@symbiote-native/engine 0.1.1 → 0.1.3

package/build/platform/index.ios.js

@@ -2,8 +2,8 @@
 // is the static 'ios'; everything else derives from the PlatformConstants native module
 // (RN spec NativePlatformConstantsIOS.js), read lazily and cached via the shared
 // resolver. Metro picks this on an iOS host; it is also the base re-export target
-// (platform.ts) so tsc / tsx / web (no Metro) land here too. See .docs/decisions/0022.
-import { createConstantsResolver, UNKNOWN_VERSION, } from './shared';
+// (platform.ts) so tsc / tsx / web (no Metro) land here too.
+import { createConstantsResolver, UNKNOWN_VERSION, } from './shared.js';
 // interfaceIdiom values RN compares against for the device-class getters.
 const IDIOM_PAD = 'pad';
 const IDIOM_TV = 'tv';

package/build/platform/index.js

@@ -1,5 +1,4 @@
 // Base / default Platform: re-exports the iOS implementation. Metro overrides this
 // with platform.ios.ts / platform.android.ts on a real host; under tsc / tsx / web
 // (no Metro) resolution lands here. The filename is the selector, no Platform.OS read.
-// See .docs/decisions/0022 (and 0020 for the same split on component names).
-export * from './index.ios';
+export * from './index.ios.js';

package/build/platform/shared.js

@@ -4,9 +4,8 @@
 // owns only what genuinely differs: the OS literal, the constants shape + guard, the
 // 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.
-// See .docs/decisions/0022 (and 0020 for the same split on component names).
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.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-aspect-ratio.js

@@ -5,7 +5,7 @@
 // already-working form) passes through untouched; this is a no-op for it.
 //
 // RN throws via invariant() in __DEV__ on a malformed value; we dlog and return undefined.
-import { dlog } from './debug';
+import { dlog } from './debug.js';
 // RN processAspectRatio.js:15-63. number → number; ratio string → number; invalid → undefined.
 export function processAspectRatio(aspectRatio) {
     if (typeof aspectRatio === 'number') {

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

@@ -7,9 +7,9 @@
 // processColor is referenced from ../commit at RUNTIME only (inside function bodies), never at
 // module-init, so the cyclic import (commit -> here -> commit) has no TDZ hazard — same pattern
 // as process-box-shadow/process-filter.
-import { processColor } from '../commit';
-import { isOpaqueColorValue } from '../platform-color';
-import { dlog } from '../debug';
+import { processColor } from '../commit.js';
+import { isOpaqueColorValue } from '../platform-color.js';
+import { dlog } from '../debug.js';
 // RN processBackgroundImage.js: pre-compiled patterns.
 const NEWLINE_REGEX = /\n/g;
 const GRADIENT_REGEX = /^(linear|radial)-gradient\(((?:\([^)]*\)|[^()])*)\)/;

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

@@ -7,9 +7,9 @@
 //
 // processColor is referenced from ./commit at RUNTIME only (inside the function bodies),
 // never at module-init, so the cyclic import (commit -> here -> commit) has no TDZ hazard.
-import { processColor } from '../commit';
-import { isOpaqueColorValue } from '../platform-color';
-import { dlog } from '../debug';
+import { processColor } from '../commit.js';
+import { isOpaqueColorValue } from '../platform-color.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).
 const COMMA_SPLIT_REGEX = /,(?![^()]*\))/;

package/build/process-filter.js

@@ -7,9 +7,9 @@
 //
 // processColor is referenced from ./commit at RUNTIME only (inside function bodies),
 // never at module-init, so the cyclic import (commit -> here -> commit) has no TDZ hazard.
-import { processColor } from './commit';
-import { isOpaqueColorValue } from './platform-color';
-import { dlog } from './debug';
+import { processColor } from './commit.js';
+import { isOpaqueColorValue } from './platform-color.js';
+import { dlog } from './debug.js';
 // RN processFilter.js:19-24: pre-compiled patterns.
 const NEWLINE_REGEX = /\n/g;
 const FILTER_FUNCTION_REGEX = /([\w-]+)\(([^()]*|\([^()]*\)|[^()]*\([^()]*\)[^()]*)\)/g;

package/build/process-transform/index.js

@@ -14,7 +14,7 @@
 // _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).
-import { dlog } from '../debug';
+import { dlog } from '../debug.js';
 // RN processTransform.js:28: matches each `name(args)` in the CSS string.
 const TRANSFORM_REGEX = /(\w+)\(([^)]+)\)/g;
 // RN processTransform.js:59: splits one arg into [, number, , unit?].

package/build/process-transform-origin/index.js

@@ -9,7 +9,7 @@
 //
 // RN throws via invariant() on a malformed value; we instead dlog and keep the partial array
 // (matching the boxShadow/filter idiom of never throwing into the commit path).
-import { dlog } from '../debug';
+import { dlog } from '../debug.js';
 // RN processTransformOrigin.js:14, pre-compiled pattern matching each keyword / length token.
 const TRANSFORM_ORIGIN_REGEX = /(top|bottom|left|right|center|\d+(?:%|px)|0)/gi;
 // RN processTransformOrigin.js:16-18.

package/build/settings/index.js

@@ -5,15 +5,13 @@
 // watched key's value changes. Native re-broadcasts external edits through the
 // 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';
-import { getNativeModule } from '../native-modules';
-import { dlog } from '../debug';
+import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
+import { getNativeModule } from '../native-modules.js';
+import { dlog } from '../debug.js';
 // The iOS native module name RN registers this under. NOTE: this is the name the
 // iOS JS wrapper resolves via `TurboModuleRegistry.getEnforcing('SettingsManager')`.
-// The spec filename is `INativeSettingsManager`. Per the symbiote invariant, a
-// module name is only provable on a real host (a headless fake answers to any
-// name); this iOS name is device-verify-pending.
-// See .docs/native-module-platform-routing.md.
+// The spec filename is `INativeSettingsManager`. A module name is only provable on a
+// real host (a headless fake answers to any name); this iOS name is device-verify-pending.
 const SETTINGS_MODULE = 'SettingsManager';
 // The device event native emits when the app's defaults change out from under JS
 // (e.g. a Settings.bundle edit). Its payload is a record of changed key->value.

package/build/share/index.android.js

@@ -2,15 +2,14 @@
 // `share(content, dialogTitle?) -> Promise<{ action }>`. We validate content, build the
 // content dict (title/message), forward the dialog title, and map the resolved action
 // onto the shared IShareAction shape; Android has no dismiss path, so RN fills the
-// missing activityType with null. Metro picks this file on an Android host. See ADR 0019.
+// missing activityType with null. Metro picks this file on an Android host.
 //
 // device-verify-pending: the `ShareModule` name matches NativeShareModule's
 // 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).
-// See .docs/native-module-platform-routing.md, ADR 0012.
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
-import { validateContent, shareActions, SHARED_ACTION, DISMISSED_ACTION } from './shared';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.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
 // reading `action` (no `as`).

package/build/share/index.ios.js

@@ -3,10 +3,10 @@
 // `showShareActionSheetWithOptions(options, failure, success)`. We validate content, map
 // options onto the native share options, and resolve the IShareAction from the success
 // callback. Metro picks this file on an iOS host; the base share.ts re-exports it for
-// web/headless. See ADR 0019.
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
-import { validateContent, shareActions, SHARED_ACTION, DISMISSED_ACTION } from './shared';
+// web/headless.
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.js';
+import { validateContent, shareActions, SHARED_ACTION, DISMISSED_ACTION } from './shared.js';
 const ACTION_SHEET_MANAGER = 'ActionSheetManager';
 export const Share = {
     ...shareActions,

package/build/share/index.js

@@ -2,5 +2,5 @@
 // platform file). Metro overrides this with share.ios.ts / share.android.ts on a real
 // iOS/Android host; off those, the iOS build is the fallback (its ActionSheetManager
 // resolves null elsewhere → graceful reject). The barrel imports './share', which
-// resolves here under tsc/tsx and to the platform file under Metro. See ADR 0019.
-export * from './index.ios';
+// resolves here under tsc/tsx and to the platform file under Metro.
+export * from './index.ios.js';

package/build/share/shared.js

@@ -6,7 +6,7 @@
 //
 // Metro selects the platform file on a real host (share.android.ts > share.ts); the base
 // share.ts re-exports the iOS build for web/headless. There is no runtime `Platform.OS`
-// read: the filename is the selector. See ADR 0019.
+// read: the filename is the selector.
 // RN's Share action constants (RN Share.js ~173/179). These back the documented
 // `result.action === Share.dismissedAction` pattern. True statically-known literals,
 // so CONSTANT_CASE; the public fields (Share.sharedAction / Share.dismissedAction) are

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

@@ -9,11 +9,11 @@
 // 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 installStopSurfaceGlobal + native-module-platform-routing.
-import { getNativeModule } from '../native-modules';
-import { processColor } from '../commit';
-import { dlog } from '../debug';
-import { STATUS_BAR_MANAGER } from './shared';
+// light/dark text). See render.ts's installStopSurfaceGlobal.
+import { getNativeModule } from '../native-modules.js';
+import { processColor } from '../commit.js';
+import { dlog } from '../debug.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
 // (null for an unparseable color, headless identity passthrough of a string) is dropped.

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

@@ -1,7 +1,6 @@
 // StatusBar on iOS drives the iOS `StatusBarManager` TurboModule from props (via
 // applyStatusBarProps) and from the static methods (statusBarImperative). The native
-// contract is RN's spec at
-// .vendors/react-native/.../src/private/specs_DEPRECATED/modules/NativeStatusBarManagerIOS.js:
+// contract mirrors RN's own NativeStatusBarManagerIOS spec:
 //   setStyle(statusBarStyle?: string, animated: boolean)
 //   setHidden(hidden: boolean, withAnimation: 'none' | 'fade' | 'slide')
 //   setNetworkActivityIndicatorVisible(visible: boolean)
@@ -9,9 +8,9 @@
 // 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';
-import { dlog } from '../debug';
-import { STATUS_BAR_MANAGER, STATIC_HIDE_TRANSITION, hideTransition, } from './shared';
+import { getNativeModule } from '../native-modules.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
 // declarative component's effect, on mount and on every prop change. Resolves lazily inside
 // the call, not at import; keeps this module importable headless before a fake

package/build/status-bar/index.js

@@ -1,4 +1,4 @@
 // Base / default StatusBar engine surface; re-exports the iOS build. Metro overrides this
 // with status-bar.ios.ts / .android.ts on a real host; under tsx / tsc / web the host config
 // resolves here. Filename is the selector, no Platform.OS read. See status-bar-shared.ts.
-export * from './index.ios';
+export * from './index.ios.js';

package/build/status-bar/shared.js

@@ -6,7 +6,7 @@
 // flags from our bridgeless surface blanks it (a window-insets relayout detaches the Fabric
 // surface). So the .ios/.android files own the native calls (applyStatusBarProps +
 // statusBarImperative); the types + the framework-agnostic imperative surface live here.
-// Filename selects, no Platform.OS read (see ADR 0012 + native_module_name_is_platform_specific).
+// Filename selects, no Platform.OS read.
 //
 // This is the engine half: pure types + the imperative API. Each adapter wraps it with a
 // per-framework declarative component (React FC + useEffect, Vue defineComponent + watchEffect)

package/build/style-registry/index.js

@@ -1,20 +1,17 @@
-// Runtime style registry, ported from wolf-tui's internal/shared/src/styles/registry.ts.
-// Side-effect CSS imports (compiled by the sibling CSS-to-style build package, not
-// this module) call registerStyles() with camelCase keys; components look them up
-// by resolveClassName(). No CSS parsing happens here — this is a Map<string, ...>
-// lookup, nothing more.
+// Runtime style registry. Side-effect CSS imports (compiled by the sibling CSS-to-style
+// build package, not this module) call registerStyles() with camelCase keys; components
+// look them up by resolveClassName(). No CSS parsing happens here — this is a
+// Map<string, ...> lookup, nothing more.
 //
-// Dropped vs the wolf-tui original: all Tailwind-utility detection (registerTailwind-
-// Metadata / isTailwindUtility / custom prefix-static sets) — this repo's style
-// surface has no Tailwind layer, so compound lookup below always runs for 2-4-part
-// class strings instead of being gated behind "no part looks like a utility class".
+// This registry has no Tailwind-utility detection layer — this repo's style surface has
+// no Tailwind layer, so the compound lookup below always runs for 2-4-part class strings
+// instead of being gated behind "no part looks like a utility class".
 //
 // kebab-case authoring: a CSS selector `.section-label` always registers under the
 // camelCase key `sectionLabel` (@symbiote-native/css-parser's extractClassName), so a template
 // can write EITHER `class="sectionLabel"` OR `class="section-label"` — resolveOne below
-// falls back to the kebab->camel form on a miss. Reinstated (wolf-tui had this, an
-// earlier port here dropped it on the assumption authors would always match the
-// camelCase key exactly) once that assumption proved wrong in practice.
+// falls back to the kebab->camel form on a miss. The fallback matters because assuming
+// authors would always match the camelCase key exactly proved wrong in practice.
 // Compound lookup tries every ordering of 2-4 space-separated class parts joined by
 // '.' (e.g. "btn primary" -> "btn.primary" / "primary.btn") before falling back to a
 // per-class merge, mirroring CSS compound-selector registration (`.btn.primary { }`).
@@ -93,10 +90,9 @@ function generateKPermutations(parts, size) {
     helper([], parts, 0);
     return result;
 }
-// wolf-tui joins a compound permutation with '.' ("btn.primary") because its CSS
-// pipeline registers dot-joined selector strings. This repo's CSS-to-style compiler
-// emits plain camelCase keys for every class, single or compound, so "btn primary"
-// must resolve against a registered "btnPrimary" instead.
+// Compound permutations join as camelCase ("btn primary" -> "btnPrimary") because this
+// repo's CSS-to-style compiler emits plain camelCase keys for every class, single or
+// compound, so "btn primary" must resolve against a registered "btnPrimary".
 function toCompoundKey(parts) {
     return parts.reduce((key, part, index) => (index === 0 ? part : key + capitalize(part)), '');
 }

package/build/style-sheet/index.js

@@ -4,9 +4,9 @@
 // array, `compose` picks/pairs two styles, plus the `hairlineWidth` / `absoluteFill`
 // 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';
-import { getNativeModule } from '../native-modules';
-import { flattenStyle } from '../style';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.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
 // the same literal in PixelRatio.roundToNearestPixel(0.4)).

package/build/surface.js

@@ -1,9 +1,9 @@
 // A surface is one mounted root: it owns the rootTag handed down by the native
 // Fabric host and the list of top-level retained nodes. Adapters mutate it and
 // ask it to commit; the surface coalesces commits and drives the engine.
-import { commitChildren } from './commit';
-import { dlog } from './debug';
-import { installEventHandler } from './events';
+import { commitChildren } from './commit.js';
+import { dlog } from './debug.js';
+import { installEventHandler } from './events/index.js';
 export class SymbioteSurface {
     rootTag;
     children = [];

package/build/text-input-state.js

@@ -2,8 +2,8 @@
 // JS-side because native exposes no focus getter. TextInput reports focus/blur here so
 // Keyboard.dismiss can blur whatever holds focus without a ref, exactly how RN's
 // dismissKeyboard() works (blurTextInput(currentlyFocusedInput())).
-import { dispatchViewCommand } from './commit';
-import { dlog } from './debug';
+import { dispatchViewCommand } from './commit.js';
+import { dlog } from './debug.js';
 let currentlyFocused = null;
 // The input that last reported focus and hasn't reported blur, or null.
 export function currentlyFocusedInput() {

package/build/toast-android/index.js

@@ -13,13 +13,13 @@
 //   show(message: string, duration: number)
 //   showWithGravity(message: string, duration: number, gravity: number)
 //   showWithGravityAndOffset(message, duration, gravity, xOffset, yOffset)
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.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`. Per the symbiote invariant, a module name is
-// only provable on a real host (a headless fake answers to any name); this Android
-// name is device-verify-pending. See .docs/native-module-platform-routing.md.
+// spec filename `INativeToastAndroid`. A module name is only provable on a real
+// host (a headless fake answers to any name); this Android name is confirmed from
+// RN source but not yet exercised on a device.
 const TOAST_MODULE = 'ToastAndroid';
 // Conventional RN values for SHORT/LONG/TOP/BOTTOM/CENTER. On a real device the
 // numbers come from native getConstants() (resolved below); these are the fallbacks

package/build/vibration/index.android.js

@@ -5,9 +5,8 @@
 //
 // device-verify-pending: the `Vibration` name and the `vibrateByPattern` routing are
 // confirmed from RN source but not yet exercised on a real Android host: only a
-// bridgeless resolution log there can prove the name. See
-// .docs/native-module-platform-routing.md.
-import { createVibration } from './shared';
+// bridgeless resolution log there can prove the name.
+import { createVibration } from './shared.js';
 // RN encodes "do not repeat" as -1 and "repeat from start" as 0 in vibrateByPattern.
 const REPEAT_NONE = -1;
 const REPEAT_FROM_START = 0;

package/build/vibration/index.ios.js

@@ -3,7 +3,7 @@
 // Everything else (the single-number buzz, cancel, the module resolver) is the shared
 // core. Metro picks this file on an iOS host; the base vibration.ts re-exports it for
 // web/headless.
-import { createVibration, DEFAULT_VIBRATION_LENGTH } from './shared';
+import { createVibration, DEFAULT_VIBRATION_LENGTH } from './shared.js';
 // JS scheduler state, mirroring RN's _vibrating / _id. `scheduleId` guards against a
 // stale timer from a previous run firing into a new one.
 let vibrating = false;

package/build/vibration/index.js

@@ -2,5 +2,5 @@
 // platform file). Metro overrides this with vibration.ios.ts / vibration.android.ts on a
 // real iOS/Android host; off those, the iOS build is the fallback (its Vibration module
 // resolves null elsewhere → graceful no-op). The barrel imports './vibration', which
-// resolves here under tsc/tsx and to the platform file under Metro. See ADR 0019.
-export * from './index.ios';
+// resolves here under tsc/tsx and to the platform file under Metro.
+export * from './index.ios.js';

package/build/vibration/shared.js

@@ -5,19 +5,18 @@
 // `createVibration`. Mirrors RN's Libraries/Vibration/Vibration.js: a number is a single
 // buzz, an array is a pattern.
 //
-// Native module name is `Vibration` on BOTH iOS and Android (see
-// .docs/native-module-platform-routing.md), so unlike Linking the module name is shared,
-// not divergent. The TurboModule spec lives at specs_DEPRECATED/modules/INativeVibration.js:
+// Native module name is `Vibration` on BOTH iOS and Android, so unlike Linking the
+// module name is shared, not divergent. The TurboModule spec lives at
+// specs_DEPRECATED/modules/INativeVibration.js:
 //   vibrate(pattern: number)
 //   vibrateByPattern(pattern: number[], repeat: number)
 //   cancel()
 //
 // Metro selects the platform file on a real host (vibration.android.ts > vibration.ts);
 // the base vibration.ts re-exports the iOS build for web/headless. There is no runtime
-// `Platform.OS` read; the filename is the selector. See ADR 0019. No Fabric view,
-// pure JS->native.
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
+// `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';
 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/build/view-config.js

@@ -11,7 +11,7 @@
 // reaches Fabric). Structural adapters (Svelte `addEventListener`, Angular
 // `Renderer2.listen`) deliver events pre-separated and call `setEventListener`
 // directly, bypassing this entirely.
-import { isRegisteredEvent } from './registry';
+import { isRegisteredEvent } from './registry.js';
 // Accessibility events from RN's base ViewConfig: every view can emit them.
 // accessibilityAction fires on iOS + Android; the other three are iOS-only and inert
 // on Android (no native producer), exactly like `scrollToTop` below.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/engine",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "SymbioteNative's retained shadow-tree engine — clone-on-write commit path + event normalization over React Native Fabric, shared by every framework adapter.",
   "repository": {
     "type": "git",
@@ -32,7 +32,7 @@
     "react-native": ">=0.86"
   },
   "devDependencies": {
-    "@symbiote-native/test-utils": "0.0.0"
+    "@symbiote-native/test-utils": "0.1.3"
   },
   "scripts": {
     "typecheck": "tsc --build",