@cratis/scene.react 4.0.0 → 4.1.1

package/dist/esm/for_useInteractionHosts/when_the_host_cannot_do_what_was_asked.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { render, screen } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { useMemo } from 'react';
+import { InteractionActionKind, InteractionTriggerKind } from '@cratis/scene.model';
+import { InteractionScope, createBrowserDispatcher, useInteractionHosts, useInteractions } from '../interactions';
+const navigateSomewhere = {
+    name: 'GoToInvoice',
+    bindings: [
+        {
+            trigger: { kind: InteractionTriggerKind.Click },
+            actions: [{ kind: InteractionActionKind.Navigate, screen: 'InvoiceDetails' }],
+        },
+    ],
+};
+function Button() {
+    const handlers = useInteractions('element', [navigateSomewhere]);
+    return _jsx("button", { type: "button", ...handlers, children: "Open" });
+}
+function Application() {
+    const { host, surfaces } = useInteractionHosts();
+    const dispatcher = useMemo(() => createBrowserDispatcher(host), [host]);
+    return (_jsxs(InteractionScope, { dispatcher: dispatcher, attachments: [], children: [_jsx(Button, {}), surfaces] }));
+}
+describe('when the host cannot do what was asked', () => {
+    it('should say so on the screen rather than do nothing', async () => {
+        render(_jsx(Application, {}));
+        await userEvent.click(screen.getByRole('button', { name: 'Open' }));
+        screen.getByText('navigate to InvoiceDetails').textContent.should.equal('navigate to InvoiceDetails');
+    });
+    it('should report the same action once however often it is asked for', async () => {
+        render(_jsx(Application, {}));
+        await userEvent.click(screen.getByRole('button', { name: 'Open' }));
+        await userEvent.click(screen.getByRole('button', { name: 'Open' }));
+        await userEvent.click(screen.getByRole('button', { name: 'Open' }));
+        screen.getAllByText('navigate to InvoiceDetails').should.have.lengthOf(1);
+    });
+    it('should say nothing when nothing has failed', () => {
+        render(_jsx(Application, {}));
+        (screen.queryByText(/cannot do what the document asked/) === null).should.equal(true);
+    });
+});
+//# sourceMappingURL=when_the_host_cannot_do_what_was_asked.js.map

package/dist/esm/for_useInteractionHosts/when_the_host_cannot_do_what_was_asked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when_the_host_cannot_do_what_was_asked.js","sourceRoot":"","sources":["../../../for_useInteractionHosts/when_the_host_cannot_do_what_was_asked.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,SAAS,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAY,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElH,MAAM,iBAAiB,GAAa;IAChC,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE;QACN;YACI,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,CAAC,KAAK,EAAW;YACxD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAW,CAAC;SACzF;KACJ;CACJ,CAAC;AAEF,SAAS,MAAM;IACX,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACjE,OAAO,iBAAQ,IAAI,EAAC,QAAQ,KAAK,QAAQ,qBAAe,CAAC;AAC7D,CAAC;AAKD,SAAS,WAAW;IAChB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAExE,OAAO,CACH,MAAC,gBAAgB,IAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,aACrD,KAAC,MAAM,KAAG,EACT,QAAQ,IACM,CACtB,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,CAAC,KAAC,WAAW,KAAG,CAAC,CAAC;QAExB,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAEpE,MAAM,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC,WAAY,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC3G,CAAC,CAAC,CAAC;IAIH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,CAAC,KAAC,WAAW,KAAG,CAAC,CAAC;QAExB,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAEpE,MAAM,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,KAAC,WAAW,KAAG,CAAC,CAAC;QAExB,CAAC,MAAM,CAAC,WAAW,CAAC,mCAAmC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/esm/index.js

@@ -16,4 +16,8 @@ export { SceneThemeProvider, useSceneTheme } from './theme/SceneThemeProvider.js
 export { InteractionScope, attachmentFor, useInteractionScope } from './interactions/InteractionScope.js';
 export { useInteractions } from './interactions/useInteractions.js';
 export { createBrowserDispatcher } from './interactions/createBrowserDispatcher.js';
+export { ConfirmHost } from './interactions/ConfirmHost.js';
+export { NotificationHost } from './interactions/NotificationHost.js';
+export { UnresolvedActionHost } from './interactions/UnresolvedActionHost.js';
+export { useInteractionHosts } from './interactions/useInteractionHosts.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/interactions/ConfirmHost.d.ts

@@ -0,0 +1,8 @@
+import { ConfirmRequest } from './ConfirmRequest';
+export interface ConfirmHostProps {
+    readonly request?: ConfirmRequest;
+    readonly confirmLabel?: string;
+    readonly cancelLabel?: string;
+}
+export declare function ConfirmHost({ request, confirmLabel, cancelLabel }: ConfirmHostProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ConfirmHost.d.ts.map

package/dist/esm/interactions/ConfirmHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmHost.d.ts","sourceRoot":"","sources":["../../../interactions/ConfirmHost.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKlD,MAAM,WAAW,gBAAgB;IAE7B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAGlC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAG/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CACjC;AAUD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,YAAmB,EAAE,WAAsB,EAAE,EAAE,gBAAgB,sCAcrG"}

package/dist/esm/interactions/ConfirmHost.js

@@ -0,0 +1,69 @@
+import { jsx, jsxs } from '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__*/ 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__*/ 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__*/ jsx("p", {
+                    style: {
+                        margin: '0 0 1rem'
+                    },
+                    children: request.message
+                }),
+                /*#__PURE__*/ jsxs("div", {
+                    style: {
+                        display: 'flex',
+                        justifyContent: 'flex-end',
+                        gap: '0.5rem'
+                    },
+                    children: [
+                        /*#__PURE__*/ jsx("button", {
+                            type: "button",
+                            onClick: ()=>request.answer(false),
+                            children: cancelLabel
+                        }),
+                        /*#__PURE__*/ jsx("button", {
+                            type: "button",
+                            onClick: ()=>request.answer(true),
+                            children: confirmLabel
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+
+export { ConfirmHost };
+//# sourceMappingURL=ConfirmHost.js.map

package/dist/esm/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,GAAA,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,IAAA,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,GAAA,CAACqB,GAAAA,EAAAA;oBAAElB,KAAAA,EAAO;wBAAEmB,MAAAA,EAAQ;AAAW,qBAAA;AAAIzB,oBAAAA,QAAAA,EAAAA,OAAAA,CAAQkB;;8BAC3CJ,IAAA,CAACV,KAAAA,EAAAA;oBAAIE,KAAAA,EAAO;wBAAEG,OAAAA,EAAS,MAAA;wBAAQE,cAAAA,EAAgB,UAAA;wBAAYe,GAAAA,EAAK;AAAS,qBAAA;;sCACrEvB,GAAA,CAACwB,QAAAA,EAAAA;4BAAOC,IAAAA,EAAK,QAAA;4BAASC,OAAAA,EAAS,IAAM7B,OAAAA,CAAQ8B,MAAM,CAAC,KAAA,CAAA;AAAS5B,4BAAAA,QAAAA,EAAAA;;sCAC7DC,GAAA,CAACwB,QAAAA,EAAAA;4BAAOC,IAAAA,EAAK,QAAA;4BAASC,OAAAA,EAAS,IAAM7B,OAAAA,CAAQ8B,MAAM,CAAC,IAAA,CAAA;AAAQ7B,4BAAAA,QAAAA,EAAAA;;;;;;;AAKhF;;"}

package/dist/esm/interactions/ConfirmRequest.d.ts

@@ -0,0 +1,5 @@
+export interface ConfirmRequest {
+    readonly message: string;
+    answer(confirmed: boolean): void;
+}
+//# sourceMappingURL=ConfirmRequest.d.ts.map

package/dist/esm/interactions/ConfirmRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmRequest.d.ts","sourceRoot":"","sources":["../../../interactions/ConfirmRequest.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAE3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAMzB,MAAM,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC"}

package/dist/esm/interactions/ConfirmRequest.js

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

package/dist/esm/interactions/ConfirmRequest.js.map

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

package/dist/esm/interactions/InteractionScope.d.ts

@@ -7,7 +7,8 @@ export interface InteractionScopeValue {
     attachments: BehaviorAttachment[];
     onFindings?: (findings: InteractionFinding[]) => void;
 }
-export interface InteractionScopeProps extends InteractionScopeValue {
+export interface InteractionScopeProps extends Omit<InteractionScopeValue, 'context'> {
+    context?: InteractionContext;
     children: ReactNode;
 }
 export declare function InteractionScope({ children, dispatcher, context, attachments, onFindings }: InteractionScopeProps): import("react").JSX.Element;

package/dist/esm/interactions/InteractionScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InteractionScope.d.ts","sourceRoot":"","sources":["../../../interactions/InteractionScope.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAsC,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAK/C,MAAM,WAAW,qBAAqB;IAElC,UAAU,EAAE,gBAAgB,CAAC;IAG7B,OAAO,EAAE,kBAAkB,CAAC;IAG5B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAGlC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACzD;AAID,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,QAAQ,EAAE,SAAS,CAAC;CACvB;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,qBAAqB,+BAWjH;AAWD,wBAAgB,mBAAmB,IAAI,qBAAqB,GAAG,SAAS,CAEvE;AASD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAEzF"}
+{"version":3,"file":"InteractionScope.d.ts","sourceRoot":"","sources":["../../../interactions/InteractionScope.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAsC,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAK/C,MAAM,WAAW,qBAAqB;IAElC,UAAU,EAAE,gBAAgB,CAAC;IAG7B,OAAO,EAAE,kBAAkB,CAAC;IAG5B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAGlC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;CACzD;AAoBD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,SAAS,CAAC;IAEjF,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAG7B,QAAQ,EAAE,SAAS,CAAC;CACvB;AAUD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAyB,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,qBAAqB,+BAWnI;AAWD,wBAAgB,mBAAmB,IAAI,qBAAqB,GAAG,SAAS,CAEvE;AASD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,kBAAkB,EAAE,CAEzF"}

package/dist/esm/interactions/InteractionScope.js

@@ -1,6 +1,15 @@
 import { jsx } from 'react/jsx-runtime';
 import { useContext, useMemo, createContext } from '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__*/ createContext(undefined);
 /**
  * Provides the dispatcher, the resolution context and the enclosing attachments to everything beneath it.
@@ -9,7 +18,7 @@ const Scope = /*#__PURE__*/ createContext(undefined);
  * 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, attachments, onFindings }) {
+ */ function InteractionScope({ children, dispatcher, context = resolvesNothing, attachments, onFindings }) {
     const enclosing = useContext(Scope);
     const value = useMemo(()=>({
             dispatcher,

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

@@ -1 +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\nconst Scope = createContext<InteractionScopeValue | undefined>(undefined);\n\nexport interface InteractionScopeProps extends InteractionScopeValue {\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, 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":["Scope","createContext","undefined","InteractionScope","children","dispatcher","context","attachments","onFindings","enclosing","useContext","value","useMemo","_jsx","Provider","useInteractionScope","attachmentFor","level","behaviors","length"],"mappings":";;;AAwBA,MAAMA,sBAAQC,aAAAA,CAAiDC,SAAAA,CAAAA;AAM/D;;;;;;;AAOC,IACM,SAASC,gBAAAA,CAAiB,EAAEC,QAAQ,EAAEC,UAAU,EAAEC,OAAO,EAAEC,WAAW,EAAEC,UAAU,EAAyB,EAAA;AAC9G,IAAA,MAAMC,YAAYC,UAAAA,CAAWV,KAAAA,CAAAA;IAE7B,MAAMW,KAAAA,GAAQC,OAAAA,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,GAAA,CAACb,MAAMc,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQP,QAAAA,QAAAA,EAAAA;;AAC1C;AAEA;;;;;;;;AAQC,IACM,SAASW,mBAAAA,GAAAA;AACZ,IAAA,OAAOL,UAAAA,CAAWV,KAAAA,CAAAA;AACtB;AAEA;;;;;;AAMC,IACM,SAASgB,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;;"}
+{"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,aAAAA,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,UAAAA,CAAWT,KAAAA,CAAAA;IAE7B,MAAMU,KAAAA,GAAQC,OAAAA,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,GAAA,CAACZ,MAAMa,QAAQ,EAAA;QAACH,KAAAA,EAAOA,KAAAA;AAAQP,QAAAA,QAAAA,EAAAA;;AAC1C;AAEA;;;;;;;;AAQC,IACM,SAASW,mBAAAA,GAAAA;AACZ,IAAA,OAAOL,UAAAA,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/esm/interactions/NotificationHost.d.ts

@@ -0,0 +1,7 @@
+import { SceneNotification } from './SceneNotification';
+export interface NotificationHostProps {
+    readonly notifications: readonly SceneNotification[];
+    readonly onDismiss: (id: number) => void;
+}
+export declare function NotificationHost({ notifications, onDismiss }: NotificationHostProps): import("react").JSX.Element | null;
+//# sourceMappingURL=NotificationHost.d.ts.map

package/dist/esm/interactions/NotificationHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationHost.d.ts","sourceRoot":"","sources":["../../../interactions/NotificationHost.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKxD,MAAM,WAAW,qBAAqB;IAElC,QAAQ,CAAC,aAAa,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAGrD,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAgBD,wBAAgB,gBAAgB,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,qBAAqB,sCAgBnF"}

package/dist/esm/interactions/NotificationHost.js

@@ -0,0 +1,71 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { NotificationLevel } from '@cratis/scene.model';
+
+const colours = {
+    [NotificationLevel.Info]: '#1e6fbf',
+    [NotificationLevel.Warning]: '#b8860b',
+    [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__*/ 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__*/ 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__*/ jsx("span", {
+                        style: {
+                            flex: 1
+                        },
+                        children: notification.message
+                    }),
+                    /*#__PURE__*/ 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))
+    });
+}
+
+export { NotificationHost };
+//# sourceMappingURL=NotificationHost.js.map

package/dist/esm/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,iBAAAA,CAAkBC,IAAI,GAAG,SAAA;IAC1B,CAACD,iBAAAA,CAAkBE,OAAO,GAAG,SAAA;IAC7B,CAACF,iBAAAA,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,GAAA,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,IAAA,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,GAAA,CAAC0B,MAAAA,EAAAA;wBAAKrB,KAAAA,EAAO;4BAAEsB,IAAAA,EAAM;AAAE,yBAAA;AAAIb,wBAAAA,QAAAA,EAAAA,YAAAA,CAAac;;kCACxC5B,GAAA,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/esm/interactions/SceneNotification.d.ts

@@ -0,0 +1,7 @@
+import { NotificationLevel } from '@cratis/scene.model';
+export interface SceneNotification {
+    readonly id: number;
+    readonly level: NotificationLevel;
+    readonly message: string;
+}
+//# sourceMappingURL=SceneNotification.d.ts.map

package/dist/esm/interactions/SceneNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneNotification.d.ts","sourceRoot":"","sources":["../../../interactions/SceneNotification.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKxD,MAAM,WAAW,iBAAiB;IAE9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAGlC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/esm/interactions/SceneNotification.js

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

package/dist/esm/interactions/SceneNotification.js.map

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

package/dist/esm/interactions/UnresolvedAction.d.ts

@@ -0,0 +1,5 @@
+export interface UnresolvedAction {
+    readonly id: number;
+    readonly action: string;
+}
+//# sourceMappingURL=UnresolvedAction.d.ts.map

package/dist/esm/interactions/UnresolvedAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnresolvedAction.d.ts","sourceRoot":"","sources":["../../../interactions/UnresolvedAction.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAE7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAGpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAC3B"}

package/dist/esm/interactions/UnresolvedAction.js

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

package/dist/esm/interactions/UnresolvedAction.js.map

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

package/dist/esm/interactions/UnresolvedActionHost.d.ts

@@ -0,0 +1,6 @@
+import { UnresolvedAction } from './UnresolvedAction';
+export interface UnresolvedActionHostProps {
+    readonly unresolved: readonly UnresolvedAction[];
+}
+export declare function UnresolvedActionHost({ unresolved }: UnresolvedActionHostProps): import("react").JSX.Element | null;
+//# sourceMappingURL=UnresolvedActionHost.d.ts.map

package/dist/esm/interactions/UnresolvedActionHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnresolvedActionHost.d.ts","sourceRoot":"","sources":["../../../interactions/UnresolvedActionHost.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,WAAW,yBAAyB;IAEtC,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD;AAUD,wBAAgB,oBAAoB,CAAC,EAAE,UAAU,EAAE,EAAE,yBAAyB,sCAW7E"}

package/dist/esm/interactions/UnresolvedActionHost.js

@@ -0,0 +1,51 @@
+import { jsxs, jsx } from '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__*/ 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__*/ jsx("strong", {
+                style: {
+                    display: 'block',
+                    marginBottom: '0.25rem'
+                },
+                children: "This surface cannot do what the document asked"
+            }),
+            /*#__PURE__*/ jsx("ul", {
+                style: {
+                    margin: 0,
+                    paddingLeft: '1.25rem'
+                },
+                children: unresolved.map((action)=>/*#__PURE__*/ jsx("li", {
+                        children: action.action
+                    }, action.id))
+            })
+        ]
+    });
+}
+
+export { UnresolvedActionHost };
+//# sourceMappingURL=UnresolvedActionHost.js.map

package/dist/esm/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,IAAA,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,GAAA,CAACC,QAAAA,EAAAA;gBAAOZ,KAAAA,EAAO;oBAAEa,OAAAA,EAAS,OAAA;oBAASC,YAAAA,EAAc;AAAU,iBAAA;AAAG,gBAAA,QAAA,EAAA;;0BAC9DH,GAAA,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,GAAA,CAACS,IAAAA,EAAAA;AAAoBD,wBAAAA,QAAAA,EAAAA,MAAAA,CAAOA;AAAnBA,qBAAAA,EAAAA,MAAAA,CAAOE,EAAE,CAAA;;;;AAI5D;;"}

package/dist/esm/interactions/index.d.ts

@@ -1,4 +1,11 @@
 export * from './InteractionScope';
 export * from './useInteractions';
 export * from './createBrowserDispatcher';
+export * from './ConfirmHost';
+export * from './ConfirmRequest';
+export * from './NotificationHost';
+export * from './SceneNotification';
+export * from './UnresolvedAction';
+export * from './UnresolvedActionHost';
+export * from './useInteractionHosts';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/interactions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../interactions/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../interactions/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/esm/interactions/index.js

@@ -1,4 +1,11 @@
 export * from './InteractionScope';
 export * from './useInteractions';
 export * from './createBrowserDispatcher';
+export * from './ConfirmHost';
+export * from './ConfirmRequest';
+export * from './NotificationHost';
+export * from './SceneNotification';
+export * from './UnresolvedAction';
+export * from './UnresolvedActionHost';
+export * from './useInteractionHosts';
 //# sourceMappingURL=index.js.map

package/dist/esm/interactions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../interactions/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../interactions/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/esm/interactions/useInteractionHosts.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { BrowserDispatcherHost } from './createBrowserDispatcher';
+export interface InteractionHosts {
+    readonly host: Pick<BrowserDispatcherHost, 'notify' | 'confirm' | 'onUnsupported'>;
+    readonly surfaces: ReactNode;
+}
+export interface InteractionHostOptions {
+    readonly dismissAfter?: number;
+}
+export declare function useInteractionHosts(options?: InteractionHostOptions): InteractionHosts;
+//# sourceMappingURL=useInteractionHosts.d.ts.map

package/dist/esm/interactions/useInteractionHosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractionHosts.d.ts","sourceRoot":"","sources":["../../../interactions/useInteractionHosts.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAA0C,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAWlE,MAAM,WAAW,gBAAgB;IAE7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC,CAAC;IAGnF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAChC;AAKD,MAAM,WAAW,sBAAsB;IAEnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAClC;AAuBD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,GAAG,gBAAgB,CA+C1F"}

package/dist/esm/interactions/useInteractionHosts.js

@@ -0,0 +1,107 @@
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
+import { useState, useRef, useCallback, useMemo } from 'react';
+import { ConfirmHost } from './ConfirmHost.js';
+import { NotificationHost } from './NotificationHost.js';
+import { UnresolvedActionHost } from './UnresolvedActionHost.js';
+
+/**
+ * Provides the default surfaces for the actions that need somewhere to appear.
+ *
+ * `notify` and `confirm` are the two actions a document can take that have no backend and no route: they are
+ * purely things the user sees. Without a surface, a host either invents one or the action goes to the console,
+ * which is why these ship with Scene rather than being every application's first chore.
+ *
+ * The three are returned as one unit because they are wired the same way and forgetting to render one of them
+ * is exactly the failure they exist to prevent:
+ *
+ * ```tsx
+ * const { host, surfaces } = useInteractionHosts();
+ * const dispatcher = useMemo(() => createBrowserDispatcher({ ...host, executeCommand, navigate }), [host]);
+ *
+ * return <InteractionScope dispatcher={dispatcher}>{children}{surfaces}</InteractionScope>;
+ * ```
+ *
+ * An application with a design system of its own passes its own `notify` after the spread and keeps the rest.
+ * @param options The {@link InteractionHostOptions}.
+ * @returns The {@link InteractionHosts}.
+ */ function useInteractionHosts(options = {}) {
+    const { dismissAfter = 6000 } = options;
+    const [notifications, setNotifications] = useState([]);
+    const [unresolved, setUnresolved] = useState([]);
+    const [request, setRequest] = useState(undefined);
+    const nextId = useRef(0);
+    const dismiss = useCallback((id)=>setNotifications((current)=>current.filter((_)=>_.id !== id)), []);
+    const notify = useCallback((level, message)=>{
+        const id = nextId.current++;
+        setNotifications((current)=>[
+                ...current,
+                {
+                    id,
+                    level,
+                    message
+                }
+            ]);
+        if (dismissAfter > 0) {
+            setTimeout(()=>setNotifications((current)=>current.filter((_)=>_.id !== id)), dismissAfter);
+        }
+    }, [
+        dismissAfter
+    ]);
+    const confirm = useCallback((message)=>new Promise((resolve)=>{
+            setRequest({
+                message,
+                answer (confirmed) {
+                    // Cleared before resolving, so the sequence that continues cannot find a question on screen
+                    // that has already been answered.
+                    setRequest(undefined);
+                    resolve(confirmed);
+                }
+            });
+        }), []);
+    const onUnsupported = useCallback((action)=>{
+        // Reported once per distinct action. An unsupported action on a hover or an interval would otherwise
+        // grow the list until it covered the application it is trying to tell you about.
+        setUnresolved((current)=>current.some((_)=>_.action === action) ? current : [
+                ...current,
+                {
+                    id: nextId.current++,
+                    action
+                }
+            ]);
+    }, []);
+    const host = useMemo(()=>({
+            notify,
+            confirm,
+            onUnsupported
+        }), [
+        notify,
+        confirm,
+        onUnsupported
+    ]);
+    const surfaces = useMemo(()=>/*#__PURE__*/ jsxs(Fragment, {
+            children: [
+                /*#__PURE__*/ jsx(NotificationHost, {
+                    notifications: notifications,
+                    onDismiss: dismiss
+                }),
+                /*#__PURE__*/ jsx(ConfirmHost, {
+                    request: request
+                }),
+                /*#__PURE__*/ jsx(UnresolvedActionHost, {
+                    unresolved: unresolved
+                })
+            ]
+        }), [
+        notifications,
+        dismiss,
+        request,
+        unresolved
+    ]);
+    return {
+        host,
+        surfaces
+    };
+}
+
+export { useInteractionHosts };
+//# sourceMappingURL=useInteractionHosts.js.map