@symbiote-native/navigation 1.0.0 → 2.0.1

package/build/core/screen-options.js

@@ -1,133 +0,0 @@
-// Pure folds from a route's agnostic IScreenOptions into the native view-props shapes
-// (RNSScreen + RNSScreenStackHeaderConfig + RNSSearchBar paint from). Framework-agnostic and
-// shared verbatim by every adapter - the adapter's own job is only wiring identity (screenId),
-// position (activityState via computeActivityState) and the lifecycle event handlers into
-// `passthrough`.
-//
-// The header bar-button payload+dispatch cluster (id-tagging, onPress lookup) lives in
-// header-bar-buttons.ts - self-contained, consumed here only as a black box by
-// resolveHeaderConfigView.
-import { buildHeaderBarButtonDispatch, prepareHeaderBarButtonItems } from './header-bar-buttons.js';
-// These sentinels must be kept in sync with react-native-screens' native side - they are RNS's
-// own compat values for the 'fitToContents'/'large'/'medium'/'all' legacy presets, replicated
-// here because we drive RNSScreen directly (no react-native-screens JS component in the path).
-const SHEET_FIT_TO_CONTENTS = [-1];
-const SHEET_COMPAT_LARGE = [1.0];
-const SHEET_COMPAT_MEDIUM = [0.5];
-const SHEET_COMPAT_ALL = [0.5, 1.0];
-const SHEET_DIMMED_ALWAYS = -1;
-function resolveSheetAllowedDetents(compat) {
-    if (compat === undefined)
-        return SHEET_COMPAT_LARGE;
-    if (Array.isArray(compat))
-        return compat;
-    switch (compat) {
-        case 'fitToContents':
-            return SHEET_FIT_TO_CONTENTS;
-        case 'large':
-            return SHEET_COMPAT_LARGE;
-        case 'medium':
-            return SHEET_COMPAT_MEDIUM;
-        case 'all':
-            return SHEET_COMPAT_ALL;
-    }
-}
-function resolveSheetLargestUndimmedDetent(compat, lastDetentIndex) {
-    if (typeof compat === 'number')
-        return compat;
-    switch (compat) {
-        case 'last':
-            return lastDetentIndex;
-        case 'large':
-            return 1;
-        case 'medium':
-            return 0;
-        case 'none':
-        case 'all':
-        case undefined:
-            return SHEET_DIMMED_ALWAYS;
-    }
-}
-function resolveSheetInitialDetent(compat, lastDetentIndex) {
-    if (compat === 'last')
-        return lastDetentIndex;
-    if (compat === undefined)
-        return 0;
-    return compat;
-}
-function toOptionalBooleanNativeProp(value) {
-    if (value === undefined)
-        return 'undefined';
-    return value ? 'true' : 'false';
-}
-export function resolveHeaderConfigView(options, platform, passthrough = {}) {
-    return {
-        title: options?.title,
-        hidden: options?.headerShown === false,
-        backTitle: options?.headerBackTitle,
-        backTitleVisible: platform.defaultHeaderBackTitleVisible,
-        backButtonDisplayMode: options?.headerBackButtonDisplayMode,
-        largeTitle: options?.headerLargeTitle,
-        translucent: options?.headerTranslucent,
-        color: options?.headerTintColor,
-        titleColor: options?.headerTitleColor,
-        backgroundColor: options?.headerStyle?.backgroundColor,
-        largeTitleBackgroundColor: options?.headerLargeStyle?.backgroundColor,
-        userInterfaceStyle: options?.headerUserInterfaceStyle,
-        headerLeftBarButtonItems: prepareHeaderBarButtonItems(options?.headerLeftBarButtonItems, 'left'),
-        headerRightBarButtonItems: prepareHeaderBarButtonItems(options?.headerRightBarButtonItems, 'right'),
-        ...buildHeaderBarButtonDispatch(options?.headerLeftBarButtonItems, options?.headerRightBarButtonItems),
-        passthrough,
-    };
-}
-export function resolveScreenView(screenId, activityState, options, passthrough = {}) {
-    const sheetAllowedDetents = resolveSheetAllowedDetents(options?.sheetAllowedDetents);
-    const lastDetentIndex = sheetAllowedDetents.length - 1;
-    return {
-        screenId,
-        activityState,
-        gestureEnabled: options?.gestureEnabled,
-        stackAnimation: options?.stackAnimation,
-        stackPresentation: options?.stackPresentation,
-        transitionDuration: options?.transitionDuration,
-        sheetAllowedDetents,
-        sheetLargestUndimmedDetent: resolveSheetLargestUndimmedDetent(options?.sheetLargestUndimmedDetentIndex, lastDetentIndex),
-        sheetInitialDetent: resolveSheetInitialDetent(options?.sheetInitialDetentIndex, lastDetentIndex),
-        sheetGrabberVisible: options?.sheetGrabberVisible,
-        sheetCornerRadius: options?.sheetCornerRadius,
-        sheetExpandsWhenScrolledToEdge: options?.sheetExpandsWhenScrolledToEdge,
-        sheetElevation: options?.sheetElevation,
-        sheetShouldOverflowTopInset: options?.sheetShouldOverflowTopInset,
-        sheetDefaultResizeAnimationEnabled: options?.sheetDefaultResizeAnimationEnabled,
-        statusBarStyle: options?.statusBarStyle,
-        statusBarHidden: options?.statusBarHidden,
-        statusBarAnimation: options?.statusBarAnimation,
-        screenOrientation: options?.screenOrientation,
-        passthrough,
-    };
-}
-// RNSSearchBar is a standalone Fabric leaf (react-native-screens mounts it as a header-subview
-// child in its own JS component) - resolveSearchBarView only folds the static config surface;
-// where/how the adapter mounts the resulting leaf in the header tree is an adapter concern.
-export function resolveSearchBarView(options, passthrough = {}) {
-    return {
-        placeholder: options?.placeholder,
-        autoCapitalize: options?.autoCapitalize,
-        placement: options?.placement,
-        hideWhenScrolling: options?.hideWhenScrolling,
-        allowToolbarIntegration: options?.allowToolbarIntegration,
-        obscureBackground: toOptionalBooleanNativeProp(options?.obscureBackground),
-        hideNavigationBar: toOptionalBooleanNativeProp(options?.hideNavigationBar),
-        cancelButtonText: options?.cancelButtonText,
-        barTintColor: options?.barTintColor,
-        tintColor: options?.tintColor,
-        textColor: options?.textColor,
-        autoFocus: options?.autoFocus,
-        disableBackButtonOverride: options?.disableBackButtonOverride,
-        inputType: options?.inputType,
-        hintTextColor: options?.hintTextColor,
-        headerIconColor: options?.headerIconColor,
-        shouldShowHintSearchIcon: options?.shouldShowHintSearchIcon,
-        passthrough,
-    };
-}

package/build/core/search-bar-commands.d.ts

@@ -1,10 +0,0 @@
-import { type ISymbioteNode } from '@symbiote-native/engine';
-export interface ISearchBarCommands {
-    focus(): void;
-    blur(): void;
-    clearText(): void;
-    setText(text: string): void;
-    cancelSearch(): void;
-    toggleCancelButton(show: boolean): void;
-}
-export declare function buildSearchBarHandle(getNode: () => ISymbioteNode | null): ISearchBarCommands;

package/build/core/search-bar-commands.js

@@ -1,42 +0,0 @@
-// The imperative API react-native-screens' own SearchBarProps exposes via its `ref` field
-// (SearchBarCommands): each method dispatches a native view command on the RNSSearchBar node
-// (SearchBarNativeComponent's supportedCommands: blur/focus/clearText/toggleCancelButton/
-// setText/cancelSearch). Framework-agnostic - mirrors @symbiote-native/components'
-// buildScrollViewHandle exactly (same lazy-getter shape); the adapter supplies the node getter
-// and its own framework-specific ref field (see react/screen.ts's IReactSearchBarOptions - the
-// ref itself is per-adapter, same split as IPressableProps).
-import { dispatchViewCommand, dlog } from '@symbiote-native/engine';
-// dispatchViewCommand itself dlogs a "node not committed" skip; this null case (the ref never
-// attached to a live RNSSearchBar at all - e.g. the header's search bar isn't mounted, or a
-// stale handle outlived its screen) was the one unlogged gap, silently indistinguishable from
-// "the command fired but did nothing". Investigation instrumentation (HeaderOptionsScreen
-// unresponsive-buttons bug); kept behind DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
-function warnIfDetached(command, node) {
-    if (node !== null)
-        return true;
-    dlog(`SearchBarCommands.${command}: skipped, node is null (ref never attached) at t=${Date.now()}`);
-    return false;
-}
-// Every command is the same 3-line dance: get the (lazily-read) node, bail with a dlog'd warning
-// if it's detached, dispatch the native view command. Factored once so the six methods below
-// differ only in which command name they dispatch.
-function makeCommand(getNode, command) {
-    return (...args) => {
-        const node = getNode();
-        if (!warnIfDetached(command, node))
-            return;
-        dispatchViewCommand(node, command, args);
-    };
-}
-// `getNode` is a LAZY getter, read on every call - see buildScrollViewHandle's comment for why
-// an eager capture would freeze `null`.
-export function buildSearchBarHandle(getNode) {
-    return {
-        focus: makeCommand(getNode, 'focus'),
-        blur: makeCommand(getNode, 'blur'),
-        clearText: makeCommand(getNode, 'clearText'),
-        setText: makeCommand(getNode, 'setText'),
-        cancelSearch: makeCommand(getNode, 'cancelSearch'),
-        toggleCancelButton: makeCommand(getNode, 'toggleCancelButton'),
-    };
-}

package/build/core/state-persistence/index.d.ts

@@ -1,3 +0,0 @@
-import type { INavigatorState } from '../navigator-state';
-export declare function serializeNavigatorState(state: INavigatorState): unknown;
-export declare function deserializeNavigatorState(raw: unknown): INavigatorState;

package/build/core/state-persistence/index.js

@@ -1,23 +0,0 @@
-// Lightweight state persistence: pure serialize/deserialize for INavigatorState, the primitive
-// @react-navigation's `initialState`/`onStateChange` persistence recipe is built on. Routes are
-// already `{key, name, params}` - plain data, no functions/refs/class instances - so a JSON-safe
-// passthrough is sufficient; no framework wiring lives here yet (that's an adapter-level task).
-import { isRecord } from '../guards.js';
-// No `'params' in value` check: a route pushed with no params serializes to `{key, name,
-// params: undefined}`, and JSON.stringify drops undefined-valued keys - a JSON round trip of a
-// perfectly valid route legitimately arrives here without a `params` key at all.
-function isRoute(value) {
-    return isRecord(value) && typeof value.key === 'string' && typeof value.name === 'string';
-}
-function isNavigatorState(value) {
-    return isRecord(value) && Array.isArray(value.routes) && value.routes.every(isRoute);
-}
-export function serializeNavigatorState(state) {
-    return state;
-}
-export function deserializeNavigatorState(raw) {
-    if (!isNavigatorState(raw)) {
-        throw new Error('deserializeNavigatorState: persisted value is not a valid navigator state');
-    }
-    return raw;
-}

package/build/core/tab-options.d.ts

@@ -1,13 +0,0 @@
-import type { IColorValue } from '@symbiote-native/engine';
-import type { IViewStyle, IStyleProp } from '@symbiote-native/engine';
-import type { IDescriptor } from '@symbiote-native/components';
-export type ITabBarIcon = IDescriptor | string;
-export type ITabOptions = {
-    title?: string;
-    tabBarLabel?: string;
-    tabBarIcon?: ITabBarIcon;
-    tabBarBadge?: string | number;
-    tabBarActiveTintColor?: IColorValue;
-    tabBarInactiveTintColor?: IColorValue;
-    tabBarStyle?: IStyleProp<IViewStyle>;
-};

package/build/core/tab-options.js

@@ -1,10 +0,0 @@
-// Per-tab agnostic options. Mirrors @react-navigation/bottom-tabs' `options` surface (title,
-// tabBarLabel, tabBarIcon, tabBarBadge, tint colors, tabBarStyle) minus anything that requires a
-// framework element: `tabBarIcon` there is a render prop returning a platform icon element, but
-// per <prop_types_split_agnostic_vs_per_adapter> a render-callback-returning-a-framework-element
-// field can't live in the shared agnostic type, so here it is EITHER a pre-built `IDescriptor`
-// (an adapter can bridge any host node it already resolved, image or vector icon) or a bare icon
-// NAME string the renderer paints as a label-style glyph - both framework-agnostic. An adapter
-// wanting a `(props) => ReactNode`-style callback resolves it to one of these two forms itself,
-// same split as IPressableProps's per-adapter children.
-export {};

package/build/core/tab-router-state/index.d.ts

@@ -1,19 +0,0 @@
-import type { IRoute } from '../navigator-state';
-export type { IRoute } from '../navigator-state';
-type IRouteEntry = IRoute<unknown>;
-export type ITabRouterState = Readonly<{
-    routes: readonly IRouteEntry[];
-    index: number;
-}>;
-export type ITabRouterAction = {
-    type: 'jumpTo';
-    name: string;
-    params?: unknown;
-} | {
-    type: 'setParams';
-    key: string;
-    params: unknown;
-};
-export declare function createInitialTabState(routes: readonly IRouteEntry[], initialRouteName?: string): ITabRouterState;
-export declare function tabRouterReducer(state: ITabRouterState, action: ITabRouterAction): ITabRouterState;
-export declare function isFocusedRoute(index: number, focusedIndex: number): boolean;

package/build/core/tab-router-state/index.js

@@ -1,51 +0,0 @@
-// TabRouter: the logic half (framework-agnostic, zero render). A pure reducer over a FOCUSED
-// INDEX into a fixed route list - jumpTo/setParams - mirroring what @react-navigation/routers'
-// TabRouter keeps, minus the React-specific action-creator/linking machinery. The key structural
-// difference from navigator-state's Stack: tabs never push/pop a route, they move a focused
-// index between a fixed set (mirrors TabRouter.getInitialState / getStateForAction for
-// JUMP_TO - see the tab-actions docs: jumpTo takes a route NAME, not a stack push). Route
-// identity (`key`) is generated by the CALLER, same convention as navigator-state.ts - reused
-// verbatim from there so Stack and Tabs share one route shape.
-import { mergeParams } from '../guards.js';
-const INITIAL_FOCUSED_INDEX = 0;
-export function createInitialTabState(routes, initialRouteName) {
-    if (initialRouteName === undefined)
-        return { routes, index: INITIAL_FOCUSED_INDEX };
-    const index = routes.findIndex(route => route.name === initialRouteName);
-    return { routes, index: index === -1 ? INITIAL_FOCUSED_INDEX : index };
-}
-// jumpTo moves the focused index to an existing route by name and optionally merges params
-// (navigation.jumpTo(name, params) - the tab-actions doc's own signature); it never adds,
-// removes, or reorders routes (mirrors TabRouter: JUMP_TO is a no-op when the target name isn't
-// registered, same as navigatorReducer's popTo bailing on an unknown key). setParams merges into
-// the target route's params by key (CommonActions.setParams semantics - a merge, not a replace).
-export function tabRouterReducer(state, action) {
-    switch (action.type) {
-        case 'jumpTo': {
-            const index = state.routes.findIndex(route => route.name === action.name);
-            if (index === -1)
-                return state;
-            if (action.params === undefined) {
-                return index === state.index ? state : { ...state, index };
-            }
-            const target = state.routes[index];
-            const routes = state.routes.slice();
-            routes[index] = { ...target, params: mergeParams(target.params, action.params) };
-            return { ...state, index, routes };
-        }
-        case 'setParams': {
-            const index = state.routes.findIndex(route => route.key === action.key);
-            if (index === -1)
-                return state;
-            const target = state.routes[index];
-            const routes = state.routes.slice();
-            routes[index] = { ...target, params: mergeParams(target.params, action.params) };
-            return { ...state, routes };
-        }
-        default:
-            return state;
-    }
-}
-export function isFocusedRoute(index, focusedIndex) {
-    return index === focusedIndex;
-}

package/build/react/collect-registry.d.ts

@@ -1,4 +0,0 @@
-import { type ReactElement, type ReactNode } from 'react';
-export declare function collectRegistry<TProps extends {
-    name: string;
-}>(children: ReactNode, isMarkerElement: (child: ReactNode) => child is ReactElement<TProps>): Map<string, Omit<TProps, 'name'>>;

package/build/react/collect-registry.js

@@ -1,15 +0,0 @@
-// Shared by stack.ts/tabs.ts/drawer.ts: each navigator registers its own Screen marker
-// component's props into a name -> entry map via React.Children, differing only in the marker
-// component (isMarkerElement) and the props shape (TProps). Stays in react/ rather than core/:
-// Children/isValidElement are React-only APIs (see CLAUDE.md <adapter_src_follows_framework_idioms>).
-import { Children } from 'react';
-export function collectRegistry(children, isMarkerElement) {
-    const registry = new Map();
-    Children.forEach(children, child => {
-        if (!isMarkerElement(child))
-            return;
-        const { name, ...entry } = child.props;
-        registry.set(name, entry);
-    });
-    return registry;
-}

package/build/react/drawer/index.d.ts

@@ -1,29 +0,0 @@
-import type { ReactNode } from 'react';
-import { type IStyleProp, type IViewStyle } from '@symbiote-native/engine';
-import type { IDrawerDescriptorMap, IDrawerNavigatorHandle, IDrawerOptions, IDrawerRouterState, IDrawerScreenOptions } from '../../core';
-import { DrawerScreen } from '../drawer-screen';
-export type { IDrawerNavigatorHandle, IDrawerDescriptorMap } from '../../core';
-export type IDrawerProps = IDrawerOptions & {
-    initialRouteName?: string;
-    screenOptions?: IDrawerScreenOptions;
-    drawerStyle?: IStyleProp<IViewStyle>;
-    renderDrawerContent?: (props: {
-        state: IDrawerRouterState;
-        descriptors: IDrawerDescriptorMap;
-        navigation: IDrawerNavigatorHandle;
-    }) => ReactNode;
-    children?: ReactNode;
-};
-export declare const Drawer: import("react").ForwardRefExoticComponent<IDrawerOptions & {
-    initialRouteName?: string;
-    screenOptions?: IDrawerScreenOptions;
-    drawerStyle?: IStyleProp<IViewStyle>;
-    renderDrawerContent?: (props: {
-        state: IDrawerRouterState;
-        descriptors: IDrawerDescriptorMap;
-        navigation: IDrawerNavigatorHandle;
-    }) => ReactNode;
-    children?: ReactNode;
-} & import("react").RefAttributes<IDrawerNavigatorHandle>> & {
-    Screen: typeof DrawerScreen;
-};

package/build/react/drawer/index.js

@@ -1,277 +0,0 @@
-// Drawer, the React lifecycle half. The open/closed + focused-route router (drawer-router-state)
-// and the pure swipe/geometry math (drawer-options) live in @symbiote-native/navigation core,
-// shared verbatim with the Vue/Angular adapters; here React supplies the lifecycle - useReducer
-// for the router, a PanResponder for the swipe gesture (RN's own idiom: build it ONCE via
-// useRef, let its callbacks read current values off refs rather than rebuilding it every render),
-// an Animated.Value driving the slide/opacity transforms, and useImperativeHandle for the
-// open/close/toggle/jumpTo handle - mirroring react/tabs.ts's shape (Tab is the closer sibling:
-// both are fixed-route-list, no-react-native-screens navigators; Stack's push/pop + native-screen
-// bridging don't apply here).
-//
-// FEASIBILITY NOTE (see the drawer skill / PR description for the full writeup): the REAL
-// @react-navigation/drawer is built on react-native-gesture-handler + react-native-reanimated,
-// neither of which this codebase depends on. What's built here reaches the same swipe-to-open/
-// close + front/back/slide/permanent behavior using only PanResponder + Animated (both already in
-// @symbiote-native/engine), which is sufficient for a solid drawer but NOT byte-for-byte parity -
-// see the explicit gap list at the bottom of this file.
-import { createElement, forwardRef, isValidElement, useCallback, useContext, useEffect, useId, useImperativeHandle, useMemo, useReducer, useRef, } from 'react';
-import { Animated, PanResponder, useWindowDimensions } from '@symbiote-native/react';
-import { dlog } from '@symbiote-native/engine';
-import { DRAWER_DEFAULT_OVERLAY_COLOR, NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, createInitialDrawerRouterState, createNavigationEmitter, drawerChildOrder, drawerRouterReducer, isDrawerAnimated, renderDrawer, resolveDragProgress, resolveDrawerGeometry, resolveDrawerSlotInterpolation, resolveSwipeIntent, shouldClaimDrawerSwipe, } from '../../core/index.js';
-import { collectRegistry } from '../collect-registry.js';
-import { NavigationContext } from '../navigation-context.js';
-import { DrawerScreen } from '../drawer-screen.js';
-function isDrawerScreenElement(child) {
-    return isValidElement(child) && child.type === DrawerScreen;
-}
-function resolveDrawerScreenOptions(entry, optionsArgs, screenOptions) {
-    const own = typeof entry.options === 'function' ? entry.options(optionsArgs) : entry.options;
-    return { ...screenOptions, ...own };
-}
-const DRAWER_SNAP_DURATION = 250;
-const DrawerImpl = forwardRef((props, forwardedRef) => {
-    // Read BEFORE establishing this Drawer's own Context value below - becomes the `parent` link a
-    // nested screen's useNavigation().getParent() walks (e.g. this Drawer rendered as a Stack
-    // screen's content reaches that Stack via this value). undefined when this Drawer is the
-    // nesting root.
-    const ambientContext = useContext(NavigationContext);
-    const { initialRouteName, screenOptions, renderDrawerContent, children, drawerStyle, drawerType, drawerPosition, drawerWidth, overlayColor, swipeEnabled, swipeEdgeWidth, swipeMinDistance, swipeMinVelocity, } = props;
-    const options = {
-        drawerType,
-        drawerPosition,
-        drawerWidth,
-        overlayColor,
-        swipeEnabled,
-        swipeEdgeWidth,
-        swipeMinDistance,
-        swipeMinVelocity,
-    };
-    const registry = useMemo(() => collectRegistry(children, isDrawerScreenElement), [children]);
-    const routeIdPrefix = useId();
-    const routes = useMemo(() => Array.from(registry.entries()).map(([name, entry]) => ({
-        key: `${routeIdPrefix}-${name}`,
-        name,
-        params: entry.initialParams,
-    })), [registry, routeIdPrefix]);
-    const [state, dispatch] = useReducer(drawerRouterReducer, undefined, () => createInitialDrawerRouterState(routes, initialRouteName));
-    if (routes.length === 0)
-        dlog('Drawer: no <Drawer.Screen> children registered');
-    const { width: screenWidth } = useWindowDimensions();
-    // progress: 0 closed -> 1 open, the single Animated.Value every slide/opacity transform below
-    // interpolates from.
-    const progress = useRef(new Animated.Value(state.isOpen ? 1 : 0)).current;
-    // Where a drag STARTS from, in progress units. Always exactly 0 or 1: a gesture only ever
-    // begins at rest, since terminate/release always snap the value back to a resting state before
-    // another grant can fire.
-    const dragStartProgress = useRef(0);
-    // Refs so the PanResponder's callbacks - built ONCE below, RN's own idiom - always read the
-    // CURRENT render's values without forcing a new PanResponder identity on every state/prop
-    // change (recreating panHandlers mid-gesture would drop the in-flight touch).
-    const optionsRef = useRef(options);
-    optionsRef.current = options;
-    const screenWidthRef = useRef(screenWidth);
-    screenWidthRef.current = screenWidth;
-    const isOpenRef = useRef(state.isOpen);
-    isOpenRef.current = state.isOpen;
-    const animateProgressTo = useCallback((open) => {
-        // Investigation instrumentation (Drawer openDrawer-no-op / toggleDrawer-no-animation bug):
-        // every imperative caller (openDrawer/closeDrawer/toggleDrawer/jumpTo) funnels through here,
-        // so this single seam proves whether Animated.timing is actually being started at all, and
-        // with what toValue - a live-only failure (e.g. a stale progress ref, or Animated.timing
-        // silently short-circuiting) would show up as this log firing with no visible motion. Kept
-        // behind DEBUG per <keep_logs_gate_behind_DEBUG>, never removed.
-        dlog(`Drawer: animateProgressTo(open=${open}) starting at t=${Date.now()}`);
-        Animated.timing(progress, {
-            toValue: open ? 1 : 0,
-            duration: DRAWER_SNAP_DURATION,
-            // Native-driver wiring (the AnimatedComponent passthrough opt-in ADR 0017 defines) is
-            // deferred for v1 - see this file's header feasibility note. The JS timing loop still
-            // drives every frame, same as any other non-native-driven Animated.timing in this codebase.
-            useNativeDriver: false,
-        }).start();
-    }, [progress]);
-    const handle = useMemo(() => ({
-        openDrawer: () => {
-            dlog(`Drawer: openDrawer() called, isOpen=${isOpenRef.current} at t=${Date.now()}`);
-            animateProgressTo(true);
-            dispatch({ type: 'openDrawer' });
-        },
-        closeDrawer: () => {
-            dlog(`Drawer: closeDrawer() called, isOpen=${isOpenRef.current} at t=${Date.now()}`);
-            animateProgressTo(false);
-            dispatch({ type: 'closeDrawer' });
-        },
-        toggleDrawer: () => {
-            dlog(`Drawer: toggleDrawer() called, isOpen=${isOpenRef.current} at t=${Date.now()}`);
-            animateProgressTo(!isOpenRef.current);
-            dispatch({ type: 'toggleDrawer' });
-        },
-        jumpTo: (name) => {
-            dispatch({ type: 'jumpTo', name });
-            if (isOpenRef.current)
-                animateProgressTo(false);
-        },
-    }), [animateProgressTo]);
-    useImperativeHandle(forwardedRef, () => handle, [handle]);
-    const panResponder = useRef(PanResponder.create({
-        onStartShouldSetPanResponder: (event, gestureState) => shouldClaimDrawerSwipe(event, gestureState, screenWidthRef.current, isOpenRef.current, optionsRef.current, 'start'),
-        onMoveShouldSetPanResponder: (event, gestureState) => shouldClaimDrawerSwipe(event, gestureState, screenWidthRef.current, isOpenRef.current, optionsRef.current, 'move'),
-        onPanResponderGrant: () => {
-            dlog('Drawer: gesture grant');
-            dragStartProgress.current = isOpenRef.current ? 1 : 0;
-        },
-        onPanResponderMove: (_event, gestureState) => {
-            const nextProgress = resolveDragProgress(gestureState, dragStartProgress.current, optionsRef.current);
-            progress.setValue(nextProgress);
-        },
-        onPanResponderRelease: (_event, gestureState) => {
-            const intent = resolveSwipeIntent(gestureState, isOpenRef.current, optionsRef.current);
-            const open = intent === 'open';
-            dlog(`Drawer: gesture release -> ${open ? 'open' : 'close'}`);
-            animateProgressTo(open);
-            dispatch(open ? { type: 'openDrawer' } : { type: 'closeDrawer' });
-        },
-        onPanResponderTerminate: () => {
-            dlog('Drawer: gesture terminated, snapping back');
-            animateProgressTo(isOpenRef.current);
-        },
-    })).current;
-    const animated = isDrawerAnimated(options);
-    const geometry = useMemo(() => resolveDrawerGeometry(options), [options.drawerType, options.drawerPosition, options.drawerWidth]);
-    const panelSlot = animated ? resolveDrawerSlotInterpolation(geometry, 'panel') : undefined;
-    const contentSlot = animated ? resolveDrawerSlotInterpolation(geometry, 'content') : undefined;
-    const overlaySlot = animated ? resolveDrawerSlotInterpolation(geometry, 'overlay') : undefined;
-    const panelTranslateX = panelSlot ? progress.interpolate(panelSlot.translateX) : undefined;
-    const contentTranslateX = contentSlot ? progress.interpolate(contentSlot.translateX) : undefined;
-    const overlayOpacity = overlaySlot ? progress.interpolate(overlaySlot.opacity) : undefined;
-    // The overlay is a full-screen absolutely-positioned sibling BELOW content in paint order
-    // (see render-drawer.ts's drawerChildOrder) - for 'front' that's fine since content never moves,
-    // but for 'slide' content itself translates away by contentTranslateX, and without following it
-    // the overlay stays pinned full-screen, dimming (and touch-capturing) the now-revealed panel
-    // underneath instead of just the content sliver it's meant to dim. Tying overlay to the SAME
-    // translateX as content keeps it registered exactly under content, wherever content actually is
-    // (resolveDrawerSlotInterpolation's 'overlay' overload returns that same content delta).
-    const overlayTranslateX = overlaySlot ? progress.interpolate(overlaySlot.translateX) : undefined;
-    const focusedRoute = state.routes[state.index];
-    const focusedEntry = focusedRoute ? registry.get(focusedRoute.name) : undefined;
-    if (focusedRoute && !focusedEntry) {
-        dlog(`Drawer: no screen registered for route name "${focusedRoute.name}"`);
-    }
-    // Only the focused route's screen is ever mounted (like Tab, unlike Stack which keeps every
-    // pushed route alive), so a fresh emitter per focus change is sufficient - see tabs.ts's
-    // matching comment for why no per-route emitter map is needed. Keyed on the route KEY, not the
-    // route object, so a jumpTo-with-no-params re-focus of the ALREADY-focused route (a no-op in
-    // drawerRouterReducer) and any future params merge don't spuriously re-fire focus/blur.
-    const focusedRouteKey = focusedRoute?.key;
-    const routeEmitter = useMemo(() => createNavigationEmitter(), [focusedRouteKey]);
-    // Drawer paints its own panel in pure JS - there is no native onAppear/onDisappear to hook
-    // (unlike Stack's RNSScreen), so focus/blur is synthesized here: mount = focus, cleanup = blur,
-    // exactly what an effect keyed on focusedRouteKey already encodes - no diffFocusedRoute
-    // indirection needed (unlike Vue/Angular, which diff real prev/next keys inside an imperative
-    // watch/CD callback that has no mount/cleanup pairing of its own).
-    useEffect(() => {
-        if (focusedRouteKey === undefined)
-            return undefined;
-        dlog(`Drawer: route "${focusedRoute?.name}" focused`);
-        routeEmitter.emit(NAVIGATION_EVENT_FOCUS);
-        return () => {
-            dlog(`Drawer: route "${focusedRoute?.name}" blurred`);
-            routeEmitter.emit(NAVIGATION_EVENT_BLUR);
-        };
-        // focusedRoute omitted deliberately: only its .key (tracked via focusedRouteKey) should
-        // re-run this effect - see the comment above on focusedRouteKey.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [routeEmitter, focusedRouteKey]);
-    const content = focusedEntry && focusedRoute
-        ? createElement(NavigationContext.Provider, {
-            value: {
-                route: focusedRoute,
-                navigation: handle,
-                emitter: routeEmitter,
-                parent: ambientContext,
-            },
-        }, createElement(focusedEntry.component))
-        : null;
-    const descriptors = {};
-    for (const route of state.routes) {
-        const entry = registry.get(route.name);
-        if (entry === undefined)
-            continue;
-        descriptors[route.key] = {
-            options: resolveDrawerScreenOptions(entry, { route, navigation: handle }, screenOptions),
-            navigation: handle,
-        };
-    }
-    const drawerContent = renderDrawerContent?.({ state, descriptors, navigation: handle }) ?? null;
-    const root = renderDrawer({
-        overlayColor: overlayColor ?? DRAWER_DEFAULT_OVERLAY_COLOR,
-        drawerStyle,
-        contentPassthrough: {},
-        overlayPassthrough: animated
-            ? {
-                pointerEvents: state.isOpen ? 'auto' : 'none',
-                onStartShouldSetResponder: () => true,
-                onResponderRelease: () => {
-                    animateProgressTo(false);
-                    dispatch({ type: 'closeDrawer' });
-                },
-            }
-            : {},
-        panelPassthrough: {},
-    }, options);
-    const order = drawerChildOrder(options);
-    const slots = new Map();
-    order.forEach((slot, index) => {
-        const descriptor = root.children[index];
-        if (typeof descriptor !== 'string')
-            slots.set(slot, descriptor);
-    });
-    const slotChildren = {
-        content,
-        overlay: null,
-        panel: drawerContent,
-    };
-    // Each animated style holds an AnimatedInterpolation node, not a plain number/color - it feeds
-    // only Animated.View's deliberately permissive `style?: unknown` (see create-animated-component.tsx),
-    // never the plain-IViewStyle branch below, so this stays untyped rather than widening IViewStyle.
-    const slotAnimatedStyle = {
-        content: contentTranslateX === undefined
-            ? undefined
-            : { transform: [{ translateX: contentTranslateX }] },
-        overlay: overlayOpacity === undefined
-            ? undefined
-            : { opacity: overlayOpacity, transform: [{ translateX: overlayTranslateX }] },
-        panel: panelTranslateX === undefined ? undefined : { transform: [{ translateX: panelTranslateX }] },
-    };
-    function renderSlot(slot) {
-        const descriptor = slots.get(slot);
-        if (descriptor === undefined)
-            return null;
-        const animatedStyle = slotAnimatedStyle[slot];
-        if (animatedStyle === undefined) {
-            return createElement(descriptor.type, { key: descriptor.key, ...descriptor.props }, slotChildren[slot]);
-        }
-        const style = [descriptor.props.style, animatedStyle];
-        return createElement(Animated.View, { key: descriptor.key, ...descriptor.props, style }, slotChildren[slot]);
-    }
-    const drawerChildren = order
-        .map(renderSlot)
-        .filter((element) => element !== null);
-    return createElement('symbiote-view', { style: root.props.style, ...panResponder.panHandlers }, ...drawerChildren);
-});
-export const Drawer = Object.assign(DrawerImpl, { Screen: DrawerScreen });
-// --- Explicit gap list vs the real react-native-gesture-handler + react-native-reanimated
-// @react-navigation/drawer (confirmed against its current docs) ---
-// 1. `configureGestureHandler` - a raw react-native-gesture-handler `Gesture` object escape
-//    hatch. No PanResponder equivalent exists; not ported.
-// 2. Simultaneous/failure gesture RELATIONSHIPS (gesture-handler's declarative composition vs a
-//    nested ScrollView, another PanResponder, etc.) - PanResponder only offers negotiation via the
-//    should-set boolean gates used here (edge-start + dominant-axis), which is more prone to an
-//    accidental hijack of a nested horizontal ScrollView/Swiper than gesture-handler's system.
-// 3. `useDrawerProgress` - a Reanimated SharedValue read on the UI thread. `progress` here is a
-//    JS-thread AnimatedValue; interpolating it for consumer-facing content animation works, but
-//    without native-driver wiring (gap noted above) it does not carry the same synchronous
-//    UI-thread guarantee under JS-thread load.
-// 4. `hideStatusBarOnOpen` / `keyboardDismissMode` / `statusBarAnimation` / `overlayStyle` - not
-//    wired in this pass; straightforward additions once StatusBar/Keyboard module wiring is
-//    needed here (not a PanResponder/Animated limitation, just unscoped for v1).