@ankhorage/expo-runtime 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/expo-runtime
 
+## 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
+
+- 0573919: Add a generated barcode scanner adapter source helper for standalone Expo app generation.
+
 ## 0.0.4
 
 ### 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/generatedSources.d.ts

@@ -0,0 +1,2 @@
+export declare function getExpoBarcodeScannerViewSource(): string;
+//# sourceMappingURL=generatedSources.d.ts.map

package/dist/generatedSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatedSources.d.ts","sourceRoot":"","sources":["../src/generatedSources.ts"],"names":[],"mappings":"AAMA,wBAAgB,+BAA+B,IAAI,MAAM,CAExD"}

package/dist/generatedSources.js

@@ -0,0 +1,9 @@
+const EXPO_BARCODE_SCANNER_VIEW_SOURCE = [
+    'export { ExpoBarcodeScannerAdapter as ExpoBarcodeScannerView }',
+    ' from "@ankhorage/expo-runtime";',
+    '\n',
+];
+export function getExpoBarcodeScannerViewSource() {
+    return EXPO_BARCODE_SCANNER_VIEW_SOURCE.join('');
+}
+//# sourceMappingURL=generatedSources.js.map

package/dist/generatedSources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatedSources.js","sourceRoot":"","sources":["../src/generatedSources.ts"],"names":[],"mappings":"AAAA,MAAM,gCAAgC,GAAG;IACvC,gEAAgE;IAChE,kCAAkC;IAClC,IAAI;CACI,CAAC;AAEX,MAAM,UAAU,+BAA+B;IAC7C,OAAO,gCAAgC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC","sourcesContent":["const EXPO_BARCODE_SCANNER_VIEW_SOURCE = [\n  'export { ExpoBarcodeScannerAdapter as ExpoBarcodeScannerView }',\n  ' from \"@ankhorage/expo-runtime\";',\n  '\\n',\n] as const;\n\nexport function getExpoBarcodeScannerViewSource(): string {\n  return EXPO_BARCODE_SCANNER_VIEW_SOURCE.join('');\n}\n"]}

package/dist/index.d.ts

@@ -2,8 +2,10 @@ 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 { 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,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,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 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 { 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;AAM9F,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 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;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 {\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 type {\n  ExpoRuntimeAdapterId,\n  ExpoRuntimePlan,\n  ExpoRuntimeProviderId,\n} from './resolveExpoRuntimePlan';\nexport { resolveExpoRuntimePlan } from './resolveExpoRuntimePlan';\n"]}

package/dist/planning.d.ts

@@ -1,3 +1,4 @@
+export { getExpoBarcodeScannerViewSource } from './generatedSources';
 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,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,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/planning.js

@@ -1,2 +1,3 @@
+export { getExpoBarcodeScannerViewSource } from './generatedSources';
 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":"AAKA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export 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;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"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "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": {
@@ -22,7 +22,7 @@
     "runtime"
   ],
   "dependencies": {
-    "@ankhorage/contracts": "^1.18.2",
+    "@ankhorage/contracts": "^1.18.3",
     "@ankhorage/permissions": "^0.2.0",
     "@ankhorage/zora": "^2.8.0"
   },

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/generatedSources.ts

@@ -0,0 +1,9 @@
+const EXPO_BARCODE_SCANNER_VIEW_SOURCE = [
+  'export { ExpoBarcodeScannerAdapter as ExpoBarcodeScannerView }',
+  ' from "@ankhorage/expo-runtime";',
+  '\n',
+] as const;
+
+export function getExpoBarcodeScannerViewSource(): string {
+  return EXPO_BARCODE_SCANNER_VIEW_SOURCE.join('');
+}

package/src/index.ts

@@ -10,8 +10,19 @@ 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 {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,

package/src/planning.ts

@@ -1,3 +1,4 @@
+export { getExpoBarcodeScannerViewSource } from './generatedSources';
 export type {
   ExpoRuntimeAdapterId,
   ExpoRuntimePlan,