@ankhorage/studio 2.0.22 → 2.0.24

package/dist/ui/admin/pages/deploy/useProjectDeployDashboard.js

@@ -1,5 +1,9 @@
 import { useCallback, useEffect, useState } from 'react';
 import { listProjectDeployReleaseHistory, readProjectDeployConfig, readProjectDeployListing, readProjectDeployMonetization, readProjectDeployRelease, } from '../../../../projectDeployApi';
+/***
+ * Load the five deploy-dashboard resources for one project, invalidate stale generations, and expose an explicit refresh trigger.
+ * @todo Keep this React adapter at the deploy admin UI edge while dashboard loading/orchestration moves into deploy application ownership.
+ */
 export function useProjectDeployDashboard(projectId) {
     const [refreshGeneration, setRefreshGeneration] = useState(0);
     const [loaded, setLoaded] = useState(null);
@@ -14,6 +18,7 @@ export function useProjectDeployDashboard(projectId) {
             cancelled = true;
         };
     }, [projectId, requestKey]);
+    /*** Increment the request generation so the hook reloads all dashboard resources. */
     const refresh = useCallback(() => {
         setRefreshGeneration((current) => current + 1);
     }, []);
@@ -27,6 +32,7 @@ const loadingState = {
     release: { status: 'loading' },
     history: { status: 'loading' },
 };
+/*** Load all deploy-dashboard resources concurrently while isolating each resource failure into its own loadable state. */
 async function loadDashboard(projectId) {
     const [config, listing, monetization, release, history] = await Promise.all([
         capture(readProjectDeployConfig(projectId)),
@@ -37,6 +43,10 @@ async function loadDashboard(projectId) {
     ]);
     return { config, listing, monetization, release, history };
 }
+/***
+ * Convert a promise into a discriminated ready/error loadable result while normalizing unknown errors to messages.
+ * @utility @ankhorage/utility/async
+ */
 async function capture(operation) {
     try {
         return { status: 'ready', data: await operation };

package/dist/ui/admin/pages/deploy/useProjectDeployDashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"useProjectDeployDashboard.js","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/deploy/useProjectDeployDashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,EACL,+BAA+B,EAC/B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAQtC,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,GAAG,SAAS,IAAI,iBAAiB,EAAE,CAAC;IAEvD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3C,IAAI,CAAC,SAAS;gBAAE,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,MAAM,EAAE,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9E,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,YAAY,GAAgC;IAChD,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC7B,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC9B,YAAY,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IACnC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC9B,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;CAC/B,CAAC;AAEF,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1E,OAAO,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC;QACjD,OAAO,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC;QAC5C,OAAO,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC;KACpD,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,OAAO,CAAI,SAAqB;IAC7C,IAAI,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9F,CAAC;AACH,CAAC"}
+{"version":3,"file":"useProjectDeployDashboard.js","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/deploy/useProjectDeployDashboard.ts"],"names":[],"mappings":"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"}

package/dist/ui/admin/pages/screens/screensAdminActions.d.ts

@@ -24,5 +24,9 @@ export type ScreensAdminAction = {
     toIndex: number;
 };
 export type ScreensAdminMutationTarget = Pick<StudioContextValue, 'addScreen' | 'deleteScreen' | 'moveRoute' | 'setNavigatorInitialRoute' | 'setNavigatorType' | 'setRoutePrimaryNavigationVisibility'>;
+/***
+ * Dispatch one typed screens-administration command onto the Studio screen/navigation mutation target.
+ * @todo Move this command application from `ui/` into the screens/routes application domain so React only emits actions.
+ */
 export declare function applyScreensAdminAction(target: ScreensAdminMutationTarget, action: ScreensAdminAction): void;
 //# sourceMappingURL=screensAdminActions.d.ts.map

package/dist/ui/admin/pages/screens/screensAdminActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screensAdminActions.d.ts","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/screens/screensAdminActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,OAAO,CAAC;CAClC,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAChB,WAAW,GACX,cAAc,GACd,WAAW,GACX,0BAA0B,GAC1B,kBAAkB,GAClB,qCAAqC,CACxC,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAwBN"}
+{"version":3,"file":"screensAdminActions.d.ts","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/screens/screensAdminActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,aAAa,EAAE,aAAa,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,IAAI,EAAE,mCAAmC,CAAC;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB,EAAE,OAAO,CAAC;CAClC,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAChB,WAAW,GACX,cAAc,GACd,WAAW,GACX,0BAA0B,GAC1B,kBAAkB,GAClB,qCAAqC,CACxC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAwBN"}

package/dist/ui/admin/pages/screens/screensAdminActions.js

@@ -1,3 +1,7 @@
+/***
+ * Dispatch one typed screens-administration command onto the Studio screen/navigation mutation target.
+ * @todo Move this command application from `ui/` into the screens/routes application domain so React only emits actions.
+ */
 export function applyScreensAdminAction(target, action) {
     switch (action.type) {
         case 'create-screen':

package/dist/ui/admin/pages/screens/screensAdminActions.js.map

@@ -1 +1 @@
-{"version":3,"file":"screensAdminActions.js","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/screens/screensAdminActions.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,uBAAuB,CACrC,MAAkC,EAClC,MAA0B;IAE1B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,eAAe;YAClB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO;QACT,KAAK,eAAe;YAClB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO;QACT,KAAK,oBAAoB;YACvB,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAC9C,OAAO;QACT,KAAK,mBAAmB;YACtB,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClD,OAAO;QACT,KAAK,mCAAmC;YACtC,MAAM,CAAC,mCAAmC,CACxC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,uBAAuB,CAC/B,CAAC;YACF,OAAO;QACT,KAAK,YAAY;YACf,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}
+{"version":3,"file":"screensAdminActions.js","sourceRoot":"","sources":["../../../../../src/ui/admin/pages/screens/screensAdminActions.ts"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAkC,EAClC,MAA0B;IAE1B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,eAAe;YAClB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO;QACT,KAAK,eAAe;YAClB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO;QACT,KAAK,oBAAoB;YACvB,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YAC9C,OAAO;QACT,KAAK,mBAAmB;YACtB,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClD,OAAO;QACT,KAAK,mCAAmC;YACtC,MAAM,CAAC,mCAAmC,CACxC,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,uBAAuB,CAC/B,CAAC;YACF,OAAO;QACT,KAAK,YAAY;YACf,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/ui/admin/pages/themeRecipeAuthoringModel.d.ts

@@ -1,5 +1,9 @@
 import type { ThemeRecipeOverrides, ThemeRecipeOverrideValue } from '@ankhorage/contracts';
 export type ThemeRecipeAuthoringKind = 'component' | 'pattern';
+/***
+ * Immutably set or remove one component/pattern recipe field override and prune empty recipe/bucket structures.
+ * @todo Move this theme-recipe mutation policy from admin UI into the theme authoring domain.
+ */
 export declare function updateThemeRecipeField(args: {
     readonly recipes: ThemeRecipeOverrides | undefined;
     readonly kind: ThemeRecipeAuthoringKind;

package/dist/ui/admin/pages/themeRecipeAuthoringModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeRecipeAuthoringModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeAuthoringModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACtD,GAAG,oBAAoB,GAAG,SAAS,CAcnC"}
+{"version":3,"file":"themeRecipeAuthoringModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeAuthoringModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,SAAS,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACtD,GAAG,oBAAoB,GAAG,SAAS,CAcnC"}

package/dist/ui/admin/pages/themeRecipeAuthoringModel.js

@@ -1,6 +1,8 @@
-import { deleteOwnProperty } from '../../../utils/deleteOwnProperty';
-import { readOwnProperty } from '../../../utils/readOwnProperty';
-import { setOwnProperty } from '../../../utils/setOwnProperty';
+import { deleteOwnProperty, readOwnProperty, setOwnProperty } from '@ankhorage/utility/object';
+/***
+ * Immutably set or remove one component/pattern recipe field override and prune empty recipe/bucket structures.
+ * @todo Move this theme-recipe mutation policy from admin UI into the theme authoring domain.
+ */
 export function updateThemeRecipeField(args) {
     const bucketName = args.kind === 'component' ? 'components' : 'patterns';
     const bucket = args.recipes
@@ -18,9 +20,14 @@ export function updateThemeRecipeField(args) {
         deleteOwnProperty(nextRecipes, bucketName);
     return nextRecipes.components || nextRecipes.patterns ? nextRecipes : undefined;
 }
+/*** Apply the generic record-update primitive to one theme recipe field map. */
 function updateField(fields, fieldName, value) {
     return updateRecord(fields, fieldName, value);
 }
+/***
+ * Immutably set/delete a keyed record value and normalize an empty resulting record to undefined.
+ * @utility @ankhorage/utility/object
+ */
 function updateRecord(record, key, value) {
     const next = { ...record };
     if (value === undefined)

package/dist/ui/admin/pages/themeRecipeAuthoringModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"themeRecipeAuthoringModel.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeAuthoringModel.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,MAAM,UAAU,sBAAsB,CAAC,IAMtC;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO;QACzB,CAAC,CAAC,eAAe,CAAsD,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QAChG,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC,eAAe,CAA4B,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC;QACrE,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,WAAW,GAAyB,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9D,IAAI,UAAU;QAAE,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;;QAC/D,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,SAAS,WAAW,CAClB,MAA6C,EAC7C,SAAiB,EACjB,KAA2C;IAE3C,OAAO,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CACnB,MAA+C,EAC/C,GAAW,EACX,KAAoB;IAEpB,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;;QACjD,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}
+{"version":3,"file":"themeRecipeAuthoringModel.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeAuthoringModel.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAI/F;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAMtC;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO;QACzB,CAAC,CAAC,eAAe,CAAsD,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QAChG,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,aAAa,GAAG,MAAM;QAC1B,CAAC,CAAC,eAAe,CAA4B,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC;QACrE,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,WAAW,GAAyB,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC9D,IAAI,UAAU;QAAE,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;;QAC/D,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAChD,OAAO,WAAW,CAAC,UAAU,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAClB,MAA6C,EAC7C,SAAiB,EACjB,KAA2C;IAE3C,OAAO,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CACnB,MAA+C,EAC/C,GAAW,EACX,KAAoB;IAEpB,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;;QACjD,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/dist/ui/admin/pages/themeRecipeTokenOptions.d.ts

@@ -10,6 +10,10 @@ interface ThemeRecipeTokenSource {
         readonly headings: object;
     };
 }
+/***
+ * Resolve sorted token names for one ZORA theme token family, merging the three typography token namespaces when requested.
+ * @todo This reusable ZORA token-catalog knowledge belongs with `@ankhorage/zora` theme metadata rather than Studio UI or generic Utility.
+ */
 export declare function resolveThemeRecipeTokenOptions(theme: ThemeRecipeTokenSource, family: ZoraThemeTokenFamily): readonly string[];
 export {};
 //# sourceMappingURL=themeRecipeTokenOptions.d.ts.map

package/dist/ui/admin/pages/themeRecipeTokenOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeRecipeTokenOptions.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeTokenOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,oBAAoB,GAC3B,SAAS,MAAM,EAAE,CAanB"}
+{"version":3,"file":"themeRecipeTokenOptions.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeTokenOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,sBAAsB,EAC7B,MAAM,EAAE,oBAAoB,GAC3B,SAAS,MAAM,EAAE,CAanB"}

package/dist/ui/admin/pages/themeRecipeTokenOptions.js

@@ -1,3 +1,7 @@
+/***
+ * Resolve sorted token names for one ZORA theme token family, merging the three typography token namespaces when requested.
+ * @todo This reusable ZORA token-catalog knowledge belongs with `@ankhorage/zora` theme metadata rather than Studio UI or generic Utility.
+ */
 export function resolveThemeRecipeTokenOptions(theme, family) {
     if (family === 'colors')
         return Object.keys(theme.colors).sort();

package/dist/ui/admin/pages/themeRecipeTokenOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"themeRecipeTokenOptions.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeTokenOptions.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,8BAA8B,CAC5C,KAA6B,EAC7B,MAA4B;IAE5B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnE,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC;QACN,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACtC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACxC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;KAC1C,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}
+{"version":3,"file":"themeRecipeTokenOptions.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeRecipeTokenOptions.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA6B,EAC7B,MAA4B;IAE5B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnE,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC;QACN,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QACtC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QACxC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;KAC1C,CAAC,CACH,CAAC,IAAI,EAAE,CAAC;AACX,CAAC"}

package/dist/ui/admin/pages/themeTokenAuthoringModel.d.ts

@@ -1,21 +1,25 @@
 import type { ThemeGlobalTokenOverrides, ThemeTypographyHeadingOverrides } from '@ankhorage/contracts';
 export type NumericThemeTokenFamily = 'spacing' | 'radii' | 'shadows';
+/*** Immutably set/remove one numeric global theme token and prune empty family/global override structures. */
 export declare function updateNumericThemeToken(args: {
     readonly tokens: ThemeGlobalTokenOverrides | undefined;
     readonly family: NumericThemeTokenFamily;
     readonly key: string;
     readonly value: number | undefined;
 }): ThemeGlobalTokenOverrides | undefined;
+/*** Immutably set/remove one typography size override and prune empty typography/global override structures. */
 export declare function updateTypographySize(args: {
     readonly tokens: ThemeGlobalTokenOverrides | undefined;
     readonly key: string;
     readonly value: number | undefined;
 }): ThemeGlobalTokenOverrides | undefined;
+/*** Immutably set/remove one typography weight override and prune empty typography/global override structures. */
 export declare function updateTypographyWeight(args: {
     readonly tokens: ThemeGlobalTokenOverrides | undefined;
     readonly key: string;
     readonly value: string | undefined;
 }): ThemeGlobalTokenOverrides | undefined;
+/*** Immutably set/remove one typography heading field override and prune empty heading/typography/global structures. */
 export declare function updateTypographyHeading(args: {
     readonly tokens: ThemeGlobalTokenOverrides | undefined;
     readonly level: string;

package/dist/ui/admin/pages/themeTokenAuthoringModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"themeTokenAuthoringModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeTokenAuthoringModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,+BAA+B,EAEhC,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CASxC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAKxC;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAKxC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,+BAA+B,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C,GAAG,yBAAyB,GAAG,SAAS,CAiBxC"}
+{"version":3,"file":"themeTokenAuthoringModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/themeTokenAuthoringModel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,+BAA+B,EAEhC,MAAM,sBAAsB,CAAC;AAG9B,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtE,8GAA8G;AAC9G,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CASxC;AAED,gHAAgH;AAChH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAKxC;AAED,kHAAkH;AAClH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC,GAAG,yBAAyB,GAAG,SAAS,CAKxC;AAED,wHAAwH;AACxH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,CAAC,MAAM,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,+BAA+B,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C,GAAG,yBAAyB,GAAG,SAAS,CAiBxC"}

package/dist/ui/admin/pages/themeTokenAuthoringModel.js

@@ -1,6 +1,5 @@
-import { deleteOwnProperty } from '../../../utils/deleteOwnProperty';
-import { readOwnProperty } from '../../../utils/readOwnProperty';
-import { setOwnProperty } from '../../../utils/setOwnProperty';
+import { deleteOwnProperty, readOwnProperty, setOwnProperty } from '@ankhorage/utility/object';
+/*** Immutably set/remove one numeric global theme token and prune empty family/global override structures. */
 export function updateNumericThemeToken(args) {
     const family = args.tokens
         ? readOwnProperty(args.tokens, args.family)
@@ -13,18 +12,21 @@ export function updateNumericThemeToken(args) {
         deleteOwnProperty(nextTokens, args.family);
     return normalizeGlobalTokens(nextTokens);
 }
+/*** Immutably set/remove one typography size override and prune empty typography/global override structures. */
 export function updateTypographySize(args) {
     return updateTypographyTokens(args.tokens, {
         ...args.tokens?.typography,
         sizes: updateRecordValue(args.tokens?.typography?.sizes, args.key, args.value),
     });
 }
+/*** Immutably set/remove one typography weight override and prune empty typography/global override structures. */
 export function updateTypographyWeight(args) {
     return updateTypographyTokens(args.tokens, {
         ...args.tokens?.typography,
         weights: updateRecordValue(args.tokens?.typography?.weights, args.key, args.value),
     });
 }
+/*** Immutably set/remove one typography heading field override and prune empty heading/typography/global structures. */
 export function updateTypographyHeading(args) {
     const headings = args.tokens?.typography?.headings;
     const current = headings
@@ -41,9 +43,14 @@ export function updateTypographyHeading(args) {
         headings: nextHeadings,
     });
 }
+/*** Replace typography overrides and normalize empty typography/global token structures. */
 function updateTypographyTokens(tokens, typography) {
     return normalizeGlobalTokens({ ...tokens, typography: normalizeTypography(typography) });
 }
+/***
+ * Immutably set/delete a keyed record value and normalize an empty resulting record to undefined.
+ * @utility @ankhorage/utility/object
+ */
 function updateRecordValue(record, key, value) {
     const next = { ...record };
     if (value === undefined)
@@ -52,12 +59,14 @@ function updateRecordValue(record, key, value) {
         setOwnProperty(next, key, value);
     return Object.keys(next).length > 0 ? next : undefined;
 }
+/*** Normalize an empty typography override shell to undefined. */
 function normalizeTypography(typography) {
     const { headings, sizes, weights } = typography;
     if (!headings && !sizes && !weights)
         return undefined;
     return typography;
 }
+/*** Normalize an empty global theme-token override shell to undefined. */
 function normalizeGlobalTokens(tokens) {
     const { spacing, radii, typography, shadows } = tokens;
     return spacing || radii || typography || shadows ? tokens : undefined;

package/dist/ui/admin/pages/themeTokenAuthoringModel.js.map

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

package/dist/ui/admin/pages/useActiveThemeAdmin.d.ts

@@ -6,6 +6,10 @@ interface ActiveThemeAdminState {
     readonly setMode: (mode: 'light' | 'dark') => void;
     readonly updateTheme: (updates: ThemeUpdates) => void;
 }
+/***
+ * Compose Studio manifest theme selection with the active ZORA surface mode and expose a mode-scoped theme update adapter.
+ * @todo Keep this React/ZORA bridge at the theme-admin UI edge while active-theme policy and mutations move to the theme application domain.
+ */
 export declare function useActiveThemeAdmin(): ActiveThemeAdminState;
 export {};
 //# sourceMappingURL=useActiveThemeAdmin.d.ts.map

package/dist/ui/admin/pages/useActiveThemeAdmin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActiveThemeAdmin.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/useActiveThemeAdmin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,wBAAwB,EAAmC,MAAM,mBAAmB,CAAC;AAEnG,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,mBAAmB,IAAI,qBAAqB,CAiB3D"}
+{"version":3,"file":"useActiveThemeAdmin.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/useActiveThemeAdmin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,wBAAwB,EAAmC,MAAM,mBAAmB,CAAC;AAEnG,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,CAkB3D"}

package/dist/ui/admin/pages/useActiveThemeAdmin.js

@@ -1,6 +1,10 @@
 import { useZoraTheme } from '@ankhorage/zora';
 import { useStudio } from '../../../core/StudioContext';
 import { resolveActiveThemeModeSelection } from './adminThemeModel';
+/***
+ * Compose Studio manifest theme selection with the active ZORA surface mode and expose a mode-scoped theme update adapter.
+ * @todo Keep this React/ZORA bridge at the theme-admin UI edge while active-theme policy and mutations move to the theme application domain.
+ */
 export function useActiveThemeAdmin() {
     const studio = useStudio();
     const { mode, setMode } = useZoraTheme();
@@ -11,6 +15,7 @@ export function useActiveThemeAdmin() {
             surfaceMode: mode,
         })
         : null;
+    /*** Apply partial theme updates to the currently resolved active theme when one exists. */
     const updateTheme = (updates) => {
         if (!selection)
             return;

package/dist/ui/admin/pages/useActiveThemeAdmin.js.map

@@ -1 +1 @@
-{"version":3,"file":"useActiveThemeAdmin.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/useActiveThemeAdmin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAiC,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AASnG,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ;QAC/B,CAAC,CAAC,+BAA+B,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;YAC5C,WAAW,EAAE,IAAI;SAClB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,WAAW,GAAG,CAAC,OAAqB,EAAE,EAAE;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"useActiveThemeAdmin.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/useActiveThemeAdmin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,EAAiC,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AASnG;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ;QAC/B,CAAC,CAAC,+BAA+B,CAAC;YAC9B,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;YAC5C,WAAW,EAAE,IAAI;SAClB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAET,2FAA2F;IAC3F,MAAM,WAAW,GAAG,CAAC,OAAqB,EAAE,EAAE;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC"}

package/dist/ui/canvas/StudioCanvasDndOverlay.d.ts

@@ -11,5 +11,9 @@ export interface StudioCanvasDndOverlayProps {
     readonly selectedNodeId: string | null;
     readonly setActiveDragNodeId: (nodeId: string | null) => void;
 }
+/***
+ * Render and coordinate the Studio canvas drag handle, drag preview, and resolved drop-zone overlay.
+ * @todo Keep this component as the canvas inbound UI edge while moving drop/move policy and view-model derivation into the canvas domain/application layer.
+ */
 export declare function StudioCanvasDndOverlay(props: StudioCanvasDndOverlayProps): React.JSX.Element | null;
 //# sourceMappingURL=StudioCanvasDndOverlay.d.ts.map

package/dist/ui/canvas/StudioCanvasDndOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StudioCanvasDndOverlay.d.ts","sourceRoot":"","sources":["../../../src/ui/canvas/StudioCanvasDndOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AASrF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AA8ID,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA0F1B"}
+{"version":3,"file":"StudioCanvasDndOverlay.d.ts","sourceRoot":"","sources":["../../../src/ui/canvas/StudioCanvasDndOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAgB,KAAK,aAAa,EAAE,KAAK,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAEjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AASrF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAoJD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CA2F1B"}

package/dist/ui/canvas/StudioCanvasDndOverlay.js

@@ -9,6 +9,10 @@ import { findNodeById } from '../../index';
 import { resolveNodeLabel } from '../../insertModalModel';
 import { activateCanvasDrag, completeCanvasDropAfterAdapter, createCanvasDraggableSessionKey, resetCanvasDragSession, sortCanvasDropTargetsBySpecificity, } from './canvasDndInteraction';
 const MAX_DROP_CAPACITY = Number.MAX_SAFE_INTEGER;
+/***
+ * Resolve visible canvas drop-zone view models for all measured targets, then order them by geometric specificity.
+ * @todo Move drop-zone view-model composition beside the canvas domain; the React overlay should only render resolved zones.
+ */
 function resolveDropZoneViews(args) {
     const zones = args.indicatorRects.flatMap((targetRect) => {
         const targetNode = findNodeById(args.rootNode, targetRect.nodeId);
@@ -32,6 +36,7 @@ function resolveDropZoneViews(args) {
     });
     return sortCanvasDropTargetsBySpecificity(zones);
 }
+/*** Render one Studio canvas drop target and bridge DnD adapter events to canvas interaction use cases. */
 function CanvasDropZone(props) {
     const { theme } = useZoraTheme();
     const isActive = props.activeDropZoneId === props.zone.id;
@@ -59,6 +64,7 @@ function CanvasDropZone(props) {
                 ? `${props.zone.resolution.kind} ${resolveNodeLabel({ node: props.zone.targetNode, componentMeta: props.componentMeta })}`
                 : props.zone.resolution.reason.message })) : null }));
 }
+/*** Render the floating preview for the currently dragged Studio node. */
 function CanvasDragPreview(props) {
     const { theme } = useZoraTheme();
     const previewText = resolveCanvasDragPreviewText(props.node.props);
@@ -77,6 +83,10 @@ function CanvasDragPreview(props) {
             opacity: 0.88,
         }, children: [_jsx(Text, { numberOfLines: 1, variant: "label", weight: "semiBold", children: props.label }), previewText ? (_jsx(Text, { numberOfLines: 2, emphasis: "muted", variant: "bodySmall", children: previewText })) : null] }));
 }
+/***
+ * Render and coordinate the Studio canvas drag handle, drag preview, and resolved drop-zone overlay.
+ * @todo Keep this component as the canvas inbound UI edge while moving drop/move policy and view-model derivation into the canvas domain/application layer.
+ */
 export function StudioCanvasDndOverlay(props) {
     const [activeDropZoneId, setActiveDropZoneId] = React.useState(null);
     const [dragSessionRevision, setDragSessionRevision] = React.useState(0);
@@ -103,6 +113,7 @@ export function StudioCanvasDndOverlay(props) {
             rootNode,
         })
         : [];
+    /*** Reset the local adapter state and restart the draggable instance after a drag session completes. */
     const resetDrag = () => {
         dragStartedRef.current = false;
         resetCanvasDragSession({

package/dist/ui/canvas/StudioCanvasDndOverlay.js.map

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

package/dist/ui/canvas/canvasDndInteraction.d.ts

@@ -1,4 +1,5 @@
 import { type StudioCanvasDragPayload } from '../../canvasDragModel';
+export { sortByRectArea as sortCanvasDropTargetsBySpecificity } from '@ankhorage/utility/geometry';
 import type { CanvasDropZoneResolution } from '../../canvasDropZones';
 import type { NodePlacement } from '../../index';
 export interface CanvasDragSessionCallbacks {
@@ -6,15 +7,26 @@ export interface CanvasDragSessionCallbacks {
     readonly setActiveDragNodeId: (nodeId: string | null) => void;
     readonly setActiveDropZoneId: (zoneId: string | null) => void;
 }
+/***
+ * Build the composite key used to force a fresh draggable instance for one node/revision pair.
+ * @utility @ankhorage/utility/string
+ */
 export declare function createCanvasDraggableSessionKey(nodeId: string, revision: number): string;
-export declare function sortCanvasDropTargetsBySpecificity<T extends {
-    readonly rect: {
-        readonly width: number;
-        readonly height: number;
-    };
-}>(targets: readonly T[]): readonly T[];
+/***
+ * Reset the active Studio canvas drag/drop state and force the draggable adapter to restart.
+ * @todo Move this Studio canvas interaction orchestration beside the canvas domain instead of generic UI ownership.
+ */
 export declare function resetCanvasDragSession(callbacks: CanvasDragSessionCallbacks): void;
+/***
+ * Commit one valid Studio canvas drop by validating the Studio drag payload and forwarding its node to the resolved placement adapter.
+ * @todo Move this Studio canvas drop policy beside the canvas domain; UI should invoke the use case rather than own it.
+ */
 export declare function commitCanvasDrop(payload: unknown, zone: CanvasDropZoneResolution, moveNodeToPlacement: (nodeId: string, placement: NodePlacement) => boolean): boolean;
+/***
+ * Defer one Studio canvas drop commit until after the DnD adapter callback and always reset drag state afterwards.
+ * @todo Keep this adapter-timing orchestration at the canvas/DnD edge, not in a generic UI helper module.
+ */
 export declare function completeCanvasDropAfterAdapter(payload: unknown, zone: CanvasDropZoneResolution, moveNodeToPlacement: (nodeId: string, placement: NodePlacement) => boolean, resetDrag: () => void): Promise<boolean>;
+/*** Activate the Studio canvas drag session for the node carried by a canonical drag payload. */
 export declare function activateCanvasDrag(payload: StudioCanvasDragPayload, callbacks: Pick<CanvasDragSessionCallbacks, 'setActiveDragNodeId'>): void;
 //# sourceMappingURL=canvasDndInteraction.d.ts.map

package/dist/ui/canvas/canvasDndInteraction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDndInteraction.d.ts","sourceRoot":"","sources":["../../../src/ui/canvas/canvasDndInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,kCAAkC,CAChD,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAChF,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAIrC;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI,CAIlF;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,wBAAwB,EAC9B,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,GACzE,OAAO,CAMT;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,wBAAwB,EAC9B,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,EAC1E,SAAS,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,IAAI,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,GACjE,IAAI,CAEN"}
+{"version":3,"file":"canvasDndInteraction.d.ts","sourceRoot":"","sources":["../../../src/ui/canvas/canvasDndInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,cAAc,IAAI,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AACnG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,0BAA0B,GAAG,IAAI,CAIlF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,wBAAwB,EAC9B,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,GACzE,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,wBAAwB,EAC9B,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,KAAK,OAAO,EAC1E,SAAS,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,IAAI,CAAC,0BAA0B,EAAE,qBAAqB,CAAC,GACjE,IAAI,CAEN"}

package/dist/ui/canvas/canvasDndInteraction.js

@@ -1,21 +1,35 @@
 import { isStudioCanvasDragPayload } from '../../canvasDragModel';
+export { sortByRectArea as sortCanvasDropTargetsBySpecificity } from '@ankhorage/utility/geometry';
+/***
+ * Build the composite key used to force a fresh draggable instance for one node/revision pair.
+ * @utility @ankhorage/utility/string
+ */
 export function createCanvasDraggableSessionKey(nodeId, revision) {
     return `${nodeId}:${revision}`;
 }
-export function sortCanvasDropTargetsBySpecificity(targets) {
-    return [...targets].sort((left, right) => left.rect.width * left.rect.height - right.rect.width * right.rect.height);
-}
+/***
+ * Reset the active Studio canvas drag/drop state and force the draggable adapter to restart.
+ * @todo Move this Studio canvas interaction orchestration beside the canvas domain instead of generic UI ownership.
+ */
 export function resetCanvasDragSession(callbacks) {
     callbacks.setActiveDropZoneId(null);
     callbacks.setActiveDragNodeId(null);
     callbacks.restartDraggable();
 }
+/***
+ * Commit one valid Studio canvas drop by validating the Studio drag payload and forwarding its node to the resolved placement adapter.
+ * @todo Move this Studio canvas drop policy beside the canvas domain; UI should invoke the use case rather than own it.
+ */
 export function commitCanvasDrop(payload, zone, moveNodeToPlacement) {
     if (zone.status !== 'valid' || !isStudioCanvasDragPayload(payload)) {
         return false;
     }
     return moveNodeToPlacement(payload.nodeId, zone.placement);
 }
+/***
+ * Defer one Studio canvas drop commit until after the DnD adapter callback and always reset drag state afterwards.
+ * @todo Keep this adapter-timing orchestration at the canvas/DnD edge, not in a generic UI helper module.
+ */
 export function completeCanvasDropAfterAdapter(payload, zone, moveNodeToPlacement, resetDrag) {
     return Promise.resolve().then(() => {
         try {
@@ -26,6 +40,7 @@ export function completeCanvasDropAfterAdapter(payload, zone, moveNodeToPlacemen
         }
     });
 }
+/*** Activate the Studio canvas drag session for the node carried by a canonical drag payload. */
 export function activateCanvasDrag(payload, callbacks) {
     callbacks.setActiveDragNodeId(payload.nodeId);
 }

package/dist/ui/canvas/canvasDndInteraction.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvasDndInteraction.js","sourceRoot":"","sources":["../../../src/ui/canvas/canvasDndInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAgC,MAAM,uBAAuB,CAAC;AAUhG,MAAM,UAAU,+BAA+B,CAAC,MAAc,EAAE,QAAgB;IAC9E,OAAO,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAEhD,OAAqB;IACrB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACtB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAC3F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAqC;IAC1E,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,gBAAgB,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,IAA8B,EAC9B,mBAA0E;IAE1E,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAAgB,EAChB,IAA8B,EAC9B,mBAA0E,EAC1E,SAAqB;IAErB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACjC,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,SAAkE;IAElE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"canvasDndInteraction.js","sourceRoot":"","sources":["../../../src/ui/canvas/canvasDndInteraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAgC,MAAM,uBAAuB,CAAC;AAChG,OAAO,EAAE,cAAc,IAAI,kCAAkC,EAAE,MAAM,6BAA6B,CAAC;AAUnG;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAc,EAAE,QAAgB;IAC9E,OAAO,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAqC;IAC1E,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,gBAAgB,EAAE,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,IAA8B,EAC9B,mBAA0E;IAE1E,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAgB,EAChB,IAA8B,EAC9B,mBAA0E,EAC1E,SAAqB;IAErB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACjC,IAAI,CAAC;YACH,OAAO,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,SAAS,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,SAAkE;IAElE,SAAS,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/upsertExternalApi.d.ts

@@ -4,6 +4,9 @@ export interface ExternalApiUpsertResult {
     readonly apis: ApiDefinitionList;
     readonly created: boolean;
 }
+/***
+ * Use canonical keyed upsert behavior while reporting Studio's domain-specific creation metadata.
+ */
 export declare function upsertExternalApi(apis: ApiDefinitionList, api: ExternalApiDefinition): ExternalApiUpsertResult;
 export {};
 //# sourceMappingURL=upsertExternalApi.d.ts.map

package/dist/upsertExternalApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsertExternalApi.d.ts","sourceRoot":"","sources":["../src/upsertExternalApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,KAAK,qBAAqB,GAAG,4BAA4B,GAAG,yBAAyB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,qBAAqB,GACzB,uBAAuB,CAQzB"}
+{"version":3,"file":"upsertExternalApi.d.ts","sourceRoot":"","sources":["../src/upsertExternalApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAGnC,KAAK,qBAAqB,GAAG,4BAA4B,GAAG,yBAAyB,CAAC;AAEtF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,qBAAqB,GACzB,uBAAuB,CAMzB"}

package/dist/upsertExternalApi.js

@@ -1,10 +1,12 @@
+import { upsertBy } from '@ankhorage/utility/array';
+/***
+ * Use canonical keyed upsert behavior while reporting Studio's domain-specific creation metadata.
+ */
 export function upsertExternalApi(apis, api) {
-    const index = apis.findIndex((candidate) => candidate.id === api.id);
-    if (index < 0)
-        return { apis: [...apis, api], created: true };
+    const created = !apis.some((candidate) => candidate.id === api.id);
     return {
-        apis: apis.map((candidate, candidateIndex) => (candidateIndex === index ? api : candidate)),
-        created: false,
+        apis: upsertBy(apis, api, (candidate) => candidate.id),
+        created,
     };
 }
 //# sourceMappingURL=upsertExternalApi.js.map

package/dist/upsertExternalApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"upsertExternalApi.js","sourceRoot":"","sources":["../src/upsertExternalApi.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,iBAAiB,CAC/B,IAAuB,EACvB,GAA0B;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACrE,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAE9D,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3F,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"upsertExternalApi.js","sourceRoot":"","sources":["../src/upsertExternalApi.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASpD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuB,EACvB,GAA0B;IAE1B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACnE,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/utils/treeUtils.d.ts

@@ -1,3 +1,6 @@
+/***
+ * @todo Remove this re-export-only shim. `src/utils` must own real package-local utilities, not re-export implementations from the public entrypoint; move the tree implementations out of `src/index.ts` to their canonical owner and export them directly from that owner through the package entrypoint.
+ */
 import { cloneWithNewIds, findNodeById, removeNodeFromTree, updateNodeInTree } from '../index';
 export { cloneWithNewIds, findNodeById, removeNodeFromTree, updateNodeInTree };
 //# sourceMappingURL=treeUtils.d.ts.map

package/dist/utils/treeUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/treeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"treeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/treeUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC"}