@symbiote-native/react 3.2.0 → 3.4.0

package/build/hooks/use-pressability.js

@@ -0,0 +1,39 @@
+// RN's `usePressability`, over RN's own `Pressability` class, which `bootstrapHost` hands to the
+// engine. RN's class expects its synthetic events, so each handler gets the event with `persist()`
+import { useInsertionEffect, useRef } from 'react';
+import { loadPressability, } from '@symbiote-native/engine';
+// An event of ours answers everything RN's class reads, `persist` apart: nothing is pooled here
+function withPersist(event) {
+    return Object.assign(Object.create(event), { persist: () => { } });
+}
+function persistingHandlers(handlers) {
+    return Object.fromEntries(Object.entries(handlers).map(([name, handler]) => [
+        name,
+        (event) => handler(withPersist(event)),
+    ]));
+}
+export function usePressability(config) {
+    const ref = useRef(null);
+    if (config != null && ref.current === null) {
+        const Pressability = loadPressability();
+        const pressability = new Pressability(config);
+        ref.current = {
+            pressability,
+            handlers: persistingHandlers(pressability.getEventHandlers()),
+        };
+    }
+    const instance = ref.current;
+    // A no-op on the first mount, on an update it points `Pressability` at the new config
+    useInsertionEffect(() => {
+        if (config != null && instance !== null) {
+            instance.pressability.configure(config);
+        }
+    }, [config, instance]);
+    // On unmount only, not when `config` changes: pending timers and state go
+    useInsertionEffect(() => {
+        if (instance === null)
+            return undefined;
+        return () => instance.pressability.reset();
+    }, [instance]);
+    return instance === null ? null : instance.handlers;
+}

package/build/hooks/use-window-dimensions.js

@@ -1,26 +1,22 @@
-// useWindowDimensions is the preferred API for components that need window metrics,
-// a port of RN's Libraries/Utilities/useWindowDimensions.js. It seeds from
-// Dimensions.get('window'), subscribes to 'change', and re-checks once after
-// subscribing to close the gap between the render-time get and the effect-time
-// listener. Only the window metrics changing triggers a re-render.
+// Port of RN's `useWindowDimensions`: seeds from `Dimensions.get('window')`, subscribes to 'change'
+// TODO(rn-port): RN's module loads `NativeDeviceInfo` eagerly, which needs a bridge itests lack
 import { useEffect, useState } from 'react';
 import { Dimensions, } from '@symbiote-native/engine';
 export function useWindowDimensions() {
     const [dimensions, setDimensions] = useState(() => Dimensions.get('window'));
     useEffect(() => {
         function handleChange(window) {
-            if (dimensions.width !== window.width ||
+            const hasChanged = dimensions.width !== window.width ||
                 dimensions.height !== window.height ||
                 dimensions.scale !== window.scale ||
-                dimensions.fontScale !== window.fontScale) {
+                dimensions.fontScale !== window.fontScale;
+            if (hasChanged)
                 setDimensions(window);
-            }
         }
         const subscription = Dimensions.addEventListener('change', (set) => {
             handleChange(set.window);
         });
-        // We may have missed an update between calling `get` in render and subscribing
-        // here; re-check now. If nothing changed, React filters the no-op set.
+        // An update may land between `get` in render and the subscription, so re-check now
         handleChange(Dimensions.get('window'));
         return () => {
             subscription.remove();

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';
@@ -27,6 +29,7 @@ export type { IPressableProps, IPressState, } from './components/pressable/press
 export type { ITouchableOpacityProps, ITouchableHighlightProps, } from './components/touchable/touchable-props';
 export type { ITouchableWithoutFeedbackProps } from './components/touchable-without-feedback/touchable-without-feedback-props';
 export type { IButtonProps } from './components/button-props';
+export type { ICheckboxProps } from './components/checkbox-props';
 export { FlatList } from './components/flat-list';
 export type { IFlatListProps, IFlatListHandle } from './components/flat-list';
 export { SectionList } from './components/section-list';
@@ -34,31 +37,42 @@ 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';
 export { createTunnel, type ITunnel } from './create-tunnel';
 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, 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';
 export { createEventValueHook } from './hooks/create-event-value-hook';
+export { useEvent, useEventListener } from './hooks/use-event';
 export { AccessibilityInfo } from './modules/accessibility-info';
 export type { IAccessibilityChangeEvent, IAccessibilityChangeEventName, IAccessibilityChangeEventHandler, IAccessibilityAnnouncementFinishedEvent, IAnnounceForAccessibilityOptions, IAccessibilityEventType, } from './modules/accessibility-info';
 export { PanResponder } from '@symbiote-native/engine';
@@ -70,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,24 +18,23 @@ 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
 // a shared render fn's Descriptor onto React elements through the SAME bridge the adapter uses.
 export { descriptorToReact } from './descriptor-to-react/index.js';
+export { descriptorToReactWithChildren } from './descriptor-to-react/with-children.js';
 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.
@@ -47,24 +46,29 @@ 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, 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';
 export { createEventValueHook } from './hooks/create-event-value-hook.js';
+export { useEvent, useEventListener } from './hooks/use-event.js';
 export { AccessibilityInfo } from './modules/accessibility-info';
 // Interaction subsystems: gestures, deferred work, and layout transitions.
 export { PanResponder } from '@symbiote-native/engine';
@@ -78,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,8 +1,9 @@
 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';
+import type { ICheckboxProps } from './components/checkbox-props';
 import type { IImageProps } from './components/image/image-props';
 import type { IImageBackgroundProps } from './components/image-background-props';
 import type { IInputAccessoryViewProps } from './components/input-accessory-view-props';
@@ -17,16 +18,17 @@ 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;
     button: IButtonProps;
+    checkbox: ICheckboxProps;
     image: IImageProps;
     'image-background': IImageBackgroundProps;
     'input-accessory-view': IInputAccessoryViewProps;
@@ -41,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;