@cratis/scene.blueprint.default 4.32.0 → 4.34.0

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

@@ -0,0 +1,288 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useMemo, useRef, useEffect, useState, useCallback } from 'react';
+import { SliceKind } from '@cratis/scene.model';
+import { ApplicationStructureIndex, resolveToolbarButton } from '@cratis/scene.engine';
+import { createMemorySceneHistory, createDryRunInvoker, SliceInvokerProvider, SliceCommandFieldsProvider, SceneThemeProvider, useSceneNavigation, sliceDialogDestination } from '@cratis/scene.react';
+import { ComponentName } from '../ComponentName.js';
+import { externalComponent } from '../gallery/elements.js';
+import { SlotName } from '../layouts/SlotName.js';
+import { LayoutName } from '../layouts/LayoutName.js';
+import '../layouts/shellComponents.js';
+import '../layouts/appShell.js';
+import '../layouts/fullPage.js';
+import { previewProfile } from './previewProfile.js';
+import { ApplicationHost } from './ApplicationHost.js';
+import { diagnosePreview } from './diagnosePreview.js';
+import { PreviewProblemSeverity, PreviewProblemCode, hasBlockingProblem } from './PreviewProblem.js';
+import { PreviewProblemsView } from './PreviewProblemsView.js';
+import { createPreviewSampleData } from './previewSampleData.js';
+import { findSliceFragment } from './PreviewSliceFragment.js';
+import { PreviewToast } from './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.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 = useMemo(()=>structure instanceof ApplicationStructureIndex ? structure : new ApplicationStructureIndex(structure), [
+        structure
+    ]);
+    const compose = useMemo(()=>({
+            logo: navigation.application.logo,
+            ...composition
+        }), [
+        composition,
+        navigation.application.logo
+    ]);
+    const diagnosis = useMemo(()=>diagnosePreview({
+            document: application,
+            structure: index,
+            navigation,
+            target,
+            packs: sampleData?.packs,
+            composition: compose
+        }), [
+        application,
+        compose,
+        index,
+        navigation,
+        sampleData?.packs,
+        target
+    ]);
+    const problems = useMemo(()=>{
+        const found = [
+            ...diagnosis.problems
+        ];
+        const { plan, screen } = diagnosis;
+        if (plan?.kind === 'stateView' && screen && plan.slice) {
+            const slice = index.findSlice(plan.slice);
+            if (slice && findSliceFragment(screen, plan.slice, slice).length === 0) {
+                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
+                });
+            }
+        }
+        return found;
+    }, [
+        diagnosis,
+        index
+    ]);
+    const key = JSON.stringify(problems);
+    const reported = useRef(undefined);
+    useEffect(()=>{
+        if (reported.current === key) return;
+        reported.current = key;
+        onProblems?.(problems);
+    }, [
+        key,
+        onProblems,
+        problems
+    ]);
+    const breadcrumb = diagnosis.plan?.breadcrumb;
+    const breadcrumbKey = breadcrumb?.join('\u0000');
+    useEffect(()=>{
+        if (breadcrumb) onBreadcrumbChange?.(breadcrumb);
+    // `breadcrumbKey` is the value of `breadcrumb`.
+    }, [
+        breadcrumbKey,
+        onBreadcrumbChange
+    ]);
+    const [memoryHistory] = useState(()=>createMemorySceneHistory());
+    const [toast, setToast] = useState();
+    const dryRun = useMemo(()=>createDryRunInvoker({
+            onInvoked: (invocation)=>{
+                setToast(invocation);
+                onInvoked?.(invocation);
+            }
+        }), [
+        onInvoked
+    ]);
+    const samples = useMemo(()=>createPreviewSampleData(application, sampleData), [
+        application,
+        sampleData
+    ]);
+    const fields = useMemo(()=>(command, slice)=>samples.commandFields(command, fieldsFor?.(command, slice) ?? []), [
+        fieldsFor,
+        samples
+    ]);
+    const page = 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(application.uiProfiles).layout ?? LayoutName.AppShell;
+            const header = externalComponent('preview-page-header', 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 ? 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 = useMemo(()=>page ? {
+            ...application,
+            screens: page.screens
+        } : application, [
+        application,
+        page
+    ]);
+    const navigationModel = useMemo(()=>({
+            structure: index,
+            navigation,
+            isVisible
+        }), [
+        index,
+        isVisible,
+        navigation
+    ]);
+    const onKeyDown = useCallback((event)=>{
+        if (event.key === 'Escape' && !event.defaultPrevented) onExit?.();
+    }, [
+        onExit
+    ]);
+    if (hasBlockingProblem(problems) || !page) {
+        return /*#__PURE__*/ jsx(PreviewProblemsView, {
+            problems: problems.filter((problem)=>problem.severity === PreviewProblemSeverity.Error),
+            onSelectProblem: onSelectProblem
+        });
+    }
+    const body = /*#__PURE__*/ jsx(SliceInvokerProvider, {
+        invoker: invoker ?? dryRun,
+        warnEmptySlices: false,
+        children: /*#__PURE__*/ jsx(SliceCommandFieldsProvider, {
+            fieldsFor: fields,
+            children: /*#__PURE__*/ jsx("div", {
+                className: "scene-preview-host",
+                "data-scene-preview": diagnosis.plan?.kind,
+                "data-preview-breadcrumb": breadcrumb?.join(' › '),
+                children: /*#__PURE__*/ jsxs(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__*/ jsx(OpenSliceDialog, {
+                            index: index,
+                            plan: diagnosis.plan
+                        }),
+                        /*#__PURE__*/ jsx(EscapeToExit, {
+                            onKeyDown: onKeyDown,
+                            enabled: onExit !== undefined
+                        }),
+                        toast && invoker === undefined && /*#__PURE__*/ jsx(PreviewToast, {
+                            invocation: toast,
+                            onDismiss: ()=>setToast(undefined)
+                        }),
+                        children
+                    ]
+                })
+            })
+        })
+    });
+    return theme ? /*#__PURE__*/ jsx(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 = useSceneNavigation();
+    const opened = useRef(false);
+    useEffect(()=>{
+        if (opened.current || plan.slice === undefined) return;
+        const slice = index.findSlice(plan.slice);
+        if (!slice || slice.kind !== SliceKind.StateChange) return;
+        const destination = sliceDialogDestination(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 = useSceneNavigation();
+    const dialogOpen = navigation.currentDialog !== undefined;
+    useEffect(()=>{
+        if (!enabled || dialogOpen) return undefined;
+        globalThis.addEventListener('keydown', onKeyDown);
+        return ()=>globalThis.removeEventListener('keydown', onKeyDown);
+    }, [
+        dialogOpen,
+        enabled,
+        onKeyDown
+    ]);
+    return null;
+}
+
+export { ScenePreviewHost };
+//# sourceMappingURL=ScenePreviewHost.js.map

package/dist/esm/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/esm/preview-host/composeApplication.d.ts

@@ -0,0 +1,34 @@
+import { DestinationReference, DialogTemplate, Form, Layout, SceneElement, Screen, ScreenTemplate, UiProfile, type ApplicationLogo, type EffectiveConfiguration } from '@cratis/scene.model';
+import { DescriptorCatalog, PackageCatalog } from '@cratis/scene.engine';
+import { ApplicationDocument } from './ApplicationDocument';
+export interface CompositionOptions {
+    profile?: UiProfile;
+    catalog?: PackageCatalog;
+    chrome?(screen: Screen, shell: string): Record<string, SceneElement[]>;
+    form?(screenName: string, form: Form): SceneElement;
+    trailing?: SceneElement[];
+    decorate?(element: SceneElement): SceneElement;
+    blueprintTemplates?: ScreenTemplate[];
+    blueprintLayouts?: Layout[];
+    descriptors?: DescriptorCatalog;
+    logo?: ApplicationLogo;
+}
+export interface ComposedScreen {
+    element: SceneElement;
+    configuration?: EffectiveConfiguration;
+    templates: string[];
+}
+export declare function findLayout(application: ApplicationDocument, name: string, options?: CompositionOptions): Layout | undefined;
+export declare function templatesOf(application: ApplicationDocument, options?: CompositionOptions): ScreenTemplate[];
+export declare function templatePoolFor(application: ApplicationDocument, screen: Screen, options?: CompositionOptions): ScreenTemplate[];
+export declare function templateChainOf(application: ApplicationDocument, screen: Screen, options?: CompositionOptions): ScreenTemplate[];
+export declare function screenContent(application: ApplicationDocument, screen: Screen, options?: CompositionOptions): {
+    content: SceneElement[];
+    templates: string[];
+    slot: string;
+};
+export declare function composeApplicationScreen(application: ApplicationDocument, screen: Screen, options?: CompositionOptions): ComposedScreen;
+export declare function composeOutletScreen(application: ApplicationDocument, screen: Screen, options?: CompositionOptions): SceneElement;
+export declare function composeDialog(application: ApplicationDocument, template: DialogTemplate, options?: CompositionOptions): SceneElement;
+export declare function collectDestinations(application: ApplicationDocument): DestinationReference[];
+//# sourceMappingURL=composeApplication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"composeApplication.d.ts","sourceRoot":"","sources":["../../../preview-host/composeApplication.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,oBAAoB,EAAE,cAAc,EAAoB,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EACrH,KAAK,eAAe,EAAE,KAAK,sBAAsB,EACpD,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,iBAAiB,EAAE,cAAc,EACpC,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,mBAAmB,EAAoB,MAAM,uBAAuB,CAAC;AAM9E,MAAM,WAAW,kBAAkB;IAE/B,OAAO,CAAC,EAAE,SAAS,CAAC;IAGpB,OAAO,CAAC,EAAE,cAAc,CAAC;IAMzB,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAGvE,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,YAAY,CAAC;IAGpD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAG1B,QAAQ,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;IAG/C,kBAAkB,CAAC,EAAE,cAAc,EAAE,CAAC;IAGtC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG5B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAGhC,IAAI,CAAC,EAAE,eAAe,CAAC;CAC1B;AAGD,MAAM,WAAW,cAAc;IAE3B,OAAO,EAAE,YAAY,CAAC;IAGtB,aAAa,CAAC,EAAE,sBAAsB,CAAC;IAGvC,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AA8BD,wBAAgB,UAAU,CAAC,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,GAAG,SAAS,CAG/H;AAOD,wBAAgB,WAAW,CAAC,WAAW,EAAE,mBAAmB,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,EAAE,CAGhH;AAOD,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,EAAE,CAIpI;AAWD,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,EAAE,CAkBpI;AASD,wBAAgB,aAAa,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBhL;AAyBD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,cAAc,CAc3I;AAMD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,YAAY,CAIpI;AAMD,wBAAgB,aAAa,CAAC,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,GAAE,kBAAuB,GAAG,YAAY,CAGxI;AAeD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,GAAG,oBAAoB,EAAE,CAsB5F"}

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

@@ -0,0 +1,239 @@
+import { EditingScopeKind } from '@cratis/scene.model';
+import { resolveScreenTemplates, resolveTemplateChain, resolveEffectiveConfiguration } from '@cratis/scene.engine';
+import { ComponentName } from '../ComponentName.js';
+import { externalComponent } from '../gallery/elements.js';
+import { resolveElementComponentNames } from '../gallery/resolveElementNames.js';
+import { galleryScreenTemplates } from '../gallery/screens.js';
+import { SlotName } from '../layouts/SlotName.js';
+import { shellComponentForLayout } from '../layouts/shellComponents.js';
+import '../layouts/appShell.js';
+import '../layouts/fullPage.js';
+import { defaultLayouts } from '../layouts/defaultLayouts.js';
+import { completeDocument } from './ApplicationDocument.js';
+import { defaultApplicationChrome } from './defaultApplicationChrome.js';
+import { previewTemplateComponent } from './PreviewTemplate.js';
+import { previewProfile, blueprintPackageCatalog } 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.
+function previewCatalog(options) {
+    return options.catalog ?? blueprintPackageCatalog;
+}
+function profileOf(application, options) {
+    return options.profile ?? previewProfile(application.uiProfiles);
+}
+function defaultForm(screenName, form) {
+    return 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).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 ?? 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.Content;
+    const slot = fits.includes('.') ? fits.slice(fits.lastIndexOf('.') + 1) : fits;
+    return layout === undefined || layout.slots.some((candidate)=>candidate.name === slot) ? slot : 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 ? 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.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 = externalComponent(`template-${screen.name}-${template.name}`, 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.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 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 = shellComponentForLayout(screen.layout) ?? screen.layout;
+    const chrome = options.chrome ? options.chrome(screen, shell) : shell === ComponentName.FullPageShell ? {} : defaultApplicationChrome(options.logo);
+    const composed = externalComponent(`screen-${screen.name}`, shell, {
+        screenName: screen.name
+    }, {
+        ...chrome,
+        [slot]: [
+            ...chrome[slot] ?? [],
+            ...content,
+            ...slot === 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 = externalComponent(`dialog-${template.name}`, 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 = {
+        ...completeDocument(application),
+        screenTemplates: templates,
+        layouts: [
+            ...application.layouts,
+            ...(options.blueprintLayouts ?? defaultLayouts).filter((layout)=>!application.layouts.some((own)=>own.name === layout.name))
+        ]
+    };
+    const chain = resolveTemplateChain(document, {
+        kind: EditingScopeKind.Screen,
+        name: screen.name
+    });
+    return 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;
+}
+
+export { collectDestinations, composeApplicationScreen, composeDialog, composeOutletScreen, findLayout, screenContent, templateChainOf, templatePoolFor, templatesOf };
+//# sourceMappingURL=composeApplication.js.map