@mapples/navigation 1.1.1

package/dist/mappers/screenOptions.js

@@ -0,0 +1,37 @@
+import { mapHeaderOptions } from './headerOptions';
+/**
+ * Per-route native-stack options: the route's header overrides
+ * ({@link RouteNode.options} extends `Partial<HeaderOptions>`) plus its
+ * `presentation`.
+ */
+export const mapStackScreenOptions = (route, resolvers) => {
+    const patch = {
+        ...mapHeaderOptions(route.options, resolvers),
+    };
+    if (route.presentation !== undefined)
+        patch.presentation = route.presentation;
+    return patch;
+};
+/** Per-route bottom-tabs item options (label + icon). */
+export const mapTabItemOptions = (route, resolvers) => {
+    const patch = {};
+    if (route.options?.tabLabel !== undefined) {
+        patch.tabBarLabel = route.options.tabLabel;
+    }
+    const icon = resolvers.resolveIcon(route.options?.tabIcon);
+    if (icon)
+        patch.tabBarIcon = icon;
+    return patch;
+};
+/** Per-route drawer item options (label + icon). */
+export const mapDrawerItemOptions = (route, resolvers) => {
+    const patch = {};
+    if (route.options?.drawerLabel !== undefined) {
+        patch.drawerLabel = route.options.drawerLabel;
+    }
+    const icon = resolvers.resolveIcon(route.options?.drawerIcon);
+    if (icon)
+        patch.drawerIcon = icon;
+    return patch;
+};
+//# sourceMappingURL=screenOptions.js.map

package/dist/mappers/screenOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenOptions.js","sourceRoot":"","sources":["../../src/mappers/screenOptions.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAgB,EAChB,SAAuB,EACE,EAAE;IAC3B,MAAM,KAAK,GAA4B;QACrC,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC;KAC9C,CAAC;IACF,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS;QAAE,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAgB,EAChB,SAAuB,EACF,EAAE;IACvB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC1C,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,IAAI;QAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,KAAgB,EAChB,SAAuB,EACC,EAAE;IAC1B,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QAC7C,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;IAChD,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9D,IAAI,IAAI;QAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/mappers/tabBarOptions.d.ts

@@ -0,0 +1,5 @@
+import { TabBarOptions } from '@mapples/types';
+import { RefResolvers, TabBarOptionsPatch } from '../types';
+/** Map {@link TabBarOptions} to a bottom-tabs navigator options patch. */
+export declare const mapTabBarOptions: (tabBar: TabBarOptions | undefined, resolvers: RefResolvers) => TabBarOptionsPatch;
+//# sourceMappingURL=tabBarOptions.d.ts.map

package/dist/mappers/tabBarOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabBarOptions.d.ts","sourceRoot":"","sources":["../../src/mappers/tabBarOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE5D,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,aAAa,GAAG,SAAS,EACjC,WAAW,YAAY,KACtB,kBAkCF,CAAC"}

package/dist/mappers/tabBarOptions.js

@@ -0,0 +1,37 @@
+/** Map {@link TabBarOptions} to a bottom-tabs navigator options patch. */
+export const mapTabBarOptions = (tabBar, resolvers) => {
+    const patch = {};
+    if (!tabBar)
+        return patch;
+    const style = {};
+    if (tabBar.visible !== undefined) {
+        style.display = tabBar.visible ? 'flex' : 'none';
+    }
+    const backgroundColor = resolvers.resolveColor(tabBar.backgroundColor);
+    if (backgroundColor)
+        style.backgroundColor = backgroundColor;
+    if (Object.keys(style).length)
+        patch.tabBarStyle = style;
+    const activeTintColor = resolvers.resolveColor(tabBar.activeTintColor);
+    if (activeTintColor)
+        patch.tabBarActiveTintColor = activeTintColor;
+    const inactiveTintColor = resolvers.resolveColor(tabBar.inactiveTintColor);
+    if (inactiveTintColor)
+        patch.tabBarInactiveTintColor = inactiveTintColor;
+    if (tabBar.labelVisible !== undefined) {
+        patch.tabBarShowLabel = tabBar.labelVisible;
+    }
+    if (tabBar.labelStyle) {
+        const labelStyle = {};
+        if (tabBar.labelStyle.fontFamily) {
+            labelStyle.fontFamily = tabBar.labelStyle.fontFamily;
+        }
+        if (tabBar.labelStyle.fontSize !== undefined) {
+            labelStyle.fontSize = tabBar.labelStyle.fontSize;
+        }
+        if (Object.keys(labelStyle).length)
+            patch.tabBarLabelStyle = labelStyle;
+    }
+    return patch;
+};
+//# sourceMappingURL=tabBarOptions.js.map

package/dist/mappers/tabBarOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabBarOptions.js","sourceRoot":"","sources":["../../src/mappers/tabBarOptions.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAiC,EACjC,SAAuB,EACH,EAAE;IACtB,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,MAAM,KAAK,GAAmD,EAAE,CAAC;IACjE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IACD,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvE,IAAI,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,eAAe,CAAC;IAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAEzD,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvE,IAAI,eAAe;QAAE,KAAK,CAAC,qBAAqB,GAAG,eAAe,CAAC;IAEnE,MAAM,iBAAiB,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC3E,IAAI,iBAAiB;QAAE,KAAK,CAAC,uBAAuB,GAAG,iBAAiB,CAAC;IAEzE,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,UAAU,GAAwD,EAAE,CAAC;QAC3E,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACjC,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;QACvD,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC7C,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QACnD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,gBAAgB,GAAG,UAAU,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/model.d.ts

@@ -0,0 +1,90 @@
+import { NavigationDocument, NavigatorNode, NavigatorType, RouteNode } from '@mapples/types';
+/**
+ * Build the navigator-qualified screen name for a route.
+ *
+ * Route names are unique only *within* a navigator (the validator allows two
+ * stacks to each own an `index` route), so a bare name like `index` is
+ * ambiguous as a `navigate` target. Navigator names are unique per document, so
+ * `<navigatorName>:<routeName>` is a stable, unambiguous screen name. This is
+ * the name registered with React Navigation and stored as the action target.
+ */
+export declare const qualifyRouteName: (navigatorName: string, routeName: string) => string;
+/** A screen within a {@link NavigatorModel}. */
+export interface ScreenModel {
+    /** Navigator-qualified screen name (`<navigatorName>:<routeName>`). */
+    routeName: string;
+    routeId: string;
+    route: RouteNode;
+    /** Page leaf, or a nested navigator already expanded into a child model. */
+    target: {
+        kind: 'page';
+        pageUuid: string;
+    } | {
+        kind: 'navigator';
+        child: NavigatorModel;
+    };
+}
+/** A fully-expanded navigator ready to be rendered. */
+export interface NavigatorModel {
+    id: string;
+    type: NavigatorType;
+    name: string;
+    node: NavigatorNode;
+    /** Resolved initial route name (defaults to the first screen). */
+    initialRouteName?: string;
+    screens: ScreenModel[];
+}
+/**
+ * Expand a {@link NavigationDocument} into a navigator tree by following
+ * `navigator` route targets from the root. Pure and side-effect free — it does
+ * not touch React Navigation, so it can be asserted on directly in tests.
+ *
+ * Assumes a validated document (see `validateNavigationDocument`); a missing or
+ * cyclic navigator reference simply stops that branch rather than throwing.
+ */
+export declare const buildNavigationModel: (document: NavigationDocument) => NavigatorModel | null;
+/**
+ * The navigator-qualified screen name of the first route (anywhere in the
+ * document) that targets a given page. Used to resolve `pageUuid` navigation
+ * targets to a screen name.
+ */
+export declare const findRouteNameForPage: (document: NavigationDocument, pageUuid: string) => string | null;
+/**
+ * Resolve a navigation target to the qualified screen name the runtime
+ * navigates to.
+ *
+ * - An exact `<navigator>:<route>` match is returned as-is.
+ * - A bare legacy route name (no navigator prefix) resolves to the first route
+ *   with that name, qualified, with a one-time warning — backward compatibility
+ *   for documents authored before targets were qualified.
+ *
+ * Returns `null` when nothing matches.
+ */
+export declare const resolveScreenName: (document: NavigationDocument, target: string) => string | null;
+/**
+ * The set of route ids nested beneath a tree node — every screen reachable
+ * under a navigator, or under a route that targets a navigator. The editor uses
+ * this to keep a parent node selected while the preview shows one of its
+ * descendant screens.
+ */
+export declare const collectDescendantRouteIds: (document: NavigationDocument, nodeId: string) => Set<string>;
+/** A React Navigation `navigate` call: a screen name plus optional nested params. */
+export interface ScreenNavigateTarget {
+    name: string;
+    params?: object;
+}
+/**
+ * Build the (possibly nested) navigate target for a qualified screen name.
+ *
+ * React Navigation can't reach a screen inside a nested navigator by a flat
+ * name — it descends via `navigate(parent, { screen, params })`. We walk the
+ * document from the root to the target route and nest the qualified screen
+ * names so the action lands in the right navigator. Returns `null` when the
+ * name resolves to no route.
+ *
+ * @example
+ * // screen "HomeStack:Feed" nested under the "Root:HomeTab" route →
+ * { name: 'Root:HomeTab', params: { screen: 'HomeStack:Feed', params: undefined } }
+ */
+export declare const buildScreenNavigateTarget: (document: NavigationDocument, screenName: string, params?: object) => ScreenNavigateTarget | null;
+//# sourceMappingURL=model.d.ts.map

package/dist/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,eAAe,MAAM,EACrB,WAAW,MAAM,KAChB,MAAyC,CAAC;AAE7C,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,4EAA4E;IAC5E,MAAM,EACF;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAClC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;CAClD;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,kBAAkB,KAC3B,cAAc,GAAG,IA+CnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,kBAAkB,EAC5B,UAAU,MAAM,KACf,MAAM,GAAG,IASX,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,kBAAkB,EAC5B,QAAQ,MAAM,KACb,MAAM,GAAG,IAuBX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,kBAAkB,EAC5B,QAAQ,MAAM,KACb,GAAG,CAAC,MAAM,CA8BZ,CAAC;AAEF,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwBD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,kBAAkB,EAC5B,YAAY,MAAM,EAClB,SAAS,MAAM,KACd,oBAAoB,GAAG,IAYzB,CAAC"}

package/dist/model.js

@@ -0,0 +1,189 @@
+/**
+ * Build the navigator-qualified screen name for a route.
+ *
+ * Route names are unique only *within* a navigator (the validator allows two
+ * stacks to each own an `index` route), so a bare name like `index` is
+ * ambiguous as a `navigate` target. Navigator names are unique per document, so
+ * `<navigatorName>:<routeName>` is a stable, unambiguous screen name. This is
+ * the name registered with React Navigation and stored as the action target.
+ */
+export const qualifyRouteName = (navigatorName, routeName) => `${navigatorName}:${routeName}`;
+/**
+ * Expand a {@link NavigationDocument} into a navigator tree by following
+ * `navigator` route targets from the root. Pure and side-effect free — it does
+ * not touch React Navigation, so it can be asserted on directly in tests.
+ *
+ * Assumes a validated document (see `validateNavigationDocument`); a missing or
+ * cyclic navigator reference simply stops that branch rather than throwing.
+ */
+export const buildNavigationModel = (document) => {
+    const build = (navigatorId, seen) => {
+        const node = document.navigators[navigatorId];
+        if (!node || seen.has(navigatorId))
+            return null;
+        const nextSeen = new Set(seen).add(navigatorId);
+        const screens = [];
+        for (const route of node.routes) {
+            const routeName = qualifyRouteName(node.name, route.name);
+            if (route.target.kind === 'page') {
+                screens.push({
+                    routeName,
+                    routeId: route.id,
+                    route,
+                    target: { kind: 'page', pageUuid: route.target.pageUuid },
+                });
+            }
+            else {
+                const child = build(route.target.navigatorId, nextSeen);
+                if (!child)
+                    continue;
+                screens.push({
+                    routeName,
+                    routeId: route.id,
+                    route,
+                    target: { kind: 'navigator', child },
+                });
+            }
+        }
+        const initialRouteName = screens.find((screen) => screen.routeId === node.initialRouteId)
+            ?.routeName ?? screens[0]?.routeName;
+        return {
+            id: node.id,
+            type: node.type,
+            name: node.name,
+            node,
+            screens,
+            initialRouteName,
+        };
+    };
+    return build(document.rootNavigatorId, new Set());
+};
+/**
+ * The navigator-qualified screen name of the first route (anywhere in the
+ * document) that targets a given page. Used to resolve `pageUuid` navigation
+ * targets to a screen name.
+ */
+export const findRouteNameForPage = (document, pageUuid) => {
+    for (const navigator of Object.values(document.navigators)) {
+        for (const route of navigator.routes) {
+            if (route.target.kind === 'page' && route.target.pageUuid === pageUuid) {
+                return qualifyRouteName(navigator.name, route.name);
+            }
+        }
+    }
+    return null;
+};
+/**
+ * Resolve a navigation target to the qualified screen name the runtime
+ * navigates to.
+ *
+ * - An exact `<navigator>:<route>` match is returned as-is.
+ * - A bare legacy route name (no navigator prefix) resolves to the first route
+ *   with that name, qualified, with a one-time warning — backward compatibility
+ *   for documents authored before targets were qualified.
+ *
+ * Returns `null` when nothing matches.
+ */
+export const resolveScreenName = (document, target) => {
+    let firstBareMatch = null;
+    for (const navigator of Object.values(document.navigators)) {
+        for (const route of navigator.routes) {
+            const qualified = qualifyRouteName(navigator.name, route.name);
+            if (qualified === target)
+                return qualified;
+            if (route.name === target && firstBareMatch === null) {
+                firstBareMatch = qualified;
+            }
+        }
+    }
+    if (firstBareMatch) {
+        console.warn(`[mapples-navigation] navigation target "${target}" is a bare route name ` +
+            `and was resolved to "${firstBareMatch}". Re-save the navigation ` +
+            `document to store the qualified "navigator:route" target.`);
+        return firstBareMatch;
+    }
+    return null;
+};
+/**
+ * The set of route ids nested beneath a tree node — every screen reachable
+ * under a navigator, or under a route that targets a navigator. The editor uses
+ * this to keep a parent node selected while the preview shows one of its
+ * descendant screens.
+ */
+export const collectDescendantRouteIds = (document, nodeId) => {
+    const result = new Set();
+    const collect = (navigatorId, seen) => {
+        const navigator = document.navigators[navigatorId];
+        if (!navigator || seen.has(navigatorId))
+            return;
+        const next = new Set(seen).add(navigatorId);
+        for (const route of navigator.routes) {
+            result.add(route.id);
+            if (route.target.kind === 'navigator') {
+                collect(route.target.navigatorId, next);
+            }
+        }
+    };
+    if (document.navigators[nodeId]) {
+        collect(nodeId, new Set());
+        return result;
+    }
+    for (const navigator of Object.values(document.navigators)) {
+        const route = navigator.routes.find((r) => r.id === nodeId);
+        if (route) {
+            if (route.target.kind === 'navigator') {
+                collect(route.target.navigatorId, new Set());
+            }
+            break;
+        }
+    }
+    return result;
+};
+/** Qualified screen names from the root navigator down to `screenName`. */
+const findScreenPath = (document, screenName) => {
+    const visit = (navigatorId, seen) => {
+        const navigator = document.navigators[navigatorId];
+        if (!navigator || seen.has(navigatorId))
+            return null;
+        const next = new Set(seen).add(navigatorId);
+        for (const route of navigator.routes) {
+            const qualified = qualifyRouteName(navigator.name, route.name);
+            if (qualified === screenName)
+                return [qualified];
+            if (route.target.kind === 'navigator') {
+                const sub = visit(route.target.navigatorId, next);
+                if (sub)
+                    return [qualified, ...sub];
+            }
+        }
+        return null;
+    };
+    return visit(document.rootNavigatorId, new Set());
+};
+/**
+ * Build the (possibly nested) navigate target for a qualified screen name.
+ *
+ * React Navigation can't reach a screen inside a nested navigator by a flat
+ * name — it descends via `navigate(parent, { screen, params })`. We walk the
+ * document from the root to the target route and nest the qualified screen
+ * names so the action lands in the right navigator. Returns `null` when the
+ * name resolves to no route.
+ *
+ * @example
+ * // screen "HomeStack:Feed" nested under the "Root:HomeTab" route →
+ * { name: 'Root:HomeTab', params: { screen: 'HomeStack:Feed', params: undefined } }
+ */
+export const buildScreenNavigateTarget = (document, screenName, params) => {
+    const names = findScreenPath(document, screenName);
+    if (!names)
+        return null;
+    let target = { name: names[names.length - 1], params };
+    for (let i = names.length - 2; i >= 0; i--) {
+        target = {
+            name: names[i],
+            params: { screen: target.name, params: target.params },
+        };
+    }
+    return target;
+};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"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"}

package/dist/refs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parsing for the shared `ref(assetType:uuid:name)` grammar (same grammar as
+ * `@mapples/render`'s `RefPropsMap`). Used to resolve `ref(theme:…)` colours and
+ * `ref(icon:…)` icons at render time.
+ */
+export interface ParsedRef {
+    type: string;
+    uuid: string;
+    name: string;
+}
+/** Parse a `ref(type:uuid:name)` string, or `null` if it isn't one. */
+export declare const parseRef: (value?: string) => ParsedRef | null;
+/** Whether a value is a `ref(...)` string (of `type`, if given). */
+export declare const isRef: (value?: string, type?: string) => boolean;
+//# sourceMappingURL=refs.d.ts.map

package/dist/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAID,uEAAuE;AACvE,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,KAAG,SAAS,GAAG,IAKrD,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,KAAG,OAGrD,CAAC"}

package/dist/refs.js

@@ -0,0 +1,21 @@
+/**
+ * Parsing for the shared `ref(assetType:uuid:name)` grammar (same grammar as
+ * `@mapples/render`'s `RefPropsMap`). Used to resolve `ref(theme:…)` colours and
+ * `ref(icon:…)` icons at render time.
+ */
+const REF_PATTERN = /^ref\(([^:]+):([^:]+):(.+)\)$/;
+/** Parse a `ref(type:uuid:name)` string, or `null` if it isn't one. */
+export const parseRef = (value) => {
+    if (!value)
+        return null;
+    const match = REF_PATTERN.exec(value);
+    if (!match)
+        return null;
+    return { type: match[1], uuid: match[2], name: match[3] };
+};
+/** Whether a value is a `ref(...)` string (of `type`, if given). */
+export const isRef = (value, type) => {
+    const parsed = parseRef(value);
+    return !!parsed && (!type || parsed.type === type);
+};
+//# sourceMappingURL=refs.js.map

package/dist/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../src/refs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAEpD,uEAAuE;AACvE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoB,EAAE;IAC3D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAE,IAAa,EAAW,EAAE;IAC9D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+import { ComponentType, ReactNode } from 'react';
+import { NavigationDocument } from '@mapples/types';
+/** Renders an icon for a tab/drawer item, given the runtime colour/size. */
+export type IconRenderer = (props: {
+    color?: string;
+    size?: number;
+}) => ReactNode;
+/**
+ * Resolves `ref(…)` option values to concrete runtime values. Supplied by the
+ * host (from `@mapples/style` + `@mapples/render` contexts); stubbed in tests.
+ */
+export interface RefResolvers {
+    /** Resolve a colour value or `ref(theme:…)` to a concrete colour. */
+    resolveColor: (value?: string) => string | undefined;
+    /** Resolve `ref(icon:…)` to an icon renderer. */
+    resolveIcon: (value?: string) => IconRenderer | undefined;
+}
+/** Subset of native-stack header options the runtime sets. */
+export interface StackHeaderOptionsPatch {
+    headerShown?: boolean;
+    title?: string;
+    headerStyle?: {
+        backgroundColor?: string;
+    };
+    headerTintColor?: string;
+    headerTitleStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+        color?: string;
+    };
+    headerBackVisible?: boolean;
+    headerShadowVisible?: boolean;
+}
+/** Per-route native-stack options (header overrides + presentation). */
+export interface StackScreenOptionsPatch extends StackHeaderOptionsPatch {
+    presentation?: 'card' | 'modal' | 'transparentModal';
+}
+/** Subset of bottom-tabs navigator options the runtime sets. */
+export interface TabBarOptionsPatch {
+    tabBarStyle?: {
+        display?: 'flex' | 'none';
+        backgroundColor?: string;
+    };
+    tabBarActiveTintColor?: string;
+    tabBarInactiveTintColor?: string;
+    tabBarShowLabel?: boolean;
+    tabBarLabelStyle?: {
+        fontFamily?: string;
+        fontSize?: number;
+    };
+}
+/** Per-route bottom-tabs item options. */
+export interface TabItemOptionsPatch {
+    tabBarLabel?: string;
+    tabBarIcon?: IconRenderer;
+}
+/** Subset of drawer navigator options the runtime sets. */
+export interface DrawerOptionsPatch {
+    drawerPosition?: 'left' | 'right';
+    drawerType?: 'front' | 'back' | 'slide';
+    drawerStyle?: {
+        backgroundColor?: string;
+        width?: number;
+    };
+    drawerActiveTintColor?: string;
+    drawerInactiveTintColor?: string;
+}
+/** Per-route drawer item options. */
+export interface DrawerItemOptionsPatch {
+    drawerLabel?: string;
+    drawerIcon?: IconRenderer;
+}
+/** A resolved navigation intent, applied to the navigation container ref. */
+export type NavigationCommand = {
+    kind: 'navigate';
+    routeName: string;
+    params?: Record<string, unknown>;
+} | {
+    kind: 'goBack';
+} | {
+    kind: 'openDrawer';
+} | {
+    kind: 'closeDrawer';
+} | {
+    kind: 'switchTab';
+    routeName: string;
+};
+/**
+ * Structural subset of React Navigation's container ref the runtime uses.
+ * Typed here (rather than importing `@react-navigation/native`) so this module
+ * stays free of the React Navigation dependency. A real
+ * `NavigationContainerRef` satisfies it.
+ */
+export interface MapplesNavigationRef {
+    isReady: () => boolean;
+    canGoBack: () => boolean;
+    goBack: () => void;
+    navigate: (name: string, params?: object) => void;
+    dispatch: (action: unknown) => void;
+    getCurrentRoute: () => {
+        name: string;
+    } | undefined;
+    addListener: (type: string, callback: (...args: unknown[]) => void) => () => void;
+}
+/** Props for {@link MapplesNavigation}. */
+export interface MapplesNavigationProps {
+    document: NavigationDocument;
+    /** pageUuid → component rendered for that page. */
+    pages: Record<string, ComponentType<Record<string, unknown>>>;
+    /** Rendered when a route references a missing page. */
+    fallback?: ComponentType<{
+        pageUuid: string;
+    }>;
+    /**
+     * Render inside `NavigationIndependentTree` instead of a `NavigationContainer`
+     * — required when the host app already owns a container (expo-router / Creator).
+     */
+    independent?: boolean;
+    /**
+     * Externally-created container ref. Supply one to observe/drive navigation
+     * from the host (e.g. the Creator preview's selection sync). When omitted, an
+     * internal ref is created.
+     */
+    navigationRef?: MapplesNavigationRef;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/useRefResolvers.d.ts

@@ -0,0 +1,10 @@
+import { RefResolvers } from './types';
+/**
+ * Builds {@link RefResolvers} from the host's style + render contexts:
+ * `ref(theme:…)` resolves against `@mapples/style`'s active theme, `ref(icon:…)`
+ * against `@mapples/render`'s assets map. Unresolvable refs warn and fall back to
+ * a default rather than crashing.
+ */
+declare const useRefResolvers: () => RefResolvers;
+export default useRefResolvers;
+//# sourceMappingURL=useRefResolvers.d.ts.map

package/dist/useRefResolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefResolvers.d.ts","sourceRoot":"","sources":["../src/useRefResolvers.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAgB,YAAY,EAAE,MAAM,SAAS,CAAC;AAYrD;;;;;GAKG;AACH,QAAA,MAAM,eAAe,QAAO,YA8C3B,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/useRefResolvers.js

@@ -0,0 +1,64 @@
+import { createElement } from 'react';
+import { useRender } from '@mapples/render';
+import { useTheme } from '@mapples/style';
+import { Image } from 'react-native';
+import { parseRef } from './refs';
+/** Resolve a dot-path (e.g. `primary.main`) against the active theme map. */
+const lookupToken = (map, path) => {
+    let current = map;
+    for (const key of path.split('.')) {
+        if (current == null || typeof current === 'string')
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === 'string' ? current : undefined;
+};
+/**
+ * Builds {@link RefResolvers} from the host's style + render contexts:
+ * `ref(theme:…)` resolves against `@mapples/style`'s active theme, `ref(icon:…)`
+ * against `@mapples/render`'s assets map. Unresolvable refs warn and fall back to
+ * a default rather than crashing.
+ */
+const useRefResolvers = () => {
+    const { theme, themeConfig } = useTheme();
+    const { assets } = useRender();
+    const resolveColor = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = parseRef(value);
+        if (!parsed)
+            return value; // already a concrete colour value
+        if (parsed.type !== 'theme')
+            return undefined;
+        const resolved = lookupToken(theme, parsed.name);
+        if (resolved)
+            return resolved;
+        console.warn(`[@mapples/navigation] unresolved theme ref: ${value}`);
+        return themeConfig.defaultColor;
+    };
+    const resolveIcon = (value) => {
+        if (!value)
+            return undefined;
+        const parsed = parseRef(value);
+        if (!parsed || parsed.type !== 'icon')
+            return undefined;
+        const asset = assets[value];
+        if (asset == null) {
+            console.warn(`[@mapples/navigation] unresolved icon ref: ${value}`);
+            return undefined;
+        }
+        const source = typeof asset === 'string'
+            ? { uri: asset }
+            : asset;
+        // The returned value is a React Navigation icon option callback, not a
+        // component, so it needs no display name.
+        // eslint-disable-next-line react/display-name
+        return ({ size }) => createElement(Image, {
+            source,
+            style: { width: size ?? 24, height: size ?? 24 },
+        });
+    };
+    return { resolveColor, resolveIcon };
+};
+export default useRefResolvers;
+//# sourceMappingURL=useRefResolvers.js.map