@ankhorage/expo-runtime 0.0.5 → 0.0.7

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/expo-runtime
 
+## 0.0.7
+
+### Patch Changes
+
+- 7eddf62: Add generated layout helper output for Expo provider imports.
+
+## 0.0.6
+
+### Patch Changes
+
+- 5f947ed: Add Expo-aware runtime action bridge helpers for navigation, theme toggling, logging, alerts, and delegated action handlers.
+
 ## 0.0.5
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # EXPO-RUNTIME
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v0.0.3](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.0.5](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Declarative runtime integration for Expo apps: maps app capabilities to permissions, packages, config plugins, providers, and adapters
 
@@ -16,5 +16,6 @@ Declarative runtime integration for Expo apps: maps app capabilities to permissi
 - [Module relationships](././paradox/diagrams/module-relationships.mmd)
 - [Export graph](././paradox/diagrams/export-graph.mmd)
 - [createExpoRuntimeRegistry sequence](././paradox/diagrams/sequences/create-expo-runtime-registry.mmd)
+- [executeExpoRuntimeAction sequence](././paradox/diagrams/sequences/execute-expo-runtime-action.mmd)
 - [ExpoBarcodeScannerAdapter sequence](././paradox/diagrams/sequences/expo-barcode-scanner-adapter.mmd)
 - [resolveExpoRuntimePlan sequence](././paradox/diagrams/sequences/resolve-expo-runtime-plan.mmd)

package/dist/expoActionBridge.d.ts

@@ -0,0 +1,29 @@
+import type { Action } from '@ankhorage/contracts';
+export type ExpoRuntimeThemeMode = 'dark' | 'light';
+export interface ExpoRuntimeRouterLike {
+    push: (args: {
+        pathname: string;
+        params: Record<string, number | string>;
+    }) => void;
+}
+export interface ExpoRuntimeActionHandlerArgs {
+    action: Action;
+}
+export type ExpoRuntimeActionHandlers = Record<string, (args: ExpoRuntimeActionHandlerArgs) => Promise<void> | void>;
+export interface ExecuteExpoRuntimeActionArgs {
+    action: unknown;
+    router: ExpoRuntimeRouterLike;
+    mode: ExpoRuntimeThemeMode;
+    setMode: (mode: ExpoRuntimeThemeMode) => void;
+    actionHandlers?: ExpoRuntimeActionHandlers;
+    requestAnimationFrameImpl?: (callback: () => void) => number | void;
+    alertImpl?: (message: string) => void;
+    consoleImpl?: Pick<typeof console, 'log'>;
+}
+export interface ExpoRuntimeRouteResolution {
+    resolvedPath: string;
+    unusedParams: Record<string, number | string>;
+}
+export declare function resolveExpoRuntimeRoutePath(pathname: string, params?: Record<string, number | string>): ExpoRuntimeRouteResolution;
+export declare function executeExpoRuntimeAction(args: ExecuteExpoRuntimeActionArgs): Promise<void>;
+//# sourceMappingURL=expoActionBridge.d.ts.map

package/dist/expoActionBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expoActionBridge.d.ts","sourceRoot":"","sources":["../src/expoActionBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAC5C,MAAM,EACN,CAAC,IAAI,EAAE,4BAA4B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAC7D,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,yBAAyB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IACpE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,WAAW,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,KAAK,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC/C;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,0BAA0B,CAmB5B;AAUD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CA0EhG"}

package/dist/expoActionBridge.js

@@ -0,0 +1,78 @@
+export function resolveExpoRuntimeRoutePath(pathname, params) {
+    if (!params) {
+        return { resolvedPath: pathname, unusedParams: {} };
+    }
+    let resolvedPath = pathname;
+    const unusedParams = { ...params };
+    Object.keys(params).forEach((key) => {
+        const placeholder = `[${key}]`;
+        if (!resolvedPath.includes(placeholder)) {
+            return;
+        }
+        resolvedPath = resolvedPath.replace(placeholder, String(params[key]));
+        delete unusedParams[key];
+    });
+    return { resolvedPath, unusedParams };
+}
+function isAction(value) {
+    return typeof value === 'object' && value !== null && 'type' in value;
+}
+function isActionCallback(value) {
+    return typeof value === 'function';
+}
+export async function executeExpoRuntimeAction(args) {
+    const { action, router, mode, setMode, actionHandlers, requestAnimationFrameImpl = (callback) => {
+        callback();
+    }, alertImpl, consoleImpl = console, } = args;
+    if (!action) {
+        return;
+    }
+    if (isActionCallback(action)) {
+        action();
+        return;
+    }
+    if (!isAction(action)) {
+        return;
+    }
+    if (action.type === 'navigate' && action.payload.route) {
+        const { route, params } = action.payload;
+        requestAnimationFrameImpl(() => {
+            let pathname = route;
+            if (!pathname.startsWith('/') && !pathname.startsWith('(')) {
+                pathname = `/${pathname}`;
+            }
+            const { resolvedPath, unusedParams } = resolveExpoRuntimeRoutePath(pathname, params);
+            router.push({
+                pathname: resolvedPath,
+                params: unusedParams,
+            });
+        });
+        return;
+    }
+    if (action.type === 'toggleDarkMode') {
+        setMode(mode === 'dark' ? 'light' : 'dark');
+        return;
+    }
+    if (action.type === 'search') {
+        consoleImpl.log('[Ankh Action] Search:', action.payload);
+        return;
+    }
+    if (action.type === 'filter') {
+        consoleImpl.log('[Ankh Action] Filter:', action.payload);
+        return;
+    }
+    if (action.type === 'alert') {
+        const message = action.payload?.message ?? JSON.stringify(action.payload);
+        alertImpl?.(message);
+        return;
+    }
+    if (action.type === 'console') {
+        consoleImpl.log('[Ankh Action]', action.payload);
+        return;
+    }
+    const configuredHandler = actionHandlers?.[action.type];
+    if (configuredHandler) {
+        await configuredHandler({ action });
+    }
+}
+//# sourceMappingURL=expoActionBridge.js.map

package/dist/expoActionBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expoActionBridge.js","sourceRoot":"","sources":["../src/expoActionBridge.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Action } from '@ankhorage/contracts';\n\nexport type ExpoRuntimeThemeMode = 'dark' | 'light';\n\nexport interface ExpoRuntimeRouterLike {\n  push: (args: { pathname: string; params: Record<string, number | string> }) => void;\n}\n\nexport interface ExpoRuntimeActionHandlerArgs {\n  action: Action;\n}\n\nexport type ExpoRuntimeActionHandlers = Record<\n  string,\n  (args: ExpoRuntimeActionHandlerArgs) => Promise<void> | void\n>;\n\nexport interface ExecuteExpoRuntimeActionArgs {\n  action: unknown;\n  router: ExpoRuntimeRouterLike;\n  mode: ExpoRuntimeThemeMode;\n  setMode: (mode: ExpoRuntimeThemeMode) => void;\n  actionHandlers?: ExpoRuntimeActionHandlers;\n  requestAnimationFrameImpl?: (callback: () => void) => number | void;\n  alertImpl?: (message: string) => void;\n  consoleImpl?: Pick<typeof console, 'log'>;\n}\n\nexport interface ExpoRuntimeRouteResolution {\n  resolvedPath: string;\n  unusedParams: Record<string, number | string>;\n}\n\nexport function resolveExpoRuntimeRoutePath(\n  pathname: string,\n  params?: Record<string, number | string>,\n): ExpoRuntimeRouteResolution {\n  if (!params) {\n    return { resolvedPath: pathname, unusedParams: {} };\n  }\n\n  let resolvedPath = pathname;\n  const unusedParams: Record<string, number | string> = { ...params };\n\n  Object.keys(params).forEach((key) => {\n    const placeholder = `[${key}]`;\n    if (!resolvedPath.includes(placeholder)) {\n      return;\n    }\n\n    resolvedPath = resolvedPath.replace(placeholder, String(params[key]));\n    delete unusedParams[key];\n  });\n\n  return { resolvedPath, unusedParams };\n}\n\nfunction isAction(value: unknown): value is Action {\n  return typeof value === 'object' && value !== null && 'type' in value;\n}\n\nfunction isActionCallback(value: unknown): value is () => void {\n  return typeof value === 'function';\n}\n\nexport async function executeExpoRuntimeAction(args: ExecuteExpoRuntimeActionArgs): Promise<void> {\n  const {\n    action,\n    router,\n    mode,\n    setMode,\n    actionHandlers,\n    requestAnimationFrameImpl = (callback) => {\n      callback();\n    },\n    alertImpl,\n    consoleImpl = console,\n  } = args;\n\n  if (!action) {\n    return;\n  }\n\n  if (isActionCallback(action)) {\n    action();\n    return;\n  }\n\n  if (!isAction(action)) {\n    return;\n  }\n\n  if (action.type === 'navigate' && action.payload.route) {\n    const { route, params } = action.payload;\n    requestAnimationFrameImpl(() => {\n      let pathname = route;\n      if (!pathname.startsWith('/') && !pathname.startsWith('(')) {\n        pathname = `/${pathname}`;\n      }\n\n      const { resolvedPath, unusedParams } = resolveExpoRuntimeRoutePath(pathname, params);\n      router.push({\n        pathname: resolvedPath,\n        params: unusedParams,\n      });\n    });\n    return;\n  }\n\n  if (action.type === 'toggleDarkMode') {\n    setMode(mode === 'dark' ? 'light' : 'dark');\n    return;\n  }\n\n  if (action.type === 'search') {\n    consoleImpl.log('[Ankh Action] Search:', action.payload);\n    return;\n  }\n\n  if (action.type === 'filter') {\n    consoleImpl.log('[Ankh Action] Filter:', action.payload);\n    return;\n  }\n\n  if (action.type === 'alert') {\n    const message = action.payload?.message ?? JSON.stringify(action.payload);\n    alertImpl?.(message);\n    return;\n  }\n\n  if (action.type === 'console') {\n    consoleImpl.log('[Ankh Action]', action.payload);\n    return;\n  }\n\n  const configuredHandler = actionHandlers?.[action.type];\n  if (configuredHandler) {\n    await configuredHandler({ action });\n  }\n}\n"]}

package/dist/index.d.ts

@@ -2,9 +2,11 @@ export { BARCODE_SCAN_DEDUPE_WINDOW_MS, BARCODE_SCANNER_TYPES, type BarcodeScanR
 export type { ComponentRegistry } from './componentRegistry';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';
+export { executeExpoRuntimeAction, type ExecuteExpoRuntimeActionArgs, type ExpoRuntimeActionHandlerArgs, type ExpoRuntimeActionHandlers, type ExpoRuntimeRouteResolution, type ExpoRuntimeRouterLike, type ExpoRuntimeThemeMode, resolveExpoRuntimeRoutePath, } from './expoActionBridge';
 export { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
 export { ExpoRuntimeProviders, type ExpoRuntimeProvidersProps } from './ExpoRuntimeProviders';
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export { type ExpoRuntimeLayoutIntegrationPlan, resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
 export type { ExpoRuntimeAdapterId, ExpoRuntimePlan, ExpoRuntimeProviderId, } from './resolveExpoRuntimePlan';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,2CAA2C,EAC3C,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,2CAA2C,EAC3C,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,KAAK,gCAAgC,EACrC,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,8 +1,10 @@
 export { BARCODE_SCAN_DEDUPE_WINDOW_MS, BARCODE_SCANNER_TYPES, mapPermissionStatusToCameraPermissionStatus, normalizeExpoBarcodeScanResult, shouldIgnoreBarcodeScan, } from './barcodeScanRuntime';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';
+export { executeExpoRuntimeAction, resolveExpoRuntimeRoutePath, } from './expoActionBridge';
 export { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
 export { ExpoRuntimeProviders } from './ExpoRuntimeProviders';
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export { resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EAGrB,2CAA2C,EAC3C,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAkC,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAMrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export {\n  BARCODE_SCAN_DEDUPE_WINDOW_MS,\n  BARCODE_SCANNER_TYPES,\n  type BarcodeScanRecord,\n  type ExpoBarcodeScanResultLike,\n  mapPermissionStatusToCameraPermissionStatus,\n  normalizeExpoBarcodeScanResult,\n  shouldIgnoreBarcodeScan,\n} from './barcodeScanRuntime';\nexport type { ComponentRegistry } from './componentRegistry';\nexport { createComponentRegistry } from './componentRegistry';\nexport { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';\nexport { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';\nexport { ExpoRuntimeProviders, type ExpoRuntimeProvidersProps } from './ExpoRuntimeProviders';\nexport { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EAGrB,2CAA2C,EAC3C,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,wBAAwB,EAOxB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAkC,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAEL,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export {\n  BARCODE_SCAN_DEDUPE_WINDOW_MS,\n  BARCODE_SCANNER_TYPES,\n  type BarcodeScanRecord,\n  type ExpoBarcodeScanResultLike,\n  mapPermissionStatusToCameraPermissionStatus,\n  normalizeExpoBarcodeScanResult,\n  shouldIgnoreBarcodeScan,\n} from './barcodeScanRuntime';\nexport type { ComponentRegistry } from './componentRegistry';\nexport { createComponentRegistry } from './componentRegistry';\nexport { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';\nexport {\n  executeExpoRuntimeAction,\n  type ExecuteExpoRuntimeActionArgs,\n  type ExpoRuntimeActionHandlerArgs,\n  type ExpoRuntimeActionHandlers,\n  type ExpoRuntimeRouteResolution,\n  type ExpoRuntimeRouterLike,\n  type ExpoRuntimeThemeMode,\n  resolveExpoRuntimeRoutePath,\n} from './expoActionBridge';\nexport { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';\nexport { ExpoRuntimeProviders, type ExpoRuntimeProvidersProps } from './ExpoRuntimeProviders';\nexport { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport {\n  type ExpoRuntimeLayoutIntegrationPlan,\n  resolveExpoRuntimeLayoutIntegration,\n} from './layoutIntegrationPlanning';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}

package/dist/layoutIntegrationPlanning.d.ts

@@ -0,0 +1,9 @@
+import type { ExpoRuntimePlan } from './resolveExpoRuntimePlan';
+export interface ExpoRuntimeLayoutIntegrationPlan {
+    readonly imports: readonly string[];
+    readonly moduleDeclarations: readonly string[];
+    readonly providerStart: readonly string[];
+    readonly providerEnd: readonly string[];
+}
+export declare function resolveExpoRuntimeLayoutIntegration(runtimePlan: ExpoRuntimePlan | undefined): ExpoRuntimeLayoutIntegrationPlan;
+//# sourceMappingURL=layoutIntegrationPlanning.d.ts.map

package/dist/layoutIntegrationPlanning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutIntegrationPlanning.d.ts","sourceRoot":"","sources":["../src/layoutIntegrationPlanning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,eAAe,GAAG,SAAS,GACvC,gCAAgC,CA2BlC"}

package/dist/layoutIntegrationPlanning.js

@@ -0,0 +1,22 @@
+export function resolveExpoRuntimeLayoutIntegration(runtimePlan) {
+    const imports = [];
+    const expoRuntimeImports = [];
+    const moduleDeclarations = [];
+    const providerStart = [];
+    const providerEnd = [];
+    if ((runtimePlan?.providers.length ?? 0) > 0) {
+        expoRuntimeImports.push('ExpoRuntimeProviders');
+        providerStart.push(`<ExpoRuntimeProviders providers={['${(runtimePlan?.providers ?? []).join("', '")}']}>`);
+        providerEnd.push('</ExpoRuntimeProviders>');
+    }
+    if (expoRuntimeImports.length > 0) {
+        imports.push(`import { ${Array.from(new Set(expoRuntimeImports)).join(', ')} } from '@ankhorage/expo-runtime';`);
+    }
+    return {
+        imports,
+        moduleDeclarations,
+        providerStart,
+        providerEnd,
+    };
+}
+//# sourceMappingURL=layoutIntegrationPlanning.js.map

package/dist/layoutIntegrationPlanning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutIntegrationPlanning.js","sourceRoot":"","sources":["../src/layoutIntegrationPlanning.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,mCAAmC,CACjD,WAAwC;IAExC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IACxC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,kBAAkB,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAChD,aAAa,CAAC,IAAI,CAChB,sCAAsC,CAAC,WAAW,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CACxF,CAAC;QACF,WAAW,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CACV,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CACnG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,kBAAkB;QAClB,aAAa;QACb,WAAW;KACZ,CAAC;AACJ,CAAC","sourcesContent":["import type { ExpoRuntimePlan } from './resolveExpoRuntimePlan';\n\nexport interface ExpoRuntimeLayoutIntegrationPlan {\n  readonly imports: readonly string[];\n  readonly moduleDeclarations: readonly string[];\n  readonly providerStart: readonly string[];\n  readonly providerEnd: readonly string[];\n}\n\nexport function resolveExpoRuntimeLayoutIntegration(\n  runtimePlan: ExpoRuntimePlan | undefined,\n): ExpoRuntimeLayoutIntegrationPlan {\n  const imports: string[] = [];\n  const expoRuntimeImports: string[] = [];\n  const moduleDeclarations: string[] = [];\n  const providerStart: string[] = [];\n  const providerEnd: string[] = [];\n\n  if ((runtimePlan?.providers.length ?? 0) > 0) {\n    expoRuntimeImports.push('ExpoRuntimeProviders');\n    providerStart.push(\n      `<ExpoRuntimeProviders providers={['${(runtimePlan?.providers ?? []).join(\"', '\")}']}>`,\n    );\n    providerEnd.push('</ExpoRuntimeProviders>');\n  }\n\n  if (expoRuntimeImports.length > 0) {\n    imports.push(\n      `import { ${Array.from(new Set(expoRuntimeImports)).join(', ')} } from '@ankhorage/expo-runtime';`,\n    );\n  }\n\n  return {\n    imports,\n    moduleDeclarations,\n    providerStart,\n    providerEnd,\n  };\n}\n"]}

package/dist/planning.d.ts

@@ -1,4 +1,5 @@
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export { type ExpoRuntimeLayoutIntegrationPlan, resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
 export type { ExpoRuntimeAdapterId, ExpoRuntimePlan, ExpoRuntimeProviderId, } from './resolveExpoRuntimePlan';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=planning.d.ts.map

package/dist/planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"planning.d.ts","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,KAAK,gCAAgC,EACrC,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/planning.js

@@ -1,3 +1,4 @@
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export { resolveExpoRuntimeLayoutIntegration, } from './layoutIntegrationPlanning';
 export { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';
 //# sourceMappingURL=planning.js.map

package/dist/planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAMrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../src/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAEL,mCAAmC,GACpC,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { getExpoBarcodeScannerViewSource } from './generatedSources';\nexport {\n  type ExpoRuntimeLayoutIntegrationPlan,\n  resolveExpoRuntimeLayoutIntegration,\n} from './layoutIntegrationPlanning';\nexport type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Declarative runtime integration for Expo apps: maps app capabilities to permissions, packages, config plugins, providers, and adapters",
   "homepage": "https://github.com/ankhorage/expo-runtime#readme",
   "bugs": {

package/src/expoActionBridge.test.ts

@@ -0,0 +1,54 @@
+import { describe, expect, test } from 'bun:test';
+
+import { executeExpoRuntimeAction, resolveExpoRuntimeRoutePath } from './expoActionBridge';
+
+describe('expoActionBridge', () => {
+  test('resolves dynamic route params and keeps unused params', () => {
+    expect(resolveExpoRuntimeRoutePath('/users/[id]', { id: 42, tab: 'profile' })).toEqual({
+      resolvedPath: '/users/42',
+      unusedParams: { tab: 'profile' },
+    });
+  });
+
+  test('executes navigation actions', async () => {
+    const pushes: { pathname: string; params: Record<string, number | string> }[] = [];
+
+    await executeExpoRuntimeAction({
+      action: { type: 'navigate', payload: { route: 'users/[id]', params: { id: 42 } } },
+      router: { push: (args) => pushes.push(args) },
+      mode: 'dark',
+      setMode: () => undefined,
+    });
+
+    expect(pushes).toEqual([{ pathname: '/users/42', params: {} }]);
+  });
+
+  test('toggles dark mode', async () => {
+    const modes: string[] = [];
+
+    await executeExpoRuntimeAction({
+      action: { type: 'toggleDarkMode' },
+      router: { push: () => undefined },
+      mode: 'dark',
+      setMode: (mode) => modes.push(mode),
+    });
+
+    expect(modes).toEqual(['light']);
+  });
+
+  test('delegates configured actions', async () => {
+    const calls: string[] = [];
+
+    await executeExpoRuntimeAction({
+      action: { type: 'setLanguage', payload: { locale: 'de' } },
+      router: { push: () => undefined },
+      mode: 'dark',
+      setMode: () => undefined,
+      actionHandlers: {
+        setLanguage: ({ action }) => calls.push(action.type),
+      },
+    });
+
+    expect(calls).toEqual(['setLanguage']);
+  });
+});

package/src/expoActionBridge.ts

@@ -0,0 +1,140 @@
+import type { Action } from '@ankhorage/contracts';
+
+export type ExpoRuntimeThemeMode = 'dark' | 'light';
+
+export interface ExpoRuntimeRouterLike {
+  push: (args: { pathname: string; params: Record<string, number | string> }) => void;
+}
+
+export interface ExpoRuntimeActionHandlerArgs {
+  action: Action;
+}
+
+export type ExpoRuntimeActionHandlers = Record<
+  string,
+  (args: ExpoRuntimeActionHandlerArgs) => Promise<void> | void
+>;
+
+export interface ExecuteExpoRuntimeActionArgs {
+  action: unknown;
+  router: ExpoRuntimeRouterLike;
+  mode: ExpoRuntimeThemeMode;
+  setMode: (mode: ExpoRuntimeThemeMode) => void;
+  actionHandlers?: ExpoRuntimeActionHandlers;
+  requestAnimationFrameImpl?: (callback: () => void) => number | void;
+  alertImpl?: (message: string) => void;
+  consoleImpl?: Pick<typeof console, 'log'>;
+}
+
+export interface ExpoRuntimeRouteResolution {
+  resolvedPath: string;
+  unusedParams: Record<string, number | string>;
+}
+
+export function resolveExpoRuntimeRoutePath(
+  pathname: string,
+  params?: Record<string, number | string>,
+): ExpoRuntimeRouteResolution {
+  if (!params) {
+    return { resolvedPath: pathname, unusedParams: {} };
+  }
+
+  let resolvedPath = pathname;
+  const unusedParams: Record<string, number | string> = { ...params };
+
+  Object.keys(params).forEach((key) => {
+    const placeholder = `[${key}]`;
+    if (!resolvedPath.includes(placeholder)) {
+      return;
+    }
+
+    resolvedPath = resolvedPath.replace(placeholder, String(params[key]));
+    delete unusedParams[key];
+  });
+
+  return { resolvedPath, unusedParams };
+}
+
+function isAction(value: unknown): value is Action {
+  return typeof value === 'object' && value !== null && 'type' in value;
+}
+
+function isActionCallback(value: unknown): value is () => void {
+  return typeof value === 'function';
+}
+
+export async function executeExpoRuntimeAction(args: ExecuteExpoRuntimeActionArgs): Promise<void> {
+  const {
+    action,
+    router,
+    mode,
+    setMode,
+    actionHandlers,
+    requestAnimationFrameImpl = (callback) => {
+      callback();
+    },
+    alertImpl,
+    consoleImpl = console,
+  } = args;
+
+  if (!action) {
+    return;
+  }
+
+  if (isActionCallback(action)) {
+    action();
+    return;
+  }
+
+  if (!isAction(action)) {
+    return;
+  }
+
+  if (action.type === 'navigate' && action.payload.route) {
+    const { route, params } = action.payload;
+    requestAnimationFrameImpl(() => {
+      let pathname = route;
+      if (!pathname.startsWith('/') && !pathname.startsWith('(')) {
+        pathname = `/${pathname}`;
+      }
+
+      const { resolvedPath, unusedParams } = resolveExpoRuntimeRoutePath(pathname, params);
+      router.push({
+        pathname: resolvedPath,
+        params: unusedParams,
+      });
+    });
+    return;
+  }
+
+  if (action.type === 'toggleDarkMode') {
+    setMode(mode === 'dark' ? 'light' : 'dark');
+    return;
+  }
+
+  if (action.type === 'search') {
+    consoleImpl.log('[Ankh Action] Search:', action.payload);
+    return;
+  }
+
+  if (action.type === 'filter') {
+    consoleImpl.log('[Ankh Action] Filter:', action.payload);
+    return;
+  }
+
+  if (action.type === 'alert') {
+    const message = action.payload?.message ?? JSON.stringify(action.payload);
+    alertImpl?.(message);
+    return;
+  }
+
+  if (action.type === 'console') {
+    consoleImpl.log('[Ankh Action]', action.payload);
+    return;
+  }
+
+  const configuredHandler = actionHandlers?.[action.type];
+  if (configuredHandler) {
+    await configuredHandler({ action });
+  }
+}

package/src/index.ts

@@ -10,9 +10,23 @@ export {
 export type { ComponentRegistry } from './componentRegistry';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';
+export {
+  executeExpoRuntimeAction,
+  type ExecuteExpoRuntimeActionArgs,
+  type ExpoRuntimeActionHandlerArgs,
+  type ExpoRuntimeActionHandlers,
+  type ExpoRuntimeRouteResolution,
+  type ExpoRuntimeRouterLike,
+  type ExpoRuntimeThemeMode,
+  resolveExpoRuntimeRoutePath,
+} from './expoActionBridge';
 export { ExpoBarcodeScannerAdapter } from './ExpoBarcodeScannerAdapter';
 export { ExpoRuntimeProviders, type ExpoRuntimeProvidersProps } from './ExpoRuntimeProviders';
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export {
+  type ExpoRuntimeLayoutIntegrationPlan,
+  resolveExpoRuntimeLayoutIntegration,
+} from './layoutIntegrationPlanning';
 export type {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,

package/src/layoutIntegrationPlanning.test.ts

@@ -0,0 +1,55 @@
+import { describe, expect, test } from 'bun:test';
+
+import { resolveExpoRuntimeLayoutIntegration } from './layoutIntegrationPlanning';
+import type { ExpoRuntimePlan } from './resolveExpoRuntimePlan';
+
+const EMPTY_PLAN: ExpoRuntimePlan = {
+  permissions: [],
+  capabilities: [],
+  impliedPermissions: [],
+  dependencies: [],
+  nativeConfig: {
+    androidPermissions: [],
+    configHints: [],
+    plugins: [],
+  },
+  providers: [],
+  runtimeAdapters: [],
+  usesExpoRuntimeRegistry: false,
+  needsPermissionsProvider: false,
+  diagnostics: [],
+};
+
+const PERMISSIONS_PROVIDER_START = "<ExpoRuntimeProviders providers={['permissions']}>";
+
+describe('layoutIntegrationPlanning', () => {
+  test('returns an empty integration plan when no providers are required', () => {
+    expect(resolveExpoRuntimeLayoutIntegration(undefined)).toEqual({
+      imports: [],
+      moduleDeclarations: [],
+      providerStart: [],
+      providerEnd: [],
+    });
+    expect(resolveExpoRuntimeLayoutIntegration(EMPTY_PLAN)).toEqual({
+      imports: [],
+      moduleDeclarations: [],
+      providerStart: [],
+      providerEnd: [],
+    });
+  });
+
+  test('adds ExpoRuntimeProviders import and wrapper when providers are required', () => {
+    expect(
+      resolveExpoRuntimeLayoutIntegration({
+        ...EMPTY_PLAN,
+        providers: ['permissions'],
+        needsPermissionsProvider: true,
+      }),
+    ).toEqual({
+      imports: ["import { ExpoRuntimeProviders } from '@ankhorage/expo-runtime';"],
+      moduleDeclarations: [],
+      providerStart: [PERMISSIONS_PROVIDER_START],
+      providerEnd: ['</ExpoRuntimeProviders>'],
+    });
+  });
+});

package/src/layoutIntegrationPlanning.ts

@@ -0,0 +1,39 @@
+import type { ExpoRuntimePlan } from './resolveExpoRuntimePlan';
+
+export interface ExpoRuntimeLayoutIntegrationPlan {
+  readonly imports: readonly string[];
+  readonly moduleDeclarations: readonly string[];
+  readonly providerStart: readonly string[];
+  readonly providerEnd: readonly string[];
+}
+
+export function resolveExpoRuntimeLayoutIntegration(
+  runtimePlan: ExpoRuntimePlan | undefined,
+): ExpoRuntimeLayoutIntegrationPlan {
+  const imports: string[] = [];
+  const expoRuntimeImports: string[] = [];
+  const moduleDeclarations: string[] = [];
+  const providerStart: string[] = [];
+  const providerEnd: string[] = [];
+
+  if ((runtimePlan?.providers.length ?? 0) > 0) {
+    expoRuntimeImports.push('ExpoRuntimeProviders');
+    providerStart.push(
+      `<ExpoRuntimeProviders providers={['${(runtimePlan?.providers ?? []).join("', '")}']}>`,
+    );
+    providerEnd.push('</ExpoRuntimeProviders>');
+  }
+
+  if (expoRuntimeImports.length > 0) {
+    imports.push(
+      `import { ${Array.from(new Set(expoRuntimeImports)).join(', ')} } from '@ankhorage/expo-runtime';`,
+    );
+  }
+
+  return {
+    imports,
+    moduleDeclarations,
+    providerStart,
+    providerEnd,
+  };
+}

package/src/planning.ts

@@ -1,4 +1,8 @@
 export { getExpoBarcodeScannerViewSource } from './generatedSources';
+export {
+  type ExpoRuntimeLayoutIntegrationPlan,
+  resolveExpoRuntimeLayoutIntegration,
+} from './layoutIntegrationPlanning';
 export type {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,