@ankhorage/studio 2.0.22 → 2.0.24

package/dist/index.d.ts

@@ -12,6 +12,9 @@ export type { ProjectSecretUsage, ProjectSecretUsageCategory, ProjectSecretUsage
 export type { ProjectCreationValidationCode, ProjectCreationValidationFailure, ProjectCreationValidationResult, ProjectSortKey, StudioProjectSummary, } from './projectWorkspaceContracts';
 export * from './propertiesAuthoringModel';
 export type { TemplateCatalog, TemplateCatalogCategory, TemplateCatalogTemplate, TemplateEntry, } from './templateCatalogContracts';
+/***
+ * @todo Make `src/index.ts` a public exports-only entrypoint. Package metadata, authoring contracts, tree editing, placement policy, templates and insert-catalog implementations need canonical owner modules and should only be re-exported here.
+ */
 export declare const STUDIO_PACKAGE_NAME: "@ankhorage/studio";
 export interface StudioPackageBoundary {
     readonly owns: readonly string[];
@@ -223,25 +226,59 @@ export interface StudioContextValue extends StudioSelectionState, StudioSessionS
 }
 export declare const ACTION_REGISTRY: Record<ActionType, ActionDefinition>;
 export declare const TPL_SCREEN_EMPTY: UiNode;
-/**
- * Generates a unique ID for Studio-authored nodes and entities.
+/***
+ * Generate a compact time/random identifier with an optional lowercase prefix.
+ * @utility @ankhorage/utility/id
+ * @todo Move the Studio-facing wrapper out of `src/index.ts`; the reusable identifier primitive belongs in Utility.
  */
 export declare const generateStudioId: StudioIdGenerator;
+/***
+ * Deep-clone a UiNode tree while assigning fresh identifiers and shallow-cloning node props.
+ * @utility @ankhorage/utility/tree
+ * @todo `cloneTreeWithNewIds` currently allocates child ids before the root; retain this public pre-order callback contract until Utility supports configurable traversal order.
+ */
 export declare const cloneWithNewIds: (node: UiNode, createId?: StudioIdGenerator) => UiNode;
+/***
+ * Find the first node with a matching id in a depth-first tree traversal.
+ * @utility @ankhorage/utility/tree
+ * @todo Move the UiNode wrapper out of `src/index.ts`; parameterize id and child accessors for Utility.
+ */
 export declare const findNodeById: (root: UiNode, id: string) => UiNode | null;
+/***
+ * Immutably update one UiNode by id while preserving Studio's alias/style versus props patch semantics.
+ * @utility @ankhorage/utility/tree
+ * @todo Keep Studio-specific patch projection in the canvas/properties owner and extract the generic immutable tree-update primitive to Utility.
+ */
 export declare const updateNodeInTree: (root: UiNode, id: string, newProps: Record<string, unknown>) => UiNode;
+/***
+ * Immutably remove a node by id from a UiNode tree and preserve unchanged branches by reference.
+ * @utility @ankhorage/utility/tree
+ * @todo Move the UiNode wrapper out of `src/index.ts` and parameterize tree accessors for Utility.
+ */
 export declare const removeNodeFromTree: (root: UiNode, nodeId: string) => UiNode | null;
+/***
+ * Return whether Studio component metadata permits one child type under a parent type.
+ * @todo Move this component-placement policy from `src/index.ts` into the `canvas/` or insert-authoring domain.
+ */
 export declare function canAcceptChild(args: {
     parentType: string;
     childType: string;
     componentMeta: StudioComponentMetaRegistry;
 }): boolean;
+/***
+ * Validate one resolved Studio placement against parent existence, child policy, index bounds and sibling-reference invariants.
+ * @todo Move placement validation from the public entrypoint into the `canvas/` domain.
+ */
 export declare function validateNodePlacement(args: {
     root: UiNode;
     placement: NodePlacement;
     childType: string;
     componentMeta: StudioComponentMetaRegistry;
 }): PlacementValidationResult;
+/***
+ * Resolve a requested inside/before/after insertion target to a validated Studio placement.
+ * @todo Move insertion-placement policy from `src/index.ts` into the `canvas/`/insert domain.
+ */
 export declare function resolveInsertPlacement(args: {
     root: UiNode;
     targetNodeId: string;
@@ -249,6 +286,10 @@ export declare function resolveInsertPlacement(args: {
     componentMeta: StudioComponentMetaRegistry;
     kind: PlacementKind;
 }): PlacementResolutionResult;
+/***
+ * Resolve the preferred insertion placement by trying the selected node, its sibling position, then the screen root.
+ * @todo Move Studio default insertion policy from `src/index.ts` into the insert/canvas domain.
+ */
 export declare function resolveDefaultInsertPlacement(args: {
     root: UiNode;
     selectedNodeId: string | null;
@@ -265,6 +306,10 @@ export interface InsertNodeAtPlacementResult {
     root: UiNode;
     insertedNodeId: string;
 }
+/***
+ * Create and insert one Studio node after validating its requested placement.
+ * @todo Move Studio insertion orchestration from `src/index.ts` into the insert/canvas domain.
+ */
 export declare function insertNodeAtPlacement(args: InsertNodeAtPlacementArgs): InsertNodeAtPlacementResult | null;
 export interface MoveNodeToPlacementArgs {
     root: UiNode;
@@ -276,16 +321,44 @@ export interface MoveNodeToPlacementResult {
     root: UiNode;
     movedNodeId: string;
 }
+/***
+ * Validate and resolve a requested Studio node move after accounting for source removal and descendant/no-op invariants.
+ * @todo Move node-move policy from `src/index.ts` into the canvas domain.
+ */
 export declare function resolveMoveNodePlacement(args: MoveNodeToPlacementArgs): PlacementResolutionResult;
+/***
+ * Execute a validated Studio node move as immutable removal followed by insertion.
+ * @todo Move node-move orchestration from `src/index.ts` into the canvas domain.
+ */
 export declare function moveNodeToPlacement(args: MoveNodeToPlacementArgs): MoveNodeToPlacementResult | null;
 export declare const STUDIO_INSERT_RECIPES: readonly InsertRecipe[];
+/***
+ * Resolve Studio's display label for an insert-catalog category, falling back to the raw category id.
+ * @todo Move insert-catalog presentation metadata out of `src/index.ts` into the insert domain.
+ */
 export declare function getInsertCatalogCategoryLabel(category: string): string;
+/***
+ * Validate an insert recipe recursively against Studio component metadata and allowed-child constraints.
+ * @todo Move recipe validation from `src/index.ts` into the insert/templates domain.
+ */
 export declare function validateInsertRecipe(recipe: InsertRecipe, componentMeta: StudioComponentMetaRegistry): InsertRecipeIssue | null;
+/***
+ * Materialize one enabled component or recipe catalog entry into a fresh UiNode tree.
+ * @todo Move insert-catalog node creation from `src/index.ts` into the insert domain.
+ */
 export declare function createNodeFromCatalogEntry(entry: InsertCatalogEntry, componentMeta: StudioComponentMetaRegistry, createId?: StudioIdGenerator): UiNode;
+/***
+ * Build and deterministically sort Studio's component/recipe insert catalog from component metadata and recipes.
+ * @todo Move insert-catalog construction from `src/index.ts` into the insert domain.
+ */
 export declare function buildInsertCatalogEntries(args: {
     componentMeta: StudioComponentMetaRegistry;
     recipes?: readonly InsertRecipe[];
 }): InsertCatalogEntry[];
+/***
+ * Resolve enabled/disabled insert-catalog state against the active screen and selected-node placement context.
+ * @todo Move context-sensitive insert catalog projection from `src/index.ts` into the insert/canvas application domain.
+ */
 export declare function resolveInsertCatalogEntries(args: {
     entries: readonly InsertCatalogEntry[];
     root: UiNode | null;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,uBAAuB,EACvB,4BAA4B,EAC5B,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,WAAW,EACX,eAAe,EACf,MAAM,EACP,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EACV,qBAAqB,EACrB,6BAA6B,EAC7B,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,cAAc,EACd,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,aAAa,GACd,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,mBAAmB,EAAG,mBAA4B,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,uBAAuB,EAAE,qBA+BrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,4zBAgC1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AACrC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AACrC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AACpC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;AACrC,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,SAAS,GACT,eAAe,GACf,OAAO,GACP,SAAS,GACT,eAAe,GACf,MAAM,GACN,aAAa,GACb,gBAAgB,GAChB,MAAM,GACN,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,SAAS,GACT,QAAQ,GACR,OAAO,GACP,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,YAAY,CAAC;AACjB,MAAM,MAAM,0BAA0B,GAClC,OAAO,GACP,eAAe,GACf,aAAa,GACb,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,uBAAuB,GACvB,YAAY,GACZ,sBAAsB,GACtB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,wBAAwB,GACxB,qBAAqB,GACrB,mBAAmB,GACnB,qBAAqB,CAAC;AAC1B,MAAM,MAAM,oBAAoB,GAC5B,0BAA0B,GAC1B,iBAAiB,MAAM,EAAE,GACzB,iBAAiB,MAAM,EAAE,GACzB,0BAA0B,MAAM,EAAE,GAClC,wBAAwB,MAAM,EAAE,GAChC,kBAAkB,MAAM,EAAE,GAC1B,oBAAoB,MAAM,EAAE,CAAC;AAEjC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,YAAY,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,sBAAsB,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,uBAAuB,GACvB,6BAA6B,GAC7B,OAAO,CAAC;AAEZ,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEN,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GACtC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,sBAAsB,CAAC;CAChC,CAAC;AAEN,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAC5D,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9D,MAAM,MAAM,+BAA+B,GACzC,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAC3C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,+BAA+B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG,2BAA2B,GAAG,wBAAwB,CAAC;AAExF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,4BAA4B,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAEjF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,yBAAyB,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC,CAAC;AAE1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5D,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,gCAAgC,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,SAAS,EAAE,oBAAoB,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEnE,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB,EAAE,kBAAkB;IAClF,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,2BAA2B,CAAC;IAC3C,UAAU,EAAE,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1D,qBAAqB,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7D,uBAAuB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,yBAAyB,EAAE,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IACjE,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3E,gBAAgB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9C,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAC/C,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACxE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,qBAAqB,EAAE,CACrB,MAAM,EAAE,uBAAuB,EAC/B,MAAM,CAAC,EAAE,uBAAuB,KAC7B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtC,kBAAkB,EAAE,CAAC,YAAY,EAAE,4BAA4B,KAAK,IAAI,CAAC;IACzE,iBAAiB,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7D,UAAU,EAAE,CAAC,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;IACvC,sBAAsB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC/D,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,CAAC;IACjF,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,YAAY,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,wBAAwB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,mCAAmC,EAAE,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EACjB,uBAAuB,EAAE,OAAO,KAC7B,IAAI,CAAC;IACV,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACzD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC3D,kBAAkB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACxF,oBAAoB,EAAE,CAAC,SAAS,EAAE,uBAAuB,EAAE,KAAK,IAAI,CAAC;IACrE,iBAAiB,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5D,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE,gBAAgB,CA0FhE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MA2C9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAK9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EACZ,WAAU,iBAAoC,KAC7C,MAYF,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,IAAI,MAAM,KAAG,MAAM,GAAG,IAUhE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,IAAI,MAAM,EACV,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAsBF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAM,GAAG,IAgB1E,CAAC;AAkGF,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,OAAO,CAMV;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,yBAAyB,CAgF5B;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,2BAA2B,CAAC;IAC3C,IAAI,EAAE,aAAa,CAAC;CACrB,GAAG,yBAAyB,CAqD5B;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,yBAAyB,CAsC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB;AA+CD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,yBAAyB,GAC9B,2BAA2B,GAAG,IAAI,CAuBpC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,EAAE,2BAA2B,CAAC;CAC5C;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AA+BD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,yBAAyB,CAkEjG;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,GAC5B,yBAAyB,GAAG,IAAI,CAwBlC;AAYD,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EA+BxD,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAeD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,2BAA2B,GACzC,iBAAiB,GAAG,IAAI,CAgC1B;AAsBD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,EACzB,aAAa,EAAE,2BAA2B,EAC1C,QAAQ,GAAE,iBAAoC,GAC7C,MAAM,CAcR;AA+DD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,aAAa,EAAE,2BAA2B,CAAC;IAC3C,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACnC,GAAG,kBAAkB,EAAE,CAqBvB;AAkBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,kBAAkB,EAAE,CA0CvB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,8 +1,22 @@
+import { createCompactId as createUtilityCompactId } from '@ankhorage/utility/id';
+import { findTreeNode, findTreeNodeWithParent, isTreeDescendant, removeTreeNode, updateTreeNode, } from '@ankhorage/utility/tree';
+const uiNodeTreeAdapter = {
+    getId: (node) => node.id,
+    getChildren: (node) => node.children,
+    withChildren: (node, children) => {
+        if (children.length === 0 && node.children === undefined)
+            return { ...node };
+        return { ...node, children: [...children] };
+    },
+};
 export * from './bindingAuthoringModel';
 export * from './mediaAuthoringModel';
 export * from './mediaPickerAuthoring';
 export { deriveProjectId, ProjectCreationValidationError, validateProjectCreationInput, } from './projectIdentity';
 export * from './propertiesAuthoringModel';
+/***
+ * @todo Make `src/index.ts` a public exports-only entrypoint. Package metadata, authoring contracts, tree editing, placement policy, templates and insert-catalog implementations need canonical owner modules and should only be re-exported here.
+ */
 export const STUDIO_PACKAGE_NAME = '@ankhorage/studio';
 export const STUDIO_PACKAGE_BOUNDARY = {
     owns: [
@@ -204,15 +218,19 @@ export const TPL_SCREEN_EMPTY = {
         },
     ],
 };
-/**
- * Generates a unique ID for Studio-authored nodes and entities.
+/***
+ * Generate a compact time/random identifier with an optional lowercase prefix.
+ * @utility @ankhorage/utility/id
+ * @todo Move the Studio-facing wrapper out of `src/index.ts`; the reusable identifier primitive belongs in Utility.
  */
 export const generateStudioId = (prefix) => {
-    const timestamp = Date.now().toString(36);
-    const random = Math.random().toString(36).substring(2, 11);
-    const id = `${timestamp}-${random}`;
-    return prefix ? `${prefix.toLowerCase()}-${id}` : id;
+    return createUtilityCompactId(prefix?.toLowerCase() ?? '', { randomLength: 9 });
 };
+/***
+ * Deep-clone a UiNode tree while assigning fresh identifiers and shallow-cloning node props.
+ * @utility @ankhorage/utility/tree
+ * @todo `cloneTreeWithNewIds` currently allocates child ids before the root; retain this public pre-order callback contract until Utility supports configurable traversal order.
+ */
 export const cloneWithNewIds = (node, createId = generateStudioId) => {
     const clonedNode = {
         ...node,
@@ -224,80 +242,58 @@ export const cloneWithNewIds = (node, createId = generateStudioId) => {
     }
     return clonedNode;
 };
+/***
+ * Find the first node with a matching id in a depth-first tree traversal.
+ * @utility @ankhorage/utility/tree
+ * @todo Move the UiNode wrapper out of `src/index.ts`; parameterize id and child accessors for Utility.
+ */
 export const findNodeById = (root, id) => {
-    if (root.id === id)
-        return root;
-    if (!root.children)
-        return null;
-    for (const child of root.children) {
-        const found = findNodeById(child, id);
-        if (found)
-            return found;
-    }
-    return null;
+    return findTreeNode(root, id, uiNodeTreeAdapter) ?? null;
 };
+/***
+ * Immutably update one UiNode by id while preserving Studio's alias/style versus props patch semantics.
+ * @utility @ankhorage/utility/tree
+ * @todo Keep Studio-specific patch projection in the canvas/properties owner and extract the generic immutable tree-update primitive to Utility.
+ */
 export const updateNodeInTree = (root, id, newProps) => {
-    if (root.id === id) {
+    return updateTreeNode(root, id, (node) => {
         const { alias, style, ...rest } = newProps;
         const aliasUpdate = typeof alias === 'string' ? { alias } : {};
         const styleUpdate = isStyleRecord(style) ? { style } : {};
         return {
-            ...root,
+            ...node,
             ...aliasUpdate,
             ...styleUpdate,
-            props: { ...(root.props ?? {}), ...rest },
+            props: { ...(node.props ?? {}), ...rest },
         };
-    }
-    if (!root.children) {
-        return root;
-    }
-    return {
-        ...root,
-        children: root.children.map((child) => updateNodeInTree(child, id, newProps)),
-    };
+    }, uiNodeTreeAdapter);
 };
+/***
+ * Immutably remove a node by id from a UiNode tree and preserve unchanged branches by reference.
+ * @utility @ankhorage/utility/tree
+ * @todo Move the UiNode wrapper out of `src/index.ts` and parameterize tree accessors for Utility.
+ */
 export const removeNodeFromTree = (root, nodeId) => {
-    if (root.id === nodeId)
-        return null;
-    if (!root.children) {
-        return root;
-    }
-    const filteredChildren = root.children.filter((child) => child.id !== nodeId);
-    if (filteredChildren.length !== root.children.length) {
-        return { ...root, children: filteredChildren };
-    }
-    const nextChildren = root.children.map((child) => removeNodeFromTree(child, nodeId) ?? child);
-    const hasChanged = nextChildren.some((child, index) => child !== root.children?.at(index));
-    return hasChanged ? { ...root, children: nextChildren } : root;
+    return removeTreeNode(root, nodeId, uiNodeTreeAdapter) ?? null;
 };
+/***
+ * Find a node together with its parent and sibling index in a depth-first traversal.
+ * @utility @ankhorage/utility/tree
+ */
 function findNodeWithParent(root, nodeId) {
-    if (root.id === nodeId) {
-        return { node: root, parent: null, index: -1 };
-    }
-    const visit = (node) => {
-        const children = node.children ?? [];
-        for (const [index, child] of children.entries()) {
-            if (child.id === nodeId) {
-                return { node: child, parent: node, index };
-            }
-            const nested = visit(child);
-            if (nested) {
-                return nested;
-            }
-        }
-        return null;
-    };
-    return visit(root);
+    return findTreeNodeWithParent(root, nodeId, uiNodeTreeAdapter) ?? null;
 }
+/***
+ * Return whether a node tree contains a descendant with the requested id.
+ * @utility @ankhorage/utility/tree
+ */
 function isDescendantNode(node, descendantId) {
-    const children = node.children ?? [];
-    for (const child of children) {
-        if (child.id === descendantId || isDescendantNode(child, descendantId)) {
-            return true;
-        }
-    }
-    return false;
+    return isTreeDescendant(node, node.id, descendantId, uiNodeTreeAdapter);
 }
+/***
+ * Immutably remove one node from a tree and return both the next tree and removed node for move operations.
+ * @utility @ankhorage/utility/tree
+ */
 function removeNodeForMove(args) {
     const { node, nodeId } = args;
     const children = node.children ?? [];
@@ -342,6 +338,10 @@ function removeNodeForMove(args) {
         removedNode,
     };
 }
+/***
+ * Return whether Studio component metadata permits one child type under a parent type.
+ * @todo Move this component-placement policy from `src/index.ts` into the `canvas/` or insert-authoring domain.
+ */
 export function canAcceptChild(args) {
     const { parentType, childType, componentMeta } = args;
     const meta = Object.entries(componentMeta).find(([type]) => type === parentType)?.[1];
@@ -349,6 +349,10 @@ export function canAcceptChild(args) {
         return false;
     return meta.allowedChildren.includes(childType);
 }
+/***
+ * Validate one resolved Studio placement against parent existence, child policy, index bounds and sibling-reference invariants.
+ * @todo Move placement validation from the public entrypoint into the `canvas/` domain.
+ */
 export function validateNodePlacement(args) {
     const { root, placement, childType, componentMeta } = args;
     const parent = findNodeById(root, placement.parentId);
@@ -423,6 +427,10 @@ export function validateNodePlacement(args) {
     }
     return { ok: true };
 }
+/***
+ * Resolve a requested inside/before/after insertion target to a validated Studio placement.
+ * @todo Move insertion-placement policy from `src/index.ts` into the `canvas/`/insert domain.
+ */
 export function resolveInsertPlacement(args) {
     const { root, targetNodeId, childType, componentMeta, kind } = args;
     const target = findNodeWithParent(root, targetNodeId);
@@ -472,6 +480,10 @@ export function resolveInsertPlacement(args) {
     }
     return { ok: true, placement };
 }
+/***
+ * Resolve the preferred insertion placement by trying the selected node, its sibling position, then the screen root.
+ * @todo Move Studio default insertion policy from `src/index.ts` into the insert/canvas domain.
+ */
 export function resolveDefaultInsertPlacement(args) {
     const { root, selectedNodeId, childType, componentMeta } = args;
     if (selectedNodeId) {
@@ -511,6 +523,10 @@ export function resolveDefaultInsertPlacement(args) {
         },
     };
 }
+/***
+ * Immutably insert a child at a requested parent/index anywhere in a tree and report whether insertion occurred.
+ * @utility @ankhorage/utility/tree
+ */
 function insertChildAtIndex(args) {
     const { node, parentId, index, newNode } = args;
     if (node.id === parentId) {
@@ -543,6 +559,10 @@ function insertChildAtIndex(args) {
         inserted: true,
     };
 }
+/***
+ * Create and insert one Studio node after validating its requested placement.
+ * @todo Move Studio insertion orchestration from `src/index.ts` into the insert/canvas domain.
+ */
 export function insertNodeAtPlacement(args) {
     const { root, placement, componentMeta, makeNode } = args;
     const newNode = makeNode();
@@ -565,6 +585,10 @@ export function insertNodeAtPlacement(args) {
         return null;
     return { root: result.node, insertedNodeId: newNode.id };
 }
+/***
+ * Adjust a target placement for removal-induced index shifts and reject no-op/self-reference moves.
+ * @todo Keep this placement-specific policy in the canvas domain.
+ */
 function getAdjustedMovePlacement(args) {
     const { source, placement } = args;
     if (!source.parent) {
@@ -586,6 +610,10 @@ function getAdjustedMovePlacement(args) {
         index: adjustedIndex,
     };
 }
+/***
+ * Validate and resolve a requested Studio node move after accounting for source removal and descendant/no-op invariants.
+ * @todo Move node-move policy from `src/index.ts` into the canvas domain.
+ */
 export function resolveMoveNodePlacement(args) {
     const { root, nodeId, placement, componentMeta } = args;
     const source = findNodeWithParent(root, nodeId);
@@ -646,6 +674,10 @@ export function resolveMoveNodePlacement(args) {
         return validation;
     return { ok: true, placement: adjustedPlacement };
 }
+/***
+ * Execute a validated Studio node move as immutable removal followed by insertion.
+ * @todo Move node-move orchestration from `src/index.ts` into the canvas domain.
+ */
 export function moveNodeToPlacement(args) {
     const { root, nodeId, placement, componentMeta } = args;
     const resolution = resolveMoveNodePlacement({ root, nodeId, placement, componentMeta });
@@ -709,20 +741,31 @@ export const STUDIO_INSERT_RECIPES = [
         },
     },
 ];
+/***
+ * Resolve Studio's display label for an insert-catalog category, falling back to the raw category id.
+ * @todo Move insert-catalog presentation metadata out of `src/index.ts` into the insert domain.
+ */
 export function getInsertCatalogCategoryLabel(category) {
     return Object.entries(CATEGORY_LABELS).find(([key]) => key === category)?.[1] ?? category;
 }
+/*** Resolve a category's preferred sort position and place unknown categories after the configured list. */
 function resolveCategoryOrder(category) {
     const index = CATEGORY_ORDER.indexOf(category);
     return index === -1 ? CATEGORY_ORDER.length : index;
 }
+/*** Convert an insert-recipe validation issue to the Studio-facing disabled reason text. */
 function describeInsertRecipeIssue(issue) {
     if (issue.code === 'missing-meta') {
         return `Missing component metadata for ${issue.nodeType}.`;
     }
     return `Child ${issue.childType ?? 'unknown'} is not allowed under ${issue.nodeType}.`;
 }
+/***
+ * Validate an insert recipe recursively against Studio component metadata and allowed-child constraints.
+ * @todo Move recipe validation from `src/index.ts` into the insert/templates domain.
+ */
 export function validateInsertRecipe(recipe, componentMeta) {
+    /*** Visit one recipe node, validating metadata and child compatibility while retaining the recipe path. */
     const visit = (node, path) => {
         const meta = componentMeta[node.type];
         if (!meta) {
@@ -751,7 +794,12 @@ export function validateInsertRecipe(recipe, componentMeta) {
     };
     return visit(recipe.root, [recipe.root.type]);
 }
+/***
+ * Materialize a Studio insert-recipe tree into UiNodes using component blueprint defaults and an injected id generator.
+ * @todo Move recipe-node creation from `src/index.ts` into the insert/templates domain.
+ */
 function createNodeFromRecipe(recipe, componentMeta, createId) {
+    /*** Build one recipe node and recursively materialize its children. */
     const buildNode = (node) => {
         const meta = componentMeta[node.type];
         const defaultProps = meta?.blueprint?.defaultProps;
@@ -764,6 +812,10 @@ function createNodeFromRecipe(recipe, componentMeta, createId) {
     };
     return buildNode(recipe.root);
 }
+/***
+ * Materialize one enabled component or recipe catalog entry into a fresh UiNode tree.
+ * @todo Move insert-catalog node creation from `src/index.ts` into the insert domain.
+ */
 export function createNodeFromCatalogEntry(entry, componentMeta, createId = generateStudioId) {
     if (entry.kind === 'recipe') {
         return createNodeFromRecipe(entry.recipe, componentMeta, createId);
@@ -777,6 +829,7 @@ export function createNodeFromCatalogEntry(entry, componentMeta, createId = gene
         children: [],
     };
 }
+/*** Project one Studio component metadata entry into its insert-catalog entry and direct-node availability state. */
 function createComponentEntry(componentType, meta) {
     const isDirect = meta.directManifestNode === true;
     return {
@@ -795,6 +848,7 @@ function createComponentEntry(componentType, meta) {
             },
     };
 }
+/*** Project one Studio recipe into an enabled/disabled insert-catalog entry after recipe validation. */
 function createRecipeEntry(recipe, componentMeta) {
     const issue = validateInsertRecipe(recipe, componentMeta);
     if (issue) {
@@ -826,6 +880,10 @@ function createRecipeEntry(recipe, componentMeta) {
         status: 'enabled',
     };
 }
+/***
+ * Build and deterministically sort Studio's component/recipe insert catalog from component metadata and recipes.
+ * @todo Move insert-catalog construction from `src/index.ts` into the insert domain.
+ */
 export function buildInsertCatalogEntries(args) {
     const { componentMeta, recipes = STUDIO_INSERT_RECIPES } = args;
     const componentEntries = [];
@@ -835,6 +893,7 @@ export function buildInsertCatalogEntries(args) {
         }
     }
     const recipeEntries = recipes.map((recipe) => createRecipeEntry(recipe, componentMeta));
+    /*** Order catalog entries by configured category rank and then locale-aware label order. */
     return [...componentEntries, ...recipeEntries].sort((left, right) => {
         const leftOrder = resolveCategoryOrder(left.category);
         const rightOrder = resolveCategoryOrder(right.category);
@@ -844,6 +903,7 @@ export function buildInsertCatalogEntries(args) {
         return left.label.localeCompare(right.label);
     });
 }
+/*** Resolve the default validated placement for one insert-catalog entry. */
 function resolvePlacementForEntry(args) {
     const { entry, root, selectedNodeId, componentMeta } = args;
     return resolveDefaultInsertPlacement({
@@ -853,8 +913,13 @@ function resolvePlacementForEntry(args) {
         componentMeta,
     });
 }
+/***
+ * Resolve enabled/disabled insert-catalog state against the active screen and selected-node placement context.
+ * @todo Move context-sensitive insert catalog projection from `src/index.ts` into the insert/canvas application domain.
+ */
 export function resolveInsertCatalogEntries(args) {
     const { entries, root, selectedNodeId, componentMeta } = args;
+    /*** Project one entry to its current placement availability while preserving already-disabled catalog entries. */
     return entries.map((entry) => {
         if (entry.status === 'disabled') {
             return entry;
@@ -892,6 +957,10 @@ export function resolveInsertCatalogEntries(args) {
         };
     });
 }
+/***
+ * Return whether a value is a non-array record whose values are all strings or numbers.
+ * @utility @ankhorage/utility/object
+ */
 function isStyleRecord(value) {
     if (typeof value !== 'object' || value === null || Array.isArray(value))
         return false;