@symbiote-native/navigation 1.0.0 → 2.0.1

package/build/core/linking-config/index.js

@@ -1,171 +0,0 @@
-// Linking config: the piece @react-navigation's `NavigationContainer`'s `linking` prop provides
-// on top of the framework-agnostic `Linking` module (core/engine/src/linking) - resolving a URL
-// ('myapp://user/42', '/user/42') to a route, and a route back to a URL. This is OUR OWN type,
-// not imported from react-navigation, kept close to its shape (`prefixes` + `config.screens`)
-// only so the DX is familiar.
-//
-// Why hand-rolled matching instead of react-router's `matchPath`/`generatePath` (evaluated per
-// task): react-router 8's package has no subpath export for the pure `lib/router/utils.ts`
-// matcher - its only general entry point (`.`) eagerly imports `./lib/dom/*`
-// (BrowserRouter/ScrollRestoration/cookies) and `./lib/server-runtime/*`, code that assumes DOM
-// and Node globals a Metro/Hermes RN bundle doesn't have; its `peerDependencies` also pin
-// `react-dom`, which this DOM-free monorepo never installs (see CLAUDE.md
-// react_native_is_an_explicit_top_level_peer - no foreign runtime singleton gets smuggled in).
-// On top of the bundling risk, `matchPath`'s/`generatePath`'s param-name extraction is a
-// template-literal-type trick that only fires for a compile-time LITERAL path string; our
-// patterns come from a runtime config object (`Path` widens to plain `string`), so the generic
-// degrades to an empty params type and using the result would force an `as` cast - forbidden by
-// this project's TS conventions. A minimal `:param`-segment matcher sidesteps both problems and
-// is the right size for a single flat Stack (no optional/splat segments - no nested-navigator use
-// for them yet).
-import { dlog } from '@symbiote-native/engine';
-import { isRecord } from '../guards.js';
-// Strips leading/trailing slashes so segments join predictably regardless of how the caller
-// wrote a path ('feed/:sort', '/feed/:sort/', etc).
-function normalizeSegment(segment) {
-    return segment.replace(/^\/+|\/+$/g, '');
-}
-function joinPath(parent, child) {
-    const parts = [normalizeSegment(parent), normalizeSegment(child)].filter(part => part.length > 0);
-    return parts.join('/');
-}
-// Walks `screens` recursively, accumulating the path down to each LEAF screen. Unlike
-// react-navigation (which resolves nested config into nested navigation state), our navigator is
-// a single flat Stack - a `screens` group with no `path` of its own is transparent (consumes no
-// URL segment); a group WITH a `path` but no nested `screens` is itself a leaf using that path.
-function flattenScreens(screens, parentPath, out) {
-    for (const [name, entry] of Object.entries(screens)) {
-        if (typeof entry === 'string') {
-            out.push({ name, pattern: joinPath(parentPath, entry) });
-            continue;
-        }
-        const nextParent = entry.path !== undefined ? joinPath(parentPath, entry.path) : parentPath;
-        if (entry.screens !== undefined) {
-            flattenScreens(entry.screens, nextParent, out);
-        }
-        else if (entry.path !== undefined) {
-            out.push({ name, pattern: nextParent });
-        }
-        else {
-            dlog(`linking-config: screen "${name}" has neither a path nor nested screens, skipping`);
-        }
-    }
-    return out;
-}
-function dynamicSegmentCount(pattern) {
-    if (pattern.length === 0)
-        return 0;
-    return pattern.split('/').filter(segment => segment.startsWith(':')).length;
-}
-function segmentCount(pattern) {
-    return pattern.length === 0 ? 0 : pattern.split('/').length;
-}
-// More static segments should win over a param that would also match (e.g. a literal
-// '/user/me' pattern over '/user/:id'), mirroring how react-navigation prefers exact matches.
-function bySpecificity(a, b) {
-    const dynamicDiff = dynamicSegmentCount(a.pattern) - dynamicSegmentCount(b.pattern);
-    if (dynamicDiff !== 0)
-        return dynamicDiff;
-    return segmentCount(b.pattern) - segmentCount(a.pattern);
-}
-function matchPattern(pattern, pathname) {
-    const patternSegments = pattern.length === 0 ? [] : pattern.split('/');
-    const pathSegments = pathname.length === 0 ? [] : pathname.split('/');
-    if (patternSegments.length !== pathSegments.length)
-        return null;
-    const params = {};
-    for (let index = 0; index < patternSegments.length; index += 1) {
-        const patternSegment = patternSegments[index];
-        const pathSegment = pathSegments[index];
-        if (patternSegment.startsWith(':')) {
-            params[patternSegment.slice(1)] = decodeURIComponent(pathSegment);
-        }
-        else if (patternSegment !== pathSegment) {
-            return null;
-        }
-    }
-    return params;
-}
-function stripQueryAndHash(url) {
-    const match = /[?#]/.exec(url);
-    return match === null ? url : url.slice(0, match.index);
-}
-// Resolves a full URL down to the bare path segment string ('user/42', no leading slash) by
-// stripping the longest matching configured prefix, falling back to treating the URL as an
-// already-bare path when it starts with '/' (the task's second example form). Returns null when
-// neither applies - an unrecognized scheme/host, not "no route matched".
-function extractPathname(config, url) {
-    const withoutQuery = stripQueryAndHash(url);
-    const sortedPrefixes = [...config.prefixes].sort((a, b) => b.length - a.length);
-    for (const prefix of sortedPrefixes) {
-        if (withoutQuery.startsWith(prefix)) {
-            return normalizeSegment(withoutQuery.slice(prefix.length));
-        }
-    }
-    if (withoutQuery.startsWith('/'))
-        return normalizeSegment(withoutQuery);
-    return null;
-}
-export function resolveRouteFromUrl(config, url) {
-    const pathname = extractPathname(config, url);
-    if (pathname === null) {
-        dlog(`linking-config: url "${url}" matched no configured prefix`);
-        return null;
-    }
-    const candidates = flattenScreens(config.config.screens, '', []).sort(bySpecificity);
-    for (const candidate of candidates) {
-        const params = matchPattern(candidate.pattern, pathname);
-        if (params !== null) {
-            dlog(`linking-config: resolved "${url}" -> ${candidate.name}`);
-            // `key` is not real route identity here - the navigator mints its own on push/replace
-            // (stack.ts's createRoute); `name` is a stable enough placeholder to satisfy IRoute's shape.
-            return {
-                key: candidate.name,
-                name: candidate.name,
-                params: Object.keys(params).length > 0 ? params : undefined,
-            };
-        }
-    }
-    dlog(`linking-config: url "${url}" (path "${pathname}") matched no configured screen`);
-    return null;
-}
-// The inverse of matchPattern: fills a pattern's ':param' segments from `params`, or returns
-// null when a required param is missing (mirrors react-router's generatePath throwing, minus the
-// throw - a resolver returning null reads more naturally at the call site here).
-function fillPattern(pattern, params) {
-    if (pattern.length === 0)
-        return '';
-    const source = isRecord(params) ? params : {};
-    const segments = [];
-    for (const segment of pattern.split('/')) {
-        if (!segment.startsWith(':')) {
-            segments.push(segment);
-            continue;
-        }
-        const value = source[segment.slice(1)];
-        if (value === undefined || value === null)
-            return null;
-        segments.push(encodeURIComponent(String(value)));
-    }
-    return segments.join('/');
-}
-export function resolveUrlFromRoute(config, route) {
-    const candidate = flattenScreens(config.config.screens, '', []).find(entry => entry.name === route.name);
-    if (candidate === undefined) {
-        dlog(`linking-config: no configured screen for route name "${route.name}"`);
-        return null;
-    }
-    const path = fillPattern(candidate.pattern, route.params);
-    if (path === null) {
-        dlog(`linking-config: route "${route.name}" is missing a param required by "${candidate.pattern}"`);
-        return null;
-    }
-    const prefix = config.prefixes[0];
-    if (prefix === undefined)
-        return path.length > 0 ? `/${path}` : '/';
-    // A prefix already carrying its own trailing separator ('myapp://') must not be truncated to
-    // 'myapp:/' by naively slicing one char off - only add a '/' when the prefix doesn't have one.
-    if (path.length === 0)
-        return prefix;
-    return prefix.endsWith('/') ? `${prefix}${path}` : `${prefix}/${path}`;
-}

package/build/core/navigation-events/index.d.ts

@@ -1,16 +0,0 @@
-export declare const NAVIGATION_EVENT_FOCUS = "focus";
-export declare const NAVIGATION_EVENT_BLUR = "blur";
-export declare const NAVIGATION_EVENT_STATE = "state";
-export declare const NAVIGATION_EVENT_BEFORE_REMOVE = "beforeRemove";
-export type INavigationEventName = typeof NAVIGATION_EVENT_FOCUS | typeof NAVIGATION_EVENT_BLUR | typeof NAVIGATION_EVENT_STATE | typeof NAVIGATION_EVENT_BEFORE_REMOVE;
-export type INavigationEventListener<TData = unknown> = (data: TData) => void;
-export type INavigationEmitter = {
-    emit: (event: INavigationEventName, data?: unknown) => void;
-    addListener: (event: INavigationEventName, listener: INavigationEventListener) => () => void;
-};
-export declare function createNavigationEmitter(): INavigationEmitter;
-export type IFocusTransition = {
-    blurKey?: string;
-    focusKey?: string;
-};
-export declare function diffFocusedRoute(prevKey: string | undefined, nextKey: string | undefined): IFocusTransition;

package/build/core/navigation-events/index.js

@@ -1,57 +0,0 @@
-// The framework-agnostic half of what @react-navigation exposes as `navigation.addListener` /
-// `useFocusEffect` / `useIsFocused` / `useNavigationState`: a plain pub/sub emitter, zero React.
-// addListener is NOT React-specific there either - React's hooks are thin useEffect wrappers
-// around exactly this subscribe/unsubscribe shape (confirmed against the 8.x docs: `const
-// unsubscribe = navigation.addListener('focus', cb); return unsubscribe;` inside a bare
-// `useEffect`). One emitter per route (created by the adapter, e.g. stack.ts's per-route
-// `emitters` map) carries that route's own focus/blur/state lifecycle; every adapter's lifecycle
-// hooks subscribe to it, matching this file's single responsibility split from `constants.ts`
-// (which only names Fabric view/prop-key strings, not this JS-only event system).
-//
-// diffFocusedRoute below centralizes the "which route lost focus, which gained it" comparison
-// that tabs.ts and drawer.ts independently reimplemented in all three adapters (each watching its
-// own router state for the focused index/key changing, then manually emitting BLUR to the old key
-// and FOCUS to the new one, plus an initial FOCUS seed on first mount) - the diff is pure and
-// identical everywhere; only WHEN to run it differs per framework (a `useEffect` dependency array,
-// a Vue `watch`, an idempotent-per-read Angular method), so that half stays adapter-owned.
-import { dlog } from '@symbiote-native/engine';
-export const NAVIGATION_EVENT_FOCUS = 'focus';
-export const NAVIGATION_EVENT_BLUR = 'blur';
-export const NAVIGATION_EVENT_STATE = 'state';
-export const NAVIGATION_EVENT_BEFORE_REMOVE = 'beforeRemove';
-export function createNavigationEmitter() {
-    const listenersByEvent = new Map();
-    function addListener(event, listener) {
-        let listeners = listenersByEvent.get(event);
-        if (!listeners) {
-            listeners = new Set();
-            listenersByEvent.set(event, listeners);
-        }
-        listeners.add(listener);
-        return () => {
-            listeners?.delete(listener);
-        };
-    }
-    function emit(event, data) {
-        const listeners = listenersByEvent.get(event);
-        // Investigation instrumentation (flicker-on-focus bug): every emission, whether or not a
-        // listener is attached, so the log stream shows if focus/blur ever fires with 0 subscribers
-        // (a silent no-op) vs racing an actual effect. Kept behind DEBUG, never removed.
-        dlog(`Navigation emitter: emit "${event}" (${listeners?.size ?? 0} listener(s)) at t=${Date.now()}`);
-        if (!listeners)
-            return;
-        for (const listener of listeners)
-            listener(data);
-    }
-    return { emit, addListener };
-}
-export function diffFocusedRoute(prevKey, nextKey) {
-    if (prevKey === nextKey)
-        return {};
-    const transition = {};
-    if (prevKey !== undefined)
-        transition.blurKey = prevKey;
-    if (nextKey !== undefined)
-        transition.focusKey = nextKey;
-    return transition;
-}

package/build/core/navigator-handles/index.d.ts

@@ -1,30 +0,0 @@
-import type { INavigatorState } from '../navigator-state';
-import type { IDrawerScreenOptions } from '../drawer-options';
-export type INavigatorHandle = {
-    push: (name: string, params?: unknown) => void;
-    pop: (count?: number) => void;
-    popToTop: () => void;
-    popTo: (key: string) => void;
-    replace: (name: string, params?: unknown) => void;
-    setParams: (params: unknown, key?: string) => void;
-    reset: (state: INavigatorState) => void;
-    canGoBack: () => boolean;
-};
-export type ITabNavigatorHandle = {
-    jumpTo: (name: string, params?: unknown) => void;
-    setParams: (params: unknown, key: string) => void;
-};
-export type IDrawerNavigatorHandle = {
-    openDrawer: () => void;
-    closeDrawer: () => void;
-    toggleDrawer: () => void;
-    jumpTo: (name: string) => void;
-};
-export type IDrawerDescriptorMap = Record<string, {
-    options: IDrawerScreenOptions;
-    navigation: IDrawerNavigatorHandle;
-}>;
-export type IAnyNavigatorHandle = INavigatorHandle | ITabNavigatorHandle | IDrawerNavigatorHandle;
-export declare function isStackNavigatorHandle(handle: IAnyNavigatorHandle): handle is INavigatorHandle;
-export declare function isDrawerNavigatorHandle(handle: IAnyNavigatorHandle): handle is IDrawerNavigatorHandle;
-export declare function isTabNavigatorHandle(handle: IAnyNavigatorHandle): handle is ITabNavigatorHandle;

package/build/core/navigator-handles/index.js

@@ -1,15 +0,0 @@
-// Imperative navigator handles: framework-agnostic (scalars, `unknown`, plain function
-// signatures over `INavigatorState`/`IDrawerScreenOptions` - no framework element, ref, or
-// children in any field), so each shape is declared once here and every adapter re-exports it
-// verbatim (see CLAUDE.md <prop_types_split_agnostic_vs_per_adapter>).
-export function isStackNavigatorHandle(handle) {
-    return 'push' in handle;
-}
-export function isDrawerNavigatorHandle(handle) {
-    return 'openDrawer' in handle;
-}
-// jumpTo exists on both Tab and Drawer handles, so a Tab handle is a jumpTo-having handle that
-// isn't a Drawer handle (Drawer's own openDrawer/closeDrawer/toggleDrawer rule it out).
-export function isTabNavigatorHandle(handle) {
-    return 'jumpTo' in handle && !isDrawerNavigatorHandle(handle);
-}

package/build/core/navigator-props.d.ts

@@ -1,216 +0,0 @@
-import type { IColorValue, ISymbioteEvent } from '@symbiote-native/engine';
-import type { IImageSourceProp } from '@symbiote-native/components';
-export type IStackAnimation = 'default' | 'flip' | 'simple_push' | 'none' | 'fade' | 'slide_from_right' | 'slide_from_left' | 'slide_from_bottom' | 'fade_from_bottom' | 'ios_from_right' | 'ios_from_left';
-export type IStackPresentation = 'push' | 'modal' | 'transparentModal' | 'fullScreenModal' | 'formSheet' | 'pageSheet' | 'containedModal' | 'containedTransparentModal';
-export type IHeaderBackButtonDisplayMode = 'minimal' | 'default' | 'generic';
-export type IHeaderUserInterfaceStyle = 'unspecified' | 'light' | 'dark';
-export type IOptionalBooleanNativeProp = 'undefined' | 'false' | 'true';
-export type ISheetAllowedDetents = number[] | 'fitToContents' | 'large' | 'medium' | 'all';
-export type ISheetLargestUndimmedDetent = number | 'last' | 'none' | 'all' | 'large' | 'medium';
-export type ISheetInitialDetent = number | 'last';
-export type IHeaderBarButtonIcon = {
-    type: 'sfSymbol';
-    name: string;
-} | {
-    type: 'xcasset';
-    name: string;
-} | {
-    type: 'imageSource';
-    imageSource: IImageSourceProp;
-} | {
-    type: 'templateSource';
-    templateSource: IImageSourceProp;
-};
-export type IHeaderBarButtonItemBadge = {
-    value: string;
-    style?: {
-        color?: IColorValue;
-        backgroundColor?: IColorValue;
-        fontFamily?: string;
-        fontSize?: number;
-        fontWeight?: string;
-    };
-};
-type ISharedHeaderBarButtonItem = {
-    index?: number;
-    title?: string;
-    titleStyle?: {
-        fontFamily?: string;
-        fontSize?: number;
-        fontWeight?: string;
-        color?: IColorValue;
-    };
-    icon?: IHeaderBarButtonIcon;
-    variant?: 'plain' | 'done' | 'prominent';
-    tintColor?: IColorValue;
-    disabled?: boolean;
-    width?: number;
-    hidesSharedBackground?: boolean;
-    sharesBackground?: boolean;
-    identifier?: string;
-    badge?: IHeaderBarButtonItemBadge;
-    accessibilityLabel?: string;
-    accessibilityHint?: string;
-};
-export type IHeaderBarButtonItemAction = ISharedHeaderBarButtonItem & {
-    type: 'button';
-    onPress: () => void;
-    selected?: boolean;
-};
-export type IHeaderBarButtonMenuAction = {
-    type: 'action';
-    title?: string;
-    subtitle?: string;
-    onPress: () => void;
-    icon?: IHeaderBarButtonIcon;
-    state?: 'on' | 'off' | 'mixed';
-    disabled?: boolean;
-    destructive?: boolean;
-    hidden?: boolean;
-    keepsMenuPresented?: boolean;
-    discoverabilityLabel?: string;
-};
-export type IHeaderBarButtonSubmenu = {
-    type: 'submenu';
-    title?: string;
-    icon?: IHeaderBarButtonIcon;
-    items: (IHeaderBarButtonMenuAction | IHeaderBarButtonSubmenu)[];
-    displayInline?: boolean;
-    destructive?: boolean;
-    singleSelection?: boolean;
-    displayAsPalette?: boolean;
-};
-export type IHeaderBarButtonItemMenu = ISharedHeaderBarButtonItem & {
-    type: 'menu';
-    menu: {
-        title?: string;
-        items: (IHeaderBarButtonMenuAction | IHeaderBarButtonSubmenu)[];
-        singleSelection?: boolean;
-        displayAsPalette?: boolean;
-    };
-    changesSelectionAsPrimaryAction?: boolean;
-};
-export type IHeaderBarButtonItemSpacing = {
-    type: 'spacing';
-    spacing: number;
-};
-export type IHeaderBarButtonItem = IHeaderBarButtonItemAction | IHeaderBarButtonItemMenu | IHeaderBarButtonItemSpacing;
-export type ISearchBarAutoCapitalize = 'systemDefault' | 'none' | 'words' | 'sentences' | 'characters';
-export type ISearchBarPlacement = 'automatic' | 'inline' | 'stacked' | 'integrated' | 'integratedButton' | 'integratedCentered';
-export type ISearchBarOptions = {
-    placeholder?: string;
-    autoCapitalize?: ISearchBarAutoCapitalize;
-    placement?: ISearchBarPlacement;
-    hideWhenScrolling?: boolean;
-    allowToolbarIntegration?: boolean;
-    obscureBackground?: boolean;
-    hideNavigationBar?: boolean;
-    cancelButtonText?: string;
-    barTintColor?: IColorValue;
-    tintColor?: IColorValue;
-    textColor?: IColorValue;
-    autoFocus?: boolean;
-    disableBackButtonOverride?: boolean;
-    inputType?: string;
-    hintTextColor?: IColorValue;
-    headerIconColor?: IColorValue;
-    shouldShowHintSearchIcon?: boolean;
-    onChangeText?: (text: string) => void;
-    onFocus?: () => void;
-    onBlur?: () => void;
-    onCancelButtonPress?: () => void;
-    onSearchButtonPress?: (text: string) => void;
-    onClose?: () => void;
-    onOpen?: () => void;
-};
-export type IScreenOrientation = 'default' | 'all' | 'portrait' | 'portrait_up' | 'portrait_down' | 'landscape' | 'landscape_left' | 'landscape_right';
-export interface IScreenOptions {
-    title?: string;
-    headerShown?: boolean;
-    headerTitleColor?: IColorValue;
-    headerStyle?: {
-        backgroundColor?: IColorValue;
-    };
-    headerTintColor?: IColorValue;
-    headerBackTitle?: string;
-    headerBackButtonDisplayMode?: IHeaderBackButtonDisplayMode;
-    headerLargeTitle?: boolean;
-    headerLargeStyle?: {
-        backgroundColor?: IColorValue;
-    };
-    headerUserInterfaceStyle?: IHeaderUserInterfaceStyle;
-    headerTranslucent?: boolean;
-    headerLeftBarButtonItems?: IHeaderBarButtonItem[];
-    headerRightBarButtonItems?: IHeaderBarButtonItem[];
-    headerSearchBarOptions?: ISearchBarOptions;
-    gestureEnabled?: boolean;
-    stackAnimation?: IStackAnimation;
-    stackPresentation?: IStackPresentation;
-    transitionDuration?: number;
-    sheetAllowedDetents?: ISheetAllowedDetents;
-    sheetLargestUndimmedDetentIndex?: ISheetLargestUndimmedDetent;
-    sheetInitialDetentIndex?: ISheetInitialDetent;
-    sheetGrabberVisible?: boolean;
-    sheetCornerRadius?: number;
-    sheetExpandsWhenScrolledToEdge?: boolean;
-    sheetElevation?: number;
-    sheetShouldOverflowTopInset?: boolean;
-    sheetDefaultResizeAnimationEnabled?: boolean;
-    statusBarStyle?: 'inverted' | 'auto' | 'light' | 'dark';
-    statusBarHidden?: boolean;
-    statusBarAnimation?: 'none' | 'fade' | 'slide';
-    screenOrientation?: IScreenOrientation;
-}
-export type INavigatorPlatform = {
-    defaultHeaderBackTitleVisible: boolean;
-};
-export type IScreenViewProps = {
-    screenId: string;
-    activityState: number;
-    gestureEnabled?: boolean;
-    stackAnimation?: IStackAnimation;
-    stackPresentation?: IStackPresentation;
-    transitionDuration?: number;
-    sheetAllowedDetents?: number[];
-    sheetLargestUndimmedDetent?: number;
-    sheetInitialDetent?: number;
-    sheetGrabberVisible?: boolean;
-    sheetCornerRadius?: number;
-    sheetExpandsWhenScrolledToEdge?: boolean;
-    sheetElevation?: number;
-    sheetShouldOverflowTopInset?: boolean;
-    sheetDefaultResizeAnimationEnabled?: boolean;
-    statusBarStyle?: 'inverted' | 'auto' | 'light' | 'dark';
-    statusBarHidden?: boolean;
-    statusBarAnimation?: 'none' | 'fade' | 'slide';
-    screenOrientation?: IScreenOrientation;
-    passthrough: Record<string, unknown>;
-};
-export type IHeaderConfigViewProps = {
-    title?: string;
-    hidden: boolean;
-    backTitle?: string;
-    backTitleVisible: boolean;
-    backButtonDisplayMode?: IHeaderBackButtonDisplayMode;
-    largeTitle?: boolean;
-    translucent?: boolean;
-    color?: IColorValue;
-    titleColor?: IColorValue;
-    backgroundColor?: IColorValue;
-    largeTitleBackgroundColor?: IColorValue;
-    userInterfaceStyle?: IHeaderUserInterfaceStyle;
-    headerLeftBarButtonItems?: unknown[];
-    headerRightBarButtonItems?: unknown[];
-    onPressHeaderBarButtonItem?: (event: ISymbioteEvent) => void;
-    onPressHeaderBarButtonMenuItem?: (event: ISymbioteEvent) => void;
-    passthrough: Record<string, unknown>;
-};
-export type IStackViewProps = {
-    passthrough: Record<string, unknown>;
-};
-export type ISearchBarViewProps = Omit<ISearchBarOptions, 'obscureBackground' | 'hideNavigationBar' | 'onChangeText' | 'onFocus' | 'onBlur' | 'onCancelButtonPress' | 'onSearchButtonPress' | 'onClose' | 'onOpen'> & {
-    obscureBackground?: IOptionalBooleanNativeProp;
-    hideNavigationBar?: IOptionalBooleanNativeProp;
-    passthrough: Record<string, unknown>;
-};
-export {};

package/build/core/navigator-props.js

@@ -1,7 +0,0 @@
-// Navigator prop types. Per CLAUDE.md <prop_types_split_agnostic_vs_per_adapter>: screen
-// options (title, header styling, transition/presentation) are entirely scalar/color-typed, so
-// they live here as the shared agnostic base every adapter re-exports. The Stack/Screen PUBLIC
-// component props are NOT here - they carry framework children (the screen content) and a
-// framework ref (the navigator handle), so each adapter declares its own flavored type over
-// this base, same split as IPressableProps.
-export {};

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

@@ -1,36 +0,0 @@
-export type IRoute<TParams = undefined> = Readonly<{
-    key: string;
-    name: string;
-    params: TParams;
-}>;
-type IRouteEntry = IRoute<unknown>;
-export type INavigatorState = Readonly<{
-    routes: readonly IRouteEntry[];
-}>;
-export type INavigatorAction = {
-    type: 'push';
-    route: IRouteEntry;
-} | {
-    type: 'pop';
-    count?: number;
-} | {
-    type: 'popToTop';
-} | {
-    type: 'popTo';
-    key: string;
-} | {
-    type: 'replace';
-    route: IRouteEntry;
-} | {
-    type: 'setParams';
-    key?: string;
-    params: unknown;
-} | {
-    type: 'reset';
-    state: INavigatorState;
-};
-export declare function createInitialNavigatorState(initialRoute: IRouteEntry): INavigatorState;
-export declare function navigatorReducer(state: INavigatorState, action: INavigatorAction): INavigatorState;
-export declare function computeActivityState(index: number, routesLength: number): number;
-export declare function isTopRoute(index: number, routesLength: number): boolean;
-export {};

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

@@ -1,81 +0,0 @@
-// Navigator: the logic half (framework-agnostic, zero render). A pure reducer over a route
-// stack - push/pop/popToTop/popTo/replace - mirroring what @react-navigation/native-stack keeps
-// in its router, minus the React-specific action-creator/linking machinery. Route identity
-// (`key`) is generated by the CALLER (the adapter, via React's useId or an equivalent) - the
-// reducer never invents identity itself, so it stays a pure (state, action) => state function.
-import { SCREEN_ACTIVITY_STATE_FOCUSED, SCREEN_ACTIVITY_STATE_INACTIVE } from '../constants.js';
-import { mergeParams } from '../guards.js';
-export function createInitialNavigatorState(initialRoute) {
-    return { routes: [initialRoute] };
-}
-// The stack never pops its last route - mirrors the library refusing to pop the initial screen;
-// the caller (e.g. a hardware back handler) decides what a pop-at-root means for the host app.
-export function navigatorReducer(state, action) {
-    switch (action.type) {
-        case 'push':
-            return { routes: [...state.routes, action.route] };
-        case 'pop': {
-            if (state.routes.length <= 1)
-                return state;
-            const count = action.count ?? 1;
-            const nextLength = Math.max(1, state.routes.length - count);
-            return { routes: state.routes.slice(0, nextLength) };
-        }
-        case 'popToTop':
-            return state.routes.length <= 1 ? state : { routes: state.routes.slice(0, 1) };
-        case 'popTo': {
-            const index = state.routes.findIndex(route => route.key === action.key);
-            if (index === -1)
-                return state;
-            return { routes: state.routes.slice(0, index + 1) };
-        }
-        case 'replace': {
-            if (state.routes.length === 0)
-                return { routes: [action.route] };
-            return { routes: [...state.routes.slice(0, -1), action.route] };
-        }
-        // Mirrors @react-navigation's CommonActions.setParams: merges onto the route matched by
-        // `key`, defaulting to the focused (top-of-stack) route when omitted - same shape as its
-        // `source`-defaults-to-focused-route behavior, minus the cross-navigator target routing this
-        // single-navigator reducer has no need for.
-        case 'setParams': {
-            const targetKey = action.key ?? state.routes[state.routes.length - 1]?.key;
-            if (targetKey === undefined)
-                return state;
-            const index = state.routes.findIndex(route => route.key === targetKey);
-            if (index === -1)
-                return state;
-            const target = state.routes[index];
-            const nextRoute = {
-                ...target,
-                params: mergeParams(target.params, action.params),
-            };
-            return {
-                routes: [...state.routes.slice(0, index), nextRoute, ...state.routes.slice(index + 1)],
-            };
-        }
-        // Mirrors @react-navigation's CommonActions.reset / BaseRouter's RESET handler: the payload
-        // state replaces the current one verbatim, no merge - full rehydration (e.g. restoring a
-        // persisted stack) is just a reset with the deserialized state as the payload.
-        case 'reset':
-            return action.state;
-        default:
-            return state;
-    }
-}
-// Mirrors @react-navigation/native-stack's actual algorithm (NativeStackView.native.tsx:
-// `activityState={isInactive ? 0 : 2}`, where isInactive = index > state.index) - NOT a
-// three-way top/one-below/rest split. A route index beyond the focused one only exists for a
-// preloaded-but-not-yet-navigated-to screen, a feature this reducer doesn't implement, so the
-// focused index is always routesLength - 1 (the last route) and every currently-mounted route is
-// FOCUSED. This is required, not just simpler: react-native-screens' native RNSScreen.mm asserts
-// an already-mounted NativeStack screen's activityState can never decrease via a plain prop
-// update ("activityState can only progress in NativeStack") - since no mounted route's index ever
-// exceeds routesLength - 1, this formula never produces a decrease across a push or pop.
-export function computeActivityState(index, routesLength) {
-    const focusedIndex = routesLength - 1;
-    return index > focusedIndex ? SCREEN_ACTIVITY_STATE_INACTIVE : SCREEN_ACTIVITY_STATE_FOCUSED;
-}
-export function isTopRoute(index, routesLength) {
-    return index === routesLength - 1;
-}

package/build/core/render-drawer.d.ts

@@ -1,13 +0,0 @@
-import { type IDescriptor } from '@symbiote-native/components';
-import type { IStyleProp, IViewStyle } from '@symbiote-native/engine';
-import { type IDrawerOptions } from './drawer-options';
-export type IDrawerSlot = 'content' | 'overlay' | 'panel';
-export declare function drawerChildOrder(options: IDrawerOptions): readonly IDrawerSlot[];
-export type IDrawerViewProps = {
-    overlayColor?: string;
-    drawerStyle?: IStyleProp<IViewStyle>;
-    contentPassthrough: Record<string, unknown>;
-    overlayPassthrough: Record<string, unknown>;
-    panelPassthrough: Record<string, unknown>;
-};
-export declare function renderDrawer(view: IDrawerViewProps, options: IDrawerOptions): IDescriptor;