@cratis/scene.engine 4.14.0 → 4.16.0

package/dist/cjs/resolveArgumentSource.js

@@ -0,0 +1,36 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var resolveBindingExpression = require('./resolveBindingExpression.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The prefix of an argument source that reads another element's output. */ const componentArgumentSourcePrefix = 'component.';
+/**
+ * Resolves where a command argument comes from, as an action's argument mapping writes it.
+ *
+ * `component.<id>.<output>` reads an output another element publishes - an input's `value`, a table's
+ * `selectedItem.id` - from the same output scope a `componentProperty` binding reads. Element ids may contain
+ * dots, so the longest id with outputs in scope wins: `component.order.lines.value` reads `value` of
+ * `order.lines` when that element exists. Any other source is a path in the data context. An empty source,
+ * or an element with no outputs in scope, resolves as absent.
+ *
+ * The C# engine (`ArgumentSources.Resolve`) behaves identically; both run `argument-source-fixtures.json`.
+ */ function resolveArgumentSource(source, scope) {
+    if (!source) return undefined;
+    if (!source.startsWith(componentArgumentSourcePrefix)) return resolveBindingExpression.resolveBindingExpression({
+        path: source
+    }, scope);
+    const reference = source.substring(componentArgumentSourcePrefix.length);
+    const componentId = Object.keys(scope.componentOutputs ?? {}).filter((id)=>reference === id || reference.startsWith(`${id}.`)).sort((left, right)=>right.length - left.length)[0];
+    if (componentId === undefined) return undefined;
+    return resolveBindingExpression.resolveBindingExpression({
+        kind: scene_model.BindingSourceKind.ComponentProperty,
+        componentId,
+        path: reference.substring(componentId.length + 1)
+    }, scope);
+}
+
+exports.componentArgumentSourcePrefix = componentArgumentSourcePrefix;
+exports.resolveArgumentSource = resolveArgumentSource;
+//# sourceMappingURL=resolveArgumentSource.js.map

package/dist/cjs/resolveArgumentSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveArgumentSource.js","sources":["../../resolveArgumentSource.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 } from '@cratis/scene.model';\nimport { BindingScope } from './BindingScope';\nimport { resolveBindingExpression } from './resolveBindingExpression';\n\n/** The prefix of an argument source that reads another element's output. */\nexport const componentArgumentSourcePrefix = 'component.';\n\n/**\n * Resolves where a command argument comes from, as an action's argument mapping writes it.\n *\n * `component.<id>.<output>` reads an output another element publishes - an input's `value`, a table's\n * `selectedItem.id` - from the same output scope a `componentProperty` binding reads. Element ids may contain\n * dots, so the longest id with outputs in scope wins: `component.order.lines.value` reads `value` of\n * `order.lines` when that element exists. Any other source is a path in the data context. An empty source,\n * or an element with no outputs in scope, resolves as absent.\n *\n * The C# engine (`ArgumentSources.Resolve`) behaves identically; both run `argument-source-fixtures.json`.\n */\nexport function resolveArgumentSource(source: string, scope: BindingScope): unknown {\n    if (!source) return undefined;\n    if (!source.startsWith(componentArgumentSourcePrefix)) return resolveBindingExpression({ path: source }, scope);\n\n    const reference = source.substring(componentArgumentSourcePrefix.length);\n    const componentId = Object.keys(scope.componentOutputs ?? {})\n        .filter(id => reference === id || reference.startsWith(`${id}.`))\n        .sort((left, right) => right.length - left.length)[0];\n    if (componentId === undefined) return undefined;\n\n    return resolveBindingExpression({ kind: BindingSourceKind.ComponentProperty, componentId, path: reference.substring(componentId.length + 1) }, scope);\n}\n"],"names":["componentArgumentSourcePrefix","resolveArgumentSource","source","scope","undefined","startsWith","resolveBindingExpression","path","reference","substring","length","componentId","Object","keys","componentOutputs","filter","id","sort","left","right","kind","BindingSourceKind","ComponentProperty"],"mappings":";;;;;AAAA;AACA;AAMA,6EACO,MAAMA,6BAAAA,GAAgC;AAE7C;;;;;;;;;;AAUC,IACM,SAASC,qBAAAA,CAAsBC,MAAc,EAAEC,KAAmB,EAAA;IACrE,IAAI,CAACD,QAAQ,OAAOE,SAAAA;AACpB,IAAA,IAAI,CAACF,MAAAA,CAAOG,UAAU,CAACL,6BAAAA,CAAAA,EAAgC,OAAOM,iDAAAA,CAAyB;QAAEC,IAAAA,EAAML;KAAO,EAAGC,KAAAA,CAAAA;AAEzG,IAAA,MAAMK,SAAAA,GAAYN,MAAAA,CAAOO,SAAS,CAACT,8BAA8BU,MAAM,CAAA;AACvE,IAAA,MAAMC,WAAAA,GAAcC,MAAAA,CAAOC,IAAI,CAACV,MAAMW,gBAAgB,IAAI,EAAC,CAAA,CACtDC,MAAM,CAACC,CAAAA,EAAAA,GAAMR,SAAAA,KAAcQ,MAAMR,SAAAA,CAAUH,UAAU,CAAC,CAAA,EAAGW,GAAG,CAAC,CAAC,CAAA,CAAA,CAC9DC,IAAI,CAAC,CAACC,IAAAA,EAAMC,KAAAA,GAAUA,KAAAA,CAAMT,MAAM,GAAGQ,IAAAA,CAAKR,MAAM,CAAC,CAAC,CAAA,CAAE;IACzD,IAAIC,WAAAA,KAAgBP,WAAW,OAAOA,SAAAA;AAEtC,IAAA,OAAOE,iDAAAA,CAAyB;AAAEc,QAAAA,IAAAA,EAAMC,8BAAkBC,iBAAiB;AAAEX,QAAAA,WAAAA;AAAaJ,QAAAA,IAAAA,EAAMC,SAAAA,CAAUC,SAAS,CAACE,WAAAA,CAAYD,MAAM,GAAG,CAAA;KAAG,EAAGP,KAAAA,CAAAA;AACnJ;;;"}

package/dist/cjs/resolveBindingExpression.js

@@ -8,9 +8,9 @@ var scene_model = require('@cratis/scene.model');
  * Resolves a typed binding against the shared runtime binding scope.
  */ function resolveBindingExpression(binding, scope) {
     const kind = binding.kind ?? scene_model.BindingSourceKind.DataContext;
-    if (kind === scene_model.BindingSourceKind.Literal) return binding.value;
-    const source = sourceValue(binding, scope, kind);
-    const value = readPath(source, sourcePath(binding, kind));
+    // A literal without a value is absent, whether the author wrote `null` or nothing: the C# model cannot
+    // tell the two apart, and both engines must resolve the same document to the same value.
+    const value = kind === scene_model.BindingSourceKind.Literal ? binding.value ?? undefined : readPath(sourceValue(binding, scope, kind), sourcePath(binding, kind));
     if (value !== null && value !== undefined) return value;
     if (binding.nullBehavior === scene_model.BindingNullBehavior.Preserve) return undefined;
     if (binding.nullBehavior === scene_model.BindingNullBehavior.Clear) return null;
@@ -24,7 +24,7 @@ var scene_model = require('@cratis/scene.model');
 function sourceValue(binding, scope, kind) {
     switch(kind){
         case scene_model.BindingSourceKind.DataContext:
-            return scope.dataContext;
+            return scope.dataContext ?? undefined;
         case scene_model.BindingSourceKind.QueryResult:
             return binding.query ? scope.queryResults?.[binding.query] : undefined;
         case scene_model.BindingSourceKind.ComponentProperty:
@@ -37,12 +37,16 @@ function sourcePath(binding, kind) {
     if (kind === scene_model.BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;
     return binding.path;
 }
-function readPath(source, path) {
+/**
+ * Reads a dotted path. Only own properties and array indexes are read - never inherited members such as
+ * `constructor` - and anything that is not an object or array ends the walk, so the C# engine can follow
+ * exactly the same rule over JSON.
+ */ function readPath(source, path) {
     if (!path) return source;
     return path.split('.').reduce((current, segment)=>{
-        if (current === null || current === undefined) return undefined;
-        if (typeof current !== 'object') return undefined;
-        return current[segment];
+        if (current === null || current === undefined || typeof current !== 'object') return undefined;
+        if (Array.isArray(current)) return /^(0|[1-9][0-9]*)$/.test(segment) ? current[Number(segment)] : undefined;
+        return Object.hasOwn(current, segment) ? current[segment] : undefined;
     }, source);
 }
 

package/dist/cjs/resolveBindingExpression.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveBindingExpression.js","sources":["../../resolveBindingExpression.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 { BindingExpression, BindingNullBehavior, BindingSourceKind } from '@cratis/scene.model';\nimport { BindingScope } from './BindingScope';\n\n/**\n * Resolves a typed binding against the shared runtime binding scope.\n */\nexport function resolveBindingExpression(binding: BindingExpression, scope: BindingScope): unknown {\n    const kind = binding.kind ?? BindingSourceKind.DataContext;\n    if (kind === BindingSourceKind.Literal) return binding.value;\n\n    const source = sourceValue(binding, scope, kind);\n    const value = readPath(source, sourcePath(binding, kind));\n    if (value !== null && value !== undefined) return value;\n\n    if (binding.nullBehavior === BindingNullBehavior.Preserve) return undefined;\n    if (binding.nullBehavior === BindingNullBehavior.Clear) return null;\n    return value;\n}\n\n/**\n * Creates a legacy resolver function from a binding scope.\n */\nexport function createBindingResolver(scope: BindingScope): (binding: BindingExpression) => unknown {\n    return binding => resolveBindingExpression(binding, scope);\n}\n\nfunction sourceValue(binding: BindingExpression, scope: BindingScope, kind: BindingSourceKind): unknown {\n    switch (kind) {\n        case BindingSourceKind.DataContext:\n            return scope.dataContext;\n        case BindingSourceKind.QueryResult:\n            return binding.query ? scope.queryResults?.[binding.query] : undefined;\n        case BindingSourceKind.ComponentProperty:\n            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;\n        case BindingSourceKind.Literal:\n            return binding.value;\n    }\n}\n\nfunction sourcePath(binding: BindingExpression, kind: BindingSourceKind): string {\n    if (kind === BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;\n    return binding.path;\n}\n\nfunction readPath(source: unknown, path: string): unknown {\n    if (!path) return source;\n    return path.split('.').reduce<unknown>((current, segment) => {\n        if (current === null || current === undefined) return undefined;\n        if (typeof current !== 'object') return undefined;\n        return (current as Record<string, unknown>)[segment];\n    }, source);\n}\n"],"names":["resolveBindingExpression","binding","scope","kind","BindingSourceKind","DataContext","Literal","value","source","sourceValue","readPath","sourcePath","undefined","nullBehavior","BindingNullBehavior","Preserve","Clear","createBindingResolver","dataContext","QueryResult","query","queryResults","ComponentProperty","componentId","componentOutputs","componentPropertyPath","path","split","reduce","current","segment"],"mappings":";;;;AAAA;AACA;AAKA;;AAEC,IACM,SAASA,wBAAAA,CAAyBC,OAA0B,EAAEC,KAAmB,EAAA;AACpF,IAAA,MAAMC,IAAAA,GAAOF,OAAAA,CAAQE,IAAI,IAAIC,8BAAkBC,WAAW;AAC1D,IAAA,IAAIF,SAASC,6BAAAA,CAAkBE,OAAO,EAAE,OAAOL,QAAQM,KAAK;IAE5D,MAAMC,MAAAA,GAASC,WAAAA,CAAYR,OAAAA,EAASC,KAAAA,EAAOC,IAAAA,CAAAA;AAC3C,IAAA,MAAMI,KAAAA,GAAQG,QAAAA,CAASF,MAAAA,EAAQG,UAAAA,CAAWV,OAAAA,EAASE,IAAAA,CAAAA,CAAAA;AACnD,IAAA,IAAII,KAAAA,KAAU,IAAA,IAAQA,KAAAA,KAAUK,SAAAA,EAAW,OAAOL,KAAAA;AAElD,IAAA,IAAIN,QAAQY,YAAY,KAAKC,+BAAAA,CAAoBC,QAAQ,EAAE,OAAOH,SAAAA;AAClE,IAAA,IAAIX,QAAQY,YAAY,KAAKC,+BAAAA,CAAoBE,KAAK,EAAE,OAAO,IAAA;IAC/D,OAAOT,KAAAA;AACX;AAEA;;IAGO,SAASU,qBAAAA,CAAsBf,KAAmB,EAAA;IACrD,OAAOD,CAAAA,OAAAA,GAAWD,wBAAAA,CAAyBC,OAAAA,EAASC,KAAAA,CAAAA;AACxD;AAEA,SAASO,WAAAA,CAAYR,OAA0B,EAAEC,KAAmB,EAAEC,IAAuB,EAAA;IACzF,OAAQA,IAAAA;AACJ,QAAA,KAAKC,8BAAkBC,WAAW;AAC9B,YAAA,OAAOH,MAAMgB,WAAW;AAC5B,QAAA,KAAKd,8BAAkBe,WAAW;YAC9B,OAAOlB,OAAAA,CAAQmB,KAAK,GAAGlB,KAAAA,CAAMmB,YAAY,GAAGpB,OAAAA,CAAQmB,KAAK,CAAC,GAAGR,SAAAA;AACjE,QAAA,KAAKR,8BAAkBkB,iBAAiB;YACpC,OAAOrB,OAAAA,CAAQsB,WAAW,GAAGrB,KAAAA,CAAMsB,gBAAgB,GAAGvB,OAAAA,CAAQsB,WAAW,CAAC,GAAGX,SAAAA;AACjF,QAAA,KAAKR,8BAAkBE,OAAO;AAC1B,YAAA,OAAOL,QAAQM,KAAK;AAC5B;AACJ;AAEA,SAASI,UAAAA,CAAWV,OAA0B,EAAEE,IAAuB,EAAA;IACnE,IAAIA,IAAAA,KAASC,8BAAkBkB,iBAAiB,EAAE,OAAOrB,OAAAA,CAAQwB,qBAAqB,IAAIxB,OAAAA,CAAQyB,IAAI;AACtG,IAAA,OAAOzB,QAAQyB,IAAI;AACvB;AAEA,SAAShB,QAAAA,CAASF,MAAe,EAAEkB,IAAY,EAAA;IAC3C,IAAI,CAACA,MAAM,OAAOlB,MAAAA;AAClB,IAAA,OAAOkB,KAAKC,KAAK,CAAC,KAAKC,MAAM,CAAU,CAACC,OAAAA,EAASC,OAAAA,GAAAA;AAC7C,QAAA,IAAID,OAAAA,KAAY,IAAA,IAAQA,OAAAA,KAAYjB,SAAAA,EAAW,OAAOA,SAAAA;QACtD,IAAI,OAAOiB,OAAAA,KAAY,QAAA,EAAU,OAAOjB,SAAAA;QACxC,OAAQiB,OAAmC,CAACC,OAAAA,CAAQ;IACxD,CAAA,EAAGtB,MAAAA,CAAAA;AACP;;;"}
+{"version":3,"file":"resolveBindingExpression.js","sources":["../../resolveBindingExpression.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 { BindingExpression, BindingNullBehavior, BindingSourceKind } from '@cratis/scene.model';\nimport { BindingScope } from './BindingScope';\n\n/**\n * Resolves a typed binding against the shared runtime binding scope.\n */\nexport function resolveBindingExpression(binding: BindingExpression, scope: BindingScope): unknown {\n    const kind = binding.kind ?? BindingSourceKind.DataContext;\n\n    // A literal without a value is absent, whether the author wrote `null` or nothing: the C# model cannot\n    // tell the two apart, and both engines must resolve the same document to the same value.\n    const value = kind === BindingSourceKind.Literal\n        ? binding.value ?? undefined\n        : readPath(sourceValue(binding, scope, kind), sourcePath(binding, kind));\n    if (value !== null && value !== undefined) return value;\n\n    if (binding.nullBehavior === BindingNullBehavior.Preserve) return undefined;\n    if (binding.nullBehavior === BindingNullBehavior.Clear) return null;\n    return value;\n}\n\n/**\n * Creates a legacy resolver function from a binding scope.\n */\nexport function createBindingResolver(scope: BindingScope): (binding: BindingExpression) => unknown {\n    return binding => resolveBindingExpression(binding, scope);\n}\n\nfunction sourceValue(binding: BindingExpression, scope: BindingScope, kind: BindingSourceKind): unknown {\n    switch (kind) {\n        case BindingSourceKind.DataContext:\n            return scope.dataContext ?? undefined;\n        case BindingSourceKind.QueryResult:\n            return binding.query ? scope.queryResults?.[binding.query] : undefined;\n        case BindingSourceKind.ComponentProperty:\n            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;\n        case BindingSourceKind.Literal:\n            return binding.value;\n    }\n}\n\nfunction sourcePath(binding: BindingExpression, kind: BindingSourceKind): string {\n    if (kind === BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;\n    return binding.path;\n}\n\n/**\n * Reads a dotted path. Only own properties and array indexes are read - never inherited members such as\n * `constructor` - and anything that is not an object or array ends the walk, so the C# engine can follow\n * exactly the same rule over JSON.\n */\nfunction readPath(source: unknown, path: string): unknown {\n    if (!path) return source;\n    return path.split('.').reduce<unknown>((current, segment) => {\n        if (current === null || current === undefined || typeof current !== 'object') return undefined;\n        if (Array.isArray(current)) return /^(0|[1-9][0-9]*)$/.test(segment) ? current[Number(segment)] : undefined;\n        return Object.hasOwn(current, segment) ? (current as Record<string, unknown>)[segment] : undefined;\n    }, source);\n}\n"],"names":["resolveBindingExpression","binding","scope","kind","BindingSourceKind","DataContext","value","Literal","undefined","readPath","sourceValue","sourcePath","nullBehavior","BindingNullBehavior","Preserve","Clear","createBindingResolver","dataContext","QueryResult","query","queryResults","ComponentProperty","componentId","componentOutputs","componentPropertyPath","path","source","split","reduce","current","segment","Array","isArray","test","Number","Object","hasOwn"],"mappings":";;;;AAAA;AACA;AAKA;;AAEC,IACM,SAASA,wBAAAA,CAAyBC,OAA0B,EAAEC,KAAmB,EAAA;AACpF,IAAA,MAAMC,IAAAA,GAAOF,OAAAA,CAAQE,IAAI,IAAIC,8BAAkBC,WAAW;;;AAI1D,IAAA,MAAMC,KAAAA,GAAQH,IAAAA,KAASC,6BAAAA,CAAkBG,OAAO,GAC1CN,OAAAA,CAAQK,KAAK,IAAIE,SAAAA,GACjBC,SAASC,WAAAA,CAAYT,OAAAA,EAASC,KAAAA,EAAOC,IAAAA,CAAAA,EAAOQ,WAAWV,OAAAA,EAASE,IAAAA,CAAAA,CAAAA;AACtE,IAAA,IAAIG,KAAAA,KAAU,IAAA,IAAQA,KAAAA,KAAUE,SAAAA,EAAW,OAAOF,KAAAA;AAElD,IAAA,IAAIL,QAAQW,YAAY,KAAKC,+BAAAA,CAAoBC,QAAQ,EAAE,OAAON,SAAAA;AAClE,IAAA,IAAIP,QAAQW,YAAY,KAAKC,+BAAAA,CAAoBE,KAAK,EAAE,OAAO,IAAA;IAC/D,OAAOT,KAAAA;AACX;AAEA;;IAGO,SAASU,qBAAAA,CAAsBd,KAAmB,EAAA;IACrD,OAAOD,CAAAA,OAAAA,GAAWD,wBAAAA,CAAyBC,OAAAA,EAASC,KAAAA,CAAAA;AACxD;AAEA,SAASQ,WAAAA,CAAYT,OAA0B,EAAEC,KAAmB,EAAEC,IAAuB,EAAA;IACzF,OAAQA,IAAAA;AACJ,QAAA,KAAKC,8BAAkBC,WAAW;YAC9B,OAAOH,KAAAA,CAAMe,WAAW,IAAIT,SAAAA;AAChC,QAAA,KAAKJ,8BAAkBc,WAAW;YAC9B,OAAOjB,OAAAA,CAAQkB,KAAK,GAAGjB,KAAAA,CAAMkB,YAAY,GAAGnB,OAAAA,CAAQkB,KAAK,CAAC,GAAGX,SAAAA;AACjE,QAAA,KAAKJ,8BAAkBiB,iBAAiB;YACpC,OAAOpB,OAAAA,CAAQqB,WAAW,GAAGpB,KAAAA,CAAMqB,gBAAgB,GAAGtB,OAAAA,CAAQqB,WAAW,CAAC,GAAGd,SAAAA;AACjF,QAAA,KAAKJ,8BAAkBG,OAAO;AAC1B,YAAA,OAAON,QAAQK,KAAK;AAC5B;AACJ;AAEA,SAASK,UAAAA,CAAWV,OAA0B,EAAEE,IAAuB,EAAA;IACnE,IAAIA,IAAAA,KAASC,8BAAkBiB,iBAAiB,EAAE,OAAOpB,OAAAA,CAAQuB,qBAAqB,IAAIvB,OAAAA,CAAQwB,IAAI;AACtG,IAAA,OAAOxB,QAAQwB,IAAI;AACvB;AAEA;;;;AAIC,IACD,SAAShB,QAAAA,CAASiB,MAAe,EAAED,IAAY,EAAA;IAC3C,IAAI,CAACA,MAAM,OAAOC,MAAAA;AAClB,IAAA,OAAOD,KAAKE,KAAK,CAAC,KAAKC,MAAM,CAAU,CAACC,OAAAA,EAASC,OAAAA,GAAAA;AAC7C,QAAA,IAAID,YAAY,IAAA,IAAQA,OAAAA,KAAYrB,aAAa,OAAOqB,OAAAA,KAAY,UAAU,OAAOrB,SAAAA;AACrF,QAAA,IAAIuB,KAAAA,CAAMC,OAAO,CAACH,OAAAA,CAAAA,EAAU,OAAO,mBAAA,CAAoBI,IAAI,CAACH,OAAAA,CAAAA,GAAWD,OAAO,CAACK,MAAAA,CAAOJ,SAAS,GAAGtB,SAAAA;QAClG,OAAO2B,MAAAA,CAAOC,MAAM,CAACP,OAAAA,EAASC,WAAW,OAAoC,CAACA,OAAAA,CAAQ,GAAGtB,SAAAA;IAC7F,CAAA,EAAGkB,MAAAA,CAAAA;AACP;;;"}

package/dist/esm/QueryBindingState.d.ts

@@ -0,0 +1,10 @@
+import { BindingScope } from './BindingScope';
+import { QueryBindingTicket } from './QueryBindingTicket';
+export declare class QueryBindingState {
+    #private;
+    begin(query: string): QueryBindingTicket;
+    complete(ticket: QueryBindingTicket, result: unknown): boolean;
+    clear(query: string): void;
+    get queryResults(): NonNullable<BindingScope['queryResults']>;
+}
+//# sourceMappingURL=QueryBindingState.d.ts.map

package/dist/esm/QueryBindingState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBindingState.d.ts","sourceRoot":"","sources":["../../QueryBindingState.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU1D,qBAAa,iBAAiB;;IAK1B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAIvC;IAGD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAI7D;IAGD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGzB;IAGD,IAAI,YAAY,IAAI,WAAW,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAE5D;CACJ"}

package/dist/esm/QueryBindingState.js

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

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

@@ -0,0 +1,5 @@
+export interface QueryBindingTicket {
+    query: string;
+    generation: number;
+}
+//# sourceMappingURL=QueryBindingTicket.d.ts.map

package/dist/esm/QueryBindingTicket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBindingTicket.d.ts","sourceRoot":"","sources":["../../QueryBindingTicket.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/esm/QueryBindingTicket.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QueryBindingTicket.js.map

package/dist/esm/QueryBindingTicket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryBindingTicket.js","sourceRoot":"","sources":["../../QueryBindingTicket.ts"],"names":[],"mappings":""}

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

@@ -1 +1 @@
-{"version":3,"file":"resolveEffectiveConfiguration.d.ts","sourceRoot":"","sources":["../../../editing/resolveEffectiveConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,sBAAsB,EAA0B,oBAAoB,EACvE,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAA2B,MAAM,qBAAqB,CAAC;AAIjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAoGhD,wBAAgB,6BAA6B,CACzC,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,oBAAoB,EAAE,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,sBAAsB,CAsFxB"}
+{"version":3,"file":"resolveEffectiveConfiguration.d.ts","sourceRoot":"","sources":["../../../editing/resolveEffectiveConfiguration.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,sBAAsB,EAA0B,oBAAoB,EACvE,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAA2B,MAAM,qBAAqB,CAAC;AAIjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAoGhD,wBAAgB,6BAA6B,CACzC,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,oBAAoB,EAAE,EAC7C,OAAO,EAAE,iBAAiB,GAC3B,sBAAsB,CAiGxB"}

package/dist/esm/editing/resolveEffectiveConfiguration.js

@@ -156,6 +156,17 @@ function collectionValue(grant, matching, instance, items, diagnostics) {
                 scalarValue(effectiveGrant, matching, instance, current, diagnostics);
             }
         }
+        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.push(errorDiagnostic(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/esm/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/esm/editing/validateValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateValue.d.ts","sourceRoot":"","sources":["../../../editing/validateValue.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAiBtG,wBAAgB,aAAa,CAAC,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAqDhG;AAmDD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,EAAE,CAsB5I"}
+{"version":3,"file":"validateValue.d.ts","sourceRoot":"","sources":["../../../editing/validateValue.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,wBAAwB,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAiBzH,wBAAgB,aAAa,CAAC,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA4DhG;AAgED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AASD,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,EAAE,CAsB5I"}

package/dist/esm/editing/validateValue.js

@@ -1,4 +1,4 @@
-import { PropertyValueType } from '@cratis/scene.model';
+import { BindingSourceKind, PropertyValueType } 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.
@@ -19,6 +19,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 PropertyValueType.String:
             {
@@ -61,7 +65,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(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/esm/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":"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"}
+{"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/esm/forms/CommandFormLayoutKey.d.ts

@@ -0,0 +1,7 @@
+export declare enum CommandFormLayoutKey {
+    ArrowLeft = "ArrowLeft",
+    ArrowRight = "ArrowRight",
+    ArrowUp = "ArrowUp",
+    ArrowDown = "ArrowDown"
+}
+//# sourceMappingURL=CommandFormLayoutKey.d.ts.map

package/dist/esm/forms/CommandFormLayoutKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormLayoutKey.d.ts","sourceRoot":"","sources":["../../../forms/CommandFormLayoutKey.ts"],"names":[],"mappings":"AAIA,oBAAY,oBAAoB;IAC5B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,SAAS,cAAc;CAC1B"}

package/dist/esm/forms/CommandFormLayoutKey.js

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

package/dist/esm/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/esm/forms/applyCommandFormLayoutKey.d.ts

@@ -0,0 +1,5 @@
+import { CommandFormLayout } from '@cratis/scene.model';
+import { CommandFormLayoutDraft } from './CommandFormLayoutDraft';
+import { CommandFormLayoutKey } from './CommandFormLayoutKey';
+export declare function applyCommandFormLayoutKey(committed: CommandFormLayout, field: string, key: CommandFormLayoutKey, resize?: boolean, fields?: readonly string[]): CommandFormLayoutDraft | undefined;
+//# sourceMappingURL=applyCommandFormLayoutKey.d.ts.map

package/dist/esm/forms/applyCommandFormLayoutKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyCommandFormLayoutKey.d.ts","sourceRoot":"","sources":["../../../forms/applyCommandFormLayoutKey.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAsB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAW9D,wBAAgB,yBAAyB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,oBAAoB,EACzB,MAAM,UAAQ,EACd,MAAM,GAAE,SAAS,MAAM,EAAO,GAC/B,sBAAsB,GAAG,SAAS,CAIpC"}

package/dist/esm/forms/applyCommandFormLayoutKey.js

@@ -0,0 +1,70 @@
+import { CommandFormLayoutKey } from './CommandFormLayoutKey.js';
+import { updateCommandFormFieldPlacement } from './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(committed, resize ? resized(placement, key) : moved(placement, key), fields);
+}
+function moved(placement, key) {
+    switch(key){
+        case CommandFormLayoutKey.ArrowLeft:
+            return {
+                ...placement,
+                column: Math.max(1, placement.column - 1)
+            };
+        case CommandFormLayoutKey.ArrowRight:
+            return {
+                ...placement,
+                column: placement.column + 1
+            };
+        case CommandFormLayoutKey.ArrowUp:
+            return {
+                ...placement,
+                row: Math.max(1, placement.row - 1)
+            };
+        case 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.ArrowLeft:
+            return {
+                ...placement,
+                columnSpan: Math.max(1, columnSpan - 1)
+            };
+        case CommandFormLayoutKey.ArrowRight:
+            return {
+                ...placement,
+                columnSpan: columnSpan + 1
+            };
+        case CommandFormLayoutKey.ArrowUp:
+            return {
+                ...placement,
+                rowSpan: Math.max(1, rowSpan - 1)
+            };
+        case CommandFormLayoutKey.ArrowDown:
+            return {
+                ...placement,
+                rowSpan: rowSpan + 1
+            };
+    }
+}
+
+export { applyCommandFormLayoutKey };
+//# sourceMappingURL=applyCommandFormLayoutKey.js.map

package/dist/esm/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,+BAAAA,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,qBAAqBC,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,qBAAqBK,UAAU;YAAE,OAAO;AAAE,gBAAA,GAAGb,SAAS;gBAAEU,MAAAA,EAAQV,SAAAA,CAAUU,MAAM,GAAG;AAAE,aAAA;AAC1F,QAAA,KAAKF,qBAAqBM,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,qBAAqBQ,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,qBAAqBC,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,qBAAqBK,UAAU;YAAE,OAAO;AAAE,gBAAA,GAAGb,SAAS;AAAEiB,gBAAAA,UAAAA,EAAYA,UAAAA,GAAa;AAAE,aAAA;AACxF,QAAA,KAAKT,qBAAqBM,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,qBAAqBQ,SAAS;YAAE,OAAO;AAAE,gBAAA,GAAGhB,SAAS;AAAEkB,gBAAAA,OAAAA,EAASA,OAAAA,GAAU;AAAE,aAAA;AACrF;AACJ;;"}