@cratis/scene.engine 4.12.0 → 4.13.0

package/dist/cjs/templates/templateMetadataRules.js

@@ -0,0 +1,32 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Whether a value is an absolute `https` URL with a host - the only kind of link a template browser
+ * should follow for attribution or license terms. Kept to plain string rules so the C# twin matches exactly.
+ */ function isAbsoluteHttpsUrl(value) {
+    const prefix = 'https://';
+    return value.startsWith(prefix) && value.length > prefix.length && value[prefix.length] !== '/' && !/\s/.test(value);
+}
+/**
+ * Whether a value is a simple SPDX license expression: identifiers such as `MIT`, `Apache-2.0` or
+ * `LicenseRef-Acme`, optionally joined by `AND`, `OR` or `WITH`. Parentheses are not supported.
+ */ function isSpdxExpression(value) {
+    const tokens = value.split(' ');
+    if (tokens.length % 2 === 0) return false;
+    return tokens.every((token, index)=>index % 2 === 1 ? [
+            'AND',
+            'OR',
+            'WITH'
+        ].includes(token) : isSpdxIdentifier(token));
+}
+function isSpdxIdentifier(token) {
+    return token.length > 0 && [
+        ...token
+    ].every((character)=>/[A-Za-z0-9.+-]/.test(character));
+}
+
+exports.isAbsoluteHttpsUrl = isAbsoluteHttpsUrl;
+exports.isSpdxExpression = isSpdxExpression;
+//# sourceMappingURL=templateMetadataRules.js.map

package/dist/cjs/templates/templateMetadataRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateMetadataRules.js","sources":["../../../templates/templateMetadataRules.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 * Whether a value is an absolute `https` URL with a host - the only kind of link a template browser\n * should follow for attribution or license terms. Kept to plain string rules so the C# twin matches exactly.\n */\nexport function isAbsoluteHttpsUrl(value: string): boolean {\n    const prefix = 'https://';\n    return value.startsWith(prefix) && value.length > prefix.length && value[prefix.length] !== '/' && !/\\s/.test(value);\n}\n\n/**\n * Whether a value is a simple SPDX license expression: identifiers such as `MIT`, `Apache-2.0` or\n * `LicenseRef-Acme`, optionally joined by `AND`, `OR` or `WITH`. Parentheses are not supported.\n */\nexport function isSpdxExpression(value: string): boolean {\n    const tokens = value.split(' ');\n    if (tokens.length % 2 === 0) return false;\n    return tokens.every((token, index) => (index % 2 === 1 ? ['AND', 'OR', 'WITH'].includes(token) : isSpdxIdentifier(token)));\n}\n\nfunction isSpdxIdentifier(token: string): boolean {\n    return token.length > 0 && [...token].every(character => /[A-Za-z0-9.+-]/.test(character));\n}\n"],"names":["isAbsoluteHttpsUrl","value","prefix","startsWith","length","test","isSpdxExpression","tokens","split","every","token","index","includes","isSpdxIdentifier","character"],"mappings":";;AAAA;AACA;AAEA;;;IAIO,SAASA,kBAAAA,CAAmBC,KAAa,EAAA;AAC5C,IAAA,MAAMC,MAAAA,GAAS,UAAA;IACf,OAAOD,KAAAA,CAAME,UAAU,CAACD,MAAAA,CAAAA,IAAWD,MAAMG,MAAM,GAAGF,OAAOE,MAAM,IAAIH,KAAK,CAACC,MAAAA,CAAOE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAA,CAAKC,IAAI,CAACJ,KAAAA,CAAAA;AAClH;AAEA;;;IAIO,SAASK,gBAAAA,CAAiBL,KAAa,EAAA;IAC1C,MAAMM,MAAAA,GAASN,KAAAA,CAAMO,KAAK,CAAC,GAAA,CAAA;AAC3B,IAAA,IAAID,MAAAA,CAAOH,MAAM,GAAG,CAAA,KAAM,GAAG,OAAO,KAAA;IACpC,OAAOG,MAAAA,CAAOE,KAAK,CAAC,CAACC,OAAOC,KAAAA,GAAWA,KAAAA,GAAQ,MAAM,CAAA,GAAI;AAAC,YAAA,KAAA;AAAO,YAAA,IAAA;AAAM,YAAA;SAAO,CAACC,QAAQ,CAACF,KAAAA,CAAAA,GAASG,gBAAAA,CAAiBH,KAAAA,CAAAA,CAAAA;AACtH;AAEA,SAASG,iBAAiBH,KAAa,EAAA;IACnC,OAAOA,KAAAA,CAAMN,MAAM,GAAG,CAAA,IAAK;AAAIM,QAAAA,GAAAA;AAAM,KAAA,CAACD,KAAK,CAACK,CAAAA,SAAAA,GAAa,gBAAA,CAAiBT,IAAI,CAACS,SAAAA,CAAAA,CAAAA;AACnF;;;"}

package/dist/cjs/templates/validateTemplateMetadata.js

@@ -0,0 +1,50 @@
+'use strict';
+
+var packageVersionRange = require('../packageVersionRange.js');
+var templateMetadataRules = require('./templateMetadataRules.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Checks that a template carries the compatibility, attribution and license metadata every shipped template
+ * needs, and that each value is well formed. The C# engine (`TemplateMetadataValidation.Validate`) reports the
+ * same problems in the same order; both are asserted against `template-metadata-fixtures.json`.
+ */ function validateTemplateMetadata(name, metadata) {
+    const problems = [];
+    const compatibility = metadata?.compatibility;
+    if (!compatibility) {
+        problems.push(`Template '${name}' declares no compatibility`);
+    } else {
+        if (!compatibility.scene?.trim()) {
+            problems.push(`Template '${name}' declares no Scene version range`);
+        } else if (!packageVersionRange.isValidVersionRange(compatibility.scene)) {
+            problems.push(`Template '${name}' declares an invalid Scene version range '${compatibility.scene}'`);
+        }
+        for (const requirement of compatibility.packages ?? []){
+            if (!requirement.name?.trim()) {
+                problems.push(`Template '${name}' declares a package requirement without a name`);
+            } else if (!packageVersionRange.isValidVersionRange(requirement.versionRange)) {
+                problems.push(`Template '${name}' declares an invalid version range '${requirement.versionRange}' for package '${requirement.name}'`);
+            }
+        }
+    }
+    const attribution = metadata?.attribution;
+    if (!attribution?.author?.trim()) {
+        problems.push(`Template '${name}' declares no author`);
+    }
+    if (attribution?.url !== undefined && !templateMetadataRules.isAbsoluteHttpsUrl(attribution.url)) {
+        problems.push(`Template '${name}' declares an attribution URL '${attribution.url}' that is not an absolute https URL`);
+    }
+    if (!metadata?.license?.trim()) {
+        problems.push(`Template '${name}' declares no license`);
+    } else if (!templateMetadataRules.isSpdxExpression(metadata.license)) {
+        problems.push(`Template '${name}' declares '${metadata.license}', which is not an SPDX license expression`);
+    }
+    if (metadata?.licenseUrl !== undefined && !templateMetadataRules.isAbsoluteHttpsUrl(metadata.licenseUrl)) {
+        problems.push(`Template '${name}' declares a license URL '${metadata.licenseUrl}' that is not an absolute https URL`);
+    }
+    return problems;
+}
+
+exports.validateTemplateMetadata = validateTemplateMetadata;
+//# sourceMappingURL=validateTemplateMetadata.js.map

package/dist/cjs/templates/validateTemplateMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateTemplateMetadata.js","sources":["../../../templates/validateTemplateMetadata.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 { TemplateMetadata } from '@cratis/scene.model';\nimport { isValidVersionRange } from '../packageVersionRange';\nimport { isAbsoluteHttpsUrl, isSpdxExpression } from './templateMetadataRules';\n\n/**\n * Checks that a template carries the compatibility, attribution and license metadata every shipped template\n * needs, and that each value is well formed. The C# engine (`TemplateMetadataValidation.Validate`) reports the\n * same problems in the same order; both are asserted against `template-metadata-fixtures.json`.\n */\nexport function validateTemplateMetadata(name: string, metadata: TemplateMetadata | undefined): string[] {\n    const problems: string[] = [];\n    const compatibility = metadata?.compatibility;\n\n    if (!compatibility) {\n        problems.push(`Template '${name}' declares no compatibility`);\n    } else {\n        if (!compatibility.scene?.trim()) {\n            problems.push(`Template '${name}' declares no Scene version range`);\n        } else if (!isValidVersionRange(compatibility.scene)) {\n            problems.push(`Template '${name}' declares an invalid Scene version range '${compatibility.scene}'`);\n        }\n\n        for (const requirement of compatibility.packages ?? []) {\n            if (!requirement.name?.trim()) {\n                problems.push(`Template '${name}' declares a package requirement without a name`);\n            } else if (!isValidVersionRange(requirement.versionRange)) {\n                problems.push(`Template '${name}' declares an invalid version range '${requirement.versionRange}' for package '${requirement.name}'`);\n            }\n        }\n    }\n\n    const attribution = metadata?.attribution;\n    if (!attribution?.author?.trim()) {\n        problems.push(`Template '${name}' declares no author`);\n    }\n\n    if (attribution?.url !== undefined && !isAbsoluteHttpsUrl(attribution.url)) {\n        problems.push(`Template '${name}' declares an attribution URL '${attribution.url}' that is not an absolute https URL`);\n    }\n\n    if (!metadata?.license?.trim()) {\n        problems.push(`Template '${name}' declares no license`);\n    } else if (!isSpdxExpression(metadata.license)) {\n        problems.push(`Template '${name}' declares '${metadata.license}', which is not an SPDX license expression`);\n    }\n\n    if (metadata?.licenseUrl !== undefined && !isAbsoluteHttpsUrl(metadata.licenseUrl)) {\n        problems.push(`Template '${name}' declares a license URL '${metadata.licenseUrl}' that is not an absolute https URL`);\n    }\n\n    return problems;\n}\n"],"names":["validateTemplateMetadata","name","metadata","problems","compatibility","push","scene","trim","isValidVersionRange","requirement","packages","versionRange","attribution","author","url","undefined","isAbsoluteHttpsUrl","license","isSpdxExpression","licenseUrl"],"mappings":"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"}

package/dist/cjs/validateNavigationDestinations.js

@@ -1,47 +1,21 @@
 'use strict';
 
+var diagnoseNavigation = require('./navigation/diagnoseNavigation.js');
+
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 /**
- * Validates destinations against the outlet/route declarations owned by layouts and templates.
+ * Validates destinations against the outlet/route declarations owned by layouts and templates, and - when
+ * the screens and dialog templates are given - against the targets that actually exist.
+ *
+ * A shorthand for {@link diagnoseNavigation} over destinations without entry identities.
  */ function validateNavigationDestinations(destinations, surfaces = {}) {
-    const diagnostics = [];
-    const outlets = new Set();
-    const routes = new Set();
-    for (const surface of [
-        ...surfaces.layouts ?? [],
-        ...surfaces.screenTemplates ?? []
-    ]){
-        for (const outlet of surface.outlets ?? []){
-            if (outlets.has(outlet.name)) diagnostics.push({
-                code: 'duplicateOutlet',
-                message: `Outlet '${outlet.name}' is declared more than once.`
-            });
-            outlets.add(outlet.name);
-        }
-    }
-    for (const destination of destinations){
-        if (destination.outlet && !outlets.has(destination.outlet)) {
-            diagnostics.push({
-                code: 'missingOutlet',
-                message: `Destination targets missing outlet '${destination.outlet}'.`
-            });
-        }
-        if (destination.route) {
-            if (routes.has(destination.route)) diagnostics.push({
-                code: 'duplicateRoute',
-                message: `Route '${destination.route}' is used by more than one destination.`
-            });
-            routes.add(destination.route);
-        }
-        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {
-            diagnostics.push({
-                code: 'unavailableTarget',
-                message: 'Destination must name a screen, stable identity, route or dialog.'
-            });
-        }
-    }
-    return diagnostics;
+    return diagnoseNavigation.diagnoseNavigation({
+        entries: destinations.map((destination)=>({
+                destination
+            })),
+        ...surfaces
+    });
 }
 
 exports.validateNavigationDestinations = validateNavigationDestinations;

package/dist/cjs/validateNavigationDestinations.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateNavigationDestinations.js","sources":["../../validateNavigationDestinations.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 { DestinationReference, Layout, ScreenTemplate } from '@cratis/scene.model';\n\nexport interface NavigationDestinationDiagnostic {\n    code: string;\n    message: string;\n}\n\n/**\n * Validates destinations against the outlet/route declarations owned by layouts and templates.\n */\nexport function validateNavigationDestinations(\n    destinations: DestinationReference[],\n    surfaces: { layouts?: Layout[]; screenTemplates?: ScreenTemplate[] } = {},\n): NavigationDestinationDiagnostic[] {\n    const diagnostics: NavigationDestinationDiagnostic[] = [];\n    const outlets = new Set<string>();\n    const routes = new Set<string>();\n\n    for (const surface of [...(surfaces.layouts ?? []), ...(surfaces.screenTemplates ?? [])]) {\n        for (const outlet of surface.outlets ?? []) {\n            if (outlets.has(outlet.name)) diagnostics.push({ code: 'duplicateOutlet', message: `Outlet '${outlet.name}' is declared more than once.` });\n            outlets.add(outlet.name);\n        }\n    }\n\n    for (const destination of destinations) {\n        if (destination.outlet && !outlets.has(destination.outlet)) {\n            diagnostics.push({ code: 'missingOutlet', message: `Destination targets missing outlet '${destination.outlet}'.` });\n        }\n        if (destination.route) {\n            if (routes.has(destination.route)) diagnostics.push({ code: 'duplicateRoute', message: `Route '${destination.route}' is used by more than one destination.` });\n            routes.add(destination.route);\n        }\n        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {\n            diagnostics.push({ code: 'unavailableTarget', message: 'Destination must name a screen, stable identity, route or dialog.' });\n        }\n    }\n\n    return diagnostics;\n}\n"],"names":["validateNavigationDestinations","destinations","surfaces","diagnostics","outlets","Set","routes","surface","layouts","screenTemplates","outlet","has","name","push","code","message","add","destination","route","screen","module","dialog"],"mappings":";;AAAA;AACA;AASA;;AAEC,IACM,SAASA,8BAAAA,CACZC,YAAoC,EACpCC,QAAAA,GAAuE,EAAE,EAAA;AAEzE,IAAA,MAAMC,cAAiD,EAAE;AACzD,IAAA,MAAMC,UAAU,IAAIC,GAAAA,EAAAA;AACpB,IAAA,MAAMC,SAAS,IAAID,GAAAA,EAAAA;AAEnB,IAAA,KAAK,MAAME,OAAAA,IAAW;WAAKL,QAAAA,CAASM,OAAO,IAAI,EAAE;WAAON,QAAAA,CAASO,eAAe,IAAI;KAAI,CAAE;AACtF,QAAA,KAAK,MAAMC,MAAAA,IAAUH,OAAAA,CAAQH,OAAO,IAAI,EAAE,CAAE;YACxC,IAAIA,OAAAA,CAAQO,GAAG,CAACD,MAAAA,CAAOE,IAAI,CAAA,EAAGT,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,iBAAA;AAAmBC,gBAAAA,OAAAA,EAAS,CAAC,QAAQ,EAAEL,OAAOE,IAAI,CAAC,6BAA6B;AAAE,aAAA,CAAA;YACzIR,OAAAA,CAAQY,GAAG,CAACN,MAAAA,CAAOE,IAAI,CAAA;AAC3B,QAAA;AACJ,IAAA;IAEA,KAAK,MAAMK,eAAehB,YAAAA,CAAc;QACpC,IAAIgB,WAAAA,CAAYP,MAAM,IAAI,CAACN,QAAQO,GAAG,CAACM,WAAAA,CAAYP,MAAM,CAAA,EAAG;AACxDP,YAAAA,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,eAAA;AAAiBC,gBAAAA,OAAAA,EAAS,CAAC,oCAAoC,EAAEE,YAAYP,MAAM,CAAC,EAAE;AAAE,aAAA,CAAA;AACrH,QAAA;QACA,IAAIO,WAAAA,CAAYC,KAAK,EAAE;YACnB,IAAIZ,MAAAA,CAAOK,GAAG,CAACM,WAAAA,CAAYC,KAAK,CAAA,EAAGf,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,gBAAA;AAAkBC,gBAAAA,OAAAA,EAAS,CAAC,OAAO,EAAEE,YAAYC,KAAK,CAAC,uCAAuC;AAAE,aAAA,CAAA;YAC5JZ,MAAAA,CAAOU,GAAG,CAACC,WAAAA,CAAYC,KAAK,CAAA;AAChC,QAAA;AACA,QAAA,IAAI,CAACD,WAAAA,CAAYE,MAAM,IAAI,CAACF,WAAAA,CAAYG,MAAM,IAAI,CAACH,YAAYC,KAAK,IAAI,CAACD,WAAAA,CAAYI,MAAM,EAAE;AACzFlB,YAAAA,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,mBAAA;gBAAqBC,OAAAA,EAAS;AAAoE,aAAA,CAAA;AAC/H,QAAA;AACJ,IAAA;IAEA,OAAOZ,WAAAA;AACX;;"}
+{"version":3,"file":"validateNavigationDestinations.js","sources":["../../validateNavigationDestinations.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 { DestinationReference, DialogTemplate, Layout, Screen, ScreenTemplate } from '@cratis/scene.model';\nimport { NavigationDiagnostic, diagnoseNavigation } from './navigation';\n\n/**\n * A navigation problem as {@link validateNavigationDestinations} reports it.\n */\nexport type NavigationDestinationDiagnostic = NavigationDiagnostic;\n\n/**\n * Validates destinations against the outlet/route declarations owned by layouts and templates, and - when\n * the screens and dialog templates are given - against the targets that actually exist.\n *\n * A shorthand for {@link diagnoseNavigation} over destinations without entry identities.\n */\nexport function validateNavigationDestinations(\n    destinations: DestinationReference[],\n    surfaces: { layouts?: Layout[]; screenTemplates?: ScreenTemplate[]; screens?: Screen[]; dialogTemplates?: DialogTemplate[] } = {},\n): NavigationDestinationDiagnostic[] {\n    return diagnoseNavigation({ entries: destinations.map(destination => ({ destination })), ...surfaces });\n}\n"],"names":["validateNavigationDestinations","destinations","surfaces","diagnoseNavigation","entries","map","destination"],"mappings":";;;;AAAA;AACA;AAUA;;;;;AAKC,IACM,SAASA,8BAAAA,CACZC,YAAoC,EACpCC,QAAAA,GAA+H,EAAE,EAAA;AAEjI,IAAA,OAAOC,qCAAAA,CAAmB;AAAEC,QAAAA,OAAAA,EAASH,YAAAA,CAAaI,GAAG,CAACC,CAAAA,eAAgB;AAAEA,gBAAAA;aAAY,CAAA,CAAA;AAAK,QAAA,GAAGJ;AAAS,KAAA,CAAA;AACzG;;"}

package/dist/esm/index.d.ts

@@ -24,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,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,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

@@ -26,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"}