@ankhorage/studio 6.0.2 → 7.0.0

package/dist/manifestState.js

@@ -48,7 +48,7 @@ export const DEFAULT_STUDIO_SCREEN_TEMPLATE = {
 };
 /***
  * Generate a Studio manifest-state identifier from the current time, randomness, and optional prefix.
- * @todo Move this identifier policy from the src root into the manifest domain or the domain that owns generated authoring IDs.
+ * TODO: Move this identifier policy from the src root into the manifest domain or the domain that owns generated authoring IDs.
  */
 export const generateManifestStateId = (prefix) => {
     const timestamp = Date.now().toString(36);
@@ -58,7 +58,7 @@ export const generateManifestStateId = (prefix) => {
 };
 /***
  * Serialize the manifest fields used to detect broad Studio authoring-state changes.
- * @todo Move this manifest state projection from the src root into the manifest domain.
+ * TODO: Move this manifest state projection from the src root into the manifest domain.
  */
 export function createStudioManifestFingerprint(manifest) {
     if (!manifest)
@@ -77,21 +77,21 @@ export function createStudioManifestFingerprint(manifest) {
 }
 /***
  * Convert a navigator parent path to the stable key used for route grouping.
- * @todo Move this route-path helper from the src root into routes/.
+ * TODO: Move this route-path helper from the src root into routes/.
  */
 export function pathToKey(path) {
     return path.length === 0 ? '__root__' : path.join('/');
 }
 /***
  * Return whether a route segment represents an Expo Router-style group segment.
- * @todo Move this route semantic helper from the src root into routes/.
+ * TODO: Move this route semantic helper from the src root into routes/.
  */
 export function isRouteGroupSegment(segment) {
     return /^\(.*\)$/.test(segment);
 }
 /***
  * Recursively collect screen-targeting routes together with their navigator and route paths.
- * @todo Move route traversal from the src root into routes/.
+ * TODO: Move route traversal from the src root into routes/.
  */
 export function collectScreenRouteEntries(routes, parentPath = [], routePathPrefix = []) {
     const entries = [];
@@ -113,7 +113,7 @@ export function collectScreenRouteEntries(routes, parentPath = [], routePathPref
 }
 /***
  * Group collected screen routes by the navigator parent path that owns them.
- * @todo Move route grouping from the src root into routes/.
+ * TODO: Move route grouping from the src root into routes/.
  */
 export function groupScreenRouteEntries(entries) {
     const groups = new Map();
@@ -132,7 +132,7 @@ export function groupScreenRouteEntries(entries) {
 }
 /***
  * Verify that every screen registry key equals its unique stable ScreenSpec identifier.
- * @todo Move this manifest screen invariant from the src root into the manifest domain.
+ * TODO: Move this manifest screen invariant from the src root into the manifest domain.
  */
 export function hasCanonicalStudioScreenRegistryIdentity(screens) {
     const screenIds = new Set();
@@ -145,7 +145,7 @@ export function hasCanonicalStudioScreenRegistryIdentity(screens) {
 }
 /***
  * Resolve a screen by stable identifier only when the manifest screen registry satisfies its canonical identity invariant.
- * @todo Move this screen lookup from the src root into the manifest domain.
+ * TODO: Move this screen lookup from the src root into the manifest domain.
  */
 function resolveCanonicalStudioScreen(manifest, screenId) {
     if (!hasCanonicalStudioScreenRegistryIdentity(manifest.screens))
@@ -154,7 +154,7 @@ function resolveCanonicalStudioScreen(manifest, screenId) {
 }
 /***
  * Derive the complete screen/navigation authoring model and diagnostics without flattening the navigator tree.
- * @todo Move navigation-model derivation from the src root into routes/.
+ * TODO: Move navigation-model derivation from the src root into routes/.
  */
 export function deriveStudioScreenNavigationModel(manifest) {
     const primaryNavigatorPath = getPrimaryNavigatorPath(manifest.navigator.routes);
@@ -215,7 +215,7 @@ export function deriveStudioScreenNavigationModel(manifest) {
 }
 /***
  * Resolve a concrete app pathname only when a screen has one unique, non-dynamic route reference.
- * @todo Move canonical route-path resolution from the src root into routes/.
+ * TODO: Move canonical route-path resolution from the src root into routes/.
  */
 export function resolveStudioScreenAppPath(model, screenId) {
     const matchingEntries = model.screens.filter((candidate) => candidate.screenId === screenId);
@@ -239,7 +239,7 @@ export function resolveStudioScreenAppPath(model, screenId) {
 }
 /***
  * Traverse a navigator tree to collect route references and navigation diagnostics for each screen.
- * @todo Move navigation traversal and diagnostics from the src root into routes/.
+ * TODO: Move navigation traversal and diagnostics from the src root into routes/.
  */
 function collectNavigationModelReferences(args) {
     const { navigator, screens, primaryNavigatorPath, parentPath, routePathPrefix, runtimePathPrefix, diagnostics, referencesByRegistryKey, } = args;
@@ -337,7 +337,7 @@ function collectNavigationModelReferences(args) {
 }
 /***
  * Append one route's explicit or named path segments to the current runtime route path.
- * @todo Move runtime route-path construction from the src root into routes/.
+ * TODO: Move runtime route-path construction from the src root into routes/.
  */
 function appendRuntimeRoutePath(runtimePathPrefix, route) {
     const explicitPath = route.path?.trim();
@@ -347,28 +347,28 @@ function appendRuntimeRoutePath(runtimePathPrefix, route) {
 }
 /***
  * Compare two route paths for ordered segment equality.
- * @todo Keep this small comparison helper local to routes/ unless broader reuse is demonstrated.
+ * TODO: Keep this small comparison helper local to routes/ unless broader reuse is demonstrated.
  */
 function pathsEqual(first, second) {
     return (first.length === second.length && first.every((value, index) => value === second.at(index)));
 }
 /***
  * Format a route parent path for navigation diagnostic messages.
- * @todo Move route diagnostic formatting from the src root into routes/.
+ * TODO: Move route diagnostic formatting from the src root into routes/.
  */
 function formatParentPath(parentPath) {
     return parentPath.length === 0 ? '<root>' : parentPath.join('/');
 }
 /***
  * List routed screen identifiers in navigator traversal order.
- * @todo Move route ordering behavior from the src root into routes/.
+ * TODO: Move route ordering behavior from the src root into routes/.
  */
 export function listScreenIdsInRouteOrder(routes) {
     return collectScreenRouteEntries(routes).map((entry) => entry.screenId);
 }
 /***
  * Resolve the initial leaf screen selected by a nested navigator tree, falling back to the first usable route.
- * @todo Move initial-route resolution from the src root into routes/.
+ * TODO: Move initial-route resolution from the src root into routes/.
  */
 export function resolveInitialScreenId(navigator, screens) {
     if (screens && !hasCanonicalStudioScreenRegistryIdentity(screens))
@@ -393,7 +393,7 @@ export function resolveInitialScreenId(navigator, screens) {
 }
 /***
  * Resolve the active screen Studio should select when a manifest is first opened.
- * @todo Move initial Studio screen selection out of the src root into routes/ or selection/ according to its caller boundary.
+ * TODO: Move initial Studio screen selection out of the src root into routes/ or selection/ according to its caller boundary.
  */
 export function resolveInitialActiveScreenId(manifest) {
     if (!manifest || !hasCanonicalStudioScreenRegistryIdentity(manifest.screens))
@@ -404,7 +404,7 @@ export function resolveInitialActiveScreenId(manifest) {
 }
 /***
  * Resolve the root UI node for the active canonical screen.
- * @todo Move active-screen root resolution from the src root into the manifest/selection boundary.
+ * TODO: Move active-screen root resolution from the src root into the manifest/selection boundary.
  */
 export function resolveActiveRootNode(manifest, activeScreenId) {
     if (!manifest || !activeScreenId)
@@ -413,7 +413,7 @@ export function resolveActiveRootNode(manifest, activeScreenId) {
 }
 /***
  * Recursively find a UI node by identifier in a manifest-owned UI tree.
- * @todo Move UI-tree traversal from the src root into canvas/.
+ * TODO: Move UI-tree traversal from the src root into canvas/.
  */
 export function findNodeInManifest(root, id) {
     if (root.id === id)
@@ -427,7 +427,7 @@ export function findNodeInManifest(root, id) {
 }
 /***
  * Keep a selected node identifier only while that node still exists in the active tree.
- * @todo Move selection validity policy from the src root into selection/.
+ * TODO: Move selection validity policy from the src root into selection/.
  */
 export function resolveSafeSelectedNodeId(rootNode, selectedNodeId) {
     if (!selectedNodeId || !rootNode)
@@ -436,7 +436,7 @@ export function resolveSafeSelectedNodeId(rootNode, selectedNodeId) {
 }
 /***
  * Find the canonical screen whose UI tree contains a given node identifier.
- * @todo Move screen ownership lookup from the src root into the manifest/canvas boundary.
+ * TODO: Move screen ownership lookup from the src root into the manifest/canvas boundary.
  */
 export function findScreenIdForNode(manifest, nodeId) {
     if (!hasCanonicalStudioScreenRegistryIdentity(manifest.screens))
@@ -450,7 +450,7 @@ export function findScreenIdForNode(manifest, nodeId) {
 }
 /***
  * Update authored properties of one node in the active screen while preserving manifest immutability.
- * @todo Move canvas node mutation from the src root into canvas/.
+ * TODO: Move canvas node mutation from the src root into canvas/.
  */
 export function updateStudioManifestNode(manifest, activeScreenId, nodeId, newProps) {
     if (!activeScreenId)
@@ -474,7 +474,7 @@ export function updateStudioManifestNode(manifest, activeScreenId, nodeId, newPr
 }
 /***
  * Delete a non-root node from the active screen and remove data bindings owned by the deleted subtree.
- * @todo Split this canvas mutation and binding cleanup between canvas/ and bindings/ instead of the src root.
+ * TODO: Split this canvas mutation and binding cleanup between canvas/ and bindings/ instead of the src root.
  */
 export function deleteStudioManifestNode(manifest, activeScreenId, nodeId) {
     if (!activeScreenId)
@@ -504,7 +504,7 @@ export function deleteStudioManifestNode(manifest, activeScreenId, nodeId) {
 }
 /***
  * Insert a new UI node at a validated canvas placement in the active screen.
- * @todo Move canvas insertion orchestration from the src root into canvas/.
+ * TODO: Move canvas insertion orchestration from the src root into canvas/.
  */
 export function insertStudioManifestNodeAtPlacement(args) {
     const { manifest, activeScreenId, placement, newNode, componentMeta } = args;
@@ -537,7 +537,7 @@ export function insertStudioManifestNodeAtPlacement(args) {
 }
 /***
  * Move an existing UI node to a validated canvas placement in the active screen.
- * @todo Move canvas movement orchestration from the src root into canvas/.
+ * TODO: Move canvas movement orchestration from the src root into canvas/.
  */
 export function moveStudioManifestNodeToPlacement(args) {
     const { manifest, activeScreenId, nodeId, placement, componentMeta } = args;
@@ -570,21 +570,21 @@ export function moveStudioManifestNodeToPlacement(args) {
 }
 /***
  * Replace the manifest component data-binding registry.
- * @todo Move binding-state mutation from the src root into bindings/.
+ * TODO: Move binding-state mutation from the src root into bindings/.
  */
 export function updateStudioManifestDataBindings(manifest, dataBindings) {
     return { ...manifest, dataBindings };
 }
 /***
  * Replace the manifest data-source registry.
- * @todo Resolve data-source authoring ownership with bindings/external APIs and remove this src-root mutation.
+ * TODO: Resolve data-source authoring ownership with bindings/external APIs and remove this src-root mutation.
  */
 export function updateStudioManifestDataSources(manifest, dataSources) {
     return { ...manifest, dataSources };
 }
 /***
  * Create the default light/dark theme configuration for a newly authored theme.
- * @todo Extract theme authoring from manifestState.ts; the current Studio structure target does not yet name a dedicated theme domain.
+ * TODO: Extract theme authoring from manifestState.ts; the current Studio structure target does not yet name a dedicated theme domain.
  */
 export function createDefaultThemeConfig(themeIndex, id = generateManifestStateId('theme')) {
     return {
@@ -602,7 +602,7 @@ export function createDefaultThemeConfig(themeIndex, id = generateManifestStateI
 }
 /***
  * Append a theme to the manifest, creating a default theme when none is supplied.
- * @todo Extract theme authoring from manifestState.ts into its resolved owner.
+ * TODO: Extract theme authoring from manifestState.ts into its resolved owner.
  */
 export function addStudioManifestTheme(manifest, theme = createDefaultThemeConfig(Object.keys(manifest.themes).length)) {
     const themes = { ...manifest.themes };
@@ -611,7 +611,7 @@ export function addStudioManifestTheme(manifest, theme = createDefaultThemeConfi
 }
 /***
  * Merge shared and mode-specific updates into one manifest theme.
- * @todo Extract theme authoring from manifestState.ts into its resolved owner.
+ * TODO: Extract theme authoring from manifestState.ts into its resolved owner.
  */
 export function updateStudioManifestTheme(manifest, themeId, updates) {
     const theme = readOwnProperty(manifest.themes, themeId);
@@ -630,7 +630,7 @@ export function updateStudioManifestTheme(manifest, themeId, updates) {
 }
 /***
  * Delete a theme while preserving at least one theme and a valid active-theme identifier.
- * @todo Extract theme authoring from manifestState.ts into its resolved owner.
+ * TODO: Extract theme authoring from manifestState.ts into its resolved owner.
  */
 export function deleteStudioManifestTheme(manifest, themeId) {
     if (Object.keys(manifest.themes).length <= 1)
@@ -646,7 +646,7 @@ export function deleteStudioManifestTheme(manifest, themeId) {
 }
 /***
  * Set the active theme identifier in the manifest.
- * @todo Extract theme authoring from manifestState.ts into its resolved owner.
+ * TODO: Extract theme authoring from manifestState.ts into its resolved owner.
  */
 export function setStudioManifestActiveThemeId(manifest, activeThemeId) {
     return readOwnProperty(manifest.themes, activeThemeId) === undefined
@@ -655,14 +655,14 @@ export function setStudioManifestActiveThemeId(manifest, activeThemeId) {
 }
 /***
  * Set the active light/dark theme mode in the manifest.
- * @todo Extract theme authoring from manifestState.ts into its resolved owner.
+ * TODO: Extract theme authoring from manifestState.ts into its resolved owner.
  */
 export function setStudioManifestActiveThemeMode(manifest, activeThemeMode) {
     return { ...manifest, activeThemeMode };
 }
 /***
  * Replace OAuth providers while preserving or creating the surrounding manifest auth configuration.
- * @todo Move auth policy from the src root into auth/.
+ * TODO: Move auth policy from the src root into auth/.
  */
 export function updateStudioManifestOAuthProviders(manifest, providers) {
     const previousAuth = manifest.infra.environments.local.auth ?? {
@@ -697,7 +697,7 @@ export function updateStudioManifestOAuthProviders(manifest, providers) {
 }
 /***
  * Resolve the navigator path Studio treats as the primary application navigator.
- * @todo Move primary-navigator policy from the src root into routes/.
+ * TODO: Move primary-navigator policy from the src root into routes/.
  */
 export function getPrimaryNavigatorPath(routes) {
     const appGroupRoute = routes.find((route) => route.name === '(app)' && route.navigator?.routes);
@@ -710,7 +710,7 @@ export function getPrimaryNavigatorPath(routes) {
 }
 /***
  * Find the navigator parent path that owns a route targeting the requested screen.
- * @todo Move route traversal from the src root into routes/.
+ * TODO: Move route traversal from the src root into routes/.
  */
 export function findParentPathForScreenId(routes, screenId, parentPath = [], routePathPrefix = []) {
     for (const route of routes) {
@@ -727,7 +727,7 @@ export function findParentPathForScreenId(routes, screenId, parentPath = [], rou
 }
 /***
  * Resolve the direct route collection owned by a navigator parent path.
- * @todo Move navigator path lookup from the src root into routes/.
+ * TODO: Move navigator path lookup from the src root into routes/.
  */
 export function findRoutesAtParentPath(routes, parentPath) {
     if (parentPath.length === 0)
@@ -745,7 +745,7 @@ export function findRoutesAtParentPath(routes, parentPath) {
 }
 /***
  * Insert a route into the navigator identified by a parent path without mutating the existing tree.
- * @todo Move route-tree mutation from the src root into routes/.
+ * TODO: Move route-tree mutation from the src root into routes/.
  */
 export function insertRouteAtParentPath(routes, parentPath, newRoute) {
     if (parentPath.length === 0)
@@ -769,7 +769,7 @@ export function insertRouteAtParentPath(routes, parentPath, newRoute) {
 }
 /***
  * Resolve a nested navigator by its route-name path.
- * @todo Move navigator lookup from the src root into routes/.
+ * TODO: Move navigator lookup from the src root into routes/.
  */
 export function findNavigatorAtPath(navigator, parentPath) {
     if (parentPath.length === 0)
@@ -787,7 +787,7 @@ export function findNavigatorAtPath(navigator, parentPath) {
 }
 /***
  * Immutably update the navigator identified by a route-name path.
- * @todo Move navigator-tree mutation from the src root into routes/.
+ * TODO: Move navigator-tree mutation from the src root into routes/.
  */
 export function updateNavigatorAtPath(navigator, parentPath, updater) {
     if (parentPath.length === 0)
@@ -838,7 +838,7 @@ function createNavigatorWithType(current, type) {
 }
 /***
  * Change the primary navigator type when the requested navigator type is valid and different.
- * @todo Move navigator authoring policy from the src root into routes/.
+ * TODO: Move navigator authoring policy from the src root into routes/.
  */
 export function setStudioManifestNavigatorType(manifest, type) {
     if (!NAVIGATOR_TYPES.includes(type))
@@ -866,7 +866,7 @@ export function setStudioManifestNavigatorType(manifest, type) {
 }
 /***
  * Change the primary navigator initial route when the requested sibling route is unique.
- * @todo Move navigator authoring policy from the src root into routes/.
+ * TODO: Move navigator authoring policy from the src root into routes/.
  */
 export function setStudioManifestNavigatorInitialRoute(manifest, routeName) {
     const normalizedRoute = routeName.trim();
@@ -891,7 +891,7 @@ export function setStudioManifestNavigatorInitialRoute(manifest, routeName) {
 }
 /***
  * Set whether one route is visible in primary navigation while preserving the canonical visible representation.
- * @todo Move route visibility authoring from the src root into routes/.
+ * TODO: Move route visibility authoring from the src root into routes/.
  */
 export function setStudioManifestRoutePrimaryNavigationVisibility(args) {
     const { manifest, parentPath, routeName, showInPrimaryNavigation } = args;
@@ -927,7 +927,7 @@ export function setStudioManifestRoutePrimaryNavigationVisibility(args) {
 }
 /***
  * Reorder one uniquely named route within its navigator parent.
- * @todo Move route ordering authoring from the src root into routes/.
+ * TODO: Move route ordering authoring from the src root into routes/.
  */
 export function moveStudioManifestRoute(args) {
     const { manifest, parentPath, routeName, toIndex } = args;
@@ -956,7 +956,7 @@ export function moveStudioManifestRoute(args) {
 }
 /***
  * Create a new screen from a template, generate a collision-free route, and make the new screen active.
- * @todo Split screen creation between manifest screen state and routes/ instead of keeping both in one src-root function.
+ * TODO: Split screen creation between manifest screen state and routes/ instead of keeping both in one src-root function.
  */
 export function addStudioManifestScreen(args) {
     const { manifest, activeScreenId, createId = generateManifestStateId } = args;
@@ -1005,7 +1005,7 @@ export function addStudioManifestScreen(args) {
 }
 /***
  * Delete a screen, remove route references and bindings for its subtree, and resolve a safe next active screen.
- * @todo Split this cross-domain operation across manifest, routes/, bindings/, and selection application responsibilities.
+ * TODO: Split this cross-domain operation across manifest, routes/, bindings/, and selection application responsibilities.
  */
 export function deleteStudioManifestScreen(manifest, screenId, activeScreenId) {
     if (!hasCanonicalStudioScreenRegistryIdentity(manifest.screens)) {
@@ -1042,7 +1042,7 @@ export function deleteStudioManifestScreen(manifest, screenId, activeScreenId) {
 }
 /***
  * Recursively remove a screen target from routes and prune nested navigators that become empty.
- * @todo Move route cleanup from the src root into routes/.
+ * TODO: Move route cleanup from the src root into routes/.
  */
 export function removeScreenIdFromRoutes(routes, screenId) {
     const nextRoutes = [];
@@ -1071,7 +1071,7 @@ export function removeScreenIdFromRoutes(routes, screenId) {
 }
 /***
  * Generate a route name that is unique among sibling routes by appending a numeric suffix when needed.
- * @todo Move route-name generation from the src root into routes/.
+ * TODO: Move route-name generation from the src root into routes/.
  */
 export function makeUniqueSiblingRouteName(base, siblingRoutes) {
     const normalized = normalizeRouteName(base);
@@ -1086,7 +1086,7 @@ export function makeUniqueSiblingRouteName(base, siblingRoutes) {
 }
 /***
  * Convert route path segments to the canonical pathname pattern used by Studio authoring.
- * @todo Move canonical route-pattern logic from the src root into routes/.
+ * TODO: Move canonical route-pattern logic from the src root into routes/.
  */
 export function toCanonicalRoutePattern(routePath) {
     const normalized = routePath.filter((segment) => !isRouteGroupSegment(segment));
@@ -1098,7 +1098,7 @@ export function toCanonicalRoutePattern(routePath) {
 }
 /***
  * Generate a route name that avoids both sibling-name and canonical-path collisions.
- * @todo Move route-name collision policy from the src root into routes/.
+ * TODO: Move route-name collision policy from the src root into routes/.
  */
 export function makeUniqueRouteNameForParent(baseRouteName, siblingRoutes, parentPath, existingPatterns) {
     const siblingNames = new Set(siblingRoutes.map((route) => route.name));
@@ -1113,14 +1113,14 @@ export function makeUniqueRouteNameForParent(baseRouteName, siblingRoutes, paren
 }
 /***
  * Normalize arbitrary screen text into the lowercase hyphenated route-name form used by Studio.
- * @todo Keep this semantic route-name normalization under routes/ rather than extracting it as a generic slug utility.
+ * TODO: Keep this semantic route-name normalization under routes/ rather than extracting it as a generic slug utility.
  */
 function normalizeRouteName(value) {
     return slugifyAscii(value) || 'screen';
 }
 /***
  * Collect canonical pathname patterns for every route in a nested navigator tree.
- * @todo Move route-pattern traversal from the src root into routes/.
+ * TODO: Move route-pattern traversal from the src root into routes/.
  */
 function collectCanonicalRoutePatterns(routes, runtimePathPrefix = []) {
     const patterns = [];
@@ -1135,7 +1135,7 @@ function collectCanonicalRoutePatterns(routes, runtimePathPrefix = []) {
 }
 /***
  * Deep-clone a UI node tree while assigning fresh identifiers and copying mutable node data.
- * @todo Move UI-tree cloning from the src root into canvas/.
+ * TODO: Move UI-tree cloning from the src root into canvas/.
  */
 function cloneNodeWithNewIds(node, createId) {
     const clonedNode = {
@@ -1150,7 +1150,7 @@ function cloneNodeWithNewIds(node, createId) {
 }
 /***
  * Immutably update alias, style, and props for a node in a UI tree.
- * @todo Move UI-tree mutation from the src root into canvas/ or properties/ according to final authoring ownership.
+ * TODO: Move UI-tree mutation from the src root into canvas/ or properties/ according to final authoring ownership.
  */
 function updateNodeInManifestTree(root, id, newProps) {
     if (root.id === id) {
@@ -1172,7 +1172,7 @@ function updateNodeInManifestTree(root, id, newProps) {
 }
 /***
  * Immutably remove a node from a UI tree while preserving the remaining hierarchy.
- * @todo Move UI-tree mutation from the src root into canvas/.
+ * TODO: Move UI-tree mutation from the src root into canvas/.
  */
 function removeNodeFromManifestTree(root, nodeId) {
     if (root.id === nodeId)
@@ -1189,7 +1189,7 @@ function removeNodeFromManifestTree(root, nodeId) {
 }
 /***
  * Collect every node identifier in a UI subtree.
- * @todo Move UI-tree traversal from the src root into canvas/.
+ * TODO: Move UI-tree traversal from the src root into canvas/.
  */
 function collectNodeIds(root) {
     const ids = new Set();
@@ -1203,7 +1203,7 @@ function collectNodeIds(root) {
 }
 /***
  * Repair a navigator's initial-route field after route removal while preserving canonical omission when no initial route exists.
- * @todo Move navigator normalization from the src root into routes/.
+ * TODO: Move navigator normalization from the src root into routes/.
  */
 function normalizeNavigatorAfterRouteUpdate(navigator) {
     const nextRoutes = navigator.routes;
@@ -1223,7 +1223,7 @@ function normalizeNavigatorAfterRouteUpdate(navigator) {
 }
 /***
  * Narrow an unknown node style value to the string-or-number style record accepted by Studio node updates.
- * @todo Keep this semantic style predicate with the canvas/properties authoring logic rather than treating it as a generic record utility.
+ * TODO: Keep this semantic style predicate with the canvas/properties authoring logic rather than treating it as a generic record utility.
  */
 function isStyleRecord(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value))

package/dist/manifestSync.d.ts

@@ -1,12 +1,12 @@
 import type { StudioManifest } from './index';
 /***
  * Serialize only the manifest fields that affect generated runtime synchronization.
- * @todo Move manifest signature behavior from the source root into the manifest domain.
+ * TODO: Move manifest signature behavior from the source root into the manifest domain.
  */
-export declare function createStudioRuntimeSyncSignature(manifest: StudioManifest): string;
+export declare function createStudioRuntimeSyncSignature(manifest: StudioManifest, generatorRevision?: string): string;
 /***
  * Serialize the complete manifest for exact persistence-change comparison.
- * @todo Move manifest signature behavior from the source root into the manifest domain.
+ * TODO: Move manifest signature behavior from the source root into the manifest domain.
  */
 export declare function createStudioManifestSignature(manifest: StudioManifest): string;
 //# sourceMappingURL=manifestSync.d.ts.map

package/dist/manifestSync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifestSync.d.ts","sourceRoot":"","sources":["../src/manifestSync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2B9C;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAcjF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE9E"}
+{"version":3,"file":"manifestSync.d.ts","sourceRoot":"","sources":["../src/manifestSync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2B9C;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,cAAc,EACxB,iBAAiB,SAAW,GAC3B,MAAM,CAeR;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE9E"}

package/dist/manifestSync.js

@@ -1,7 +1,7 @@
 import { setOwnProperty } from '@ankhorage/utility/object';
 /***
  * Build the sorted screen subset used to detect runtime-relevant manifest changes.
- * @todo Move manifest signature behavior from the source root into the manifest domain.
+ * TODO: Move manifest signature behavior from the source root into the manifest domain.
  */
 function createRuntimeScreenSignatures(manifest) {
     return Object.entries(manifest.screens)
@@ -17,10 +17,11 @@ function createRuntimeScreenSignatures(manifest) {
 }
 /***
  * Serialize only the manifest fields that affect generated runtime synchronization.
- * @todo Move manifest signature behavior from the source root into the manifest domain.
+ * TODO: Move manifest signature behavior from the source root into the manifest domain.
  */
-export function createStudioRuntimeSyncSignature(manifest) {
+export function createStudioRuntimeSyncSignature(manifest, generatorRevision = 'legacy') {
     return JSON.stringify({
+        generatorRevision,
         navigator: manifest.navigator,
         screens: createRuntimeScreenSignatures(manifest),
         apis: Object.fromEntries(Object.entries(manifest.infra.apis ?? {}).sort(([leftId], [rightId]) => leftId.localeCompare(rightId))),
@@ -32,7 +33,7 @@ export function createStudioRuntimeSyncSignature(manifest) {
 }
 /***
  * Serialize the complete manifest for exact persistence-change comparison.
- * @todo Move manifest signature behavior from the source root into the manifest domain.
+ * TODO: Move manifest signature behavior from the source root into the manifest domain.
  */
 export function createStudioManifestSignature(manifest) {
     return JSON.stringify(manifest);

package/dist/manifestSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifestSync.js","sourceRoot":"","sources":["../src/manifestSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;GAGG;AACH,SAAS,6BAA6B,CACpC,QAAwB;IAExB,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;SAC5D,MAAM,CAAyC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;QAC1E,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE;YAC5B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAAC,QAAwB;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,6BAA6B,CAAC,QAAQ,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC,WAAW,CACtB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CACrE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAC9B,CACF;QACD,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE;QACzC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;QACzC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAwB;IACpE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"manifestSync.js","sourceRoot":"","sources":["../src/manifestSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;GAGG;AACH,SAAS,6BAA6B,CACpC,QAAwB;IAExB,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;SAC5D,MAAM,CAAyC,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;QAC1E,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE;YAC5B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAwB,EACxB,iBAAiB,GAAG,QAAQ;IAE5B,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,iBAAiB;QACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,OAAO,EAAE,6BAA6B,CAAC,QAAQ,CAAC;QAChD,IAAI,EAAE,MAAM,CAAC,WAAW,CACtB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CACrE,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAC9B,CACF;QACD,YAAY,EAAE,QAAQ,CAAC,YAAY,IAAI,EAAE;QACzC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;QACvC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;QACzC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAwB;IACpE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}

package/dist/mediaAuthoringModel.d.ts

@@ -39,27 +39,26 @@ export type StudioUrlMediaAssetResult = {
 };
 /***
  * List manifest media assets, optionally filter by kind, and sort them by name.
- * @utility @ankhorage/utility/array
  */
 export declare function listStudioMediaAssets(manifest: AppManifest, mediaKinds?: readonly MediaAssetKind[]): readonly MediaAsset[];
 /***
  * Create the canonical media-reference object for one media id.
- * @todo Keep the MediaAssetReference constructor with its contracts/media owner unless a generic single-key reference constructor is extracted.
+ * Follow-up: Keep the MediaAssetReference constructor with its contracts/media owner unless a generic single-key reference constructor is extracted.
  */
 export declare function createStudioMediaAssetReference(mediaId: string): MediaAssetReference;
 /***
  * Parse an unknown value as an exact one-key media-reference object.
- * @todo Keep MediaAssetReference semantics with media/contracts; implement it from generic object/value utilities.
+ * Follow-up: Keep MediaAssetReference semantics with media/contracts; implement it from generic object/value utilities.
  */
 export declare function readStudioMediaAssetReference(value: unknown): MediaAssetReference | null;
 /***
  * Create a unique slug-like media id from a name and an existing keyed registry.
- * @utility @ankhorage/utility/string
+ * Utility candidate: @ankhorage/utility/string
  */
 export declare function createStudioMediaAssetId(name: string, registry?: MediaAssetRegistry): string;
 /***
  * Create a URL-backed Studio media asset after validating and normalizing its HTTP URL.
- * @todo Move URL-media authoring behavior under src/media/ while reusing generic URL normalization.
+ * Follow-up: Move URL-media authoring behavior under src/media/ while reusing generic URL normalization.
  */
 export declare function createStudioUrlMediaAsset(args: {
     readonly id: string;
@@ -69,17 +68,16 @@ export declare function createStudioUrlMediaAsset(args: {
 }): StudioUrlMediaAssetResult;
 /***
  * Immutably insert or replace a keyed media asset in a manifest registry.
- * @utility @ankhorage/utility/object
  */
 export declare function upsertStudioMediaAsset(manifest: AppManifest, asset: MediaAsset): AppManifest;
 /***
  * Collect every Studio node-property usage of one media asset across all manifest screens.
- * @todo Move media usage analysis under src/media/ while extracting generic deep-value traversal.
+ * Follow-up: Move media usage analysis under src/media/ while extracting generic deep-value traversal.
  */
 export declare function collectStudioMediaAssetUsages(manifest: AppManifest, mediaId: string): readonly StudioMediaUsage[];
 /***
  * Remove an unused media asset from the manifest and reject removal when the asset is missing or referenced.
- * @todo Move media removal policy under src/media/.
+ * Follow-up: Move media removal policy under src/media/.
  */
 export declare function removeStudioMediaAsset(manifest: AppManifest, mediaId: string): StudioMediaAssetRemovalResult;
 //# sourceMappingURL=mediaAuthoringModel.d.ts.map

package/dist/mediaAuthoringModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaAuthoringModel.d.ts","sourceRoot":"","sources":["../src/mediaAuthoringModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,GACrD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC3D;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;CAC9B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;CAC7B,CAAC;AAEN,MAAM,MAAM,yBAAyB,GACjC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EACrB,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,GACrC,SAAS,UAAU,EAAE,CAMvB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAEpF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAMxF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,kBAAuB,GAAG,MAAM,CAMhG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GAAG,yBAAyB,CAY5B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,WAAW,CAI5F;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,GACd,SAAS,gBAAgB,EAAE,CAM7B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,GACd,6BAA6B,CAe/B"}
+{"version":3,"file":"mediaAuthoringModel.d.ts","sourceRoot":"","sources":["../src/mediaAuthoringModel.ts"],"names":[],"mappings":"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"}