@symbiote-native/navigation 1.0.0 → 2.0.1

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

@@ -1,18 +0,0 @@
-// useNavigation() returns a union (IAnyNavigatorHandle) since it doesn't know which navigator
-// mounted the calling component. When a component genuinely knows it only ever renders under a
-// Stack, this composable narrows that union ONCE, here, so call sites never write their own
-// 'push' in navigation check. Vue twin of react/hooks/use-stack-navigation.ts.
-import { computed } from '@vue/runtime-core';
-import { isStackNavigatorHandle } from '../../core/index.js';
-import { useNavigation } from './use-navigation.js';
-export function useStackNavigation() {
-    const navigation = useNavigation();
-    return computed(() => {
-        const value = navigation.value;
-        if (!isStackNavigatorHandle(value)) {
-            throw new Error('useStackNavigation() was called from a component whose nearest navigator is not a Stack. ' +
-                'Use useNavigation() instead if this component can render under more than one navigator kind.');
-        }
-        return value;
-    });
-}

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

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

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

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

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

@@ -1,19 +0,0 @@
-import type { IStyleProp, IViewStyle } from '@symbiote-native/engine';
-import type { IDrawerDescriptorMap, IDrawerNavigatorHandle, IDrawerOptions, IDrawerRouterState } from '../../core';
-import type { IDrawerScreenProps } from '../drawer-screen';
-export type { IDrawerNavigatorHandle, IDrawerDescriptorMap } from '../../core';
-export type IDrawerContentSlotProps = {
-    state: IDrawerRouterState;
-    descriptors: IDrawerDescriptorMap;
-    navigation: IDrawerNavigatorHandle;
-};
-export type IDrawerProps = IDrawerOptions & {
-    initialRouteName?: string;
-    drawerStyle?: IStyleProp<IViewStyle>;
-};
-export declare const Drawer: import("vue").DefineSetupFnComponent<IDrawerProps, {}, {}, IDrawerOptions & {
-    initialRouteName?: string;
-    drawerStyle?: IStyleProp<IViewStyle>;
-} & {}, import("vue").PublicProps> & {
-    Screen: import("vue").DefineSetupFnComponent<IDrawerScreenProps, {}, {}, IDrawerScreenProps & {}, import("vue").PublicProps>;
-};

package/build/vue/drawer/index.js

@@ -1,390 +0,0 @@
-// Drawer, the Vue 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 React/Angular adapters; here Vue supplies the lifecycle - a plain ref
-// for the router (Vue's twin of useReducer), a PanResponder for the swipe gesture (built ONCE in
-// setup, its callbacks reading options/window-width/isOpen LIVE off Vue's own reactive `attrs` /
-// composable refs at gesture time - Vue's reactivity already gives every gesture callback the
-// CURRENT value with no ref-mirroring dance, unlike React's useRef(value); value = X every
-// render), an Animated.Value driving the slide/opacity transforms, and expose() for the
-// open/close/toggle/jumpTo handle - mirroring 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, mirrored from
-// react/drawer.ts): 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 (verbatim from
-// the React twin - the gaps are architectural, not adapter-specific).
-import { defineComponent, h, nextTick, onMounted, onUnmounted, shallowRef, useId, watch, } from '@vue/runtime-core';
-import { Animated, PanResponder, normalizeVueAttrs, useWindowDimensions, } from '@symbiote-native/vue';
-import { dlog } from '@symbiote-native/engine';
-import { DRAWER_DEFAULT_OVERLAY_COLOR, NAVIGATION_EVENT_BLUR, NAVIGATION_EVENT_FOCUS, createInitialDrawerRouterState, createNavigationEmitter, diffFocusedRoute, drawerChildOrder, drawerRouterReducer, isDrawerAnimated, isRecord, renderDrawer, resolveDragProgress, resolveDrawerGeometry, resolveDrawerSlotInterpolation, resolveSwipeIntent, shouldClaimDrawerSwipe, } from '../../core/index.js';
-import { NavigationScope, injectNavigationScope } from '../navigation-context.js';
-import { DrawerScreen } from '../drawer-screen.js';
-function asString(value) {
-    return typeof value === 'string' ? value : undefined;
-}
-function asNumber(value) {
-    return typeof value === 'number' ? value : undefined;
-}
-function asBoolean(value) {
-    return typeof value === 'boolean' ? value : undefined;
-}
-function isStyleProp(value) {
-    return isRecord(value);
-}
-const DRAWER_TYPES = ['front', 'back', 'slide', 'permanent'];
-// .some() itself doesn't narrow `value`'s type back at the call site - the `value is IDrawerType`
-// predicate on THIS function is what lets asDrawerType's ternary return `value` typed, mirroring
-// Modal's isOrientation guard (adapters/vue/src/components/modal.ts).
-function isDrawerType(value) {
-    return typeof value === 'string' && DRAWER_TYPES.some(type => type === value);
-}
-function asDrawerType(value) {
-    return isDrawerType(value) ? value : undefined;
-}
-const DRAWER_POSITIONS = ['left', 'right'];
-function isDrawerPosition(value) {
-    return typeof value === 'string' && DRAWER_POSITIONS.some(position => position === value);
-}
-function asDrawerPosition(value) {
-    return isDrawerPosition(value) ? value : undefined;
-}
-function asComponent(value) {
-    if (typeof value === 'function')
-        return value;
-    return isRecord(value) ? value : undefined;
-}
-// IDrawerScreenOptions carries only `title`/`drawerLabel`, small enough for direct field guards -
-// kept as a single cast-at-the-edge helper anyway for symmetry with stack.ts/tabs.ts's
-// asScreenOptions/asTabOptions (same CLAUDE.md-sanctioned I/O-edge narrowing).
-function asDrawerScreenOptions(value) {
-    return isRecord(value) ? value : undefined;
-}
-function asDrawerScreenOptionsOrResolver(value) {
-    if (typeof value === 'function')
-        return value;
-    return asDrawerScreenOptions(value);
-}
-function collectRegistry(vnodes) {
-    const registry = new Map();
-    for (const vnode of vnodes) {
-        if (vnode.type !== DrawerScreen || !isRecord(vnode.props))
-            continue;
-        const name = asString(vnode.props.name);
-        const component = asComponent(vnode.props.component);
-        if (name === undefined || component === undefined)
-            continue;
-        registry.set(name, {
-            component,
-            options: asDrawerScreenOptionsOrResolver(vnode.props.options),
-            initialParams: vnode.props.initialParams,
-        });
-    }
-    return registry;
-}
-function resolveDrawerScreenOptions(entry, screenComponentProps) {
-    if (typeof entry.options === 'function')
-        return entry.options(screenComponentProps);
-    return entry.options ?? {};
-}
-const DRAWER_SNAP_DURATION = 250;
-const DrawerImpl = defineComponent((_props, { attrs: rawAttrs, slots, expose }) => {
-    const attrs = normalizeVueAttrs(rawAttrs);
-    // Read BEFORE this Drawer establishes its own per-screen NavigationScope below - becomes the
-    // `parent` link a nested screen's useNavigation().getParent() walks. undefined when this
-    // Drawer is the nesting root.
-    const ambientScopeRef = injectNavigationScope();
-    function currentOptions() {
-        return {
-            drawerType: asDrawerType(attrs.drawerType),
-            drawerPosition: asDrawerPosition(attrs.drawerPosition),
-            drawerWidth: asNumber(attrs.drawerWidth),
-            overlayColor: asString(attrs.overlayColor),
-            swipeEnabled: asBoolean(attrs.swipeEnabled),
-            swipeEdgeWidth: asNumber(attrs.swipeEdgeWidth),
-            swipeMinDistance: asNumber(attrs.swipeMinDistance),
-            swipeMinVelocity: asNumber(attrs.swipeMinVelocity),
-        };
-    }
-    let routeSequence = 0;
-    const routeIdPrefix = useId();
-    function buildRoutes(registry) {
-        return Array.from(registry.entries()).map(([name, entry]) => {
-            routeSequence += 1;
-            return {
-                key: `${routeIdPrefix}-${name}-${routeSequence}`,
-                name,
-                params: entry.initialParams,
-            };
-        });
-    }
-    const initialRegistry = collectRegistry(slots.default?.() ?? []);
-    const initialRoutes = buildRoutes(initialRegistry);
-    if (initialRoutes.length === 0)
-        dlog('Drawer: no <Drawer.Screen> children registered');
-    const state = shallowRef(createInitialDrawerRouterState(initialRoutes, asString(attrs.initialRouteName)));
-    function dispatch(action) {
-        state.value = drawerRouterReducer(state.value, action);
-    }
-    const windowDimensions = useWindowDimensions();
-    // progress: 0 closed -> 1 open, the single Animated.Value every slide/opacity transform below
-    // interpolates from. A plain `const` (not a ref): setup() runs once, so this needs no
-    // re-creation guard the way React's useRef(new Animated.Value(...)).current does.
-    const progress = new Animated.Value(state.value.isOpen ? 1 : 0);
-    // 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.
-    let dragStartProgress = 0;
-    function animateProgressTo(open) {
-        dlog(`Drawer: animateProgressTo(open=${open}) starting at t=${Date.now()}`);
-        Animated.timing(progress, {
-            toValue: open ? 1 : 0,
-            duration: DRAWER_SNAP_DURATION,
-            // Native-driver wiring 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();
-    }
-    const handle = {
-        openDrawer: () => {
-            dlog(`Drawer: openDrawer() called, isOpen=${state.value.isOpen} at t=${Date.now()}`);
-            animateProgressTo(true);
-            dispatch({ type: 'openDrawer' });
-        },
-        closeDrawer: () => {
-            dlog(`Drawer: closeDrawer() called, isOpen=${state.value.isOpen} at t=${Date.now()}`);
-            animateProgressTo(false);
-            dispatch({ type: 'closeDrawer' });
-        },
-        toggleDrawer: () => {
-            dlog(`Drawer: toggleDrawer() called, isOpen=${state.value.isOpen} at t=${Date.now()}`);
-            animateProgressTo(!state.value.isOpen);
-            dispatch({ type: 'toggleDrawer' });
-        },
-        jumpTo: (name) => {
-            // Captured BEFORE dispatch: unlike React's isOpenRef (only refreshed at the TOP of the
-            // next render, so it still holds the pre-dispatch value here since React batches the
-            // re-render asynchronously), this ref's `.value` mutates SYNCHRONOUSLY inside dispatch -
-            // reading it after dispatch would already see the reducer's own isOpen: false.
-            const wasOpen = state.value.isOpen;
-            dispatch({ type: 'jumpTo', name });
-            if (wasOpen)
-                animateProgressTo(false);
-        },
-    };
-    expose(handle);
-    const panResponder = PanResponder.create({
-        onStartShouldSetPanResponder: (event, gestureState) => shouldClaimDrawerSwipe(event, gestureState, windowDimensions.value.width, state.value.isOpen, currentOptions(), 'start'),
-        onMoveShouldSetPanResponder: (event, gestureState) => shouldClaimDrawerSwipe(event, gestureState, windowDimensions.value.width, state.value.isOpen, currentOptions(), 'move'),
-        onPanResponderGrant: () => {
-            dlog('Drawer: gesture grant');
-            dragStartProgress = state.value.isOpen ? 1 : 0;
-        },
-        onPanResponderMove: (_event, gestureState) => {
-            progress.setValue(resolveDragProgress(gestureState, dragStartProgress, currentOptions()));
-        },
-        onPanResponderRelease: (_event, gestureState) => {
-            const intent = resolveSwipeIntent(gestureState, state.value.isOpen, currentOptions());
-            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(state.value.isOpen);
-        },
-    });
-    // Only the focused route's screen is ever mounted (like Tab, unlike Stack which keeps every
-    // pushed route alive). One emitter per route.key, created lazily and cached for the
-    // navigator's whole lifetime (mirrors stack.ts's own `emitters` map) - see tabs.ts's matching
-    // comment for why a stable per-key lookup, not a recreate-on-change scheme, is what actually
-    // avoids racing Vue's own render/mount cycle regardless of which watch `flush` timing is used.
-    function focusedKeyOf(current) {
-        return current.routes[current.index]?.key;
-    }
-    const emitters = new Map();
-    function emitterFor(routeKey) {
-        let emitter = emitters.get(routeKey);
-        if (emitter === undefined) {
-            emitter = createNavigationEmitter();
-            emitters.set(routeKey, emitter);
-        }
-        return emitter;
-    }
-    // Emitted from onMounted (NOT from inside the render closure below, which runs before the
-    // focused screen's own component ever mounts - an emit there always has zero subscribers).
-    let focusedRouteKey = focusedKeyOf(state.value);
-    onMounted(() => {
-        if (focusedRouteKey !== undefined) {
-            dlog(`Drawer: route "${focusedRouteKey}" focused at t=${Date.now()}`);
-            emitterFor(focusedRouteKey).emit(NAVIGATION_EVENT_FOCUS);
-        }
-    });
-    // The bookkeeping (which key is focused) updates immediately so the render closure below
-    // always reads the right route; the actual emit is deferred to nextTick(), which resolves
-    // only after the CURRENT flush cycle fully drains - including the newly-focused screen's own
-    // onMounted (subscribing its useIsFocused/useFocusEffect listeners). flush:'post' alone is
-    // NOT enough here: it only guarantees this callback runs after THIS component's own render
-    // effect, not after an arbitrary sibling post-flush job (a just-mounted child's onMounted)
-    // that may be queued after it in the same batch - nextTick is the one API that waits for the
-    // WHOLE cycle, not just this watcher's own slot in it.
-    watch(() => focusedKeyOf(state.value), nextKey => {
-        const { blurKey, focusKey } = diffFocusedRoute(focusedRouteKey, nextKey);
-        if (blurKey === undefined && focusKey === undefined)
-            return;
-        focusedRouteKey = nextKey;
-        nextTick(() => {
-            if (blurKey !== undefined) {
-                dlog(`Drawer: route "${blurKey}" blurred at t=${Date.now()}`);
-                emitterFor(blurKey).emit(NAVIGATION_EVENT_BLUR);
-            }
-            if (focusKey !== undefined) {
-                dlog(`Drawer: route "${focusKey}" focused at t=${Date.now()}`);
-                emitterFor(focusKey).emit(NAVIGATION_EVENT_FOCUS);
-            }
-        });
-    });
-    onUnmounted(() => {
-        if (focusedRouteKey !== undefined)
-            emitterFor(focusedRouteKey).emit(NAVIGATION_EVENT_BLUR);
-    });
-    return () => {
-        const registry = collectRegistry(slots.default?.() ?? []);
-        const options = currentOptions();
-        const drawerStyle = isStyleProp(attrs.drawerStyle) ? attrs.drawerStyle : undefined;
-        if (registry.size === 0)
-            dlog('Drawer: no <Drawer.Screen> children registered');
-        const animated = isDrawerAnimated(options);
-        const geometry = resolveDrawerGeometry(options);
-        const panelTranslateX = animated
-            ? progress.interpolate(resolveDrawerSlotInterpolation(geometry, 'panel').translateX)
-            : undefined;
-        const contentTranslateX = animated
-            ? progress.interpolate(resolveDrawerSlotInterpolation(geometry, 'content').translateX)
-            : 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. resolveDrawerSlotInterpolation's
-        // 'overlay' branch ties its translateX to the SAME range as content's for exactly this
-        // reason, so overlayOpacity and overlayTranslateX below share one resolved config.
-        const overlayInterpolation = animated
-            ? resolveDrawerSlotInterpolation(geometry, 'overlay')
-            : undefined;
-        const overlayOpacity = overlayInterpolation
-            ? progress.interpolate(overlayInterpolation.opacity)
-            : undefined;
-        const overlayTranslateX = overlayInterpolation
-            ? progress.interpolate(overlayInterpolation.translateX)
-            : undefined;
-        const focusedRoute = state.value.routes[state.value.index];
-        const focusedEntry = focusedRoute ? registry.get(focusedRoute.name) : undefined;
-        if (focusedRoute && !focusedEntry) {
-            dlog(`Drawer: no screen registered for route name "${focusedRoute.name}"`);
-        }
-        const content = focusedEntry && focusedRoute
-            ? h(NavigationScope, {
-                value: {
-                    route: focusedRoute,
-                    navigation: handle,
-                    emitter: emitterFor(focusedRoute.key),
-                    parent: ambientScopeRef?.value,
-                },
-            }, 
-            // No route/navigation props: the screen reads both through composables off the
-            // NavigationScope provided just above (useRoute / useDrawerNavigation).
-            () => h(focusedEntry.component))
-            : null;
-        const descriptors = {};
-        for (const route of state.value.routes) {
-            const entry = registry.get(route.name);
-            if (entry === undefined)
-                continue;
-            descriptors[route.key] = {
-                options: resolveDrawerScreenOptions(entry, { route, navigation: handle }),
-                navigation: handle,
-            };
-        }
-        const drawerContent = slots.drawerContent?.({ state: state.value, descriptors, navigation: handle }) ?? null;
-        const root = renderDrawer({
-            overlayColor: asString(attrs.overlayColor) ?? DRAWER_DEFAULT_OVERLAY_COLOR,
-            drawerStyle,
-            contentPassthrough: {},
-            overlayPassthrough: animated
-                ? {
-                    pointerEvents: state.value.isOpen ? 'auto' : 'none',
-                    onStartShouldSetResponder: () => true,
-                    onResponderRelease: () => {
-                        animateProgressTo(false);
-                        dispatch({ type: 'closeDrawer' });
-                    },
-                }
-                : {},
-            panelPassthrough: {},
-        }, options);
-        const order = drawerChildOrder(options);
-        const slotDescriptors = new Map();
-        order.forEach((slot, index) => {
-            const descriptor = root.children[index];
-            if (typeof descriptor !== 'string')
-                slotDescriptors.set(slot, descriptor);
-        });
-        const slotChildren = {
-            content: content === null ? [] : [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`, 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 = slotDescriptors.get(slot);
-            if (descriptor === undefined)
-                return null;
-            const children = slotChildren[slot] ?? [];
-            const animatedStyle = slotAnimatedStyle[slot];
-            if (animatedStyle === undefined) {
-                return h(descriptor.type, { key: descriptor.key, ...descriptor.props }, children);
-            }
-            const style = [descriptor.props.style, animatedStyle];
-            return h(Animated.View, { key: descriptor.key, ...descriptor.props, style }, children);
-        }
-        const drawerChildren = order
-            .map(renderSlot)
-            .filter((element) => element !== null);
-        return h('symbiote-view', { style: root.props.style, ...panResponder.panHandlers }, drawerChildren);
-    };
-}, { name: 'Drawer', inheritAttrs: false });
-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, mirrored verbatim from the React
-// twin - the gaps are architectural, not adapter-specific) ---
-// 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).

package/build/vue/drawer-screen.d.ts

@@ -1,14 +0,0 @@
-import type { Component } from '@vue/runtime-core';
-import type { IDrawerScreenOptions, IRoute, IDrawerNavigatorHandle } from '../core';
-export type IDrawerScreenOptionsArgs = {
-    route: IRoute<unknown>;
-    navigation: IDrawerNavigatorHandle;
-};
-export type IDrawerScreenOptionsResolver = (props: IDrawerScreenOptionsArgs) => IDrawerScreenOptions;
-export type IDrawerScreenProps = {
-    name: string;
-    component: Component;
-    options?: IDrawerScreenOptions | IDrawerScreenOptionsResolver;
-    initialParams?: unknown;
-};
-export declare const DrawerScreen: import("vue").DefineSetupFnComponent<IDrawerScreenProps, {}, {}, IDrawerScreenProps & {}, import("vue").PublicProps>;

package/build/vue/drawer-screen.js

@@ -1,12 +0,0 @@
-// Drawer.Screen: a declarative marker, never rendered on its own - Drawer reads its props via a
-// default-slot scan (see drawer.ts's collectRegistry) to build the static name -> {component,
-// options} registry, then mounts the FOCUSED route's component. The Vue twin of
-// react/drawer-screen.ts's DrawerScreen, mirroring tab-screen.ts's slot-scanning marker (Tab is
-// the closer sibling - both are fixed-route-list/no-push navigators) and screen.ts's; see
-// CLAUDE.md <third_party_rn_packages_are_react_only> - this and Drawer import nothing from
-// react-native.
-import { defineComponent } from '@vue/runtime-core';
-export const DrawerScreen = defineComponent(() => () => null, {
-    name: 'DrawerScreen',
-    inheritAttrs: false,
-});

package/build/vue/index.d.ts

@@ -1,21 +0,0 @@
-import '../register';
-export { Stack } from './stack';
-export type { INavigatorHandle, IStackProps } from './stack';
-export { Screen } from './screen';
-export type { IScreenOptionsArgs, IScreenOptionsResolver, IScreenProps, IVueScreenOptions, IVueSearchBarOptions, } from './screen';
-export type { IScreenOptions, IStackAnimation, IStackPresentation } from '../core';
-export { useNavigation, useStackNavigation, useTabNavigation, useDrawerNavigation, useRoute, useIsFocused, useFocusEffect, useNavigationState, } from './composables';
-export type { INavigationHandle, IStackNavigationHandle, ITabNavigationHandle, IDrawerNavigationHandle, } from './composables';
-export type { INavigationScopeValue, IAnyNavigatorHandle } from './navigation-context';
-export { useLinkingIntegration } from './linking';
-export type { ILinkingConfig, IScreenLinkingConfig } from '../core';
-export { Tab } from './tabs';
-export type { ITabNavigatorHandle, ITabProps } from './tabs';
-export { TabScreen } from './tab-screen';
-export type { ITabScreenOptionsArgs, ITabScreenOptionsResolver, ITabScreenProps, } from './tab-screen';
-export type { ITabOptions, ITabBarIcon } from '../core';
-export { Drawer } from './drawer';
-export type { IDrawerContentSlotProps, IDrawerNavigatorHandle, IDrawerProps, IDrawerDescriptorMap, } from './drawer';
-export { DrawerScreen } from './drawer-screen';
-export type { IDrawerScreenOptionsArgs, IDrawerScreenOptionsResolver, IDrawerScreenProps, } from './drawer-screen';
-export type { IDrawerOptions, IDrawerScreenOptions, IDrawerType, IDrawerPosition } from '../core';

package/build/vue/index.js

@@ -1,19 +0,0 @@
-// @symbiote-native/navigation/vue: the Vue native-stack navigator over react-native-screens'
-// native view primitives. Importing this barrel first registers the native views' ViewConfigs
-// (../register, a side-effect import of the three codegen specs - never react-native-screens' own
-// React components), then exposes Stack (with Stack.Screen attached) and the navigator handle.
-import '../register';
-export { Stack } from './stack/index.js';
-export { Screen } from './screen.js';
-export { useNavigation, useStackNavigation, useTabNavigation, useDrawerNavigation, useRoute, useIsFocused, useFocusEffect, useNavigationState, } from './composables/index.js';
-export { useLinkingIntegration } from './linking.js';
-// Tab: the bottom-tabs navigator, a PURE-JS UI (no react-native-screens views involved, so no
-// extra ViewConfig registration is needed beyond the ../register import above).
-export { Tab } from './tabs/index.js';
-export { TabScreen } from './tab-screen.js';
-// Drawer: the swipeable drawer navigator, a PURE-JS UI (PanResponder + Animated, no
-// react-native-screens views involved, so no extra ViewConfig registration is needed beyond the
-// ../register import above). See drawer.ts's header for the feasibility note re:
-// react-native-gesture-handler / react-native-reanimated parity gaps.
-export { Drawer } from './drawer/index.js';
-export { DrawerScreen } from './drawer-screen.js';

package/build/vue/linking.d.ts

@@ -1,3 +0,0 @@
-import type { Ref } from '@vue/runtime-core';
-import type { ILinkingConfig, INavigatorHandle } from '../core';
-export declare function useLinkingIntegration(config: ILinkingConfig, navigatorHandle: Ref<INavigatorHandle | null>): void;

package/build/vue/linking.js

@@ -1,57 +0,0 @@
-// useLinkingIntegration: wires the framework-agnostic linking config (../core's
-// resolveRouteFromUrl) onto an existing Stack's INavigatorHandle. Deliberately NOT called from
-// inside stack.ts - app code owns the wiring, the same top-level-prop shape @react-navigation
-// keeps `linking` in on NavigationContainer rather than baking it into the router itself.
-//
-// Vue-shape difference from React: React's twin takes the RESOLVED `navigatorHandle:
-// INavigatorHandle` directly, because a React hook is called fresh on EVERY render with the
-// caller's current value, and useImperativeHandle's ref assignment (a layout effect) is
-// guaranteed to run before this hook's OWN mount effect, so `handleRef.current` is already
-// populated by the time it's read. Vue's setup() runs exactly ONCE per component instance, so
-// there is no "fresh call every render" to re-supply a resolved value, and a template/h() `ref`
-// only resolves to Stack's expose()d handle AFTER mount - an eagerly-resolved argument evaluated
-// at composable-call time (during setup, before mount) would be null. This composable therefore
-// takes the Stack's `Ref<INavigatorHandle | null>` itself (the ref object, not its resolved
-// value) and reads `.value` lazily inside onMounted - Vue's own onMounted hooks fire bottom-up
-// (children before parents), giving the same "already populated" guarantee React's layout-effect
-// ordering does.
-import { onMounted, onUnmounted } from '@vue/runtime-core';
-import { Linking, dlog } from '@symbiote-native/engine';
-import { resolveRouteFromUrl } from '../core/index.js';
-export function useLinkingIntegration(config, navigatorHandle) {
-    let cancelled = false;
-    let subscription;
-    function applyRoute(url, dispatch) {
-        const route = resolveRouteFromUrl(config, url);
-        if (route === null) {
-            dlog(`useLinkingIntegration: no route resolved for "${url}"`);
-            return;
-        }
-        dispatch(route.name, route.params);
-    }
-    onMounted(() => {
-        const handle = navigatorHandle.value;
-        if (handle === null) {
-            dlog('useLinkingIntegration: navigatorHandle is not yet available at mount time');
-            return;
-        }
-        Linking.getInitialURL()
-            .then(url => {
-            if (cancelled || url === null)
-                return;
-            dlog(`useLinkingIntegration: initial URL "${url}"`);
-            applyRoute(url, handle.replace);
-        })
-            .catch((error) => {
-            dlog(`useLinkingIntegration: getInitialURL failed: ${String(error)}`);
-        });
-        subscription = Linking.addEventListener('url', (event) => {
-            dlog(`useLinkingIntegration: url event "${event.url}"`);
-            applyRoute(event.url, handle.push);
-        });
-    });
-    onUnmounted(() => {
-        cancelled = true;
-        subscription?.remove();
-    });
-}

package/build/vue/navigation-context.d.ts

@@ -1,16 +0,0 @@
-import type { ShallowRef } from '@vue/runtime-core';
-import type { INavigationEmitter, IRoute, IAnyNavigatorHandle } from '../core';
-export type { IAnyNavigatorHandle };
-export type INavigationScopeValue = {
-    route: IRoute<unknown>;
-    navigation: IAnyNavigatorHandle;
-    emitter: INavigationEmitter;
-    parent?: INavigationScopeValue;
-};
-export declare function injectNavigationScope(): ShallowRef<INavigationScopeValue> | undefined;
-export declare function requireNavigationScope(hookName: string): ShallowRef<INavigationScopeValue>;
-export declare const NavigationScope: import("vue").DefineSetupFnComponent<{
-    value: INavigationScopeValue;
-}, {}, {}, {
-    value: INavigationScopeValue;
-} & {}, import("vue").PublicProps>;