@cratis/scene.blueprint.default 4.33.0 → 4.35.0

package/dist/cjs/preview-host/PreviewTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewTemplate.js","sources":["../../../preview-host/PreviewTemplate.tsx"],"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 { ReactNode } from 'react';\nimport type { FlowArrangement } from '@cratis/scene.model';\nimport { evaluateFlowArrangement } from '@cratis/scene.engine';\nimport type { ComponentRegistry, RegisteredComponentProps } from '@cratis/scene.react';\nimport { FlowArrangementView } from './FlowArrangementView';\nimport { useSizeClass } from './useSizeClass';\n\n/** The name the template wrapper is registered under. */\nexport const previewTemplateComponent = 'Scene:template';\n\nfunction isFlowArrangement(arrangement: unknown): arrangement is FlowArrangement {\n    return !!arrangement && typeof arrangement === 'object' && 'root' in arrangement;\n}\n\n/**\n * A screen's content inside the screen template it names.\n *\n * The template's own `arrangement flow` positions its slots - header, body, aside - exactly as the document wrote it, evaluated\n * for the window's current size class. A template with no flow arrangement stacks them. It sits inside the shell's content\n * slot, so the shell, not this, owns the chrome around it. Stage and the preview host render templates with this one component.\n */\nexport function PreviewTemplate({ element, slots }: RegisteredComponentProps) {\n    const sizeClass = useSizeClass();\n    const arrangement = (element.properties as Record<string, unknown> | undefined)?.arrangement;\n    const nodes: Record<string, ReactNode> = {};\n    for (const [name, content] of Object.entries(slots)) {\n        nodes[name] = <section className='scene-template-slot' data-slot={name}>{content}</section>;\n    }\n\n    return (\n        <div className='scene-template' data-scene-id={element.id}>\n            {isFlowArrangement(arrangement)\n                ? <FlowArrangementView node={evaluateFlowArrangement(arrangement, sizeClass)} slots={nodes} />\n                : Object.entries(nodes).map(([name, node]) => <div key={name}>{node}</div>)}\n        </div>\n    );\n}\n\n/** The components the preview host and the Stage add to the registry for composed screens. */\nexport const previewComponents: ComponentRegistry = {\n    [previewTemplateComponent]: PreviewTemplate,\n};\n"],"names":["previewTemplateComponent","isFlowArrangement","arrangement","PreviewTemplate","element","slots","sizeClass","useSizeClass","properties","nodes","name","content","Object","entries","_jsx","section","className","data-slot","div","data-scene-id","id","FlowArrangementView","node","evaluateFlowArrangement","map","previewComponents"],"mappings":";;;;;;;AAAA;AACA;AASA,0DACO,MAAMA,wBAAAA,GAA2B;AAExC,SAASC,kBAAkBC,WAAoB,EAAA;AAC3C,IAAA,OAAO,CAAC,CAACA,WAAAA,IAAe,OAAOA,WAAAA,KAAgB,YAAY,MAAA,IAAUA,WAAAA;AACzE;AAEA;;;;;;AAMC,IACM,SAASC,eAAAA,CAAgB,EAAEC,OAAO,EAAEC,KAAK,EAA4B,EAAA;AACxE,IAAA,MAAMC,SAAAA,GAAYC,yBAAAA,EAAAA;IAClB,MAAML,WAAAA,GAAeE,OAAAA,CAAQI,UAAU,EAA0CN,WAAAA;AACjF,IAAA,MAAMO,QAAmC,EAAC;IAC1C,KAAK,MAAM,CAACC,IAAAA,EAAMC,OAAAA,CAAQ,IAAIC,MAAAA,CAAOC,OAAO,CAACR,KAAAA,CAAAA,CAAQ;QACjDI,KAAK,CAACC,IAAAA,CAAK,iBAAGI,cAAA,CAACC,SAAAA,EAAAA;YAAQC,SAAAA,EAAU,qBAAA;YAAsBC,WAAAA,EAAWP,IAAAA;AAAOC,YAAAA,QAAAA,EAAAA;;AAC7E,IAAA;AAEA,IAAA,qBACIG,cAAA,CAACI,KAAAA,EAAAA;QAAIF,SAAAA,EAAU,gBAAA;AAAiBG,QAAAA,eAAAA,EAAef,QAAQgB,EAAE;AACpDnB,QAAAA,QAAAA,EAAAA,iBAAAA,CAAkBC,6BACbY,cAAA,CAACO,uCAAAA,EAAAA;AAAoBC,YAAAA,IAAAA,EAAMC,qCAAwBrB,WAAAA,EAAaI,SAAAA,CAAAA;YAAYD,KAAAA,EAAOI;aACnFG,MAAAA,CAAOC,OAAO,CAACJ,KAAAA,CAAAA,CAAOe,GAAG,CAAC,CAAC,CAACd,IAAAA,EAAMY,IAAAA,CAAK,iBAAKR,cAAA,CAACI,KAAAA,EAAAA;AAAgBI,gBAAAA,QAAAA,EAAAA;AAAPZ,aAAAA,EAAAA,IAAAA,CAAAA;;AAGxE;AAEA,+FACO,MAAMe,iBAAAA,GAAuC;AAChD,IAAA,CAACzB,2BAA2BG;AAChC;;;;"}

package/dist/cjs/preview-host/PreviewToast.js

@@ -0,0 +1,45 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * The toast that confirms a dry run: "Command would be sent", with the payload in an expandable detail. Nothing was sent to
+ * Chronicle or Arc.
+ */ function PreviewToast({ invocation, onDismiss }) {
+    return /*#__PURE__*/ jsxRuntime.jsxs("div", {
+        className: "scene-preview-toast",
+        role: "status",
+        "data-scene-preview-toast": true,
+        children: [
+            /*#__PURE__*/ jsxRuntime.jsx("strong", {
+                children: "Command would be sent"
+            }),
+            /*#__PURE__*/ jsxRuntime.jsxs("span", {
+                children: [
+                    " · ",
+                    invocation.command ?? invocation.sliceId
+                ]
+            }),
+            /*#__PURE__*/ jsxRuntime.jsxs("details", {
+                children: [
+                    /*#__PURE__*/ jsxRuntime.jsx("summary", {
+                        children: "Payload"
+                    }),
+                    /*#__PURE__*/ jsxRuntime.jsx("pre", {
+                        children: JSON.stringify(invocation.payload, null, 2)
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsxRuntime.jsx("button", {
+                type: "button",
+                onClick: onDismiss,
+                children: "Dismiss"
+            })
+        ]
+    });
+}
+
+exports.PreviewToast = PreviewToast;
+//# sourceMappingURL=PreviewToast.js.map

package/dist/cjs/preview-host/PreviewToast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewToast.js","sources":["../../../preview-host/PreviewToast.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** What a dry run reports (PRV5). */\nexport interface PreviewInvocation {\n    /** The qualified id of the slice. */\n    sliceId: string;\n\n    /** The command the slice accepts, when known. */\n    command?: string;\n\n    /** The payload that would have been sent. */\n    payload: Record<string, unknown>;\n}\n\n/**\n * The toast that confirms a dry run: \"Command would be sent\", with the payload in an expandable detail. Nothing was sent to\n * Chronicle or Arc.\n */\nexport function PreviewToast({ invocation, onDismiss }: { invocation: PreviewInvocation; onDismiss(): void }) {\n    return (\n        <div className='scene-preview-toast' role='status' data-scene-preview-toast>\n            <strong>Command would be sent</strong>\n            <span> · {invocation.command ?? invocation.sliceId}</span>\n            <details>\n                <summary>Payload</summary>\n                <pre>{JSON.stringify(invocation.payload, null, 2)}</pre>\n            </details>\n            <button type='button' onClick={onDismiss}>Dismiss</button>\n        </div>\n    );\n}\n"],"names":["PreviewToast","invocation","onDismiss","_jsxs","div","className","role","data-scene-preview-toast","_jsx","strong","span","command","sliceId","details","summary","pre","JSON","stringify","payload","button","type","onClick"],"mappings":";;;;AAAA;AACA;AAcA;;;AAGC,IACM,SAASA,YAAAA,CAAa,EAAEC,UAAU,EAAEC,SAAS,EAAwD,EAAA;AACxG,IAAA,qBACIC,eAAA,CAACC,KAAAA,EAAAA;QAAIC,SAAAA,EAAU,qBAAA;QAAsBC,IAAAA,EAAK,QAAA;QAASC,0BAAwB,EAAA,IAAA;;0BACvEC,cAAA,CAACC,QAAAA,EAAAA;AAAO,gBAAA,QAAA,EAAA;;0BACRN,eAAA,CAACO,MAAAA,EAAAA;;AAAK,oBAAA,KAAA;oBAAIT,UAAAA,CAAWU,OAAO,IAAIV,UAAAA,CAAWW;;;0BAC3CT,eAAA,CAACU,SAAAA,EAAAA;;kCACGL,cAAA,CAACM,SAAAA,EAAAA;AAAQ,wBAAA,QAAA,EAAA;;kCACTN,cAAA,CAACO,KAAAA,EAAAA;AAAKC,wBAAAA,QAAAA,EAAAA,IAAAA,CAAKC,SAAS,CAAChB,UAAAA,CAAWiB,OAAO,EAAE,IAAA,EAAM,CAAA;;;;0BAEnDV,cAAA,CAACW,QAAAA,EAAAA;gBAAOC,IAAAA,EAAK,QAAA;gBAASC,OAAAA,EAASnB,SAAAA;AAAW,gBAAA,QAAA,EAAA;;;;AAGtD;;"}

package/dist/cjs/preview-host/ScenePreviewHost.js

@@ -0,0 +1,290 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var scene_model = require('@cratis/scene.model');
+var scene_engine = require('@cratis/scene.engine');
+var scene_react = require('@cratis/scene.react');
+var ComponentName = require('../ComponentName.js');
+var elements = require('../gallery/elements.js');
+var SlotName = require('../layouts/SlotName.js');
+var LayoutName = require('../layouts/LayoutName.js');
+require('../layouts/shellComponents.js');
+require('../layouts/appShell.js');
+require('../layouts/fullPage.js');
+var previewProfile = require('./previewProfile.js');
+var ApplicationHost = require('./ApplicationHost.js');
+var diagnosePreview = require('./diagnosePreview.js');
+var PreviewProblem = require('./PreviewProblem.js');
+var PreviewProblemsView = require('./PreviewProblemsView.js');
+var previewSampleData = require('./previewSampleData.js');
+var PreviewSliceFragment = require('./PreviewSliceFragment.js');
+var PreviewToast = require('./PreviewToast.js');
+
+const previewPageScreen = '#preview-page';
+const noNavigation = {
+    application: {
+        regions: []
+    },
+    modules: []
+};
+/** The page a slice preview happens over when its feature has no screen of its own, or a State View's fragment is shown. */ function minimalPage(layout, content) {
+    return {
+        name: previewPageScreen,
+        layout,
+        slotContent: {
+            [SlotName.SlotName.Content]: content
+        },
+        forms: [],
+        contributions: []
+    };
+}
+/**
+ * Renders the effective application (spec 10, PRV1-PRV9) from an in-memory document: the real shell, its navigation regions, the
+ * first feature of a module, a feature, or a slice - a State Change slice as its task dialog over a minimal host page, a State View
+ * slice as its data fragment.
+ *
+ * - **One code path**: the composition and the host are the Stage's own (`composeApplicationScreen`, `ApplicationHost`); nothing
+ *   here draws a shell, a menu or a dialog (PRV9).
+ * - **Read-only**: no design affordances, no edits (PRV8) - a toolbar button without a slice shows no warning badge here; it is
+ *   reported as a problem instead. A model that cannot render - an unknown target, a feature without a screen,
+ *   a layout or template nobody provides - gives a {@link PreviewProblemsView} and `onProblems`, not a blank screen.
+ * - **Navigation** keeps to an in-memory history; a different module swaps the shell's effective navigation (PRV4).
+ * - **Dialogs** submit through the dry-run invoker unless one is given: validation runs, nothing is sent, a toast says so (PRV5).
+ * - **Data** is the active sample data pack's (PRV6); the same seed shows the same rows.
+ * - The strip (`Previewing`, sample data, `Exit preview · Esc`) is the host application's: this reports the breadcrumb and calls
+ *   `onExit` on Escape.
+ */ function ScenePreviewHost({ document: application, structure, navigation = noNavigation, target, sampleData, registry, invoker, onInvoked, fieldsFor, composition = {}, theme, isVisible, history, onProblems, onSelectProblem, onBreadcrumbChange, onExit, children }) {
+    const index = react.useMemo(()=>structure instanceof scene_engine.ApplicationStructureIndex ? structure : new scene_engine.ApplicationStructureIndex(structure), [
+        structure
+    ]);
+    const compose = react.useMemo(()=>({
+            logo: navigation.application.logo,
+            ...composition
+        }), [
+        composition,
+        navigation.application.logo
+    ]);
+    const diagnosis = react.useMemo(()=>diagnosePreview.diagnosePreview({
+            document: application,
+            structure: index,
+            navigation,
+            target,
+            packs: sampleData?.packs,
+            composition: compose
+        }), [
+        application,
+        compose,
+        index,
+        navigation,
+        sampleData?.packs,
+        target
+    ]);
+    const problems = react.useMemo(()=>{
+        const found = [
+            ...diagnosis.problems
+        ];
+        const { plan, screen } = diagnosis;
+        if (plan?.kind === 'stateView' && screen && plan.slice) {
+            const slice = index.findSlice(plan.slice);
+            if (slice && PreviewSliceFragment.findSliceFragment(screen, plan.slice, slice).length === 0) {
+                found.push({
+                    code: PreviewProblem.PreviewProblemCode.SliceFragmentMissing,
+                    severity: PreviewProblem.PreviewProblemSeverity.Warning,
+                    message: `Nothing on the screen '${screen.name}' is bound to the State View '${plan.slice}', so its page is shown.`,
+                    nodeId: plan.slice
+                });
+            }
+        }
+        return found;
+    }, [
+        diagnosis,
+        index
+    ]);
+    const key = JSON.stringify(problems);
+    const reported = react.useRef(undefined);
+    react.useEffect(()=>{
+        if (reported.current === key) return;
+        reported.current = key;
+        onProblems?.(problems);
+    }, [
+        key,
+        onProblems,
+        problems
+    ]);
+    const breadcrumb = diagnosis.plan?.breadcrumb;
+    const breadcrumbKey = breadcrumb?.join('\u0000');
+    react.useEffect(()=>{
+        if (breadcrumb) onBreadcrumbChange?.(breadcrumb);
+    // `breadcrumbKey` is the value of `breadcrumb`.
+    }, [
+        breadcrumbKey,
+        onBreadcrumbChange
+    ]);
+    const [memoryHistory] = react.useState(()=>scene_react.createMemorySceneHistory());
+    const [toast, setToast] = react.useState();
+    const dryRun = react.useMemo(()=>scene_react.createDryRunInvoker({
+            onInvoked: (invocation)=>{
+                setToast(invocation);
+                onInvoked?.(invocation);
+            }
+        }), [
+        onInvoked
+    ]);
+    const samples = react.useMemo(()=>previewSampleData.createPreviewSampleData(application, sampleData), [
+        application,
+        sampleData
+    ]);
+    const fields = react.useMemo(()=>(command, slice)=>samples.commandFields(command, fieldsFor?.(command, slice) ?? []), [
+        fieldsFor,
+        samples
+    ]);
+    const page = react.useMemo(()=>{
+        const { plan, screen } = diagnosis;
+        if (!plan) return undefined;
+        if (!screen) {
+            // A slice whose feature has no screen of its own: a minimal host page, headed with where it is.
+            if (plan.slice === undefined) return undefined;
+            const layout = previewProfile.previewProfile(application.uiProfiles).layout ?? LayoutName.LayoutName.AppShell;
+            const header = elements.externalComponent('preview-page-header', ComponentName.ComponentName.PageHeader, {
+                title: plan.breadcrumb.slice(0, -1).join(' › ') || plan.breadcrumb[0]
+            });
+            return {
+                screens: [
+                    ...application.screens,
+                    minimalPage(layout, [
+                        header
+                    ])
+                ],
+                initial: previewPageScreen
+            };
+        }
+        if (plan.kind === 'stateView' && plan.slice) {
+            const slice = index.findSlice(plan.slice);
+            const fragment = slice ? PreviewSliceFragment.findSliceFragment(screen, plan.slice, slice) : [];
+            if (fragment.length > 0) return {
+                screens: [
+                    ...application.screens,
+                    minimalPage(screen.layout, fragment)
+                ],
+                initial: previewPageScreen
+            };
+        }
+        return {
+            screens: application.screens,
+            initial: screen.name
+        };
+    }, [
+        application.screens,
+        application.uiProfiles,
+        diagnosis,
+        index
+    ]);
+    const hostApplication = react.useMemo(()=>page ? {
+            ...application,
+            screens: page.screens
+        } : application, [
+        application,
+        page
+    ]);
+    const navigationModel = react.useMemo(()=>({
+            structure: index,
+            navigation,
+            isVisible
+        }), [
+        index,
+        isVisible,
+        navigation
+    ]);
+    const onKeyDown = react.useCallback((event)=>{
+        if (event.key === 'Escape' && !event.defaultPrevented) onExit?.();
+    }, [
+        onExit
+    ]);
+    if (PreviewProblem.hasBlockingProblem(problems) || !page) {
+        return /*#__PURE__*/ jsxRuntime.jsx(PreviewProblemsView.PreviewProblemsView, {
+            problems: problems.filter((problem)=>problem.severity === PreviewProblem.PreviewProblemSeverity.Error),
+            onSelectProblem: onSelectProblem
+        });
+    }
+    const body = /*#__PURE__*/ jsxRuntime.jsx(scene_react.SliceInvokerProvider, {
+        invoker: invoker ?? dryRun,
+        warnEmptySlices: false,
+        children: /*#__PURE__*/ jsxRuntime.jsx(scene_react.SliceCommandFieldsProvider, {
+            fieldsFor: fields,
+            children: /*#__PURE__*/ jsxRuntime.jsx("div", {
+                className: "scene-preview-host",
+                "data-scene-preview": diagnosis.plan?.kind,
+                "data-preview-breadcrumb": breadcrumb?.join(' › '),
+                children: /*#__PURE__*/ jsxRuntime.jsxs(ApplicationHost.ApplicationHost, {
+                    application: hostApplication,
+                    composition: compose,
+                    navigationModel: navigationModel,
+                    registry: registry,
+                    initialScreen: page.initial,
+                    history: history ?? memoryHistory,
+                    resolveBinding: samples.resolveBinding,
+                    queryResults: samples.queryResults,
+                    children: [
+                        diagnosis.plan?.kind === 'stateChange' && /*#__PURE__*/ jsxRuntime.jsx(OpenSliceDialog, {
+                            index: index,
+                            plan: diagnosis.plan
+                        }),
+                        /*#__PURE__*/ jsxRuntime.jsx(EscapeToExit, {
+                            onKeyDown: onKeyDown,
+                            enabled: onExit !== undefined
+                        }),
+                        toast && invoker === undefined && /*#__PURE__*/ jsxRuntime.jsx(PreviewToast.PreviewToast, {
+                            invocation: toast,
+                            onDismiss: ()=>setToast(undefined)
+                        }),
+                        children
+                    ]
+                })
+            })
+        })
+    });
+    return theme ? /*#__PURE__*/ jsxRuntime.jsx(scene_react.SceneThemeProvider, {
+        theme: theme,
+        children: body
+    }) : body;
+}
+/** Opens the task dialog of a State Change slice once the page is up - the slice preview (PRV3). */ function OpenSliceDialog({ index, plan }) {
+    const navigation = scene_react.useSceneNavigation();
+    const opened = react.useRef(false);
+    react.useEffect(()=>{
+        if (opened.current || plan.slice === undefined) return;
+        const slice = index.findSlice(plan.slice);
+        if (!slice || slice.kind !== scene_model.SliceKind.StateChange) return;
+        const destination = scene_react.sliceDialogDestination(scene_engine.resolveToolbarButton(index, {
+            id: plan.slice,
+            title: slice.name,
+            slice: plan.slice
+        }));
+        if (destination === undefined) return;
+        opened.current = true;
+        navigation.navigate(destination);
+    }, [
+        index,
+        navigation,
+        plan.slice
+    ]);
+    return null;
+}
+/** Exits the preview on Escape, unless something - an open dialog - already used the key. */ function EscapeToExit({ onKeyDown, enabled }) {
+    const navigation = scene_react.useSceneNavigation();
+    const dialogOpen = navigation.currentDialog !== undefined;
+    react.useEffect(()=>{
+        if (!enabled || dialogOpen) return undefined;
+        globalThis.addEventListener('keydown', onKeyDown);
+        return ()=>globalThis.removeEventListener('keydown', onKeyDown);
+    }, [
+        dialogOpen,
+        enabled,
+        onKeyDown
+    ]);
+    return null;
+}
+
+exports.ScenePreviewHost = ScenePreviewHost;
+//# sourceMappingURL=ScenePreviewHost.js.map

package/dist/cjs/preview-host/ScenePreviewHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScenePreviewHost.js","sources":["../../../preview-host/ScenePreviewHost.tsx"],"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 { ReactNode, useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { ApplicationStructure, NavigationModel, Screen, SliceKind, Theme } from '@cratis/scene.model';\nimport { ApplicationStructureIndex, EffectiveNavItem, resolveToolbarButton } from '@cratis/scene.engine';\nimport {\n    ComponentRegistry, SceneHistory, SceneThemeProvider, SliceCommandFieldsProvider, SliceCommandFieldsSource, SliceInvoker,\n    SliceInvokerProvider, createDryRunInvoker, createMemorySceneHistory, sliceDialogDestination, useSceneNavigation,\n} from '@cratis/scene.react';\nimport { ComponentName } from '../ComponentName';\nimport { externalComponent } from '../gallery/elements';\nimport { LayoutName, SlotName } from '../layouts';\nimport { previewProfile } from './previewProfile';\nimport { ApplicationDocument } from './ApplicationDocument';\nimport { ApplicationHost } from './ApplicationHost';\nimport { CompositionOptions } from './composeApplication';\nimport { diagnosePreview } from './diagnosePreview';\nimport { PreviewProblem, PreviewProblemCode, PreviewProblemSeverity, hasBlockingProblem } from './PreviewProblem';\nimport { PreviewProblemsView } from './PreviewProblemsView';\nimport { PreviewSampleData, createPreviewSampleData } from './previewSampleData';\nimport { findSliceFragment } from './PreviewSliceFragment';\nimport { PreviewTarget } from './PreviewTarget';\nimport { PreviewInvocation, PreviewToast } from './PreviewToast';\nimport { PreviewPlan } from './resolvePreviewPlan';\n\nexport interface ScenePreviewHostProps {\n    /** The document to preview - the in-memory one, unsaved edits included. */\n    document: ApplicationDocument;\n\n    /** The modules, features and slices of the application. */\n    structure: ApplicationStructure | ApplicationStructureIndex;\n\n    /** The application and module navigation regions; none when absent. */\n    navigation?: NavigationModel;\n\n    /** What to preview: a module, a feature or a slice. */\n    target: PreviewTarget;\n\n    /** The sample data to preview with; none when absent. */\n    sampleData?: PreviewSampleData;\n\n    /** The components to draw with. */\n    registry: ComponentRegistry;\n\n    /** What a submitted slice dialog goes through; a dry run, which only validates and reports, when absent (PRV5). */\n    invoker?: SliceInvoker;\n\n    /** Called for every dry run that passes validation, with what would have been sent. */\n    onInvoked?(invocation: PreviewInvocation): void;\n\n    /** The fields of a command, for the slice dialogs; the preview's sample rows fill their starting values. */\n    fieldsFor?: SliceCommandFieldsSource;\n\n    /** What the host decides about composition, such as the packages names resolve against. */\n    composition?: CompositionOptions;\n\n    /** The theme to apply; Studio passes the application's selected one (PRV9). */\n    theme?: Theme;\n\n    /** Hides a navigation item the preview user is not allowed to see. */\n    isVisible?(item: EffectiveNavItem): boolean;\n\n    /** Keeps the preview's navigation; an in-memory history by default, so a preview never touches the host's address (PRV4). */\n    history?: SceneHistory;\n\n    /** Called with the problems found - blocking or not - whenever they change (PRV8). */\n    onProblems?(problems: PreviewProblem[]): void;\n\n    /** Called when the author follows a problem to its node. */\n    onSelectProblem?(problem: PreviewProblem): void;\n\n    /** Called with what is being previewed, `Sales`, `Orders`, ... - the strip's breadcrumb (PRV7). */\n    onBreadcrumbChange?(breadcrumb: string[]): void;\n\n    /** Called when Escape is pressed with no dialog open: the host exits the preview (PRV7). */\n    onExit?(): void;\n\n    /** Extra content inside the host, such as a design layer's strip. */\n    children?: ReactNode;\n}\n\nconst previewPageScreen = '#preview-page';\nconst noNavigation: NavigationModel = { application: { regions: [] }, modules: [] };\n\n/** The page a slice preview happens over when its feature has no screen of its own, or a State View's fragment is shown. */\nfunction minimalPage(layout: string, content: Screen['slotContent'][string]): Screen {\n    return {\n        name: previewPageScreen,\n        layout,\n        slotContent: { [SlotName.Content]: content },\n        forms: [],\n        contributions: [],\n    };\n}\n\n/**\n * Renders the effective application (spec 10, PRV1-PRV9) from an in-memory document: the real shell, its navigation regions, the\n * first feature of a module, a feature, or a slice - a State Change slice as its task dialog over a minimal host page, a State View\n * slice as its data fragment.\n *\n * - **One code path**: the composition and the host are the Stage's own (`composeApplicationScreen`, `ApplicationHost`); nothing\n *   here draws a shell, a menu or a dialog (PRV9).\n * - **Read-only**: no design affordances, no edits (PRV8) - a toolbar button without a slice shows no warning badge here; it is\n *   reported as a problem instead. A model that cannot render - an unknown target, a feature without a screen,\n *   a layout or template nobody provides - gives a {@link PreviewProblemsView} and `onProblems`, not a blank screen.\n * - **Navigation** keeps to an in-memory history; a different module swaps the shell's effective navigation (PRV4).\n * - **Dialogs** submit through the dry-run invoker unless one is given: validation runs, nothing is sent, a toast says so (PRV5).\n * - **Data** is the active sample data pack's (PRV6); the same seed shows the same rows.\n * - The strip (`Previewing`, sample data, `Exit preview · Esc`) is the host application's: this reports the breadcrumb and calls\n *   `onExit` on Escape.\n */\nexport function ScenePreviewHost({\n    document: application, structure, navigation = noNavigation, target, sampleData, registry, invoker, onInvoked, fieldsFor, composition = {},\n    theme, isVisible, history, onProblems, onSelectProblem, onBreadcrumbChange, onExit, children,\n}: ScenePreviewHostProps) {\n    const index = useMemo(() => structure instanceof ApplicationStructureIndex ? structure : new ApplicationStructureIndex(structure), [structure]);\n    const compose = useMemo<CompositionOptions>(() => ({ logo: navigation.application.logo, ...composition }), [composition, navigation.application.logo]);\n    const diagnosis = useMemo(\n        () => diagnosePreview({ document: application, structure: index, navigation, target, packs: sampleData?.packs, composition: compose }),\n        [application, compose, index, navigation, sampleData?.packs, target]);\n\n    const problems = useMemo(() => {\n        const found = [...diagnosis.problems];\n        const { plan, screen } = diagnosis;\n        if (plan?.kind === 'stateView' && screen && plan.slice) {\n            const slice = index.findSlice(plan.slice);\n            if (slice && findSliceFragment(screen, plan.slice, slice).length === 0) {\n                found.push({ code: PreviewProblemCode.SliceFragmentMissing, severity: PreviewProblemSeverity.Warning, message: `Nothing on the screen '${screen.name}' is bound to the State View '${plan.slice}', so its page is shown.`, nodeId: plan.slice });\n            }\n        }\n\n        return found;\n    }, [diagnosis, index]);\n\n    const key = JSON.stringify(problems);\n    const reported = useRef<string | undefined>(undefined);\n    useEffect(() => {\n        if (reported.current === key) return;\n        reported.current = key;\n        onProblems?.(problems);\n    }, [key, onProblems, problems]);\n\n    const breadcrumb = diagnosis.plan?.breadcrumb;\n    const breadcrumbKey = breadcrumb?.join('\\u0000');\n    useEffect(() => {\n        if (breadcrumb) onBreadcrumbChange?.(breadcrumb);\n        // `breadcrumbKey` is the value of `breadcrumb`.\n    }, [breadcrumbKey, onBreadcrumbChange]);\n\n    const [memoryHistory] = useState(() => createMemorySceneHistory());\n    const [toast, setToast] = useState<PreviewInvocation>();\n    const dryRun = useMemo(() => createDryRunInvoker({\n        onInvoked: invocation => {\n            setToast(invocation);\n            onInvoked?.(invocation);\n        },\n    }), [onInvoked]);\n\n    const samples = useMemo(() => createPreviewSampleData(application, sampleData), [application, sampleData]);\n    const fields = useMemo<SliceCommandFieldsSource>(() => (command, slice) => samples.commandFields(command, fieldsFor?.(command, slice) ?? []), [fieldsFor, samples]);\n\n    const page = useMemo(() => {\n        const { plan, screen } = diagnosis;\n        if (!plan) return undefined;\n\n        if (!screen) {\n            // A slice whose feature has no screen of its own: a minimal host page, headed with where it is.\n            if (plan.slice === undefined) return undefined;\n            const layout = previewProfile(application.uiProfiles).layout ?? LayoutName.AppShell;\n            const header = externalComponent('preview-page-header', ComponentName.PageHeader, { title: plan.breadcrumb.slice(0, -1).join(' › ') || plan.breadcrumb[0] });\n            return { screens: [...application.screens, minimalPage(layout, [header])], initial: previewPageScreen };\n        }\n\n        if (plan.kind === 'stateView' && plan.slice) {\n            const slice = index.findSlice(plan.slice);\n            const fragment = slice ? findSliceFragment(screen, plan.slice, slice) : [];\n            if (fragment.length > 0) return { screens: [...application.screens, minimalPage(screen.layout, fragment)], initial: previewPageScreen };\n        }\n\n        return { screens: application.screens, initial: screen.name };\n    }, [application.screens, application.uiProfiles, diagnosis, index]);\n\n    const hostApplication = useMemo(() => page ? { ...application, screens: page.screens } : application, [application, page]);\n    const navigationModel = useMemo(() => ({ structure: index, navigation, isVisible }), [index, isVisible, navigation]);\n\n    const onKeyDown = useCallback((event: KeyboardEvent) => {\n        if (event.key === 'Escape' && !event.defaultPrevented) onExit?.();\n    }, [onExit]);\n\n    if (hasBlockingProblem(problems) || !page) {\n        return <PreviewProblemsView problems={problems.filter(problem => problem.severity === PreviewProblemSeverity.Error)} onSelectProblem={onSelectProblem} />;\n    }\n\n    const body = (\n        <SliceInvokerProvider invoker={invoker ?? dryRun} warnEmptySlices={false}>\n            <SliceCommandFieldsProvider fieldsFor={fields}>\n                <div className='scene-preview-host' data-scene-preview={diagnosis.plan?.kind} data-preview-breadcrumb={breadcrumb?.join(' › ')}>\n                    <ApplicationHost\n                        application={hostApplication}\n                        composition={compose}\n                        navigationModel={navigationModel}\n                        registry={registry}\n                        initialScreen={page.initial}\n                        history={history ?? memoryHistory}\n                        resolveBinding={samples.resolveBinding}\n                        queryResults={samples.queryResults}>\n                        {diagnosis.plan?.kind === 'stateChange' && <OpenSliceDialog index={index} plan={diagnosis.plan} />}\n                        <EscapeToExit onKeyDown={onKeyDown} enabled={onExit !== undefined} />\n                        {toast && invoker === undefined && <PreviewToast invocation={toast} onDismiss={() => setToast(undefined)} />}\n                        {children}\n                    </ApplicationHost>\n                </div>\n            </SliceCommandFieldsProvider>\n        </SliceInvokerProvider>\n    );\n\n    return theme ? <SceneThemeProvider theme={theme}>{body}</SceneThemeProvider> : body;\n}\n\n/** Opens the task dialog of a State Change slice once the page is up - the slice preview (PRV3). */\nfunction OpenSliceDialog({ index, plan }: { index: ApplicationStructureIndex; plan: PreviewPlan }) {\n    const navigation = useSceneNavigation();\n    const opened = useRef(false);\n    useEffect(() => {\n        if (opened.current || plan.slice === undefined) return;\n        const slice = index.findSlice(plan.slice);\n        if (!slice || slice.kind !== SliceKind.StateChange) return;\n\n        const destination = sliceDialogDestination(resolveToolbarButton(index, { id: plan.slice, title: slice.name, slice: plan.slice }));\n        if (destination === undefined) return;\n        opened.current = true;\n        navigation.navigate(destination);\n    }, [index, navigation, plan.slice]);\n\n    return null;\n}\n\n/** Exits the preview on Escape, unless something - an open dialog - already used the key. */\nfunction EscapeToExit({ onKeyDown, enabled }: { onKeyDown(event: KeyboardEvent): void; enabled: boolean }) {\n    const navigation = useSceneNavigation();\n    const dialogOpen = navigation.currentDialog !== undefined;\n    useEffect(() => {\n        if (!enabled || dialogOpen) return undefined;\n        globalThis.addEventListener('keydown', onKeyDown);\n        return () => globalThis.removeEventListener('keydown', onKeyDown);\n    }, [dialogOpen, enabled, onKeyDown]);\n\n    return null;\n}\n"],"names":["previewPageScreen","noNavigation","application","regions","modules","minimalPage","layout","content","name","slotContent","SlotName","Content","forms","contributions","ScenePreviewHost","document","structure","navigation","target","sampleData","registry","invoker","onInvoked","fieldsFor","composition","theme","isVisible","history","onProblems","onSelectProblem","onBreadcrumbChange","onExit","children","index","useMemo","ApplicationStructureIndex","compose","logo","diagnosis","diagnosePreview","packs","problems","found","plan","screen","kind","slice","findSlice","findSliceFragment","length","push","code","PreviewProblemCode","SliceFragmentMissing","severity","PreviewProblemSeverity","Warning","message","nodeId","key","JSON","stringify","reported","useRef","undefined","useEffect","current","breadcrumb","breadcrumbKey","join","memoryHistory","useState","createMemorySceneHistory","toast","setToast","dryRun","createDryRunInvoker","invocation","samples","createPreviewSampleData","fields","command","commandFields","page","previewProfile","uiProfiles","LayoutName","AppShell","header","externalComponent","ComponentName","PageHeader","title","screens","initial","fragment","hostApplication","navigationModel","onKeyDown","useCallback","event","defaultPrevented","hasBlockingProblem","_jsx","PreviewProblemsView","filter","problem","Error","body","SliceInvokerProvider","warnEmptySlices","SliceCommandFieldsProvider","div","className","data-scene-preview","data-preview-breadcrumb","_jsxs","ApplicationHost","initialScreen","resolveBinding","queryResults","OpenSliceDialog","EscapeToExit","enabled","PreviewToast","onDismiss","SceneThemeProvider","useSceneNavigation","opened","SliceKind","StateChange","destination","sliceDialogDestination","resolveToolbarButton","id","navigate","dialogOpen","currentDialog","globalThis","addEventListener","removeEventListener"],"mappings":"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"}

package/dist/cjs/preview-host/composeApplication.js

@@ -0,0 +1,249 @@
+'use strict';
+
+var scene_model = require('@cratis/scene.model');
+var scene_engine = require('@cratis/scene.engine');
+var ComponentName = require('../ComponentName.js');
+var elements = require('../gallery/elements.js');
+var resolveElementNames = require('../gallery/resolveElementNames.js');
+var screens = require('../gallery/screens.js');
+var SlotName = require('../layouts/SlotName.js');
+var shellComponents = require('../layouts/shellComponents.js');
+require('../layouts/appShell.js');
+require('../layouts/fullPage.js');
+var defaultLayouts = require('../layouts/defaultLayouts.js');
+var ApplicationDocument = require('./ApplicationDocument.js');
+var defaultApplicationChrome = require('./defaultApplicationChrome.js');
+var PreviewTemplate = require('./PreviewTemplate.js');
+var previewProfile = require('./previewProfile.js');
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+function previewCatalog(options) {
+    return options.catalog ?? previewProfile.blueprintPackageCatalog;
+}
+function profileOf(application, options) {
+    return options.profile ?? previewProfile.previewProfile(application.uiProfiles);
+}
+function defaultForm(screenName, form) {
+    return elements.externalComponent(`form-${screenName}-${form.name}`, 'commandForm', {
+        command: form.forCommand,
+        label: form.name,
+        generationMode: form.generationMode,
+        layout: form.layout,
+        fields: form.fields
+    });
+}
+function mergeSlots(...sources) {
+    const merged = {};
+    for (const source of sources){
+        for (const [slot, elements] of Object.entries(source ?? {}))merged[slot] = [
+            ...merged[slot] ?? [],
+            ...elements
+        ];
+    }
+    return merged;
+}
+/** The layout a screen names: the document's own, or one the blueprint provides. */ function findLayout(application, name, options = {}) {
+    return application.layouts.find((candidate)=>candidate.name === name) ?? (options.blueprintLayouts ?? defaultLayouts.defaultLayouts).find((candidate)=>candidate.name === name);
+}
+/**
+ * The templates a screen is composed with: the document's own, then the blueprint's for any name the document does not declare.
+ * A model that writes `template CrudList` without declaring it is naming one of the blueprint's templates; the document's
+ * own declaration always wins the name.
+ */ function templatesOf(application, options = {}) {
+    const own = application.screenTemplates;
+    return [
+        ...own,
+        ...(options.blueprintTemplates ?? screens.galleryScreenTemplates).filter((template)=>!own.some((candidate)=>candidate.name === template.name))
+    ];
+}
+/**
+ * The templates a screen's template chain is worked out among: the document's own when the screen's template is one of them,
+ * otherwise the blueprint's as well. The blueprint's templates are never mixed into a document's own chain - several of them fit
+ * the same slot name, which would make every slot ambiguous.
+ */ function templatePoolFor(application, screen, options = {}) {
+    return application.screenTemplates.some((candidate)=>candidate.name === screen.screenTemplate) ? application.screenTemplates : templatesOf(application, options);
+}
+/** The slot of the layout a template chain's outermost template fits: its declared slot, or `content`. */ function layoutSlotOf(layout, outermost) {
+    const fits = outermost.fitsSlot;
+    if (fits === undefined) return SlotName.SlotName.Content;
+    const slot = fits.includes('.') ? fits.slice(fits.lastIndexOf('.') + 1) : fits;
+    return layout === undefined || layout.slots.some((candidate)=>candidate.name === slot) ? slot : SlotName.SlotName.Content;
+}
+/** The templates a screen's own template sits inside, outermost first, ending with the screen's own template. */ function templateChainOf(application, screen, options = {}) {
+    if (!screen.screenTemplate) return [];
+    const templates = templatePoolFor(application, screen, options);
+    const own = templates.find((candidate)=>candidate.name === screen.screenTemplate);
+    if (!own) return [];
+    const layout = findLayout(application, screen.layout, options);
+    const placements = layout ? scene_engine.resolveScreenTemplates(layout, templates).placements : [];
+    const chain = [
+        own
+    ];
+    for(let guard = 0; guard <= templates.length; guard++){
+        const placement = placements.find((candidate)=>candidate.template === chain[0].name);
+        if (!placement || placement.container === layout?.name) break;
+        const parent = templates.find((candidate)=>candidate.name === placement.container);
+        if (!parent || chain.includes(parent)) break;
+        chain.unshift(parent);
+    }
+    return chain;
+}
+/**
+ * What a screen puts in the shell's content slot: the screen - inside the template chain it names, when it names one - and the
+ * forms it hosts. The same content fills the shell on the primary region and a nested outlet.
+ *
+ * The innermost template takes the screen's own slot content; each template outside it holds the one inside in the slot it
+ * declared (`fitsSlot`), so the chain's arrangements all apply.
+ */ function screenContent(application, screen, options = {}) {
+    const form = options.form ?? defaultForm;
+    const forms = screen.forms.map((candidate)=>form(screen.name, candidate));
+    const chain = templateChainOf(application, screen, options);
+    if (chain.length === 0) {
+        return {
+            content: [
+                ...Object.values(screen.slotContent).flat(),
+                ...forms
+            ],
+            templates: [],
+            slot: SlotName.SlotName.Content
+        };
+    }
+    let inner;
+    for(let index = chain.length - 1; index >= 0; index--){
+        const template = chain[index];
+        const slots = index === chain.length - 1 ? mergeSlots(template.content, screen.slotContent, {
+            forms
+        }) : mergeSlots(template.content, {
+            [slotName(chain[index + 1])]: [
+                inner
+            ]
+        });
+        inner = elements.externalComponent(`template-${screen.name}-${template.name}`, PreviewTemplate.previewTemplateComponent, {
+            arrangement: template.arrangement
+        }, slots);
+    }
+    const layout = findLayout(application, screen.layout, options);
+    return {
+        content: [
+            inner
+        ],
+        templates: chain.map((template)=>template.name),
+        slot: layoutSlotOf(layout, chain[0])
+    };
+}
+function slotName(template) {
+    const fits = template.fitsSlot ?? SlotName.SlotName.Content;
+    return fits.includes('.') ? fits.slice(fits.lastIndexOf('.') + 1) : fits;
+}
+function finish(element, profile, catalog, options) {
+    const decorated = options.decorate ? options.decorate(element) : element;
+    return resolveElementNames.resolveElementComponentNames(decorated, profile, catalog);
+}
+/**
+ * Composes one screen the way the application shows it: the shell for the screen's layout, the chrome every screen shares in the
+ * shell's slots, and the screen - inside the template chain it names - in the slot the chain fits. Stage and the preview host
+ * both compose through this, so a screen is the same screen in both (spec PRV9, REN2).
+ *
+ * A layout the selected package set does not provide stays unresolved in the rendered tree: showing that missing component is
+ * deliberate, because silently substituting a default shell would hide a package/profile problem.
+ *
+ * @param application The document and profiles.
+ * @param screen The screen to compose.
+ * @param options What the host decides.
+ * @returns The element to render, the configuration its templates resolved, and the templates around the screen.
+ */ function composeApplicationScreen(application, screen, options = {}) {
+    const profile = profileOf(application, options);
+    const { content, templates, slot } = screenContent(application, screen, options);
+    const shell = shellComponents.shellComponentForLayout(screen.layout) ?? screen.layout;
+    const chrome = options.chrome ? options.chrome(screen, shell) : shell === ComponentName.ComponentName.FullPageShell ? {} : defaultApplicationChrome.defaultApplicationChrome(options.logo);
+    const composed = elements.externalComponent(`screen-${screen.name}`, shell, {
+        screenName: screen.name
+    }, {
+        ...chrome,
+        [slot]: [
+            ...chrome[slot] ?? [],
+            ...content,
+            ...slot === SlotName.SlotName.Content ? options.trailing ?? [] : []
+        ]
+    });
+    return {
+        element: finish(composed, profile, previewCatalog(options), options),
+        configuration: configurationOf(application, screen, options),
+        templates
+    };
+}
+/**
+ * A screen as it appears inside an outlet of another screen: its content alone, without the shell the primary region wraps
+ * every screen in, with the same name resolution.
+ */ function composeOutletScreen(application, screen, options = {}) {
+    const { content } = screenContent(application, screen, options);
+    const element = content.length === 1 ? content[0] : {
+        id: `outlet-${screen.name}`,
+        children: content
+    };
+    return finish(element, profileOf(application, options), previewCatalog(options), options);
+}
+/**
+ * A dialog template as it is shown over the application: its slot content inside the template wrapper, with the arrangement the
+ * template wrote, names resolved - the same wrapper a screen's template gets.
+ */ function composeDialog(application, template, options = {}) {
+    const element = elements.externalComponent(`dialog-${template.name}`, PreviewTemplate.previewTemplateComponent, {
+        arrangement: template.arrangement
+    }, template.content ?? {});
+    return finish(element, profileOf(application, options), previewCatalog(options), options);
+}
+function configurationOf(application, screen, options) {
+    if (!options.descriptors || (application.instanceContributions ?? []).length === 0) return undefined;
+    const templates = templatesOf(application, options);
+    const document = {
+        ...ApplicationDocument.completeDocument(application),
+        screenTemplates: templates,
+        layouts: [
+            ...application.layouts,
+            ...(options.blueprintLayouts ?? defaultLayouts.defaultLayouts).filter((layout)=>!application.layouts.some((own)=>own.name === layout.name))
+        ]
+    };
+    const chain = scene_engine.resolveTemplateChain(document, {
+        kind: scene_model.EditingScopeKind.Screen,
+        name: screen.name
+    });
+    return scene_engine.resolveEffectiveConfiguration(chain, document.instanceContributions, options.descriptors);
+}
+/**
+ * Every destination the document authors - on actions, navigations, contributions and toolbar items - wherever it sits, so a
+ * route override on one of them can be deep linked.
+ */ function collectDestinations(application) {
+    const found = [];
+    const visit = (value)=>{
+        if (value === null || typeof value !== 'object') return;
+        if (Array.isArray(value)) {
+            value.forEach(visit);
+            return;
+        }
+        for (const [key, entry] of Object.entries(value)){
+            if (key === 'destination' && entry !== null && typeof entry === 'object' && !Array.isArray(entry)) found.push(entry);
+            visit(entry);
+        }
+    };
+    for (const screen of application.screens){
+        visit(screen.slotContent);
+        visit(screen.contributions);
+    }
+    for (const template of [
+        ...application.screenTemplates,
+        ...application.dialogTemplates ?? []
+    ])visit(template.content);
+    return found;
+}
+
+exports.collectDestinations = collectDestinations;
+exports.composeApplicationScreen = composeApplicationScreen;
+exports.composeDialog = composeDialog;
+exports.composeOutletScreen = composeOutletScreen;
+exports.findLayout = findLayout;
+exports.screenContent = screenContent;
+exports.templateChainOf = templateChainOf;
+exports.templatePoolFor = templatePoolFor;
+exports.templatesOf = templatesOf;
+//# sourceMappingURL=composeApplication.js.map