@cratis/scene.engine 4.14.0 → 4.16.0

package/QueryBindingState.ts

@@ -0,0 +1,43 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+import { BindingScope } from './BindingScope';
+import { QueryBindingTicket } from './QueryBindingTicket';
+
+/**
+ * Keeps the results of bound queries as their arguments change. Every rebind starts a new generation; a
+ * result is accepted only for the latest generation of its query, so a slow answer for a previous
+ * selection is discarded instead of overwriting the current one. Clearing a query - its arguments became
+ * unavailable, or its element left the tree - removes the result and invalidates any run in flight.
+ *
+ * The C# engine (`QueryBindingState`) behaves identically; both run `binding-resolution-fixtures.json`.
+ */
+export class QueryBindingState {
+    readonly #generations = new Map<string, number>();
+    readonly #results = new Map<string, unknown>();
+
+    /** Starts a run of a query with new arguments, invalidating every earlier run of that query. */
+    begin(query: string): QueryBindingTicket {
+        const generation = (this.#generations.get(query) ?? 0) + 1;
+        this.#generations.set(query, generation);
+        return { query, generation };
+    }
+
+    /** Records a run's result. Returns false, and keeps the current result, when the run is stale. */
+    complete(ticket: QueryBindingTicket, result: unknown): boolean {
+        if (this.#generations.get(ticket.query) !== ticket.generation) return false;
+        this.#results.set(ticket.query, result);
+        return true;
+    }
+
+    /** Removes a query's result and invalidates any run still in flight. */
+    clear(query: string): void {
+        this.#generations.set(query, (this.#generations.get(query) ?? 0) + 1);
+        this.#results.delete(query);
+    }
+
+    /** The accepted results, as the query results of a binding scope. */
+    get queryResults(): NonNullable<BindingScope['queryResults']> {
+        return Object.fromEntries(this.#results);
+    }
+}

package/QueryBindingTicket.ts

@@ -0,0 +1,8 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/** Identifies one run of a bound query, issued when the run starts. */
+export interface QueryBindingTicket {
+    query: string;
+    generation: number;
+}

package/dist/cjs/QueryBindingState.js

@@ -0,0 +1,38 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Keeps the results of bound queries as their arguments change. Every rebind starts a new generation; a
+ * result is accepted only for the latest generation of its query, so a slow answer for a previous
+ * selection is discarded instead of overwriting the current one. Clearing a query - its arguments became
+ * unavailable, or its element left the tree - removes the result and invalidates any run in flight.
+ *
+ * The C# engine (`QueryBindingState`) behaves identically; both run `binding-resolution-fixtures.json`.
+ */ class QueryBindingState {
+    #generations = new Map();
+    #results = new Map();
+    /** Starts a run of a query with new arguments, invalidating every earlier run of that query. */ begin(query) {
+        const generation = (this.#generations.get(query) ?? 0) + 1;
+        this.#generations.set(query, generation);
+        return {
+            query,
+            generation
+        };
+    }
+    /** Records a run's result. Returns false, and keeps the current result, when the run is stale. */ complete(ticket, result) {
+        if (this.#generations.get(ticket.query) !== ticket.generation) return false;
+        this.#results.set(ticket.query, result);
+        return true;
+    }
+    /** Removes a query's result and invalidates any run still in flight. */ clear(query) {
+        this.#generations.set(query, (this.#generations.get(query) ?? 0) + 1);
+        this.#results.delete(query);
+    }
+    /** The accepted results, as the query results of a binding scope. */ get queryResults() {
+        return Object.fromEntries(this.#results);
+    }
+}
+
+exports.QueryBindingState = QueryBindingState;
+//# sourceMappingURL=QueryBindingState.js.map

package/dist/cjs/QueryBindingState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBindingState.js","sources":["../../QueryBindingState.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 { BindingScope } from './BindingScope';\nimport { QueryBindingTicket } from './QueryBindingTicket';\n\n/**\n * Keeps the results of bound queries as their arguments change. Every rebind starts a new generation; a\n * result is accepted only for the latest generation of its query, so a slow answer for a previous\n * selection is discarded instead of overwriting the current one. Clearing a query - its arguments became\n * unavailable, or its element left the tree - removes the result and invalidates any run in flight.\n *\n * The C# engine (`QueryBindingState`) behaves identically; both run `binding-resolution-fixtures.json`.\n */\nexport class QueryBindingState {\n    readonly #generations = new Map<string, number>();\n    readonly #results = new Map<string, unknown>();\n\n    /** Starts a run of a query with new arguments, invalidating every earlier run of that query. */\n    begin(query: string): QueryBindingTicket {\n        const generation = (this.#generations.get(query) ?? 0) + 1;\n        this.#generations.set(query, generation);\n        return { query, generation };\n    }\n\n    /** Records a run's result. Returns false, and keeps the current result, when the run is stale. */\n    complete(ticket: QueryBindingTicket, result: unknown): boolean {\n        if (this.#generations.get(ticket.query) !== ticket.generation) return false;\n        this.#results.set(ticket.query, result);\n        return true;\n    }\n\n    /** Removes a query's result and invalidates any run still in flight. */\n    clear(query: string): void {\n        this.#generations.set(query, (this.#generations.get(query) ?? 0) + 1);\n        this.#results.delete(query);\n    }\n\n    /** The accepted results, as the query results of a binding scope. */\n    get queryResults(): NonNullable<BindingScope['queryResults']> {\n        return Object.fromEntries(this.#results);\n    }\n}\n"],"names":["QueryBindingState","Map","begin","query","generation","get","set","complete","ticket","result","clear","delete","queryResults","Object","fromEntries"],"mappings":";;AAAA;AACA;AAKA;;;;;;;AAOC,IACM,MAAMA,iBAAAA,CAAAA;IACA,YAAY,GAAG,IAAIC,GAAAA,EAAAA;IACnB,QAAQ,GAAG,IAAIA,GAAAA,EAAAA;qGAGxBC,KAAAA,CAAMC,KAAa,EAAsB;AACrC,QAAA,MAAMC,UAAAA,GAAc,CAAA,IAAI,CAAC,YAAY,CAACC,GAAG,CAACF,KAAAA,CAAAA,IAAU,CAAA,IAAK,CAAA;AACzD,QAAA,IAAI,CAAC,YAAY,CAACG,GAAG,CAACH,KAAAA,EAAOC,UAAAA,CAAAA;QAC7B,OAAO;AAAED,YAAAA,KAAAA;AAAOC,YAAAA;AAAW,SAAA;AAC/B,IAAA;AAEA,uGACAG,QAAAA,CAASC,MAA0B,EAAEC,MAAe,EAAW;AAC3D,QAAA,IAAI,IAAI,CAAC,YAAY,CAACJ,GAAG,CAACG,MAAAA,CAAOL,KAAK,CAAA,KAAMK,MAAAA,CAAOJ,UAAU,EAAE,OAAO,KAAA;QACtE,IAAI,CAAC,QAAQ,CAACE,GAAG,CAACE,MAAAA,CAAOL,KAAK,EAAEM,MAAAA,CAAAA;QAChC,OAAO,IAAA;AACX,IAAA;6EAGAC,KAAAA,CAAMP,KAAa,EAAQ;AACvB,QAAA,IAAI,CAAC,YAAY,CAACG,GAAG,CAACH,OAAO,CAAC,IAAI,CAAC,YAAY,CAACE,GAAG,CAACF,KAAAA,CAAAA,IAAU,CAAA,IAAK,CAAA,CAAA;AACnE,QAAA,IAAI,CAAC,QAAQ,CAACQ,MAAM,CAACR,KAAAA,CAAAA;AACzB,IAAA;0EAGA,IAAIS,YAAAA,GAA0D;AAC1D,QAAA,OAAOC,OAAOC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAA;AAC3C,IAAA;AACJ;;"}

package/dist/cjs/editing/resolveEffectiveConfiguration.js

@@ -158,6 +158,17 @@ function collectionValue(grant, matching, instance, items, diagnostics$1) {
                 scalarValue(effectiveGrant, matching, instance, current, diagnostics$1);
             }
         }
+        const maximumItems = grant.descriptor.constraints?.maximumItems;
+        if (isCollection && maximumItems !== undefined && items.length > maximumItems) {
+            // Saved items that no longer fit - the owner lowered the limit after they were added - are left out of
+            // the result in order and kept in the saved data, like any other saved value that no longer fits.
+            const dropped = items.splice(maximumItems);
+            diagnostics$1.push(diagnostics.errorDiagnostic(scene_model.DiagnosticCode.ContributionTypeMismatch, `'${grant.path}' on '${grant.component}' allows at most ${maximumItems} items; ${dropped.map((item)=>`'${item.id}'`).join(', ')} ${dropped.length === 1 ? 'is' : 'are'} ignored and kept.`, {
+                instance: current.contributedBy ?? owner.instance,
+                component: grant.component,
+                path: grant.path
+            }));
+        }
         if (isCollection) {
             current.items = items;
             current.inheritedValue = baseItems.map(toFlatItem);

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

@@ -1 +1 @@
-{"version":3,"file":"resolveEffectiveConfiguration.js","sources":["../../../editing/resolveEffectiveConfiguration.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, EffectiveCollectionItem, EffectiveComponentConfiguration,\n    EffectiveConfiguration, EffectivePropertyValue, InstanceContribution, PropertyValueType, SceneDiagnostic, ValueSource,\n} from '@cratis/scene.model';\nimport { DescriptorCatalog, findComponentDescriptor } from './DescriptorCatalog';\nimport { errorDiagnostic } from './diagnostics';\nimport { computeExposureGrants, ExposureGrant, grantKey } from './exposureGrants';\nimport { cloneData, getValueAtPath, setValueAtPath } from './pathAccess';\nimport { TemplateChain } from './TemplateChain';\nimport { validateItemValues, validateValue } from './validateValue';\n\n/**\n * Splits a flat collection item as it is stored on an element - `{ id, label, ... }` - into its id and fields.\n */\nfunction toEffectiveItem(item: unknown, index: number): EffectiveCollectionItem {\n    const { id, ...values } = (item !== null && typeof item === 'object' ? item : {}) as Record<string, unknown>;\n    return { id: typeof id === 'string' && id.length > 0 ? id : `owner-${index}`, values, origin: 'owner', fixed: true };\n}\n\nfunction toFlatItem(item: EffectiveCollectionItem): Record<string, unknown> {\n    return { id: item.id, ...item.values };\n}\n\nfunction scalarValue(grant: ExposureGrant, matching: InstanceContribution[], instance: string, current: EffectivePropertyValue, diagnostics: SceneDiagnostic[]): void {\n    for (const contribution of matching) {\n        const problem = contribution.value === undefined ? 'a value is required' : validateValue(grant.descriptor, contribution.value);\n        if (problem) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionTypeMismatch,\n                `The saved value of '${grant.path}' set by '${instance}' is ignored: ${problem}. It is kept, and applies again when it fits.`,\n                { instance, component: grant.component, path: grant.path }));\n            continue;\n        }\n\n        current.value = contribution.value;\n        current.source = ValueSource.Instance;\n        current.contributedBy = instance;\n    }\n}\n\nfunction collectionValue(grant: ExposureGrant, matching: InstanceContribution[], instance: string, items: EffectiveCollectionItem[], diagnostics: SceneDiagnostic[]): boolean {\n    let contributed = false;\n\n    for (const contribution of matching) {\n        const context = { instance, component: grant.component, path: grant.path };\n        if (contribution.items === undefined) {\n            diagnostics.push(errorDiagnostic(DiagnosticCode.ContributionTypeMismatch, `The saved value of '${grant.path}' set by '${instance}' is ignored: a collection takes items.`, context));\n            continue;\n        }\n\n        if (contribution.items.length > 0 && !grant.operations.includes(CollectionOperation.Add)) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionOperationNotPermitted,\n                `'${instance}' has items in '${grant.path}', but adding items is not exposed. They are ignored and kept.`,\n                context));\n            continue;\n        }\n\n        for (const item of contribution.items) {\n            const itemContext = { ...context, itemId: item.id };\n            if (items.some(existing => existing.id === item.id)) {\n                diagnostics.push(errorDiagnostic(DiagnosticCode.DuplicateCollectionItem, `The item id '${item.id}' in '${grant.path}' is already used.`, itemContext));\n                continue;\n            }\n\n            const values: Record<string, unknown> = {};\n            for (const [field, value] of Object.entries(item.values)) {\n                if (grant.editableFields !== undefined && !grant.editableFields.includes(field)) {\n                    diagnostics.push(errorDiagnostic(DiagnosticCode.ContributionOperationNotPermitted, `The field '${field}' of '${grant.path}' is not exposed for editing.`, itemContext));\n                    continue;\n                }\n\n                const problem = validateItemValues(grant.descriptor.item, { [field]: value }).find(candidate => candidate.field === field);\n                if (problem) {\n                    diagnostics.push(errorDiagnostic(\n                        problem.problem.startsWith('is not a field') ? DiagnosticCode.UnknownCollectionField : DiagnosticCode.ContributionTypeMismatch,\n                        `The field '${field}' of an item in '${grant.path}' is ignored: ${problem.problem}.`,\n                        itemContext));\n                    continue;\n                }\n\n                values[field] = value;\n            }\n\n            items.push({ id: item.id, values, origin: instance, fixed: false });\n            contributed = true;\n        }\n    }\n\n    return contributed;\n}\n\n/**\n * Resolves what every configurable component in a template chain is worth: the owner's own values, with each\n * instance's contributions applied in nesting order.\n *\n * This is the one merge. The editor shows its result and the runtime renders from it, so what an author sees is\n * what Play renders. Order is fixed: the owner's value first, then each level from the outermost inwards, so a\n * later level wins a scalar and appends to a collection after the earlier ones.\n *\n * Nothing in the persisted data is changed. A contribution that cannot apply - the exposure was withdrawn, the\n * property's type changed, the component is gone - is reported in `diagnostics` and left out of the result, and\n * stays in `instanceContributions`, so restoring the exposure brings its value back.\n *\n * @param templateChain The nesting, from {@link resolveTemplateChain} or built by hand.\n * @param instanceContributions What each instance has set.\n * @param catalog The descriptors saying what each component supports.\n */\nexport function resolveEffectiveConfiguration(\n    templateChain: TemplateChain,\n    instanceContributions: InstanceContribution[],\n    catalog: DescriptorCatalog,\n): EffectiveConfiguration {\n    const grants = computeExposureGrants(templateChain, catalog);\n    const diagnostics: SceneDiagnostic[] = [...templateChain.diagnostics, ...grants.diagnostics];\n    const handled = new Set<InstanceContribution>();\n    const components = new Map<string, EffectiveComponentConfiguration>();\n\n    for (const grant of grants.exposed) {\n        const owner = templateChain.levels[grant.ownerLevel];\n        const element = owner.elements.find(candidate => candidate.id === grant.component)!;\n\n        let configuration = components.get(grant.component);\n        if (!configuration) {\n            configuration = { component: grant.component, owner: owner.owner, properties: cloneData(element.properties), values: [] };\n            components.set(grant.component, configuration);\n        }\n\n        const stored = getValueAtPath(element.properties, grant.path);\n        const base = stored === undefined ? cloneData(grant.descriptor.default) : cloneData(stored);\n        const isCollection = grant.descriptor.valueType === PropertyValueType.Collection;\n        const baseItems = isCollection && Array.isArray(base) ? base.map(toEffectiveItem) : [];\n        const items = [...baseItems];\n\n        const current: EffectivePropertyValue = {\n            path: grant.path,\n            value: base,\n            source: stored === undefined ? ValueSource.Default : ValueSource.Local,\n            inheritedValue: base,\n        };\n        let contributed = false;\n\n        for (let index = grant.ownerLevel + 1; index < templateChain.levels.length; index++) {\n            const instance = templateChain.levels[index].instance;\n            if (!grants.byInstance.get(instance)?.has(grantKey(grant.component, grant.path))) continue;\n\n            const effectiveGrant = grants.byInstance.get(instance)!.get(grantKey(grant.component, grant.path))!;\n            const matching = instanceContributions.filter(contribution =>\n                contribution.instance === instance && contribution.component === grant.component && contribution.path === grant.path);\n            for (const contribution of matching) handled.add(contribution);\n\n            if (isCollection) {\n                if (collectionValue(effectiveGrant, matching, instance, items, diagnostics)) {\n                    contributed = true;\n                    current.contributedBy = instance;\n                }\n            } else {\n                scalarValue(effectiveGrant, matching, instance, current, diagnostics);\n            }\n        }\n\n        if (isCollection) {\n            current.items = items;\n            current.inheritedValue = baseItems.map(toFlatItem);\n            current.value = items.map(toFlatItem);\n            if (contributed) current.source = ValueSource.Instance;\n        }\n\n        if (current.value !== undefined) setValueAtPath(configuration.properties, grant.path, current.value);\n        configuration.values.push(current);\n    }\n\n    const levelOf = new Map(templateChain.levels.map((chainLevel, index) => [chainLevel.instance, index]));\n    for (const contribution of instanceContributions) {\n        const contributorLevel = levelOf.get(contribution.instance);\n        if (contributorLevel === undefined || handled.has(contribution)) continue;\n\n        const context = { instance: contribution.instance, component: contribution.component, path: contribution.path };\n        const owner = templateChain.levels.slice(0, contributorLevel).find(chainLevel => chainLevel.elements.some(element => element.id === contribution.component));\n        if (!owner) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionTargetMissing,\n                `'${contribution.instance}' has saved values for '${contribution.component}', which is not in any layout or template above it. They are kept.`,\n                context));\n        } else if (!findComponentDescriptor(catalog, owner.elements.find(element => element.id === contribution.component)!.componentName)) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.MissingComponentDescriptor,\n                `'${contribution.instance}' has saved values for '${contribution.component}', but nothing describes that component any more. They are kept.`,\n                context));\n        } else {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionNotExposed,\n                `'${contribution.instance}' has a saved value for '${contribution.path}' on '${contribution.component}', which is not exposed to it. It is ignored and kept.`,\n                context));\n        }\n    }\n\n    return { components: [...components.values()], diagnostics };\n}\n"],"names":["toEffectiveItem","item","index","id","values","length","origin","fixed","toFlatItem","scalarValue","grant","matching","instance","current","diagnostics","contribution","problem","value","undefined","validateValue","descriptor","push","errorDiagnostic","DiagnosticCode","ContributionTypeMismatch","path","component","source","ValueSource","Instance","contributedBy","collectionValue","items","contributed","context","operations","includes","CollectionOperation","Add","ContributionOperationNotPermitted","itemContext","itemId","some","existing","DuplicateCollectionItem","field","Object","entries","editableFields","validateItemValues","find","candidate","startsWith","UnknownCollectionField","resolveEffectiveConfiguration","templateChain","instanceContributions","catalog","grants","computeExposureGrants","handled","Set","components","Map","exposed","owner","levels","ownerLevel","element","elements","configuration","get","properties","cloneData","set","stored","getValueAtPath","base","default","isCollection","valueType","PropertyValueType","Collection","baseItems","Array","isArray","map","Default","Local","inheritedValue","byInstance","has","grantKey","effectiveGrant","filter","add","setValueAtPath","levelOf","chainLevel","contributorLevel","slice","ContributionTargetMissing","findComponentDescriptor","componentName","MissingComponentDescriptor","ContributionNotExposed"],"mappings":"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"}
+{"version":3,"file":"resolveEffectiveConfiguration.js","sources":["../../../editing/resolveEffectiveConfiguration.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, EffectiveCollectionItem, EffectiveComponentConfiguration,\n    EffectiveConfiguration, EffectivePropertyValue, InstanceContribution, PropertyValueType, SceneDiagnostic, ValueSource,\n} from '@cratis/scene.model';\nimport { DescriptorCatalog, findComponentDescriptor } from './DescriptorCatalog';\nimport { errorDiagnostic } from './diagnostics';\nimport { computeExposureGrants, ExposureGrant, grantKey } from './exposureGrants';\nimport { cloneData, getValueAtPath, setValueAtPath } from './pathAccess';\nimport { TemplateChain } from './TemplateChain';\nimport { validateItemValues, validateValue } from './validateValue';\n\n/**\n * Splits a flat collection item as it is stored on an element - `{ id, label, ... }` - into its id and fields.\n */\nfunction toEffectiveItem(item: unknown, index: number): EffectiveCollectionItem {\n    const { id, ...values } = (item !== null && typeof item === 'object' ? item : {}) as Record<string, unknown>;\n    return { id: typeof id === 'string' && id.length > 0 ? id : `owner-${index}`, values, origin: 'owner', fixed: true };\n}\n\nfunction toFlatItem(item: EffectiveCollectionItem): Record<string, unknown> {\n    return { id: item.id, ...item.values };\n}\n\nfunction scalarValue(grant: ExposureGrant, matching: InstanceContribution[], instance: string, current: EffectivePropertyValue, diagnostics: SceneDiagnostic[]): void {\n    for (const contribution of matching) {\n        const problem = contribution.value === undefined ? 'a value is required' : validateValue(grant.descriptor, contribution.value);\n        if (problem) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionTypeMismatch,\n                `The saved value of '${grant.path}' set by '${instance}' is ignored: ${problem}. It is kept, and applies again when it fits.`,\n                { instance, component: grant.component, path: grant.path }));\n            continue;\n        }\n\n        current.value = contribution.value;\n        current.source = ValueSource.Instance;\n        current.contributedBy = instance;\n    }\n}\n\nfunction collectionValue(grant: ExposureGrant, matching: InstanceContribution[], instance: string, items: EffectiveCollectionItem[], diagnostics: SceneDiagnostic[]): boolean {\n    let contributed = false;\n\n    for (const contribution of matching) {\n        const context = { instance, component: grant.component, path: grant.path };\n        if (contribution.items === undefined) {\n            diagnostics.push(errorDiagnostic(DiagnosticCode.ContributionTypeMismatch, `The saved value of '${grant.path}' set by '${instance}' is ignored: a collection takes items.`, context));\n            continue;\n        }\n\n        if (contribution.items.length > 0 && !grant.operations.includes(CollectionOperation.Add)) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionOperationNotPermitted,\n                `'${instance}' has items in '${grant.path}', but adding items is not exposed. They are ignored and kept.`,\n                context));\n            continue;\n        }\n\n        for (const item of contribution.items) {\n            const itemContext = { ...context, itemId: item.id };\n            if (items.some(existing => existing.id === item.id)) {\n                diagnostics.push(errorDiagnostic(DiagnosticCode.DuplicateCollectionItem, `The item id '${item.id}' in '${grant.path}' is already used.`, itemContext));\n                continue;\n            }\n\n            const values: Record<string, unknown> = {};\n            for (const [field, value] of Object.entries(item.values)) {\n                if (grant.editableFields !== undefined && !grant.editableFields.includes(field)) {\n                    diagnostics.push(errorDiagnostic(DiagnosticCode.ContributionOperationNotPermitted, `The field '${field}' of '${grant.path}' is not exposed for editing.`, itemContext));\n                    continue;\n                }\n\n                const problem = validateItemValues(grant.descriptor.item, { [field]: value }).find(candidate => candidate.field === field);\n                if (problem) {\n                    diagnostics.push(errorDiagnostic(\n                        problem.problem.startsWith('is not a field') ? DiagnosticCode.UnknownCollectionField : DiagnosticCode.ContributionTypeMismatch,\n                        `The field '${field}' of an item in '${grant.path}' is ignored: ${problem.problem}.`,\n                        itemContext));\n                    continue;\n                }\n\n                values[field] = value;\n            }\n\n            items.push({ id: item.id, values, origin: instance, fixed: false });\n            contributed = true;\n        }\n    }\n\n    return contributed;\n}\n\n/**\n * Resolves what every configurable component in a template chain is worth: the owner's own values, with each\n * instance's contributions applied in nesting order.\n *\n * This is the one merge. The editor shows its result and the runtime renders from it, so what an author sees is\n * what Play renders. Order is fixed: the owner's value first, then each level from the outermost inwards, so a\n * later level wins a scalar and appends to a collection after the earlier ones.\n *\n * Nothing in the persisted data is changed. A contribution that cannot apply - the exposure was withdrawn, the\n * property's type changed, the component is gone - is reported in `diagnostics` and left out of the result, and\n * stays in `instanceContributions`, so restoring the exposure brings its value back.\n *\n * @param templateChain The nesting, from {@link resolveTemplateChain} or built by hand.\n * @param instanceContributions What each instance has set.\n * @param catalog The descriptors saying what each component supports.\n */\nexport function resolveEffectiveConfiguration(\n    templateChain: TemplateChain,\n    instanceContributions: InstanceContribution[],\n    catalog: DescriptorCatalog,\n): EffectiveConfiguration {\n    const grants = computeExposureGrants(templateChain, catalog);\n    const diagnostics: SceneDiagnostic[] = [...templateChain.diagnostics, ...grants.diagnostics];\n    const handled = new Set<InstanceContribution>();\n    const components = new Map<string, EffectiveComponentConfiguration>();\n\n    for (const grant of grants.exposed) {\n        const owner = templateChain.levels[grant.ownerLevel];\n        const element = owner.elements.find(candidate => candidate.id === grant.component)!;\n\n        let configuration = components.get(grant.component);\n        if (!configuration) {\n            configuration = { component: grant.component, owner: owner.owner, properties: cloneData(element.properties), values: [] };\n            components.set(grant.component, configuration);\n        }\n\n        const stored = getValueAtPath(element.properties, grant.path);\n        const base = stored === undefined ? cloneData(grant.descriptor.default) : cloneData(stored);\n        const isCollection = grant.descriptor.valueType === PropertyValueType.Collection;\n        const baseItems = isCollection && Array.isArray(base) ? base.map(toEffectiveItem) : [];\n        const items = [...baseItems];\n\n        const current: EffectivePropertyValue = {\n            path: grant.path,\n            value: base,\n            source: stored === undefined ? ValueSource.Default : ValueSource.Local,\n            inheritedValue: base,\n        };\n        let contributed = false;\n\n        for (let index = grant.ownerLevel + 1; index < templateChain.levels.length; index++) {\n            const instance = templateChain.levels[index].instance;\n            if (!grants.byInstance.get(instance)?.has(grantKey(grant.component, grant.path))) continue;\n\n            const effectiveGrant = grants.byInstance.get(instance)!.get(grantKey(grant.component, grant.path))!;\n            const matching = instanceContributions.filter(contribution =>\n                contribution.instance === instance && contribution.component === grant.component && contribution.path === grant.path);\n            for (const contribution of matching) handled.add(contribution);\n\n            if (isCollection) {\n                if (collectionValue(effectiveGrant, matching, instance, items, diagnostics)) {\n                    contributed = true;\n                    current.contributedBy = instance;\n                }\n            } else {\n                scalarValue(effectiveGrant, matching, instance, current, diagnostics);\n            }\n        }\n\n        const maximumItems = grant.descriptor.constraints?.maximumItems;\n        if (isCollection && maximumItems !== undefined && items.length > maximumItems) {\n            // Saved items that no longer fit - the owner lowered the limit after they were added - are left out of\n            // the result in order and kept in the saved data, like any other saved value that no longer fits.\n            const dropped = items.splice(maximumItems);\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionTypeMismatch,\n                `'${grant.path}' on '${grant.component}' allows at most ${maximumItems} items; ${dropped.map(item => `'${item.id}'`).join(', ')} ${dropped.length === 1 ? 'is' : 'are'} ignored and kept.`,\n                { instance: current.contributedBy ?? owner.instance, component: grant.component, path: grant.path }));\n        }\n\n        if (isCollection) {\n            current.items = items;\n            current.inheritedValue = baseItems.map(toFlatItem);\n            current.value = items.map(toFlatItem);\n            if (contributed) current.source = ValueSource.Instance;\n        }\n\n        if (current.value !== undefined) setValueAtPath(configuration.properties, grant.path, current.value);\n        configuration.values.push(current);\n    }\n\n    const levelOf = new Map(templateChain.levels.map((chainLevel, index) => [chainLevel.instance, index]));\n    for (const contribution of instanceContributions) {\n        const contributorLevel = levelOf.get(contribution.instance);\n        if (contributorLevel === undefined || handled.has(contribution)) continue;\n\n        const context = { instance: contribution.instance, component: contribution.component, path: contribution.path };\n        const owner = templateChain.levels.slice(0, contributorLevel).find(chainLevel => chainLevel.elements.some(element => element.id === contribution.component));\n        if (!owner) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionTargetMissing,\n                `'${contribution.instance}' has saved values for '${contribution.component}', which is not in any layout or template above it. They are kept.`,\n                context));\n        } else if (!findComponentDescriptor(catalog, owner.elements.find(element => element.id === contribution.component)!.componentName)) {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.MissingComponentDescriptor,\n                `'${contribution.instance}' has saved values for '${contribution.component}', but nothing describes that component any more. They are kept.`,\n                context));\n        } else {\n            diagnostics.push(errorDiagnostic(\n                DiagnosticCode.ContributionNotExposed,\n                `'${contribution.instance}' has a saved value for '${contribution.path}' on '${contribution.component}', which is not exposed to it. It is ignored and kept.`,\n                context));\n        }\n    }\n\n    return { components: [...components.values()], diagnostics };\n}\n"],"names":["toEffectiveItem","item","index","id","values","length","origin","fixed","toFlatItem","scalarValue","grant","matching","instance","current","diagnostics","contribution","problem","value","undefined","validateValue","descriptor","push","errorDiagnostic","DiagnosticCode","ContributionTypeMismatch","path","component","source","ValueSource","Instance","contributedBy","collectionValue","items","contributed","context","operations","includes","CollectionOperation","Add","ContributionOperationNotPermitted","itemContext","itemId","some","existing","DuplicateCollectionItem","field","Object","entries","editableFields","validateItemValues","find","candidate","startsWith","UnknownCollectionField","resolveEffectiveConfiguration","templateChain","instanceContributions","catalog","grants","computeExposureGrants","handled","Set","components","Map","exposed","owner","levels","ownerLevel","element","elements","configuration","get","properties","cloneData","set","stored","getValueAtPath","base","default","isCollection","valueType","PropertyValueType","Collection","baseItems","Array","isArray","map","Default","Local","inheritedValue","byInstance","has","grantKey","effectiveGrant","filter","add","maximumItems","constraints","dropped","splice","join","setValueAtPath","levelOf","chainLevel","contributorLevel","slice","ContributionTargetMissing","findComponentDescriptor","componentName","MissingComponentDescriptor","ContributionNotExposed"],"mappings":"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"}

package/dist/cjs/editing/validateValue.js

@@ -21,6 +21,10 @@ function isNonEmptyString(value) {
     if (value === undefined || value === null) {
         return constraints.required ? 'a value is required' : undefined;
     }
+    const binding = bindingKindOf(value);
+    if (binding !== undefined && descriptor.acceptedBindingKinds !== undefined) {
+        return descriptor.acceptedBindingKinds.includes(binding.kind) ? undefined : `a ${binding.kind} binding is not accepted here; use ${descriptor.acceptedBindingKinds.join(' or ')}`;
+    }
     switch(descriptor.valueType){
         case scene_model.PropertyValueType.String:
             {
@@ -63,7 +67,19 @@ function isNonEmptyString(value) {
 /**
  * The deepest nesting a JSON value may have. Authored configuration (chart datasets, option lists) is shallow;
  * the limit turns a runaway or hostile structure into a validation message instead of a stack overflow.
- */ const maximumJsonDepth = 64;
+ */ const bindingKinds = new Set(Object.values(scene_model.BindingSourceKind));
+/**
+ * The source kind of a value that is a typed binding expression - an object with a known `kind` and a
+ * string `path` - rather than a value of the property's own type. Only consulted for properties that declare
+ * `acceptedBindingKinds`, so a collection property such as a command form's `inputs` can be bound to a
+ * table's `selectedItem` instead of listing its items.
+ */ function bindingKindOf(value) {
+    if (!isRecord(value) || typeof value.kind !== 'string' || !bindingKinds.has(value.kind) || typeof value.path !== 'string') return undefined;
+    return {
+        kind: value.kind
+    };
+}
+const maximumJsonDepth = 64;
 /**
  * Whether a value is JSON: `null`, a string, a boolean, a finite number, or an array or plain object of those.
  * The value is only inspected, never serialized, so what an editor stores is exactly what was passed in.

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

@@ -1 +1 @@
-{"version":3,"file":"validateValue.js","sources":["../../../editing/validateValue.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 { CollectionItemDescriptor, PropertyDescriptor, PropertyValueType } from '@cratis/scene.model';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Checks a value against a property descriptor.\n *\n * @param descriptor The property the value is for.\n * @param value The value to check. `undefined` means \"not set\", which is fine unless the property is required.\n * @returns The reason the value is not acceptable, or `undefined` when it is.\n */\nexport function validateValue(descriptor: PropertyDescriptor, value: unknown): string | undefined {\n    const constraints = descriptor.constraints ?? {};\n    if (value === undefined || value === null) {\n        return constraints.required ? 'a value is required' : undefined;\n    }\n\n    switch (descriptor.valueType) {\n        case PropertyValueType.String: {\n            if (typeof value !== 'string') return 'expected a string';\n            if (constraints.minimumLength !== undefined && value.length < constraints.minimumLength) return `must be at least ${constraints.minimumLength} characters`;\n            if (constraints.maximumLength !== undefined && value.length > constraints.maximumLength) return `must be at most ${constraints.maximumLength} characters`;\n            if (constraints.pattern !== undefined && !new RegExp(`^(?:${constraints.pattern})$`).test(value)) return `must match ${constraints.pattern}`;\n            return undefined;\n        }\n\n        case PropertyValueType.Number: {\n            if (typeof value !== 'number' || !Number.isFinite(value)) return 'expected a number';\n            if (constraints.integer && !Number.isInteger(value)) return 'expected a whole number';\n            if (constraints.minimum !== undefined && value < constraints.minimum) return `must be at least ${constraints.minimum}`;\n            if (constraints.maximum !== undefined && value > constraints.maximum) return `must be at most ${constraints.maximum}`;\n            return undefined;\n        }\n\n        case PropertyValueType.Boolean:\n            return typeof value === 'boolean' ? undefined : 'expected true or false';\n\n        case PropertyValueType.Enum:\n            return (descriptor.choices ?? []).some(choice => choice.value === value) ? undefined : 'not one of the allowed choices';\n\n        case PropertyValueType.Icon:\n            if (!isRecord(value) || !isNonEmptyString(value.library) || !isNonEmptyString(value.key)) return 'expected an icon reference with a library and a key';\n            return value.variant === undefined || typeof value.variant === 'string' ? undefined : 'the icon variant must be a string';\n\n        case PropertyValueType.Destination:\n            if (!isRecord(value) || !isNonEmptyString(value.screen)) return 'expected a destination naming a screen';\n            return value.routeParameterBindings === undefined || isRecord(value.routeParameterBindings)\n                ? undefined\n                : 'routeParameterBindings must be an object';\n\n        case PropertyValueType.QueryReference:\n            if (isNonEmptyString(value)) return undefined;\n            if (!isRecord(value) || !isNonEmptyString(value.queryId) || !isNonEmptyString(value.query)) return 'expected a query name or a query binding';\n            return Array.isArray(value.arguments) && Array.isArray(value.results) ? undefined : 'a query binding needs arguments and results lists';\n\n        case PropertyValueType.Collection:\n            return validateCollection(descriptor, value);\n\n        case PropertyValueType.Json:\n            return isJsonValue(value) ? undefined : 'expected a JSON value';\n\n        default:\n            return isRecord(value) || Array.isArray(value) ? undefined : 'expected a structured value';\n    }\n}\n\n/**\n * The deepest nesting a JSON value may have. Authored configuration (chart datasets, option lists) is shallow;\n * the limit turns a runaway or hostile structure into a validation message instead of a stack overflow.\n */\nconst maximumJsonDepth = 64;\n\n/**\n * Whether a value is JSON: `null`, a string, a boolean, a finite number, or an array or plain object of those.\n * The value is only inspected, never serialized, so what an editor stores is exactly what was passed in.\n */\nfunction isJsonValue(value: unknown, parents = new Set<object>()): boolean {\n    if (value === null || typeof value === 'string' || typeof value === 'boolean') return true;\n    if (typeof value === 'number') return Number.isFinite(value);\n    if (typeof value !== 'object' || parents.has(value) || parents.size >= maximumJsonDepth) return false;\n\n    const isArray = Array.isArray(value);\n    const prototype = Object.getPrototypeOf(value);\n    if (isArray ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) return false;\n\n    parents.add(value);\n    const values = isArray ? Array.from({ length: value.length }, (_, index) => (index in value ? value[index] : undefined)) : Object.values(value);\n    const valid = values.every(candidate => isJsonValue(candidate, parents));\n    parents.delete(value);\n    return valid;\n}\n\nfunction validateCollection(descriptor: PropertyDescriptor, value: unknown): string | undefined {\n    if (!Array.isArray(value)) return 'expected a list';\n    const constraints = descriptor.constraints ?? {};\n    if (constraints.minimumItems !== undefined && value.length < constraints.minimumItems) return `needs at least ${constraints.minimumItems} items`;\n    if (constraints.maximumItems !== undefined && value.length > constraints.maximumItems) return `allows at most ${constraints.maximumItems} items`;\n\n    const identities = new Set<string>();\n    for (const item of value) {\n        if (!isRecord(item) || !isNonEmptyString(item.id)) return 'every item needs an id';\n        if (identities.has(item.id)) return `the item id '${item.id}' is used twice`;\n        identities.add(item.id);\n\n        const { id: _identity, ...values } = item;\n        const problem = validateItemValues(descriptor.item, values).at(0);\n        if (problem) return `item '${item.id}': ${problem.field} ${problem.problem}`;\n    }\n\n    return undefined;\n}\n\n/**\n * One field of a collection item that does not fit its descriptor.\n */\nexport interface ItemFieldProblem {\n    field: string;\n    problem: string;\n}\n\n/**\n * Checks a collection item's field values against the collection's item descriptor.\n *\n * @param itemDescriptor What the items look like.\n * @param values The item's field values, keyed by field path.\n * @returns Every field that is unknown or has an unacceptable value.\n */\nexport function validateItemValues(itemDescriptor: CollectionItemDescriptor | undefined, values: Record<string, unknown>): ItemFieldProblem[] {\n    const fields = itemDescriptor?.properties ?? [];\n    const problems: ItemFieldProblem[] = [];\n\n    for (const [field, fieldValue] of Object.entries(values)) {\n        const fieldDescriptor = fields.find(candidate => candidate.path === field);\n        if (!fieldDescriptor) {\n            problems.push({ field, problem: 'is not a field of this collection\\'s items' });\n            continue;\n        }\n\n        const problem = validateValue(fieldDescriptor, fieldValue);\n        if (problem) problems.push({ field, problem });\n    }\n\n    for (const fieldDescriptor of fields) {\n        if (fieldDescriptor.constraints?.required && values[fieldDescriptor.path] === undefined) {\n            problems.push({ field: fieldDescriptor.path, problem: 'a value is required' });\n        }\n    }\n\n    return problems;\n}\n"],"names":["isRecord","value","Array","isArray","isNonEmptyString","length","validateValue","descriptor","constraints","undefined","required","valueType","PropertyValueType","String","minimumLength","maximumLength","pattern","RegExp","test","Number","isFinite","integer","isInteger","minimum","maximum","Boolean","Enum","choices","some","choice","Icon","library","key","variant","Destination","screen","routeParameterBindings","QueryReference","queryId","query","arguments","results","Collection","validateCollection","Json","isJsonValue","maximumJsonDepth","parents","Set","has","size","prototype","Object","getPrototypeOf","add","values","from","_","index","valid","every","candidate","delete","minimumItems","maximumItems","identities","item","id","_identity","problem","validateItemValues","at","field","itemDescriptor","fields","properties","problems","fieldValue","entries","fieldDescriptor","find","path","push"],"mappings":";;;;AAAA;AACA;AAIA,SAASA,SAASC,KAAc,EAAA;IAC5B,OAAOA,KAAAA,KAAU,QAAQ,OAAOA,KAAAA,KAAU,YAAY,CAACC,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAAA;AACzE;AAEA,SAASG,iBAAiBH,KAAc,EAAA;AACpC,IAAA,OAAO,OAAOA,KAAAA,KAAU,QAAA,IAAYA,KAAAA,CAAMI,MAAM,GAAG,CAAA;AACvD;AAEA;;;;;;AAMC,IACM,SAASC,aAAAA,CAAcC,UAA8B,EAAEN,KAAc,EAAA;AACxE,IAAA,MAAMO,WAAAA,GAAcD,UAAAA,CAAWC,WAAW,IAAI,EAAC;IAC/C,IAAIP,KAAAA,KAAUQ,SAAAA,IAAaR,KAAAA,KAAU,IAAA,EAAM;QACvC,OAAOO,WAAAA,CAAYE,QAAQ,GAAG,qBAAA,GAAwBD,SAAAA;AAC1D,IAAA;AAEA,IAAA,OAAQF,WAAWI,SAAS;AACxB,QAAA,KAAKC,8BAAkBC,MAAM;AAAE,YAAA;gBAC3B,IAAI,OAAOZ,KAAAA,KAAU,QAAA,EAAU,OAAO,mBAAA;AACtC,gBAAA,IAAIO,YAAYM,aAAa,KAAKL,aAAaR,KAAAA,CAAMI,MAAM,GAAGG,WAAAA,CAAYM,aAAa,EAAE,OAAO,CAAC,iBAAiB,EAAEN,YAAYM,aAAa,CAAC,WAAW,CAAC;AAC1J,gBAAA,IAAIN,YAAYO,aAAa,KAAKN,aAAaR,KAAAA,CAAMI,MAAM,GAAGG,WAAAA,CAAYO,aAAa,EAAE,OAAO,CAAC,gBAAgB,EAAEP,YAAYO,aAAa,CAAC,WAAW,CAAC;gBACzJ,IAAIP,WAAAA,CAAYQ,OAAO,KAAKP,SAAAA,IAAa,CAAC,IAAIQ,MAAAA,CAAO,CAAC,IAAI,EAAET,WAAAA,CAAYQ,OAAO,CAAC,EAAE,CAAC,CAAA,CAAEE,IAAI,CAACjB,KAAAA,CAAAA,EAAQ,OAAO,CAAC,WAAW,EAAEO,WAAAA,CAAYQ,OAAO,CAAA,CAAE;gBAC5I,OAAOP,SAAAA;AACX,YAAA;AAEA,QAAA,KAAKG,8BAAkBO,MAAM;AAAE,YAAA;gBAC3B,IAAI,OAAOlB,UAAU,QAAA,IAAY,CAACkB,OAAOC,QAAQ,CAACnB,QAAQ,OAAO,mBAAA;gBACjE,IAAIO,WAAAA,CAAYa,OAAO,IAAI,CAACF,OAAOG,SAAS,CAACrB,QAAQ,OAAO,yBAAA;AAC5D,gBAAA,IAAIO,WAAAA,CAAYe,OAAO,KAAKd,SAAAA,IAAaR,QAAQO,WAAAA,CAAYe,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAEf,WAAAA,CAAYe,OAAO,CAAA,CAAE;AACtH,gBAAA,IAAIf,WAAAA,CAAYgB,OAAO,KAAKf,SAAAA,IAAaR,QAAQO,WAAAA,CAAYgB,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAEhB,WAAAA,CAAYgB,OAAO,CAAA,CAAE;gBACrH,OAAOf,SAAAA;AACX,YAAA;AAEA,QAAA,KAAKG,8BAAkBa,OAAO;YAC1B,OAAO,OAAOxB,KAAAA,KAAU,SAAA,GAAYQ,SAAAA,GAAY,wBAAA;AAEpD,QAAA,KAAKG,8BAAkBc,IAAI;AACvB,YAAA,OAAO,CAACnB,UAAAA,CAAWoB,OAAO,IAAI,EAAE,EAAEC,IAAI,CAACC,CAAAA,MAAAA,GAAUA,MAAAA,CAAO5B,KAAK,KAAKA,SAASQ,SAAAA,GAAY,gCAAA;AAE3F,QAAA,KAAKG,8BAAkBkB,IAAI;AACvB,YAAA,IAAI,CAAC9B,QAAAA,CAASC,KAAAA,CAAAA,IAAU,CAACG,gBAAAA,CAAiBH,KAAAA,CAAM8B,OAAO,CAAA,IAAK,CAAC3B,gBAAAA,CAAiBH,KAAAA,CAAM+B,GAAG,GAAG,OAAO,qDAAA;YACjG,OAAO/B,KAAAA,CAAMgC,OAAO,KAAKxB,SAAAA,IAAa,OAAOR,KAAAA,CAAMgC,OAAO,KAAK,QAAA,GAAWxB,SAAAA,GAAY,mCAAA;AAE1F,QAAA,KAAKG,8BAAkBsB,WAAW;YAC9B,IAAI,CAAClC,SAASC,KAAAA,CAAAA,IAAU,CAACG,iBAAiBH,KAAAA,CAAMkC,MAAM,GAAG,OAAO,wCAAA;YAChE,OAAOlC,KAAAA,CAAMmC,sBAAsB,KAAK3B,SAAAA,IAAaT,SAASC,KAAAA,CAAMmC,sBAAsB,IACpF3B,SAAAA,GACA,0CAAA;AAEV,QAAA,KAAKG,8BAAkByB,cAAc;YACjC,IAAIjC,gBAAAA,CAAiBH,QAAQ,OAAOQ,SAAAA;AACpC,YAAA,IAAI,CAACT,QAAAA,CAASC,KAAAA,CAAAA,IAAU,CAACG,gBAAAA,CAAiBH,KAAAA,CAAMqC,OAAO,CAAA,IAAK,CAAClC,gBAAAA,CAAiBH,KAAAA,CAAMsC,KAAK,GAAG,OAAO,0CAAA;AACnG,YAAA,OAAOrC,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAMuC,SAAS,CAAA,IAAKtC,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAMwC,OAAO,CAAA,GAAIhC,SAAAA,GAAY,mDAAA;AAExF,QAAA,KAAKG,8BAAkB8B,UAAU;AAC7B,YAAA,OAAOC,mBAAmBpC,UAAAA,EAAYN,KAAAA,CAAAA;AAE1C,QAAA,KAAKW,8BAAkBgC,IAAI;YACvB,OAAOC,WAAAA,CAAY5C,SAASQ,SAAAA,GAAY,uBAAA;AAE5C,QAAA;AACI,YAAA,OAAOT,SAASC,KAAAA,CAAAA,IAAUC,KAAAA,CAAMC,OAAO,CAACF,SAASQ,SAAAA,GAAY,6BAAA;AACrE;AACJ;AAEA;;;AAGC,IACD,MAAMqC,gBAAAA,GAAmB,EAAA;AAEzB;;;AAGC,IACD,SAASD,WAAAA,CAAY5C,KAAc,EAAE8C,OAAAA,GAAU,IAAIC,GAAAA,EAAa,EAAA;IAC5D,IAAI/C,KAAAA,KAAU,QAAQ,OAAOA,KAAAA,KAAU,YAAY,OAAOA,KAAAA,KAAU,WAAW,OAAO,IAAA;AACtF,IAAA,IAAI,OAAOA,KAAAA,KAAU,QAAA,EAAU,OAAOkB,MAAAA,CAAOC,QAAQ,CAACnB,KAAAA,CAAAA;IACtD,IAAI,OAAOA,KAAAA,KAAU,QAAA,IAAY8C,OAAAA,CAAQE,GAAG,CAAChD,KAAAA,CAAAA,IAAU8C,OAAAA,CAAQG,IAAI,IAAIJ,gBAAAA,EAAkB,OAAO,KAAA;IAEhG,MAAM3C,OAAAA,GAAUD,KAAAA,CAAMC,OAAO,CAACF,KAAAA,CAAAA;IAC9B,MAAMkD,SAAAA,GAAYC,MAAAA,CAAOC,cAAc,CAACpD,KAAAA,CAAAA;IACxC,IAAIE,OAAAA,GAAUgD,SAAAA,KAAcjD,KAAAA,CAAMiD,SAAS,GAAGA,SAAAA,KAAcC,MAAAA,CAAOD,SAAS,IAAIA,SAAAA,KAAc,IAAA,EAAM,OAAO,KAAA;AAE3GJ,IAAAA,OAAAA,CAAQO,GAAG,CAACrD,KAAAA,CAAAA;AACZ,IAAA,MAAMsD,MAAAA,GAASpD,OAAAA,GAAUD,KAAAA,CAAMsD,IAAI,CAAC;AAAEnD,QAAAA,MAAAA,EAAQJ,MAAMI;AAAO,KAAA,EAAG,CAACoD,CAAAA,EAAGC,KAAAA,GAAWA,KAAAA,IAASzD,KAAAA,GAAQA,KAAK,CAACyD,KAAAA,CAAM,GAAGjD,SAAAA,CAAAA,GAAc2C,MAAAA,CAAOG,MAAM,CAACtD,KAAAA,CAAAA;AACzI,IAAA,MAAM0D,QAAQJ,MAAAA,CAAOK,KAAK,CAACC,CAAAA,SAAAA,GAAahB,YAAYgB,SAAAA,EAAWd,OAAAA,CAAAA,CAAAA;AAC/DA,IAAAA,OAAAA,CAAQe,MAAM,CAAC7D,KAAAA,CAAAA;IACf,OAAO0D,KAAAA;AACX;AAEA,SAAShB,kBAAAA,CAAmBpC,UAA8B,EAAEN,KAAc,EAAA;AACtE,IAAA,IAAI,CAACC,KAAAA,CAAMC,OAAO,CAACF,QAAQ,OAAO,iBAAA;AAClC,IAAA,MAAMO,WAAAA,GAAcD,UAAAA,CAAWC,WAAW,IAAI,EAAC;AAC/C,IAAA,IAAIA,YAAYuD,YAAY,KAAKtD,aAAaR,KAAAA,CAAMI,MAAM,GAAGG,WAAAA,CAAYuD,YAAY,EAAE,OAAO,CAAC,eAAe,EAAEvD,YAAYuD,YAAY,CAAC,MAAM,CAAC;AAChJ,IAAA,IAAIvD,YAAYwD,YAAY,KAAKvD,aAAaR,KAAAA,CAAMI,MAAM,GAAGG,WAAAA,CAAYwD,YAAY,EAAE,OAAO,CAAC,eAAe,EAAExD,YAAYwD,YAAY,CAAC,MAAM,CAAC;AAEhJ,IAAA,MAAMC,aAAa,IAAIjB,GAAAA,EAAAA;IACvB,KAAK,MAAMkB,QAAQjE,KAAAA,CAAO;QACtB,IAAI,CAACD,SAASkE,IAAAA,CAAAA,IAAS,CAAC9D,iBAAiB8D,IAAAA,CAAKC,EAAE,GAAG,OAAO,wBAAA;AAC1D,QAAA,IAAIF,UAAAA,CAAWhB,GAAG,CAACiB,IAAAA,CAAKC,EAAE,CAAA,EAAG,OAAO,CAAC,aAAa,EAAED,IAAAA,CAAKC,EAAE,CAAC,eAAe,CAAC;QAC5EF,UAAAA,CAAWX,GAAG,CAACY,IAAAA,CAAKC,EAAE,CAAA;AAEtB,QAAA,MAAM,EAAEA,EAAAA,EAAIC,SAAS,EAAE,GAAGb,QAAQ,GAAGW,IAAAA;AACrC,QAAA,MAAMG,UAAUC,kBAAAA,CAAmB/D,UAAAA,CAAW2D,IAAI,EAAEX,MAAAA,CAAAA,CAAQgB,EAAE,CAAC,CAAA,CAAA;AAC/D,QAAA,IAAIF,SAAS,OAAO,CAAC,MAAM,EAAEH,KAAKC,EAAE,CAAC,GAAG,EAAEE,QAAQG,KAAK,CAAC,CAAC,EAAEH,OAAAA,CAAQA,OAAO,CAAA,CAAE;AAChF,IAAA;IAEA,OAAO5D,SAAAA;AACX;AAUA;;;;;;AAMC,IACM,SAAS6D,kBAAAA,CAAmBG,cAAoD,EAAElB,MAA+B,EAAA;IACpH,MAAMmB,MAAAA,GAASD,cAAAA,EAAgBE,UAAAA,IAAc,EAAE;AAC/C,IAAA,MAAMC,WAA+B,EAAE;IAEvC,KAAK,MAAM,CAACJ,KAAAA,EAAOK,UAAAA,CAAW,IAAIzB,MAAAA,CAAO0B,OAAO,CAACvB,MAAAA,CAAAA,CAAS;QACtD,MAAMwB,eAAAA,GAAkBL,OAAOM,IAAI,CAACnB,CAAAA,SAAAA,GAAaA,SAAAA,CAAUoB,IAAI,KAAKT,KAAAA,CAAAA;AACpE,QAAA,IAAI,CAACO,eAAAA,EAAiB;AAClBH,YAAAA,QAAAA,CAASM,IAAI,CAAC;AAAEV,gBAAAA,KAAAA;gBAAOH,OAAAA,EAAS;AAA6C,aAAA,CAAA;AAC7E,YAAA;AACJ,QAAA;QAEA,MAAMA,OAAAA,GAAU/D,cAAcyE,eAAAA,EAAiBF,UAAAA,CAAAA;QAC/C,IAAIR,OAAAA,EAASO,QAAAA,CAASM,IAAI,CAAC;AAAEV,YAAAA,KAAAA;AAAOH,YAAAA;AAAQ,SAAA,CAAA;AAChD,IAAA;IAEA,KAAK,MAAMU,mBAAmBL,MAAAA,CAAQ;QAClC,IAAIK,eAAAA,CAAgBvE,WAAW,EAAEE,QAAAA,IAAY6C,MAAM,CAACwB,eAAAA,CAAgBE,IAAI,CAAC,KAAKxE,SAAAA,EAAW;AACrFmE,YAAAA,QAAAA,CAASM,IAAI,CAAC;AAAEV,gBAAAA,KAAAA,EAAOO,gBAAgBE,IAAI;gBAAEZ,OAAAA,EAAS;AAAsB,aAAA,CAAA;AAChF,QAAA;AACJ,IAAA;IAEA,OAAOO,QAAAA;AACX;;;"}
+{"version":3,"file":"validateValue.js","sources":["../../../editing/validateValue.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 { BindingSourceKind, CollectionItemDescriptor, PropertyDescriptor, PropertyValueType } from '@cratis/scene.model';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Checks a value against a property descriptor.\n *\n * @param descriptor The property the value is for.\n * @param value The value to check. `undefined` means \"not set\", which is fine unless the property is required.\n * @returns The reason the value is not acceptable, or `undefined` when it is.\n */\nexport function validateValue(descriptor: PropertyDescriptor, value: unknown): string | undefined {\n    const constraints = descriptor.constraints ?? {};\n    if (value === undefined || value === null) {\n        return constraints.required ? 'a value is required' : undefined;\n    }\n\n    const binding = bindingKindOf(value);\n    if (binding !== undefined && descriptor.acceptedBindingKinds !== undefined) {\n        return descriptor.acceptedBindingKinds.includes(binding.kind)\n            ? undefined\n            : `a ${binding.kind} binding is not accepted here; use ${descriptor.acceptedBindingKinds.join(' or ')}`;\n    }\n\n    switch (descriptor.valueType) {\n        case PropertyValueType.String: {\n            if (typeof value !== 'string') return 'expected a string';\n            if (constraints.minimumLength !== undefined && value.length < constraints.minimumLength) return `must be at least ${constraints.minimumLength} characters`;\n            if (constraints.maximumLength !== undefined && value.length > constraints.maximumLength) return `must be at most ${constraints.maximumLength} characters`;\n            if (constraints.pattern !== undefined && !new RegExp(`^(?:${constraints.pattern})$`).test(value)) return `must match ${constraints.pattern}`;\n            return undefined;\n        }\n\n        case PropertyValueType.Number: {\n            if (typeof value !== 'number' || !Number.isFinite(value)) return 'expected a number';\n            if (constraints.integer && !Number.isInteger(value)) return 'expected a whole number';\n            if (constraints.minimum !== undefined && value < constraints.minimum) return `must be at least ${constraints.minimum}`;\n            if (constraints.maximum !== undefined && value > constraints.maximum) return `must be at most ${constraints.maximum}`;\n            return undefined;\n        }\n\n        case PropertyValueType.Boolean:\n            return typeof value === 'boolean' ? undefined : 'expected true or false';\n\n        case PropertyValueType.Enum:\n            return (descriptor.choices ?? []).some(choice => choice.value === value) ? undefined : 'not one of the allowed choices';\n\n        case PropertyValueType.Icon:\n            if (!isRecord(value) || !isNonEmptyString(value.library) || !isNonEmptyString(value.key)) return 'expected an icon reference with a library and a key';\n            return value.variant === undefined || typeof value.variant === 'string' ? undefined : 'the icon variant must be a string';\n\n        case PropertyValueType.Destination:\n            if (!isRecord(value) || !isNonEmptyString(value.screen)) return 'expected a destination naming a screen';\n            return value.routeParameterBindings === undefined || isRecord(value.routeParameterBindings)\n                ? undefined\n                : 'routeParameterBindings must be an object';\n\n        case PropertyValueType.QueryReference:\n            if (isNonEmptyString(value)) return undefined;\n            if (!isRecord(value) || !isNonEmptyString(value.queryId) || !isNonEmptyString(value.query)) return 'expected a query name or a query binding';\n            return Array.isArray(value.arguments) && Array.isArray(value.results) ? undefined : 'a query binding needs arguments and results lists';\n\n        case PropertyValueType.Collection:\n            return validateCollection(descriptor, value);\n\n        case PropertyValueType.Json:\n            return isJsonValue(value) ? undefined : 'expected a JSON value';\n\n        default:\n            return isRecord(value) || Array.isArray(value) ? undefined : 'expected a structured value';\n    }\n}\n\n/**\n * The deepest nesting a JSON value may have. Authored configuration (chart datasets, option lists) is shallow;\n * the limit turns a runaway or hostile structure into a validation message instead of a stack overflow.\n */\nconst bindingKinds = new Set<string>(Object.values(BindingSourceKind));\n\n/**\n * The source kind of a value that is a typed binding expression - an object with a known `kind` and a\n * string `path` - rather than a value of the property's own type. Only consulted for properties that declare\n * `acceptedBindingKinds`, so a collection property such as a command form's `inputs` can be bound to a\n * table's `selectedItem` instead of listing its items.\n */\nfunction bindingKindOf(value: unknown): { kind: BindingSourceKind } | undefined {\n    if (!isRecord(value) || typeof value.kind !== 'string' || !bindingKinds.has(value.kind) || typeof value.path !== 'string') return undefined;\n    return { kind: value.kind as BindingSourceKind };\n}\n\nconst maximumJsonDepth = 64;\n\n/**\n * Whether a value is JSON: `null`, a string, a boolean, a finite number, or an array or plain object of those.\n * The value is only inspected, never serialized, so what an editor stores is exactly what was passed in.\n */\nfunction isJsonValue(value: unknown, parents = new Set<object>()): boolean {\n    if (value === null || typeof value === 'string' || typeof value === 'boolean') return true;\n    if (typeof value === 'number') return Number.isFinite(value);\n    if (typeof value !== 'object' || parents.has(value) || parents.size >= maximumJsonDepth) return false;\n\n    const isArray = Array.isArray(value);\n    const prototype = Object.getPrototypeOf(value);\n    if (isArray ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) return false;\n\n    parents.add(value);\n    const values = isArray ? Array.from({ length: value.length }, (_, index) => (index in value ? value[index] : undefined)) : Object.values(value);\n    const valid = values.every(candidate => isJsonValue(candidate, parents));\n    parents.delete(value);\n    return valid;\n}\n\nfunction validateCollection(descriptor: PropertyDescriptor, value: unknown): string | undefined {\n    if (!Array.isArray(value)) return 'expected a list';\n    const constraints = descriptor.constraints ?? {};\n    if (constraints.minimumItems !== undefined && value.length < constraints.minimumItems) return `needs at least ${constraints.minimumItems} items`;\n    if (constraints.maximumItems !== undefined && value.length > constraints.maximumItems) return `allows at most ${constraints.maximumItems} items`;\n\n    const identities = new Set<string>();\n    for (const item of value) {\n        if (!isRecord(item) || !isNonEmptyString(item.id)) return 'every item needs an id';\n        if (identities.has(item.id)) return `the item id '${item.id}' is used twice`;\n        identities.add(item.id);\n\n        const { id: _identity, ...values } = item;\n        const problem = validateItemValues(descriptor.item, values).at(0);\n        if (problem) return `item '${item.id}': ${problem.field} ${problem.problem}`;\n    }\n\n    return undefined;\n}\n\n/**\n * One field of a collection item that does not fit its descriptor.\n */\nexport interface ItemFieldProblem {\n    field: string;\n    problem: string;\n}\n\n/**\n * Checks a collection item's field values against the collection's item descriptor.\n *\n * @param itemDescriptor What the items look like.\n * @param values The item's field values, keyed by field path.\n * @returns Every field that is unknown or has an unacceptable value.\n */\nexport function validateItemValues(itemDescriptor: CollectionItemDescriptor | undefined, values: Record<string, unknown>): ItemFieldProblem[] {\n    const fields = itemDescriptor?.properties ?? [];\n    const problems: ItemFieldProblem[] = [];\n\n    for (const [field, fieldValue] of Object.entries(values)) {\n        const fieldDescriptor = fields.find(candidate => candidate.path === field);\n        if (!fieldDescriptor) {\n            problems.push({ field, problem: 'is not a field of this collection\\'s items' });\n            continue;\n        }\n\n        const problem = validateValue(fieldDescriptor, fieldValue);\n        if (problem) problems.push({ field, problem });\n    }\n\n    for (const fieldDescriptor of fields) {\n        if (fieldDescriptor.constraints?.required && values[fieldDescriptor.path] === undefined) {\n            problems.push({ field: fieldDescriptor.path, problem: 'a value is required' });\n        }\n    }\n\n    return problems;\n}\n"],"names":["isRecord","value","Array","isArray","isNonEmptyString","length","validateValue","descriptor","constraints","undefined","required","binding","bindingKindOf","acceptedBindingKinds","includes","kind","join","valueType","PropertyValueType","String","minimumLength","maximumLength","pattern","RegExp","test","Number","isFinite","integer","isInteger","minimum","maximum","Boolean","Enum","choices","some","choice","Icon","library","key","variant","Destination","screen","routeParameterBindings","QueryReference","queryId","query","arguments","results","Collection","validateCollection","Json","isJsonValue","bindingKinds","Set","Object","values","BindingSourceKind","has","path","maximumJsonDepth","parents","size","prototype","getPrototypeOf","add","from","_","index","valid","every","candidate","delete","minimumItems","maximumItems","identities","item","id","_identity","problem","validateItemValues","at","field","itemDescriptor","fields","properties","problems","fieldValue","entries","fieldDescriptor","find","push"],"mappings":"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"}

package/dist/cjs/forms/CommandFormLayoutKey.js

@@ -0,0 +1,14 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The keys a designer maps to layout moves and resizes. */ var CommandFormLayoutKey = /*#__PURE__*/ function(CommandFormLayoutKey) {
+    CommandFormLayoutKey["ArrowLeft"] = "ArrowLeft";
+    CommandFormLayoutKey["ArrowRight"] = "ArrowRight";
+    CommandFormLayoutKey["ArrowUp"] = "ArrowUp";
+    CommandFormLayoutKey["ArrowDown"] = "ArrowDown";
+    return CommandFormLayoutKey;
+}({});
+
+exports.CommandFormLayoutKey = CommandFormLayoutKey;
+//# sourceMappingURL=CommandFormLayoutKey.js.map

package/dist/cjs/forms/CommandFormLayoutKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormLayoutKey.js","sources":["../../../forms/CommandFormLayoutKey.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\n/** The keys a designer maps to layout moves and resizes. */\nexport enum CommandFormLayoutKey {\n    ArrowLeft = 'ArrowLeft',\n    ArrowRight = 'ArrowRight',\n    ArrowUp = 'ArrowUp',\n    ArrowDown = 'ArrowDown',\n}\n"],"names":["CommandFormLayoutKey"],"mappings":";;AAAA;AACA;AAEA,6DACO,IAAKA,oBAAAA,iBAAAA,SAAAA,oBAAAA,EAAAA;;;;;AAAAA,IAAAA,OAAAA,oBAAAA;AAKX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/forms/applyCommandFormLayoutKey.js

@@ -0,0 +1,72 @@
+'use strict';
+
+var CommandFormLayoutKey = require('./CommandFormLayoutKey.js');
+var updateCommandFormFieldPlacement = require('./updateCommandFormFieldPlacement.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Moves or resizes one field from the keyboard, so the layout can be arranged without a pointer.
+ *
+ * An arrow key moves the field one cell; with `resize`, Left and Right narrow and widen its column span and
+ * Up and Down shorten and lengthen its row span. Positions are one-based and never go below one, and spans never below one.
+ * The result is a draft validated like any other placement change, so a move or resize past the last
+ * column is reported in its diagnostics and the committed layout is kept. Returns undefined for a field that is not placed.
+ */ function applyCommandFormLayoutKey(committed, field, key, resize = false, fields = []) {
+    const placement = committed.placements.find((candidate)=>candidate.field === field);
+    if (!placement) return undefined;
+    return updateCommandFormFieldPlacement.updateCommandFormFieldPlacement(committed, resize ? resized(placement, key) : moved(placement, key), fields);
+}
+function moved(placement, key) {
+    switch(key){
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowLeft:
+            return {
+                ...placement,
+                column: Math.max(1, placement.column - 1)
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowRight:
+            return {
+                ...placement,
+                column: placement.column + 1
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowUp:
+            return {
+                ...placement,
+                row: Math.max(1, placement.row - 1)
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowDown:
+            return {
+                ...placement,
+                row: placement.row + 1
+            };
+    }
+}
+function resized(placement, key) {
+    const columnSpan = placement.columnSpan ?? 1;
+    const rowSpan = placement.rowSpan ?? 1;
+    switch(key){
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowLeft:
+            return {
+                ...placement,
+                columnSpan: Math.max(1, columnSpan - 1)
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowRight:
+            return {
+                ...placement,
+                columnSpan: columnSpan + 1
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowUp:
+            return {
+                ...placement,
+                rowSpan: Math.max(1, rowSpan - 1)
+            };
+        case CommandFormLayoutKey.CommandFormLayoutKey.ArrowDown:
+            return {
+                ...placement,
+                rowSpan: rowSpan + 1
+            };
+    }
+}
+
+exports.applyCommandFormLayoutKey = applyCommandFormLayoutKey;
+//# sourceMappingURL=applyCommandFormLayoutKey.js.map

package/dist/cjs/forms/applyCommandFormLayoutKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyCommandFormLayoutKey.js","sources":["../../../forms/applyCommandFormLayoutKey.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 { CommandFormLayout, FormFieldPlacement } from '@cratis/scene.model';\nimport { CommandFormLayoutDraft } from './CommandFormLayoutDraft';\nimport { CommandFormLayoutKey } from './CommandFormLayoutKey';\nimport { updateCommandFormFieldPlacement } from './updateCommandFormFieldPlacement';\n\n/**\n * Moves or resizes one field from the keyboard, so the layout can be arranged without a pointer.\n *\n * An arrow key moves the field one cell; with `resize`, Left and Right narrow and widen its column span and\n * Up and Down shorten and lengthen its row span. Positions are one-based and never go below one, and spans never below one.\n * The result is a draft validated like any other placement change, so a move or resize past the last\n * column is reported in its diagnostics and the committed layout is kept. Returns undefined for a field that is not placed.\n */\nexport function applyCommandFormLayoutKey(\n    committed: CommandFormLayout,\n    field: string,\n    key: CommandFormLayoutKey,\n    resize = false,\n    fields: readonly string[] = [],\n): CommandFormLayoutDraft | undefined {\n    const placement = committed.placements.find(candidate => candidate.field === field);\n    if (!placement) return undefined;\n    return updateCommandFormFieldPlacement(committed, resize ? resized(placement, key) : moved(placement, key), fields);\n}\n\nfunction moved(placement: FormFieldPlacement, key: CommandFormLayoutKey): FormFieldPlacement {\n    switch (key) {\n        case CommandFormLayoutKey.ArrowLeft: return { ...placement, column: Math.max(1, placement.column - 1) };\n        case CommandFormLayoutKey.ArrowRight: return { ...placement, column: placement.column + 1 };\n        case CommandFormLayoutKey.ArrowUp: return { ...placement, row: Math.max(1, placement.row - 1) };\n        case CommandFormLayoutKey.ArrowDown: return { ...placement, row: placement.row + 1 };\n    }\n}\n\nfunction resized(placement: FormFieldPlacement, key: CommandFormLayoutKey): FormFieldPlacement {\n    const columnSpan = placement.columnSpan ?? 1;\n    const rowSpan = placement.rowSpan ?? 1;\n    switch (key) {\n        case CommandFormLayoutKey.ArrowLeft: return { ...placement, columnSpan: Math.max(1, columnSpan - 1) };\n        case CommandFormLayoutKey.ArrowRight: return { ...placement, columnSpan: columnSpan + 1 };\n        case CommandFormLayoutKey.ArrowUp: return { ...placement, rowSpan: Math.max(1, rowSpan - 1) };\n        case CommandFormLayoutKey.ArrowDown: return { ...placement, rowSpan: rowSpan + 1 };\n    }\n}\n"],"names":["applyCommandFormLayoutKey","committed","field","key","resize","fields","placement","placements","find","candidate","undefined","updateCommandFormFieldPlacement","resized","moved","CommandFormLayoutKey","ArrowLeft","column","Math","max","ArrowRight","ArrowUp","row","ArrowDown","columnSpan","rowSpan"],"mappings":";;;;;AAAA;AACA;AAOA;;;;;;;AAOC,IACM,SAASA,yBAAAA,CACZC,SAA4B,EAC5BC,KAAa,EACbC,GAAyB,EACzBC,MAAAA,GAAS,KAAK,EACdC,SAA4B,EAAE,EAAA;IAE9B,MAAMC,SAAAA,GAAYL,SAAAA,CAAUM,UAAU,CAACC,IAAI,CAACC,CAAAA,SAAAA,GAAaA,SAAAA,CAAUP,KAAK,KAAKA,KAAAA,CAAAA;IAC7E,IAAI,CAACI,WAAW,OAAOI,SAAAA;IACvB,OAAOC,+DAAAA,CAAgCV,WAAWG,MAAAA,GAASQ,OAAAA,CAAQN,WAAWH,GAAAA,CAAAA,GAAOU,KAAAA,CAAMP,WAAWH,GAAAA,CAAAA,EAAME,MAAAA,CAAAA;AAChH;AAEA,SAASQ,KAAAA,CAAMP,SAA6B,EAAEH,GAAyB,EAAA;IACnE,OAAQA,GAAAA;AACJ,QAAA,KAAKW,0CAAqBC,SAAS;YAAE,OAAO;AAAE,gBAAA,GAAGT,SAAS;AAAEU,gBAAAA,MAAAA,EAAQC,KAAKC,GAAG,CAAC,CAAA,EAAGZ,SAAAA,CAAUU,MAAM,GAAG,CAAA;AAAG,aAAA;AACtG,QAAA,KAAKF,0CAAqBK,UAAU;YAAE,OAAO;AAAE,gBAAA,GAAGb,SAAS;gBAAEU,MAAAA,EAAQV,SAAAA,CAAUU,MAAM,GAAG;AAAE,aAAA;AAC1F,QAAA,KAAKF,0CAAqBM,OAAO;YAAE,OAAO;AAAE,gBAAA,GAAGd,SAAS;AAAEe,gBAAAA,GAAAA,EAAKJ,KAAKC,GAAG,CAAC,CAAA,EAAGZ,SAAAA,CAAUe,GAAG,GAAG,CAAA;AAAG,aAAA;AAC9F,QAAA,KAAKP,0CAAqBQ,SAAS;YAAE,OAAO;AAAE,gBAAA,GAAGhB,SAAS;gBAAEe,GAAAA,EAAKf,SAAAA,CAAUe,GAAG,GAAG;AAAE,aAAA;AACvF;AACJ;AAEA,SAAST,OAAAA,CAAQN,SAA6B,EAAEH,GAAyB,EAAA;IACrE,MAAMoB,UAAAA,GAAajB,SAAAA,CAAUiB,UAAU,IAAI,CAAA;IAC3C,MAAMC,OAAAA,GAAUlB,SAAAA,CAAUkB,OAAO,IAAI,CAAA;IACrC,OAAQrB,GAAAA;AACJ,QAAA,KAAKW,0CAAqBC,SAAS;YAAE,OAAO;AAAE,gBAAA,GAAGT,SAAS;AAAEiB,gBAAAA,UAAAA,EAAYN,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAGK,UAAAA,GAAa,CAAA;AAAG,aAAA;AACpG,QAAA,KAAKT,0CAAqBK,UAAU;YAAE,OAAO;AAAE,gBAAA,GAAGb,SAAS;AAAEiB,gBAAAA,UAAAA,EAAYA,UAAAA,GAAa;AAAE,aAAA;AACxF,QAAA,KAAKT,0CAAqBM,OAAO;YAAE,OAAO;AAAE,gBAAA,GAAGd,SAAS;AAAEkB,gBAAAA,OAAAA,EAASP,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAGM,OAAAA,GAAU,CAAA;AAAG,aAAA;AAC5F,QAAA,KAAKV,0CAAqBQ,SAAS;YAAE,OAAO;AAAE,gBAAA,GAAGhB,SAAS;AAAEkB,gBAAAA,OAAAA,EAASA,OAAAA,GAAU;AAAE,aAAA;AACrF;AACJ;;"}

package/dist/cjs/forms/stackCommandFormLayout.js

@@ -0,0 +1,37 @@
+'use strict';
+
+var scene_model = require('@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.
+/**
+ * The layout a command form uses at a compact width: one full-width column, every field on its own row,
+ * in reading order - row first, then column, then authored order. Spans and per-field widths are dropped
+ * because there is nothing to span. The authored layout is not changed, so the form returns to its columns
+ * at a regular width.
+ */ function stackCommandFormLayout(layout) {
+    const ordered = layout.placements.map((placement, order)=>({
+            placement,
+            order
+        })).sort((left, right)=>left.placement.row - right.placement.row || left.placement.column - right.placement.column || left.order - right.order);
+    return {
+        ...layout,
+        columns: [
+            {
+                index: 1,
+                width: {
+                    unit: scene_model.FormWidthUnit.Fraction,
+                    value: 1
+                }
+            }
+        ],
+        placements: ordered.map(({ placement }, index)=>({
+                field: placement.field,
+                row: index + 1,
+                column: 1
+            }))
+    };
+}
+
+exports.stackCommandFormLayout = stackCommandFormLayout;
+//# sourceMappingURL=stackCommandFormLayout.js.map

package/dist/cjs/forms/stackCommandFormLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stackCommandFormLayout.js","sources":["../../../forms/stackCommandFormLayout.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 { CommandFormLayout, FormWidthUnit } from '@cratis/scene.model';\n\n/**\n * The layout a command form uses at a compact width: one full-width column, every field on its own row,\n * in reading order - row first, then column, then authored order. Spans and per-field widths are dropped\n * because there is nothing to span. The authored layout is not changed, so the form returns to its columns\n * at a regular width.\n */\nexport function stackCommandFormLayout(layout: CommandFormLayout): CommandFormLayout {\n    const ordered = layout.placements\n        .map((placement, order) => ({ placement, order }))\n        .sort((left, right) => left.placement.row - right.placement.row || left.placement.column - right.placement.column || left.order - right.order);\n\n    return {\n        ...layout,\n        columns: [{ index: 1, width: { unit: FormWidthUnit.Fraction, value: 1 } }],\n        placements: ordered.map(({ placement }, index) => ({ field: placement.field, row: index + 1, column: 1 })),\n    };\n}\n"],"names":["stackCommandFormLayout","layout","ordered","placements","map","placement","order","sort","left","right","row","column","columns","index","width","unit","FormWidthUnit","Fraction","value","field"],"mappings":";;;;AAAA;AACA;AAIA;;;;;IAMO,SAASA,sBAAAA,CAAuBC,MAAyB,EAAA;IAC5D,MAAMC,OAAAA,GAAUD,OAAOE,UAAU,CAC5BC,GAAG,CAAC,CAACC,SAAAA,EAAWC,KAAAA,IAAW;AAAED,YAAAA,SAAAA;AAAWC,YAAAA;AAAM,SAAA,CAAA,CAAA,CAC9CC,IAAI,CAAC,CAACC,IAAAA,EAAMC,KAAAA,GAAUD,IAAAA,CAAKH,SAAS,CAACK,GAAG,GAAGD,KAAAA,CAAMJ,SAAS,CAACK,GAAG,IAAIF,IAAAA,CAAKH,SAAS,CAACM,MAAM,GAAGF,KAAAA,CAAMJ,SAAS,CAACM,MAAM,IAAIH,IAAAA,CAAKF,KAAK,GAAGG,MAAMH,KAAK,CAAA;IAEjJ,OAAO;AACH,QAAA,GAAGL,MAAM;QACTW,OAAAA,EAAS;AAAC,YAAA;gBAAEC,KAAAA,EAAO,CAAA;gBAAGC,KAAAA,EAAO;AAAEC,oBAAAA,IAAAA,EAAMC,0BAAcC,QAAQ;oBAAEC,KAAAA,EAAO;AAAE;AAAE;AAAE,SAAA;QAC1Ef,UAAAA,EAAYD,OAAAA,CAAQE,GAAG,CAAC,CAAC,EAAEC,SAAS,EAAE,EAAEQ,KAAAA,IAAW;AAAEM,gBAAAA,KAAAA,EAAOd,UAAUc,KAAK;AAAET,gBAAAA,GAAAA,EAAKG,KAAAA,GAAQ,CAAA;gBAAGF,MAAAA,EAAQ;aAAE,CAAA;AAC3G,KAAA;AACJ;;"}

package/dist/cjs/index.js

@@ -1,6 +1,10 @@
 'use strict';
 
 var resolveBindingExpression = require('./resolveBindingExpression.js');
+var nestBindingScope = require('./nestBindingScope.js');
+var resolveArgumentSource = require('./resolveArgumentSource.js');
+var removeComponentOutputs = require('./removeComponentOutputs.js');
+var QueryBindingState = require('./QueryBindingState.js');
 var validateBindingExpression = require('./validateBindingExpression.js');
 var renderElement = require('./renderElement.js');
 var CommandFormLayoutDiagnosticCode = require('./forms/CommandFormLayoutDiagnosticCode.js');
@@ -13,6 +17,9 @@ var preserveDirtyCommandValues = require('./forms/preserveDirtyCommandValues.js'
 var resizeCommandFormColumn = require('./forms/resizeCommandFormColumn.js');
 var updateCommandFormFieldPlacement = require('./forms/updateCommandFormFieldPlacement.js');
 var validateCommandFormLayout = require('./forms/validateCommandFormLayout.js');
+var CommandFormLayoutKey = require('./forms/CommandFormLayoutKey.js');
+var applyCommandFormLayoutKey = require('./forms/applyCommandFormLayoutKey.js');
+var stackCommandFormLayout = require('./forms/stackCommandFormLayout.js');
 var elementKind = require('./elementKind.js');
 var panelKind = require('./panelKind.js');
 var flowNodeKind = require('./flowNodeKind.js');
@@ -69,6 +76,11 @@ var collectIconUsages = require('./editing/collectIconUsages.js');
 
 exports.createBindingResolver = resolveBindingExpression.createBindingResolver;
 exports.resolveBindingExpression = resolveBindingExpression.resolveBindingExpression;
+exports.nestBindingScope = nestBindingScope.nestBindingScope;
+exports.componentArgumentSourcePrefix = resolveArgumentSource.componentArgumentSourcePrefix;
+exports.resolveArgumentSource = resolveArgumentSource.resolveArgumentSource;
+exports.removeComponentOutputs = removeComponentOutputs.removeComponentOutputs;
+exports.QueryBindingState = QueryBindingState.QueryBindingState;
 exports.validateBindingExpression = validateBindingExpression.validateBindingExpression;
 exports.renderElement = renderElement.renderElement;
 exports.CommandFormLayoutDiagnosticCode = CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode;
@@ -81,6 +93,9 @@ exports.preserveDirtyCommandValues = preserveDirtyCommandValues.preserveDirtyCom
 exports.resizeCommandFormColumn = resizeCommandFormColumn.resizeCommandFormColumn;
 exports.updateCommandFormFieldPlacement = updateCommandFormFieldPlacement.updateCommandFormFieldPlacement;
 exports.validateCommandFormLayout = validateCommandFormLayout.validateCommandFormLayout;
+exports.CommandFormLayoutKey = CommandFormLayoutKey.CommandFormLayoutKey;
+exports.applyCommandFormLayoutKey = applyCommandFormLayoutKey.applyCommandFormLayoutKey;
+exports.stackCommandFormLayout = stackCommandFormLayout.stackCommandFormLayout;
 exports.isContentControl = elementKind.isContentControl;
 exports.isExternalComponent = elementKind.isExternalComponent;
 exports.isItemsControl = elementKind.isItemsControl;

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/nestBindingScope.js

@@ -0,0 +1,26 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The scope a nested template or region sees. A data context it declares replaces the inherited one - a
+ * detail region bound to the selected row reads that row, not the screen's - while query results and
+ * component outputs are inherited, with its own entries shadowing the parent's of the same name. A null
+ * data context inherits, as in the C# engine, which cannot tell null from absent. The parent scope is not
+ * changed.
+ */ function nestBindingScope(parent, nested) {
+    return {
+        dataContext: nested.dataContext ?? parent.dataContext,
+        queryResults: {
+            ...parent.queryResults ?? {},
+            ...nested.queryResults ?? {}
+        },
+        componentOutputs: {
+            ...parent.componentOutputs ?? {},
+            ...nested.componentOutputs ?? {}
+        }
+    };
+}
+
+exports.nestBindingScope = nestBindingScope;
+//# sourceMappingURL=nestBindingScope.js.map

package/dist/cjs/nestBindingScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestBindingScope.js","sources":["../../nestBindingScope.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 { BindingScope } from './BindingScope';\n\n/**\n * The scope a nested template or region sees. A data context it declares replaces the inherited one - a\n * detail region bound to the selected row reads that row, not the screen's - while query results and\n * component outputs are inherited, with its own entries shadowing the parent's of the same name. A null\n * data context inherits, as in the C# engine, which cannot tell null from absent. The parent scope is not\n * changed.\n */\nexport function nestBindingScope(parent: BindingScope, nested: BindingScope): BindingScope {\n    return {\n        dataContext: nested.dataContext ?? parent.dataContext,\n        queryResults: { ...(parent.queryResults ?? {}), ...(nested.queryResults ?? {}) },\n        componentOutputs: { ...(parent.componentOutputs ?? {}), ...(nested.componentOutputs ?? {}) },\n    };\n}\n"],"names":["nestBindingScope","parent","nested","dataContext","queryResults","componentOutputs"],"mappings":";;AAAA;AACA;AAIA;;;;;;AAMC,IACM,SAASA,gBAAAA,CAAiBC,MAAoB,EAAEC,MAAoB,EAAA;IACvE,OAAO;AACHC,QAAAA,WAAAA,EAAaD,MAAAA,CAAOC,WAAW,IAAIF,MAAAA,CAAOE,WAAW;QACrDC,YAAAA,EAAc;AAAE,YAAA,GAAIH,MAAAA,CAAOG,YAAY,IAAI,EAAE;AAAG,YAAA,GAAIF,MAAAA,CAAOE,YAAY,IAAI;AAAI,SAAA;QAC/EC,gBAAAA,EAAkB;AAAE,YAAA,GAAIJ,MAAAA,CAAOI,gBAAgB,IAAI,EAAE;AAAG,YAAA,GAAIH,MAAAA,CAAOG,gBAAgB,IAAI;AAAI;AAC/F,KAAA;AACJ;;"}

package/dist/cjs/removeComponentOutputs.js

@@ -0,0 +1,19 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The scope after elements leave the tree - unmounted, deleted or renamed to a new id. Their output
+ * properties are removed, so a binding to them resolves as absent and validates as `unknownComponent`
+ * instead of reading a value from an element that no longer exists.
+ */ function removeComponentOutputs(scope, elementIds) {
+    const removed = new Set(elementIds);
+    const componentOutputs = Object.fromEntries(Object.entries(scope.componentOutputs ?? {}).filter(([id])=>!removed.has(id)));
+    return {
+        ...scope,
+        componentOutputs
+    };
+}
+
+exports.removeComponentOutputs = removeComponentOutputs;
+//# sourceMappingURL=removeComponentOutputs.js.map

package/dist/cjs/removeComponentOutputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeComponentOutputs.js","sources":["../../removeComponentOutputs.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 { BindingScope } from './BindingScope';\n\n/**\n * The scope after elements leave the tree - unmounted, deleted or renamed to a new id. Their output\n * properties are removed, so a binding to them resolves as absent and validates as `unknownComponent`\n * instead of reading a value from an element that no longer exists.\n */\nexport function removeComponentOutputs(scope: BindingScope, elementIds: string[]): BindingScope {\n    const removed = new Set(elementIds);\n    const componentOutputs = Object.fromEntries(Object.entries(scope.componentOutputs ?? {}).filter(([id]) => !removed.has(id)));\n    return { ...scope, componentOutputs };\n}\n"],"names":["removeComponentOutputs","scope","elementIds","removed","Set","componentOutputs","Object","fromEntries","entries","filter","id","has"],"mappings":";;AAAA;AACA;AAIA;;;;AAIC,IACM,SAASA,sBAAAA,CAAuBC,KAAmB,EAAEC,UAAoB,EAAA;IAC5E,MAAMC,OAAAA,GAAU,IAAIC,GAAAA,CAAIF,UAAAA,CAAAA;IACxB,MAAMG,gBAAAA,GAAmBC,OAAOC,WAAW,CAACD,OAAOE,OAAO,CAACP,MAAMI,gBAAgB,IAAI,EAAC,CAAA,CAAGI,MAAM,CAAC,CAAC,CAACC,GAAG,GAAK,CAACP,OAAAA,CAAQQ,GAAG,CAACD,EAAAA,CAAAA,CAAAA,CAAAA;IACvH,OAAO;AAAE,QAAA,GAAGT,KAAK;AAAEI,QAAAA;AAAiB,KAAA;AACxC;;"}