@symbiote-native/engine 0.1.5 → 0.1.7

package/build/accessibility-info/index.android.js

@@ -6,7 +6,7 @@
 // device-event NAMES also differ from iOS (e.g. screen-reader is `touchExplorationDidChange`,
 // reduce-motion is `reduceMotionDidChange`). Metro picks this on an Android host. Mirrors
 // RN's AccessibilityInfo.js Android branches.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 import { isBoolean, routeSendAccessibilityEvent, } from './shared.js';

package/build/accessibility-info/index.ios.js

@@ -6,7 +6,7 @@
 // NativeEventEmitter and re-broadcasts to JS listeners. Metro picks this on an iOS host;
 // the bare accessibility-info.ts re-exports it as the default for tsc / tsx / headless.
 // Mirrors RN's AccessibilityInfo.js iOS branches.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 import { isBoolean, routeSendAccessibilityEvent, } from './shared.js';

package/build/action-sheet-ios/index.js

@@ -17,7 +17,7 @@
 // processing in @symbiote-native/engine, so we do NOT process colors here; options pass
 // through untouched. The canary needs no colors; revisit when wiring real colors.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 export const ACTION_SHEET_MANAGER = 'ActionSheetManager';
 // The static imperative API RN exposes, mirrored as a static-method object.
 export const ActionSheetIOS = {

package/build/alert/index.android.js

@@ -17,7 +17,7 @@
 //
 // Non-throwing, like StatusBar: a missing native module is a no-op, never a crash.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { isRecord } from '../type-guards.js';
 import { DEFAULT_POSITIVE_TEXT, normalizeButtons, } from './shared.js';
 const DIALOG_MANAGER = 'DialogManagerAndroid';

package/build/alert/index.ios.js

@@ -12,7 +12,7 @@
 // Non-throwing, like StatusBar: a missing native module is a no-op, never a crash (on a
 // device the module may be absent).
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 const ALERT_MANAGER = 'AlertManager';
 // prompt builds the native args, assigns each button its array index as id, and dispatches
 // the matching button's onPress when the native callback returns that id. Non-throwing: no

package/build/animated/index.d.ts

@@ -17,4 +17,4 @@ export { nativeAnimated, isNativeAnimatedAvailable, type INativeNodeConfig, type
 export { AnimatedProps } from './props';
 export { AnimatedStyle, AnimatedTransform } from './style';
 export { AnimatedMock } from './mock';
-export { reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated-component-shared';
+export { reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode } from './shared';

package/build/animated/index.js

@@ -25,4 +25,4 @@ export { AnimatedProps } from './props.js';
 export { AnimatedStyle, AnimatedTransform } from './style.js';
 export { AnimatedMock } from './mock.js';
 // Framework-agnostic createAnimatedComponent helpers. Both adapters import them.
-export { reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated-component-shared.js';
+export { reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode } from './shared.js';

package/build/animated/native/native-animated.js

@@ -10,7 +10,7 @@
 // module is resolved lazily on first use, so importing this file headless (no
 // native host) is inert until a native-driven animation actually starts.
 import { dlog } from '../../debug.js';
-import { getNativeModule } from '../../native-modules.js';
+import { getNativeModule } from '../../native-modules/index.js';
 import { NativeEventEmitter } from '../../native-events.js';
 import { isRecord } from '../../type-guards.js';
 // iOS bridgeless registers the Turbo variant; the legacy name is the fallback.

package/build/app-registry/index.js

@@ -11,7 +11,7 @@
 // registrar. Reached the same way shared reaches processColor: a dependency-injected seam
 // (setHostRegistrar), so the core stays react-native-free and the app glue wires the host once
 // at startup.
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 const HEADLESS_TASK_MODULE = 'HeadlessJsTaskSupport';
 // Builds one adapter's AppRegistry. `runnableFor` is the sole framework-specific seam: given a

package/build/app-state/index.js

@@ -5,7 +5,7 @@
 // NativeEventEmitter bound to the AppState native module and maps them onto the
 // public 'change'/'memoryWarning'/'focus'/'blur' listeners, mirroring RN's
 // Libraries/AppState/AppState.js.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 // The native module name RN registers AppState under, confirmed from its spec

package/build/appearance/index.js

@@ -4,7 +4,7 @@
 // native module (which RN keys its appearance events off of) and re-broadcasts to
 // JS listeners as a plain `{ colorScheme }` payload. Mirrors RN's
 // Libraries/Utilities/Appearance.js, slimmed to the parts we need.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 // The native module name RN registers the appearance module under, confirmed from

package/build/back-handler/index.js

@@ -6,7 +6,7 @@
 // Android-only by intent: iOS has no hardware back button, so the whole module
 // degrades to a no-op when the native module is absent, matching RN's
 // BackHandler.ios.js stub. Mirrors RN's Libraries/Utilities/BackHandler.android.js.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 // The native module name RN registers this under. NOTE: this is the name the

package/build/commit.js

@@ -13,7 +13,7 @@
 // references to specific child handles. That bubble is inherent to a persistent
 // tree and is exactly what React's own Fabric renderer does.
 import { getSlot, } from './fabric.js';
-import { createElement, isAnchor, VIRTUAL_TEXT_COMPONENT } from './node.js';
+import { createElement, debugNodeId, isAnchor, VIRTUAL_TEXT_COMPONENT, } from './node.js';
 import { dlog, isDebug } from './debug.js';
 import { flattenStyle } from './style/index.js';
 import { nextTag } from './tags.js';
@@ -23,7 +23,7 @@ import { isRecord } from './type-guards.js';
 // processColor/setColorProcessor now live in ./platform-color (the stable color-processing
 // leaf every color-touching module imports from); re-exported here so nothing outside this
 // module needs to change its import path.
-export { processColor, setColorProcessor } from './platform-color.js';
+export { processColor, setColorProcessor } from './platform-color/index.js';
 // Per-commit work counters, surfaced via dlog so a device run can prove the
 // engine is incremental (created=0 with clones after the first mount).
 const stats = { created: 0, cloneProps: 0, cloneChildren: 0, reused: 0 };
@@ -210,6 +210,13 @@ function reconcile(slot, node, rootTag, hasTextAncestor, renderableParent, force
             slot.appendChild(handle, reconcile(slot, child, rootTag, childInText, node, true).handle);
         }
         logScrollChildren(node, viewName, tag);
+        // Investigation instrumentation (search-bar-ref "node not committed" bug): scoped to RNS* so
+        // it can be directly compared against the ref-attach log in stack.ts and the dispatch-miss
+        // log below — same debugNodeId on both sides proves/disproves an identity mismatch. Kept
+        // behind DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
+        if (viewName.startsWith('RNS')) {
+            dlog(`mirror.set (create) node=${debugNodeId(node)} tag=${tag} view=${viewName}`);
+        }
         mirror.set(node, {
             handle,
             tag,
@@ -259,6 +266,11 @@ function reconcile(slot, node, rootTag, hasTextAncestor, renderableParent, force
         guardSerializable(propsDiff, viewName, committed.tag);
         handle = slot.cloneNodeWithNewProps(committed.handle, propsDiff);
     }
+    // Investigation instrumentation (search-bar-ref "node not committed" bug): see the create-path
+    // dlog above. Kept behind DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
+    if (viewName.startsWith('RNS')) {
+        dlog(`mirror.set (update) node=${debugNodeId(node)} tag=${committed.tag} view=${viewName}`);
+    }
     // The clone keeps the node's family, so its reactTag is unchanged; carry it.
     mirror.set(node, {
         handle,
@@ -428,10 +440,12 @@ export function getNativeNode(node) {
 export function dispatchViewCommand(node, commandName, args) {
     const record = mirror.get(node);
     if (record === undefined) {
-        dlog(`dispatchViewCommand "${commandName}" skipped: node not committed`);
+        // node=... compares directly against the mirror.set logs above (same debugNodeId scheme) to
+        // prove/disprove a node-identity mismatch — see the search-bar-ref investigation note there.
+        dlog(`dispatchViewCommand "${commandName}" skipped: node not committed (node=${debugNodeId(node)} component=${node.component})`);
         return;
     }
-    dlog(`dispatchViewCommand "${commandName}"`);
+    dlog(`dispatchViewCommand "${commandName}" (node=${debugNodeId(node)})`);
     getSlot().dispatchCommand(record.handle, commandName, args);
 }
 // Emit an accessibility event (focus/click/viewHoverEnter/windowStateChange) at a node's

package/build/dimensions/index.js

@@ -11,7 +11,7 @@
 // We resolve it through the same generic native-module bridge as Platform
 // (getNativeModule), so this module stays importable headless before a fake proxy
 // is installed.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 import { isRecord } from '../type-guards.js';

package/build/fabric-props.js

@@ -7,7 +7,7 @@
 import { RAW_TEXT_COMPONENT } from './node.js';
 import { flattenStyle } from './style/index.js';
 import { registeredProcessor } from './registry.js';
-import { isProcessableColor, processColor } from './platform-color.js';
+import { isProcessableColor, processColor } from './platform-color/index.js';
 import { processBoxShadow } from './process-box-shadow/index.js';
 import { processFilter } from './process-filter.js';
 import { processTransformOrigin } from './process-transform-origin/index.js';

package/build/i18n-manager/index.js

@@ -13,7 +13,7 @@
 //   forceRTL(forceRTL: boolean)
 //   swapLeftAndRightInRTL(flipStyles: boolean)
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { isBoolean } from '../type-guards.js';
 // The iOS native module name RN registers this under (the same name on both
 // platforms). A module name is only provable on a real host (a headless fake

package/build/image-loader.js

@@ -15,7 +15,7 @@
 // native bridge).
 import { dlog } from './debug.js';
 import { resolveImageSource } from './image-source-resolver.js';
-import { getNativeModule } from './native-modules.js';
+import { getNativeModule } from './native-modules/index.js';
 import { Platform } from './platform';
 import { isNumber } from './type-guards.js';
 // The iOS native module name RN registers this under (NativeImageLoaderIOS.js resolves

package/build/index.d.ts

@@ -1,4 +1,4 @@
-export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, } from './node';
+export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node';
 export { isEventFor } from './view-config';
 export { registerComponent, setNativeViewConfigSource } from './registry';
 export { isRecord } from './type-guards';

package/build/index.js

@@ -2,7 +2,7 @@
 // Every framework adapter drives this tiny mutation API; all Fabric-specific
 // logic (tag allocation, view-name resolution, clone-on-write, event
 // normalization) lives behind it, in one place.
-export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, } from './node.js';
+export { createElement, createRawText, createAnchor, isAnchor, appendChild, insertBefore, removeChild, setProp, setEventListener, routeProp, getExplicitStyle, setText, isSymbioteNode, isSymbioteEvent, RAW_TEXT_COMPONENT, debugNodeId, } from './node.js';
 export { isEventFor } from './view-config.js';
 export { registerComponent, setNativeViewConfigSource } from './registry.js';
 // Real cross-package consumer: core/components' KeyboardAvoidingView render narrows
@@ -21,7 +21,7 @@ export { setColorProcessor, processColor, dispatchViewCommand, sendAccessibility
 // the Vue renderer's createElement): the imperative measure/setNativeProps/focus API. Lives
 // here because it depends only on engine internals, so all adapters inherit it identically.
 export { toPublicInstance } from './host-instance/index.js';
-export { PlatformColor, DynamicColorIOS, isOpaqueColorValue } from './platform-color.js';
+export { PlatformColor, DynamicColorIOS, isOpaqueColorValue } from './platform-color/index.js';
 // CSS-style processors (boxShadow/filter): RN parses these in JS before native because
 // enableNativeCSSParsing() defaults to false. Exported so an adapter / test can reuse them.
 export { processBoxShadow } from './process-box-shadow/index.js';
@@ -37,7 +37,7 @@ export { registerStyles, resolveClassName, clearGlobalStyles, isClassNameValue,
 export { scopeClassName } from './style-registry/scope.js';
 export { Platform } from './platform';
 export { dlog, isDebug } from './debug.js';
-export { getNativeModule, getEnforcingNativeModule } from './native-modules.js';
+export { getNativeModule, getEnforcingNativeModule } from './native-modules/index.js';
 export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource } from './native-events.js';
 export { AnimatedNode, AnimatedWithChildren, AnimatedValue, AnimatedValueXY, AnimatedColor, AnimatedInterpolation, AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, AnimatedEvent, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, flushValue, Easing, createNumericInterpolation, checkValidRanges, TimingAnimation, SpringAnimation, DecayAnimation, AnimatedTracking, timing, spring, decay, parallel, sequence, stagger, loop, delay, nativeAnimated, isNativeAnimatedAvailable, AnimatedProps, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated/index.js';
 export { getSlot } from './fabric.js';

package/build/keyboard/index.js

@@ -3,7 +3,7 @@
 // subscribes through a NativeEventEmitter bound to the KeyboardObserver native
 // module, which RN keys its keyboard events off of. Mirrors RN's
 // Libraries/Components/Keyboard/Keyboard.js, slimmed to the parts we need.
-import { createDeviceEventModule } from '../native-modules.js';
+import { createDeviceEventModule } from '../native-modules/index.js';
 import {} from '../native-events.js';
 import { dlog } from '../debug.js';
 import { blurTextInput, currentlyFocusedInput } from '../text-input-state.js';

package/build/layout-animation/index.js

@@ -7,7 +7,7 @@
 //
 // It is a native-bridge consumer (RN's `Platform`/`StyleSheet` purity split puts
 // these in the adapter, not in shared, like Keyboard / StatusBar).
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 import { isRecord } from '../type-guards.js';
 // ---- native module routing ----------------------------------------------

package/build/linking/shared.js

@@ -8,7 +8,7 @@
 // the base linking.ts re-exports the iOS build for web/headless. There is no runtime
 // `Platform.OS` read; the filename is the selector.
 import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 // The one event symbiote observes: an incoming deep link. RN's LinkingEventDefinitions.
 const URL_EVENT = 'url';

package/build/{native-modules.d.ts → native-modules/index.d.ts}

@@ -1,4 +1,4 @@
-import { NativeEventEmitter } from './native-events';
+import { NativeEventEmitter } from '../native-events';
 declare global {
     var __turboModuleProxy: (<T>(name: string) => T | null) | undefined;
     var nativeModuleProxy: Record<string, unknown> | undefined;

package/build/{native-modules.js → native-modules/index.js}

@@ -8,9 +8,9 @@
 // KeyboardObserver, ...). Third-party RN packages import `TurboModuleRegistry` from
 // `'react-native'` and read the same global themselves; they do not go through
 // here.
-import { dlog } from './debug.js';
-import { installDeviceEventHub, NativeEventEmitter, } from './native-events.js';
-import { isRecord } from './type-guards.js';
+import { dlog } from '../debug.js';
+import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
+import { isRecord } from '../type-guards.js';
 // The native module value crosses from an untyped HostObject into our types here;
 // the caller vouches for its shape via T (the single trust-boundary narrowing, no
 // per-call `as`). Native modules are always non-null objects.

package/build/node.d.ts

@@ -23,6 +23,7 @@ export interface ISymbioteNode {
 export declare function createElement(component: string, isText?: boolean): ISymbioteNode;
 export declare function createRawText(text: string): ISymbioteNode;
 export declare function isSymbioteNode(value: unknown): value is ISymbioteNode;
+export declare function debugNodeId(node: ISymbioteNode): number;
 export declare const ANCHOR_COMPONENT = "#anchor";
 export declare function createAnchor(): ISymbioteNode;
 export declare function isAnchor(node: ISymbioteNode): boolean;

package/build/node.js

@@ -6,6 +6,7 @@
 // lives here in shared so no adapter re-implements it.
 import { isEventFor } from './view-config.js';
 import { isClassNameValue, resolveClassName } from './style-registry/index.js';
+import { dlog } from './debug.js';
 const BRAND = Symbol('symbiote.node');
 // A node carries the Fabric view name directly, so adding a primitive (Image,
 // ScrollView, TextInput) is just a new string from the adapter, no core change.
@@ -52,6 +53,21 @@ export function createRawText(text) {
 export function isSymbioteNode(value) {
     return typeof value === 'object' && value !== null && BRAND in value;
 }
+// Investigation instrumentation (HeaderOptionsScreen search-bar-ref "node not committed" bug):
+// a WeakMap can't be logged, so this gives every node a small human-readable id, assigned lazily
+// on first call — lets a dlog at ref-attach time and a dlog at commit/dispatch time be compared
+// directly to prove whether they're the SAME node object or two different ones. Kept behind
+// DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
+const debugIds = new WeakMap();
+let nextDebugId = 1;
+export function debugNodeId(node) {
+    let id = debugIds.get(node);
+    if (id === undefined) {
+        id = nextDebugId++;
+        debugIds.set(node, id);
+    }
+    return id;
+}
 // Vue's runtime-core needs comment/anchor nodes (fragments, v-if, v-for) to track
 // sibling order; Fabric has no such concept. An anchor is a real retained node so
 // insert/nextSibling/parentNode ordering stays correct, but the commit walk SKIPS it
@@ -166,7 +182,17 @@ export function routeProp(node, key, value) {
     }
     if (ON_PREFIX.test(key)) {
         const name = listenerName(key);
-        if (RESPONDER_EVENTS.has(name) || isEventFor(node.component, name)) {
+        const isRegisteredEvent = RESPONDER_EVENTS.has(name) || isEventFor(node.component, name);
+        // Investigation instrumentation (HeaderOptionsScreen unresponsive-buttons bug): RNS* views
+        // derive their events from react-native-screens' own codegen ViewConfig (registry.ts), so an
+        // unregistered event silently falls through to setProp below — a dead prop Fabric ignores,
+        // indistinguishable from "the button did nothing" at the UI. Scoped to RNS* to avoid noise
+        // from the rest of the app. Kept behind DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
+        if (node.component.startsWith('RNS')) {
+            dlog(`routeProp: ${node.component} "${key}" -> listener "${name}" ` +
+                `registered=${isRegisteredEvent} at t=${Date.now()}`);
+        }
+        if (isRegisteredEvent) {
             setEventListener(node, name, value);
             return;
         }

package/build/permissions-android/index.js

@@ -17,7 +17,7 @@
 //   requestPermission(permission): Promise<string>
 //   shouldShowRequestPermissionRationale(permission): Promise<boolean>
 //   requestMultiplePermissions(permissions): Promise<{[permission]: string}>
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 import { isBoolean } from '../type-guards.js';
 // The native module name RN registers this TurboModule under

package/build/platform/shared.js

@@ -5,7 +5,7 @@
 // select precedence, and the device-class getters. The filename is the selector (Metro
 // picks platform.ios / platform.android by host); no Platform.OS read lives here.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 // The native module name RN registers PlatformConstants under, identical on both
 // platforms; only getConstants()'s SHAPE differs, which each platform file guards.
 export const PLATFORM_CONSTANTS = 'PlatformConstants';

package/build/process-background-image/index.js

@@ -3,7 +3,7 @@
 // enableNativeCSSParsing(), which DEFAULTS TO FALSE, so RN's stock path parses the CSS gradient
 // string / structured array in JS and sends only the processed array to native - Fabric's C++
 // never sees the raw string. This restores that missing JS parse.
-import { isOpaqueColorValue, processColor } from '../platform-color.js';
+import { isOpaqueColorValue, processColor } from '../platform-color/index.js';
 import { dlog } from '../debug.js';
 import { isRecord } from '../type-guards.js';
 // RN processBackgroundImage.js: pre-compiled patterns.

package/build/process-box-shadow/index.js

@@ -4,7 +4,7 @@
 // processed array to native; Fabric's C++ never sees the raw string. symbiote was
 // forwarding the raw value, which native (CSS parsing off) silently ignores: shadow
 // rendered nothing. This restores the missing JS parse + per-color processColor.
-import { isOpaqueColorValue, processColor } from '../platform-color.js';
+import { isOpaqueColorValue, processColor } from '../platform-color/index.js';
 import { dlog } from '../debug.js';
 // RN processBoxShadow.js:16-19: split args only on the delimiters that are NOT inside
 // a parenthesized color like rgba(0,0,0,1).

package/build/process-filter.js

@@ -4,7 +4,7 @@
 // structured result. symbiote forwarded the raw value; the array form already worked
 // (Fabric accepts it raw, `filter:[{brightness:0.5}]` was device-verified), but the
 // CSS-string form and drop-shadow color processing were missing. This restores them.
-import { isOpaqueColorValue, processColor } from './platform-color.js';
+import { isOpaqueColorValue, processColor } from './platform-color/index.js';
 import { dlog } from './debug.js';
 import { isRecord } from './type-guards.js';
 // RN processFilter.js:19-24: pre-compiled patterns.

package/build/settings/index.js

@@ -6,7 +6,7 @@
 // device event `settingsUpdated`, which feeds the same change->fire path. Mirrors
 // RN's Libraries/Settings/Settings.ios.js, iOS surface only.
 import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 import { isRecord } from '../type-guards.js';
 // The iOS native module name RN registers this under. NOTE: this is the name the

package/build/share/index.android.js

@@ -8,7 +8,7 @@
 // TurboModuleRegistry.get('ShareModule') from RN source, but headless fakes resolve any
 // name, so it is only proven on a real Android host (a bridgeless resolution log there).
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { validateContent, shareActions, SHARED_ACTION, DISMISSED_ACTION } from './shared.js';
 const SHARE_MODULE = 'ShareModule';
 // ShareModule.share resolves an untyped value at the native boundary; narrow it before

package/build/share/index.ios.js

@@ -5,7 +5,7 @@
 // callback. Metro picks this file on an iOS host; the base share.ts re-exports it for
 // web/headless.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { ACTION_SHEET_MANAGER, } from '../action-sheet-ios/index.js';
 import { validateContent, shareActions, SHARED_ACTION, DISMISSED_ACTION } from './shared.js';
 export const Share = {

package/build/status-bar/index.android.js

@@ -10,9 +10,9 @@
 // replace. Now that render.ts installs RN$stopSurface and tears surfaces down cleanly, the
 // relayout survives and the bar updates without blanking (verified on device: show/hide +
 // light/dark text). See render.ts's installStopSurfaceGlobal.
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
-import { processColor } from '../platform-color.js';
+import { processColor } from '../platform-color/index.js';
 import { STATUS_BAR_MANAGER } from './shared.js';
 // processColor returns `unknown` (its result is platform-dependent); narrow to the
 // number Fabric/native expects, like RN's invariant before setColor. A non-number

package/build/status-bar/index.ios.js

@@ -8,7 +8,7 @@
 // boundary getNativeModule<T> resolves against. Metro picks this on an iOS host; the base
 // status-bar.ts re-exports it for tsc / tsx / headless. Each adapter wraps these with its own
 // declarative component.
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 import { STATUS_BAR_MANAGER, STATIC_HIDE_TRANSITION, hideTransition, } from './shared.js';
 // Apply a StatusBar component's props to the native module. The adapter calls this from its

package/build/style-registry/scope/index.d.ts

@@ -0,0 +1,3 @@
+export type IClassToggleMap = Record<string, boolean | undefined>;
+export type IScopableClassValue = string | IClassToggleMap | Array<string | IClassToggleMap> | undefined | null;
+export declare function scopeClassName(value: IScopableClassValue, localNames: ReadonlySet<string>, scopeId: string): IScopableClassValue;

package/build/style-registry/scope/index.js

@@ -0,0 +1,41 @@
+// Vue `<style scoped>` class-name rewriter. Distinct responsibility from the sibling
+// ./index.ts (the CSS class -> style registry): this module does pure NAME rewriting,
+// no registry lookup, no CSS parsing. It runs at the compiled call site of a Vue SFC's
+// scoped-style template - `adapters/vue/metro-vue-transformer.cjs` emits calls to
+// scopeClassName (imported there as `__scopeClass`) - BEFORE Vue's own normalizeClass()
+// collapses string/object/array `class` values to a final string, so it must pre-process
+// all three shapes normalizeClass understands. resolveClassName in ./index.ts still does
+// the actual style lookup, unchanged, against the rewritten (possibly suffixed) name.
+import { kebabToCamel } from '../index.js';
+// Suffixes every class token that this file's scoped block locally defines with
+// `__${scopeId}`, leaving unrecognized tokens (globals, external classes) untouched.
+export function scopeClassName(value, localNames, scopeId) {
+    if (value === undefined || value === null)
+        return value;
+    if (Array.isArray(value)) {
+        return value.map(item => scopeClassEntry(item, localNames, scopeId));
+    }
+    return scopeClassEntry(value, localNames, scopeId);
+}
+// A token arrives as either the camelCase registry key (`sectionLabel`) or its kebab-case
+// authoring form (`section-label`) - normalize to camelCase FIRST, then decide scoping, so
+// `localNames` (always camelCase, built from the css-parser's registered keys) recognizes a
+// kebab-written token. The emitted (possibly suffixed) name is always the camelCase form.
+function scopeToken(token, localNames, scopeId) {
+    const camelToken = kebabToCamel(token);
+    return localNames.has(camelToken) ? `${camelToken}__${scopeId}` : camelToken;
+}
+function scopeClassEntry(value, localNames, scopeId) {
+    if (typeof value === 'object') {
+        const scoped = {};
+        for (const [name, enabled] of Object.entries(value)) {
+            scoped[scopeToken(name, localNames, scopeId)] = enabled;
+        }
+        return scoped;
+    }
+    return value
+        .split(/\s+/)
+        .filter(Boolean)
+        .map(token => scopeToken(token, localNames, scopeId))
+        .join(' ');
+}

package/build/style-sheet/index.js

@@ -5,7 +5,7 @@
 // constants. The typed ViewStyle/TextStyle live next door in styles.ts, so `create`
 // is typed against them like RN's, not left generic over a plain Record.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 import { flattenStyle } from '../style/index.js';
 // RN's hairline factor: a "1 physical pixel" line is ~0.4 logical px, rounded to the
 // nearest device pixel. Named so the 0.4 isn't a bare magic number (RN source uses

package/build/toast-android/index.js

@@ -14,7 +14,7 @@
 //   showWithGravity(message: string, duration: number, gravity: number)
 //   showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset)
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 // The native module name RN registers this under. NOTE: this is the name the spec
 // resolves via `TurboModuleRegistry.getEnforcing<Spec>('ToastAndroid')`, NOT the
 // spec filename `INativeToastAndroid`. A module name is only provable on a real

package/build/touch-history/index.d.ts

@@ -0,0 +1,23 @@
+interface ITouchRecord {
+    touchActive: boolean;
+    startPageX: number;
+    startPageY: number;
+    startTimeStamp: number;
+    currentPageX: number;
+    currentPageY: number;
+    currentTimeStamp: number;
+    previousPageX: number;
+    previousPageY: number;
+    previousTimeStamp: number;
+}
+interface ITouchHistory {
+    touchBank: ITouchRecord[];
+    numberActiveTouches: number;
+    indexOfSingleActiveTouch: number;
+    mostRecentTimeStamp: number;
+}
+export declare const touchHistory: ITouchHistory;
+export declare function recordTouchTrack(kind: 'start' | 'move' | 'end', nativeEvent: Record<string, unknown>): void;
+export declare function resetTouchHistory(): void;
+export declare function attachTouchHistory(nativeEvent: Record<string, unknown>): void;
+export {};

package/build/touch-history/index.js

@@ -0,0 +1,150 @@
+// Per-touch position/time tracking, ported from RN's
+// react-native-renderer/.../legacy-events/ResponderTouchHistoryStore.js. PanResponder's
+// multitouch dx/vx math needs each touch's own previous->current delta (RN counts only
+// touches that moved since `_accountsForMovesUpTo`), which a grant-relative centroid of
+// ALL live touches cannot reconstruct. We maintain the bank as touches flow and ATTACH
+// `touchHistory` onto the nativeEvent reaching responder handlers, exactly how
+// ResponderEventPlugin.js sets `*.touchHistory`.
+//
+// events/index.ts consumes only this file's public surface (recordTouchTrack,
+// attachTouchHistory, resetTouchHistory, touchHistory); everything else here is a
+// private implementation detail of the bank.
+import { isRecord } from '../type-guards.js';
+// RN's bank is indexed by touch identifier and warns above 20; we never warn (headless
+// events may carry larger or absent ids), we just skip anything out of a sane range.
+const MAX_TOUCH_BANK = 20;
+const touchBank = [];
+export const touchHistory = {
+    touchBank,
+    numberActiveTouches: 0,
+    indexOfSingleActiveTouch: -1,
+    mostRecentTimeStamp: 0,
+};
+function toFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+// Pull a recordable touch out of an untyped entry. RN's getTouchIdentifier throws on
+// a null id; we skip instead, so events without touch geometry leave the bank untouched.
+function normalizeTouch(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const identifier = toFiniteNumber(raw.identifier);
+    const pageX = toFiniteNumber(raw.pageX);
+    const pageY = toFiniteNumber(raw.pageY);
+    if (identifier === undefined || pageX === undefined || pageY === undefined)
+        return undefined;
+    if (identifier < 0 || identifier > MAX_TOUCH_BANK)
+        return undefined;
+    return { identifier, pageX, pageY, timestamp: toFiniteNumber(raw.timestamp) ?? 0 };
+}
+// The changed touches for this frame (start/move/end), defensively read.
+function changedTouchesOf(nativeEvent) {
+    const raw = nativeEvent.changedTouches;
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        const touch = normalizeTouch(entry);
+        if (touch !== undefined)
+            out.push(touch);
+    }
+    return out;
+}
+// Count of all touches still down (RN reads nativeEvent.touches.length directly).
+function activeTouchCount(nativeEvent) {
+    const raw = nativeEvent.touches;
+    return Array.isArray(raw) ? raw.length : 0;
+}
+function recordTouchStart(touch) {
+    const record = touchBank[touch.identifier];
+    if (record) {
+        record.touchActive = true;
+        record.startPageX = touch.pageX;
+        record.startPageY = touch.pageY;
+        record.startTimeStamp = touch.timestamp;
+        record.currentPageX = touch.pageX;
+        record.currentPageY = touch.pageY;
+        record.currentTimeStamp = touch.timestamp;
+        record.previousPageX = touch.pageX;
+        record.previousPageY = touch.pageY;
+        record.previousTimeStamp = touch.timestamp;
+    }
+    else {
+        touchBank[touch.identifier] = {
+            touchActive: true,
+            startPageX: touch.pageX,
+            startPageY: touch.pageY,
+            startTimeStamp: touch.timestamp,
+            currentPageX: touch.pageX,
+            currentPageY: touch.pageY,
+            currentTimeStamp: touch.timestamp,
+            previousPageX: touch.pageX,
+            previousPageY: touch.pageY,
+            previousTimeStamp: touch.timestamp,
+        };
+    }
+    touchHistory.mostRecentTimeStamp = touch.timestamp;
+}
+// Move and end share the previous<-current shift; only `touchActive` differs.
+function shiftTouchRecord(touch, active) {
+    const record = touchBank[touch.identifier];
+    if (!record)
+        return;
+    record.touchActive = active;
+    record.previousPageX = record.currentPageX;
+    record.previousPageY = record.currentPageY;
+    record.previousTimeStamp = record.currentTimeStamp;
+    record.currentPageX = touch.pageX;
+    record.currentPageY = touch.pageY;
+    record.currentTimeStamp = touch.timestamp;
+    touchHistory.mostRecentTimeStamp = touch.timestamp;
+}
+function arrayFirst(value) {
+    return Array.isArray(value) ? value[0] : undefined;
+}
+// Maintain the bank as a touch frame flows. Mirrors RN's recordTouchTrack: moveish
+// shifts records, startish records + recomputes numberActiveTouches, endish marks the
+// record inactive + rescans for the single remaining touch. `kind` is the touch phase.
+export function recordTouchTrack(kind, nativeEvent) {
+    if (kind === 'move') {
+        for (const touch of changedTouchesOf(nativeEvent))
+            shiftTouchRecord(touch, true);
+        return;
+    }
+    if (kind === 'start') {
+        for (const touch of changedTouchesOf(nativeEvent))
+            recordTouchStart(touch);
+        touchHistory.numberActiveTouches = activeTouchCount(nativeEvent);
+        if (touchHistory.numberActiveTouches === 1) {
+            const first = normalizeTouch(arrayFirst(nativeEvent.touches));
+            touchHistory.indexOfSingleActiveTouch = first?.identifier ?? -1;
+        }
+        return;
+    }
+    for (const touch of changedTouchesOf(nativeEvent))
+        shiftTouchRecord(touch, false);
+    touchHistory.numberActiveTouches = activeTouchCount(nativeEvent);
+    if (touchHistory.numberActiveTouches === 1) {
+        for (let i = 0; i < touchBank.length; i++) {
+            const record = touchBank[i];
+            if (record !== undefined && record.touchActive) {
+                touchHistory.indexOfSingleActiveTouch = i;
+                break;
+            }
+        }
+    }
+}
+// Drop all touch state. Called on a fully-released / cancelled gesture so a stale bank
+// never leaks geometry into the next gesture's first frame.
+export function resetTouchHistory() {
+    touchBank.length = 0;
+    touchHistory.numberActiveTouches = 0;
+    touchHistory.indexOfSingleActiveTouch = -1;
+    touchHistory.mostRecentTimeStamp = 0;
+}
+// Attach the live touch history onto the event the responder handlers receive, matching
+// ResponderEventPlugin.js (`grantEvent.touchHistory = ...`, etc.). PanResponder reads
+// it for the per-touch dx/vx math; handlers that ignore it are unaffected.
+export function attachTouchHistory(nativeEvent) {
+    nativeEvent.touchHistory = touchHistory;
+}

package/build/type-guards/index.d.ts

@@ -0,0 +1,4 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isBoolean(value: unknown): value is boolean;
+export declare function isNumber(value: unknown): value is number;
+export declare function isString(value: unknown): value is string;

package/build/type-guards/index.js

@@ -0,0 +1,15 @@
+// Runtime guards to narrow `unknown` at trust boundaries (native payloads, ViewConfig
+// attributes, style values) without an `as` cast. `isRecord` excludes arrays - most
+// call sites mean "a native payload keyed by string," never a list.
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+export function isNumber(value) {
+    return typeof value === 'number';
+}
+export function isString(value) {
+    return typeof value === 'string';
+}

package/build/vibration/shared.js

@@ -16,7 +16,7 @@
 // the base vibration.ts re-exports the iOS build for web/headless. There is no runtime
 // `Platform.OS` read; the filename is the selector. No Fabric view, pure JS->native.
 import { dlog } from '../debug.js';
-import { getNativeModule } from '../native-modules.js';
+import { getNativeModule } from '../native-modules/index.js';
 const VIBRATION_MODULE = 'Vibration';
 // RN's _default_vibration_length: the single-buzz duration when no pattern is given,
 // and the per-segment buzz length the iOS scheduler emits between waits.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@symbiote-native/engine",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "SymbioteNative's retained shadow-tree engine — clone-on-write commit path + event normalization over React Native Fabric, shared by every framework adapter.",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
@@ -32,7 +33,7 @@
     "react-native": ">=0.86"
   },
   "devDependencies": {
-    "@symbiote-native/test-utils": "0.1.5"
+    "@symbiote-native/test-utils": "0.1.6"
   },
   "scripts": {
     "typecheck": "tsc --build",