@cratis/scene.engine 4.23.0 → 4.25.0

package/dist/esm/templates/applicableTemplates.js

@@ -0,0 +1,194 @@
+import { TemplateScope, SliceKind, TemplateReferenceSource } from '@cratis/scene.model';
+import { resolveScreenTemplates } from '../resolveScreenTemplates.js';
+import { validateDialogTemplateApplicability, validateLayoutApplicability, validateScreenTemplateApplicability } from '../templateApplicability.js';
+import { TemplateCatalogKind } from './TemplateCatalogKind.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const screenScopes = [
+    TemplateScope.Module,
+    TemplateScope.Feature,
+    TemplateScope.Subfeature
+];
+const dialogSliceKinds = [
+    SliceKind.StateChange
+];
+const screenSliceKinds = [
+    SliceKind.StateChange,
+    SliceKind.StateView
+];
+/**
+ * Decides which templates a picker offers at a target, so no host re-implements the rules: own templates by
+ * category, then each blueprint that has at least one applicable template. A blueprint with none is omitted.
+ *
+ * It composes the applicability validators (kind and scope, explicit scopes override, category never implies a
+ * scope, slot fit against the container) and `resolveScreenTemplates` (a template must find exactly one home and
+ * nothing may nest inside itself) with the defaults of each hierarchy level, used when a template declares no scopes:
+ *
+ * - Application - layouts.
+ * - Module, Feature, Subfeature - screen templates, fitting a slot of the container.
+ * - Slice, state change - dialog templates.
+ * - Slice, state view - screen templates that declare the Slice scope or state view slice kinds.
+ *
+ * Declared `scopes` and `sliceKinds` always override the defaults. The C# engine (`ApplicableTemplates.Compute`)
+ * returns identical results; both are asserted against `template-applicability-fixtures.json`.
+ */ function applicableTemplates(library, target) {
+    const own = library.own ? groupByCategory(applicableIn(library.own, target, false)) : [];
+    const blueprints = [];
+    for (const source of library.blueprints){
+        const categories = groupByCategory(applicableIn(source, target, true));
+        if (categories.length > 0) {
+            blueprints.push({
+                blueprint: source.manifest.name,
+                version: source.manifest.version,
+                displayName: source.manifest.displayName,
+                categories
+            });
+        }
+    }
+    return {
+        own,
+        blueprints
+    };
+}
+/** Why a layout does not apply at a target; empty when it does. */ function validateLayoutForTarget(layout, target) {
+    return withDefaults(validateLayoutApplicability(layout, target.scope), layout.name, TemplateCatalogKind.Layout, layout.metadata, target);
+}
+/** Why a screen template does not apply at a target, including whether its slot nesting resolves; empty when it does. */ function validateScreenTemplateForTarget(template, target) {
+    const problems = withDefaults(validateScreenTemplateApplicability(template, target.scope, target.container), template.name, TemplateCatalogKind.ScreenTemplate, template.metadata, target);
+    if (problems.length > 0) return problems;
+    if (target.chain?.includes(template.name)) {
+        return [
+            `Template '${template.name}' is already chosen above this target; nesting it again would make the chain loop`
+        ];
+    }
+    if (template.fitsSlot !== undefined && target.container) {
+        const containerName = target.container.name;
+        const resolution = resolveScreenTemplates({
+            name: containerName,
+            slots: target.container.slots
+        }, [
+            template
+        ]);
+        const valid = resolution.unplaced.length === 0 && resolution.cycles.length === 0;
+        if (!valid || !resolution.placements.some((placement)=>placement.template === template.name && placement.container === containerName)) {
+            return [
+                `Template '${template.name}' cannot be placed in '${containerName}': its slot nesting does not resolve`
+            ];
+        }
+    }
+    return [];
+}
+/** Why a dialog template does not apply at a target; empty when it does. */ function validateDialogTemplateForTarget(template, target) {
+    return withDefaults(validateDialogTemplateApplicability(template, target.scope), template.name, TemplateCatalogKind.DialogTemplate, template.metadata, target);
+}
+function applicableIn(source, target, isBlueprint) {
+    const { manifest } = source;
+    const referenceTo = (name)=>isBlueprint ? {
+            source: TemplateReferenceSource.Blueprint,
+            id: name,
+            blueprint: manifest.name,
+            version: `^${manifest.version}`
+        } : {
+            source: TemplateReferenceSource.Own,
+            id: name
+        };
+    const applicable = [];
+    for (const layout of source.layouts ?? []){
+        if (validateLayoutForTarget(layout, target).length > 0) continue;
+        applicable.push({
+            package: manifest.name,
+            packageVersion: manifest.version,
+            kind: TemplateCatalogKind.Layout,
+            name: layout.name,
+            metadata: layout.metadata,
+            reference: referenceTo(layout.name)
+        });
+    }
+    for (const template of source.screenTemplates ?? []){
+        if (validateScreenTemplateForTarget(template, target).length > 0) continue;
+        applicable.push({
+            package: manifest.name,
+            packageVersion: manifest.version,
+            kind: TemplateCatalogKind.ScreenTemplate,
+            name: template.name,
+            displayName: template.displayName,
+            description: template.description,
+            metadata: template.metadata,
+            reference: referenceTo(template.name)
+        });
+    }
+    for (const template of source.dialogTemplates ?? []){
+        if (validateDialogTemplateForTarget(template, target).length > 0) continue;
+        applicable.push({
+            package: manifest.name,
+            packageVersion: manifest.version,
+            kind: TemplateCatalogKind.DialogTemplate,
+            name: template.name,
+            displayName: template.displayName,
+            description: template.description,
+            metadata: template.metadata,
+            reference: referenceTo(template.name)
+        });
+    }
+    return applicable;
+}
+function groupByCategory(templates) {
+    const categoryOf = (template)=>template.metadata?.category?.trim() ? template.metadata.category : undefined;
+    const categories = [
+        ...new Set(templates.map(categoryOf).filter((category)=>category !== undefined))
+    ];
+    const groups = categories.map((category)=>({
+            category,
+            templates: templates.filter((template)=>categoryOf(template) === category)
+        }));
+    const uncategorized = templates.filter((template)=>categoryOf(template) === undefined);
+    if (uncategorized.length > 0) groups.push({
+        templates: uncategorized
+    });
+    return groups;
+}
+function withDefaults(problems, name, kind, metadata, target) {
+    if (problems.length > 0 || !Object.values(TemplateScope).includes(target.scope)) return problems;
+    if (metadata?.scopes === undefined && !defaultScopes(kind, metadata).includes(target.scope)) {
+        return [
+            `Template '${name}' is not offered at scope '${target.scope}' unless it declares that scope`
+        ];
+    }
+    if (target.scope === TemplateScope.Slice && target.sliceKind !== undefined) {
+        const sliceKind = target.sliceKind;
+        if (!Object.values(SliceKind).includes(sliceKind)) return [
+            `Template '${name}' has unknown target slice kind '${sliceKind}'`
+        ];
+        if (sliceKind === SliceKind.Automation) return [
+            `Template '${name}' cannot be applied to an Automation slice, which has no presentation`
+        ];
+        const kinds = metadata?.sliceKinds ?? defaultSliceKinds(kind);
+        if (!kinds.includes(sliceKind)) return [
+            `Template '${name}' does not apply to slice kind '${sliceKind}'`
+        ];
+    }
+    return [];
+}
+function defaultScopes(kind, metadata) {
+    switch(kind){
+        case TemplateCatalogKind.Layout:
+            return [
+                TemplateScope.Application
+            ];
+        case TemplateCatalogKind.DialogTemplate:
+            return [
+                TemplateScope.Slice
+            ];
+        default:
+            return metadata?.sliceKinds === undefined ? screenScopes : [
+                TemplateScope.Slice
+            ];
+    }
+}
+function defaultSliceKinds(kind) {
+    return kind === TemplateCatalogKind.DialogTemplate ? dialogSliceKinds : screenSliceKinds;
+}
+
+export { applicableTemplates, validateDialogTemplateForTarget, validateLayoutForTarget, validateScreenTemplateForTarget };
+//# sourceMappingURL=applicableTemplates.js.map

package/dist/esm/templates/applicableTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applicableTemplates.js","sources":["../../../templates/applicableTemplates.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 { DialogTemplate, Layout, ScreenTemplate, TemplateMetadata, TemplateReference, TemplateReferenceSource, TemplateScope, SliceKind } from '@cratis/scene.model';\nimport { resolveScreenTemplates } from '../resolveScreenTemplates';\nimport { validateDialogTemplateApplicability, validateLayoutApplicability, validateScreenTemplateApplicability } from '../templateApplicability';\nimport { ApplicableBlueprint, ApplicableTemplate, ApplicableTemplateGroup, ApplicableTemplateSet } from './ApplicableTemplateSet';\nimport { TemplateCatalogKind } from './TemplateCatalogKind';\nimport { TemplateLibrary } from './TemplateLibrary';\nimport { TemplateSource } from './TemplateSource';\nimport { TemplateTarget } from './TemplateTarget';\n\nconst screenScopes = [TemplateScope.Module, TemplateScope.Feature, TemplateScope.Subfeature];\nconst dialogSliceKinds = [SliceKind.StateChange];\nconst screenSliceKinds = [SliceKind.StateChange, SliceKind.StateView];\n\n/**\n * Decides which templates a picker offers at a target, so no host re-implements the rules: own templates by\n * category, then each blueprint that has at least one applicable template. A blueprint with none is omitted.\n *\n * It composes the applicability validators (kind and scope, explicit scopes override, category never implies a\n * scope, slot fit against the container) and `resolveScreenTemplates` (a template must find exactly one home and\n * nothing may nest inside itself) with the defaults of each hierarchy level, used when a template declares no scopes:\n *\n * - Application - layouts.\n * - Module, Feature, Subfeature - screen templates, fitting a slot of the container.\n * - Slice, state change - dialog templates.\n * - Slice, state view - screen templates that declare the Slice scope or state view slice kinds.\n *\n * Declared `scopes` and `sliceKinds` always override the defaults. The C# engine (`ApplicableTemplates.Compute`)\n * returns identical results; both are asserted against `template-applicability-fixtures.json`.\n */\nexport function applicableTemplates(library: TemplateLibrary, target: TemplateTarget): ApplicableTemplateSet {\n    const own = library.own ? groupByCategory(applicableIn(library.own, target, false)) : [];\n    const blueprints: ApplicableBlueprint[] = [];\n    for (const source of library.blueprints) {\n        const categories = groupByCategory(applicableIn(source, target, true));\n        if (categories.length > 0) {\n            blueprints.push({ blueprint: source.manifest.name, version: source.manifest.version, displayName: source.manifest.displayName, categories });\n        }\n    }\n    return { own, blueprints };\n}\n\n/** Why a layout does not apply at a target; empty when it does. */\nexport function validateLayoutForTarget(layout: Layout, target: TemplateTarget): string[] {\n    return withDefaults(validateLayoutApplicability(layout, target.scope), layout.name, TemplateCatalogKind.Layout, layout.metadata, target);\n}\n\n/** Why a screen template does not apply at a target, including whether its slot nesting resolves; empty when it does. */\nexport function validateScreenTemplateForTarget(template: ScreenTemplate, target: TemplateTarget): string[] {\n    const problems = withDefaults(\n        validateScreenTemplateApplicability(template, target.scope, target.container),\n        template.name,\n        TemplateCatalogKind.ScreenTemplate,\n        template.metadata,\n        target,\n    );\n    if (problems.length > 0) return problems;\n\n    if (target.chain?.includes(template.name)) {\n        return [`Template '${template.name}' is already chosen above this target; nesting it again would make the chain loop`];\n    }\n\n    if (template.fitsSlot !== undefined && target.container) {\n        const containerName = target.container.name;\n        const resolution = resolveScreenTemplates({ name: containerName, slots: target.container.slots } as Layout, [template]);\n        const valid = resolution.unplaced.length === 0 && resolution.cycles.length === 0;\n        if (!valid || !resolution.placements.some(placement => placement.template === template.name && placement.container === containerName)) {\n            return [`Template '${template.name}' cannot be placed in '${containerName}': its slot nesting does not resolve`];\n        }\n    }\n    return [];\n}\n\n/** Why a dialog template does not apply at a target; empty when it does. */\nexport function validateDialogTemplateForTarget(template: DialogTemplate, target: TemplateTarget): string[] {\n    return withDefaults(validateDialogTemplateApplicability(template, target.scope), template.name, TemplateCatalogKind.DialogTemplate, template.metadata, target);\n}\n\nfunction applicableIn(source: TemplateSource, target: TemplateTarget, isBlueprint: boolean): ApplicableTemplate[] {\n    const { manifest } = source;\n    const referenceTo = (name: string): TemplateReference => isBlueprint\n        ? { source: TemplateReferenceSource.Blueprint, id: name, blueprint: manifest.name, version: `^${manifest.version}` }\n        : { source: TemplateReferenceSource.Own, id: name };\n\n    const applicable: ApplicableTemplate[] = [];\n    for (const layout of source.layouts ?? []) {\n        if (validateLayoutForTarget(layout, target).length > 0) continue;\n        applicable.push({\n            package: manifest.name, packageVersion: manifest.version, kind: TemplateCatalogKind.Layout, name: layout.name,\n            metadata: layout.metadata, reference: referenceTo(layout.name),\n        });\n    }\n    for (const template of source.screenTemplates ?? []) {\n        if (validateScreenTemplateForTarget(template, target).length > 0) continue;\n        applicable.push({\n            package: manifest.name, packageVersion: manifest.version, kind: TemplateCatalogKind.ScreenTemplate, name: template.name,\n            displayName: template.displayName, description: template.description, metadata: template.metadata, reference: referenceTo(template.name),\n        });\n    }\n    for (const template of source.dialogTemplates ?? []) {\n        if (validateDialogTemplateForTarget(template, target).length > 0) continue;\n        applicable.push({\n            package: manifest.name, packageVersion: manifest.version, kind: TemplateCatalogKind.DialogTemplate, name: template.name,\n            displayName: template.displayName, description: template.description, metadata: template.metadata, reference: referenceTo(template.name),\n        });\n    }\n    return applicable;\n}\n\nfunction groupByCategory(templates: ApplicableTemplate[]): ApplicableTemplateGroup[] {\n    const categoryOf = (template: ApplicableTemplate) => template.metadata?.category?.trim() ? template.metadata.category : undefined;\n    const categories = [...new Set(templates.map(categoryOf).filter((category): category is string => category !== undefined))];\n    const groups: ApplicableTemplateGroup[] = categories.map(category => ({ category, templates: templates.filter(template => categoryOf(template) === category) }));\n    const uncategorized = templates.filter(template => categoryOf(template) === undefined);\n    if (uncategorized.length > 0) groups.push({ templates: uncategorized });\n    return groups;\n}\n\nfunction withDefaults(problems: string[], name: string, kind: TemplateCatalogKind, metadata: TemplateMetadata | undefined, target: TemplateTarget): string[] {\n    if (problems.length > 0 || !Object.values(TemplateScope).includes(target.scope)) return problems;\n\n    if (metadata?.scopes === undefined && !defaultScopes(kind, metadata).includes(target.scope)) {\n        return [`Template '${name}' is not offered at scope '${target.scope}' unless it declares that scope`];\n    }\n\n    if (target.scope === TemplateScope.Slice && target.sliceKind !== undefined) {\n        const sliceKind = target.sliceKind;\n        if (!Object.values(SliceKind).includes(sliceKind)) return [`Template '${name}' has unknown target slice kind '${sliceKind}'`];\n        if (sliceKind === SliceKind.Automation) return [`Template '${name}' cannot be applied to an Automation slice, which has no presentation`];\n        const kinds = metadata?.sliceKinds ?? defaultSliceKinds(kind);\n        if (!kinds.includes(sliceKind)) return [`Template '${name}' does not apply to slice kind '${sliceKind}'`];\n    }\n    return [];\n}\n\nfunction defaultScopes(kind: TemplateCatalogKind, metadata: TemplateMetadata | undefined): TemplateScope[] {\n    switch (kind) {\n        case TemplateCatalogKind.Layout: return [TemplateScope.Application];\n        case TemplateCatalogKind.DialogTemplate: return [TemplateScope.Slice];\n        default: return metadata?.sliceKinds === undefined ? screenScopes : [TemplateScope.Slice];\n    }\n}\n\nfunction defaultSliceKinds(kind: TemplateCatalogKind): SliceKind[] {\n    return kind === TemplateCatalogKind.DialogTemplate ? dialogSliceKinds : screenSliceKinds;\n}\n"],"names":["screenScopes","TemplateScope","Module","Feature","Subfeature","dialogSliceKinds","SliceKind","StateChange","screenSliceKinds","StateView","applicableTemplates","library","target","own","groupByCategory","applicableIn","blueprints","source","categories","length","push","blueprint","manifest","name","version","displayName","validateLayoutForTarget","layout","withDefaults","validateLayoutApplicability","scope","TemplateCatalogKind","Layout","metadata","validateScreenTemplateForTarget","template","problems","validateScreenTemplateApplicability","container","ScreenTemplate","chain","includes","fitsSlot","undefined","containerName","resolution","resolveScreenTemplates","slots","valid","unplaced","cycles","placements","some","placement","validateDialogTemplateForTarget","validateDialogTemplateApplicability","DialogTemplate","isBlueprint","referenceTo","TemplateReferenceSource","Blueprint","id","Own","applicable","layouts","package","packageVersion","kind","reference","screenTemplates","description","dialogTemplates","templates","categoryOf","category","trim","Set","map","filter","groups","uncategorized","Object","values","scopes","defaultScopes","Slice","sliceKind","Automation","kinds","sliceKinds","defaultSliceKinds","Application"],"mappings":";;;;;AAAA;AACA;AAWA,MAAMA,YAAAA,GAAe;AAACC,IAAAA,aAAAA,CAAcC,MAAM;AAAED,IAAAA,aAAAA,CAAcE,OAAO;AAAEF,IAAAA,aAAAA,CAAcG;AAAW,CAAA;AAC5F,MAAMC,gBAAAA,GAAmB;AAACC,IAAAA,SAAAA,CAAUC;AAAY,CAAA;AAChD,MAAMC,gBAAAA,GAAmB;AAACF,IAAAA,SAAAA,CAAUC,WAAW;AAAED,IAAAA,SAAAA,CAAUG;AAAU,CAAA;AAErE;;;;;;;;;;;;;;;AAeC,IACM,SAASC,mBAAAA,CAAoBC,OAAwB,EAAEC,MAAsB,EAAA;IAChF,MAAMC,GAAAA,GAAMF,OAAAA,CAAQE,GAAG,GAAGC,eAAAA,CAAgBC,YAAAA,CAAaJ,OAAAA,CAAQE,GAAG,EAAED,MAAAA,EAAQ,KAAA,CAAA,CAAA,GAAU,EAAE;AACxF,IAAA,MAAMI,aAAoC,EAAE;AAC5C,IAAA,KAAK,MAAMC,MAAAA,IAAUN,OAAAA,CAAQK,UAAU,CAAE;AACrC,QAAA,MAAME,UAAAA,GAAaJ,eAAAA,CAAgBC,YAAAA,CAAaE,MAAAA,EAAQL,MAAAA,EAAQ,IAAA,CAAA,CAAA;QAChE,IAAIM,UAAAA,CAAWC,MAAM,GAAG,CAAA,EAAG;AACvBH,YAAAA,UAAAA,CAAWI,IAAI,CAAC;gBAAEC,SAAAA,EAAWJ,MAAAA,CAAOK,QAAQ,CAACC,IAAI;gBAAEC,OAAAA,EAASP,MAAAA,CAAOK,QAAQ,CAACE,OAAO;gBAAEC,WAAAA,EAAaR,MAAAA,CAAOK,QAAQ,CAACG,WAAW;AAAEP,gBAAAA;AAAW,aAAA,CAAA;AAC9I,QAAA;AACJ,IAAA;IACA,OAAO;AAAEL,QAAAA,GAAAA;AAAKG,QAAAA;AAAW,KAAA;AAC7B;AAEA,oEACO,SAASU,uBAAAA,CAAwBC,MAAc,EAAEf,MAAsB,EAAA;AAC1E,IAAA,OAAOgB,YAAAA,CAAaC,2BAAAA,CAA4BF,MAAAA,EAAQf,MAAAA,CAAOkB,KAAK,CAAA,EAAGH,MAAAA,CAAOJ,IAAI,EAAEQ,mBAAAA,CAAoBC,MAAM,EAAEL,MAAAA,CAAOM,QAAQ,EAAErB,MAAAA,CAAAA;AACrI;AAEA,0HACO,SAASsB,+BAAAA,CAAgCC,QAAwB,EAAEvB,MAAsB,EAAA;AAC5F,IAAA,MAAMwB,WAAWR,YAAAA,CACbS,mCAAAA,CAAoCF,UAAUvB,MAAAA,CAAOkB,KAAK,EAAElB,MAAAA,CAAO0B,SAAS,CAAA,EAC5EH,QAAAA,CAASZ,IAAI,EACbQ,mBAAAA,CAAoBQ,cAAc,EAClCJ,QAAAA,CAASF,QAAQ,EACjBrB,MAAAA,CAAAA;AAEJ,IAAA,IAAIwB,QAAAA,CAASjB,MAAM,GAAG,CAAA,EAAG,OAAOiB,QAAAA;AAEhC,IAAA,IAAIxB,OAAO4B,KAAK,EAAEC,QAAAA,CAASN,QAAAA,CAASZ,IAAI,CAAA,EAAG;QACvC,OAAO;AAAC,YAAA,CAAC,UAAU,EAAEY,QAAAA,CAASZ,IAAI,CAAC,iFAAiF;AAAE,SAAA;AAC1H,IAAA;AAEA,IAAA,IAAIY,SAASO,QAAQ,KAAKC,SAAAA,IAAa/B,MAAAA,CAAO0B,SAAS,EAAE;AACrD,QAAA,MAAMM,aAAAA,GAAgBhC,MAAAA,CAAO0B,SAAS,CAACf,IAAI;AAC3C,QAAA,MAAMsB,aAAaC,sBAAAA,CAAuB;YAAEvB,IAAAA,EAAMqB,aAAAA;YAAeG,KAAAA,EAAOnC,MAAAA,CAAO0B,SAAS,CAACS;SAAM,EAAa;AAACZ,YAAAA;AAAS,SAAA,CAAA;QACtH,MAAMa,KAAAA,GAAQH,UAAAA,CAAWI,QAAQ,CAAC9B,MAAM,KAAK,CAAA,IAAK0B,UAAAA,CAAWK,MAAM,CAAC/B,MAAM,KAAK,CAAA;AAC/E,QAAA,IAAI,CAAC6B,KAAAA,IAAS,CAACH,WAAWM,UAAU,CAACC,IAAI,CAACC,CAAAA,YAAaA,SAAAA,CAAUlB,QAAQ,KAAKA,QAAAA,CAASZ,IAAI,IAAI8B,SAAAA,CAAUf,SAAS,KAAKM,aAAAA,CAAAA,EAAgB;YACnI,OAAO;gBAAC,CAAC,UAAU,EAAET,QAAAA,CAASZ,IAAI,CAAC,uBAAuB,EAAEqB,aAAAA,CAAc,oCAAoC;AAAE,aAAA;AACpH,QAAA;AACJ,IAAA;AACA,IAAA,OAAO,EAAE;AACb;AAEA,6EACO,SAASU,+BAAAA,CAAgCnB,QAAwB,EAAEvB,MAAsB,EAAA;AAC5F,IAAA,OAAOgB,YAAAA,CAAa2B,mCAAAA,CAAoCpB,QAAAA,EAAUvB,MAAAA,CAAOkB,KAAK,CAAA,EAAGK,QAAAA,CAASZ,IAAI,EAAEQ,mBAAAA,CAAoByB,cAAc,EAAErB,QAAAA,CAASF,QAAQ,EAAErB,MAAAA,CAAAA;AAC3J;AAEA,SAASG,YAAAA,CAAaE,MAAsB,EAAEL,MAAsB,EAAE6C,WAAoB,EAAA;IACtF,MAAM,EAAEnC,QAAQ,EAAE,GAAGL,MAAAA;IACrB,MAAMyC,WAAAA,GAAc,CAACnC,IAAAA,GAAoCkC,WAAAA,GACnD;AAAExC,YAAAA,MAAAA,EAAQ0C,wBAAwBC,SAAS;YAAEC,EAAAA,EAAItC,IAAAA;AAAMF,YAAAA,SAAAA,EAAWC,SAASC,IAAI;AAAEC,YAAAA,OAAAA,EAAS,CAAC,CAAC,EAAEF,QAAAA,CAASE,OAAO,CAAA;SAAG,GACjH;AAAEP,YAAAA,MAAAA,EAAQ0C,wBAAwBG,GAAG;YAAED,EAAAA,EAAItC;AAAK,SAAA;AAEtD,IAAA,MAAMwC,aAAmC,EAAE;AAC3C,IAAA,KAAK,MAAMpC,MAAAA,IAAUV,MAAAA,CAAO+C,OAAO,IAAI,EAAE,CAAE;AACvC,QAAA,IAAItC,uBAAAA,CAAwBC,MAAAA,EAAQf,MAAAA,CAAAA,CAAQO,MAAM,GAAG,CAAA,EAAG;AACxD4C,QAAAA,UAAAA,CAAW3C,IAAI,CAAC;AACZ6C,YAAAA,OAAAA,EAAS3C,SAASC,IAAI;AAAE2C,YAAAA,cAAAA,EAAgB5C,SAASE,OAAO;AAAE2C,YAAAA,IAAAA,EAAMpC,oBAAoBC,MAAM;AAAET,YAAAA,IAAAA,EAAMI,OAAOJ,IAAI;AAC7GU,YAAAA,QAAAA,EAAUN,OAAOM,QAAQ;YAAEmC,SAAAA,EAAWV,WAAAA,CAAY/B,OAAOJ,IAAI;AACjE,SAAA,CAAA;AACJ,IAAA;AACA,IAAA,KAAK,MAAMY,QAAAA,IAAYlB,MAAAA,CAAOoD,eAAe,IAAI,EAAE,CAAE;AACjD,QAAA,IAAInC,+BAAAA,CAAgCC,QAAAA,EAAUvB,MAAAA,CAAAA,CAAQO,MAAM,GAAG,CAAA,EAAG;AAClE4C,QAAAA,UAAAA,CAAW3C,IAAI,CAAC;AACZ6C,YAAAA,OAAAA,EAAS3C,SAASC,IAAI;AAAE2C,YAAAA,cAAAA,EAAgB5C,SAASE,OAAO;AAAE2C,YAAAA,IAAAA,EAAMpC,oBAAoBQ,cAAc;AAAEhB,YAAAA,IAAAA,EAAMY,SAASZ,IAAI;AACvHE,YAAAA,WAAAA,EAAaU,SAASV,WAAW;AAAE6C,YAAAA,WAAAA,EAAanC,SAASmC,WAAW;AAAErC,YAAAA,QAAAA,EAAUE,SAASF,QAAQ;YAAEmC,SAAAA,EAAWV,WAAAA,CAAYvB,SAASZ,IAAI;AAC3I,SAAA,CAAA;AACJ,IAAA;AACA,IAAA,KAAK,MAAMY,QAAAA,IAAYlB,MAAAA,CAAOsD,eAAe,IAAI,EAAE,CAAE;AACjD,QAAA,IAAIjB,+BAAAA,CAAgCnB,QAAAA,EAAUvB,MAAAA,CAAAA,CAAQO,MAAM,GAAG,CAAA,EAAG;AAClE4C,QAAAA,UAAAA,CAAW3C,IAAI,CAAC;AACZ6C,YAAAA,OAAAA,EAAS3C,SAASC,IAAI;AAAE2C,YAAAA,cAAAA,EAAgB5C,SAASE,OAAO;AAAE2C,YAAAA,IAAAA,EAAMpC,oBAAoByB,cAAc;AAAEjC,YAAAA,IAAAA,EAAMY,SAASZ,IAAI;AACvHE,YAAAA,WAAAA,EAAaU,SAASV,WAAW;AAAE6C,YAAAA,WAAAA,EAAanC,SAASmC,WAAW;AAAErC,YAAAA,QAAAA,EAAUE,SAASF,QAAQ;YAAEmC,SAAAA,EAAWV,WAAAA,CAAYvB,SAASZ,IAAI;AAC3I,SAAA,CAAA;AACJ,IAAA;IACA,OAAOwC,UAAAA;AACX;AAEA,SAASjD,gBAAgB0D,SAA+B,EAAA;AACpD,IAAA,MAAMC,UAAAA,GAAa,CAACtC,QAAAA,GAAiCA,QAAAA,CAASF,QAAQ,EAAEyC,QAAAA,EAAUC,IAAAA,EAAAA,GAASxC,QAAAA,CAASF,QAAQ,CAACyC,QAAQ,GAAG/B,SAAAA;AACxH,IAAA,MAAMzB,UAAAA,GAAa;WAAI,IAAI0D,GAAAA,CAAIJ,UAAUK,GAAG,CAACJ,YAAYK,MAAM,CAAC,CAACJ,QAAAA,GAAiCA,QAAAA,KAAa/B,SAAAA,CAAAA;AAAY,KAAA;AAC3H,IAAA,MAAMoC,SAAoC7D,UAAAA,CAAW2D,GAAG,CAACH,CAAAA,YAAa;AAAEA,YAAAA,QAAAA;AAAUF,YAAAA,SAAAA,EAAWA,UAAUM,MAAM,CAAC3C,CAAAA,QAAAA,GAAYsC,WAAWtC,QAAAA,CAAAA,KAAcuC,QAAAA;SAAU,CAAA,CAAA;AAC7J,IAAA,MAAMM,gBAAgBR,SAAAA,CAAUM,MAAM,CAAC3C,CAAAA,QAAAA,GAAYsC,WAAWtC,QAAAA,CAAAA,KAAcQ,SAAAA,CAAAA;AAC5E,IAAA,IAAIqC,cAAc7D,MAAM,GAAG,CAAA,EAAG4D,MAAAA,CAAO3D,IAAI,CAAC;QAAEoD,SAAAA,EAAWQ;AAAc,KAAA,CAAA;IACrE,OAAOD,MAAAA;AACX;AAEA,SAASnD,YAAAA,CAAaQ,QAAkB,EAAEb,IAAY,EAAE4C,IAAyB,EAAElC,QAAsC,EAAErB,MAAsB,EAAA;AAC7I,IAAA,IAAIwB,QAAAA,CAASjB,MAAM,GAAG,CAAA,IAAK,CAAC8D,MAAAA,CAAOC,MAAM,CAACjF,aAAAA,CAAAA,CAAewC,QAAQ,CAAC7B,MAAAA,CAAOkB,KAAK,GAAG,OAAOM,QAAAA;IAExF,IAAIH,QAAAA,EAAUkD,MAAAA,KAAWxC,SAAAA,IAAa,CAACyC,aAAAA,CAAcjB,IAAAA,EAAMlC,QAAAA,CAAAA,CAAUQ,QAAQ,CAAC7B,MAAAA,CAAOkB,KAAK,CAAA,EAAG;QACzF,OAAO;YAAC,CAAC,UAAU,EAAEP,IAAAA,CAAK,2BAA2B,EAAEX,MAAAA,CAAOkB,KAAK,CAAC,+BAA+B;AAAE,SAAA;AACzG,IAAA;IAEA,IAAIlB,MAAAA,CAAOkB,KAAK,KAAK7B,aAAAA,CAAcoF,KAAK,IAAIzE,MAAAA,CAAO0E,SAAS,KAAK3C,SAAAA,EAAW;QACxE,MAAM2C,SAAAA,GAAY1E,OAAO0E,SAAS;QAClC,IAAI,CAACL,OAAOC,MAAM,CAAC5E,WAAWmC,QAAQ,CAAC6C,YAAY,OAAO;AAAC,YAAA,CAAC,UAAU,EAAE/D,IAAAA,CAAK,iCAAiC,EAAE+D,SAAAA,CAAU,CAAC;AAAE,SAAA;AAC7H,QAAA,IAAIA,SAAAA,KAAchF,SAAAA,CAAUiF,UAAU,EAAE,OAAO;AAAC,YAAA,CAAC,UAAU,EAAEhE,IAAAA,CAAK,qEAAqE;AAAE,SAAA;QACzI,MAAMiE,KAAAA,GAAQvD,QAAAA,EAAUwD,UAAAA,IAAcC,iBAAAA,CAAkBvB,IAAAA,CAAAA;AACxD,QAAA,IAAI,CAACqB,KAAAA,CAAM/C,QAAQ,CAAC6C,YAAY,OAAO;AAAC,YAAA,CAAC,UAAU,EAAE/D,IAAAA,CAAK,gCAAgC,EAAE+D,SAAAA,CAAU,CAAC;AAAE,SAAA;AAC7G,IAAA;AACA,IAAA,OAAO,EAAE;AACb;AAEA,SAASF,aAAAA,CAAcjB,IAAyB,EAAElC,QAAsC,EAAA;IACpF,OAAQkC,IAAAA;AACJ,QAAA,KAAKpC,oBAAoBC,MAAM;YAAE,OAAO;AAAC/B,gBAAAA,aAAAA,CAAc0F;AAAY,aAAA;AACnE,QAAA,KAAK5D,oBAAoByB,cAAc;YAAE,OAAO;AAACvD,gBAAAA,aAAAA,CAAcoF;AAAM,aAAA;AACrE,QAAA;YAAS,OAAOpD,QAAAA,EAAUwD,UAAAA,KAAe9C,SAAAA,GAAY3C,YAAAA,GAAe;AAACC,gBAAAA,aAAAA,CAAcoF;AAAM,aAAA;AAC7F;AACJ;AAEA,SAASK,kBAAkBvB,IAAyB,EAAA;AAChD,IAAA,OAAOA,IAAAA,KAASpC,mBAAAA,CAAoByB,cAAc,GAAGnD,gBAAAA,GAAmBG,gBAAAA;AAC5E;;"}

package/dist/esm/templates/describeTemplateCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"describeTemplateCatalog.d.ts","sourceRoot":"","sources":["../../../templates/describeTemplateCatalog.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAwChH"}
+{"version":3,"file":"describeTemplateCatalog.d.ts","sourceRoot":"","sources":["../../../templates/describeTemplateCatalog.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAalD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA2ChH"}

package/dist/esm/templates/describeTemplateCatalog.js

@@ -1,6 +1,7 @@
+import { PackageKind } from '@cratis/scene.model';
 import { isVersionSatisfiedBy } from '../packageVersionRange.js';
 import { TemplateCatalogKind } from './TemplateCatalogKind.js';
-import { validateTemplateMetadata } from './validateTemplateMetadata.js';
+import { validateTemplateMetadata, validateTemplateCategory } from './validateTemplateMetadata.js';
 
 // Copyright (c) Cratis. All rights reserved.
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
@@ -10,7 +11,8 @@ import { validateTemplateMetadata } from './validateTemplateMetadata.js';
  *
  * A template is compatible when its metadata is complete and valid, the Scene version (when given) satisfies
  * its Scene range, and every package it requires is among the given packages at a satisfying version and is
- * either its own package or one that package depends on. Nothing is filtered out: a browser shows incompatible
+ * either its own package or one that package depends on. A blueprint template without a category is a problem; an
+ * own template without one is a warning. Nothing is filtered out: a browser shows incompatible
  * templates with their problems rather than hiding why they are unavailable.
  */ function describeTemplateCatalog(sources, sceneVersion) {
     const versions = new Map(sources.map((source)=>[
@@ -36,10 +38,11 @@ import { validateTemplateMetadata } from './validateTemplateMetadata.js';
         for (const { kind, template } of templates){
             const metadata = template.metadata;
             const describable = template;
-            const problems = [
-                ...validateTemplateMetadata(template.name, metadata),
-                ...requirementProblems(template.name, metadata, source.manifest, versions, sceneVersion)
-            ];
+            const problems = validateTemplateMetadata(template.name, metadata);
+            const warnings = [];
+            const missingCategory = validateTemplateCategory(template.name, metadata);
+            if (missingCategory) (source.manifest.kind === PackageKind.Blueprint ? problems : warnings).push(missingCategory);
+            problems.push(...requirementProblems(template.name, metadata, source.manifest, versions, sceneVersion));
             entries.push({
                 package: source.manifest.name,
                 packageVersion: source.manifest.version,
@@ -50,12 +53,14 @@ import { validateTemplateMetadata } from './validateTemplateMetadata.js';
                 type: metadata?.type,
                 category: metadata?.category,
                 scopes: metadata?.scopes,
+                sliceKinds: metadata?.sliceKinds,
                 compatibility: metadata?.compatibility,
                 attribution: metadata?.attribution,
                 license: metadata?.license,
                 licenseUrl: metadata?.licenseUrl,
                 compatible: problems.length === 0,
-                problems
+                problems,
+                warnings
             });
         }
     }

package/dist/esm/templates/describeTemplateCatalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"describeTemplateCatalog.js","sources":["../../../templates/describeTemplateCatalog.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, TemplateMetadata } from '@cratis/scene.model';\nimport { isVersionSatisfiedBy } from '../packageVersionRange';\nimport { TemplateCatalogEntry } from './TemplateCatalogEntry';\nimport { TemplateCatalogKind } from './TemplateCatalogKind';\nimport { TemplateSource } from './TemplateSource';\nimport { validateTemplateMetadata } from './validateTemplateMetadata';\n\n/**\n * Describes every template the given packages provide, in package then layout, screen template, dialog\n * template order, with its compatibility, attribution and license metadata and whether it can be used.\n *\n * A template is compatible when its metadata is complete and valid, the Scene version (when given) satisfies\n * its Scene range, and every package it requires is among the given packages at a satisfying version and is\n * either its own package or one that package depends on. Nothing is filtered out: a browser shows incompatible\n * templates with their problems rather than hiding why they are unavailable.\n */\nexport function describeTemplateCatalog(sources: TemplateSource[], sceneVersion?: string): TemplateCatalogEntry[] {\n    const versions = new Map(sources.map(source => [source.manifest.name, source.manifest.version]));\n    const entries: TemplateCatalogEntry[] = [];\n\n    for (const source of sources) {\n        const templates = [\n            ...(source.layouts ?? []).map(template => ({ kind: TemplateCatalogKind.Layout, template })),\n            ...(source.screenTemplates ?? []).map(template => ({ kind: TemplateCatalogKind.ScreenTemplate, template })),\n            ...(source.dialogTemplates ?? []).map(template => ({ kind: TemplateCatalogKind.DialogTemplate, template })),\n        ];\n\n        for (const { kind, template } of templates) {\n            const metadata = template.metadata;\n            const describable = template as { displayName?: string; description?: string };\n            const problems = [\n                ...validateTemplateMetadata(template.name, metadata),\n                ...requirementProblems(template.name, metadata, source.manifest, versions, sceneVersion),\n            ];\n\n            entries.push({\n                package: source.manifest.name,\n                packageVersion: source.manifest.version,\n                kind,\n                name: template.name,\n                displayName: describable.displayName,\n                description: describable.description,\n                type: metadata?.type,\n                category: metadata?.category,\n                scopes: metadata?.scopes,\n                compatibility: metadata?.compatibility,\n                attribution: metadata?.attribution,\n                license: metadata?.license,\n                licenseUrl: metadata?.licenseUrl,\n                compatible: problems.length === 0,\n                problems,\n            });\n        }\n    }\n\n    return entries;\n}\n\nfunction requirementProblems(\n    name: string,\n    metadata: TemplateMetadata | undefined,\n    owner: ScenePackage,\n    versions: Map<string, string>,\n    sceneVersion: string | undefined,\n): string[] {\n    const problems: string[] = [];\n    const compatibility = metadata?.compatibility;\n    if (!compatibility) return problems;\n\n    if (sceneVersion !== undefined && compatibility.scene?.trim() && !isVersionSatisfiedBy(sceneVersion, compatibility.scene)) {\n        problems.push(`Template '${name}' requires Scene ${compatibility.scene} but the host runs ${sceneVersion}`);\n    }\n\n    for (const requirement of compatibility.packages ?? []) {\n        if (!requirement.name?.trim()) continue;\n        if (requirement.name !== owner.name && !owner.dependencies.some(dependency => dependency.name === requirement.name)) {\n            problems.push(`Template '${name}' requires package '${requirement.name}', which its package '${owner.name}' does not depend on`);\n        }\n\n        const version = versions.get(requirement.name);\n        if (version === undefined) {\n            problems.push(`Template '${name}' requires package '${requirement.name}', which is not available`);\n        } else if (!isVersionSatisfiedBy(version, requirement.versionRange)) {\n            problems.push(`Template '${name}' requires package '${requirement.name}' ${requirement.versionRange} but version ${version} is available`);\n        }\n    }\n\n    return problems;\n}\n"],"names":["describeTemplateCatalog","sources","sceneVersion","versions","Map","map","source","manifest","name","version","entries","templates","layouts","template","kind","TemplateCatalogKind","Layout","screenTemplates","ScreenTemplate","dialogTemplates","DialogTemplate","metadata","describable","problems","validateTemplateMetadata","requirementProblems","push","package","packageVersion","displayName","description","type","category","scopes","compatibility","attribution","license","licenseUrl","compatible","length","owner","undefined","scene","trim","isVersionSatisfiedBy","requirement","packages","dependencies","some","dependency","get","versionRange"],"mappings":"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"}
+{"version":3,"file":"describeTemplateCatalog.js","sources":["../../../templates/describeTemplateCatalog.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, TemplateMetadata } from '@cratis/scene.model';\nimport { isVersionSatisfiedBy } from '../packageVersionRange';\nimport { TemplateCatalogEntry } from './TemplateCatalogEntry';\nimport { TemplateCatalogKind } from './TemplateCatalogKind';\nimport { TemplateSource } from './TemplateSource';\nimport { validateTemplateCategory, validateTemplateMetadata } from './validateTemplateMetadata';\n\n/**\n * Describes every template the given packages provide, in package then layout, screen template, dialog\n * template order, with its compatibility, attribution and license metadata and whether it can be used.\n *\n * A template is compatible when its metadata is complete and valid, the Scene version (when given) satisfies\n * its Scene range, and every package it requires is among the given packages at a satisfying version and is\n * either its own package or one that package depends on. A blueprint template without a category is a problem; an\n * own template without one is a warning. Nothing is filtered out: a browser shows incompatible\n * templates with their problems rather than hiding why they are unavailable.\n */\nexport function describeTemplateCatalog(sources: TemplateSource[], sceneVersion?: string): TemplateCatalogEntry[] {\n    const versions = new Map(sources.map(source => [source.manifest.name, source.manifest.version]));\n    const entries: TemplateCatalogEntry[] = [];\n\n    for (const source of sources) {\n        const templates = [\n            ...(source.layouts ?? []).map(template => ({ kind: TemplateCatalogKind.Layout, template })),\n            ...(source.screenTemplates ?? []).map(template => ({ kind: TemplateCatalogKind.ScreenTemplate, template })),\n            ...(source.dialogTemplates ?? []).map(template => ({ kind: TemplateCatalogKind.DialogTemplate, template })),\n        ];\n\n        for (const { kind, template } of templates) {\n            const metadata = template.metadata;\n            const describable = template as { displayName?: string; description?: string };\n            const problems = validateTemplateMetadata(template.name, metadata);\n            const warnings: string[] = [];\n            const missingCategory = validateTemplateCategory(template.name, metadata);\n            if (missingCategory) (source.manifest.kind === PackageKind.Blueprint ? problems : warnings).push(missingCategory);\n            problems.push(...requirementProblems(template.name, metadata, source.manifest, versions, sceneVersion));\n\n            entries.push({\n                package: source.manifest.name,\n                packageVersion: source.manifest.version,\n                kind,\n                name: template.name,\n                displayName: describable.displayName,\n                description: describable.description,\n                type: metadata?.type,\n                category: metadata?.category,\n                scopes: metadata?.scopes,\n                sliceKinds: metadata?.sliceKinds,\n                compatibility: metadata?.compatibility,\n                attribution: metadata?.attribution,\n                license: metadata?.license,\n                licenseUrl: metadata?.licenseUrl,\n                compatible: problems.length === 0,\n                problems,\n                warnings,\n            });\n        }\n    }\n\n    return entries;\n}\n\nfunction requirementProblems(\n    name: string,\n    metadata: TemplateMetadata | undefined,\n    owner: ScenePackage,\n    versions: Map<string, string>,\n    sceneVersion: string | undefined,\n): string[] {\n    const problems: string[] = [];\n    const compatibility = metadata?.compatibility;\n    if (!compatibility) return problems;\n\n    if (sceneVersion !== undefined && compatibility.scene?.trim() && !isVersionSatisfiedBy(sceneVersion, compatibility.scene)) {\n        problems.push(`Template '${name}' requires Scene ${compatibility.scene} but the host runs ${sceneVersion}`);\n    }\n\n    for (const requirement of compatibility.packages ?? []) {\n        if (!requirement.name?.trim()) continue;\n        if (requirement.name !== owner.name && !owner.dependencies.some(dependency => dependency.name === requirement.name)) {\n            problems.push(`Template '${name}' requires package '${requirement.name}', which its package '${owner.name}' does not depend on`);\n        }\n\n        const version = versions.get(requirement.name);\n        if (version === undefined) {\n            problems.push(`Template '${name}' requires package '${requirement.name}', which is not available`);\n        } else if (!isVersionSatisfiedBy(version, requirement.versionRange)) {\n            problems.push(`Template '${name}' requires package '${requirement.name}' ${requirement.versionRange} but version ${version} is available`);\n        }\n    }\n\n    return problems;\n}\n"],"names":["describeTemplateCatalog","sources","sceneVersion","versions","Map","map","source","manifest","name","version","entries","templates","layouts","template","kind","TemplateCatalogKind","Layout","screenTemplates","ScreenTemplate","dialogTemplates","DialogTemplate","metadata","describable","problems","validateTemplateMetadata","warnings","missingCategory","validateTemplateCategory","PackageKind","Blueprint","push","requirementProblems","package","packageVersion","displayName","description","type","category","scopes","sliceKinds","compatibility","attribution","license","licenseUrl","compatible","length","owner","undefined","scene","trim","isVersionSatisfiedBy","requirement","packages","dependencies","some","dependency","get","versionRange"],"mappings":"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"}

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

@@ -1,7 +1,13 @@
+export * from './ApplicableTemplateSet';
 export * from './TemplateCatalogEntry';
 export * from './TemplateCatalogKind';
+export * from './TemplateLibrary';
+export * from './TemplateReferenceResolution';
 export * from './TemplateSource';
+export * from './TemplateTarget';
+export * from './applicableTemplates';
 export * from './describeTemplateCatalog';
+export * from './resolveTemplateReference';
 export * from './templateMetadataRules';
 export * from './validateTemplateMetadata';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../templates/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../templates/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/dist/esm/templates/index.js

@@ -1,7 +1,13 @@
+export * from './ApplicableTemplateSet';
 export * from './TemplateCatalogEntry';
 export * from './TemplateCatalogKind';
+export * from './TemplateLibrary';
+export * from './TemplateReferenceResolution';
 export * from './TemplateSource';
+export * from './TemplateTarget';
+export * from './applicableTemplates';
 export * from './describeTemplateCatalog';
+export * from './resolveTemplateReference';
 export * from './templateMetadataRules';
 export * from './validateTemplateMetadata';
 //# sourceMappingURL=index.js.map

package/dist/esm/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../templates/index.ts"],"names":[],"mappings":"AAGA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../templates/index.ts"],"names":[],"mappings":"AAGA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/dist/esm/templates/resolveTemplateReference.d.ts

@@ -0,0 +1,5 @@
+import { TemplateReference } from '@cratis/scene.model';
+import { TemplateLibrary } from './TemplateLibrary';
+import { TemplateReferenceResolution } from './TemplateReferenceResolution';
+export declare function resolveTemplateReference(reference: TemplateReference, library: TemplateLibrary): TemplateReferenceResolution;
+//# sourceMappingURL=resolveTemplateReference.d.ts.map

package/dist/esm/templates/resolveTemplateReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTemplateReference.d.ts","sourceRoot":"","sources":["../../../templates/resolveTemplateReference.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAA2B,MAAM,qBAAqB,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAA2B,MAAM,+BAA+B,CAAC;AAQrG,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,2BAA2B,CAsC5H"}

package/dist/esm/templates/resolveTemplateReference.js

@@ -0,0 +1,87 @@
+import { TemplateReferenceSource } from '@cratis/scene.model';
+import { isValidVersionRange, isVersionSatisfiedBy } from '../packageVersionRange.js';
+import { TemplateCatalogKind } from './TemplateCatalogKind.js';
+import { TemplateReferenceStatus } from './TemplateReferenceResolution.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Resolves a template reference against the templates that exist, including the blueprint version pin. The C#
+ * engine (`TemplateReferenceResolver.Resolve`) reports the same outcomes and messages; both are asserted against
+ * `template-applicability-fixtures.json`.
+ */ function resolveTemplateReference(reference, library) {
+    if (!reference.id?.trim()) {
+        return {
+            status: TemplateReferenceStatus.Malformed,
+            message: 'A template reference must name a template'
+        };
+    }
+    if (reference.source === TemplateReferenceSource.Own) {
+        if (reference.blueprint !== undefined || reference.version !== undefined) {
+            return {
+                status: TemplateReferenceStatus.Malformed,
+                message: `Own template reference '${reference.id}' must not name a blueprint or a version`
+            };
+        }
+        return library.own ? find(reference.id, library.own, reference) : unknown(reference, undefined);
+    }
+    if (!reference.blueprint?.trim()) {
+        return {
+            status: TemplateReferenceStatus.Malformed,
+            message: `Blueprint template reference '${reference.id}' must name its blueprint`
+        };
+    }
+    const blueprint = library.blueprints.find((source)=>source.manifest.name === reference.blueprint);
+    if (!blueprint) {
+        return {
+            status: TemplateReferenceStatus.UnknownBlueprint,
+            message: `Blueprint '${reference.blueprint}' referenced by template '${reference.id}' is not available`
+        };
+    }
+    const installed = blueprint.manifest.version;
+    if (reference.version !== undefined) {
+        if (!isValidVersionRange(reference.version)) {
+            return {
+                status: TemplateReferenceStatus.Malformed,
+                package: blueprint.manifest.name,
+                packageVersion: installed,
+                message: `Template reference '${reference.id}' declares an invalid version range '${reference.version}'`
+            };
+        }
+        if (!isVersionSatisfiedBy(installed, reference.version)) {
+            return {
+                status: TemplateReferenceStatus.VersionNotSatisfied,
+                package: blueprint.manifest.name,
+                packageVersion: installed,
+                message: `Template '${reference.id}' was chosen from blueprint '${blueprint.manifest.name}' ${reference.version} but version ${installed} is installed`
+            };
+        }
+    }
+    return find(reference.id, blueprint, reference);
+}
+function find(name, source, reference) {
+    const kind = kindOf(name, source);
+    return kind === undefined ? unknown(reference, source) : {
+        status: TemplateReferenceStatus.Resolved,
+        package: source.manifest.name,
+        packageVersion: source.manifest.version,
+        kind
+    };
+}
+function unknown(reference, source) {
+    return {
+        status: TemplateReferenceStatus.UnknownTemplate,
+        package: source?.manifest.name,
+        packageVersion: source?.manifest.version,
+        message: reference.source === TemplateReferenceSource.Own ? `Own template '${reference.id}' does not exist` : `Blueprint '${reference.blueprint}' has no template '${reference.id}'`
+    };
+}
+function kindOf(name, source) {
+    if (source.screenTemplates?.some((template)=>template.name === name)) return TemplateCatalogKind.ScreenTemplate;
+    if (source.dialogTemplates?.some((template)=>template.name === name)) return TemplateCatalogKind.DialogTemplate;
+    if (source.layouts?.some((layout)=>layout.name === name)) return TemplateCatalogKind.Layout;
+    return undefined;
+}
+
+export { resolveTemplateReference };
+//# sourceMappingURL=resolveTemplateReference.js.map

package/dist/esm/templates/resolveTemplateReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTemplateReference.js","sources":["../../../templates/resolveTemplateReference.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 { TemplateReference, TemplateReferenceSource } from '@cratis/scene.model';\nimport { isValidVersionRange, isVersionSatisfiedBy } from '../packageVersionRange';\nimport { TemplateCatalogKind } from './TemplateCatalogKind';\nimport { TemplateLibrary } from './TemplateLibrary';\nimport { TemplateReferenceResolution, TemplateReferenceStatus } from './TemplateReferenceResolution';\nimport { TemplateSource } from './TemplateSource';\n\n/**\n * Resolves a template reference against the templates that exist, including the blueprint version pin. The C#\n * engine (`TemplateReferenceResolver.Resolve`) reports the same outcomes and messages; both are asserted against\n * `template-applicability-fixtures.json`.\n */\nexport function resolveTemplateReference(reference: TemplateReference, library: TemplateLibrary): TemplateReferenceResolution {\n    if (!reference.id?.trim()) {\n        return { status: TemplateReferenceStatus.Malformed, message: 'A template reference must name a template' };\n    }\n\n    if (reference.source === TemplateReferenceSource.Own) {\n        if (reference.blueprint !== undefined || reference.version !== undefined) {\n            return { status: TemplateReferenceStatus.Malformed, message: `Own template reference '${reference.id}' must not name a blueprint or a version` };\n        }\n        return library.own ? find(reference.id, library.own, reference) : unknown(reference, undefined);\n    }\n\n    if (!reference.blueprint?.trim()) {\n        return { status: TemplateReferenceStatus.Malformed, message: `Blueprint template reference '${reference.id}' must name its blueprint` };\n    }\n\n    const blueprint = library.blueprints.find(source => source.manifest.name === reference.blueprint);\n    if (!blueprint) {\n        return { status: TemplateReferenceStatus.UnknownBlueprint, message: `Blueprint '${reference.blueprint}' referenced by template '${reference.id}' is not available` };\n    }\n\n    const installed = blueprint.manifest.version;\n    if (reference.version !== undefined) {\n        if (!isValidVersionRange(reference.version)) {\n            return {\n                status: TemplateReferenceStatus.Malformed, package: blueprint.manifest.name, packageVersion: installed,\n                message: `Template reference '${reference.id}' declares an invalid version range '${reference.version}'`,\n            };\n        }\n        if (!isVersionSatisfiedBy(installed, reference.version)) {\n            return {\n                status: TemplateReferenceStatus.VersionNotSatisfied, package: blueprint.manifest.name, packageVersion: installed,\n                message: `Template '${reference.id}' was chosen from blueprint '${blueprint.manifest.name}' ${reference.version} but version ${installed} is installed`,\n            };\n        }\n    }\n\n    return find(reference.id, blueprint, reference);\n}\n\nfunction find(name: string, source: TemplateSource, reference: TemplateReference): TemplateReferenceResolution {\n    const kind = kindOf(name, source);\n    return kind === undefined\n        ? unknown(reference, source)\n        : { status: TemplateReferenceStatus.Resolved, package: source.manifest.name, packageVersion: source.manifest.version, kind };\n}\n\nfunction unknown(reference: TemplateReference, source: TemplateSource | undefined): TemplateReferenceResolution {\n    return {\n        status: TemplateReferenceStatus.UnknownTemplate,\n        package: source?.manifest.name,\n        packageVersion: source?.manifest.version,\n        message: reference.source === TemplateReferenceSource.Own\n            ? `Own template '${reference.id}' does not exist`\n            : `Blueprint '${reference.blueprint}' has no template '${reference.id}'`,\n    };\n}\n\nfunction kindOf(name: string, source: TemplateSource): TemplateCatalogKind | undefined {\n    if (source.screenTemplates?.some(template => template.name === name)) return TemplateCatalogKind.ScreenTemplate;\n    if (source.dialogTemplates?.some(template => template.name === name)) return TemplateCatalogKind.DialogTemplate;\n    if (source.layouts?.some(layout => layout.name === name)) return TemplateCatalogKind.Layout;\n    return undefined;\n}\n"],"names":["resolveTemplateReference","reference","library","id","trim","status","TemplateReferenceStatus","Malformed","message","source","TemplateReferenceSource","Own","blueprint","undefined","version","own","find","unknown","blueprints","manifest","name","UnknownBlueprint","installed","isValidVersionRange","package","packageVersion","isVersionSatisfiedBy","VersionNotSatisfied","kind","kindOf","Resolved","UnknownTemplate","screenTemplates","some","template","TemplateCatalogKind","ScreenTemplate","dialogTemplates","DialogTemplate","layouts","layout","Layout"],"mappings":"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"}

package/dist/esm/templates/validateTemplateMetadata.d.ts

@@ -1,3 +1,5 @@
 import { TemplateMetadata } from '@cratis/scene.model';
 export declare function validateTemplateMetadata(name: string, metadata: TemplateMetadata | undefined): string[];
+export declare const templateCategoryMissingCode = "templateCategoryMissing";
+export declare function validateTemplateCategory(name: string, metadata: TemplateMetadata | undefined): string | undefined;
 //# sourceMappingURL=validateTemplateMetadata.d.ts.map

package/dist/esm/templates/validateTemplateMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateTemplateMetadata.d.ts","sourceRoot":"","sources":["../../../templates/validateTemplateMetadata.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AASvD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,EAAE,CA0CvG"}
+{"version":3,"file":"validateTemplateMetadata.d.ts","sourceRoot":"","sources":["../../../templates/validateTemplateMetadata.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AASvD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,EAAE,CA0CvG;AAMD,eAAO,MAAM,2BAA2B,4BAA4B,CAAC;AAGrE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEjH"}

package/dist/esm/templates/validateTemplateMetadata.js

@@ -43,6 +43,13 @@ import { isAbsoluteHttpsUrl, isSpdxExpression } from './templateMetadataRules.js
     }
     return problems;
 }
+/**
+ * The diagnostic code reported for a template without a category. Category is required for blueprint templates
+ * (an error) and recommended for own templates (a warning).
+ */ const templateCategoryMissingCode = 'templateCategoryMissing';
+/** Checks that a template declares a browse category; returns the problem, or undefined when it does. */ function validateTemplateCategory(name, metadata) {
+    return metadata?.category?.trim() ? undefined : `Template '${name}' declares no category`;
+}
 
-export { validateTemplateMetadata };
+export { templateCategoryMissingCode, validateTemplateCategory, validateTemplateMetadata };
 //# sourceMappingURL=validateTemplateMetadata.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"validateTemplateMetadata.js","sources":["../../../templates/validateTemplateMetadata.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { TemplateMetadata } from '@cratis/scene.model';\nimport { isValidVersionRange } from '../packageVersionRange';\nimport { isAbsoluteHttpsUrl, isSpdxExpression } from './templateMetadataRules';\n\n/**\n * Checks that a template carries the compatibility, attribution and license metadata every shipped template\n * needs, and that each value is well formed. The C# engine (`TemplateMetadataValidation.Validate`) reports the\n * same problems in the same order; both are asserted against `template-metadata-fixtures.json`.\n */\nexport function validateTemplateMetadata(name: string, metadata: TemplateMetadata | undefined): string[] {\n    const problems: string[] = [];\n    const compatibility = metadata?.compatibility;\n\n    if (!compatibility) {\n        problems.push(`Template '${name}' declares no compatibility`);\n    } else {\n        if (!compatibility.scene?.trim()) {\n            problems.push(`Template '${name}' declares no Scene version range`);\n        } else if (!isValidVersionRange(compatibility.scene)) {\n            problems.push(`Template '${name}' declares an invalid Scene version range '${compatibility.scene}'`);\n        }\n\n        for (const requirement of compatibility.packages ?? []) {\n            if (!requirement.name?.trim()) {\n                problems.push(`Template '${name}' declares a package requirement without a name`);\n            } else if (!isValidVersionRange(requirement.versionRange)) {\n                problems.push(`Template '${name}' declares an invalid version range '${requirement.versionRange}' for package '${requirement.name}'`);\n            }\n        }\n    }\n\n    const attribution = metadata?.attribution;\n    if (!attribution?.author?.trim()) {\n        problems.push(`Template '${name}' declares no author`);\n    }\n\n    if (attribution?.url !== undefined && !isAbsoluteHttpsUrl(attribution.url)) {\n        problems.push(`Template '${name}' declares an attribution URL '${attribution.url}' that is not an absolute https URL`);\n    }\n\n    if (!metadata?.license?.trim()) {\n        problems.push(`Template '${name}' declares no license`);\n    } else if (!isSpdxExpression(metadata.license)) {\n        problems.push(`Template '${name}' declares '${metadata.license}', which is not an SPDX license expression`);\n    }\n\n    if (metadata?.licenseUrl !== undefined && !isAbsoluteHttpsUrl(metadata.licenseUrl)) {\n        problems.push(`Template '${name}' declares a license URL '${metadata.licenseUrl}' that is not an absolute https URL`);\n    }\n\n    return problems;\n}\n"],"names":["validateTemplateMetadata","name","metadata","problems","compatibility","push","scene","trim","isValidVersionRange","requirement","packages","versionRange","attribution","author","url","undefined","isAbsoluteHttpsUrl","license","isSpdxExpression","licenseUrl"],"mappings":"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"}
+{"version":3,"file":"validateTemplateMetadata.js","sources":["../../../templates/validateTemplateMetadata.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { TemplateMetadata } from '@cratis/scene.model';\nimport { isValidVersionRange } from '../packageVersionRange';\nimport { isAbsoluteHttpsUrl, isSpdxExpression } from './templateMetadataRules';\n\n/**\n * Checks that a template carries the compatibility, attribution and license metadata every shipped template\n * needs, and that each value is well formed. The C# engine (`TemplateMetadataValidation.Validate`) reports the\n * same problems in the same order; both are asserted against `template-metadata-fixtures.json`.\n */\nexport function validateTemplateMetadata(name: string, metadata: TemplateMetadata | undefined): string[] {\n    const problems: string[] = [];\n    const compatibility = metadata?.compatibility;\n\n    if (!compatibility) {\n        problems.push(`Template '${name}' declares no compatibility`);\n    } else {\n        if (!compatibility.scene?.trim()) {\n            problems.push(`Template '${name}' declares no Scene version range`);\n        } else if (!isValidVersionRange(compatibility.scene)) {\n            problems.push(`Template '${name}' declares an invalid Scene version range '${compatibility.scene}'`);\n        }\n\n        for (const requirement of compatibility.packages ?? []) {\n            if (!requirement.name?.trim()) {\n                problems.push(`Template '${name}' declares a package requirement without a name`);\n            } else if (!isValidVersionRange(requirement.versionRange)) {\n                problems.push(`Template '${name}' declares an invalid version range '${requirement.versionRange}' for package '${requirement.name}'`);\n            }\n        }\n    }\n\n    const attribution = metadata?.attribution;\n    if (!attribution?.author?.trim()) {\n        problems.push(`Template '${name}' declares no author`);\n    }\n\n    if (attribution?.url !== undefined && !isAbsoluteHttpsUrl(attribution.url)) {\n        problems.push(`Template '${name}' declares an attribution URL '${attribution.url}' that is not an absolute https URL`);\n    }\n\n    if (!metadata?.license?.trim()) {\n        problems.push(`Template '${name}' declares no license`);\n    } else if (!isSpdxExpression(metadata.license)) {\n        problems.push(`Template '${name}' declares '${metadata.license}', which is not an SPDX license expression`);\n    }\n\n    if (metadata?.licenseUrl !== undefined && !isAbsoluteHttpsUrl(metadata.licenseUrl)) {\n        problems.push(`Template '${name}' declares a license URL '${metadata.licenseUrl}' that is not an absolute https URL`);\n    }\n\n    return problems;\n}\n\n/**\n * The diagnostic code reported for a template without a category. Category is required for blueprint templates\n * (an error) and recommended for own templates (a warning).\n */\nexport const templateCategoryMissingCode = 'templateCategoryMissing';\n\n/** Checks that a template declares a browse category; returns the problem, or undefined when it does. */\nexport function validateTemplateCategory(name: string, metadata: TemplateMetadata | undefined): string | undefined {\n    return metadata?.category?.trim() ? undefined : `Template '${name}' declares no category`;\n}\n"],"names":["validateTemplateMetadata","name","metadata","problems","compatibility","push","scene","trim","isValidVersionRange","requirement","packages","versionRange","attribution","author","url","undefined","isAbsoluteHttpsUrl","license","isSpdxExpression","licenseUrl","templateCategoryMissingCode","validateTemplateCategory","category"],"mappings":"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"}