@cratis/scene.engine 4.23.0 → 4.25.0

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

@@ -0,0 +1,5 @@
+export * from './validateComponentDescriptors';
+export * from './componentBadge';
+export * from './matchComponentQuery';
+export * from './rankFrequentlyUsedComponents';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC"}

package/dist/esm/descriptors/index.js

@@ -0,0 +1,5 @@
+export * from './validateComponentDescriptors';
+export * from './componentBadge';
+export * from './matchComponentQuery';
+export * from './rankFrequentlyUsedComponents';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../descriptors/index.ts"],"names":[],"mappings":"AAGA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC"}

package/dist/esm/descriptors/matchComponentQuery.d.ts

@@ -0,0 +1,9 @@
+import { ComponentDescriptor } from '@cratis/scene.model';
+export interface ComponentQueryMatch {
+    matched: boolean;
+    via?: 'name' | 'category' | 'keyword';
+    ranges: [number, number][];
+    keyword?: string;
+}
+export declare function matchComponentQuery(descriptor: Pick<ComponentDescriptor, 'component' | 'displayName' | 'category' | 'keywords'>, query: string): ComponentQueryMatch;
+//# sourceMappingURL=matchComponentQuery.d.ts.map

package/dist/esm/descriptors/matchComponentQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchComponentQuery.d.ts","sourceRoot":"","sources":["../../../descriptors/matchComponentQuery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK1D,MAAM,WAAW,mBAAmB;IAEhC,OAAO,EAAE,OAAO,CAAC;IAGjB,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAGtC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAG3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAcpK"}

package/dist/esm/descriptors/matchComponentQuery.js

@@ -0,0 +1,54 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Decides whether a component is shown for the text typed in a picker's filter, and why.
+ *
+ * Matching is case-insensitive. The display name (or, when the descriptor has none, the bare component name) and the keywords match by
+ * substring. The category matches by the start of one of its words - `nav` finds every Navigation component, while `ta` does not find
+ * everything under `Data display`, which a substring match on the category would. A component is shown when any of the three
+ * match; it reports the first of name, category, keyword that did, so the picker highlights the name and shows a hint only when a
+ * keyword alone brought the component in. An empty filter matches everything and highlights nothing.
+ */ function matchComponentQuery(descriptor, query) {
+    const needle = query.trim().toLowerCase();
+    if (needle.length === 0) return {
+        matched: true,
+        ranges: []
+    };
+    const name = descriptor.displayName ?? descriptor.component.slice(descriptor.component.lastIndexOf(':') + 1);
+    const ranges = occurrencesOf(name.toLowerCase(), needle);
+    if (ranges.length > 0) return {
+        matched: true,
+        via: 'name',
+        ranges
+    };
+    if (descriptor.category !== undefined && descriptor.category.toLowerCase().split(/\s+/).some((word)=>word.startsWith(needle))) {
+        return {
+            matched: true,
+            via: 'category',
+            ranges: []
+        };
+    }
+    const keyword = (descriptor.keywords ?? []).find((candidate)=>candidate.toLowerCase().includes(needle));
+    return keyword === undefined ? {
+        matched: false,
+        ranges: []
+    } : {
+        matched: true,
+        via: 'keyword',
+        ranges: [],
+        keyword
+    };
+}
+function occurrencesOf(text, needle) {
+    const found = [];
+    for(let at = text.indexOf(needle); at >= 0; at = text.indexOf(needle, at + needle.length)){
+        found.push([
+            at,
+            at + needle.length
+        ]);
+    }
+    return found;
+}
+
+export { matchComponentQuery };
+//# sourceMappingURL=matchComponentQuery.js.map

package/dist/esm/descriptors/matchComponentQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchComponentQuery.js","sources":["../../../descriptors/matchComponentQuery.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 { ComponentDescriptor } from '@cratis/scene.model';\n\n/**\n * How a component answers a picker's filter text (spec PICK2).\n */\nexport interface ComponentQueryMatch {\n    /** The component is shown for this filter. */\n    matched: boolean;\n\n    /** What matched, strongest first: the display name, the category, or one of the keywords. Absent when nothing matched. */\n    via?: 'name' | 'category' | 'keyword';\n\n    /** The `[start, end)` ranges of the display name to highlight. Empty unless the name matched. */\n    ranges: [number, number][];\n\n    /** The keyword the component matched through. Present only when `via` is `keyword`: the picker shows it as a hint. */\n    keyword?: string;\n}\n\n/**\n * Decides whether a component is shown for the text typed in a picker's filter, and why.\n *\n * Matching is case-insensitive. The display name (or, when the descriptor has none, the bare component name) and the keywords match by\n * substring. The category matches by the start of one of its words - `nav` finds every Navigation component, while `ta` does not find\n * everything under `Data display`, which a substring match on the category would. A component is shown when any of the three\n * match; it reports the first of name, category, keyword that did, so the picker highlights the name and shows a hint only when a\n * keyword alone brought the component in. An empty filter matches everything and highlights nothing.\n */\nexport function matchComponentQuery(descriptor: Pick<ComponentDescriptor, 'component' | 'displayName' | 'category' | 'keywords'>, query: string): ComponentQueryMatch {\n    const needle = query.trim().toLowerCase();\n    if (needle.length === 0) return { matched: true, ranges: [] };\n\n    const name = descriptor.displayName ?? descriptor.component.slice(descriptor.component.lastIndexOf(':') + 1);\n    const ranges = occurrencesOf(name.toLowerCase(), needle);\n    if (ranges.length > 0) return { matched: true, via: 'name', ranges };\n\n    if (descriptor.category !== undefined && descriptor.category.toLowerCase().split(/\\s+/).some(word => word.startsWith(needle))) {\n        return { matched: true, via: 'category', ranges: [] };\n    }\n\n    const keyword = (descriptor.keywords ?? []).find(candidate => candidate.toLowerCase().includes(needle));\n    return keyword === undefined ? { matched: false, ranges: [] } : { matched: true, via: 'keyword', ranges: [], keyword };\n}\n\nfunction occurrencesOf(text: string, needle: string): [number, number][] {\n    const found: [number, number][] = [];\n    for (let at = text.indexOf(needle); at >= 0; at = text.indexOf(needle, at + needle.length)) {\n        found.push([at, at + needle.length]);\n    }\n\n    return found;\n}\n"],"names":["matchComponentQuery","descriptor","query","needle","trim","toLowerCase","length","matched","ranges","name","displayName","component","slice","lastIndexOf","occurrencesOf","via","category","undefined","split","some","word","startsWith","keyword","keywords","find","candidate","includes","text","found","at","indexOf","push"],"mappings":"AAAA;AACA;AAqBA;;;;;;;;AAQC,IACM,SAASA,mBAAAA,CAAoBC,UAA4F,EAAEC,KAAa,EAAA;AAC3I,IAAA,MAAMC,MAAAA,GAASD,KAAAA,CAAME,IAAI,EAAA,CAAGC,WAAW,EAAA;AACvC,IAAA,IAAIF,MAAAA,CAAOG,MAAM,KAAK,CAAA,EAAG,OAAO;QAAEC,OAAAA,EAAS,IAAA;AAAMC,QAAAA,MAAAA,EAAQ;AAAG,KAAA;AAE5D,IAAA,MAAMC,IAAAA,GAAOR,UAAAA,CAAWS,WAAW,IAAIT,WAAWU,SAAS,CAACC,KAAK,CAACX,UAAAA,CAAWU,SAAS,CAACE,WAAW,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA;AAC1G,IAAA,MAAML,MAAAA,GAASM,aAAAA,CAAcL,IAAAA,CAAKJ,WAAW,EAAA,EAAIF,MAAAA,CAAAA;AACjD,IAAA,IAAIK,MAAAA,CAAOF,MAAM,GAAG,CAAA,EAAG,OAAO;QAAEC,OAAAA,EAAS,IAAA;QAAMQ,GAAAA,EAAK,MAAA;AAAQP,QAAAA;AAAO,KAAA;AAEnE,IAAA,IAAIP,WAAWe,QAAQ,KAAKC,aAAahB,UAAAA,CAAWe,QAAQ,CAACX,WAAW,EAAA,CAAGa,KAAK,CAAC,KAAA,CAAA,CAAOC,IAAI,CAACC,CAAAA,OAAQA,IAAAA,CAAKC,UAAU,CAAClB,MAAAA,CAAAA,CAAAA,EAAU;QAC3H,OAAO;YAAEI,OAAAA,EAAS,IAAA;YAAMQ,GAAAA,EAAK,UAAA;AAAYP,YAAAA,MAAAA,EAAQ;AAAG,SAAA;AACxD,IAAA;AAEA,IAAA,MAAMc,UAAU,CAACrB,UAAAA,CAAWsB,QAAQ,IAAI,EAAC,EAAGC,IAAI,CAACC,CAAAA,SAAAA,GAAaA,UAAUpB,WAAW,EAAA,CAAGqB,QAAQ,CAACvB,MAAAA,CAAAA,CAAAA;AAC/F,IAAA,OAAOmB,YAAYL,SAAAA,GAAY;QAAEV,OAAAA,EAAS,KAAA;AAAOC,QAAAA,MAAAA,EAAQ;KAAG,GAAI;QAAED,OAAAA,EAAS,IAAA;QAAMQ,GAAAA,EAAK,SAAA;AAAWP,QAAAA,MAAAA,EAAQ,EAAE;AAAEc,QAAAA;AAAQ,KAAA;AACzH;AAEA,SAASR,aAAAA,CAAca,IAAY,EAAExB,MAAc,EAAA;AAC/C,IAAA,MAAMyB,QAA4B,EAAE;AACpC,IAAA,IAAK,IAAIC,EAAAA,GAAKF,IAAAA,CAAKG,OAAO,CAAC3B,SAAS0B,EAAAA,IAAM,CAAA,EAAGA,EAAAA,GAAKF,IAAAA,CAAKG,OAAO,CAAC3B,MAAAA,EAAQ0B,EAAAA,GAAK1B,MAAAA,CAAOG,MAAM,CAAA,CAAG;AACxFsB,QAAAA,KAAAA,CAAMG,IAAI,CAAC;AAACF,YAAAA,EAAAA;AAAIA,YAAAA,EAAAA,GAAK1B,OAAOG;AAAO,SAAA,CAAA;AACvC,IAAA;IAEA,OAAOsB,KAAAA;AACX;;"}

package/dist/esm/descriptors/rankFrequentlyUsedComponents.d.ts

@@ -0,0 +1,7 @@
+export interface ComponentUsage {
+    count: number;
+    last: number;
+}
+export declare const frequentlyUsedLimit = 6;
+export declare function rankFrequentlyUsedComponents(usage: Readonly<Record<string, ComponentUsage>>, limit?: number): string[];
+//# sourceMappingURL=rankFrequentlyUsedComponents.d.ts.map

package/dist/esm/descriptors/rankFrequentlyUsedComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankFrequentlyUsedComponents.d.ts","sourceRoot":"","sources":["../../../descriptors/rankFrequentlyUsedComponents.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAE3B,KAAK,EAAE,MAAM,CAAC;IAGd,IAAI,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAOrC,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,KAAK,GAAE,MAA4B,GAAG,MAAM,EAAE,CAM3I"}

package/dist/esm/descriptors/rankFrequentlyUsedComponents.js

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * How often and how recently one component was added to a canvas.
+ */ /** The number of components the "Frequently used" group lists (spec PICK3). */ const frequentlyUsedLimit = 6;
+/**
+ * The components the "Frequently used" group lists: at most `limit` (6 by default), the most used first, ties broken by the most
+ * recent use, and any remaining tie by the component name so the order is stable. Components never used, or whose count is not a
+ * positive number, are not listed, so a picker hides the group when this is empty.
+ */ function rankFrequentlyUsedComponents(usage, limit = frequentlyUsedLimit) {
+    return Object.entries(usage).filter(([, entry])=>Number.isFinite(entry.count) && entry.count > 0).sort(([leftName, left], [rightName, right])=>right.count - left.count || right.last - left.last || leftName.localeCompare(rightName)).slice(0, Math.max(0, limit)).map(([name])=>name);
+}
+
+export { frequentlyUsedLimit, rankFrequentlyUsedComponents };
+//# sourceMappingURL=rankFrequentlyUsedComponents.js.map

package/dist/esm/descriptors/rankFrequentlyUsedComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankFrequentlyUsedComponents.js","sources":["../../../descriptors/rankFrequentlyUsedComponents.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 * How often and how recently one component was added to a canvas.\n */\nexport interface ComponentUsage {\n    /** How many times the component was added. */\n    count: number;\n\n    /** When it was last added, in milliseconds since the epoch. */\n    last: number;\n}\n\n/** The number of components the \"Frequently used\" group lists (spec PICK3). */\nexport const frequentlyUsedLimit = 6;\n\n/**\n * The components the \"Frequently used\" group lists: at most `limit` (6 by default), the most used first, ties broken by the most\n * recent use, and any remaining tie by the component name so the order is stable. Components never used, or whose count is not a\n * positive number, are not listed, so a picker hides the group when this is empty.\n */\nexport function rankFrequentlyUsedComponents(usage: Readonly<Record<string, ComponentUsage>>, limit: number = frequentlyUsedLimit): string[] {\n    return Object.entries(usage)\n        .filter(([, entry]) => Number.isFinite(entry.count) && entry.count > 0)\n        .sort(([leftName, left], [rightName, right]) => right.count - left.count || right.last - left.last || leftName.localeCompare(rightName))\n        .slice(0, Math.max(0, limit))\n        .map(([name]) => name);\n}\n"],"names":["frequentlyUsedLimit","rankFrequentlyUsedComponents","usage","limit","Object","entries","filter","entry","Number","isFinite","count","sort","leftName","left","rightName","right","last","localeCompare","slice","Math","max","map","name"],"mappings":"AAAA;AACA;AAEA;;AAEC,oFAUM,MAAMA,sBAAsB;AAEnC;;;;AAIC,IACM,SAASC,4BAAAA,CAA6BC,KAA+C,EAAEC,QAAgBH,mBAAmB,EAAA;AAC7H,IAAA,OAAOI,MAAAA,CAAOC,OAAO,CAACH,KAAAA,CAAAA,CACjBI,MAAM,CAAC,CAAC,GAAGC,KAAAA,CAAM,GAAKC,MAAAA,CAAOC,QAAQ,CAACF,KAAAA,CAAMG,KAAK,CAAA,IAAKH,KAAAA,CAAMG,KAAK,GAAG,CAAA,CAAA,CACpEC,IAAI,CAAC,CAAC,CAACC,QAAAA,EAAUC,IAAAA,CAAK,EAAE,CAACC,SAAAA,EAAWC,KAAAA,CAAM,GAAKA,KAAAA,CAAML,KAAK,GAAGG,IAAAA,CAAKH,KAAK,IAAIK,KAAAA,CAAMC,IAAI,GAAGH,IAAAA,CAAKG,IAAI,IAAIJ,QAAAA,CAASK,aAAa,CAACH,SAAAA,CAAAA,CAAAA,CAC5HI,KAAK,CAAC,CAAA,EAAGC,IAAAA,CAAKC,GAAG,CAAC,CAAA,EAAGjB,KAAAA,CAAAA,CAAAA,CACrBkB,GAAG,CAAC,CAAC,CAACC,IAAAA,CAAK,GAAKA,IAAAA,CAAAA;AACzB;;"}

package/dist/esm/descriptors/validateComponentDescriptors.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDescriptor, SceneDiagnostic } from '@cratis/scene.model';
+export declare function validateComponentDescriptors(descriptors: readonly ComponentDescriptor[], registered?: readonly string[], knownCategories?: readonly string[]): SceneDiagnostic[];
+//# sourceMappingURL=validateComponentDescriptors.d.ts.map

package/dist/esm/descriptors/validateComponentDescriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateComponentDescriptors.d.ts","sourceRoot":"","sources":["../../../descriptors/validateComponentDescriptors.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,mBAAmB,EACnB,eAAe,EAClB,MAAM,qBAAqB,CAAC;AAgB7B,wBAAgB,4BAA4B,CACxC,WAAW,EAAE,SAAS,mBAAmB,EAAE,EAC3C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,EAC9B,eAAe,GAAE,SAAS,MAAM,EAAwB,GACzD,eAAe,EAAE,CA8BnB"}

package/dist/esm/descriptors/validateComponentDescriptors.js

@@ -0,0 +1,114 @@
+import { componentCategories, DiagnosticSeverity, DiagnosticCode, PropertyValueType, PropertyEditorKind } from '@cratis/scene.model';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Checks the component metadata a package ships - what a picker and a designer read without loading a component.
+ *
+ * - **CMP1** `componentCategoryMissing` (error): a registered component has no descriptor, or its descriptor declares no category.
+ * - `componentCategoryUnknown` (warning): the category is not one of the model's; a package may add its own, so this is a
+ *   nudge towards the shared vocabulary, not a refusal.
+ * - `componentDesignModeInvalid` (error): the design-mode descriptor names an items or collection path that is not a `Collection`
+ *   property of the component, or repeats an action id.
+ * - `propertyEditorOptionsInvalid` (error): an editor's parameters cannot work - a `reference` editor that does not say what it
+ *   references, a step that is not positive, an empty list of slice kinds.
+ *
+ * `registered` is the bare or package-qualified names of the components the package registers; when given, each must be described.
+ * The result is in a stable order: registered components first (in the order given), then each descriptor's findings in its own order.
+ */ function validateComponentDescriptors(descriptors, registered, knownCategories = componentCategories) {
+    const diagnostics = [];
+    const described = new Map(descriptors.map((descriptor)=>[
+            descriptor.component,
+            descriptor
+        ]));
+    for (const component of registered ?? []){
+        if (!described.has(component)) {
+            diagnostics.push(missingCategory(component, `'${component}' is registered but has no descriptor, so it declares no category`));
+        }
+    }
+    for (const descriptor of descriptors){
+        const { component } = descriptor;
+        if (descriptor.category === undefined || descriptor.category.trim().length === 0) {
+            diagnostics.push(missingCategory(component, `'${component}' declares no category`));
+        } else if (!knownCategories.includes(descriptor.category)) {
+            diagnostics.push({
+                code: DiagnosticCode.ComponentCategoryUnknown,
+                severity: DiagnosticSeverity.Warning,
+                component,
+                message: `'${component}' declares the category '${descriptor.category}', which is not one of ${knownCategories.join(', ')}`
+            });
+        }
+        if (descriptor.designMode) {
+            diagnostics.push(...validateDesignMode(descriptor, descriptor.designMode));
+        }
+        diagnostics.push(...validateEditorOptions(component, descriptor.properties, ''));
+    }
+    return diagnostics;
+}
+function missingCategory(component, message) {
+    return {
+        code: DiagnosticCode.ComponentCategoryMissing,
+        severity: DiagnosticSeverity.Error,
+        component,
+        message
+    };
+}
+function invalidDesignMode(component, message) {
+    return {
+        code: DiagnosticCode.ComponentDesignModeInvalid,
+        severity: DiagnosticSeverity.Error,
+        component,
+        message
+    };
+}
+function validateDesignMode(descriptor, designMode) {
+    const { component } = descriptor;
+    const diagnostics = [];
+    const collections = new Set(descriptor.properties.filter((property)=>property.valueType === PropertyValueType.Collection).map((property)=>property.path));
+    if (designMode.itemsPath !== undefined && !collections.has(designMode.itemsPath)) {
+        diagnostics.push(invalidDesignMode(component, `'${component}' names '${designMode.itemsPath}' as its design-mode items, which is not one of its Collection properties`));
+    }
+    const seenAdd = new Set();
+    for (const action of designMode.addActions){
+        if (seenAdd.has(action.id)) diagnostics.push(invalidDesignMode(component, `'${component}' declares the design-mode add action '${action.id}' more than once`));
+        seenAdd.add(action.id);
+        if (action.collectionPath !== undefined && !collections.has(action.collectionPath)) {
+            diagnostics.push(invalidDesignMode(component, `the design-mode add action '${action.id}' of '${component}' adds to '${action.collectionPath}', which is not one of its Collection properties`));
+        }
+    }
+    const seenItem = new Set();
+    for (const action of designMode.itemToolbar){
+        if (seenItem.has(action.id)) diagnostics.push(invalidDesignMode(component, `'${component}' declares the design-mode item action '${action.id}' more than once`));
+        seenItem.add(action.id);
+    }
+    return diagnostics;
+}
+function validateEditorOptions(component, properties, parent) {
+    const diagnostics = [];
+    const invalid = (path, message)=>({
+            code: DiagnosticCode.PropertyEditorOptionsInvalid,
+            severity: DiagnosticSeverity.Error,
+            component,
+            path,
+            message: `'${component}' property '${path}' ${message}`
+        });
+    for (const property of properties){
+        const path = `${parent}${property.path}`;
+        const options = property.editorOptions;
+        if (property.editorKind === PropertyEditorKind.Reference && !options?.reference?.target) {
+            diagnostics.push(invalid(path, "uses the 'reference' editor without saying what it references (editorOptions.reference.target)"));
+        }
+        if (options?.step !== undefined && !(options.step > 0)) {
+            diagnostics.push(invalid(path, 'declares a step that is not greater than zero'));
+        }
+        if (options?.kinds !== undefined && options.kinds.length === 0) {
+            diagnostics.push(invalid(path, 'declares an empty list of kinds, which would offer nothing'));
+        }
+        if (property.item) diagnostics.push(...validateEditorOptions(component, property.item.properties, `${path}[].`));
+        if (property.properties) diagnostics.push(...validateEditorOptions(component, property.properties, `${path}.`));
+    }
+    return diagnostics;
+}
+
+export { validateComponentDescriptors };
+//# sourceMappingURL=validateComponentDescriptors.js.map

package/dist/esm/descriptors/validateComponentDescriptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateComponentDescriptors.js","sources":["../../../descriptors/validateComponentDescriptors.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 {\n    ComponentDescriptor, ComponentDesignModeDescriptor, DiagnosticCode, DiagnosticSeverity, PropertyDescriptor, PropertyEditorKind, PropertyValueType,\n    SceneDiagnostic, componentCategories,\n} from '@cratis/scene.model';\n\n/**\n * Checks the component metadata a package ships - what a picker and a designer read without loading a component.\n *\n * - **CMP1** `componentCategoryMissing` (error): a registered component has no descriptor, or its descriptor declares no category.\n * - `componentCategoryUnknown` (warning): the category is not one of the model's; a package may add its own, so this is a\n *   nudge towards the shared vocabulary, not a refusal.\n * - `componentDesignModeInvalid` (error): the design-mode descriptor names an items or collection path that is not a `Collection`\n *   property of the component, or repeats an action id.\n * - `propertyEditorOptionsInvalid` (error): an editor's parameters cannot work - a `reference` editor that does not say what it\n *   references, a step that is not positive, an empty list of slice kinds.\n *\n * `registered` is the bare or package-qualified names of the components the package registers; when given, each must be described.\n * The result is in a stable order: registered components first (in the order given), then each descriptor's findings in its own order.\n */\nexport function validateComponentDescriptors(\n    descriptors: readonly ComponentDescriptor[],\n    registered?: readonly string[],\n    knownCategories: readonly string[] = componentCategories\n): SceneDiagnostic[] {\n    const diagnostics: SceneDiagnostic[] = [];\n    const described = new Map(descriptors.map(descriptor => [descriptor.component, descriptor]));\n\n    for (const component of registered ?? []) {\n        if (!described.has(component)) {\n            diagnostics.push(missingCategory(component, `'${component}' is registered but has no descriptor, so it declares no category`));\n        }\n    }\n\n    for (const descriptor of descriptors) {\n        const { component } = descriptor;\n\n        if (descriptor.category === undefined || descriptor.category.trim().length === 0) {\n            diagnostics.push(missingCategory(component, `'${component}' declares no category`));\n        } else if (!knownCategories.includes(descriptor.category)) {\n            diagnostics.push({\n                code: DiagnosticCode.ComponentCategoryUnknown, severity: DiagnosticSeverity.Warning, component,\n                message: `'${component}' declares the category '${descriptor.category}', which is not one of ${knownCategories.join(', ')}`,\n            });\n        }\n\n        if (descriptor.designMode) {\n            diagnostics.push(...validateDesignMode(descriptor, descriptor.designMode));\n        }\n\n        diagnostics.push(...validateEditorOptions(component, descriptor.properties, ''));\n    }\n\n    return diagnostics;\n}\n\nfunction missingCategory(component: string, message: string): SceneDiagnostic {\n    return { code: DiagnosticCode.ComponentCategoryMissing, severity: DiagnosticSeverity.Error, component, message };\n}\n\nfunction invalidDesignMode(component: string, message: string): SceneDiagnostic {\n    return { code: DiagnosticCode.ComponentDesignModeInvalid, severity: DiagnosticSeverity.Error, component, message };\n}\n\nfunction validateDesignMode(descriptor: ComponentDescriptor, designMode: ComponentDesignModeDescriptor): SceneDiagnostic[] {\n    const { component } = descriptor;\n    const diagnostics: SceneDiagnostic[] = [];\n    const collections = new Set(descriptor.properties.filter(property => property.valueType === PropertyValueType.Collection).map(property => property.path));\n\n    if (designMode.itemsPath !== undefined && !collections.has(designMode.itemsPath)) {\n        diagnostics.push(invalidDesignMode(component, `'${component}' names '${designMode.itemsPath}' as its design-mode items, which is not one of its Collection properties`));\n    }\n\n    const seenAdd = new Set<string>();\n    for (const action of designMode.addActions) {\n        if (seenAdd.has(action.id)) diagnostics.push(invalidDesignMode(component, `'${component}' declares the design-mode add action '${action.id}' more than once`));\n        seenAdd.add(action.id);\n\n        if (action.collectionPath !== undefined && !collections.has(action.collectionPath)) {\n            diagnostics.push(invalidDesignMode(component, `the design-mode add action '${action.id}' of '${component}' adds to '${action.collectionPath}', which is not one of its Collection properties`));\n        }\n    }\n\n    const seenItem = new Set<string>();\n    for (const action of designMode.itemToolbar) {\n        if (seenItem.has(action.id)) diagnostics.push(invalidDesignMode(component, `'${component}' declares the design-mode item action '${action.id}' more than once`));\n        seenItem.add(action.id);\n    }\n\n    return diagnostics;\n}\n\nfunction validateEditorOptions(component: string, properties: readonly PropertyDescriptor[], parent: string): SceneDiagnostic[] {\n    const diagnostics: SceneDiagnostic[] = [];\n    const invalid = (path: string, message: string): SceneDiagnostic => ({\n        code: DiagnosticCode.PropertyEditorOptionsInvalid, severity: DiagnosticSeverity.Error, component, path, message: `'${component}' property '${path}' ${message}`,\n    });\n\n    for (const property of properties) {\n        const path = `${parent}${property.path}`;\n        const options = property.editorOptions;\n\n        if (property.editorKind === PropertyEditorKind.Reference && !options?.reference?.target) {\n            diagnostics.push(invalid(path, \"uses the 'reference' editor without saying what it references (editorOptions.reference.target)\"));\n        }\n\n        if (options?.step !== undefined && !(options.step > 0)) {\n            diagnostics.push(invalid(path, 'declares a step that is not greater than zero'));\n        }\n\n        if (options?.kinds !== undefined && options.kinds.length === 0) {\n            diagnostics.push(invalid(path, 'declares an empty list of kinds, which would offer nothing'));\n        }\n\n        if (property.item) diagnostics.push(...validateEditorOptions(component, property.item.properties, `${path}[].`));\n        if (property.properties) diagnostics.push(...validateEditorOptions(component, property.properties, `${path}.`));\n    }\n\n    return diagnostics;\n}\n"],"names":["validateComponentDescriptors","descriptors","registered","knownCategories","componentCategories","diagnostics","described","Map","map","descriptor","component","has","push","missingCategory","category","undefined","trim","length","includes","code","DiagnosticCode","ComponentCategoryUnknown","severity","DiagnosticSeverity","Warning","message","join","designMode","validateDesignMode","validateEditorOptions","properties","ComponentCategoryMissing","Error","invalidDesignMode","ComponentDesignModeInvalid","collections","Set","filter","property","valueType","PropertyValueType","Collection","path","itemsPath","seenAdd","action","addActions","id","add","collectionPath","seenItem","itemToolbar","parent","invalid","PropertyEditorOptionsInvalid","options","editorOptions","editorKind","PropertyEditorKind","Reference","reference","target","step","kinds","item"],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -16,6 +16,7 @@ export * from './panelKind';
 export * from './flowNodeKind';
 export * from './ComponentResolution';
 export * from './icons';
+export * from './descriptors';
 export * from './resolveComponentName';
 export * from './computeSizeClass';
 export * from './evaluateFlowArrangement';

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

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

package/dist/esm/index.js

@@ -25,6 +25,10 @@ export { resolveIconLibraries } from './icons/resolveIconLibraries.js';
 export { referencesOfEntry } from './icons/EffectiveIconEntry.js';
 export { EffectiveIconCatalog } from './icons/EffectiveIconCatalog.js';
 export { analyzeIconImpact } from './icons/analyzeIconImpact.js';
+export { validateComponentDescriptors } from './descriptors/validateComponentDescriptors.js';
+export { componentBadge } from './descriptors/componentBadge.js';
+export { matchComponentQuery } from './descriptors/matchComponentQuery.js';
+export { frequentlyUsedLimit, rankFrequentlyUsedComponents } from './descriptors/rankFrequentlyUsedComponents.js';
 export { corePackage, effectivePackages, resolveComponentName } from './resolveComponentName.js';
 export { computeSizeClass, defaultHeightBreakpoint, defaultWidthBreakpoint } from './computeSizeClass.js';
 export { evaluateFlowArrangement } from './evaluateFlowArrangement.js';
@@ -39,9 +43,12 @@ export { availablePackagesFor, baseComponentLibraries, componentsForPackages, pa
 export { isScreenTemplateResolutionValid, resolveScreenTemplates } from './resolveScreenTemplates.js';
 export { filterApplicableScreenTemplates, validateDialogTemplateApplicability, validateLayoutApplicability, validateScreenTemplateApplicability } from './templateApplicability.js';
 export { TemplateCatalogKind } from './templates/TemplateCatalogKind.js';
+export { TemplateReferenceStatus } from './templates/TemplateReferenceResolution.js';
+export { applicableTemplates, validateDialogTemplateForTarget, validateLayoutForTarget, validateScreenTemplateForTarget } from './templates/applicableTemplates.js';
 export { describeTemplateCatalog } from './templates/describeTemplateCatalog.js';
+export { resolveTemplateReference } from './templates/resolveTemplateReference.js';
 export { isAbsoluteHttpsUrl, isSpdxExpression } from './templates/templateMetadataRules.js';
-export { validateTemplateMetadata } from './templates/validateTemplateMetadata.js';
+export { templateCategoryMissingCode, validateTemplateCategory, validateTemplateMetadata } from './templates/validateTemplateMetadata.js';
 export { buildStarterProfile } from './buildStarterProfile.js';
 export { incompatibleStarterThemes } from './incompatibleStarterThemes.js';
 export { InteractionStop, runActions, runBindings } from './runActions.js';

package/dist/esm/index.js.map

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

package/dist/esm/templateApplicability.d.ts

@@ -1,8 +1,7 @@
 import { DialogTemplate, Layout, ScreenTemplate, TemplateScope } from '@cratis/scene.model';
-type TemplateContainer = Pick<Layout, 'name' | 'slots'>;
+export type TemplateContainer = Pick<Layout, 'name' | 'slots'>;
 export declare function validateLayoutApplicability(layout: Layout | undefined, scope: TemplateScope): string[];
 export declare function validateScreenTemplateApplicability(template: ScreenTemplate | undefined, scope: TemplateScope, container?: TemplateContainer): string[];
 export declare function validateDialogTemplateApplicability(template: DialogTemplate | undefined, scope: TemplateScope): string[];
 export declare function filterApplicableScreenTemplates(templates: readonly ScreenTemplate[], scope: TemplateScope, container?: TemplateContainer): ScreenTemplate[];
-export {};
 //# sourceMappingURL=templateApplicability.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"templateApplicability.d.ts","sourceRoot":"","sources":["../../templateApplicability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAoB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG9G,KAAK,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAGxD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAEtG;AAMD,wBAAgB,mCAAmC,CAC/C,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,iBAAiB,GAC9B,MAAM,EAAE,CAYV;AAGD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAExH;AAGD,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,iBAAiB,GAC9B,cAAc,EAAE,CAElB"}
+{"version":3,"file":"templateApplicability.d.ts","sourceRoot":"","sources":["../../templateApplicability.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAAoB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAI9G,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAG/D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAEtG;AAMD,wBAAgB,mCAAmC,CAC/C,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,iBAAiB,GAC9B,MAAM,EAAE,CAYV;AAGD,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAExH;AAGD,wBAAgB,+BAA+B,CAC3C,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,iBAAiB,GAC9B,cAAc,EAAE,CAElB"}

package/dist/esm/templateApplicability.js.map

@@ -1 +1 @@
-{"version":3,"file":"templateApplicability.js","sources":["../../templateApplicability.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, TemplateScope } from '@cratis/scene.model';\n\ntype TemplateKind = 'Layout' | 'ScreenTemplate' | 'DialogTemplate';\ntype TemplateContainer = Pick<Layout, 'name' | 'slots'>;\n\n/** Validates application-shell selection without introducing a competing shell model. */\nexport function validateLayoutApplicability(layout: Layout | undefined, scope: TemplateScope): string[] {\n    return layout ? validateRole(layout.name, 'Layout', layout.metadata, scope) : [];\n}\n\n/**\n * Validates selection at any depth of the application hierarchy, including qualified fitsSlot names.\n * Undefined represents outlet-only composition and is valid. Invalid author input is never rewritten.\n */\nexport function validateScreenTemplateApplicability(\n    template: ScreenTemplate | undefined,\n    scope: TemplateScope,\n    container?: TemplateContainer,\n): string[] {\n    if (!template) return [];\n    const problems = validateRole(template.name, 'ScreenTemplate', template.metadata, scope);\n    if (template.fitsSlot !== undefined) {\n        const separator = template.fitsSlot.lastIndexOf('.');\n        const qualifier = separator < 0 ? undefined : template.fitsSlot.slice(0, separator);\n        const slot = separator < 0 ? template.fitsSlot : template.fitsSlot.slice(separator + 1);\n        if (!container || (qualifier !== undefined && qualifier !== container.name) || !container.slots.some(candidate => candidate.name === slot)) {\n            problems.push(`Template '${template.name}' does not fit slot '${template.fitsSlot}' on '${container?.name ?? '(no container)'}'`);\n        }\n    }\n    return problems;\n}\n\n/** Validates an overlay template separately from slot-based screen composition. */\nexport function validateDialogTemplateApplicability(template: DialogTemplate | undefined, scope: TemplateScope): string[] {\n    return template ? validateRole(template.name, 'DialogTemplate', template.metadata, scope) : [];\n}\n\n/** The shared picker predicate uses exactly the same rules as validation on apply. */\nexport function filterApplicableScreenTemplates(\n    templates: readonly ScreenTemplate[],\n    scope: TemplateScope,\n    container?: TemplateContainer,\n): ScreenTemplate[] {\n    return templates.filter(template => validateScreenTemplateApplicability(template, scope, container).length === 0);\n}\n\nfunction validateRole(name: string, kind: TemplateKind, metadata: TemplateMetadata | undefined, scope: TemplateScope): string[] {\n    const problems: string[] = [];\n    if (!Object.values(TemplateScope).includes(scope)) {\n        problems.push(`Template '${name}' has unknown target scope '${scope}'`);\n    } else if ((kind === 'Layout') !== (scope === TemplateScope.Application)) {\n        problems.push(`Template '${name}' of kind '${kind}' cannot be applied at scope '${scope}'`);\n    }\n    if (metadata?.type === 'ApplicationShell' && kind !== 'Layout') {\n        problems.push(`Template '${name}' of type 'ApplicationShell' must be a Layout`);\n    }\n    if (metadata?.type === 'Dialog' && kind !== 'DialogTemplate') {\n        problems.push(`Template '${name}' of type 'Dialog' must be a DialogTemplate`);\n    }\n    if (kind === 'Layout' && ['Workspace', 'List', 'Detail', 'Form'].includes(metadata?.type ?? '')) {\n        problems.push(`Template '${name}' of type '${metadata?.type}' must not be a Layout`);\n    }\n    for (const declaredScope of metadata?.scopes ?? []) {\n        if (!Object.values(TemplateScope).includes(declaredScope)) {\n            problems.push(`Template '${name}' declares unknown scope '${declaredScope}'`);\n        }\n    }\n    if (metadata?.scopes !== undefined && !metadata.scopes.includes(scope)) {\n        problems.push(`Template '${name}' does not declare scope '${scope}'`);\n    }\n    return problems;\n}\n"],"names":["validateLayoutApplicability","layout","scope","validateRole","name","metadata","validateScreenTemplateApplicability","template","container","problems","fitsSlot","undefined","separator","lastIndexOf","qualifier","slice","slot","slots","some","candidate","push","validateDialogTemplateApplicability","filterApplicableScreenTemplates","templates","filter","length","kind","Object","values","TemplateScope","includes","Application","type","declaredScope","scopes"],"mappings":"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"}
+{"version":3,"file":"templateApplicability.js","sources":["../../templateApplicability.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, TemplateScope } from '@cratis/scene.model';\n\ntype TemplateKind = 'Layout' | 'ScreenTemplate' | 'DialogTemplate';\n/** The containing layout or screen template against which a fitsSlot selection is checked. */\nexport type TemplateContainer = Pick<Layout, 'name' | 'slots'>;\n\n/** Validates application-shell selection without introducing a competing shell model. */\nexport function validateLayoutApplicability(layout: Layout | undefined, scope: TemplateScope): string[] {\n    return layout ? validateRole(layout.name, 'Layout', layout.metadata, scope) : [];\n}\n\n/**\n * Validates selection at any depth of the application hierarchy, including qualified fitsSlot names.\n * Undefined represents outlet-only composition and is valid. Invalid author input is never rewritten.\n */\nexport function validateScreenTemplateApplicability(\n    template: ScreenTemplate | undefined,\n    scope: TemplateScope,\n    container?: TemplateContainer,\n): string[] {\n    if (!template) return [];\n    const problems = validateRole(template.name, 'ScreenTemplate', template.metadata, scope);\n    if (template.fitsSlot !== undefined) {\n        const separator = template.fitsSlot.lastIndexOf('.');\n        const qualifier = separator < 0 ? undefined : template.fitsSlot.slice(0, separator);\n        const slot = separator < 0 ? template.fitsSlot : template.fitsSlot.slice(separator + 1);\n        if (!container || (qualifier !== undefined && qualifier !== container.name) || !container.slots.some(candidate => candidate.name === slot)) {\n            problems.push(`Template '${template.name}' does not fit slot '${template.fitsSlot}' on '${container?.name ?? '(no container)'}'`);\n        }\n    }\n    return problems;\n}\n\n/** Validates an overlay template separately from slot-based screen composition. */\nexport function validateDialogTemplateApplicability(template: DialogTemplate | undefined, scope: TemplateScope): string[] {\n    return template ? validateRole(template.name, 'DialogTemplate', template.metadata, scope) : [];\n}\n\n/** The shared picker predicate uses exactly the same rules as validation on apply. */\nexport function filterApplicableScreenTemplates(\n    templates: readonly ScreenTemplate[],\n    scope: TemplateScope,\n    container?: TemplateContainer,\n): ScreenTemplate[] {\n    return templates.filter(template => validateScreenTemplateApplicability(template, scope, container).length === 0);\n}\n\nfunction validateRole(name: string, kind: TemplateKind, metadata: TemplateMetadata | undefined, scope: TemplateScope): string[] {\n    const problems: string[] = [];\n    if (!Object.values(TemplateScope).includes(scope)) {\n        problems.push(`Template '${name}' has unknown target scope '${scope}'`);\n    } else if ((kind === 'Layout') !== (scope === TemplateScope.Application)) {\n        problems.push(`Template '${name}' of kind '${kind}' cannot be applied at scope '${scope}'`);\n    }\n    if (metadata?.type === 'ApplicationShell' && kind !== 'Layout') {\n        problems.push(`Template '${name}' of type 'ApplicationShell' must be a Layout`);\n    }\n    if (metadata?.type === 'Dialog' && kind !== 'DialogTemplate') {\n        problems.push(`Template '${name}' of type 'Dialog' must be a DialogTemplate`);\n    }\n    if (kind === 'Layout' && ['Workspace', 'List', 'Detail', 'Form'].includes(metadata?.type ?? '')) {\n        problems.push(`Template '${name}' of type '${metadata?.type}' must not be a Layout`);\n    }\n    for (const declaredScope of metadata?.scopes ?? []) {\n        if (!Object.values(TemplateScope).includes(declaredScope)) {\n            problems.push(`Template '${name}' declares unknown scope '${declaredScope}'`);\n        }\n    }\n    if (metadata?.scopes !== undefined && !metadata.scopes.includes(scope)) {\n        problems.push(`Template '${name}' does not declare scope '${scope}'`);\n    }\n    return problems;\n}\n"],"names":["validateLayoutApplicability","layout","scope","validateRole","name","metadata","validateScreenTemplateApplicability","template","container","problems","fitsSlot","undefined","separator","lastIndexOf","qualifier","slice","slot","slots","some","candidate","push","validateDialogTemplateApplicability","filterApplicableScreenTemplates","templates","filter","length","kind","Object","values","TemplateScope","includes","Application","type","declaredScope","scopes"],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+import { TemplateMetadata, TemplateReference } from '@cratis/scene.model';
+import { TemplateCatalogKind } from './TemplateCatalogKind';
+export interface ApplicableTemplate {
+    package: string;
+    packageVersion: string;
+    kind: TemplateCatalogKind;
+    name: string;
+    displayName?: string;
+    description?: string;
+    metadata?: TemplateMetadata;
+    reference: TemplateReference;
+}
+export interface ApplicableTemplateGroup {
+    category?: string;
+    templates: ApplicableTemplate[];
+}
+export interface ApplicableBlueprint {
+    blueprint: string;
+    version: string;
+    displayName?: string;
+    categories: ApplicableTemplateGroup[];
+}
+export interface ApplicableTemplateSet {
+    own: ApplicableTemplateGroup[];
+    blueprints: ApplicableBlueprint[];
+}
+//# sourceMappingURL=ApplicableTemplateSet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicableTemplateSet.d.ts","sourceRoot":"","sources":["../../../templates/ApplicableTemplateSet.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,kBAAkB;IAE/B,OAAO,EAAE,MAAM,CAAC;IAGhB,cAAc,EAAE,MAAM,CAAC;IAEvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAG5B,SAAS,EAAE,iBAAiB,CAAC;CAChC;AAGD,MAAM,WAAW,uBAAuB;IAEpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAGD,MAAM,WAAW,mBAAmB;IAEhC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAGD,MAAM,WAAW,qBAAqB;IAElC,GAAG,EAAE,uBAAuB,EAAE,CAAC;IAG/B,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACrC"}

package/dist/esm/templates/ApplicableTemplateSet.js

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

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

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

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

@@ -1,4 +1,4 @@
-import { TemplateAttribution, TemplateCompatibility, TemplateScope } from '@cratis/scene.model';
+import { TemplateAttribution, TemplateCompatibility, TemplateScope, SliceKind } from '@cratis/scene.model';
 import { TemplateCatalogKind } from './TemplateCatalogKind';
 export interface TemplateCatalogEntry {
     package: string;
@@ -10,11 +10,13 @@ export interface TemplateCatalogEntry {
     type?: string;
     category?: string;
     scopes?: TemplateScope[];
+    sliceKinds?: SliceKind[];
     compatibility?: TemplateCompatibility;
     attribution?: TemplateAttribution;
     license?: string;
     licenseUrl?: string;
     compatible: boolean;
     problems: string[];
+    warnings: string[];
 }
 //# sourceMappingURL=TemplateCatalogEntry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"TemplateCatalogEntry.d.ts","sourceRoot":"","sources":["../../../templates/TemplateCatalogEntry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,MAAM,WAAW,oBAAoB;IAEjC,OAAO,EAAE,MAAM,CAAC;IAGhB,cAAc,EAAE,MAAM,CAAC;IAEvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,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,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,OAAO,CAAC;IAGpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB"}
+{"version":3,"file":"TemplateCatalogEntry.d.ts","sourceRoot":"","sources":["../../../templates/TemplateCatalogEntry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3G,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,MAAM,WAAW,oBAAoB;IAEjC,OAAO,EAAE,MAAM,CAAC;IAGhB,cAAc,EAAE,MAAM,CAAC;IAEvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,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,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,OAAO,CAAC;IAGpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAGnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB"}

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

@@ -0,0 +1,6 @@
+import { TemplateSource } from './TemplateSource';
+export interface TemplateLibrary {
+    own?: TemplateSource;
+    blueprints: TemplateSource[];
+}
+//# sourceMappingURL=TemplateLibrary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateLibrary.d.ts","sourceRoot":"","sources":["../../../templates/TemplateLibrary.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,MAAM,WAAW,eAAe;IAE5B,GAAG,CAAC,EAAE,cAAc,CAAC;IAGrB,UAAU,EAAE,cAAc,EAAE,CAAC;CAChC"}

package/dist/esm/templates/TemplateLibrary.js

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

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

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

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

@@ -0,0 +1,16 @@
+import { TemplateCatalogKind } from './TemplateCatalogKind';
+export declare enum TemplateReferenceStatus {
+    Resolved = "Resolved",
+    Malformed = "Malformed",
+    UnknownBlueprint = "UnknownBlueprint",
+    VersionNotSatisfied = "VersionNotSatisfied",
+    UnknownTemplate = "UnknownTemplate"
+}
+export interface TemplateReferenceResolution {
+    status: TemplateReferenceStatus;
+    package?: string;
+    packageVersion?: string;
+    kind?: TemplateCatalogKind;
+    message?: string;
+}
+//# sourceMappingURL=TemplateReferenceResolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateReferenceResolution.d.ts","sourceRoot":"","sources":["../../../templates/TemplateReferenceResolution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,oBAAY,uBAAuB;IAE/B,QAAQ,aAAa;IAErB,SAAS,cAAc;IAEvB,gBAAgB,qBAAqB;IAErC,mBAAmB,wBAAwB;IAE3C,eAAe,oBAAoB;CACtC;AAGD,MAAM,WAAW,2BAA2B;IACxC,MAAM,EAAE,uBAAuB,CAAC;IAGhC,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAG3B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/esm/templates/TemplateReferenceResolution.js

@@ -0,0 +1,13 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** The outcome of resolving a template reference against a template library. */ var TemplateReferenceStatus = /*#__PURE__*/ function(TemplateReferenceStatus) {
+    /** The reference names a template that exists, at a version the reference accepts. */ TemplateReferenceStatus["Resolved"] = "Resolved";
+    /** The reference is not well formed: an own reference carrying a blueprint or version, a blueprint reference without a blueprint, or an invalid version range. */ TemplateReferenceStatus["Malformed"] = "Malformed";
+    /** No blueprint package of that name is available. */ TemplateReferenceStatus["UnknownBlueprint"] = "UnknownBlueprint";
+    /** The installed version of the blueprint is outside the reference's version range: the blueprint has drifted from what was chosen. */ TemplateReferenceStatus["VersionNotSatisfied"] = "VersionNotSatisfied";
+    /** The blueprint or workspace has no template of that name. */ TemplateReferenceStatus["UnknownTemplate"] = "UnknownTemplate";
+    return TemplateReferenceStatus;
+}({});
+
+export { TemplateReferenceStatus };
+//# sourceMappingURL=TemplateReferenceResolution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateReferenceResolution.js","sources":["../../../templates/TemplateReferenceResolution.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 { TemplateCatalogKind } from './TemplateCatalogKind';\n\n/** The outcome of resolving a template reference against a template library. */\nexport enum TemplateReferenceStatus {\n    /** The reference names a template that exists, at a version the reference accepts. */\n    Resolved = 'Resolved',\n    /** The reference is not well formed: an own reference carrying a blueprint or version, a blueprint reference without a blueprint, or an invalid version range. */\n    Malformed = 'Malformed',\n    /** No blueprint package of that name is available. */\n    UnknownBlueprint = 'UnknownBlueprint',\n    /** The installed version of the blueprint is outside the reference's version range: the blueprint has drifted from what was chosen. */\n    VersionNotSatisfied = 'VersionNotSatisfied',\n    /** The blueprint or workspace has no template of that name. */\n    UnknownTemplate = 'UnknownTemplate',\n}\n\n/** The result of resolving a template reference. */\nexport interface TemplateReferenceResolution {\n    status: TemplateReferenceStatus;\n\n    /** The package providing the template, when it was found or its blueprint was. */\n    package?: string;\n\n    /** The installed version of that package. */\n    packageVersion?: string;\n\n    /** Which kind of template was found, when the status is Resolved. */\n    kind?: TemplateCatalogKind;\n\n    /** A diagnostic when the reference did not resolve. */\n    message?: string;\n}\n"],"names":["TemplateReferenceStatus"],"mappings":"AAAA;AACA;AAIA,iFACO,IAAKA,uBAAAA,iBAAAA,SAAAA,uBAAAA,EAAAA;2FAC4E,uBAAA,CAAA,UAAA,CAAA,GAAA,UAAA;uKAE4E,uBAAA,CAAA,WAAA,CAAA,GAAA,WAAA;2DAE5G,uBAAA,CAAA,kBAAA,CAAA,GAAA,kBAAA;4IAEiF,uBAAA,CAAA,qBAAA,CAAA,GAAA,qBAAA;oEAExE,uBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAA;AATrDA,IAAAA,OAAAA,uBAAAA;AAWX,CAAA,CAAA,EAAA;;"}

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

@@ -0,0 +1,9 @@
+import { TemplateScope, SliceKind } from '@cratis/scene.model';
+import { TemplateContainer } from '../templateApplicability';
+export interface TemplateTarget {
+    scope: TemplateScope;
+    sliceKind?: SliceKind;
+    container?: TemplateContainer;
+    chain?: string[];
+}
+//# sourceMappingURL=TemplateTarget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateTarget.d.ts","sourceRoot":"","sources":["../../../templates/TemplateTarget.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,WAAW,cAAc;IAE3B,KAAK,EAAE,aAAa,CAAC;IAGrB,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAM9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/esm/templates/TemplateTarget.js

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

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

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

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

@@ -0,0 +1,9 @@
+import { DialogTemplate, Layout, ScreenTemplate } from '@cratis/scene.model';
+import { ApplicableTemplateSet } from './ApplicableTemplateSet';
+import { TemplateLibrary } from './TemplateLibrary';
+import { TemplateTarget } from './TemplateTarget';
+export declare function applicableTemplates(library: TemplateLibrary, target: TemplateTarget): ApplicableTemplateSet;
+export declare function validateLayoutForTarget(layout: Layout, target: TemplateTarget): string[];
+export declare function validateScreenTemplateForTarget(template: ScreenTemplate, target: TemplateTarget): string[];
+export declare function validateDialogTemplateForTarget(template: DialogTemplate, target: TemplateTarget): string[];
+//# sourceMappingURL=applicableTemplates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"applicableTemplates.d.ts","sourceRoot":"","sources":["../../../templates/applicableTemplates.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,EAA0F,MAAM,qBAAqB,CAAC;AAGrK,OAAO,EAAoE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAElI,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAsBlD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAU3G;AAGD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAExF;AAGD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAuB1G;AAGD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAE1G"}