@ankhorage/runtime 1.0.0 → 1.1.0

package/dist/runtimeMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMedia.js","sourceRoot":"","sources":["../src/runtimeMedia.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isMediaAssetReference,\n  type MediaAsset,\n  type MediaAssetRegistry,\n} from '@ankhorage/contracts';\n\nexport type RuntimeResolvedMediaValue = string | number | Readonly<Record<string, unknown>>;\n\nexport interface RuntimeMediaAssetResolverArgs {\n  readonly asset: MediaAsset;\n}\n\nexport type RuntimeMediaAssetResolver = (\n  args: RuntimeMediaAssetResolverArgs,\n) => Promise<RuntimeResolvedMediaValue | null> | RuntimeResolvedMediaValue | null;\n\nexport type RuntimeMediaResolutionCache = WeakMap<\n  MediaAsset,\n  WeakMap<RuntimeMediaAssetResolver, Promise<RuntimeResolvedMediaValue | null>>\n>;\n\nconst OMIT_MEDIA_VALUE = Symbol('omit-runtime-media-value');\n\nexport function createRuntimeMediaResolutionCache(): RuntimeMediaResolutionCache {\n  return new WeakMap();\n}\n\nexport function collectRuntimeMediaReferenceIds(value: unknown): readonly string[] {\n  const ids = new Set<string>();\n  collectMediaReferenceIds(value, ids);\n  return [...ids].sort();\n}\n\nexport function replaceRuntimeMediaReferences(\n  value: unknown,\n  resolvedById: ReadonlyMap<string, RuntimeResolvedMediaValue>,\n): unknown {\n  const replaced = replaceMediaValue(value, resolvedById);\n  return replaced === OMIT_MEDIA_VALUE ? undefined : replaced;\n}\n\nexport function resolveRuntimeMediaAsset(\n  asset: MediaAsset,\n  resolver: RuntimeMediaAssetResolver | undefined,\n  cache: RuntimeMediaResolutionCache,\n): Promise<RuntimeResolvedMediaValue | null> {\n  if (asset.source.kind === 'url') return Promise.resolve(asset.source.url);\n  if (!resolver) return Promise.resolve(null);\n\n  let resolverCache = cache.get(asset);\n  if (!resolverCache) {\n    resolverCache = new WeakMap();\n    cache.set(asset, resolverCache);\n  }\n\n  const cached = resolverCache.get(resolver);\n  if (cached) return cached;\n\n  const pending = Promise.resolve(resolver({ asset })).catch(() => null);\n  resolverCache.set(resolver, pending);\n  return pending;\n}\n\nexport function createSyncRuntimeMediaResolutionMap(\n  ids: readonly string[],\n  mediaAssets: MediaAssetRegistry | undefined,\n): Map<string, RuntimeResolvedMediaValue> {\n  const resolved = new Map<string, RuntimeResolvedMediaValue>();\n\n  for (const id of ids) {\n    const asset = mediaAssets?.[id];\n    if (asset?.source.kind === 'url') resolved.set(id, asset.source.url);\n  }\n\n  return resolved;\n}\n\nfunction collectMediaReferenceIds(value: unknown, ids: Set<string>): void {\n  if (isMediaAssetReference(value)) {\n    ids.add(value.mediaId.trim());\n    return;\n  }\n\n  if (Array.isArray(value)) {\n    value.forEach((item) => collectMediaReferenceIds(item, ids));\n    return;\n  }\n\n  if (!isPlainObject(value)) return;\n  Object.values(value).forEach((item) => collectMediaReferenceIds(item, ids));\n}\n\nfunction replaceMediaValue(\n  value: unknown,\n  resolvedById: ReadonlyMap<string, RuntimeResolvedMediaValue>,\n): unknown {\n  if (isMediaAssetReference(value)) {\n    return resolvedById.get(value.mediaId.trim()) ?? OMIT_MEDIA_VALUE;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => {\n      const replaced = replaceMediaValue(item, resolvedById);\n      return replaced === OMIT_MEDIA_VALUE ? undefined : replaced;\n    });\n  }\n\n  if (!isPlainObject(value)) return value;\n\n  const result: Record<string, unknown> = {};\n  for (const [key, item] of Object.entries(value)) {\n    const replaced = replaceMediaValue(item, resolvedById);\n    if (replaced !== OMIT_MEDIA_VALUE) result[key] = replaced;\n  }\n  return result;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false;\n  const prototype = Reflect.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n"]}

package/dist/runtimeMediaCache.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import { type RuntimeMediaResolutionCache } from './runtimeMedia';
+export declare function useRuntimeMediaResolutionCache(): RuntimeMediaResolutionCache;
+export declare function RuntimeMediaResolutionCacheProvider(props: {
+    readonly value: RuntimeMediaResolutionCache;
+    readonly children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=runtimeMediaCache.d.ts.map

package/dist/runtimeMediaCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMediaCache.d.ts","sourceRoot":"","sources":["../src/runtimeMediaCache.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAElE,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,gBAAgB,CAAC;AAIxB,wBAAgB,8BAA8B,IAAI,2BAA2B,CAI5E;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE;IACzD,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CACpC,qBAMA"}

package/dist/runtimeMediaCache.js

@@ -0,0 +1,14 @@
+import React, { createContext, useContext, useMemo } from 'react';
+import { createRuntimeMediaResolutionCache, } from './runtimeMedia';
+const RuntimeMediaCacheContext = createContext(null);
+export function useRuntimeMediaResolutionCache() {
+    const inherited = useContext(RuntimeMediaCacheContext);
+    const local = useMemo(() => createRuntimeMediaResolutionCache(), []);
+    return inherited ?? local;
+}
+export function RuntimeMediaResolutionCacheProvider(props) {
+    return (<RuntimeMediaCacheContext.Provider value={props.value}>
+      {props.children}
+    </RuntimeMediaCacheContext.Provider>);
+}
+//# sourceMappingURL=runtimeMediaCache.js.map

package/dist/runtimeMediaCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeMediaCache.js","sourceRoot":"","sources":["../src/runtimeMediaCache.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAElE,OAAO,EACL,iCAAiC,GAElC,MAAM,gBAAgB,CAAC;AAExB,MAAM,wBAAwB,GAAG,aAAa,CAAqC,IAAI,CAAC,CAAC;AAEzF,MAAM,UAAU,8BAA8B;IAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iCAAiC,EAAE,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,SAAS,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,KAGnD;IACC,OAAO,CACL,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CACpD;MAAA,CAAC,KAAK,CAAC,QAAQ,CACjB;IAAA,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CACrC,CAAC;AACJ,CAAC","sourcesContent":["import React, { createContext, useContext, useMemo } from 'react';\n\nimport {\n  createRuntimeMediaResolutionCache,\n  type RuntimeMediaResolutionCache,\n} from './runtimeMedia';\n\nconst RuntimeMediaCacheContext = createContext<RuntimeMediaResolutionCache | null>(null);\n\nexport function useRuntimeMediaResolutionCache(): RuntimeMediaResolutionCache {\n  const inherited = useContext(RuntimeMediaCacheContext);\n  const local = useMemo(() => createRuntimeMediaResolutionCache(), []);\n  return inherited ?? local;\n}\n\nexport function RuntimeMediaResolutionCacheProvider(props: {\n  readonly value: RuntimeMediaResolutionCache;\n  readonly children: React.ReactNode;\n}) {\n  return (\n    <RuntimeMediaCacheContext.Provider value={props.value}>\n      {props.children}\n    </RuntimeMediaCacheContext.Provider>\n  );\n}\n"]}

package/dist/useRuntimeMediaProps.d.ts

@@ -0,0 +1,9 @@
+import type { MediaAssetRegistry } from '@ankhorage/contracts';
+import { type RuntimeMediaAssetResolver, type RuntimeMediaResolutionCache } from './runtimeMedia';
+export declare function useRuntimeMediaProps(args: {
+    readonly props: Record<string, unknown>;
+    readonly mediaAssets?: MediaAssetRegistry;
+    readonly resolveMediaAsset?: RuntimeMediaAssetResolver;
+    readonly cache: RuntimeMediaResolutionCache;
+}): Record<string, unknown>;
+//# sourceMappingURL=useRuntimeMediaProps.d.ts.map

package/dist/useRuntimeMediaProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuntimeMediaProps.d.ts","sourceRoot":"","sources":["../src/useRuntimeMediaProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/D,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAEjC,MAAM,gBAAgB,CAAC;AAExB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;CAC7C,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyC1B"}

package/dist/useRuntimeMediaProps.js

@@ -0,0 +1,61 @@
+import React from 'react';
+import { collectRuntimeMediaReferenceIds, createSyncRuntimeMediaResolutionMap, replaceRuntimeMediaReferences, resolveRuntimeMediaAsset, } from './runtimeMedia';
+export function useRuntimeMediaProps(args) {
+    const ids = collectRuntimeMediaReferenceIds(args.props);
+    const idsKey = ids.join('\u0000');
+    const [asyncResolved, setAsyncResolved] = React.useState(() => new Map());
+    React.useEffect(() => {
+        let active = true;
+        const effectIds = idsKey.length === 0 ? [] : idsKey.split('\u0000');
+        const currentIds = new Set(effectIds);
+        setAsyncResolved((current) => filterResolvedValues(current, currentIds));
+        for (const id of effectIds) {
+            const asset = args.mediaAssets?.[id];
+            if (!asset || asset.source.kind === 'url')
+                continue;
+            void resolveRuntimeMediaAsset(asset, args.resolveMediaAsset, args.cache).then((value) => {
+                if (!active || value === null)
+                    return;
+                setAsyncResolved((current) => {
+                    if (current.get(id) === value)
+                        return current;
+                    const next = new Map(current);
+                    next.set(id, value);
+                    return next;
+                });
+            });
+        }
+        return () => {
+            active = false;
+        };
+    }, [args.cache, args.mediaAssets, args.resolveMediaAsset, idsKey]);
+    const resolved = createSyncRuntimeMediaResolutionMap(ids, args.mediaAssets);
+    const currentIds = new Set(ids);
+    asyncResolved.forEach((value, id) => {
+        if (currentIds.has(id))
+            resolved.set(id, value);
+    });
+    const replaced = replaceRuntimeMediaReferences(args.props, resolved);
+    return isRecord(replaced) ? replaced : {};
+}
+function filterResolvedValues(current, ids) {
+    const next = new Map();
+    current.forEach((value, id) => {
+        if (ids.has(id))
+            next.set(id, value);
+    });
+    return mapsEqual(current, next) ? current : next;
+}
+function mapsEqual(left, right) {
+    if (left.size !== right.size)
+        return false;
+    for (const [key, value] of left) {
+        if (right.get(key) !== value)
+            return false;
+    }
+    return true;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=useRuntimeMediaProps.js.map

package/dist/useRuntimeMediaProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRuntimeMediaProps.js","sourceRoot":"","sources":["../src/useRuntimeMediaProps.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaAssetRegistry } from '@ankhorage/contracts';\nimport React from 'react';\n\nimport {\n  collectRuntimeMediaReferenceIds,\n  createSyncRuntimeMediaResolutionMap,\n  replaceRuntimeMediaReferences,\n  resolveRuntimeMediaAsset,\n  type RuntimeMediaAssetResolver,\n  type RuntimeMediaResolutionCache,\n  type RuntimeResolvedMediaValue,\n} from './runtimeMedia';\n\nexport function useRuntimeMediaProps(args: {\n  readonly props: Record<string, unknown>;\n  readonly mediaAssets?: MediaAssetRegistry;\n  readonly resolveMediaAsset?: RuntimeMediaAssetResolver;\n  readonly cache: RuntimeMediaResolutionCache;\n}): Record<string, unknown> {\n  const ids = collectRuntimeMediaReferenceIds(args.props);\n  const idsKey = ids.join('\\u0000');\n  const [asyncResolved, setAsyncResolved] = React.useState(\n    () => new Map<string, RuntimeResolvedMediaValue>(),\n  );\n\n  React.useEffect(() => {\n    let active = true;\n    const effectIds = idsKey.length === 0 ? [] : idsKey.split('\\u0000');\n    const currentIds = new Set(effectIds);\n    setAsyncResolved((current) => filterResolvedValues(current, currentIds));\n\n    for (const id of effectIds) {\n      const asset = args.mediaAssets?.[id];\n      if (!asset || asset.source.kind === 'url') continue;\n\n      void resolveRuntimeMediaAsset(asset, args.resolveMediaAsset, args.cache).then((value) => {\n        if (!active || value === null) return;\n        setAsyncResolved((current) => {\n          if (current.get(id) === value) return current;\n          const next = new Map(current);\n          next.set(id, value);\n          return next;\n        });\n      });\n    }\n\n    return () => {\n      active = false;\n    };\n  }, [args.cache, args.mediaAssets, args.resolveMediaAsset, idsKey]);\n\n  const resolved = createSyncRuntimeMediaResolutionMap(ids, args.mediaAssets);\n  const currentIds = new Set(ids);\n  asyncResolved.forEach((value, id) => {\n    if (currentIds.has(id)) resolved.set(id, value);\n  });\n\n  const replaced = replaceRuntimeMediaReferences(args.props, resolved);\n  return isRecord(replaced) ? replaced : {};\n}\n\nfunction filterResolvedValues(\n  current: Map<string, RuntimeResolvedMediaValue>,\n  ids: ReadonlySet<string>,\n): Map<string, RuntimeResolvedMediaValue> {\n  const next = new Map<string, RuntimeResolvedMediaValue>();\n  current.forEach((value, id) => {\n    if (ids.has(id)) next.set(id, value);\n  });\n  return mapsEqual(current, next) ? current : next;\n}\n\nfunction mapsEqual(\n  left: ReadonlyMap<string, RuntimeResolvedMediaValue>,\n  right: ReadonlyMap<string, RuntimeResolvedMediaValue>,\n): boolean {\n  if (left.size !== right.size) return false;\n  for (const [key, value] of left) {\n    if (right.get(key) !== value) return false;\n  }\n  return true;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/runtime",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Platform-neutral runtime renderer, contracts, and helpers for Ankhorage generated apps.",
   "license": "MIT",
   "publishConfig": {
@@ -19,6 +19,7 @@
     "runtime",
     "manifest",
     "bindings",
+    "media",
     "adapters",
     "typescript"
   ],
@@ -59,7 +60,7 @@
     "version-packages": "changeset version"
   },
   "dependencies": {
-    "@ankhorage/contracts": "^4.0.2",
+    "@ankhorage/contracts": "^7.4.0",
     "@ankhorage/data-sources": "^1.0.0"
   },
   "peerDependencies": {
@@ -68,7 +69,7 @@
   },
   "devDependencies": {
     "@ankhorage/devtools": "^1.0.6",
-    "@ankhorage/paradox": "^0.1.10",
+    "@ankhorage/paradox": "^0.1.21",
     "@changesets/cli": "^2.31.0",
     "@types/bun": "^1.3.13",
     "@types/node": "^25.6.0",

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: v0.3.0">
-<title>npm: v0.3.0</title>
+<svg xmlns="http://www.w3.org/2000/svg" width="90" height="20" role="img" aria-label="npm: v1.0.0">
+<title>npm: v1.0.0</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">v0.3.0</text>
+<text x="64" y="14" fill="#ffffff" font-family="Verdana,Geneva,DejaVu Sans,sans-serif" font-size="11" text-anchor="middle">v1.0.0</text>
 </svg>

package/paradox/components.md

@@ -26,7 +26,7 @@ Export paths: `src/index.ts`
 
 ## RuntimeRenderer
 
-Source: `src/RuntimeRenderer.tsx:67:1`
+Source: `src/RuntimeRenderer.tsx:76:1`
 
 Export paths: `src/index.ts`
 
@@ -41,16 +41,18 @@ Export paths: `src/index.ts`
 | executeAction     | `RuntimeActionExecutor \| undefined`                                  | no       | —       |             |
 | executeOperation  | `RuntimeBindingOperationExecutor \| undefined`                        | no       | —       |             |
 | isRoot            | `boolean \| undefined`                                                | no       | —       |             |
+| mediaAssets       | `MediaAssetRegistry \| undefined`                                     | no       | —       |             |
 | node              | `UiNode`                                                              | yes      | —       |             |
 | onDiagnostics     | `(diagnostics: readonly DataSourceDiagnostic[]) => void \| undefined` | no       | —       |             |
 | operationResults  | `RuntimeBindingOperationResultCache \| undefined`                     | no       | —       |             |
 | registry          | `ComponentRegistry \| undefined`                                      | no       | —       |             |
+| resolveMediaAsset | `RuntimeMediaAssetResolver \| undefined`                              | no       | —       |             |
 | stateAdapter      | `StateAdapter \| undefined`                                           | no       | —       |             |
 | wrapNode          | `(args: RuntimeRendererWrapArgs) => React.ReactNode \| undefined`     | no       | —       |             |
 
 ## RuntimeRendererConfigProvider
 
-Source: `src/RuntimeRendererConfig.tsx:152:1`
+Source: `src/RuntimeRendererConfig.tsx:158:1`
 
 Export paths: `src/index.ts`
 

package/paradox/diagrams/architecture-overview.mmd

@@ -61,6 +61,17 @@ graph TD
   module_src_runtimeEventExecution_ts --> module_src_RuntimeRendererConfig_tsx
   module_src_runtimeManifest_ts["src/runtimeManifest.ts"]
   package__ankhorage_runtime -.-> module_src_runtimeManifest_ts
+  module_src_runtimeMedia_test_ts["src/runtimeMedia.test.ts"]
+  package__ankhorage_runtime -.-> module_src_runtimeMedia_test_ts
+  module_src_runtimeMedia_test_ts --> module_src_runtimeMedia_ts
+  module_src_runtimeMedia_ts["src/runtimeMedia.ts"]
+  package__ankhorage_runtime -.-> module_src_runtimeMedia_ts
+  module_src_runtimeMediaCache_tsx["src/runtimeMediaCache.tsx"]
+  package__ankhorage_runtime -.-> module_src_runtimeMediaCache_tsx
+  module_src_runtimeMediaCache_tsx --> module_src_runtimeMedia_ts
+  module_src_runtimeMediaConfig_test_ts["src/runtimeMediaConfig.test.ts"]
+  package__ankhorage_runtime -.-> module_src_runtimeMediaConfig_test_ts
+  module_src_runtimeMediaConfig_test_ts --> module_src_RuntimeRendererConfig_tsx
   module_src_runtimeNodeProps_test_ts["src/runtimeNodeProps.test.ts"]
   package__ankhorage_runtime -.-> module_src_runtimeNodeProps_test_ts
   module_src_runtimeNodeProps_test_ts --> module_src_runtimeNodeProps_ts
@@ -81,11 +92,14 @@ graph TD
   module_src_RuntimeRenderer_tsx --> module_src_runtimeBindings_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeDbPersist_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeEventExecution_ts
+  module_src_RuntimeRenderer_tsx --> module_src_runtimeMedia_ts
+  module_src_RuntimeRenderer_tsx --> module_src_runtimeMediaCache_tsx
   module_src_RuntimeRenderer_tsx --> module_src_runtimeNodeProps_ts
   module_src_RuntimeRenderer_tsx --> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeat_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeatDiagnostics_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeatEmptyState_ts
+  module_src_RuntimeRenderer_tsx --> module_src_useRuntimeMediaProps_ts
   module_src_RuntimeRendererConfig_test_tsx["src/RuntimeRendererConfig.test.tsx"]
   package__ankhorage_runtime -.-> module_src_RuntimeRendererConfig_test_tsx
   module_src_RuntimeRendererConfig_test_tsx --> module_src_RuntimeRendererConfig_tsx
@@ -93,6 +107,7 @@ graph TD
   package__ankhorage_runtime -.-> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeRendererConfig_tsx --> module_src_registry_tsx
   module_src_RuntimeRendererConfig_tsx --> module_src_runtimeBindings_ts
+  module_src_RuntimeRendererConfig_tsx --> module_src_runtimeMedia_ts
   module_src_runtimeRepeat_test_ts["src/runtimeRepeat.test.ts"]
   package__ankhorage_runtime -.-> module_src_runtimeRepeat_test_ts
   module_src_runtimeRepeat_test_ts --> module_src_runtimeActionRegistry_ts
@@ -130,6 +145,9 @@ graph TD
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_runtimeBindings_ts
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_runtimeNodeProps_ts
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_RuntimeRendererConfig_tsx
+  module_src_useRuntimeMediaProps_ts["src/useRuntimeMediaProps.ts"]
+  package__ankhorage_runtime -.-> module_src_useRuntimeMediaProps_ts
+  module_src_useRuntimeMediaProps_ts --> module_src_runtimeMedia_ts
   module_tests_runtime_test_ts["tests/runtime.test.ts"]
   package__ankhorage_runtime -.-> module_tests_runtime_test_ts
   module_tests_runtime_test_ts --> module_src_runtimeManifest_ts

package/paradox/diagrams/export-graph.mmd

@@ -19,6 +19,10 @@ graph LR
   module_src_runtimeEventExecution_test_ts["src/runtimeEventExecution.test.ts"]
   module_src_runtimeEventExecution_ts["src/runtimeEventExecution.ts"]
   module_src_runtimeManifest_ts["src/runtimeManifest.ts"]
+  module_src_runtimeMedia_test_ts["src/runtimeMedia.test.ts"]
+  module_src_runtimeMedia_ts["src/runtimeMedia.ts"]
+  module_src_runtimeMediaCache_tsx["src/runtimeMediaCache.tsx"]
+  module_src_runtimeMediaConfig_test_ts["src/runtimeMediaConfig.test.ts"]
   module_src_runtimeNodeProps_test_ts["src/runtimeNodeProps.test.ts"]
   module_src_runtimeNodeProps_ts["src/runtimeNodeProps.ts"]
   module_src_runtimePackageIsolation_test_ts["src/runtimePackageIsolation.test.ts"]
@@ -36,6 +40,7 @@ graph LR
   module_src_runtimeScreenLoaders_ts["src/runtimeScreenLoaders.ts"]
   module_src_runtimeStateAdapter_ts["src/runtimeStateAdapter.ts"]
   module_src_runtimeStateAdapterConfig_test_ts["src/runtimeStateAdapterConfig.test.ts"]
+  module_src_useRuntimeMediaProps_ts["src/useRuntimeMediaProps.ts"]
   module_tests_runtime_test_ts["tests/runtime.test.ts"]
   export_ComponentRegistry["ComponentRegistry"]
   module_src_componentRegistry_ts --> export_ComponentRegistry
@@ -73,25 +78,12 @@ graph LR
   module_src_runtimeDataSourceOperations_ts --> export_createRuntimeDataSourceOperationExecutor
   export_createRuntimeDataSourceOperationExecutor -.-> export_RuntimeBindingOperationExecutor
   export_createRuntimeDataSourceOperationExecutor -.-> export_RuntimeDataSourceOperationExecutorOptions
-  export_createRuntimeManifest["createRuntimeManifest"]
-  module_src_runtimeManifest_ts --> export_createRuntimeManifest
-  export_createRuntimeManifest -.-> export_RuntimeManifest
-  export_createRuntimeManifest -.-> export_RuntimeManifestInput
   export_createRuntimeMemoryStateAdapter["createRuntimeMemoryStateAdapter"]
   module_src_runtimeStateAdapter_ts --> export_createRuntimeMemoryStateAdapter
   export_createRuntimeMemoryStateAdapter -.-> export_RuntimeMemoryStateAdapterOptions
   export_createRuntimeScreenLoaderRequestKey["createRuntimeScreenLoaderRequestKey"]
   module_src_runtimeScreenLoaders_ts --> export_createRuntimeScreenLoaderRequestKey
   export_createRuntimeScreenLoaderRequestKey -.-> export_RuntimeBindingOperationResultCache
-  export_defineRuntimeAction["defineRuntimeAction"]
-  module_src_runtimeManifest_ts --> export_defineRuntimeAction
-  export_defineRuntimeAction -.-> export_RuntimeActionDescriptor
-  export_defineRuntimeAdapter["defineRuntimeAdapter"]
-  module_src_runtimeManifest_ts --> export_defineRuntimeAdapter
-  export_defineRuntimeAdapter -.-> export_RuntimeAdapterDescriptor
-  export_defineRuntimeBinding["defineRuntimeBinding"]
-  module_src_runtimeManifest_ts --> export_defineRuntimeBinding
-  export_defineRuntimeBinding -.-> export_RuntimeBindingDescriptor
   export_dispatchRuntimeComponentEvent["dispatchRuntimeComponentEvent"]
   module_src_runtimeActionRegistry_ts --> export_dispatchRuntimeComponentEvent
   export_dispatchRuntimeComponentEvent -.-> export_RuntimeActionHandlers
@@ -111,8 +103,6 @@ graph LR
   export_executeRuntimeScreenOperationLoaders -.-> export_RuntimeBindingOperationResultCache
   export_executeRuntimeScreenOperationLoaders -.-> export_RuntimeBindingResolutionContext
   export_executeRuntimeScreenOperationLoaders -.-> export_RuntimeScreenOperationLoaderExecutionResult
-  export_listRuntimeCapabilities["listRuntimeCapabilities"]
-  module_src_runtimeManifest_ts --> export_listRuntimeCapabilities
   export_ManifestContext["ManifestContext"]
   module_src_ManifestContext_tsx --> export_ManifestContext
   export_ManifestProvider["ManifestProvider"]
@@ -148,10 +138,6 @@ graph LR
   export_resolveRuntimeBindingValueSync -.-> export_RuntimeBindingResolutionContext
   export_resolveScreenOperationLoaders["resolveScreenOperationLoaders"]
   module_src_runtimeScreenLoaders_ts --> export_resolveScreenOperationLoaders
-  export_RUNTIME_CAPABILITIES["RUNTIME_CAPABILITIES"]
-  module_src_runtimeManifest_ts --> export_RUNTIME_CAPABILITIES
-  export_RUNTIME_MANIFEST_KIND["RUNTIME_MANIFEST_KIND"]
-  module_src_runtimeManifest_ts --> export_RUNTIME_MANIFEST_KIND
   export_RuntimeAction["RuntimeAction"]
   module_src_RuntimeRendererConfig_tsx --> export_RuntimeAction
   export_RuntimeActionDescriptor["RuntimeActionDescriptor"]
@@ -235,6 +221,10 @@ graph LR
   export_RuntimeManifestInput -.-> export_RuntimeBindingDescriptor
   export_RuntimeManifestInput -.-> export_RuntimeDiagnostic
   export_RuntimeManifestInput -.-> export_RuntimeManifestConfig
+  export_RuntimeMediaAssetResolver["RuntimeMediaAssetResolver"]
+  module_src_runtimeMedia_ts --> export_RuntimeMediaAssetResolver
+  export_RuntimeMediaAssetResolverArgs["RuntimeMediaAssetResolverArgs"]
+  module_src_runtimeMedia_ts --> export_RuntimeMediaAssetResolverArgs
   export_RuntimeMemoryStateAdapterOptions["RuntimeMemoryStateAdapterOptions"]
   module_src_runtimeStateAdapter_ts --> export_RuntimeMemoryStateAdapterOptions
   export_RuntimeNodePropsResolver["RuntimeNodePropsResolver"]
@@ -248,6 +238,7 @@ graph LR
   export_RuntimeRendererConfig -.-> export_RuntimeActionHandlers
   export_RuntimeRendererConfig -.-> export_RuntimeBindingOperationExecutor
   export_RuntimeRendererConfig -.-> export_RuntimeBindingOperationResultWriter
+  export_RuntimeRendererConfig -.-> export_RuntimeMediaAssetResolver
   export_RuntimeRendererConfig -.-> export_RuntimeNodePropsResolver
   export_RuntimeRendererConfig -.-> export_RuntimeRendererWrapArgs
   export_RuntimeRendererConfigProvider["RuntimeRendererConfigProvider"]
@@ -257,10 +248,13 @@ graph LR
   module_src_RuntimeRenderer_tsx --> export_RuntimeRendererProps
   export_RuntimeRendererProps -.-> export_RuntimeActionHandler
   export_RuntimeRendererProps -.-> export_RuntimeBindingOperationExecutor
+  export_RuntimeRendererProps -.-> export_RuntimeMediaAssetResolver
   export_RuntimeRendererProps -.-> export_RuntimeRendererConfig
   export_RuntimeRendererProps -.-> export_RuntimeRendererWrapArgs
   export_RuntimeRendererWrapArgs["RuntimeRendererWrapArgs"]
   module_src_RuntimeRendererConfig_tsx --> export_RuntimeRendererWrapArgs
+  export_RuntimeResolvedMediaValue["RuntimeResolvedMediaValue"]
+  module_src_runtimeMedia_ts --> export_RuntimeResolvedMediaValue
   export_RuntimeResolveNodePropsArgs["RuntimeResolveNodePropsArgs"]
   module_node_modules__ankhorage_contracts_dist_runtimeCallbacks_d_ts --> export_RuntimeResolveNodePropsArgs
   export_RuntimeScreen["RuntimeScreen"]

package/paradox/diagrams/module-relationships.mmd

@@ -19,6 +19,10 @@ graph LR
   module_src_runtimeEventExecution_test_ts["src/runtimeEventExecution.test.ts"]
   module_src_runtimeEventExecution_ts["src/runtimeEventExecution.ts"]
   module_src_runtimeManifest_ts["src/runtimeManifest.ts"]
+  module_src_runtimeMedia_test_ts["src/runtimeMedia.test.ts"]
+  module_src_runtimeMedia_ts["src/runtimeMedia.ts"]
+  module_src_runtimeMediaCache_tsx["src/runtimeMediaCache.tsx"]
+  module_src_runtimeMediaConfig_test_ts["src/runtimeMediaConfig.test.ts"]
   module_src_runtimeNodeProps_test_ts["src/runtimeNodeProps.test.ts"]
   module_src_runtimeNodeProps_ts["src/runtimeNodeProps.ts"]
   module_src_runtimePackageIsolation_test_ts["src/runtimePackageIsolation.test.ts"]
@@ -36,6 +40,7 @@ graph LR
   module_src_runtimeScreenLoaders_ts["src/runtimeScreenLoaders.ts"]
   module_src_runtimeStateAdapter_ts["src/runtimeStateAdapter.ts"]
   module_src_runtimeStateAdapterConfig_test_ts["src/runtimeStateAdapterConfig.test.ts"]
+  module_src_useRuntimeMediaProps_ts["src/useRuntimeMediaProps.ts"]
   module_tests_runtime_test_ts["tests/runtime.test.ts"]
   module_src_registry_test_ts --> module_src_registry_tsx
   module_src_rendering_test_ts --> module_src_registry_tsx
@@ -57,6 +62,9 @@ graph LR
   module_src_runtimeEventExecution_test_ts --> module_src_runtimeEventExecution_ts
   module_src_runtimeEventExecution_ts --> module_src_runtimeActionRegistry_ts
   module_src_runtimeEventExecution_ts --> module_src_RuntimeRendererConfig_tsx
+  module_src_runtimeMedia_test_ts --> module_src_runtimeMedia_ts
+  module_src_runtimeMediaCache_tsx --> module_src_runtimeMedia_ts
+  module_src_runtimeMediaConfig_test_ts --> module_src_RuntimeRendererConfig_tsx
   module_src_runtimeNodeProps_test_ts --> module_src_runtimeNodeProps_ts
   module_src_runtimeNodeProps_ts --> module_src_runtimeBindings_ts
   module_src_runtimeNodeProps_ts --> module_src_RuntimeRendererConfig_tsx
@@ -67,14 +75,18 @@ graph LR
   module_src_RuntimeRenderer_tsx --> module_src_runtimeBindings_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeDbPersist_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeEventExecution_ts
+  module_src_RuntimeRenderer_tsx --> module_src_runtimeMedia_ts
+  module_src_RuntimeRenderer_tsx --> module_src_runtimeMediaCache_tsx
   module_src_RuntimeRenderer_tsx --> module_src_runtimeNodeProps_ts
   module_src_RuntimeRenderer_tsx --> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeat_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeatDiagnostics_ts
   module_src_RuntimeRenderer_tsx --> module_src_runtimeRepeatEmptyState_ts
+  module_src_RuntimeRenderer_tsx --> module_src_useRuntimeMediaProps_ts
   module_src_RuntimeRendererConfig_test_tsx --> module_src_RuntimeRendererConfig_tsx
   module_src_RuntimeRendererConfig_tsx --> module_src_registry_tsx
   module_src_RuntimeRendererConfig_tsx --> module_src_runtimeBindings_ts
+  module_src_RuntimeRendererConfig_tsx --> module_src_runtimeMedia_ts
   module_src_runtimeRepeat_test_ts --> module_src_runtimeActionRegistry_ts
   module_src_runtimeRepeat_test_ts --> module_src_runtimeBindings_ts
   module_src_runtimeRepeat_test_ts --> module_src_runtimeRepeat_ts
@@ -92,4 +104,5 @@ graph LR
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_runtimeBindings_ts
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_runtimeNodeProps_ts
   module_src_runtimeStateAdapterConfig_test_ts --> module_src_RuntimeRendererConfig_tsx
+  module_src_useRuntimeMediaProps_ts --> module_src_runtimeMedia_ts
   module_tests_runtime_test_ts --> module_src_runtimeManifest_ts