@ankhorage/expo-runtime 0.0.6 → 0.0.7

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/expo-runtime
 
+## 0.0.7
+
+### Patch Changes
+
+- 7eddf62: Add generated layout helper output for Expo provider imports.
+
 ## 0.0.6
 
 ### Patch Changes

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export { executeExpoRuntimeAction, type ExecuteExpoRuntimeActionArgs, type ExpoR
 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,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"}
+{"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

@@ -5,5 +5,6 @@ export { executeExpoRuntimeAction, resolveExpoRuntimeRoutePath, } from './expoAc
 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,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"]}
+{"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.6",
+  "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/index.ts

@@ -23,6 +23,10 @@ export {
 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,