@cratis/scene.engine 4.13.0 → 4.15.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/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,9 @@
 'use strict';
 
 var resolveBindingExpression = require('./resolveBindingExpression.js');
+var nestBindingScope = require('./nestBindingScope.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 +16,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 +75,9 @@ var collectIconUsages = require('./editing/collectIconUsages.js');
 
 exports.createBindingResolver = resolveBindingExpression.createBindingResolver;
 exports.resolveBindingExpression = resolveBindingExpression.resolveBindingExpression;
+exports.nestBindingScope = nestBindingScope.nestBindingScope;
+exports.removeComponentOutputs = removeComponentOutputs.removeComponentOutputs;
+exports.QueryBindingState = QueryBindingState.QueryBindingState;
 exports.validateBindingExpression = validateBindingExpression.validateBindingExpression;
 exports.renderElement = renderElement.renderElement;
 exports.CommandFormLayoutDiagnosticCode = CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode;
@@ -81,6 +90,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;;"}

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/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"}