@cratis/scene.engine 0.1.0

package/dist/cjs/incompatibleStarterThemes.js

@@ -0,0 +1,29 @@
+'use strict';
+
+var themeCompatibility = require('./themeCompatibility.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Finds the {@link UiStarter.themes} that are not compatible with the starter's own {@link UiStarter.packages} -
+ * part of Cratis/Scene#6. A starter is versioned per package combination it targets, so a theme it ships
+ * as a choice that turns out incompatible with the starter's own packages is exactly the gap
+ * `themeCompatibility` already surfaces for a {@link UiProfile}; this reuses that rule rather than
+ * reimplementing it for starters.
+ *
+ * @param starter The {@link UiStarter} to check.
+ * @param themes Every known {@link Theme}, keyed by name.
+ * @returns The names in `starter.themes` that are either unknown to `themes` or incompatible with `starter.packages`.
+ */ function incompatibleStarterThemes(starter, themes) {
+    const profile = {
+        name: starter.name,
+        packages: starter.packages
+    };
+    return starter.themes.filter((name)=>{
+        const theme = themes[name];
+        return !theme || themeCompatibility.incompatiblePackages(theme, profile).length > 0;
+    });
+}
+
+exports.incompatibleStarterThemes = incompatibleStarterThemes;
+//# sourceMappingURL=incompatibleStarterThemes.js.map

package/dist/cjs/incompatibleStarterThemes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"incompatibleStarterThemes.js","sources":["../../incompatibleStarterThemes.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 { Theme, UiProfile, UiStarter } from '@cratis/scene.model';\nimport { incompatiblePackages } from './themeCompatibility';\n\n/**\n * Finds the {@link UiStarter.themes} that are not compatible with the starter's own {@link UiStarter.packages} -\n * part of Cratis/Scene#6. A starter is versioned per package combination it targets, so a theme it ships\n * as a choice that turns out incompatible with the starter's own packages is exactly the gap\n * `themeCompatibility` already surfaces for a {@link UiProfile}; this reuses that rule rather than\n * reimplementing it for starters.\n *\n * @param starter The {@link UiStarter} to check.\n * @param themes Every known {@link Theme}, keyed by name.\n * @returns The names in `starter.themes` that are either unknown to `themes` or incompatible with `starter.packages`.\n */\nexport function incompatibleStarterThemes(starter: UiStarter, themes: Record<string, Theme>): string[] {\n    const profile: UiProfile = { name: starter.name, targetPlatform: '', packages: starter.packages };\n    return starter.themes.filter(name => {\n        const theme = themes[name];\n        return !theme || incompatiblePackages(theme, profile).length > 0;\n    });\n}\n"],"names":["incompatibleStarterThemes","starter","themes","profile","name","packages","filter","theme","incompatiblePackages","length"],"mappings":";;;;AAAA;AACA;AAKA;;;;;;;;;;AAUC,IACM,SAASA,yBAAAA,CAA0BC,OAAkB,EAAEC,MAA6B,EAAA;AACvF,IAAA,MAAMC,OAAAA,GAAqB;AAAEC,QAAAA,IAAAA,EAAMH,QAAQG,IAAI;QAAsBC,QAAAA,EAAUJ,QAAQI;AAAS,KAAA;AAChG,IAAA,OAAOJ,OAAAA,CAAQC,MAAM,CAACI,MAAM,CAACF,CAAAA,IAAAA,GAAAA;QACzB,MAAMG,KAAAA,GAAQL,MAAM,CAACE,IAAAA,CAAK;AAC1B,QAAA,OAAO,CAACG,KAAAA,IAASC,uCAAAA,CAAqBD,KAAAA,EAAOJ,OAAAA,CAAAA,CAASM,MAAM,GAAG,CAAA;AACnE,IAAA,CAAA,CAAA;AACJ;;;;"}

package/dist/cjs/index.js

@@ -0,0 +1,59 @@
+'use strict';
+
+var renderElement = require('./renderElement.js');
+var elementKind = require('./elementKind.js');
+var flowNodeKind = require('./flowNodeKind.js');
+var resolveComponentName = require('./resolveComponentName.js');
+var computeSizeClass = require('./computeSizeClass.js');
+var evaluateFlowArrangement = require('./evaluateFlowArrangement.js');
+var evaluateFreeformArrangement = require('./evaluateFreeformArrangement.js');
+var evaluateFreeformSlotArrangement = require('./evaluateFreeformSlotArrangement.js');
+var aggregateContributions = require('./aggregateContributions.js');
+var themeCompatibility = require('./themeCompatibility.js');
+var PackageSelection = require('./PackageSelection.js');
+var packageVersionRange = require('./packageVersionRange.js');
+var resolvePackageDependencies = require('./resolvePackageDependencies.js');
+var packageCatalog = require('./packageCatalog.js');
+var resolveScreenTemplates = require('./resolveScreenTemplates.js');
+var buildStarterProfile = require('./buildStarterProfile.js');
+var incompatibleStarterThemes = require('./incompatibleStarterThemes.js');
+
+
+
+exports.renderElement = renderElement.renderElement;
+exports.isContentControl = elementKind.isContentControl;
+exports.isExternalComponent = elementKind.isExternalComponent;
+exports.isItemsControl = elementKind.isItemsControl;
+exports.isPanel = elementKind.isPanel;
+exports.isFlowColumn = flowNodeKind.isFlowColumn;
+exports.isFlowContainer = flowNodeKind.isFlowContainer;
+exports.isFlowGrid = flowNodeKind.isFlowGrid;
+exports.isFlowLeaf = flowNodeKind.isFlowLeaf;
+exports.isFlowRow = flowNodeKind.isFlowRow;
+exports.isFlowSlotLeaf = flowNodeKind.isFlowSlotLeaf;
+exports.corePackage = resolveComponentName.corePackage;
+exports.effectivePackages = resolveComponentName.effectivePackages;
+exports.resolveComponentName = resolveComponentName.resolveComponentName;
+exports.computeSizeClass = computeSizeClass.computeSizeClass;
+exports.defaultHeightBreakpoint = computeSizeClass.defaultHeightBreakpoint;
+exports.defaultWidthBreakpoint = computeSizeClass.defaultWidthBreakpoint;
+exports.evaluateFlowArrangement = evaluateFlowArrangement.evaluateFlowArrangement;
+exports.evaluateFreeformArrangement = evaluateFreeformArrangement.evaluateFreeformArrangement;
+exports.evaluateFreeformSlotArrangement = evaluateFreeformSlotArrangement.evaluateFreeformSlotArrangement;
+exports.aggregateContributions = aggregateContributions.aggregateContributions;
+exports.applicableThemePackages = themeCompatibility.applicableThemePackages;
+exports.incompatiblePackages = themeCompatibility.incompatiblePackages;
+exports.isThemeCompatible = themeCompatibility.isThemeCompatible;
+exports.isPackageSelectionValid = PackageSelection.isPackageSelectionValid;
+exports.isVersionSatisfiedBy = packageVersionRange.isVersionSatisfiedBy;
+exports.resolvePackageDependencies = resolvePackageDependencies.resolvePackageDependencies;
+exports.availablePackagesFor = packageCatalog.availablePackagesFor;
+exports.baseComponentLibraries = packageCatalog.baseComponentLibraries;
+exports.componentsForPackages = packageCatalog.componentsForPackages;
+exports.packagesOfKind = packageCatalog.packagesOfKind;
+exports.toComponentCatalog = packageCatalog.toComponentCatalog;
+exports.isScreenTemplateResolutionValid = resolveScreenTemplates.isScreenTemplateResolutionValid;
+exports.resolveScreenTemplates = resolveScreenTemplates.resolveScreenTemplates;
+exports.buildStarterProfile = buildStarterProfile.buildStarterProfile;
+exports.incompatibleStarterThemes = incompatibleStarterThemes.incompatibleStarterThemes;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/packageCatalog.js

@@ -0,0 +1,63 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The packages of a given kind.
+ */ function packagesOfKind(catalog, kind) {
+    return catalog.filter((scenePackage)=>scenePackage.kind === kind);
+}
+/**
+ * The component libraries a profile can be founded on — the ones that do not themselves layer on another
+ * component library.
+ *
+ * "Base" is not a declared property; it falls out of the dependency graph. PrimeReact depends on a
+ * styling package but on no other component library, so it is a base. `@cratis/components` depends on
+ * PrimeReact, so it is not — it is something you add on top of a base you already picked. Deriving it
+ * this way means a third party shipping their own library gets classified correctly without having to
+ * declare anything extra.
+ */ function baseComponentLibraries(catalog) {
+    const libraries = packagesOfKind(catalog, scene_model.PackageKind.ComponentLibrary);
+    const names = new Set(libraries.map((scenePackage)=>scenePackage.name));
+    return libraries.filter((scenePackage)=>!scenePackage.dependencies.some((dependency)=>names.has(dependency.name)));
+}
+/**
+ * The packages that can be added to a selection without pulling anything else in — every dependency they
+ * declare is already selected.
+ *
+ * This is the "what else works with what I have picked" list: choose PrimeReact and Tailwind, and
+ * `@cratis/components` becomes available because both of its dependencies are now met. It is
+ * deliberately stricter than {@link resolvePackageDependencies}, which will happily add the missing
+ * dependencies for you — a picker wants to show what fits, not what would drag more in.
+ */ function availablePackagesFor(catalog, selected) {
+    const chosen = new Set(selected);
+    return catalog.filter((scenePackage)=>!chosen.has(scenePackage.name) && scenePackage.dependencies.every((dependency)=>chosen.has(dependency.name)));
+}
+/**
+ * Every component name the selected packages declare between them, without duplicates, sorted so a
+ * component picker has a stable list to show.
+ */ function componentsForPackages(catalog, selected) {
+    const chosen = new Set(selected);
+    const components = catalog.filter((scenePackage)=>chosen.has(scenePackage.name)).flatMap((scenePackage)=>scenePackage.components);
+    return [
+        ...new Set(components)
+    ].sort();
+}
+/**
+ * Builds the component-name catalog `resolveComponentName` resolves against.
+ */ function toComponentCatalog(catalog) {
+    const components = {};
+    for (const scenePackage of catalog){
+        components[scenePackage.name] = scenePackage.components;
+    }
+    return components;
+}
+
+exports.availablePackagesFor = availablePackagesFor;
+exports.baseComponentLibraries = baseComponentLibraries;
+exports.componentsForPackages = componentsForPackages;
+exports.packagesOfKind = packagesOfKind;
+exports.toComponentCatalog = toComponentCatalog;
+//# sourceMappingURL=packageCatalog.js.map

package/dist/cjs/packageCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageCatalog.js","sources":["../../packageCatalog.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 { PackageKind, ScenePackage } from '@cratis/scene.model';\n\n/**\n * The packages of a given kind.\n */\nexport function packagesOfKind(catalog: ScenePackage[], kind: PackageKind): ScenePackage[] {\n    return catalog.filter((scenePackage) => scenePackage.kind === kind);\n}\n\n/**\n * The component libraries a profile can be founded on — the ones that do not themselves layer on another\n * component library.\n *\n * \"Base\" is not a declared property; it falls out of the dependency graph. PrimeReact depends on a\n * styling package but on no other component library, so it is a base. `@cratis/components` depends on\n * PrimeReact, so it is not — it is something you add on top of a base you already picked. Deriving it\n * this way means a third party shipping their own library gets classified correctly without having to\n * declare anything extra.\n */\nexport function baseComponentLibraries(catalog: ScenePackage[]): ScenePackage[] {\n    const libraries = packagesOfKind(catalog, PackageKind.ComponentLibrary);\n    const names = new Set(libraries.map((scenePackage) => scenePackage.name));\n    return libraries.filter((scenePackage) => !scenePackage.dependencies.some((dependency) => names.has(dependency.name)));\n}\n\n/**\n * The packages that can be added to a selection without pulling anything else in — every dependency they\n * declare is already selected.\n *\n * This is the \"what else works with what I have picked\" list: choose PrimeReact and Tailwind, and\n * `@cratis/components` becomes available because both of its dependencies are now met. It is\n * deliberately stricter than {@link resolvePackageDependencies}, which will happily add the missing\n * dependencies for you — a picker wants to show what fits, not what would drag more in.\n */\nexport function availablePackagesFor(catalog: ScenePackage[], selected: string[]): ScenePackage[] {\n    const chosen = new Set(selected);\n    return catalog.filter(\n        (scenePackage) => !chosen.has(scenePackage.name) && scenePackage.dependencies.every((dependency) => chosen.has(dependency.name))\n    );\n}\n\n/**\n * Every component name the selected packages declare between them, without duplicates, sorted so a\n * component picker has a stable list to show.\n */\nexport function componentsForPackages(catalog: ScenePackage[], selected: string[]): string[] {\n    const chosen = new Set(selected);\n    const components = catalog.filter((scenePackage) => chosen.has(scenePackage.name)).flatMap((scenePackage) => scenePackage.components);\n    return [...new Set(components)].sort();\n}\n\n/**\n * Builds the component-name catalog `resolveComponentName` resolves against.\n */\nexport function toComponentCatalog(catalog: ScenePackage[]): Record<string, string[]> {\n    const components: Record<string, string[]> = {};\n    for (const scenePackage of catalog) {\n        components[scenePackage.name] = scenePackage.components;\n    }\n\n    return components;\n}\n"],"names":["packagesOfKind","catalog","kind","filter","scenePackage","baseComponentLibraries","libraries","PackageKind","ComponentLibrary","names","Set","map","name","dependencies","some","dependency","has","availablePackagesFor","selected","chosen","every","componentsForPackages","components","flatMap","sort","toComponentCatalog"],"mappings":";;;;AAAA;AACA;AAIA;;AAEC,IACM,SAASA,cAAAA,CAAeC,OAAuB,EAAEC,IAAiB,EAAA;AACrE,IAAA,OAAOD,QAAQE,MAAM,CAAC,CAACC,YAAAA,GAAiBA,YAAAA,CAAaF,IAAI,KAAKA,IAAAA,CAAAA;AAClE;AAEA;;;;;;;;;IAUO,SAASG,sBAAAA,CAAuBJ,OAAuB,EAAA;AAC1D,IAAA,MAAMK,SAAAA,GAAYN,cAAAA,CAAeC,OAAAA,EAASM,uBAAAA,CAAYC,gBAAgB,CAAA;IACtE,MAAMC,KAAAA,GAAQ,IAAIC,GAAAA,CAAIJ,SAAAA,CAAUK,GAAG,CAAC,CAACP,YAAAA,GAAiBA,YAAAA,CAAaQ,IAAI,CAAA,CAAA;AACvE,IAAA,OAAON,UAAUH,MAAM,CAAC,CAACC,YAAAA,GAAiB,CAACA,YAAAA,CAAaS,YAAY,CAACC,IAAI,CAAC,CAACC,UAAAA,GAAeN,MAAMO,GAAG,CAACD,WAAWH,IAAI,CAAA,CAAA,CAAA;AACvH;AAEA;;;;;;;;AAQC,IACM,SAASK,oBAAAA,CAAqBhB,OAAuB,EAAEiB,QAAkB,EAAA;IAC5E,MAAMC,MAAAA,GAAS,IAAIT,GAAAA,CAAIQ,QAAAA,CAAAA;IACvB,OAAOjB,OAAAA,CAAQE,MAAM,CACjB,CAACC,eAAiB,CAACe,MAAAA,CAAOH,GAAG,CAACZ,YAAAA,CAAaQ,IAAI,KAAKR,YAAAA,CAAaS,YAAY,CAACO,KAAK,CAAC,CAACL,aAAeI,MAAAA,CAAOH,GAAG,CAACD,UAAAA,CAAWH,IAAI,CAAA,CAAA,CAAA;AAEtI;AAEA;;;AAGC,IACM,SAASS,qBAAAA,CAAsBpB,OAAuB,EAAEiB,QAAkB,EAAA;IAC7E,MAAMC,MAAAA,GAAS,IAAIT,GAAAA,CAAIQ,QAAAA,CAAAA;AACvB,IAAA,MAAMI,aAAarB,OAAAA,CAAQE,MAAM,CAAC,CAACC,eAAiBe,MAAAA,CAAOH,GAAG,CAACZ,YAAAA,CAAaQ,IAAI,CAAA,CAAA,CAAGW,OAAO,CAAC,CAACnB,YAAAA,GAAiBA,aAAakB,UAAU,CAAA;IACpI,OAAO;AAAI,QAAA,GAAA,IAAIZ,GAAAA,CAAIY,UAAAA;AAAY,KAAA,CAACE,IAAI,EAAA;AACxC;AAEA;;IAGO,SAASC,kBAAAA,CAAmBxB,OAAuB,EAAA;AACtD,IAAA,MAAMqB,aAAuC,EAAC;IAC9C,KAAK,MAAMlB,gBAAgBH,OAAAA,CAAS;AAChCqB,QAAAA,UAAU,CAAClB,YAAAA,CAAaQ,IAAI,CAAC,GAAGR,aAAakB,UAAU;AAC3D,IAAA;IAEA,OAAOA,UAAAA;AACX;;;;;;;;"}

package/dist/cjs/packageVersionRange.js

@@ -0,0 +1,113 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Checks a {@link PackageDependency.versionRange} against a package's actual version. A deliberately
+ * small subset of semver — enough to express what a package declaration realistically needs, and small
+ * enough that the C# twin in `Cratis.Scene.Engine` can match it exactly rather than approximately. Both
+ * sides are asserted against the same shared fixture corpus.
+ *
+ * Supported: an empty range or `*` (anything), a bare or `=`-prefixed exact version, `^` (npm caret —
+ * compatible within the leftmost non-zero component), `~` (patch-level changes), and the comparisons
+ * `>=`, `>`, `<=`, `<`. Versions are read as `major.minor.patch` with any pre-release or build metadata
+ * suffix ignored. Anything the parser does not recognize is treated as unsatisfiable rather than as
+ * "anything", so a typo surfaces as a conflict instead of silently passing.
+ */ function isVersionSatisfiedBy(version, range) {
+    const trimmed = range?.trim();
+    if (!trimmed || trimmed === '*') return true;
+    const actual = parseVersion(version);
+    if (!actual) return false;
+    const [operator, literal] = splitRange(trimmed);
+    const required = parseVersion(literal);
+    if (!required) return false;
+    switch(operator){
+        case '^':
+            return compare(actual, required) >= 0 && compare(actual, caretUpperBound(required)) < 0;
+        case '~':
+            return compare(actual, required) >= 0 && compare(actual, [
+                required[0],
+                required[1] + 1,
+                0
+            ]) < 0;
+        case '>=':
+            return compare(actual, required) >= 0;
+        case '>':
+            return compare(actual, required) > 0;
+        case '<=':
+            return compare(actual, required) <= 0;
+        case '<':
+            return compare(actual, required) < 0;
+        default:
+            return compare(actual, required) === 0;
+    }
+}
+function splitRange(range) {
+    for (const operator of [
+        '>=',
+        '<=',
+        '^',
+        '~',
+        '>',
+        '<',
+        '='
+    ]){
+        if (range.startsWith(operator)) {
+            return [
+                operator === '=' ? '' : operator,
+                range.substring(operator.length).trim()
+            ];
+        }
+    }
+    return [
+        '',
+        range
+    ];
+}
+/**
+ * npm's caret rule: compatibility is bounded by the leftmost non-zero component, so `^1.2.3` allows
+ * anything below `2.0.0`, `^0.2.3` anything below `0.3.0`, and `^0.0.3` only `0.0.3` itself.
+ */ function caretUpperBound(version) {
+    if (version[0] > 0) return [
+        version[0] + 1,
+        0,
+        0
+    ];
+    if (version[1] > 0) return [
+        0,
+        version[1] + 1,
+        0
+    ];
+    return [
+        0,
+        0,
+        version[2] + 1
+    ];
+}
+function compare(left, right) {
+    if (left[0] !== right[0]) return left[0] - right[0];
+    if (left[1] !== right[1]) return left[1] - right[1];
+    return left[2] - right[2];
+}
+function parseVersion(value) {
+    let numeric = value.trim();
+    const suffix = numeric.search(/[-+]/);
+    if (suffix >= 0) {
+        numeric = numeric.substring(0, suffix);
+    }
+    const parts = numeric.split('.');
+    if (parts.length === 0 || parts.length > 3) return undefined;
+    const components = [
+        0,
+        0,
+        0
+    ];
+    for(let index = 0; index < parts.length; index++){
+        if (!/^\d+$/.test(parts[index])) return undefined;
+        components[index] = parseInt(parts[index], 10);
+    }
+    return components;
+}
+
+exports.isVersionSatisfiedBy = isVersionSatisfiedBy;
+//# sourceMappingURL=packageVersionRange.js.map

package/dist/cjs/packageVersionRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageVersionRange.js","sources":["../../packageVersionRange.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 * Checks a {@link PackageDependency.versionRange} against a package's actual version. A deliberately\n * small subset of semver — enough to express what a package declaration realistically needs, and small\n * enough that the C# twin in `Cratis.Scene.Engine` can match it exactly rather than approximately. Both\n * sides are asserted against the same shared fixture corpus.\n *\n * Supported: an empty range or `*` (anything), a bare or `=`-prefixed exact version, `^` (npm caret —\n * compatible within the leftmost non-zero component), `~` (patch-level changes), and the comparisons\n * `>=`, `>`, `<=`, `<`. Versions are read as `major.minor.patch` with any pre-release or build metadata\n * suffix ignored. Anything the parser does not recognize is treated as unsatisfiable rather than as\n * \"anything\", so a typo surfaces as a conflict instead of silently passing.\n */\nexport function isVersionSatisfiedBy(version: string, range: string | undefined): boolean {\n    const trimmed = range?.trim();\n    if (!trimmed || trimmed === '*') return true;\n\n    const actual = parseVersion(version);\n    if (!actual) return false;\n\n    const [operator, literal] = splitRange(trimmed);\n    const required = parseVersion(literal);\n    if (!required) return false;\n\n    switch (operator) {\n        case '^':\n            return compare(actual, required) >= 0 && compare(actual, caretUpperBound(required)) < 0;\n        case '~':\n            return compare(actual, required) >= 0 && compare(actual, [required[0], required[1] + 1, 0]) < 0;\n        case '>=':\n            return compare(actual, required) >= 0;\n        case '>':\n            return compare(actual, required) > 0;\n        case '<=':\n            return compare(actual, required) <= 0;\n        case '<':\n            return compare(actual, required) < 0;\n        default:\n            return compare(actual, required) === 0;\n    }\n}\n\ntype Version = [number, number, number];\n\nfunction splitRange(range: string): [string, string] {\n    for (const operator of ['>=', '<=', '^', '~', '>', '<', '=']) {\n        if (range.startsWith(operator)) {\n            return [operator === '=' ? '' : operator, range.substring(operator.length).trim()];\n        }\n    }\n\n    return ['', range];\n}\n\n/**\n * npm's caret rule: compatibility is bounded by the leftmost non-zero component, so `^1.2.3` allows\n * anything below `2.0.0`, `^0.2.3` anything below `0.3.0`, and `^0.0.3` only `0.0.3` itself.\n */\nfunction caretUpperBound(version: Version): Version {\n    if (version[0] > 0) return [version[0] + 1, 0, 0];\n    if (version[1] > 0) return [0, version[1] + 1, 0];\n    return [0, 0, version[2] + 1];\n}\n\nfunction compare(left: Version, right: Version): number {\n    if (left[0] !== right[0]) return left[0] - right[0];\n    if (left[1] !== right[1]) return left[1] - right[1];\n    return left[2] - right[2];\n}\n\nfunction parseVersion(value: string): Version | undefined {\n    let numeric = value.trim();\n    const suffix = numeric.search(/[-+]/);\n    if (suffix >= 0) {\n        numeric = numeric.substring(0, suffix);\n    }\n\n    const parts = numeric.split('.');\n    if (parts.length === 0 || parts.length > 3) return undefined;\n\n    const components: Version = [0, 0, 0];\n    for (let index = 0; index < parts.length; index++) {\n        if (!/^\\d+$/.test(parts[index])) return undefined;\n        components[index] = parseInt(parts[index], 10);\n    }\n\n    return components;\n}\n"],"names":["isVersionSatisfiedBy","version","range","trimmed","trim","actual","parseVersion","operator","literal","splitRange","required","compare","caretUpperBound","startsWith","substring","length","left","right","value","numeric","suffix","search","parts","split","undefined","components","index","test","parseInt"],"mappings":"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"}

package/dist/cjs/renderElement.js

@@ -0,0 +1,39 @@
+'use strict';
+
+var elementKind = require('./elementKind.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Walks a Scene element tree, rendering each node's children before the node itself, and hands the
+ * result to the supplied {@link Renderer}. This is a structural tree walk only - resolving a `ui
+ * profile`'s package list, aggregating contribution points, and computing layout arrangement are the
+ * jobs of the profile resolution, contribution runtime and layout engines (Scene#3, Scene#2, Scene#4),
+ * layered on top of this walk rather than folded into it.
+ */ function renderElement(element, renderer, resolveBinding) {
+    if (elementKind.isContentControl(element)) {
+        return renderer.renderContentControl(element, renderElement(element.content, renderer, resolveBinding));
+    }
+    if (elementKind.isItemsControl(element)) {
+        const items = resolveBinding(element.itemsSource);
+        const itemCount = Array.isArray(items) ? items.length : 0;
+        const rendered = Array.from({
+            length: itemCount
+        }, ()=>renderElement(element.itemTemplate, renderer, resolveBinding));
+        return renderer.renderItemsControl(element, rendered);
+    }
+    if (elementKind.isExternalComponent(element)) {
+        const slots = Object.fromEntries(Object.entries(element.slots).map(([name, children])=>[
+                name,
+                children.map((child)=>renderElement(child, renderer, resolveBinding))
+            ]));
+        return renderer.renderExternalComponent(element, slots);
+    }
+    if (elementKind.isPanel(element)) {
+        return renderer.renderPanel(element, element.children.map((child)=>renderElement(child, renderer, resolveBinding)));
+    }
+    throw new Error(`Scene element '${element.id}' is not a recognized concrete kind (ContentControl, ItemsControl, ExternalComponent or Panel).`);
+}
+
+exports.renderElement = renderElement;
+//# sourceMappingURL=renderElement.js.map

package/dist/cjs/renderElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderElement.js","sources":["../../renderElement.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 { SceneElement } from '@cratis/scene.model';\nimport { Renderer } from './Renderer';\nimport { BindingResolver } from './BindingResolver';\nimport { isContentControl, isItemsControl, isExternalComponent, isPanel } from './elementKind';\n\n/**\n * Walks a Scene element tree, rendering each node's children before the node itself, and hands the\n * result to the supplied {@link Renderer}. This is a structural tree walk only - resolving a `ui\n * profile`'s package list, aggregating contribution points, and computing layout arrangement are the\n * jobs of the profile resolution, contribution runtime and layout engines (Scene#3, Scene#2, Scene#4),\n * layered on top of this walk rather than folded into it.\n */\nexport function renderElement<TOutput>(element: SceneElement, renderer: Renderer<TOutput>, resolveBinding: BindingResolver): TOutput {\n    if (isContentControl(element)) {\n        return renderer.renderContentControl(element, renderElement(element.content, renderer, resolveBinding));\n    }\n\n    if (isItemsControl(element)) {\n        const items = resolveBinding(element.itemsSource);\n        const itemCount = Array.isArray(items) ? items.length : 0;\n        const rendered = Array.from({ length: itemCount }, () => renderElement(element.itemTemplate, renderer, resolveBinding));\n        return renderer.renderItemsControl(element, rendered);\n    }\n\n    if (isExternalComponent(element)) {\n        const slots = Object.fromEntries(\n            Object.entries(element.slots).map(([name, children]) => [name, children.map(child => renderElement(child, renderer, resolveBinding))]),\n        );\n        return renderer.renderExternalComponent(element, slots);\n    }\n\n    if (isPanel(element)) {\n        return renderer.renderPanel(element, element.children.map(child => renderElement(child, renderer, resolveBinding)));\n    }\n\n    throw new Error(`Scene element '${element.id}' is not a recognized concrete kind (ContentControl, ItemsControl, ExternalComponent or Panel).`);\n}\n"],"names":["renderElement","element","renderer","resolveBinding","isContentControl","renderContentControl","content","isItemsControl","items","itemsSource","itemCount","Array","isArray","length","rendered","from","itemTemplate","renderItemsControl","isExternalComponent","slots","Object","fromEntries","entries","map","name","children","child","renderExternalComponent","isPanel","renderPanel","Error","id"],"mappings":";;;;AAAA;AACA;AAOA;;;;;;AAMC,IACM,SAASA,aAAAA,CAAuBC,OAAqB,EAAEC,QAA2B,EAAEC,cAA+B,EAAA;AACtH,IAAA,IAAIC,6BAAiBH,OAAAA,CAAAA,EAAU;QAC3B,OAAOC,QAAAA,CAASG,oBAAoB,CAACJ,OAAAA,EAASD,cAAcC,OAAAA,CAAQK,OAAO,EAAEJ,QAAAA,EAAUC,cAAAA,CAAAA,CAAAA;AAC3F,IAAA;AAEA,IAAA,IAAII,2BAAeN,OAAAA,CAAAA,EAAU;QACzB,MAAMO,KAAAA,GAAQL,cAAAA,CAAeF,OAAAA,CAAQQ,WAAW,CAAA;AAChD,QAAA,MAAMC,YAAYC,KAAAA,CAAMC,OAAO,CAACJ,KAAAA,CAAAA,GAASA,KAAAA,CAAMK,MAAM,GAAG,CAAA;QACxD,MAAMC,QAAAA,GAAWH,KAAAA,CAAMI,IAAI,CAAC;YAAEF,MAAAA,EAAQH;AAAU,SAAA,EAAG,IAAMV,aAAAA,CAAcC,OAAAA,CAAQe,YAAY,EAAEd,QAAAA,EAAUC,cAAAA,CAAAA,CAAAA;QACvG,OAAOD,QAAAA,CAASe,kBAAkB,CAAChB,OAAAA,EAASa,QAAAA,CAAAA;AAChD,IAAA;AAEA,IAAA,IAAII,gCAAoBjB,OAAAA,CAAAA,EAAU;AAC9B,QAAA,MAAMkB,QAAQC,MAAAA,CAAOC,WAAW,CAC5BD,MAAAA,CAAOE,OAAO,CAACrB,OAAAA,CAAQkB,KAAK,CAAA,CAAEI,GAAG,CAAC,CAAC,CAACC,IAAAA,EAAMC,SAAS,GAAK;AAACD,gBAAAA,IAAAA;AAAMC,gBAAAA,QAAAA,CAASF,GAAG,CAACG,CAAAA,KAAAA,GAAS1B,aAAAA,CAAc0B,OAAOxB,QAAAA,EAAUC,cAAAA,CAAAA;AAAiB,aAAA,CAAA,CAAA;QAEzI,OAAOD,QAAAA,CAASyB,uBAAuB,CAAC1B,OAAAA,EAASkB,KAAAA,CAAAA;AACrD,IAAA;AAEA,IAAA,IAAIS,oBAAQ3B,OAAAA,CAAAA,EAAU;AAClB,QAAA,OAAOC,QAAAA,CAAS2B,WAAW,CAAC5B,OAAAA,EAASA,OAAAA,CAAQwB,QAAQ,CAACF,GAAG,CAACG,CAAAA,KAAAA,GAAS1B,aAAAA,CAAc0B,OAAOxB,QAAAA,EAAUC,cAAAA,CAAAA,CAAAA,CAAAA;AACtG,IAAA;IAEA,MAAM,IAAI2B,MAAM,CAAC,eAAe,EAAE7B,OAAAA,CAAQ8B,EAAE,CAAC,+FAA+F,CAAC,CAAA;AACjJ;;;;"}

package/dist/cjs/resolveComponentName.js

@@ -0,0 +1,67 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The name of the package that is always present as the final fallback, regardless of what a {@link UiProfile} lists in its own `packages`. */ const corePackage = 'core';
+/**
+ * Computes a {@link UiProfile}'s effective package priority order - its own declared packages, with
+ * {@link corePackage} prepended as the final fallback when not already present. {@link corePackage} is
+ * the lowest-priority fallback, so it belongs at the front of the ascending-priority order, not the
+ * back - prepending it (rather than appending) is what makes every explicitly listed package outrank it.
+ *
+ * @returns The packages in ascending priority order - the last entry wins when more than one declares the same name.
+ */ function effectivePackages(profile) {
+    return profile.packages.includes(corePackage) ? profile.packages : [
+        corePackage,
+        ...profile.packages
+    ];
+}
+/**
+ * Resolves a component name against a {@link UiProfile} - the runtime half of Cratis/Scene#3, run
+ * whenever a profile is applied. Studio's design-time tooling and Stage's build-time resolution use the
+ * C# twin of this algorithm in `Cratis.Scene.Engine`; both sides are asserted against the same shared
+ * fixture corpus so they cannot drift apart.
+ *
+ * A name containing a `.` is package-qualified - everything before the last `.` is the package,
+ * everything after is the bare name - and resolves directly against that one package, bypassing shadow
+ * tracking and the profile's priority order entirely (an author naming the package explicitly has
+ * already disambiguated). A name with no `.` is bare and resolves by walking {@link effectivePackages}
+ * from highest to lowest priority; every other active package that also declares the name is recorded in
+ * the result's `shadows`, not discarded, so a caller can explain the pick rather than only report it.
+ *
+ * @param requestedName The name as written on a screen - bare (`button`) or package-qualified (`Internal.Widgets.TrendChart`).
+ * @param profile The {@link UiProfile} whose package list to resolve against.
+ * @param catalog Every active package's declared component names, keyed by package name.
+ * @returns The {@link ComponentResolution}, or `undefined` when nothing in scope declares the name.
+ */ function resolveComponentName(requestedName, profile, catalog) {
+    const lastDot = requestedName.lastIndexOf('.');
+    if (lastDot >= 0) {
+        const qualifiedPackage = requestedName.slice(0, lastDot);
+        const qualifiedName = requestedName.slice(lastDot + 1);
+        return declares(catalog, qualifiedPackage, qualifiedName) ? {
+            name: qualifiedName,
+            package: qualifiedPackage,
+            shadows: []
+        } : undefined;
+    }
+    const priority = effectivePackages(profile);
+    const matches = [];
+    for(let index = priority.length - 1; index >= 0; index--){
+        if (declares(catalog, priority[index], requestedName)) {
+            matches.push(priority[index]);
+        }
+    }
+    return matches.length === 0 ? undefined : {
+        name: requestedName,
+        package: matches[0],
+        shadows: matches.slice(1)
+    };
+}
+function declares(catalog, packageName, name) {
+    return catalog[packageName]?.includes(name) ?? false;
+}
+
+exports.corePackage = corePackage;
+exports.effectivePackages = effectivePackages;
+exports.resolveComponentName = resolveComponentName;
+//# sourceMappingURL=resolveComponentName.js.map

package/dist/cjs/resolveComponentName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveComponentName.js","sources":["../../resolveComponentName.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 { UiProfile } from '@cratis/scene.model';\nimport { ComponentResolution } from './ComponentResolution';\n\n/** The name of the package that is always present as the final fallback, regardless of what a {@link UiProfile} lists in its own `packages`. */\nexport const corePackage = 'core';\n\n/** Every active package's declared component names, keyed by package name. */\nexport type PackageCatalog = Record<string, string[]>;\n\n/**\n * Computes a {@link UiProfile}'s effective package priority order - its own declared packages, with\n * {@link corePackage} prepended as the final fallback when not already present. {@link corePackage} is\n * the lowest-priority fallback, so it belongs at the front of the ascending-priority order, not the\n * back - prepending it (rather than appending) is what makes every explicitly listed package outrank it.\n *\n * @returns The packages in ascending priority order - the last entry wins when more than one declares the same name.\n */\nexport function effectivePackages(profile: UiProfile): string[] {\n    return profile.packages.includes(corePackage) ? profile.packages : [corePackage, ...profile.packages];\n}\n\n/**\n * Resolves a component name against a {@link UiProfile} - the runtime half of Cratis/Scene#3, run\n * whenever a profile is applied. Studio's design-time tooling and Stage's build-time resolution use the\n * C# twin of this algorithm in `Cratis.Scene.Engine`; both sides are asserted against the same shared\n * fixture corpus so they cannot drift apart.\n *\n * A name containing a `.` is package-qualified - everything before the last `.` is the package,\n * everything after is the bare name - and resolves directly against that one package, bypassing shadow\n * tracking and the profile's priority order entirely (an author naming the package explicitly has\n * already disambiguated). A name with no `.` is bare and resolves by walking {@link effectivePackages}\n * from highest to lowest priority; every other active package that also declares the name is recorded in\n * the result's `shadows`, not discarded, so a caller can explain the pick rather than only report it.\n *\n * @param requestedName The name as written on a screen - bare (`button`) or package-qualified (`Internal.Widgets.TrendChart`).\n * @param profile The {@link UiProfile} whose package list to resolve against.\n * @param catalog Every active package's declared component names, keyed by package name.\n * @returns The {@link ComponentResolution}, or `undefined` when nothing in scope declares the name.\n */\nexport function resolveComponentName(requestedName: string, profile: UiProfile, catalog: PackageCatalog): ComponentResolution | undefined {\n    const lastDot = requestedName.lastIndexOf('.');\n    if (lastDot >= 0) {\n        const qualifiedPackage = requestedName.slice(0, lastDot);\n        const qualifiedName = requestedName.slice(lastDot + 1);\n        return declares(catalog, qualifiedPackage, qualifiedName)\n            ? { name: qualifiedName, package: qualifiedPackage, shadows: [] }\n            : undefined;\n    }\n\n    const priority = effectivePackages(profile);\n    const matches: string[] = [];\n    for (let index = priority.length - 1; index >= 0; index--) {\n        if (declares(catalog, priority[index], requestedName)) {\n            matches.push(priority[index]);\n        }\n    }\n\n    return matches.length === 0 ? undefined : { name: requestedName, package: matches[0], shadows: matches.slice(1) };\n}\n\nfunction declares(catalog: PackageCatalog, packageName: string, name: string): boolean {\n    return catalog[packageName]?.includes(name) ?? false;\n}\n"],"names":["corePackage","effectivePackages","profile","packages","includes","resolveComponentName","requestedName","catalog","lastDot","lastIndexOf","qualifiedPackage","slice","qualifiedName","declares","name","package","shadows","undefined","priority","matches","index","length","push","packageName"],"mappings":";;AAAA;AACA;AAKA,iJACO,MAAMA,WAAAA,GAAc;AAK3B;;;;;;;IAQO,SAASC,iBAAAA,CAAkBC,OAAkB,EAAA;IAChD,OAAOA,OAAAA,CAAQC,QAAQ,CAACC,QAAQ,CAACJ,WAAAA,CAAAA,GAAeE,OAAAA,CAAQC,QAAQ,GAAG;AAACH,QAAAA,WAAAA;AAAgBE,QAAAA,GAAAA,OAAAA,CAAQC;AAAS,KAAA;AACzG;AAEA;;;;;;;;;;;;;;;;;AAiBC,IACM,SAASE,oBAAAA,CAAqBC,aAAqB,EAAEJ,OAAkB,EAAEK,OAAuB,EAAA;IACnG,MAAMC,OAAAA,GAAUF,aAAAA,CAAcG,WAAW,CAAC,GAAA,CAAA;AAC1C,IAAA,IAAID,WAAW,CAAA,EAAG;AACd,QAAA,MAAME,gBAAAA,GAAmBJ,aAAAA,CAAcK,KAAK,CAAC,CAAA,EAAGH,OAAAA,CAAAA;AAChD,QAAA,MAAMI,aAAAA,GAAgBN,aAAAA,CAAcK,KAAK,CAACH,OAAAA,GAAU,CAAA,CAAA;QACpD,OAAOK,QAAAA,CAASN,OAAAA,EAASG,gBAAAA,EAAkBE,aAAAA,CAAAA,GACrC;YAAEE,IAAAA,EAAMF,aAAAA;YAAeG,OAAAA,EAASL,gBAAAA;AAAkBM,YAAAA,OAAAA,EAAS;SAAG,GAC9DC,SAAAA;AACV,IAAA;AAEA,IAAA,MAAMC,WAAWjB,iBAAAA,CAAkBC,OAAAA,CAAAA;AACnC,IAAA,MAAMiB,UAAoB,EAAE;IAC5B,IAAK,IAAIC,QAAQF,QAAAA,CAASG,MAAM,GAAG,CAAA,EAAGD,KAAAA,IAAS,GAAGA,KAAAA,EAAAA,CAAS;AACvD,QAAA,IAAIP,SAASN,OAAAA,EAASW,QAAQ,CAACE,KAAAA,CAAM,EAAEd,aAAAA,CAAAA,EAAgB;AACnDa,YAAAA,OAAAA,CAAQG,IAAI,CAACJ,QAAQ,CAACE,KAAAA,CAAM,CAAA;AAChC,QAAA;AACJ,IAAA;AAEA,IAAA,OAAOD,OAAAA,CAAQE,MAAM,KAAK,CAAA,GAAIJ,SAAAA,GAAY;QAAEH,IAAAA,EAAMR,aAAAA;QAAeS,OAAAA,EAASI,OAAO,CAAC,CAAA,CAAE;QAAEH,OAAAA,EAASG,OAAAA,CAAQR,KAAK,CAAC,CAAA;AAAG,KAAA;AACpH;AAEA,SAASE,QAAAA,CAASN,OAAuB,EAAEgB,WAAmB,EAAET,IAAY,EAAA;AACxE,IAAA,OAAOP,OAAO,CAACgB,WAAAA,CAAY,EAAEnB,SAASU,IAAAA,CAAAA,IAAS,KAAA;AACnD;;;;;;"}

package/dist/cjs/resolvePackageDependencies.js

@@ -0,0 +1,149 @@
+'use strict';
+
+var packageVersionRange = require('./packageVersionRange.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Expands a chosen set of package names into the complete, correctly ordered list a {@link UiProfile}
+ * needs — the runtime half. The C# twin in `Cratis.Scene.Engine` implements the same algorithm for
+ * Studio's package picker and Stage's build; both are asserted against the same shared fixture corpus so
+ * they cannot drift apart.
+ *
+ * This is a different concern from `resolveComponentName`, which resolves one component *name* against
+ * an already-decided package list. This decides what that list is.
+ *
+ * Ordering is a stable topological sort: among packages whose dependencies are equally satisfied, the one
+ * the caller named first comes first, and packages pulled in transitively follow in the order they were
+ * discovered. When a cycle makes ordering impossible, the packages involved are reported in `cycles` and
+ * appended in discovery order rather than dropped.
+ */ function resolvePackageDependencies(selected, catalog) {
+    const index = new Map(catalog.map((scenePackage)=>[
+            scenePackage.name,
+            scenePackage
+        ]));
+    const discovered = [];
+    const seen = new Set(selected);
+    const missing = [];
+    const versionConflicts = [];
+    const pending = [
+        ...selected
+    ];
+    while(pending.length > 0){
+        const name = pending.shift();
+        discovered.push(name);
+        const scenePackage = index.get(name);
+        if (!scenePackage) continue;
+        for (const dependency of scenePackage.dependencies){
+            const dependedOn = index.get(dependency.name);
+            if (!dependedOn) {
+                missing.push({
+                    package: scenePackage.name,
+                    dependsOn: dependency.name
+                });
+                continue;
+            }
+            if (!packageVersionRange.isVersionSatisfiedBy(dependedOn.version, dependency.versionRange)) {
+                versionConflicts.push({
+                    package: scenePackage.name,
+                    dependsOn: dependency.name,
+                    requiredRange: dependency.versionRange,
+                    actualVersion: dependedOn.version
+                });
+            }
+            if (!seen.has(dependency.name)) {
+                seen.add(dependency.name);
+                pending.push(dependency.name);
+            }
+        }
+    }
+    const cycles = findCycles(discovered, index);
+    const packages = topologicallyOrder(discovered, index);
+    const chosen = new Set(selected);
+    return {
+        packages,
+        added: packages.filter((name)=>!chosen.has(name)),
+        missing,
+        versionConflicts,
+        cycles
+    };
+}
+function dependenciesWithin(name, index, within) {
+    const scenePackage = index.get(name);
+    if (!scenePackage) return [];
+    const names = scenePackage.dependencies.map((dependency)=>dependency.name).filter((dependency)=>within.has(dependency));
+    return [
+        ...new Set(names)
+    ];
+}
+/**
+ * Orders an already-closed set of package names so each follows the packages it depends on.
+ */ function topologicallyOrder(names, index) {
+    const within = new Set(names);
+    const remaining = new Map(names.map((name)=>[
+            name,
+            dependenciesWithin(name, index, within).length
+        ]));
+    const ordered = [];
+    const placed = new Set();
+    let progressed = true;
+    while(progressed){
+        progressed = false;
+        for (const name of names){
+            if (placed.has(name) || remaining.get(name) !== 0) continue;
+            ordered.push(name);
+            placed.add(name);
+            progressed = true;
+            for (const other of names){
+                if (placed.has(other)) continue;
+                if (dependenciesWithin(other, index, within).includes(name)) {
+                    remaining.set(other, remaining.get(other) - 1);
+                }
+            }
+        }
+    }
+    // Anything left is inside a cycle, or downstream of one. It is reported through `cycles`; keeping it
+    // in the list means a package picker never silently loses a package it was told about.
+    ordered.push(...names.filter((name)=>!placed.has(name)));
+    return ordered;
+}
+/**
+ * Finds every dependency cycle, walking depth-first from each package in discovery order so the result
+ * is deterministic. A cycle is recorded once, keyed by the set of packages in it.
+ */ function findCycles(names, index) {
+    const within = new Set(names);
+    const cycles = [];
+    const recorded = new Set();
+    const path = [];
+    const onPath = new Set();
+    const explored = new Set();
+    const walk = (name)=>{
+        if (onPath.has(name)) {
+            const cycle = path.slice(path.indexOf(name));
+            const key = [
+                ...cycle
+            ].sort().join(' ');
+            if (!recorded.has(key)) {
+                recorded.add(key);
+                cycles.push(cycle);
+            }
+            return;
+        }
+        if (explored.has(name)) return;
+        explored.add(name);
+        path.push(name);
+        onPath.add(name);
+        for (const dependency of dependenciesWithin(name, index, within)){
+            walk(dependency);
+        }
+        onPath.delete(name);
+        path.pop();
+    };
+    for (const name of names){
+        walk(name);
+    }
+    return cycles;
+}
+
+exports.resolvePackageDependencies = resolvePackageDependencies;
+//# sourceMappingURL=resolvePackageDependencies.js.map

package/dist/cjs/resolvePackageDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePackageDependencies.js","sources":["../../resolvePackageDependencies.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 { ScenePackage } from '@cratis/scene.model';\nimport { MissingPackageDependency, PackageSelection, PackageVersionConflict } from './PackageSelection';\nimport { isVersionSatisfiedBy } from './packageVersionRange';\n\n/**\n * Expands a chosen set of package names into the complete, correctly ordered list a {@link UiProfile}\n * needs — the runtime half. The C# twin in `Cratis.Scene.Engine` implements the same algorithm for\n * Studio's package picker and Stage's build; both are asserted against the same shared fixture corpus so\n * they cannot drift apart.\n *\n * This is a different concern from `resolveComponentName`, which resolves one component *name* against\n * an already-decided package list. This decides what that list is.\n *\n * Ordering is a stable topological sort: among packages whose dependencies are equally satisfied, the one\n * the caller named first comes first, and packages pulled in transitively follow in the order they were\n * discovered. When a cycle makes ordering impossible, the packages involved are reported in `cycles` and\n * appended in discovery order rather than dropped.\n */\nexport function resolvePackageDependencies(selected: string[], catalog: ScenePackage[]): PackageSelection {\n    const index = new Map(catalog.map((scenePackage) => [scenePackage.name, scenePackage]));\n    const discovered: string[] = [];\n    const seen = new Set<string>(selected);\n    const missing: MissingPackageDependency[] = [];\n    const versionConflicts: PackageVersionConflict[] = [];\n\n    const pending = [...selected];\n    while (pending.length > 0) {\n        const name = pending.shift()!;\n        discovered.push(name);\n\n        const scenePackage = index.get(name);\n        if (!scenePackage) continue;\n\n        for (const dependency of scenePackage.dependencies) {\n            const dependedOn = index.get(dependency.name);\n            if (!dependedOn) {\n                missing.push({ package: scenePackage.name, dependsOn: dependency.name });\n                continue;\n            }\n\n            if (!isVersionSatisfiedBy(dependedOn.version, dependency.versionRange)) {\n                versionConflicts.push({\n                    package: scenePackage.name,\n                    dependsOn: dependency.name,\n                    requiredRange: dependency.versionRange!,\n                    actualVersion: dependedOn.version,\n                });\n            }\n\n            if (!seen.has(dependency.name)) {\n                seen.add(dependency.name);\n                pending.push(dependency.name);\n            }\n        }\n    }\n\n    const cycles = findCycles(discovered, index);\n    const packages = topologicallyOrder(discovered, index);\n    const chosen = new Set(selected);\n\n    return {\n        packages,\n        added: packages.filter((name) => !chosen.has(name)),\n        missing,\n        versionConflicts,\n        cycles,\n    };\n}\n\nfunction dependenciesWithin(name: string, index: Map<string, ScenePackage>, within: Set<string>): string[] {\n    const scenePackage = index.get(name);\n    if (!scenePackage) return [];\n    const names = scenePackage.dependencies.map((dependency) => dependency.name).filter((dependency) => within.has(dependency));\n    return [...new Set(names)];\n}\n\n/**\n * Orders an already-closed set of package names so each follows the packages it depends on.\n */\nfunction topologicallyOrder(names: string[], index: Map<string, ScenePackage>): string[] {\n    const within = new Set(names);\n    const remaining = new Map(names.map((name) => [name, dependenciesWithin(name, index, within).length]));\n\n    const ordered: string[] = [];\n    const placed = new Set<string>();\n    let progressed = true;\n    while (progressed) {\n        progressed = false;\n        for (const name of names) {\n            if (placed.has(name) || remaining.get(name) !== 0) continue;\n\n            ordered.push(name);\n            placed.add(name);\n            progressed = true;\n\n            for (const other of names) {\n                if (placed.has(other)) continue;\n                if (dependenciesWithin(other, index, within).includes(name)) {\n                    remaining.set(other, remaining.get(other)! - 1);\n                }\n            }\n        }\n    }\n\n    // Anything left is inside a cycle, or downstream of one. It is reported through `cycles`; keeping it\n    // in the list means a package picker never silently loses a package it was told about.\n    ordered.push(...names.filter((name) => !placed.has(name)));\n    return ordered;\n}\n\n/**\n * Finds every dependency cycle, walking depth-first from each package in discovery order so the result\n * is deterministic. A cycle is recorded once, keyed by the set of packages in it.\n */\nfunction findCycles(names: string[], index: Map<string, ScenePackage>): string[][] {\n    const within = new Set(names);\n    const cycles: string[][] = [];\n    const recorded = new Set<string>();\n    const path: string[] = [];\n    const onPath = new Set<string>();\n    const explored = new Set<string>();\n\n    const walk = (name: string) => {\n        if (onPath.has(name)) {\n            const cycle = path.slice(path.indexOf(name));\n            const key = [...cycle].sort().join(' ');\n            if (!recorded.has(key)) {\n                recorded.add(key);\n                cycles.push(cycle);\n            }\n\n            return;\n        }\n\n        if (explored.has(name)) return;\n        explored.add(name);\n\n        path.push(name);\n        onPath.add(name);\n        for (const dependency of dependenciesWithin(name, index, within)) {\n            walk(dependency);\n        }\n\n        onPath.delete(name);\n        path.pop();\n    };\n\n    for (const name of names) {\n        walk(name);\n    }\n\n    return cycles;\n}\n"],"names":["resolvePackageDependencies","selected","catalog","index","Map","map","scenePackage","name","discovered","seen","Set","missing","versionConflicts","pending","length","shift","push","get","dependency","dependencies","dependedOn","package","dependsOn","isVersionSatisfiedBy","version","versionRange","requiredRange","actualVersion","has","add","cycles","findCycles","packages","topologicallyOrder","chosen","added","filter","dependenciesWithin","within","names","remaining","ordered","placed","progressed","other","includes","set","recorded","path","onPath","explored","walk","cycle","slice","indexOf","key","sort","join","delete","pop"],"mappings":"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"}