@symbiote-native/react 1.0.0 → 3.0.0

package/build/components/safe-area-view/index.d.ts

@@ -1,12 +0,0 @@
-import { type FC, type ReactNode } from 'react';
-import { type ISymbioteEvent } from '@symbiote-native/engine';
-import { type IAccessibilityProps, type IAriaProps } from '@symbiote-native/components';
-import type { IStyleProp, IViewStyle } from '../../utils/styles';
-export interface ISafeAreaViewProps extends IAccessibilityProps, IAriaProps {
-    style?: IStyleProp<IViewStyle>;
-    id?: string;
-    className?: string;
-    children?: ReactNode;
-    onLayout?: (event: ISymbioteEvent) => void;
-}
-export declare const SafeAreaView: FC<ISafeAreaViewProps>;

package/build/components/safe-area-view/index.js

@@ -1,18 +0,0 @@
-// SafeAreaView primitive. A plain view whose native side insets its children to
-// the safe area (notch, rounded corners, system bars). There is no JS-side
-// translation; RN just renders the native RCTSafeAreaView and lets the host do
-// the inset math, so this maps style + children straight onto the intrinsic.
-import { createElement } from 'react';
-import { dlog } from '@symbiote-native/engine';
-import { resolveAccessibilityProps, } from '@symbiote-native/components';
-export const SafeAreaView = rawProps => {
-    // Owns its host element (symbiote-safe-area-view), so it folds aria/role here;
-    // the resolved accessibility* surface rides the node via `...accessibilityRest`.
-    const props = resolveAccessibilityProps(rawProps);
-    const { style, children, onLayout, ...accessibilityRest } = props;
-    dlog('SafeAreaView -> SafeAreaView');
-    const nodeProps = { ...accessibilityRest, style };
-    if (onLayout !== undefined)
-        nodeProps.onLayout = onLayout;
-    return createElement('symbiote-safe-area-view', nodeProps, children);
-};

package/build/components/scroll-view/index.android.d.ts

@@ -1,3 +0,0 @@
-import { type IScrollViewHandle, type IScrollViewProps } from './shared';
-export type { IScrollViewProps, IScrollViewHandle } from './shared';
-export declare const ScrollView: import("react").ForwardRefExoticComponent<IScrollViewProps & import("react").RefAttributes<IScrollViewHandle>>;

package/build/components/scroll-view/index.android.js

@@ -1,61 +0,0 @@
-// ScrollView on Android: an Android ScrollView accepts only ONE child, so a RefreshControl
-// can't be a sibling of the content the way iOS allows ("addViewAt: failed to insert view
-// ... at index 1"). Instead the RefreshControl (AndroidSwipeRefreshLayout) WRAPS the
-// scroll view, with the scroll view nested inside and nestedScrollEnabled so the inner
-// scroll handles the gesture before the refresh parent, which mirrors RN's ScrollView.js
-// android branch (cloneElement(refreshControl, {style}, <ScrollView nestedScrollEnabled
-// style={flex:1}>{content}</ScrollView>)). Metro picks this on an Android host; no
-// Platform.OS read.
-import { cloneElement, createElement, forwardRef, useImperativeHandle, useRef, } from 'react';
-import { dlog } from '@symbiote-native/engine';
-import { buildScrollViewHandle, splitLayoutProps, } from '@symbiote-native/components';
-import { usePreparedScrollView, useNativeStickyScrollAttach, } from './shared.js';
-export const ScrollView = forwardRef((props, forwardedRef) => {
-    const { scrollViewIntrinsic, scrollViewBaseStyle, outerProps, style, layoutSplitStyle, content, refreshControl, scrollAnimatedValue, nativeStickyAvailable, } = usePreparedScrollView(props);
-    // The node ref backs the imperative handle; it attaches to the inner scroll-view element
-    // (the wrap shape leaves the scroll view as the command target, not the RefreshControl).
-    const ref = useRef(null);
-    // Lazy getter, not the ref itself: the node is null until the element commits, so the handle
-    // must read ref.current on each command, an eager capture would freeze null.
-    useImperativeHandle(forwardedRef, () => buildScrollViewHandle(() => ref.current), []);
-    // Drive the sticky scroll value on the native UI thread (RN attachNativeEvent). No-op on a
-    // host without the native animated module. The JS sticky path stays in effect.
-    useNativeStickyScrollAttach(ref, scrollAnimatedValue, nativeStickyAvailable);
-    dlog('ScrollView.ANDROID refreshControl=' +
-        (refreshControl === undefined ? 'NONE(1child)' : 'WRAP'));
-    if (refreshControl === undefined) {
-        // Base style (flexDirection: row for horizontal) under user style; undefined base
-        // (vertical) passes the user style through unchanged.
-        const scrollStyle = scrollViewBaseStyle
-            ? [scrollViewBaseStyle, style]
-            : style;
-        return createElement(scrollViewIntrinsic, { ...outerProps, style: scrollStyle, ref }, content);
-    }
-    // RN splits the flattened style across the two boxes (ScrollView.js android branch):
-    // LAYOUT props (margin/flex/size/position/transform/gap/…) drive the outer
-    // AndroidSwipeRefreshLayout frame; VISUAL props (background/padding/border/opacity/…) paint
-    // the inner scroll view. So the wrapper carries `outer`, and the inner scroll view its base
-    // (flexDirection/overflow) plus the visual `inner` composed over it, NOT a hardcoded flex:1
-    // that would override an explicit user height/width.
-    //
-    // layoutSplitStyle (not style): a class-only layout prop (flex/height/gap/…) is invisible to
-    // `style` (it never carries the resolved `className` value), so splitting on `style` alone
-    // starves the wrapper of its layout style and it collapses to nothing. layoutSplitStyle is
-    // `style` merged with the resolved className style (see usePreparedScrollView).
-    const { outer: outerStyle, inner: innerStyle } = splitLayoutProps(layoutSplitStyle);
-    const scrollStyle = scrollViewBaseStyle
-        ? [scrollViewBaseStyle, innerStyle]
-        : innerStyle;
-    // className is stripped from the spread here: layoutSplitStyle already folded its resolved
-    // value into `outer`/`inner` above, so forwarding the raw prop too would re-apply its LAYOUT
-    // half onto the inner scroll view a second time (on top of the outer wrapper).
-    const { className: _classNameAppliedViaSplit, ...innerOuterProps } = outerProps;
-    const scrollView = createElement(scrollViewIntrinsic, {
-        ...innerOuterProps,
-        style: scrollStyle,
-        nestedScrollEnabled: true,
-        ref,
-    }, content);
-    return cloneElement(refreshControl, { style: outerStyle }, scrollView);
-});
-ScrollView.displayName = 'ScrollView';

package/build/components/scroll-view/index.d.ts

@@ -1 +0,0 @@
-export * from './index.ios';

package/build/components/scroll-view/index.ios.d.ts

@@ -1,3 +0,0 @@
-import { type IScrollViewHandle, type IScrollViewProps } from './shared';
-export type { IScrollViewProps, IScrollViewHandle } from './shared';
-export declare const ScrollView: import("react").ForwardRefExoticComponent<IScrollViewProps & import("react").RefAttributes<IScrollViewHandle>>;

package/build/components/scroll-view/index.ios.js

@@ -1,29 +0,0 @@
-// ScrollView (iOS): RefreshControl renders as a sibling BEFORE the content container, matching
-// RN's ScrollView.js ({refreshControl}{contentContainer}). Also the base export
-// (scroll-view.ts re-exports it) for headless / web.
-import { createElement, forwardRef, useImperativeHandle, useRef } from 'react';
-import { buildScrollViewHandle } from '@symbiote-native/components';
-import { usePreparedScrollView, useNativeStickyScrollAttach, } from './shared.js';
-export const ScrollView = forwardRef((props, forwardedRef) => {
-    const { scrollViewIntrinsic, scrollViewBaseStyle, outerProps, style, content, refreshControl, scrollAnimatedValue, nativeStickyAvailable, } = usePreparedScrollView(props);
-    // Backs the imperative handle; passing `ref` through createElement props binds it to the
-    // SymbioteNode below, as TextInput does.
-    const ref = useRef(null);
-    // Lazy getter: the node is null until commit, so the handle reads ref.current per call
-    // instead of capturing eagerly, which would freeze null.
-    useImperativeHandle(forwardedRef, () => buildScrollViewHandle(() => ref.current), []);
-    // Drives sticky scroll on the native UI thread (RN attachNativeEvent); no-ops without the
-    // native animated module, falling back to the JS sticky path.
-    useNativeStickyScrollAttach(ref, scrollAnimatedValue, nativeStickyAvailable);
-    // Base style stays under user style so an explicit value wins; undefined base (vertical)
-    // passes the user style through unchanged.
-    const scrollStyle = scrollViewBaseStyle
-        ? [scrollViewBaseStyle, style]
-        : style;
-    const scrollProps = { ...outerProps, style: scrollStyle, ref };
-    if (refreshControl === undefined) {
-        return createElement(scrollViewIntrinsic, scrollProps, content);
-    }
-    return createElement(scrollViewIntrinsic, scrollProps, refreshControl, content);
-});
-ScrollView.displayName = 'ScrollView';

package/build/components/scroll-view/index.js

@@ -1,4 +0,0 @@
-// Base / default ScrollView: re-exports the iOS build. Metro overrides this with
-// scroll-view.ios.ts / .android.ts on a real host; under tsx / tsc / web the host config
-// resolves here. Filename is the selector, no Platform.OS read.
-export * from './index.ios.js';

package/build/components/scroll-view/shared.js

@@ -1,240 +0,0 @@
-// ScrollView: shared core. The Fabric tree is nested: the scroll view wraps a content
-// view that holds the children (RN's own ScrollView.js shape). Building that content
-// node, resolving decelerationRate, and the prop plumbing are platform-invariant and
-// live here. What diverges is how a RefreshControl integrates: on iOS it is a
-// CHILD of the scroll view (sibling of the content), on Android it WRAPS the scroll view
-// (AndroidSwipeRefreshLayout is the parent, ScrollView nested inside). So the .ios/.android
-// files assemble the final element; the filename selects, no Platform.OS read.
-//
-// The framework-agnostic pieces (decelerationRate, the per-axis intrinsics/base style, the
-// content-size dedupe, the imperative handle, splitLayoutProps, the sticky math, the native
-// scroll-attach) live in @symbiote-native/components; this file holds only the React
-// lifecycle (refs/state/effects) and the element assembly that consumes them.
-import { createElement, useEffect, useRef, useState, } from 'react';
-import { AnimatedValue, dlog, event as animatedEvent, isClassNameValue, isNativeAnimatedAvailable, resolveClassName, } from '@symbiote-native/engine';
-import { attachStickyScroll, didContentSizeChange, forwardScrollEvent, readLayoutDimension, resolveDecelerationRate, resolveScrollForwarding, selectScrollIntrinsics, } from '@symbiote-native/components';
-import { resolveAccessibilityProps, } from '@symbiote-native/components';
-import { wrapStickyHeaders, } from './sticky-header.js';
-export function usePreparedScrollView(rawProps) {
-    // ScrollView forwards its outer props straight to the native scroll view (not a View
-    // wrapper), so it folds aria/role into accessibility* here before forwarding.
-    const props = resolveAccessibilityProps(rawProps);
-    const { style, className, contentContainerStyle, horizontal, decelerationRate, refreshControl, children, onContentSizeChange, stickyHeaderIndices, invertStickyHeaders, StickyHeaderComponent, onLayout, onScroll, scrollEventThrottle, ...outer } = props;
-    const isHorizontal = horizontal === true;
-    const hasStickyHeaders = stickyHeaderIndices !== undefined && stickyHeaderIndices.length > 0;
-    // A single AnimatedValue tracks the scroll offset and drives every sticky header's
-    // translateY (RN's _scrollAnimatedValue). Stable across renders via a ref so the headers'
-    // bindings survive re-renders. Allocated even when no sticky headers are present (hooks
-    // run unconditionally: usePreparedScrollView is always called at the top of the render body).
-    const scrollAnimatedValueRef = useRef(null);
-    if (scrollAnimatedValueRef.current === null)
-        scrollAnimatedValueRef.current = new AnimatedValue(0);
-    const scrollAnimatedValue = scrollAnimatedValueRef.current;
-    // Inverted sticky headers stick to the BOTTOM, so they need the viewport height (RN reads
-    // it in _handleLayout). Tracked here and fed back into the wrapped headers.
-    const [viewportHeight, setViewportHeight] = useState(undefined);
-    // Sticky-header cross-talk (RN ScrollView.js _headerLayoutYs, line 754): a child-index→measured-y
-    // map the parent keeps so each header can learn where the NEXT sticky header starts (its push-off
-    // collision point). The map lives in a ref (mutated imperatively from each header's onLayout, like
-    // RN's _onStickyHeaderLayout), and a state bump forces the re-render that feeds the freshly-recorded
-    // y forward into the previous header's nextHeaderLayoutY prop.
-    const headerLayoutYsRef = useRef(null);
-    if (headerLayoutYsRef.current === null)
-        headerLayoutYsRef.current = new Map();
-    const headerLayoutYs = headerLayoutYsRef.current;
-    // The mounted headers by child index (RN's _stickyHeaderRefs, ScrollView.js:750), so a fresh
-    // measurement reaches its predecessor directly.
-    const stickyHeaderRefsRef = useRef(null);
-    if (stickyHeaderRefsRef.current === null)
-        stickyHeaderRefsRef.current = new Map();
-    const stickyHeaderRefs = stickyHeaderRefsRef.current;
-    const onHeaderRef = (index, handle) => {
-        if (handle === null)
-            stickyHeaderRefs.delete(index);
-        else
-            stickyHeaderRefs.set(index, handle);
-    };
-    // Measurements waiting to be handed to their predecessors, flushed together (see below).
-    const pendingHeaderYsRef = useRef(null);
-    if (pendingHeaderYsRef.current === null)
-        pendingHeaderYsRef.current = new Map();
-    const pendingHeaderYs = pendingHeaderYsRef.current;
-    const flushScheduledRef = useRef(false);
-    const flushHeaderYs = () => {
-        flushScheduledRef.current = false;
-        if (stickyHeaderIndices === undefined)
-            return;
-        for (const [index, y] of pendingHeaderYs) {
-            const previousIndex = stickyHeaderIndices[stickyHeaderIndices.indexOf(index) - 1];
-            if (previousIndex === undefined)
-                continue;
-            stickyHeaderRefs.get(previousIndex)?.setNextHeaderY(y);
-        }
-        pendingHeaderYs.clear();
-    };
-    // RN _onStickyHeaderLayout (ScrollView.js:1136): record this header's y, then hand it to the
-    // PREVIOUS sticky header as its push-off collision point.
-    //
-    // The handoff is COALESCED rather than immediate, and that is the point. Cross-talk runs BACKWARDS
-    // (a header learns its collision point from the one after it), so a mount measures every header
-    // and walks the chain end to start. Pushing each value the moment it arrives makes every link its
-    // own update generation - a setState on the predecessor, whose effect setStates again - and React
-    // caps nested updates at 50: three headers go unnoticed, two hundred abort the app with "Maximum
-    // update depth exceeded", which reads like an infinite loop but is really depth. Draining on a
-    // microtask puts one burst of layouts into ONE render pass, so depth stops tracking header count.
-    const onHeaderLayoutY = (index, y) => {
-        if (headerLayoutYs.get(index) === y)
-            return;
-        headerLayoutYs.set(index, y);
-        dlog(`ScrollView sticky-header layoutY index=${index} y=${y}`);
-        pendingHeaderYs.set(index, y);
-        if (flushScheduledRef.current)
-            return;
-        flushScheduledRef.current = true;
-        void Promise.resolve().then(flushHeaderYs);
-    };
-    // A class-name string resolves through the shared registry before it reaches the
-    // framework-agnostic selector below, which only understands style objects/arrays.
-    const resolvedContentContainerStyle = typeof contentContainerStyle === 'string'
-        ? resolveClassName(contentContainerStyle)
-        : contentContainerStyle;
-    // The per-axis intrinsics, base style, and content style come from the shared selector
-    // (@symbiote-native/components): on Android horizontal resolves to its own ViewManager, on iOS both
-    // map back to RCTScrollView; here we only pass the axis.
-    const { scrollViewIntrinsic, contentIntrinsic, scrollViewBaseStyle, contentStyle, } = selectScrollIntrinsics(isHorizontal, resolvedContentContainerStyle);
-    const outerProps = { ...outer };
-    // className is pulled out above (unlike the rest of `...outer`) so `layoutSplitStyle` below can
-    // resolve it eagerly; re-added here so the simple single-node paths (iOS, Android with no
-    // refreshControl) keep forwarding it raw, exactly as it did when it flowed through `...outer`.
-    if (className !== undefined)
-        outerProps.className = className;
-    // RN defaults nested scrolling ON (ScrollView.js:1862 `nestedScrollEnabled ?? true`).
-    // Android needs the flag to scroll a scrollable nested inside another scroll view
-    // independently; without it the inner one stays put. iOS handles nesting natively, so
-    // it is a no-op there. Default to true so nested lists scroll out of the box, like RN.
-    outerProps.nestedScrollEnabled = props.nestedScrollEnabled ?? true;
-    // iOS needs `horizontal` to flip RCTScrollView's axis; Android's dedicated horizontal
-    // manager ignores it. Harmless on Android, load-bearing on iOS, so always forward it.
-    if (horizontal !== undefined)
-        outerProps.horizontal = horizontal;
-    if (decelerationRate !== undefined) {
-        outerProps.decelerationRate = resolveDecelerationRate(decelerationRate);
-    }
-    // The scroll-forwarding DECISIONS (which onScroll path, the 1/16 throttle defaults, whether to
-    // capture the viewport height for inverted sticky, whether to keep cells un-flattened) are folded
-    // out to the shared resolveScrollForwarding; here React only EXECUTES them with its own primitives.
-    const nativeStickyAvailable = hasStickyHeaders && isNativeAnimatedAvailable();
-    const forwarding = resolveScrollForwarding({
-        hasStickyHeaders,
-        nativeStickyAvailable,
-        invertStickyHeaders,
-        scrollEventThrottle,
-        maintainVisibleContentPosition: props.maintainVisibleContentPosition,
-        snapToAlignment: props.snapToAlignment,
-    });
-    // onScroll: the JS-fallback path wraps the user's handler in Animated.event so the offset drives
-    // the AnimatedValue each frame (RN _scrollAnimatedValueAttachment); the native + plain paths
-    // forward the user's handler as-is (the native driver attaches the value on the UI thread).
-    if (forwarding.mode === 'sticky-js') {
-        outerProps.onScroll = animatedEvent([{ nativeEvent: { contentOffset: { y: scrollAnimatedValue } } }], onScroll === undefined
-            ? undefined
-            : { listener: (...args) => forwardScrollEvent(onScroll, args) });
-    }
-    else if (onScroll !== undefined) {
-        outerProps.onScroll = onScroll;
-    }
-    if (forwarding.scrollEventThrottle !== undefined) {
-        outerProps.scrollEventThrottle = forwarding.scrollEventThrottle;
-    }
-    // onLayout on the scroll-view node: capture the viewport height for inverted sticky headers
-    // (RN _handleLayout), then call the user's handler. Pass through unchanged otherwise.
-    if (forwarding.capturesViewportHeight) {
-        outerProps.onLayout = (layoutEvent) => {
-            const height = readLayoutDimension(layoutEvent, 'height');
-            if (height !== undefined)
-                setViewportHeight(height);
-            onLayout?.(layoutEvent);
-        };
-    }
-    else if (onLayout !== undefined) {
-        outerProps.onLayout = onLayout;
-    }
-    dlog(`ScrollView -> ${scrollViewIntrinsic} (horizontal=${isHorizontal} sticky=${hasStickyHeaders})`);
-    // onContentSizeChange is synthesized from the content view's own onLayout (RN
-    // _handleContentOnLayout): read width/height off nativeEvent.layout and fire only when the
-    // size actually changed (dedupe via a ref, like RN). Composed with any content onLayout.
-    const lastContentSizeRef = useRef(null);
-    const contentProps = {
-        style: contentStyle,
-        collapsable: false,
-    };
-    // maintainVisibleContentPosition (and Android snapToAlignment) anchor against the metrics
-    // of MOUNTED cell views. Android Fabric view-flattens layout-only cells away, so the native
-    // MaintainVisibleScrollPositionHelper has nothing to anchor to and the list jumps on prepend.
-    // RN keeps the cells as real views via collapsableChildren={false} on the content container
-    // (ScrollView.js:1731-1748 `preserveChildren`). iOS never flattens, so it is a no-op there.
-    if (forwarding.collapsableChildren) {
-        contentProps.collapsableChildren = false;
-    }
-    if (onContentSizeChange !== undefined) {
-        contentProps.onLayout = (layoutEvent) => {
-            const width = readLayoutDimension(layoutEvent, 'width');
-            const height = readLayoutDimension(layoutEvent, 'height');
-            if (width === undefined || height === undefined)
-                return;
-            const last = lastContentSizeRef.current;
-            if (!didContentSizeChange(last, { width, height }))
-                return;
-            lastContentSizeRef.current = { width, height };
-            dlog(`ScrollView onContentSizeChange ${width}x${height}`);
-            onContentSizeChange(width, height);
-        };
-    }
-    // Wrap the flagged children so they pin to the scroll offset (see the sticky-headers note
-    // above); no-op when none are flagged.
-    const contentChildren = hasStickyHeaders
-        ? wrapStickyHeaders(children, stickyHeaderIndices, scrollAnimatedValue, invertStickyHeaders, viewportHeight, StickyHeaderComponent, { headerLayoutYs, onHeaderLayoutY, onHeaderRef })
-        : children;
-    // `collapsable: false` is load-bearing on Android. The content container is a
-    // layout-only View, which Android Fabric view-flattens away, hoisting the cells
-    // up as DIRECT children of the scroll view, which strictly hosts exactly one
-    // child ("ScrollView can host only one direct child" → addViewAt crash). RN pins
-    // its own NativeScrollContentView the same way (ScrollView.js, collapsable={false};
-    // ReactScrollView.java: "the 'content' View … non-collapsable so it will never be
-    // View-flattened away"). iOS doesn't flatten, so this is a no-op there.
-    const content = createElement(contentIntrinsic, contentProps, contentChildren);
-    // resolveClassName(undefined) is a cheap {} no-op, so this is safe with no className too.
-    const resolvedClassName = isClassNameValue(className) ? className : undefined;
-    const layoutSplitStyle = [
-        resolveClassName(resolvedClassName),
-        style,
-    ];
-    return {
-        scrollViewIntrinsic,
-        scrollViewBaseStyle,
-        outerProps,
-        style,
-        layoutSplitStyle,
-        content,
-        refreshControl,
-        scrollAnimatedValue,
-        nativeStickyAvailable,
-    };
-}
-// Attach the scroll event to the scroll-offset value on the NATIVE driver, RN's
-// _updateAnimatedNodeAttachment / AnimatedImplementation.attachNativeEvent (ScrollView.js:1087).
-// Called by each platform ScrollView with its committed scroll-node ref; the value then tracks
-// scroll on the UI thread and the sticky-header interpolations ride it natively (no JS jitter).
-// No-op when native sticky is unavailable or the node hasn't committed. Detaches on unmount.
-// The attach/detach itself lives in @symbiote-native/components (attachStickyScroll); this is the React
-// effect that drives it.
-export function useNativeStickyScrollAttach(scrollNodeRef, scrollAnimatedValue, enabled) {
-    useEffect(() => {
-        if (!enabled)
-            return;
-        const node = scrollNodeRef.current;
-        if (node === null)
-            return;
-        return attachStickyScroll(node, scrollAnimatedValue);
-    }, [scrollNodeRef, scrollAnimatedValue, enabled]);
-}

package/build/components/scroll-view/sticky-header.d.ts

@@ -1,18 +0,0 @@
-import { type ComponentType, type ReactNode, type Ref } from 'react';
-import { AnimatedValue } from '@symbiote-native/engine';
-import { type IStickyHeaderProps } from '@symbiote-native/components';
-export type IStickyHeaderHandle = {
-    setNextHeaderY: (y: number) => void;
-};
-export type IStickyCrossTalk = {
-    headerLayoutYs: ReadonlyMap<number, number>;
-    onHeaderLayoutY: (index: number, y: number) => void;
-    onHeaderRef: (index: number, handle: IStickyHeaderHandle | null) => void;
-};
-export type IStickyHeaderComponentProps = IStickyHeaderProps & {
-    children?: ReactNode;
-    ref?: Ref<IStickyHeaderHandle>;
-};
-export type IStickyHeaderComponentType = ComponentType<IStickyHeaderComponentProps>;
-export declare const ScrollViewStickyHeader: IStickyHeaderComponentType;
-export declare function wrapStickyHeaders(children: ReactNode, stickyHeaderIndices: number[] | undefined, scrollAnimatedValue: AnimatedValue, invertStickyHeaders: boolean | undefined, scrollViewHeight: number | undefined, StickyHeaderComponent: IStickyHeaderComponentType | undefined, crossTalk: IStickyCrossTalk): ReactNode;

package/build/components/scroll-view/sticky-header.js

@@ -1,227 +0,0 @@
-// Sticky headers: the JS layer RN implements in ScrollView.js / ScrollViewStickyHeader.js.
-//
-// RN does stickiness purely in JS: ScrollView.js (~line 1690) wraps each flagged child in a
-// ScrollViewStickyHeader, fed by a single `_scrollAnimatedValue` that Animated.event drives
-// from `onScroll` (~line 1095). The native Fabric scroll view does not honor the index array,
-// so forwarding `stickyHeaderIndices` to native would be a silent no-op - we replicate the JS
-// layer instead. The interpolation mirrors ScrollViewStickyHeader.js and now lives,
-// framework-agnostic, in @symbiote-native/components (computeStickyInterpolation); this file
-// holds only the React component shell, layout state, and child-wrapping.
-import { Children, createElement, isValidElement, useCallback, useEffect, useImperativeHandle, useReducer, useRef, useState, } from 'react';
-import { AnimatedInterpolation, AnimatedValue, Platform, dlog, } from '@symbiote-native/engine';
-import { createInitialStickyState, nextStickyHeaderY, readLayoutNumber, reduceSticky, STICKY_HEADER_Z_INDEX, } from '@symbiote-native/components';
-import { Animated } from '../../modules/animated/index.js';
-function readChildOnLayout(child) {
-    const childProps = child.props;
-    if (typeof childProps !== 'object' || childProps === null)
-        return undefined;
-    const handler = Reflect.get(childProps, 'onLayout');
-    return typeof handler === 'function' ? handler : undefined;
-}
-function firstChild(children) {
-    const first = Children.toArray(children)[0];
-    return isValidElement(first) ? first : undefined;
-}
-// One sticky header. Measures its own y/height via onLayout, interpolates the shared scroll
-// offset into a translateY that keeps it pinned to the top (or bottom, inverted) until the next
-// header collides with it, and drives that translate through the native driver when available so
-// the pin tracks scroll on the UI thread (no JS jitter). The DECISIONS — the zero-swallow gate, the
-// debounce delay, the rebuild-on-input-change ranges — live in `reduceSticky`
-// (@symbiote-native/components); this component supplies only the React lifecycle: the ONE folded
-// state cell, the interpolation-node + listener wiring, the debounce setTimeout, and the re-render.
-export const ScrollViewStickyHeader = props => {
-    const { inverted, scrollViewHeight, scrollAnimatedValue, nextHeaderLayoutY, children, ref, } = props;
-    // The next header's y lives HERE, not in a prop the parent re-renders to update (RN keeps it in
-    // the child too, ScrollViewStickyHeader.js:65). The prop only seeds the first render; afterwards
-    // the ScrollView pushes updates through setNextHeaderY. That keeps the cost linear - a
-    // parent-state round trip re-renders every child on every header's layout, so N headers cost N
-    // re-renders of N children. At N=200 it churned enough native animated nodes to trip Fabric's view
-    // registry ("Attempt to dequeue already registered component") seconds after mount.
-    const [nextHeaderY, setNextHeaderY] = useState(nextHeaderLayoutY);
-    useImperativeHandle(ref, () => ({ setNextHeaderY }), []);
-    // The imperative push is a fast path, not the source of truth. When the parent DOES re-render
-    // with a different value the prop wins, because the successor may be gone: a VirtualizedList
-    // unmounts headers as they scroll out, and a value pushed in earlier would otherwise stick
-    // around as a collision point that no longer exists.
-    const lastNextHeaderProp = useRef(nextHeaderLayoutY);
-    if (lastNextHeaderProp.current !== nextHeaderLayoutY) {
-        lastNextHeaderProp.current = nextHeaderLayoutY;
-        setNextHeaderY(nextHeaderLayoutY);
-    }
-    // The one folded state cell (RN's scattered useState/useRef collapsed into IStickyHeaderState),
-    // mutated in place by reduceSticky. Lazily created once.
-    const stateRef = useRef(null);
-    const state = (stateRef.current ??= createInitialStickyState());
-    const [, forceRender] = useReducer((tick) => tick + 1, 0);
-    // The animated node that drives the transform (RN's animatedTranslateY), rebuilt by the
-    // rebuild-interpolation effect. When the scroll value is native, this interpolation runs on the
-    // UI thread: the smooth pin.
-    const [animatedTranslateY, setAnimatedTranslateY] = useState(() => scrollAnimatedValue.interpolate({
-        inputRange: [-1, 0],
-        outputRange: [0, 0],
-    }));
-    const debounceTimer = useRef(null);
-    // The current interpolation node + its settled-value listener id, held so the next rebuild can
-    // detach the old listener (engine calls the reducer does NOT own) and unmount can clean up.
-    const interpolationRef = useRef(null);
-    const listenerIdRef = useRef(null);
-    const inputsRef = useRef({
-        os: Platform.OS,
-        inverted,
-        scrollViewHeight,
-        nextHeaderLayoutY: nextHeaderY,
-    });
-    inputsRef.current = {
-        os: Platform.OS,
-        inverted,
-        scrollViewHeight,
-        nextHeaderLayoutY: nextHeaderY,
-    };
-    // dispatch reaches through a ref because the effect executors dispatch follow-up actions
-    // (the listener -> animated-tick, the debounce timer -> debounce-fired).
-    const dispatchRef = useRef(() => { });
-    const runEffects = useCallback((effects) => {
-        for (const effect of effects) {
-            switch (effect.kind) {
-                case 'rebuild-interpolation': {
-                    // Detach the old listener, build a fresh interpolation onto the shared scroll value, and
-                    // wire the settled-value listener (symbiote is always Fabric; RN attaches it only there).
-                    const previous = interpolationRef.current;
-                    if (previous !== null && listenerIdRef.current !== null) {
-                        previous.removeListener(listenerIdRef.current);
-                        listenerIdRef.current = null;
-                    }
-                    const next = scrollAnimatedValue.interpolate({
-                        inputRange: effect.inputRange,
-                        outputRange: effect.outputRange,
-                    });
-                    listenerIdRef.current = next.addListener(({ value }) => {
-                        if (typeof value === 'number')
-                            dispatchRef.current({ kind: 'animated-tick', value });
-                    });
-                    interpolationRef.current = next;
-                    setAnimatedTranslateY(next);
-                    break;
-                }
-                case 'schedule-debounce': {
-                    // The animated value updates several times per frame; debounce the settled value into the
-                    // committed transform so hit detection stays current (a Fabric issue, worse on Android).
-                    if (debounceTimer.current !== null)
-                        clearTimeout(debounceTimer.current);
-                    debounceTimer.current = setTimeout(() => {
-                        debounceTimer.current = null;
-                        dispatchRef.current({
-                            kind: 'debounce-fired',
-                            value: effect.value,
-                        });
-                    }, effect.delay);
-                    break;
-                }
-                case 'apply-passthrough':
-                    forceRender();
-                    break;
-                case 'record-header-y':
-                    // React records through the wrapper's onLayout closure (props.onLayout, below), which
-                    // honors the public IStickyHeaderProps contract; the reducer emits no index for it.
-                    break;
-            }
-        }
-    }, [scrollAnimatedValue]);
-    const dispatch = useCallback((action) => {
-        const current = stateRef.current;
-        if (current === null)
-            return;
-        runEffects(reduceSticky(current, action, inputsRef.current).effects);
-    }, [runEffects]);
-    dispatchRef.current = dispatch;
-    // Rebuild when the collision/viewport inputs change (RN effect deps minus the layout state, which
-    // dispatches 'layout' itself); also does the initial identity build on mount.
-    useEffect(() => {
-        dispatchRef.current({ kind: 'inputs-changed' });
-    }, [inverted, scrollViewHeight, nextHeaderY, scrollAnimatedValue]);
-    // Detach the listener + clear the debounce on unmount.
-    useEffect(() => () => {
-        const previous = interpolationRef.current;
-        if (previous !== null && listenerIdRef.current !== null)
-            previous.removeListener(listenerIdRef.current);
-        if (debounceTimer.current !== null)
-            clearTimeout(debounceTimer.current);
-    }, []);
-    const onLayout = (event) => {
-        const y = readLayoutNumber(event, 'y');
-        const height = readLayoutNumber(event, 'height');
-        // Keep the previous value when a field is absent (RN sets state only on a defined read).
-        dispatch({
-            kind: 'layout',
-            y: y ?? state.layoutY,
-            height: height ?? state.layoutHeight,
-        });
-        props.onLayout(event);
-        const child = firstChild(children);
-        const childOnLayout = child === undefined ? undefined : readChildOnLayout(child);
-        childOnLayout?.(event);
-    };
-    // The EXPLICIT debounced translateY overrides the committed transform for hit-testing, while
-    // `animatedTranslateY` does the smooth (native-driven) pin, per RN ScrollViewStickyHeader.js.
-    const passthroughAnimatedPropExplicitValues = state.translateY !== null
-        ? { style: { transform: [{ translateY: state.translateY }] } }
-        : null;
-    // collapsable:false keeps the wrapper a real Yoga node; zIndex makes the pinned header paint
-    // OVER the rows scrolling under it. `style` is `unknown` on Animated.View, so the interpolation
-    // transform passes with no cast.
-    return createElement(Animated.View, {
-        style: {
-            transform: [{ translateY: animatedTranslateY }],
-            zIndex: STICKY_HEADER_Z_INDEX,
-        },
-        onLayout,
-        collapsable: false,
-        passthroughAnimatedPropExplicitValues,
-    }, children);
-};
-ScrollViewStickyHeader.displayName = 'ScrollViewStickyHeader';
-// Wrap each child flagged by `stickyHeaderIndices` in the sticky header component, fed by the
-// shared scroll AnimatedValue. Mirrors ScrollView.js's render-time children.map (~line 1690).
-// Returns the children unchanged when no indices are flagged.
-//
-// Cross-talk plumbing (RN's _headerLayoutYs + _onStickyHeaderLayout, ScrollView.js:1115-1143):
-// `headerLayoutYs` is a child-index→measured-y map the parent keeps; each header reports its own
-// y through `onHeaderLayoutY` as it measures, and we feed every header the y of the NEXT flagged
-// header (the collision point past which it scrolls off) by looking up its successor's index in
-// `stickyHeaderIndices`. The LAST flagged header has no successor, so its `nextHeaderLayoutY`
-// stays undefined and it sticks indefinitely (correct).
-export function wrapStickyHeaders(children, stickyHeaderIndices, scrollAnimatedValue, invertStickyHeaders, scrollViewHeight, StickyHeaderComponent, crossTalk) {
-    const { headerLayoutYs, onHeaderLayoutY, onHeaderRef } = crossTalk;
-    if (stickyHeaderIndices === undefined || stickyHeaderIndices.length === 0)
-        return children;
-    const Wrapper = StickyHeaderComponent ?? ScrollViewStickyHeader;
-    return Children.toArray(children).map((child, index) => {
-        const indexOfIndex = stickyHeaderIndices.indexOf(index);
-        if (indexOfIndex === -1 || !isValidElement(child))
-            return child;
-        // The next flagged header's measured y, by index order in stickyHeaderIndices (RN
-        // ScrollView.js:1695 nextIndex). undefined until that header has measured (or for the last).
-        const nextIndex = stickyHeaderIndices[indexOfIndex + 1];
-        const nextHeaderLayoutY = nextStickyHeaderY(stickyHeaderIndices, indexOfIndex, headerLayoutYs);
-        dlog(`ScrollView sticky-header wrap index=${index} next=${nextIndex} nextY=${nextHeaderLayoutY}`);
-        return createElement(Wrapper, {
-            key: child.key ?? `sticky-${index}`,
-            // Registers this header so the ScrollView can push the NEXT header's y straight in
-            // (RN ScrollView.js:1109). Without it a measurement would have to travel through parent
-            // state, re-rendering every child.
-            ref: (handle) => onHeaderRef(index, handle),
-            nextHeaderLayoutY,
-            // RN _onStickyHeaderLayout: record this header's own y, then push it to the previous
-            // header as its nextHeaderLayoutY. We record into the parent map; the lookup above feeds
-            // it forward on the resulting re-render.
-            onLayout: (event) => {
-                const y = readLayoutNumber(event, 'y');
-                if (y !== undefined)
-                    onHeaderLayoutY(index, y);
-            },
-            scrollAnimatedValue,
-            inverted: invertStickyHeaders,
-            scrollViewHeight,
-        }, child);
-    });
-}

package/build/components/switch/index.android.d.ts

@@ -1,3 +0,0 @@
-import type { ISwitchProps } from './shared';
-export type { ISwitchProps, ISwitchTrackColor } from './shared';
-export declare function Switch(rawProps: ISwitchProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;