@cratis/scene.blueprint.default 4.33.0 → 4.34.0

package/dist/esm/preview-host/previewProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewProfile.js","sources":["../../../preview-host/previewProfile.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 type { UiProfile } from '@cratis/scene.model';\nimport type { PackageCatalog } from '@cratis/scene.engine';\nimport { ComponentName } from '../ComponentName';\nimport { defaultBlueprintName } from '../packageName';\nimport { coreComponents } from '@cratis/scene.react';\n\n/** The packages every preview and Stage application resolves bare component names against, in ascending priority. */\nexport const requiredPackages = ['core', defaultBlueprintName];\n\n/** What the packages every host has declare, so a bare name resolves to the package that provides it. */\nexport const blueprintPackageCatalog: PackageCatalog = {\n    core: Object.keys(coreComponents).map(key => key.slice(key.indexOf(':') + 1)),\n    [defaultBlueprintName]: Object.values(ComponentName),\n};\n\n/**\n * The profile an application renders against: the document's own web profile (else its first), with the packages every host\n * renders with admitted even when the model never named them - without that, a template written against the blueprint's\n * vocabulary would come out as a column of dashed placeholders. A host with more packages (PrimeReact, a custom set) lists them\n * in `additionalPackages`.\n *\n * The profile's `sampleData` is carried through: it is where the application chose its active pack (spec 11, SD3).\n *\n * @param profiles The profiles the document declares.\n * @param additionalPackages Packages the host renders with beyond the required ones, lowest priority first.\n * @returns The profile to resolve component names with.\n */\nexport function previewProfile(profiles: UiProfile[] | undefined, additionalPackages: string[] = []): UiProfile {\n    const declared = profiles?.find(profile => profile.targetPlatform === 'web') ?? profiles?.[0];\n    const packages = [...(declared?.packages ?? [])];\n    for (const required of [...requiredPackages, ...additionalPackages]) {\n        if (!packages.includes(required)) packages.push(required);\n    }\n\n    return {\n        name: declared?.name ?? 'Preview',\n        targetPlatform: declared?.targetPlatform ?? 'web',\n        packages,\n        defaultSizeClass: declared?.defaultSizeClass,\n        layout: declared?.layout,\n        theme: declared?.theme,\n        sampleData: declared?.sampleData,\n    };\n}\n"],"names":["requiredPackages","defaultBlueprintName","blueprintPackageCatalog","core","Object","keys","coreComponents","map","key","slice","indexOf","values","ComponentName","previewProfile","profiles","additionalPackages","declared","find","profile","targetPlatform","packages","required","includes","push","name","defaultSizeClass","layout","theme","sampleData"],"mappings":";;;;AAAA;AACA;AAQA,sHACO,MAAMA,gBAAAA,GAAmB;AAAC,IAAA,MAAA;AAAQC,IAAAA;;AAEzC,0GACO,MAAMC,uBAAAA,GAA0C;AACnDC,IAAAA,IAAAA,EAAMC,MAAAA,CAAOC,IAAI,CAACC,cAAAA,CAAAA,CAAgBC,GAAG,CAACC,CAAAA,GAAAA,GAAOA,GAAAA,CAAIC,KAAK,CAACD,GAAAA,CAAIE,OAAO,CAAC,GAAA,CAAA,GAAO,CAAA,CAAA,CAAA;AAC1E,IAAA,CAACT,oBAAAA,GAAuBG,MAAAA,CAAOO,MAAM,CAACC,aAAAA;AAC1C;AAEA;;;;;;;;;;;AAWC,IACM,SAASC,cAAAA,CAAeC,QAAiC,EAAEC,qBAA+B,EAAE,EAAA;IAC/F,MAAMC,QAAAA,GAAWF,QAAAA,EAAUG,IAAAA,CAAKC,CAAAA,OAAAA,GAAWA,OAAAA,CAAQC,cAAc,KAAK,KAAA,CAAA,IAAUL,QAAAA,GAAW,CAAA,CAAE;AAC7F,IAAA,MAAMM,QAAAA,GAAW;AAAKJ,QAAAA,GAAAA,QAAAA,EAAUI,YAAY;AAAI,KAAA;AAChD,IAAA,KAAK,MAAMC,QAAAA,IAAY;AAAIrB,QAAAA,GAAAA,gBAAAA;AAAqBe,QAAAA,GAAAA;KAAmB,CAAE;AACjE,QAAA,IAAI,CAACK,QAAAA,CAASE,QAAQ,CAACD,QAAAA,CAAAA,EAAWD,QAAAA,CAASG,IAAI,CAACF,QAAAA,CAAAA;AACpD,IAAA;IAEA,OAAO;AACHG,QAAAA,IAAAA,EAAMR,UAAUQ,IAAAA,IAAQ,SAAA;AACxBL,QAAAA,cAAAA,EAAgBH,UAAUG,cAAAA,IAAkB,KAAA;AAC5CC,QAAAA,QAAAA;AACAK,QAAAA,gBAAAA,EAAkBT,QAAAA,EAAUS,gBAAAA;AAC5BC,QAAAA,MAAAA,EAAQV,QAAAA,EAAUU,MAAAA;AAClBC,QAAAA,KAAAA,EAAOX,QAAAA,EAAUW,KAAAA;AACjBC,QAAAA,UAAAA,EAAYZ,QAAAA,EAAUY;AAC1B,KAAA;AACJ;;"}

package/dist/esm/preview-host/previewSampleData.d.ts

@@ -0,0 +1,22 @@
+import { SampleDataPack, SampleShape } from '@cratis/scene.model';
+import { BindingResolver, SampleDataResolution } from '@cratis/scene.engine';
+import type { SliceCommandField } from '@cratis/scene.react';
+import { ApplicationDocument } from './ApplicationDocument';
+export interface PreviewSampleData {
+    packs: SampleDataPack[];
+    sessionActivePack?: string;
+    blueprintDefaultPack?: string;
+    locale?: string;
+    seed?: number;
+    rowCount?: number;
+    shapes?: Record<string, SampleShape>;
+}
+export interface PreviewSampleDataSource {
+    rows(target: string, shape?: SampleShape): SampleDataResolution;
+    queryResults: Record<string, unknown>;
+    resolveBinding: BindingResolver;
+    commandFields(command: string, fields: SliceCommandField[]): SliceCommandField[];
+}
+export declare function collectQueryNames(value: unknown): string[];
+export declare function createPreviewSampleData(application: ApplicationDocument, sample?: PreviewSampleData): PreviewSampleDataSource;
+//# sourceMappingURL=previewSampleData.d.ts.map

package/dist/esm/preview-host/previewSampleData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewSampleData.d.ts","sourceRoot":"","sources":["../../../preview-host/previewSampleData.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAqB,MAAM,sBAAsB,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D,MAAM,WAAW,iBAAiB;IAE9B,KAAK,EAAE,cAAc,EAAE,CAAC;IAGxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACxC;AAGD,MAAM,WAAW,uBAAuB;IAEpC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,oBAAoB,CAAC;IAGhE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGtC,cAAc,EAAE,eAAe,CAAC;IAGhC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,EAAE,CAAC;CACpF;AAKD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAiB1D;AA2BD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,GAAE,iBAA4B,GAAG,uBAAuB,CA2CvI"}

package/dist/esm/preview-host/previewSampleData.js

@@ -0,0 +1,113 @@
+import { resolveSampleData } from '@cratis/scene.engine';
+import { previewProfile } from './previewProfile.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const noSample = {
+    packs: []
+};
+/** The names of the queries a document binds: every `query` it names, in bindings and on components. */ function collectQueryNames(value) {
+    const names = new Set();
+    const visit = (candidate)=>{
+        if (candidate === null || typeof candidate !== 'object') return;
+        if (Array.isArray(candidate)) {
+            candidate.forEach(visit);
+            return;
+        }
+        for (const [key, entry] of Object.entries(candidate)){
+            if (key === 'query' && typeof entry === 'string' && entry.length > 0) names.add(entry);
+            else visit(entry);
+        }
+    };
+    visit(value);
+    return [
+        ...names
+    ];
+}
+function readPath(source, path) {
+    if (!path) return source;
+    return path.split('.').reduce((current, segment)=>{
+        if (current === null || current === undefined || typeof current !== 'object') return undefined;
+        if (Array.isArray(current)) return /^(0|[1-9][0-9]*)$/.test(segment) ? current[Number(segment)] : undefined;
+        return Object.hasOwn(current, segment) ? current[segment] : undefined;
+    }, source);
+}
+function shapeOfFields(name, fields) {
+    return {
+        name,
+        fields: fields.map((field)=>({
+                name: field.name,
+                type: field.type
+            }))
+    };
+}
+function scalar(value) {
+    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' ? value : undefined;
+}
+/**
+ * Plugs the sample data resolution into what a preview renders with (PRV6). Nothing here decides what a row looks like - that is
+ * `resolveSampleData` - this only asks it, with the application profile's selection, for the queries the document binds and the
+ * commands its slices accept. It is design/preview time only: a production host never builds one (SD6).
+ *
+ * @param application The document whose profile carries the selection and whose bindings are scanned.
+ * @param sample The packs, session override and seed.
+ */ function createPreviewSampleData(application, sample = noSample) {
+    const profile = previewProfile(application.uiProfiles);
+    const context = {
+        packs: sample.packs,
+        profile,
+        sessionActivePack: sample.sessionActivePack,
+        blueprintDefaultPack: sample.blueprintDefaultPack,
+        locale: sample.locale,
+        seed: sample.seed,
+        rowCount: sample.rowCount,
+        isDesignOrPreview: true
+    };
+    const rows = (target, shape)=>{
+        const known = shape ?? sample.shapes?.[target];
+        const resolved = resolveSampleData({
+            target,
+            ...known === undefined ? {} : {
+                shape: known
+            }
+        }, context);
+        if (resolved.rows.length > 0 || !target.includes('.')) return resolved;
+        const short = target.slice(target.lastIndexOf('.') + 1);
+        return resolveSampleData({
+            target: short,
+            ...known === undefined ? {} : {
+                shape: known
+            }
+        }, context);
+    };
+    const queryResults = {};
+    for (const name of collectQueryNames([
+        application.screens,
+        application.screenTemplates,
+        application.dialogTemplates ?? [],
+        application.layouts
+    ])){
+        const resolved = rows(name);
+        if (resolved.rows.length > 0) queryResults[name] = resolved.rows;
+    }
+    return {
+        rows,
+        queryResults,
+        resolveBinding: (binding)=>binding.query ? readPath(queryResults[binding.query], binding.path) : undefined,
+        commandFields: (command, fields)=>{
+            const first = rows(command, shapeOfFields(command, fields)).rows[0];
+            if (!first) return fields;
+            return fields.map((field)=>{
+                const key = Object.keys(first).find((candidate)=>candidate.toLowerCase() === field.name.toLowerCase());
+                const value = key === undefined ? undefined : scalar(first[key]);
+                return value === undefined ? field : {
+                    ...field,
+                    initialValue: value
+                };
+            });
+        }
+    };
+}
+
+export { collectQueryNames, createPreviewSampleData };
+//# sourceMappingURL=previewSampleData.js.map

package/dist/esm/preview-host/previewSampleData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewSampleData.js","sources":["../../../preview-host/previewSampleData.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, SampleDataPack, SampleShape } from '@cratis/scene.model';\nimport { BindingResolver, SampleDataResolution, resolveSampleData } from '@cratis/scene.engine';\nimport type { SliceCommandField } from '@cratis/scene.react';\nimport { ApplicationDocument } from './ApplicationDocument';\nimport { previewProfile } from './previewProfile';\n\n/**\n * Which sample data a preview shows (spec 11, PRV6). The active pack is the application profile's (`sampleData.activePack`),\n * chosen once for the whole application; `sessionActivePack` is the preview strip's selector, a session-only override of that\n * setting - not a second source of truth. Resolution is `resolveSampleData`'s: bound pack, active pack, the blueprint's default\n * pack, then generated data, and the same seed gives the same rows every time.\n */\nexport interface PreviewSampleData {\n    /** Every pack available: the blueprints' and the author's own. */\n    packs: SampleDataPack[];\n\n    /** The preview strip's choice for this session: a pack id, or the empty string for generated data. Absent leaves the profile's. */\n    sessionActivePack?: string;\n\n    /** The default pack of the blueprint the templates came from. */\n    blueprintDefaultPack?: string;\n\n    /** The locale of generated data when no pack supplies one. */\n    locale?: string;\n\n    /** The seed for generated data; 1 by default, so previews are stable. */\n    seed?: number;\n\n    /** The number of generated rows. */\n    rowCount?: number;\n\n    /** The shape of the rows of each read model or query, by name, for generating rows where no pack has them. */\n    shapes?: Record<string, SampleShape>;\n}\n\n/** What a preview reads its data from. */\nexport interface PreviewSampleDataSource {\n    /** The rows for a read model or query; empty when nothing supplies any. */\n    rows(target: string, shape?: SampleShape): SampleDataResolution;\n\n    /** The rows of every query the document binds, by query name - the `queryResults` of the render scope. */\n    queryResults: Record<string, unknown>;\n\n    /** Resolves a binding that names a query against the sample rows. */\n    resolveBinding: BindingResolver;\n\n    /** Starting values for a command's fields from the sample rows, for the task dialog of a slice. */\n    commandFields(command: string, fields: SliceCommandField[]): SliceCommandField[];\n}\n\nconst noSample: PreviewSampleData = { packs: [] };\n\n/** The names of the queries a document binds: every `query` it names, in bindings and on components. */\nexport function collectQueryNames(value: unknown): string[] {\n    const names = new Set<string>();\n    const visit = (candidate: unknown) => {\n        if (candidate === null || typeof candidate !== 'object') return;\n        if (Array.isArray(candidate)) {\n            candidate.forEach(visit);\n            return;\n        }\n\n        for (const [key, entry] of Object.entries(candidate as Record<string, unknown>)) {\n            if (key === 'query' && typeof entry === 'string' && entry.length > 0) names.add(entry);\n            else visit(entry);\n        }\n    };\n\n    visit(value);\n    return [...names];\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 || typeof current !== 'object') return undefined;\n        if (Array.isArray(current)) return /^(0|[1-9][0-9]*)$/.test(segment) ? current[Number(segment)] : undefined;\n        return Object.hasOwn(current, segment) ? (current as Record<string, unknown>)[segment] : undefined;\n    }, source);\n}\n\nfunction shapeOfFields(name: string, fields: SliceCommandField[]): SampleShape {\n    return { name, fields: fields.map(field => ({ name: field.name, type: field.type })) };\n}\n\nfunction scalar(value: unknown): string | number | boolean | undefined {\n    return typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' ? value : undefined;\n}\n\n/**\n * Plugs the sample data resolution into what a preview renders with (PRV6). Nothing here decides what a row looks like - that is\n * `resolveSampleData` - this only asks it, with the application profile's selection, for the queries the document binds and the\n * commands its slices accept. It is design/preview time only: a production host never builds one (SD6).\n *\n * @param application The document whose profile carries the selection and whose bindings are scanned.\n * @param sample The packs, session override and seed.\n */\nexport function createPreviewSampleData(application: ApplicationDocument, sample: PreviewSampleData = noSample): PreviewSampleDataSource {\n    const profile = previewProfile(application.uiProfiles);\n    const context = {\n        packs: sample.packs,\n        profile,\n        sessionActivePack: sample.sessionActivePack,\n        blueprintDefaultPack: sample.blueprintDefaultPack,\n        locale: sample.locale,\n        seed: sample.seed,\n        rowCount: sample.rowCount,\n        isDesignOrPreview: true,\n    };\n\n    const rows = (target: string, shape?: SampleShape): SampleDataResolution => {\n        const known = shape ?? sample.shapes?.[target];\n        const resolved = resolveSampleData({ target, ...(known === undefined ? {} : { shape: known }) }, context);\n        if (resolved.rows.length > 0 || !target.includes('.')) return resolved;\n\n        const short = target.slice(target.lastIndexOf('.') + 1);\n        return resolveSampleData({ target: short, ...(known === undefined ? {} : { shape: known }) }, context);\n    };\n\n    const queryResults: Record<string, unknown> = {};\n    for (const name of collectQueryNames([application.screens, application.screenTemplates, application.dialogTemplates ?? [], application.layouts])) {\n        const resolved = rows(name);\n        if (resolved.rows.length > 0) queryResults[name] = resolved.rows;\n    }\n\n    return {\n        rows,\n        queryResults,\n        resolveBinding: (binding: BindingExpression) => binding.query ? readPath(queryResults[binding.query], binding.path) : undefined,\n        commandFields: (command, fields) => {\n            const first = rows(command, shapeOfFields(command, fields)).rows[0];\n            if (!first) return fields;\n\n            return fields.map(field => {\n                const key = Object.keys(first).find(candidate => candidate.toLowerCase() === field.name.toLowerCase());\n                const value = key === undefined ? undefined : scalar(first[key]);\n                return value === undefined ? field : { ...field, initialValue: value };\n            });\n        },\n    };\n}\n"],"names":["noSample","packs","collectQueryNames","value","names","Set","visit","candidate","Array","isArray","forEach","key","entry","Object","entries","length","add","readPath","source","path","split","reduce","current","segment","undefined","test","Number","hasOwn","shapeOfFields","name","fields","map","field","type","scalar","createPreviewSampleData","application","sample","profile","previewProfile","uiProfiles","context","sessionActivePack","blueprintDefaultPack","locale","seed","rowCount","isDesignOrPreview","rows","target","shape","known","shapes","resolved","resolveSampleData","includes","short","slice","lastIndexOf","queryResults","screens","screenTemplates","dialogTemplates","layouts","resolveBinding","binding","query","commandFields","command","first","keys","find","toLowerCase","initialValue"],"mappings":"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"}

package/dist/esm/preview-host/resolvePreviewPlan.d.ts

@@ -0,0 +1,18 @@
+import { ApplicationStructure } from '@cratis/scene.model';
+import { ApplicationStructureIndex } from '@cratis/scene.engine';
+import { PreviewTarget } from './PreviewTarget';
+import { PreviewProblem } from './PreviewProblem';
+export interface PreviewPlan {
+    kind: 'module' | 'feature' | 'stateChange' | 'stateView';
+    module: string;
+    feature?: string;
+    slice?: string;
+    command?: string;
+    breadcrumb: string[];
+}
+export interface PreviewPlanResult {
+    plan?: PreviewPlan;
+    problems: PreviewProblem[];
+}
+export declare function resolvePreviewPlan(structure: ApplicationStructure | ApplicationStructureIndex, target: PreviewTarget): PreviewPlanResult;
+//# sourceMappingURL=resolvePreviewPlan.d.ts.map

package/dist/esm/preview-host/resolvePreviewPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePreviewPlan.d.ts","sourceRoot":"","sources":["../../../preview-host/resolvePreviewPlan.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAA0B,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAA8C,MAAM,kBAAkB,CAAC;AAG9F,MAAM,WAAW,WAAW;IAExB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAGzD,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC9B;AAyBD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,oBAAoB,GAAG,yBAAyB,EAAE,MAAM,EAAE,aAAa,GAAG,iBAAiB,CA0CxI"}

package/dist/esm/preview-host/resolvePreviewPlan.js

@@ -0,0 +1,124 @@
+import { SliceKind } from '@cratis/scene.model';
+import { ApplicationStructureIndex } from '@cratis/scene.engine';
+import { isSliceTarget } from './PreviewTarget.js';
+import { PreviewProblemCode, PreviewProblemSeverity } from './PreviewProblem.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+const error = (code, message, nodeId)=>({
+        code,
+        severity: PreviewProblemSeverity.Error,
+        message,
+        ...nodeId === undefined ? {} : {
+            nodeId
+        }
+    });
+/** The feature a qualified id names, and the display names of the features above it, outermost first. */ function featurePath(structure, qualified) {
+    const [moduleId, ...rest] = qualified.split('.');
+    let features = structure.modules.find((module)=>module.id === moduleId)?.features;
+    const names = [];
+    let found;
+    for (const id of rest){
+        found = features?.find((candidate)=>candidate.id === id);
+        if (!found) return undefined;
+        names.push(found.name);
+        features = found.features;
+    }
+    return found ? {
+        feature: found,
+        names
+    } : undefined;
+}
+/**
+ * Resolves a preview target against the application structure (PRV3): a module previews its first feature, a feature itself,
+ * a slice the page of the feature it belongs to with the slice itself opened (State Change) or isolated (State View).
+ * A target that is not in the structure resolves to a problem, not to a blank screen.
+ */ function resolvePreviewPlan(structure, target) {
+    const index = structure instanceof ApplicationStructureIndex ? structure : new ApplicationStructureIndex(structure);
+    if (isSliceTarget(target)) {
+        const slice = index.findSlice(target.slice);
+        if (!slice) return {
+            problems: [
+                error(PreviewProblemCode.TargetNotFound, `The slice '${target.slice}' is not in the application.`, target.slice)
+            ]
+        };
+        if (slice.kind === SliceKind.Automation) {
+            return {
+                problems: [
+                    error(PreviewProblemCode.SliceNotPreviewable, `The slice '${target.slice}' is an automation: it reacts to events and has nothing to show.`, target.slice)
+                ]
+            };
+        }
+        const segments = target.slice.split('.');
+        const module = segments[0];
+        const featureId = segments.length > 2 ? segments.slice(0, -1).join('.') : undefined;
+        const moduleNode = index.findModule(module);
+        const path = featureId ? featurePath(index.structure, featureId) : undefined;
+        const containerFeature = featureId ?? index.firstFeatureId(module);
+        return {
+            plan: {
+                kind: slice.kind === SliceKind.StateChange ? 'stateChange' : 'stateView',
+                module,
+                feature: containerFeature,
+                slice: target.slice,
+                ...slice.kind === SliceKind.StateChange ? {
+                    command: slice.command ?? slice.id
+                } : {},
+                breadcrumb: [
+                    moduleNode?.name ?? module,
+                    ...path?.names ?? [],
+                    slice.name
+                ]
+            },
+            problems: []
+        };
+    }
+    const moduleNode = index.findModule(target.module);
+    if (!moduleNode) return {
+        problems: [
+            error(PreviewProblemCode.TargetNotFound, `The module '${target.module}' is not in the application.`, target.module)
+        ]
+    };
+    if (target.feature === undefined) {
+        const first = index.firstFeatureId(target.module);
+        if (first === undefined) return {
+            problems: [
+                error(PreviewProblemCode.ModuleWithoutFeatures, `The module '${moduleNode.name}' has no feature to show.`, target.module)
+            ]
+        };
+        return {
+            plan: {
+                kind: 'module',
+                module: target.module,
+                feature: first,
+                breadcrumb: [
+                    moduleNode.name,
+                    ...featurePath(index.structure, first)?.names ?? []
+                ]
+            },
+            problems: []
+        };
+    }
+    const qualified = target.feature.startsWith(`${target.module}.`) ? target.feature : `${target.module}.${target.feature}`;
+    const path = featurePath(index.structure, qualified);
+    if (!path) return {
+        problems: [
+            error(PreviewProblemCode.TargetNotFound, `The feature '${qualified}' is not in the application.`, qualified)
+        ]
+    };
+    return {
+        plan: {
+            kind: 'feature',
+            module: target.module,
+            feature: qualified,
+            breadcrumb: [
+                moduleNode.name,
+                ...path.names
+            ]
+        },
+        problems: []
+    };
+}
+
+export { resolvePreviewPlan };
+//# sourceMappingURL=resolvePreviewPlan.js.map

package/dist/esm/preview-host/resolvePreviewPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePreviewPlan.js","sources":["../../../preview-host/resolvePreviewPlan.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 { ApplicationStructure, FeatureNode, SliceKind } from '@cratis/scene.model';\nimport { ApplicationStructureIndex } from '@cratis/scene.engine';\nimport { PreviewTarget, isSliceTarget } from './PreviewTarget';\nimport { PreviewProblem, PreviewProblemCode, PreviewProblemSeverity } from './PreviewProblem';\n\n/** What a target resolved to in the application structure. */\nexport interface PreviewPlan {\n    /** `module`, `feature`, `stateChange` or `stateView`. */\n    kind: 'module' | 'feature' | 'stateChange' | 'stateView';\n\n    /** The module the preview is in. */\n    module: string;\n\n    /** The qualified id of the feature whose screen is the page: the module's first feature, the feature itself, or the slice's feature. */\n    feature?: string;\n\n    /** The qualified id of the slice, for a slice target. */\n    slice?: string;\n\n    /** The command a State Change slice accepts. */\n    command?: string;\n\n    /** The display names from the module down to the target - what the preview strip shows as `Sales › Orders` (PRV7). */\n    breadcrumb: string[];\n}\n\nexport interface PreviewPlanResult {\n    plan?: PreviewPlan;\n    problems: PreviewProblem[];\n}\n\nconst error = (code: PreviewProblemCode, message: string, nodeId?: string): PreviewProblem => ({ code, severity: PreviewProblemSeverity.Error, message, ...(nodeId === undefined ? {} : { nodeId }) });\n\n/** The feature a qualified id names, and the display names of the features above it, outermost first. */\nfunction featurePath(structure: ApplicationStructure, qualified: string): { feature: FeatureNode; names: string[] } | undefined {\n    const [moduleId, ...rest] = qualified.split('.');\n    let features = structure.modules.find(module => module.id === moduleId)?.features;\n    const names: string[] = [];\n    let found: FeatureNode | undefined;\n    for (const id of rest) {\n        found = features?.find(candidate => candidate.id === id);\n        if (!found) return undefined;\n        names.push(found.name);\n        features = found.features;\n    }\n\n    return found ? { feature: found, names } : undefined;\n}\n\n/**\n * Resolves a preview target against the application structure (PRV3): a module previews its first feature, a feature itself,\n * a slice the page of the feature it belongs to with the slice itself opened (State Change) or isolated (State View).\n * A target that is not in the structure resolves to a problem, not to a blank screen.\n */\nexport function resolvePreviewPlan(structure: ApplicationStructure | ApplicationStructureIndex, target: PreviewTarget): PreviewPlanResult {\n    const index = structure instanceof ApplicationStructureIndex ? structure : new ApplicationStructureIndex(structure);\n\n    if (isSliceTarget(target)) {\n        const slice = index.findSlice(target.slice);\n        if (!slice) return { problems: [error(PreviewProblemCode.TargetNotFound, `The slice '${target.slice}' is not in the application.`, target.slice)] };\n        if (slice.kind === SliceKind.Automation) {\n            return { problems: [error(PreviewProblemCode.SliceNotPreviewable, `The slice '${target.slice}' is an automation: it reacts to events and has nothing to show.`, target.slice)] };\n        }\n\n        const segments = target.slice.split('.');\n        const module = segments[0];\n        const featureId = segments.length > 2 ? segments.slice(0, -1).join('.') : undefined;\n        const moduleNode = index.findModule(module);\n        const path = featureId ? featurePath(index.structure, featureId) : undefined;\n        const containerFeature = featureId ?? index.firstFeatureId(module);\n        return {\n            plan: {\n                kind: slice.kind === SliceKind.StateChange ? 'stateChange' : 'stateView',\n                module,\n                feature: containerFeature,\n                slice: target.slice,\n                ...(slice.kind === SliceKind.StateChange ? { command: slice.command ?? slice.id } : {}),\n                breadcrumb: [moduleNode?.name ?? module, ...(path?.names ?? []), slice.name],\n            },\n            problems: [],\n        };\n    }\n\n    const moduleNode = index.findModule(target.module);\n    if (!moduleNode) return { problems: [error(PreviewProblemCode.TargetNotFound, `The module '${target.module}' is not in the application.`, target.module)] };\n\n    if (target.feature === undefined) {\n        const first = index.firstFeatureId(target.module);\n        if (first === undefined) return { problems: [error(PreviewProblemCode.ModuleWithoutFeatures, `The module '${moduleNode.name}' has no feature to show.`, target.module)] };\n        return { plan: { kind: 'module', module: target.module, feature: first, breadcrumb: [moduleNode.name, ...(featurePath(index.structure, first)?.names ?? [])] }, problems: [] };\n    }\n\n    const qualified = target.feature.startsWith(`${target.module}.`) ? target.feature : `${target.module}.${target.feature}`;\n    const path = featurePath(index.structure, qualified);\n    if (!path) return { problems: [error(PreviewProblemCode.TargetNotFound, `The feature '${qualified}' is not in the application.`, qualified)] };\n    return { plan: { kind: 'feature', module: target.module, feature: qualified, breadcrumb: [moduleNode.name, ...path.names] }, problems: [] };\n}\n"],"names":["error","code","message","nodeId","severity","PreviewProblemSeverity","Error","undefined","featurePath","structure","qualified","moduleId","rest","split","features","modules","find","module","id","names","found","candidate","push","name","feature","resolvePreviewPlan","target","index","ApplicationStructureIndex","isSliceTarget","slice","findSlice","problems","PreviewProblemCode","TargetNotFound","kind","SliceKind","Automation","SliceNotPreviewable","segments","featureId","length","join","moduleNode","findModule","path","containerFeature","firstFeatureId","plan","StateChange","command","breadcrumb","first","ModuleWithoutFeatures","startsWith"],"mappings":"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"}

package/dist/esm/preview-host/useSizeClass.d.ts

@@ -0,0 +1,3 @@
+import type { SizeClass } from '@cratis/scene.model';
+export declare function useSizeClass(): SizeClass;
+//# sourceMappingURL=useSizeClass.d.ts.map

package/dist/esm/preview-host/useSizeClass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSizeClass.d.ts","sourceRoot":"","sources":["../../../preview-host/useSizeClass.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQrD,wBAAgB,YAAY,IAAI,SAAS,CAUxC"}

package/dist/esm/preview-host/useSizeClass.js

@@ -0,0 +1,21 @@
+import { useState, useEffect } from 'react';
+import { computeSizeClass } from '@cratis/scene.engine';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Tracks the browser window's {@link SizeClass}, recomputing whenever it resizes across a boundary the
+ * shared engine cares about. This is what lets a modeled `when width compact` override actually take
+ * effect on a narrow window instead of the arrangement engine's size-aware logic never being asked.
+ */ function useSizeClass() {
+    const [sizeClass, setSizeClass] = useState(()=>computeSizeClass(globalThis.innerWidth, globalThis.innerHeight));
+    useEffect(()=>{
+        const onResize = ()=>setSizeClass(computeSizeClass(globalThis.innerWidth, globalThis.innerHeight));
+        globalThis.addEventListener('resize', onResize);
+        return ()=>globalThis.removeEventListener('resize', onResize);
+    }, []);
+    return sizeClass;
+}
+
+export { useSizeClass };
+//# sourceMappingURL=useSizeClass.js.map

package/dist/esm/preview-host/useSizeClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSizeClass.js","sources":["../../../preview-host/useSizeClass.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 { useEffect, useState } from 'react';\nimport type { SizeClass } from '@cratis/scene.model';\nimport { computeSizeClass } from '@cratis/scene.engine';\n\n/**\n * Tracks the browser window's {@link SizeClass}, recomputing whenever it resizes across a boundary the\n * shared engine cares about. This is what lets a modeled `when width compact` override actually take\n * effect on a narrow window instead of the arrangement engine's size-aware logic never being asked.\n */\nexport function useSizeClass(): SizeClass {\n    const [sizeClass, setSizeClass] = useState<SizeClass>(() => computeSizeClass(globalThis.innerWidth, globalThis.innerHeight));\n\n    useEffect(() => {\n        const onResize = () => setSizeClass(computeSizeClass(globalThis.innerWidth, globalThis.innerHeight));\n        globalThis.addEventListener('resize', onResize);\n        return () => globalThis.removeEventListener('resize', onResize);\n    }, []);\n\n    return sizeClass;\n}\n"],"names":["useSizeClass","sizeClass","setSizeClass","useState","computeSizeClass","globalThis","innerWidth","innerHeight","useEffect","onResize","addEventListener","removeEventListener"],"mappings":";;;AAAA;AACA;AAMA;;;;AAIC,IACM,SAASA,YAAAA,GAAAA;IACZ,MAAM,CAACC,SAAAA,EAAWC,YAAAA,CAAa,GAAGC,QAAAA,CAAoB,IAAMC,gBAAAA,CAAiBC,UAAAA,CAAWC,UAAU,EAAED,UAAAA,CAAWE,WAAW,CAAA,CAAA;IAE1HC,SAAAA,CAAU,IAAA;QACN,MAAMC,QAAAA,GAAW,IAAMP,YAAAA,CAAaE,gBAAAA,CAAiBC,WAAWC,UAAU,EAAED,WAAWE,WAAW,CAAA,CAAA;QAClGF,UAAAA,CAAWK,gBAAgB,CAAC,QAAA,EAAUD,QAAAA,CAAAA;AACtC,QAAA,OAAO,IAAMJ,UAAAA,CAAWM,mBAAmB,CAAC,QAAA,EAAUF,QAAAA,CAAAA;AAC1D,IAAA,CAAA,EAAG,EAAE,CAAA;IAEL,OAAOR,SAAAA;AACX;;"}