@cratis/scene.engine 4.37.0 → 4.39.0

package/dist/cjs/blueprints/describeBlueprintCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeBlueprintCatalog.js","sources":["../../../blueprints/describeBlueprintCatalog.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 } from '@cratis/scene.model';\nimport { TemplateSource } from '../templates/TemplateSource';\nimport { BlueprintCatalogEntry, BlueprintCatalogFile } from './BlueprintCatalogEntry';\n\n/**\n * Describes every domain blueprint among the given packages - those of kind Blueprint that declare blueprint metadata - for a gallery:\n * its thumbnail and description, its screen set in navigation order, the templates it provides, and the sample data a preview can use.\n * A package that only provides foundation layouts and templates is not a domain blueprint and is not listed. The result is ordered by\n * package name so the file it is written to is stable. The C# engine (`BlueprintCatalog.Describe`) returns the same entries; both are\n * asserted against `blueprint-verification-fixtures.json`.\n */\nexport function describeBlueprintCatalog(sources: readonly TemplateSource[]): BlueprintCatalogEntry[] {\n    return sources\n        .filter(source => source.manifest.kind === PackageKind.Blueprint && source.manifest.blueprint !== undefined)\n        .map((source): BlueprintCatalogEntry => {\n            const manifest = source.manifest;\n            const blueprint = manifest.blueprint!;\n            const defaultId = blueprint.defaultSampleData ?? ((manifest.sampleData ?? []).length === 1 ? manifest.sampleData![0].id : undefined);\n            const templates = [\n                ...(source.layouts ?? []).map(template => ({ kind: 'Layout', template })),\n                ...(source.screenTemplates ?? []).map(template => ({ kind: 'ScreenTemplate', template })),\n                ...(source.dialogTemplates ?? []).map(template => ({ kind: 'DialogTemplate', template })),\n            ];\n\n            return {\n                package: manifest.name,\n                version: manifest.version,\n                domain: blueprint.domain,\n                ...(manifest.displayName === undefined ? {} : { displayName: manifest.displayName }),\n                description: blueprint.description,\n                thumbnail: blueprint.thumbnail,\n                ...(manifest.license === undefined ? {} : { license: manifest.license }),\n                ...(manifest.licenseUrl === undefined ? {} : { licenseUrl: manifest.licenseUrl }),\n                dependencies: manifest.dependencies.map(dependency => ({ name: dependency.name, ...(dependency.versionRange === undefined ? {} : { versionRange: dependency.versionRange }) })),\n                screens: orderedScreens(blueprint.screenSet ?? []).map(screen => ({\n                    name: screen.name,\n                    title: screen.title,\n                    ...(screen.description === undefined ? {} : { description: screen.description }),\n                    ...(screen.template === undefined ? {} : { template: screen.template }),\n                    ...(screen.parent === undefined ? {} : { parent: screen.parent }),\n                    ...(screen.order === undefined ? {} : { order: screen.order }),\n                })),\n                templates: templates.map(({ kind, template }) => {\n                    const described = template as { displayName?: string; description?: string; metadata?: { type?: string; category?: string; thumbnail?: string } };\n                    return {\n                        name: template.name,\n                        kind,\n                        ...(described.displayName === undefined ? {} : { displayName: described.displayName }),\n                        ...(described.description === undefined ? {} : { description: described.description }),\n                        ...(described.metadata?.type === undefined ? {} : { type: described.metadata.type }),\n                        ...(described.metadata?.category === undefined ? {} : { category: described.metadata.category }),\n                        ...(described.metadata?.thumbnail === undefined ? {} : { thumbnail: described.metadata.thumbnail }),\n                    };\n                }),\n                sampleData: (manifest.sampleData ?? []).map(reference => ({ id: reference.id, title: reference.title, locale: reference.locale, path: reference.path, default: reference.id === defaultId })),\n            };\n        })\n        .sort((left, right) => (left.package < right.package ? -1 : left.package > right.package ? 1 : 0));\n}\n\n/** The catalog as the file a blueprint package ships. */\nexport const toBlueprintCatalogFile = (entries: BlueprintCatalogEntry[]): BlueprintCatalogFile => ({ schema: 1, blueprints: entries });\n\n/**\n * Puts screens in navigation order: siblings by `order` (a screen without one keeps its written place after those with one), each\n * screen directly followed by its children, so a flat list reads top to bottom as the navigation does.\n */\nfunction orderedScreens<T extends { name: string; parent?: string; order?: number }>(screens: readonly T[]): T[] {\n    const names = new Set(screens.map(screen => screen.name));\n    const childrenOf = (parent: string | undefined): T[] => {\n        const siblings = screens.filter(screen => (parent === undefined ? screen.parent === undefined || !names.has(screen.parent) : screen.parent === parent));\n        return siblings\n            .map((screen, index) => ({ screen, index }))\n            .sort((left, right) => (left.screen.order ?? Number.MAX_SAFE_INTEGER) - (right.screen.order ?? Number.MAX_SAFE_INTEGER) || left.index - right.index)\n            .map(entry => entry.screen);\n    };\n\n    const result: T[] = [];\n    const seen = new Set<string>();\n    const walk = (level: T[]) => {\n        for (const screen of level) {\n            if (seen.has(screen.name)) continue;\n            seen.add(screen.name);\n            result.push(screen);\n            walk(childrenOf(screen.name));\n        }\n    };\n\n    walk(childrenOf(undefined));\n    for (const screen of screens) if (!seen.has(screen.name)) result.push(screen);\n    return result;\n}\n"],"names":["describeBlueprintCatalog","sources","filter","source","manifest","kind","PackageKind","Blueprint","blueprint","undefined","map","defaultId","defaultSampleData","sampleData","length","id","templates","layouts","template","screenTemplates","dialogTemplates","package","name","version","domain","displayName","description","thumbnail","license","licenseUrl","dependencies","dependency","versionRange","screens","orderedScreens","screenSet","screen","title","parent","order","described","metadata","type","category","reference","locale","path","default","sort","left","right","toBlueprintCatalogFile","entries","schema","blueprints","names","Set","childrenOf","siblings","has","index","Number","MAX_SAFE_INTEGER","entry","result","seen","walk","level","add","push"],"mappings":"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"}

package/dist/cjs/blueprints/evaluateBlueprintPin.js

@@ -0,0 +1,75 @@
+'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.
+/** Where a blueprint reference's pin stands against what is installed and what is available. */ var BlueprintPinStatus = /*#__PURE__*/ function(BlueprintPinStatus) {
+    /** The installed version satisfies the pin and nothing newer is available. */ BlueprintPinStatus["Current"] = "Current";
+    /** A newer version the pin allows is available: taking it changes nothing the pin promised to keep. */ BlueprintPinStatus["UpdateAvailable"] = "UpdateAvailable";
+    /** A newer version is available that the pin does not allow - usually a new major version - so taking it is a deliberate move that rewrites the pin. */ BlueprintPinStatus["UpdateBlockedByPin"] = "UpdateBlockedByPin";
+    /** The installed version does not satisfy the pin: the reference was chosen from a version that is no longer there. */ BlueprintPinStatus["NotSatisfied"] = "NotSatisfied";
+    /** The pin or a version is not one the engine understands. */ BlueprintPinStatus["Invalid"] = "Invalid";
+    return BlueprintPinStatus;
+}({});
+/**
+ * The pin a reference gets when a template is chosen from a blueprint: the caret range of the installed version, so the reference accepts
+ * every compatible update and refuses a new major version until someone moves it on purpose.
+ */ const defaultBlueprintPin = (installedVersion)=>`^${installedVersion}`;
+/**
+ * Decides whether "update available" applies to a template reference that pins a blueprint version (`TemplateReference.version`).
+ *
+ * A reference without a pin is held to {@link defaultBlueprintPin} of the installed version. The pin says which versions the reference
+ * is content to run against; the installed version must satisfy it, and a newer available version is an update - an ordinary one when
+ * the pin allows it, one the pin blocks (usually a major version) when it does not. Both engines implement this identically (`BlueprintVersionPin.Evaluate`) and are
+ * asserted against `blueprint-verification-fixtures.json`.
+ *
+ * @param pin The reference's version range, or undefined when it has none.
+ * @param installedVersion The version of the blueprint that is installed.
+ * @param latestVersion The newest version of the blueprint that is available; when undefined only the installed version is known.
+ */ function evaluateBlueprintPin(pin, installedVersion, latestVersion) {
+    const effective = pin === undefined || pin.trim() === '' ? defaultBlueprintPin(installedVersion) : pin.trim();
+    if (!packageVersionRange.isValidVersion(installedVersion)) return {
+        status: "Invalid",
+        pin: effective,
+        message: `Installed version '${installedVersion}' is not a version`
+    };
+    if (!packageVersionRange.isValidVersionRange(effective)) return {
+        status: "Invalid",
+        pin: effective,
+        message: `Pin '${effective}' is not a version range`
+    };
+    if (latestVersion !== undefined && !packageVersionRange.isValidVersion(latestVersion)) return {
+        status: "Invalid",
+        pin: effective,
+        message: `Latest version '${latestVersion}' is not a version`
+    };
+    if (!packageVersionRange.isVersionSatisfiedBy(installedVersion, effective)) {
+        return {
+            status: "NotSatisfied",
+            pin: effective,
+            message: `Version ${installedVersion} is installed but the reference pins ${effective}`
+        };
+    }
+    if (latestVersion === undefined || packageVersionRange.compareVersions(latestVersion, installedVersion) <= 0) {
+        return {
+            status: "Current",
+            pin: effective,
+            message: `Version ${installedVersion} is the latest`
+        };
+    }
+    return packageVersionRange.isVersionSatisfiedBy(latestVersion, effective) ? {
+        status: "UpdateAvailable",
+        pin: effective,
+        message: `Version ${latestVersion} is available, and ${effective} allows it`
+    } : {
+        status: "UpdateBlockedByPin",
+        pin: effective,
+        message: `Version ${latestVersion} is available but ${effective} does not allow it`
+    };
+}
+
+exports.BlueprintPinStatus = BlueprintPinStatus;
+exports.defaultBlueprintPin = defaultBlueprintPin;
+exports.evaluateBlueprintPin = evaluateBlueprintPin;
+//# sourceMappingURL=evaluateBlueprintPin.js.map

package/dist/cjs/blueprints/evaluateBlueprintPin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateBlueprintPin.js","sources":["../../../blueprints/evaluateBlueprintPin.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 { compareVersions, isValidVersion, isValidVersionRange, isVersionSatisfiedBy } from '../packageVersionRange';\n\n/** Where a blueprint reference's pin stands against what is installed and what is available. */\nexport enum BlueprintPinStatus {\n    /** The installed version satisfies the pin and nothing newer is available. */\n    Current = 'Current',\n\n    /** A newer version the pin allows is available: taking it changes nothing the pin promised to keep. */\n    UpdateAvailable = 'UpdateAvailable',\n\n    /** A newer version is available that the pin does not allow - usually a new major version - so taking it is a deliberate move that rewrites the pin. */\n    UpdateBlockedByPin = 'UpdateBlockedByPin',\n\n    /** The installed version does not satisfy the pin: the reference was chosen from a version that is no longer there. */\n    NotSatisfied = 'NotSatisfied',\n\n    /** The pin or a version is not one the engine understands. */\n    Invalid = 'Invalid',\n}\n\n/** The outcome of evaluating a pin. */\nexport interface BlueprintPinEvaluation {\n    status: BlueprintPinStatus;\n\n    /** The pin that was evaluated: the one given, or the default for the installed version when none was. */\n    pin: string;\n\n    /** Said in a sentence, for a tooltip or a diagnostic. */\n    message: string;\n}\n\n/**\n * The pin a reference gets when a template is chosen from a blueprint: the caret range of the installed version, so the reference accepts\n * every compatible update and refuses a new major version until someone moves it on purpose.\n */\nexport const defaultBlueprintPin = (installedVersion: string): string => `^${installedVersion}`;\n\n/**\n * Decides whether \"update available\" applies to a template reference that pins a blueprint version (`TemplateReference.version`).\n *\n * A reference without a pin is held to {@link defaultBlueprintPin} of the installed version. The pin says which versions the reference\n * is content to run against; the installed version must satisfy it, and a newer available version is an update - an ordinary one when\n * the pin allows it, one the pin blocks (usually a major version) when it does not. Both engines implement this identically (`BlueprintVersionPin.Evaluate`) and are\n * asserted against `blueprint-verification-fixtures.json`.\n *\n * @param pin The reference's version range, or undefined when it has none.\n * @param installedVersion The version of the blueprint that is installed.\n * @param latestVersion The newest version of the blueprint that is available; when undefined only the installed version is known.\n */\nexport function evaluateBlueprintPin(pin: string | undefined, installedVersion: string, latestVersion?: string): BlueprintPinEvaluation {\n    const effective = pin === undefined || pin.trim() === '' ? defaultBlueprintPin(installedVersion) : pin.trim();\n\n    if (!isValidVersion(installedVersion)) return { status: BlueprintPinStatus.Invalid, pin: effective, message: `Installed version '${installedVersion}' is not a version` };\n    if (!isValidVersionRange(effective)) return { status: BlueprintPinStatus.Invalid, pin: effective, message: `Pin '${effective}' is not a version range` };\n    if (latestVersion !== undefined && !isValidVersion(latestVersion)) return { status: BlueprintPinStatus.Invalid, pin: effective, message: `Latest version '${latestVersion}' is not a version` };\n\n    if (!isVersionSatisfiedBy(installedVersion, effective)) {\n        return { status: BlueprintPinStatus.NotSatisfied, pin: effective, message: `Version ${installedVersion} is installed but the reference pins ${effective}` };\n    }\n\n    if (latestVersion === undefined || compareVersions(latestVersion, installedVersion) <= 0) {\n        return { status: BlueprintPinStatus.Current, pin: effective, message: `Version ${installedVersion} is the latest` };\n    }\n\n    return isVersionSatisfiedBy(latestVersion, effective)\n        ? { status: BlueprintPinStatus.UpdateAvailable, pin: effective, message: `Version ${latestVersion} is available, and ${effective} allows it` }\n        : { status: BlueprintPinStatus.UpdateBlockedByPin, pin: effective, message: `Version ${latestVersion} is available but ${effective} does not allow it` };\n}\n"],"names":["BlueprintPinStatus","defaultBlueprintPin","installedVersion","evaluateBlueprintPin","pin","latestVersion","effective","undefined","trim","isValidVersion","status","message","isValidVersionRange","isVersionSatisfiedBy","compareVersions"],"mappings":";;;;AAAA;AACA;AAIA,iGACO,IAAKA,kBAAAA,iBAAAA,SAAAA,kBAAAA,EAAAA;mFACoE,kBAAA,CAAA,SAAA,CAAA,GAAA,SAAA;4GAGyB,kBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA;6JAGiD,kBAAA,CAAA,oBAAA,CAAA,GAAA,oBAAA;4HAGjC,kBAAA,CAAA,cAAA,CAAA,GAAA,cAAA;mEAGzD,kBAAA,CAAA,SAAA,CAAA,GAAA,SAAA;AAbpDA,IAAAA,OAAAA,kBAAAA;AAeX,CAAA,CAAA,EAAA;AAaD;;;UAIaC,mBAAAA,GAAsB,CAACC,mBAAqC,CAAC,CAAC,EAAEA,gBAAAA,CAAAA;AAE7E;;;;;;;;;;;AAWC,IACM,SAASC,oBAAAA,CAAqBC,GAAuB,EAAEF,gBAAwB,EAAEG,aAAsB,EAAA;IAC1G,MAAMC,SAAAA,GAAYF,GAAAA,KAAQG,SAAAA,IAAaH,GAAAA,CAAII,IAAI,OAAO,EAAA,GAAKP,mBAAAA,CAAoBC,gBAAAA,CAAAA,GAAoBE,GAAAA,CAAII,IAAI,EAAA;IAE3G,IAAI,CAACC,kCAAAA,CAAeP,gBAAAA,CAAAA,EAAmB,OAAO;QAAEQ,MAAM,EAAA,SAAA;QAA8BN,GAAAA,EAAKE,SAAAA;AAAWK,QAAAA,OAAAA,EAAS,CAAC,mBAAmB,EAAET,gBAAAA,CAAiB,kBAAkB;AAAE,KAAA;IACxK,IAAI,CAACU,uCAAAA,CAAoBN,SAAAA,CAAAA,EAAY,OAAO;QAAEI,MAAM,EAAA,SAAA;QAA8BN,GAAAA,EAAKE,SAAAA;AAAWK,QAAAA,OAAAA,EAAS,CAAC,KAAK,EAAEL,SAAAA,CAAU,wBAAwB;AAAE,KAAA;AACvJ,IAAA,IAAID,aAAAA,KAAkBE,SAAAA,IAAa,CAACE,kCAAAA,CAAeJ,gBAAgB,OAAO;QAAEK,MAAM,EAAA,SAAA;QAA8BN,GAAAA,EAAKE,SAAAA;AAAWK,QAAAA,OAAAA,EAAS,CAAC,gBAAgB,EAAEN,aAAAA,CAAc,kBAAkB;AAAE,KAAA;IAE9L,IAAI,CAACQ,wCAAAA,CAAqBX,gBAAAA,EAAkBI,SAAAA,CAAAA,EAAY;QACpD,OAAO;YAAEI,MAAM,EAAA,cAAA;YAAmCN,GAAAA,EAAKE,SAAAA;AAAWK,YAAAA,OAAAA,EAAS,CAAC,QAAQ,EAAET,gBAAAA,CAAiB,qCAAqC,EAAEI,SAAAA,CAAAA;AAAY,SAAA;AAC9J,IAAA;AAEA,IAAA,IAAID,aAAAA,KAAkBE,SAAAA,IAAaO,mCAAAA,CAAgBT,aAAAA,EAAeH,qBAAqB,CAAA,EAAG;QACtF,OAAO;YAAEQ,MAAM,EAAA,SAAA;YAA8BN,GAAAA,EAAKE,SAAAA;AAAWK,YAAAA,OAAAA,EAAS,CAAC,QAAQ,EAAET,gBAAAA,CAAiB,cAAc;AAAE,SAAA;AACtH,IAAA;IAEA,OAAOW,wCAAAA,CAAqBR,eAAeC,SAAAA,CAAAA,GACrC;QAAEI,MAAM,EAAA,iBAAA;QAAsCN,GAAAA,EAAKE,SAAAA;QAAWK,OAAAA,EAAS,CAAC,QAAQ,EAAEN,aAAAA,CAAc,mBAAmB,EAAEC,SAAAA,CAAU,UAAU;KAAE,GAC3I;QAAEI,MAAM,EAAA,oBAAA;QAAyCN,GAAAA,EAAKE,SAAAA;QAAWK,OAAAA,EAAS,CAAC,QAAQ,EAAEN,aAAAA,CAAc,kBAAkB,EAAEC,SAAAA,CAAU,kBAAkB;AAAE,KAAA;AAC/J;;;;"}

package/dist/cjs/blueprints/verifyBlueprintPackage.js

@@ -0,0 +1,194 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var packageVersionRange = require('../packageVersionRange.js');
+var resolveScreenTemplates = require('../resolveScreenTemplates.js');
+var validateSampleDataPackages = require('../sampleData/validateSampleDataPackages.js');
+var describeTemplateCatalog = require('../templates/describeTemplateCatalog.js');
+var blueprintRules = require('./blueprintRules.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The definition of done for a blueprint (spec Part B 6), as rules a package can be held to: valid manifest and version; for a domain
+ * blueprint its domain, description, thumbnail and screen set; every template with complete metadata, a category, a type from the
+ * vocabulary, a description and a thumbnail; every template placed by the slot resolver, with nothing unplaced, ambiguous or nested in
+ * itself (ambiguity is only a problem for a domain blueprint: the foundation's generic nesting chain fits slots many templates declare, and is chosen explicitly); sample data present, locale-tagged and valid; and a dependency on the foundation set. The C# engine
+ * (`BlueprintVerification.Verify`) reports the same problems in the same order; both are asserted against
+ * `blueprint-verification-fixtures.json`.
+ *
+ * @param source The blueprint to verify.
+ * @param library The other packages available - above all the foundation set - so templates can be placed into its layouts and checked against its versions.
+ * @param options How strictly to verify.
+ * @returns The problems; empty when the blueprint is done.
+ */ function verifyBlueprintPackage(source, library = [], options = {}) {
+    const manifest = source.manifest;
+    const name = manifest.name;
+    const label = `Blueprint '${name}'`;
+    const foundation = options.foundationPackage ?? blueprintRules.foundationPackageName;
+    if (manifest.kind !== scene_model.PackageKind.Blueprint) return [
+        `Package '${name}' is not a Blueprint package`
+    ];
+    const problems = [];
+    if (!packageVersionRange.isValidVersion(manifest.version)) problems.push(`${label} declares an invalid version '${manifest.version ?? ''}'`);
+    const blueprint = manifest.blueprint;
+    const domain = blueprint !== undefined;
+    const available = new Set([
+        ...source.screenTemplates ?? [],
+        ...library.flatMap((other)=>other.screenTemplates ?? [])
+    ].map((template)=>template.name));
+    if (!blueprint) {
+        if (options.requireBlueprintMetadata) problems.push(`${label} declares no blueprint metadata (domain, description, thumbnail and screen set)`);
+    } else {
+        if ((blueprint.domain ?? '').trim() === '') problems.push(`${label} declares no domain`);
+        else if (!blueprintRules.isValidBlueprintDomain(blueprint.domain)) problems.push(`${label} declares an invalid domain '${blueprint.domain}'; use lower-case words separated by '-'`);
+        if ((blueprint.description ?? '').trim() === '') problems.push(`${label} declares no description`);
+        else if (blueprint.description.length > blueprintRules.maximumBlueprintDescriptionLength) problems.push(`${label} declares a description longer than ${blueprintRules.maximumBlueprintDescriptionLength} characters`);
+        problems.push(...thumbnailProblems(label, blueprint.thumbnail, source.files));
+        problems.push(...screenSetProblems(source, label, available));
+        if (blueprint.defaultSampleData !== undefined && !(manifest.sampleData ?? []).some((reference)=>reference.id === blueprint.defaultSampleData)) {
+            problems.push(`${label} declares default sample data '${blueprint.defaultSampleData}', which is not one of its sample data packs`);
+        }
+        if ((manifest.sampleData ?? []).length === 0) problems.push(`${label} ships no sample data pack`);
+        else if ((manifest.sampleData ?? []).length > 1 && blueprint.defaultSampleData === undefined) problems.push(`${label} ships several sample data packs but declares no default`);
+        if (name !== foundation && !manifest.dependencies.some((dependency)=>dependency.name === foundation)) {
+            problems.push(`${label} does not depend on the foundation set '${foundation}'`);
+        }
+    }
+    problems.push(...validateSampleDataPackages.validateSampleDataPackages([
+        {
+            manifest,
+            packs: source.packs
+        }
+    ]));
+    for (const reference of manifest.sampleData ?? []){
+        if (source.files !== undefined && !source.files.includes(reference.path)) problems.push(`${label} sample data pack '${reference.id}' names '${reference.path}', which is not in the package`);
+    }
+    problems.push(...templateProblems(source, library, domain));
+    problems.push(...placementProblems(source, library, label, domain));
+    return problems;
+}
+function thumbnailProblems(owner, thumbnail, files) {
+    if ((thumbnail ?? '').trim() === '') return [
+        `${owner} declares no thumbnail`
+    ];
+    if (!blueprintRules.isValidThumbnailPath(thumbnail)) return [
+        `${owner} declares thumbnail '${thumbnail}', which is not 'thumbnails/<name>.png|webp|jpg|svg'`
+    ];
+    if (files !== undefined && !files.includes(thumbnail)) return [
+        `${owner} declares thumbnail '${thumbnail}', which is not in the package`
+    ];
+    return [];
+}
+function screenSetProblems(source, label, availableTemplates) {
+    const set = source.manifest.blueprint.screenSet ?? [];
+    if (set.length === 0) return [
+        `${label} declares no ready-to-use screen set`
+    ];
+    const problems = [];
+    const names = new Set();
+    for (const screen of set){
+        if ((screen.name ?? '').trim() === '') {
+            problems.push(`${label} declares a screen set entry without a name`);
+            continue;
+        }
+        if (names.has(screen.name)) problems.push(`${label} declares screen '${screen.name}' more than once`);
+        names.add(screen.name);
+    }
+    for (const screen of set){
+        if ((screen.name ?? '').trim() === '') continue;
+        const owner = `${label} screen '${screen.name}'`;
+        if ((screen.title ?? '').trim() === '') problems.push(`${owner} declares no title`);
+        if (screen.template !== undefined && !availableTemplates.has(screen.template)) problems.push(`${owner} uses template '${screen.template}', which is not available`);
+        if (screen.parent !== undefined && !names.has(screen.parent)) problems.push(`${owner} has parent '${screen.parent}', which is not in the screen set`);
+        if (source.screens !== undefined && !source.screens.some((candidate)=>candidate.name === screen.name)) problems.push(`${owner} is named in the screen set but the package does not provide it`);
+    }
+    for (const screen of set){
+        if (screen.parent !== undefined && names.has(screen.parent) && isOwnAncestor(screen.name, set)) problems.push(`${label} screen '${screen.name}' is its own ancestor`);
+    }
+    return problems;
+}
+function isOwnAncestor(name, set) {
+    const visited = new Set();
+    for(let current = set.find((screen)=>screen.name === name)?.parent; current !== undefined; current = set.find((screen)=>screen.name === current)?.parent){
+        if (current === name) return true;
+        if (visited.has(current)) return false;
+        visited.add(current);
+    }
+    return false;
+}
+function templateProblems(source, library, domain) {
+    const problems = [];
+    const described = [
+        ...source.screenTemplates ?? [],
+        ...source.dialogTemplates ?? []
+    ];
+    const everyTemplate = [
+        ...(source.layouts ?? []).map((layout)=>({
+                name: layout.name,
+                metadata: layout.metadata,
+                describable: false
+            })),
+        ...described.map((template)=>({
+                name: template.name,
+                displayName: template.displayName,
+                description: template.description,
+                metadata: template.metadata,
+                describable: true
+            }))
+    ];
+    const others = library.filter((other)=>other.manifest.name !== source.manifest.name);
+    for (const entry of describeTemplateCatalog.describeTemplateCatalog([
+        source,
+        ...others
+    ]).filter((candidate)=>candidate.package === source.manifest.name)){
+        problems.push(...entry.problems);
+    }
+    for (const template of everyTemplate){
+        const owner = `Template '${template.name}'`;
+        if (template.describable && (template.displayName ?? '').trim() === '') problems.push(`${owner} declares no display name`);
+        if (template.describable && (template.description ?? '').trim() === '') problems.push(`${owner} declares no description`);
+        if (!domain) continue;
+        const metadata = template.metadata;
+        if (metadata?.type === undefined) problems.push(`${owner} declares no type`);
+        else if (!blueprintRules.blueprintTemplateTypes.includes(metadata.type)) problems.push(`${owner} declares type '${metadata.type}', which is not one of ${blueprintRules.blueprintTemplateTypes.join(', ')}`);
+        if (metadata?.category !== undefined && metadata.category.trim() !== '' && !metadata.category.startsWith(blueprintRules.businessCategoryPrefix)) {
+            problems.push(`${owner} declares category '${metadata.category}', which does not start with '${blueprintRules.businessCategoryPrefix}'`);
+        }
+        problems.push(...thumbnailProblems(owner, metadata?.thumbnail, source.files));
+    }
+    return problems;
+}
+function placementProblems(source, library, label, domain) {
+    const own = (source.screenTemplates ?? []).filter((template)=>template.fitsSlot !== undefined);
+    if (own.length === 0) return [];
+    const layouts = [
+        ...source.layouts ?? [],
+        ...library.flatMap((other)=>other.layouts ?? [])
+    ];
+    const everyTemplate = [
+        ...source.screenTemplates ?? [],
+        ...library.flatMap((other)=>other.screenTemplates ?? [])
+    ];
+    if (layouts.length === 0) return [
+        `${label} has no layout to place its screen templates in`
+    ];
+    const resolutions = layouts.map((layout)=>({
+            layout,
+            resolution: resolveScreenTemplates.resolveScreenTemplates(layout, everyTemplate)
+        }));
+    const problems = [];
+    for (const template of own){
+        if (resolutions.some(({ resolution })=>resolution.placements.some((placement)=>placement.template === template.name))) continue;
+        const unplacedEverywhere = resolutions.flatMap(({ resolution })=>resolution.unplaced.filter((candidate)=>candidate.template === template.name));
+        const unplaced = unplacedEverywhere.find((candidate)=>candidate.candidates.length > 1);
+        const cyclic = resolutions.some(({ resolution })=>resolution.cycles.some((cycle)=>cycle.includes(template.name)));
+        if (cyclic) problems.push(`Template '${template.name}' is nested inside itself`);
+        else if (unplaced && domain) problems.push(`Template '${template.name}' is ambiguous: slot '${unplaced.slot}' is declared by ${unplaced.candidates.join(', ')}`);
+        else if (!unplaced) problems.push(`Template '${template.name}' is unplaced: no layout or template declares slot '${template.fitsSlot}'`);
+    }
+    return problems;
+}
+
+exports.verifyBlueprintPackage = verifyBlueprintPackage;
+//# sourceMappingURL=verifyBlueprintPackage.js.map

package/dist/cjs/blueprints/verifyBlueprintPackage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyBlueprintPackage.js","sources":["../../../blueprints/verifyBlueprintPackage.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, ScreenTemplate } from '@cratis/scene.model';\nimport { isValidVersion } from '../packageVersionRange';\nimport { resolveScreenTemplates } from '../resolveScreenTemplates';\nimport { validateSampleDataPackages } from '../sampleData/validateSampleDataPackages';\nimport { describeTemplateCatalog } from '../templates/describeTemplateCatalog';\nimport { TemplateSource } from '../templates/TemplateSource';\nimport { BlueprintSource } from './BlueprintSource';\nimport {\n    blueprintTemplateTypes, businessCategoryPrefix, foundationPackageName, isValidBlueprintDomain, isValidThumbnailPath, maximumBlueprintDescriptionLength,\n} from './blueprintRules';\n\n/** How a blueprint is verified. */\nexport interface BlueprintVerificationOptions {\n    /** The package that provides the foundation set a domain blueprint must depend on. Defaults to {@link foundationPackageName}. */\n    foundationPackage?: string;\n\n    /** Whether a package without blueprint metadata is a problem. Set for every domain blueprint; unset for a package that only provides foundation layouts and templates. */\n    requireBlueprintMetadata?: boolean;\n}\n\n/**\n * The definition of done for a blueprint (spec Part B 6), as rules a package can be held to: valid manifest and version; for a domain\n * blueprint its domain, description, thumbnail and screen set; every template with complete metadata, a category, a type from the\n * vocabulary, a description and a thumbnail; every template placed by the slot resolver, with nothing unplaced, ambiguous or nested in\n * itself (ambiguity is only a problem for a domain blueprint: the foundation's generic nesting chain fits slots many templates declare, and is chosen explicitly); sample data present, locale-tagged and valid; and a dependency on the foundation set. The C# engine\n * (`BlueprintVerification.Verify`) reports the same problems in the same order; both are asserted against\n * `blueprint-verification-fixtures.json`.\n *\n * @param source The blueprint to verify.\n * @param library The other packages available - above all the foundation set - so templates can be placed into its layouts and checked against its versions.\n * @param options How strictly to verify.\n * @returns The problems; empty when the blueprint is done.\n */\nexport function verifyBlueprintPackage(source: BlueprintSource, library: readonly TemplateSource[] = [], options: BlueprintVerificationOptions = {}): string[] {\n    const manifest = source.manifest;\n    const name = manifest.name;\n    const label = `Blueprint '${name}'`;\n    const foundation = options.foundationPackage ?? foundationPackageName;\n\n    if (manifest.kind !== PackageKind.Blueprint) return [`Package '${name}' is not a Blueprint package`];\n\n    const problems: string[] = [];\n    if (!isValidVersion(manifest.version)) problems.push(`${label} declares an invalid version '${manifest.version ?? ''}'`);\n\n    const blueprint = manifest.blueprint;\n    const domain = blueprint !== undefined;\n    const available = new Set([...(source.screenTemplates ?? []), ...library.flatMap(other => other.screenTemplates ?? [])].map(template => template.name));\n\n    if (!blueprint) {\n        if (options.requireBlueprintMetadata) problems.push(`${label} declares no blueprint metadata (domain, description, thumbnail and screen set)`);\n    } else {\n        if ((blueprint.domain ?? '').trim() === '') problems.push(`${label} declares no domain`);\n        else if (!isValidBlueprintDomain(blueprint.domain)) problems.push(`${label} declares an invalid domain '${blueprint.domain}'; use lower-case words separated by '-'`);\n\n        if ((blueprint.description ?? '').trim() === '') problems.push(`${label} declares no description`);\n        else if (blueprint.description.length > maximumBlueprintDescriptionLength) problems.push(`${label} declares a description longer than ${maximumBlueprintDescriptionLength} characters`);\n\n        problems.push(...thumbnailProblems(label, blueprint.thumbnail, source.files));\n        problems.push(...screenSetProblems(source, label, available));\n\n        if (blueprint.defaultSampleData !== undefined && !(manifest.sampleData ?? []).some(reference => reference.id === blueprint.defaultSampleData)) {\n            problems.push(`${label} declares default sample data '${blueprint.defaultSampleData}', which is not one of its sample data packs`);\n        }\n\n        if ((manifest.sampleData ?? []).length === 0) problems.push(`${label} ships no sample data pack`);\n        else if ((manifest.sampleData ?? []).length > 1 && blueprint.defaultSampleData === undefined) problems.push(`${label} ships several sample data packs but declares no default`);\n\n        if (name !== foundation && !manifest.dependencies.some(dependency => dependency.name === foundation)) {\n            problems.push(`${label} does not depend on the foundation set '${foundation}'`);\n        }\n    }\n\n    problems.push(...validateSampleDataPackages([{ manifest, packs: source.packs }]));\n    for (const reference of manifest.sampleData ?? []) {\n        if (source.files !== undefined && !source.files.includes(reference.path)) problems.push(`${label} sample data pack '${reference.id}' names '${reference.path}', which is not in the package`);\n    }\n\n    problems.push(...templateProblems(source, library, domain));\n    problems.push(...placementProblems(source, library, label, domain));\n    return problems;\n}\n\nfunction thumbnailProblems(owner: string, thumbnail: string | undefined, files: string[] | undefined): string[] {\n    if ((thumbnail ?? '').trim() === '') return [`${owner} declares no thumbnail`];\n    if (!isValidThumbnailPath(thumbnail)) return [`${owner} declares thumbnail '${thumbnail}', which is not 'thumbnails/<name>.png|webp|jpg|svg'`];\n    if (files !== undefined && !files.includes(thumbnail!)) return [`${owner} declares thumbnail '${thumbnail}', which is not in the package`];\n    return [];\n}\n\nfunction screenSetProblems(source: BlueprintSource, label: string, availableTemplates: Set<string>): string[] {\n    const set = source.manifest.blueprint!.screenSet ?? [];\n    if (set.length === 0) return [`${label} declares no ready-to-use screen set`];\n\n    const problems: string[] = [];\n    const names = new Set<string>();\n    for (const screen of set) {\n        if ((screen.name ?? '').trim() === '') {\n            problems.push(`${label} declares a screen set entry without a name`);\n            continue;\n        }\n\n        if (names.has(screen.name)) problems.push(`${label} declares screen '${screen.name}' more than once`);\n        names.add(screen.name);\n    }\n\n    for (const screen of set) {\n        if ((screen.name ?? '').trim() === '') continue;\n        const owner = `${label} screen '${screen.name}'`;\n        if ((screen.title ?? '').trim() === '') problems.push(`${owner} declares no title`);\n        if (screen.template !== undefined && !availableTemplates.has(screen.template)) problems.push(`${owner} uses template '${screen.template}', which is not available`);\n        if (screen.parent !== undefined && !names.has(screen.parent)) problems.push(`${owner} has parent '${screen.parent}', which is not in the screen set`);\n        if (source.screens !== undefined && !source.screens.some(candidate => candidate.name === screen.name)) problems.push(`${owner} is named in the screen set but the package does not provide it`);\n    }\n\n    for (const screen of set) {\n        if (screen.parent !== undefined && names.has(screen.parent) && isOwnAncestor(screen.name, set)) problems.push(`${label} screen '${screen.name}' is its own ancestor`);\n    }\n\n    return problems;\n}\n\nfunction isOwnAncestor(name: string, set: { name: string; parent?: string }[]): boolean {\n    const visited = new Set<string>();\n    for (let current = set.find(screen => screen.name === name)?.parent; current !== undefined; current = set.find(screen => screen.name === current)?.parent) {\n        if (current === name) return true;\n        if (visited.has(current)) return false;\n        visited.add(current);\n    }\n\n    return false;\n}\n\nfunction templateProblems(source: BlueprintSource, library: readonly TemplateSource[], domain: boolean): string[] {\n    const problems: string[] = [];\n    const described = [...(source.screenTemplates ?? []), ...(source.dialogTemplates ?? [])];\n    const everyTemplate: { name: string; displayName?: string; description?: string; metadata?: { type?: string; category?: string; thumbnail?: string }; describable: boolean }[] = [\n        ...(source.layouts ?? []).map(layout => ({ name: layout.name, metadata: layout.metadata, describable: false })),\n        ...described.map(template => ({ name: template.name, displayName: template.displayName, description: template.description, metadata: template.metadata, describable: true })),\n    ];\n\n    const others = library.filter(other => other.manifest.name !== source.manifest.name);\n    for (const entry of describeTemplateCatalog([source, ...others]).filter(candidate => candidate.package === source.manifest.name)) {\n        problems.push(...entry.problems);\n    }\n\n    for (const template of everyTemplate) {\n        const owner = `Template '${template.name}'`;\n        if (template.describable && (template.displayName ?? '').trim() === '') problems.push(`${owner} declares no display name`);\n        if (template.describable && (template.description ?? '').trim() === '') problems.push(`${owner} declares no description`);\n        if (!domain) continue;\n\n        const metadata = template.metadata;\n        if (metadata?.type === undefined) problems.push(`${owner} declares no type`);\n        else if (!blueprintTemplateTypes.includes(metadata.type)) problems.push(`${owner} declares type '${metadata.type}', which is not one of ${blueprintTemplateTypes.join(', ')}`);\n\n        if (metadata?.category !== undefined && metadata.category.trim() !== '' && !metadata.category.startsWith(businessCategoryPrefix)) {\n            problems.push(`${owner} declares category '${metadata.category}', which does not start with '${businessCategoryPrefix}'`);\n        }\n\n        problems.push(...thumbnailProblems(owner, metadata?.thumbnail, source.files));\n    }\n\n    return problems;\n}\n\nfunction placementProblems(source: BlueprintSource, library: readonly TemplateSource[], label: string, domain: boolean): string[] {\n    const own: ScreenTemplate[] = (source.screenTemplates ?? []).filter(template => template.fitsSlot !== undefined);\n    if (own.length === 0) return [];\n\n    const layouts = [...(source.layouts ?? []), ...library.flatMap(other => other.layouts ?? [])];\n    const everyTemplate = [...(source.screenTemplates ?? []), ...library.flatMap(other => other.screenTemplates ?? [])];\n    if (layouts.length === 0) return [`${label} has no layout to place its screen templates in`];\n\n    const resolutions = layouts.map(layout => ({ layout, resolution: resolveScreenTemplates(layout, everyTemplate) }));\n    const problems: string[] = [];\n\n    for (const template of own) {\n        if (resolutions.some(({ resolution }) => resolution.placements.some(placement => placement.template === template.name))) continue;\n\n        const unplacedEverywhere = resolutions.flatMap(({ resolution }) => resolution.unplaced.filter(candidate => candidate.template === template.name));\n        const unplaced = unplacedEverywhere.find(candidate => candidate.candidates.length > 1);\n        const cyclic = resolutions.some(({ resolution }) => resolution.cycles.some(cycle => cycle.includes(template.name)));\n        if (cyclic) problems.push(`Template '${template.name}' is nested inside itself`);\n        else if (unplaced && domain) problems.push(`Template '${template.name}' is ambiguous: slot '${unplaced.slot}' is declared by ${unplaced.candidates.join(', ')}`);\n        else if (!unplaced) problems.push(`Template '${template.name}' is unplaced: no layout or template declares slot '${template.fitsSlot}'`);\n    }\n\n    return problems;\n}\n"],"names":["verifyBlueprintPackage","source","library","options","manifest","name","label","foundation","foundationPackage","foundationPackageName","kind","PackageKind","Blueprint","problems","isValidVersion","version","push","blueprint","domain","undefined","available","Set","screenTemplates","flatMap","other","map","template","requireBlueprintMetadata","trim","isValidBlueprintDomain","description","length","maximumBlueprintDescriptionLength","thumbnailProblems","thumbnail","files","screenSetProblems","defaultSampleData","sampleData","some","reference","id","dependencies","dependency","validateSampleDataPackages","packs","includes","path","templateProblems","placementProblems","owner","isValidThumbnailPath","availableTemplates","set","screenSet","names","screen","has","add","title","parent","screens","candidate","isOwnAncestor","visited","current","find","described","dialogTemplates","everyTemplate","layouts","layout","metadata","describable","displayName","others","filter","entry","describeTemplateCatalog","package","type","blueprintTemplateTypes","join","category","startsWith","businessCategoryPrefix","own","fitsSlot","resolutions","resolution","resolveScreenTemplates","placements","placement","unplacedEverywhere","unplaced","candidates","cyclic","cycles","cycle","slot"],"mappings":"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"}

package/dist/cjs/index.js

@@ -51,6 +51,10 @@ var describeTemplateCatalog = require('./templates/describeTemplateCatalog.js');
 var resolveTemplateReference = require('./templates/resolveTemplateReference.js');
 var templateMetadataRules = require('./templates/templateMetadataRules.js');
 var validateTemplateMetadata = require('./templates/validateTemplateMetadata.js');
+var blueprintRules = require('./blueprints/blueprintRules.js');
+var verifyBlueprintPackage = require('./blueprints/verifyBlueprintPackage.js');
+var describeBlueprintCatalog = require('./blueprints/describeBlueprintCatalog.js');
+var evaluateBlueprintPin = require('./blueprints/evaluateBlueprintPin.js');
 var buildStarterProfile = require('./buildStarterProfile.js');
 var incompatibleStarterThemes = require('./incompatibleStarterThemes.js');
 var runActions = require('./runActions.js');
@@ -168,6 +172,7 @@ exports.applicableThemePackages = themeCompatibility.applicableThemePackages;
 exports.incompatiblePackages = themeCompatibility.incompatiblePackages;
 exports.isThemeCompatible = themeCompatibility.isThemeCompatible;
 exports.isPackageSelectionValid = PackageSelection.isPackageSelectionValid;
+exports.compareVersions = packageVersionRange.compareVersions;
 exports.isValidVersion = packageVersionRange.isValidVersion;
 exports.isValidVersionRange = packageVersionRange.isValidVersionRange;
 exports.isVersionSatisfiedBy = packageVersionRange.isVersionSatisfiedBy;
@@ -196,6 +201,18 @@ exports.isSpdxExpression = templateMetadataRules.isSpdxExpression;
 exports.templateCategoryMissingCode = validateTemplateMetadata.templateCategoryMissingCode;
 exports.validateTemplateCategory = validateTemplateMetadata.validateTemplateCategory;
 exports.validateTemplateMetadata = validateTemplateMetadata.validateTemplateMetadata;
+exports.blueprintTemplateTypes = blueprintRules.blueprintTemplateTypes;
+exports.businessCategoryPrefix = blueprintRules.businessCategoryPrefix;
+exports.foundationPackageName = blueprintRules.foundationPackageName;
+exports.isValidBlueprintDomain = blueprintRules.isValidBlueprintDomain;
+exports.isValidThumbnailPath = blueprintRules.isValidThumbnailPath;
+exports.maximumBlueprintDescriptionLength = blueprintRules.maximumBlueprintDescriptionLength;
+exports.verifyBlueprintPackage = verifyBlueprintPackage.verifyBlueprintPackage;
+exports.describeBlueprintCatalog = describeBlueprintCatalog.describeBlueprintCatalog;
+exports.toBlueprintCatalogFile = describeBlueprintCatalog.toBlueprintCatalogFile;
+exports.BlueprintPinStatus = evaluateBlueprintPin.BlueprintPinStatus;
+exports.defaultBlueprintPin = evaluateBlueprintPin.defaultBlueprintPin;
+exports.evaluateBlueprintPin = evaluateBlueprintPin.evaluateBlueprintPin;
 exports.buildStarterProfile = buildStarterProfile.buildStarterProfile;
 exports.incompatibleStarterThemes = incompatibleStarterThemes.incompatibleStarterThemes;
 exports.InteractionStop = runActions.InteractionStop;

package/dist/cjs/index.js.map

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

package/dist/cjs/packageVersionRange.js

@@ -56,6 +56,16 @@
  */ function isValidVersion(version) {
     return version !== undefined && version.trim().length > 0 && parseVersion(version) !== undefined;
 }
+/**
+ * Compares two versions as `major.minor.patch`, pre-release and build suffixes ignored: negative when the first is older, zero when equal,
+ * positive when it is newer. A value that is not a version compares as older than every version, and equal to another that is not.
+ */ function compareVersions(left, right) {
+    const first = parseVersion(left);
+    const second = parseVersion(right);
+    if (!first) return second ? -1 : 0;
+    if (!second) return 1;
+    return compare(first, second);
+}
 function splitRange(range) {
     for (const operator of [
         '>=',
@@ -123,6 +133,7 @@ function parseVersion(value) {
     return components;
 }
 
+exports.compareVersions = compareVersions;
 exports.isValidVersion = isValidVersion;
 exports.isValidVersionRange = isValidVersionRange;
 exports.isVersionSatisfiedBy = isVersionSatisfiedBy;

package/dist/cjs/packageVersionRange.js.map

@@ -1 +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\n/**\n * Whether a range is one {@link isVersionSatisfiedBy} understands. An empty range or `*` is valid and means\n * \"any version\"; anything the parser cannot read is invalid, so declarations can be rejected up front\n * instead of surfacing later as a conflict nobody can satisfy.\n */\nexport function isValidVersionRange(range: string | undefined): boolean {\n    const trimmed = range?.trim();\n    if (!trimmed || trimmed === '*') return true;\n    return parseVersion(splitRange(trimmed)[1]) !== undefined;\n}\n\n/**\n * Whether a value is a `major.minor.patch` version, optionally with a pre-release or build suffix.\n */\nexport function isValidVersion(version: string | undefined): boolean {\n    return version !== undefined && version.trim().length > 0 && parseVersion(version) !== undefined;\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","isValidVersionRange","undefined","isValidVersion","length","startsWith","substring","left","right","value","numeric","suffix","search","parts","split","components","index","test","parseInt"],"mappings":"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"}
+{"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\n/**\n * Whether a range is one {@link isVersionSatisfiedBy} understands. An empty range or `*` is valid and means\n * \"any version\"; anything the parser cannot read is invalid, so declarations can be rejected up front\n * instead of surfacing later as a conflict nobody can satisfy.\n */\nexport function isValidVersionRange(range: string | undefined): boolean {\n    const trimmed = range?.trim();\n    if (!trimmed || trimmed === '*') return true;\n    return parseVersion(splitRange(trimmed)[1]) !== undefined;\n}\n\n/**\n * Whether a value is a `major.minor.patch` version, optionally with a pre-release or build suffix.\n */\nexport function isValidVersion(version: string | undefined): boolean {\n    return version !== undefined && version.trim().length > 0 && parseVersion(version) !== undefined;\n}\n\n/**\n * Compares two versions as `major.minor.patch`, pre-release and build suffixes ignored: negative when the first is older, zero when equal,\n * positive when it is newer. A value that is not a version compares as older than every version, and equal to another that is not.\n */\nexport function compareVersions(left: string, right: string): number {\n    const first = parseVersion(left);\n    const second = parseVersion(right);\n    if (!first) return second ? -1 : 0;\n    if (!second) return 1;\n    return compare(first, second);\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","isValidVersionRange","undefined","isValidVersion","length","compareVersions","left","right","first","second","startsWith","substring","value","numeric","suffix","search","parts","split","components","index","test","parseInt"],"mappings":"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"}

package/dist/esm/blueprints/BlueprintCatalogEntry.d.ts

@@ -0,0 +1,46 @@
+export interface BlueprintCatalogScreen {
+    name: string;
+    title: string;
+    description?: string;
+    template?: string;
+    parent?: string;
+    order?: number;
+}
+export interface BlueprintCatalogTemplate {
+    name: string;
+    kind: string;
+    displayName?: string;
+    description?: string;
+    type?: string;
+    category?: string;
+    thumbnail?: string;
+}
+export interface BlueprintCatalogSampleData {
+    id: string;
+    title: string;
+    locale: string;
+    path: string;
+    default: boolean;
+}
+export interface BlueprintCatalogEntry {
+    package: string;
+    version: string;
+    domain: string;
+    displayName?: string;
+    description: string;
+    thumbnail: string;
+    license?: string;
+    licenseUrl?: string;
+    dependencies: {
+        name: string;
+        versionRange?: string;
+    }[];
+    screens: BlueprintCatalogScreen[];
+    templates: BlueprintCatalogTemplate[];
+    sampleData: BlueprintCatalogSampleData[];
+}
+export interface BlueprintCatalogFile {
+    schema: 1;
+    blueprints: BlueprintCatalogEntry[];
+}
+//# sourceMappingURL=BlueprintCatalogEntry.d.ts.map

package/dist/esm/blueprints/BlueprintCatalogEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintCatalogEntry.d.ts","sourceRoot":"","sources":["../../../blueprints/BlueprintCatalogEntry.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,0BAA0B;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB;AAMD,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC,UAAU,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAGD,MAAM,WAAW,oBAAoB;IAEjC,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACvC"}

package/dist/esm/blueprints/BlueprintCatalogEntry.js

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

package/dist/esm/blueprints/BlueprintCatalogEntry.js.map

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

package/dist/esm/blueprints/BlueprintSource.d.ts

@@ -0,0 +1,8 @@
+import { SampleDataPack, Screen } from '@cratis/scene.model';
+import { TemplateSource } from '../templates/TemplateSource';
+export interface BlueprintSource extends TemplateSource {
+    screens?: Screen[];
+    packs?: SampleDataPack[];
+    files?: string[];
+}
+//# sourceMappingURL=BlueprintSource.d.ts.map

package/dist/esm/blueprints/BlueprintSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlueprintSource.d.ts","sourceRoot":"","sources":["../../../blueprints/BlueprintSource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAO7D,MAAM,WAAW,eAAgB,SAAQ,cAAc;IAEnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAGnB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IAMzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/esm/blueprints/BlueprintSource.js

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

package/dist/esm/blueprints/BlueprintSource.js.map

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

package/dist/esm/blueprints/blueprintRules.d.ts

@@ -0,0 +1,7 @@
+export declare const foundationPackageName = "Cratis.Blueprint.Default";
+export declare const blueprintTemplateTypes: readonly string[];
+export declare const businessCategoryPrefix = "Business / ";
+export declare const maximumBlueprintDescriptionLength = 200;
+export declare const isValidBlueprintDomain: (domain: string | undefined) => boolean;
+export declare const isValidThumbnailPath: (path: string | undefined) => boolean;
+//# sourceMappingURL=blueprintRules.d.ts.map

package/dist/esm/blueprints/blueprintRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprintRules.d.ts","sourceRoot":"","sources":["../../../blueprints/blueprintRules.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAGhE,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAgH,CAAC;AAGrK,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAGpD,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAMrD,eAAO,MAAM,sBAAsB,WAAY,MAAM,GAAG,SAAS,KAAG,OAA6D,CAAC;AAGlI,eAAO,MAAM,oBAAoB,SAAU,MAAM,GAAG,SAAS,KAAG,OAA4D,CAAC"}

package/dist/esm/blueprints/blueprintRules.js

@@ -0,0 +1,25 @@
+// 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 provides the foundation layouts and templates every domain blueprint builds on. */ const foundationPackageName = 'Cratis.Blueprint.Default';
+/** The template types a domain blueprint may declare (Part B 1.2). */ const blueprintTemplateTypes = [
+    'Shell',
+    'Workspace',
+    'Dashboard',
+    'List',
+    'Board',
+    'Detail',
+    'Form',
+    'Wizard',
+    'Dialog',
+    'Auth',
+    'State'
+];
+/** The prefix every template category of a domain blueprint starts with; the rest is the domain. */ const businessCategoryPrefix = 'Business / ';
+/** The longest a blueprint description may be. */ const maximumBlueprintDescriptionLength = 200;
+const domainPattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+const thumbnailPattern = /^thumbnails\/[A-Za-z0-9][A-Za-z0-9._-]*\.(png|webp|jpg|svg)$/;
+/** Whether a value is a lower-case domain slug: `crm`, `project-tracker`. */ const isValidBlueprintDomain = (domain)=>domain !== undefined && domainPattern.test(domain);
+/** Whether a value is a package-relative thumbnail path: `thumbnails/<name>.png`, `.webp`, `.jpg` or `.svg`. */ const isValidThumbnailPath = (path)=>path !== undefined && thumbnailPattern.test(path);
+
+export { blueprintTemplateTypes, businessCategoryPrefix, foundationPackageName, isValidBlueprintDomain, isValidThumbnailPath, maximumBlueprintDescriptionLength };
+//# sourceMappingURL=blueprintRules.js.map