@ankhorage/expo-runtime 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/expo-runtime
 
+## 2.2.0
+
+### Minor Changes
+
+- 3ac63a6: Add Expo/Metro bundled media resolution and static registry source generation for canonical app-relative media paths.
+
 ## 2.1.0
 
 ### Minor Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # EXPO-RUNTIME
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.0.0](././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: v2.1.0](././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
 
@@ -18,6 +18,7 @@ Declarative runtime integration for Expo apps: maps app capabilities to permissi
 - [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)
+- [getExpoBundledMediaRegistrySource sequence](././paradox/diagrams/sequences/get-expo-bundled-media-registry-source.mmd)
 - [resolveExpoRuntimeGeneratedAppOutput sequence](././paradox/diagrams/sequences/resolve-expo-runtime-generated-app-output.mmd)
 - [resolveExpoRuntimeNativeOutput sequence](././paradox/diagrams/sequences/resolve-expo-runtime-native-output.mmd)
 - [resolveExpoRuntimePlan sequence](././paradox/diagrams/sequences/resolve-expo-runtime-plan.mmd)

package/dist/bundledMediaRegistrySource.d.ts

@@ -0,0 +1,6 @@
+export interface ExpoBundledMediaRegistrySourceEntry {
+    readonly path: string;
+    readonly requirePath: string;
+}
+export declare function getExpoBundledMediaRegistrySource(entries: readonly ExpoBundledMediaRegistrySourceEntry[]): string;
+//# sourceMappingURL=bundledMediaRegistrySource.d.ts.map

package/dist/bundledMediaRegistrySource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundledMediaRegistrySource.d.ts","sourceRoot":"","sources":["../src/bundledMediaRegistrySource.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,SAAS,mCAAmC,EAAE,GACtD,MAAM,CAeR"}

package/dist/bundledMediaRegistrySource.js

@@ -0,0 +1,28 @@
+export function getExpoBundledMediaRegistrySource(entries) {
+    const normalized = normalizeEntries(entries);
+    const rows = normalized.map((entry) => `  ${JSON.stringify(entry.path)}: require(${JSON.stringify(entry.requirePath)}),`);
+    return [
+        "import type { ExpoBundledMediaRegistry } from '@ankhorage/expo-runtime';",
+        '',
+        'declare const require: (path: string) => ExpoBundledMediaRegistry[string];',
+        '',
+        'export const bundledMediaRegistry: ExpoBundledMediaRegistry = {',
+        ...rows,
+        '};',
+        '',
+    ].join('\n');
+}
+function normalizeEntries(entries) {
+    const byPath = new Map();
+    for (const entry of entries) {
+        const existing = byPath.get(entry.path);
+        if (existing !== undefined && existing !== entry.requirePath) {
+            throw new Error(`Bundled media path has conflicting require targets: ${entry.path}`);
+        }
+        byPath.set(entry.path, entry.requirePath);
+    }
+    return [...byPath.entries()]
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([path, requirePath]) => ({ path, requirePath }));
+}
+//# sourceMappingURL=bundledMediaRegistrySource.js.map

package/dist/bundledMediaRegistrySource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundledMediaRegistrySource.js","sourceRoot":"","sources":["../src/bundledMediaRegistrySource.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,iCAAiC,CAC/C,OAAuD;IAEvD,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CACzB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAC7F,CAAC;IACF,OAAO;QACL,0EAA0E;QAC1E,EAAE;QACF,4EAA4E;QAC5E,EAAE;QACF,iEAAiE;QACjE,GAAG,IAAI;QACP,IAAI;QACJ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAuD;IAEvD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,uDAAuD,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SACzB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["export interface ExpoBundledMediaRegistrySourceEntry {\n  readonly path: string;\n  readonly requirePath: string;\n}\n\nexport function getExpoBundledMediaRegistrySource(\n  entries: readonly ExpoBundledMediaRegistrySourceEntry[],\n): string {\n  const normalized = normalizeEntries(entries);\n  const rows = normalized.map(\n    (entry) => `  ${JSON.stringify(entry.path)}: require(${JSON.stringify(entry.requirePath)}),`,\n  );\n  return [\n    \"import type { ExpoBundledMediaRegistry } from '@ankhorage/expo-runtime';\",\n    '',\n    'declare const require: (path: string) => ExpoBundledMediaRegistry[string];',\n    '',\n    'export const bundledMediaRegistry: ExpoBundledMediaRegistry = {',\n    ...rows,\n    '};',\n    '',\n  ].join('\\n');\n}\n\nfunction normalizeEntries(\n  entries: readonly ExpoBundledMediaRegistrySourceEntry[],\n): readonly ExpoBundledMediaRegistrySourceEntry[] {\n  const byPath = new Map<string, string>();\n  for (const entry of entries) {\n    const existing = byPath.get(entry.path);\n    if (existing !== undefined && existing !== entry.requirePath) {\n      throw new Error(`Bundled media path has conflicting require targets: ${entry.path}`);\n    }\n    byPath.set(entry.path, entry.requirePath);\n  }\n  return [...byPath.entries()]\n    .sort(([left], [right]) => left.localeCompare(right))\n    .map(([path, requirePath]) => ({ path, requirePath }));\n}\n"]}

package/dist/bundledMediaResolver.d.ts

@@ -0,0 +1,10 @@
+import type { MediaAsset } from '@ankhorage/contracts';
+export type ExpoBundledMediaValue = string | number | Readonly<Record<string, unknown>>;
+export type ExpoBundledMediaRegistry = Readonly<Record<string, ExpoBundledMediaValue>>;
+export interface ExpoBundledMediaResolverArgs {
+    readonly asset: MediaAsset;
+}
+export type ExpoBundledMediaResolver = (args: ExpoBundledMediaResolverArgs) => ExpoBundledMediaValue | null;
+export declare function createExpoBundledMediaResolver(registry: ExpoBundledMediaRegistry): ExpoBundledMediaResolver;
+export declare function resolveExpoBundledMediaAsset(registry: ExpoBundledMediaRegistry, asset: MediaAsset): ExpoBundledMediaValue | null;
+//# sourceMappingURL=bundledMediaResolver.d.ts.map

package/dist/bundledMediaResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundledMediaResolver.d.ts","sourceRoot":"","sources":["../src/bundledMediaResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAEvF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,IAAI,EAAE,4BAA4B,KAC/B,qBAAqB,GAAG,IAAI,CAAC;AAElC,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,wBAAwB,GACjC,wBAAwB,CAE1B;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,wBAAwB,EAClC,KAAK,EAAE,UAAU,GAChB,qBAAqB,GAAG,IAAI,CAG9B"}

package/dist/bundledMediaResolver.js

@@ -0,0 +1,9 @@
+export function createExpoBundledMediaResolver(registry) {
+    return ({ asset }) => resolveExpoBundledMediaAsset(registry, asset);
+}
+export function resolveExpoBundledMediaAsset(registry, asset) {
+    if (asset.source.kind !== 'bundled')
+        return null;
+    return registry[asset.source.path] ?? null;
+}
+//# sourceMappingURL=bundledMediaResolver.js.map

package/dist/bundledMediaResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundledMediaResolver.js","sourceRoot":"","sources":["../src/bundledMediaResolver.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,8BAA8B,CAC5C,QAAkC;IAElC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAAkC,EAClC,KAAiB;IAEjB,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC7C,CAAC","sourcesContent":["import type { MediaAsset } from '@ankhorage/contracts';\n\nexport type ExpoBundledMediaValue = string | number | Readonly<Record<string, unknown>>;\n\nexport type ExpoBundledMediaRegistry = Readonly<Record<string, ExpoBundledMediaValue>>;\n\nexport interface ExpoBundledMediaResolverArgs {\n  readonly asset: MediaAsset;\n}\n\nexport type ExpoBundledMediaResolver = (\n  args: ExpoBundledMediaResolverArgs,\n) => ExpoBundledMediaValue | null;\n\nexport function createExpoBundledMediaResolver(\n  registry: ExpoBundledMediaRegistry,\n): ExpoBundledMediaResolver {\n  return ({ asset }) => resolveExpoBundledMediaAsset(registry, asset);\n}\n\nexport function resolveExpoBundledMediaAsset(\n  registry: ExpoBundledMediaRegistry,\n  asset: MediaAsset,\n): ExpoBundledMediaValue | null {\n  if (asset.source.kind !== 'bundled') return null;\n  return registry[asset.source.path] ?? null;\n}\n"]}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { BARCODE_SCAN_DEDUPE_WINDOW_MS, BARCODE_SCANNER_TYPES, type BarcodeScanRecord, type ExpoBarcodeScanResultLike, mapPermissionStatusToCameraPermissionStatus, normalizeExpoBarcodeScanResult, shouldIgnoreBarcodeScan, } from './barcodeScanRuntime';
+export { type ExpoBundledMediaRegistrySourceEntry, getExpoBundledMediaRegistrySource, } from './bundledMediaRegistrySource';
+export { createExpoBundledMediaResolver, type ExpoBundledMediaRegistry, type ExpoBundledMediaResolver, type ExpoBundledMediaResolverArgs, type ExpoBundledMediaValue, resolveExpoBundledMediaAsset, } from './bundledMediaResolver';
 export type { ComponentRegistry } from './componentRegistry';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';

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,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,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,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"}
+{"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,OAAO,EACL,KAAK,mCAAmC,EACxC,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,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,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,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,4 +1,6 @@
 export { BARCODE_SCAN_DEDUPE_WINDOW_MS, BARCODE_SCANNER_TYPES, mapPermissionStatusToCameraPermissionStatus, normalizeExpoBarcodeScanResult, shouldIgnoreBarcodeScan, } from './barcodeScanRuntime';
+export { getExpoBundledMediaRegistrySource, } from './bundledMediaRegistrySource';
+export { createExpoBundledMediaResolver, resolveExpoBundledMediaAsset, } from './bundledMediaResolver';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';
 export { executeExpoRuntimeAction, resolveExpoRuntimeRoutePath, } from './expoActionBridge';

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,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,EAKL,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,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 {\n  type ExpoRuntimeConfigPluginOutput,\n  type ExpoRuntimeDependencyMap,\n  type ExpoRuntimeGeneratedAppOutputPlan,\n  type ExpoRuntimeNativeOutputPlan,\n  resolveExpoRuntimeConfigPluginOutput,\n  resolveExpoRuntimeDependencyMap,\n  resolveExpoRuntimeGeneratedAppOutput,\n  resolveExpoRuntimeNativeOutput,\n} from './generatedAppOutput';\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"]}
+{"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;AAC9B,OAAO,EAEL,iCAAiC,GAClC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,8BAA8B,EAK9B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,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,EAKL,oCAAoC,EACpC,+BAA+B,EAC/B,oCAAoC,EACpC,8BAA8B,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,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 {\n  type ExpoBundledMediaRegistrySourceEntry,\n  getExpoBundledMediaRegistrySource,\n} from './bundledMediaRegistrySource';\nexport {\n  createExpoBundledMediaResolver,\n  type ExpoBundledMediaRegistry,\n  type ExpoBundledMediaResolver,\n  type ExpoBundledMediaResolverArgs,\n  type ExpoBundledMediaValue,\n  resolveExpoBundledMediaAsset,\n} from './bundledMediaResolver';\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 {\n  type ExpoRuntimeConfigPluginOutput,\n  type ExpoRuntimeDependencyMap,\n  type ExpoRuntimeGeneratedAppOutputPlan,\n  type ExpoRuntimeNativeOutputPlan,\n  resolveExpoRuntimeConfigPluginOutput,\n  resolveExpoRuntimeDependencyMap,\n  resolveExpoRuntimeGeneratedAppOutput,\n  resolveExpoRuntimeNativeOutput,\n} from './generatedAppOutput';\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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/expo-runtime",
   "type": "module",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "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/bundledMediaRegistrySource.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, test } from 'bun:test';
+
+import { getExpoBundledMediaRegistrySource } from './bundledMediaRegistrySource';
+
+describe('Expo bundled media registry source', () => {
+  test('renders sorted static require literals and deduplicates identical entries', () => {
+    const source = getExpoBundledMediaRegistrySource([
+      { path: 'assets/z.png', requirePath: '../../assets/z.png' },
+      { path: 'assets/a.png', requirePath: '../../assets/a.png' },
+      { path: 'assets/a.png', requirePath: '../../assets/a.png' },
+    ]);
+    expect(source.indexOf('assets/a.png')).toBeLessThan(source.indexOf('assets/z.png'));
+    expect(source.match(/require\("\.\.\/\.\.\/assets\/a\.png"\)/g)?.length).toBe(1);
+    expect(source).toContain('require("../../assets/z.png")');
+  });
+
+  test('rejects one canonical path mapped to different files', () => {
+    expect(() =>
+      getExpoBundledMediaRegistrySource([
+        { path: 'assets/a.png', requirePath: '../../assets/a.png' },
+        { path: 'assets/a.png', requirePath: '../../assets/other.png' },
+      ]),
+    ).toThrow('conflicting require targets');
+  });
+});

package/src/bundledMediaRegistrySource.ts

@@ -0,0 +1,39 @@
+export interface ExpoBundledMediaRegistrySourceEntry {
+  readonly path: string;
+  readonly requirePath: string;
+}
+
+export function getExpoBundledMediaRegistrySource(
+  entries: readonly ExpoBundledMediaRegistrySourceEntry[],
+): string {
+  const normalized = normalizeEntries(entries);
+  const rows = normalized.map(
+    (entry) => `  ${JSON.stringify(entry.path)}: require(${JSON.stringify(entry.requirePath)}),`,
+  );
+  return [
+    "import type { ExpoBundledMediaRegistry } from '@ankhorage/expo-runtime';",
+    '',
+    'declare const require: (path: string) => ExpoBundledMediaRegistry[string];',
+    '',
+    'export const bundledMediaRegistry: ExpoBundledMediaRegistry = {',
+    ...rows,
+    '};',
+    '',
+  ].join('\n');
+}
+
+function normalizeEntries(
+  entries: readonly ExpoBundledMediaRegistrySourceEntry[],
+): readonly ExpoBundledMediaRegistrySourceEntry[] {
+  const byPath = new Map<string, string>();
+  for (const entry of entries) {
+    const existing = byPath.get(entry.path);
+    if (existing !== undefined && existing !== entry.requirePath) {
+      throw new Error(`Bundled media path has conflicting require targets: ${entry.path}`);
+    }
+    byPath.set(entry.path, entry.requirePath);
+  }
+  return [...byPath.entries()]
+    .sort(([left], [right]) => left.localeCompare(right))
+    .map(([path, requirePath]) => ({ path, requirePath }));
+}

package/src/bundledMediaResolver.test.ts

@@ -0,0 +1,31 @@
+import type { MediaAsset } from '@ankhorage/contracts';
+import { describe, expect, test } from 'bun:test';
+
+import {
+  createExpoBundledMediaResolver,
+  resolveExpoBundledMediaAsset,
+} from './bundledMediaResolver';
+
+const bundledAsset: MediaAsset = {
+  id: 'hero',
+  name: 'Hero',
+  kind: 'image',
+  source: { kind: 'bundled', path: 'assets/authoring/hero/hero.png' },
+};
+
+describe('Expo bundled media resolution', () => {
+  test('resolves canonical bundled paths from the static registry', () => {
+    const registry = { 'assets/authoring/hero/hero.png': 42 } as const;
+    expect(resolveExpoBundledMediaAsset(registry, bundledAsset)).toBe(42);
+    expect(createExpoBundledMediaResolver(registry)({ asset: bundledAsset })).toBe(42);
+  });
+
+  test('returns null for unknown bundled paths and non-bundled assets', () => {
+    expect(resolveExpoBundledMediaAsset({}, bundledAsset)).toBeNull();
+    const remoteAsset: MediaAsset = {
+      ...bundledAsset,
+      source: { kind: 'url', url: 'https://example.com/hero.png' },
+    };
+    expect(resolveExpoBundledMediaAsset({}, remoteAsset)).toBeNull();
+  });
+});

package/src/bundledMediaResolver.ts

@@ -0,0 +1,27 @@
+import type { MediaAsset } from '@ankhorage/contracts';
+
+export type ExpoBundledMediaValue = string | number | Readonly<Record<string, unknown>>;
+
+export type ExpoBundledMediaRegistry = Readonly<Record<string, ExpoBundledMediaValue>>;
+
+export interface ExpoBundledMediaResolverArgs {
+  readonly asset: MediaAsset;
+}
+
+export type ExpoBundledMediaResolver = (
+  args: ExpoBundledMediaResolverArgs,
+) => ExpoBundledMediaValue | null;
+
+export function createExpoBundledMediaResolver(
+  registry: ExpoBundledMediaRegistry,
+): ExpoBundledMediaResolver {
+  return ({ asset }) => resolveExpoBundledMediaAsset(registry, asset);
+}
+
+export function resolveExpoBundledMediaAsset(
+  registry: ExpoBundledMediaRegistry,
+  asset: MediaAsset,
+): ExpoBundledMediaValue | null {
+  if (asset.source.kind !== 'bundled') return null;
+  return registry[asset.source.path] ?? null;
+}

package/src/index.ts

@@ -7,6 +7,18 @@ export {
   normalizeExpoBarcodeScanResult,
   shouldIgnoreBarcodeScan,
 } from './barcodeScanRuntime';
+export {
+  type ExpoBundledMediaRegistrySourceEntry,
+  getExpoBundledMediaRegistrySource,
+} from './bundledMediaRegistrySource';
+export {
+  createExpoBundledMediaResolver,
+  type ExpoBundledMediaRegistry,
+  type ExpoBundledMediaResolver,
+  type ExpoBundledMediaResolverArgs,
+  type ExpoBundledMediaValue,
+  resolveExpoBundledMediaAsset,
+} from './bundledMediaResolver';
 export type { ComponentRegistry } from './componentRegistry';
 export { createComponentRegistry } from './componentRegistry';
 export { createExpoRuntimeRegistry } from './createExpoRuntimeRegistry';