@symbiote-native/react 1.0.0 → 2.0.0

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>>;

package/build/components/switch/index.android.js

@@ -1,18 +0,0 @@
-// Switch, Android host binding. AndroidSwitch takes trackColorForTrue / trackColorForFalse
-// plus trackTintColor (the color for the CURRENT value, which RN computes as value ? true :
-// false), and snaps native back via the `setNativeValue` command (Switch.js:221-225).
-import { descriptorToReact } from '../../descriptor-to-react/index.js';
-import { useSwitchLogic } from './shared.js';
-const PLATFORM = {
-    snapBackCommand: 'setNativeValue',
-    trackColorProps: (value, trackColor) => ({
-        trackColorForFalse: trackColor?.false,
-        trackColorForTrue: trackColor?.true,
-        trackTintColor: value ? trackColor?.true : trackColor?.false,
-    }),
-};
-// A top-level named function, not a factory-returned closure: React Compiler's
-// component detection only walks top-level declarations (see shared.ts).
-export function Switch(rawProps) {
-    return descriptorToReact(useSwitchLogic(rawProps, PLATFORM));
-}

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

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

package/build/components/switch/index.ios.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>>;

package/build/components/switch/index.ios.js

@@ -1,16 +0,0 @@
-// Switch, iOS host binding. iOS's native Switch takes onTintColor (ON-track) / tintColor
-// (OFF-track), and snaps native back via the `setValue` command (Switch.js:221-225).
-import { descriptorToReact } from '../../descriptor-to-react/index.js';
-import { useSwitchLogic } from './shared.js';
-const PLATFORM = {
-    snapBackCommand: 'setValue',
-    trackColorProps: (_value, trackColor) => ({
-        onTintColor: trackColor?.true,
-        tintColor: trackColor?.false,
-    }),
-};
-// A top-level named function, not a factory-returned closure: React Compiler's
-// component detection only walks top-level declarations (see shared.ts).
-export function Switch(rawProps) {
-    return descriptorToReact(useSwitchLogic(rawProps, PLATFORM));
-}

package/build/components/switch/index.js

@@ -1,6 +0,0 @@
-// Base / default Switch: re-exports the iOS build. Metro overrides this with switch.ios.ts /
-// switch.android.ts on a real host; under tsx / tsc / web the host config resolves here.
-// Filename is the selector, no Platform.OS read. The logic lives in
-// @symbiote-native/components/state, the render in @symbiote-native/components/view, and the
-// hook in switch-shared.
-export * from './index.ios.js';

package/build/components/switch/shared.d.ts

@@ -1,9 +0,0 @@
-import type { ISwitchPlatform, ISwitchProps as ISwitchBaseProps } from '@symbiote-native/components';
-export type { ISwitchTrackColor } from '@symbiote-native/components';
-export type ISwitchProps = ISwitchBaseProps & {
-    className?: string;
-};
-export type ISwitchHostPlatform = ISwitchPlatform & {
-    snapBackCommand: string;
-};
-export declare function useSwitchLogic(rawProps: ISwitchProps, platform: ISwitchHostPlatform): import("@symbiote-native/components").IDescriptor;

package/build/components/switch/shared.js

@@ -1,60 +0,0 @@
-// Switch is the React lifecycle half. The logic (the lastNativeReport reducer, valueFromChange,
-// the snap-back decision) lives in @symbiote-native/components/state, the render (value fold, track
-// colors, ios_backgroundColor) in @symbiote-native/components/view; here the adapter only owns the
-// hook: useReducer over the shared reducer, a ref for the imperative command, and the
-// useLayoutEffect that snaps native back when the parent rejects a toggle.
-//
-// Switch is controlled exactly like RN's: the parent's onValueChange MUST update `value` for
-// the toggle to stick. If the handler is a no-op, native has already flipped its own grip, so
-// JS commands the old value back down (a plain prop re-push cannot cover the no-op case: the
-// prop never changes, so the retained tree never diverges). The command name is platform-
-// specific (iOS setValue / Android setNativeValue) and arrives via `platform`.
-//
-// useSwitchLogic is a plain hook, not a component factory returning a closure: React Compiler's
-// component/hook detection only walks top-level declarations, so index.ios.ts / index.android.ts
-// each declare their OWN top-level `Switch` function that calls this hook, rather than exporting
-// whatever a factory here returns.
-import { useCallback, useLayoutEffect, useReducer, useRef } from 'react';
-import { renderSwitch, switchReducer, createInitialSwitchState, shouldSnapBack, valueFromChange, } from '@symbiote-native/components';
-import { dispatchViewCommand, dlog, } from '@symbiote-native/engine';
-import { resolveAccessibilityProps } from '@symbiote-native/components';
-export function useSwitchLogic(rawProps, platform) {
-    // Switch owns its host element rather than rendering through a symbiote View, so it folds
-    // aria/role into accessibility* here; the resolved accessibility* fields (plus testID etc.)
-    // ride down to the host node via `passthrough`.
-    const props = resolveAccessibilityProps(rawProps);
-    const { value, onValueChange, disabled, trackColor, thumbColor, ios_backgroundColor, style, ...passthrough } = props;
-    const ref = useRef(null);
-    const [state, dispatch] = useReducer(switchReducer, undefined, createInitialSwitchState);
-    const handleChange = useCallback((event) => {
-        const next = valueFromChange(event);
-        dlog(`Switch onChange value=${String(next)} eventCount=${String(event.nativeEvent.eventCount)}`);
-        if (next === undefined)
-            return;
-        onValueChange?.(next, event);
-        dispatch({ type: 'native-reported', value: next });
-    }, [onValueChange]);
-    // value is a real Fabric prop, folded to a strict boolean: RN sends `value === true`, so
-    // an undefined prop reads as "off" rather than absent.
-    const fabricValue = value === true;
-    useLayoutEffect(() => {
-        const node = ref.current;
-        if (node === null)
-            return;
-        if (!shouldSnapBack(state, fabricValue)) {
-            dlog(`Switch snap-back no-op reported=${String(state.lastNativeReport)} value=${fabricValue}`);
-            return;
-        }
-        dlog(`Switch ${platform.snapBackCommand} snap-back reported=${String(state.lastNativeReport)} value=${fabricValue}`);
-        dispatchViewCommand(node, platform.snapBackCommand, [fabricValue]);
-    }, [fabricValue, state]);
-    return renderSwitch({
-        value: fabricValue,
-        disabled,
-        trackColor,
-        thumbColor,
-        ios_backgroundColor,
-        style,
-        passthrough: { ...passthrough, ref, onChange: handleChange },
-    }, platform);
-}