@cratis/scene.engine 4.7.0 → 4.8.0

package/dist/cjs/index.js

@@ -20,6 +20,7 @@ var packageVersionRange = require('./packageVersionRange.js');
 var resolvePackageDependencies = require('./resolvePackageDependencies.js');
 var packageCatalog = require('./packageCatalog.js');
 var resolveScreenTemplates = require('./resolveScreenTemplates.js');
+var templateApplicability = require('./templateApplicability.js');
 var buildStarterProfile = require('./buildStarterProfile.js');
 var incompatibleStarterThemes = require('./incompatibleStarterThemes.js');
 var runActions = require('./runActions.js');
@@ -88,6 +89,10 @@ exports.packagesOfKind = packageCatalog.packagesOfKind;
 exports.toComponentCatalog = packageCatalog.toComponentCatalog;
 exports.isScreenTemplateResolutionValid = resolveScreenTemplates.isScreenTemplateResolutionValid;
 exports.resolveScreenTemplates = resolveScreenTemplates.resolveScreenTemplates;
+exports.filterApplicableScreenTemplates = templateApplicability.filterApplicableScreenTemplates;
+exports.validateDialogTemplateApplicability = templateApplicability.validateDialogTemplateApplicability;
+exports.validateLayoutApplicability = templateApplicability.validateLayoutApplicability;
+exports.validateScreenTemplateApplicability = templateApplicability.validateScreenTemplateApplicability;
 exports.buildStarterProfile = buildStarterProfile.buildStarterProfile;
 exports.incompatibleStarterThemes = incompatibleStarterThemes.incompatibleStarterThemes;
 exports.InteractionStop = runActions.InteractionStop;

package/dist/cjs/index.js.map

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

package/dist/cjs/templateApplicability.js

@@ -0,0 +1,68 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Validates application-shell selection without introducing a competing shell model. */ function validateLayoutApplicability(layout, scope) {
+    return layout ? validateRole(layout.name, 'Layout', layout.metadata, scope) : [];
+}
+/**
+ * Validates selection at any depth of the application hierarchy, including qualified fitsSlot names.
+ * Undefined represents outlet-only composition and is valid. Invalid author input is never rewritten.
+ */ function validateScreenTemplateApplicability(template, scope, container) {
+    if (!template) return [];
+    const problems = validateRole(template.name, 'ScreenTemplate', template.metadata, scope);
+    if (template.fitsSlot !== undefined) {
+        const separator = template.fitsSlot.lastIndexOf('.');
+        const qualifier = separator < 0 ? undefined : template.fitsSlot.slice(0, separator);
+        const slot = separator < 0 ? template.fitsSlot : template.fitsSlot.slice(separator + 1);
+        if (!container || qualifier !== undefined && qualifier !== container.name || !container.slots.some((candidate)=>candidate.name === slot)) {
+            problems.push(`Template '${template.name}' does not fit slot '${template.fitsSlot}' on '${container?.name ?? '(no container)'}'`);
+        }
+    }
+    return problems;
+}
+/** Validates an overlay template separately from slot-based screen composition. */ function validateDialogTemplateApplicability(template, scope) {
+    return template ? validateRole(template.name, 'DialogTemplate', template.metadata, scope) : [];
+}
+/** The shared picker predicate uses exactly the same rules as validation on apply. */ function filterApplicableScreenTemplates(templates, scope, container) {
+    return templates.filter((template)=>validateScreenTemplateApplicability(template, scope, container).length === 0);
+}
+function validateRole(name, kind, metadata, scope) {
+    const problems = [];
+    if (!Object.values(scene_model.TemplateScope).includes(scope)) {
+        problems.push(`Template '${name}' has unknown target scope '${scope}'`);
+    } else if (kind === 'Layout' !== (scope === scene_model.TemplateScope.Application)) {
+        problems.push(`Template '${name}' of kind '${kind}' cannot be applied at scope '${scope}'`);
+    }
+    if (metadata?.type === 'ApplicationShell' && kind !== 'Layout') {
+        problems.push(`Template '${name}' of type 'ApplicationShell' must be a Layout`);
+    }
+    if (metadata?.type === 'Dialog' && kind !== 'DialogTemplate') {
+        problems.push(`Template '${name}' of type 'Dialog' must be a DialogTemplate`);
+    }
+    if (kind === 'Layout' && [
+        'Workspace',
+        'List',
+        'Detail',
+        'Form'
+    ].includes(metadata?.type ?? '')) {
+        problems.push(`Template '${name}' of type '${metadata?.type}' must not be a Layout`);
+    }
+    for (const declaredScope of metadata?.scopes ?? []){
+        if (!Object.values(scene_model.TemplateScope).includes(declaredScope)) {
+            problems.push(`Template '${name}' declares unknown scope '${declaredScope}'`);
+        }
+    }
+    if (metadata?.scopes !== undefined && !metadata.scopes.includes(scope)) {
+        problems.push(`Template '${name}' does not declare scope '${scope}'`);
+    }
+    return problems;
+}
+
+exports.filterApplicableScreenTemplates = filterApplicableScreenTemplates;
+exports.validateDialogTemplateApplicability = validateDialogTemplateApplicability;
+exports.validateLayoutApplicability = validateLayoutApplicability;
+exports.validateScreenTemplateApplicability = validateScreenTemplateApplicability;
+//# sourceMappingURL=templateApplicability.js.map

package/dist/cjs/templateApplicability.js.map

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

package/dist/esm/index.d.ts

@@ -18,6 +18,7 @@ export * from './packageVersionRange';
 export * from './resolvePackageDependencies';
 export * from './packageCatalog';
 export * from './resolveScreenTemplates';
+export * from './templateApplicability';
 export * from './buildStarterProfile';
 export * from './incompatibleStarterThemes';
 export * from './ActionDispatcher';

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

package/dist/esm/index.js

@@ -18,6 +18,7 @@ export { isVersionSatisfiedBy } from './packageVersionRange.js';
 export { resolvePackageDependencies } from './resolvePackageDependencies.js';
 export { availablePackagesFor, baseComponentLibraries, componentsForPackages, packagesOfKind, toComponentCatalog } from './packageCatalog.js';
 export { isScreenTemplateResolutionValid, resolveScreenTemplates } from './resolveScreenTemplates.js';
+export { filterApplicableScreenTemplates, validateDialogTemplateApplicability, validateLayoutApplicability, validateScreenTemplateApplicability } from './templateApplicability.js';
 export { 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

@@ -0,0 +1,8 @@
+import { DialogTemplate, Layout, ScreenTemplate, TemplateScope } from '@cratis/scene.model';
+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

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

package/dist/esm/templateApplicability.js

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

package/dist/esm/templateApplicability.js.map

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