@cratis/scene.engine 4.2.0 → 4.3.0

package/dist/esm/editing/applyEffectiveConfiguration.js

@@ -0,0 +1,60 @@
+import { isExternalComponent, isContentControl, isItemsControl, isPanel } from '../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 (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 (isContentControl(element)) {
+        const content = applyEffectiveConfiguration(element.content, configuration);
+        const updated = {
+            ...element,
+            content
+        };
+        return content === element.content ? element : updated;
+    }
+    if (isItemsControl(element)) {
+        const itemTemplate = applyEffectiveConfiguration(element.itemTemplate, configuration);
+        const updated = {
+            ...element,
+            itemTemplate
+        };
+        return itemTemplate === element.itemTemplate ? element : updated;
+    }
+    if (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;
+}
+
+export { applyEffectiveConfiguration };
+//# sourceMappingURL=applyEffectiveConfiguration.js.map

package/dist/esm/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,oBAAoBF,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,iBAAiBvB,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,eAAezB,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,QAAQ3B,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/esm/editing/collectComponents.d.ts

@@ -0,0 +1,3 @@
+import { ExternalComponent } from '@cratis/scene.model';
+export declare function collectComponents(owner: unknown): ExternalComponent[];
+//# sourceMappingURL=collectComponents.d.ts.map

package/dist/esm/editing/collectComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectComponents.d.ts","sourceRoot":"","sources":["../../../editing/collectComponents.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAgBxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAgBrE"}

package/dist/esm/editing/collectComponents.js

@@ -0,0 +1,32 @@
+// 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()
+    ];
+}
+
+export { collectComponents };
+//# sourceMappingURL=collectComponents.js.map

package/dist/esm/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/esm/editing/describeNode.d.ts

@@ -0,0 +1,11 @@
+import { LayoutCapabilities, PropertyDescriptor, SceneDiagnostic } from '@cratis/scene.model';
+import { DescriptorCatalog } from './DescriptorCatalog';
+import { NodeRecord } from './DocumentIndex';
+export interface NodeDescription {
+    properties: PropertyDescriptor[];
+    capabilities?: LayoutCapabilities;
+    diagnostics: SceneDiagnostic[];
+}
+export declare function describeNode(record: NodeRecord, catalog: DescriptorCatalog): NodeDescription;
+export declare function readNodeValue(record: NodeRecord, path: string): unknown;
+//# sourceMappingURL=describeNode.d.ts.map

package/dist/esm/editing/describeNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeNode.d.ts","sourceRoot":"","sources":["../../../editing/describeNode.ts"],"names":[],"mappings":"AAGA,OAAO,EACa,kBAAkB,EAAc,kBAAkB,EAAE,eAAe,EACtF,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAqD,MAAM,qBAAqB,CAAC;AAC3G,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQ7C,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,eAAe,EAAE,CAAC;CAClC;AAWD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,GAAG,eAAe,CAqB5F;AAKD,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvE"}

package/dist/esm/editing/describeNode.js

@@ -0,0 +1,60 @@
+import { LayoutType, SceneNodeKind, DiagnosticCode } from '@cratis/scene.model';
+import { findLayoutTypeDescriptor, findComponentDescriptor } from './DescriptorCatalog.js';
+import { warningDiagnostic } from './diagnostics.js';
+import { getValueAtPath } from './pathAccess.js';
+import { placementProperties, templateProperties } from './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(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 = [];
+    if (record.kind === SceneNodeKind.Placement) return {
+        properties: placementProperties,
+        diagnostics
+    };
+    if (record.kind === SceneNodeKind.ScreenTemplate || record.kind === SceneNodeKind.DialogTemplate) return {
+        properties: templateProperties,
+        diagnostics
+    };
+    if (layoutTypes.has(record.typeId)) {
+        const descriptor = findLayoutTypeDescriptor(catalog, record.typeId);
+        return {
+            properties: descriptor?.properties ?? [],
+            capabilities: descriptor?.capabilities,
+            diagnostics
+        };
+    }
+    if (record.kind === SceneNodeKind.Element && record.value.componentName !== undefined) {
+        const descriptor = findComponentDescriptor(catalog, record.typeId);
+        if (!descriptor) {
+            diagnostics.push(warningDiagnostic(DiagnosticCode.MissingComponentDescriptor, `Nothing describes the component '${record.typeId}', so none of its properties can be edited.`, {
+                nodeId: record.id
+            }));
+        }
+        return {
+            properties: descriptor?.properties ?? [],
+            diagnostics
+        };
+    }
+    return {
+        properties: [],
+        diagnostics
+    };
+}
+/**
+ * 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 === SceneNodeKind.Element && value.componentName !== undefined;
+    return getValueAtPath(isComponent ? value.properties : value, path);
+}
+
+export { describeNode, readNodeValue };
+//# sourceMappingURL=describeNode.js.map

package/dist/esm/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,UAAAA,CAAAA,CAAAA;AAElD;;;;;;AAMC,IACM,SAASC,YAAAA,CAAaC,MAAkB,EAAEC,OAA0B,EAAA;AACvE,IAAA,MAAMC,cAAiC,EAAE;AAEzC,IAAA,IAAIF,OAAOG,IAAI,KAAKC,aAAAA,CAAcC,SAAS,EAAE,OAAO;QAAEC,UAAAA,EAAYC,mBAAAA;AAAqBL,QAAAA;AAAY,KAAA;AACnG,IAAA,IAAIF,MAAAA,CAAOG,IAAI,KAAKC,aAAAA,CAAcI,cAAc,IAAIR,MAAAA,CAAOG,IAAI,KAAKC,aAAAA,CAAcK,cAAc,EAAE,OAAO;QAAEH,UAAAA,EAAYI,kBAAAA;AAAoBR,QAAAA;AAAY,KAAA;AAEvJ,IAAA,IAAIR,WAAAA,CAAYiB,GAAG,CAACX,MAAAA,CAAOY,MAAM,CAAA,EAAG;AAChC,QAAA,MAAMC,UAAAA,GAAaC,wBAAAA,CAAyBb,OAAAA,EAASD,MAAAA,CAAOY,MAAM,CAAA;QAClE,OAAO;YAAEN,UAAAA,EAAYO,UAAAA,EAAYP,cAAc,EAAE;AAAES,YAAAA,YAAAA,EAAcF,UAAAA,EAAYE,YAAAA;AAAcb,YAAAA;AAAY,SAAA;AAC3G,IAAA;AAEA,IAAA,IAAIF,MAAAA,CAAOG,IAAI,KAAKC,aAAAA,CAAcY,OAAO,IAAI,MAAChB,CAAOiB,KAAK,CAAiCC,aAAa,KAAKC,SAAAA,EAAW;AACpH,QAAA,MAAMN,UAAAA,GAAaO,uBAAAA,CAAwBnB,OAAAA,EAASD,MAAAA,CAAOY,MAAM,CAAA;AACjE,QAAA,IAAI,CAACC,UAAAA,EAAY;AACbX,YAAAA,WAAAA,CAAYmB,IAAI,CAACC,iBAAAA,CAAkBC,cAAAA,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,YAAAA;AAAY,SAAA;AACnE,IAAA;IAEA,OAAO;AAAEI,QAAAA,UAAAA,EAAY,EAAE;AAAEJ,QAAAA;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,cAAcY,OAAO,IAAIC,KAAAA,CAAMC,aAAa,KAAKC,SAAAA;AACrF,IAAA,OAAOW,cAAAA,CAAeD,WAAAA,GAAeZ,KAAAA,CAAMX,UAAU,GAA+BW,KAAAA,EAAOW,IAAAA,CAAAA;AAC/F;;"}

package/dist/esm/editing/diagnostics.d.ts

@@ -0,0 +1,6 @@
+import { DiagnosticCode, SceneDiagnostic } from '@cratis/scene.model';
+export type DiagnosticContext = Partial<Omit<SceneDiagnostic, 'code' | 'severity' | 'message'>>;
+export declare function errorDiagnostic(code: DiagnosticCode, message: string, context?: DiagnosticContext): SceneDiagnostic;
+export declare function warningDiagnostic(code: DiagnosticCode, message: string, context?: DiagnosticContext): SceneDiagnostic;
+export declare function hasErrors(diagnostics: SceneDiagnostic[]): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/esm/editing/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../editing/diagnostics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAsB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK1F,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC;AAKhG,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,eAAe,CAEvH;AAKD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,eAAe,CAEzH;AAKD,wBAAgB,SAAS,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,OAAO,CAEjE"}

package/dist/esm/editing/diagnostics.js

@@ -0,0 +1,32 @@
+import { DiagnosticSeverity } from '@cratis/scene.model';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Builds an error diagnostic: the edit or resolution step that produced it did not happen.
+ */ function errorDiagnostic(code, message, context = {}) {
+    return {
+        code,
+        severity: DiagnosticSeverity.Error,
+        message,
+        ...context
+    };
+}
+/**
+ * Builds a warning diagnostic: the work went ahead, and the author should know something about it.
+ */ function warningDiagnostic(code, message, context = {}) {
+    return {
+        code,
+        severity: DiagnosticSeverity.Warning,
+        message,
+        ...context
+    };
+}
+/**
+ * Whether any diagnostic is an error.
+ */ function hasErrors(diagnostics) {
+    return diagnostics.some((diagnostic)=>diagnostic.severity === DiagnosticSeverity.Error);
+}
+
+export { errorDiagnostic, hasErrors, warningDiagnostic };
+//# sourceMappingURL=diagnostics.js.map

package/dist/esm/editing/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sources":["../../../editing/diagnostics.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, DiagnosticSeverity, SceneDiagnostic } from '@cratis/scene.model';\n\n/**\n * The context a diagnostic can carry besides its code and message.\n */\nexport type DiagnosticContext = Partial<Omit<SceneDiagnostic, 'code' | 'severity' | 'message'>>;\n\n/**\n * Builds an error diagnostic: the edit or resolution step that produced it did not happen.\n */\nexport function errorDiagnostic(code: DiagnosticCode, message: string, context: DiagnosticContext = {}): SceneDiagnostic {\n    return { code, severity: DiagnosticSeverity.Error, message, ...context };\n}\n\n/**\n * Builds a warning diagnostic: the work went ahead, and the author should know something about it.\n */\nexport function warningDiagnostic(code: DiagnosticCode, message: string, context: DiagnosticContext = {}): SceneDiagnostic {\n    return { code, severity: DiagnosticSeverity.Warning, message, ...context };\n}\n\n/**\n * Whether any diagnostic is an error.\n */\nexport function hasErrors(diagnostics: SceneDiagnostic[]): boolean {\n    return diagnostics.some(diagnostic => diagnostic.severity === DiagnosticSeverity.Error);\n}\n"],"names":["errorDiagnostic","code","message","context","severity","DiagnosticSeverity","Error","warningDiagnostic","Warning","hasErrors","diagnostics","some","diagnostic"],"mappings":";;AAAA;AACA;AASA;;IAGO,SAASA,eAAAA,CAAgBC,IAAoB,EAAEC,OAAe,EAAEC,OAAAA,GAA6B,EAAE,EAAA;IAClG,OAAO;AAAEF,QAAAA,IAAAA;AAAMG,QAAAA,QAAAA,EAAUC,mBAAmBC,KAAK;AAAEJ,QAAAA,OAAAA;AAAS,QAAA,GAAGC;AAAQ,KAAA;AAC3E;AAEA;;IAGO,SAASI,iBAAAA,CAAkBN,IAAoB,EAAEC,OAAe,EAAEC,OAAAA,GAA6B,EAAE,EAAA;IACpG,OAAO;AAAEF,QAAAA,IAAAA;AAAMG,QAAAA,QAAAA,EAAUC,mBAAmBG,OAAO;AAAEN,QAAAA,OAAAA;AAAS,QAAA,GAAGC;AAAQ,KAAA;AAC7E;AAEA;;IAGO,SAASM,SAAAA,CAAUC,WAA8B,EAAA;IACpD,OAAOA,WAAAA,CAAYC,IAAI,CAACC,CAAAA,aAAcA,UAAAA,CAAWR,QAAQ,KAAKC,kBAAAA,CAAmBC,KAAK,CAAA;AAC1F;;"}

package/dist/esm/editing/documentPaths.d.ts

@@ -0,0 +1,8 @@
+import { DocumentPath } from './DocumentIndex';
+export declare function getAtPath(root: unknown, path: DocumentPath): unknown;
+export declare function ensureArrayAt(root: unknown, path: DocumentPath): unknown[];
+export declare function mirroredPaths(mirror: {
+    prefix: DocumentPath;
+    others: DocumentPath[];
+} | undefined, path: DocumentPath): DocumentPath[];
+//# sourceMappingURL=documentPaths.d.ts.map

package/dist/esm/editing/documentPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentPaths.d.ts","sourceRoot":"","sources":["../../../editing/documentPaths.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAQpE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,EAAE,CAQ1E;AAMD,wBAAgB,aAAa,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,EAAE,CAGtI"}

package/dist/esm/editing/documentPaths.js

@@ -0,0 +1,41 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Reads the value at a document path.
+ */ function getAtPath(root, path) {
+    let current = root;
+    for (const key of path){
+        if (current === null || typeof current !== 'object') return undefined;
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Reads the array at a path, creating it - and any objects on the way - when it is not there yet. Mutates `root`,
+ * which callers hold a copy of.
+ */ function ensureArrayAt(root, path) {
+    let current = root;
+    path.forEach((key, position)=>{
+        if (current[key] === undefined) current[key] = position === path.length - 1 ? [] : {};
+        current = current[key];
+    });
+    return current;
+}
+/**
+ * The paths a change to `path` must be made at: the path itself and, for a node inside a freeform element, the same
+ * place in every other size-class variant's copy.
+ */ function mirroredPaths(mirror, path) {
+    if (!mirror || mirror.prefix.some((key, position)=>path[position] !== key)) return [
+        path
+    ];
+    return [
+        path,
+        ...mirror.others.map((other)=>[
+                ...other,
+                ...path.slice(mirror.prefix.length)
+            ])
+    ];
+}
+
+export { ensureArrayAt, getAtPath, mirroredPaths };
+//# sourceMappingURL=documentPaths.js.map

package/dist/esm/editing/documentPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentPaths.js","sources":["../../../editing/documentPaths.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 { DocumentPath } from './DocumentIndex';\n\n/**\n * Reads the value at a document path.\n */\nexport function getAtPath(root: unknown, path: DocumentPath): unknown {\n    let current = root;\n    for (const key of path) {\n        if (current === null || typeof current !== 'object') return undefined;\n        current = (current as Record<string | number, unknown>)[key];\n    }\n\n    return current;\n}\n\n/**\n * Reads the array at a path, creating it - and any objects on the way - when it is not there yet. Mutates `root`,\n * which callers hold a copy of.\n */\nexport function ensureArrayAt(root: unknown, path: DocumentPath): unknown[] {\n    let current = root as Record<string | number, unknown>;\n    path.forEach((key, position) => {\n        if (current[key] === undefined) current[key] = position === path.length - 1 ? [] : {};\n        current = current[key] as Record<string | number, unknown>;\n    });\n\n    return current as unknown as unknown[];\n}\n\n/**\n * The paths a change to `path` must be made at: the path itself and, for a node inside a freeform element, the same\n * place in every other size-class variant's copy.\n */\nexport function mirroredPaths(mirror: { prefix: DocumentPath; others: DocumentPath[] } | undefined, path: DocumentPath): DocumentPath[] {\n    if (!mirror || mirror.prefix.some((key, position) => path[position] !== key)) return [path];\n    return [path, ...mirror.others.map(other => [...other, ...path.slice(mirror.prefix.length)])];\n}\n"],"names":["getAtPath","root","path","current","key","undefined","ensureArrayAt","forEach","position","length","mirroredPaths","mirror","prefix","some","others","map","other","slice"],"mappings":"AAAA;AACA;AAIA;;AAEC,IACM,SAASA,SAAAA,CAAUC,IAAa,EAAEC,IAAkB,EAAA;AACvD,IAAA,IAAIC,OAAAA,GAAUF,IAAAA;IACd,KAAK,MAAMG,OAAOF,IAAAA,CAAM;AACpB,QAAA,IAAIC,OAAAA,KAAY,IAAA,IAAQ,OAAOA,OAAAA,KAAY,UAAU,OAAOE,SAAAA;QAC5DF,OAAAA,GAAWA,OAA4C,CAACC,GAAAA,CAAI;AAChE,IAAA;IAEA,OAAOD,OAAAA;AACX;AAEA;;;AAGC,IACM,SAASG,aAAAA,CAAcL,IAAa,EAAEC,IAAkB,EAAA;AAC3D,IAAA,IAAIC,OAAAA,GAAUF,IAAAA;IACdC,IAAAA,CAAKK,OAAO,CAAC,CAACH,GAAAA,EAAKI,QAAAA,GAAAA;AACf,QAAA,IAAIL,OAAO,CAACC,GAAAA,CAAI,KAAKC,SAAAA,EAAWF,OAAO,CAACC,GAAAA,CAAI,GAAGI,QAAAA,KAAaN,KAAKO,MAAM,GAAG,CAAA,GAAI,EAAE,GAAG,EAAC;QACpFN,OAAAA,GAAUA,OAAO,CAACC,GAAAA,CAAI;AAC1B,IAAA,CAAA,CAAA;IAEA,OAAOD,OAAAA;AACX;AAEA;;;AAGC,IACM,SAASO,aAAAA,CAAcC,MAAoE,EAAET,IAAkB,EAAA;AAClH,IAAA,IAAI,CAACS,MAAAA,IAAUA,MAAAA,CAAOC,MAAM,CAACC,IAAI,CAAC,CAACT,GAAAA,EAAKI,WAAaN,IAAI,CAACM,QAAAA,CAAS,KAAKJ,MAAM,OAAO;AAACF,QAAAA;AAAK,KAAA;IAC3F,OAAO;AAACA,QAAAA,IAAAA;AAASS,QAAAA,GAAAA,MAAAA,CAAOG,MAAM,CAACC,GAAG,CAACC,CAAAA,KAAAA,GAAS;AAAIA,gBAAAA,GAAAA,KAAAA;AAAUd,gBAAAA,GAAAA,IAAAA,CAAKe,KAAK,CAACN,MAAAA,CAAOC,MAAM,CAACH,MAAM;AAAE,aAAA;AAAE,KAAA;AACjG;;"}

package/dist/esm/editing/exposureEdits.d.ts

@@ -0,0 +1,5 @@
+import { ExposePropertyEdit, SceneDiagnostic, SceneDocument, UnexposePropertyEdit } from '@cratis/scene.model';
+import { EditSession } from './EditSession';
+export declare function applyExposeProperty(session: EditSession, edit: ExposePropertyEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]): void;
+export declare function applyUnexposeProperty(session: EditSession, edit: UnexposePropertyEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]): void;
+//# sourceMappingURL=exposureEdits.d.ts.map

package/dist/esm/editing/exposureEdits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposureEdits.d.ts","sourceRoot":"","sources":["../../../editing/exposureEdits.ts"],"names":[],"mappings":"AAGA,OAAO,EACmD,kBAAkB,EAAqB,eAAe,EAC5G,aAAa,EAAE,oBAAoB,EACtC,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA8E5C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAI,CAc9I;AAKD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,IAAI,CAYlJ"}

package/dist/esm/editing/exposureEdits.js

@@ -0,0 +1,103 @@
+import { DiagnosticCode, PropertyValueType, CollectionOperation } from '@cratis/scene.model';
+import { findComponentDescriptor } from './DescriptorCatalog.js';
+import { errorDiagnostic } from './diagnostics.js';
+import { grantKey } from './exposureGrants.js';
+import { cloneData } from './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 ownsDeclaration(session, owner, diagnostics) {
+    const level = session.chain.levels.at(-1);
+    if (!level || level.owner !== owner) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.NodeNotEditable, `Exposure is declared by the layout or template that owns the component. '${owner}' is not what is being edited.`));
+        return false;
+    }
+    return true;
+}
+function validateExposure(session, property, diagnostics) {
+    const context = {
+        component: property.component,
+        path: property.path
+    };
+    const level = session.chain.levels.at(-1);
+    const reExposed = property.reExposes !== undefined;
+    if (!reExposed && !level.elements.some((candidate)=>candidate.id === property.component)) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${level.owner}' has no component '${property.component}'.`, context));
+        return false;
+    }
+    const grant = reExposed ? session.scopeGrants.get(grantKey(property.component, property.path)) : undefined;
+    if (reExposed && (!grant || grant.owner !== property.reExposes)) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.ReExposureBroken, `'${property.reExposes}' does not expose '${property.path}' on '${property.component}' to '${level.owner}', so it cannot be passed on.`, context));
+        return false;
+    }
+    const element = level.elements.find((candidate)=>candidate.id === property.component);
+    const descriptor = grant ? grant.descriptor : findComponentDescriptor(session.context.catalog, element.componentName)?.properties.find((candidate)=>candidate.path === property.path);
+    if (!descriptor) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `There is no editable property '${property.path}' on '${property.component}'.`, context));
+        return false;
+    }
+    const operations = property.operations ?? [];
+    if (descriptor.valueType !== PropertyValueType.Collection) {
+        if (operations.length > 0 || property.editableFields !== undefined) {
+            diagnostics.push(errorDiagnostic(DiagnosticCode.InvalidEdit, `'${descriptor.label}' is not a collection, so operations and editable fields do not apply.`, context));
+            return false;
+        }
+        return true;
+    }
+    const known = Object.values(CollectionOperation);
+    const unknown = operations.find((operation)=>!known.includes(operation));
+    if (unknown !== undefined) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.InvalidEdit, `'${unknown}' is not a collection operation.`, context));
+        return false;
+    }
+    const fields = descriptor.item?.properties.map((candidate)=>candidate.path) ?? [];
+    const unknownField = property.editableFields?.find((field)=>!fields.includes(field));
+    if (unknownField !== undefined) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.UnknownCollectionField, `Items of '${descriptor.label}' have no field '${unknownField}'.`, context));
+        return false;
+    }
+    if (grant && (operations.some((operation)=>!grant.operations.includes(operation)) || grant.editableFields !== undefined && (property.editableFields ?? fields).some((field)=>!grant.editableFields.includes(field)))) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureWidensOwner, `'${property.reExposes}' exposed less of '${descriptor.label}' than this re-exposes.`, context));
+        return false;
+    }
+    return true;
+}
+/**
+ * Applies an exposure declaration to a copy of the document.
+ *
+ * Exposure only narrows: the property has to be one the component's descriptor supports, a collection's
+ * operations and fields have to exist, and a re-exposure cannot grant more than the owner it passes on.
+ */ function applyExposeProperty(session, edit, clone, diagnostics) {
+    if (!ownsDeclaration(session, edit.owner, diagnostics) || !validateExposure(session, edit.property, diagnostics)) return;
+    let declaration = clone.exposures.find((candidate)=>candidate.owner === edit.owner);
+    if (!declaration) {
+        declaration = {
+            owner: edit.owner,
+            properties: []
+        };
+        clone.exposures.push(declaration);
+    }
+    const same = (candidate)=>candidate.component === edit.property.component && candidate.path === edit.property.path && candidate.reExposes === edit.property.reExposes;
+    const position = declaration.properties.findIndex(same);
+    if (position >= 0) declaration.properties[position] = cloneData(edit.property);
+    else declaration.properties.push(cloneData(edit.property));
+}
+/**
+ * Applies an exposure withdrawal to a copy of the document. Values already saved against it are not touched.
+ */ function applyUnexposeProperty(session, edit, clone, diagnostics) {
+    if (!ownsDeclaration(session, edit.owner, diagnostics)) return;
+    const declaration = clone.exposures.find((candidate)=>candidate.owner === edit.owner);
+    const remaining = declaration?.properties.filter((candidate)=>!(candidate.component === edit.component && candidate.path === edit.path));
+    if (!declaration || remaining.length === declaration.properties.length) {
+        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${edit.owner}' does not expose '${edit.path}' on '${edit.component}'.`, {
+            component: edit.component,
+            path: edit.path
+        }));
+        return;
+    }
+    if (remaining.length === 0) clone.exposures.splice(clone.exposures.indexOf(declaration), 1);
+    else declaration.properties = remaining;
+}
+
+export { applyExposeProperty, applyUnexposeProperty };
+//# sourceMappingURL=exposureEdits.js.map

package/dist/esm/editing/exposureEdits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposureEdits.js","sources":["../../../editing/exposureEdits.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    CollectionOperation, DiagnosticCode, ExposedProperty, ExposePropertyEdit, PropertyValueType, SceneDiagnostic,\n    SceneDocument, UnexposePropertyEdit,\n} from '@cratis/scene.model';\nimport { findComponentDescriptor } from './DescriptorCatalog';\nimport { errorDiagnostic } from './diagnostics';\nimport { EditSession } from './EditSession';\nimport { grantKey } from './exposureGrants';\nimport { cloneData } from './pathAccess';\n\nfunction ownsDeclaration(session: EditSession, owner: string, diagnostics: SceneDiagnostic[]): boolean {\n    const level = session.chain.levels.at(-1);\n    if (!level || level.owner !== owner) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.NodeNotEditable, `Exposure is declared by the layout or template that owns the component. '${owner}' is not what is being edited.`));\n        return false;\n    }\n\n    return true;\n}\n\nfunction validateExposure(session: EditSession, property: ExposedProperty, diagnostics: SceneDiagnostic[]): boolean {\n    const context = { component: property.component, path: property.path };\n    const level = session.chain.levels.at(-1)!;\n    const reExposed = property.reExposes !== undefined;\n\n    if (!reExposed && !level.elements.some(candidate => candidate.id === property.component)) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${level.owner}' has no component '${property.component}'.`, context));\n        return false;\n    }\n\n    const grant = reExposed ? session.scopeGrants.get(grantKey(property.component, property.path)) : undefined;\n    if (reExposed && (!grant || grant.owner !== property.reExposes)) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.ReExposureBroken, `'${property.reExposes}' does not expose '${property.path}' on '${property.component}' to '${level.owner}', so it cannot be passed on.`, context));\n        return false;\n    }\n\n    const element = level.elements.find(candidate => candidate.id === property.component);\n    const descriptor = grant\n        ? grant.descriptor\n        : findComponentDescriptor(session.context.catalog, element!.componentName)?.properties.find(candidate => candidate.path === property.path);\n    if (!descriptor) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `There is no editable property '${property.path}' on '${property.component}'.`, context));\n        return false;\n    }\n\n    const operations = property.operations ?? [];\n    if (descriptor.valueType !== PropertyValueType.Collection) {\n        if (operations.length > 0 || property.editableFields !== undefined) {\n            diagnostics.push(errorDiagnostic(DiagnosticCode.InvalidEdit, `'${descriptor.label}' is not a collection, so operations and editable fields do not apply.`, context));\n            return false;\n        }\n\n        return true;\n    }\n\n    const known = Object.values(CollectionOperation) as string[];\n    const unknown = operations.find(operation => !known.includes(operation));\n    if (unknown !== undefined) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.InvalidEdit, `'${unknown}' is not a collection operation.`, context));\n        return false;\n    }\n\n    const fields = descriptor.item?.properties.map(candidate => candidate.path) ?? [];\n    const unknownField = property.editableFields?.find(field => !fields.includes(field));\n    if (unknownField !== undefined) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.UnknownCollectionField, `Items of '${descriptor.label}' have no field '${unknownField}'.`, context));\n        return false;\n    }\n\n    if (grant && (operations.some(operation => !grant.operations.includes(operation))\n        || (grant.editableFields !== undefined && (property.editableFields ?? fields).some(field => !grant.editableFields!.includes(field))))) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureWidensOwner, `'${property.reExposes}' exposed less of '${descriptor.label}' than this re-exposes.`, context));\n        return false;\n    }\n\n    return true;\n}\n\n/**\n * Applies an exposure declaration to a copy of the document.\n *\n * Exposure only narrows: the property has to be one the component's descriptor supports, a collection's\n * operations and fields have to exist, and a re-exposure cannot grant more than the owner it passes on.\n */\nexport function applyExposeProperty(session: EditSession, edit: ExposePropertyEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]): void {\n    if (!ownsDeclaration(session, edit.owner, diagnostics) || !validateExposure(session, edit.property, diagnostics)) return;\n\n    let declaration = clone.exposures.find(candidate => candidate.owner === edit.owner);\n    if (!declaration) {\n        declaration = { owner: edit.owner, properties: [] };\n        clone.exposures.push(declaration);\n    }\n\n    const same = (candidate: ExposedProperty) => candidate.component === edit.property.component\n        && candidate.path === edit.property.path && candidate.reExposes === edit.property.reExposes;\n    const position = declaration.properties.findIndex(same);\n    if (position >= 0) declaration.properties[position] = cloneData(edit.property);\n    else declaration.properties.push(cloneData(edit.property));\n}\n\n/**\n * Applies an exposure withdrawal to a copy of the document. Values already saved against it are not touched.\n */\nexport function applyUnexposeProperty(session: EditSession, edit: UnexposePropertyEdit, clone: SceneDocument, diagnostics: SceneDiagnostic[]): void {\n    if (!ownsDeclaration(session, edit.owner, diagnostics)) return;\n\n    const declaration = clone.exposures.find(candidate => candidate.owner === edit.owner);\n    const remaining = declaration?.properties.filter(candidate => !(candidate.component === edit.component && candidate.path === edit.path));\n    if (!declaration || remaining!.length === declaration.properties.length) {\n        diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${edit.owner}' does not expose '${edit.path}' on '${edit.component}'.`, { component: edit.component, path: edit.path }));\n        return;\n    }\n\n    if (remaining!.length === 0) clone.exposures.splice(clone.exposures.indexOf(declaration), 1);\n    else declaration.properties = remaining!;\n}\n"],"names":["ownsDeclaration","session","owner","diagnostics","level","chain","levels","at","push","errorDiagnostic","DiagnosticCode","NodeNotEditable","validateExposure","property","context","component","path","reExposed","reExposes","undefined","elements","some","candidate","id","ExposureTargetMissing","grant","scopeGrants","get","grantKey","ReExposureBroken","element","find","descriptor","findComponentDescriptor","catalog","componentName","properties","operations","valueType","PropertyValueType","Collection","length","editableFields","InvalidEdit","label","known","Object","values","CollectionOperation","unknown","operation","includes","fields","item","map","unknownField","field","UnknownCollectionField","ExposureWidensOwner","applyExposeProperty","edit","clone","declaration","exposures","same","position","findIndex","cloneData","applyUnexposeProperty","remaining","filter","splice","indexOf"],"mappings":"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"}

package/dist/esm/editing/exposureGrants.d.ts

@@ -0,0 +1,21 @@
+import { CollectionOperation, PropertyDescriptor, SceneDiagnostic } from '@cratis/scene.model';
+import { DescriptorCatalog } from './DescriptorCatalog';
+import { TemplateChain } from './TemplateChain';
+export interface ExposureGrant {
+    component: string;
+    path: string;
+    descriptor: PropertyDescriptor;
+    owner: string;
+    ownerLevel: number;
+    operations: CollectionOperation[];
+    editableFields?: string[];
+    label?: string;
+}
+export interface ExposureGrants {
+    exposed: ExposureGrant[];
+    byInstance: Map<string, Map<string, ExposureGrant>>;
+    diagnostics: SceneDiagnostic[];
+}
+export declare function grantKey(component: string, path: string): string;
+export declare function computeExposureGrants(chain: TemplateChain, catalog: DescriptorCatalog): ExposureGrants;
+//# sourceMappingURL=exposureGrants.d.ts.map

package/dist/esm/editing/exposureGrants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exposureGrants.d.ts","sourceRoot":"","sources":["../../../editing/exposureGrants.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,mBAAmB,EAAmC,kBAAkB,EAAqB,eAAe,EAC/G,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAA2B,MAAM,qBAAqB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,MAAM,WAAW,aAAa;IAE1B,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,kBAAkB,CAAC;IAG/B,KAAK,EAAE,MAAM,CAAC;IAGd,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAGlC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,MAAM,WAAW,cAAc;IAE3B,OAAO,EAAE,aAAa,EAAE,CAAC;IAGzB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAEpD,WAAW,EAAE,eAAe,EAAE,CAAC;CAClC;AAKD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAyBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,cAAc,CA+EtG"}

package/dist/esm/editing/exposureGrants.js

@@ -0,0 +1,112 @@
+import { DiagnosticCode, PropertyValueType } from '@cratis/scene.model';
+import { findComponentDescriptor } from './DescriptorCatalog.js';
+import { errorDiagnostic } from './diagnostics.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The key a grant is stored under.
+ */ function grantKey(component, path) {
+    return `${component}\u0000${path}`;
+}
+function narrow(grant, reExposure) {
+    const requested = reExposure.operations ?? [];
+    const operations = requested.filter((operation)=>grant.operations.includes(operation));
+    const fields = grant.editableFields === undefined ? reExposure.editableFields : reExposure.editableFields === undefined ? grant.editableFields : reExposure.editableFields.filter((field)=>grant.editableFields.includes(field));
+    const widened = operations.length < requested.length || grant.editableFields !== undefined && reExposure.editableFields !== undefined && reExposure.editableFields.some((field)=>!grant.editableFields.includes(field));
+    return {
+        grant: {
+            ...grant,
+            operations,
+            editableFields: fields,
+            label: reExposure.label ?? grant.label
+        },
+        widened
+    };
+}
+/**
+ * Works out, for every instance in a chain, which properties it may configure.
+ *
+ * An owner's exposure reaches the instance directly inside it. It reaches further only through explicit
+ * re-exposure by every level in between, and each re-exposure can only narrow what it passes on - a nested
+ * template that lists more operations or fields than its owner granted gets the owner's, not its own.
+ *
+ * @param chain The chain to analyze.
+ * @param catalog The descriptors that say what each component supports.
+ */ function computeExposureGrants(chain, catalog) {
+    const result = {
+        exposed: [],
+        byInstance: new Map(),
+        diagnostics: []
+    };
+    for (const chainLevel of chain.levels)result.byInstance.set(chainLevel.instance, new Map());
+    const consumed = new Set();
+    chain.levels.forEach((owner, ownerLevel)=>{
+        for (const exposure of owner.exposures.filter((candidate)=>candidate.reExposes === undefined)){
+            const element = owner.elements.find((candidate)=>candidate.id === exposure.component);
+            if (!element) {
+                result.diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${owner.owner}' exposes '${exposure.path}' on '${exposure.component}', but it has no such component.`, {
+                    component: exposure.component,
+                    path: exposure.path
+                }));
+                continue;
+            }
+            const descriptor = findComponentDescriptor(catalog, element.componentName);
+            if (!descriptor) {
+                result.diagnostics.push(errorDiagnostic(DiagnosticCode.MissingComponentDescriptor, `'${owner.owner}' exposes '${exposure.path}' on '${exposure.component}', but nothing describes the component '${element.componentName}'.`, {
+                    component: exposure.component,
+                    path: exposure.path
+                }));
+                continue;
+            }
+            const property = descriptor.properties.find((candidate)=>candidate.path === exposure.path);
+            if (!property) {
+                result.diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureTargetMissing, `'${owner.owner}' exposes '${exposure.path}' on '${exposure.component}', but '${element.componentName}' no longer has that property.`, {
+                    component: exposure.component,
+                    path: exposure.path
+                }));
+                continue;
+            }
+            const isCollection = property.valueType === PropertyValueType.Collection;
+            let current = {
+                component: exposure.component,
+                path: exposure.path,
+                descriptor: property,
+                owner: owner.owner,
+                ownerLevel,
+                operations: isCollection ? [
+                    ...new Set(exposure.operations ?? [])
+                ] : [],
+                editableFields: isCollection ? exposure.editableFields : undefined,
+                label: exposure.label
+            };
+            result.exposed.push(current);
+            for(let contributor = ownerLevel + 1; contributor < chain.levels.length; contributor++){
+                result.byInstance.get(chain.levels[contributor].instance).set(grantKey(exposure.component, exposure.path), current);
+                const reExposure = chain.levels[contributor].exposures.find((candidate)=>candidate.reExposes === owner.owner && candidate.component === exposure.component && candidate.path === exposure.path);
+                if (!reExposure) break;
+                consumed.add(reExposure);
+                const narrowed = narrow(current, reExposure);
+                if (narrowed.widened) {
+                    result.diagnostics.push(errorDiagnostic(DiagnosticCode.ExposureWidensOwner, `'${chain.levels[contributor].owner}' re-exposes more of '${exposure.path}' than '${owner.owner}' exposed; only what the owner granted is passed on.`, {
+                        component: exposure.component,
+                        path: exposure.path
+                    }));
+                }
+                current = narrowed.grant;
+            }
+        }
+    });
+    for (const chainLevel of chain.levels){
+        for (const reExposure of chainLevel.exposures.filter((candidate)=>candidate.reExposes !== undefined && !consumed.has(candidate))){
+            result.diagnostics.push(errorDiagnostic(DiagnosticCode.ReExposureBroken, `'${chainLevel.owner}' re-exposes '${reExposure.path}' on '${reExposure.component}' from '${reExposure.reExposes}', which does not expose it to this chain.`, {
+                component: reExposure.component,
+                path: reExposure.path
+            }));
+        }
+    }
+    return result;
+}
+
+export { computeExposureGrants, grantKey };
+//# sourceMappingURL=exposureGrants.js.map