@symbiote-native/engine 0.1.1 → 0.1.3

package/README.md

@@ -30,6 +30,16 @@ dance Fabric requires, done **once**, for every framework.
 The mutation API below is intentionally low-level and closely mirrors Fabric's own persistent
 semantics — it is an internal seam, not an app-facing API.
 
+### Install
+
+Most apps get this transitively, through an adapter (`@symbiote-native/react`,
+`@symbiote-native/vue`, `@symbiote-native/angular` all depend on it). Writing or debugging an
+adapter yourself:
+
+```bash
+npm install @symbiote-native/engine
+```
+
 ---
 
 ## The mutation API — `core/engine/src/node.ts`

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

@@ -6,17 +6,16 @@
 // 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 { getNativeModule } from '../native-modules';
-import { installDeviceEventHub, NativeEventEmitter, } from '../native-events';
-import { isSymbioteNode } from '../node';
-import { sendAccessibilityEvent as sharedSendAccessibilityEvent } from '../commit';
-import { dlog } from '../debug';
-import { isBoolean, } from './shared';
+import { getNativeModule } from '../native-modules.js';
+import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
+import { isSymbioteNode } from '../node.js';
+import { sendAccessibilityEvent as sharedSendAccessibilityEvent } from '../commit.js';
+import { dlog } from '../debug.js';
+import { isBoolean, } from './shared.js';
 // The Android native module name. This is the module the Android JS wrapper
 // (INativeAccessibilityInfoAndroid) resolves: the stock RN `AccessibilityInfo` Turbo/legacy
-// module. 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.
+// module. A module name is only provable on a real host (a headless fake answers to any
+// name); this Android name is DEVICE-VERIFY-PENDING.
 const ACCESSIBILITY_MODULE = 'AccessibilityInfo';
 // Public event name -> the Android device event the native side emits. Android renames
 // most of them; events with no Android source (iOS-only) are absent and yield an inert

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

@@ -6,18 +6,17 @@
 // 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 { getNativeModule } from '../native-modules';
-import { installDeviceEventHub, NativeEventEmitter, } from '../native-events';
-import { isSymbioteNode } from '../node';
-import { sendAccessibilityEvent as sharedSendAccessibilityEvent } from '../commit';
-import { dlog } from '../debug';
-import { isBoolean, } from './shared';
+import { getNativeModule } from '../native-modules.js';
+import { installDeviceEventHub, NativeEventEmitter, } from '../native-events.js';
+import { isSymbioteNode } from '../node.js';
+import { sendAccessibilityEvent as sharedSendAccessibilityEvent } from '../commit.js';
+import { dlog } from '../debug.js';
+import { isBoolean, } from './shared.js';
 // The iOS native module name RN registers this under. NOTE: this is the name the iOS JS
 // wrapper (INativeAccessibilityManagerIOS) resolves via
 // `TurboModuleRegistry.get('AccessibilityManager')`, NOT the spec filename
-// `NativeAccessibilityManager`. 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-verified
-// (the pre-split file shipped it). See .docs/native-module-platform-routing.md.
+// `NativeAccessibilityManager`. A module name is only provable on a real host (a headless
+// fake answers to any name); this iOS name is device-verified (the pre-split file shipped it).
 const ACCESSIBILITY_MODULE = 'AccessibilityManager';
 // Public event name -> the iOS device event the native side emits. iOS keeps the names
 // 1:1; the indirection exists only so the mapping stays explicit (Android renames them).

package/build/accessibility-info/index.js

@@ -2,4 +2,4 @@
 // accessibility-info.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
 // accessibility-info-shared.ts.
-export * from './index.ios';
+export * from './index.ios.js';

package/build/accessibility-info/shared.js

@@ -6,7 +6,8 @@
 // event maps to (iOS `screenReaderChanged` vs Android `touchExplorationDidChange`).
 // So the .ios/.android files own the native calls and per-platform event-name map;
 // the public types + the shared method surface live here. Filename selects, no
-// Platform.OS read (see ADR 0012 + native_module_name_is_platform_specific). Mirrors
+// Platform.OS read: the native module name is resolved per platform inside those
+// files, not derived from this file's name. Mirrors
 // RN's Libraries/Components/AccessibilityInfo/AccessibilityInfo.js.
 export function isBoolean(value) {
     return typeof value === 'boolean';

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

@@ -3,8 +3,8 @@
 // passes options straight through and the native `callback(buttonIndex)` reports
 // the tapped row. We mirror RN faithfully.
 //
-// The native contract is confirmed from RN's TurboModule spec at
-// .vendors/react-native/.../src/private/specs_DEPRECATED/modules/INativeActionSheetManager.js:
+// The native contract is confirmed from RN's TurboModule spec for
+// `INativeActionSheetManager`:
 //   showActionSheetWithOptions(options, callback: (buttonIndex: number) => void)
 //   showShareActionSheetWithOptions(options, failureCallback, successCallback)
 //   dismissActionSheet?()
@@ -16,8 +16,8 @@
 // through processColor before handing them to native. symbiote centralizes color
 // 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';
-import { getNativeModule } from '../native-modules';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.js';
 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

@@ -5,20 +5,20 @@
 // neutral, last-to-first as RN does. Everything platform-agnostic is the shared core.
 // Metro picks this file on an Android host.
 //
-// The native contract is confirmed from RN's TurboModule spec:
-//   .vendors/.../specs_DEPRECATED/modules/INativeDialogManagerAndroid.js
-//     getConstants(): { buttonClicked, dismissed, buttonPositive, buttonNegative,
-//                       buttonNeutral }
-//     showAlert(config, onError: (msg) => void, onAction: (action, buttonKey?) => void)
+// The native contract is confirmed from RN's TurboModule spec for
+// `INativeDialogManagerAndroid`:
+//   getConstants(): { buttonClicked, dismissed, buttonPositive, buttonNegative,
+//                     buttonNeutral }
+//   showAlert(config, onError: (msg) => void, onAction: (action, buttonKey?) => void)
 //
 // device-verify-pending: the `DialogManagerAndroid` name and 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.
+// there can prove the name.
 //
 // Non-throwing, like StatusBar: a missing native module is a no-op, never a crash.
-import { dlog } from '../debug';
-import { getNativeModule } from '../native-modules';
-import { DEFAULT_POSITIVE_TEXT, normalizeButtons, } from './shared';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.js';
+import { DEFAULT_POSITIVE_TEXT, normalizeButtons, } from './shared.js';
 const DIALOG_MANAGER = 'DialogManagerAndroid';
 // RN's hardwired Android fallbacks for the button-key constants (NativeDialogManager-
 // Android documents buttonPositive=-1, buttonNegative=-2, buttonNeutral=-3, and the

package/build/alert/index.ios.js

@@ -5,14 +5,14 @@
 // AlertManager path RN uses. Metro picks this file on an iOS host; the base alert.ts
 // re-exports it for web/headless.
 //
-// The native contract is confirmed from RN's TurboModule spec:
-//   .vendors/.../specs_DEPRECATED/modules/INativeAlertManager.js
-//     alertWithArgs(args: Args, callback: (id: number, value: string) => void)
+// The native contract is confirmed from RN's TurboModule spec for
+// `INativeAlertManager`:
+//   alertWithArgs(args: Args, callback: (id: number, value: string) => void)
 //
 // 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';
-import { getNativeModule } from '../native-modules';
+import { dlog } from '../debug.js';
+import { getNativeModule } from '../native-modules.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/alert/index.js

@@ -4,5 +4,5 @@
 // → graceful no-op). The barrel imports './alert', which resolves here under tsc/tsx and to
 // the platform file under Metro. The `export *` re-exports the public type names
 // (AlertType, AlertButtonStyle, AlertButton, AlertButtons, AlertOptions) so the barrel's
-// `export type { ... } from '../alert'` still resolves. See ADR 0019.
-export * from './index.ios';
+// `export type { ... } from '../alert/index.js'` still resolves.
+export * from './index.ios.js';

package/build/alert/shared.js

@@ -3,7 +3,7 @@
 // constant defaults, and the button-normalization helper. The per-platform files
 // (alert.ios.ts / alert.android.ts) implement `alert()` fully against their own native
 // module (iOS keeps `prompt` too); the two native call shapes are too divergent to share
-// a factory. No native, no `Platform.OS` read here. See ADR 0019.
+// a factory. No native, no `Platform.OS` read here.
 // The default positive label RN uses when a button carries no text.
 export const DEFAULT_POSITIVE_TEXT = 'OK';
 // Normalize the `buttons` arg into a consistent list: undefined/empty becomes a single

package/build/animated/animated-component-shared.js

@@ -3,10 +3,9 @@
 // mechanism (capture the host node, build an AnimatedProps leaf, reduce animated
 // props to their current values, override with the passthrough style) is pure JS,
 // identical across frameworks. Only `assignRef` is framework-ref-specific and stays
-// per-adapter; everything here is shared. Extracted from the React wrapper (ADR
-// 0016/0017) so a new adapter reuses it verbatim.
-import { AnimatedNode } from './graph';
-import { AnimatedStyle } from './style';
+// per-adapter; everything here is shared so a new adapter reuses it verbatim.
+import { AnimatedNode } from './graph.js';
+import { AnimatedStyle } from './style.js';
 export function isAnimatedNode(value) {
     return value instanceof AnimatedNode;
 }

package/build/animated/animations/base.js

@@ -1,5 +1,5 @@
 // Minimal driver base, ported from RN's animations/Animation.js with every
-// native path removed (ADR 0016): no NativeAnimatedHelper, no
+// native path removed: no NativeAnimatedHelper, no
 // __startAnimationIfNative, no shouldUseNativeDriver, no FeatureFlags. What
 // remains is the JS-only contract: hold the end callback, track whether the
 // animation is still active, and fire onEnd at most once.
@@ -8,9 +8,9 @@
 // owns its own requestAnimationFrame loop. They are declared as methods (not
 // class fields) so a subclass override is not shadowed under
 // useDefineForClassFields.
-import { flushValue } from '../graph';
-import { dlog, isDebug } from '../../debug';
-import { generateNativeAnimationId, isNativeAnimatedAvailable, nativeAnimated, } from '../native/native-animated';
+import { flushValue } from '../graph.js';
+import { dlog, isDebug } from '../../debug.js';
+import { generateNativeAnimationId, isNativeAnimatedAvailable, nativeAnimated, } from '../native/native-animated.js';
 export class BaseAnimation {
     // `protected` so subclasses read it inside their rAF loop to decide whether to
     // schedule the next frame; cleared by stop().
@@ -48,7 +48,7 @@ export class BaseAnimation {
     // If useNativeDriver was requested and the module is present, mirror the value
     // graph into native and hand the curve to native. The JS rAF loop is then
     // skipped entirely. Returns true when native took over. Falls back to JS (false)
-    // when the module is missing (ADR 0016 path), so an app without RCTAnimation
+    // when the module is missing, so an app without RCTAnimation
     // still animates.
     startNativeIfNeeded(animatedValue) {
         if (!this.nativeDriverRequested)

package/build/animated/animations/composition.js

@@ -1,17 +1,17 @@
 // The driver factory + composition API, ported from RN's
-// AnimatedImplementation.js, JS orchestration only (ADR 0016). `timing` /
+// AnimatedImplementation.js, JS orchestration only. `timing` /
 // `spring` / `decay` wrap a value with a fresh driver and return a
 // CompositeAnimation; `parallel` / `sequence` / `stagger` / `loop` / `delay`
 // orchestrate those. Vector (XY/Color) handling, tracking, AnimatedEvent and
 // every native-loop branch are dropped.
-import { dlog } from '../../debug';
-import { isNativeAnimatedAvailable } from '../native/native-animated';
-import { AnimatedNode } from '../graph';
-import { AnimatedValue } from '../value';
-import { AnimatedTracking } from './tracking';
-import { TimingAnimation } from './timing';
-import { SpringAnimation } from './spring';
-import { DecayAnimation } from './decay';
+import { dlog } from '../../debug.js';
+import { isNativeAnimatedAvailable } from '../native/native-animated.js';
+import { AnimatedNode } from '../graph.js';
+import { AnimatedValue } from '../value.js';
+import { AnimatedTracking } from './tracking.js';
+import { TimingAnimation } from './timing.js';
+import { SpringAnimation } from './spring.js';
+import { DecayAnimation } from './decay.js';
 // A loop offloads to native only when the driver was asked for the native path AND
 // the module is present; otherwise the JS-restart loop must run (a JS timing runs
 // once, it does not loop itself).

package/build/animated/animations/decay.js

@@ -1,10 +1,10 @@
-// DecayAnimation: ported from RN's animations/DecayAnimation.js, JS path only
-// (ADR 0016). Models momentum bleeding off under friction: an initial velocity
+// DecayAnimation: ported from RN's animations/DecayAnimation.js, JS path only.
+// Models momentum bleeding off under friction: an initial velocity
 // decays exponentially toward a resting value. Ends when consecutive frames
 // move less than 0.1.
-import { dlog } from '../../debug';
-import { BaseAnimation } from './base';
-import { cancelFrame, requestFrame } from './raf';
+import { dlog } from '../../debug.js';
+import { BaseAnimation } from './base.js';
+import { cancelFrame, requestFrame } from './raf.js';
 export class DecayAnimation extends BaseAnimation {
     startTime = 0;
     lastValue = 0;

package/build/animated/animations/spring.js

@@ -1,13 +1,13 @@
 // SpringAnimation: ported from RN's animations/SpringAnimation.js, JS path
-// only (ADR 0016). Integrates the closed form of a damped harmonic oscillator
+// only. Integrates the closed form of a damped harmonic oscillator
 // each frame and rests once both velocity and displacement fall below their
 // thresholds. A spring chained after a previous spring inherits its
 // position/velocity/time (getInternalState) so retargeting mid-flight stays
 // continuous. The native-config export is dropped.
-import { dlog } from '../../debug';
-import { BaseAnimation } from './base';
-import { cancelFrame, clearTimer, requestFrame, setTimer } from './raf';
-import { fromBouncinessAndSpeed, fromOrigamiTensionAndFriction } from './spring-config';
+import { dlog } from '../../debug.js';
+import { BaseAnimation } from './base.js';
+import { cancelFrame, clearTimer, requestFrame, setTimer } from './raf.js';
+import { fromBouncinessAndSpeed, fromOrigamiTensionAndFriction } from './spring-config.js';
 function resolveStiffnessDampingMass(config) {
     if (config.stiffness !== undefined || config.damping !== undefined || config.mass !== undefined) {
         return {

package/build/animated/animations/timing.js

@@ -1,11 +1,11 @@
 // TimingAnimation: ported from RN's animations/TimingAnimation.js, JS path
-// only (ADR 0016). Walks a value from `fromValue` to `toValue` over `duration`
+// only. Walks a value from `fromValue` to `toValue` over `duration`
 // ms, shaping progress through an easing function. The native-frame export and
 // __startAnimationIfNative branch are dropped.
-import { Easing } from '../easing';
-import { dlog } from '../../debug';
-import { BaseAnimation } from './base';
-import { cancelFrame, clearTimer, requestFrame, setTimer } from './raf';
+import { Easing } from '../easing.js';
+import { dlog } from '../../debug.js';
+import { BaseAnimation } from './base.js';
+import { cancelFrame, clearTimer, requestFrame, setTimer } from './raf.js';
 let cachedEaseInOut;
 function easeInOut() {
     if (cachedEaseInOut === undefined) {

package/build/animated/animations/tracking.js

@@ -4,7 +4,7 @@
 // target changes, re-launches the animation toward the target's new value, so the
 // value chases the target continuously (a spring following a gesture). Ported from
 // RN's AnimatedTracking.js, JS path; native tracking re-uses the per-launch driver.
-import { AnimatedNode } from '../graph';
+import { AnimatedNode } from '../graph.js';
 export class AnimatedTracking extends AnimatedNode {
     value;
     parent;

package/build/animated/color.js

@@ -4,8 +4,8 @@
 // AnimatedColor.js: the {r,g,b,a} and CSS-color input forms are supported; named
 // colors and platform (Native) colors are deferred (they need RN's full
 // normalizeColor / processColorObject, which live outside shared).
-import { AnimatedWithChildren, flushValue } from './graph';
-import { AnimatedValue } from './value';
+import { AnimatedWithChildren, flushValue } from './graph.js';
+import { AnimatedValue } from './value.js';
 const DEFAULT_COLOR = { r: 0, g: 0, b: 0, a: 1 };
 function isRgbaInput(value) {
     return typeof value === 'object' && value !== null && 'r' in value && 'g' in value;

package/build/animated/easing.js

@@ -1,7 +1,7 @@
 // Common easing functions, ported from React Native's Libraries/Animated/Easing.js.
 // Pure math (the only dependency is the equally-pure bezier solver), so it lives
 // unchanged in shared and every adapter re-exports it.
-import { bezier } from './bezier';
+import { bezier } from './bezier.js';
 let cachedEase;
 export const Easing = {
     // A stepping function: 1 for any positive n, else 0.

package/build/animated/event.js

@@ -13,11 +13,11 @@
 //   - Native path: __attach(viewTag, eventName) mirrors each leaf value into native
 //     and registers the key path with the stock native module, so the event drives
 //     the view with zero JS per event.
-import { dlog } from '../debug';
-import { getNativeTag, whenCommitted } from '../commit';
-import { isSymbioteNode } from '../node';
-import { AnimatedNode, flushValue } from './graph';
-import { isNativeAnimatedAvailable, nativeAnimated } from './native/native-animated';
+import { dlog } from '../debug.js';
+import { getNativeTag, whenCommitted } from '../commit.js';
+import { isSymbioteNode } from '../node.js';
+import { AnimatedNode, flushValue } from './graph.js';
+import { isNativeAnimatedAvailable, nativeAnimated } from './native/native-animated.js';
 function isRecord(value) {
     return typeof value === 'object' && value !== null;
 }

package/build/animated/graph.js

@@ -2,15 +2,14 @@
 // sits ABOVE symbiote's shadow tree. Ported from React Native's AnimatedNode.js
 // + AnimatedWithChildren.js, with every native-driver path
 // (NativeAnimatedHelper / __isNative / __makeNative / __getNativeConfig) removed:
-// this is the JS-driven engine (ADR 0016). The native driver re-introduces those
-// hooks separately (ADR 0017).
+// this is a JS-driven engine. A native driver re-introduces those hooks separately.
 //
 // Two phases drive an update:
 //   A) top-down: when a Value changes, walk children to the leaf nodes (the
 //      ones with an `update()` method) and flag them.
 //   B) bottom-up: each flagged leaf re-pulls its whole subtree via __getValue()
 //      to rebuild composite props (e.g. transform from many parents).
-import { generateNativeNodeTag, nativeAnimated, } from './native/native-animated';
+import { generateNativeNodeTag, nativeAnimated, } from './native/native-animated.js';
 let nextListenerId = 1;
 // Depth of the currently-active withSuspendedCallbacks blocks. While > 0, a
 // composite setter (AnimatedColor.setValue) is driving several channels in a row;
@@ -28,7 +27,7 @@ export class AnimatedNode {
     // _withSuspendedCallbacks, then fires once with the final value. Ported from RN's
     // AnimatedColor._suspendCallbacks.
     suspendCallbacks = 0;
-    // Native-driver state (ADR 0017). Off until a useNativeDriver animation marks
+    // Native-driver state. Off until a useNativeDriver animation marks
     // the graph native; `nativeTag` is the node's identity in the native module,
     // allocated lazily on first reference (which also creates the native node).
     isNative = false;

package/build/animated/index.js

@@ -1,28 +1,28 @@
-// @symbiote-native/engine/animated: the framework-agnostic, JS-driven Animated engine
-// (ADR 0016). The value graph, easing, interpolation and (Phase 2) drivers are
-// pure JS with no React and no native dependency; every adapter re-exports them.
-export { AnimatedNode, AnimatedWithChildren, flushValue } from './graph';
-export { AnimatedValue } from './value';
-export { AnimatedValueXY } from './value-xy';
-export { AnimatedInterpolation } from './interpolation-node';
-export { AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, add, subtract, multiply, divide, modulo, diffClamp, } from './operators';
-export { AnimatedEvent, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, } from './event';
-export { AnimatedColor } from './color';
-export { Easing } from './easing';
-export { createNumericInterpolation, createInterpolation, checkValidRanges, } from './interpolation';
-export { TimingAnimation } from './animations/timing';
-export { SpringAnimation } from './animations/spring';
-export { DecayAnimation } from './animations/decay';
-export { AnimatedTracking } from './animations/tracking';
-export { timing, spring, decay, parallel, sequence, stagger, loop, delay, } from './animations/composition';
-// The native-driver bridge (ADR 0017). Adapters need it to connect a props leaf to
+// @symbiote-native/engine/animated: the framework-agnostic, JS-driven Animated engine.
+// The value graph, easing, interpolation and drivers are pure JS with no React
+// and no native dependency; every adapter re-exports them.
+export { AnimatedNode, AnimatedWithChildren, flushValue } from './graph.js';
+export { AnimatedValue } from './value.js';
+export { AnimatedValueXY } from './value-xy.js';
+export { AnimatedInterpolation } from './interpolation-node.js';
+export { AnimatedAddition, AnimatedSubtraction, AnimatedMultiplication, AnimatedDivision, AnimatedModulo, AnimatedDiffClamp, add, subtract, multiply, divide, modulo, diffClamp, } from './operators.js';
+export { AnimatedEvent, event, forkEvent, unforkEvent, attachNativeEvent, attachNativeEventHandler, } from './event.js';
+export { AnimatedColor } from './color.js';
+export { Easing } from './easing.js';
+export { createNumericInterpolation, createInterpolation, checkValidRanges, } from './interpolation.js';
+export { TimingAnimation } from './animations/timing.js';
+export { SpringAnimation } from './animations/spring.js';
+export { DecayAnimation } from './animations/decay.js';
+export { AnimatedTracking } from './animations/tracking.js';
+export { timing, spring, decay, parallel, sequence, stagger, loop, delay, } from './animations/composition.js';
+// The native-driver bridge. Adapters need it to connect a props leaf to
 // a host view tag and to restore default values on disconnect.
-export { nativeAnimated, isNativeAnimatedAvailable, } from './native/native-animated';
+export { nativeAnimated, isNativeAnimatedAvailable, } from './native/native-animated.js';
 // The pure graph leaves and the mock, framework-agnostic (extend AnimatedWithChildren,
 // no React/Vue). They live here with the rest of the graph; every adapter's
-// createAnimatedComponent + Animated namespace re-exports them (ADR 0016/0017).
-export { AnimatedProps } from './props';
-export { AnimatedStyle, AnimatedTransform } from './style';
-export { AnimatedMock } from './mock';
+// createAnimatedComponent + Animated namespace re-exports them.
+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';
+export { reduceProps, isAnimatedNode, readPassthroughStyle, resolveHostNode, } from './animated-component-shared.js';

package/build/animated/interpolation-node.js

@@ -2,8 +2,8 @@
 // through an interpolation. Ported from RN's AnimatedInterpolation.js: numeric,
 // string-with-units, and color output ranges (the value graph; native config
 // removed). Platform (Native) colors stay out of scope, color.ts defers them.
-import { AnimatedNode, AnimatedWithChildren } from './graph';
-import { checkValidRanges, createInterpolation } from './interpolation';
+import { AnimatedNode, AnimatedWithChildren } from './graph.js';
+import { checkValidRanges, createInterpolation } from './interpolation.js';
 export class AnimatedInterpolation extends AnimatedWithChildren {
     parent;
     config;

package/build/animated/interpolation.js

@@ -4,8 +4,8 @@
 // extrapolation. A numeric output range stays number -> number; a string output
 // range (values-with-units like '0deg' or colors like '#000') is interpolated
 // per numeric token and reassembled. See createStringInterpolation below.
-import { normalizeColor } from './color';
-import { Easing } from './easing';
+import { normalizeColor } from './color.js';
+import { Easing } from './easing.js';
 function interpolateSegment(input, inputMin, inputMax, outputMin, outputMax, easing, extrapolateLeft, extrapolateRight) {
     let result = input;
     // Extrapolate below the range.

package/build/animated/mock.js

@@ -6,14 +6,14 @@
 // users get the resting state without flake. The value graph, operators, easing,
 // events and createAnimatedComponent are reused verbatim from the live engine.
 // Only the driver factories (timing/spring/decay) and compositions are mocked.
-import { AnimatedValue } from './value';
-import { AnimatedValueXY } from './value-xy';
-import { AnimatedColor } from './color';
-import { AnimatedNode } from './graph';
-import { Easing } from './easing';
-import { add, subtract, multiply, divide, modulo, diffClamp } from './operators';
-import { event, forkEvent, unforkEvent } from './event';
-import { dlog } from '../debug';
+import { AnimatedValue } from './value.js';
+import { AnimatedValueXY } from './value-xy.js';
+import { AnimatedColor } from './color.js';
+import { AnimatedNode } from './graph.js';
+import { Easing } from './easing.js';
+import { add, subtract, multiply, divide, modulo, diffClamp } from './operators.js';
+import { event, forkEvent, unforkEvent } from './event.js';
+import { dlog } from '../debug.js';
 // Prevent a callback invocation from recursively triggering another callback,
 // which may trigger another animation (RN's AnimatedMock.js:36-60).
 let inAnimationCallback = false;

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

@@ -1,4 +1,4 @@
-// The native-driver bridge (ADR 0017). When an animation runs with
+// The native-driver bridge. When an animation runs with
 // useNativeDriver:true, the whole value graph is mirrored into native "animated
 // nodes" and the curve is handed to the stock NativeAnimated TurboModule, which
 // then mutates the bound shadow node every frame with ZERO JS per frame.
@@ -6,12 +6,12 @@
 // We consume the module that ships in stock react-native, no native fork. On
 // iOS bridgeless it registers as `NativeAnimatedTurboModule`; we fall back to the
 // legacy `NativeAnimatedModule` name. Resolution goes through the same JSI seam as
-// every other native module (getNativeModule), consistent with ADR 0012. The
+// every other native module (getNativeModule). The
 // 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';
-import { getNativeModule } from '../../native-modules';
-import { NativeEventEmitter } from '../../native-events';
+import { dlog } from '../../debug.js';
+import { getNativeModule } from '../../native-modules.js';
+import { NativeEventEmitter } from '../../native-events.js';
 // iOS bridgeless registers the Turbo variant; the legacy name is the fallback.
 const TURBO_MODULE_NAME = 'NativeAnimatedTurboModule';
 const LEGACY_MODULE_NAME = 'NativeAnimatedModule';
@@ -29,7 +29,7 @@ function module() {
 }
 // True when the stock native module is present in the binary: the gate the
 // drivers consult before honouring useNativeDriver:true (else they fall back to
-// the JS-driven path of ADR 0016).
+// the JS-driven path).
 export function isNativeAnimatedAvailable() {
     return module() !== null;
 }

package/build/animated/operators.js

@@ -8,10 +8,10 @@
 // separately and wired by registering this node as a child of each input at
 // __attach (input.__addChild(this)). __getNativeConfig is creation-only: it reads
 // each input's native tag (creating the input node) but issues no connect.
-import { AnimatedNode, AnimatedWithChildren } from './graph';
-import { AnimatedValue } from './value';
-import { AnimatedInterpolation } from './interpolation-node';
-import { dlog } from '../debug';
+import { AnimatedNode, AnimatedWithChildren } from './graph.js';
+import { AnimatedValue } from './value.js';
+import { AnimatedInterpolation } from './interpolation-node.js';
+import { dlog } from '../debug.js';
 // Wrap a bare number in an AnimatedValue so every input is a graph node.
 function toNode(input) {
     return typeof input === 'number' ? new AnimatedValue(input) : input;

package/build/animated/props.js

@@ -5,18 +5,18 @@
 // flushes to this leaf via its `update()` method, which re-pulls the current values
 // into a flat partial and pushes it through shared's scoped setNativeProps: one
 // targeted clone-on-write commit. Ported from RN's AnimatedProps.js, JS-driven path
-// only: native config (__makeNative / __getNativeConfig / connectAnimatedNodeToView,
-// ADR 0017) is stripped.
+// only: native config (__makeNative / __getNativeConfig / connectAnimatedNodeToView)
+// is stripped.
 //
 // `update` MUST be a method, not a class field: flushValue detects a leaf by reading
 // a `update` function off the node, and under useDefineForClassFields a field
 // initialiser would shadow it and break subclassing. (See shared graph.ts leafUpdate.)
-import { AnimatedNode, AnimatedWithChildren } from './graph';
-import { setNativeProps, getNativeTag } from '../commit';
-import { isSymbioteNode } from '../node';
-import { registerPostCommit } from '../post-commit';
-import { nativeAnimated } from './native/native-animated';
-import { AnimatedStyle } from './style';
+import { AnimatedNode, AnimatedWithChildren } from './graph.js';
+import { setNativeProps, getNativeTag } from '../commit.js';
+import { isSymbioteNode } from '../node.js';
+import { registerPostCommit } from '../post-commit.js';
+import { nativeAnimated } from './native/native-animated.js';
+import { AnimatedStyle } from './style.js';
 function isAnimatedNode(value) {
     return value instanceof AnimatedNode;
 }
@@ -73,7 +73,7 @@ export class AnimatedProps extends AnimatedWithChildren {
     // base component's public instance via setNativeView.
     target = null;
     // The Fabric view tag this leaf is bound to natively (null until connected).
-    // Kept so __detach can disconnect exactly what it connected (ADR 0017).
+    // Kept so __detach can disconnect exactly what it connected.
     connectedViewTag = null;
     constructor(inputProps) {
         super();
@@ -139,7 +139,7 @@ export class AnimatedProps extends AnimatedWithChildren {
         this.target = null;
         super.__detach();
     }
-    // ---- native driver (ADR 0017) -------------------------------------------
+    // ---- native driver -------------------------------------------------------
     // Marking the leaf native binds it to the host view. The value->...->props edges
     // are wired by the upstream walk (AnimatedWithChildren.__makeNative); the one
     // thing only the leaf can do is attach the props node to a real view tag.