@cratis/scene.engine 4.11.0 → 4.13.0

package/dist/esm/forms/validateCommandFormLayout.js

@@ -0,0 +1,70 @@
+import { FormWidthUnit } from '@cratis/scene.model';
+import { CommandFormLayoutDiagnosticCode } from './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.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.InvalidColumnIndex, `Column ${index + 1} must have a one-based integer index.`, `columns.${index}.index`));
+        }
+        if (columnIndexes.has(column.index)) {
+            diagnostics.push(problem(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.MissingField, 'A placement must name its field.', `placements.${index}.field`));
+        if (knownFields.size && !knownFields.has(placement.field)) {
+            diagnostics.push(problem(CommandFormLayoutDiagnosticCode.MissingField, `Placement targets unknown field '${placement.field}'.`, `placements.${index}.field`));
+        }
+        if (placements.has(placement.field)) {
+            diagnostics.push(problem(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.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.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(FormWidthUnit).includes(width.unit)) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' uses an unsupported unit.`, path));
+        return;
+    }
+    if (width.unit === FormWidthUnit.Auto && width.value !== undefined) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Automatic width at '${path}' must not carry a numeric value.`, path));
+    }
+    if (width.unit !== FormWidthUnit.Auto && (width.value === undefined || width.value < 0 || !Number.isFinite(width.value))) {
+        diagnostics.push(problem(CommandFormLayoutDiagnosticCode.InvalidWidth, `Width at '${path}' must carry a non-negative numeric value.`, path));
+    }
+}
+function problem(code, message, path) {
+    return {
+        code,
+        message,
+        path
+    };
+}
+
+export { validateCommandFormLayout };
+//# sourceMappingURL=validateCommandFormLayout.js.map

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

@@ -5,6 +5,7 @@ export * from './BindingDiagnostic';
 export * from './resolveBindingExpression';
 export * from './validateBindingExpression';
 export * from './renderElement';
+export * from './forms';
 export * from './elementKind';
 export * from './panelKind';
 export * from './flowNodeKind';
@@ -23,12 +24,14 @@ export * from './resolvePackageDependencies';
 export * from './packageCatalog';
 export * from './resolveScreenTemplates';
 export * from './templateApplicability';
+export * from './templates';
 export * from './buildStarterProfile';
 export * from './incompatibleStarterThemes';
 export * from './ActionDispatcher';
 export * from './runActions';
 export * from './resolveBehaviors';
 export * from './resolveStrings';
+export * from './navigation';
 export * from './validateNavigationDestinations';
 export * from './editing';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kCAAkC,CAAC;AACjD,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,SAAS,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,kCAAkC,CAAC;AACjD,cAAc,WAAW,CAAC"}

package/dist/esm/index.js

@@ -1,6 +1,16 @@
 export { createBindingResolver, resolveBindingExpression } from './resolveBindingExpression.js';
 export { validateBindingExpression } from './validateBindingExpression.js';
 export { renderElement } from './renderElement.js';
+export { CommandFormLayoutDiagnosticCode } from './forms/CommandFormLayoutDiagnosticCode.js';
+export { commitCommandFormLayoutDraft } from './forms/commitCommandFormLayoutDraft.js';
+export { defaultCommandFormLayout } from './forms/defaultCommandFormLayout.js';
+export { formWidthToCss } from './forms/formWidthToCss.js';
+export { normalizeCommandFormLayout } from './forms/normalizeCommandFormLayout.js';
+export { parseFormWidth } from './forms/parseFormWidth.js';
+export { preserveDirtyCommandValues } from './forms/preserveDirtyCommandValues.js';
+export { resizeCommandFormColumn } from './forms/resizeCommandFormColumn.js';
+export { updateCommandFormFieldPlacement } from './forms/updateCommandFormFieldPlacement.js';
+export { validateCommandFormLayout } from './forms/validateCommandFormLayout.js';
 export { isContentControl, isExternalComponent, isItemsControl, isPanel } from './elementKind.js';
 export { isCanvas, isDockPanel, isGrid, isStackPanel, isWrapPanel } from './panelKind.js';
 export { isFlowColumn, isFlowContainer, isFlowGrid, isFlowLeaf, isFlowRow, isFlowSlotLeaf } from './flowNodeKind.js';
@@ -16,16 +26,24 @@ export { evaluateFreeformSlotArrangement } from './evaluateFreeformSlotArrangeme
 export { aggregateContributions } from './aggregateContributions.js';
 export { applicableThemePackages, incompatiblePackages, isThemeCompatible } from './themeCompatibility.js';
 export { isPackageSelectionValid } from './PackageSelection.js';
-export { isVersionSatisfiedBy } from './packageVersionRange.js';
+export { isValidVersion, isValidVersionRange, isVersionSatisfiedBy } from './packageVersionRange.js';
 export { resolvePackageDependencies } from './resolvePackageDependencies.js';
 export { availablePackagesFor, baseComponentLibraries, componentsForPackages, packagesOfKind, toComponentCatalog } from './packageCatalog.js';
 export { isScreenTemplateResolutionValid, resolveScreenTemplates } from './resolveScreenTemplates.js';
 export { filterApplicableScreenTemplates, validateDialogTemplateApplicability, validateLayoutApplicability, validateScreenTemplateApplicability } from './templateApplicability.js';
+export { TemplateCatalogKind } from './templates/TemplateCatalogKind.js';
+export { describeTemplateCatalog } from './templates/describeTemplateCatalog.js';
+export { isAbsoluteHttpsUrl, isSpdxExpression } from './templates/templateMetadataRules.js';
+export { validateTemplateMetadata } from './templates/validateTemplateMetadata.js';
 export { buildStarterProfile } from './buildStarterProfile.js';
 export { incompatibleStarterThemes } from './incompatibleStarterThemes.js';
 export { InteractionStop, runActions, runBindings } from './runActions.js';
 export { resolveApplicationTriggerBehaviors, resolveBehaviors, resolveEventBehaviors, resolveIntervalBehaviors } from './resolveBehaviors.js';
 export { isStringsReference, resolveStringsInElement, resolveStringsValue } from './resolveStrings.js';
+export { NavigationDiagnosticCode } from './navigation/NavigationDiagnosticCode.js';
+export { diagnoseNavigation } from './navigation/diagnoseNavigation.js';
+export { navigationEntriesFrom } from './navigation/navigationEntriesFrom.js';
+export { authoredRouteKey, navigationTarget } from './navigation/navigationRoute.js';
 export { validateNavigationDestinations } from './validateNavigationDestinations.js';
 export { errorDiagnostic, hasErrors, warningDiagnostic } from './editing/diagnostics.js';
 export { dialogTemplateNodeId, elementNodeId, flowNodeId, freeformNodeId, layoutNodeId, ownerArrangementId, placementNodeId, scopeInstanceId, scopeNodeId, screenNodeId, screenTemplateNodeId, slotNodeId } from './editing/nodeIds.js';

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

@@ -0,0 +1,7 @@
+import { NavigationDiagnosticCode } from './NavigationDiagnosticCode';
+export interface NavigationDiagnostic {
+    code: NavigationDiagnosticCode;
+    message: string;
+    entry?: string;
+}
+//# sourceMappingURL=NavigationDiagnostic.d.ts.map

package/dist/esm/navigation/NavigationDiagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationDiagnostic.d.ts","sourceRoot":"","sources":["../../../navigation/NavigationDiagnostic.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAKtE,MAAM,WAAW,oBAAoB;IAEjC,IAAI,EAAE,wBAAwB,CAAC;IAG/B,OAAO,EAAE,MAAM,CAAC;IAGhB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/esm/navigation/NavigationDiagnostic.js

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

package/dist/esm/navigation/NavigationDiagnostic.js.map

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

package/dist/esm/navigation/NavigationDiagnosticCode.d.ts

@@ -0,0 +1,9 @@
+export declare enum NavigationDiagnosticCode {
+    DuplicateRoute = "duplicateRoute",
+    DuplicateOutlet = "duplicateOutlet",
+    MissingOutlet = "missingOutlet",
+    IncompatibleOutlet = "incompatibleOutlet",
+    NavigationCycle = "navigationCycle",
+    UnavailableTarget = "unavailableTarget"
+}
+//# sourceMappingURL=NavigationDiagnosticCode.d.ts.map

package/dist/esm/navigation/NavigationDiagnosticCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationDiagnosticCode.d.ts","sourceRoot":"","sources":["../../../navigation/NavigationDiagnosticCode.ts"],"names":[],"mappings":"AAOA,oBAAY,wBAAwB;IAEhC,cAAc,mBAAmB;IAGjC,eAAe,oBAAoB;IAGnC,aAAa,kBAAkB;IAG/B,kBAAkB,uBAAuB;IAGzC,eAAe,oBAAoB;IAGnC,iBAAiB,sBAAsB;CAC1C"}

package/dist/esm/navigation/NavigationDiagnosticCode.js

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

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

@@ -0,0 +1,6 @@
+import { DestinationReference } from '@cratis/scene.model';
+export interface NavigationEntry {
+    id?: string;
+    destination: DestinationReference;
+}
+//# sourceMappingURL=NavigationEntry.d.ts.map

package/dist/esm/navigation/NavigationEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationEntry.d.ts","sourceRoot":"","sources":["../../../navigation/NavigationEntry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM3D,MAAM,WAAW,eAAe;IAE5B,EAAE,CAAC,EAAE,MAAM,CAAC;IAGZ,WAAW,EAAE,oBAAoB,CAAC;CACrC"}

package/dist/esm/navigation/NavigationEntry.js

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

package/dist/esm/navigation/NavigationEntry.js.map

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

package/dist/esm/navigation/NavigationGraph.d.ts

@@ -0,0 +1,10 @@
+import { DialogTemplate, Layout, Screen, ScreenTemplate } from '@cratis/scene.model';
+import { NavigationEntry } from './NavigationEntry';
+export interface NavigationGraph {
+    entries: NavigationEntry[];
+    screens?: Screen[];
+    layouts?: Layout[];
+    screenTemplates?: ScreenTemplate[];
+    dialogTemplates?: DialogTemplate[];
+}
+//# sourceMappingURL=NavigationGraph.d.ts.map

package/dist/esm/navigation/NavigationGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../navigation/NavigationGraph.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,WAAW,eAAe;IAE5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAG3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAGnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAGnB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IAGnC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACtC"}

package/dist/esm/navigation/NavigationGraph.js

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

package/dist/esm/navigation/NavigationGraph.js.map

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

package/dist/esm/navigation/OutletOwner.d.ts

@@ -0,0 +1,7 @@
+import { Outlet } from '@cratis/scene.model';
+export interface OutletOwner {
+    outlet: Outlet;
+    owner: string;
+    ownerKind: 'Layout' | 'ScreenTemplate';
+}
+//# sourceMappingURL=OutletOwner.d.ts.map

package/dist/esm/navigation/OutletOwner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutletOwner.d.ts","sourceRoot":"","sources":["../../../navigation/OutletOwner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAK7C,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,QAAQ,GAAG,gBAAgB,CAAC;CAC1C"}

package/dist/esm/navigation/OutletOwner.js

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

package/dist/esm/navigation/OutletOwner.js.map

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

package/dist/esm/navigation/collectOutlets.d.ts

@@ -0,0 +1,5 @@
+import { NavigationDiagnostic } from './NavigationDiagnostic';
+import { NavigationGraph } from './NavigationGraph';
+import { OutletOwner } from './OutletOwner';
+export declare function collectOutlets(graph: NavigationGraph, diagnostics: NavigationDiagnostic[]): Map<string, OutletOwner>;
+//# sourceMappingURL=collectOutlets.d.ts.map

package/dist/esm/navigation/collectOutlets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectOutlets.d.ts","sourceRoot":"","sources":["../../../navigation/collectOutlets.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAuBpH"}

package/dist/esm/navigation/collectOutlets.js

@@ -0,0 +1,43 @@
+import { NavigationDiagnosticCode } from './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.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;
+}
+
+export { collectOutlets };
+//# sourceMappingURL=collectOutlets.js.map

package/dist/esm/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,yBAAyBC,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;;"}

package/dist/esm/navigation/diagnoseNavigation.d.ts

@@ -0,0 +1,5 @@
+import { NavigationDiagnostic } from './NavigationDiagnostic';
+import { NavigationGraph } from './NavigationGraph';
+import { NavigationRouteKey } from './navigationRoute';
+export declare function diagnoseNavigation(graph: NavigationGraph, routeKey?: NavigationRouteKey): NavigationDiagnostic[];
+//# sourceMappingURL=diagnoseNavigation.d.ts.map

package/dist/esm/navigation/diagnoseNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoseNavigation.d.ts","sourceRoot":"","sources":["../../../navigation/diagnoseNavigation.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAsC,MAAM,mBAAmB,CAAC;AAW3F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,GAAE,kBAAqC,GAAG,oBAAoB,EAAE,CA6ClI"}

package/dist/esm/navigation/diagnoseNavigation.js

@@ -0,0 +1,114 @@
+import { DestinationKind } from '@cratis/scene.model';
+import { collectOutlets } from './collectOutlets.js';
+import { findHostingCycles } from './findHostingCycles.js';
+import { NavigationDiagnosticCode } from './NavigationDiagnosticCode.js';
+import { authoredRouteKey, navigationTarget } from './navigationRoute.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Diagnoses how destinations, outlets, routes and targets fit together: duplicate routes, duplicate,
+ * missing or incompatible outlets, hosting cycles and unavailable targets.
+ *
+ * Routes are compared by `routeKey` - by default the authored route override, since the engine constructs no
+ * URLs. Nothing is rewritten. The C# engine (`NavigationDiagnostics.Diagnose`) reports the same codes and
+ * messages in the same order for the same model; both are asserted against `navigation-diagnostic-fixtures.json`.
+ */ function diagnoseNavigation(graph, routeKey = authoredRouteKey) {
+    const diagnostics = [];
+    const outlets = collectOutlets(graph, diagnostics);
+    const screens = graph.screens ? new Map(graph.screens.map((screen)=>[
+            screen.name,
+            screen
+        ])) : undefined;
+    const routes = new Map();
+    const hostedIn = new Map();
+    graph.entries.forEach((navigationEntry, index)=>{
+        const entry = navigationEntry.id ?? `#${index + 1}`;
+        const destination = navigationEntry.destination;
+        const kind = destination.kind ?? (destination.dialog ? DestinationKind.Dialog : DestinationKind.Outlet);
+        const report = (code, message)=>diagnostics.push({
+                code,
+                message,
+                entry
+            });
+        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {
+            report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' names no screen, stable identity, route or dialog.`);
+            return;
+        }
+        diagnoseTarget(graph, screens, destination, kind, entry, report);
+        const owner = diagnoseOutlet(graph, outlets, screens, destination, kind, entry, report);
+        if (owner?.ownerKind === 'ScreenTemplate' && destination.screen && screens?.has(destination.screen)) {
+            const hosts = graph.screens.filter((screen)=>screen.screenTemplate === owner.owner).map((screen)=>screen.name);
+            hostedIn.set(destination.screen, [
+                ...new Set([
+                    ...hostedIn.get(destination.screen) ?? [],
+                    ...hosts
+                ])
+            ]);
+        }
+        const route = kind === DestinationKind.External ? undefined : routeKey(destination);
+        if (route) {
+            const target = navigationTarget(destination, kind);
+            const existing = routes.get(route);
+            if (!existing) {
+                routes.set(route, {
+                    entry,
+                    target
+                });
+            } else if (existing.target !== target) {
+                report(NavigationDiagnosticCode.DuplicateRoute, `Route '${destination.route ?? route}' is used by destinations '${existing.entry}' and '${entry}', which open different targets.`);
+            }
+        }
+    });
+    for (const cycle of findHostingCycles(graph.screens?.map((screen)=>screen.name) ?? [], hostedIn)){
+        diagnostics.push({
+            code: NavigationDiagnosticCode.NavigationCycle,
+            message: `Navigation cycle ${[
+                ...cycle,
+                cycle[0]
+            ].join(' -> ')}: each screen is placed in an outlet owned by the next, so composition never terminates.`
+        });
+    }
+    return diagnostics;
+}
+function diagnoseTarget(graph, screens, destination, kind, entry, report) {
+    if (kind === DestinationKind.Dialog) {
+        if (!destination.dialog) {
+            report(NavigationDiagnosticCode.UnavailableTarget, `Dialog destination '${entry}' names no dialog.`);
+        } else if (graph.dialogTemplates && !graph.dialogTemplates.some((template)=>template.name === destination.dialog)) {
+            report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' opens dialog '${destination.dialog}', which no dialog template provides.`);
+        }
+        return;
+    }
+    if (kind === DestinationKind.Outlet && destination.screen && screens && !screens.has(destination.screen)) {
+        report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' opens screen '${destination.screen}', which does not exist.`);
+    }
+}
+function diagnoseOutlet(graph, outlets, screens, destination, kind, entry, report) {
+    if (!destination.outlet) return undefined;
+    if (kind !== DestinationKind.Outlet) {
+        const opens = kind === DestinationKind.Dialog ? 'a dialog' : 'an external target';
+        report(NavigationDiagnosticCode.IncompatibleOutlet, `Destination '${entry}' opens ${opens} but names outlet '${destination.outlet}'; only outlet destinations render in outlets.`);
+        return undefined;
+    }
+    const owner = outlets.get(destination.outlet);
+    if (!owner) {
+        report(NavigationDiagnosticCode.MissingOutlet, `Destination '${entry}' targets missing outlet '${destination.outlet}'.`);
+        return undefined;
+    }
+    const screen = destination.screen ? screens?.get(destination.screen) : undefined;
+    if (!screen) return owner;
+    if (owner.ownerKind === 'Layout' && screen.layout !== owner.owner) {
+        report(NavigationDiagnosticCode.IncompatibleOutlet, `Outlet '${owner.outlet.name}' belongs to layout '${owner.owner}', but destination '${entry}' places '${screen.name}', which renders in layout '${screen.layout}'.`);
+    }
+    if (owner.outlet.accepts) {
+        const type = graph.screenTemplates?.find((template)=>template.name === screen.screenTemplate)?.metadata?.type;
+        if (!type || !owner.outlet.accepts.includes(type)) {
+            report(NavigationDiagnosticCode.IncompatibleOutlet, `Outlet '${owner.outlet.name}' accepts ${owner.outlet.accepts.join(', ')} screens, but destination '${entry}' places '${screen.name}' of type '${type ?? 'untyped'}'.`);
+        }
+    }
+    return owner;
+}
+
+export { diagnoseNavigation };
+//# sourceMappingURL=diagnoseNavigation.js.map

package/dist/esm/navigation/diagnoseNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoseNavigation.js","sources":["../../../navigation/diagnoseNavigation.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 { DestinationKind, DestinationReference, Screen } from '@cratis/scene.model';\nimport { collectOutlets } from './collectOutlets';\nimport { findHostingCycles } from './findHostingCycles';\nimport { NavigationDiagnostic } from './NavigationDiagnostic';\nimport { NavigationDiagnosticCode } from './NavigationDiagnosticCode';\nimport { NavigationGraph } from './NavigationGraph';\nimport { NavigationRouteKey, authoredRouteKey, navigationTarget } from './navigationRoute';\nimport { OutletOwner } from './OutletOwner';\n\n/**\n * Diagnoses how destinations, outlets, routes and targets fit together: duplicate routes, duplicate,\n * missing or incompatible outlets, hosting cycles and unavailable targets.\n *\n * Routes are compared by `routeKey` - by default the authored route override, since the engine constructs no\n * URLs. Nothing is rewritten. The C# engine (`NavigationDiagnostics.Diagnose`) reports the same codes and\n * messages in the same order for the same model; both are asserted against `navigation-diagnostic-fixtures.json`.\n */\nexport function diagnoseNavigation(graph: NavigationGraph, routeKey: NavigationRouteKey = authoredRouteKey): NavigationDiagnostic[] {\n    const diagnostics: NavigationDiagnostic[] = [];\n    const outlets = collectOutlets(graph, diagnostics);\n    const screens = graph.screens ? new Map(graph.screens.map(screen => [screen.name, screen])) : undefined;\n    const routes = new Map<string, { entry: string; target: string }>();\n    const hostedIn = new Map<string, string[]>();\n\n    graph.entries.forEach((navigationEntry, index) => {\n        const entry = navigationEntry.id ?? `#${index + 1}`;\n        const destination = navigationEntry.destination;\n        const kind = destination.kind ?? (destination.dialog ? DestinationKind.Dialog : DestinationKind.Outlet);\n        const report = (code: NavigationDiagnosticCode, message: string) => diagnostics.push({ code, message, entry });\n\n        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {\n            report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' names no screen, stable identity, route or dialog.`);\n            return;\n        }\n\n        diagnoseTarget(graph, screens, destination, kind, entry, report);\n        const owner = diagnoseOutlet(graph, outlets, screens, destination, kind, entry, report);\n        if (owner?.ownerKind === 'ScreenTemplate' && destination.screen && screens?.has(destination.screen)) {\n            const hosts = graph.screens!.filter(screen => screen.screenTemplate === owner.owner).map(screen => screen.name);\n            hostedIn.set(destination.screen, [...new Set([...(hostedIn.get(destination.screen) ?? []), ...hosts])]);\n        }\n\n        const route = kind === DestinationKind.External ? undefined : routeKey(destination);\n        if (route) {\n            const target = navigationTarget(destination, kind);\n            const existing = routes.get(route);\n            if (!existing) {\n                routes.set(route, { entry, target });\n            } else if (existing.target !== target) {\n                report(NavigationDiagnosticCode.DuplicateRoute, `Route '${destination.route ?? route}' is used by destinations '${existing.entry}' and '${entry}', which open different targets.`);\n            }\n        }\n    });\n\n    for (const cycle of findHostingCycles(graph.screens?.map(screen => screen.name) ?? [], hostedIn)) {\n        diagnostics.push({\n            code: NavigationDiagnosticCode.NavigationCycle,\n            message: `Navigation cycle ${[...cycle, cycle[0]].join(' -> ')}: each screen is placed in an outlet owned by the next, so composition never terminates.`,\n        });\n    }\n\n    return diagnostics;\n}\n\ntype Report = (code: NavigationDiagnosticCode, message: string) => void;\n\nfunction diagnoseTarget(\n    graph: NavigationGraph,\n    screens: Map<string, Screen> | undefined,\n    destination: DestinationReference,\n    kind: DestinationKind,\n    entry: string,\n    report: Report,\n) {\n    if (kind === DestinationKind.Dialog) {\n        if (!destination.dialog) {\n            report(NavigationDiagnosticCode.UnavailableTarget, `Dialog destination '${entry}' names no dialog.`);\n        } else if (graph.dialogTemplates && !graph.dialogTemplates.some(template => template.name === destination.dialog)) {\n            report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' opens dialog '${destination.dialog}', which no dialog template provides.`);\n        }\n        return;\n    }\n\n    if (kind === DestinationKind.Outlet && destination.screen && screens && !screens.has(destination.screen)) {\n        report(NavigationDiagnosticCode.UnavailableTarget, `Destination '${entry}' opens screen '${destination.screen}', which does not exist.`);\n    }\n}\n\nfunction diagnoseOutlet(\n    graph: NavigationGraph,\n    outlets: Map<string, OutletOwner>,\n    screens: Map<string, Screen> | undefined,\n    destination: DestinationReference,\n    kind: DestinationKind,\n    entry: string,\n    report: Report,\n): OutletOwner | undefined {\n    if (!destination.outlet) return undefined;\n\n    if (kind !== DestinationKind.Outlet) {\n        const opens = kind === DestinationKind.Dialog ? 'a dialog' : 'an external target';\n        report(NavigationDiagnosticCode.IncompatibleOutlet, `Destination '${entry}' opens ${opens} but names outlet '${destination.outlet}'; only outlet destinations render in outlets.`);\n        return undefined;\n    }\n\n    const owner = outlets.get(destination.outlet);\n    if (!owner) {\n        report(NavigationDiagnosticCode.MissingOutlet, `Destination '${entry}' targets missing outlet '${destination.outlet}'.`);\n        return undefined;\n    }\n\n    const screen = destination.screen ? screens?.get(destination.screen) : undefined;\n    if (!screen) return owner;\n\n    if (owner.ownerKind === 'Layout' && screen.layout !== owner.owner) {\n        report(\n            NavigationDiagnosticCode.IncompatibleOutlet,\n            `Outlet '${owner.outlet.name}' belongs to layout '${owner.owner}', but destination '${entry}' places '${screen.name}', which renders in layout '${screen.layout}'.`,\n        );\n    }\n\n    if (owner.outlet.accepts) {\n        const type = graph.screenTemplates?.find(template => template.name === screen.screenTemplate)?.metadata?.type;\n        if (!type || !owner.outlet.accepts.includes(type)) {\n            report(\n                NavigationDiagnosticCode.IncompatibleOutlet,\n                `Outlet '${owner.outlet.name}' accepts ${owner.outlet.accepts.join(', ')} screens, but destination '${entry}' places '${screen.name}' of type '${type ?? 'untyped'}'.`,\n            );\n        }\n    }\n\n    return owner;\n}\n"],"names":["diagnoseNavigation","graph","routeKey","authoredRouteKey","diagnostics","outlets","collectOutlets","screens","Map","map","screen","name","undefined","routes","hostedIn","entries","forEach","navigationEntry","index","entry","id","destination","kind","dialog","DestinationKind","Dialog","Outlet","report","code","message","push","module","route","NavigationDiagnosticCode","UnavailableTarget","diagnoseTarget","owner","diagnoseOutlet","ownerKind","has","hosts","filter","screenTemplate","set","Set","get","External","target","navigationTarget","existing","DuplicateRoute","cycle","findHostingCycles","NavigationCycle","join","dialogTemplates","some","template","outlet","opens","IncompatibleOutlet","MissingOutlet","layout","accepts","type","screenTemplates","find","metadata","includes"],"mappings":"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"}

package/dist/esm/navigation/findHostingCycles.d.ts

@@ -0,0 +1,2 @@
+export declare function findHostingCycles(screens: string[], edges: Map<string, string[]>): string[][];
+//# sourceMappingURL=findHostingCycles.d.ts.map

package/dist/esm/navigation/findHostingCycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findHostingCycles.d.ts","sourceRoot":"","sources":["../../../navigation/findHostingCycles.ts"],"names":[],"mappings":"AASA,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,CA+B7F"}

package/dist/esm/navigation/findHostingCycles.js

@@ -0,0 +1,41 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Finds cycles in a "renders inside" graph, where an edge from a screen to another means the first is
+ * placed in an outlet the second one's template owns. Screens are visited in the given order and edges in
+ * insertion order, so the same graph always yields the same cycles in the same order. Each set of screens
+ * is reported once, starting from the screen the walk reached it through.
+ */ function findHostingCycles(screens, edges) {
+    const state = new Map();
+    const stack = [];
+    const reported = new Set();
+    const cycles = [];
+    const visit = (screen)=>{
+        state.set(screen, 'visiting');
+        stack.push(screen);
+        for (const host of edges.get(screen) ?? []){
+            const hostState = state.get(host);
+            if (hostState === 'visiting') {
+                const cycle = stack.slice(stack.indexOf(host));
+                const key = [
+                    ...cycle
+                ].sort().join('\u0000');
+                if (!reported.has(key)) {
+                    reported.add(key);
+                    cycles.push(cycle);
+                }
+            } else if (hostState === undefined) {
+                visit(host);
+            }
+        }
+        stack.pop();
+        state.set(screen, 'done');
+    };
+    for (const screen of screens){
+        if (!state.has(screen)) visit(screen);
+    }
+    return cycles;
+}
+
+export { findHostingCycles };
+//# sourceMappingURL=findHostingCycles.js.map

package/dist/esm/navigation/findHostingCycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findHostingCycles.js","sources":["../../../navigation/findHostingCycles.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 * Finds cycles in a \"renders inside\" graph, where an edge from a screen to another means the first is\n * placed in an outlet the second one's template owns. Screens are visited in the given order and edges in\n * insertion order, so the same graph always yields the same cycles in the same order. Each set of screens\n * is reported once, starting from the screen the walk reached it through.\n */\nexport function findHostingCycles(screens: string[], edges: Map<string, string[]>): string[][] {\n    const state = new Map<string, 'visiting' | 'done'>();\n    const stack: string[] = [];\n    const reported = new Set<string>();\n    const cycles: string[][] = [];\n\n    const visit = (screen: string) => {\n        state.set(screen, 'visiting');\n        stack.push(screen);\n        for (const host of edges.get(screen) ?? []) {\n            const hostState = state.get(host);\n            if (hostState === 'visiting') {\n                const cycle = stack.slice(stack.indexOf(host));\n                const key = [...cycle].sort().join('\\u0000');\n                if (!reported.has(key)) {\n                    reported.add(key);\n                    cycles.push(cycle);\n                }\n            } else if (hostState === undefined) {\n                visit(host);\n            }\n        }\n        stack.pop();\n        state.set(screen, 'done');\n    };\n\n    for (const screen of screens) {\n        if (!state.has(screen)) visit(screen);\n    }\n\n    return cycles;\n}\n"],"names":["findHostingCycles","screens","edges","state","Map","stack","reported","Set","cycles","visit","screen","set","push","host","get","hostState","cycle","slice","indexOf","key","sort","join","has","add","undefined","pop"],"mappings":"AAAA;AACA;AAEA;;;;;AAKC,IACM,SAASA,iBAAAA,CAAkBC,OAAiB,EAAEC,KAA4B,EAAA;AAC7E,IAAA,MAAMC,QAAQ,IAAIC,GAAAA,EAAAA;AAClB,IAAA,MAAMC,QAAkB,EAAE;AAC1B,IAAA,MAAMC,WAAW,IAAIC,GAAAA,EAAAA;AACrB,IAAA,MAAMC,SAAqB,EAAE;AAE7B,IAAA,MAAMC,QAAQ,CAACC,MAAAA,GAAAA;QACXP,KAAAA,CAAMQ,GAAG,CAACD,MAAAA,EAAQ,UAAA,CAAA;AAClBL,QAAAA,KAAAA,CAAMO,IAAI,CAACF,MAAAA,CAAAA;AACX,QAAA,KAAK,MAAMG,IAAAA,IAAQX,KAAAA,CAAMY,GAAG,CAACJ,MAAAA,CAAAA,IAAW,EAAE,CAAE;YACxC,MAAMK,SAAAA,GAAYZ,KAAAA,CAAMW,GAAG,CAACD,IAAAA,CAAAA;AAC5B,YAAA,IAAIE,cAAc,UAAA,EAAY;AAC1B,gBAAA,MAAMC,QAAQX,KAAAA,CAAMY,KAAK,CAACZ,KAAAA,CAAMa,OAAO,CAACL,IAAAA,CAAAA,CAAAA;AACxC,gBAAA,MAAMM,GAAAA,GAAM;AAAIH,oBAAAA,GAAAA;iBAAM,CAACI,IAAI,EAAA,CAAGC,IAAI,CAAC,QAAA,CAAA;AACnC,gBAAA,IAAI,CAACf,QAAAA,CAASgB,GAAG,CAACH,GAAAA,CAAAA,EAAM;AACpBb,oBAAAA,QAAAA,CAASiB,GAAG,CAACJ,GAAAA,CAAAA;AACbX,oBAAAA,MAAAA,CAAOI,IAAI,CAACI,KAAAA,CAAAA;AAChB,gBAAA;YACJ,CAAA,MAAO,IAAID,cAAcS,SAAAA,EAAW;gBAChCf,KAAAA,CAAMI,IAAAA,CAAAA;AACV,YAAA;AACJ,QAAA;AACAR,QAAAA,KAAAA,CAAMoB,GAAG,EAAA;QACTtB,KAAAA,CAAMQ,GAAG,CAACD,MAAAA,EAAQ,MAAA,CAAA;AACtB,IAAA,CAAA;IAEA,KAAK,MAAMA,UAAUT,OAAAA,CAAS;AAC1B,QAAA,IAAI,CAACE,KAAAA,CAAMmB,GAAG,CAACZ,SAASD,KAAAA,CAAMC,MAAAA,CAAAA;AAClC,IAAA;IAEA,OAAOF,MAAAA;AACX;;"}

package/dist/esm/navigation/index.d.ts

@@ -0,0 +1,8 @@
+export * from './NavigationDiagnostic';
+export * from './NavigationDiagnosticCode';
+export * from './NavigationEntry';
+export * from './NavigationGraph';
+export * from './diagnoseNavigation';
+export * from './navigationEntriesFrom';
+export * from './navigationRoute';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../navigation/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC"}