@cratis/scene.react 3.7.0 → 4.1.0

package/core/CoreButton.tsx

@@ -6,10 +6,10 @@ import { RegisteredComponentProps } from '../renderer';
 /**
  * The `core:button` component - part of the minimum vocabulary a `ui profile` can always fall back to.
  */
-export function CoreButton({ element, slots }: RegisteredComponentProps) {
+export function CoreButton({ element, slots, interactions }: RegisteredComponentProps) {
     const label = typeof element.properties.label === 'string' ? element.properties.label : '';
     return (
-        <button type="button" data-scene-id={element.id}>
+        <button type="button" data-scene-id={element.id} {...interactions}>
             {label}
             {slots.content}
         </button>

package/dist/cjs/SceneElementView.js

@@ -4,6 +4,8 @@ var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 var scene_engine = require('@cratis/scene.engine');
 var createReactRenderer = require('./renderer/createReactRenderer.js');
+require('./interactions/useInteractions.js');
+require('./interactions/NotificationHost.js');
 
 /**
  * Renders a Scene element tree with the real `Scene.React` renderer - the WYSIWYG building block Studio's

package/dist/cjs/SceneElementView.js.map

@@ -1 +1 @@
-{"version":3,"file":"SceneElementView.js","sources":["../../SceneElementView.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 { useMemo } from 'react';\nimport { renderElement, BindingResolver } from '@cratis/scene.engine';\nimport { SceneElement } from '@cratis/scene.model';\nimport { ComponentRegistry, createReactRenderer } from './renderer';\n\nexport interface SceneElementViewProps {\n    element: SceneElement;\n    registry: ComponentRegistry;\n    resolveBinding: BindingResolver;\n}\n\n/**\n * Renders a Scene element tree with the real `Scene.React` renderer - the WYSIWYG building block Studio's\n * preview surface and Stage's shipped web bundle both consume unmodified.\n */\nexport function SceneElementView({ element, registry, resolveBinding }: SceneElementViewProps) {\n    const renderer = useMemo(() => createReactRenderer(registry), [registry]);\n    return <>{renderElement(element, renderer, resolveBinding)}</>;\n}\n"],"names":["SceneElementView","element","registry","resolveBinding","renderer","useMemo","createReactRenderer","_jsx","_Fragment","renderElement"],"mappings":";;;;;;;AAcA;;;IAIO,SAASA,gBAAAA,CAAiB,EAAEC,OAAO,EAAEC,QAAQ,EAAEC,cAAc,EAAyB,EAAA;AACzF,IAAA,MAAMC,QAAAA,GAAWC,aAAAA,CAAQ,IAAMC,uCAAAA,CAAoBJ,QAAAA,CAAAA,EAAW;AAACA,QAAAA;AAAS,KAAA,CAAA;IACxE,qBAAOK,cAAA,CAAAC,mBAAA,EAAA;AAAGC,QAAAA,QAAAA,EAAAA,0BAAAA,CAAcR,SAASG,QAAAA,EAAUD,cAAAA;;AAC/C;;"}
+{"version":3,"file":"SceneElementView.js","sources":["../../SceneElementView.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 { useMemo } from 'react';\nimport { renderElement, BindingResolver } from '@cratis/scene.engine';\nimport { SceneElement } from '@cratis/scene.model';\nimport { ComponentRegistry, createReactRenderer } from './renderer';\n\nexport interface SceneElementViewProps {\n    element: SceneElement;\n    registry: ComponentRegistry;\n    resolveBinding: BindingResolver;\n}\n\n/**\n * Renders a Scene element tree with the real `Scene.React` renderer - the WYSIWYG building block Studio's\n * preview surface and Stage's shipped web bundle both consume unmodified.\n */\nexport function SceneElementView({ element, registry, resolveBinding }: SceneElementViewProps) {\n    const renderer = useMemo(() => createReactRenderer(registry), [registry]);\n    return <>{renderElement(element, renderer, resolveBinding)}</>;\n}\n"],"names":["SceneElementView","element","registry","resolveBinding","renderer","useMemo","createReactRenderer","_jsx","_Fragment","renderElement"],"mappings":";;;;;;;;;AAcA;;;IAIO,SAASA,gBAAAA,CAAiB,EAAEC,OAAO,EAAEC,QAAQ,EAAEC,cAAc,EAAyB,EAAA;AACzF,IAAA,MAAMC,QAAAA,GAAWC,aAAAA,CAAQ,IAAMC,uCAAAA,CAAoBJ,QAAAA,CAAAA,EAAW;AAACA,QAAAA;AAAS,KAAA,CAAA;IACxE,qBAAOK,cAAA,CAAAC,mBAAA,EAAA;AAAGC,QAAAA,QAAAA,EAAAA,0BAAAA,CAAcR,SAASG,QAAAA,EAAUD,cAAAA;;AAC/C;;"}

package/dist/cjs/core/CoreButton.js

@@ -6,11 +6,12 @@ var jsxRuntime = require('react/jsx-runtime');
 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
 /**
  * The `core:button` component - part of the minimum vocabulary a `ui profile` can always fall back to.
- */ function CoreButton({ element, slots }) {
+ */ function CoreButton({ element, slots, interactions }) {
     const label = typeof element.properties.label === 'string' ? element.properties.label : '';
     return /*#__PURE__*/ jsxRuntime.jsxs("button", {
         type: "button",
         "data-scene-id": element.id,
+        ...interactions,
         children: [
             label,
             slots.content

package/dist/cjs/core/CoreButton.js.map

@@ -1 +1 @@
-{"version":3,"file":"CoreButton.js","sources":["../../../core/CoreButton.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 { RegisteredComponentProps } from '../renderer';\n\n/**\n * The `core:button` component - part of the minimum vocabulary a `ui profile` can always fall back to.\n */\nexport function CoreButton({ element, slots }: RegisteredComponentProps) {\n    const label = typeof element.properties.label === 'string' ? element.properties.label : '';\n    return (\n        <button type=\"button\" data-scene-id={element.id}>\n            {label}\n            {slots.content}\n        </button>\n    );\n}\n"],"names":["CoreButton","element","slots","label","properties","_jsxs","button","type","data-scene-id","id","content"],"mappings":";;;;AAAA;AACA;AAIA;;AAEC,IACM,SAASA,UAAAA,CAAW,EAAEC,OAAO,EAAEC,KAAK,EAA4B,EAAA;AACnE,IAAA,MAAMC,KAAAA,GAAQ,OAAOF,OAAAA,CAAQG,UAAU,CAACD,KAAK,KAAK,QAAA,GAAWF,OAAAA,CAAQG,UAAU,CAACD,KAAK,GAAG,EAAA;AACxF,IAAA,qBACIE,eAAA,CAACC,QAAAA,EAAAA;QAAOC,IAAAA,EAAK,QAAA;AAASC,QAAAA,eAAAA,EAAeP,QAAQQ,EAAE;;AAC1CN,YAAAA,KAAAA;AACAD,YAAAA,KAAAA,CAAMQ;;;AAGnB;;"}
+{"version":3,"file":"CoreButton.js","sources":["../../../core/CoreButton.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 { RegisteredComponentProps } from '../renderer';\n\n/**\n * The `core:button` component - part of the minimum vocabulary a `ui profile` can always fall back to.\n */\nexport function CoreButton({ element, slots, interactions }: RegisteredComponentProps) {\n    const label = typeof element.properties.label === 'string' ? element.properties.label : '';\n    return (\n        <button type=\"button\" data-scene-id={element.id} {...interactions}>\n            {label}\n            {slots.content}\n        </button>\n    );\n}\n"],"names":["CoreButton","element","slots","interactions","label","properties","_jsxs","button","type","data-scene-id","id","content"],"mappings":";;;;AAAA;AACA;AAIA;;IAGO,SAASA,UAAAA,CAAW,EAAEC,OAAO,EAAEC,KAAK,EAAEC,YAAY,EAA4B,EAAA;AACjF,IAAA,MAAMC,KAAAA,GAAQ,OAAOH,OAAAA,CAAQI,UAAU,CAACD,KAAK,KAAK,QAAA,GAAWH,OAAAA,CAAQI,UAAU,CAACD,KAAK,GAAG,EAAA;AACxF,IAAA,qBACIE,eAAA,CAACC,QAAAA,EAAAA;QAAOC,IAAAA,EAAK,QAAA;AAASC,QAAAA,eAAAA,EAAeR,QAAQS,EAAE;AAAG,QAAA,GAAGP,YAAY;;AAC5DC,YAAAA,KAAAA;AACAF,YAAAA,KAAAA,CAAMS;;;AAGnB;;"}

package/dist/cjs/index.js

@@ -3,6 +3,7 @@
 var SceneElementView = require('./SceneElementView.js');
 var UnresolvedComponent = require('./renderer/UnresolvedComponent.js');
 var createReactRenderer = require('./renderer/createReactRenderer.js');
+var InteractiveComponent = require('./renderer/InteractiveComponent.js');
 var CoreText = require('./core/CoreText.js');
 var CoreButton = require('./core/CoreButton.js');
 var CoreCard = require('./core/CoreCard.js');
@@ -14,12 +15,20 @@ var extractNavigationItem = require('./NavBar/extractNavigationItem.js');
 var ScenePackageBundle = require('./packages/ScenePackageBundle.js');
 var themeTokens = require('./theme/themeTokens.js');
 var SceneThemeProvider = require('./theme/SceneThemeProvider.js');
+var InteractionScope = require('./interactions/InteractionScope.js');
+var useInteractions = require('./interactions/useInteractions.js');
+var createBrowserDispatcher = require('./interactions/createBrowserDispatcher.js');
+var ConfirmHost = require('./interactions/ConfirmHost.js');
+var NotificationHost = require('./interactions/NotificationHost.js');
+var UnresolvedActionHost = require('./interactions/UnresolvedActionHost.js');
+var useInteractionHosts = require('./interactions/useInteractionHosts.js');
 
 
 
 exports.SceneElementView = SceneElementView.SceneElementView;
 exports.UnresolvedComponent = UnresolvedComponent.UnresolvedComponent;
 exports.createReactRenderer = createReactRenderer.createReactRenderer;
+exports.InteractiveComponent = InteractiveComponent.InteractiveComponent;
 exports.CoreText = CoreText.CoreText;
 exports.CoreButton = CoreButton.CoreButton;
 exports.CoreCard = CoreCard.CoreCard;
@@ -47,4 +56,13 @@ exports.themeTokenPrefix = themeTokens.themeTokenPrefix;
 exports.themeTokenProperty = themeTokens.themeTokenProperty;
 exports.SceneThemeProvider = SceneThemeProvider.SceneThemeProvider;
 exports.useSceneTheme = SceneThemeProvider.useSceneTheme;
+exports.InteractionScope = InteractionScope.InteractionScope;
+exports.attachmentFor = InteractionScope.attachmentFor;
+exports.useInteractionScope = InteractionScope.useInteractionScope;
+exports.useInteractions = useInteractions.useInteractions;
+exports.createBrowserDispatcher = createBrowserDispatcher.createBrowserDispatcher;
+exports.ConfirmHost = ConfirmHost.ConfirmHost;
+exports.NotificationHost = NotificationHost.NotificationHost;
+exports.UnresolvedActionHost = UnresolvedActionHost.UnresolvedActionHost;
+exports.useInteractionHosts = useInteractionHosts.useInteractionHosts;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/interactions/ConfirmHost.js

@@ -0,0 +1,71 @@
+'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.
+/**
+ * Asks what a document's `confirm` asked, in the page rather than in a browser prompt.
+ *
+ * The browser's own prompt blocks the event loop and cannot be styled or tested, which is why it is the
+ * fallback and not this. Declining is the default action, so dismissing the question stops the sequence - a
+ * confirm exists to gate what follows it, and a gate that opens when ignored is not one.
+ * @param props The {@link ConfirmHostProps}.
+ */ function ConfirmHost({ request, confirmLabel = 'OK', cancelLabel = 'Cancel' }) {
+    if (!request) return null;
+    return /*#__PURE__*/ jsxRuntime.jsx("div", {
+        "data-scene-confirm": true,
+        style: {
+            position: 'fixed',
+            inset: 0,
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            background: 'rgba(0,0,0,0.35)',
+            zIndex: 1100
+        },
+        children: /*#__PURE__*/ jsxRuntime.jsxs("div", {
+            role: "alertdialog",
+            "aria-modal": "true",
+            "aria-label": request.message,
+            style: {
+                minWidth: '18rem',
+                maxWidth: '28rem',
+                padding: '1rem',
+                borderRadius: 4,
+                background: '#fff',
+                color: '#1a1a1a'
+            },
+            children: [
+                /*#__PURE__*/ jsxRuntime.jsx("p", {
+                    style: {
+                        margin: '0 0 1rem'
+                    },
+                    children: request.message
+                }),
+                /*#__PURE__*/ jsxRuntime.jsxs("div", {
+                    style: {
+                        display: 'flex',
+                        justifyContent: 'flex-end',
+                        gap: '0.5rem'
+                    },
+                    children: [
+                        /*#__PURE__*/ jsxRuntime.jsx("button", {
+                            type: "button",
+                            onClick: ()=>request.answer(false),
+                            children: cancelLabel
+                        }),
+                        /*#__PURE__*/ jsxRuntime.jsx("button", {
+                            type: "button",
+                            onClick: ()=>request.answer(true),
+                            children: confirmLabel
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+
+exports.ConfirmHost = ConfirmHost;
+//# sourceMappingURL=ConfirmHost.js.map

package/dist/cjs/interactions/ConfirmHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmHost.js","sources":["../../../interactions/ConfirmHost.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 { ConfirmRequest } from './ConfirmRequest';\n\n/**\n * The properties of {@link ConfirmHost}.\n */\nexport interface ConfirmHostProps {\n    /** The question waiting on an answer, or `undefined` when nothing is being asked. */\n    readonly request?: ConfirmRequest;\n\n    /** The label on the agreeing choice. */\n    readonly confirmLabel?: string;\n\n    /** The label on the declining choice. */\n    readonly cancelLabel?: string;\n}\n\n/**\n * Asks what a document's `confirm` asked, in the page rather than in a browser prompt.\n *\n * The browser's own prompt blocks the event loop and cannot be styled or tested, which is why it is the\n * fallback and not this. Declining is the default action, so dismissing the question stops the sequence - a\n * confirm exists to gate what follows it, and a gate that opens when ignored is not one.\n * @param props The {@link ConfirmHostProps}.\n */\nexport function ConfirmHost({ request, confirmLabel = 'OK', cancelLabel = 'Cancel' }: ConfirmHostProps) {\n    if (!request) return null;\n\n    return (\n        <div data-scene-confirm style={{ position: 'fixed', inset: 0, display: 'flex', alignItems: 'center', justifyContent: 'center', background: 'rgba(0,0,0,0.35)', zIndex: 1100 }}>\n            <div role=\"alertdialog\" aria-modal=\"true\" aria-label={request.message} style={{ minWidth: '18rem', maxWidth: '28rem', padding: '1rem', borderRadius: 4, background: '#fff', color: '#1a1a1a' }}>\n                <p style={{ margin: '0 0 1rem' }}>{request.message}</p>\n                <div style={{ display: 'flex', justifyContent: 'flex-end', gap: '0.5rem' }}>\n                    <button type=\"button\" onClick={() => request.answer(false)}>{cancelLabel}</button>\n                    <button type=\"button\" onClick={() => request.answer(true)}>{confirmLabel}</button>\n                </div>\n            </div>\n        </div>\n    );\n}\n"],"names":["ConfirmHost","request","confirmLabel","cancelLabel","_jsx","div","data-scene-confirm","style","position","inset","display","alignItems","justifyContent","background","zIndex","_jsxs","role","aria-modal","aria-label","message","minWidth","maxWidth","padding","borderRadius","color","p","margin","gap","button","type","onClick","answer"],"mappings":";;;;AAAA;AACA;AAkBA;;;;;;;IAQO,SAASA,WAAAA,CAAY,EAAEC,OAAO,EAAEC,YAAAA,GAAe,IAAI,EAAEC,WAAAA,GAAc,QAAQ,EAAoB,EAAA;IAClG,IAAI,CAACF,SAAS,OAAO,IAAA;AAErB,IAAA,qBACIG,cAAA,CAACC,KAAAA,EAAAA;QAAIC,oBAAkB,EAAA,IAAA;QAACC,KAAAA,EAAO;YAAEC,QAAAA,EAAU,OAAA;YAASC,KAAAA,EAAO,CAAA;YAAGC,OAAAA,EAAS,MAAA;YAAQC,UAAAA,EAAY,QAAA;YAAUC,cAAAA,EAAgB,QAAA;YAAUC,UAAAA,EAAY,kBAAA;YAAoBC,MAAAA,EAAQ;AAAK,SAAA;AACxK,QAAA,QAAA,gBAAAC,eAAA,CAACV,KAAAA,EAAAA;YAAIW,IAAAA,EAAK,aAAA;YAAcC,YAAAA,EAAW,MAAA;AAAOC,YAAAA,YAAAA,EAAYjB,QAAQkB,OAAO;YAAEZ,KAAAA,EAAO;gBAAEa,QAAAA,EAAU,OAAA;gBAASC,QAAAA,EAAU,OAAA;gBAASC,OAAAA,EAAS,MAAA;gBAAQC,YAAAA,EAAc,CAAA;gBAAGV,UAAAA,EAAY,MAAA;gBAAQW,KAAAA,EAAO;AAAU,aAAA;;8BACzLpB,cAAA,CAACqB,GAAAA,EAAAA;oBAAElB,KAAAA,EAAO;wBAAEmB,MAAAA,EAAQ;AAAW,qBAAA;AAAIzB,oBAAAA,QAAAA,EAAAA,OAAAA,CAAQkB;;8BAC3CJ,eAAA,CAACV,KAAAA,EAAAA;oBAAIE,KAAAA,EAAO;wBAAEG,OAAAA,EAAS,MAAA;wBAAQE,cAAAA,EAAgB,UAAA;wBAAYe,GAAAA,EAAK;AAAS,qBAAA;;sCACrEvB,cAAA,CAACwB,QAAAA,EAAAA;4BAAOC,IAAAA,EAAK,QAAA;4BAASC,OAAAA,EAAS,IAAM7B,OAAAA,CAAQ8B,MAAM,CAAC,KAAA,CAAA;AAAS5B,4BAAAA,QAAAA,EAAAA;;sCAC7DC,cAAA,CAACwB,QAAAA,EAAAA;4BAAOC,IAAAA,EAAK,QAAA;4BAASC,OAAAA,EAAS,IAAM7B,OAAAA,CAAQ8B,MAAM,CAAC,IAAA,CAAA;AAAQ7B,4BAAAA,QAAAA,EAAAA;;;;;;;AAKhF;;"}

package/dist/cjs/interactions/InteractionScope.js

@@ -0,0 +1,74 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+
+/**
+ * The context a scope uses when it was given none.
+ *
+ * A document whose messages are literal text and whose actions take no arguments resolves nothing, and that is
+ * an ordinary document rather than a degenerate one. Requiring a context anyway would make every host invent
+ * an empty resolver, and an invented one is a place for a mistake to hide.
+ */ const resolvesNothing = {
+    resolve: ()=>undefined
+};
+const Scope = /*#__PURE__*/ react.createContext(undefined);
+/**
+ * Provides the dispatcher, the resolution context and the enclosing attachments to everything beneath it.
+ *
+ * Attachments nest: a scope inside another scope appends to it rather than replacing it, so an element's
+ * enclosing chain is assembled by the tree rather than reconstructed at each leaf. That is what keeps the
+ * additive rule true in a renderer - a module's behavior is still in scope at a button six levels down,
+ * without the button knowing the module exists.
+ */ function InteractionScope({ children, dispatcher, context = resolvesNothing, attachments, onFindings }) {
+    const enclosing = react.useContext(Scope);
+    const value = react.useMemo(()=>({
+            dispatcher,
+            context,
+            attachments: [
+                ...enclosing?.attachments ?? [],
+                ...attachments
+            ],
+            onFindings: onFindings ?? enclosing?.onFindings
+        }), [
+        dispatcher,
+        context,
+        attachments,
+        onFindings,
+        enclosing
+    ]);
+    return /*#__PURE__*/ jsxRuntime.jsx(Scope.Provider, {
+        value: value,
+        children: children
+    });
+}
+/**
+ * Reads the enclosing interaction scope.
+ *
+ * @returns The scope, or `undefined` when the tree is rendered without one.
+ * @remarks
+ * Rendering without a scope is legitimate - a preview surface showing what a screen looks like has nothing to
+ * dispatch to - so this answers `undefined` rather than throwing. What must not happen is an element silently
+ * appearing interactive when nothing can run; {@link useInteractions} is where that is decided.
+ */ function useInteractionScope() {
+    return react.useContext(Scope);
+}
+/**
+ * Builds the attachment list for one element, so a caller does not have to know the shape.
+ *
+ * @param level What is being attached to, used when reporting.
+ * @param behaviors The behaviors attached there.
+ * @returns The attachment, or an empty list when there are none.
+ */ function attachmentFor(level, behaviors) {
+    return behaviors && behaviors.length > 0 ? [
+        {
+            level,
+            behaviors
+        }
+    ] : [];
+}
+
+exports.InteractionScope = InteractionScope;
+exports.attachmentFor = attachmentFor;
+exports.useInteractionScope = useInteractionScope;
+//# sourceMappingURL=InteractionScope.js.map

package/dist/cjs/interactions/InteractionScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionScope.js","sources":["../../../interactions/InteractionScope.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, createContext, useContext, useMemo } from 'react';\nimport { ActionDispatcher, BehaviorAttachment, InteractionContext, InteractionFinding } from '@cratis/scene.engine';\nimport { Behavior } from '@cratis/scene.model';\n\n/**\n * What the elements beneath a scope need in order to run an interaction.\n */\nexport interface InteractionScopeValue {\n    /** The seam that performs the effects. */\n    dispatcher: ActionDispatcher;\n\n    /** How bindings and localization resolve. */\n    context: InteractionContext;\n\n    /** The attachments enclosing this point, outermost first. */\n    attachments: BehaviorAttachment[];\n\n    /** Where a finding goes. Absent means nothing is listening, which is itself worth knowing. */\n    onFindings?: (findings: InteractionFinding[]) => void;\n}\n\n/**\n * The context a scope uses when it was given none.\n *\n * A document whose messages are literal text and whose actions take no arguments resolves nothing, and that is\n * an ordinary document rather than a degenerate one. Requiring a context anyway would make every host invent\n * an empty resolver, and an invented one is a place for a mistake to hide.\n */\nconst resolvesNothing: InteractionContext = { resolve: () => undefined };\n\nconst Scope = createContext<InteractionScopeValue | undefined>(undefined);\n\n/**\n * The properties of {@link InteractionScope}.\n *\n * The context is the one thing an author may leave out, because a document whose messages are literal text and\n * whose actions take no arguments resolves nothing. Everything beneath a scope still reads a context that is\n * definitely there, so only the author is spared, not the code doing the work.\n */\nexport interface InteractionScopeProps extends Omit<InteractionScopeValue, 'context'> {\n    /** How bindings and localization resolve. Omitted means nothing resolves. */\n    context?: InteractionContext;\n\n    /** What the scope encloses. */\n    children: ReactNode;\n}\n\n/**\n * Provides the dispatcher, the resolution context and the enclosing attachments to everything beneath it.\n *\n * Attachments nest: a scope inside another scope appends to it rather than replacing it, so an element's\n * enclosing chain is assembled by the tree rather than reconstructed at each leaf. That is what keeps the\n * additive rule true in a renderer - a module's behavior is still in scope at a button six levels down,\n * without the button knowing the module exists.\n */\nexport function InteractionScope({ children, dispatcher, context = resolvesNothing, attachments, onFindings }: InteractionScopeProps) {\n    const enclosing = useContext(Scope);\n\n    const value = useMemo<InteractionScopeValue>(() => ({\n        dispatcher,\n        context,\n        attachments: [...(enclosing?.attachments ?? []), ...attachments],\n        onFindings: onFindings ?? enclosing?.onFindings,\n    }), [dispatcher, context, attachments, onFindings, enclosing]);\n\n    return <Scope.Provider value={value}>{children}</Scope.Provider>;\n}\n\n/**\n * Reads the enclosing interaction scope.\n *\n * @returns The scope, or `undefined` when the tree is rendered without one.\n * @remarks\n * Rendering without a scope is legitimate - a preview surface showing what a screen looks like has nothing to\n * dispatch to - so this answers `undefined` rather than throwing. What must not happen is an element silently\n * appearing interactive when nothing can run; {@link useInteractions} is where that is decided.\n */\nexport function useInteractionScope(): InteractionScopeValue | undefined {\n    return useContext(Scope);\n}\n\n/**\n * Builds the attachment list for one element, so a caller does not have to know the shape.\n *\n * @param level What is being attached to, used when reporting.\n * @param behaviors The behaviors attached there.\n * @returns The attachment, or an empty list when there are none.\n */\nexport function attachmentFor(level: string, behaviors?: Behavior[]): BehaviorAttachment[] {\n    return behaviors && behaviors.length > 0 ? [{ level, behaviors }] : [];\n}\n"],"names":["resolvesNothing","resolve","undefined","Scope","createContext","InteractionScope","children","dispatcher","context","attachments","onFindings","enclosing","useContext","value","useMemo","_jsx","Provider","useInteractionScope","attachmentFor","level","behaviors","length"],"mappings":";;;;;AAwBA;;;;;;AAMC,IACD,MAAMA,eAAAA,GAAsC;AAAEC,IAAAA,OAAAA,EAAS,IAAMC;AAAU,CAAA;AAEvE,MAAMC,sBAAQC,mBAAAA,CAAiDF,SAAAA,CAAAA;AAiB/D;;;;;;;AAOC,IACM,SAASG,gBAAAA,CAAiB,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,OAAAA,GAAUR,eAAe,EAAES,WAAW,EAAEC,UAAU,EAAyB,EAAA;AAChI,IAAA,MAAMC,YAAYC,gBAAAA,CAAWT,KAAAA,CAAAA;IAE7B,MAAMU,KAAAA,GAAQC,aAAAA,CAA+B,KAAO;AAChDP,YAAAA,UAAAA;AACAC,YAAAA,OAAAA;YACAC,WAAAA,EAAa;AAAKE,gBAAAA,GAAAA,SAAAA,EAAWF,eAAe,EAAE;AAAMA,gBAAAA,GAAAA;AAAY,aAAA;AAChEC,YAAAA,UAAAA,EAAYA,cAAcC,SAAAA,EAAWD;AACzC,SAAA,CAAA,EAAI;AAACH,QAAAA,UAAAA;AAAYC,QAAAA,OAAAA;AAASC,QAAAA,WAAAA;AAAaC,QAAAA,UAAAA;AAAYC,QAAAA;AAAU,KAAA,CAAA;IAE7D,qBAAOI,cAAA,CAACZ,MAAMa,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQP,QAAAA,QAAAA,EAAAA;;AAC1C;AAEA;;;;;;;;AAQC,IACM,SAASW,mBAAAA,GAAAA;AACZ,IAAA,OAAOL,gBAAAA,CAAWT,KAAAA,CAAAA;AACtB;AAEA;;;;;;AAMC,IACM,SAASe,aAAAA,CAAcC,KAAa,EAAEC,SAAsB,EAAA;AAC/D,IAAA,OAAOA,SAAAA,IAAaA,SAAAA,CAAUC,MAAM,GAAG,CAAA,GAAI;AAAC,QAAA;AAAEF,YAAAA,KAAAA;AAAOC,YAAAA;AAAU;AAAE,KAAA,GAAG,EAAE;AAC1E;;;;"}

package/dist/cjs/interactions/NotificationHost.js

@@ -0,0 +1,73 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var scene_model = require('@cratis/scene.model');
+
+const colours = {
+    [scene_model.NotificationLevel.Info]: '#1e6fbf',
+    [scene_model.NotificationLevel.Warning]: '#b8860b',
+    [scene_model.NotificationLevel.Error]: '#c0392b'
+};
+/**
+ * Shows what a document's `notify` asked to say.
+ *
+ * Deliberately plain. An application with a design system of its own passes its own `notify` to the dispatcher
+ * and never renders this; what this exists for is that the default is *something* rather than a console line
+ * nobody is looking at.
+ * @param props The {@link NotificationHostProps}.
+ */ function NotificationHost({ notifications, onDismiss }) {
+    if (notifications.length === 0) return null;
+    return /*#__PURE__*/ jsxRuntime.jsx("div", {
+        role: "log",
+        "aria-live": "polite",
+        "data-scene-notifications": true,
+        style: {
+            position: 'fixed',
+            top: '1rem',
+            right: '1rem',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '0.5rem',
+            zIndex: 1000
+        },
+        children: notifications.map((notification)=>/*#__PURE__*/ jsxRuntime.jsxs("div", {
+                "data-scene-notification": notification.level,
+                style: {
+                    display: 'flex',
+                    alignItems: 'center',
+                    gap: '0.75rem',
+                    maxWidth: '24rem',
+                    padding: '0.625rem 0.75rem',
+                    borderRadius: 4,
+                    border: `1px solid ${colours[notification.level]}`,
+                    borderLeftWidth: 4,
+                    background: '#fff',
+                    color: '#1a1a1a'
+                },
+                children: [
+                    /*#__PURE__*/ jsxRuntime.jsx("span", {
+                        style: {
+                            flex: 1
+                        },
+                        children: notification.message
+                    }),
+                    /*#__PURE__*/ jsxRuntime.jsx("button", {
+                        type: "button",
+                        "aria-label": "Dismiss",
+                        onClick: ()=>onDismiss(notification.id),
+                        style: {
+                            border: 'none',
+                            background: 'none',
+                            cursor: 'pointer',
+                            fontSize: '1rem',
+                            lineHeight: 1
+                        },
+                        children: "x"
+                    })
+                ]
+            }, notification.id))
+    });
+}
+
+exports.NotificationHost = NotificationHost;
+//# sourceMappingURL=NotificationHost.js.map

package/dist/cjs/interactions/NotificationHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationHost.js","sources":["../../../interactions/NotificationHost.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 { NotificationLevel } from '@cratis/scene.model';\nimport { SceneNotification } from './SceneNotification';\n\n/**\n * The properties of {@link NotificationHost}.\n */\nexport interface NotificationHostProps {\n    /** What is currently being said, oldest first. */\n    readonly notifications: readonly SceneNotification[];\n\n    /** Called when one is dismissed. */\n    readonly onDismiss: (id: number) => void;\n}\n\nconst colours: Record<NotificationLevel, string> = {\n    [NotificationLevel.Info]: '#1e6fbf',\n    [NotificationLevel.Warning]: '#b8860b',\n    [NotificationLevel.Error]: '#c0392b',\n};\n\n/**\n * Shows what a document's `notify` asked to say.\n *\n * Deliberately plain. An application with a design system of its own passes its own `notify` to the dispatcher\n * and never renders this; what this exists for is that the default is *something* rather than a console line\n * nobody is looking at.\n * @param props The {@link NotificationHostProps}.\n */\nexport function NotificationHost({ notifications, onDismiss }: NotificationHostProps) {\n    if (notifications.length === 0) return null;\n\n    return (\n        <div role=\"log\" aria-live=\"polite\" data-scene-notifications style={{ position: 'fixed', top: '1rem', right: '1rem', display: 'flex', flexDirection: 'column', gap: '0.5rem', zIndex: 1000 }}>\n            {notifications.map(notification => (\n                <div\n                    key={notification.id}\n                    data-scene-notification={notification.level}\n                    style={{ display: 'flex', alignItems: 'center', gap: '0.75rem', maxWidth: '24rem', padding: '0.625rem 0.75rem', borderRadius: 4, border: `1px solid ${colours[notification.level]}`, borderLeftWidth: 4, background: '#fff', color: '#1a1a1a' }}>\n                    <span style={{ flex: 1 }}>{notification.message}</span>\n                    <button type=\"button\" aria-label=\"Dismiss\" onClick={() => onDismiss(notification.id)} style={{ border: 'none', background: 'none', cursor: 'pointer', fontSize: '1rem', lineHeight: 1 }}>x</button>\n                </div>\n            ))}\n        </div>\n    );\n}\n"],"names":["colours","NotificationLevel","Info","Warning","Error","NotificationHost","notifications","onDismiss","length","_jsx","div","role","aria-live","data-scene-notifications","style","position","top","right","display","flexDirection","gap","zIndex","map","notification","_jsxs","data-scene-notification","level","alignItems","maxWidth","padding","borderRadius","border","borderLeftWidth","background","color","span","flex","message","button","type","aria-label","onClick","id","cursor","fontSize","lineHeight"],"mappings":";;;;;AAiBA,MAAMA,OAAAA,GAA6C;IAC/C,CAACC,6BAAAA,CAAkBC,IAAI,GAAG,SAAA;IAC1B,CAACD,6BAAAA,CAAkBE,OAAO,GAAG,SAAA;IAC7B,CAACF,6BAAAA,CAAkBG,KAAK,GAAG;AAC/B,CAAA;AAEA;;;;;;;AAOC,IACM,SAASC,gBAAAA,CAAiB,EAAEC,aAAa,EAAEC,SAAS,EAAyB,EAAA;AAChF,IAAA,IAAID,aAAAA,CAAcE,MAAM,KAAK,CAAA,EAAG,OAAO,IAAA;AAEvC,IAAA,qBACIC,cAAA,CAACC,KAAAA,EAAAA;QAAIC,IAAAA,EAAK,KAAA;QAAMC,WAAAA,EAAU,QAAA;QAASC,0BAAwB,EAAA,IAAA;QAACC,KAAAA,EAAO;YAAEC,QAAAA,EAAU,OAAA;YAASC,GAAAA,EAAK,MAAA;YAAQC,KAAAA,EAAO,MAAA;YAAQC,OAAAA,EAAS,MAAA;YAAQC,aAAAA,EAAe,QAAA;YAAUC,GAAAA,EAAK,QAAA;YAAUC,MAAAA,EAAQ;AAAK,SAAA;AACrLf,QAAAA,QAAAA,EAAAA,aAAAA,CAAcgB,GAAG,CAACC,CAAAA,YAAAA,iBACfC,eAAA,CAACd,KAAAA,EAAAA;AAEGe,gBAAAA,yBAAAA,EAAyBF,aAAaG,KAAK;gBAC3CZ,KAAAA,EAAO;oBAAEI,OAAAA,EAAS,MAAA;oBAAQS,UAAAA,EAAY,QAAA;oBAAUP,GAAAA,EAAK,SAAA;oBAAWQ,QAAAA,EAAU,OAAA;oBAASC,OAAAA,EAAS,kBAAA;oBAAoBC,YAAAA,EAAc,CAAA;oBAAGC,MAAAA,EAAQ,CAAC,UAAU,EAAE/B,OAAO,CAACuB,YAAAA,CAAaG,KAAK,CAAC,CAAA,CAAE;oBAAEM,eAAAA,EAAiB,CAAA;oBAAGC,UAAAA,EAAY,MAAA;oBAAQC,KAAAA,EAAO;AAAU,iBAAA;;kCAC9OzB,cAAA,CAAC0B,MAAAA,EAAAA;wBAAKrB,KAAAA,EAAO;4BAAEsB,IAAAA,EAAM;AAAE,yBAAA;AAAIb,wBAAAA,QAAAA,EAAAA,YAAAA,CAAac;;kCACxC5B,cAAA,CAAC6B,QAAAA,EAAAA;wBAAOC,IAAAA,EAAK,QAAA;wBAASC,YAAAA,EAAW,SAAA;wBAAUC,OAAAA,EAAS,IAAMlC,SAAAA,CAAUgB,YAAAA,CAAamB,EAAE,CAAA;wBAAG5B,KAAAA,EAAO;4BAAEiB,MAAAA,EAAQ,MAAA;4BAAQE,UAAAA,EAAY,MAAA;4BAAQU,MAAAA,EAAQ,SAAA;4BAAWC,QAAAA,EAAU,MAAA;4BAAQC,UAAAA,EAAY;AAAE,yBAAA;AAAG,wBAAA,QAAA,EAAA;;;AAJpLtB,aAAAA,EAAAA,YAAAA,CAAamB,EAAE,CAAA;;AASxC;;"}

package/dist/cjs/interactions/UnresolvedActionHost.js

@@ -0,0 +1,53 @@
+'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.
+/**
+ * Shows what a document asked for that this host cannot do.
+ *
+ * Only useful while an application is being built, which is why an application that has wired everything will
+ * never see it. It is rendered rather than logged because the person who would fix it is usually looking at
+ * the screen and not at the console.
+ * @param props The {@link UnresolvedActionHostProps}.
+ */ function UnresolvedActionHost({ unresolved }) {
+    if (unresolved.length === 0) return null;
+    return /*#__PURE__*/ jsxRuntime.jsxs("div", {
+        role: "status",
+        "data-scene-unresolved": true,
+        style: {
+            position: 'fixed',
+            bottom: '1rem',
+            left: '1rem',
+            maxWidth: '28rem',
+            padding: '0.625rem 0.75rem',
+            borderRadius: 4,
+            border: '1px solid #c0392b',
+            background: '#fff',
+            color: '#1a1a1a',
+            zIndex: 1000
+        },
+        children: [
+            /*#__PURE__*/ jsxRuntime.jsx("strong", {
+                style: {
+                    display: 'block',
+                    marginBottom: '0.25rem'
+                },
+                children: "This surface cannot do what the document asked"
+            }),
+            /*#__PURE__*/ jsxRuntime.jsx("ul", {
+                style: {
+                    margin: 0,
+                    paddingLeft: '1.25rem'
+                },
+                children: unresolved.map((action)=>/*#__PURE__*/ jsxRuntime.jsx("li", {
+                        children: action.action
+                    }, action.id))
+            })
+        ]
+    });
+}
+
+exports.UnresolvedActionHost = UnresolvedActionHost;
+//# sourceMappingURL=UnresolvedActionHost.js.map

package/dist/cjs/interactions/UnresolvedActionHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnresolvedActionHost.js","sources":["../../../interactions/UnresolvedActionHost.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 { UnresolvedAction } from './UnresolvedAction';\n\n/**\n * The properties of {@link UnresolvedActionHost}.\n */\nexport interface UnresolvedActionHostProps {\n    /** What has been asked for and could not be done. */\n    readonly unresolved: readonly UnresolvedAction[];\n}\n\n/**\n * Shows what a document asked for that this host cannot do.\n *\n * Only useful while an application is being built, which is why an application that has wired everything will\n * never see it. It is rendered rather than logged because the person who would fix it is usually looking at\n * the screen and not at the console.\n * @param props The {@link UnresolvedActionHostProps}.\n */\nexport function UnresolvedActionHost({ unresolved }: UnresolvedActionHostProps) {\n    if (unresolved.length === 0) return null;\n\n    return (\n        <div role=\"status\" data-scene-unresolved style={{ position: 'fixed', bottom: '1rem', left: '1rem', maxWidth: '28rem', padding: '0.625rem 0.75rem', borderRadius: 4, border: '1px solid #c0392b', background: '#fff', color: '#1a1a1a', zIndex: 1000 }}>\n            <strong style={{ display: 'block', marginBottom: '0.25rem' }}>This surface cannot do what the document asked</strong>\n            <ul style={{ margin: 0, paddingLeft: '1.25rem' }}>\n                {unresolved.map(action => <li key={action.id}>{action.action}</li>)}\n            </ul>\n        </div>\n    );\n}\n"],"names":["UnresolvedActionHost","unresolved","length","_jsxs","div","role","data-scene-unresolved","style","position","bottom","left","maxWidth","padding","borderRadius","border","background","color","zIndex","_jsx","strong","display","marginBottom","ul","margin","paddingLeft","map","action","li","id"],"mappings":";;;;AAAA;AACA;AAYA;;;;;;;AAOC,IACM,SAASA,oBAAAA,CAAqB,EAAEC,UAAU,EAA6B,EAAA;AAC1E,IAAA,IAAIA,UAAAA,CAAWC,MAAM,KAAK,CAAA,EAAG,OAAO,IAAA;AAEpC,IAAA,qBACIC,eAAA,CAACC,KAAAA,EAAAA;QAAIC,IAAAA,EAAK,QAAA;QAASC,uBAAqB,EAAA,IAAA;QAACC,KAAAA,EAAO;YAAEC,QAAAA,EAAU,OAAA;YAASC,MAAAA,EAAQ,MAAA;YAAQC,IAAAA,EAAM,MAAA;YAAQC,QAAAA,EAAU,OAAA;YAASC,OAAAA,EAAS,kBAAA;YAAoBC,YAAAA,EAAc,CAAA;YAAGC,MAAAA,EAAQ,mBAAA;YAAqBC,UAAAA,EAAY,MAAA;YAAQC,KAAAA,EAAO,SAAA;YAAWC,MAAAA,EAAQ;AAAK,SAAA;;0BAChPC,cAAA,CAACC,QAAAA,EAAAA;gBAAOZ,KAAAA,EAAO;oBAAEa,OAAAA,EAAS,OAAA;oBAASC,YAAAA,EAAc;AAAU,iBAAA;AAAG,gBAAA,QAAA,EAAA;;0BAC9DH,cAAA,CAACI,IAAAA,EAAAA;gBAAGf,KAAAA,EAAO;oBAAEgB,MAAAA,EAAQ,CAAA;oBAAGC,WAAAA,EAAa;AAAU,iBAAA;AAC1CvB,gBAAAA,QAAAA,EAAAA,UAAAA,CAAWwB,GAAG,CAACC,CAAAA,MAAAA,iBAAUR,cAAA,CAACS,IAAAA,EAAAA;AAAoBD,wBAAAA,QAAAA,EAAAA,MAAAA,CAAOA;AAAnBA,qBAAAA,EAAAA,MAAAA,CAAOE,EAAE,CAAA;;;;AAI5D;;"}

package/dist/cjs/interactions/createBrowserDispatcher.js

@@ -0,0 +1,102 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Creates the dispatcher a browser host uses.
+ *
+ * This is the only place in Scene.React that knows an action has to *happen*. Everything about which actions
+ * run and in what order is the engine's, which is why this file is a list of one-line delegations and holds no
+ * rules of its own.
+ *
+ * @param host What the surrounding application can actually do.
+ * @returns The {@link ActionDispatcher}.
+ */ function createBrowserDispatcher(host = {}) {
+    const unsupported = (action)=>{
+        host.onUnsupported?.(action);
+        console.warn(`[scene] The host cannot '${action}', so the interaction stopped there.`);
+    };
+    return {
+        async executeCommand (command, args) {
+            if (!host.executeCommand) {
+                unsupported(`execute ${command}`);
+                // Reported as a failure, so the document's own `on failure` runs. Answering success would
+                // make a command that never reached a backend look like one that worked.
+                return {
+                    isSuccess: false,
+                    validationErrors: []
+                };
+            }
+            return host.executeCommand(command, args);
+        },
+        navigate (screen, args) {
+            if (host.navigate) {
+                host.navigate(screen, args);
+                return;
+            }
+            unsupported(`navigate to ${screen}`);
+        },
+        navigateBack () {
+            if (host.navigateBack) {
+                host.navigateBack();
+                return;
+            }
+            unsupported('navigate back');
+        },
+        async openDialog (dialogTemplate, args) {
+            if (!host.openDialog) {
+                unsupported(`open dialog ${dialogTemplate}`);
+                return {
+                    isConfirmed: false
+                };
+            }
+            return host.openDialog(dialogTemplate, args);
+        },
+        closeDialog () {
+            if (host.closeDialog) {
+                host.closeDialog();
+                return;
+            }
+            unsupported('close dialog');
+        },
+        async refreshQuery (query) {
+            if (host.refreshQuery) {
+                await host.refreshQuery(query);
+                return;
+            }
+            unsupported(`refresh ${query}`);
+        },
+        setState (target, value) {
+            if (host.setState) {
+                host.setState(target, value);
+                return;
+            }
+            unsupported(`set ${target}`);
+        },
+        notify (level, message) {
+            if (host.notify) {
+                host.notify(level, message);
+                return;
+            }
+            // The console is a poor notification, but it is a real one - and a host that has not wired
+            // notifications yet should still see what the document wanted to say.
+            console.log(`[scene:${level}] ${message}`);
+        },
+        async confirm (message) {
+            if (host.confirm) return host.confirm(message);
+            // The browser's own prompt is the honest default: a confirm exists to gate what follows, so
+            // answering `true` without asking anyone would remove the gate rather than approximate it.
+            return typeof globalThis.confirm === 'function' ? globalThis.confirm(message) : false;
+        },
+        async raise (trigger, args) {
+            if (host.raise) {
+                await host.raise(trigger, args);
+                return;
+            }
+            unsupported(`raise ${trigger}`);
+        }
+    };
+}
+
+exports.createBrowserDispatcher = createBrowserDispatcher;
+//# sourceMappingURL=createBrowserDispatcher.js.map

package/dist/cjs/interactions/createBrowserDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBrowserDispatcher.js","sources":["../../../interactions/createBrowserDispatcher.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ActionDispatcher, CommandOutcome, DialogOutcome } from '@cratis/scene.engine';\nimport { NotificationLevel } from '@cratis/scene.model';\n\n/**\n * What a host has to supply for an interaction to reach anything real.\n *\n * Every member is optional and every one that is missing is *reported* rather than quietly ignored. A host\n * that cannot execute commands is a legitimate state - a preview surface, a design tool - but a button that\n * appears to work and does nothing is not.\n */\nexport interface BrowserDispatcherHost {\n    /** Submits a command. The transport belongs to the host: Scene does not know what a backend is. */\n    executeCommand?: (command: string, args: Record<string, unknown>) => Promise<CommandOutcome>;\n\n    /** Navigates to a screen. The URL belongs to the host, which is why no route is constructed here. */\n    navigate?: (screen: string, args: Record<string, unknown>) => void;\n\n    /** Goes back. */\n    navigateBack?: () => void;\n\n    /** Opens a dialog and answers with what the user did. */\n    openDialog?: (dialogTemplate: string, args: Record<string, unknown>) => Promise<DialogOutcome>;\n\n    /** Closes the open dialog. */\n    closeDialog?: () => void;\n\n    /** Re-runs a query. */\n    refreshQuery?: (query: string) => Promise<void>;\n\n    /** Writes screen state. */\n    setState?: (target: string, value: unknown) => void;\n\n    /** Surfaces a message. Falls back to the console rather than to nothing. */\n    notify?: (level: NotificationLevel, message: string) => void;\n\n    /** Asks the user to confirm. Falls back to the browser's own prompt. */\n    confirm?: (message: string) => Promise<boolean>;\n\n    /** Raises an application trigger. */\n    raise?: (trigger: string, args: Record<string, unknown>) => Promise<void>;\n\n    /** Where an unsupported action is reported. */\n    onUnsupported?: (action: string) => void;\n}\n\n/**\n * Creates the dispatcher a browser host uses.\n *\n * This is the only place in Scene.React that knows an action has to *happen*. Everything about which actions\n * run and in what order is the engine's, which is why this file is a list of one-line delegations and holds no\n * rules of its own.\n *\n * @param host What the surrounding application can actually do.\n * @returns The {@link ActionDispatcher}.\n */\nexport function createBrowserDispatcher(host: BrowserDispatcherHost = {}): ActionDispatcher {\n    const unsupported = (action: string) => {\n        host.onUnsupported?.(action);\n        console.warn(`[scene] The host cannot '${action}', so the interaction stopped there.`);\n    };\n\n    return {\n        async executeCommand(command, args) {\n            if (!host.executeCommand) {\n                unsupported(`execute ${command}`);\n\n                // Reported as a failure, so the document's own `on failure` runs. Answering success would\n                // make a command that never reached a backend look like one that worked.\n                return { isSuccess: false, validationErrors: [] };\n            }\n\n            return host.executeCommand(command, args);\n        },\n\n        navigate(screen, args) {\n            if (host.navigate) {\n                host.navigate(screen, args);\n                return;\n            }\n\n            unsupported(`navigate to ${screen}`);\n        },\n\n        navigateBack() {\n            if (host.navigateBack) {\n                host.navigateBack();\n                return;\n            }\n\n            unsupported('navigate back');\n        },\n\n        async openDialog(dialogTemplate, args) {\n            if (!host.openDialog) {\n                unsupported(`open dialog ${dialogTemplate}`);\n                return { isConfirmed: false };\n            }\n\n            return host.openDialog(dialogTemplate, args);\n        },\n\n        closeDialog() {\n            if (host.closeDialog) {\n                host.closeDialog();\n                return;\n            }\n\n            unsupported('close dialog');\n        },\n\n        async refreshQuery(query) {\n            if (host.refreshQuery) {\n                await host.refreshQuery(query);\n                return;\n            }\n\n            unsupported(`refresh ${query}`);\n        },\n\n        setState(target, value) {\n            if (host.setState) {\n                host.setState(target, value);\n                return;\n            }\n\n            unsupported(`set ${target}`);\n        },\n\n        notify(level, message) {\n            if (host.notify) {\n                host.notify(level, message);\n                return;\n            }\n\n            // The console is a poor notification, but it is a real one - and a host that has not wired\n            // notifications yet should still see what the document wanted to say.\n            console.log(`[scene:${level}] ${message}`);\n        },\n\n        async confirm(message) {\n            if (host.confirm) return host.confirm(message);\n\n            // The browser's own prompt is the honest default: a confirm exists to gate what follows, so\n            // answering `true` without asking anyone would remove the gate rather than approximate it.\n            return typeof globalThis.confirm === 'function' ? globalThis.confirm(message) : false;\n        },\n\n        async raise(trigger, args) {\n            if (host.raise) {\n                await host.raise(trigger, args);\n                return;\n            }\n\n            unsupported(`raise ${trigger}`);\n        },\n    };\n}\n"],"names":["createBrowserDispatcher","host","unsupported","action","onUnsupported","console","warn","executeCommand","command","args","isSuccess","validationErrors","navigate","screen","navigateBack","openDialog","dialogTemplate","isConfirmed","closeDialog","refreshQuery","query","setState","target","value","notify","level","message","log","confirm","globalThis","raise","trigger"],"mappings":"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"}