@ankhorage/studio 2.0.22 → 2.0.24

package/dist/bindingMetadataModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindingMetadataModel.d.ts","sourceRoot":"","sources":["../src/bindingMetadataModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAErC,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,uBAAuB,GAChC,SAAS,wBAAwB,EAAE,CAQrC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,uBAAuB,GAChC,SAAS,yBAAyB,EAAE,CAQtC"}
+{"version":3,"file":"bindingMetadataModel.d.ts","sourceRoot":"","sources":["../src/bindingMetadataModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE5E,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,uBAAuB,GAChC,SAAS,wBAAwB,EAAE,CAQrC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,uBAAuB,GAChC,SAAS,yBAAyB,EAAE,CAQtC"}

package/dist/bindingMetadataModel.js

@@ -1,3 +1,7 @@
+/***
+ * Convert a component's bindable prop metadata record into labeled authoring options.
+ * @utility @ankhorage/utility/collection
+ */
 export function resolveStudioBindableProps(node, registry) {
     const props = registry[node.type]?.bindings?.props ?? {};
     return Object.entries(props).map(([name, meta]) => ({
@@ -6,6 +10,10 @@ export function resolveStudioBindableProps(node, registry) {
         meta,
     }));
 }
+/***
+ * Convert a component's bindable event metadata record into labeled authoring options.
+ * @utility @ankhorage/utility/collection
+ */
 export function resolveStudioBindableEvents(node, registry) {
     const events = registry[node.type]?.bindings?.events ?? {};
     return Object.entries(events).map(([name, meta]) => ({

package/dist/bindingMetadataModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"bindingMetadataModel.js","sourceRoot":"","sources":["../src/bindingMetadataModel.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,QAAiC;IAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;IAEzD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,QAAiC;IAEjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IAE3D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"bindingMetadataModel.js","sourceRoot":"","sources":["../src/bindingMetadataModel.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,QAAiC;IAEjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC;IAEzD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAY,EACZ,QAAiC;IAEjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,CAAC;IAE3D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,IAAI;KACL,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/bindingMutationModel.d.ts

@@ -1,6 +1,22 @@
 import type { ComponentDataBindingRegistry, EventBinding, PropBinding, UiNode } from '@ankhorage/contracts';
+/***
+ * Add or replace one Studio prop binding for a component node.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export declare function upsertStudioPropBinding(registry: ComponentDataBindingRegistry, node: UiNode, propName: string, binding: PropBinding): ComponentDataBindingRegistry;
+/***
+ * Remove one Studio prop binding while leaving unrelated component bindings intact.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export declare function removeStudioPropBinding(registry: ComponentDataBindingRegistry, node: UiNode, propName: string): ComponentDataBindingRegistry;
+/***
+ * Append an event binding to one Studio node/event pair without replacing earlier bindings.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export declare function appendStudioEventBinding(registry: ComponentDataBindingRegistry, node: UiNode, eventName: string, binding: EventBinding): ComponentDataBindingRegistry;
+/***
+ * Remove one indexed event binding and delete the event entry when no bindings remain.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export declare function removeStudioEventBinding(registry: ComponentDataBindingRegistry, node: UiNode, eventName: string, bindingIndex: number): ComponentDataBindingRegistry;
 //# sourceMappingURL=bindingMutationModel.d.ts.map

package/dist/bindingMutationModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindingMutationModel.d.ts","sourceRoot":"","sources":["../src/bindingMutationModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,4BAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,MAAM,EACP,MAAM,sBAAsB,CAAC;AAM9B,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,4BAA4B,CAK9B;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAM9B;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,GACpB,4BAA4B,CAQ9B;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,4BAA4B,CAW9B"}
+{"version":3,"file":"bindingMutationModel.d.ts","sourceRoot":"","sources":["../src/bindingMutationModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,4BAA4B,EAC5B,YAAY,EACZ,WAAW,EACX,MAAM,EACP,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,4BAA4B,CAK9B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAM9B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,GACpB,4BAA4B,CAQ9B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,4BAA4B,EACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,4BAA4B,CAW9B"}

package/dist/bindingMutationModel.js

@@ -1,12 +1,18 @@
-import { deleteOwnProperty } from './utils/deleteOwnProperty';
-import { readOwnProperty } from './utils/readOwnProperty';
-import { setOwnProperty } from './utils/setOwnProperty';
+import { deleteOwnProperty, readOwnProperty, setOwnProperty } from '@ankhorage/utility/object';
+/***
+ * Add or replace one Studio prop binding for a component node.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export function upsertStudioPropBinding(registry, node, propName, binding) {
     const current = readOwnProperty(registry, node.id);
     const props = { ...(current?.props ?? {}) };
     setOwnProperty(props, propName, binding);
     return writeBinding(registry, node, { ...current, props });
 }
+/***
+ * Remove one Studio prop binding while leaving unrelated component bindings intact.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export function removeStudioPropBinding(registry, node, propName) {
     const current = readOwnProperty(registry, node.id);
     if (!current?.props || !readOwnProperty(current.props, propName))
@@ -15,6 +21,10 @@ export function removeStudioPropBinding(registry, node, propName) {
     deleteOwnProperty(props, propName);
     return writeBinding(registry, node, { ...current, props });
 }
+/***
+ * Append an event binding to one Studio node/event pair without replacing earlier bindings.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export function appendStudioEventBinding(registry, node, eventName, binding) {
     const current = readOwnProperty(registry, node.id);
     const events = { ...(current?.events ?? {}) };
@@ -24,6 +34,10 @@ export function appendStudioEventBinding(registry, node, eventName, binding) {
     setOwnProperty(events, eventName, [...bindings, binding]);
     return writeBinding(registry, node, { ...current, events });
 }
+/***
+ * Remove one indexed event binding and delete the event entry when no bindings remain.
+ * @todo Move binding mutation behavior under src/bindings/.
+ */
 export function removeStudioEventBinding(registry, node, eventName, bindingIndex) {
     const current = readOwnProperty(registry, node.id);
     const bindings = current?.events
@@ -39,6 +53,10 @@ export function removeStudioEventBinding(registry, node, eventName, bindingIndex
         deleteOwnProperty(events, eventName);
     return writeBinding(registry, node, { ...current, events });
 }
+/***
+ * Write normalized component identity into a binding registry and remove empty bindings.
+ * @todo Keep component-binding normalization under src/bindings/.
+ */
 function writeBinding(registry, node, value) {
     const next = { ...registry };
     const binding = {
@@ -52,6 +70,10 @@ function writeBinding(registry, node, value) {
         setOwnProperty(next, node.id, binding);
     return next;
 }
+/***
+ * Test whether a binding has no prop or event entries.
+ * @utility @ankhorage/utility/object
+ */
 function isEmptyBinding(binding) {
     return (Object.keys(binding.props ?? {}).length === 0 && Object.keys(binding.events ?? {}).length === 0);
 }

package/dist/bindingMutationModel.js.map

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

package/dist/bindingOperationModel.d.ts

@@ -1,7 +1,18 @@
 import type { ApiDefinitionList, BindingOperationRef } from '@ankhorage/contracts';
 import type { StudioBindingInputFieldOption, StudioBindingOperationOption } from './bindingAuthoringContracts';
+/***
+ * Collect and alphabetically sort the API operations available for Studio binding authoring.
+ * @todo Move binding operation catalog behavior under src/bindings/.
+ */
 export declare function collectStudioBindingOperationOptions(apis: ApiDefinitionList): readonly StudioBindingOperationOption[];
+/***
+ * Find an option through the canonical keyed array lookup utility.
+ */
 export declare function findStudioBindingOperationOption(options: readonly StudioBindingOperationOption[], ref: BindingOperationRef): StudioBindingOperationOption | undefined;
+/***
+ * Convert an action payload schema into Studio binding input-field options.
+ * @todo Move action binding-field projection under src/bindings/.
+ */
 export declare function createStudioActionInputFields(payloadSchema: Readonly<Record<string, {
     readonly label: string;
     readonly type: string;

package/dist/bindingOperationModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bindingOperationModel.d.ts","sourceRoot":"","sources":["../src/bindingOperationModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EAIpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAGrC,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,iBAAiB,GACtB,SAAS,4BAA4B,EAAE,CAIzC;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,4BAA4B,EAAE,EAChD,GAAG,EAAE,mBAAmB,GACvB,4BAA4B,GAAG,SAAS,CAO1C;AA4DD,wBAAgB,6BAA6B,CAC3C,aAAa,EACT,QAAQ,CACN,MAAM,CACJ,MAAM,EACN;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAC/E,CACF,GACD,SAAS,GACZ,SAAS,6BAA6B,EAAE,CAO1C"}
+{"version":3,"file":"bindingOperationModel.d.ts","sourceRoot":"","sources":["../src/bindingOperationModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,mBAAmB,EAIpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AAGrC;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,IAAI,EAAE,iBAAiB,GACtB,SAAS,4BAA4B,EAAE,CAIzC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,SAAS,4BAA4B,EAAE,EAChD,GAAG,EAAE,mBAAmB,GACvB,4BAA4B,GAAG,SAAS,CAE1C;AAiFD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EACT,QAAQ,CACN,MAAM,CACJ,MAAM,EACN;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAC/E,CACF,GACD,SAAS,GACZ,SAAS,6BAA6B,EAAE,CAO1C"}

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":"AAaA,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEhG,MAAM,UAAU,oCAAoC,CAClD,IAAuB;IAEvB,OAAO,IAAI;SACR,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAgD,EAChD,GAAwB;IAExB,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;QACpC,MAAM,CAAC,SAAS,CAAC,WAAW,KAAK,GAAG,CAAC,WAAW;QAChD,MAAM,CAAC,SAAS,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAkB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACvD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrD,SAAS,EAAE;YACT,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,WAAW,EAAE,SAAS,CAAC,EAAE;SAC1B;QACD,KAAK,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,MAAM,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,EAAE;QAClE,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC;QAC1B,WAAW,EAAE,2BAA2B,CAAC,GAAG,EAAE,SAAS,CAAC;QACxD,aAAa,EAAE,0BAA0B,CACvC,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC1C,GAAG,CAAC,OAAO,CACZ;KACF,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,GAAkB,EAClB,SAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyC,CAAC;IAChE,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE;YACzB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,KAAK,EAAE,SAAS,CAAC,WAAW,IAAI,SAAS,CAAC,IAAI;YAC9C,KAAK,EAAE,4BAA4B,CAAC,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;YACnF,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAChE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7E,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE;YACf,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;YAC3B,KAAK,EAAE,4BAA4B,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC;YACxD,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,iBAAiB,CACxB,GAAkB,EAClB,IAAgG;IAEhG,OAAO,IAAI,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,WAAW,CAAC,GAAkB;IACrC,OAAO,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,aAOa;IAEb,OAAO,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAC3C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;KAClC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"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":"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"}

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;