@ankhorage/studio 6.0.1 → 7.0.0

package/dist/manifestState.d.ts

@@ -56,97 +56,97 @@ export interface StudioManifestNodeMoveResult {
 export declare const DEFAULT_STUDIO_SCREEN_TEMPLATE: UiNode;
 /***
  * 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 declare const generateManifestStateId: StudioIdGenerator;
 /***
  * 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 declare function createStudioManifestFingerprint(manifest: StudioManifest | null): string;
 /***
  * 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 declare function pathToKey(path: string[]): string;
 /***
  * 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 declare function isRouteGroupSegment(segment: string): boolean;
 /***
  * 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 declare function collectScreenRouteEntries(routes: RouteDefinition[], parentPath?: string[], routePathPrefix?: string[]): ScreenRouteEntry[];
 /***
  * 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 declare function groupScreenRouteEntries(entries: ScreenRouteEntry[]): ScreenRouteGroup[];
 /***
  * 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 declare function hasCanonicalStudioScreenRegistryIdentity(screens: StudioManifest['screens']): boolean;
 /***
  * 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 declare function deriveStudioScreenNavigationModel(manifest: StudioManifest): StudioScreenNavigationModel;
 /***
  * 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 declare function resolveStudioScreenAppPath(model: StudioScreenNavigationModel, screenId: string): string | null;
 /***
  * 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 declare function listScreenIdsInRouteOrder(routes: RouteDefinition[]): string[];
 /***
  * 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 declare function resolveInitialScreenId(navigator: NavigatorNode, screens?: AppManifest['screens']): string | null;
 /***
  * 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 declare function resolveInitialActiveScreenId(manifest: StudioManifest | null): string | null;
 /***
  * 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 declare function resolveActiveRootNode(manifest: StudioManifest | null, activeScreenId: string | null): UiNode | null;
 /***
  * 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 declare function findNodeInManifest(root: UiNode, id: string): UiNode | null;
 /***
  * 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 declare function resolveSafeSelectedNodeId(rootNode: UiNode | null, selectedNodeId: string | null): string | null;
 /***
  * 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 declare function findScreenIdForNode(manifest: StudioManifest, nodeId: string): string | null;
 /***
  * 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 declare function updateStudioManifestNode(manifest: StudioManifest, activeScreenId: string | null, nodeId: string, newProps: Record<string, unknown>): StudioManifest;
 /***
  * 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 declare function deleteStudioManifestNode(manifest: StudioManifest, activeScreenId: string | null, nodeId: string): StudioManifest;
 /***
  * 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 declare function insertStudioManifestNodeAtPlacement(args: {
     manifest: StudioManifest;
@@ -157,7 +157,7 @@ export declare function insertStudioManifestNodeAtPlacement(args: {
 }): StudioManifestNodeInsertResult | null;
 /***
  * 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 declare function moveStudioManifestNodeToPlacement(args: {
     manifest: StudioManifest;
@@ -168,92 +168,92 @@ export declare function moveStudioManifestNodeToPlacement(args: {
 }): StudioManifestNodeMoveResult | null;
 /***
  * 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 declare function updateStudioManifestDataBindings(manifest: StudioManifest, dataBindings: ComponentDataBindingRegistry): StudioManifest;
 /***
  * 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 declare function updateStudioManifestDataSources(manifest: StudioManifest, dataSources: DataSourceRegistry): StudioManifest;
 /***
  * 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 declare function createDefaultThemeConfig(themeIndex: number, id?: string): ThemeConfig;
 /***
  * 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 declare function addStudioManifestTheme(manifest: StudioManifest, theme?: ThemeConfig): StudioManifest;
 /***
  * 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 declare function updateStudioManifestTheme(manifest: StudioManifest, themeId: string, updates: ThemeUpdates): StudioManifest;
 /***
  * 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 declare function deleteStudioManifestTheme(manifest: StudioManifest, themeId: string): StudioManifest;
 /***
  * 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 declare function setStudioManifestActiveThemeId(manifest: StudioManifest, activeThemeId: string): StudioManifest;
 /***
  * 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 declare function setStudioManifestActiveThemeMode(manifest: StudioManifest, activeThemeMode: NonNullable<StudioManifest['activeThemeMode']>): StudioManifest;
 /***
  * 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 declare function updateStudioManifestOAuthProviders(manifest: StudioManifest, providers: AuthOAuthProviderConfig[]): StudioManifest;
 /***
  * 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 declare function getPrimaryNavigatorPath(routes: RouteDefinition[]): string[];
 /***
  * 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 declare function findParentPathForScreenId(routes: RouteDefinition[], screenId: string, parentPath?: string[], routePathPrefix?: string[]): string[] | null;
 /***
  * 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 declare function findRoutesAtParentPath(routes: RouteDefinition[], parentPath: string[]): RouteDefinition[] | null;
 /***
  * 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 declare function insertRouteAtParentPath(routes: RouteDefinition[], parentPath: string[], newRoute: RouteDefinition): RouteDefinition[];
 /***
  * 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 declare function findNavigatorAtPath(navigator: NavigatorNode, parentPath: string[]): NavigatorNode | null;
 /***
  * 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 declare function updateNavigatorAtPath(navigator: NavigatorNode, parentPath: string[], updater: (current: NavigatorNode) => NavigatorNode): NavigatorNode;
 /***
  * 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 declare function setStudioManifestNavigatorType(manifest: StudioManifest, type: NavigatorType): StudioManifest;
 /***
  * 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 declare function setStudioManifestNavigatorInitialRoute(manifest: StudioManifest, routeName: string): StudioManifest;
 /***
  * 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 declare function setStudioManifestRoutePrimaryNavigationVisibility(args: {
     manifest: StudioManifest;
@@ -263,7 +263,7 @@ export declare function setStudioManifestRoutePrimaryNavigationVisibility(args:
 }): StudioManifest;
 /***
  * 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 declare function moveStudioManifestRoute(args: {
     manifest: StudioManifest;
@@ -273,7 +273,7 @@ export declare function moveStudioManifestRoute(args: {
 }): StudioManifest;
 /***
  * 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 declare function addStudioManifestScreen(args: {
     manifest: StudioManifest;
@@ -285,27 +285,27 @@ export declare function addStudioManifestScreen(args: {
 }): StudioManifestScreenMutationResult;
 /***
  * 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 declare function deleteStudioManifestScreen(manifest: StudioManifest, screenId: string, activeScreenId: string | null): StudioManifestScreenMutationResult;
 /***
  * 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 declare function removeScreenIdFromRoutes(routes: RouteDefinition[], screenId: string): RouteDefinition[];
 /***
  * 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 declare function makeUniqueSiblingRouteName(base: string, siblingRoutes: RouteDefinition[]): string;
 /***
  * 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 declare function toCanonicalRoutePattern(routePath: string[]): string;
 /***
  * 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 declare function makeUniqueRouteNameForParent(baseRouteName: string, siblingRoutes: RouteDefinition[], parentPath: string[], existingPatterns: Set<string>): string;
 //# sourceMappingURL=manifestState.d.ts.map