@cratis/scene.engine 4.11.0 → 4.13.0

package/dist/cjs/forms/CommandFormLayoutDiagnosticCode.js

@@ -0,0 +1,20 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Diagnostic codes for command-form geometry validation.
+ */ var CommandFormLayoutDiagnosticCode = /*#__PURE__*/ function(CommandFormLayoutDiagnosticCode) {
+    CommandFormLayoutDiagnosticCode["EmptyColumns"] = "emptyColumns";
+    CommandFormLayoutDiagnosticCode["DuplicateColumn"] = "duplicateColumn";
+    CommandFormLayoutDiagnosticCode["InvalidColumnIndex"] = "invalidColumnIndex";
+    CommandFormLayoutDiagnosticCode["InvalidWidth"] = "invalidWidth";
+    CommandFormLayoutDiagnosticCode["DuplicatePlacement"] = "duplicatePlacement";
+    CommandFormLayoutDiagnosticCode["InvalidPlacement"] = "invalidPlacement";
+    CommandFormLayoutDiagnosticCode["MissingField"] = "missingField";
+    CommandFormLayoutDiagnosticCode["OutOfBoundsPlacement"] = "outOfBoundsPlacement";
+    return CommandFormLayoutDiagnosticCode;
+}({});
+
+exports.CommandFormLayoutDiagnosticCode = CommandFormLayoutDiagnosticCode;
+//# sourceMappingURL=CommandFormLayoutDiagnosticCode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommandFormLayoutDiagnosticCode.js","sources":["../../../forms/CommandFormLayoutDiagnosticCode.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/**\n * Diagnostic codes for command-form geometry validation.\n */\nexport enum CommandFormLayoutDiagnosticCode {\n    EmptyColumns = 'emptyColumns',\n    DuplicateColumn = 'duplicateColumn',\n    InvalidColumnIndex = 'invalidColumnIndex',\n    InvalidWidth = 'invalidWidth',\n    DuplicatePlacement = 'duplicatePlacement',\n    InvalidPlacement = 'invalidPlacement',\n    MissingField = 'missingField',\n    OutOfBoundsPlacement = 'outOfBoundsPlacement',\n}\n"],"names":["CommandFormLayoutDiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;IAGO,IAAKA,+BAAAA,iBAAAA,SAAAA,+BAAAA,EAAAA;;;;;;;;;AAAAA,IAAAA,OAAAA,+BAAAA;AASX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/forms/commitCommandFormLayoutDraft.js

@@ -0,0 +1,12 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Commits a draft layout only when it is valid; otherwise returns the previous committed metadata.
+ */ function commitCommandFormLayoutDraft(draft) {
+    return draft.isValid ? draft.draft : draft.committed;
+}
+
+exports.commitCommandFormLayoutDraft = commitCommandFormLayoutDraft;
+//# sourceMappingURL=commitCommandFormLayoutDraft.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commitCommandFormLayoutDraft.js","sources":["../../../forms/commitCommandFormLayoutDraft.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 } from '@cratis/scene.model';\nimport { CommandFormLayoutDraft } from './CommandFormLayoutDraft';\n\n/**\n * Commits a draft layout only when it is valid; otherwise returns the previous committed metadata.\n */\nexport function commitCommandFormLayoutDraft(draft: CommandFormLayoutDraft): CommandFormLayout {\n    return draft.isValid ? draft.draft : draft.committed;\n}\n"],"names":["commitCommandFormLayoutDraft","draft","isValid","committed"],"mappings":";;AAAA;AACA;AAKA;;IAGO,SAASA,4BAAAA,CAA6BC,KAA6B,EAAA;AACtE,IAAA,OAAOA,MAAMC,OAAO,GAAGD,MAAMA,KAAK,GAAGA,MAAME,SAAS;AACxD;;"}

package/dist/cjs/forms/defaultCommandFormLayout.js

@@ -0,0 +1,23 @@
+'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.
+/**
+ * Backward-compatible command form geometry: one flexible column and no authored placements.
+ */ const defaultCommandFormLayout = {
+    columns: [
+        {
+            index: 1,
+            width: {
+                unit: scene_model.FormWidthUnit.Fraction,
+                value: 1
+            }
+        }
+    ],
+    placements: []
+};
+
+exports.defaultCommandFormLayout = defaultCommandFormLayout;
+//# sourceMappingURL=defaultCommandFormLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultCommandFormLayout.js","sources":["../../../forms/defaultCommandFormLayout.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 * Backward-compatible command form geometry: one flexible column and no authored placements.\n */\nexport const defaultCommandFormLayout: CommandFormLayout = {\n    columns: [{ index: 1, width: { unit: FormWidthUnit.Fraction, value: 1 } }],\n    placements: [],\n};\n"],"names":["defaultCommandFormLayout","columns","index","width","unit","FormWidthUnit","Fraction","value","placements"],"mappings":";;;;AAAA;AACA;AAIA;;UAGaA,wBAAAA,GAA8C;IACvDC,OAAAA,EAAS;AAAC,QAAA;YAAEC,KAAAA,EAAO,CAAA;YAAGC,KAAAA,EAAO;AAAEC,gBAAAA,IAAAA,EAAMC,0BAAcC,QAAQ;gBAAEC,KAAAA,EAAO;AAAE;AAAE;AAAE,KAAA;AAC1EC,IAAAA,UAAAA,EAAY;AAChB;;"}

package/dist/cjs/forms/formWidthToCss.js

@@ -0,0 +1,24 @@
+'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.
+/**
+ * Converts a platform-neutral form width to a browser CSS width token.
+ */ function formWidthToCss(width) {
+    if (!width) return undefined;
+    switch(width.unit){
+        case scene_model.FormWidthUnit.Auto:
+            return 'auto';
+        case scene_model.FormWidthUnit.Fraction:
+            return `${width.value ?? 1}fr`;
+        case scene_model.FormWidthUnit.Pixels:
+            return `${width.value ?? 0}px`;
+        case scene_model.FormWidthUnit.Percent:
+            return `${width.value ?? 0}%`;
+    }
+}
+
+exports.formWidthToCss = formWidthToCss;
+//# sourceMappingURL=formWidthToCss.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formWidthToCss.js","sources":["../../../forms/formWidthToCss.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 { FormWidth, FormWidthUnit } from '@cratis/scene.model';\n\n/**\n * Converts a platform-neutral form width to a browser CSS width token.\n */\nexport function formWidthToCss(width: FormWidth | undefined): string | undefined {\n    if (!width) return undefined;\n    switch (width.unit) {\n        case FormWidthUnit.Auto:\n            return 'auto';\n        case FormWidthUnit.Fraction:\n            return `${width.value ?? 1}fr`;\n        case FormWidthUnit.Pixels:\n            return `${width.value ?? 0}px`;\n        case FormWidthUnit.Percent:\n            return `${width.value ?? 0}%`;\n    }\n}\n"],"names":["formWidthToCss","width","undefined","unit","FormWidthUnit","Auto","Fraction","value","Pixels","Percent"],"mappings":";;;;AAAA;AACA;AAIA;;IAGO,SAASA,cAAAA,CAAeC,KAA4B,EAAA;IACvD,IAAI,CAACA,OAAO,OAAOC,SAAAA;AACnB,IAAA,OAAQD,MAAME,IAAI;AACd,QAAA,KAAKC,0BAAcC,IAAI;YACnB,OAAO,MAAA;AACX,QAAA,KAAKD,0BAAcE,QAAQ;AACvB,YAAA,OAAO,GAAGL,KAAAA,CAAMM,KAAK,IAAI,CAAA,CAAE,EAAE,CAAC;AAClC,QAAA,KAAKH,0BAAcI,MAAM;AACrB,YAAA,OAAO,GAAGP,KAAAA,CAAMM,KAAK,IAAI,CAAA,CAAE,EAAE,CAAC;AAClC,QAAA,KAAKH,0BAAcK,OAAO;AACtB,YAAA,OAAO,GAAGR,KAAAA,CAAMM,KAAK,IAAI,CAAA,CAAE,CAAC,CAAC;AACrC;AACJ;;"}

package/dist/cjs/forms/normalizeCommandFormLayout.js

@@ -0,0 +1,42 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var defaultCommandFormLayout = require('./defaultCommandFormLayout.js');
+var parseFormWidth = require('./parseFormWidth.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Normalizes authored command form layout, including legacy per-input column/width metadata.
+ */ function normalizeCommandFormLayout(layout, inputs = []) {
+    if (layout) return layout;
+    if (!inputs.length) return defaultCommandFormLayout.defaultCommandFormLayout;
+    const placements = inputs.map((input, index)=>({
+            field: input.property,
+            row: index + 1,
+            column: positiveInteger(input.column) ?? 1,
+            width: parseFormWidth.parseFormWidth(input.width)
+        }));
+    const columnCount = Math.max(1, ...placements.map((placement)=>placement.column));
+    return {
+        columns: Array.from({
+            length: columnCount
+        }, (_, index)=>({
+                index: index + 1,
+                width: fraction(1)
+            })),
+        placements
+    };
+}
+function fraction(value) {
+    return {
+        unit: scene_model.FormWidthUnit.Fraction,
+        value
+    };
+}
+function positiveInteger(value) {
+    return value !== undefined && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+
+exports.normalizeCommandFormLayout = normalizeCommandFormLayout;
+//# sourceMappingURL=normalizeCommandFormLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeCommandFormLayout.js","sources":["../../../forms/normalizeCommandFormLayout.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, FormColumn, FormFieldPlacement, FormWidth, FormWidthUnit } from '@cratis/scene.model';\nimport { defaultCommandFormLayout } from './defaultCommandFormLayout';\nimport { parseFormWidth } from './parseFormWidth';\n\nexport interface LegacyCommandFormInputGeometry {\n    property: string;\n    column?: number;\n    width?: string;\n}\n\n/**\n * Normalizes authored command form layout, including legacy per-input column/width metadata.\n */\nexport function normalizeCommandFormLayout(layout: CommandFormLayout | undefined, inputs: readonly LegacyCommandFormInputGeometry[] = []): CommandFormLayout {\n    if (layout) return layout;\n    if (!inputs.length) return defaultCommandFormLayout;\n    const placements = inputs.map((input, index): FormFieldPlacement => ({\n        field: input.property,\n        row: index + 1,\n        column: positiveInteger(input.column) ?? 1,\n        width: parseFormWidth(input.width),\n    }));\n    const columnCount = Math.max(1, ...placements.map(placement => placement.column));\n    return {\n        columns: Array.from({ length: columnCount }, (_, index): FormColumn => ({ index: index + 1, width: fraction(1) })),\n        placements,\n    };\n}\n\nfunction fraction(value: number): FormWidth {\n    return { unit: FormWidthUnit.Fraction, value };\n}\n\nfunction positiveInteger(value: number | undefined): number | undefined {\n    return value !== undefined && Number.isInteger(value) && value > 0 ? value : undefined;\n}\n"],"names":["normalizeCommandFormLayout","layout","inputs","length","defaultCommandFormLayout","placements","map","input","index","field","property","row","column","positiveInteger","width","parseFormWidth","columnCount","Math","max","placement","columns","Array","from","_","fraction","value","unit","FormWidthUnit","Fraction","undefined","Number","isInteger"],"mappings":";;;;;;AAAA;AACA;AAYA;;AAEC,IACM,SAASA,0BAAAA,CAA2BC,MAAqC,EAAEC,SAAoD,EAAE,EAAA;AACpI,IAAA,IAAID,QAAQ,OAAOA,MAAAA;AACnB,IAAA,IAAI,CAACC,MAAAA,CAAOC,MAAM,EAAE,OAAOC,iDAAAA;AAC3B,IAAA,MAAMC,aAAaH,MAAAA,CAAOI,GAAG,CAAC,CAACC,KAAAA,EAAOC,SAA+B;AACjEC,YAAAA,KAAAA,EAAOF,MAAMG,QAAQ;AACrBC,YAAAA,GAAAA,EAAKH,KAAAA,GAAQ,CAAA;YACbI,MAAAA,EAAQC,eAAAA,CAAgBN,KAAAA,CAAMK,MAAM,CAAA,IAAK,CAAA;YACzCE,KAAAA,EAAOC,6BAAAA,CAAeR,MAAMO,KAAK;SACrC,CAAA,CAAA;IACA,MAAME,WAAAA,GAAcC,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAA,GAAMb,UAAAA,CAAWC,GAAG,CAACa,CAAAA,SAAAA,GAAaA,SAAAA,CAAUP,MAAM,CAAA,CAAA;IAC/E,OAAO;QACHQ,OAAAA,EAASC,KAAAA,CAAMC,IAAI,CAAC;YAAEnB,MAAAA,EAAQa;SAAY,EAAG,CAACO,CAAAA,EAAGf,KAAAA,IAAuB;AAAEA,gBAAAA,KAAAA,EAAOA,KAAAA,GAAQ,CAAA;AAAGM,gBAAAA,KAAAA,EAAOU,QAAAA,CAAS,CAAA;aAAG,CAAA,CAAA;AAC/GnB,QAAAA;AACJ,KAAA;AACJ;AAEA,SAASmB,SAASC,KAAa,EAAA;IAC3B,OAAO;AAAEC,QAAAA,IAAAA,EAAMC,0BAAcC,QAAQ;AAAEH,QAAAA;AAAM,KAAA;AACjD;AAEA,SAASZ,gBAAgBY,KAAyB,EAAA;IAC9C,OAAOA,KAAAA,KAAUI,aAAaC,MAAAA,CAAOC,SAAS,CAACN,KAAAA,CAAAA,IAAUA,KAAAA,GAAQ,IAAIA,KAAAA,GAAQI,SAAAA;AACjF;;"}

package/dist/cjs/forms/parseFormWidth.js

@@ -0,0 +1,34 @@
+'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.
+/**
+ * Parses a legacy width token into typed form geometry. Arbitrary strings are intentionally rejected.
+ */ function parseFormWidth(value) {
+    if (!value || typeof value !== 'string') return undefined;
+    const trimmed = value.trim();
+    if (trimmed === 'auto') return {
+        unit: scene_model.FormWidthUnit.Auto
+    };
+    const match = /^([0-9]+(?:\.[0-9]+)?)(fr|px|%)$/.exec(trimmed);
+    if (!match) return undefined;
+    const widthValue = Number(match[1]);
+    if (!Number.isFinite(widthValue) || widthValue < 0) return undefined;
+    if (match[2] === 'fr') return {
+        unit: scene_model.FormWidthUnit.Fraction,
+        value: widthValue
+    };
+    if (match[2] === 'px') return {
+        unit: scene_model.FormWidthUnit.Pixels,
+        value: widthValue
+    };
+    return {
+        unit: scene_model.FormWidthUnit.Percent,
+        value: widthValue
+    };
+}
+
+exports.parseFormWidth = parseFormWidth;
+//# sourceMappingURL=parseFormWidth.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseFormWidth.js","sources":["../../../forms/parseFormWidth.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 { FormWidth, FormWidthUnit } from '@cratis/scene.model';\n\n/**\n * Parses a legacy width token into typed form geometry. Arbitrary strings are intentionally rejected.\n */\nexport function parseFormWidth(value: unknown): FormWidth | undefined {\n    if (!value || typeof value !== 'string') return undefined;\n    const trimmed = value.trim();\n    if (trimmed === 'auto') return { unit: FormWidthUnit.Auto };\n    const match = /^([0-9]+(?:\\.[0-9]+)?)(fr|px|%)$/.exec(trimmed);\n    if (!match) return undefined;\n    const widthValue = Number(match[1]);\n    if (!Number.isFinite(widthValue) || widthValue < 0) return undefined;\n    if (match[2] === 'fr') return { unit: FormWidthUnit.Fraction, value: widthValue };\n    if (match[2] === 'px') return { unit: FormWidthUnit.Pixels, value: widthValue };\n    return { unit: FormWidthUnit.Percent, value: widthValue };\n}\n"],"names":["parseFormWidth","value","undefined","trimmed","trim","unit","FormWidthUnit","Auto","match","exec","widthValue","Number","isFinite","Fraction","Pixels","Percent"],"mappings":";;;;AAAA;AACA;AAIA;;IAGO,SAASA,cAAAA,CAAeC,KAAc,EAAA;AACzC,IAAA,IAAI,CAACA,KAAAA,IAAS,OAAOA,KAAAA,KAAU,UAAU,OAAOC,SAAAA;IAChD,MAAMC,OAAAA,GAAUF,MAAMG,IAAI,EAAA;IAC1B,IAAID,OAAAA,KAAY,QAAQ,OAAO;AAAEE,QAAAA,IAAAA,EAAMC,0BAAcC;AAAK,KAAA;IAC1D,MAAMC,KAAAA,GAAQ,kCAAA,CAAmCC,IAAI,CAACN,OAAAA,CAAAA;IACtD,IAAI,CAACK,OAAO,OAAON,SAAAA;AACnB,IAAA,MAAMQ,UAAAA,GAAaC,MAAAA,CAAOH,KAAK,CAAC,CAAA,CAAE,CAAA;AAClC,IAAA,IAAI,CAACG,MAAAA,CAAOC,QAAQ,CAACF,UAAAA,CAAAA,IAAeA,UAAAA,GAAa,GAAG,OAAOR,SAAAA;AAC3D,IAAA,IAAIM,KAAK,CAAC,CAAA,CAAE,KAAK,MAAM,OAAO;AAAEH,QAAAA,IAAAA,EAAMC,0BAAcO,QAAQ;QAAEZ,KAAAA,EAAOS;AAAW,KAAA;AAChF,IAAA,IAAIF,KAAK,CAAC,CAAA,CAAE,KAAK,MAAM,OAAO;AAAEH,QAAAA,IAAAA,EAAMC,0BAAcQ,MAAM;QAAEb,KAAAA,EAAOS;AAAW,KAAA;IAC9E,OAAO;AAAEL,QAAAA,IAAAA,EAAMC,0BAAcS,OAAO;QAAEd,KAAAA,EAAOS;AAAW,KAAA;AAC5D;;"}

package/dist/cjs/forms/preserveDirtyCommandValues.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Merges refreshed command values without overwriting dirty fields a user is editing.
+ */ function preserveDirtyCommandValues(current, refreshed, dirtyFields) {
+    return Object.fromEntries(Object.entries(refreshed).map(([field, value])=>[
+            field,
+            dirtyFields.has(field) ? current[field] : value
+        ]));
+}
+
+exports.preserveDirtyCommandValues = preserveDirtyCommandValues;
+//# sourceMappingURL=preserveDirtyCommandValues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preserveDirtyCommandValues.js","sources":["../../../forms/preserveDirtyCommandValues.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/**\n * Merges refreshed command values without overwriting dirty fields a user is editing.\n */\nexport function preserveDirtyCommandValues(\n    current: Record<string, unknown>,\n    refreshed: Record<string, unknown>,\n    dirtyFields: ReadonlySet<string>,\n): Record<string, unknown> {\n    return Object.fromEntries(Object.entries(refreshed).map(([field, value]) => [field, dirtyFields.has(field) ? current[field] : value]));\n}\n"],"names":["preserveDirtyCommandValues","current","refreshed","dirtyFields","Object","fromEntries","entries","map","field","value","has"],"mappings":";;AAAA;AACA;AAEA;;AAEC,IACM,SAASA,0BAAAA,CACZC,OAAgC,EAChCC,SAAkC,EAClCC,WAAgC,EAAA;AAEhC,IAAA,OAAOC,MAAAA,CAAOC,WAAW,CAACD,MAAAA,CAAOE,OAAO,CAACJ,SAAAA,CAAAA,CAAWK,GAAG,CAAC,CAAC,CAACC,KAAAA,EAAOC,MAAM,GAAK;AAACD,YAAAA,KAAAA;AAAOL,YAAAA,WAAAA,CAAYO,GAAG,CAACF,KAAAA,CAAAA,GAASP,OAAO,CAACO,MAAM,GAAGC;AAAM,SAAA,CAAA,CAAA;AACxI;;"}

package/dist/cjs/forms/resizeCommandFormColumn.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var validateCommandFormLayout = require('./validateCommandFormLayout.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Resizes a column as draft geometry, keeping the last committed layout separate when invalid.
+ */ function resizeCommandFormColumn(committed, columnIndex, width, fields = []) {
+    const draft = {
+        ...committed,
+        columns: committed.columns.map((column)=>column.index === columnIndex ? {
+                ...column,
+                width
+            } : column)
+    };
+    const diagnostics = validateCommandFormLayout.validateCommandFormLayout(draft, fields);
+    return {
+        committed,
+        draft,
+        diagnostics,
+        isValid: diagnostics.length === 0
+    };
+}
+
+exports.resizeCommandFormColumn = resizeCommandFormColumn;
+//# sourceMappingURL=resizeCommandFormColumn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resizeCommandFormColumn.js","sources":["../../../forms/resizeCommandFormColumn.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, FormWidth } from '@cratis/scene.model';\nimport { CommandFormLayoutDraft } from './CommandFormLayoutDraft';\nimport { validateCommandFormLayout } from './validateCommandFormLayout';\n\n/**\n * Resizes a column as draft geometry, keeping the last committed layout separate when invalid.\n */\nexport function resizeCommandFormColumn(\n    committed: CommandFormLayout,\n    columnIndex: number,\n    width: FormWidth,\n    fields: readonly string[] = [],\n): CommandFormLayoutDraft {\n    const draft: CommandFormLayout = {\n        ...committed,\n        columns: committed.columns.map(column => column.index === columnIndex ? { ...column, width } : column),\n    };\n    const diagnostics = validateCommandFormLayout(draft, fields);\n    return { committed, draft, diagnostics, isValid: diagnostics.length === 0 };\n}\n"],"names":["resizeCommandFormColumn","committed","columnIndex","width","fields","draft","columns","map","column","index","diagnostics","validateCommandFormLayout","isValid","length"],"mappings":";;;;AAAA;AACA;AAMA;;IAGO,SAASA,uBAAAA,CACZC,SAA4B,EAC5BC,WAAmB,EACnBC,KAAgB,EAChBC,MAAAA,GAA4B,EAAE,EAAA;AAE9B,IAAA,MAAMC,KAAAA,GAA2B;AAC7B,QAAA,GAAGJ,SAAS;QACZK,OAAAA,EAASL,SAAAA,CAAUK,OAAO,CAACC,GAAG,CAACC,CAAAA,MAAAA,GAAUA,MAAAA,CAAOC,KAAK,KAAKP,WAAAA,GAAc;AAAE,gBAAA,GAAGM,MAAM;AAAEL,gBAAAA;aAAM,GAAIK,MAAAA;AACnG,KAAA;IACA,MAAME,WAAAA,GAAcC,oDAA0BN,KAAAA,EAAOD,MAAAA,CAAAA;IACrD,OAAO;AAAEH,QAAAA,SAAAA;AAAWI,QAAAA,KAAAA;AAAOK,QAAAA,WAAAA;QAAaE,OAAAA,EAASF,WAAAA,CAAYG,MAAM,KAAK;AAAE,KAAA;AAC9E;;"}

package/dist/cjs/forms/updateCommandFormFieldPlacement.js

@@ -0,0 +1,27 @@
+'use strict';
+
+var validateCommandFormLayout = require('./validateCommandFormLayout.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Updates a field placement as draft geometry, keeping the committed layout separate when invalid.
+ */ function updateCommandFormFieldPlacement(committed, placement, fields = []) {
+    const draft = {
+        ...committed,
+        placements: [
+            ...committed.placements.filter((existing)=>existing.field !== placement.field),
+            placement
+        ]
+    };
+    const diagnostics = validateCommandFormLayout.validateCommandFormLayout(draft, fields);
+    return {
+        committed,
+        draft,
+        diagnostics,
+        isValid: diagnostics.length === 0
+    };
+}
+
+exports.updateCommandFormFieldPlacement = updateCommandFormFieldPlacement;
+//# sourceMappingURL=updateCommandFormFieldPlacement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateCommandFormFieldPlacement.js","sources":["../../../forms/updateCommandFormFieldPlacement.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 { validateCommandFormLayout } from './validateCommandFormLayout';\n\n/**\n * Updates a field placement as draft geometry, keeping the committed layout separate when invalid.\n */\nexport function updateCommandFormFieldPlacement(\n    committed: CommandFormLayout,\n    placement: FormFieldPlacement,\n    fields: readonly string[] = [],\n): CommandFormLayoutDraft {\n    const draft: CommandFormLayout = {\n        ...committed,\n        placements: [...committed.placements.filter(existing => existing.field !== placement.field), placement],\n    };\n    const diagnostics = validateCommandFormLayout(draft, fields);\n    return { committed, draft, diagnostics, isValid: diagnostics.length === 0 };\n}\n"],"names":["updateCommandFormFieldPlacement","committed","placement","fields","draft","placements","filter","existing","field","diagnostics","validateCommandFormLayout","isValid","length"],"mappings":";;;;AAAA;AACA;AAMA;;IAGO,SAASA,+BAAAA,CACZC,SAA4B,EAC5BC,SAA6B,EAC7BC,SAA4B,EAAE,EAAA;AAE9B,IAAA,MAAMC,KAAAA,GAA2B;AAC7B,QAAA,GAAGH,SAAS;QACZI,UAAAA,EAAY;eAAIJ,SAAAA,CAAUI,UAAU,CAACC,MAAM,CAACC,CAAAA,WAAYA,QAAAA,CAASC,KAAK,KAAKN,SAAAA,CAAUM,KAAK,CAAA;AAAGN,YAAAA;AAAU;AAC3G,KAAA;IACA,MAAMO,WAAAA,GAAcC,oDAA0BN,KAAAA,EAAOD,MAAAA,CAAAA;IACrD,OAAO;AAAEF,QAAAA,SAAAA;AAAWG,QAAAA,KAAAA;AAAOK,QAAAA,WAAAA;QAAaE,OAAAA,EAASF,WAAAA,CAAYG,MAAM,KAAK;AAAE,KAAA;AAC9E;;"}

package/dist/cjs/forms/validateCommandFormLayout.js

@@ -0,0 +1,72 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var CommandFormLayoutDiagnosticCode = require('./CommandFormLayoutDiagnosticCode.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Validates authored command-form geometry without rewriting invalid drafts.
+ */ function validateCommandFormLayout(layout, fields = []) {
+    const diagnostics = [];
+    const columnIndexes = new Set();
+    const knownFields = new Set(fields);
+    if (!layout.columns.length) diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.EmptyColumns, 'At least one column is required.', 'columns'));
+    layout.columns.forEach((column, index)=>{
+        if (!Number.isInteger(column.index) || column.index < 1) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.InvalidColumnIndex, `Column ${index + 1} must have a one-based integer index.`, `columns.${index}.index`));
+        }
+        if (columnIndexes.has(column.index)) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.DuplicateColumn, `Column ${column.index} is declared more than once.`, `columns.${index}.index`));
+        }
+        columnIndexes.add(column.index);
+        validateWidth(column.width, `columns.${index}.width`, diagnostics);
+        validateWidth(column.minWidth, `columns.${index}.minWidth`, diagnostics);
+        validateWidth(column.maxWidth, `columns.${index}.maxWidth`, diagnostics);
+    });
+    validateWidth(layout.columnGap, 'columnGap', diagnostics);
+    validateWidth(layout.rowGap, 'rowGap', diagnostics);
+    const placements = new Set();
+    layout.placements.forEach((placement, index)=>{
+        if (!placement.field.trim()) diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.MissingField, 'A placement must name its field.', `placements.${index}.field`));
+        if (knownFields.size && !knownFields.has(placement.field)) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.MissingField, `Placement targets unknown field '${placement.field}'.`, `placements.${index}.field`));
+        }
+        if (placements.has(placement.field)) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.DuplicatePlacement, `Field '${placement.field}' is placed more than once.`, `placements.${index}.field`));
+        }
+        placements.add(placement.field);
+        if (!Number.isInteger(placement.row) || placement.row < 1 || !Number.isInteger(placement.column) || placement.column < 1 || placement.rowSpan !== undefined && (!Number.isInteger(placement.rowSpan) || placement.rowSpan < 1) || placement.columnSpan !== undefined && (!Number.isInteger(placement.columnSpan) || placement.columnSpan < 1)) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.InvalidPlacement, `Placement for '${placement.field}' must use positive integer row, column and span values.`, `placements.${index}`));
+        }
+        const span = placement.columnSpan ?? 1;
+        if (layout.columns.length && placement.column + span - 1 > layout.columns.length) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.OutOfBoundsPlacement, `Placement for '${placement.field}' extends beyond the declared columns.`, `placements.${index}.columnSpan`));
+        }
+        validateWidth(placement.width, `placements.${index}.width`, diagnostics);
+    });
+    return diagnostics;
+}
+function validateWidth(width, path, diagnostics) {
+    if (!width) return;
+    if (!Object.values(scene_model.FormWidthUnit).includes(width.unit)) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' uses an unsupported unit.`, path));
+        return;
+    }
+    if (width.unit === scene_model.FormWidthUnit.Auto && width.value !== undefined) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.InvalidWidth, `Automatic width at '${path}' must not carry a numeric value.`, path));
+    }
+    if (width.unit !== scene_model.FormWidthUnit.Auto && (width.value === undefined || width.value < 0 || !Number.isFinite(width.value))) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' must carry a non-negative numeric value.`, path));
+    }
+}
+function problem(code, message, path) {
+    return {
+        code,
+        message,
+        path
+    };
+}
+
+exports.validateCommandFormLayout = validateCommandFormLayout;
+//# sourceMappingURL=validateCommandFormLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateCommandFormLayout.js","sources":["../../../forms/validateCommandFormLayout.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, FormWidth, FormWidthUnit } from '@cratis/scene.model';\nimport { CommandFormLayoutDiagnostic } from './CommandFormLayoutDiagnostic';\nimport { CommandFormLayoutDiagnosticCode } from './CommandFormLayoutDiagnosticCode';\n\n/**\n * Validates authored command-form geometry without rewriting invalid drafts.\n */\nexport function validateCommandFormLayout(layout: CommandFormLayout, fields: readonly string[] = []): CommandFormLayoutDiagnostic[] {\n    const diagnostics: CommandFormLayoutDiagnostic[] = [];\n    const columnIndexes = new Set<number>();\n    const knownFields = new Set(fields);\n\n    if (!layout.columns.length) diagnostics.push(problem(CommandFormLayoutDiagnosticCode.EmptyColumns, 'At least one column is required.', 'columns'));\n    layout.columns.forEach((column, index) => {\n        if (!Number.isInteger(column.index) || column.index < 1) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidColumnIndex, `Column ${index + 1} must have a one-based integer index.`, `columns.${index}.index`));\n        }\n        if (columnIndexes.has(column.index)) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.DuplicateColumn, `Column ${column.index} is declared more than once.`, `columns.${index}.index`));\n        }\n        columnIndexes.add(column.index);\n        validateWidth(column.width, `columns.${index}.width`, diagnostics);\n        validateWidth(column.minWidth, `columns.${index}.minWidth`, diagnostics);\n        validateWidth(column.maxWidth, `columns.${index}.maxWidth`, diagnostics);\n    });\n\n    validateWidth(layout.columnGap, 'columnGap', diagnostics);\n    validateWidth(layout.rowGap, 'rowGap', diagnostics);\n\n    const placements = new Set<string>();\n    layout.placements.forEach((placement, index) => {\n        if (!placement.field.trim()) diagnostics.push(problem(CommandFormLayoutDiagnosticCode.MissingField, 'A placement must name its field.', `placements.${index}.field`));\n        if (knownFields.size && !knownFields.has(placement.field)) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.MissingField, `Placement targets unknown field '${placement.field}'.`, `placements.${index}.field`));\n        }\n        if (placements.has(placement.field)) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.DuplicatePlacement, `Field '${placement.field}' is placed more than once.`, `placements.${index}.field`));\n        }\n        placements.add(placement.field);\n        if (!Number.isInteger(placement.row) || placement.row < 1 || !Number.isInteger(placement.column) || placement.column < 1 ||\n            (placement.rowSpan !== undefined && (!Number.isInteger(placement.rowSpan) || placement.rowSpan < 1)) ||\n            (placement.columnSpan !== undefined && (!Number.isInteger(placement.columnSpan) || placement.columnSpan < 1))) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidPlacement, `Placement for '${placement.field}' must use positive integer row, column and span values.`, `placements.${index}`));\n        }\n        const span = placement.columnSpan ?? 1;\n        if (layout.columns.length && placement.column + span - 1 > layout.columns.length) {\n            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.OutOfBoundsPlacement, `Placement for '${placement.field}' extends beyond the declared columns.`, `placements.${index}.columnSpan`));\n        }\n        validateWidth(placement.width, `placements.${index}.width`, diagnostics);\n    });\n\n    return diagnostics;\n}\n\nfunction validateWidth(width: FormWidth | undefined, path: string, diagnostics: CommandFormLayoutDiagnostic[]): void {\n    if (!width) return;\n    if (!Object.values(FormWidthUnit).includes(width.unit)) {\n        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' uses an unsupported unit.`, path));\n        return;\n    }\n    if (width.unit === FormWidthUnit.Auto && width.value !== undefined) {\n        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Automatic width at '${path}' must not carry a numeric value.`, path));\n    }\n    if (width.unit !== FormWidthUnit.Auto && (width.value === undefined || width.value < 0 || !Number.isFinite(width.value))) {\n        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' must carry a non-negative numeric value.`, path));\n    }\n}\n\nfunction problem(code: CommandFormLayoutDiagnosticCode, message: string, path: string): CommandFormLayoutDiagnostic {\n    return { code, message, path };\n}\n"],"names":["validateCommandFormLayout","layout","fields","diagnostics","columnIndexes","Set","knownFields","columns","length","push","problem","CommandFormLayoutDiagnosticCode","EmptyColumns","forEach","column","index","Number","isInteger","InvalidColumnIndex","has","DuplicateColumn","add","validateWidth","width","minWidth","maxWidth","columnGap","rowGap","placements","placement","field","trim","MissingField","size","DuplicatePlacement","row","rowSpan","undefined","columnSpan","InvalidPlacement","span","OutOfBoundsPlacement","path","Object","values","FormWidthUnit","includes","unit","InvalidWidth","Auto","value","isFinite","code","message"],"mappings":"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"}

package/dist/cjs/index.js

@@ -3,6 +3,16 @@
 var resolveBindingExpression = require('./resolveBindingExpression.js');
 var validateBindingExpression = require('./validateBindingExpression.js');
 var renderElement = require('./renderElement.js');
+var CommandFormLayoutDiagnosticCode = require('./forms/CommandFormLayoutDiagnosticCode.js');
+var commitCommandFormLayoutDraft = require('./forms/commitCommandFormLayoutDraft.js');
+var defaultCommandFormLayout = require('./forms/defaultCommandFormLayout.js');
+var formWidthToCss = require('./forms/formWidthToCss.js');
+var normalizeCommandFormLayout = require('./forms/normalizeCommandFormLayout.js');
+var parseFormWidth = require('./forms/parseFormWidth.js');
+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 elementKind = require('./elementKind.js');
 var panelKind = require('./panelKind.js');
 var flowNodeKind = require('./flowNodeKind.js');
@@ -23,11 +33,19 @@ var resolvePackageDependencies = require('./resolvePackageDependencies.js');
 var packageCatalog = require('./packageCatalog.js');
 var resolveScreenTemplates = require('./resolveScreenTemplates.js');
 var templateApplicability = require('./templateApplicability.js');
+var TemplateCatalogKind = require('./templates/TemplateCatalogKind.js');
+var describeTemplateCatalog = require('./templates/describeTemplateCatalog.js');
+var templateMetadataRules = require('./templates/templateMetadataRules.js');
+var validateTemplateMetadata = require('./templates/validateTemplateMetadata.js');
 var buildStarterProfile = require('./buildStarterProfile.js');
 var incompatibleStarterThemes = require('./incompatibleStarterThemes.js');
 var runActions = require('./runActions.js');
 var resolveBehaviors = require('./resolveBehaviors.js');
 var resolveStrings = require('./resolveStrings.js');
+var NavigationDiagnosticCode = require('./navigation/NavigationDiagnosticCode.js');
+var diagnoseNavigation = require('./navigation/diagnoseNavigation.js');
+var navigationEntriesFrom = require('./navigation/navigationEntriesFrom.js');
+var navigationRoute = require('./navigation/navigationRoute.js');
 var validateNavigationDestinations = require('./validateNavigationDestinations.js');
 var diagnostics = require('./editing/diagnostics.js');
 var nodeIds = require('./editing/nodeIds.js');
@@ -53,6 +71,16 @@ exports.createBindingResolver = resolveBindingExpression.createBindingResolver;
 exports.resolveBindingExpression = resolveBindingExpression.resolveBindingExpression;
 exports.validateBindingExpression = validateBindingExpression.validateBindingExpression;
 exports.renderElement = renderElement.renderElement;
+exports.CommandFormLayoutDiagnosticCode = CommandFormLayoutDiagnosticCode.CommandFormLayoutDiagnosticCode;
+exports.commitCommandFormLayoutDraft = commitCommandFormLayoutDraft.commitCommandFormLayoutDraft;
+exports.defaultCommandFormLayout = defaultCommandFormLayout.defaultCommandFormLayout;
+exports.formWidthToCss = formWidthToCss.formWidthToCss;
+exports.normalizeCommandFormLayout = normalizeCommandFormLayout.normalizeCommandFormLayout;
+exports.parseFormWidth = parseFormWidth.parseFormWidth;
+exports.preserveDirtyCommandValues = preserveDirtyCommandValues.preserveDirtyCommandValues;
+exports.resizeCommandFormColumn = resizeCommandFormColumn.resizeCommandFormColumn;
+exports.updateCommandFormFieldPlacement = updateCommandFormFieldPlacement.updateCommandFormFieldPlacement;
+exports.validateCommandFormLayout = validateCommandFormLayout.validateCommandFormLayout;
 exports.isContentControl = elementKind.isContentControl;
 exports.isExternalComponent = elementKind.isExternalComponent;
 exports.isItemsControl = elementKind.isItemsControl;
@@ -86,6 +114,8 @@ exports.applicableThemePackages = themeCompatibility.applicableThemePackages;
 exports.incompatiblePackages = themeCompatibility.incompatiblePackages;
 exports.isThemeCompatible = themeCompatibility.isThemeCompatible;
 exports.isPackageSelectionValid = PackageSelection.isPackageSelectionValid;
+exports.isValidVersion = packageVersionRange.isValidVersion;
+exports.isValidVersionRange = packageVersionRange.isValidVersionRange;
 exports.isVersionSatisfiedBy = packageVersionRange.isVersionSatisfiedBy;
 exports.resolvePackageDependencies = resolvePackageDependencies.resolvePackageDependencies;
 exports.availablePackagesFor = packageCatalog.availablePackagesFor;
@@ -99,6 +129,11 @@ exports.filterApplicableScreenTemplates = templateApplicability.filterApplicable
 exports.validateDialogTemplateApplicability = templateApplicability.validateDialogTemplateApplicability;
 exports.validateLayoutApplicability = templateApplicability.validateLayoutApplicability;
 exports.validateScreenTemplateApplicability = templateApplicability.validateScreenTemplateApplicability;
+exports.TemplateCatalogKind = TemplateCatalogKind.TemplateCatalogKind;
+exports.describeTemplateCatalog = describeTemplateCatalog.describeTemplateCatalog;
+exports.isAbsoluteHttpsUrl = templateMetadataRules.isAbsoluteHttpsUrl;
+exports.isSpdxExpression = templateMetadataRules.isSpdxExpression;
+exports.validateTemplateMetadata = validateTemplateMetadata.validateTemplateMetadata;
 exports.buildStarterProfile = buildStarterProfile.buildStarterProfile;
 exports.incompatibleStarterThemes = incompatibleStarterThemes.incompatibleStarterThemes;
 exports.InteractionStop = runActions.InteractionStop;
@@ -111,6 +146,11 @@ exports.resolveIntervalBehaviors = resolveBehaviors.resolveIntervalBehaviors;
 exports.isStringsReference = resolveStrings.isStringsReference;
 exports.resolveStringsInElement = resolveStrings.resolveStringsInElement;
 exports.resolveStringsValue = resolveStrings.resolveStringsValue;
+exports.NavigationDiagnosticCode = NavigationDiagnosticCode.NavigationDiagnosticCode;
+exports.diagnoseNavigation = diagnoseNavigation.diagnoseNavigation;
+exports.navigationEntriesFrom = navigationEntriesFrom.navigationEntriesFrom;
+exports.authoredRouteKey = navigationRoute.authoredRouteKey;
+exports.navigationTarget = navigationRoute.navigationTarget;
 exports.validateNavigationDestinations = validateNavigationDestinations.validateNavigationDestinations;
 exports.errorDiagnostic = diagnostics.errorDiagnostic;
 exports.hasErrors = diagnostics.hasErrors;

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/navigation/NavigationDiagnosticCode.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.
+/**
+ * What is wrong with a navigation destination. The values are shared with the C# engine so both report
+ * the same code for the same model.
+ */ var NavigationDiagnosticCode = /*#__PURE__*/ function(NavigationDiagnosticCode) {
+    /** Two destinations that go to different targets share one URL. */ NavigationDiagnosticCode["DuplicateRoute"] = "duplicateRoute";
+    /** Two surfaces declare an outlet with the same name, so a destination cannot tell them apart. */ NavigationDiagnosticCode["DuplicateOutlet"] = "duplicateOutlet";
+    /** A destination names an outlet that no layout or screen template declares. */ NavigationDiagnosticCode["MissingOutlet"] = "missingOutlet";
+    /** A destination names an outlet that cannot host what it opens. */ NavigationDiagnosticCode["IncompatibleOutlet"] = "incompatibleOutlet";
+    /** Screens are placed in outlets owned by each other, so composition never terminates. */ NavigationDiagnosticCode["NavigationCycle"] = "navigationCycle";
+    /** A destination opens a screen or dialog that does not exist, or names nothing to open. */ NavigationDiagnosticCode["UnavailableTarget"] = "unavailableTarget";
+    return NavigationDiagnosticCode;
+}({});
+
+exports.NavigationDiagnosticCode = NavigationDiagnosticCode;
+//# sourceMappingURL=NavigationDiagnosticCode.js.map

package/dist/cjs/navigation/NavigationDiagnosticCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationDiagnosticCode.js","sources":["../../../navigation/NavigationDiagnosticCode.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/**\n * What is wrong with a navigation destination. The values are shared with the C# engine so both report\n * the same code for the same model.\n */\nexport enum NavigationDiagnosticCode {\n    /** Two destinations that go to different targets share one URL. */\n    DuplicateRoute = 'duplicateRoute',\n\n    /** Two surfaces declare an outlet with the same name, so a destination cannot tell them apart. */\n    DuplicateOutlet = 'duplicateOutlet',\n\n    /** A destination names an outlet that no layout or screen template declares. */\n    MissingOutlet = 'missingOutlet',\n\n    /** A destination names an outlet that cannot host what it opens. */\n    IncompatibleOutlet = 'incompatibleOutlet',\n\n    /** Screens are placed in outlets owned by each other, so composition never terminates. */\n    NavigationCycle = 'navigationCycle',\n\n    /** A destination opens a screen or dialog that does not exist, or names nothing to open. */\n    UnavailableTarget = 'unavailableTarget',\n}\n"],"names":["NavigationDiagnosticCode"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,IAAKA,wBAAAA,iBAAAA,SAAAA,wBAAAA,EAAAA;wEACyD,wBAAA,CAAA,gBAAA,CAAA,GAAA,gBAAA;uGAG+B,wBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA;qFAGlB,wBAAA,CAAA,eAAA,CAAA,GAAA,eAAA;yEAGZ,wBAAA,CAAA,oBAAA,CAAA,GAAA,oBAAA;+FAGsB,wBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA;iGAGE,wBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAA;AAhBlFA,IAAAA,OAAAA,wBAAAA;AAkBX,CAAA,CAAA,EAAA;;"}

package/dist/cjs/navigation/collectOutlets.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var NavigationDiagnosticCode = require('./NavigationDiagnosticCode.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Indexes every declared outlet by name, keeping the first declaration and reporting each later one as a
+ * duplicate - a destination names an outlet only by name, so two of them are ambiguous.
+ */ function collectOutlets(graph, diagnostics) {
+    const owners = new Map();
+    const surfaces = [
+        ...(graph.layouts ?? []).map((layout)=>({
+                name: layout.name,
+                kind: 'Layout',
+                outlets: layout.outlets ?? []
+            })),
+        ...(graph.screenTemplates ?? []).map((template)=>({
+                name: template.name,
+                kind: 'ScreenTemplate',
+                outlets: template.outlets ?? []
+            }))
+    ];
+    for (const surface of surfaces){
+        for (const outlet of surface.outlets){
+            const existing = owners.get(outlet.name);
+            if (existing) {
+                diagnostics.push({
+                    code: NavigationDiagnosticCode.NavigationDiagnosticCode.DuplicateOutlet,
+                    message: `Outlet '${outlet.name}' is declared by both '${existing.owner}' and '${surface.name}'; destinations cannot tell them apart.`
+                });
+                continue;
+            }
+            owners.set(outlet.name, {
+                outlet,
+                owner: surface.name,
+                ownerKind: surface.kind
+            });
+        }
+    }
+    return owners;
+}
+
+exports.collectOutlets = collectOutlets;
+//# sourceMappingURL=collectOutlets.js.map

package/dist/cjs/navigation/collectOutlets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectOutlets.js","sources":["../../../navigation/collectOutlets.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 { NavigationDiagnostic } from './NavigationDiagnostic';\nimport { NavigationDiagnosticCode } from './NavigationDiagnosticCode';\nimport { NavigationGraph } from './NavigationGraph';\nimport { OutletOwner } from './OutletOwner';\n\n/**\n * Indexes every declared outlet by name, keeping the first declaration and reporting each later one as a\n * duplicate - a destination names an outlet only by name, so two of them are ambiguous.\n */\nexport function collectOutlets(graph: NavigationGraph, diagnostics: NavigationDiagnostic[]): Map<string, OutletOwner> {\n    const owners = new Map<string, OutletOwner>();\n    const surfaces = [\n        ...(graph.layouts ?? []).map(layout => ({ name: layout.name, kind: 'Layout' as const, outlets: layout.outlets ?? [] })),\n        ...(graph.screenTemplates ?? []).map(template => ({ name: template.name, kind: 'ScreenTemplate' as const, outlets: template.outlets ?? [] })),\n    ];\n\n    for (const surface of surfaces) {\n        for (const outlet of surface.outlets) {\n            const existing = owners.get(outlet.name);\n            if (existing) {\n                diagnostics.push({\n                    code: NavigationDiagnosticCode.DuplicateOutlet,\n                    message: `Outlet '${outlet.name}' is declared by both '${existing.owner}' and '${surface.name}'; destinations cannot tell them apart.`,\n                });\n                continue;\n            }\n\n            owners.set(outlet.name, { outlet, owner: surface.name, ownerKind: surface.kind });\n        }\n    }\n\n    return owners;\n}\n"],"names":["collectOutlets","graph","diagnostics","owners","Map","surfaces","layouts","map","layout","name","kind","outlets","screenTemplates","template","surface","outlet","existing","get","push","code","NavigationDiagnosticCode","DuplicateOutlet","message","owner","set","ownerKind"],"mappings":";;;;AAAA;AACA;AAOA;;;AAGC,IACM,SAASA,cAAAA,CAAeC,KAAsB,EAAEC,WAAmC,EAAA;AACtF,IAAA,MAAMC,SAAS,IAAIC,GAAAA,EAAAA;AACnB,IAAA,MAAMC,QAAAA,GAAW;WACV,CAACJ,KAAAA,CAAMK,OAAO,IAAI,EAAE,EAAEC,GAAG,CAACC,CAAAA,MAAAA,IAAW;AAAEC,gBAAAA,IAAAA,EAAMD,OAAOC,IAAI;gBAAEC,IAAAA,EAAM,QAAA;gBAAmBC,OAAAA,EAASH,MAAAA,CAAOG,OAAO,IAAI;aAAG,CAAA,CAAA;WACjH,CAACV,KAAAA,CAAMW,eAAe,IAAI,EAAE,EAAEL,GAAG,CAACM,CAAAA,QAAAA,IAAa;AAAEJ,gBAAAA,IAAAA,EAAMI,SAASJ,IAAI;gBAAEC,IAAAA,EAAM,gBAAA;gBAA2BC,OAAAA,EAASE,QAAAA,CAASF,OAAO,IAAI;aAAG,CAAA;AAC7I,KAAA;IAED,KAAK,MAAMG,WAAWT,QAAAA,CAAU;AAC5B,QAAA,KAAK,MAAMU,MAAAA,IAAUD,OAAAA,CAAQH,OAAO,CAAE;AAClC,YAAA,MAAMK,QAAAA,GAAWb,MAAAA,CAAOc,GAAG,CAACF,OAAON,IAAI,CAAA;AACvC,YAAA,IAAIO,QAAAA,EAAU;AACVd,gBAAAA,WAAAA,CAAYgB,IAAI,CAAC;AACbC,oBAAAA,IAAAA,EAAMC,kDAAyBC,eAAe;AAC9CC,oBAAAA,OAAAA,EAAS,CAAC,QAAQ,EAAEP,MAAAA,CAAON,IAAI,CAAC,uBAAuB,EAAEO,QAAAA,CAASO,KAAK,CAAC,OAAO,EAAET,QAAQL,IAAI,CAAC,uCAAuC;AACzI,iBAAA,CAAA;AACA,gBAAA;AACJ,YAAA;AAEAN,YAAAA,MAAAA,CAAOqB,GAAG,CAACT,MAAAA,CAAON,IAAI,EAAE;AAAEM,gBAAAA,MAAAA;AAAQQ,gBAAAA,KAAAA,EAAOT,QAAQL,IAAI;AAAEgB,gBAAAA,SAAAA,EAAWX,QAAQJ;AAAK,aAAA,CAAA;AACnF,QAAA;AACJ,IAAA;IAEA,OAAOP,MAAAA;AACX;;"}