@ankhorage/runtime 5.1.1 → 5.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/runtime
 
+## 5.1.3
+
+### Patch Changes
+
+- 8d799e6: Prefer configured API capability executors so generated hosts provide their injected fetch implementation.
+
+## 5.1.2
+
+### Patch Changes
+
+- 948a889: Update dependencies: `@ankhorage/data-sources`.
+
 ## 5.1.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/runtime
 
-![license: MIT](./paradox/badges/license.svg) ![npm: v5.1.1](./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) ![paradox: warnings](./paradox/badges/docs.svg)
+![license: MIT](./paradox/badges/license.svg) ![npm: v5.1.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) ![paradox: warnings](./paradox/badges/docs.svg)
 
 Platform-neutral runtime renderer, contracts, and helpers for Ankhorage generated apps.
 

package/dist/runtimeCapabilityExecutor.d.ts

@@ -5,6 +5,6 @@ export interface RuntimeCapabilityExecutorComposition {
     readonly capabilityExecutor?: RuntimeCapabilityExecutor;
     readonly stateAdapter?: StateAdapter;
 }
-/*** Routes API and state capabilities before delegating application-owned capabilities. */
+/*** Keeps local state mutations while preferring the configured host executor for API capabilities. */
 export declare function composeRuntimeCapabilityExecutor(composition: RuntimeCapabilityExecutorComposition): RuntimeCapabilityExecutor;
 //# sourceMappingURL=runtimeCapabilityExecutor.d.ts.map

package/dist/runtimeCapabilityExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeCapabilityExecutor.d.ts","sourceRoot":"","sources":["../src/runtimeCapabilityExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,sBAAsB,CAAC;AAGhF,OAAO,KAAK,EAGV,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAED,2FAA2F;AAC3F,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,oCAAoC,GAChD,yBAAyB,CAO3B"}
+{"version":3,"file":"runtimeCapabilityExecutor.d.ts","sourceRoot":"","sources":["../src/runtimeCapabilityExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,sBAAsB,CAAC;AAGhF,OAAO,KAAK,EAGV,yBAAyB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,qBAAqB,EAAE,yBAAyB,CAAC;IAC1D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAED,uGAAuG;AACvG,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,oCAAoC,GAChD,yBAAyB,CAO3B"}

package/dist/runtimeCapabilityExecutor.js

@@ -1,12 +1,16 @@
 import { isRecord } from '@ankhorage/utility/object';
-/*** Routes API and state capabilities before delegating application-owned capabilities. */
+/*** Keeps local state mutations while preferring the configured host executor for API capabilities. */
 export function composeRuntimeCapabilityExecutor(composition) {
-    return async (args) => args.capability.startsWith('api.')
-        ? composition.apiCapabilityExecutor(args)
-        : args.capability === 'state.set'
-            ? executeStateSetCapabilityAsync(args, composition.stateAdapter)
+    return async (args) => args.capability === 'state.set'
+        ? executeStateSetCapabilityAsync(args, composition.stateAdapter)
+        : args.capability.startsWith('api.')
+            ? executeApiCapabilityAsync(args, composition)
             : executeApplicationCapabilityAsync(args, composition.capabilityExecutor);
 }
+/*** Uses the host API executor when supplied, falling back to the manifest executor. */
+function executeApiCapabilityAsync(args, composition) {
+    return composition.capabilityExecutor?.(args) ?? composition.apiCapabilityExecutor(args);
+}
 /*** Applies one serializable state value through the configured application state adapter. */
 function executeStateSetCapabilityAsync(args, stateAdapter) {
     if (stateAdapter === undefined)

package/dist/runtimeCapabilityExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeCapabilityExecutor.js","sourceRoot":"","sources":["../src/runtimeCapabilityExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateAdapter, StatePath, StateValue } from '@ankhorage/contracts';\nimport { isRecord } from '@ankhorage/utility/object';\n\nimport type {\n  RuntimeCapabilityExecutionArgs,\n  RuntimeCapabilityExecutionResult,\n  RuntimeCapabilityExecutor,\n} from './runtimeBindings';\n\nexport interface RuntimeCapabilityExecutorComposition {\n  readonly apiCapabilityExecutor: RuntimeCapabilityExecutor;\n  readonly capabilityExecutor?: RuntimeCapabilityExecutor;\n  readonly stateAdapter?: StateAdapter;\n}\n\n/*** Routes API and state capabilities before delegating application-owned capabilities. */\nexport function composeRuntimeCapabilityExecutor(\n  composition: RuntimeCapabilityExecutorComposition,\n): RuntimeCapabilityExecutor {\n  return async (args) =>\n    args.capability.startsWith('api.')\n      ? composition.apiCapabilityExecutor(args)\n      : args.capability === 'state.set'\n        ? executeStateSetCapabilityAsync(args, composition.stateAdapter)\n        : executeApplicationCapabilityAsync(args, composition.capabilityExecutor);\n}\n\n/*** Applies one serializable state value through the configured application state adapter. */\nfunction executeStateSetCapabilityAsync(\n  args: RuntimeCapabilityExecutionArgs,\n  stateAdapter: StateAdapter | undefined,\n): Promise<RuntimeCapabilityExecutionResult> {\n  if (stateAdapter === undefined) return Promise.resolve(missingStateAdapterResult());\n\n  const input = resolveStateSetInput(args.input);\n  if (input === undefined) return Promise.resolve(invalidStateSetInputResult());\n\n  try {\n    const result = stateAdapter.set(input.path, input.value);\n    return Promise.resolve(\n      result.ok\n        ? { data: { path: input.path, value: input.value }, ok: true }\n        : {\n            diagnostics: [\n              {\n                code: result.error.code,\n                message: result.error.message,\n                severity: 'error',\n              },\n            ],\n            ok: false,\n          },\n    );\n  } catch (error) {\n    return Promise.resolve(stateAdapterSetErrorResult(error));\n  }\n}\n\nasync function executeApplicationCapabilityAsync(\n  args: RuntimeCapabilityExecutionArgs,\n  capabilityExecutor: RuntimeCapabilityExecutor | undefined,\n): Promise<RuntimeCapabilityExecutionResult> {\n  if (capabilityExecutor !== undefined) return capabilityExecutor(args);\n  return {\n    diagnostics: [\n      {\n        code: 'missing-operation',\n        message: `Capability '${args.capability}' has no configured executor.`,\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction resolveStateSetInput(\n  input: RuntimeCapabilityExecutionArgs['input'],\n): { readonly path: StatePath; readonly value: StateValue } | undefined {\n  if (!isRecord(input) || !('value' in input)) return undefined;\n  const { path, value } = input;\n  if (!isStatePath(path) || !isStateValue(value)) return undefined;\n  return { path, value };\n}\n\nfunction isStatePath(value: unknown): value is StatePath {\n  return (\n    (typeof value === 'string' && value.trim().length > 0) ||\n    (Array.isArray(value) &&\n      value.length > 0 &&\n      value.every((part) => typeof part === 'string' && part.trim().length > 0))\n  );\n}\n\nfunction isStateValue(value: unknown): value is StateValue {\n  if (value === null || typeof value === 'boolean' || typeof value === 'string') return true;\n  if (typeof value === 'number') return Number.isFinite(value);\n  if (Array.isArray(value)) return value.every(isStateValue);\n  return isRecord(value) && Object.values(value).every(isStateValue);\n}\n\n/*** Converts thrown adapter failures into capability diagnostics at the public Runtime boundary. */\nfunction stateAdapterSetErrorResult(error: unknown): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'state-adapter-error',\n        message: error instanceof Error ? error.message : 'StateAdapter.set failed.',\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction missingStateAdapterResult(): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'missing-adapter',\n        message: \"Capability 'state.set' requires a configured StateAdapter.\",\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction invalidStateSetInputResult(): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'invalid-input',\n        message: \"Capability 'state.set' requires a non-empty path and serializable value.\",\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n"]}
+{"version":3,"file":"runtimeCapabilityExecutor.js","sourceRoot":"","sources":["../src/runtimeCapabilityExecutor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StateAdapter, StatePath, StateValue } from '@ankhorage/contracts';\nimport { isRecord } from '@ankhorage/utility/object';\n\nimport type {\n  RuntimeCapabilityExecutionArgs,\n  RuntimeCapabilityExecutionResult,\n  RuntimeCapabilityExecutor,\n} from './runtimeBindings';\n\nexport interface RuntimeCapabilityExecutorComposition {\n  readonly apiCapabilityExecutor: RuntimeCapabilityExecutor;\n  readonly capabilityExecutor?: RuntimeCapabilityExecutor;\n  readonly stateAdapter?: StateAdapter;\n}\n\n/*** Keeps local state mutations while preferring the configured host executor for API capabilities. */\nexport function composeRuntimeCapabilityExecutor(\n  composition: RuntimeCapabilityExecutorComposition,\n): RuntimeCapabilityExecutor {\n  return async (args) =>\n    args.capability === 'state.set'\n      ? executeStateSetCapabilityAsync(args, composition.stateAdapter)\n      : args.capability.startsWith('api.')\n        ? executeApiCapabilityAsync(args, composition)\n        : executeApplicationCapabilityAsync(args, composition.capabilityExecutor);\n}\n\n/*** Uses the host API executor when supplied, falling back to the manifest executor. */\nfunction executeApiCapabilityAsync(\n  args: RuntimeCapabilityExecutionArgs,\n  composition: RuntimeCapabilityExecutorComposition,\n): Promise<RuntimeCapabilityExecutionResult> {\n  return composition.capabilityExecutor?.(args) ?? composition.apiCapabilityExecutor(args);\n}\n\n/*** Applies one serializable state value through the configured application state adapter. */\nfunction executeStateSetCapabilityAsync(\n  args: RuntimeCapabilityExecutionArgs,\n  stateAdapter: StateAdapter | undefined,\n): Promise<RuntimeCapabilityExecutionResult> {\n  if (stateAdapter === undefined) return Promise.resolve(missingStateAdapterResult());\n\n  const input = resolveStateSetInput(args.input);\n  if (input === undefined) return Promise.resolve(invalidStateSetInputResult());\n\n  try {\n    const result = stateAdapter.set(input.path, input.value);\n    return Promise.resolve(\n      result.ok\n        ? { data: { path: input.path, value: input.value }, ok: true }\n        : {\n            diagnostics: [\n              {\n                code: result.error.code,\n                message: result.error.message,\n                severity: 'error',\n              },\n            ],\n            ok: false,\n          },\n    );\n  } catch (error) {\n    return Promise.resolve(stateAdapterSetErrorResult(error));\n  }\n}\n\nasync function executeApplicationCapabilityAsync(\n  args: RuntimeCapabilityExecutionArgs,\n  capabilityExecutor: RuntimeCapabilityExecutor | undefined,\n): Promise<RuntimeCapabilityExecutionResult> {\n  if (capabilityExecutor !== undefined) return capabilityExecutor(args);\n  return {\n    diagnostics: [\n      {\n        code: 'missing-operation',\n        message: `Capability '${args.capability}' has no configured executor.`,\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction resolveStateSetInput(\n  input: RuntimeCapabilityExecutionArgs['input'],\n): { readonly path: StatePath; readonly value: StateValue } | undefined {\n  if (!isRecord(input) || !('value' in input)) return undefined;\n  const { path, value } = input;\n  if (!isStatePath(path) || !isStateValue(value)) return undefined;\n  return { path, value };\n}\n\nfunction isStatePath(value: unknown): value is StatePath {\n  return (\n    (typeof value === 'string' && value.trim().length > 0) ||\n    (Array.isArray(value) &&\n      value.length > 0 &&\n      value.every((part) => typeof part === 'string' && part.trim().length > 0))\n  );\n}\n\nfunction isStateValue(value: unknown): value is StateValue {\n  if (value === null || typeof value === 'boolean' || typeof value === 'string') return true;\n  if (typeof value === 'number') return Number.isFinite(value);\n  if (Array.isArray(value)) return value.every(isStateValue);\n  return isRecord(value) && Object.values(value).every(isStateValue);\n}\n\n/*** Converts thrown adapter failures into capability diagnostics at the public Runtime boundary. */\nfunction stateAdapterSetErrorResult(error: unknown): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'state-adapter-error',\n        message: error instanceof Error ? error.message : 'StateAdapter.set failed.',\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction missingStateAdapterResult(): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'missing-adapter',\n        message: \"Capability 'state.set' requires a configured StateAdapter.\",\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n\nfunction invalidStateSetInputResult(): RuntimeCapabilityExecutionResult {\n  return {\n    diagnostics: [\n      {\n        code: 'invalid-input',\n        message: \"Capability 'state.set' requires a non-empty path and serializable value.\",\n        severity: 'error',\n      },\n    ],\n    ok: false,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/runtime",
-  "version": "5.1.1",
+  "version": "5.1.3",
   "description": "Platform-neutral runtime renderer, contracts, and helpers for Ankhorage generated apps.",
   "license": "MIT",
   "engines": {
@@ -262,7 +262,7 @@
   "dependencies": {
     "@ankhorage/capability": "^0.2.2",
     "@ankhorage/contracts": "^26.0.2",
-    "@ankhorage/data-sources": "^2.1.2",
+    "@ankhorage/data-sources": "^2.1.3",
     "@ankhorage/utility": "^1.10.0"
   },
   "peerDependencies": {
@@ -276,7 +276,7 @@
     }
   },
   "devDependencies": {
-    "@ankhorage/devtools": "^2.3.23",
+    "@ankhorage/devtools": "^2.3.30",
     "@ankhorage/paradox": "^0.3.5",
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.4",

package/paradox/badges/npm.svg

@@ -1,7 +1,7 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="90" height="20" role="img" aria-label="npm: v5.1.1">
-<title>npm: v5.1.1</title>
+<svg xmlns="http://www.w3.org/2000/svg" width="90" height="20" role="img" aria-label="npm: v5.1.3">
+<title>npm: v5.1.3</title>
 <rect width="38" height="20" fill="#374151"/>
 <rect x="38" width="52" height="20" fill="#cb3837"/>
 <text x="19" y="14" fill="#ffffff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">npm</text>
-<text x="64" y="14" fill="#ffffff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">v5.1.1</text>
+<text x="64" y="14" fill="#ffffff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">v5.1.3</text>
 </svg>

package/paradox/diagrams/architecture-overview.mmd

@@ -126,6 +126,12 @@ graph TD
   package__ankhorage_runtime -.-> module_src_runtimeRepeatDiagnostics_ts
   module_src_runtimeRepeatEmptyState_ts["src/runtimeRepeatEmptyState.ts"]
   package__ankhorage_runtime -.-> module_src_runtimeRepeatEmptyState_ts
+  module_src_RuntimeScreen_test_tsx["src/RuntimeScreen.test.tsx"]
+  package__ankhorage_runtime -.-> module_src_RuntimeScreen_test_tsx
+  module_src_RuntimeScreen_test_tsx --> module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --> module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --> module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx["src/RuntimeScreen.tsx"]
   package__ankhorage_runtime -.-> module_src_RuntimeScreen_tsx
   module_src_RuntimeScreen_tsx --> module_src_ManifestContext_tsx

package/paradox/diagrams/export-graph.mmd

@@ -35,6 +35,7 @@ graph LR
   module_src_runtimeRepeat_ts["src/runtimeRepeat.ts"]
   module_src_runtimeRepeatDiagnostics_ts["src/runtimeRepeatDiagnostics.ts"]
   module_src_runtimeRepeatEmptyState_ts["src/runtimeRepeatEmptyState.ts"]
+  module_src_RuntimeScreen_test_tsx["src/RuntimeScreen.test.tsx"]
   module_src_RuntimeScreen_tsx["src/RuntimeScreen.tsx"]
   module_src_runtimeScreenLoaders_test_ts["src/runtimeScreenLoaders.test.ts"]
   module_src_runtimeScreenLoaders_ts["src/runtimeScreenLoaders.ts"]

package/paradox/diagrams/module-relationships.mmd

@@ -35,6 +35,7 @@ graph LR
   module_src_runtimeRepeat_ts["src/runtimeRepeat.ts"]
   module_src_runtimeRepeatDiagnostics_ts["src/runtimeRepeatDiagnostics.ts"]
   module_src_runtimeRepeatEmptyState_ts["src/runtimeRepeatEmptyState.ts"]
+  module_src_RuntimeScreen_test_tsx["src/RuntimeScreen.test.tsx"]
   module_src_RuntimeScreen_tsx["src/RuntimeScreen.tsx"]
   module_src_runtimeScreenLoaders_test_ts["src/runtimeScreenLoaders.test.ts"]
   module_src_runtimeScreenLoaders_ts["src/runtimeScreenLoaders.ts"]
@@ -98,6 +99,10 @@ graph LR
   module_src_RuntimeRendererConfig_tsx --> module_src_runtimeEventOperationLifecycle_ts
   module_src_RuntimeRendererConfig_tsx --> module_src_runtimeMedia_ts
   module_src_runtimeRepeat_ts --> module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --> module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --> module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --> module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx --> module_src_ManifestContext_tsx
   module_src_RuntimeScreen_tsx --> module_src_registry_tsx
   module_src_RuntimeScreen_tsx --> module_src_runtimeApiCapabilities_ts

package/paradox/diagrams/sequences/execute-runtime-binding-invocation.mmd

@@ -1,7 +1,9 @@
 sequenceDiagram
   participant participant_createMissingCapabilityExecutorDiagnostic as createMissingCapabilityExecutorDiagnostic
+  participant participant_executeApi as executeApi
   participant participant_executeCapability as executeCapability
   participant participant_executeRuntimeBindingInvocation as executeRuntimeBindingInvocation
+  participant participant_navigate as navigate
   participant participant_resolveBindingInputMap as resolveBindingInputMap
   participant participant_resolveObjectAsync as resolveObjectAsync
   participant participant_writeResultSlot as writeResultSlot
@@ -12,6 +14,10 @@ sequenceDiagram
   participant_resolveObjectAsync-->>participant_resolveBindingInputMap: return
   participant_resolveBindingInputMap-->>participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation->>participant_executeCapability: context.executeCapability()
+  participant_executeCapability->>participant_executeApi: executeApi()
+  participant_executeApi-->>participant_executeCapability: return
+  participant_executeCapability->>participant_navigate: navigate()
+  participant_navigate-->>participant_executeCapability: return
   participant_executeCapability-->>participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation->>participant_writeResultSlot: context.writeResultSlot()
   participant_writeResultSlot->>participant_writeResultSlot: args.writeResultSlot()

package/paradox/exports.json

@@ -66,7 +66,7 @@
   {
     "name": "composeRuntimeCapabilityExecutor",
     "title": null,
-    "description": "Routes API and state capabilities before delegating application-owned capabilities.",
+    "description": "Keeps local state mutations while preferring the configured host executor for API capabilities.",
     "isReadme": false,
     "see": [],
     "security": [],

package/paradox/exports.md

@@ -27,7 +27,7 @@ Kind: `function`
 Module: `src/runtimeCapabilityExecutor.ts`
 Source: `src/runtimeCapabilityExecutor.ts:17:1`
 
-Routes API and state capabilities before delegating application-owned capabilities.
+Keeps local state mutations while preferring the configured host executor for API capabilities.
 
 ### Signatures
 

package/paradox/index.html

@@ -184,7 +184,7 @@
   </li><li>
     <button class="nav-button" type="button" data-target="src/runtimeCapabilityExecutor.ts">
       src/runtimeCapabilityExecutor.ts
-      <small>9 functions</small>
+      <small>10 functions</small>
     </button>
   </li><li>
     <button class="nav-button" type="button" data-target="src/runtimeEventExecution.ts">
@@ -256,6 +256,11 @@
       src/runtimeRepeatEmptyState.ts
       <small>1 function</small>
     </button>
+  </li><li>
+    <button class="nav-button" type="button" data-target="src/RuntimeScreen.test.tsx">
+      src/RuntimeScreen.test.tsx
+      <small>2 functions</small>
+    </button>
   </li><li>
     <button class="nav-button" type="button" data-target="src/RuntimeScreen.tsx">
       src/RuntimeScreen.tsx
@@ -298,7 +303,7 @@
       <div class="summary">
         <div><strong>88</strong><span class="muted">public exports</span></div>
         <div><strong>5</strong><span class="muted">components</span></div>
-        <div><strong>46</strong><span class="muted">modules</span></div>
+        <div><strong>47</strong><span class="muted">modules</span></div>
         <div><strong>1</strong><span class="muted">entrypoints</span></div>
       </div>
       <h3>Entrypoints</h3>
@@ -569,6 +574,11 @@ inject it at the runtime boundary.</p>
     <p class="muted">Referenced module</p>
     <p><strong>Dependencies:</strong> <span class="empty">None</span></p>
     <p><strong>Exports:</strong> <code>shouldRenderRuntimeRepeatEmptyState</code></p>
+  </article><article class="item" data-search="src/RuntimeScreen.test.tsx src/registry.tsx src/runtimeApiCapabilities.ts src/runtimeBindings.ts src/RuntimeRendererConfig.tsx">
+    <h3>src/RuntimeScreen.test.tsx</h3>
+    <p class="muted">Referenced module</p>
+    <p><strong>Dependencies:</strong> <code>src/registry.tsx</code>, <code>src/runtimeApiCapabilities.ts</code>, <code>src/runtimeBindings.ts</code>, <code>src/RuntimeRendererConfig.tsx</code></p>
+    <p><strong>Exports:</strong> <span class="empty">None</span></p>
   </article><article class="item" data-search="src/RuntimeScreen.tsx src/ManifestContext.tsx src/registry.tsx src/runtimeApiCapabilities.ts src/runtimeCapabilityExecutor.ts src/RuntimeRenderer.tsx src/RuntimeRendererConfig.tsx src/runtimeScreenLoaders.ts src/runtimeStateAdapter.ts RuntimeScreen RuntimeScreenProps">
     <h3>src/RuntimeScreen.tsx</h3>
     <p class="muted">Referenced module</p>
@@ -1885,11 +1895,11 @@ inject it at the runtime boundary.</p>
             </section>
             <section>
               <h3>src/runtimeCapabilityExecutor.ts</h3>
-              <article class="item" id="symbol-composeruntimecapabilityexecutor" data-search="composeRuntimeCapabilityExecutor  function src/runtimeCapabilityExecutor.ts Routes API and state capabilities before delegating application-owned capabilities. RuntimeCapabilityExecutor RuntimeCapabilityExecutorComposition (composition: RuntimeCapabilityExecutorComposition) =&gt; RuntimeCapabilityExecutor">
+              <article class="item" id="symbol-composeruntimecapabilityexecutor" data-search="composeRuntimeCapabilityExecutor  function src/runtimeCapabilityExecutor.ts Keeps local state mutations while preferring the configured host executor for API capabilities. RuntimeCapabilityExecutor RuntimeCapabilityExecutorComposition (composition: RuntimeCapabilityExecutorComposition) =&gt; RuntimeCapabilityExecutor">
     <h4>composeRuntimeCapabilityExecutor</h4>
     
     <p class="muted">function • <code>src/runtimeCapabilityExecutor.ts:17:1</code></p>
-    <p>Routes API and state capabilities before delegating application-owned capabilities.</p>
+    <p>Keeps local state mutations while preferring the configured host executor for API capabilities.</p>
     
     <p><strong>Export paths:</strong> <code>src/index.ts</code></p>
     <div><strong>Related symbols:</strong> <ul class="chips"><li class="chip">RuntimeCapabilityExecutor</li><li class="chip">RuntimeCapabilityExecutorComposition</li></ul></div>
@@ -3674,6 +3684,12 @@ inject it at the runtime boundary.</p>
   package__ankhorage_runtime -.-&gt; module_src_runtimeRepeatDiagnostics_ts
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
   package__ankhorage_runtime -.-&gt; module_src_runtimeRepeatEmptyState_ts
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
+  package__ankhorage_runtime -.-&gt; module_src_RuntimeScreen_test_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   package__ankhorage_runtime -.-&gt; module_src_RuntimeScreen_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_ManifestContext_tsx
@@ -3842,6 +3858,12 @@ inject it at the runtime boundary.</p>
   package__ankhorage_runtime -.-&gt; module_src_runtimeRepeatDiagnostics_ts
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
   package__ankhorage_runtime -.-&gt; module_src_runtimeRepeatEmptyState_ts
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
+  package__ankhorage_runtime -.-&gt; module_src_RuntimeScreen_test_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   package__ankhorage_runtime -.-&gt; module_src_RuntimeScreen_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_ManifestContext_tsx
@@ -3921,6 +3943,7 @@ inject it at the runtime boundary.</p>
   module_src_runtimeRepeat_ts[&quot;src/runtimeRepeat.ts&quot;]
   module_src_runtimeRepeatDiagnostics_ts[&quot;src/runtimeRepeatDiagnostics.ts&quot;]
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   module_src_runtimeScreenLoaders_test_ts[&quot;src/runtimeScreenLoaders.test.ts&quot;]
   module_src_runtimeScreenLoaders_ts[&quot;src/runtimeScreenLoaders.ts&quot;]
@@ -3984,6 +4007,10 @@ inject it at the runtime boundary.</p>
   module_src_RuntimeRendererConfig_tsx --&gt; module_src_runtimeEventOperationLifecycle_ts
   module_src_RuntimeRendererConfig_tsx --&gt; module_src_runtimeMedia_ts
   module_src_runtimeRepeat_ts --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_ManifestContext_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_registry_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_runtimeApiCapabilities_ts
@@ -4041,6 +4068,7 @@ inject it at the runtime boundary.</p>
   module_src_runtimeRepeat_ts[&quot;src/runtimeRepeat.ts&quot;]
   module_src_runtimeRepeatDiagnostics_ts[&quot;src/runtimeRepeatDiagnostics.ts&quot;]
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   module_src_runtimeScreenLoaders_test_ts[&quot;src/runtimeScreenLoaders.test.ts&quot;]
   module_src_runtimeScreenLoaders_ts[&quot;src/runtimeScreenLoaders.ts&quot;]
@@ -4104,6 +4132,10 @@ inject it at the runtime boundary.</p>
   module_src_RuntimeRendererConfig_tsx --&gt; module_src_runtimeEventOperationLifecycle_ts
   module_src_RuntimeRendererConfig_tsx --&gt; module_src_runtimeMedia_ts
   module_src_runtimeRepeat_ts --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_registry_tsx
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeApiCapabilities_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_runtimeBindings_ts
+  module_src_RuntimeScreen_test_tsx --&gt; module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_ManifestContext_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_registry_tsx
   module_src_RuntimeScreen_tsx --&gt; module_src_runtimeApiCapabilities_ts
@@ -4163,6 +4195,7 @@ inject it at the runtime boundary.</p>
   module_src_runtimeRepeat_ts[&quot;src/runtimeRepeat.ts&quot;]
   module_src_runtimeRepeatDiagnostics_ts[&quot;src/runtimeRepeatDiagnostics.ts&quot;]
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   module_src_runtimeScreenLoaders_test_ts[&quot;src/runtimeScreenLoaders.test.ts&quot;]
   module_src_runtimeScreenLoaders_ts[&quot;src/runtimeScreenLoaders.ts&quot;]
@@ -4468,6 +4501,7 @@ inject it at the runtime boundary.</p>
   module_src_runtimeRepeat_ts[&quot;src/runtimeRepeat.ts&quot;]
   module_src_runtimeRepeatDiagnostics_ts[&quot;src/runtimeRepeatDiagnostics.ts&quot;]
   module_src_runtimeRepeatEmptyState_ts[&quot;src/runtimeRepeatEmptyState.ts&quot;]
+  module_src_RuntimeScreen_test_tsx[&quot;src/RuntimeScreen.test.tsx&quot;]
   module_src_RuntimeScreen_tsx[&quot;src/RuntimeScreen.tsx&quot;]
   module_src_runtimeScreenLoaders_test_ts[&quot;src/runtimeScreenLoaders.test.ts&quot;]
   module_src_runtimeScreenLoaders_ts[&quot;src/runtimeScreenLoaders.ts&quot;]
@@ -4842,8 +4876,10 @@ inject it at the runtime boundary.</p>
     <p class="muted"><code>diagrams/sequences/execute-runtime-binding-invocation.mmd</code></p>
     <div class="mermaid">sequenceDiagram
   participant participant_createMissingCapabilityExecutorDiagnostic as createMissingCapabilityExecutorDiagnostic
+  participant participant_executeApi as executeApi
   participant participant_executeCapability as executeCapability
   participant participant_executeRuntimeBindingInvocation as executeRuntimeBindingInvocation
+  participant participant_navigate as navigate
   participant participant_resolveBindingInputMap as resolveBindingInputMap
   participant participant_resolveObjectAsync as resolveObjectAsync
   participant participant_writeResultSlot as writeResultSlot
@@ -4854,6 +4890,10 @@ inject it at the runtime boundary.</p>
   participant_resolveObjectAsync--&gt;&gt;participant_resolveBindingInputMap: return
   participant_resolveBindingInputMap--&gt;&gt;participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation-&gt;&gt;participant_executeCapability: context.executeCapability()
+  participant_executeCapability-&gt;&gt;participant_executeApi: executeApi()
+  participant_executeApi--&gt;&gt;participant_executeCapability: return
+  participant_executeCapability-&gt;&gt;participant_navigate: navigate()
+  participant_navigate--&gt;&gt;participant_executeCapability: return
   participant_executeCapability--&gt;&gt;participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation-&gt;&gt;participant_writeResultSlot: context.writeResultSlot()
   participant_writeResultSlot-&gt;&gt;participant_writeResultSlot: args.writeResultSlot()
@@ -4864,8 +4904,10 @@ inject it at the runtime boundary.</p>
       <summary>View Mermaid source</summary>
       <pre>sequenceDiagram
   participant participant_createMissingCapabilityExecutorDiagnostic as createMissingCapabilityExecutorDiagnostic
+  participant participant_executeApi as executeApi
   participant participant_executeCapability as executeCapability
   participant participant_executeRuntimeBindingInvocation as executeRuntimeBindingInvocation
+  participant participant_navigate as navigate
   participant participant_resolveBindingInputMap as resolveBindingInputMap
   participant participant_resolveObjectAsync as resolveObjectAsync
   participant participant_writeResultSlot as writeResultSlot
@@ -4876,6 +4918,10 @@ inject it at the runtime boundary.</p>
   participant_resolveObjectAsync--&gt;&gt;participant_resolveBindingInputMap: return
   participant_resolveBindingInputMap--&gt;&gt;participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation-&gt;&gt;participant_executeCapability: context.executeCapability()
+  participant_executeCapability-&gt;&gt;participant_executeApi: executeApi()
+  participant_executeApi--&gt;&gt;participant_executeCapability: return
+  participant_executeCapability-&gt;&gt;participant_navigate: navigate()
+  participant_navigate--&gt;&gt;participant_executeCapability: return
   participant_executeCapability--&gt;&gt;participant_executeRuntimeBindingInvocation: return
   participant_executeRuntimeBindingInvocation-&gt;&gt;participant_writeResultSlot: context.writeResultSlot()
   participant_writeResultSlot-&gt;&gt;participant_writeResultSlot: args.writeResultSlot()
@@ -5577,49 +5623,54 @@ inject it at the runtime boundary.</p>
   </section><section id="view-src-runtimecapabilityexecutor-ts" class="view" data-view="src/runtimeCapabilityExecutor.ts" hidden>
     <section class="panel">
       <h2>src/runtimeCapabilityExecutor.ts</h2>
-      <article class="item" data-search="composeRuntimeCapabilityExecutor src/runtimeCapabilityExecutor.ts Routes API and state capabilities before delegating application-owned capabilities.">
+      <article class="item" data-search="composeRuntimeCapabilityExecutor src/runtimeCapabilityExecutor.ts Keeps local state mutations while preferring the configured host executor for API capabilities.">
     <h3>composeRuntimeCapabilityExecutor</h3>
     <p class="muted"><code>src/runtimeCapabilityExecutor.ts:17:1</code></p>
-    <p>Routes API and state capabilities before delegating application-owned capabilities.</p>
+    <p>Keeps local state mutations while preferring the configured host executor for API capabilities.</p>
+    
+  </article><article class="item" data-search="executeApiCapabilityAsync src/runtimeCapabilityExecutor.ts Uses the host API executor when supplied, falling back to the manifest executor.">
+    <h3>executeApiCapabilityAsync</h3>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:29:1</code></p>
+    <p>Uses the host API executor when supplied, falling back to the manifest executor.</p>
     
   </article><article class="item" data-search="executeStateSetCapabilityAsync src/runtimeCapabilityExecutor.ts Applies one serializable state value through the configured application state adapter.">
     <h3>executeStateSetCapabilityAsync</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:29:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:37:1</code></p>
     <p>Applies one serializable state value through the configured application state adapter.</p>
     
   </article><article class="item" data-search="executeApplicationCapabilityAsync src/runtimeCapabilityExecutor.ts ">
     <h3>executeApplicationCapabilityAsync</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:59:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:67:1</code></p>
     <p class="empty">No description available.</p>
     
   </article><article class="item" data-search="resolveStateSetInput src/runtimeCapabilityExecutor.ts ">
     <h3>resolveStateSetInput</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:76:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:84:1</code></p>
     <p class="empty">No description available.</p>
     
   </article><article class="item" data-search="isStatePath src/runtimeCapabilityExecutor.ts ">
     <h3>isStatePath</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:85:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:93:1</code></p>
     <p class="empty">No description available.</p>
     
   </article><article class="item" data-search="isStateValue src/runtimeCapabilityExecutor.ts ">
     <h3>isStateValue</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:94:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:102:1</code></p>
     <p class="empty">No description available.</p>
     
   </article><article class="item" data-search="stateAdapterSetErrorResult src/runtimeCapabilityExecutor.ts Converts thrown adapter failures into capability diagnostics at the public Runtime boundary.">
     <h3>stateAdapterSetErrorResult</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:102:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:110:1</code></p>
     <p>Converts thrown adapter failures into capability diagnostics at the public Runtime boundary.</p>
     
   </article><article class="item" data-search="missingStateAdapterResult src/runtimeCapabilityExecutor.ts ">
     <h3>missingStateAdapterResult</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:115:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:123:1</code></p>
     <p class="empty">No description available.</p>
     
   </article><article class="item" data-search="invalidStateSetInputResult src/runtimeCapabilityExecutor.ts ">
     <h3>invalidStateSetInputResult</h3>
-    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:128:1</code></p>
+    <p class="muted"><code>src/runtimeCapabilityExecutor.ts:136:1</code></p>
     <p class="empty">No description available.</p>
     
   </article>
@@ -5912,6 +5963,21 @@ inject it at the runtime boundary.</p>
     <p class="muted"><code>src/runtimeRepeatEmptyState.ts:3:1</code></p>
     <p class="empty">No description available.</p>
     
+  </article>
+    </section>
+  </section><section id="view-src-runtimescreen-test-tsx" class="view" data-view="src/RuntimeScreen.test.tsx" hidden>
+    <section class="panel">
+      <h2>src/RuntimeScreen.test.tsx</h2>
+      <article class="item" data-search="ButtonProbe src/RuntimeScreen.test.tsx ">
+    <h3>ButtonProbe</h3>
+    <p class="muted"><code>src/RuntimeScreen.test.tsx:31:7</code></p>
+    <p class="empty">No description available.</p>
+    
+  </article><article class="item" data-search="executeCapability src/RuntimeScreen.test.tsx ">
+    <h3>executeCapability</h3>
+    <p class="muted"><code>src/RuntimeScreen.test.tsx:147:9</code></p>
+    <p class="empty">No description available.</p>
+    
   </article>
     </section>
   </section><section id="view-src-runtimescreen-tsx" class="view" data-view="src/RuntimeScreen.tsx" hidden>

package/paradox/paradox.json

@@ -14,7 +14,7 @@
     {
       "id": "npm",
       "label": "npm",
-      "value": "v5.1.1",
+      "value": "v5.1.3",
       "color": "cb3837"
     },
     {
@@ -713,6 +713,17 @@
         "shouldRenderRuntimeRepeatEmptyState"
       ]
     },
+    {
+      "path": "src/RuntimeScreen.test.tsx",
+      "isEntrypoint": false,
+      "dependencies": [
+        "src/registry.tsx",
+        "src/runtimeApiCapabilities.ts",
+        "src/runtimeBindings.ts",
+        "src/RuntimeRendererConfig.tsx"
+      ],
+      "exports": []
+    },
     {
       "path": "src/RuntimeScreen.tsx",
       "isEntrypoint": false,
@@ -887,7 +898,7 @@
     {
       "name": "composeRuntimeCapabilityExecutor",
       "title": null,
-      "description": "Routes API and state capabilities before delegating application-owned capabilities.",
+      "description": "Keeps local state mutations while preferring the configured host executor for API capabilities.",
       "isReadme": false,
       "see": [],
       "security": [],
@@ -5659,7 +5670,7 @@
     },
     {
       "name": "composeRuntimeCapabilityExecutor",
-      "description": "Routes API and state capabilities before delegating application-owned capabilities.",
+      "description": "Keeps local state mutations while preferring the configured host executor for API capabilities.",
       "see": [],
       "security": [],
       "sourceLocation": {
@@ -5668,6 +5679,17 @@
         "column": 1
       }
     },
+    {
+      "name": "executeApiCapabilityAsync",
+      "description": "Uses the host API executor when supplied, falling back to the manifest executor.",
+      "see": [],
+      "security": [],
+      "sourceLocation": {
+        "filePath": "src/runtimeCapabilityExecutor.ts",
+        "line": 29,
+        "column": 1
+      }
+    },
     {
       "name": "executeStateSetCapabilityAsync",
       "description": "Applies one serializable state value through the configured application state adapter.",
@@ -5675,7 +5697,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 29,
+        "line": 37,
         "column": 1
       }
     },
@@ -5686,7 +5708,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 59,
+        "line": 67,
         "column": 1
       }
     },
@@ -5697,7 +5719,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 76,
+        "line": 84,
         "column": 1
       }
     },
@@ -5708,7 +5730,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 85,
+        "line": 93,
         "column": 1
       }
     },
@@ -5719,7 +5741,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 94,
+        "line": 102,
         "column": 1
       }
     },
@@ -5730,7 +5752,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 102,
+        "line": 110,
         "column": 1
       }
     },
@@ -5741,7 +5763,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 115,
+        "line": 123,
         "column": 1
       }
     },
@@ -5752,7 +5774,7 @@
       "security": [],
       "sourceLocation": {
         "filePath": "src/runtimeCapabilityExecutor.ts",
-        "line": 128,
+        "line": 136,
         "column": 1
       }
     },
@@ -6240,6 +6262,28 @@
         "column": 1
       }
     },
+    {
+      "name": "ButtonProbe",
+      "description": null,
+      "see": [],
+      "security": [],
+      "sourceLocation": {
+        "filePath": "src/RuntimeScreen.test.tsx",
+        "line": 31,
+        "column": 7
+      }
+    },
+    {
+      "name": "executeCapability",
+      "description": null,
+      "see": [],
+      "security": [],
+      "sourceLocation": {
+        "filePath": "src/RuntimeScreen.test.tsx",
+        "line": 147,
+        "column": 9
+      }
+    },
     {
       "name": "RuntimeScreen",
       "description": null,
@@ -6596,7 +6640,7 @@
       "name": "composeRuntimeCapabilityExecutor",
       "sourcePath": "src/runtimeCapabilityExecutor.ts",
       "symbolName": "composeRuntimeCapabilityExecutor",
-      "description": "Routes API and state capabilities before delegating application-owned capabilities.",
+      "description": "Keeps local state mutations while preferring the configured host executor for API capabilities.",
       "isReadme": false
     },
     {
@@ -7285,6 +7329,26 @@
         "toPath": "src/runtimeBindings.ts",
         "sourcePath": "src/runtimeRepeat.ts"
       },
+      {
+        "fromPath": "src/RuntimeScreen.test.tsx",
+        "toPath": "src/registry.tsx",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromPath": "src/RuntimeScreen.test.tsx",
+        "toPath": "src/runtimeApiCapabilities.ts",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromPath": "src/RuntimeScreen.test.tsx",
+        "toPath": "src/runtimeBindings.ts",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromPath": "src/RuntimeScreen.test.tsx",
+        "toPath": "src/RuntimeRendererConfig.tsx",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
       {
         "fromPath": "src/RuntimeScreen.tsx",
         "toPath": "src/ManifestContext.tsx",
@@ -8006,6 +8070,12 @@
         "callExpression": "expect",
         "sourcePath": "src/runtimeCapabilityExecutor.test.ts"
       },
+      {
+        "fromSymbol": "src/runtimeCapabilityExecutor.test.ts",
+        "toSymbol": "executeCapability",
+        "callExpression": "executeCapability",
+        "sourcePath": "src/runtimeCapabilityExecutor.test.ts"
+      },
       {
         "fromSymbol": "src/runtimeCapabilityExecutor.test.ts",
         "toSymbol": "createRuntimeMemoryStateAdapter",
@@ -8024,22 +8094,16 @@
         "callExpression": "resolveRuntimeNodeProps",
         "sourcePath": "src/runtimeCapabilityExecutor.test.ts"
       },
-      {
-        "fromSymbol": "src/runtimeCapabilityExecutor.test.ts",
-        "toSymbol": "executeCapability",
-        "callExpression": "executeCapability",
-        "sourcePath": "src/runtimeCapabilityExecutor.test.ts"
-      },
       {
         "fromSymbol": "src/runtimeCapabilityExecutor.ts",
-        "toSymbol": "apiCapabilityExecutor",
-        "callExpression": "composition.apiCapabilityExecutor",
+        "toSymbol": "executeStateSetCapabilityAsync",
+        "callExpression": "executeStateSetCapabilityAsync",
         "sourcePath": "src/runtimeCapabilityExecutor.ts"
       },
       {
         "fromSymbol": "src/runtimeCapabilityExecutor.ts",
-        "toSymbol": "executeStateSetCapabilityAsync",
-        "callExpression": "executeStateSetCapabilityAsync",
+        "toSymbol": "executeApiCapabilityAsync",
+        "callExpression": "executeApiCapabilityAsync",
         "sourcePath": "src/runtimeCapabilityExecutor.ts"
       },
       {
@@ -8048,6 +8112,18 @@
         "callExpression": "executeApplicationCapabilityAsync",
         "sourcePath": "src/runtimeCapabilityExecutor.ts"
       },
+      {
+        "fromSymbol": "executeApiCapabilityAsync",
+        "toSymbol": "capabilityExecutor",
+        "callExpression": "composition.capabilityExecutor",
+        "sourcePath": "src/runtimeCapabilityExecutor.ts"
+      },
+      {
+        "fromSymbol": "executeApiCapabilityAsync",
+        "toSymbol": "apiCapabilityExecutor",
+        "callExpression": "composition.apiCapabilityExecutor",
+        "sourcePath": "src/runtimeCapabilityExecutor.ts"
+      },
       {
         "fromSymbol": "executeStateSetCapabilityAsync",
         "toSymbol": "missingStateAdapterResult",
@@ -8690,6 +8766,60 @@
         "callExpression": "readRepeatPrimitive",
         "sourcePath": "src/runtimeRepeat.ts"
       },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "it",
+        "callExpression": "it",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "mock",
+        "callExpression": "mock",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "createRuntimeApiCapabilityExecutor",
+        "callExpression": "createRuntimeApiCapabilityExecutor",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "executeCapability",
+        "toSymbol": "executeApi",
+        "callExpression": "executeApi",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "executeCapability",
+        "toSymbol": "navigate",
+        "callExpression": "navigate",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "act",
+        "callExpression": "act",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "create",
+        "callExpression": "create",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "expect",
+        "callExpression": "expect",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
+      {
+        "fromSymbol": "src/RuntimeScreen.test.tsx",
+        "toSymbol": "pressLevel",
+        "callExpression": "pressLevel",
+        "sourcePath": "src/RuntimeScreen.test.tsx"
+      },
       {
         "fromSymbol": "RuntimeScreen",
         "toSymbol": "useRuntimeRendererConfig",