@symbiote-native/react 3.3.0 → 3.4.1

package/build/host-config.js

@@ -4,7 +4,7 @@
 // canary: a known-good driver exercising shared end to end.
 import createReconciler from 'react-reconciler';
 import { createContext } from 'react';
-import { appendChild, createElement, createRawText, insertBefore, removeChild, routeProp, setNodeComponent, setNodeHidden, setText, SymbioteSurface, } from '@symbiote-native/engine';
+import { appendChild, createElement, createRawText, hostBehaviorFor, insertBefore, removeChild, routeProp, setNodeComponent, setNodeHidden, setText, SymbioteSurface, } from '@symbiote-native/engine';
 import { DefaultEventPriority, DiscreteEventPriority, NoEventPriority, } from './reconciler-constants.js';
 import { toPublicInstance } from './host-instance.js';
 // Intrinsic JSX type -> Fabric component name. The name table + resolver live once in
@@ -95,7 +95,8 @@ const reconciler = createReconciler({
     scheduleMicrotask: queueMicrotask,
     getRootHostContext: () => ({ isInsideText: false }),
     getChildHostContext(parentHostContext, type) {
-        const isInsideText = descriptorFor(type).isText;
+        const isInsideText = descriptorFor(type).isText ||
+            hostBehaviorFor(type)?.acceptsTextChildren === true;
         return parentHostContext.isInsideText === isInsideText
             ? parentHostContext
             : { isInsideText };
@@ -196,9 +197,9 @@ const reconciler = createReconciler({
         currentUpdatePriority = priority;
     },
     getCurrentUpdatePriority: () => currentUpdatePriority,
-    resolveUpdatePriority: () => currentUpdatePriority !== NoEventPriority
-        ? currentUpdatePriority
-        : DefaultEventPriority,
+    resolveUpdatePriority: () => currentUpdatePriority === NoEventPriority
+        ? DefaultEventPriority
+        : currentUpdatePriority,
     maySuspendCommit: () => false,
     NotPendingTransition: null,
     // react's Context IS the runtime value react-reconciler's ReactContext wants

package/build/index.d.ts

@@ -20,6 +20,8 @@ export type { ISwitchProps } from './components/switch/switch-props';
 export type { ISwitchTrackColor, ISwitchChangeEvent, } from '@symbiote-native/components';
 export type { IActivityIndicatorProps } from './components/activity-indicator-props';
 export type { ISafeAreaViewProps } from './components/safe-area-view-props';
+export type { ILayoutConformanceProps } from './components/layout-conformance-props';
+export type { ILayoutConformanceMode } from '@symbiote-native/components';
 export type { IRefreshControlProps } from './components/refresh-control-props';
 export { Modal } from './components/modal';
 export type { IModalProps, IModalAnimationType, IModalPresentationStyle, IModalOrientation, } from './components/modal';
@@ -35,7 +37,9 @@ export type { ISectionListProps, ISectionListHandle, ISection, } from './compone
 export { VirtualizedSectionList } from './components/virtualized-section-list';
 export type { IVirtualizedSectionListProps, IVirtualizedSectionListHandle, } from './components/virtualized-section-list';
 export { VirtualizedList } from './components/virtualized-list';
-export type { IVirtualizedListProps, IVirtualizedListHandle, IViewToken, IViewableItemsChangedInfo, IViewabilityConfig, IViewabilityConfigCallbackPair, } from './components/virtualized-list';
+export { useVirtualizedListScope } from './components/virtualized-list/nested-scope';
+export type { IListScope } from '@symbiote-native/components';
+export type { ICellRendererComponent, ICellRendererProps, IVirtualizedListProps, IVirtualizedListHandle, IViewToken, IViewableItemsChangedInfo, IViewabilityConfig, IViewabilityConfigCallbackPair, } from './components/virtualized-list';
 export type { IViewStyle, ITextStyle, IFlexAlign, IFlexJustify, } from './utils/styles';
 export { mount, unmount } from './render';
 export { createPortal, type IPortalContainer } from './create-portal';
@@ -44,20 +48,26 @@ export { descriptorToReact } from './descriptor-to-react';
 export { descriptorToReactWithChildren } from './descriptor-to-react/with-children';
 export { findNodeHandle } from './host-instance';
 export type { IHostInstance } from './host-instance';
-export { AppRegistry, setHostRegistrar } from './modules/app-registry';
-export type { IComponentProvider, IAppParameters, IRunnable, IHostRegistrar, IWrapperComponentProvider, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './modules/app-registry';
+export { AppRegistry, HeadlessJsTaskError, setHostRegistrar, } from './modules/app-registry';
+export type { IComponentProvider, IAppConfig, IAppParameters, IRunnable, IHostRegistrar, IWrapperComponentProvider, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from './modules/app-registry';
 export { Animated, createAnimatedComponent } from './modules/animated';
 export { Platform, StyleSheet } from '@symbiote-native/engine';
 export { PlatformColor, DynamicColorIOS, processColor, } from '@symbiote-native/engine';
 export type { IColorValue, IOpaqueColorValue, IDynamicColorIOSTuple, } from '@symbiote-native/engine';
-export { setNativeViewConfigSource, setColorProcessor, setDeviceEventSource, } from '@symbiote-native/engine';
+export { setNativeViewConfigSource, setColorProcessor, } from '@symbiote-native/engine';
 export { dlog, isDebug } from '@symbiote-native/engine';
 export type { INativeViewConfig, INativeViewConfigSource, } from '@symbiote-native/engine';
 export type { IPlatformStatic, IPlatformOSType, IPlatformConstantsIOS, IPlatformConstantsAndroid, IPlatformSelectSpec, } from '@symbiote-native/engine';
-export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, LayoutAnimation, PixelRatio, } from '@symbiote-native/engine';
+export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, matchMedia, MediaQueryList, MediaQueryListEvent, setVariable, getComputedVariable, registerProperty, AppState, Keyboard, KEYBOARD_EVENT, TextInputState, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, LayoutAnimation, PixelRatio, } from '@symbiote-native/engine';
 export type { IAlertType, IAlertButtonStyle, IAlertButton, IAlertButtons, IAlertOptions, IShareContent, IShareOptions, IShareAction, IActionSheetIOSOptions, IShareActionSheetIOSOptions, IShareActionSheetError, IUrlEvent, II18nManagerConstants, IDisplayMetrics, IDisplayMetricsAndroid, IDimensionsPayload, IDimensionsSet, IDimensionsKey, IDimensionsChangeListener, IDimensionsStatic, IColorSchemeName, IColorSchemePreference, IAppStateStatus, IAppStateEvent, IKeyboardEventName, IKeyboardEvent, IKeyboardMetrics, IBackPressEventName, IBackPressHandler, IPermission, IPermissionStatus, IRationale, ILayoutAnimationType, ILayoutAnimationProperty, ILayoutAnimationConfig, ILayoutAnimationAnim, IPixelRatioStatic, } from '@symbiote-native/engine';
 export { useWindowDimensions } from './hooks/use-window-dimensions';
 export { useColorScheme } from './hooks/use-color-scheme';
+export { RootTagContext } from './root-tag-context';
+export { unstable_batchedUpdates } from './batched-updates';
+export { unstable_NativeText, unstable_NativeView } from './native-host-tags';
+export { usePressability } from './hooks/use-pressability';
+export type { IPressabilityConfig } from './hooks/use-pressability';
+export { useAnimatedColor, useAnimatedValue, useAnimatedValueXY, } from './hooks/use-animated-value';
 export { createPermissionHook } from './hooks/create-permission-hook';
 export { createResourceHook } from './hooks/create-resource-hook';
 export { useNativeViewController } from './hooks/use-native-view-controller';
@@ -74,3 +84,7 @@ export type { INativeFeedbackBackground, IThemeAttrBackground, IRippleBackground
 export type { ITouchableNativeFeedbackProps } from './components/touchable-native-feedback/touchable-native-feedback-props';
 export type { ISymbioteEvent, ISymbioteNode, IRootTag, } from '@symbiote-native/engine';
 export type { ICellLayout, ISeparatorProps, ISeparators, IModalOrientationChangeEvent, IPressableAndroidRippleConfig, IEnterKeyHint, IInputMode, ISubmitBehavior, ITextInputSelection, IImageStatics, } from '@symbiote-native/components';
+export { DeviceEventEmitter, Easing, EventEmitter, NativeAppEventEmitter, NativeEventEmitter, } from '@symbiote-native/engine';
+export type { IEasing, IEasingFunction, IEmitterSubscription, IEventEmitter, IEventEmitterModule, IEventSubscription, INativeEventListener, } from '@symbiote-native/engine';
+export { codegenNativeCommands, codegenNativeComponent, DevMenu, DevSettings, LogBox, NativeComponentRegistry, NativeModules, Networking, PushNotificationIOS, ReactNativeVersion, registerCallableModule, requireNativeComponent, Systrace, Touchable, TurboModuleRegistry, UIManager, UTFSequence, } from '@symbiote-native/engine';
+export type { IDevSettings } from '@symbiote-native/engine';

package/build/index.js

@@ -18,15 +18,13 @@ export { FlatList } from './components/flat-list/index.js';
 export { SectionList } from './components/section-list/index.js';
 export { VirtualizedSectionList } from './components/virtualized-section-list/index.js';
 export { VirtualizedList } from './components/virtualized-list/index.js';
+export { useVirtualizedListScope } from './components/virtualized-list/nested-scope.js';
 export { mount, unmount } from './render.js';
-// createPortal: react-reconciler's Fiber-level portal, working here because @symbiote-native/react is
-// mutation-mode (unlike stock RN's persistent-mode Fabric renderer, which doesn't support it —
-// see create-portal.ts). v1 scope: target must be an already-mounted node in the SAME surface.
+// `createPortal` needs mutation mode, stock RN's persistent-mode renderer has no portal
+// The target must be a mounted node of the same surface, see create-portal.ts
 export { createPortal } from './create-portal/index.js';
-// createTunnel: cross-surface content sharing. createPortal/Teleport stay same-surface-only
-// by design — a real React portal can't reach across two separate reconciler roots either
-// (see github.com/facebook/react/issues/17147), so reaching a different surface means letting
-// that surface commit its own content by reading from a shared store instead.
+// `createTunnel` shares content across surfaces, since a React portal cannot reach another root
+// (github.com/facebook/react/issues/17147) and the other surface reads a shared store instead
 export { createTunnel } from './create-tunnel/index.js';
 // descriptorToReact: the @symbiote-native/components Descriptor → React.createElement bridge. Exported so
 // an external wrapper package (e.g. @symbiote-native/slider/react over a third-party native view) can map
@@ -36,7 +34,7 @@ export { descriptorToReactWithChildren } from './descriptor-to-react/with-childr
 export { findNodeHandle } from './host-instance.js';
 // AppRegistry: RN's app entry point over `mount`. setHostRegistrar wires RN's own
 // registrar so the native Fabric host finds our runnable by app key.
-export { AppRegistry, setHostRegistrar } from './modules/app-registry/index.js';
+export { AppRegistry, HeadlessJsTaskError, setHostRegistrar, } from './modules/app-registry/index.js';
 // Animated bridge: createAnimatedComponent + Animated.View/Text/Image, driving the
 // shared JS Animated engine. Imperative timing/spring drivers merge into this
 // namespace once they land in shared.
@@ -48,21 +46,24 @@ export { Platform, StyleSheet } from '@symbiote-native/engine';
 // processColor runs a color through the injected platform processor. All pure /
 // seam-backed, so they live in shared and the adapter re-exports them.
 export { PlatformColor, DynamicColorIOS, processColor, } from '@symbiote-native/engine';
-// The three app-entry seams, wired once on a real host, so the barrel exposes them together.
-// setNativeViewConfigSource hands the engine RN's ViewConfig registry, which is how third-party
-// Fabric views auto-derive their metadata:
-//   setNativeViewConfigSource(name => ReactNativeViewConfigRegistry.get(name))
-export { setNativeViewConfigSource, setColorProcessor, setDeviceEventSource, } from '@symbiote-native/engine';
+// Seams wired once on a real host: `setNativeViewConfigSource` derives third-party view configs
+//   `setNativeViewConfigSource(name => ReactNativeViewConfigRegistry.get(name))`
+export { setNativeViewConfigSource, setColorProcessor, } from '@symbiote-native/engine';
 // Diagnostics, gated by DEBUG (<keep_logs_gate_behind_DEBUG>): app code logs through the same
 // seam the engine does instead of a bare console.log.
 export { dlog, isDebug } from '@symbiote-native/engine';
 // Imperative runtime modules: the SAME module every adapter shares, re-exported straight from
 // @symbiote-native/engine so app code names only @symbiote-native/react (RN's single import
 // root). Thin JS over getNativeModule + device events, no Fabric component of their own.
-export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, AppState, Keyboard, KEYBOARD_EVENT, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, LayoutAnimation, PixelRatio, } from '@symbiote-native/engine';
+export { Alert, Share, ActionSheetIOS, Linking, Vibration, ToastAndroid, Settings, I18nManager, Dimensions, Appearance, matchMedia, MediaQueryList, MediaQueryListEvent, setVariable, getComputedVariable, registerProperty, AppState, Keyboard, KEYBOARD_EVENT, TextInputState, BackHandler, PermissionsAndroid, PERMISSIONS, RESULTS, LayoutAnimation, PixelRatio, } from '@symbiote-native/engine';
 // React lifecycle over those core device-state modules.
 export { useWindowDimensions } from './hooks/use-window-dimensions.js';
 export { useColorScheme } from './hooks/use-color-scheme.js';
+export { RootTagContext } from './root-tag-context.js';
+export { unstable_batchedUpdates } from './batched-updates.js';
+export { unstable_NativeText, unstable_NativeView } from './native-host-tags.js';
+export { usePressability } from './hooks/use-pressability.js';
+export { useAnimatedColor, useAnimatedValue, useAnimatedValueXY, } from './hooks/use-animated-value.js';
 export { createPermissionHook } from './hooks/create-permission-hook.js';
 export { createResourceHook } from './hooks/create-resource-hook.js';
 export { useNativeViewController } from './hooks/use-native-view-controller.js';
@@ -81,3 +82,8 @@ export { InteractionManager } from '@symbiote-native/engine';
 // `<touchable-native-feedback>`, which commits no node of its own and clones onto its single child.
 // `TouchableNativeFeedback.Ripple(…)` / `.SelectableBackground(…)` are unchanged.
 export { TouchableNativeFeedback } from '@symbiote-native/components';
+// The device event bus and the easing curves, shared verbatim from the engine
+export { DeviceEventEmitter, Easing, EventEmitter, NativeAppEventEmitter, NativeEventEmitter, } from '@symbiote-native/engine';
+// RN's dev and native-module utilities, shared verbatim from the engine. The ones RN owns forward
+// to its own module, which `registerApp` hands over
+export { codegenNativeCommands, codegenNativeComponent, DevMenu, DevSettings, LogBox, NativeComponentRegistry, NativeModules, Networking, PushNotificationIOS, ReactNativeVersion, registerCallableModule, requireNativeComponent, Systrace, Touchable, TurboModuleRegistry, UIManager, UTFSequence, } from '@symbiote-native/engine';

package/build/jsx-runtime.d.ts

@@ -1,5 +1,5 @@
 import type { ICrossTypedIntrinsics } from '@symbiote-native/components';
-import type { Key } from 'react';
+import type { JSX as ReactJsx, Key } from 'react';
 import type { IViewProps, ITextProps } from './components';
 import type { IPressableProps } from './components/pressable/pressable-props';
 import type { IButtonProps } from './components/button-props';
@@ -18,12 +18,12 @@ import type { ITextInputProps } from './components/text-input/text-input-props';
 import type { IModalProps } from './components/modal';
 import type { IActivityIndicatorProps } from './components/activity-indicator-props';
 export { Fragment, jsx, jsxs } from 'react/jsx-runtime';
-interface IHostProps {
+type IHostProps = {
     style?: unknown;
     children?: import('react').ReactNode;
     [key: string]: unknown;
-}
-export interface ICrossedPrimitiveProps {
+};
+export type ICrossedPrimitiveProps = {
     view: IViewProps;
     text: ITextProps;
     pressable: IPressableProps;
@@ -43,22 +43,21 @@ export interface ICrossedPrimitiveProps {
     'text-input': ITextInputProps;
     modal: IModalProps;
     'activity-indicator': IActivityIndicatorProps;
-}
+};
 type IWithKey<Props> = Props & {
     key?: Key | null;
 };
 export declare namespace JSX {
-    type ElementType = import('react').JSX.ElementType;
-    type Element = import('react').JSX.Element;
-    type ElementClass = import('react').JSX.ElementClass;
-    type ElementAttributesProperty = import('react').JSX.ElementAttributesProperty;
-    type ElementChildrenAttribute = import('react').JSX.ElementChildrenAttribute;
-    type LibraryManagedAttributes<C, P> = import('react').JSX.LibraryManagedAttributes<C, P>;
-    type IntrinsicAttributes = import('react').JSX.IntrinsicAttributes;
-    type IntrinsicClassAttributes<T> = import('react').JSX.IntrinsicClassAttributes<T>;
-    interface IntrinsicElements extends ICrossTypedIntrinsics<IHostProps, {
+    type ElementType = ReactJsx.ElementType;
+    type Element = ReactJsx.Element;
+    type ElementClass = ReactJsx.ElementClass;
+    type ElementAttributesProperty = ReactJsx.ElementAttributesProperty;
+    type ElementChildrenAttribute = ReactJsx.ElementChildrenAttribute;
+    type LibraryManagedAttributes<C, P> = ReactJsx.LibraryManagedAttributes<C, P>;
+    type IntrinsicAttributes = ReactJsx.IntrinsicAttributes;
+    type IntrinsicClassAttributes<T> = ReactJsx.IntrinsicClassAttributes<T>;
+    type IntrinsicElements = ICrossTypedIntrinsics<IHostProps, {
         [K in keyof ICrossedPrimitiveProps]: IWithKey<ICrossedPrimitiveProps[K]>;
-    }> {
-    }
+    }>;
 }
 export type ISymbioteIntrinsicTag = keyof JSX.IntrinsicElements;

package/build/modules/animated/create-animated-component.d.ts

@@ -1,9 +1,9 @@
 import { type ComponentType, type Ref } from 'react';
-export interface IAnimatedComponentProps {
+export type IAnimatedComponentProps = {
     style?: unknown;
     ref?: Ref<unknown>;
     [key: string]: unknown;
-}
+};
 type IAnimatableProps = {
     style?: unknown;
     children?: unknown;

package/build/modules/animated/create-animated-component.js

@@ -13,7 +13,7 @@
 // and detaches on unmount / when the leaf identity changes. The per-frame path is
 // then: value.setValue / animation -> flushValue -> AnimatedProps.update() ->
 // setNativeProps(node, partial).
-import { createElement, useEffect, useRef, } from 'react';
+import { createElement, useCallback, useEffect, useRef, } from 'react';
 import { createAnimatedLeafLifecycle, isSymbioteNode, isNativeAnimatedAvailable, reduceProps, readPassthroughStyle, resolveHostNode, } from '@symbiote-native/engine';
 // A ref can be a function or a `.current` object; assign through both forms without
 // casting so a forwarded ref from the caller still receives the instance. Framework-
@@ -39,41 +39,29 @@ export function createAnimatedComponent(Component) {
         // Native driving is opt-in per the passthrough prop AND requires a real native module;
         // headless / unsupported hosts keep the JS flush path (and the existing JS smokes green).
         const wantsNative = passthrough != null && isNativeAnimatedAvailable();
-        // The leaf lifecycle - build/swap/bind/detach, native event rebinding, and the
-        // rebuild-vs-skip decision - is the engine's, shared by every adapter
-        // (core/engine/src/animated/leaf-lifecycle.ts). React owns only WHEN to run it.
-        //
-        // This used to be `useMemo(() => new AnimatedProps(rest), [rest])`, which reads like the same
-        // guard but never was one: `rest` comes out of a rest-destructure, so it is a fresh object on
-        // every render and the memo's dependency always differed. The real content check now lives in
-        // the shared lifecycle.
+        // Жизненный цикл листа общий для адаптеров (`leaf-lifecycle.ts`), React решает лишь когда
         const lifecycleRef = useRef(null);
         lifecycleRef.current ??= createAnimatedLeafLifecycle('react');
         const lifecycle = lifecycleRef.current;
         // The committed host node, captured by the ref below - a native event binds to the node's
         // tag, not the AnimatedProps leaf.
         const nodeRef = useRef(null);
-        // Reconcile after every commit. No dependency array on purpose: the props object is rebuilt
-        // by every render anyway, so a dependency list could only ever say "always" - the real
-        // rebuild-vs-skip decision is the lifecycle's, and it compares CONTENT by key identity.
+        // `rest` пересобирается каждым рендером, поэтому эффект идёт после каждого коммита,
+        // а пересобирать ли лист, решает жизненный цикл по содержимому
         useEffect(() => {
             lifecycle.reconcile(rest, isSymbioteNode(nodeRef.current) ? nodeRef.current : null, wantsNative);
-        });
+        }, [lifecycle, rest, wantsNative]);
         // Final teardown: detach the last-attached leaf and any native event bindings on unmount.
         useEffect(() => {
             return () => lifecycle.teardown();
         }, [lifecycle]);
-        // Callback ref: when the base component mounts, capture its public instance, resolve
-        // it to the underlying host node (unwrapping a scroll-container handle), record THAT
-        // for the event-attach effect and bind it to the leaf, but forward the ORIGINAL
-        // instance to the caller, who expects the component's public handle (scrollTo, …).
-        const captureRef = (instance) => {
+        // Стабильный ref, как у RN: пока `ref` приложения тот же, он не отцепляется и не цепляется
+        // заново на каждый рендер. Приложению уходит исходный instance, а узлу для привязки - host node
+        const captureRef = useCallback((instance) => {
             nodeRef.current = resolveHostNode(instance);
             assignRef(forwardedRef, instance);
-        };
-        // Reduced props are P-shaped (animated nodes already replaced by values); add the
-        // capture ref. Build via Object.assign so the merged object stays typed as P & ref
-        // without a cast. createElement then accepts it for the generic base component.
+        }, [forwardedRef]);
+        // Object.assign держит тип P & ref без приведения, `createElement` принимает его для базы
         const reduced = reduceProps(rest);
         // Override the committed style with the explicit passthrough values (last wins via the style
         // array, which the commit layer flattens) so the ShadowTree carries the current transform.

package/build/modules/animated/index.d.ts

@@ -1,29 +1,38 @@
-import { AnimatedValue, AnimatedValueXY, AnimatedColor, timing, spring, decay, parallel, sequence, stagger, loop, delay, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent } from '@symbiote-native/engine';
 import { createAnimatedComponent } from './create-animated-component';
 export { createAnimatedComponent } from './create-animated-component';
 export { AnimatedProps, AnimatedStyle, AnimatedTransform, } from '@symbiote-native/engine';
 export declare const Animated: {
-    Value: typeof AnimatedValue;
-    ValueXY: typeof AnimatedValueXY;
-    Color: typeof AnimatedColor;
+    timing: {
+        (value: import("@symbiote-native/engine").AnimatedValue, config: import("@symbiote-native/engine").ITimingConfig): import("@symbiote-native/engine").ICompositeAnimation;
+        (value: import("@symbiote-native/engine").IVectorValue, config: import("@symbiote-native/engine").IVectorTimingConfig): import("@symbiote-native/engine").ICompositeAnimation;
+    };
+    spring: {
+        (value: import("@symbiote-native/engine").AnimatedValue, config: import("@symbiote-native/engine").ISpringConfig): import("@symbiote-native/engine").ICompositeAnimation;
+        (value: import("@symbiote-native/engine").IVectorValue, config: import("@symbiote-native/engine").IVectorSpringConfig): import("@symbiote-native/engine").ICompositeAnimation;
+    };
+    decay: (_value: import("@symbiote-native/engine").AnimatedValue, _config: import("@symbiote-native/engine").IDecayConfig) => import("@symbiote-native/engine").ICompositeAnimation;
+    parallel: (animations: import("@symbiote-native/engine").ICompositeAnimation[], _config?: import("@symbiote-native/engine").IParallelConfig) => import("@symbiote-native/engine").ICompositeAnimation;
+    sequence: (animations: import("@symbiote-native/engine").ICompositeAnimation[]) => import("@symbiote-native/engine").ICompositeAnimation;
+    stagger: (_time: number, animations: import("@symbiote-native/engine").ICompositeAnimation[]) => import("@symbiote-native/engine").ICompositeAnimation;
+    loop: (_animation: import("@symbiote-native/engine").ICompositeAnimation) => import("@symbiote-native/engine").ICompositeAnimation;
+    delay: (_time: number) => import("@symbiote-native/engine").ICompositeAnimation;
+    Value: typeof import("@symbiote-native/engine").AnimatedValue;
+    ValueXY: typeof import("@symbiote-native/engine").AnimatedValueXY;
+    Color: typeof import("@symbiote-native/engine").AnimatedColor;
+    Interpolation: typeof import("@symbiote-native/engine").AnimatedInterpolation;
+    Node: typeof import("@symbiote-native/engine").AnimatedNode;
     Easing: import("@symbiote-native/engine").IEasing;
-    timing: typeof timing;
-    spring: typeof spring;
-    decay: typeof decay;
-    parallel: typeof parallel;
-    sequence: typeof sequence;
-    stagger: typeof stagger;
-    loop: typeof loop;
-    delay: typeof delay;
-    add: typeof add;
-    subtract: typeof subtract;
-    multiply: typeof multiply;
-    divide: typeof divide;
-    modulo: typeof modulo;
-    diffClamp: typeof diffClamp;
-    event: typeof event;
-    forkEvent: typeof forkEvent;
-    unforkEvent: typeof unforkEvent;
+    add: typeof import("@symbiote-native/engine").add;
+    subtract: typeof import("@symbiote-native/engine").subtract;
+    multiply: typeof import("@symbiote-native/engine").multiply;
+    divide: typeof import("@symbiote-native/engine").divide;
+    modulo: typeof import("@symbiote-native/engine").modulo;
+    diffClamp: typeof import("@symbiote-native/engine").diffClamp;
+    event: typeof import("@symbiote-native/engine").event;
+    attachNativeEvent: typeof import("@symbiote-native/engine").attachNativeEvent;
+    forkEvent: typeof import("@symbiote-native/engine").forkEvent;
+    unforkEvent: typeof import("@symbiote-native/engine").unforkEvent;
+    Event: typeof import("@symbiote-native/engine").AnimatedEvent;
     View: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;
     Text: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;
     Image: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;
@@ -31,27 +40,31 @@ export declare const Animated: {
     SectionList: ReturnType<typeof createAnimatedComponent>;
     createAnimatedComponent: typeof createAnimatedComponent;
 } | {
-    Value: typeof AnimatedValue;
-    ValueXY: typeof AnimatedValueXY;
-    Color: typeof AnimatedColor;
+    Value: typeof import("@symbiote-native/engine").AnimatedValue;
+    ValueXY: typeof import("@symbiote-native/engine").AnimatedValueXY;
+    Color: typeof import("@symbiote-native/engine").AnimatedColor;
+    Interpolation: typeof import("@symbiote-native/engine").AnimatedInterpolation;
+    Node: typeof import("@symbiote-native/engine").AnimatedNode;
     Easing: import("@symbiote-native/engine").IEasing;
-    timing: (value: AnimatedValue, config: import("@symbiote-native/engine").ITimingConfig) => import("@symbiote-native/engine").ICompositeAnimation;
-    spring: (value: AnimatedValue, config: import("@symbiote-native/engine").ISpringConfig) => import("@symbiote-native/engine").ICompositeAnimation;
-    decay: (_value: AnimatedValue, _config: import("@symbiote-native/engine").IDecayConfig) => import("@symbiote-native/engine").ICompositeAnimation;
-    parallel: (animations: import("@symbiote-native/engine").ICompositeAnimation[], _config?: import("@symbiote-native/engine").IParallelConfig) => import("@symbiote-native/engine").ICompositeAnimation;
-    sequence: (animations: import("@symbiote-native/engine").ICompositeAnimation[]) => import("@symbiote-native/engine").ICompositeAnimation;
-    stagger: (_time: number, animations: import("@symbiote-native/engine").ICompositeAnimation[]) => import("@symbiote-native/engine").ICompositeAnimation;
-    loop: (_animation: import("@symbiote-native/engine").ICompositeAnimation) => import("@symbiote-native/engine").ICompositeAnimation;
-    delay: (_time: number) => import("@symbiote-native/engine").ICompositeAnimation;
-    add: typeof add;
-    subtract: typeof subtract;
-    multiply: typeof multiply;
-    divide: typeof divide;
-    modulo: typeof modulo;
-    diffClamp: typeof diffClamp;
-    event: typeof event;
-    forkEvent: typeof forkEvent;
-    unforkEvent: typeof unforkEvent;
+    timing: typeof import("@symbiote-native/engine").timing;
+    spring: typeof import("@symbiote-native/engine").spring;
+    decay: typeof import("@symbiote-native/engine").decay;
+    parallel: typeof import("@symbiote-native/engine").parallel;
+    sequence: typeof import("@symbiote-native/engine").sequence;
+    stagger: typeof import("@symbiote-native/engine").stagger;
+    loop: typeof import("@symbiote-native/engine").loop;
+    delay: typeof import("@symbiote-native/engine").delay;
+    add: typeof import("@symbiote-native/engine").add;
+    subtract: typeof import("@symbiote-native/engine").subtract;
+    multiply: typeof import("@symbiote-native/engine").multiply;
+    divide: typeof import("@symbiote-native/engine").divide;
+    modulo: typeof import("@symbiote-native/engine").modulo;
+    diffClamp: typeof import("@symbiote-native/engine").diffClamp;
+    event: typeof import("@symbiote-native/engine").event;
+    attachNativeEvent: typeof import("@symbiote-native/engine").attachNativeEvent;
+    forkEvent: typeof import("@symbiote-native/engine").forkEvent;
+    unforkEvent: typeof import("@symbiote-native/engine").unforkEvent;
+    Event: typeof import("@symbiote-native/engine").AnimatedEvent;
     View: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;
     Text: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;
     Image: import("react").ComponentType<import("./create-animated-component").IAnimatedComponentProps>;

package/build/modules/animated/index.js

@@ -3,11 +3,10 @@
 // easing and imperative drivers come from @symbiote-native/engine (framework-agnostic,
 // JS-driven). Both halves meet here in one `Animated` object so the
 // familiar surface (`Animated.timing(new Animated.Value(0), …).start()`) works.
-import { AnimatedValue, AnimatedValueXY, AnimatedColor, Easing, Platform, timing, spring, decay, parallel, sequence, stagger, loop, delay, add, subtract, multiply, divide, modulo, diffClamp, event, forkEvent, unforkEvent, } from '@symbiote-native/engine';
+import { AnimatedDrivers, AnimatedMock, Platform, } from '@symbiote-native/engine';
 import { FlatList } from '../../components/flat-list/index.js';
 import { SectionList } from '../../components/section-list/index.js';
 import { createAnimatedComponent } from './create-animated-component.js';
-import { AnimatedMock } from '@symbiote-native/engine';
 export { createAnimatedComponent } from './create-animated-component.js';
 // The pure graph leaves now live in @symbiote-native/engine (they extend AnimatedWithChildren,
 // no React); re-exported here so @symbiote-native/react's Animated surface is unchanged.
@@ -30,37 +29,13 @@ const AnimatedImage = createAnimatedComponent('image');
 // own `get FlatList() { return require(...) }`.
 let animatedFlatList;
 let animatedSectionList;
-// The live, JS-driven driver namespace (real frames). RN's AnimatedImplementation.
-const liveDrivers = {
-    Value: AnimatedValue,
-    ValueXY: AnimatedValueXY,
-    Color: AnimatedColor,
-    Easing,
-    timing,
-    spring,
-    decay,
-    parallel,
-    sequence,
-    stagger,
-    loop,
-    delay,
-    add,
-    subtract,
-    multiply,
-    divide,
-    modulo,
-    diffClamp,
-    event,
-    forkEvent,
-    unforkEvent,
-};
 // RN's AnimatedExports.js:21 swaps the WHOLE namespace for the mock when the host
 // reports isDisableAnimations (reduced motion / test env): the mock keeps the same
 // surface but jumps each animation to its final value synchronously, no frames.
 // The animated COMPONENTS (View/Text/Image + the lazy container getters) are live in
 // both branches; only the drivers/value/operators/events half is swapped, exactly
 // like RN spreading `...Animated` (impl or mock) over the same component getters.
-const drivers = Platform.isDisableAnimations ? AnimatedMock : liveDrivers;
+const drivers = Platform.isDisableAnimations ? AnimatedMock : AnimatedDrivers;
 export const Animated = {
     View: AnimatedView,
     Text: AnimatedText,

package/build/modules/app-registry/index.d.ts

@@ -1,7 +1,7 @@
 import { type ComponentType } from 'react';
-import { type IAppParameters } from '@symbiote-native/engine';
+import { HeadlessJsTaskError, type IAppParameters } from '@symbiote-native/engine';
 export type IComponentProvider = () => ComponentType<object>;
 export type IWrapperComponentProvider = (appParameters: IAppParameters) => ComponentType<object>;
 declare const AppRegistry: import("@symbiote-native/engine").IAppRegistry<IComponentProvider, IWrapperComponentProvider>, setHostRegistrar: (registrar: import("@symbiote-native/engine").IHostRegistrar) => void;
-export { AppRegistry, setHostRegistrar };
-export type { IAppParameters, IRunnable, IHostRegistrar, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from '@symbiote-native/engine';
+export { AppRegistry, HeadlessJsTaskError, setHostRegistrar };
+export type { IAppConfig, IAppParameters, IRunnable, IHostRegistrar, IRegistry, IHeadlessTask, ITaskProvider, ITaskCanceller, ITaskCancelProvider, } from '@symbiote-native/engine';

package/build/modules/app-registry/index.js

@@ -5,7 +5,7 @@
 // only the one React-specific seam — building a runnable from a component provider via
 // createElement + mount — so existing RN app-entry code ports verbatim.
 import { createElement } from 'react';
-import { createAppRegistry, dlog, } from '@symbiote-native/engine';
+import { createAppRegistry, dlog, HeadlessJsTaskError, } from '@symbiote-native/engine';
 import { mount } from '../../render.js';
 function runnableFor(componentProvider, getWrapperComponentProvider) {
     return appParameters => {
@@ -23,4 +23,4 @@ function runnableFor(componentProvider, getWrapperComponentProvider) {
     };
 }
 const { AppRegistry, setHostRegistrar } = createAppRegistry(runnableFor);
-export { AppRegistry, setHostRegistrar };
+export { AppRegistry, HeadlessJsTaskError, setHostRegistrar };

package/build/modules/status-bar/index.android.d.ts

@@ -1,3 +1,3 @@
-import type { IStatusBarComponent } from './shared';
+import { type IStatusBarComponent } from './shared';
 export type { IStatusBarProps, IStatusBarStyle } from './shared';
 export declare const StatusBar: IStatusBarComponent;

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

@@ -1,31 +1,11 @@
-// StatusBar on Android: the declarative React half only. The native StatusBarManager driving
-// (applyStatusBarProps), the imperative statics (statusBarImperative), and the Android
-// currentHeight getter (statusBarCurrentHeight) all live in @symbiote-native/engine, shared
-// verbatim with every adapter (Vue's status-bar.ts, Angular's status-bar.ts drive the exact
-// same functions). This file supplies only what's React-specific: an FC that renders null and
-// re-applies props via useEffect on mount + every prop change, with the imperative statics
-// attached to the function object, exactly like RN's own StatusBar.
+// StatusBar on Android: the shared declarative component with the engine's imperative statics
+// attached to the function object, plus the `currentHeight` getter
 //
-// Metro picks this file on an Android host, resolving '@symbiote-native/engine's relative
-// './status-bar' import to its own index.android.ts in turn (Android's native module is a
-// DIFFERENT shape from iOS — single-arg setHidden(hidden)/setStyle(style) plus
-// setColor/setTranslucent — all handled inside that engine module, not here).
-import { useEffect } from 'react';
-import { applyStatusBarProps, statusBarImperative, statusBarCurrentHeight, } from '@symbiote-native/engine';
-// Renders null and applies its props to the native module in an effect, on mount and on
-// every prop change, same contract as iOS.
-const StatusBarAndroidComponent = props => {
-    const { barStyle, hidden, animated, backgroundColor, translucent } = props;
-    useEffect(() => {
-        applyStatusBarProps(props);
-        // eslint-disable-next-line react-hooks/exhaustive-deps -- deps are the primitive fields, not `props` itself, so an unchanged prop shape doesn't re-fire.
-    }, [barStyle, hidden, animated, backgroundColor, translucent]);
-    return null;
-};
-const StatusBarAndroid = Object.assign(StatusBarAndroidComponent, statusBarImperative);
-// Android exposes the bar height as a native constant; undefined if the module or the
-// constant is absent. Read lazily (getter, not a value) so nothing touches native at import
-// time — the engine's Android impl resolves it on access.
+// Metro picks this file on an Android host
+import { statusBarImperative, statusBarCurrentHeight, } from '@symbiote-native/engine';
+import { StatusBarComponent } from './shared.js';
+const StatusBarAndroid = Object.assign(StatusBarComponent, statusBarImperative);
+// A getter, not a value, so nothing touches native at import time
 Object.defineProperty(StatusBarAndroid, 'currentHeight', {
     get: statusBarCurrentHeight,
     enumerable: true,

package/build/modules/status-bar/index.ios.d.ts

@@ -1,3 +1,3 @@
-import type { IStatusBarComponent } from './shared';
+import { type IStatusBarComponent } from './shared';
 export type { IStatusBarProps, IStatusBarStyle } from './shared';
 export declare const StatusBar: IStatusBarComponent;

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

@@ -1,29 +1,5 @@
-// StatusBar on iOS: the declarative React half only. The native `StatusBarManager`
-// TurboModule driving (applyStatusBarProps), the imperative statics (statusBarImperative),
-// and the iOS currentHeight stub all live in @symbiote-native/engine, shared verbatim with
-// every adapter (Vue's status-bar.ts, Angular's status-bar.ts drive the exact same functions).
-// This file supplies only what's React-specific: an FC that renders null and re-applies props
-// via useEffect on mount + every prop change, with the imperative statics attached to the
-// function object, exactly like RN's own StatusBar.
-//
-// Metro picks this file on an iOS host; the headless/tsx base (status-bar/index.ts) re-exports
-// it, which is also what a bare '@symbiote-native/engine' import resolves to under vitest — so
-// this file's own engine import is already vitest-correct, no platform-selection subtlety here.
-import { useEffect } from 'react';
-import { applyStatusBarProps, statusBarImperative, } from '@symbiote-native/engine';
-// StatusBar renders null and applies its props to the native module in an effect,
-// on mount and on every prop change. Simplification vs RN: RN maintains a
-// prop-merge stack so nested StatusBars compose (deepest/last wins). This module
-// direct-applies a single component's props, which is correct for one StatusBar.
-const StatusBarComponent = props => {
-    const { barStyle, hidden, animated, networkActivityIndicatorVisible } = props;
-    useEffect(() => {
-        applyStatusBarProps(props);
-        // eslint-disable-next-line react-hooks/exhaustive-deps -- deps are the primitive fields, not `props` itself, so an unchanged prop shape doesn't re-fire.
-    }, [barStyle, hidden, animated, networkActivityIndicatorVisible]);
-    return null;
-};
-// The imperative statics mirror the declarative component: non-throwing, a missing optional
-// native module is a no-op. currentHeight is Android-only; absent on iOS (RN sets it to null
-// on iOS), so it's intentionally not attached here.
+// StatusBar on iOS: the shared component with the engine's statics attached, like RN
+// `currentHeight` is Android-only, so it is absent here
+import { statusBarImperative } from '@symbiote-native/engine';
+import { StatusBarComponent } from './shared.js';
 export const StatusBar = Object.assign(StatusBarComponent, statusBarImperative);

package/build/modules/status-bar/shared.d.ts

@@ -1,6 +1,7 @@
-import type { FC } from 'react';
-import type { IStatusBarImperative, IStatusBarProps } from '@symbiote-native/engine';
+import { type FC } from 'react';
+import { type IStatusBarImperative, type IStatusBarProps } from '@symbiote-native/engine';
 export type { IStatusBarProps, IStatusBarStyle, IStatusBarAnimation, } from '@symbiote-native/engine';
-export interface IStatusBarComponent extends FC<IStatusBarProps>, IStatusBarImperative {
+export type IStatusBarComponent = FC<IStatusBarProps> & IStatusBarImperative & {
     currentHeight?: number;
-}
+};
+export declare const StatusBarComponent: FC<IStatusBarProps>;