@symbiote-native/navigation 1.0.0 → 2.0.1

package/build/react/stack/index.js

@@ -1,202 +0,0 @@
-// Stack, the React lifecycle half. The route-stack transitions (navigator-state) and the
-// options/props folds (screen-options, render-stack) live in @symbiote-native/navigation core,
-// shared verbatim with the Vue/Angular adapters; here React supplies the lifecycle - useReducer
-// for the pushed-route stack, useId + a ref counter for route-key generation, useImperativeHandle
-// for the push/pop/replace navigator handle - plus the descriptor bridge for the header config
-// leaf. Pushing/popping a route is an ordinary child mount/unmount: RNSScreenStack diffs its
-// RNSScreen children natively, so no imperative native command is needed here at all. Neither
-// this nor the Screen marker imports react-native-screens' own React components (ScreenStack.tsx
-// et al - hooks, crashes a non-React adapter); the native views are driven directly through the
-// ViewConfig ../register registers. See CLAUDE.md <third_party_rn_packages_are_react_only>.
-import { createElement, forwardRef, isValidElement, useCallback, useContext, useEffect, useId, useImperativeHandle, useMemo, useReducer, useRef, } from 'react';
-import { descriptorToReact } from '@symbiote-native/react';
-import { Platform, debugNodeId, dlog } from '@symbiote-native/engine';
-import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, NAVIGATION_EVENT_STATE, RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME, RNS_SCREEN_STACK_VIEW_NAME, RNS_SCREEN_VIEW_NAME, SCREEN_ON_APPEAR, SCREEN_ON_DISAPPEAR, SCREEN_ON_DISMISSED, SCREEN_ON_HEADER_BACK_BUTTON_CLICKED, SCREEN_ON_WILL_APPEAR, SCREEN_ON_WILL_DISAPPEAR, STACK_ON_FINISH_TRANSITIONING, buildSearchBarHandle, buildSearchBarPassthrough, computeActivityState, createInitialNavigatorState, createNavigationEmitter, navigatorReducer, resolveScreenRenderPlan, resolveStackProps, } from '../../core/index.js';
-import { collectRegistry } from '../collect-registry.js';
-import { NavigationContext } from '../navigation-context.js';
-import { Screen } from '../screen.js';
-// backTitleVisible defaults to `true` on both platforms per the codegen spec's own default
-// (CT.WithDefault<boolean, 'true'>) - no ios/android divergence in v1 scope, so a single constant
-// stands in for the per-platform injection point ISliderPlatform-style adapters use elsewhere.
-const NAVIGATOR_PLATFORM = { defaultHeaderBackTitleVisible: true };
-function isScreenElement(child) {
-    return isValidElement(child) && child.type === Screen;
-}
-function resolveScreenOptions(entry, optionsArgs, screenOptions) {
-    const own = typeof entry.options === 'function' ? entry.options(optionsArgs) : entry.options;
-    return { ...screenOptions, ...own };
-}
-const StackImpl = forwardRef((props, forwardedRef) => {
-    // Read BEFORE establishing this Stack's own Context value below - becomes the `parent` link a
-    // nested screen's useNavigation().getParent() walks (e.g. this Stack rendered as a Tab screen's
-    // content reaches that Tab via this value). undefined when this Stack is the nesting root.
-    const ambientContext = useContext(NavigationContext);
-    const registry = useMemo(() => collectRegistry(props.children, isScreenElement), [props.children]);
-    const routeIdPrefix = useId();
-    const routeSequence = useRef(0);
-    // One emitter per route.key, keyed exactly like routeSequence's counter is scoped - created
-    // lazily the first time a route is rendered, pruned once it's popped off the stack (below).
-    const emitters = useRef(new Map()).current;
-    // Investigation instrumentation (flicker-on-focus bug): route keys whose resolved
-    // transition/animation-timing props have already been logged, so the once-per-mount dump below
-    // doesn't spam on every re-render. Kept behind DEBUG, never removed.
-    const loggedScreenPropKeys = useRef(new Set()).current;
-    const emitterFor = useCallback((routeKey) => {
-        let emitter = emitters.get(routeKey);
-        if (!emitter) {
-            emitter = createNavigationEmitter();
-            emitters.set(routeKey, emitter);
-        }
-        return emitter;
-    }, [emitters]);
-    const createRoute = useCallback((name, params) => {
-        routeSequence.current += 1;
-        return { key: `${routeIdPrefix}-${name}-${routeSequence.current}`, name, params };
-    }, [routeIdPrefix]);
-    const [state, dispatch] = useReducer(navigatorReducer, undefined, () => {
-        const initialRouteName = props.initialRouteName ?? registry.keys().next().value;
-        if (initialRouteName === undefined) {
-            dlog('Stack: no <Stack.Screen> children registered');
-            return createInitialNavigatorState({ key: routeIdPrefix, name: '', params: undefined });
-        }
-        return createInitialNavigatorState(createRoute(initialRouteName, registry.get(initialRouteName)?.initialParams));
-    });
-    const handle = useMemo(() => ({
-        push: (name, params) => dispatch({ type: 'push', route: createRoute(name, params) }),
-        pop: count => dispatch({ type: 'pop', count }),
-        popToTop: () => dispatch({ type: 'popToTop' }),
-        popTo: key => dispatch({ type: 'popTo', key }),
-        replace: (name, params) => dispatch({ type: 'replace', route: createRoute(name, params) }),
-        setParams: (params, key) => dispatch({ type: 'setParams', key, params }),
-        reset: nextState => dispatch({ type: 'reset', state: nextState }),
-        canGoBack: () => state.routes.length > 1,
-    }), [createRoute, state.routes.length]);
-    useImperativeHandle(forwardedRef, () => handle, [handle]);
-    // Broadcasts the router state to every still-live route's emitter (useNavigationState's
-    // source) after each commit, and prunes emitters for routes popped off the stack - mirroring
-    // React's own subscribe-in-effect pattern rather than emitting mid-render, which would call a
-    // descendant's setState while this component is still rendering.
-    useEffect(() => {
-        for (const route of state.routes) {
-            emitterFor(route.key).emit(NAVIGATION_EVENT_STATE, state);
-        }
-        for (const routeKey of emitters.keys()) {
-            if (!state.routes.some(route => route.key === routeKey))
-                emitters.delete(routeKey);
-        }
-    }, [state, emitterFor, emitters]);
-    // Investigation instrumentation (flicker-on-focus bug): STACK_ON_FINISH_TRANSITIONING is the
-    // native signal that the WHOLE push/pop animation has finished (as opposed to onAppear/
-    // onDisappear, which are per-screen) - logging it lets the per-screen appear/disappear
-    // timestamps above be checked against the actual transition-complete moment. Kept behind
-    // DEBUG, never removed.
-    const stackProps = resolveStackProps({
-        passthrough: {
-            [STACK_ON_FINISH_TRANSITIONING]: () => dlog(`Stack: onFinishTransitioning at t=${Date.now()}`),
-        },
-    });
-    const children = state.routes.map((route, index) => {
-        const entry = registry.get(route.name);
-        if (!entry) {
-            dlog(`Stack: no screen registered for route name "${route.name}"`);
-            return null;
-        }
-        const screenOptionsArgs = { route, navigation: handle };
-        const mergedOptions = resolveScreenOptions(entry, screenOptionsArgs, props.screenOptions);
-        const activityState = computeActivityState(index, state.routes.length);
-        // Investigation instrumentation (flicker-on-focus bug): fires on EVERY Stack render, not just
-        // on transitions, so the log stream shows whether a route's activityState/index ever changes
-        // outside of a push/pop dispatch (e.g. from an unrelated re-render racing the native
-        // transition). Kept behind DEBUG per <keep_logs_gate_behind_DEBUG> - never remove.
-        dlog(`Stack: render route "${route.name}" index=${index}/${state.routes.length - 1} ` +
-            `activityState=${activityState} at t=${Date.now()}`);
-        const routeEmitter = emitterFor(route.key);
-        const searchBarOptions = mergedOptions.headerSearchBarOptions;
-        const plan = resolveScreenRenderPlan({
-            screenId: route.key,
-            index,
-            routeCount: state.routes.length,
-            options: mergedOptions,
-            platform: NAVIGATOR_PLATFORM,
-            isAndroid: Platform.OS === 'android',
-            screenPassthrough: {
-                [SCREEN_ON_DISMISSED]: () => dispatch({ type: 'pop', count: 1 }),
-                [SCREEN_ON_HEADER_BACK_BUTTON_CLICKED]: () => dispatch({ type: 'pop', count: 1 }),
-                // onAppear/onDisappear are the definitive visibility boundary (post-transition-animation),
-                // so 'focus'/'blur' fire exactly once per transition; onWillAppear/onWillDisappear fire
-                // BEFORE the animation runs, so wiring them to emit() too would double-invoke
-                // useFocusEffect per transition - they only get a debug log here.
-                [SCREEN_ON_WILL_APPEAR]: () => dlog(`Stack: route "${route.name}" will appear at t=${Date.now()}`),
-                [SCREEN_ON_APPEAR]: () => {
-                    dlog(`Stack: route "${route.name}" appeared (focus) at t=${Date.now()}`);
-                    routeEmitter.emit(NAVIGATION_EVENT_FOCUS);
-                },
-                [SCREEN_ON_WILL_DISAPPEAR]: () => dlog(`Stack: route "${route.name}" will disappear at t=${Date.now()}`),
-                [SCREEN_ON_DISAPPEAR]: () => {
-                    dlog(`Stack: route "${route.name}" disappeared (blur) at t=${Date.now()}`);
-                    routeEmitter.emit(NAVIGATION_EVENT_BLUR);
-                },
-            },
-            searchBarPassthrough: searchBarOptions
-                ? {
-                    ...buildSearchBarPassthrough(searchBarOptions, message => dlog(`Stack: route "${route.name}" ${message}`)),
-                    // The imperative ref (SearchBarCommands): a callback ref attached straight to the
-                    // RNSSearchBar host element via `passthrough.ref` - createElement extracts `ref` from
-                    // a props object same as ScrollView/TextInput's own ref binding (see
-                    // descriptor-to-react's comment), so the host instance IS the ISymbioteNode. Built
-                    // fresh per mount/unmount, never captured eagerly (buildSearchBarHandle's own
-                    // lazy-getter contract is satisfied trivially here since `node` is already resolved).
-                    ref: (node) => {
-                        // Investigation instrumentation (search-bar-ref "node not committed" bug): compare
-                        // this debugNodeId against the mirror.set/dispatchViewCommand logs in commit.ts -
-                        // same id on both sides proves the ref really does hold the committed node; a
-                        // mismatch proves a stale closure instead. Kept behind DEBUG, never removed.
-                        dlog(`Stack: search bar ref callback, node=${node === null ? 'null' : debugNodeId(node)} at t=${Date.now()}`);
-                        const appRef = searchBarOptions.ref;
-                        if (!appRef)
-                            return;
-                        appRef.current = node === null ? null : buildSearchBarHandle(() => node);
-                    },
-                }
-                : undefined,
-        });
-        // Investigation instrumentation (flicker-on-focus bug): the actual timing/z-order-relevant
-        // values resolved onto the native RNSScreen, once per route.key (not every render) - rules a
-        // stackAnimation/transitionDuration mismatch against react-native-screens' own native default
-        // in or out. Kept behind DEBUG, never removed.
-        if (!loggedScreenPropKeys.has(route.key)) {
-            loggedScreenPropKeys.add(route.key);
-            dlog(`Stack: route "${route.name}" resolved screen props ` +
-                `stackAnimation=${String(plan.screenProps.stackAnimation)} ` +
-                `stackPresentation=${String(plan.screenProps.stackPresentation)} ` +
-                `transitionDuration=${String(plan.screenProps.transitionDuration)} ` +
-                `gestureEnabled=${String(plan.screenProps.gestureEnabled)} at t=${Date.now()}`);
-        }
-        // Must not be flattened away (collapsable: false) - react-native-screens' native side
-        // finds THIS specific view type by class check to register a formSheet's content for
-        // sizing (see RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME's comment in core/constants.ts). A
-        // `push` screen doesn't need it, but a `formSheet` one is otherwise left with no content
-        // ever attached natively.
-        const content = createElement(RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME, plan.contentWrapperProps, createElement(NavigationContext.Provider, { value: { route, navigation: handle, emitter: routeEmitter, parent: ambientContext } }, createElement(entry.component)));
-        // react-native-screens' own Screen.tsx swaps in a DIFFERENT Fabric component
-        // ('RNSModalScreen') for a modally-presented screen - its native updateLayoutMetrics: relies on
-        // this exact class to know it must NOT apply Yoga's computed frame (see resolveScreenViewName's
-        // comment in core/render-stack.ts). The nested Screen isHeaderInModal adds below is always
-        // plain 'RNSScreen': react-native-screens' own inner Screen never carries a presentation prop
-        // either, since it exists purely to host the header, not to be modally presented itself.
-        // A modal/formSheet screen has no UINavigationController of its own on iOS - nest an inner
-        // RNSScreenStack/RNSScreen purely to host the native header bar (see isHeaderInModal's
-        // comment in core/render-stack.ts). Skipping this leaves RNSScreenStackHeaderConfig with no
-        // navigation controller to attach to, so the header silently never renders.
-        return plan.inModal
-            ? createElement(plan.screenViewName, { key: route.key, ...plan.screenProps }, createElement(RNS_SCREEN_STACK_VIEW_NAME, { style: plan.innerStackStyle }, createElement(RNS_SCREEN_VIEW_NAME, 
-            // activityState mirrors the outer Screen's own value - react-native-screens'
-            // RNSScreen.mm treats an unset/inactive nested screen as not yet pushed, leaving it
-            // parked at its pre-push transition position (off past the bottom edge) instead of
-            // its real, presented frame.
-            { style: plan.innerScreenStyle, activityState: plan.activityState }, descriptorToReact(plan.headerConfig), content)))
-            : createElement(plan.screenViewName, { key: route.key, ...plan.screenProps }, descriptorToReact(plan.headerConfig), content);
-    });
-    return createElement(RNS_SCREEN_STACK_VIEW_NAME, stackProps, ...children);
-});
-export const Stack = Object.assign(StackImpl, { Screen });

package/build/react/tab-screen.d.ts

@@ -1,15 +0,0 @@
-import type { FC, ReactElement } from 'react';
-import type { IRoute, ITabOptions } from '../core';
-import type { ITabNavigatorHandle } from '../core';
-export type ITabScreenOptionsArgs = {
-    route: IRoute<unknown>;
-    navigation: ITabNavigatorHandle;
-};
-export type ITabScreenOptionsResolver = (args: ITabScreenOptionsArgs) => ITabOptions;
-export type ITabScreenProps = {
-    name: string;
-    component: FC;
-    options?: ITabOptions | ITabScreenOptionsResolver;
-    initialParams?: unknown;
-};
-export declare function TabScreen(_props: ITabScreenProps): ReactElement | null;

package/build/react/tab-screen.js

@@ -1,8 +0,0 @@
-// Tab.Screen: a declarative marker, never rendered on its own - Tab reads its props via
-// React.Children to build the static name -> {component, options} registry, then mounts the
-// FOCUSED route's component itself. Mirrors react/screen.ts's Screen (Stack's twin) minus the
-// stack-only concepts (no push/pop lifecycle events to wire); see CLAUDE.md
-// <third_party_rn_packages_are_react_only> - this and Tab import nothing from react-native.
-export function TabScreen(_props) {
-    return null;
-}

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

@@ -1,12 +0,0 @@
-import type { ReactNode } from 'react';
-import type { ITabNavigatorHandle, ITabOptions } from '../../core';
-import { TabScreen } from '../tab-screen';
-export type { ITabNavigatorHandle } from '../../core';
-export type ITabProps = {
-    initialRouteName?: string;
-    screenOptions?: ITabOptions;
-    children?: ReactNode;
-};
-export declare const Tab: import("react").ForwardRefExoticComponent<ITabProps & import("react").RefAttributes<ITabNavigatorHandle>> & {
-    Screen: typeof TabScreen;
-};

package/build/react/tabs/index.js

@@ -1,116 +0,0 @@
-// Tab, the React lifecycle half. The focused-index router (tab-router-state) and the tab-bar
-// Descriptor builder (render-tabs) live in @symbiote-native/navigation core, shared verbatim
-// with the Vue/Angular adapters; here React supplies the lifecycle - useReducer for the focused
-// index, useId for route-key generation, useImperativeHandle for the jumpTo/setParams handle -
-// plus the descriptor bridge for the tab-bar leaf, exactly like Stack bridges its header config
-// (react/stack.ts). Unlike Stack, a bottom-tabs bar is a PURE-JS UI: it paints ordinary
-// `symbiote-view`/`symbiote-text` primitives via the shared render fn, so there is no
-// react-native-screens ViewConfig to register here - Tab needs no `../register` import.
-import { createElement, forwardRef, isValidElement, useCallback, useContext, useEffect, useId, useImperativeHandle, useMemo, useReducer, } from 'react';
-import { descriptorToReact } from '@symbiote-native/react';
-import { dlog } from '@symbiote-native/engine';
-import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, createInitialTabState, createNavigationEmitter, isFocusedRoute, renderTabBar, tabRouterReducer, } from '../../core/index.js';
-import { collectRegistry } from '../collect-registry.js';
-import { NavigationContext } from '../navigation-context.js';
-import { TabScreen } from '../tab-screen.js';
-function isTabScreenElement(child) {
-    return isValidElement(child) && child.type === TabScreen;
-}
-function resolveTabOptions(entry, optionsArgs, screenOptions) {
-    const own = typeof entry.options === 'function' ? entry.options(optionsArgs) : entry.options;
-    return { ...screenOptions, ...own };
-}
-const TAB_CONTENT_STYLE = { flex: 1 };
-const TAB_ROOT_STYLE = { flex: 1 };
-const TabImpl = forwardRef((props, forwardedRef) => {
-    // Read BEFORE establishing this Tab's own Context value below - becomes the `parent` link a
-    // nested screen's useNavigation().getParent() walks (e.g. this Tab rendered as a Stack screen's
-    // content reaches that Stack via this value). undefined when this Tab is the nesting root.
-    const ambientContext = useContext(NavigationContext);
-    const registry = useMemo(() => collectRegistry(props.children, isTabScreenElement), [props.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(tabRouterReducer, undefined, () => createInitialTabState(routes, props.initialRouteName));
-    if (routes.length === 0)
-        dlog('Tab: no <Tab.Screen> children registered');
-    const jumpTo = useCallback((name, params) => dispatch({ type: 'jumpTo', name, params }), []);
-    const setParams = useCallback((params, key) => dispatch({ type: 'setParams', key, params }), []);
-    const handle = useMemo(() => ({ jumpTo, setParams }), [jumpTo, setParams]);
-    useImperativeHandle(forwardedRef, () => handle, [handle]);
-    const focusedRoute = state.routes[state.index];
-    const items = state.routes.map((route, index) => {
-        const entry = registry.get(route.name);
-        const focused = isFocusedRoute(index, state.index);
-        if (!entry) {
-            dlog(`Tab: no screen registered for route name "${route.name}"`);
-            return {
-                key: route.key,
-                focused,
-                label: route.name,
-                passthrough: {},
-            };
-        }
-        const options = resolveTabOptions(entry, { route, navigation: handle }, props.screenOptions);
-        return {
-            key: route.key,
-            focused,
-            label: options.tabBarLabel ?? options.title ?? route.name,
-            icon: options.tabBarIcon,
-            badge: options.tabBarBadge,
-            activeTintColor: options.tabBarActiveTintColor,
-            inactiveTintColor: options.tabBarInactiveTintColor,
-            passthrough: {
-                onPress: () => jumpTo(route.name),
-                accessibilityRole: 'tab',
-                accessibilityState: { selected: focused },
-            },
-        };
-    });
-    const focusedEntry = focusedRoute ? registry.get(focusedRoute.name) : undefined;
-    const focusedOptions = focusedEntry && focusedRoute
-        ? resolveTabOptions(focusedEntry, { route: focusedRoute, navigation: handle }, props.screenOptions)
-        : props.screenOptions;
-    const tabBar = descriptorToReact(renderTabBar({ items, style: focusedOptions?.tabBarStyle, passthrough: {} }));
-    // Only the focused route's screen is ever mounted (unlike Stack, which keeps every pushed route
-    // alive), so a fresh emitter per focus change is sufficient - no per-route emitter map to prune,
-    // because the previous screen's whole subtree (and any listeners it registered) is torn down by
-    // an ordinary React unmount when focus moves on. Keyed on the route KEY rather than the route
-    // object so a setParams-only change (new route object, same key) doesn't spuriously re-fire
-    // focus/blur.
-    const focusedRouteKey = focusedRoute?.key;
-    const routeEmitter = useMemo(() => createNavigationEmitter(), [focusedRouteKey]);
-    // Tab paints its own bar 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(`Tab: route "${focusedRoute?.name}" focused`);
-        routeEmitter.emit(NAVIGATION_EVENT_FOCUS);
-        return () => {
-            dlog(`Tab: 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;
-    return createElement('symbiote-view', { style: TAB_ROOT_STYLE }, createElement('symbiote-view', { style: TAB_CONTENT_STYLE }, content), tabBar);
-});
-export const Tab = Object.assign(TabImpl, { Screen: TabScreen });

package/build/register.d.ts

@@ -1,7 +0,0 @@
-import 'react-native-screens/src/fabric/ScreenNativeComponent';
-import 'react-native-screens/src/fabric/ModalScreenNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackHeaderConfigNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackHeaderSubviewNativeComponent';
-import 'react-native-screens/src/fabric/SearchBarNativeComponent';
-import 'react-native-screens/src/fabric/ScreenContentWrapperNativeComponent';

package/build/register.js

@@ -1,58 +0,0 @@
-// Side-effect: register RNSScreen/RNSScreenStack/RNSScreenStackHeaderConfig/
-// RNSScreenStackHeaderSubview/RNSSearchBar/RNSScreenContentWrapper's ViewConfigs in RN's
-// ReactNativeViewConfigRegistry. Evaluating each codegen native-component spec
-// (codegenNativeComponent('RNSScreen', ...) etc.) registers the getter the engine reads via
-// setNativeViewConfigSource, so events + color processors derive on first commit. We import the
-// codegen SPECS, never react-native-screens' React components (ScreenStack.tsx et al - hooks,
-// crashes a non-React adapter) - these modules have no hooks, so they are framework-agnostic and
-// shared by every adapter entry. Each adapter barrel imports this; the component modules and
-// their headless tests stay free of it. See CLAUDE.md <third_party_rn_packages_are_react_only>.
-//
-// RNSSearchBar (headerSearchBarOptions' native leaf, nested by render-stack.ts's
-// renderHeaderConfig) was missing from this list - its ViewConfig was never registered, so Fabric
-// had no component descriptor for 'RNSSearchBar' and crashed on mount the moment a screen set
-// headerSearchBarOptions. That is the root cause of the search-bar crash, not a deeper
-// Fabric-interop gap.
-//
-// RNSScreenStackHeaderSubview (the wrapper renderHeaderConfig nests the search bar leaf inside,
-// per RNSScreenStackHeaderConfig.mm's mountChildComponentView requiring every header child to be
-// one) needs the same registration, or the same class of mount crash follows.
-//
-// RNSScreenContentWrapper (the RNS_SCREEN_CONTENT_WRAPPER_VIEW_NAME wrapper stack.ts wraps every
-// screen's content in - see its comment in core/constants.ts) additionally needs a NATIVE-side
-// registration: this file alone is not enough. The native iOS registry
-// (RCTThirdPartyComponentsProvider.mm, generated by codegen from THIS package's own
-// package.json#codegenConfig.ios.componentProvider map, NOT from react-native-screens') has no
-// entry for 'RNSScreenContentWrapper' by default, so without it Fabric falls back to its
-// "Unimplemented component" placeholder view regardless of this file's import. Both registries
-// are independently required for a never-before-used react-native-screens view: this file (JS
-// ViewConfig, read by @symbiote-native/engine's registry.ts) and package.json's componentProvider
-// map (native ComponentDescriptor, read by codegen at `pod install` time).
-//
-// RNSModalScreen's gap on both registries isn't a mount crash but a silent mispositioning bug.
-// react-native-screens' own Screen.tsx picks
-// ModalScreenNativeComponent ('RNSModalScreen') instead of ScreenNativeComponent ('RNSScreen')
-// whenever stackPresentation isn't push/containedModal/containedTransparentModal, because
-// RNSScreen.mm's updateLayoutMetrics: checks `[self isKindOfClass:RNSModalScreen.class]` and, for
-// that class, DELIBERATELY skips applying Yoga's computed frame (its own comment: "the available
-// space is most likely restricted & differs from what Yoga resolves during first layout - we want
-// to rely on native layout here"). Emitting a plain 'RNSScreen' for a formSheet/modal presentation
-// (as resolveScreenViewName below used to do unconditionally) means that check never matches, so
-// Yoga's frame - computed as if the screen were still a normal flexed sibling in its outer
-// RNSScreenStack's push-oriented column layout - gets applied verbatim and never corrected,
-// visually shifting the whole modal down by one full screen's height. Fixed in
-// core/render-stack.ts's resolveScreenViewName, which now mirrors Screen.tsx's own
-// shouldUseModalScreenComponent condition exactly.
-//
-// Unlike @symbiote-native/slider (which deep-imports @react-native-community/slider's compiled
-// `dist/`), react-native-screens declares `"react-native": "src/index"` in its package.json -
-// Metro's resolverMainFields prioritizes that field, so it resolves the library straight to raw
-// TypeScript source and transforms it like first-party code. The deep import below targets that
-// same `src/fabric/` tree rather than a compiled output.
-import 'react-native-screens/src/fabric/ScreenNativeComponent';
-import 'react-native-screens/src/fabric/ModalScreenNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackHeaderConfigNativeComponent';
-import 'react-native-screens/src/fabric/ScreenStackHeaderSubviewNativeComponent';
-import 'react-native-screens/src/fabric/SearchBarNativeComponent';
-import 'react-native-screens/src/fabric/ScreenContentWrapperNativeComponent';

package/build/vue/composables/index.d.ts

@@ -1,12 +0,0 @@
-export { useNavigation } from './use-navigation';
-export type { INavigationHandle } from './use-navigation';
-export { useStackNavigation } from './use-stack-navigation';
-export type { IStackNavigationHandle } from './use-stack-navigation';
-export { useTabNavigation } from './use-tab-navigation';
-export type { ITabNavigationHandle } from './use-tab-navigation';
-export { useDrawerNavigation } from './use-drawer-navigation';
-export type { IDrawerNavigationHandle } from './use-drawer-navigation';
-export { useRoute } from './use-route';
-export { useIsFocused } from './use-is-focused';
-export { useFocusEffect } from './use-focus-effect';
-export { useNavigationState } from './use-navigation-state';

package/build/vue/composables/index.js

@@ -1,8 +0,0 @@
-export { useNavigation } from './use-navigation.js';
-export { useStackNavigation } from './use-stack-navigation.js';
-export { useTabNavigation } from './use-tab-navigation.js';
-export { useDrawerNavigation } from './use-drawer-navigation.js';
-export { useRoute } from './use-route.js';
-export { useIsFocused } from './use-is-focused.js';
-export { useFocusEffect } from './use-focus-effect.js';
-export { useNavigationState } from './use-navigation-state.js';

package/build/vue/composables/use-drawer-navigation.d.ts

@@ -1,5 +0,0 @@
-import type { ComputedRef } from '@vue/runtime-core';
-import type { IDrawerNavigatorHandle } from '../../core';
-import type { INavigationHandle } from './use-navigation';
-export type IDrawerNavigationHandle = IDrawerNavigatorHandle & Pick<INavigationHandle, 'addListener' | 'getParent'>;
-export declare function useDrawerNavigation(): ComputedRef<IDrawerNavigationHandle>;

package/build/vue/composables/use-drawer-navigation.js

@@ -1,15 +0,0 @@
-// Twin of use-stack-navigation.ts, narrowing to a Drawer handle instead.
-import { computed } from '@vue/runtime-core';
-import { isDrawerNavigatorHandle } from '../../core/index.js';
-import { useNavigation } from './use-navigation.js';
-export function useDrawerNavigation() {
-    const navigation = useNavigation();
-    return computed(() => {
-        const value = navigation.value;
-        if (!isDrawerNavigatorHandle(value)) {
-            throw new Error('useDrawerNavigation() was called from a component whose nearest navigator is not a Drawer. ' +
-                'Use useNavigation() instead if this component can render under more than one navigator kind.');
-        }
-        return value;
-    });
-}

package/build/vue/composables/use-focus-effect.d.ts

@@ -1 +0,0 @@
-export declare function useFocusEffect(effect: () => (() => void) | void): void;

package/build/vue/composables/use-focus-effect.js

@@ -1,31 +0,0 @@
-// Mirrors @react-navigation's useFocusEffect; Vue twin of react/hooks/use-focus-effect.ts.
-// React's version requires memoizing `effect` (useCallback) since a new identity re-subscribes
-// it like any other useEffect dependency. That doesn't apply here: Vue's setup() runs once, so
-// `effect` is read once at composable-call time and closed over directly by onMounted/onUnmounted -
-// there's no dependency array to go stale.
-import { onMounted, onUnmounted } from '@vue/runtime-core';
-import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS } from '../../core/index.js';
-import { requireNavigationScope } from '../navigation-context.js';
-export function useFocusEffect(effect) {
-    const scope = requireNavigationScope('useFocusEffect');
-    let cleanup;
-    let unsubscribeFocus;
-    let unsubscribeBlur;
-    const runEffect = () => {
-        cleanup = effect();
-    };
-    const runCleanup = () => {
-        cleanup?.();
-        cleanup = undefined;
-    };
-    onMounted(() => {
-        const { emitter } = scope.value;
-        unsubscribeFocus = emitter.addListener(NAVIGATION_EVENT_FOCUS, runEffect);
-        unsubscribeBlur = emitter.addListener(NAVIGATION_EVENT_BLUR, runCleanup);
-    });
-    onUnmounted(() => {
-        unsubscribeFocus?.();
-        unsubscribeBlur?.();
-        runCleanup();
-    });
-}

package/build/vue/composables/use-is-focused.d.ts

@@ -1,2 +0,0 @@
-import type { Ref } from '@vue/runtime-core';
-export declare function useIsFocused(): Ref<boolean>;

package/build/vue/composables/use-is-focused.js

@@ -1,28 +0,0 @@
-// Mirrors @react-navigation's useIsFocused; Vue twin of react/hooks/use-is-focused.ts.
-// Starts `false` rather than guessing from stack position: the route's emitter only fires 'focus'
-// once RNSScreen's native onAppear lands (stack.ts) or the screen mounts focused (tabs.ts/drawer.ts) -
-// a screen genuinely isn't focused at the instant it mounts, the same async gap real native
-// transitions have.
-import { onMounted, onUnmounted, ref } from '@vue/runtime-core';
-import { NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS } from '../../core/index.js';
-import { requireNavigationScope } from '../navigation-context.js';
-export function useIsFocused() {
-    const scope = requireNavigationScope('useIsFocused');
-    const isFocused = ref(false);
-    let unsubscribeFocus;
-    let unsubscribeBlur;
-    onMounted(() => {
-        const { emitter } = scope.value;
-        unsubscribeFocus = emitter.addListener(NAVIGATION_EVENT_FOCUS, () => {
-            isFocused.value = true;
-        });
-        unsubscribeBlur = emitter.addListener(NAVIGATION_EVENT_BLUR, () => {
-            isFocused.value = false;
-        });
-    });
-    onUnmounted(() => {
-        unsubscribeFocus?.();
-        unsubscribeBlur?.();
-    });
-    return isFocused;
-}

package/build/vue/composables/use-navigation-state.d.ts

@@ -1,3 +0,0 @@
-import type { ShallowRef } from '@vue/runtime-core';
-import type { INavigatorState } from '../../core';
-export declare function useNavigationState<TResult>(selector: (state: INavigatorState) => TResult): ShallowRef<TResult>;

package/build/vue/composables/use-navigation-state.js

@@ -1,29 +0,0 @@
-// Mirrors @react-navigation's useNavigationState; Vue twin of react/hooks/use-navigation-state.ts.
-// The reducer/dispatch machinery lives in core/navigator-state.ts (tab-router-state.ts /
-// drawer-router-state.ts for the other two navigators) - this composable only wires the
-// subscription to the `state` broadcast each render loop re-emits after commit.
-//
-// Seeded from a single-route snapshot ({ routes: [route] }) rather than left undefined: the real
-// broadcast lands after mount (Stack's render loop; tabs.ts/drawer.ts emit on focus), so a
-// selector reading e.g. `state.routes.at(-1)?.name` still resolves correctly on first paint for
-// the common single-route case - the same async gap useIsFocused documents.
-import { onMounted, onUnmounted, shallowRef } from '@vue/runtime-core';
-import { NAVIGATION_EVENT_STATE, isRecord } from '../../core/index.js';
-import { requireNavigationScope } from '../navigation-context.js';
-function isNavigatorState(value) {
-    return isRecord(value) && Array.isArray(value.routes);
-}
-export function useNavigationState(selector) {
-    const scope = requireNavigationScope('useNavigationState');
-    const result = shallowRef(selector({ routes: [scope.value.route] }));
-    let unsubscribe;
-    onMounted(() => {
-        unsubscribe = scope.value.emitter.addListener(NAVIGATION_EVENT_STATE, (state) => {
-            if (!isNavigatorState(state))
-                return;
-            result.value = selector(state);
-        });
-    });
-    onUnmounted(() => unsubscribe?.());
-    return result;
-}

package/build/vue/composables/use-navigation.d.ts

@@ -1,8 +0,0 @@
-import type { ComputedRef } from '@vue/runtime-core';
-import type { INavigationEventListener, INavigationEventName } from '../../core';
-import type { IAnyNavigatorHandle } from '../navigation-context';
-export type INavigationHandle = IAnyNavigatorHandle & {
-    addListener: (event: INavigationEventName, listener: INavigationEventListener) => () => void;
-    getParent: () => IAnyNavigatorHandle | undefined;
-};
-export declare function useNavigation(): ComputedRef<INavigationHandle>;

package/build/vue/composables/use-navigation.js

@@ -1,13 +0,0 @@
-// Mirrors @react-navigation's `navigation.addListener('focus', cb)` surface; Vue twin of
-// react/hooks/use-navigation.ts (returns a ComputedRef, Vue's reactive-primitive convention,
-// instead of a plain value). All pub/sub logic lives in ../../core/navigation-events - this
-// composable only reads the injected navigation scope and binds identity.
-import { computed } from '@vue/runtime-core';
-import { requireNavigationScope } from '../navigation-context.js';
-export function useNavigation() {
-    const scope = requireNavigationScope('useNavigation');
-    return computed(() => {
-        const { navigation, emitter, parent } = scope.value;
-        return { ...navigation, addListener: emitter.addListener, getParent: () => parent?.navigation };
-    });
-}

package/build/vue/composables/use-route.d.ts

@@ -1,3 +0,0 @@
-import type { ComputedRef } from '@vue/runtime-core';
-import type { IRoute } from '../../core';
-export declare function useRoute(): ComputedRef<IRoute<unknown>>;

package/build/vue/composables/use-route.js

@@ -1,9 +0,0 @@
-// Mirrors @react-navigation's useRoute; Vue twin of react/hooks/use-route.ts (returns a
-// ComputedRef instead of a plain value). Zero logic of its own - the route object itself is built
-// by stack.ts's/tabs.ts's/drawer.ts's render loop from the shared core reducer's state.
-import { computed } from '@vue/runtime-core';
-import { requireNavigationScope } from '../navigation-context.js';
-export function useRoute() {
-    const scope = requireNavigationScope('useRoute');
-    return computed(() => scope.value.route);
-}

package/build/vue/composables/use-stack-navigation.d.ts

@@ -1,5 +0,0 @@
-import type { ComputedRef } from '@vue/runtime-core';
-import type { INavigatorHandle } from '../../core';
-import type { INavigationHandle } from './use-navigation';
-export type IStackNavigationHandle = INavigatorHandle & Pick<INavigationHandle, 'addListener' | 'getParent'>;
-export declare function useStackNavigation(): ComputedRef<IStackNavigationHandle>;