@symbiote-native/components 0.3.0 → 0.5.0

package/README.md

@@ -51,14 +51,22 @@ types and wires the reducer/render pair from here. Calling the render function d
 adapter itself does, to build its lifecycle wrapper:
 
 ```ts
-import { renderSwitch, createInitialSwitchState, switchReducer } from '@symbiote-native/components';
+import {
+  renderSwitch,
+  createInitialSwitchState,
+  switchReducer,
+} from '@symbiote-native/components';
 
 // inside an adapter's own hook/composable:
 const state = createInitialSwitchState();
 const next = switchReducer(state, { type: 'native-reported', value: true });
 const descriptor = renderSwitch(
   { value: true, disabled: false, passthrough: { onChange, ref } },
-  { trackColorProps: (value, trackColor) => ({ /* platform-specific prop names */ }) },
+  {
+    trackColorProps: (value, trackColor) => ({
+      /* platform-specific prop names */
+    }),
+  },
 );
 // descriptor is then handed to the adapter's own descriptorToReact / descriptorToVue bridge
 ```

package/build/accessibility-props.js

@@ -95,7 +95,8 @@ export function resolveAccessibilityProps(props) {
         'aria-valuenow': undefined,
         'aria-valuetext': undefined,
     };
-    if (ariaLabelledBy !== undefined && next.accessibilityLabelledBy === undefined) {
+    if (ariaLabelledBy !== undefined &&
+        next.accessibilityLabelledBy === undefined) {
         next.accessibilityLabelledBy = ariaLabelledBy.split(/\s*,\s*/g);
     }
     if (ariaLabel !== undefined && next.accessibilityLabel === undefined) {

package/build/bootstrap/index.js

@@ -4,7 +4,7 @@
 // startup. Lives OUTSIDE the package's main barrel (see package.json's separate "./bootstrap"
 // export): react-native's own source is Flow syntax Vitest's transform can't parse, so anything
 // importing it directly must stay unreachable from the tested main index.ts.
-import { processColor, DeviceEventEmitter, Image } from 'react-native';
+import { processColor, DeviceEventEmitter, Image, } from 'react-native';
 import { setColorProcessor, setDeviceEventSource, setImageSourceResolver, setNativeViewConfigSource, } from '@symbiote-native/engine';
 // @ts-expect-error react-native ships no types for this internal path (plain .js) - the
 // try/catch below is what actually proves the shape, not TS.

package/build/component-names/index.android.js

@@ -2,7 +2,7 @@
 // Each name is the ViewManager's REACT_CLASS in react-native/ReactAndroid/.../views/**.
 // device-verify-pending: source-confirmed from RN's Android ViewManagers, proven on a
 // real host by the absence of a "Can't find ViewManager '<name>'" red box.
-import { buildDescriptors, makeDescriptorFor } from './shared.js';
+import { buildDescriptors, makeDescriptorFor, } from './shared.js';
 const ANDROID_NAMES = {
     'symbiote-view': 'RCTView',
     'symbiote-text': 'RCTText',

package/build/component-names/index.ios.js

@@ -2,7 +2,7 @@
 // (component-names.ts re-exports it) for headless tsx / tsc / web fallback.
 // Fabric names are the codegen spec's registered name (the new-arch name), not the legacy
 // paperComponentName (RCTSwitch, …).
-import { buildDescriptors, makeDescriptorFor } from './shared.js';
+import { buildDescriptors, makeDescriptorFor, } from './shared.js';
 const IOS_NAMES = {
     'symbiote-view': 'RCTView',
     'symbiote-text': 'RCTText',

package/build/component-names/shared.js

@@ -13,7 +13,10 @@ const TEXT_INTRINSICS = new Set(['symbiote-text']);
 export function buildDescriptors(names) {
     const descriptors = {};
     for (const [intrinsic, component] of Object.entries(names)) {
-        descriptors[intrinsic] = { component, isText: TEXT_INTRINSICS.has(intrinsic) };
+        descriptors[intrinsic] = {
+            component,
+            isText: TEXT_INTRINSICS.has(intrinsic),
+        };
     }
     return descriptors;
 }

package/build/descriptor.d.ts

@@ -9,3 +9,11 @@ export type IDescriptor = {
 };
 export declare function el(type: IDescriptorType, props?: IDescriptorProps, children?: IDescriptorChild[], key?: string): IDescriptor;
 export declare function txt(props?: IDescriptorProps, children?: IDescriptorChild[]): IDescriptor;
+export type IDescriptorShapeGuard = {
+    error(detail: string): Error;
+    assertType(expected: IDescriptorType, actual: IDescriptorType): void;
+    assertChildCount(expected: number, actual: number): void;
+    asText(child: IDescriptorChild): string;
+    asElement(child: IDescriptorChild): IDescriptor;
+};
+export declare function createDescriptorShapeGuard(bridge: string): IDescriptorShapeGuard;

package/build/descriptor.js

@@ -13,3 +13,30 @@ export function el(type, props = {}, children = [], key) {
 export function txt(props = {}, children = []) {
     return { type: 'symbiote-text', props, children };
 }
+// `bridge` names the caller (`descriptorToSolid`, `descriptorToSvelte`) so a device log says which
+// one tripped without a stack to read.
+export function createDescriptorShapeGuard(bridge) {
+    const error = (detail) => new Error(`${bridge}: Descriptor shape changed between renders (${detail}) — a render-*.ts fn must ` +
+        `produce a CONSTANT tree shape; only prop values may vary between calls.`);
+    return {
+        error,
+        assertType(expected, actual) {
+            if (expected !== actual)
+                throw error(`${expected} -> ${actual}`);
+        },
+        assertChildCount(expected, actual) {
+            if (expected !== actual)
+                throw error(`child count ${expected} -> ${actual}`);
+        },
+        asText(child) {
+            if (typeof child !== 'string')
+                throw error(`text -> ${child.type}`);
+            return child;
+        },
+        asElement(child) {
+            if (typeof child === 'string')
+                throw error('element -> text');
+            return child;
+        },
+    };
+}

package/build/index.d.ts

@@ -1,10 +1,14 @@
 export { el, txt } from './descriptor';
 export type { IDescriptor, IDescriptorType, IDescriptorProps, IDescriptorChild, } from './descriptor';
+export { createDescriptorShapeGuard } from './descriptor';
+export type { IDescriptorShapeGuard } from './descriptor';
 export { resolveAccessibilityProps } from './accessibility-props';
+export { resolveTextProps } from './text-props';
+export type { IEllipsizeMode, ITextDefaultableProps } from './text-props';
 export type { IAccessibilityProps, IAriaProps, IAccessibilityRole, IRole, IAccessibilityStateValue, IAccessibilityValue, IAccessibilityActionInfo, } from './accessibility-props';
 export { descriptorFor, COMPONENT_DESCRIPTORS } from './component-names';
 export { buildDescriptors, makeDescriptorFor } from './component-names/shared';
-export type { ISymbioteIntrinsic, IComponentDescriptor } from './component-names/shared';
+export type { ISymbioteIntrinsic, IComponentDescriptor, } from './component-names/shared';
 export { renderActivityIndicator } from './view/render-activity-indicator';
 export type { IActivityIndicatorProps, IActivityIndicatorViewProps, IActivityIndicatorPlatform, IActivityIndicatorSize, } from './view/render-activity-indicator';
 export { renderSwitch } from './view/render-switch';
@@ -17,12 +21,12 @@ export type { IScrollIntrinsics, IContentSize, IScrollForwarding, IScrollForward
 export { buildScrollViewHandle, splitLayoutProps, attachStickyScroll, isSymbioteEvent, forwardScrollEvent, } from './scroll-view-commands';
 export type { IScrollViewHandle } from './scroll-view-commands';
 export { computeStickyInterpolation, nextStickyHeaderY, stickyDebounceMs, readLayoutNumber, STICKY_HEADER_Z_INDEX, } from './view/render-scroll-sticky';
-export type { IStickyHeaderProps, IStickyInterpolationParams } from './view/render-scroll-sticky';
+export type { IStickyHeaderProps, IStickyInterpolationParams, } from './view/render-scroll-sticky';
 export { reduceSticky, createInitialStickyState, stickyEffectSignature, } from './state/sticky-header-reducer';
 export type { IStickyHeaderState, IStickyReducerInputs, IStickyAction, IStickyEffect, IStickyReduceResult, } from './state/sticky-header-reducer';
 export type { IImageSource, IImageSourceProp, IResizeMode, IImageProps, IImageViewProps, } from './view/render-image';
 export { renderImage } from './view/render-image';
-export type { IImageStatics, IImageSize, IImageCacheStatus } from '@symbiote-native/engine';
+export type { IImageStatics, IImageSize, IImageCacheStatus, } from '@symbiote-native/engine';
 export { imageStatics, setImageSourceResolver } from '@symbiote-native/engine';
 export { renderImageBackground } from './view/render-image-background';
 export type { IImageBackgroundViewProps } from './view/render-image-background';
@@ -30,29 +34,33 @@ export { renderInputAccessoryView } from './view/render-input-accessory-view';
 export type { IInputAccessoryViewViewProps } from './view/render-input-accessory-view';
 export { renderModal } from './view/render-modal';
 export type { IModalViewProps, IModalAnimationType, IModalPresentationStyle, IModalOrientation, IModalOrientationChangeEvent, } from './view/render-modal';
-export { modalReducer, createInitialModalState, shouldRenderModal } from './state/modal';
+export { modalReducer, createInitialModalState, shouldRenderModal, } from './state/modal';
 export type { IModalState, IModalAction } from './state/modal';
-export { computeInset, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view';
-export type { IKeyboardAvoidingBehavior, IMeasuredFrame, IKeyboardFrame, IKeyboardAvoidingLayout, IResolveKeyboardAvoidingLayoutParams, } from './view/render-keyboard-avoiding-view';
+export { computeInset, keyboardAvoidingEventNamesFor, readPrefersCrossFadeTransitions, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view';
+export type { IComputeInsetOptions, IKeyboardAvoidingBehavior, IKeyboardAvoidingEventNames, IMeasuredFrame, IKeyboardFrame, IKeyboardAvoidingLayout, IResolveKeyboardAvoidingLayoutParams, } from './view/render-keyboard-avoiding-view';
 export { createPressHandlers, createPressRuntime, normalizeRect, maxEdge, isTouchWithinRegion, readPoint, computeRegion, rippleProps, DEFAULT_DELAY_LONG_PRESS_MS, DEFAULT_PRESS_RECT_OFFSETS, } from './state/pressable';
 export type { IPressState, IPressHandler, IPressHandlers, IPressHost, IPressRuntime, IPressMachineConfig, IFrameCallback, IRectOffset, IEdgeInsets, IResponderRegion, IPressableAndroidRippleConfig, IRippleBackground as IPressableRippleBackground, } from './state/pressable';
 export { buildPressableListeners, resolveDisabledAccessibilityState, noteHoverNoop, shouldSuppressPress, shouldClaimResponder, isTerminationAllowed, } from './view/render-pressable';
-export { computePressOutWait, createTouchableFeedbackRuntime, createTouchableFeedbackHandlers, DEFAULT_ACTIVE_OPACITY, OPACITY_ACTIVE_DURATION_MS, OPACITY_INACTIVE_DURATION_MS, RESTING_OPACITY, DEFAULT_HIGHLIGHT_CHILD_OPACITY, DEFAULT_UNDERLAY_COLOR, DEFAULT_MIN_PRESS_DURATION_MS, } from './state/touchable';
-export type { IPressTimingProps, ITouchableHandler, ITouchableFeedbackRuntime, ITouchableFeedbackConfig, ITouchableFeedbackCallbacks, ITouchableFeedbackHandlers, } from './state/touchable';
-export { highlightPressedStyle } from './view/render-touchable-highlight';
+export { computePressOutWait, createTouchableFeedbackRuntime, createTouchableFeedbackHandlers, DEFAULT_ACTIVE_OPACITY, OPACITY_ACTIVE_GRANT_DURATION_MS, OPACITY_ACTIVE_DURATION_MS, OPACITY_INACTIVE_DURATION_MS, RESTING_OPACITY, DEFAULT_HIGHLIGHT_CHILD_OPACITY, DEFAULT_UNDERLAY_COLOR, TOUCHABLE_MIN_PRESS_DURATION_MS, restingOpacityFromStyle, hasTouchablePressHandler, createHighlightUnderlayRuntime, createHighlightUnderlayHandlers, } from './state/touchable';
+export type { IPressTimingProps, ITouchableHandler, ITouchableFeedbackRuntime, ITouchableFeedbackConfig, ITouchableFeedbackCallbacks, ITouchableFeedbackHandlers, ITouchablePressHandlerProps, IHighlightUnderlayRuntime, IHighlightUnderlayConfig, IHighlightUnderlayCallbacks, IHighlightUnderlayHandlers, } from './state/touchable';
+export { resolveHighlightExtraStyles } from './view/render-touchable-highlight';
+export type { ITouchableHighlightExtraStyles, ITouchableHighlightUnderlayView, } from './view/render-touchable-highlight';
 export { backgroundProps, canUseNativeForeground, selectableBackground, selectableBackgroundBorderless, rippleBackground, } from './view/render-touchable-native-feedback';
 export type { INativeFeedbackBackground, IThemeAttrBackground, IRippleBackground, } from './view/render-touchable-native-feedback';
 export { BUTTON_ACCESSIBILITY_ROLE, buttonTextStyle, resolveButtonTextStyle, } from './view/render-button';
 export type { IButtonProps } from './view/render-button';
 export { resolveTextInputProps, foldText, foldAutoComplete, foldSubmitBehavior, mapAutoComplete, textFromChange, eventCountFromChange, shouldCommandText, INITIAL_EVENT_COUNT, SELECTION_NONE, } from './state/text-input';
 export type { ITextInputProps, ITextInputHandle, ITextInputSelection, ITextInputEventHandler, ITextInputFoldInput, IFoldedTextInputProps, IInputMode, IEnterKeyHint, ISubmitBehavior, } from './state/text-input';
+export { keyboardTypeForInputMode } from './state/text-input';
 export { renderTextInput } from './view/render-text-input';
 export type { ITextInputViewProps } from './view/render-text-input';
-export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_END_REACHED_THRESHOLD, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, DEFAULT_START_REACHED_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, buildOffsets, computeWindow, throttleWindow, visiblePercent, isCellViewable, offsetForIndex, averageMeasuredLength, highestMeasuredIndex, computeEndReached, computeStartReached, buildViewabilityPairs, computeViewableSet, diffViewable, maxMinimumViewTime, buildListPlan, computeMvcpAdjustment, resolveItemKey, indexOfItem, offsetForEnd, isSeparatorGapInRange, decideEdgeReached, resolveStickySectionHeaders, wrapFixedLayout, resolveAverageLength, } from './state/virtualized-list';
+export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_END_REACHED_THRESHOLD, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, DEFAULT_START_REACHED_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, readLayoutOffset, buildOffsets, computeWindow, throttleWindow, visiblePercent, isCellViewable, offsetForIndex, averageMeasuredLength, averageMeasuredStride, highestMeasuredIndex, computeEndReached, computeStartReached, buildViewabilityPairs, computeViewableSet, diffViewable, maxMinimumViewTime, buildListPlan, computeMvcpAdjustment, resolveItemKey, indexOfItem, offsetForEnd, isSeparatorGapInRange, decideEdgeReached, resolveStickySectionHeaders, wrapFixedLayout, resolveAverageLength, } from './state/virtualized-list';
 export type { IMvcpAction, IMvcpAdjustmentParams, IMvcpAdjustmentResult, ICellLayout, ISeparators, ISeparatorProps, IViewToken, IViewableItemsChangedInfo, IViewabilityConfig, IViewabilityConfigCallbackPair, IVirtualizedListHandle, IViewableSetParams, IListCellPlan, IListPlan, IListPlanParams, } from './state/virtualized-list';
 export { reduceList, createInitialListState, listEffectSignature, } from './state/virtualized-list-reducer';
 export type { IListState, IListMetrics, IListReducerInputs, IListAction, IListEffect, IListReduceResult, } from './state/virtualized-list-reducer';
+export { subscribeListDiagnostics } from './state/virtualized-list-diagnostics';
+export type { IListDiagnosticFrame, IListDiagnosticMove, } from './state/virtualized-list-diagnostics';
 export { SINGLE_COLUMN, chunkIntoRows, rowKeyExtractor, expandRowToken, expandRowViewability, lastItemOfRow, firstItemOfRow, } from './state/flat-list';
 export type { IRow } from './state/flat-list';
 export { flattenSections, unwrapEntryItem, sectionEntryKey, scrollLocationToFlatIndex, } from './state/section-list';
-export type { ISection, ISectionEntry, IVirtualizedSectionListHandle } from './state/section-list';
+export type { ISection, ISectionEntry, IVirtualizedSectionListHandle, } from './state/section-list';

package/build/index.js

@@ -3,10 +3,15 @@
 // wires state→render with ITS lifecycle (React hooks / Vue reactivity) and maps the
 // Descriptor onto its own element.
 export { el, txt } from './descriptor.js';
+// The shape-stability guard a fine-grained adapter's Descriptor bridge builds on. Internal to
+// adapter bridges (Svelte's and Solid's), NOT part of an app's surface — so it stays out of the
+// adapter barrels, unlike the passthrough names in tests/adapter-barrel-parity.test.ts.
+export { createDescriptorShapeGuard } from './descriptor.js';
 // Accessibility folding: the web-alias (aria-*/role) → canonical accessibility* transform
 // and its types. Framework-agnostic, so React, Vue, and the next adapter all fold
 // identically; moved here from @symbiote-native/react. RefreshControl/SafeAreaView/ScrollView consume it.
 export { resolveAccessibilityProps } from './accessibility-props.js';
+export { resolveTextProps } from './text-props.js';
 // Intrinsic (`symbiote-*`) → Fabric view-name resolution. Shared by every adapter so the
 // names CANNOT drift between them (one engine, one Fabric). The name tables are
 // Metro-split (.ios/.android, filename selects, no Platform.OS read); the base
@@ -37,9 +42,9 @@ export { renderImageBackground } from './view/render-image-background.js';
 export { renderInputAccessoryView } from './view/render-input-accessory-view.js';
 // Modal: full 3-layer split (state machine gates the iOS keep-alive frame).
 export { renderModal } from './view/render-modal.js';
-export { modalReducer, createInitialModalState, shouldRenderModal } from './state/modal.js';
+export { modalReducer, createInitialModalState, shouldRenderModal, } from './state/modal.js';
 // KeyboardAvoidingView: pure inset/behavior math; the adapter owns the Keyboard subscription.
-export { computeInset, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view.js';
+export { computeInset, keyboardAvoidingEventNamesFor, readPrefersCrossFadeTransitions, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view.js';
 // Pressable: the press state machine (logic) + render decisions. The pure lifecycle (timers,
 // geometry, drift test, suppression flags) lives in state/pressable; the responder-listener +
 // accessibilityState + ripple render decisions in view/render-pressable. Every adapter supplies
@@ -48,8 +53,8 @@ export { createPressHandlers, createPressRuntime, normalizeRect, maxEdge, isTouc
 export { buildPressableListeners, resolveDisabledAccessibilityState, noteHoverNoop, shouldSuppressPress, shouldClaimResponder, isTerminationAllowed, } from './view/render-pressable/index.js';
 // Touchable*: shared press-timing constants + the deactivation-floor math (the Animated feedback
 // itself stays per-adapter), and TouchableNativeFeedback's pure static factories + background map.
-export { computePressOutWait, createTouchableFeedbackRuntime, createTouchableFeedbackHandlers, DEFAULT_ACTIVE_OPACITY, OPACITY_ACTIVE_DURATION_MS, OPACITY_INACTIVE_DURATION_MS, RESTING_OPACITY, DEFAULT_HIGHLIGHT_CHILD_OPACITY, DEFAULT_UNDERLAY_COLOR, DEFAULT_MIN_PRESS_DURATION_MS, } from './state/touchable.js';
-export { highlightPressedStyle } from './view/render-touchable-highlight.js';
+export { computePressOutWait, createTouchableFeedbackRuntime, createTouchableFeedbackHandlers, DEFAULT_ACTIVE_OPACITY, OPACITY_ACTIVE_GRANT_DURATION_MS, OPACITY_ACTIVE_DURATION_MS, OPACITY_INACTIVE_DURATION_MS, RESTING_OPACITY, DEFAULT_HIGHLIGHT_CHILD_OPACITY, DEFAULT_UNDERLAY_COLOR, TOUCHABLE_MIN_PRESS_DURATION_MS, restingOpacityFromStyle, hasTouchablePressHandler, createHighlightUnderlayRuntime, createHighlightUnderlayHandlers, } from './state/touchable.js';
+export { resolveHighlightExtraStyles } from './view/render-touchable-highlight.js';
 export { backgroundProps, canUseNativeForeground, selectableBackground, selectableBackgroundBorderless, rippleBackground, } from './view/render-touchable-native-feedback.js';
 // Button: shared base text style, role constant, and color fold (the adapter composes its own
 // TouchableOpacity + Text).
@@ -60,15 +65,17 @@ export { BUTTON_ACCESSIBILITY_ROLE, buttonTextStyle, resolveButtonTextStyle, } f
 // resolved native props. Both shared verbatim across React and Vue; the adapter owns only the
 // hooks/reactivity + the imperative handle.
 export { resolveTextInputProps, foldText, foldAutoComplete, foldSubmitBehavior, mapAutoComplete, textFromChange, eventCountFromChange, shouldCommandText, INITIAL_EVENT_COUNT, SELECTION_NONE, } from './state/text-input.js';
+export { keyboardTypeForInputMode } from './state/text-input.js';
 export { renderTextInput } from './view/render-text-input.js';
 // VirtualizedList family: the framework-agnostic windowing engine + data shapes. Lists
 // have NO view/render-*.ts (the cell content is the framework's own children, so there is
 // no Descriptor render fn) — the shared layer for lists is this STATE/logic, reused
 // verbatim by React and Vue.
-export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_END_REACHED_THRESHOLD, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, DEFAULT_START_REACHED_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, buildOffsets, computeWindow, throttleWindow, visiblePercent, isCellViewable, offsetForIndex, averageMeasuredLength, highestMeasuredIndex, computeEndReached, computeStartReached, buildViewabilityPairs, computeViewableSet, diffViewable, maxMinimumViewTime, buildListPlan, computeMvcpAdjustment, resolveItemKey, indexOfItem, offsetForEnd, isSeparatorGapInRange, decideEdgeReached, resolveStickySectionHeaders, wrapFixedLayout, resolveAverageLength, } from './state/virtualized-list.js';
+export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_END_REACHED_THRESHOLD, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, DEFAULT_START_REACHED_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, readLayoutOffset, buildOffsets, computeWindow, throttleWindow, visiblePercent, isCellViewable, offsetForIndex, averageMeasuredLength, averageMeasuredStride, highestMeasuredIndex, computeEndReached, computeStartReached, buildViewabilityPairs, computeViewableSet, diffViewable, maxMinimumViewTime, buildListPlan, computeMvcpAdjustment, resolveItemKey, indexOfItem, offsetForEnd, isSeparatorGapInRange, decideEdgeReached, resolveStickySectionHeaders, wrapFixedLayout, resolveAverageLength, } from './state/virtualized-list.js';
 // The orchestration reducer: the one pure state machine every list adapter drives, folding the
 // after-commit effect skeleton (window recompute -> edge -> viewability -> initial-scroll -> MVCP)
 // out of each adapter's reactive glue. The adapter maps events to actions and runs the effects.
 export { reduceList, createInitialListState, listEffectSignature, } from './state/virtualized-list-reducer.js';
+export { subscribeListDiagnostics } from './state/virtualized-list-diagnostics.js';
 export { SINGLE_COLUMN, chunkIntoRows, rowKeyExtractor, expandRowToken, expandRowViewability, lastItemOfRow, firstItemOfRow, } from './state/flat-list.js';
 export { flattenSections, unwrapEntryItem, sectionEntryKey, scrollLocationToFlatIndex, } from './state/section-list.js';

package/build/scroll-view-commands.js

@@ -116,5 +116,9 @@ export function attachStickyScroll(node, value) {
     const attachment = attachNativeEvent(node, 'onScroll', [
         { nativeEvent: { contentOffset: { y: value } } },
     ]);
-    return () => attachment.detach();
+    dlog(`STICKY[attach] attachStickyScroll onScroll -> value#${value.__getNativeTag?.() ?? 'js'}`);
+    return () => {
+        dlog('STICKY[attach] attachStickyScroll detached');
+        attachment.detach();
+    };
 }

package/build/state/pressable.js

@@ -13,7 +13,12 @@ import { dlog, Platform } from '@symbiote-native/engine';
 export const DEFAULT_DELAY_LONG_PRESS_MS = 500;
 // RN's default extra slop kept around a press once it is active, before a drift fires pressOut.
 // The PressRect extension (Pressability.js DEFAULT_PRESS_RECT_OFFSETS). Per-edge, deeper bottom.
-export const DEFAULT_PRESS_RECT_OFFSETS = { top: 20, left: 20, bottom: 30, right: 20 };
+export const DEFAULT_PRESS_RECT_OFFSETS = {
+    top: 20,
+    left: 20,
+    bottom: 30,
+    right: 20,
+};
 // ---- geometry (pure) --------------------------------------------------------------------------
 // A rect offset is a per-edge object (not the scalar shorthand). Reads the asymmetric form
 // without a cast.
@@ -58,7 +63,12 @@ export function readPoint(event) {
 export function computeRegion(width, height, pageX, pageY) {
     if (!width && !height && !pageX && !pageY)
         return undefined;
-    return { left: pageX, top: pageY, right: pageX + width, bottom: pageY + height };
+    return {
+        left: pageX,
+        top: pageY,
+        right: pageX + width,
+        bottom: pageY + height,
+    };
 }
 // Build the Android native-feedback prop the inner View carries from the ripple config. RN runs
 // the color through processColor → a native int; we have no native bridge in JS, so we keep the
@@ -132,7 +142,7 @@ export function createPressHandlers(config, runtime, host) {
         const origin = runtime.pressOrigin;
         if (origin === undefined)
             return true;
-        return Math.hypot(point.x - origin.x, point.y - origin.y) <= fallbackThreshold;
+        return (Math.hypot(point.x - origin.x, point.y - origin.y) <= fallbackThreshold);
     }
     function clearLongPress() {
         if (runtime.longPressCancel !== undefined) {

package/build/state/sticky-header-reducer.d.ts

@@ -6,6 +6,7 @@ export interface IStickyHeaderState {
     haveReceivedInitialZeroTranslateY: boolean;
     inputRange: number[];
     outputRange: number[];
+    rangesEmitted: boolean;
 }
 export interface IStickyReducerInputs {
     os: string;

package/build/state/sticky-header-reducer.js

@@ -15,7 +15,7 @@
 // ./view/render-scroll-sticky; this module composes them into the ordered transition every adapter
 // shares. Ported from ScrollViewStickyHeader.js's effect.
 import { dlog } from '@symbiote-native/engine';
-import { computeStickyInterpolation, stickyDebounceMs } from '../view/render-scroll-sticky.js';
+import { computeStickyInterpolation, stickyDebounceMs, } from '../view/render-scroll-sticky.js';
 // The un-measured identity interpolation (RN: a fresh AnimatedInterpolation before the header has
 // measured its own y/height). Kept as the reset the initial state and every rebuild start from.
 const IDENTITY_INPUT_RANGE = [-1, 0];
@@ -30,6 +30,7 @@ export function createInitialStickyState() {
         haveReceivedInitialZeroTranslateY: true,
         inputRange: [...IDENTITY_INPUT_RANGE],
         outputRange: [...IDENTITY_OUTPUT_RANGE],
+        rangesEmitted: false,
     };
 }
 // A cheap signature over the render-relevant state (the ranges + the committed translateY). The
@@ -37,6 +38,11 @@ export function createInitialStickyState() {
 export function stickyEffectSignature(state) {
     return `${state.inputRange.join(',')}|${state.outputRange.join(',')}|${state.translateY}`;
 }
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    return a.every((value, index) => value === b[index]);
+}
 // Recompute the derived interpolation ranges off the current state + inputs (wrapping the load-bearing
 // computeStickyInterpolation math), store them, and return them for the rebuild effect.
 function deriveRanges(state, inputs) {
@@ -54,27 +60,95 @@ function deriveRanges(state, inputs) {
 }
 // The single transition every sticky-header adapter shares. The adapter maps a native event / animated
 // tick / timer fire to an action, calls this, stores the returned state, and executes the effects.
+// DIAGNOSTIC-only, gated: identifies which header instance a log line belongs to across a
+// device dump without needing full state dumps at every call — layoutY doubles as a stable
+// per-header id once measured (0 before the first layout).
+function headerTag(state) {
+    return `y=${state.layoutY}`;
+}
 export function reduceSticky(state, action, inputs) {
+    dlog(`STICKY[reducer ${headerTag(state)}] action=${action.kind}` +
+        (action.kind === 'layout'
+            ? ` y=${action.y} height=${action.height}`
+            : '') +
+        (action.kind === 'animated-tick' || action.kind === 'debounce-fired'
+            ? ` value=${action.value}`
+            : '') +
+        ` inputs={inverted=${inputs.inverted} scrollViewHeight=${inputs.scrollViewHeight} nextHeaderLayoutY=${inputs.nextHeaderLayoutY}}`);
     switch (action.kind) {
         case 'layout': {
             // Record own y/height, mark measured, rebuild the interpolation, and (when the reducer owns the
             // cross-talk index) hand the parent this header's y so the PREVIOUS header learns its collision
             // point. Matches RN ScrollViewStickyHeader.js._onLayout.
+            //
+            // Redundant-geometry guard: Yoga legitimately re-fires onLayout with the SAME y/height (relayout
+            // passes triggered by an unrelated sibling, a native-driven prop commit, ...) — every consumer
+            // must tolerate that. React's port gets this guard for FREE: `setLayoutY(sameValue)` is a no-op
+            // (React bails out of re-rendering on an unchanged primitive), so a redundant onLayout never
+            // reaches the rebuild `useEffect`. This reducer has no such implicit bail-out, so it must skip
+            // the rebuild explicitly — device-confirmed (2026-08-13) that omitting this guard lets a
+            // native-driven rebuild (fresh AnimatedProps/AnimatedStyle graph, fresh native connect) commit a
+            // fresh prop identity on every redundant layout, which can itself provoke another relayout pass —
+            // an unbounded same-tick rebuild ping-pong that trips Svelte's effect_update_depth_exceeded guard.
+            const alreadyAtThisGeometry = state.measured &&
+                state.layoutY === action.y &&
+                state.layoutHeight === action.height;
             state.layoutY = action.y;
             state.layoutHeight = action.height;
             state.measured = true;
-            const { inputRange, outputRange } = deriveRanges(state, inputs);
             const effects = [];
             if (inputs.index !== undefined) {
-                effects.push({ kind: 'record-header-y', index: inputs.index, y: action.y });
+                effects.push({
+                    kind: 'record-header-y',
+                    index: inputs.index,
+                    y: action.y,
+                });
             }
+            if (alreadyAtThisGeometry && state.rangesEmitted) {
+                dlog(`STICKY[reducer ${headerTag(state)}] layout: redundant geometry, skipped rebuild`);
+                return { state, effects, changed: effects.length > 0 };
+            }
+            const { inputRange, outputRange } = deriveRanges(state, inputs);
+            state.rangesEmitted = true;
+            dlog(`STICKY[reducer ${headerTag(state)}] layout: measured=true inputRange=${JSON.stringify(inputRange)} ` +
+                `outputRange=${JSON.stringify(outputRange)}`);
             effects.push({ kind: 'rebuild-interpolation', inputRange, outputRange });
             return { state, effects, changed: true };
         }
         case 'inputs-changed': {
             // A collision/viewport input changed (RN effect deps: inverted, scrollViewHeight,
             // nextHeaderLayoutY): recompute the ranges and rebuild.
+            //
+            // Redundant-ranges guard (sibling of 'layout's `alreadyAtThisGeometry` above, same root
+            // cause): the adapter's own mount `$effect` re-dispatches 'inputs-changed' whenever its
+            // `inverted`/`scrollViewHeight`/`nextHeaderLayoutY` derived values re-evaluate — which can
+            // happen on an unrelated parent re-render (e.g. VirtualizedList re-deriving
+            // `nextHeaderLayoutYFor(cell.index)` off its cross-talk Map on every reactive pass) even when
+            // the COMPUTED value is identical. React gets no implicit protection here either (this is a
+            // real `useEffect` with real deps), but RN's own deps array only fires on an ACTUAL primitive
+            // change; a framework-agnostic caller re-dispatching on every derive needs the reducer itself
+            // to compare the RESULT (the ranges), not the raw inputs (which may recompute to the same
+            // ranges via different intermediate values) — device-confirmed (2026-08-13) this is a second,
+            // independent source of the same unbounded same-tick rebuild loop the 'layout' guard fixed.
+            const previousInputRange = state.inputRange;
+            const previousOutputRange = state.outputRange;
+            const hadEmitted = state.rangesEmitted;
             const { inputRange, outputRange } = deriveRanges(state, inputs);
+            state.rangesEmitted = true;
+            // `hadEmitted` is load-bearing, not defensive: an unmeasured header derives exactly the
+            // identity ranges the initial state already holds, so without it the FIRST dispatch (Angular
+            // sends one from ngOnInit, before any layout) reads as redundant and the header never emits
+            // a rebuild at all — its wrapper then never commits. Regression-covered in
+            // sticky-header-reducer.test.ts.
+            if (hadEmitted &&
+                arraysEqual(previousInputRange, inputRange) &&
+                arraysEqual(previousOutputRange, outputRange)) {
+                dlog(`STICKY[reducer ${headerTag(state)}] inputs-changed: ranges unchanged, skipped rebuild`);
+                return { state, effects: [], changed: false };
+            }
+            dlog(`STICKY[reducer ${headerTag(state)}] inputs-changed: inputRange ${JSON.stringify(previousInputRange)}->` +
+                `${JSON.stringify(inputRange)} outputRange ${JSON.stringify(previousOutputRange)}->` +
+                `${JSON.stringify(outputRange)}`);
             return {
                 state,
                 effects: [{ kind: 'rebuild-interpolation', inputRange, outputRange }],
@@ -87,20 +161,38 @@ export function reduceSticky(state, action, inputs) {
             // settled value into the committed transform for hit-testing.
             if (action.value === 0 && !state.haveReceivedInitialZeroTranslateY) {
                 state.haveReceivedInitialZeroTranslateY = true;
-                dlog('sticky-header swallowed re-emitted zero translateY');
+                dlog(`STICKY[reducer ${headerTag(state)}] animated-tick: swallowed re-emitted zero translateY`);
                 return { state, effects: [], changed: false };
             }
+            dlog(`STICKY[reducer ${headerTag(state)}] animated-tick: scheduling debounce delay=${stickyDebounceMs(inputs.os)} ` +
+                `value=${action.value}`);
             return {
                 state,
                 effects: [
-                    { kind: 'schedule-debounce', delay: stickyDebounceMs(inputs.os), value: action.value },
+                    {
+                        kind: 'schedule-debounce',
+                        delay: stickyDebounceMs(inputs.os),
+                        value: action.value,
+                    },
                 ],
                 changed: false,
             };
         }
         case 'debounce-fired': {
+            // Already sitting at this value: emit nothing. Same bail-out the 'layout' case above spells
+            // out, for the same reason - React's own header gets it free from setTranslateY (an unchanged
+            // primitive bails out of the re-render), a reducer has to say it. Device-confirmed 2026-08-18:
+            // without it a re-arriving settled value emits apply-passthrough, the adapter force-renders,
+            // the passthrough prop gets a fresh identity, the animated graph reconnects and re-emits into
+            // another tick -> another debounce -> another passthrough. One header survives it; a screen of
+            // 200 trips React's "Maximum update depth exceeded" and takes the app down.
+            if (state.translateY === action.value) {
+                dlog(`STICKY[reducer ${headerTag(state)}] debounce-fired: already at translateY=${action.value}, no-op`);
+                return { state, effects: [], changed: false };
+            }
             // The debounce completed: commit the settled translateY. Once a NON-zero value commits, re-arm
             // the swallow gate so the next interpolation rebuild's spurious 0 is dropped (RN).
+            dlog(`STICKY[reducer ${headerTag(state)}] debounce-fired: committing translateY=${action.value}`);
             state.translateY = action.value;
             if (action.value !== 0)
                 state.haveReceivedInitialZeroTranslateY = false;

package/build/state/switch.js

@@ -27,5 +27,5 @@ export function valueFromChange(event) {
 // retained tree never diverges and nothing re-commits. The imperative command is the only
 // correction path. No report yet (null) or agreement → no command.
 export function shouldSnapBack(state, fabricValue) {
-    return state.lastNativeReport !== null && state.lastNativeReport !== fabricValue;
+    return (state.lastNativeReport !== null && state.lastNativeReport !== fabricValue);
 }

package/build/state/text-input.d.ts

@@ -1,4 +1,4 @@
-import type { ISymbioteEvent, ITextStyle } from '@symbiote-native/engine';
+import type { IPlatformOSType, ISymbioteEvent, ITextStyle } from '@symbiote-native/engine';
 import type { IAccessibilityProps, IAriaProps } from '../accessibility-props';
 export type IInputMode = 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
 export type IEnterKeyHint = 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
@@ -10,6 +10,7 @@ export type ITextInputSelection = {
 export type ITextInputEventHandler = (event: ISymbioteEvent) => void;
 export declare const INITIAL_EVENT_COUNT = 0;
 export declare const SELECTION_NONE = -1;
+export declare function keyboardTypeForInputMode(inputMode: string, os: IPlatformOSType): string | undefined;
 export declare function mapAutoComplete(map: Record<string, string>, token: string): string | undefined;
 export declare function foldAutoComplete(token: string | undefined): {
     autoComplete: string | undefined;

package/build/state/text-input.js

@@ -11,6 +11,7 @@
 // latest count, while `lastNativeText` is bookkeeping the controlled-write effect mutates
 // without a render. So the logic layer is the pure folds/maps + the controlled-write predicate;
 // each adapter holds the two pieces in ITS own primitives (React useState/useRef, Vue ref/let).
+import { Platform } from '@symbiote-native/engine';
 // The acknowledged count starts at 0, native has reported nothing yet, so the first
 // controlled write echoes 0 and lands on eventLag 0.
 export const INITIAL_EVENT_COUNT = 0;
@@ -29,11 +30,25 @@ const inputModeToKeyboardType = {
     email: 'email-address',
     none: 'default',
     numeric: 'number-pad',
-    search: 'default',
     tel: 'phone-pad',
     text: 'default',
     url: 'url',
 };
+// `search` is the ONE inputMode token RN resolves per platform (TextInput.js:815-825):
+//   search: Platform.OS === 'ios' ? 'web-search' : 'default'
+// iOS has a dedicated search keyboard whose return key is a magnifier; every other host falls back
+// to the default one. It is deliberately absent from the map above, so there is one source for it
+// rather than a map entry and an override that can drift apart.
+//
+// The host is an ARGUMENT rather than a `Platform.OS` read inside the body, because the headless
+// Platform module always resolves to iOS (platform/index.ts re-exports index.ios) — a direct read
+// would leave the android branch permanently unprovable. resolveTextInputProps supplies the real
+// value. This costs the callers nothing: the exported fold signature is unchanged.
+export function keyboardTypeForInputMode(inputMode, os) {
+    if (inputMode === 'search')
+        return os === 'ios' ? 'web-search' : 'default';
+    return mapAutoComplete(inputModeToKeyboardType, inputMode);
+}
 // RN's enterKeyHint -> returnKeyType map (TextInput.js:805). Note `enter` -> 'default'.
 const enterKeyHintToReturnKeyType = {
     done: 'done',
@@ -122,7 +137,9 @@ const autoCompleteWebToTextContentType = {
 // if the token has no native equivalent. The caller decides the per-platform fallback. Named
 // for its first user (autoComplete), but it is the one generic safe lookup every map shares.
 export function mapAutoComplete(map, token) {
-    return Object.prototype.hasOwnProperty.call(map, token) ? map[token] : undefined;
+    return Object.prototype.hasOwnProperty.call(map, token)
+        ? map[token]
+        : undefined;
 }
 // RN folds W3C `autoComplete` per platform (TextInput.js:938): Android takes the mapped
 // `autoComplete` token (falling back to the raw token), iOS takes the mapped `textContentType`
@@ -187,7 +204,7 @@ export function resolveTextInputProps(input) {
     const folded = foldAutoComplete(input.autoComplete);
     return {
         keyboardType: input.inputMode !== undefined
-            ? mapAutoComplete(inputModeToKeyboardType, input.inputMode)
+            ? keyboardTypeForInputMode(input.inputMode, Platform.OS)
             : input.keyboardType,
         returnKeyType: input.enterKeyHint !== undefined
             ? mapAutoComplete(enterKeyHintToReturnKeyType, input.enterKeyHint)
@@ -195,11 +212,21 @@ export function resolveTextInputProps(input) {
         editable: input.readOnly !== undefined ? !input.readOnly : input.editable,
         submitBehavior: foldSubmitBehavior(input.submitBehavior, input.blurOnSubmit, input.multiline),
         selectionColor: input.selectionColor,
-        cursorColor: input.cursorColor !== undefined ? input.cursorColor : input.selectionColor,
-        selectionHandleColor: input.selectionHandleColor !== undefined ? input.selectionHandleColor : input.selectionColor,
-        underlineColorAndroid: input.underlineColorAndroid !== undefined ? input.underlineColorAndroid : 'transparent',
+        cursorColor: input.cursorColor !== undefined
+            ? input.cursorColor
+            : input.selectionColor,
+        selectionHandleColor: input.selectionHandleColor !== undefined
+            ? input.selectionHandleColor
+            : input.selectionColor,
+        underlineColorAndroid: input.underlineColorAndroid !== undefined
+            ? input.underlineColorAndroid
+            : 'transparent',
         autoComplete: folded.autoComplete,
-        textContentType: input.textContentType !== undefined ? input.textContentType : folded.textContentType,
-        showSoftInputOnFocus: input.inputMode !== undefined ? input.inputMode !== 'none' : input.showSoftInputOnFocus,
+        textContentType: input.textContentType !== undefined
+            ? input.textContentType
+            : folded.textContentType,
+        showSoftInputOnFocus: input.inputMode !== undefined
+            ? input.inputMode !== 'none'
+            : input.showSoftInputOnFocus,
     };
 }