@cratis/scene.engine 4.2.1 → 4.4.0

package/dist/cjs/editing/DescriptorCatalog.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var layoutTypeDescriptors = require('./layoutTypeDescriptors.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Builds a catalog from the component descriptors of the active packages, plus the built-in layout types.
+ *
+ * When two descriptors name the same component the later one wins, which is the same override-priority rule
+ * the profile's package order already means for components.
+ */ function createDescriptorCatalog(componentDescriptors = []) {
+    const byComponent = new Map();
+    for (const descriptor of componentDescriptors)byComponent.set(descriptor.component, descriptor);
+    return {
+        components: [
+            ...byComponent.values()
+        ],
+        layoutTypes: layoutTypeDescriptors.layoutTypeDescriptors
+    };
+}
+/**
+ * Finds the descriptor of a component by the name an element carries.
+ *
+ * An exact match wins. Otherwise a bare name (`dataTable`) finds the one descriptor whose component ends in
+ * `:dataTable`; a bare name that several packages describe has no single answer, so it finds none.
+ */ function findComponentDescriptor(catalog, componentName) {
+    const exact = catalog.components.find((descriptor)=>descriptor.component === componentName);
+    if (exact) return exact;
+    const matches = catalog.components.filter((descriptor)=>descriptor.component.endsWith(`:${componentName}`));
+    return matches.length === 1 ? matches[0] : undefined;
+}
+/**
+ * Finds the descriptor of a layout type.
+ */ function findLayoutTypeDescriptor(catalog, type) {
+    return catalog.layoutTypes.find((descriptor)=>descriptor.type === type);
+}
+
+exports.createDescriptorCatalog = createDescriptorCatalog;
+exports.findComponentDescriptor = findComponentDescriptor;
+exports.findLayoutTypeDescriptor = findLayoutTypeDescriptor;
+//# sourceMappingURL=DescriptorCatalog.js.map

package/dist/cjs/editing/DescriptorCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DescriptorCatalog.js","sources":["../../../editing/DescriptorCatalog.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentDescriptor, LayoutTypeDescriptor } from '@cratis/scene.model';\nimport { layoutTypeDescriptors } from './layoutTypeDescriptors';\n\n/**\n * Everything an editor knows how to describe: the component descriptors packages contribute, and the layout types\n * the model itself defines.\n *\n * It is a derived view over what packages ship - not a registry anything registers into. Build one from the\n * descriptors of the packages a profile lists, and rebuild it when the list changes.\n */\nexport interface DescriptorCatalog {\n    components: ComponentDescriptor[];\n    layoutTypes: LayoutTypeDescriptor[];\n}\n\n/**\n * Builds a catalog from the component descriptors of the active packages, plus the built-in layout types.\n *\n * When two descriptors name the same component the later one wins, which is the same override-priority rule\n * the profile's package order already means for components.\n */\nexport function createDescriptorCatalog(componentDescriptors: ComponentDescriptor[] = []): DescriptorCatalog {\n    const byComponent = new Map<string, ComponentDescriptor>();\n    for (const descriptor of componentDescriptors) byComponent.set(descriptor.component, descriptor);\n\n    return { components: [...byComponent.values()], layoutTypes: layoutTypeDescriptors };\n}\n\n/**\n * Finds the descriptor of a component by the name an element carries.\n *\n * An exact match wins. Otherwise a bare name (`dataTable`) finds the one descriptor whose component ends in\n * `:dataTable`; a bare name that several packages describe has no single answer, so it finds none.\n */\nexport function findComponentDescriptor(catalog: DescriptorCatalog, componentName: string): ComponentDescriptor | undefined {\n    const exact = catalog.components.find(descriptor => descriptor.component === componentName);\n    if (exact) return exact;\n\n    const matches = catalog.components.filter(descriptor => descriptor.component.endsWith(`:${componentName}`));\n    return matches.length === 1 ? matches[0] : undefined;\n}\n\n/**\n * Finds the descriptor of a layout type.\n */\nexport function findLayoutTypeDescriptor(catalog: DescriptorCatalog, type: string): LayoutTypeDescriptor | undefined {\n    return catalog.layoutTypes.find(descriptor => descriptor.type === type);\n}\n"],"names":["createDescriptorCatalog","componentDescriptors","byComponent","Map","descriptor","set","component","components","values","layoutTypes","layoutTypeDescriptors","findComponentDescriptor","catalog","componentName","exact","find","matches","filter","endsWith","length","undefined","findLayoutTypeDescriptor","type"],"mappings":";;;;AAAA;AACA;AAiBA;;;;;AAKC,IACM,SAASA,uBAAAA,CAAwBC,oBAAAA,GAA8C,EAAE,EAAA;AACpF,IAAA,MAAMC,cAAc,IAAIC,GAAAA,EAAAA;IACxB,KAAK,MAAMC,cAAcH,oBAAAA,CAAsBC,WAAAA,CAAYG,GAAG,CAACD,UAAAA,CAAWE,SAAS,EAAEF,UAAAA,CAAAA;IAErF,OAAO;QAAEG,UAAAA,EAAY;AAAIL,YAAAA,GAAAA,WAAAA,CAAYM,MAAM;AAAG,SAAA;QAAEC,WAAAA,EAAaC;AAAsB,KAAA;AACvF;AAEA;;;;;AAKC,IACM,SAASC,uBAAAA,CAAwBC,OAA0B,EAAEC,aAAqB,EAAA;IACrF,MAAMC,KAAAA,GAAQF,OAAAA,CAAQL,UAAU,CAACQ,IAAI,CAACX,CAAAA,UAAAA,GAAcA,UAAAA,CAAWE,SAAS,KAAKO,aAAAA,CAAAA;AAC7E,IAAA,IAAIC,OAAO,OAAOA,KAAAA;AAElB,IAAA,MAAME,UAAUJ,OAAAA,CAAQL,UAAU,CAACU,MAAM,CAACb,CAAAA,UAAAA,GAAcA,UAAAA,CAAWE,SAAS,CAACY,QAAQ,CAAC,CAAC,CAAC,EAAEL,aAAAA,CAAAA,CAAe,CAAA,CAAA;AACzG,IAAA,OAAOG,QAAQG,MAAM,KAAK,IAAIH,OAAO,CAAC,EAAE,GAAGI,SAAAA;AAC/C;AAEA;;AAEC,IACM,SAASC,wBAAAA,CAAyBT,OAA0B,EAAEU,IAAY,EAAA;IAC7E,OAAOV,OAAAA,CAAQH,WAAW,CAACM,IAAI,CAACX,CAAAA,UAAAA,GAAcA,UAAAA,CAAWkB,IAAI,KAAKA,IAAAA,CAAAA;AACtE;;;;"}

package/dist/cjs/editing/EditSession.js

@@ -0,0 +1,44 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var exposureGrants = require('./exposureGrants.js');
+var indexDocument = require('./indexDocument.js');
+var inspect = require('./inspect.js');
+var resolveEffectiveConfiguration = require('./resolveEffectiveConfiguration.js');
+var resolveTemplateChain = require('./resolveTemplateChain.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Everything an edit needs to decide whether it is allowed, worked out once against the document as it was.
+ */ class EditSession {
+    document;
+    context;
+    index;
+    chain;
+    grants;
+    configuration;
+    constructor(document, context){
+        this.document = document;
+        this.context = context;
+        this.index = indexDocument.indexDocument(document);
+        this.chain = resolveTemplateChain.resolveTemplateChain(document, context.scope);
+        this.grants = exposureGrants.computeExposureGrants(this.chain, context.catalog);
+        this.configuration = resolveEffectiveConfiguration.resolveEffectiveConfiguration(this.chain, document.instanceContributions, context.catalog);
+    }
+    /** The instance id the scope contributes as, or `undefined` when the scope was not found. */ get scopeInstance() {
+        return this.chain.levels.at(-1)?.instance;
+    }
+    /** What the scope's instance may configure on inherited components. */ get scopeGrants() {
+        return (this.scopeInstance === undefined ? undefined : this.grants.byInstance.get(this.scopeInstance)) ?? new Map();
+    }
+    /** Whether the scope itself owns the node. */ isLocal(record) {
+        return inspect.provenanceOf(record, this.chain, this.scopeGrants).kind === scene_model.ProvenanceKind.Local;
+    }
+    /** Where an inherited node comes from, for a message. */ sourceOf(record) {
+        return record.owner;
+    }
+}
+
+exports.EditSession = EditSession;
+//# sourceMappingURL=EditSession.js.map

package/dist/cjs/editing/EditSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditSession.js","sources":["../../../editing/EditSession.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ProvenanceKind, SceneDocument } from '@cratis/scene.model';\nimport { EditingContext } from './EditingContext';\nimport { DocumentIndex, NodeRecord } from './DocumentIndex';\nimport { ExposureGrant, ExposureGrants, computeExposureGrants } from './exposureGrants';\nimport { indexDocument } from './indexDocument';\nimport { provenanceOf } from './inspect';\nimport { resolveEffectiveConfiguration } from './resolveEffectiveConfiguration';\nimport { resolveTemplateChain } from './resolveTemplateChain';\nimport { TemplateChain } from './TemplateChain';\nimport { EffectiveConfiguration } from '@cratis/scene.model';\n\n/**\n * Everything an edit needs to decide whether it is allowed, worked out once against the document as it was.\n */\nexport class EditSession {\n    readonly index: DocumentIndex;\n    readonly chain: TemplateChain;\n    readonly grants: ExposureGrants;\n    readonly configuration: EffectiveConfiguration;\n\n    constructor(readonly document: SceneDocument, readonly context: EditingContext) {\n        this.index = indexDocument(document);\n        this.chain = resolveTemplateChain(document, context.scope);\n        this.grants = computeExposureGrants(this.chain, context.catalog);\n        this.configuration = resolveEffectiveConfiguration(this.chain, document.instanceContributions, context.catalog);\n    }\n\n    /** The instance id the scope contributes as, or `undefined` when the scope was not found. */\n    get scopeInstance(): string | undefined {\n        return this.chain.levels.at(-1)?.instance;\n    }\n\n    /** What the scope's instance may configure on inherited components. */\n    get scopeGrants(): Map<string, ExposureGrant> {\n        return (this.scopeInstance === undefined ? undefined : this.grants.byInstance.get(this.scopeInstance)) ?? new Map();\n    }\n\n    /** Whether the scope itself owns the node. */\n    isLocal(record: NodeRecord): boolean {\n        return provenanceOf(record, this.chain, this.scopeGrants).kind === ProvenanceKind.Local;\n    }\n\n    /** Where an inherited node comes from, for a message. */\n    sourceOf(record: NodeRecord): string {\n        return record.owner;\n    }\n}\n"],"names":["EditSession","index","chain","grants","configuration","context","document","indexDocument","resolveTemplateChain","scope","computeExposureGrants","catalog","resolveEffectiveConfiguration","instanceContributions","scopeInstance","levels","at","instance","scopeGrants","undefined","byInstance","get","Map","isLocal","record","provenanceOf","kind","ProvenanceKind","Local","sourceOf","owner"],"mappings":";;;;;;;;;AAAA;AACA;AAaA;;AAEC,IACM,MAAMA,WAAAA,CAAAA;;;IACAC,KAAAA;IACAC,KAAAA;IACAC,MAAAA;IACAC,aAAAA;AAET,IAAA,WAAA,CAAY,QAAgC,EAAWC,OAAuB,CAAE;aAA3DC,QAAAA,GAAAA,QAAAA;aAAkCD,OAAAA,GAAAA,OAAAA;QACnD,IAAI,CAACJ,KAAK,GAAGM,2BAAAA,CAAcD,QAAAA,CAAAA;AAC3B,QAAA,IAAI,CAACJ,KAAK,GAAGM,yCAAAA,CAAqBF,QAAAA,EAAUD,QAAQI,KAAK,CAAA;QACzD,IAAI,CAACN,MAAM,GAAGO,oCAAAA,CAAsB,IAAI,CAACR,KAAK,EAAEG,OAAAA,CAAQM,OAAO,CAAA;AAC/D,QAAA,IAAI,CAACP,aAAa,GAAGQ,2DAAAA,CAA8B,IAAI,CAACV,KAAK,EAAEI,QAAAA,CAASO,qBAAqB,EAAER,OAAAA,CAAQM,OAAO,CAAA;AAClH,IAAA;kGAGA,IAAIG,aAAAA,GAAoC;QACpC,OAAO,IAAI,CAACZ,KAAK,CAACa,MAAM,CAACC,EAAE,CAAC,EAAC,CAAA,EAAIC,QAAAA;AACrC,IAAA;4EAGA,IAAIC,WAAAA,GAA0C;QAC1C,OAAQ,CAAA,IAAI,CAACJ,aAAa,KAAKK,SAAAA,GAAYA,YAAY,IAAI,CAAChB,MAAM,CAACiB,UAAU,CAACC,GAAG,CAAC,IAAI,CAACP,aAAa,CAAA,KAAM,IAAIQ,GAAAA,EAAAA;AAClH,IAAA;mDAGAC,OAAAA,CAAQC,MAAkB,EAAW;AACjC,QAAA,OAAOC,oBAAAA,CAAaD,MAAAA,EAAQ,IAAI,CAACtB,KAAK,EAAE,IAAI,CAACgB,WAAW,CAAA,CAAEQ,IAAI,KAAKC,2BAAeC,KAAK;AAC3F,IAAA;8DAGAC,QAAAA,CAASL,MAAkB,EAAU;AACjC,QAAA,OAAOA,OAAOM,KAAK;AACvB,IAAA;AACJ;;"}

package/dist/cjs/editing/applyEdit.js

@@ -0,0 +1,83 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var diagnostics = require('./diagnostics.js');
+var EditSession = require('./EditSession.js');
+var exposureEdits = require('./exposureEdits.js');
+var instanceEdits = require('./instanceEdits.js');
+var layoutTypeEdits = require('./layoutTypeEdits.js');
+var pathAccess = require('./pathAccess.js');
+var propertyEdits = require('./propertyEdits.js');
+var structureEdits = require('./structureEdits.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function run(session, edit, clone, diagnostics$1) {
+    const handle = (handler)=>handler(session, edit, clone, diagnostics$1);
+    switch(edit.kind){
+        case scene_model.SceneEditKind.SetProperty:
+            return handle(propertyEdits.applySetProperty);
+        case scene_model.SceneEditKind.ResetProperty:
+            return handle(propertyEdits.applyResetProperty);
+        case scene_model.SceneEditKind.ChangeLayoutType:
+            return handle(layoutTypeEdits.applyChangeLayoutType);
+        case scene_model.SceneEditKind.InsertNode:
+            return handle(structureEdits.applyInsertNode);
+        case scene_model.SceneEditKind.MoveNode:
+            return handle(structureEdits.applyMoveNode);
+        case scene_model.SceneEditKind.RemoveNode:
+            return handle(structureEdits.applyRemoveNode);
+        case scene_model.SceneEditKind.SetInstanceValue:
+            return handle(instanceEdits.applySetInstanceValue);
+        case scene_model.SceneEditKind.ResetInstanceValue:
+            return handle(instanceEdits.applyResetInstanceValue);
+        case scene_model.SceneEditKind.AddCollectionItem:
+            return handle(instanceEdits.applyAddCollectionItem);
+        case scene_model.SceneEditKind.RemoveCollectionItem:
+            return handle(instanceEdits.applyRemoveCollectionItem);
+        case scene_model.SceneEditKind.ReorderCollectionItem:
+            return handle(instanceEdits.applyReorderCollectionItem);
+        case scene_model.SceneEditKind.EditCollectionItem:
+            return handle(instanceEdits.applyEditCollectionItem);
+        case scene_model.SceneEditKind.ExposeProperty:
+            return handle(exposureEdits.applyExposeProperty);
+        case scene_model.SceneEditKind.UnexposeProperty:
+            return handle(exposureEdits.applyUnexposeProperty);
+        default:
+            diagnostics$1.push(diagnostics.errorDiagnostic(scene_model.DiagnosticCode.InvalidEdit, `'${edit.kind}' is not an edit this engine knows.`));
+    }
+}
+/**
+ * Applies one edit to a document.
+ *
+ * Pure and immutable: the document passed in is never changed, and the result is a new document. Edits are plain
+ * data, so a host can persist them and build undo and redo by keeping the documents either side. On any error the
+ * prior document comes back - the same object - together with the diagnostics, so a refused edit leaves nothing
+ * half done.
+ *
+ * What an edit may touch follows the editing scope. Nodes the scope owns are edited directly; inherited nodes are
+ * read-only, and their exposed properties are configured with the instance edits, which are checked against what
+ * each owner exposed.
+ *
+ * @param model The document to edit.
+ * @param edit What to do.
+ * @param context The catalog and the editing scope.
+ */ function applyEdit(model, edit, context) {
+    const session = new EditSession.EditSession(model, context);
+    const clone = pathAccess.cloneData(model);
+    const diagnostics$1 = [];
+    run(session, edit, clone, diagnostics$1);
+    if (diagnostics.hasErrors(diagnostics$1)) return {
+        model,
+        diagnostics: diagnostics$1,
+        applied: false
+    };
+    return {
+        model: clone,
+        diagnostics: diagnostics$1,
+        applied: true
+    };
+}
+
+exports.applyEdit = applyEdit;
+//# sourceMappingURL=applyEdit.js.map

package/dist/cjs/editing/applyEdit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyEdit.js","sources":["../../../editing/applyEdit.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { DiagnosticCode, SceneDiagnostic, SceneDocument, SceneEdit, SceneEditKind } from '@cratis/scene.model';\nimport { errorDiagnostic, hasErrors } from './diagnostics';\nimport { EditOutcome } from './EditOutcome';\nimport { EditingContext } from './EditingContext';\nimport { EditSession } from './EditSession';\nimport { applyExposeProperty, applyUnexposeProperty } from './exposureEdits';\nimport {\n    applyAddCollectionItem, applyEditCollectionItem, applyRemoveCollectionItem, applyReorderCollectionItem,\n    applyResetInstanceValue, applySetInstanceValue,\n} from './instanceEdits';\nimport { applyChangeLayoutType } from './layoutTypeEdits';\nimport { cloneData } from './pathAccess';\nimport { applyResetProperty, applySetProperty } from './propertyEdits';\nimport { applyInsertNode, applyMoveNode, applyRemoveNode } from './structureEdits';\n\ntype Handler<TEdit extends SceneEdit> = (session: EditSession, edit: TEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]) => void;\n\nfunction run(session: EditSession, edit: SceneEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]): void {\n    const handle = <TEdit extends SceneEdit>(handler: Handler<TEdit>) => handler(session, edit as TEdit, clone, diagnostics);\n\n    switch (edit.kind) {\n        case SceneEditKind.SetProperty: return handle(applySetProperty);\n        case SceneEditKind.ResetProperty: return handle(applyResetProperty);\n        case SceneEditKind.ChangeLayoutType: return handle(applyChangeLayoutType);\n        case SceneEditKind.InsertNode: return handle(applyInsertNode);\n        case SceneEditKind.MoveNode: return handle(applyMoveNode);\n        case SceneEditKind.RemoveNode: return handle(applyRemoveNode);\n        case SceneEditKind.SetInstanceValue: return handle(applySetInstanceValue);\n        case SceneEditKind.ResetInstanceValue: return handle(applyResetInstanceValue);\n        case SceneEditKind.AddCollectionItem: return handle(applyAddCollectionItem);\n        case SceneEditKind.RemoveCollectionItem: return handle(applyRemoveCollectionItem);\n        case SceneEditKind.ReorderCollectionItem: return handle(applyReorderCollectionItem);\n        case SceneEditKind.EditCollectionItem: return handle(applyEditCollectionItem);\n        case SceneEditKind.ExposeProperty: return handle(applyExposeProperty);\n        case SceneEditKind.UnexposeProperty: return handle(applyUnexposeProperty);\n        default:\n            diagnostics.push(errorDiagnostic(DiagnosticCode.InvalidEdit, `'${(edit as { kind?: string }).kind}' is not an edit this engine knows.`));\n    }\n}\n\n/**\n * Applies one edit to a document.\n *\n * Pure and immutable: the document passed in is never changed, and the result is a new document. Edits are plain\n * data, so a host can persist them and build undo and redo by keeping the documents either side. On any error the\n * prior document comes back - the same object - together with the diagnostics, so a refused edit leaves nothing\n * half done.\n *\n * What an edit may touch follows the editing scope. Nodes the scope owns are edited directly; inherited nodes are\n * read-only, and their exposed properties are configured with the instance edits, which are checked against what\n * each owner exposed.\n *\n * @param model The document to edit.\n * @param edit What to do.\n * @param context The catalog and the editing scope.\n */\nexport function applyEdit(model: SceneDocument, edit: SceneEdit, context: EditingContext): EditOutcome {\n    const session = new EditSession(model, context);\n    const clone = cloneData(model);\n    const diagnostics: SceneDiagnostic[] = [];\n\n    run(session, edit, clone, diagnostics);\n\n    if (hasErrors(diagnostics)) return { model, diagnostics, applied: false };\n    return { model: clone, diagnostics, applied: true };\n}\n"],"names":["run","session","edit","clone","diagnostics","handle","handler","kind","SceneEditKind","SetProperty","applySetProperty","ResetProperty","applyResetProperty","ChangeLayoutType","applyChangeLayoutType","InsertNode","applyInsertNode","MoveNode","applyMoveNode","RemoveNode","applyRemoveNode","SetInstanceValue","applySetInstanceValue","ResetInstanceValue","applyResetInstanceValue","AddCollectionItem","applyAddCollectionItem","RemoveCollectionItem","applyRemoveCollectionItem","ReorderCollectionItem","applyReorderCollectionItem","EditCollectionItem","applyEditCollectionItem","ExposeProperty","applyExposeProperty","UnexposeProperty","applyUnexposeProperty","push","errorDiagnostic","DiagnosticCode","InvalidEdit","applyEdit","model","context","EditSession","cloneData","hasErrors","applied"],"mappings":";;;;;;;;;;;;AAAA;AACA;AAmBA,SAASA,IAAIC,OAAoB,EAAEC,IAAe,EAAEC,KAAoB,EAAEC,aAA8B,EAAA;AACpG,IAAA,MAAMC,SAAS,CAA0BC,OAAAA,GAA4BA,OAAAA,CAAQL,OAAAA,EAASC,MAAeC,KAAAA,EAAOC,aAAAA,CAAAA;AAE5G,IAAA,OAAQF,KAAKK,IAAI;AACb,QAAA,KAAKC,0BAAcC,WAAW;AAAE,YAAA,OAAOJ,MAAAA,CAAOK,8BAAAA,CAAAA;AAC9C,QAAA,KAAKF,0BAAcG,aAAa;AAAE,YAAA,OAAON,MAAAA,CAAOO,gCAAAA,CAAAA;AAChD,QAAA,KAAKJ,0BAAcK,gBAAgB;AAAE,YAAA,OAAOR,MAAAA,CAAOS,qCAAAA,CAAAA;AACnD,QAAA,KAAKN,0BAAcO,UAAU;AAAE,YAAA,OAAOV,MAAAA,CAAOW,8BAAAA,CAAAA;AAC7C,QAAA,KAAKR,0BAAcS,QAAQ;AAAE,YAAA,OAAOZ,MAAAA,CAAOa,4BAAAA,CAAAA;AAC3C,QAAA,KAAKV,0BAAcW,UAAU;AAAE,YAAA,OAAOd,MAAAA,CAAOe,8BAAAA,CAAAA;AAC7C,QAAA,KAAKZ,0BAAca,gBAAgB;AAAE,YAAA,OAAOhB,MAAAA,CAAOiB,mCAAAA,CAAAA;AACnD,QAAA,KAAKd,0BAAce,kBAAkB;AAAE,YAAA,OAAOlB,MAAAA,CAAOmB,qCAAAA,CAAAA;AACrD,QAAA,KAAKhB,0BAAciB,iBAAiB;AAAE,YAAA,OAAOpB,MAAAA,CAAOqB,oCAAAA,CAAAA;AACpD,QAAA,KAAKlB,0BAAcmB,oBAAoB;AAAE,YAAA,OAAOtB,MAAAA,CAAOuB,uCAAAA,CAAAA;AACvD,QAAA,KAAKpB,0BAAcqB,qBAAqB;AAAE,YAAA,OAAOxB,MAAAA,CAAOyB,wCAAAA,CAAAA;AACxD,QAAA,KAAKtB,0BAAcuB,kBAAkB;AAAE,YAAA,OAAO1B,MAAAA,CAAO2B,qCAAAA,CAAAA;AACrD,QAAA,KAAKxB,0BAAcyB,cAAc;AAAE,YAAA,OAAO5B,MAAAA,CAAO6B,iCAAAA,CAAAA;AACjD,QAAA,KAAK1B,0BAAc2B,gBAAgB;AAAE,YAAA,OAAO9B,MAAAA,CAAO+B,mCAAAA,CAAAA;AACnD,QAAA;AACIhC,YAAAA,aAAAA,CAAYiC,IAAI,CAACC,2BAAAA,CAAgBC,0BAAAA,CAAeC,WAAW,EAAE,CAAC,CAAC,EAAE,IAACtC,CAA2BK,IAAI,CAAC,mCAAmC,CAAC,CAAA,CAAA;AAC9I;AACJ;AAEA;;;;;;;;;;;;;;;AAeC,IACM,SAASkC,SAAAA,CAAUC,KAAoB,EAAExC,IAAe,EAAEyC,OAAuB,EAAA;IACpF,MAAM1C,OAAAA,GAAU,IAAI2C,uBAAAA,CAAYF,KAAAA,EAAOC,OAAAA,CAAAA;AACvC,IAAA,MAAMxC,QAAQ0C,oBAAAA,CAAUH,KAAAA,CAAAA;AACxB,IAAA,MAAMtC,gBAAiC,EAAE;IAEzCJ,GAAAA,CAAIC,OAAAA,EAASC,MAAMC,KAAAA,EAAOC,aAAAA,CAAAA;IAE1B,IAAI0C,qBAAAA,CAAU1C,gBAAc,OAAO;AAAEsC,QAAAA,KAAAA;AAAOtC,qBAAAA,aAAAA;QAAa2C,OAAAA,EAAS;AAAM,KAAA;IACxE,OAAO;QAAEL,KAAAA,EAAOvC,KAAAA;AAAOC,qBAAAA,aAAAA;QAAa2C,OAAAA,EAAS;AAAK,KAAA;AACtD;;"}

package/dist/cjs/editing/applyEffectiveConfiguration.js

@@ -0,0 +1,62 @@
+'use strict';
+
+var elementKind = require('../elementKind.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Returns the element tree a renderer should draw once effective configuration is applied: each configurable
+ * component carries its resolved properties.
+ *
+ * Pure, and structure-sharing - an element with nothing to change comes back as the same object, so a renderer
+ * that memoizes on identity does not redraw what did not change. There is no design-time flag here or anywhere
+ * downstream: a screen being edited and a screen being played go through this same function.
+ *
+ * @param element The element tree from the template or screen.
+ * @param configuration What {@link resolveEffectiveConfiguration} produced for the chain the tree sits in.
+ */ function applyEffectiveConfiguration(element, configuration) {
+    if (elementKind.isExternalComponent(element)) {
+        const resolved = configuration.components.find((candidate)=>candidate.component === element.id);
+        let changed = resolved !== undefined;
+        const slots = {};
+        for (const [name, children] of Object.entries(element.slots)){
+            const mapped = children.map((child)=>applyEffectiveConfiguration(child, configuration));
+            if (mapped.some((child, index)=>child !== children[index])) changed = true;
+            slots[name] = mapped;
+        }
+        const updated = {
+            ...element,
+            properties: resolved?.properties ?? element.properties,
+            slots
+        };
+        return changed ? updated : element;
+    }
+    if (elementKind.isContentControl(element)) {
+        const content = applyEffectiveConfiguration(element.content, configuration);
+        const updated = {
+            ...element,
+            content
+        };
+        return content === element.content ? element : updated;
+    }
+    if (elementKind.isItemsControl(element)) {
+        const itemTemplate = applyEffectiveConfiguration(element.itemTemplate, configuration);
+        const updated = {
+            ...element,
+            itemTemplate
+        };
+        return itemTemplate === element.itemTemplate ? element : updated;
+    }
+    if (elementKind.isPanel(element)) {
+        const children = element.children.map((child)=>applyEffectiveConfiguration(child, configuration));
+        const updated = {
+            ...element,
+            children
+        };
+        return children.some((child, index)=>child !== element.children[index]) ? updated : element;
+    }
+    return element;
+}
+
+exports.applyEffectiveConfiguration = applyEffectiveConfiguration;
+//# sourceMappingURL=applyEffectiveConfiguration.js.map

package/dist/cjs/editing/applyEffectiveConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyEffectiveConfiguration.js","sources":["../../../editing/applyEffectiveConfiguration.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ContentControl, EffectiveConfiguration, ExternalComponent, ItemsControl, Panel, SceneElement } from '@cratis/scene.model';\nimport { isContentControl, isExternalComponent, isItemsControl, isPanel } from '../elementKind';\n\n/**\n * Returns the element tree a renderer should draw once effective configuration is applied: each configurable\n * component carries its resolved properties.\n *\n * Pure, and structure-sharing - an element with nothing to change comes back as the same object, so a renderer\n * that memoizes on identity does not redraw what did not change. There is no design-time flag here or anywhere\n * downstream: a screen being edited and a screen being played go through this same function.\n *\n * @param element The element tree from the template or screen.\n * @param configuration What {@link resolveEffectiveConfiguration} produced for the chain the tree sits in.\n */\nexport function applyEffectiveConfiguration(element: SceneElement, configuration: EffectiveConfiguration): SceneElement {\n    if (isExternalComponent(element)) {\n        const resolved = configuration.components.find(candidate => candidate.component === element.id);\n        let changed = resolved !== undefined;\n\n        const slots: typeof element.slots = {};\n        for (const [name, children] of Object.entries(element.slots)) {\n            const mapped = children.map(child => applyEffectiveConfiguration(child, configuration));\n            if (mapped.some((child, index) => child !== children[index])) changed = true;\n            slots[name] = mapped;\n        }\n\n        const updated: ExternalComponent = { ...element, properties: resolved?.properties ?? element.properties, slots };\n        return changed ? updated : element;\n    }\n\n    if (isContentControl(element)) {\n        const content = applyEffectiveConfiguration(element.content, configuration);\n        const updated: ContentControl = { ...element, content };\n        return content === element.content ? element : updated;\n    }\n\n    if (isItemsControl(element)) {\n        const itemTemplate = applyEffectiveConfiguration(element.itemTemplate, configuration);\n        const updated: ItemsControl = { ...element, itemTemplate };\n        return itemTemplate === element.itemTemplate ? element : updated;\n    }\n\n    if (isPanel(element)) {\n        const children = element.children.map(child => applyEffectiveConfiguration(child, configuration));\n        const updated: Panel = { ...element, children };\n        return children.some((child, index) => child !== element.children[index]) ? updated : element;\n    }\n\n    return element;\n}\n"],"names":["applyEffectiveConfiguration","element","configuration","isExternalComponent","resolved","components","find","candidate","component","id","changed","undefined","slots","name","children","Object","entries","mapped","map","child","some","index","updated","properties","isContentControl","content","isItemsControl","itemTemplate","isPanel"],"mappings":";;;;AAAA;AACA;AAKA;;;;;;;;;;AAUC,IACM,SAASA,2BAAAA,CAA4BC,OAAqB,EAAEC,aAAqC,EAAA;AACpG,IAAA,IAAIC,gCAAoBF,OAAAA,CAAAA,EAAU;AAC9B,QAAA,MAAMG,QAAAA,GAAWF,aAAAA,CAAcG,UAAU,CAACC,IAAI,CAACC,CAAAA,SAAAA,GAAaA,SAAAA,CAAUC,SAAS,KAAKP,OAAAA,CAAQQ,EAAE,CAAA;AAC9F,QAAA,IAAIC,UAAUN,QAAAA,KAAaO,SAAAA;AAE3B,QAAA,MAAMC,QAA8B,EAAC;QACrC,KAAK,MAAM,CAACC,IAAAA,EAAMC,QAAAA,CAAS,IAAIC,OAAOC,OAAO,CAACf,OAAAA,CAAQW,KAAK,CAAA,CAAG;AAC1D,YAAA,MAAMK,SAASH,QAAAA,CAASI,GAAG,CAACC,CAAAA,KAAAA,GAASnB,4BAA4BmB,KAAAA,EAAOjB,aAAAA,CAAAA,CAAAA;YACxE,IAAIe,MAAAA,CAAOG,IAAI,CAAC,CAACD,KAAAA,EAAOE,KAAAA,GAAUF,KAAAA,KAAUL,QAAQ,CAACO,KAAAA,CAAM,CAAA,EAAGX,OAAAA,GAAU,IAAA;YACxEE,KAAK,CAACC,KAAK,GAAGI,MAAAA;AAClB,QAAA;AAEA,QAAA,MAAMK,OAAAA,GAA6B;AAAE,YAAA,GAAGrB,OAAO;YAAEsB,UAAAA,EAAYnB,QAAAA,EAAUmB,UAAAA,IAActB,OAAAA,CAAQsB,UAAU;AAAEX,YAAAA;AAAM,SAAA;AAC/G,QAAA,OAAOF,UAAUY,OAAAA,GAAUrB,OAAAA;AAC/B,IAAA;AAEA,IAAA,IAAIuB,6BAAiBvB,OAAAA,CAAAA,EAAU;AAC3B,QAAA,MAAMwB,OAAAA,GAAUzB,2BAAAA,CAA4BC,OAAAA,CAAQwB,OAAO,EAAEvB,aAAAA,CAAAA;AAC7D,QAAA,MAAMoB,OAAAA,GAA0B;AAAE,YAAA,GAAGrB,OAAO;AAAEwB,YAAAA;AAAQ,SAAA;AACtD,QAAA,OAAOA,OAAAA,KAAYxB,OAAAA,CAAQwB,OAAO,GAAGxB,OAAAA,GAAUqB,OAAAA;AACnD,IAAA;AAEA,IAAA,IAAII,2BAAezB,OAAAA,CAAAA,EAAU;AACzB,QAAA,MAAM0B,YAAAA,GAAe3B,2BAAAA,CAA4BC,OAAAA,CAAQ0B,YAAY,EAAEzB,aAAAA,CAAAA;AACvE,QAAA,MAAMoB,OAAAA,GAAwB;AAAE,YAAA,GAAGrB,OAAO;AAAE0B,YAAAA;AAAa,SAAA;AACzD,QAAA,OAAOA,YAAAA,KAAiB1B,OAAAA,CAAQ0B,YAAY,GAAG1B,OAAAA,GAAUqB,OAAAA;AAC7D,IAAA;AAEA,IAAA,IAAIM,oBAAQ3B,OAAAA,CAAAA,EAAU;QAClB,MAAMa,QAAAA,GAAWb,QAAQa,QAAQ,CAACI,GAAG,CAACC,CAAAA,KAAAA,GAASnB,2BAAAA,CAA4BmB,KAAAA,EAAOjB,aAAAA,CAAAA,CAAAA;AAClF,QAAA,MAAMoB,OAAAA,GAAiB;AAAE,YAAA,GAAGrB,OAAO;AAAEa,YAAAA;AAAS,SAAA;AAC9C,QAAA,OAAOA,QAAAA,CAASM,IAAI,CAAC,CAACD,KAAAA,EAAOE,KAAAA,GAAUF,KAAAA,KAAUlB,OAAAA,CAAQa,QAAQ,CAACO,KAAAA,CAAM,CAAA,GAAIC,OAAAA,GAAUrB,OAAAA;AAC1F,IAAA;IAEA,OAAOA,OAAAA;AACX;;"}

package/dist/cjs/editing/collectComponents.js

@@ -0,0 +1,34 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function isExternalComponentValue(value) {
+    const candidate = value;
+    return typeof candidate.id === 'string' && typeof candidate.componentName === 'string' && candidate.properties !== null && typeof candidate.properties === 'object';
+}
+/**
+ * Finds every external component anywhere inside a layout, template, dialog template or screen, each once by id.
+ *
+ * It scans the value's structure rather than following a fixed list of properties, so a component is found
+ * wherever the model keeps it - slot content, a flow leaf, a freeform placement, a panel's children, another
+ * component's slot. A freeform arrangement repeats an element across its size-class variants; the first copy
+ * is the one returned.
+ */ function collectComponents(owner) {
+    const found = new Map();
+    const visit = (value)=>{
+        if (value === null || typeof value !== 'object') return;
+        if (Array.isArray(value)) {
+            for (const item of value)visit(item);
+            return;
+        }
+        if (isExternalComponentValue(value) && !found.has(value.id)) found.set(value.id, value);
+        for (const child of Object.values(value))visit(child);
+    };
+    visit(owner);
+    return [
+        ...found.values()
+    ];
+}
+
+exports.collectComponents = collectComponents;
+//# sourceMappingURL=collectComponents.js.map

package/dist/cjs/editing/collectComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectComponents.js","sources":["../../../editing/collectComponents.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ExternalComponent } from '@cratis/scene.model';\n\nfunction isExternalComponentValue(value: object): value is ExternalComponent {\n    const candidate = value as Partial<ExternalComponent>;\n    return typeof candidate.id === 'string' && typeof candidate.componentName === 'string'\n        && candidate.properties !== null && typeof candidate.properties === 'object';\n}\n\n/**\n * Finds every external component anywhere inside a layout, template, dialog template or screen, each once by id.\n *\n * It scans the value's structure rather than following a fixed list of properties, so a component is found\n * wherever the model keeps it - slot content, a flow leaf, a freeform placement, a panel's children, another\n * component's slot. A freeform arrangement repeats an element across its size-class variants; the first copy\n * is the one returned.\n */\nexport function collectComponents(owner: unknown): ExternalComponent[] {\n    const found = new Map<string, ExternalComponent>();\n\n    const visit = (value: unknown): void => {\n        if (value === null || typeof value !== 'object') return;\n        if (Array.isArray(value)) {\n            for (const item of value) visit(item);\n            return;\n        }\n\n        if (isExternalComponentValue(value) && !found.has(value.id)) found.set(value.id, value);\n        for (const child of Object.values(value)) visit(child);\n    };\n\n    visit(owner);\n    return [...found.values()];\n}\n"],"names":["isExternalComponentValue","value","candidate","id","componentName","properties","collectComponents","owner","found","Map","visit","Array","isArray","item","has","set","child","Object","values"],"mappings":";;AAAA;AACA;AAIA,SAASA,yBAAyBC,KAAa,EAAA;AAC3C,IAAA,MAAMC,SAAAA,GAAYD,KAAAA;AAClB,IAAA,OAAO,OAAOC,SAAAA,CAAUC,EAAE,KAAK,QAAA,IAAY,OAAOD,SAAAA,CAAUE,aAAa,KAAK,QAAA,IACvEF,UAAUG,UAAU,KAAK,QAAQ,OAAOH,SAAAA,CAAUG,UAAU,KAAK,QAAA;AAC5E;AAEA;;;;;;;IAQO,SAASC,iBAAAA,CAAkBC,KAAc,EAAA;AAC5C,IAAA,MAAMC,QAAQ,IAAIC,GAAAA,EAAAA;AAElB,IAAA,MAAMC,QAAQ,CAACT,KAAAA,GAAAA;AACX,QAAA,IAAIA,KAAAA,KAAU,IAAA,IAAQ,OAAOA,KAAAA,KAAU,QAAA,EAAU;QACjD,IAAIU,KAAAA,CAAMC,OAAO,CAACX,KAAAA,CAAAA,EAAQ;YACtB,KAAK,MAAMY,IAAAA,IAAQZ,KAAAA,CAAOS,KAAAA,CAAMG,IAAAA,CAAAA;AAChC,YAAA;AACJ,QAAA;AAEA,QAAA,IAAIb,wBAAAA,CAAyBC,KAAAA,CAAAA,IAAU,CAACO,KAAAA,CAAMM,GAAG,CAACb,KAAAA,CAAME,EAAE,CAAA,EAAGK,KAAAA,CAAMO,GAAG,CAACd,KAAAA,CAAME,EAAE,EAAEF,KAAAA,CAAAA;AACjF,QAAA,KAAK,MAAMe,KAAAA,IAASC,MAAAA,CAAOC,MAAM,CAACjB,OAAQS,KAAAA,CAAMM,KAAAA,CAAAA;AACpD,IAAA,CAAA;IAEAN,KAAAA,CAAMH,KAAAA,CAAAA;IACN,OAAO;AAAIC,QAAAA,GAAAA,KAAAA,CAAMU,MAAM;AAAG,KAAA;AAC9B;;"}

package/dist/cjs/editing/collectIconUsages.js

@@ -0,0 +1,86 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var collectComponents = require('./collectComponents.js');
+var DescriptorCatalog = require('./DescriptorCatalog.js');
+var pathAccess = require('./pathAccess.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function iconFields(property) {
+    return (property.item?.properties ?? []).filter((field)=>field.valueType === scene_model.PropertyValueType.Icon).map((field)=>field.path);
+}
+function usagesOf(property, value, items, location) {
+    if (property.valueType === scene_model.PropertyValueType.Icon) {
+        return value === undefined ? [] : [
+            {
+                value: value,
+                location: `${location}:${property.path}`
+            }
+        ];
+    }
+    return property.valueType === scene_model.PropertyValueType.Collection ? (items ?? []).flatMap((item)=>iconFields(property).filter((field)=>item.values[field] !== undefined).map((field)=>({
+                value: item.values[field],
+                location: `${location}:${property.path}:${item.id}:${field}`
+            }))) : [];
+}
+function ownerItems(value) {
+    return (Array.isArray(value) ? value : []).filter((item)=>item !== null && typeof item === 'object').map(({ id, ...values })=>({
+            id: String(id),
+            values
+        }));
+}
+/**
+ * Finds every icon value stored anywhere in a document - the values components carry themselves, and the values
+ * and collection-item icon fields that template instances contributed - as the `IconUsage`s that
+ * `analyzeIconImpact` takes, so "what would removing this library break" can be asked of a whole document.
+ *
+ * Each usage's `location` reads `<owner or instance>:<component>:<path>[:<itemId>:<field>]`, where the first part is
+ * the contributing instance id (`screen:Orders`) for a contributed value and the name of the owning layout or
+ * template for a value the component carries. Values are read as stored; none are changed.
+ *
+ * @param document The document to read.
+ * @param catalog The descriptors saying which properties are icons.
+ */ function collectIconUsages(document, catalog) {
+    const usages = [];
+    const componentNames = new Map();
+    const owners = [
+        ...document.layouts.map((layout)=>({
+                name: layout.name,
+                value: layout
+            })),
+        ...document.screenTemplates.map((template)=>({
+                name: template.name,
+                value: template
+            })),
+        ...document.dialogTemplates.map((template)=>({
+                name: template.name,
+                value: template
+            })),
+        ...document.screens.map((screen)=>({
+                name: screen.name,
+                value: screen
+            }))
+    ];
+    for (const owner of owners){
+        for (const component of collectComponents.collectComponents(owner.value)){
+            if (!componentNames.has(component.id)) componentNames.set(component.id, component.componentName);
+            for (const property of DescriptorCatalog.findComponentDescriptor(catalog, component.componentName)?.properties ?? []){
+                const value = pathAccess.getValueAtPath(component.properties, property.path);
+                usages.push(...usagesOf(property, value, ownerItems(value), `${owner.name}:${component.id}`));
+            }
+        }
+    }
+    for (const contribution of document.instanceContributions){
+        const componentName = componentNames.get(contribution.component);
+        const property = componentName === undefined ? undefined : DescriptorCatalog.findComponentDescriptor(catalog, componentName)?.properties.find((candidate)=>candidate.path === contribution.path);
+        if (property) usages.push(...contributedUsages(property, contribution));
+    }
+    return usages;
+}
+function contributedUsages(property, contribution) {
+    return usagesOf(property, contribution.value, contribution.items, `${contribution.instance}:${contribution.component}`);
+}
+
+exports.collectIconUsages = collectIconUsages;
+//# sourceMappingURL=collectIconUsages.js.map

package/dist/cjs/editing/collectIconUsages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectIconUsages.js","sources":["../../../editing/collectIconUsages.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { InstanceContribution, PropertyDescriptor, PropertyValueType, SceneDocument } from '@cratis/scene.model';\nimport { IconUsage } from '../icons/IconUsage';\nimport { collectComponents } from './collectComponents';\nimport { DescriptorCatalog, findComponentDescriptor } from './DescriptorCatalog';\nimport { getValueAtPath } from './pathAccess';\n\nfunction iconFields(property: PropertyDescriptor): string[] {\n    return (property.item?.properties ?? []).filter((field) => field.valueType === PropertyValueType.Icon).map((field) => field.path);\n}\n\nfunction usagesOf(property: PropertyDescriptor, value: unknown, items: { id: string; values: Record<string, unknown> }[] | undefined, location: string): IconUsage[] {\n    if (property.valueType === PropertyValueType.Icon) {\n        return value === undefined ? [] : [{ value: value as IconUsage['value'], location: `${location}:${property.path}` }];\n    }\n\n    return property.valueType === PropertyValueType.Collection\n        ? (items ?? []).flatMap((item) =>\n              iconFields(property)\n                  .filter((field) => item.values[field] !== undefined)\n                  .map((field) => ({ value: item.values[field] as IconUsage['value'], location: `${location}:${property.path}:${item.id}:${field}` })))\n        : [];\n}\n\nfunction ownerItems(value: unknown): { id: string; values: Record<string, unknown> }[] {\n    return (Array.isArray(value) ? value : [])\n        .filter((item): item is Record<string, unknown> => item !== null && typeof item === 'object')\n        .map(({ id, ...values }) => ({ id: String(id), values }));\n}\n\n/**\n * Finds every icon value stored anywhere in a document - the values components carry themselves, and the values\n * and collection-item icon fields that template instances contributed - as the `IconUsage`s that\n * `analyzeIconImpact` takes, so \"what would removing this library break\" can be asked of a whole document.\n *\n * Each usage's `location` reads `<owner or instance>:<component>:<path>[:<itemId>:<field>]`, where the first part is\n * the contributing instance id (`screen:Orders`) for a contributed value and the name of the owning layout or\n * template for a value the component carries. Values are read as stored; none are changed.\n *\n * @param document The document to read.\n * @param catalog The descriptors saying which properties are icons.\n */\nexport function collectIconUsages(document: SceneDocument, catalog: DescriptorCatalog): IconUsage[] {\n    const usages: IconUsage[] = [];\n    const componentNames = new Map<string, string>();\n\n    const owners: { name: string; value: unknown }[] = [\n        ...document.layouts.map((layout) => ({ name: layout.name, value: layout })),\n        ...document.screenTemplates.map((template) => ({ name: template.name, value: template })),\n        ...document.dialogTemplates.map((template) => ({ name: template.name, value: template })),\n        ...document.screens.map((screen) => ({ name: screen.name, value: screen })),\n    ];\n\n    for (const owner of owners) {\n        for (const component of collectComponents(owner.value)) {\n            if (!componentNames.has(component.id)) componentNames.set(component.id, component.componentName);\n\n            for (const property of findComponentDescriptor(catalog, component.componentName)?.properties ?? []) {\n                const value = getValueAtPath(component.properties, property.path);\n                usages.push(...usagesOf(property, value, ownerItems(value), `${owner.name}:${component.id}`));\n            }\n        }\n    }\n\n    for (const contribution of document.instanceContributions) {\n        const componentName = componentNames.get(contribution.component);\n        const property = componentName === undefined ? undefined : findComponentDescriptor(catalog, componentName)?.properties.find((candidate) => candidate.path === contribution.path);\n        if (property) usages.push(...contributedUsages(property, contribution));\n    }\n\n    return usages;\n}\n\nfunction contributedUsages(property: PropertyDescriptor, contribution: InstanceContribution): IconUsage[] {\n    return usagesOf(property, contribution.value, contribution.items, `${contribution.instance}:${contribution.component}`);\n}\n"],"names":["iconFields","property","item","properties","filter","field","valueType","PropertyValueType","Icon","map","path","usagesOf","value","items","location","undefined","Collection","flatMap","values","id","ownerItems","Array","isArray","String","collectIconUsages","document","catalog","usages","componentNames","Map","owners","layouts","layout","name","screenTemplates","template","dialogTemplates","screens","screen","owner","component","collectComponents","has","set","componentName","findComponentDescriptor","getValueAtPath","push","contribution","instanceContributions","get","find","candidate","contributedUsages","instance"],"mappings":"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"}

package/dist/cjs/editing/describeNode.js

@@ -0,0 +1,63 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var DescriptorCatalog = require('./DescriptorCatalog.js');
+var diagnostics = require('./diagnostics.js');
+var pathAccess = require('./pathAccess.js');
+var layoutTypeDescriptors = require('./layoutTypeDescriptors.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const layoutTypes = new Set(Object.values(scene_model.LayoutType));
+/**
+ * Works out which descriptors apply to a node.
+ *
+ * A component takes its descriptor from the catalog by the name it carries; a layout node takes its layout type's;
+ * a placement and a template have their own fixed sets. A component nothing describes has no editable
+ * properties, and says so rather than failing.
+ */ function describeNode(record, catalog) {
+    const diagnostics$1 = [];
+    if (record.kind === scene_model.SceneNodeKind.Placement) return {
+        properties: layoutTypeDescriptors.placementProperties,
+        diagnostics: diagnostics$1
+    };
+    if (record.kind === scene_model.SceneNodeKind.ScreenTemplate || record.kind === scene_model.SceneNodeKind.DialogTemplate) return {
+        properties: layoutTypeDescriptors.templateProperties,
+        diagnostics: diagnostics$1
+    };
+    if (layoutTypes.has(record.typeId)) {
+        const descriptor = DescriptorCatalog.findLayoutTypeDescriptor(catalog, record.typeId);
+        return {
+            properties: descriptor?.properties ?? [],
+            capabilities: descriptor?.capabilities,
+            diagnostics: diagnostics$1
+        };
+    }
+    if (record.kind === scene_model.SceneNodeKind.Element && record.value.componentName !== undefined) {
+        const descriptor = DescriptorCatalog.findComponentDescriptor(catalog, record.typeId);
+        if (!descriptor) {
+            diagnostics$1.push(diagnostics.warningDiagnostic(scene_model.DiagnosticCode.MissingComponentDescriptor, `Nothing describes the component '${record.typeId}', so none of its properties can be edited.`, {
+                nodeId: record.id
+            }));
+        }
+        return {
+            properties: descriptor?.properties ?? [],
+            diagnostics: diagnostics$1
+        };
+    }
+    return {
+        properties: [],
+        diagnostics: diagnostics$1
+    };
+}
+/**
+ * Reads a descriptor's value from a node: from the property bag of a component, from the node itself otherwise.
+ */ function readNodeValue(record, path) {
+    const value = record.value;
+    const isComponent = record.kind === scene_model.SceneNodeKind.Element && value.componentName !== undefined;
+    return pathAccess.getValueAtPath(isComponent ? value.properties : value, path);
+}
+
+exports.describeNode = describeNode;
+exports.readNodeValue = readNodeValue;
+//# sourceMappingURL=describeNode.js.map

package/dist/cjs/editing/describeNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeNode.js","sources":["../../../editing/describeNode.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport {\n    DiagnosticCode, LayoutCapabilities, LayoutType, PropertyDescriptor, SceneDiagnostic, SceneNodeKind,\n} from '@cratis/scene.model';\nimport { DescriptorCatalog, findComponentDescriptor, findLayoutTypeDescriptor } from './DescriptorCatalog';\nimport { NodeRecord } from './DocumentIndex';\nimport { warningDiagnostic } from './diagnostics';\nimport { getValueAtPath } from './pathAccess';\nimport { placementProperties, templateProperties } from './layoutTypeDescriptors';\n\n/**\n * What describes a node: its editable properties, and for a layout node what the type can do.\n */\nexport interface NodeDescription {\n    properties: PropertyDescriptor[];\n    capabilities?: LayoutCapabilities;\n    diagnostics: SceneDiagnostic[];\n}\n\nconst layoutTypes = new Set<string>(Object.values(LayoutType));\n\n/**\n * Works out which descriptors apply to a node.\n *\n * A component takes its descriptor from the catalog by the name it carries; a layout node takes its layout type's;\n * a placement and a template have their own fixed sets. A component nothing describes has no editable\n * properties, and says so rather than failing.\n */\nexport function describeNode(record: NodeRecord, catalog: DescriptorCatalog): NodeDescription {\n    const diagnostics: SceneDiagnostic[] = [];\n\n    if (record.kind === SceneNodeKind.Placement) return { properties: placementProperties, diagnostics };\n    if (record.kind === SceneNodeKind.ScreenTemplate || record.kind === SceneNodeKind.DialogTemplate) return { properties: templateProperties, diagnostics };\n\n    if (layoutTypes.has(record.typeId)) {\n        const descriptor = findLayoutTypeDescriptor(catalog, record.typeId);\n        return { properties: descriptor?.properties ?? [], capabilities: descriptor?.capabilities, diagnostics };\n    }\n\n    if (record.kind === SceneNodeKind.Element && (record.value as { componentName?: unknown }).componentName !== undefined) {\n        const descriptor = findComponentDescriptor(catalog, record.typeId);\n        if (!descriptor) {\n            diagnostics.push(warningDiagnostic(DiagnosticCode.MissingComponentDescriptor, `Nothing describes the component '${record.typeId}', so none of its properties can be edited.`, { nodeId: record.id }));\n        }\n\n        return { properties: descriptor?.properties ?? [], diagnostics };\n    }\n\n    return { properties: [], diagnostics };\n}\n\n/**\n * Reads a descriptor's value from a node: from the property bag of a component, from the node itself otherwise.\n */\nexport function readNodeValue(record: NodeRecord, path: string): unknown {\n    const value = record.value as Record<string, unknown>;\n    const isComponent = record.kind === SceneNodeKind.Element && value.componentName !== undefined;\n    return getValueAtPath(isComponent ? (value.properties as Record<string, unknown>) : value, path);\n}\n"],"names":["layoutTypes","Set","Object","values","LayoutType","describeNode","record","catalog","diagnostics","kind","SceneNodeKind","Placement","properties","placementProperties","ScreenTemplate","DialogTemplate","templateProperties","has","typeId","descriptor","findLayoutTypeDescriptor","capabilities","Element","value","componentName","undefined","findComponentDescriptor","push","warningDiagnostic","DiagnosticCode","MissingComponentDescriptor","nodeId","id","readNodeValue","path","isComponent","getValueAtPath"],"mappings":";;;;;;;;AAAA;AACA;AAoBA,MAAMA,WAAAA,GAAc,IAAIC,GAAAA,CAAYC,MAAAA,CAAOC,MAAM,CAACC,sBAAAA,CAAAA,CAAAA;AAElD;;;;;;AAMC,IACM,SAASC,YAAAA,CAAaC,MAAkB,EAAEC,OAA0B,EAAA;AACvE,IAAA,MAAMC,gBAAiC,EAAE;AAEzC,IAAA,IAAIF,OAAOG,IAAI,KAAKC,yBAAAA,CAAcC,SAAS,EAAE,OAAO;QAAEC,UAAAA,EAAYC,yCAAAA;AAAqBL,qBAAAA;AAAY,KAAA;AACnG,IAAA,IAAIF,MAAAA,CAAOG,IAAI,KAAKC,yBAAAA,CAAcI,cAAc,IAAIR,MAAAA,CAAOG,IAAI,KAAKC,yBAAAA,CAAcK,cAAc,EAAE,OAAO;QAAEH,UAAAA,EAAYI,wCAAAA;AAAoBR,qBAAAA;AAAY,KAAA;AAEvJ,IAAA,IAAIR,WAAAA,CAAYiB,GAAG,CAACX,MAAAA,CAAOY,MAAM,CAAA,EAAG;AAChC,QAAA,MAAMC,UAAAA,GAAaC,0CAAAA,CAAyBb,OAAAA,EAASD,MAAAA,CAAOY,MAAM,CAAA;QAClE,OAAO;YAAEN,UAAAA,EAAYO,UAAAA,EAAYP,cAAc,EAAE;AAAES,YAAAA,YAAAA,EAAcF,UAAAA,EAAYE,YAAAA;AAAcb,yBAAAA;AAAY,SAAA;AAC3G,IAAA;AAEA,IAAA,IAAIF,MAAAA,CAAOG,IAAI,KAAKC,yBAAAA,CAAcY,OAAO,IAAI,MAAChB,CAAOiB,KAAK,CAAiCC,aAAa,KAAKC,SAAAA,EAAW;AACpH,QAAA,MAAMN,UAAAA,GAAaO,yCAAAA,CAAwBnB,OAAAA,EAASD,MAAAA,CAAOY,MAAM,CAAA;AACjE,QAAA,IAAI,CAACC,UAAAA,EAAY;AACbX,YAAAA,aAAAA,CAAYmB,IAAI,CAACC,6BAAAA,CAAkBC,0BAAAA,CAAeC,0BAA0B,EAAE,CAAC,iCAAiC,EAAExB,MAAAA,CAAOY,MAAM,CAAC,2CAA2C,CAAC,EAAE;AAAEa,gBAAAA,MAAAA,EAAQzB,OAAO0B;AAAG,aAAA,CAAA,CAAA;AACtM,QAAA;QAEA,OAAO;YAAEpB,UAAAA,EAAYO,UAAAA,EAAYP,cAAc,EAAE;AAAEJ,yBAAAA;AAAY,SAAA;AACnE,IAAA;IAEA,OAAO;AAAEI,QAAAA,UAAAA,EAAY,EAAE;AAAEJ,qBAAAA;AAAY,KAAA;AACzC;AAEA;;AAEC,IACM,SAASyB,aAAAA,CAAc3B,MAAkB,EAAE4B,IAAY,EAAA;IAC1D,MAAMX,KAAAA,GAAQjB,OAAOiB,KAAK;IAC1B,MAAMY,WAAAA,GAAc7B,OAAOG,IAAI,KAAKC,0BAAcY,OAAO,IAAIC,KAAAA,CAAMC,aAAa,KAAKC,SAAAA;AACrF,IAAA,OAAOW,yBAAAA,CAAeD,WAAAA,GAAeZ,KAAAA,CAAMX,UAAU,GAA+BW,KAAAA,EAAOW,IAAAA,CAAAA;AAC/F;;;"}

package/dist/cjs/editing/diagnoseIcons.js

@@ -0,0 +1,67 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var DescriptorCatalog = require('./DescriptorCatalog.js');
+var iconDiagnostics = require('./iconDiagnostics.js');
+var pathAccess = require('./pathAccess.js');
+var resolveEffectiveConfiguration = require('./resolveEffectiveConfiguration.js');
+var resolveTemplateChain = require('./resolveTemplateChain.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function isIconBearing(property) {
+    return property.valueType === scene_model.PropertyValueType.Icon || property.valueType === scene_model.PropertyValueType.Collection && (property.item?.properties ?? []).some((field)=>field.valueType === scene_model.PropertyValueType.Icon);
+}
+/**
+ * Reports every icon in what the editing scope renders - the template chain's own values and what each instance
+ * contributed - that the profile's icon catalog cannot supply: a library the profile lacks, an icon or variant a
+ * library no longer has, a library at an incompatible version.
+ *
+ * It reports; it never changes anything. The offending values stay in the document, still applied (a renderer
+ * shows its fallback), and apply again as soon as the icon is available, so removing a library is reversible.
+ * Each diagnostic names the component, property, collection item and - for a contributed value - the instance.
+ *
+ * Returns nothing when the context carries no `iconCatalog`. Load the catalogs first (`iconCatalog.load()`) for
+ * definite answers; an icon from an unloaded library is reported as not verified.
+ */ function diagnoseIcons(document, context) {
+    const iconCatalog = context.iconCatalog;
+    if (!iconCatalog) return [];
+    const chain = resolveTemplateChain.resolveTemplateChain(document, context.scope);
+    const configuration = resolveEffectiveConfiguration.resolveEffectiveConfiguration(chain, document.instanceContributions, context.catalog);
+    const diagnostics = [];
+    for (const level of chain.levels){
+        for (const element of level.elements){
+            const descriptor = DescriptorCatalog.findComponentDescriptor(context.catalog, element.componentName);
+            const configured = configuration.components.find((candidate)=>candidate.component === element.id);
+            for (const property of (descriptor?.properties ?? []).filter(isIconBearing)){
+                const effective = configured?.values.find((candidate)=>candidate.path === property.path);
+                const where = {
+                    component: element.id,
+                    ...effective?.contributedBy === undefined ? {} : {
+                        instance: effective.contributedBy
+                    }
+                };
+                if (property.valueType === scene_model.PropertyValueType.Icon) {
+                    const value = effective ? effective.value : pathAccess.getValueAtPath(element.properties, property.path);
+                    diagnostics.push(...iconDiagnostics.iconProblemsOfProperty(iconCatalog, property, value, scene_model.DiagnosticSeverity.Warning, where));
+                } else if (effective?.items) {
+                    const items = effective.items.map((item)=>({
+                            id: item.id,
+                            values: item.values,
+                            instance: item.origin === 'owner' ? undefined : item.origin
+                        }));
+                    diagnostics.push(...iconDiagnostics.iconProblemsOfItems(iconCatalog, property.item, items, scene_model.DiagnosticSeverity.Warning, {
+                        component: element.id,
+                        path: property.path
+                    }));
+                } else {
+                    diagnostics.push(...iconDiagnostics.iconProblemsOfProperty(iconCatalog, property, pathAccess.getValueAtPath(element.properties, property.path), scene_model.DiagnosticSeverity.Warning, where));
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+
+exports.diagnoseIcons = diagnoseIcons;
+//# sourceMappingURL=diagnoseIcons.js.map

package/dist/cjs/editing/diagnoseIcons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoseIcons.js","sources":["../../../editing/diagnoseIcons.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { DiagnosticSeverity, PropertyDescriptor, PropertyValueType, SceneDiagnostic, SceneDocument } from '@cratis/scene.model';\nimport { findComponentDescriptor } from './DescriptorCatalog';\nimport { EditingContext } from './EditingContext';\nimport { iconProblemsOfItems, iconProblemsOfProperty } from './iconDiagnostics';\nimport { getValueAtPath } from './pathAccess';\nimport { resolveEffectiveConfiguration } from './resolveEffectiveConfiguration';\nimport { resolveTemplateChain } from './resolveTemplateChain';\n\nfunction isIconBearing(property: PropertyDescriptor): boolean {\n    return property.valueType === PropertyValueType.Icon\n        || (property.valueType === PropertyValueType.Collection && (property.item?.properties ?? []).some((field) => field.valueType === PropertyValueType.Icon));\n}\n\n/**\n * Reports every icon in what the editing scope renders - the template chain's own values and what each instance\n * contributed - that the profile's icon catalog cannot supply: a library the profile lacks, an icon or variant a\n * library no longer has, a library at an incompatible version.\n *\n * It reports; it never changes anything. The offending values stay in the document, still applied (a renderer\n * shows its fallback), and apply again as soon as the icon is available, so removing a library is reversible.\n * Each diagnostic names the component, property, collection item and - for a contributed value - the instance.\n *\n * Returns nothing when the context carries no `iconCatalog`. Load the catalogs first (`iconCatalog.load()`) for\n * definite answers; an icon from an unloaded library is reported as not verified.\n */\nexport function diagnoseIcons(document: SceneDocument, context: EditingContext): SceneDiagnostic[] {\n    const iconCatalog = context.iconCatalog;\n    if (!iconCatalog) return [];\n\n    const chain = resolveTemplateChain(document, context.scope);\n    const configuration = resolveEffectiveConfiguration(chain, document.instanceContributions, context.catalog);\n    const diagnostics: SceneDiagnostic[] = [];\n\n    for (const level of chain.levels) {\n        for (const element of level.elements) {\n            const descriptor = findComponentDescriptor(context.catalog, element.componentName);\n            const configured = configuration.components.find((candidate) => candidate.component === element.id);\n\n            for (const property of (descriptor?.properties ?? []).filter(isIconBearing)) {\n                const effective = configured?.values.find((candidate) => candidate.path === property.path);\n                const where = { component: element.id, ...(effective?.contributedBy === undefined ? {} : { instance: effective.contributedBy }) };\n\n                if (property.valueType === PropertyValueType.Icon) {\n                    const value = effective ? effective.value : getValueAtPath(element.properties, property.path);\n                    diagnostics.push(...iconProblemsOfProperty(iconCatalog, property, value, DiagnosticSeverity.Warning, where));\n                } else if (effective?.items) {\n                    const items = effective.items.map((item) => ({ id: item.id, values: item.values, instance: item.origin === 'owner' ? undefined : item.origin }));\n                    diagnostics.push(...iconProblemsOfItems(iconCatalog, property.item, items, DiagnosticSeverity.Warning, { component: element.id, path: property.path }));\n                } else {\n                    diagnostics.push(...iconProblemsOfProperty(iconCatalog, property, getValueAtPath(element.properties, property.path), DiagnosticSeverity.Warning, where));\n                }\n            }\n        }\n    }\n\n    return diagnostics;\n}\n"],"names":["isIconBearing","property","valueType","PropertyValueType","Icon","Collection","item","properties","some","field","diagnoseIcons","document","context","iconCatalog","chain","resolveTemplateChain","scope","configuration","resolveEffectiveConfiguration","instanceContributions","catalog","diagnostics","level","levels","element","elements","descriptor","findComponentDescriptor","componentName","configured","components","find","candidate","component","id","filter","effective","values","path","where","contributedBy","undefined","instance","value","getValueAtPath","push","iconProblemsOfProperty","DiagnosticSeverity","Warning","items","map","origin","iconProblemsOfItems"],"mappings":";;;;;;;;;AAAA;AACA;AAUA,SAASA,cAAcC,QAA4B,EAAA;AAC/C,IAAA,OAAOA,QAAAA,CAASC,SAAS,KAAKC,6BAAAA,CAAkBC,IAAI,IAC5CH,QAAAA,CAASC,SAAS,KAAKC,6BAAAA,CAAkBE,UAAU,IAAI,CAACJ,QAAAA,CAASK,IAAI,EAAEC,UAAAA,IAAc,EAAC,EAAGC,IAAI,CAAC,CAACC,KAAAA,GAAUA,KAAAA,CAAMP,SAAS,KAAKC,8BAAkBC,IAAI,CAAA;AAC/J;AAEA;;;;;;;;;;;AAWC,IACM,SAASM,aAAAA,CAAcC,QAAuB,EAAEC,OAAuB,EAAA;IAC1E,MAAMC,WAAAA,GAAcD,QAAQC,WAAW;IACvC,IAAI,CAACA,WAAAA,EAAa,OAAO,EAAE;AAE3B,IAAA,MAAMC,KAAAA,GAAQC,yCAAAA,CAAqBJ,QAAAA,EAAUC,OAAAA,CAAQI,KAAK,CAAA;AAC1D,IAAA,MAAMC,gBAAgBC,2DAAAA,CAA8BJ,KAAAA,EAAOH,SAASQ,qBAAqB,EAAEP,QAAQQ,OAAO,CAAA;AAC1G,IAAA,MAAMC,cAAiC,EAAE;AAEzC,IAAA,KAAK,MAAMC,KAAAA,IAASR,KAAAA,CAAMS,MAAM,CAAE;AAC9B,QAAA,KAAK,MAAMC,OAAAA,IAAWF,KAAAA,CAAMG,QAAQ,CAAE;AAClC,YAAA,MAAMC,aAAaC,yCAAAA,CAAwBf,OAAAA,CAAQQ,OAAO,EAAEI,QAAQI,aAAa,CAAA;AACjF,YAAA,MAAMC,UAAAA,GAAaZ,aAAAA,CAAca,UAAU,CAACC,IAAI,CAAC,CAACC,SAAAA,GAAcA,SAAAA,CAAUC,SAAS,KAAKT,OAAAA,CAAQU,EAAE,CAAA;YAElG,KAAK,MAAMjC,QAAAA,IAAayB,CAAAA,UAAAA,EAAYnB,UAAAA,IAAc,EAAE,EAAE4B,MAAM,CAACnC,aAAAA,CAAAA,CAAgB;gBACzE,MAAMoC,SAAAA,GAAYP,UAAAA,EAAYQ,MAAAA,CAAON,IAAAA,CAAK,CAACC,YAAcA,SAAAA,CAAUM,IAAI,KAAKrC,QAAAA,CAASqC,IAAI,CAAA;AACzF,gBAAA,MAAMC,KAAAA,GAAQ;AAAEN,oBAAAA,SAAAA,EAAWT,QAAQU,EAAE;AAAE,oBAAA,GAAIE,SAAAA,EAAWI,aAAAA,KAAkBC,SAAAA,GAAY,EAAC,GAAI;AAAEC,wBAAAA,QAAAA,EAAUN,UAAUI;;AAAiB,iBAAA;AAEhI,gBAAA,IAAIvC,QAAAA,CAASC,SAAS,KAAKC,6BAAAA,CAAkBC,IAAI,EAAE;oBAC/C,MAAMuC,KAAAA,GAAQP,SAAAA,GAAYA,SAAAA,CAAUO,KAAK,GAAGC,0BAAepB,OAAAA,CAAQjB,UAAU,EAAEN,QAAAA,CAASqC,IAAI,CAAA;oBAC5FjB,WAAAA,CAAYwB,IAAI,IAAIC,sCAAAA,CAAuBjC,WAAAA,EAAaZ,UAAU0C,KAAAA,EAAOI,8BAAAA,CAAmBC,OAAO,EAAET,KAAAA,CAAAA,CAAAA;gBACzG,CAAA,MAAO,IAAIH,WAAWa,KAAAA,EAAO;oBACzB,MAAMA,KAAAA,GAAQb,UAAUa,KAAK,CAACC,GAAG,CAAC,CAAC5C,QAAU;AAAE4B,4BAAAA,EAAAA,EAAI5B,KAAK4B,EAAE;AAAEG,4BAAAA,MAAAA,EAAQ/B,KAAK+B,MAAM;AAAEK,4BAAAA,QAAAA,EAAUpC,KAAK6C,MAAM,KAAK,OAAA,GAAUV,SAAAA,GAAYnC,KAAK6C;yBAAO,CAAA,CAAA;oBAC7I9B,WAAAA,CAAYwB,IAAI,CAAA,GAAIO,mCAAAA,CAAoBvC,WAAAA,EAAaZ,QAAAA,CAASK,IAAI,EAAE2C,KAAAA,EAAOF,8BAAAA,CAAmBC,OAAO,EAAE;AAAEf,wBAAAA,SAAAA,EAAWT,QAAQU,EAAE;AAAEI,wBAAAA,IAAAA,EAAMrC,SAASqC;AAAK,qBAAA,CAAA,CAAA;gBACxJ,CAAA,MAAO;AACHjB,oBAAAA,WAAAA,CAAYwB,IAAI,CAAA,GAAIC,sCAAAA,CAAuBjC,WAAAA,EAAaZ,UAAU2C,yBAAAA,CAAepB,OAAAA,CAAQjB,UAAU,EAAEN,QAAAA,CAASqC,IAAI,CAAA,EAAGS,8BAAAA,CAAmBC,OAAO,EAAET,KAAAA,CAAAA,CAAAA;AACrJ,gBAAA;AACJ,YAAA;AACJ,QAAA;AACJ,IAAA;IAEA,OAAOlB,WAAAA;AACX;;"}