@symbiote-native/engine 0.1.6 → 0.2.0

package/build/animated/rgba.js

@@ -0,0 +1,55 @@
+// Pure RGBA parsing — no graph node, no AnimatedValue, no imports from this package at all.
+//
+// It is split out of color.ts DELIBERATELY, and must stay dependency-free. `interpolation.ts`
+// needs `normalizeColor` for its color output ranges, and `graph.ts` needs `interpolation.ts`
+// (AnimatedInterpolation lives there). color.ts also defines `AnimatedColor extends
+// AnimatedWithChildren`, so leaving the parser there closes a cycle
+//   graph -> interpolation -> color -> graph
+// which surfaces at load time as `TypeError: Class extends value undefined is not a
+// constructor` — AnimatedWithChildren is still uninitialized when color.ts evaluates. Keeping
+// the pure half in its own leaf module breaks it structurally rather than by import ordering.
+export const DEFAULT_COLOR = { r: 0, g: 0, b: 0, a: 1 };
+// Decompose a #hex (3/4/6/8), rgb()/rgba(), or 0xRRGGBBAA number into channels.
+// undefined when unparseable (a named/platform color), so the caller falls back to
+// the default rather than throwing inside a render. Exported so interpolation's
+// color path parses through the same RGBA decoder (DRY) rather than duplicating it.
+export function normalizeColor(color) {
+    if (typeof color === 'number') {
+        const c = color >>> 0;
+        return { r: (c >>> 24) & 255, g: (c >>> 16) & 255, b: (c >>> 8) & 255, a: (c & 255) / 255 };
+    }
+    const trimmed = color.trim();
+    if (trimmed.startsWith('#'))
+        return parseHex(trimmed);
+    if (/^rgba?\(/i.test(trimmed))
+        return parseRgb(trimmed);
+    return undefined;
+}
+function parseHex(hex) {
+    let body = hex.slice(1);
+    if (body.length === 3 || body.length === 4) {
+        body = body
+            .split('')
+            .map(c => c + c)
+            .join('');
+    }
+    if (body.length !== 6 && body.length !== 8)
+        return undefined;
+    const int = Number.parseInt(body, 16);
+    if (Number.isNaN(int))
+        return undefined;
+    if (body.length === 6) {
+        return { r: (int >>> 16) & 255, g: (int >>> 8) & 255, b: int & 255, a: 1 };
+    }
+    const c = int >>> 0;
+    return { r: (c >>> 24) & 255, g: (c >>> 16) & 255, b: (c >>> 8) & 255, a: (c & 255) / 255 };
+}
+function parseRgb(str) {
+    const match = /^rgba?\(([^)]+)\)$/i.exec(str);
+    if (match === null)
+        return undefined;
+    const parts = match[1].split(',').map(part => Number.parseFloat(part.trim()));
+    if (parts.length < 3 || parts.some(n => Number.isNaN(n)))
+        return undefined;
+    return { r: parts[0], g: parts[1], b: parts[2], a: parts.length >= 4 ? parts[3] : 1 };
+}

package/build/animated/value.js

@@ -119,13 +119,12 @@ export class AnimatedValue extends AnimatedWithChildren {
             this.offset = offset;
         }
     }
-    // Own the native-driver "start" handshake end-to-end: make this value native, mint
+    // Owns the native-driver "start" handshake end-to-end: make this value native, mint
     // its tag, hand the curve to the native module, and on completion sync the JS value
-    // (no re-flush to bound leaves' native side; native already moved the view). A
-    // driver (BaseAnimation.startNativeIfNeeded) supplies only what IT owns: the curve
-    // config, its own animation id, its platform bag, and its own end callback, never
-    // touching __makeNative / __getNativeTag / __onNativeUpdate / flushValue directly.
-    // Information Expert: this value is the one object that actually holds those internals.
+    // (no re-flush; native already moved the view). The driver (BaseAnimation.
+    // startNativeIfNeeded) supplies only what it owns - curve config, animation id,
+    // platform bag, end callback - never touching __makeNative / __getNativeTag /
+    // __onNativeUpdate / flushValue directly; those internals live here.
     __startNativeAnimation(config, nativeId, onEnd, platformConfig) {
         this.__makeNative(platformConfig);
         nativeAnimated.startAnimatingNode(nativeId, this.__getNativeTag(), config, result => {
@@ -164,10 +163,16 @@ export class AnimatedValue extends AnimatedWithChildren {
             this.tracking = null;
         }
     }
-    // Stop any animation and reset to the original value.
+    // Stop any animation and reset to the original value. The native graph keeps its OWN copy of
+    // the value, so a native-driven node has to be told as well - otherwise the reset lands in JS
+    // only and the view stays wherever the animation left it. setValue above pushes for the same
+    // reason; RN pushes here too (Libraries/Animated/nodes/AnimatedValue.js:285).
     resetAnimation(callback) {
         this.stopAnimation(callback);
         this.value = this.startingValue;
+        if (this.isNative) {
+            nativeAnimated.setAnimatedNodeValue(this.__getNativeTag(), this.startingValue);
+        }
     }
     // Drive this value with an animation. Typically called by Animated.timing /
     // spring / decay rather than directly.

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

@@ -20,9 +20,7 @@ import { nextTag } from './tags.js';
 import { registerPostCommit, runPostCommitHooks } from './post-commit.js';
 import { fabricProps } from './fabric-props.js';
 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.
+// Re-exported from ./platform-color so callers don't need to change their import path.
 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).
@@ -173,8 +171,6 @@ function reconcile(slot, node, rootTag, hasTextAncestor, renderableParent, force
     const props = fabricProps(node);
     const childInText = node.isText || hasTextAncestor;
     const committed = mirror.get(node);
-    // The children that actually reach Fabric. Anchors are filtered out here so the
-    // whole walk (child-set emission, identity diff, mirror) is anchor-blind.
     const kids = renderableChildren(node);
     // First mount, or the view kind flipped (RCTText <-> RCTVirtualText when a
     // <Text> moves in or out of another <Text>): a different native component

package/build/debug.d.ts

@@ -2,4 +2,4 @@ declare global {
     var __SYMBIOTE_DEBUG__: boolean | undefined;
 }
 export declare function isDebug(): boolean;
-export declare function dlog(message: string): void;
+export declare function dlog(message: string | (() => string)): void;

package/build/debug.js

@@ -5,7 +5,13 @@
 //     Metro start (--reset-cache), not a rebuild.
 //   - runtime: globalThis.__SYMBIOTE_DEBUG__ = true, an escape hatch for hosts
 //     where the env isn't reachable.
-// Production with neither set pays one property read per call and nothing else.
+// Production with neither set pays one property read per call and nothing else -
+// but ONLY if the caller does not build the message itself first. A template
+// literal is evaluated at the CALL SITE, before dlog can decide anything, so a
+// `dlog(\`… ${JSON.stringify(x)}\`)` on a per-frame path costs its full price with
+// logging off. On a hot path (a getter Angular re-reads every change-detection
+// pass, an Animated reconcile, a scroll-driven apply) pass a THUNK instead:
+// `dlog(() => \`…\`)` - it is only called once the switch is on.
 function envEnabled() {
     return typeof process !== 'undefined' && process.env.DEBUG === '1';
 }
@@ -13,6 +19,7 @@ export function isDebug() {
     return globalThis.__SYMBIOTE_DEBUG__ === true || envEnabled();
 }
 export function dlog(message) {
-    if (isDebug())
-        console.log(`[symbiote] ${message}`);
+    if (!isDebug())
+        return;
+    console.log(`[symbiote] ${typeof message === 'function' ? message() : message}`);
 }

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/events/index.js

@@ -515,7 +515,6 @@ function bubble(target, listenerName, nativeEvent) {
     while (node) {
         const listener = isAnchor(node) ? undefined : node.listeners?.get(listenerName);
         if (listener) {
-            // engine owner adds currentTarget + stopPropagation to SymbioteEvent
             const event = {
                 type: listenerName,
                 target,
@@ -535,7 +534,6 @@ function deliverDirect(target, listenerName, nativeEvent) {
     const listener = target.listeners?.get(listenerName);
     if (!listener)
         return;
-    // engine owner adds currentTarget + stopPropagation to SymbioteEvent
     listener({
         type: listenerName,
         target,

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

@@ -37,11 +37,13 @@ export type { IPlatformStatic, IPlatformOSType, IPlatformSelectSpec } from './pl
 export type { IPlatformConstantsIOS } from './platform/index.ios';
 export type { IPlatformConstantsAndroid } from './platform/index.android';
 export { dlog, isDebug } from './debug';
+export { reportUncaughtError } from './report-error';
+export type { IUncaughtErrorInfo } from './report-error';
 export { getNativeModule, getEnforcingNativeModule } from './native-modules';
 export { installDeviceEventHub, NativeEventEmitter, setDeviceEventSource } from './native-events';
 export type { IEventSubscription, IEventEmitterModule, INativeEventListener, IDeviceEventSource, } from './native-events';
-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';
-export type { IValueXY, IRgbaValue, IColorInput, IEventConfig, IEventListener, IAnimatedEventHandler, INativeEventAttachment, IValueListener, IEasingFunction, IInterpolationConfig, IExtrapolateType, IAnimation, IEndCallback, IEndResult, ICompositeAnimation, ITimingConfig, ISpringConfig, IDecayConfig, IParallelConfig, ILoopAnimationConfig, INativeNodeConfig, INativeAnimationConfig, INativeEventMapping, IPlatformConfig, } from './animated';
+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, createAnimatedLeafLifecycle, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated';
+export type { IAnimatedLeafLifecycle, IValueXY, IRgbaValue, IColorInput, IEventConfig, IEventListener, IAnimatedEventHandler, INativeEventAttachment, IValueListener, IEasingFunction, IInterpolationConfig, IExtrapolateType, IAnimation, IEndCallback, IEndResult, ICompositeAnimation, ITimingConfig, ISpringConfig, IDecayConfig, IParallelConfig, ILoopAnimationConfig, INativeNodeConfig, INativeAnimationConfig, INativeEventMapping, IPlatformConfig, } from './animated';
 export { getSlot } from './fabric';
 export type { IFabricSlot, IFabricNode, IFabricChildSet, IFabricProps, IFabricEventHandler, IRootTag, IMeasureOnSuccess, IMeasureInWindowOnSuccess, IMeasureLayoutOnSuccess, } from './fabric';
 export { Alert } from './alert';

package/build/index.js

@@ -37,9 +37,10 @@ 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 { reportUncaughtError } from './report-error.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 { 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, createAnimatedLeafLifecycle, AnimatedStyle, AnimatedTransform, AnimatedMock, reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated/index.js';
 export { getSlot } from './fabric.js';
 // Imperative runtime modules: framework-agnostic native-bridge consumers (no visual, no
 // lifecycle), moved here from @symbiote-native/react so every adapter re-exports the SAME module.

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 ----------------------------------------------
@@ -148,7 +148,6 @@ function configureNext(config, onAnimationDidEnd, onAnimationDidFail) {
         onAnimationDidEnd?.();
     };
     dlog(`LayoutAnimation.configureNext: dispatching config (duration=${config.duration})`);
-    // Default to a no-op when the caller doesn't supply one.
     manager.configureNextLayoutAnimation(config, onComplete, onAnimationDidFail ?? (() => { }));
 }
 // ---- the LayoutAnimation facade ------------------------------------------

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/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-font-variant.js

@@ -12,6 +12,5 @@ export function processFontVariant(fontVariant) {
     if (typeof fontVariant === 'string') {
         return fontVariant.split(' ').filter(Boolean);
     }
-    // Neither an array nor a string: nothing to split, hand back an empty variant list.
     return [];
 }

package/build/process-transform/index.js

@@ -1,19 +1,15 @@
 // JS-side port of RN's processTransform (Libraries/StyleSheet/processTransform.js).
-// Same root cause as transformOrigin/boxShadow: ReactNativeStyleAttributes registers
-// `transform` with `nativeCSSParsing ? true : {process: processTransform}`, and
-// enableNativeCSSParsing() DEFAULTS TO FALSE, so RN's stock path runs processTransform
-// IN JS. It only does work for a STRING input (parses the CSS string into the entry
-// array); an ARRAY input is returned UNCHANGED. symbiote forwarded a raw string, which
-// Android native cast to ReadableArray and crashed with
-// `java.lang.String cannot be cast to com.facebook.react.bridge.ReadableArray`. This
-// restores the missing JS parse so native always receives the entry array.
+// Same root cause as transformOrigin/boxShadow: RN only parses `transform` in JS when
+// nativeCSSParsing is off (the default), and only for a STRING input - an ARRAY is
+// returned unchanged. symbiote forwarded a raw string once, which Android native cast
+// to ReadableArray and crashed (`String cannot be cast to ReadableArray`). This
+// restores the missing JS parse.
 //
-// CRITICAL: the animated / sticky-header hot path produces transform ARRAYS and flows
-// through commit's processValue on every flush, so the array branch MUST return the
-// byte-identical reference (no decompose, no clone). RN's only array-path work is
-// _validateTransforms, which is __DEV__-only and THROWS via invariant; we never throw
-// into the commit path, so we run a non-throwing check that dlogs and still returns the
-// array unchanged (matching the boxShadow/transformOrigin idiom).
+// CRITICAL: the animated / sticky-header hot path produces transform ARRAYS on every
+// commit flush, so the array branch MUST return the byte-identical reference (no
+// decompose, no clone). RN's only array-path check, _validateTransforms, is __DEV__-only
+// and throws via invariant; we never throw in commit, so we dlog instead and still
+// return the array unchanged.
 import { dlog } from '../debug.js';
 // RN processTransform.js:28: matches each `name(args)` in the CSS string.
 const TRANSFORM_REGEX = /(\w+)\(([^)]+)\)/g;
@@ -78,16 +74,14 @@ function getKeyAndValueFromCSSTransform(key, args) {
             return { key, value: isNaN(Number(args)) ? args : Number(args) };
     }
 }
-// RN processTransform.js:24-50. STRING input is parsed into the entry array; ARRAY input
-// is returned UNCHANGED (RN's only array work, _validateTransforms, is __DEV__-only and
-// throws; we never throw, so we skip it and run a non-throwing dlog sanity check).
+// RN processTransform.js:24-50. String input is parsed into the entry array; array
+// input is returned unchanged (see file header for why).
 export function processTransform(transform) {
     if (transform == null) {
         return [];
     }
     if (typeof transform !== 'string') {
-        // Hot path: animated / sticky-header transforms arrive here as arrays. Return the
-        // same reference (no decompose, no clone) so the flush is a no-op.
+        // Hot path: return the same reference, no clone (see file header).
         warnInvalidTransforms(transform);
         return transform;
     }

package/build/report-error.d.ts

@@ -0,0 +1,5 @@
+export type IUncaughtErrorInfo = {
+    readonly origin: string;
+    readonly componentStack?: string | null;
+};
+export declare function reportUncaughtError(value: unknown, info: IUncaughtErrorInfo): void;

package/build/report-error.js

@@ -0,0 +1,60 @@
+// Hand an error to the host the way React Native itself does, for the seams where an adapter
+// catches something its framework would otherwise have surfaced on its own.
+//
+// RN routes an uncaught render error through ReactFiberErrorDialog -> ExceptionsManager
+// (Libraries/Core/ReactFiberErrorDialog.js), which is reachable only by a deep path into RN's
+// Libraries. `global.ErrorUtils` is the same surface through the documented global that
+// @react-native/js-polyfills installs before any module evaluates - RN's own
+// Libraries/vendor/core/ErrorUtils.js is nothing but `export default global.ErrorUtils`. Off a
+// native host (vitest, node smokes) the global is absent and console.error is the whole channel.
+//
+// This is NOT the dlog channel. dlog is DEBUG-gated and therefore the developer's; an error that
+// blanked the screen has to reach the app whether or not anyone turned diagnostics on.
+// Read off globalThis through Reflect rather than named as an identifier, and deliberately NOT
+// declared in an ambient block: react-native ships its own `const ErrorUtils: ErrorUtils` in
+// src/types/globals.d.ts, so a `declare global { var ErrorUtils }` here redeclares it (TS2451) for
+// every package whose tsconfig pulls in RN's types - the engine's own does not, so it typechecks
+// clean here and breaks ngc downstream. RN's declared shape also lists only the two
+// get/setGlobalHandler members, not reportError, which the polyfill does install.
+function nativeReporter() {
+    const utils = Reflect.get(globalThis, 'ErrorUtils');
+    if (typeof utils !== 'object' || utils === null)
+        return null;
+    const report = Reflect.get(utils, 'reportError');
+    if (typeof report !== 'function')
+        return null;
+    return error => {
+        Reflect.apply(report, utils, [error]);
+    };
+}
+// A throw is not required to be an Error - a string, or null, reaches here just as easily, and
+// the host's reporter wants something with a message and a stack. RN wraps the same way, via
+// SyntheticError.
+function toError(value, origin) {
+    if (value instanceof Error)
+        return value;
+    return new Error(`${origin}: ${String(value)}`);
+}
+export function reportUncaughtError(value, info) {
+    const error = toError(value, info.origin);
+    if (info.componentStack) {
+        // LogBox reads these two off the error to render the component frames; RN's own
+        // ReactFiberErrorDialog sets exactly the same pair, in a try/catch because a frozen or
+        // sealed error still deserves to be reported, just without the frames.
+        try {
+            Object.assign(error, { componentStack: info.componentStack, isComponentError: true });
+        }
+        catch {
+            // Reported below regardless.
+        }
+    }
+    const report = nativeReporter();
+    if (report !== null) {
+        // Exactly one channel, never both: RN routes console.error into LogBox as well, so logging
+        // here too would double-report every error. Upstream returns false from showErrorDialog for
+        // this same reason (Libraries/Core/ReactFiberErrorDialog.js:57).
+        report(error);
+        return;
+    }
+    console.error(`[symbiote] ${info.origin}:`, error);
+}

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

@@ -4,13 +4,12 @@
 // setColor/setTranslucent, same module name ('StatusBarManager'). Metro picks this on an
 // Android host; iOS keeps its own shape. Each adapter wraps these with its declarative component.
 //
-// History: this used to be a no-op. Driving the window flags from our bridgeless surface
-// blanked the app: a status-bar relayout triggered stopSurface, which threw "Global was
-// not installed" because RN installs global.RN$stopSurface from its own renderer, which we
-// 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';
+// Driving window flags from our bridgeless surface used to blank the app: a status-bar
+// relayout triggered stopSurface, which threw "Global was not installed" because RN's
+// own renderer installs global.RN$stopSurface and we replace that renderer. Fixed by
+// render.ts installing RN$stopSurface itself (see installStopSurfaceGlobal) - verified
+// on device: show/hide + light/dark text survive the relayout without blanking.
+import { getNativeModule } from '../native-modules/index.js';
 import { dlog } from '../debug.js';
 import { processColor } from '../platform-color/index.js';
 import { STATUS_BAR_MANAGER } from './shared.js';

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