@symbiote-native/components 1.0.0 → 3.0.0

package/build/component-names/shared.js

@@ -7,7 +7,7 @@
 // The only text-laying intrinsic; drives the RCTText / RCTVirtualText nesting choice
 // (a <Text> inside another <Text> becomes a virtual span). Platform-invariant, so it is
 // not part of the per-platform name table.
-const TEXT_INTRINSICS = new Set(['symbiote-text']);
+const TEXT_INTRINSICS = new Set(['text']);
 // Assemble the descriptor map a platform file exports: each intrinsic's Fabric name from
 // the platform table, paired with its invariant isText flag.
 export function buildDescriptors(names) {
@@ -32,12 +32,23 @@ export function makeDescriptorFor(descriptors) {
         const descriptor = descriptors[type];
         if (descriptor !== undefined)
             return descriptor;
-        if (type.startsWith('symbiote-')) {
-            throw new Error(`Unknown symbiote component type: ${type}`);
-        }
+        // NO "unknown tag of ours" throw any more, and the reason is the whole cost of dropping the
+        // prefix: `symbiote-*` was a MARKER, so a miss carrying it could only be our own typo. Without
+        // it this namespace holds three populations that a string cannot tell apart —
+        //
+        //   view · scroll-view          ours
+        //   counter-child · app-root    an Angular app's OWN component selectors, kebab by convention
+        //   RCTView · RNCSlider         a Fabric view name, resolving through the fallthrough below
+        //
+        // — and the first attempt at a replacement ("lowercase is ours") threw on the second row, which
+        // is most of an Angular app. Measured: 222 tests, the primary failure being `counter-child`.
+        //
+        // What replaces it is stronger and is not runtime at all: `ISymbioteIntrinsic` is a closed
+        // union, so a misspelled tag in our own source is a compile error at every call site that names
+        // one. The guard was only ever a backstop for a name built dynamically.
         if (unrewritten.has(type)) {
             throw new Error(`"${type}" is a primitive's PUBLIC name, not a Fabric view name — a rewrite was missed. ` +
-                `Expected the intrinsic tag (e.g. "symbiote-view"). Falling through would have committed ` +
+                `Expected the intrinsic tag (e.g. "view"). Falling through would have committed ` +
                 `a Fabric view literally named "${type}", which fails on device only.`);
         }
         return { component: type, isText: false };
@@ -64,7 +75,6 @@ function publicNamesThatAreNotViewNames(descriptors) {
     const names = new Set();
     for (const intrinsic of Object.keys(descriptors)) {
         const publicName = intrinsic
-            .slice('symbiote-'.length)
             .split('-')
             .map(part => part.charAt(0).toUpperCase() + part.slice(1))
             .join('');

package/build/descriptor.js

@@ -4,14 +4,14 @@
 // adapter's host element then flows on through its reconciler → engine → Fabric.
 //
 // `type` is an open host-component string, not a closed two-member union, because
-// symbiote paints one host element PER native component (`symbiote-activity-indicator`,
-// `symbiote-switch`, …), not just a generic box/text pair.
-// el(): a host element of any type. txt(): shorthand for the `symbiote-text` primitive.
+// symbiote paints one host element PER native component (`activity-indicator`,
+// `switch`, …), not just a generic box/text pair.
+// el(): a host element of any type. txt(): shorthand for the `text` primitive.
 export function el(type, props = {}, children = [], key) {
     return { type, props, children, key };
 }
 export function txt(props = {}, children = []) {
-    return { type: 'symbiote-text', props, children };
+    return { type: 'text', props, children };
 }
 // `bridge` names the caller (`descriptorToSolid`, `descriptorToSvelte`) so a device log says which
 // one tripped without a stack to read.

package/build/index.d.ts

@@ -3,22 +3,18 @@ export type { IDescriptor, IDescriptorType, IDescriptorProps, IDescriptorChild,
 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 { IEllipsizeMode } 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 { renderActivityIndicator } from './view/render-activity-indicator';
-export type { IActivityIndicatorProps, IActivityIndicatorViewProps, IActivityIndicatorPlatform, IActivityIndicatorSize, } from './view/render-activity-indicator';
-export { renderSwitch } from './view/render-switch';
-export type { ISwitchProps, ISwitchViewProps, ISwitchPlatform, ISwitchTrackColor, } from './view/render-switch';
+export type { ISymbioteIntrinsic, IComponentDescriptor, ICrossTypedIntrinsics, } from './component-names/shared';
+export type { ISwitchProps, ISwitchTrackColor, ISwitchChangeEvent, } from './view/render-switch';
 export type { IResponderProps } from './responder-props';
 export { switchReducer, createInitialSwitchState, shouldSnapBack, valueFromChange, } from './state/switch';
 export type { ISwitchState, ISwitchAction } from './state/switch';
-export { resolveDecelerationRate, selectScrollIntrinsics, readLayoutDimension, didContentSizeChange, resolveScrollForwarding, SCROLL_VIEW_BASE_HORIZONTAL, SCROLL_VIEW_BASE_VERTICAL, } from './view/render-scroll-view';
+export { selectScrollIntrinsics, readLayoutDimension, didContentSizeChange, resolveScrollForwarding, } from './view/render-scroll-view';
 export type { IScrollIntrinsics, IContentSize, IScrollForwarding, IScrollForwardingInputs, IScrollForwardMode, } from './view/render-scroll-view';
-export { buildScrollViewHandle, splitLayoutProps, attachStickyScroll, isSymbioteEvent, forwardScrollEvent, } from './scroll-view-commands';
+export { buildScrollViewHandle, 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';
@@ -28,33 +24,27 @@ export type { IImageSource, IImageSourceProp, IResizeMode, IImageProps, IImageVi
 export { renderImage } from './view/render-image';
 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';
-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 type { IModalState, IModalAction } from './state/modal';
-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, disposePressRuntime, normalizeRect, maxEdge, isTouchWithinRegion, readPoint, computeRegion, rippleProps, DEFAULT_DELAY_LONG_PRESS_MS, DEFAULT_MIN_PRESS_DURATION_MS, DEFAULT_PRESS_RECT_OFFSETS, } from './state/pressable';
+export { computeInset, configureKeyboardAvoidingAnimation, keyboardAvoidingEventNamesFor, readKeyboardAnimationTiming, readPrefersCrossFadeTransitions, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view';
+export type { IComputeInsetOptions, IKeyboardAnimationTiming, IKeyboardAvoidingBehavior, IKeyboardAvoidingEventNames, IMeasuredFrame, IKeyboardFrame, IKeyboardAvoidingLayout, IResolveKeyboardAvoidingLayoutParams, } from './view/render-keyboard-avoiding-view';
+export { createPressHandlers, createPressRuntime, disposePressRuntime, normalizeRect, maxEdge, isTouchWithinRegion, readPoint, computeRegion, DEFAULT_DELAY_LONG_PRESS_MS, DEFAULT_MIN_PRESS_DURATION_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 { buildPressableListeners, resolveDisabledAccessibilityState, noteHoverNoop, shouldSuppressPress, shouldClaimResponder, isTerminationAllowed, resolvePressableFocusable, resolveTouchableFocusable, } from './view/render-pressable';
 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 { canUseNativeForeground, selectableBackground, selectableBackgroundBorderless, rippleBackground, TouchableNativeFeedback, } 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 { resolveButtonDisabled } 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, 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 { foldText, textFromChange, eventCountFromChange, shouldCommandText, INITIAL_EVENT_COUNT, SELECTION_NONE, } from './state/text-input';
+export type { ITextInputProps, ITextInputHandle, ITextInputSelection, ITextInputEventHandler, IInputMode, IEnterKeyHint, ISubmitBehavior, ITextInputChangeEvent, } from './state/text-input';
+export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, readLayoutOffset, buildOffsets, computeWindow, throttleWindow, 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';
@@ -65,7 +55,17 @@ 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 { registerPressableBehavior, PRESSABLE_TAG, } from './behaviors/pressable';
-export { foldImagePayload, IMAGE_TAG, registerImageBehavior, } from './behaviors/image';
-export { foldInputAccessoryViewPayload, INPUT_ACCESSORY_VIEW_TAG, registerInputAccessoryViewBehavior, } from './behaviors/input-accessory-view';
+export { registerTouchableOpacityBehavior, TOUCHABLE_OPACITY_TAG, } from './behaviors/touchable-opacity';
+export { registerTouchableHighlightBehavior, TOUCHABLE_HIGHLIGHT_TAG, } from './behaviors/touchable-highlight';
+export { registerButtonBehavior, BUTTON_TAG } from './behaviors/button';
+export { registerTouchableNativeFeedbackBehavior, TOUCHABLE_NATIVE_FEEDBACK_TAG, } from './behaviors/touchable-native-feedback';
+export { registerTouchableWithoutFeedbackBehavior, TOUCHABLE_WITHOUT_FEEDBACK_TAG, } from './behaviors/touchable-without-feedback';
+export { ACTIVITY_INDICATOR_SPINNER_TAG, ACTIVITY_INDICATOR_TAG, registerActivityIndicatorBehavior, } from './behaviors/activity-indicator';
+export type { IActivityIndicatorProps, IActivityIndicatorSize, } from './behaviors/activity-indicator';
+export { IMAGE_TAG, registerImageBehavior } from './behaviors/image';
+export { IMAGE_BACKGROUND_TAG, registerImageBackgroundBehavior, } from './behaviors/image-background';
+export { INPUT_ACCESSORY_VIEW_TAG, registerInputAccessoryViewBehavior, } from './behaviors/input-accessory-view';
 export { registerTextInputBehavior, buildTextInputHandle, TEXT_INPUT_TAG, TEXT_INPUT_MULTILINE_TAG, } from './behaviors/text-input';
 export { registerSwitchBehavior, SWITCH_TAG } from './behaviors/switch';
+export { registerRefreshControlBehavior, REFRESH_CONTROL_TAG, } from './behaviors/refresh-control';
+export { HORIZONTAL_SCROLL_VIEW_TAG, registerScrollViewBehavior, SCROLL_VIEW_TAG, STICKY_HEADER_TAG, } from './behaviors/scroll-view';

package/build/index.js

@@ -11,23 +11,20 @@ export { createDescriptorShapeGuard } from './descriptor.js';
 // 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
 // re-exports iOS for headless. descriptorFor is the per-platform-bound resolver.
 export { descriptorFor, COMPONENT_DESCRIPTORS } from './component-names';
 export { buildDescriptors, makeDescriptorFor } from './component-names/shared.js';
-export { renderActivityIndicator } from './view/render-activity-indicator.js';
-export { renderSwitch } from './view/render-switch.js';
 // Switch is the first STATE machine off this layer (ActivityIndicator was render-only):
 // the reducer + the two pure predicates are the logic half, the adapter supplies the hook.
 export { switchReducer, createInitialSwitchState, shouldSnapBack, valueFromChange, } from './state/switch.js';
 // ScrollView: pure render/command helpers (no state machine, no 3-layer split). The adapter
 // owns the refs/effects/element assembly and the sticky-header component; these supply the
 // platform-invariant math and plumbing every adapter shares.
-export { resolveDecelerationRate, selectScrollIntrinsics, readLayoutDimension, didContentSizeChange, resolveScrollForwarding, SCROLL_VIEW_BASE_HORIZONTAL, SCROLL_VIEW_BASE_VERTICAL, } from './view/render-scroll-view.js';
-export { buildScrollViewHandle, splitLayoutProps, attachStickyScroll, isSymbioteEvent, forwardScrollEvent, } from './scroll-view-commands.js';
+export { selectScrollIntrinsics, readLayoutDimension, didContentSizeChange, resolveScrollForwarding, } from './view/render-scroll-view.js';
+export { buildScrollViewHandle, attachStickyScroll, isSymbioteEvent, forwardScrollEvent, } from './scroll-view-commands.js';
 export { computeStickyInterpolation, nextStickyHeaderY, stickyDebounceMs, readLayoutNumber, STICKY_HEADER_Z_INDEX, } from './view/render-scroll-sticky.js';
 // The per-header sticky effect machine: the one pure state machine every sticky-header consumer drives
 // (React/Vue header component, Angular header component, Angular projection wrapper), folding the
@@ -36,42 +33,42 @@ export { computeStickyInterpolation, nextStickyHeaderY, stickyDebounceMs, readLa
 export { reduceSticky, createInitialStickyState, stickyEffectSignature, } from './state/sticky-header-reducer.js';
 export { renderImage } from './view/render-image/index.js';
 export { imageStatics, setImageSourceResolver } from '@symbiote-native/engine';
-// ImageBackground: render-only composition (absolute-fill image behind, children on top).
-export { renderImageBackground } from './view/render-image-background.js';
-// InputAccessoryView: render-only host assembly (nativeID/backgroundColor).
-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';
 // KeyboardAvoidingView: pure inset/behavior math; the adapter owns the Keyboard subscription.
-export { computeInset, keyboardAvoidingEventNamesFor, readPrefersCrossFadeTransitions, readKeyboardFrame, readLayoutFrame, resolveKeyboardAvoidingLayout, DEFAULT_VERTICAL_OFFSET, } from './view/render-keyboard-avoiding-view.js';
+export { computeInset, configureKeyboardAvoidingAnimation, keyboardAvoidingEventNamesFor, readKeyboardAnimationTiming, 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
 // only its reactive `pressed` cell + the View's measure handle (see the 3-layer split).
-export { createPressHandlers, createPressRuntime, disposePressRuntime, normalizeRect, maxEdge, isTouchWithinRegion, readPoint, computeRegion, rippleProps, DEFAULT_DELAY_LONG_PRESS_MS, DEFAULT_MIN_PRESS_DURATION_MS, DEFAULT_PRESS_RECT_OFFSETS, } from './state/pressable.js';
-export { buildPressableListeners, resolveDisabledAccessibilityState, noteHoverNoop, shouldSuppressPress, shouldClaimResponder, isTerminationAllowed, } from './view/render-pressable/index.js';
+export { createPressHandlers, createPressRuntime, disposePressRuntime, normalizeRect, maxEdge, isTouchWithinRegion, readPoint, computeRegion, DEFAULT_DELAY_LONG_PRESS_MS, DEFAULT_MIN_PRESS_DURATION_MS, DEFAULT_PRESS_RECT_OFFSETS, } from './state/pressable.js';
+export { buildPressableListeners, resolveDisabledAccessibilityState, noteHoverNoop, shouldSuppressPress, shouldClaimResponder, isTerminationAllowed, resolvePressableFocusable, resolveTouchableFocusable, } 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_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).
-export { BUTTON_ACCESSIBILITY_ROLE, buttonTextStyle, resolveButtonTextStyle, } from './view/render-button.js';
-// TextInput: the controlled-value / event-count handshake. The logic half is the pure
-// folds/maps + the controlled-write predicate (not a single reducer: count must re-render the
-// imperative handle, lastNativeText must not); the view half picks the intrinsic and maps the
-// 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';
+export { canUseNativeForeground, selectableBackground, selectableBackgroundBorderless, rippleBackground, 
+// RN's own static namespace, the only part of the deleted wrappers with nowhere else to go: the
+// element is a tag now, and a tag is a string that cannot carry `.Ripple`.
+TouchableNativeFeedback, } from './view/render-touchable-native-feedback.js';
+// Button: `resolveButtonDisabled` alone now — the `props.disabled ?? aria ?? state.disabled`
+// precedence, which the press MACHINE reads and which is therefore still JS. Every platform fold
+// Button.js performs left this barrel between 2026-09-17 and 2026-09-18 for
+// `SymbioteFabricProps.cpp`; the last two, `buttonViewStyle` and `resolveButtonViewStyle`, went with
+// the Android arm of the test host that finally made their branch assertable.
+export { resolveButtonDisabled } from './view/render-button.js';
+// TextInput: the controlled-value / event-count handshake, and ONLY that now — the machine. The
+// W3C->native prop resolution that used to sit beside it is the engine's (`foldTextInputAliases`,
+// `SymbioteFabricProps.cpp`), so `resolveTextInputProps` and the four lookup tables under it are
+// gone rather than exported-and-unused: a tag's platform props are resolved once, natively, for
+// every adapter, and a JS copy would only be a second answer to the same question.
+export { foldText, textFromChange, eventCountFromChange, shouldCommandText, INITIAL_EVENT_COUNT, SELECTION_NONE, } from './state/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, 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';
+export { DEFAULT_WINDOW_SIZE, DEFAULT_INITIAL_NUM_TO_RENDER, DEFAULT_MAX_TO_RENDER_PER_BATCH, DEFAULT_UPDATE_CELLS_BATCHING_PERIOD, DEFAULT_VIEW_AREA_COVERAGE_PERCENT_THRESHOLD, FIRST_INDEX, EMPTY_OFFSET, NO_INDEX, NO_CONTENT_LENGTH_SENT, INVERTED_Y_STYLE, INVERTED_X_STYLE, readScrollOffset, readLayoutLength, readLayoutOffset, buildOffsets, computeWindow, throttleWindow, 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.
@@ -80,7 +77,39 @@ export { subscribeListDiagnostics } from './state/virtualized-list-diagnostics.j
 export { SINGLE_COLUMN, chunkIntoRows, rowKeyExtractor, expandRowToken, expandRowViewability, lastItemOfRow, firstItemOfRow, } from './state/flat-list.js';
 export { flattenSections, unwrapEntryItem, sectionEntryKey, scrollLocationToFlatIndex, } from './state/section-list.js';
 export { registerPressableBehavior, PRESSABLE_TAG, } from './behaviors/pressable.js';
-export { foldImagePayload, IMAGE_TAG, registerImageBehavior, } from './behaviors/image.js';
-export { foldInputAccessoryViewPayload, INPUT_ACCESSORY_VIEW_TAG, registerInputAccessoryViewBehavior, } from './behaviors/input-accessory-view.js';
+export { registerTouchableOpacityBehavior, TOUCHABLE_OPACITY_TAG, } from './behaviors/touchable-opacity.js';
+export { registerTouchableHighlightBehavior, TOUCHABLE_HIGHLIGHT_TAG, } from './behaviors/touchable-highlight.js';
+export { registerButtonBehavior, BUTTON_TAG } from './behaviors/button.js';
+// Registered by ALL FIVE adapters since 2026-09-09, in the same commit that deleted the five
+// wrappers — which is what makes it safe. While those wrappers still rendered a `Pressable` around
+// a feedback `View`, registering would have put a second responder on every existing
+// TouchableNativeFeedback. The ActivityIndicator and ScrollView blocks below are still in the
+// withheld state this one just left.
+export { registerTouchableNativeFeedbackBehavior, TOUCHABLE_NATIVE_FEEDBACK_TAG, } from './behaviors/touchable-native-feedback.js';
+// The second tag that commits no node, and registered by all five adapters in the same commit that
+// deleted their five wrappers — while those wrappers still rendered a `Pressable` around the app's
+// children, registering would have put a second responder on every TouchableWithoutFeedback.
+export { registerTouchableWithoutFeedbackBehavior, TOUCHABLE_WITHOUT_FEEDBACK_TAG, } from './behaviors/touchable-without-feedback.js';
+// Registered by all five adapters since 2026-09-09, in the same commit that deleted the five
+// wrappers — the tag builds its own spinner, so a surviving wrapper would have painted a second one.
+// The prop type rides along: there is no `view/render-activity-indicator.ts` any more, because the
+// only render this primitive had was the two nodes the behavior now builds.
+export { ACTIVITY_INDICATOR_SPINNER_TAG, ACTIVITY_INDICATOR_TAG, registerActivityIndicatorBehavior, } from './behaviors/activity-indicator';
+export { IMAGE_TAG, registerImageBehavior } from './behaviors/image.js';
+// Registered by all five adapters since 2026-09-09, in the same commit that deleted the five
+// wrappers — the tag builds the background image itself, so a surviving wrapper would have
+// committed a second one under it.
+export { IMAGE_BACKGROUND_TAG, registerImageBackgroundBehavior, } from './behaviors/image-background.js';
+export { INPUT_ACCESSORY_VIEW_TAG, registerInputAccessoryViewBehavior, } from './behaviors/input-accessory-view.js';
 export { registerTextInputBehavior, buildTextInputHandle, TEXT_INPUT_TAG, TEXT_INPUT_MULTILINE_TAG, } from './behaviors/text-input.js';
 export { registerSwitchBehavior, SWITCH_TAG } from './behaviors/switch.js';
+export { registerRefreshControlBehavior, REFRESH_CONTROL_TAG, } from './behaviors/refresh-control.js';
+// Exported as a FUNCTION, not as a side-effect module, which is what keeps it safe on a barrel:
+// Metro's inlineRequires only defers a re-export until its binding is named as a VALUE, and a
+// caller of `registerScrollViewBehavior()` names it. The shape CLAUDE.md forbids is a module whose
+// evaluation alone registers.
+//
+// EVERY ADAPTER CALLS IT since 2026-09-11, through `@symbiote-native/components/register`. It was
+// withheld while the wrappers built their own content node — registering then would have
+// double-nested every ScrollView. They are gone; the engine is the single owner.
+export { HORIZONTAL_SCROLL_VIEW_TAG, registerScrollViewBehavior, SCROLL_VIEW_TAG, STICKY_HEADER_TAG, } from './behaviors/scroll-view';

package/build/register.d.ts

@@ -0,0 +1 @@
+export {};

package/build/register.js

@@ -0,0 +1,55 @@
+// Side-effect ONLY. Exports nothing, and must never be re-exported from any barrel.
+//
+// The engine's host-behavior registry is what makes a bare `<pressable>` / `<text-input>` /
+// `<switch>` carry its machine; an unregistered tag commits inert. Every adapter needs the same
+// fourteen calls, so they live here once — an adapter's own `src/register.ts` is a single bare
+// `import '@symbiote-native/components/register';`.
+//
+// WHY A SIDE-EFFECT MODULE AND NOT A BARREL EXPORT. Metro turns on `inlineRequires` for PRODUCTION
+// only: it moves a `require` down to the first place its binding is used as a VALUE, and
+// `export { X } from './x'` compiles to a lazy getter. A registration reached only through a
+// re-export therefore never evaluates in a Release build — invisible to tsc, to vitest, and to
+// grepping the bundle. A bare `import` placed NEXT TO a re-export of the same specifier does not
+// help either: Babel merges the two into one dependency and the merged dependency stays lazy.
+// `register.test.ts` is what stops a later tidy-up from turning this back into an export.
+import { registerActivityIndicatorBehavior } from './behaviors/activity-indicator';
+import { registerButtonBehavior } from './behaviors/button.js';
+import { registerImageBackgroundBehavior } from './behaviors/image-background.js';
+import { registerImageBehavior } from './behaviors/image.js';
+import { registerInputAccessoryViewBehavior } from './behaviors/input-accessory-view.js';
+import { registerPressableBehavior } from './behaviors/pressable.js';
+import { registerRefreshControlBehavior } from './behaviors/refresh-control.js';
+import { registerScrollViewBehavior } from './behaviors/scroll-view';
+import { registerSwitchBehavior } from './behaviors/switch.js';
+import { registerTextInputBehavior } from './behaviors/text-input.js';
+import { registerTouchableHighlightBehavior } from './behaviors/touchable-highlight.js';
+import { registerTouchableNativeFeedbackBehavior } from './behaviors/touchable-native-feedback.js';
+import { registerTouchableOpacityBehavior } from './behaviors/touchable-opacity.js';
+import { registerTouchableWithoutFeedbackBehavior } from './behaviors/touchable-without-feedback.js';
+registerPressableBehavior();
+registerTouchableNativeFeedbackBehavior();
+registerTouchableWithoutFeedbackBehavior();
+// Their own tags rather than `pressable`: one node holds exactly one press machine, and each of
+// these is a pressable PLUS a second machine — the opacity fade, the underlay show/hide.
+registerTouchableOpacityBehavior();
+registerTouchableHighlightBehavior();
+// The whole subtree is the behavior's — RN's Button takes no children and builds
+// touchable > view > text > raw text itself (Button.js:363-388).
+registerButtonBehavior();
+// Two nodes, both the behavior's: RN wraps its native spinner in a centering View
+// (ActivityIndicator.js:112), so the tag is that View and `buildStructure` builds the spinner.
+registerActivityIndicatorBehavior();
+registerTextInputBehavior();
+registerSwitchBehavior();
+registerRefreshControlBehavior();
+// Fold-only, both of them: no node of their own, just the prop fold the wrapper used to run.
+registerImageBehavior();
+registerInputAccessoryViewBehavior();
+registerImageBackgroundBehavior();
+// The ENGINE is the single owner of a ScrollView's content node: `buildStructure` builds the
+// `RCTScrollContentView`, `slotProps` carries `contentContainerStyle` onto it, the claim on a
+// `refresh-control` child places it per platform, and the sticky seam is
+// `behaviors/scroll-view/sticky.ts`. EXACTLY ONE THING MAY BUILD THAT NODE — a second owner is a
+// silent `RCTScrollContentView` inside the first, which each adapter's
+// `scroll-view-content-owner` test is what guards.
+registerScrollViewBehavior();

package/build/resolve-intrinsic.js

@@ -2,15 +2,9 @@
 // commits, from the props it was created with.
 //
 // Why this has to exist at runtime at all. `intrinsicWhen` lets one primitive map to two native
-// views (`TextInput` -> `RCTSinglelineTextInputView` / `RCTMultilineTextInputView`), and until now
-// only the lowering transforms read it — so the choice was made at COMPILE time, from the source
-// text. That is why `dynamicIntrinsicChoice` had to be a refusal category: a transform seeing
-// `multiline={isLong}` cannot know the value, so it refused to lower the element at all.
-//
-// A public primitive TAG has no transform in front of it on three of the five adapters, so the
-// choice has to be made where the value is actually known — here, at element creation. That is a
-// capability the compiler never had, and it is why the refusal category disappears WITH the
-// transform rather than migrating into it.
+// views (`TextInput` -> `RCTSinglelineTextInputView` / `RCTMultilineTextInputView`), and the
+// deciding prop can be a RUNTIME value: `multiline={isLong}` is knowable only once the element is
+// created. So the choice is made here, where the value is.
 //
 // WHAT THIS DELIBERATELY DOES NOT DO: react to the prop CHANGING later. A node's native view is
 // fixed at `createNode` and no prop write moves a node between view types, so flipping `multiline`

package/build/scroll-view-commands.d.ts

@@ -1,4 +1,4 @@
-import { isSymbioteEvent, type AnimatedValue, type IStyleProp, type ISymbioteEvent, type ISymbioteNode, type IViewStyle } from '@symbiote-native/engine';
+import { isSymbioteEvent, type AnimatedValue, type ISymbioteEvent, type ISymbioteNode } from '@symbiote-native/engine';
 type IScrollHandler = (event: ISymbioteEvent) => void;
 export interface IScrollViewHandle {
     scrollTo(options?: {
@@ -12,10 +12,6 @@ export interface IScrollViewHandle {
     flashScrollIndicators(): void;
     getScrollNode(): ISymbioteNode | null;
 }
-export declare function splitLayoutProps(style: IStyleProp<IViewStyle> | undefined): {
-    outer: Record<string, unknown>;
-    inner: Record<string, unknown>;
-};
 export { isSymbioteEvent };
 export declare function forwardScrollEvent(handler: IScrollHandler, args: readonly unknown[]): void;
 export declare function buildScrollViewHandle(getNode: () => ISymbioteNode | null): IScrollViewHandle;

package/build/scroll-view-commands.js

@@ -3,61 +3,18 @@
 // the Android RefreshControl wrap, the scroll-event guard/forwarder, and the native sticky
 // scroll-attach are all platform- and framework-invariant, so they live here. The adapter
 // supplies the lifecycle (the node getter, the effect) and re-exports these.
-import { attachNativeEvent, dispatchViewCommand, dlog, flattenStyle, isSymbioteEvent, } from '@symbiote-native/engine';
-// RN's splitLayoutProps key partition (StyleSheet/splitLayoutProps.js): the LAYOUT keys
-// that belong on the OUTER box when a layout-affecting wrapper sits between the laid-out
-// frame and the visual content. Everything NOT in this set (background*, padding*, border*,
-// opacity, overflow, …) is VISUAL and stays on the inner view. Replicated exactly from RN's
-// switch cases so the Android RefreshControl wrap routes style the way RN does.
-const LAYOUT_KEYS = new Set([
-    'margin',
-    'marginHorizontal',
-    'marginVertical',
-    'marginBottom',
-    'marginTop',
-    'marginLeft',
-    'marginRight',
-    'flex',
-    'flexGrow',
-    'flexShrink',
-    'flexBasis',
-    'alignSelf',
-    'height',
-    'minHeight',
-    'maxHeight',
-    'width',
-    'minWidth',
-    'maxWidth',
-    'position',
-    'left',
-    'right',
-    'bottom',
-    'top',
-    'transform',
-    'transformOrigin',
-    'rowGap',
-    'columnGap',
-    'gap',
-]);
-// Split a flattened style into the LAYOUT props that drive the outer wrapper's frame and the
-// VISUAL props that paint the inner content, RN's splitLayoutProps. The Android build uses
-// this when a RefreshControl wraps the scroll view: layout (margin/flex/size/position/…) goes
-// on the AndroidSwipeRefreshLayout wrapper, visual (background/padding/border/…) stays on the
-// inner scroll view, instead of dumping the whole style on the wrapper and hardcoding flex:1.
-export function splitLayoutProps(style) {
-    const outer = {};
-    const inner = {};
-    // Reads keys off the style, so flatten the StyleProp (array/nested) to one object first.
-    const flat = flattenStyle(style);
-    for (const key of Object.keys(flat)) {
-        const value = Reflect.get(flat, key);
-        if (LAYOUT_KEYS.has(key))
-            outer[key] = value;
-        else
-            inner[key] = value;
-    }
-    return { outer, inner };
-}
+import { attachNativeEvent, dlog, flattenStyle, isSymbioteEvent, } from '@symbiote-native/engine';
+// THE ANDROID WRAP SPLIT LEFT THIS FILE ON 2026-09-18, and with it the last copy of RN's
+// `splitLayoutProps` key partition. Both halves are `SymbioteFabricProps.cpp` now
+// (`splitScrollViewStyle`, `foldRefreshWrapperProps`), reached off the tag and the tree rather than
+// from a `payloadFold` per node — see `behaviors/scroll-view/index.android.ts` for what made the
+// wrapper's half possible at all.
+//
+// Nothing replaced them here on purpose: a JS copy kept for a caller that no longer exists is the
+// mirror shape this migration keeps deleting, and the twenty-eight layout keys are exactly the kind
+// of list that drifts in silence. `core/engine/cpp/tests/js/scroll-view-wrap-payload.itest.ts`
+// asserts the split on the payload a commit actually sent, which is the only place it can now be
+// wrong.
 // Re-exported so the package barrel (index.ts) can still export this guard to
 // '@symbiote-native/components' callers, now that it lives in the engine, next to ISymbioteEvent.
 export { isSymbioteEvent };
@@ -69,42 +26,23 @@ export function forwardScrollEvent(handler, args) {
     if (isSymbioteEvent(first))
         handler(first);
 }
-// The imperative handle is identical across platforms: every method dispatches a view
-// command on the SAME scroll-view node; only the surrounding element assembly diverges
-// (iOS sibling RefreshControl vs Android wrap). So it is built once here and both platform
-// files back it with their scroll node getter. Commands and arg order mirror RN's
-// ScrollViewCommands: scrollTo [x, y, animated], scrollToEnd [animated], flashScrollIndicators [].
+// The imperative handle is identical across platforms — only the surrounding element assembly
+// diverges (iOS sibling RefreshControl vs Android wrap) — so it is built once here and both
+// platform files back it with their scroll node getter.
+//
+// It DELEGATES to the node's own methods rather than dispatching commands itself. The commands and
+// their defaults live on `ISymbioteNode` because a `<scroll-view>` hands the app its engine node
+// directly, with no wrapper to build a handle: two implementations would let `scrollTo()` with no
+// argument mean one thing through a ref and another through a tag, and nothing would report it.
 //
 // `getNode` is a LAZY getter (React `() => ref.current`, Vue `() => nodeRef.value`), read on
 // every call, NOT the node captured once. The node is null at mount and only set after the
 // element commits, so an eager capture would freeze `null` and every command would no-op.
 export function buildScrollViewHandle(getNode) {
     return {
-        scrollTo: (options) => {
-            const node = getNode();
-            if (node === null)
-                return;
-            const x = options?.x ?? 0;
-            const y = options?.y ?? 0;
-            const animated = options?.animated ?? true;
-            dlog(`ScrollView.scrollTo x=${x} y=${y} animated=${animated}`);
-            dispatchViewCommand(node, 'scrollTo', [x, y, animated]);
-        },
-        scrollToEnd: (options) => {
-            const node = getNode();
-            if (node === null)
-                return;
-            const animated = options?.animated ?? true;
-            dlog(`ScrollView.scrollToEnd animated=${animated}`);
-            dispatchViewCommand(node, 'scrollToEnd', [animated]);
-        },
-        flashScrollIndicators: () => {
-            const node = getNode();
-            if (node === null)
-                return;
-            dlog('ScrollView.flashScrollIndicators');
-            dispatchViewCommand(node, 'flashScrollIndicators', []);
-        },
+        scrollTo: (options) => getNode()?.scrollTo(options),
+        scrollToEnd: (options) => getNode()?.scrollToEnd(options),
+        flashScrollIndicators: () => getNode()?.flashScrollIndicators(),
         getScrollNode: () => getNode(),
     };
 }

package/build/state/flat-list.d.ts

@@ -1,11 +1,11 @@
-import type { IViewableItemsChangedInfo, IViewToken } from './virtualized-list';
+import { type IViewableItemsChangedInfo, type IViewToken } from './virtualized-list';
 export declare const SINGLE_COLUMN = 1;
 export interface IRow<ItemT> {
     items: ItemT[];
     startIndex: number;
 }
 export declare function chunkIntoRows<ItemT>(data: readonly ItemT[], columns: number): IRow<ItemT>[];
-export declare function rowKeyExtractor<ItemT>(row: IRow<ItemT>): string;
+export declare function rowKeyExtractor<ItemT>(row: IRow<ItemT>, keyExtractor?: (item: ItemT, index: number) => string): string;
 export declare function expandRowToken<ItemT>(token: IViewToken<IRow<ItemT>>, keyExtractor?: (item: ItemT, index: number) => string): IViewToken<ItemT>[];
 export declare function expandRowViewability<ItemT>(info: IViewableItemsChangedInfo<IRow<ItemT>>, keyExtractor?: (item: ItemT, index: number) => string): IViewableItemsChangedInfo<ItemT>;
 export declare function lastItemOfRow<ItemT>(row: IRow<ItemT> | undefined): ItemT | undefined;

package/build/state/flat-list.js

@@ -4,6 +4,7 @@
 // back to per-item tokens, and the row separator unwraps to the flanking items. All of
 // this is pure transform — every adapter (React, Vue) reuses it; the adapter supplies
 // only the element creation (createElement / h) for a row and the ref wiring.
+import { defaultKeyExtractor, } from './virtualized-list.js';
 export const SINGLE_COLUMN = 1;
 export function chunkIntoRows(data, columns) {
     const rows = [];
@@ -12,8 +13,15 @@ export function chunkIntoRows(data, columns) {
     }
     return rows;
 }
-export function rowKeyExtractor(row) {
-    return `row-${row.startIndex}`;
+// RN's own multi-column row key (`FlatList.js`'s `_keyExtractor`): each item's own key, joined
+// with `:`, never a synthetic position string — an app's `keyExtractor` (or the object's own
+// `key`/`id`) is what keeps a row's identity stable across inserts/removes, and a `row-${index}`
+// key defeats that as surely as no key at all.
+export function rowKeyExtractor(row, keyExtractor) {
+    const resolve = keyExtractor ?? defaultKeyExtractor;
+    return row.items
+        .map((item, column) => resolve(item, row.startIndex + column))
+        .join(':');
 }
 // Expand a row's viewable token to one token per item in that row, all sharing the row's
 // isViewable flag, so the caller sees item-level visibility rather than row-level.