@cratis/scene.engine 4.7.0 → 4.9.0

package/BindingDiagnostic.ts

@@ -0,0 +1,11 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * A binding validation problem that preserves the authored model and tells a designer what to fix.
+ */
+export interface BindingDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+}

package/BindingScope.ts

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/**
+ * Runtime values available to resolve typed bindings.
+ */
+export interface BindingScope {
+    /** Inherited effective data context for the element. */
+    dataContext?: unknown;
+
+    /** Query results keyed by the model's query binding name. */
+    queryResults?: Record<string, unknown>;
+
+    /** Component output properties keyed by stable element id. */
+    componentOutputs?: Record<string, Record<string, unknown>>;
+}

package/dist/cjs/index.js

@@ -1,5 +1,7 @@
 'use strict';
 
+var resolveBindingExpression = require('./resolveBindingExpression.js');
+var validateBindingExpression = require('./validateBindingExpression.js');
 var renderElement = require('./renderElement.js');
 var elementKind = require('./elementKind.js');
 var panelKind = require('./panelKind.js');
@@ -20,11 +22,13 @@ 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');
 var resolveBehaviors = require('./resolveBehaviors.js');
 var resolveStrings = require('./resolveStrings.js');
+var validateNavigationDestinations = require('./validateNavigationDestinations.js');
 var diagnostics = require('./editing/diagnostics.js');
 var nodeIds = require('./editing/nodeIds.js');
 var layoutTypeDescriptors = require('./editing/layoutTypeDescriptors.js');
@@ -45,6 +49,9 @@ var collectIconUsages = require('./editing/collectIconUsages.js');
 
 
 
+exports.createBindingResolver = resolveBindingExpression.createBindingResolver;
+exports.resolveBindingExpression = resolveBindingExpression.resolveBindingExpression;
+exports.validateBindingExpression = validateBindingExpression.validateBindingExpression;
 exports.renderElement = renderElement.renderElement;
 exports.isContentControl = elementKind.isContentControl;
 exports.isExternalComponent = elementKind.isExternalComponent;
@@ -88,6 +95,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;
@@ -100,6 +111,7 @@ exports.resolveIntervalBehaviors = resolveBehaviors.resolveIntervalBehaviors;
 exports.isStringsReference = resolveStrings.isStringsReference;
 exports.resolveStringsInElement = resolveStrings.resolveStringsInElement;
 exports.resolveStringsValue = resolveStrings.resolveStringsValue;
+exports.validateNavigationDestinations = validateNavigationDestinations.validateNavigationDestinations;
 exports.errorDiagnostic = diagnostics.errorDiagnostic;
 exports.hasErrors = diagnostics.hasErrors;
 exports.warningDiagnostic = diagnostics.warningDiagnostic;

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/resolveBindingExpression.js

@@ -0,0 +1,51 @@
+'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.
+/**
+ * Resolves a typed binding against the shared runtime binding scope.
+ */ function resolveBindingExpression(binding, scope) {
+    const kind = binding.kind ?? scene_model.BindingSourceKind.DataContext;
+    if (kind === scene_model.BindingSourceKind.Literal) return binding.value;
+    const source = sourceValue(binding, scope, kind);
+    const value = readPath(source, sourcePath(binding, kind));
+    if (value !== null && value !== undefined) return value;
+    if (binding.nullBehavior === scene_model.BindingNullBehavior.Preserve) return undefined;
+    if (binding.nullBehavior === scene_model.BindingNullBehavior.Clear) return null;
+    return value;
+}
+/**
+ * Creates a legacy resolver function from a binding scope.
+ */ function createBindingResolver(scope) {
+    return (binding)=>resolveBindingExpression(binding, scope);
+}
+function sourceValue(binding, scope, kind) {
+    switch(kind){
+        case scene_model.BindingSourceKind.DataContext:
+            return scope.dataContext;
+        case scene_model.BindingSourceKind.QueryResult:
+            return binding.query ? scope.queryResults?.[binding.query] : undefined;
+        case scene_model.BindingSourceKind.ComponentProperty:
+            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;
+        case scene_model.BindingSourceKind.Literal:
+            return binding.value;
+    }
+}
+function sourcePath(binding, kind) {
+    if (kind === scene_model.BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;
+    return binding.path;
+}
+function readPath(source, path) {
+    if (!path) return source;
+    return path.split('.').reduce((current, segment)=>{
+        if (current === null || current === undefined) return undefined;
+        if (typeof current !== 'object') return undefined;
+        return current[segment];
+    }, source);
+}
+
+exports.createBindingResolver = createBindingResolver;
+exports.resolveBindingExpression = resolveBindingExpression;
+//# sourceMappingURL=resolveBindingExpression.js.map

package/dist/cjs/resolveBindingExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBindingExpression.js","sources":["../../resolveBindingExpression.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 { BindingExpression, BindingNullBehavior, BindingSourceKind } from '@cratis/scene.model';\nimport { BindingScope } from './BindingScope';\n\n/**\n * Resolves a typed binding against the shared runtime binding scope.\n */\nexport function resolveBindingExpression(binding: BindingExpression, scope: BindingScope): unknown {\n    const kind = binding.kind ?? BindingSourceKind.DataContext;\n    if (kind === BindingSourceKind.Literal) return binding.value;\n\n    const source = sourceValue(binding, scope, kind);\n    const value = readPath(source, sourcePath(binding, kind));\n    if (value !== null && value !== undefined) return value;\n\n    if (binding.nullBehavior === BindingNullBehavior.Preserve) return undefined;\n    if (binding.nullBehavior === BindingNullBehavior.Clear) return null;\n    return value;\n}\n\n/**\n * Creates a legacy resolver function from a binding scope.\n */\nexport function createBindingResolver(scope: BindingScope): (binding: BindingExpression) => unknown {\n    return binding => resolveBindingExpression(binding, scope);\n}\n\nfunction sourceValue(binding: BindingExpression, scope: BindingScope, kind: BindingSourceKind): unknown {\n    switch (kind) {\n        case BindingSourceKind.DataContext:\n            return scope.dataContext;\n        case BindingSourceKind.QueryResult:\n            return binding.query ? scope.queryResults?.[binding.query] : undefined;\n        case BindingSourceKind.ComponentProperty:\n            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;\n        case BindingSourceKind.Literal:\n            return binding.value;\n    }\n}\n\nfunction sourcePath(binding: BindingExpression, kind: BindingSourceKind): string {\n    if (kind === BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;\n    return binding.path;\n}\n\nfunction readPath(source: unknown, path: string): unknown {\n    if (!path) return source;\n    return path.split('.').reduce<unknown>((current, segment) => {\n        if (current === null || current === undefined) return undefined;\n        if (typeof current !== 'object') return undefined;\n        return (current as Record<string, unknown>)[segment];\n    }, source);\n}\n"],"names":["resolveBindingExpression","binding","scope","kind","BindingSourceKind","DataContext","Literal","value","source","sourceValue","readPath","sourcePath","undefined","nullBehavior","BindingNullBehavior","Preserve","Clear","createBindingResolver","dataContext","QueryResult","query","queryResults","ComponentProperty","componentId","componentOutputs","componentPropertyPath","path","split","reduce","current","segment"],"mappings":";;;;AAAA;AACA;AAKA;;AAEC,IACM,SAASA,wBAAAA,CAAyBC,OAA0B,EAAEC,KAAmB,EAAA;AACpF,IAAA,MAAMC,IAAAA,GAAOF,OAAAA,CAAQE,IAAI,IAAIC,8BAAkBC,WAAW;AAC1D,IAAA,IAAIF,SAASC,6BAAAA,CAAkBE,OAAO,EAAE,OAAOL,QAAQM,KAAK;IAE5D,MAAMC,MAAAA,GAASC,WAAAA,CAAYR,OAAAA,EAASC,KAAAA,EAAOC,IAAAA,CAAAA;AAC3C,IAAA,MAAMI,KAAAA,GAAQG,QAAAA,CAASF,MAAAA,EAAQG,UAAAA,CAAWV,OAAAA,EAASE,IAAAA,CAAAA,CAAAA;AACnD,IAAA,IAAII,KAAAA,KAAU,IAAA,IAAQA,KAAAA,KAAUK,SAAAA,EAAW,OAAOL,KAAAA;AAElD,IAAA,IAAIN,QAAQY,YAAY,KAAKC,+BAAAA,CAAoBC,QAAQ,EAAE,OAAOH,SAAAA;AAClE,IAAA,IAAIX,QAAQY,YAAY,KAAKC,+BAAAA,CAAoBE,KAAK,EAAE,OAAO,IAAA;IAC/D,OAAOT,KAAAA;AACX;AAEA;;IAGO,SAASU,qBAAAA,CAAsBf,KAAmB,EAAA;IACrD,OAAOD,CAAAA,OAAAA,GAAWD,wBAAAA,CAAyBC,OAAAA,EAASC,KAAAA,CAAAA;AACxD;AAEA,SAASO,WAAAA,CAAYR,OAA0B,EAAEC,KAAmB,EAAEC,IAAuB,EAAA;IACzF,OAAQA,IAAAA;AACJ,QAAA,KAAKC,8BAAkBC,WAAW;AAC9B,YAAA,OAAOH,MAAMgB,WAAW;AAC5B,QAAA,KAAKd,8BAAkBe,WAAW;YAC9B,OAAOlB,OAAAA,CAAQmB,KAAK,GAAGlB,KAAAA,CAAMmB,YAAY,GAAGpB,OAAAA,CAAQmB,KAAK,CAAC,GAAGR,SAAAA;AACjE,QAAA,KAAKR,8BAAkBkB,iBAAiB;YACpC,OAAOrB,OAAAA,CAAQsB,WAAW,GAAGrB,KAAAA,CAAMsB,gBAAgB,GAAGvB,OAAAA,CAAQsB,WAAW,CAAC,GAAGX,SAAAA;AACjF,QAAA,KAAKR,8BAAkBE,OAAO;AAC1B,YAAA,OAAOL,QAAQM,KAAK;AAC5B;AACJ;AAEA,SAASI,UAAAA,CAAWV,OAA0B,EAAEE,IAAuB,EAAA;IACnE,IAAIA,IAAAA,KAASC,8BAAkBkB,iBAAiB,EAAE,OAAOrB,OAAAA,CAAQwB,qBAAqB,IAAIxB,OAAAA,CAAQyB,IAAI;AACtG,IAAA,OAAOzB,QAAQyB,IAAI;AACvB;AAEA,SAAShB,QAAAA,CAASF,MAAe,EAAEkB,IAAY,EAAA;IAC3C,IAAI,CAACA,MAAM,OAAOlB,MAAAA;AAClB,IAAA,OAAOkB,KAAKC,KAAK,CAAC,KAAKC,MAAM,CAAU,CAACC,OAAAA,EAASC,OAAAA,GAAAA;AAC7C,QAAA,IAAID,OAAAA,KAAY,IAAA,IAAQA,OAAAA,KAAYjB,SAAAA,EAAW,OAAOA,SAAAA;QACtD,IAAI,OAAOiB,OAAAA,KAAY,QAAA,EAAU,OAAOjB,SAAAA;QACxC,OAAQiB,OAAmC,CAACC,OAAAA,CAAQ;IACxD,CAAA,EAAGtB,MAAAA,CAAAA;AACP;;;"}

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/cjs/validateBindingExpression.js

@@ -0,0 +1,70 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var resolveBindingExpression = require('./resolveBindingExpression.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Validates one binding against available runtime scope and optional component dependency stack.
+ */ function validateBindingExpression(binding, scope, options = {}) {
+    const diagnostics = [];
+    const kind = binding.kind ?? scene_model.BindingSourceKind.DataContext;
+    if (kind === scene_model.BindingSourceKind.QueryResult && !binding.query) {
+        diagnostics.push(problem('missingQuery', 'Query result bindings must name the query they read from.', 'query'));
+    }
+    if (kind === scene_model.BindingSourceKind.ComponentProperty) {
+        if (!binding.componentId) {
+            diagnostics.push(problem('missingComponent', 'Component property bindings must name the source component id.', 'componentId'));
+        } else if (!scope.componentOutputs?.[binding.componentId]) {
+            diagnostics.push(problem('unknownComponent', `No component output scope exists for '${binding.componentId}'.`, 'componentId'));
+        }
+        if (binding.componentId && options.targetElementId === binding.componentId) {
+            diagnostics.push(problem('bindingCycle', `Component '${binding.componentId}' cannot bind to its own output.`, 'componentId'));
+        }
+        if (binding.componentId && options.resolvingElementIds?.includes(binding.componentId)) {
+            diagnostics.push(problem('bindingCycle', `Binding to '${binding.componentId}' would create a component binding cycle.`, 'componentId'));
+        }
+    }
+    if (binding.mode === scene_model.BindingMode.TwoWay && kind !== scene_model.BindingSourceKind.ComponentProperty) {
+        diagnostics.push(problem('unsupportedTwoWayBinding', 'Two-way bindings require a component output source.', 'mode'));
+    }
+    if (binding.expectedValueType !== undefined) {
+        const value = resolveBindingExpression.resolveBindingExpression(binding, scope);
+        if (!matchesExpectedType(value, binding.expectedValueType)) {
+            diagnostics.push(problem('bindingTypeMismatch', `Binding value does not match expected ${binding.expectedValueType}.`, 'expectedValueType'));
+        }
+    }
+    return diagnostics;
+}
+function problem(code, message, path) {
+    return {
+        code,
+        message,
+        path
+    };
+}
+function matchesExpectedType(value, type) {
+    if (value === null || value === undefined) return true;
+    switch(type){
+        case scene_model.PropertyValueType.String:
+        case scene_model.PropertyValueType.Enum:
+        case scene_model.PropertyValueType.Icon:
+        case scene_model.PropertyValueType.Destination:
+        case scene_model.PropertyValueType.QueryReference:
+            return typeof value === 'string' || typeof value === 'object' && !Array.isArray(value);
+        case scene_model.PropertyValueType.Number:
+            return typeof value === 'number' && !Number.isNaN(value);
+        case scene_model.PropertyValueType.Boolean:
+            return typeof value === 'boolean';
+        case scene_model.PropertyValueType.Collection:
+            return Array.isArray(value);
+        case scene_model.PropertyValueType.Object:
+            return typeof value === 'object' && !Array.isArray(value);
+        case scene_model.PropertyValueType.Json:
+            return true;
+    }
+}
+
+exports.validateBindingExpression = validateBindingExpression;
+//# sourceMappingURL=validateBindingExpression.js.map

package/dist/cjs/validateBindingExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateBindingExpression.js","sources":["../../validateBindingExpression.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 { BindingExpression, BindingMode, BindingSourceKind, PropertyValueType } from '@cratis/scene.model';\nimport { BindingDiagnostic } from './BindingDiagnostic';\nimport { BindingScope } from './BindingScope';\nimport { resolveBindingExpression } from './resolveBindingExpression';\n\n/**\n * Validates one binding against available runtime scope and optional component dependency stack.\n */\nexport function validateBindingExpression(\n    binding: BindingExpression,\n    scope: BindingScope,\n    options: { targetElementId?: string; resolvingElementIds?: string[] } = {},\n): BindingDiagnostic[] {\n    const diagnostics: BindingDiagnostic[] = [];\n    const kind = binding.kind ?? BindingSourceKind.DataContext;\n\n    if (kind === BindingSourceKind.QueryResult && !binding.query) {\n        diagnostics.push(problem('missingQuery', 'Query result bindings must name the query they read from.', 'query'));\n    }\n\n    if (kind === BindingSourceKind.ComponentProperty) {\n        if (!binding.componentId) {\n            diagnostics.push(problem('missingComponent', 'Component property bindings must name the source component id.', 'componentId'));\n        } else if (!scope.componentOutputs?.[binding.componentId]) {\n            diagnostics.push(problem('unknownComponent', `No component output scope exists for '${binding.componentId}'.`, 'componentId'));\n        }\n\n        if (binding.componentId && options.targetElementId === binding.componentId) {\n            diagnostics.push(problem('bindingCycle', `Component '${binding.componentId}' cannot bind to its own output.`, 'componentId'));\n        }\n\n        if (binding.componentId && options.resolvingElementIds?.includes(binding.componentId)) {\n            diagnostics.push(problem('bindingCycle', `Binding to '${binding.componentId}' would create a component binding cycle.`, 'componentId'));\n        }\n    }\n\n    if (binding.mode === BindingMode.TwoWay && kind !== BindingSourceKind.ComponentProperty) {\n        diagnostics.push(problem('unsupportedTwoWayBinding', 'Two-way bindings require a component output source.', 'mode'));\n    }\n\n    if (binding.expectedValueType !== undefined) {\n        const value = resolveBindingExpression(binding, scope);\n        if (!matchesExpectedType(value, binding.expectedValueType)) {\n            diagnostics.push(problem('bindingTypeMismatch', `Binding value does not match expected ${binding.expectedValueType}.`, 'expectedValueType'));\n        }\n    }\n\n    return diagnostics;\n}\n\nfunction problem(code: string, message: string, path?: string): BindingDiagnostic {\n    return { code, message, path };\n}\n\nfunction matchesExpectedType(value: unknown, type: PropertyValueType): boolean {\n    if (value === null || value === undefined) return true;\n    switch (type) {\n        case PropertyValueType.String:\n        case PropertyValueType.Enum:\n        case PropertyValueType.Icon:\n        case PropertyValueType.Destination:\n        case PropertyValueType.QueryReference:\n            return typeof value === 'string' || (typeof value === 'object' && !Array.isArray(value));\n        case PropertyValueType.Number:\n            return typeof value === 'number' && !Number.isNaN(value);\n        case PropertyValueType.Boolean:\n            return typeof value === 'boolean';\n        case PropertyValueType.Collection:\n            return Array.isArray(value);\n        case PropertyValueType.Object:\n            return typeof value === 'object' && !Array.isArray(value);\n        case PropertyValueType.Json:\n            return true;\n    }\n}\n"],"names":["validateBindingExpression","binding","scope","options","diagnostics","kind","BindingSourceKind","DataContext","QueryResult","query","push","problem","ComponentProperty","componentId","componentOutputs","targetElementId","resolvingElementIds","includes","mode","BindingMode","TwoWay","expectedValueType","undefined","value","resolveBindingExpression","matchesExpectedType","code","message","path","type","PropertyValueType","String","Enum","Icon","Destination","QueryReference","Array","isArray","Number","isNaN","Boolean","Collection","Object","Json"],"mappings":"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"}

package/dist/cjs/validateNavigationDestinations.js

@@ -0,0 +1,48 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Validates destinations against the outlet/route declarations owned by layouts and templates.
+ */ function validateNavigationDestinations(destinations, surfaces = {}) {
+    const diagnostics = [];
+    const outlets = new Set();
+    const routes = new Set();
+    for (const surface of [
+        ...surfaces.layouts ?? [],
+        ...surfaces.screenTemplates ?? []
+    ]){
+        for (const outlet of surface.outlets ?? []){
+            if (outlets.has(outlet.name)) diagnostics.push({
+                code: 'duplicateOutlet',
+                message: `Outlet '${outlet.name}' is declared more than once.`
+            });
+            outlets.add(outlet.name);
+        }
+    }
+    for (const destination of destinations){
+        if (destination.outlet && !outlets.has(destination.outlet)) {
+            diagnostics.push({
+                code: 'missingOutlet',
+                message: `Destination targets missing outlet '${destination.outlet}'.`
+            });
+        }
+        if (destination.route) {
+            if (routes.has(destination.route)) diagnostics.push({
+                code: 'duplicateRoute',
+                message: `Route '${destination.route}' is used by more than one destination.`
+            });
+            routes.add(destination.route);
+        }
+        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {
+            diagnostics.push({
+                code: 'unavailableTarget',
+                message: 'Destination must name a screen, stable identity, route or dialog.'
+            });
+        }
+    }
+    return diagnostics;
+}
+
+exports.validateNavigationDestinations = validateNavigationDestinations;
+//# sourceMappingURL=validateNavigationDestinations.js.map

package/dist/cjs/validateNavigationDestinations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateNavigationDestinations.js","sources":["../../validateNavigationDestinations.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 { DestinationReference, Layout, ScreenTemplate } from '@cratis/scene.model';\n\nexport interface NavigationDestinationDiagnostic {\n    code: string;\n    message: string;\n}\n\n/**\n * Validates destinations against the outlet/route declarations owned by layouts and templates.\n */\nexport function validateNavigationDestinations(\n    destinations: DestinationReference[],\n    surfaces: { layouts?: Layout[]; screenTemplates?: ScreenTemplate[] } = {},\n): NavigationDestinationDiagnostic[] {\n    const diagnostics: NavigationDestinationDiagnostic[] = [];\n    const outlets = new Set<string>();\n    const routes = new Set<string>();\n\n    for (const surface of [...(surfaces.layouts ?? []), ...(surfaces.screenTemplates ?? [])]) {\n        for (const outlet of surface.outlets ?? []) {\n            if (outlets.has(outlet.name)) diagnostics.push({ code: 'duplicateOutlet', message: `Outlet '${outlet.name}' is declared more than once.` });\n            outlets.add(outlet.name);\n        }\n    }\n\n    for (const destination of destinations) {\n        if (destination.outlet && !outlets.has(destination.outlet)) {\n            diagnostics.push({ code: 'missingOutlet', message: `Destination targets missing outlet '${destination.outlet}'.` });\n        }\n        if (destination.route) {\n            if (routes.has(destination.route)) diagnostics.push({ code: 'duplicateRoute', message: `Route '${destination.route}' is used by more than one destination.` });\n            routes.add(destination.route);\n        }\n        if (!destination.screen && !destination.module && !destination.route && !destination.dialog) {\n            diagnostics.push({ code: 'unavailableTarget', message: 'Destination must name a screen, stable identity, route or dialog.' });\n        }\n    }\n\n    return diagnostics;\n}\n"],"names":["validateNavigationDestinations","destinations","surfaces","diagnostics","outlets","Set","routes","surface","layouts","screenTemplates","outlet","has","name","push","code","message","add","destination","route","screen","module","dialog"],"mappings":";;AAAA;AACA;AASA;;AAEC,IACM,SAASA,8BAAAA,CACZC,YAAoC,EACpCC,QAAAA,GAAuE,EAAE,EAAA;AAEzE,IAAA,MAAMC,cAAiD,EAAE;AACzD,IAAA,MAAMC,UAAU,IAAIC,GAAAA,EAAAA;AACpB,IAAA,MAAMC,SAAS,IAAID,GAAAA,EAAAA;AAEnB,IAAA,KAAK,MAAME,OAAAA,IAAW;WAAKL,QAAAA,CAASM,OAAO,IAAI,EAAE;WAAON,QAAAA,CAASO,eAAe,IAAI;KAAI,CAAE;AACtF,QAAA,KAAK,MAAMC,MAAAA,IAAUH,OAAAA,CAAQH,OAAO,IAAI,EAAE,CAAE;YACxC,IAAIA,OAAAA,CAAQO,GAAG,CAACD,MAAAA,CAAOE,IAAI,CAAA,EAAGT,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,iBAAA;AAAmBC,gBAAAA,OAAAA,EAAS,CAAC,QAAQ,EAAEL,OAAOE,IAAI,CAAC,6BAA6B;AAAE,aAAA,CAAA;YACzIR,OAAAA,CAAQY,GAAG,CAACN,MAAAA,CAAOE,IAAI,CAAA;AAC3B,QAAA;AACJ,IAAA;IAEA,KAAK,MAAMK,eAAehB,YAAAA,CAAc;QACpC,IAAIgB,WAAAA,CAAYP,MAAM,IAAI,CAACN,QAAQO,GAAG,CAACM,WAAAA,CAAYP,MAAM,CAAA,EAAG;AACxDP,YAAAA,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,eAAA;AAAiBC,gBAAAA,OAAAA,EAAS,CAAC,oCAAoC,EAAEE,YAAYP,MAAM,CAAC,EAAE;AAAE,aAAA,CAAA;AACrH,QAAA;QACA,IAAIO,WAAAA,CAAYC,KAAK,EAAE;YACnB,IAAIZ,MAAAA,CAAOK,GAAG,CAACM,WAAAA,CAAYC,KAAK,CAAA,EAAGf,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,gBAAA;AAAkBC,gBAAAA,OAAAA,EAAS,CAAC,OAAO,EAAEE,YAAYC,KAAK,CAAC,uCAAuC;AAAE,aAAA,CAAA;YAC5JZ,MAAAA,CAAOU,GAAG,CAACC,WAAAA,CAAYC,KAAK,CAAA;AAChC,QAAA;AACA,QAAA,IAAI,CAACD,WAAAA,CAAYE,MAAM,IAAI,CAACF,WAAAA,CAAYG,MAAM,IAAI,CAACH,YAAYC,KAAK,IAAI,CAACD,WAAAA,CAAYI,MAAM,EAAE;AACzFlB,YAAAA,WAAAA,CAAYU,IAAI,CAAC;gBAAEC,IAAAA,EAAM,mBAAA;gBAAqBC,OAAAA,EAAS;AAAoE,aAAA,CAAA;AAC/H,QAAA;AACJ,IAAA;IAEA,OAAOZ,WAAAA;AACX;;"}

package/dist/esm/BindingDiagnostic.d.ts

@@ -0,0 +1,6 @@
+export interface BindingDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+}
+//# sourceMappingURL=BindingDiagnostic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BindingDiagnostic.d.ts","sourceRoot":"","sources":["../../BindingDiagnostic.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/esm/BindingDiagnostic.js

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

package/dist/esm/BindingDiagnostic.js.map

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

package/dist/esm/BindingScope.d.ts

@@ -0,0 +1,6 @@
+export interface BindingScope {
+    dataContext?: unknown;
+    queryResults?: Record<string, unknown>;
+    componentOutputs?: Record<string, Record<string, unknown>>;
+}
+//# sourceMappingURL=BindingScope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BindingScope.d.ts","sourceRoot":"","sources":["../../BindingScope.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAEzB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9D"}

package/dist/esm/BindingScope.js

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

package/dist/esm/BindingScope.js.map

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

package/dist/esm/index.d.ts

@@ -1,5 +1,9 @@
 export * from './Renderer';
 export * from './BindingResolver';
+export * from './BindingScope';
+export * from './BindingDiagnostic';
+export * from './resolveBindingExpression';
+export * from './validateBindingExpression';
 export * from './renderElement';
 export * from './elementKind';
 export * from './panelKind';
@@ -18,11 +22,13 @@ export * from './packageVersionRange';
 export * from './resolvePackageDependencies';
 export * from './packageCatalog';
 export * from './resolveScreenTemplates';
+export * from './templateApplicability';
 export * from './buildStarterProfile';
 export * from './incompatibleStarterThemes';
 export * from './ActionDispatcher';
 export * from './runActions';
 export * from './resolveBehaviors';
 export * from './resolveStrings';
+export * from './validateNavigationDestinations';
 export * from './editing';
 //# sourceMappingURL=index.d.ts.map

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,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,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,kCAAkC,CAAC;AACjD,cAAc,WAAW,CAAC"}

package/dist/esm/index.js

@@ -1,3 +1,5 @@
+export { createBindingResolver, resolveBindingExpression } from './resolveBindingExpression.js';
+export { validateBindingExpression } from './validateBindingExpression.js';
 export { renderElement } from './renderElement.js';
 export { isContentControl, isExternalComponent, isItemsControl, isPanel } from './elementKind.js';
 export { isCanvas, isDockPanel, isGrid, isStackPanel, isWrapPanel } from './panelKind.js';
@@ -18,11 +20,13 @@ 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';
 export { resolveApplicationTriggerBehaviors, resolveBehaviors, resolveEventBehaviors, resolveIntervalBehaviors } from './resolveBehaviors.js';
 export { isStringsReference, resolveStringsInElement, resolveStringsValue } from './resolveStrings.js';
+export { validateNavigationDestinations } from './validateNavigationDestinations.js';
 export { errorDiagnostic, hasErrors, warningDiagnostic } from './editing/diagnostics.js';
 export { dialogTemplateNodeId, elementNodeId, flowNodeId, freeformNodeId, layoutNodeId, ownerArrangementId, placementNodeId, scopeInstanceId, scopeNodeId, screenNodeId, screenTemplateNodeId, slotNodeId } from './editing/nodeIds.js';
 export { layoutTypeDescriptors, placementProperties, templateProperties } from './editing/layoutTypeDescriptors.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/resolveBindingExpression.d.ts

@@ -0,0 +1,5 @@
+import { BindingExpression } from '@cratis/scene.model';
+import { BindingScope } from './BindingScope';
+export declare function resolveBindingExpression(binding: BindingExpression, scope: BindingScope): unknown;
+export declare function createBindingResolver(scope: BindingScope): (binding: BindingExpression) => unknown;
+//# sourceMappingURL=resolveBindingExpression.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBindingExpression.d.ts","sourceRoot":"","sources":["../../resolveBindingExpression.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAA0C,MAAM,qBAAqB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAWjG;AAKD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAElG"}

package/dist/esm/resolveBindingExpression.js

@@ -0,0 +1,48 @@
+import { BindingSourceKind, BindingNullBehavior } 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.
+/**
+ * Resolves a typed binding against the shared runtime binding scope.
+ */ function resolveBindingExpression(binding, scope) {
+    const kind = binding.kind ?? BindingSourceKind.DataContext;
+    if (kind === BindingSourceKind.Literal) return binding.value;
+    const source = sourceValue(binding, scope, kind);
+    const value = readPath(source, sourcePath(binding, kind));
+    if (value !== null && value !== undefined) return value;
+    if (binding.nullBehavior === BindingNullBehavior.Preserve) return undefined;
+    if (binding.nullBehavior === BindingNullBehavior.Clear) return null;
+    return value;
+}
+/**
+ * Creates a legacy resolver function from a binding scope.
+ */ function createBindingResolver(scope) {
+    return (binding)=>resolveBindingExpression(binding, scope);
+}
+function sourceValue(binding, scope, kind) {
+    switch(kind){
+        case BindingSourceKind.DataContext:
+            return scope.dataContext;
+        case BindingSourceKind.QueryResult:
+            return binding.query ? scope.queryResults?.[binding.query] : undefined;
+        case BindingSourceKind.ComponentProperty:
+            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;
+        case BindingSourceKind.Literal:
+            return binding.value;
+    }
+}
+function sourcePath(binding, kind) {
+    if (kind === BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;
+    return binding.path;
+}
+function readPath(source, path) {
+    if (!path) return source;
+    return path.split('.').reduce((current, segment)=>{
+        if (current === null || current === undefined) return undefined;
+        if (typeof current !== 'object') return undefined;
+        return current[segment];
+    }, source);
+}
+
+export { createBindingResolver, resolveBindingExpression };
+//# sourceMappingURL=resolveBindingExpression.js.map

package/dist/esm/resolveBindingExpression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBindingExpression.js","sources":["../../resolveBindingExpression.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 { BindingExpression, BindingNullBehavior, BindingSourceKind } from '@cratis/scene.model';\nimport { BindingScope } from './BindingScope';\n\n/**\n * Resolves a typed binding against the shared runtime binding scope.\n */\nexport function resolveBindingExpression(binding: BindingExpression, scope: BindingScope): unknown {\n    const kind = binding.kind ?? BindingSourceKind.DataContext;\n    if (kind === BindingSourceKind.Literal) return binding.value;\n\n    const source = sourceValue(binding, scope, kind);\n    const value = readPath(source, sourcePath(binding, kind));\n    if (value !== null && value !== undefined) return value;\n\n    if (binding.nullBehavior === BindingNullBehavior.Preserve) return undefined;\n    if (binding.nullBehavior === BindingNullBehavior.Clear) return null;\n    return value;\n}\n\n/**\n * Creates a legacy resolver function from a binding scope.\n */\nexport function createBindingResolver(scope: BindingScope): (binding: BindingExpression) => unknown {\n    return binding => resolveBindingExpression(binding, scope);\n}\n\nfunction sourceValue(binding: BindingExpression, scope: BindingScope, kind: BindingSourceKind): unknown {\n    switch (kind) {\n        case BindingSourceKind.DataContext:\n            return scope.dataContext;\n        case BindingSourceKind.QueryResult:\n            return binding.query ? scope.queryResults?.[binding.query] : undefined;\n        case BindingSourceKind.ComponentProperty:\n            return binding.componentId ? scope.componentOutputs?.[binding.componentId] : undefined;\n        case BindingSourceKind.Literal:\n            return binding.value;\n    }\n}\n\nfunction sourcePath(binding: BindingExpression, kind: BindingSourceKind): string {\n    if (kind === BindingSourceKind.ComponentProperty) return binding.componentPropertyPath ?? binding.path;\n    return binding.path;\n}\n\nfunction readPath(source: unknown, path: string): unknown {\n    if (!path) return source;\n    return path.split('.').reduce<unknown>((current, segment) => {\n        if (current === null || current === undefined) return undefined;\n        if (typeof current !== 'object') return undefined;\n        return (current as Record<string, unknown>)[segment];\n    }, source);\n}\n"],"names":["resolveBindingExpression","binding","scope","kind","BindingSourceKind","DataContext","Literal","value","source","sourceValue","readPath","sourcePath","undefined","nullBehavior","BindingNullBehavior","Preserve","Clear","createBindingResolver","dataContext","QueryResult","query","queryResults","ComponentProperty","componentId","componentOutputs","componentPropertyPath","path","split","reduce","current","segment"],"mappings":";;AAAA;AACA;AAKA;;AAEC,IACM,SAASA,wBAAAA,CAAyBC,OAA0B,EAAEC,KAAmB,EAAA;AACpF,IAAA,MAAMC,IAAAA,GAAOF,OAAAA,CAAQE,IAAI,IAAIC,kBAAkBC,WAAW;AAC1D,IAAA,IAAIF,SAASC,iBAAAA,CAAkBE,OAAO,EAAE,OAAOL,QAAQM,KAAK;IAE5D,MAAMC,MAAAA,GAASC,WAAAA,CAAYR,OAAAA,EAASC,KAAAA,EAAOC,IAAAA,CAAAA;AAC3C,IAAA,MAAMI,KAAAA,GAAQG,QAAAA,CAASF,MAAAA,EAAQG,UAAAA,CAAWV,OAAAA,EAASE,IAAAA,CAAAA,CAAAA;AACnD,IAAA,IAAII,KAAAA,KAAU,IAAA,IAAQA,KAAAA,KAAUK,SAAAA,EAAW,OAAOL,KAAAA;AAElD,IAAA,IAAIN,QAAQY,YAAY,KAAKC,mBAAAA,CAAoBC,QAAQ,EAAE,OAAOH,SAAAA;AAClE,IAAA,IAAIX,QAAQY,YAAY,KAAKC,mBAAAA,CAAoBE,KAAK,EAAE,OAAO,IAAA;IAC/D,OAAOT,KAAAA;AACX;AAEA;;IAGO,SAASU,qBAAAA,CAAsBf,KAAmB,EAAA;IACrD,OAAOD,CAAAA,OAAAA,GAAWD,wBAAAA,CAAyBC,OAAAA,EAASC,KAAAA,CAAAA;AACxD;AAEA,SAASO,WAAAA,CAAYR,OAA0B,EAAEC,KAAmB,EAAEC,IAAuB,EAAA;IACzF,OAAQA,IAAAA;AACJ,QAAA,KAAKC,kBAAkBC,WAAW;AAC9B,YAAA,OAAOH,MAAMgB,WAAW;AAC5B,QAAA,KAAKd,kBAAkBe,WAAW;YAC9B,OAAOlB,OAAAA,CAAQmB,KAAK,GAAGlB,KAAAA,CAAMmB,YAAY,GAAGpB,OAAAA,CAAQmB,KAAK,CAAC,GAAGR,SAAAA;AACjE,QAAA,KAAKR,kBAAkBkB,iBAAiB;YACpC,OAAOrB,OAAAA,CAAQsB,WAAW,GAAGrB,KAAAA,CAAMsB,gBAAgB,GAAGvB,OAAAA,CAAQsB,WAAW,CAAC,GAAGX,SAAAA;AACjF,QAAA,KAAKR,kBAAkBE,OAAO;AAC1B,YAAA,OAAOL,QAAQM,KAAK;AAC5B;AACJ;AAEA,SAASI,UAAAA,CAAWV,OAA0B,EAAEE,IAAuB,EAAA;IACnE,IAAIA,IAAAA,KAASC,kBAAkBkB,iBAAiB,EAAE,OAAOrB,OAAAA,CAAQwB,qBAAqB,IAAIxB,OAAAA,CAAQyB,IAAI;AACtG,IAAA,OAAOzB,QAAQyB,IAAI;AACvB;AAEA,SAAShB,QAAAA,CAASF,MAAe,EAAEkB,IAAY,EAAA;IAC3C,IAAI,CAACA,MAAM,OAAOlB,MAAAA;AAClB,IAAA,OAAOkB,KAAKC,KAAK,CAAC,KAAKC,MAAM,CAAU,CAACC,OAAAA,EAASC,OAAAA,GAAAA;AAC7C,QAAA,IAAID,OAAAA,KAAY,IAAA,IAAQA,OAAAA,KAAYjB,SAAAA,EAAW,OAAOA,SAAAA;QACtD,IAAI,OAAOiB,OAAAA,KAAY,QAAA,EAAU,OAAOjB,SAAAA;QACxC,OAAQiB,OAAmC,CAACC,OAAAA,CAAQ;IACxD,CAAA,EAAGtB,MAAAA,CAAAA;AACP;;"}

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"}