@ankhorage/studio 2.0.23 → 2.0.25

package/dist/bindingOperationModel.js

@@ -1,14 +1,28 @@
+import { findByKey } from '@ankhorage/utility/array';
 import { collectStudioResponsePaths, resolveStudioSchemaValueMeta } from './bindingSchemaModel';
+/***
+ * Collect and alphabetically sort the API operations available for Studio binding authoring.
+ * @todo Move binding operation catalog behavior under src/bindings/.
+ */
 export function collectStudioBindingOperationOptions(apis) {
     return apis
         .flatMap((api) => collectApiOperations(api))
         .sort((left, right) => left.label.localeCompare(right.label));
 }
+/***
+ * Find an option through the canonical keyed array lookup utility.
+ */
 export function findStudioBindingOperationOption(options, ref) {
-    return options.find((option) => option.operation.apiId === ref.apiId &&
-        option.operation.operationId === ref.operationId &&
-        option.operation.endpointId === ref.endpointId);
+    return findByKey(options, toOperationKey(ref), (option) => toOperationKey(option.operation));
 }
+/*** Create a stable key for a Studio binding-operation reference. */
+function toOperationKey(reference) {
+    return `${reference.apiId}:${reference.endpointId}:${reference.operationId}`;
+}
+/***
+ * Project all endpoint operations from one API definition into Studio binding options.
+ * @todo Keep API-to-binding option projection under src/bindings/.
+ */
 function collectApiOperations(api) {
     return Object.values(api.endpoints).flatMap((endpoint) => Object.values(endpoint.operations).map((operation) => ({
         operation: {
@@ -22,6 +36,10 @@ function collectApiOperations(api) {
         responsePaths: collectStudioResponsePaths(resolveSlotSchema(api, operation.response), api.schemas),
     })));
 }
+/***
+ * Collect request parameters and request-body properties as Studio binding input fields.
+ * @todo Keep operation input-field projection under src/bindings/.
+ */
 function collectOperationInputFields(api, operation) {
     const fields = new Map();
     for (const parameter of operation.request?.parameters ?? []) {
@@ -45,12 +63,24 @@ function collectOperationInputFields(api, operation) {
     }
     return [...fields.values()];
 }
+/***
+ * Resolve an inline schema or schema reference from an API operation slot.
+ * @todo Move this reusable API-contract helper to @ankhorage/contracts beside API schema definitions.
+ */
 function resolveSlotSchema(api, slot) {
     return slot?.schema ?? (slot?.schemaRef ? api.schemas?.[slot.schemaRef.id] : undefined);
 }
+/***
+ * Format one API definition as a compact id, origin, and protocol label.
+ * @todo Keep API-specific presentation formatting with the binding authoring owner.
+ */
 function describeApi(api) {
     return `${api.id} · ${api.origin} · ${api.protocol}`;
 }
+/***
+ * Convert an action payload schema into Studio binding input-field options.
+ * @todo Move action binding-field projection under src/bindings/.
+ */
 export function createStudioActionInputFields(payloadSchema) {
     return Object.entries(payloadSchema ?? {}).map(([name, field]) => ({
         name,
@@ -59,6 +89,10 @@ export function createStudioActionInputFields(payloadSchema) {
         required: field.required ?? false,
     }));
 }
+/***
+ * Narrow an arbitrary payload type string to the primitive types supported by bindable values.
+ * @todo Keep bindable-type semantics under src/bindings/.
+ */
 function toBindableType(type) {
     if (type === 'string' || type === 'number' || type === 'boolean' || type === 'object') {
         return type;

package/dist/bindingOperationModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindingOperationModel.js","sourceRoot":"","sources":["../src/bindingOperationModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bindingOperationModel.js","sourceRoot":"","sources":["../src/bindingOperationModel.ts"],"names":[],"mappings":"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"}

package/dist/bindingSchemaModel.d.ts

@@ -1,6 +1,18 @@
 import type { DataSchema, DataSchemaRegistry, UiBindableValueMeta } from '@ankhorage/contracts';
 import type { StudioBindingCompatibility, StudioBindingResponsePathOption } from './bindingAuthoringContracts';
+/***
+ * Resolve a contracts data schema into the bindable value metadata used by Studio authoring.
+ * @todo Move binding schema interpretation under src/bindings/.
+ */
 export declare function resolveStudioSchemaValueMeta(schema: DataSchema | undefined, schemas: DataSchemaRegistry | undefined, seen?: ReadonlySet<string>): UiBindableValueMeta;
+/***
+ * Collect response-path options from a schema for Studio binding authoring.
+ * @todo Move response-path authoring under src/bindings/.
+ */
 export declare function collectStudioResponsePaths(schema: DataSchema | undefined, schemas: DataSchemaRegistry | undefined): readonly StudioBindingResponsePathOption[];
+/***
+ * Assess whether an actual bindable value shape can satisfy an expected Studio binding shape.
+ * @todo Keep binding compatibility policy under src/bindings/.
+ */
 export declare function assessStudioBindingCompatibility(expected: UiBindableValueMeta, actual: UiBindableValueMeta): StudioBindingCompatibility;
 //# sourceMappingURL=bindingSchemaModel.d.ts.map

package/dist/bindingSchemaModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindingSchemaModel.d.ts","sourceRoot":"","sources":["../src/bindingSchemaModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,6BAA6B,CAAC;AAGrC,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,mBAAmB,CAarB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,SAAS,+BAA+B,EAAE,CAK5C;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,mBAAmB,GAC1B,0BAA0B,CAU5B"}
+{"version":3,"file":"bindingSchemaModel.d.ts","sourceRoot":"","sources":["../src/bindingSchemaModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAElB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,mBAAmB,CAarB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,SAAS,+BAA+B,EAAE,CAK5C;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,mBAAmB,GAC1B,0BAA0B,CAU5B"}

package/dist/bindingSchemaModel.js

@@ -1,6 +1,10 @@
-import { readOwnProperty } from './utils/readOwnProperty';
+import { resolveSchemaReference, resolveSingleSchemaType } from '@ankhorage/utility/schema';
+/***
+ * Resolve a contracts data schema into the bindable value metadata used by Studio authoring.
+ * @todo Move binding schema interpretation under src/bindings/.
+ */
 export function resolveStudioSchemaValueMeta(schema, schemas, seen = new Set()) {
-    const resolved = resolveSchemaRef(schema, schemas, seen);
+    const resolved = resolveSchemaReference(schema, schemas, seen);
     if (!resolved)
         return { type: 'unknown' };
     const type = resolveSchemaType(resolved);
@@ -12,12 +16,20 @@ export function resolveStudioSchemaValueMeta(schema, schemas, seen = new Set())
         ...(itemType ? { itemType } : {}),
     };
 }
+/***
+ * Collect response-path options from a schema for Studio binding authoring.
+ * @todo Move response-path authoring under src/bindings/.
+ */
 export function collectStudioResponsePaths(schema, schemas) {
     const root = resolveStudioSchemaValueMeta(schema, schemas);
     const paths = [{ path: '', label: 'Response', value: root }];
     collectObjectPaths(schema, schemas, '', paths, new Set());
     return paths;
 }
+/***
+ * Assess whether an actual bindable value shape can satisfy an expected Studio binding shape.
+ * @todo Keep binding compatibility policy under src/bindings/.
+ */
 export function assessStudioBindingCompatibility(expected, actual) {
     if (expected.type === 'unknown' || actual.type === 'unknown')
         return 'unknown';
@@ -34,8 +46,12 @@ export function assessStudioBindingCompatibility(expected, actual) {
         return 'compatible';
     return 'incompatible';
 }
+/***
+ * Recursively append object-property response paths and their resolved binding metadata.
+ * @todo Keep recursive binding response-path collection under src/bindings/.
+ */
 function collectObjectPaths(schema, schemas, prefix, paths, seen) {
-    const resolved = resolveSchemaRef(schema, schemas, seen);
+    const resolved = resolveSchemaReference(schema, schemas, seen);
     if (!resolved?.properties)
         return;
     for (const [name, property] of Object.entries(resolved.properties)) {
@@ -48,13 +64,10 @@ function collectObjectPaths(schema, schemas, prefix, paths, seen) {
         collectObjectPaths(property, schemas, path, paths, new Set(seen));
     }
 }
-function resolveSchemaRef(schema, schemas, seen) {
-    const refId = schema?.ref?.id;
-    if (!refId || !schemas || seen.has(refId))
-        return schema;
-    const referenced = readOwnProperty(schemas, refId);
-    return referenced ? resolveSchemaRef(referenced, schemas, new Set([...seen, refId])) : schema;
-}
+/***
+ * Project schema properties into the field metadata expected by Studio bindings.
+ * @todo Keep bindable field projection under src/bindings/.
+ */
 function resolveSchemaFields(schema, schemas, seen) {
     return Object.entries(schema.properties ?? {}).map(([path, property]) => ({
         path,
@@ -62,6 +75,10 @@ function resolveSchemaFields(schema, schemas, seen) {
         required: schema.required?.includes(path) ?? false,
     }));
 }
+/***
+ * Normalize a schema's format, primitive type, and structural hints into one effective value type.
+ * @utility @ankhorage/utility/schema
+ */
 function resolveSchemaType(schema) {
     if (schema.format === 'date' || schema.format === 'date-time')
         return 'date';
@@ -82,14 +99,21 @@ function resolveSchemaType(schema) {
         return 'array';
     return 'unknown';
 }
-function resolveSingleSchemaType(type) {
-    if (typeof type === 'string')
-        return type;
-    return type?.length === 1 ? type.at(0) : undefined;
-}
+/***
+ * Return a schema primitive type only when the declaration contains exactly one effective type.
+ * @utility @ankhorage/utility/schema
+ */
+/***
+ * Test whether a bindable value type represents an object-shaped value.
+ * @todo Keep this bindable-type semantic predicate under src/bindings/.
+ */
 function isObjectLike(type) {
     return type === 'object' || type === 'record';
 }
+/***
+ * Detect the object-field shape Studio accepts as an image-asset-compatible binding value.
+ * @todo Keep image-asset binding compatibility under src/bindings/.
+ */
 function isImageAssetShape(value) {
     return (isObjectLike(value.type) &&
         value.fields?.some((field) => field.path === 'uri' && field.type === 'string') === true);

package/dist/bindingSchemaModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindingSchemaModel.js","sourceRoot":"","sources":["../src/bindingSchemaModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bindingSchemaModel.js","sourceRoot":"","sources":["../src/bindingSchemaModel.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAO5F;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA8B,EAC9B,OAAuC,EACvC,OAA4B,IAAI,GAAG,EAAE;IAErC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5D,MAAM,QAAQ,GACZ,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,4BAA4B,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAElG,OAAO;QACL,IAAI;QACJ,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA8B,EAC9B,OAAuC;IAEvC,MAAM,IAAI,GAAG,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAsC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAA6B,EAC7B,MAA2B;IAE3B,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/E,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,YAAY,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC7D,OAAO,QAAQ,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/E,CAAC;IACD,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAClF,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IACrF,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CACzB,MAA8B,EAC9B,OAAuC,EACvC,MAAc,EACd,KAAwC,EACxC,IAAiB;IAEjB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,EAAE,UAAU;QAAE,OAAO;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI;YACJ,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC;SAC7D,CAAC,CAAC;QACH,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,MAAkB,EAClB,OAAuC,EACvC,IAAyB;IAEzB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI;QACJ,IAAI,EAAE,4BAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI;QAChE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK;KACnD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAkB;IAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IAC7E,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnF,IACE,OAAO,KAAK,OAAO;QACnB,OAAO,KAAK,SAAS;QACrB,OAAO,KAAK,QAAQ;QACpB,OAAO,KAAK,QAAQ,EACpB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AAEH;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAiC;IACrD,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,KAA0B;IACnD,OAAO,CACL,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;QACxB,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,IAAI,CACxF,CAAC;AACJ,CAAC"}

package/dist/canExecuteProjectDeployRelease.d.ts

@@ -1,3 +1,7 @@
 import type { ProjectDeployReleaseInspectionResult } from './projectDeployReleaseInspectionResult';
+/***
+ * Decide whether a prepared Studio deploy release may execute without pending inspection actions.
+ * @todo Move deploy execution-gate policy under src/deploy/.
+ */
 export declare function canExecuteProjectDeployRelease(result: ProjectDeployReleaseInspectionResult): boolean;
 //# sourceMappingURL=canExecuteProjectDeployRelease.d.ts.map

package/dist/canExecuteProjectDeployRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canExecuteProjectDeployRelease.d.ts","sourceRoot":"","sources":["../src/canExecuteProjectDeployRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAEnG,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAET"}
+{"version":3,"file":"canExecuteProjectDeployRelease.d.ts","sourceRoot":"","sources":["../src/canExecuteProjectDeployRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAET"}

package/dist/canExecuteProjectDeployRelease.js

@@ -1,3 +1,7 @@
+/***
+ * Decide whether a prepared Studio deploy release may execute without pending inspection actions.
+ * @todo Move deploy execution-gate policy under src/deploy/.
+ */
 export function canExecuteProjectDeployRelease(result) {
     return result.ok && result.plan.status === 'changes' && result.inspection.actions.length === 0;
 }

package/dist/canExecuteProjectDeployRelease.js.map

@@ -1 +1 @@
-{"version":3,"file":"canExecuteProjectDeployRelease.js","sourceRoot":"","sources":["../src/canExecuteProjectDeployRelease.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,8BAA8B,CAC5C,MAA4C;IAE5C,OAAO,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;AACjG,CAAC"}
+{"version":3,"file":"canExecuteProjectDeployRelease.js","sourceRoot":"","sources":["../src/canExecuteProjectDeployRelease.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAA4C;IAE5C,OAAO,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;AACjG,CAAC"}

package/dist/canvasDragModel.d.ts

@@ -21,20 +21,48 @@ export interface CanvasDragSessionResolution {
     readonly activeDragNodeId: string | null;
     readonly shouldReset: boolean;
 }
+/***
+ * Keep or reset the active Studio canvas drag session when edit mode, selection, or tree membership changes.
+ * @todo Move Studio canvas drag-session behavior under src/canvas/.
+ */
 export declare function resolveCanvasDragSession(args: {
     readonly activeDragNodeId: string | null;
     readonly isEditMode: boolean;
     readonly rootNode: UiNode | null;
     readonly selectedNodeId: string | null;
 }): CanvasDragSessionResolution;
+/***
+ * Create the Studio-specific drag payload used to identify a canvas node.
+ * @todo Move Studio canvas drag payload behavior under src/canvas/.
+ */
 export declare function createStudioCanvasDragPayload(nodeId: string): StudioCanvasDragPayload;
+/***
+ * Validate an unknown value as the Studio-specific canvas drag payload.
+ * @todo Move Studio canvas drag payload validation under src/canvas/.
+ */
 export declare function isStudioCanvasDragPayload(value: unknown): value is StudioCanvasDragPayload;
+/***
+ * Narrow a canvas drop-zone resolution to its valid variant.
+ * @todo Keep the Studio drop-zone discriminator with src/canvas/.
+ */
 export declare function isValidCanvasDropZone(zone: CanvasDropZoneResolution): zone is ValidCanvasDropZoneResolution;
+/***
+ * Group valid Studio drop zones into before, inside, and after slots.
+ * @todo Move Studio drop-zone slot behavior under src/canvas/.
+ */
 export declare function resolveCanvasDropZoneSlots(zones: readonly CanvasDropZoneResolution[]): CanvasDropZoneSlots;
+/***
+ * Resolve a before, inside, or after drop-target rectangle from target and dragged rectangles.
+ * @utility @ankhorage/utility/geometry
+ */
 export declare function resolveCanvasDropZoneRect(args: {
     readonly kind: PlacementKind;
     readonly targetRect: CanvasRect;
     readonly draggedRect: CanvasRect;
 }): CanvasRect;
+/***
+ * Read the first useful display string from a preferred property-key list and limit its preview length.
+ * @utility @ankhorage/utility/object
+ */
 export declare function resolveCanvasDragPreviewText(props: Record<string, unknown> | undefined): string | null;
 //# sourceMappingURL=canvasDragModel.d.ts.map

package/dist/canvasDragModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDragModel.d.ts","sourceRoot":"","sources":["../src/canvasDragModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAKD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,cAAc,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACrD,cAAc,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACrD,aAAa,EAAE,6BAA6B,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAOD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,2BAA2B,CAe9B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAErF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAM1F;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,wBAAwB,GAC7B,IAAI,IAAI,6BAA6B,CAEvC;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,wBAAwB,EAAE,GACzC,mBAAmB,CASrB;AASD,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC,GAAG,UAAU,CA4Bb;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,GAAG,IAAI,CASf"}
+{"version":3,"file":"canvasDragModel.d.ts","sourceRoot":"","sources":["../src/canvasDragModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAKnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACzD,cAAc,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACrD,cAAc,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACrD,aAAa,EAAE,6BAA6B,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,GAAG,2BAA2B,CAmB9B;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAErF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAM1F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,wBAAwB,GAC7B,IAAI,IAAI,6BAA6B,CAEvC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,wBAAwB,EAAE,GACzC,mBAAmB,CASrB;AAaD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC,GAAG,UAAU,CAEb;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,GAAG,IAAI,CASf"}

package/dist/canvasDragModel.js

@@ -1,11 +1,10 @@
-import { readOwnProperty } from './utils/readOwnProperty';
-const MIN_DROP_ZONE_SIZE = 24;
-const MAX_DROP_ZONE_SIZE = 96;
-function treeContainsNode(root, nodeId) {
-    if (root.id === nodeId)
-        return true;
-    return root.children?.some((child) => treeContainsNode(child, nodeId)) ?? false;
-}
+import { resolveDropZoneRect } from '@ankhorage/utility/geometry';
+import { readOwnProperty } from '@ankhorage/utility/object';
+import { treeContainsId } from '@ankhorage/utility/tree';
+/***
+ * Keep or reset the active Studio canvas drag session when edit mode, selection, or tree membership changes.
+ * @todo Move Studio canvas drag-session behavior under src/canvas/.
+ */
 export function resolveCanvasDragSession(args) {
     const { activeDragNodeId } = args;
     if (!activeDragNodeId) {
@@ -14,14 +13,26 @@ export function resolveCanvasDragSession(args) {
     const isValid = args.isEditMode &&
         args.selectedNodeId === activeDragNodeId &&
         args.rootNode !== null &&
-        treeContainsNode(args.rootNode, activeDragNodeId);
+        treeContainsId(args.rootNode, activeDragNodeId, {
+            getId: (node) => node.id,
+            getChildren: (node) => node.children ?? [],
+            withChildren: (node, children) => ({ ...node, children: [...children] }),
+        });
     return isValid
         ? { activeDragNodeId, shouldReset: false }
         : { activeDragNodeId: null, shouldReset: true };
 }
+/***
+ * Create the Studio-specific drag payload used to identify a canvas node.
+ * @todo Move Studio canvas drag payload behavior under src/canvas/.
+ */
 export function createStudioCanvasDragPayload(nodeId) {
     return { kind: 'studio-canvas-node', nodeId };
 }
+/***
+ * Validate an unknown value as the Studio-specific canvas drag payload.
+ * @todo Move Studio canvas drag payload validation under src/canvas/.
+ */
 export function isStudioCanvasDragPayload(value) {
     if (typeof value !== 'object' || value === null)
         return false;
@@ -30,9 +41,17 @@ export function isStudioCanvasDragPayload(value) {
     const candidate = value;
     return candidate.kind === 'studio-canvas-node' && typeof candidate.nodeId === 'string';
 }
+/***
+ * Narrow a canvas drop-zone resolution to its valid variant.
+ * @todo Keep the Studio drop-zone discriminator with src/canvas/.
+ */
 export function isValidCanvasDropZone(zone) {
     return zone.status === 'valid';
 }
+/***
+ * Group valid Studio drop zones into before, inside, and after slots.
+ * @todo Move Studio drop-zone slot behavior under src/canvas/.
+ */
 export function resolveCanvasDropZoneSlots(zones) {
     const validDropZones = zones.filter(isValidCanvasDropZone);
     return {
@@ -42,36 +61,24 @@ export function resolveCanvasDropZoneSlots(zones) {
         afterDropZone: findDropZoneByKind(validDropZones, 'after'),
     };
 }
+/***
+ * Find one valid Studio drop zone by placement kind.
+ * @todo Keep Studio placement lookup with src/canvas/.
+ */
 function findDropZoneByKind(zones, kind) {
     return zones.find((zone) => zone.kind === kind) ?? null;
 }
+/***
+ * Resolve a before, inside, or after drop-target rectangle from target and dragged rectangles.
+ * @utility @ankhorage/utility/geometry
+ */
 export function resolveCanvasDropZoneRect(args) {
-    const { kind, targetRect, draggedRect } = args;
-    const edgeSize = Math.max(MIN_DROP_ZONE_SIZE, Math.min(MAX_DROP_ZONE_SIZE, draggedRect.height));
-    if (kind === 'before') {
-        return {
-            x: targetRect.x,
-            y: targetRect.y - edgeSize / 2,
-            width: targetRect.width,
-            height: edgeSize,
-        };
-    }
-    if (kind === 'after') {
-        return {
-            x: targetRect.x,
-            y: targetRect.y + targetRect.height - edgeSize / 2,
-            width: targetRect.width,
-            height: edgeSize,
-        };
-    }
-    const inset = Math.min(edgeSize / 2, targetRect.width / 4, targetRect.height / 4);
-    return {
-        x: targetRect.x + inset,
-        y: targetRect.y + inset,
-        width: Math.max(MIN_DROP_ZONE_SIZE, targetRect.width - inset * 2),
-        height: Math.max(MIN_DROP_ZONE_SIZE, targetRect.height - inset * 2),
-    };
+    return resolveDropZoneRect(args);
 }
+/***
+ * Read the first useful display string from a preferred property-key list and limit its preview length.
+ * @utility @ankhorage/utility/object
+ */
 export function resolveCanvasDragPreviewText(props) {
     if (!props)
         return null;

package/dist/canvasDragModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDragModel.js","sourceRoot":"","sources":["../src/canvasDragModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"canvasDragModel.js","sourceRoot":"","sources":["../src/canvasDragModel.ts"],"names":[],"mappings":"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"}

package/dist/canvasDropZones.d.ts

@@ -11,12 +11,20 @@ interface InvalidCanvasDropZoneResolution {
     reason: PlacementFailureReason;
 }
 export type CanvasDropZoneResolution = ValidCanvasDropZoneResolution | InvalidCanvasDropZoneResolution;
+/***
+ * Resolve every Studio canvas placement kind as a valid or invalid drop zone for the dragged node.
+ * @todo Move Studio canvas drop-zone behavior under src/canvas/.
+ */
 export declare function resolveCanvasDropZones(args: {
     root: UiNode;
     targetNodeId: string;
     draggedNode: UiNode;
     componentMeta: StudioComponentMetaRegistry;
 }): readonly CanvasDropZoneResolution[];
+/***
+ * Filter Studio drop-zone resolutions to only their valid variants.
+ * @utility @ankhorage/utility/array
+ */
 export declare function getValidCanvasDropZones(zones: readonly CanvasDropZoneResolution[]): readonly ValidCanvasDropZoneResolution[];
 export {};
 //# sourceMappingURL=canvasDropZones.d.ts.map

package/dist/canvasDropZones.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDropZones.d.ts","sourceRoot":"","sources":["../src/canvasDropZones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,UAAU,+BAA+B;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAClC,6BAA6B,GAAG,+BAA+B,CAAC;AAIlE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,SAAS,wBAAwB,EAAE,CAmDtC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,wBAAwB,EAAE,GACzC,SAAS,6BAA6B,EAAE,CAE1C"}
+{"version":3,"file":"canvasDropZones.d.ts","sourceRoot":"","sources":["../src/canvasDropZones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,aAAa,EACb,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,UAAU,+BAA+B;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAClC,6BAA6B,GAAG,+BAA+B,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,2BAA2B,CAAC;CAC5C,GAAG,SAAS,wBAAwB,EAAE,CAmDtC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,wBAAwB,EAAE,GACzC,SAAS,6BAA6B,EAAE,CAE1C"}

package/dist/canvasDropZones.js

@@ -1,5 +1,10 @@
+import { filterBy } from '@ankhorage/utility/array';
 import { resolveInsertPlacement, resolveMoveNodePlacement } from './index';
 const DROP_ZONE_KINDS = ['before', 'inside', 'after'];
+/***
+ * Resolve every Studio canvas placement kind as a valid or invalid drop zone for the dragged node.
+ * @todo Move Studio canvas drop-zone behavior under src/canvas/.
+ */
 export function resolveCanvasDropZones(args) {
     const { root, targetNodeId, draggedNode, componentMeta } = args;
     return DROP_ZONE_KINDS.map((kind) => {
@@ -47,7 +52,11 @@ export function resolveCanvasDropZones(args) {
         };
     });
 }
+/***
+ * Filter Studio drop-zone resolutions to only their valid variants.
+ * @utility @ankhorage/utility/array
+ */
 export function getValidCanvasDropZones(zones) {
-    return zones.filter((zone) => zone.status === 'valid');
+    return filterBy(zones, (zone) => zone.status === 'valid');
 }
 //# sourceMappingURL=canvasDropZones.js.map

package/dist/canvasDropZones.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDropZones.js","sourceRoot":"","sources":["../src/canvasDropZones.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAiB3E,MAAM,eAAe,GAA6B,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEhF,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAEhE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,IAAI,WAAW,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE;oBACN,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,iCAAiC;iBAC3C;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,sBAAsB,CAAC;YACvC,IAAI;YACJ,YAAY;YACZ,SAAS,EAAE,WAAW,CAAC,IAAI;YAC3B,aAAa;YACb,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,MAAM;aACzB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YACxC,IAAI;YACJ,MAAM,EAAE,WAAW,CAAC,EAAE;YACtB,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,aAAa;SACd,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAA0C;IAE1C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAyC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;AAChG,CAAC"}
+{"version":3,"file":"canvasDropZones.js","sourceRoot":"","sources":["../src/canvasDropZones.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAQpD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAiB3E,MAAM,eAAe,GAA6B,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAEhE,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,IAAI,WAAW,CAAC,EAAE,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE;oBACN,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,iCAAiC;iBAC3C;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,sBAAsB,CAAC;YACvC,IAAI;YACJ,YAAY;YACZ,SAAS,EAAE,WAAW,CAAC,IAAI;YAC3B,aAAa;YACb,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,SAAS,CAAC,MAAM;aACzB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC;YACxC,IAAI;YACJ,MAAM,EAAE,WAAW,CAAC,EAAE;YACtB,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,aAAa;SACd,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA0C;IAE1C,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAyC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;AACnG,CAAC"}

package/dist/contractGuards.d.ts

@@ -1,8 +1,14 @@
 import { type ColorHarmony } from '@ankhorage/color-theory';
 import { type AppCategory, isAppManifest } from '@ankhorage/contracts';
 export { isAppManifest };
-/*** @owner ankhorage/contracts/{category}/utils/isAppCateory.ts */
+/***
+ * Narrow an unknown value to an application category defined by the contracts package.
+ * @todo Move this reusable domain guard to @ankhorage/contracts beside APP_CATEGORIES.
+ */
 export declare function isAppCategory(value: unknown): value is AppCategory;
-/*** @owner ankhorage/color-theory */
+/***
+ * Narrow an unknown value to a color harmony defined by the color-theory package.
+ * @todo Move this reusable domain guard to @ankhorage/color-theory beside COLOR_HARMONIES.
+ */
 export declare function isColorHarmony(value: unknown): value is ColorHarmony;
 //# sourceMappingURL=contractGuards.d.ts.map

package/dist/contractGuards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contractGuards.d.ts","sourceRoot":"","sources":["../src/contractGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAkB,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKvF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED,qCAAqC;AACrC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}
+{"version":3,"file":"contractGuards.d.ts","sourceRoot":"","sources":["../src/contractGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAkB,KAAK,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKvF,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE"}

package/dist/contractGuards.js

@@ -3,11 +3,17 @@ import { APP_CATEGORIES, isAppManifest } from '@ankhorage/contracts';
 const APP_CATEGORY_SET = new Set(APP_CATEGORIES);
 const COLOR_HARMONY_SET = new Set(COLOR_HARMONIES);
 export { isAppManifest };
-/*** @owner ankhorage/contracts/{category}/utils/isAppCateory.ts */
+/***
+ * Narrow an unknown value to an application category defined by the contracts package.
+ * @todo Move this reusable domain guard to @ankhorage/contracts beside APP_CATEGORIES.
+ */
 export function isAppCategory(value) {
     return typeof value === 'string' && APP_CATEGORY_SET.has(value);
 }
-/*** @owner ankhorage/color-theory */
+/***
+ * Narrow an unknown value to a color harmony defined by the color-theory package.
+ * @todo Move this reusable domain guard to @ankhorage/color-theory beside COLOR_HARMONIES.
+ */
 export function isColorHarmony(value) {
     return typeof value === 'string' && COLOR_HARMONY_SET.has(value);
 }

package/dist/contractGuards.js.map

@@ -1 +1 @@
-{"version":3,"file":"contractGuards.js","sourceRoot":"","sources":["../src/contractGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AACzD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,eAAe,CAAC,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"contractGuards.js","sourceRoot":"","sources":["../src/contractGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAqB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAoB,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AACzD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS,eAAe,CAAC,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC"}

package/dist/core/StudioContext.d.ts

@@ -2,5 +2,9 @@ import type { StudioContextValue } from '../index';
 export type { StudioAdminRoutePath, StudioPanelId, ThemeUpdates } from '../index';
 export type StudioContextType = StudioContextValue;
 export declare const StudioContext: import("react").Context<StudioContextValue | undefined>;
+/***
+ * Read the active Studio context and fail when called outside a StudioProvider.
+ * @todo Move package-wide React composition out of core into the app edge.
+ */
 export declare const useStudio: () => StudioContextValue;
 //# sourceMappingURL=StudioContext.d.ts.map

package/dist/core/StudioContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StudioContext.d.ts","sourceRoot":"","sources":["../../src/core/StudioContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEnD,eAAO,MAAM,aAAa,yDAA0D,CAAC;AAErF,eAAO,MAAM,SAAS,0BAMrB,CAAC"}
+{"version":3,"file":"StudioContext.d.ts","sourceRoot":"","sources":["../../src/core/StudioContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEnD,eAAO,MAAM,aAAa,yDAA0D,CAAC;AAErF;;;GAGG;AACH,eAAO,MAAM,SAAS,0BAMrB,CAAC"}

package/dist/core/StudioContext.js

@@ -1,5 +1,9 @@
 import { createContext, useContext } from 'react';
 export const StudioContext = createContext(undefined);
+/***
+ * Read the active Studio context and fail when called outside a StudioProvider.
+ * @todo Move package-wide React composition out of core into the app edge.
+ */
 export const useStudio = () => {
     const context = useContext(StudioContext);
     if (!context) {

package/dist/core/StudioContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"StudioContext.js","sourceRoot":"","sources":["../../src/core/StudioContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAOlD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAgC,SAAS,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"StudioContext.js","sourceRoot":"","sources":["../../src/core/StudioContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAOlD,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAgC,SAAS,CAAC,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE;IAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/core/StudioProvider.d.ts

@@ -9,6 +9,7 @@ export interface StudioProviderProps {
     componentMeta: StudioComponentMetaRegistry;
     mediaPicker?: StudioMediaPickerAdapter;
 }
+/*** Own Studio authoring state, manifest mutations, media actions, selection, navigation, and persistence for one project. */
 export declare const StudioProvider: ({ children, projectId, initialManifest, activePathname, componentMeta, mediaPicker, }: StudioProviderProps) => React.FunctionComponentElement<{
     readonly projectId: string;
     readonly children: React.ReactNode;