@cratis/scene.primereact 4.5.0 → 4.7.0

package/dist/esm/file/PrimeFileUpload.js

@@ -0,0 +1,159 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useContext, useSyncExternalStore, useMemo } from 'react';
+import { FileUpload } from 'primereact/fileupload';
+import { stringProperty, booleanProperty, numberProperty } from '../properties.js';
+import { resolveEnumeration } from '../resolveEnumeration.js';
+import { FileUploadContext } from './FileUploadContext.js';
+import { FileUploadMode } from './FileUploadMode.js';
+import { resolveUploadTarget } from './resolveUploadTarget.js';
+import { useUploadSession } from './useUploadSession.js';
+
+const subscribeToNothing = ()=>()=>undefined;
+const pageOrigin = ()=>window.location.origin;
+const noPageOrigin = ()=>undefined;
+/**
+ * The `PrimeReact:fileUpload` component.
+ *
+ * PrimeReact 11 provides the accessible file picker and drop zone; this adapter owns everything that has an
+ * effect or a policy:
+ * - The authored `url` is untrusted data. It is checked by {@link resolveUploadTarget} - same origin as the
+ *   page unless the host allows more through {@link FileUploadHandlerProvider} - and a refused address is
+ *   reported and blocks every upload, the host's handler included.
+ * - Nothing is requested on mount. A request starts only when the user selects or drops files (automatic and
+ *   basic mode) or presses the upload button.
+ * - `multiple: false` is enforced before anything is sent, for the file input and for drag and drop.
+ * - One upload runs at a time (nothing can be selected or dropped while it runs), and a failure is shown
+ *   rather than thrown.
+ * - A disabled element (`isEnabled: false`) disables the picker, the upload button and the drop zone.
+ *
+ * Without a host handler the control posts the files itself with `fetch`, sending cookies to the page's own
+ * origin only.
+ */ function PrimeFileUpload({ element, interactions }) {
+    const { handler, allowedOrigins } = useContext(FileUploadContext);
+    const origin = useSyncExternalStore(subscribeToNothing, pageOrigin, noPageOrigin);
+    const modeResolution = resolveEnumeration('mode', element.properties.mode, FileUploadMode, FileUploadMode.Advanced);
+    const mode = modeResolution.isValid ? modeResolution.value : FileUploadMode.Advanced;
+    const authoredUrl = stringProperty(element, 'url');
+    const target = useMemo(()=>resolveUploadTarget(authoredUrl, origin, allowedOrigins), [
+        authoredUrl,
+        origin,
+        allowedOrigins
+    ]);
+    const serverUrl = target.isValid ? target.url : undefined;
+    const multiple = booleanProperty(element, 'multiple', false);
+    const enabled = element.isEnabled;
+    const canUpload = target.isValid && (handler !== undefined || serverUrl !== undefined);
+    const session = useUploadSession(handler, serverUrl, stringProperty(element, 'name', 'files'));
+    const uploaded = async (event)=>{
+        if (!enabled || !canUpload) return;
+        if (await session.upload(event.files)) event.options.clear();
+    };
+    const changed = (event)=>{
+        // Clearing the selection after an upload reports an empty change; it is not a new selection, and must not
+        // wipe the result of the upload that caused it.
+        if (event.acceptedFiles.length === 0 && event.rejectedFiles.length === 0) return;
+        const rejection = event.rejectedFiles.flatMap((rejected)=>rejected.errors.map((error)=>error.message)).join(' ');
+        session.setStatus(rejection === '' ? undefined : {
+            kind: 'error',
+            text: rejection
+        });
+        interactions?.onChange?.();
+    };
+    const refuseSeveralFromInput = (event)=>{
+        const input = event.target;
+        if (input.type !== 'file') return;
+        if (session.busy) {
+            event.stopPropagation();
+            input.value = '';
+            return;
+        }
+        if (multiple || (input.files?.length ?? 0) < 2) return;
+        event.stopPropagation();
+        input.value = '';
+        session.setStatus({
+            kind: 'error',
+            text: 'Only one file can be uploaded at a time.'
+        });
+    };
+    const refuseDrop = (event)=>{
+        if (!enabled) {
+            event.preventDefault();
+            return;
+        }
+        if (session.busy) {
+            event.preventDefault();
+            event.stopPropagation();
+            return;
+        }
+        if (multiple || (event.dataTransfer?.files.length ?? 0) < 2) return;
+        event.preventDefault();
+        event.stopPropagation();
+        session.setStatus({
+            kind: 'error',
+            text: 'Only one file can be uploaded at a time.'
+        });
+    };
+    return /*#__PURE__*/ jsx("div", {
+        "data-scene-id": element.id,
+        "data-scene-component": "fileUpload",
+        onClick: interactions?.onClick,
+        onDoubleClick: interactions?.onDoubleClick,
+        onChangeCapture: refuseSeveralFromInput,
+        onDropCapture: refuseDrop,
+        onDragOverCapture: (event)=>{
+            if (!enabled) event.preventDefault();
+        },
+        children: /*#__PURE__*/ jsx(FileUpload.Root, {
+            accept: stringProperty(element, 'accept'),
+            auto: (mode === FileUploadMode.Auto || mode === FileUploadMode.Basic) && canUpload,
+            customUpload: true,
+            disabled: !enabled,
+            maxFileSize: numberProperty(element, 'maxFileSize'),
+            multiple: multiple,
+            name: stringProperty(element, 'name', 'files'),
+            uploadHandler: uploaded,
+            onChange: changed,
+            children: /*#__PURE__*/ jsxs(FileUpload.Content, {
+                "aria-label": stringProperty(element, 'ariaLabel', 'File upload drop zone'),
+                children: [
+                    /*#__PURE__*/ jsx("p", {
+                        children: mode === FileUploadMode.Basic ? 'Choose a file to upload.' : 'Drop files here or choose files to upload.'
+                    }),
+                    /*#__PURE__*/ jsx(FileUpload.Trigger, {
+                        disabled: !enabled || session.busy,
+                        children: mode === FileUploadMode.Basic ? 'Choose file' : 'Choose files'
+                    }),
+                    mode === FileUploadMode.Advanced && /*#__PURE__*/ jsx(FileUpload.Upload, {
+                        disabled: !enabled || !canUpload || session.busy,
+                        children: "Upload selected files"
+                    }),
+                    !modeResolution.isValid && /*#__PURE__*/ jsx("p", {
+                        role: "alert",
+                        "data-scene-state": "unsupported-mode",
+                        children: modeResolution.message
+                    }),
+                    !target.isValid && /*#__PURE__*/ jsx("p", {
+                        role: "alert",
+                        "data-scene-state": "refused-address",
+                        children: target.message
+                    }),
+                    target.isValid && !canUpload && /*#__PURE__*/ jsx("p", {
+                        role: "status",
+                        children: "Configure a server URL or provide an upload handler to upload files."
+                    }),
+                    session.busy && /*#__PURE__*/ jsx("p", {
+                        role: "status",
+                        children: "Uploading…"
+                    }),
+                    session.status !== undefined && /*#__PURE__*/ jsx("p", {
+                        role: session.status.kind === 'error' ? 'alert' : 'status',
+                        children: session.status.text
+                    })
+                ]
+            })
+        })
+    });
+}
+
+export { PrimeFileUpload };
+//# sourceMappingURL=PrimeFileUpload.js.map

package/dist/esm/file/PrimeFileUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrimeFileUpload.js","sources":["../../../file/PrimeFileUpload.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 { ChangeEvent, DragEvent, useContext, useMemo, useSyncExternalStore } from 'react';\nimport { FileUpload, type FileUploadChangeEvent, type FileUploadHandlerEvent } from 'primereact/fileupload';\nimport { RegisteredComponentProps } from '@cratis/scene.react';\nimport { booleanProperty, numberProperty, stringProperty } from '../properties';\nimport { resolveEnumeration } from '../resolveEnumeration';\nimport { FileUploadContext } from './FileUploadContext';\nimport { FileUploadMode } from './FileUploadMode';\nimport { resolveUploadTarget } from './resolveUploadTarget';\nimport { useUploadSession } from './useUploadSession';\n\nconst subscribeToNothing = () => () => undefined;\nconst pageOrigin = () => window.location.origin;\nconst noPageOrigin = () => undefined;\n\n/**\n * The `PrimeReact:fileUpload` component.\n *\n * PrimeReact 11 provides the accessible file picker and drop zone; this adapter owns everything that has an\n * effect or a policy:\n * - The authored `url` is untrusted data. It is checked by {@link resolveUploadTarget} - same origin as the\n *   page unless the host allows more through {@link FileUploadHandlerProvider} - and a refused address is\n *   reported and blocks every upload, the host's handler included.\n * - Nothing is requested on mount. A request starts only when the user selects or drops files (automatic and\n *   basic mode) or presses the upload button.\n * - `multiple: false` is enforced before anything is sent, for the file input and for drag and drop.\n * - One upload runs at a time (nothing can be selected or dropped while it runs), and a failure is shown\n *   rather than thrown.\n * - A disabled element (`isEnabled: false`) disables the picker, the upload button and the drop zone.\n *\n * Without a host handler the control posts the files itself with `fetch`, sending cookies to the page's own\n * origin only.\n */\nexport function PrimeFileUpload({ element, interactions }: RegisteredComponentProps) {\n    const { handler, allowedOrigins } = useContext(FileUploadContext);\n    const origin = useSyncExternalStore(subscribeToNothing, pageOrigin, noPageOrigin);\n    const modeResolution = resolveEnumeration('mode', element.properties.mode, FileUploadMode, FileUploadMode.Advanced);\n    const mode = modeResolution.isValid ? modeResolution.value : FileUploadMode.Advanced;\n    const authoredUrl = stringProperty(element, 'url');\n    const target = useMemo(() => resolveUploadTarget(authoredUrl, origin, allowedOrigins), [authoredUrl, origin, allowedOrigins]);\n    const serverUrl = target.isValid ? target.url : undefined;\n    const multiple = booleanProperty(element, 'multiple', false);\n    const enabled = element.isEnabled;\n    const canUpload = target.isValid && (handler !== undefined || serverUrl !== undefined);\n    const session = useUploadSession(handler, serverUrl, stringProperty(element, 'name', 'files'));\n\n    const uploaded = async (event: FileUploadHandlerEvent) => {\n        if (!enabled || !canUpload) return;\n        if (await session.upload(event.files)) event.options.clear();\n    };\n\n    const changed = (event: FileUploadChangeEvent) => {\n        // Clearing the selection after an upload reports an empty change; it is not a new selection, and must not\n        // wipe the result of the upload that caused it.\n        if (event.acceptedFiles.length === 0 && event.rejectedFiles.length === 0) return;\n        const rejection = event.rejectedFiles.flatMap(rejected => rejected.errors.map(error => error.message)).join(' ');\n        session.setStatus(rejection === '' ? undefined : { kind: 'error', text: rejection });\n        interactions?.onChange?.();\n    };\n\n    const refuseSeveralFromInput = (event: ChangeEvent<HTMLElement>) => {\n        const input = event.target as HTMLInputElement;\n        if (input.type !== 'file') return;\n        if (session.busy) {\n            event.stopPropagation();\n            input.value = '';\n            return;\n        }\n\n        if (multiple || (input.files?.length ?? 0) < 2) return;\n        event.stopPropagation();\n        input.value = '';\n        session.setStatus({ kind: 'error', text: 'Only one file can be uploaded at a time.' });\n    };\n\n    const refuseDrop = (event: DragEvent<HTMLElement>) => {\n        if (!enabled) {\n            event.preventDefault();\n            return;\n        }\n        if (session.busy) {\n            event.preventDefault();\n            event.stopPropagation();\n            return;\n        }\n\n        if (multiple || (event.dataTransfer?.files.length ?? 0) < 2) return;\n        event.preventDefault();\n        event.stopPropagation();\n        session.setStatus({ kind: 'error', text: 'Only one file can be uploaded at a time.' });\n    };\n\n    return (\n        <div\n            data-scene-id={element.id}\n            data-scene-component='fileUpload'\n            onClick={interactions?.onClick}\n            onDoubleClick={interactions?.onDoubleClick}\n            onChangeCapture={refuseSeveralFromInput}\n            onDropCapture={refuseDrop}\n            onDragOverCapture={event => { if (!enabled) event.preventDefault(); }}>\n            <FileUpload.Root\n                accept={stringProperty(element, 'accept')}\n                auto={(mode === FileUploadMode.Auto || mode === FileUploadMode.Basic) && canUpload}\n                customUpload\n                disabled={!enabled}\n                maxFileSize={numberProperty(element, 'maxFileSize')}\n                multiple={multiple}\n                name={stringProperty(element, 'name', 'files')}\n                uploadHandler={uploaded}\n                onChange={changed}>\n                <FileUpload.Content aria-label={stringProperty(element, 'ariaLabel', 'File upload drop zone')}>\n                    <p>{mode === FileUploadMode.Basic ? 'Choose a file to upload.' : 'Drop files here or choose files to upload.'}</p>\n                    <FileUpload.Trigger disabled={!enabled || session.busy}>{mode === FileUploadMode.Basic ? 'Choose file' : 'Choose files'}</FileUpload.Trigger>\n                    {mode === FileUploadMode.Advanced && (\n                        <FileUpload.Upload disabled={!enabled || !canUpload || session.busy}>Upload selected files</FileUpload.Upload>\n                    )}\n                    {!modeResolution.isValid && <p role='alert' data-scene-state='unsupported-mode'>{modeResolution.message}</p>}\n                    {!target.isValid && <p role='alert' data-scene-state='refused-address'>{target.message}</p>}\n                    {target.isValid && !canUpload && <p role='status'>Configure a server URL or provide an upload handler to upload files.</p>}\n                    {session.busy && <p role='status'>Uploading…</p>}\n                    {session.status !== undefined && <p role={session.status.kind === 'error' ? 'alert' : 'status'}>{session.status.text}</p>}\n                </FileUpload.Content>\n            </FileUpload.Root>\n        </div>\n    );\n}\n"],"names":["subscribeToNothing","undefined","pageOrigin","window","location","origin","noPageOrigin","PrimeFileUpload","element","interactions","handler","allowedOrigins","useContext","FileUploadContext","useSyncExternalStore","modeResolution","resolveEnumeration","properties","mode","FileUploadMode","Advanced","isValid","value","authoredUrl","stringProperty","target","useMemo","resolveUploadTarget","serverUrl","url","multiple","booleanProperty","enabled","isEnabled","canUpload","session","useUploadSession","uploaded","event","upload","files","options","clear","changed","acceptedFiles","length","rejectedFiles","rejection","flatMap","rejected","errors","map","error","message","join","setStatus","kind","text","onChange","refuseSeveralFromInput","input","type","busy","stopPropagation","refuseDrop","preventDefault","dataTransfer","_jsx","div","data-scene-id","id","data-scene-component","onClick","onDoubleClick","onChangeCapture","onDropCapture","onDragOverCapture","FileUpload","Root","accept","auto","Auto","Basic","customUpload","disabled","maxFileSize","numberProperty","name","uploadHandler","_jsxs","Content","aria-label","p","Trigger","Upload","role","data-scene-state","status"],"mappings":";;;;;;;;;;AAaA,MAAMA,kBAAAA,GAAqB,IAAM,IAAMC,SAAAA;AACvC,MAAMC,UAAAA,GAAa,IAAMC,MAAAA,CAAOC,QAAQ,CAACC,MAAM;AAC/C,MAAMC,eAAe,IAAML,SAAAA;AAE3B;;;;;;;;;;;;;;;;;AAiBC,IACM,SAASM,eAAAA,CAAgB,EAAEC,OAAO,EAAEC,YAAY,EAA4B,EAAA;AAC/E,IAAA,MAAM,EAAEC,OAAO,EAAEC,cAAc,EAAE,GAAGC,UAAAA,CAAWC,iBAAAA,CAAAA;IAC/C,MAAMR,MAAAA,GAASS,oBAAAA,CAAqBd,kBAAAA,EAAoBE,UAAAA,EAAYI,YAAAA,CAAAA;IACpE,MAAMS,cAAAA,GAAiBC,kBAAAA,CAAmB,MAAA,EAAQR,OAAAA,CAAQS,UAAU,CAACC,IAAI,EAAEC,cAAAA,EAAgBA,cAAAA,CAAeC,QAAQ,CAAA;IAClH,MAAMF,IAAAA,GAAOH,eAAeM,OAAO,GAAGN,eAAeO,KAAK,GAAGH,eAAeC,QAAQ;IACpF,MAAMG,WAAAA,GAAcC,eAAehB,OAAAA,EAAS,KAAA,CAAA;AAC5C,IAAA,MAAMiB,SAASC,OAAAA,CAAQ,IAAMC,mBAAAA,CAAoBJ,WAAAA,EAAalB,QAAQM,cAAAA,CAAAA,EAAiB;AAACY,QAAAA,WAAAA;AAAalB,QAAAA,MAAAA;AAAQM,QAAAA;AAAe,KAAA,CAAA;AAC5H,IAAA,MAAMiB,YAAYH,MAAAA,CAAOJ,OAAO,GAAGI,MAAAA,CAAOI,GAAG,GAAG5B,SAAAA;IAChD,MAAM6B,QAAAA,GAAWC,eAAAA,CAAgBvB,OAAAA,EAAS,UAAA,EAAY,KAAA,CAAA;IACtD,MAAMwB,OAAAA,GAAUxB,QAAQyB,SAAS;IACjC,MAAMC,SAAAA,GAAYT,OAAOJ,OAAO,KAAKX,OAAAA,KAAYT,SAAAA,IAAa2B,cAAc3B,SAAQ,CAAA;AACpF,IAAA,MAAMkC,UAAUC,gBAAAA,CAAiB1B,OAAAA,EAASkB,SAAAA,EAAWJ,cAAAA,CAAehB,SAAS,MAAA,EAAQ,OAAA,CAAA,CAAA;AAErF,IAAA,MAAM6B,WAAW,OAAOC,KAAAA,GAAAA;QACpB,IAAI,CAACN,OAAAA,IAAW,CAACE,SAAAA,EAAW;QAC5B,IAAI,MAAMC,OAAAA,CAAQI,MAAM,CAACD,KAAAA,CAAME,KAAK,CAAA,EAAGF,KAAAA,CAAMG,OAAO,CAACC,KAAK,EAAA;AAC9D,IAAA,CAAA;AAEA,IAAA,MAAMC,UAAU,CAACL,KAAAA,GAAAA;;;QAGb,IAAIA,KAAAA,CAAMM,aAAa,CAACC,MAAM,KAAK,CAAA,IAAKP,KAAAA,CAAMQ,aAAa,CAACD,MAAM,KAAK,CAAA,EAAG;AAC1E,QAAA,MAAME,YAAYT,KAAAA,CAAMQ,aAAa,CAACE,OAAO,CAACC,CAAAA,QAAAA,GAAYA,QAAAA,CAASC,MAAM,CAACC,GAAG,CAACC,CAAAA,KAAAA,GAASA,MAAMC,OAAO,CAAA,CAAA,CAAGC,IAAI,CAAC,GAAA,CAAA;AAC5GnB,QAAAA,OAAAA,CAAQoB,SAAS,CAACR,SAAAA,KAAc,EAAA,GAAK9C,SAAAA,GAAY;YAAEuD,IAAAA,EAAM,OAAA;YAASC,IAAAA,EAAMV;AAAU,SAAA,CAAA;QAClFtC,YAAAA,EAAciD,QAAAA,IAAAA;AAClB,IAAA,CAAA;AAEA,IAAA,MAAMC,yBAAyB,CAACrB,KAAAA,GAAAA;QAC5B,MAAMsB,KAAAA,GAAQtB,MAAMb,MAAM;QAC1B,IAAImC,KAAAA,CAAMC,IAAI,KAAK,MAAA,EAAQ;QAC3B,IAAI1B,OAAAA,CAAQ2B,IAAI,EAAE;AACdxB,YAAAA,KAAAA,CAAMyB,eAAe,EAAA;AACrBH,YAAAA,KAAAA,CAAMtC,KAAK,GAAG,EAAA;AACd,YAAA;AACJ,QAAA;QAEA,IAAIQ,QAAAA,IAAY,CAAC8B,KAAAA,CAAMpB,KAAK,EAAEK,MAAAA,IAAU,CAAA,IAAK,CAAA,EAAG;AAChDP,QAAAA,KAAAA,CAAMyB,eAAe,EAAA;AACrBH,QAAAA,KAAAA,CAAMtC,KAAK,GAAG,EAAA;AACda,QAAAA,OAAAA,CAAQoB,SAAS,CAAC;YAAEC,IAAAA,EAAM,OAAA;YAASC,IAAAA,EAAM;AAA2C,SAAA,CAAA;AACxF,IAAA,CAAA;AAEA,IAAA,MAAMO,aAAa,CAAC1B,KAAAA,GAAAA;AAChB,QAAA,IAAI,CAACN,OAAAA,EAAS;AACVM,YAAAA,KAAAA,CAAM2B,cAAc,EAAA;AACpB,YAAA;AACJ,QAAA;QACA,IAAI9B,OAAAA,CAAQ2B,IAAI,EAAE;AACdxB,YAAAA,KAAAA,CAAM2B,cAAc,EAAA;AACpB3B,YAAAA,KAAAA,CAAMyB,eAAe,EAAA;AACrB,YAAA;AACJ,QAAA;QAEA,IAAIjC,QAAAA,IAAY,CAACQ,KAAAA,CAAM4B,YAAY,EAAE1B,KAAAA,CAAMK,MAAAA,IAAU,CAAA,IAAK,CAAA,EAAG;AAC7DP,QAAAA,KAAAA,CAAM2B,cAAc,EAAA;AACpB3B,QAAAA,KAAAA,CAAMyB,eAAe,EAAA;AACrB5B,QAAAA,OAAAA,CAAQoB,SAAS,CAAC;YAAEC,IAAAA,EAAM,OAAA;YAASC,IAAAA,EAAM;AAA2C,SAAA,CAAA;AACxF,IAAA,CAAA;AAEA,IAAA,qBACIU,GAAA,CAACC,KAAAA,EAAAA;AACGC,QAAAA,eAAAA,EAAe7D,QAAQ8D,EAAE;QACzBC,sBAAAA,EAAqB,YAAA;AACrBC,QAAAA,OAAAA,EAAS/D,YAAAA,EAAc+D,OAAAA;AACvBC,QAAAA,aAAAA,EAAehE,YAAAA,EAAcgE,aAAAA;QAC7BC,eAAAA,EAAiBf,sBAAAA;QACjBgB,aAAAA,EAAeX,UAAAA;AACfY,QAAAA,iBAAAA,EAAmBtC,CAAAA,KAAAA,GAAAA;YAAW,IAAI,CAACN,OAAAA,EAASM,KAAAA,CAAM2B,cAAc,EAAA;AAAI,QAAA,CAAA;gCACpEE,GAAA,CAACU,WAAWC,IAAI,EAAA;AACZC,YAAAA,MAAAA,EAAQvD,eAAehB,OAAAA,EAAS,QAAA,CAAA;YAChCwE,IAAAA,EAAO9D,CAAAA,IAAAA,KAASC,cAAAA,CAAe8D,IAAI,IAAI/D,IAAAA,KAASC,cAAAA,CAAe+D,KAAI,KAAMhD,SAAAA;YACzEiD,YAAY,EAAA,IAAA;AACZC,YAAAA,QAAAA,EAAU,CAACpD,OAAAA;AACXqD,YAAAA,WAAAA,EAAaC,eAAe9E,OAAAA,EAAS,aAAA,CAAA;YACrCsB,QAAAA,EAAUA,QAAAA;YACVyD,IAAAA,EAAM/D,cAAAA,CAAehB,SAAS,MAAA,EAAQ,OAAA,CAAA;YACtCgF,aAAAA,EAAenD,QAAAA;YACfqB,QAAAA,EAAUf,OAAAA;oCACV8C,IAAA,CAACZ,WAAWa,OAAO,EAAA;gBAACC,YAAAA,EAAYnE,cAAAA,CAAehB,SAAS,WAAA,EAAa,uBAAA,CAAA;;kCACjE2D,GAAA,CAACyB,GAAAA,EAAAA;kCAAG1E,IAAAA,KAASC,cAAAA,CAAe+D,KAAK,GAAG,0BAAA,GAA6B;;AACjE,kCAAAf,GAAA,CAACU,WAAWgB,OAAO,EAAA;wBAACT,QAAAA,EAAU,CAACpD,OAAAA,IAAWG,OAAAA,CAAQ2B,IAAI;kCAAG5C,IAAAA,KAASC,cAAAA,CAAe+D,KAAK,GAAG,aAAA,GAAgB;;AACxGhE,oBAAAA,IAAAA,KAASC,cAAAA,CAAeC,QAAQ,kBAC7B+C,GAAA,CAACU,WAAWiB,MAAM,EAAA;AAACV,wBAAAA,QAAAA,EAAU,CAACpD,OAAAA,IAAW,CAACE,SAAAA,IAAaC,QAAQ2B,IAAI;AAAE,wBAAA,QAAA,EAAA;;oBAExE,CAAC/C,cAAAA,CAAeM,OAAO,kBAAI8C,GAAA,CAACyB,GAAAA,EAAAA;wBAAEG,IAAAA,EAAK,OAAA;wBAAQC,kBAAAA,EAAiB,kBAAA;AAAoBjF,wBAAAA,QAAAA,EAAAA,cAAAA,CAAesC;;oBAC/F,CAAC5B,MAAAA,CAAOJ,OAAO,kBAAI8C,GAAA,CAACyB,GAAAA,EAAAA;wBAAEG,IAAAA,EAAK,OAAA;wBAAQC,kBAAAA,EAAiB,iBAAA;AAAmBvE,wBAAAA,QAAAA,EAAAA,MAAAA,CAAO4B;;AAC9E5B,oBAAAA,MAAAA,CAAOJ,OAAO,IAAI,CAACa,SAAAA,kBAAaiC,GAAA,CAACyB,GAAAA,EAAAA;wBAAEG,IAAAA,EAAK,QAAA;AAAS,wBAAA,QAAA,EAAA;;oBACjD5D,OAAAA,CAAQ2B,IAAI,kBAAIK,GAAA,CAACyB,GAAAA,EAAAA;wBAAEG,IAAAA,EAAK,QAAA;AAAS,wBAAA,QAAA,EAAA;;oBACjC5D,OAAAA,CAAQ8D,MAAM,KAAKhG,SAAAA,kBAAakE,GAAA,CAACyB,GAAAA,EAAAA;AAAEG,wBAAAA,IAAAA,EAAM5D,QAAQ8D,MAAM,CAACzC,IAAI,KAAK,UAAU,OAAA,GAAU,QAAA;kCAAWrB,OAAAA,CAAQ8D,MAAM,CAACxC;;;;;;AAKpI;;"}

package/dist/esm/file/UploadStatus.d.ts

@@ -0,0 +1,5 @@
+export interface UploadStatus {
+    kind: 'success' | 'error';
+    text: string;
+}
+//# sourceMappingURL=UploadStatus.d.ts.map

package/dist/esm/file/UploadStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadStatus.d.ts","sourceRoot":"","sources":["../../../file/UploadStatus.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAEzB,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/file/UploadStatus.js

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

package/dist/esm/file/UploadStatus.js.map

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

package/dist/esm/file/UploadTarget.d.ts

@@ -0,0 +1,8 @@
+export type UploadTarget = {
+    isValid: true;
+    url: string | undefined;
+} | {
+    isValid: false;
+    message: string;
+};
+//# sourceMappingURL=UploadTarget.d.ts.map

package/dist/esm/file/UploadTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadTarget.d.ts","sourceRoot":"","sources":["../../../file/UploadTarget.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAClB;IACE,OAAO,EAAE,IAAI,CAAC;IAGd,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,GACC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/esm/file/UploadTarget.js

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

package/dist/esm/file/UploadTarget.js.map

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

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

@@ -0,0 +1,7 @@
+export * from './FileUploadHandler';
+export * from './FileUploadHandlerProvider';
+export * from './FileUploadMode';
+export * from './PrimeFileUpload';
+export * from './resolveUploadTarget';
+export * from './UploadTarget';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../file/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}

package/dist/esm/file/index.js

@@ -0,0 +1,7 @@
+export * from './FileUploadHandler';
+export * from './FileUploadHandlerProvider';
+export * from './FileUploadMode';
+export * from './PrimeFileUpload';
+export * from './resolveUploadTarget';
+export * from './UploadTarget';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../file/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC"}

package/dist/esm/file/postFiles.d.ts

@@ -0,0 +1,2 @@
+export declare function postFiles(url: string, field: string, files: File[], signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=postFiles.d.ts.map

package/dist/esm/file/postFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postFiles.d.ts","sourceRoot":"","sources":["../../../file/postFiles.ts"],"names":[],"mappings":"AAgBA,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7G"}

package/dist/esm/file/postFiles.js

@@ -0,0 +1,29 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Sends files to an address as a `multipart/form-data` POST.
+ *
+ * Cookies are sent only to the page's own origin (`credentials: 'same-origin'`), so an upload to another
+ * origin the host allowed carries no credentials. A redirect fails the upload rather than being followed,
+ * because following one would send the files to an address the origin policy never checked.
+ *
+ * @param url The address, already checked by `resolveUploadTarget`.
+ * @param field The multipart field name each file is appended under.
+ * @param files The files to send.
+ * @param signal Cancels the request.
+ * @throws When the request fails or the server does not answer with a success status.
+ */ async function postFiles(url, field, files, signal) {
+    const body = new FormData();
+    for (const file of files)body.append(field, file, file.name);
+    const response = await fetch(url, {
+        method: 'POST',
+        body,
+        credentials: 'same-origin',
+        redirect: 'error',
+        signal
+    });
+    if (!response.ok) throw new Error(`The server answered ${response.status}${response.statusText === '' ? '' : ` ${response.statusText}`}.`);
+}
+
+export { postFiles };
+//# sourceMappingURL=postFiles.js.map

package/dist/esm/file/postFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postFiles.js","sources":["../../../file/postFiles.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\n/**\n * Sends files to an address as a `multipart/form-data` POST.\n *\n * Cookies are sent only to the page's own origin (`credentials: 'same-origin'`), so an upload to another\n * origin the host allowed carries no credentials. A redirect fails the upload rather than being followed,\n * because following one would send the files to an address the origin policy never checked.\n *\n * @param url The address, already checked by `resolveUploadTarget`.\n * @param field The multipart field name each file is appended under.\n * @param files The files to send.\n * @param signal Cancels the request.\n * @throws When the request fails or the server does not answer with a success status.\n */\nexport async function postFiles(url: string, field: string, files: File[], signal: AbortSignal): Promise<void> {\n    const body = new FormData();\n    for (const file of files) body.append(field, file, file.name);\n\n    const response = await fetch(url, { method: 'POST', body, credentials: 'same-origin', redirect: 'error', signal });\n    if (!response.ok) throw new Error(`The server answered ${response.status}${response.statusText === '' ? '' : ` ${response.statusText}`}.`);\n}\n"],"names":["postFiles","url","field","files","signal","body","FormData","file","append","name","response","fetch","method","credentials","redirect","ok","Error","status","statusText"],"mappings":"AAAA;AACA;AAEA;;;;;;;;;;;;IAaO,eAAeA,SAAAA,CAAUC,GAAW,EAAEC,KAAa,EAAEC,KAAa,EAAEC,MAAmB,EAAA;AAC1F,IAAA,MAAMC,OAAO,IAAIC,QAAAA,EAAAA;IACjB,KAAK,MAAMC,QAAQJ,KAAAA,CAAOE,IAAAA,CAAKG,MAAM,CAACN,KAAAA,EAAOK,IAAAA,EAAMA,IAAAA,CAAKE,IAAI,CAAA;IAE5D,MAAMC,QAAAA,GAAW,MAAMC,KAAAA,CAAMV,GAAAA,EAAK;QAAEW,MAAAA,EAAQ,MAAA;AAAQP,QAAAA,IAAAA;QAAMQ,WAAAA,EAAa,aAAA;QAAeC,QAAAA,EAAU,OAAA;AAASV,QAAAA;AAAO,KAAA,CAAA;IAChH,IAAI,CAACM,QAAAA,CAASK,EAAE,EAAE,MAAM,IAAIC,KAAAA,CAAM,CAAC,oBAAoB,EAAEN,QAAAA,CAASO,MAAM,CAAA,EAAGP,SAASQ,UAAU,KAAK,EAAA,GAAK,EAAA,GAAK,CAAC,CAAC,EAAER,QAAAA,CAASQ,UAAU,CAAA,CAAE,CAAC,CAAC,CAAC,CAAA;AAC7I;;"}

package/dist/esm/file/resolveUploadTarget.d.ts

@@ -0,0 +1,3 @@
+import { UploadTarget } from './UploadTarget';
+export declare function resolveUploadTarget(url: string | undefined, pageOrigin: string | undefined, allowedOrigins: readonly string[]): UploadTarget;
+//# sourceMappingURL=resolveUploadTarget.d.ts.map

package/dist/esm/file/resolveUploadTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveUploadTarget.d.ts","sourceRoot":"","sources":["../../../file/resolveUploadTarget.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AA0B9C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAmB5I"}

package/dist/esm/file/resolveUploadTarget.js

@@ -0,0 +1,66 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** A scheme (`https:`) or a protocol-relative prefix (`//host`): the address names its own host. */ const namesItsOwnHost = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
+/** Whitespace, control characters and backslashes, which browsers normalize in ways that disguise another host. */ const disguisesAHost = (address)=>Array.from(address).some((character)=>character <= ' ' || character === '\u007f' || character === '\\');
+/** Resolved against, to read an address's own parts without depending on a page. It is never sent to. */ const placeholderOrigin = 'https://upload-target.invalid';
+/**
+ * Checks the address an authored upload sends files to.
+ *
+ * The address comes from authored model data, so it is not trusted. By default an upload may only go to the
+ * origin the page was served from - a relative address, or an absolute one with the same origin. A host that
+ * needs another origin names it in `allowedOrigins` when it provides the upload handler. Whatever is accepted
+ * has the scheme `http:` or `https:`, carries no user information, and contains no whitespace, control
+ * characters or backslashes, because those are how an address is made to point somewhere other than where it
+ * reads.
+ *
+ * @param url The authored address, if any.
+ * @param pageOrigin The origin of the page, `undefined` where there is no page (server rendering).
+ * @param allowedOrigins The additional origins the host permits.
+ * @returns The address to send to, or why it cannot be used.
+ */ function resolveUploadTarget(url, pageOrigin, allowedOrigins) {
+    if (url === undefined || url === '') return {
+        isValid: true,
+        url: undefined
+    };
+    if (disguisesAHost(url)) return refused('it contains whitespace, control characters or a backslash');
+    let resolved;
+    try {
+        resolved = new URL(url, placeholderOrigin);
+    } catch  {
+        return refused('it is not a valid address');
+    }
+    if (resolved.protocol !== 'http:' && resolved.protocol !== 'https:') return refused(`the ${resolved.protocol} scheme is not allowed`);
+    if (resolved.username !== '' || resolved.password !== '') return refused('it carries user information');
+    if (!namesItsOwnHost.test(url)) return {
+        isValid: true,
+        url
+    };
+    const permitted = [
+        ...pageOrigin === undefined ? [] : [
+            pageOrigin
+        ],
+        ...allowedOrigins.flatMap(originOf)
+    ];
+    return permitted.includes(resolved.origin) ? {
+        isValid: true,
+        url: resolved.href
+    } : refused(`${resolved.origin} is not the origin of this page or one the host allows`);
+}
+function originOf(address) {
+    try {
+        return [
+            new URL(address).origin
+        ];
+    } catch  {
+        return [];
+    }
+}
+function refused(reason) {
+    return {
+        isValid: false,
+        message: `The upload address is not allowed: ${reason}.`
+    };
+}
+
+export { resolveUploadTarget };
+//# sourceMappingURL=resolveUploadTarget.js.map

package/dist/esm/file/resolveUploadTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveUploadTarget.js","sources":["../../../file/resolveUploadTarget.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 { UploadTarget } from './UploadTarget';\n\n/** A scheme (`https:`) or a protocol-relative prefix (`//host`): the address names its own host. */\nconst namesItsOwnHost = /^([a-z][a-z0-9+.-]*:|\\/\\/)/i;\n\n/** Whitespace, control characters and backslashes, which browsers normalize in ways that disguise another host. */\nconst disguisesAHost = (address: string) => Array.from(address).some(character => character <= ' ' || character === '\\u007f' || character === '\\\\');\n\n/** Resolved against, to read an address's own parts without depending on a page. It is never sent to. */\nconst placeholderOrigin = 'https://upload-target.invalid';\n\n/**\n * Checks the address an authored upload sends files to.\n *\n * The address comes from authored model data, so it is not trusted. By default an upload may only go to the\n * origin the page was served from - a relative address, or an absolute one with the same origin. A host that\n * needs another origin names it in `allowedOrigins` when it provides the upload handler. Whatever is accepted\n * has the scheme `http:` or `https:`, carries no user information, and contains no whitespace, control\n * characters or backslashes, because those are how an address is made to point somewhere other than where it\n * reads.\n *\n * @param url The authored address, if any.\n * @param pageOrigin The origin of the page, `undefined` where there is no page (server rendering).\n * @param allowedOrigins The additional origins the host permits.\n * @returns The address to send to, or why it cannot be used.\n */\nexport function resolveUploadTarget(url: string | undefined, pageOrigin: string | undefined, allowedOrigins: readonly string[]): UploadTarget {\n    if (url === undefined || url === '') return { isValid: true, url: undefined };\n    if (disguisesAHost(url)) return refused('it contains whitespace, control characters or a backslash');\n\n    let resolved: URL;\n    try {\n        resolved = new URL(url, placeholderOrigin);\n    } catch {\n        return refused('it is not a valid address');\n    }\n\n    if (resolved.protocol !== 'http:' && resolved.protocol !== 'https:') return refused(`the ${resolved.protocol} scheme is not allowed`);\n    if (resolved.username !== '' || resolved.password !== '') return refused('it carries user information');\n    if (!namesItsOwnHost.test(url)) return { isValid: true, url };\n\n    const permitted = [...(pageOrigin === undefined ? [] : [pageOrigin]), ...allowedOrigins.flatMap(originOf)];\n    return permitted.includes(resolved.origin)\n        ? { isValid: true, url: resolved.href }\n        : refused(`${resolved.origin} is not the origin of this page or one the host allows`);\n}\n\nfunction originOf(address: string): string[] {\n    try {\n        return [new URL(address).origin];\n    } catch {\n        return [];\n    }\n}\n\nfunction refused(reason: string): UploadTarget {\n    return { isValid: false, message: `The upload address is not allowed: ${reason}.` };\n}\n"],"names":["namesItsOwnHost","disguisesAHost","address","Array","from","some","character","placeholderOrigin","resolveUploadTarget","url","pageOrigin","allowedOrigins","undefined","isValid","refused","resolved","URL","protocol","username","password","test","permitted","flatMap","originOf","includes","origin","href","reason","message"],"mappings":"AAAA;AACA;AAIA,qGACA,MAAMA,eAAAA,GAAkB,6BAAA;AAExB,oHACA,MAAMC,cAAAA,GAAiB,CAACC,OAAAA,GAAoBC,MAAMC,IAAI,CAACF,OAAAA,CAAAA,CAASG,IAAI,CAACC,CAAAA,SAAAA,GAAaA,aAAa,GAAA,IAAOA,SAAAA,KAAc,YAAYA,SAAAA,KAAc,IAAA,CAAA;AAE9I,0GACA,MAAMC,iBAAAA,GAAoB,+BAAA;AAE1B;;;;;;;;;;;;;;AAcC,IACM,SAASC,mBAAAA,CAAoBC,GAAuB,EAAEC,UAA8B,EAAEC,cAAiC,EAAA;AAC1H,IAAA,IAAIF,GAAAA,KAAQG,SAAAA,IAAaH,GAAAA,KAAQ,EAAA,EAAI,OAAO;QAAEI,OAAAA,EAAS,IAAA;QAAMJ,GAAAA,EAAKG;AAAU,KAAA;IAC5E,IAAIX,cAAAA,CAAeQ,GAAAA,CAAAA,EAAM,OAAOK,OAAAA,CAAQ,2DAAA,CAAA;IAExC,IAAIC,QAAAA;IACJ,IAAI;QACAA,QAAAA,GAAW,IAAIC,IAAIP,GAAAA,EAAKF,iBAAAA,CAAAA;AAC5B,IAAA,CAAA,CAAE,OAAM;AACJ,QAAA,OAAOO,OAAAA,CAAQ,2BAAA,CAAA;AACnB,IAAA;AAEA,IAAA,IAAIC,SAASE,QAAQ,KAAK,OAAA,IAAWF,QAAAA,CAASE,QAAQ,KAAK,QAAA,EAAU,OAAOH,OAAAA,CAAQ,CAAC,IAAI,EAAEC,SAASE,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpI,IAAIF,QAAAA,CAASG,QAAQ,KAAK,EAAA,IAAMH,SAASI,QAAQ,KAAK,EAAA,EAAI,OAAOL,OAAAA,CAAQ,6BAAA,CAAA;AACzE,IAAA,IAAI,CAACd,eAAAA,CAAgBoB,IAAI,CAACX,MAAM,OAAO;QAAEI,OAAAA,EAAS,IAAA;AAAMJ,QAAAA;AAAI,KAAA;AAE5D,IAAA,MAAMY,SAAAA,GAAY;WAAKX,UAAAA,KAAeE,SAAAA,GAAY,EAAE,GAAG;AAACF,YAAAA;AAAW,SAAA;AAAMC,QAAAA,GAAAA,cAAAA,CAAeW,OAAO,CAACC,QAAAA;AAAU,KAAA;AAC1G,IAAA,OAAOF,SAAAA,CAAUG,QAAQ,CAACT,QAAAA,CAASU,MAAM,CAAA,GACnC;QAAEZ,OAAAA,EAAS,IAAA;AAAMJ,QAAAA,GAAAA,EAAKM,SAASW;AAAK,KAAA,GACpCZ,QAAQ,CAAA,EAAGC,QAAAA,CAASU,MAAM,CAAC,sDAAsD,CAAC,CAAA;AAC5F;AAEA,SAASF,SAASrB,OAAe,EAAA;IAC7B,IAAI;QACA,OAAO;YAAC,IAAIc,GAAAA,CAAId,SAASuB;AAAO,SAAA;AACpC,IAAA,CAAA,CAAE,OAAM;AACJ,QAAA,OAAO,EAAE;AACb,IAAA;AACJ;AAEA,SAASX,QAAQa,MAAc,EAAA;IAC3B,OAAO;QAAEd,OAAAA,EAAS,KAAA;AAAOe,QAAAA,OAAAA,EAAS,CAAC,mCAAmC,EAAED,MAAAA,CAAO,CAAC;AAAE,KAAA;AACtF;;"}

package/dist/esm/file/useUploadSession.d.ts

@@ -0,0 +1,10 @@
+import { FileUploadHandler } from './FileUploadHandler';
+import { UploadStatus } from './UploadStatus';
+export interface UploadSession {
+    busy: boolean;
+    status: UploadStatus | undefined;
+    setStatus(status: UploadStatus | undefined): void;
+    upload(files: File[]): Promise<boolean>;
+}
+export declare function useUploadSession(handler: FileUploadHandler | undefined, url: string | undefined, field: string): UploadSession;
+//# sourceMappingURL=useUploadSession.d.ts.map

package/dist/esm/file/useUploadSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploadSession.d.ts","sourceRoot":"","sources":["../../../file/useUploadSession.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,MAAM,WAAW,aAAa;IAE1B,IAAI,EAAE,OAAO,CAAC;IAGd,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;IAQlD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3C;AAaD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CA6B9H"}

package/dist/esm/file/useUploadSession.js

@@ -0,0 +1,60 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+import { postFiles } from './postFiles.js';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Runs one upload at a time for a control, through the host's handler or a POST to the checked address.
+ *
+ * Starting an upload while one runs is ignored rather than queued, so a double click cannot send the same
+ * files twice. Every failure ends in a visible `status`; none escapes as an unhandled rejection. An upload
+ * still running when the control unmounts is cancelled.
+ *
+ * @param handler The host's upload effect, if it owns the effect.
+ * @param url The checked address, if one was authored.
+ * @param field The multipart field name used when the control posts the files itself.
+ */ function useUploadSession(handler, url, field) {
+    const running = useRef(undefined);
+    const [busy, setBusy] = useState(false);
+    const [status, setStatus] = useState(undefined);
+    useEffect(()=>()=>running.current?.abort(), []);
+    const upload = useCallback(async (files)=>{
+        if (running.current !== undefined) return false;
+        const controller = new AbortController();
+        running.current = controller;
+        setBusy(true);
+        setStatus(undefined);
+        try {
+            if (handler !== undefined) await handler(files, url);
+            else if (url !== undefined) await postFiles(url, field, files, controller.signal);
+            else throw new Error('There is nowhere to send the files.');
+            setStatus({
+                kind: 'success',
+                text: `${files.length} file${files.length === 1 ? '' : 's'} uploaded.`
+            });
+            return true;
+        } catch (error) {
+            if (!controller.signal.aborted) setStatus({
+                kind: 'error',
+                text: `Upload failed: ${error instanceof Error ? error.message : String(error)}`
+            });
+            return false;
+        } finally{
+            running.current = undefined;
+            setBusy(false);
+        }
+    }, [
+        handler,
+        url,
+        field
+    ]);
+    return {
+        busy,
+        status,
+        setStatus,
+        upload
+    };
+}
+
+export { useUploadSession };
+//# sourceMappingURL=useUploadSession.js.map

package/dist/esm/file/useUploadSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUploadSession.js","sources":["../../../file/useUploadSession.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 { useCallback, useEffect, useRef, useState } from 'react';\nimport { FileUploadHandler } from './FileUploadHandler';\nimport { UploadStatus } from './UploadStatus';\nimport { postFiles } from './postFiles';\n\n/** The state of the upload in flight, if any, and the action that starts one. */\nexport interface UploadSession {\n    /** Whether an upload is running. */\n    busy: boolean;\n\n    /** The last result, or `undefined` before the first upload and after a new selection. */\n    status: UploadStatus | undefined;\n    setStatus(status: UploadStatus | undefined): void;\n\n    /**\n     * Sends the files, unless an upload is already running.\n     *\n     * @returns Whether the files were sent, so the caller knows to clear its selection. A failure is reported\n     * through `status` and returns `false`: the selection stays so it can be retried.\n     */\n    upload(files: File[]): Promise<boolean>;\n}\n\n/**\n * Runs one upload at a time for a control, through the host's handler or a POST to the checked address.\n *\n * Starting an upload while one runs is ignored rather than queued, so a double click cannot send the same\n * files twice. Every failure ends in a visible `status`; none escapes as an unhandled rejection. An upload\n * still running when the control unmounts is cancelled.\n *\n * @param handler The host's upload effect, if it owns the effect.\n * @param url The checked address, if one was authored.\n * @param field The multipart field name used when the control posts the files itself.\n */\nexport function useUploadSession(handler: FileUploadHandler | undefined, url: string | undefined, field: string): UploadSession {\n    const running = useRef<AbortController | undefined>(undefined);\n    const [busy, setBusy] = useState(false);\n    const [status, setStatus] = useState<UploadStatus | undefined>(undefined);\n\n    useEffect(() => () => running.current?.abort(), []);\n\n    const upload = useCallback(async (files: File[]): Promise<boolean> => {\n        if (running.current !== undefined) return false;\n        const controller = new AbortController();\n        running.current = controller;\n        setBusy(true);\n        setStatus(undefined);\n        try {\n            if (handler !== undefined) await handler(files, url);\n            else if (url !== undefined) await postFiles(url, field, files, controller.signal);\n            else throw new Error('There is nowhere to send the files.');\n            setStatus({ kind: 'success', text: `${files.length} file${files.length === 1 ? '' : 's'} uploaded.` });\n            return true;\n        } catch (error) {\n            if (!controller.signal.aborted) setStatus({ kind: 'error', text: `Upload failed: ${error instanceof Error ? error.message : String(error)}` });\n            return false;\n        } finally {\n            running.current = undefined;\n            setBusy(false);\n        }\n    }, [handler, url, field]);\n\n    return { busy, status, setStatus, upload };\n}\n"],"names":["useUploadSession","handler","url","field","running","useRef","undefined","busy","setBusy","useState","status","setStatus","useEffect","current","abort","upload","useCallback","files","controller","AbortController","postFiles","signal","Error","kind","text","length","error","aborted","message","String"],"mappings":";;;AAAA;AACA;AAyBA;;;;;;;;;;AAUC,IACM,SAASA,gBAAAA,CAAiBC,OAAsC,EAAEC,GAAuB,EAAEC,KAAa,EAAA;AAC3G,IAAA,MAAMC,UAAUC,MAAAA,CAAoCC,SAAAA,CAAAA;AACpD,IAAA,MAAM,CAACC,IAAAA,EAAMC,OAAAA,CAAQ,GAAGC,QAAAA,CAAS,KAAA,CAAA;AACjC,IAAA,MAAM,CAACC,MAAAA,EAAQC,SAAAA,CAAU,GAAGF,QAAAA,CAAmCH,SAAAA,CAAAA;AAE/DM,IAAAA,SAAAA,CAAU,IAAM,IAAMR,OAAAA,CAAQS,OAAO,EAAEC,SAAS,EAAE,CAAA;IAElD,MAAMC,MAAAA,GAASC,YAAY,OAAOC,KAAAA,GAAAA;AAC9B,QAAA,IAAIb,OAAAA,CAAQS,OAAO,KAAKP,SAAAA,EAAW,OAAO,KAAA;AAC1C,QAAA,MAAMY,aAAa,IAAIC,eAAAA,EAAAA;AACvBf,QAAAA,OAAAA,CAAQS,OAAO,GAAGK,UAAAA;QAClBV,OAAAA,CAAQ,IAAA,CAAA;QACRG,SAAAA,CAAUL,SAAAA,CAAAA;QACV,IAAI;AACA,YAAA,IAAIL,OAAAA,KAAYK,SAAAA,EAAW,MAAML,OAAAA,CAAQgB,KAAAA,EAAOf,GAAAA,CAAAA;iBAC3C,IAAIA,GAAAA,KAAQI,WAAW,MAAMc,SAAAA,CAAUlB,KAAKC,KAAAA,EAAOc,KAAAA,EAAOC,WAAWG,MAAM,CAAA;AAC3E,iBAAA,MAAM,IAAIC,KAAAA,CAAM,qCAAA,CAAA;YACrBX,SAAAA,CAAU;gBAAEY,IAAAA,EAAM,SAAA;AAAWC,gBAAAA,IAAAA,EAAM,CAAA,EAAGP,KAAAA,CAAMQ,MAAM,CAAC,KAAK,EAAER,KAAAA,CAAMQ,MAAM,KAAK,CAAA,GAAI,EAAA,GAAK,GAAA,CAAI,UAAU;AAAE,aAAA,CAAA;YACpG,OAAO,IAAA;AACX,QAAA,CAAA,CAAE,OAAOC,KAAAA,EAAO;AACZ,YAAA,IAAI,CAACR,UAAAA,CAAWG,MAAM,CAACM,OAAO,EAAEhB,SAAAA,CAAU;gBAAEY,IAAAA,EAAM,OAAA;gBAASC,IAAAA,EAAM,CAAC,eAAe,EAAEE,KAAAA,YAAiBJ,QAAQI,KAAAA,CAAME,OAAO,GAAGC,MAAAA,CAAOH,KAAAA,CAAAA,CAAAA;AAAS,aAAA,CAAA;YAC5I,OAAO,KAAA;QACX,CAAA,QAAU;AACNtB,YAAAA,OAAAA,CAAQS,OAAO,GAAGP,SAAAA;YAClBE,OAAAA,CAAQ,KAAA,CAAA;AACZ,QAAA;IACJ,CAAA,EAAG;AAACP,QAAAA,OAAAA;AAASC,QAAAA,GAAAA;AAAKC,QAAAA;AAAM,KAAA,CAAA;IAExB,OAAO;AAAEI,QAAAA,IAAAA;AAAMG,QAAAA,MAAAA;AAAQC,QAAAA,SAAAA;AAAWI,QAAAA;AAAO,KAAA;AAC7C;;"}

package/dist/esm/form/FormGallery.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormGallery.stories.d.ts","sourceRoot":"","sources":["../../../form/FormGallery.stories.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,QAAA,MAAM,IAAI;;;;;QAKF,MAAM;QACN,IAAI;YAAI,WAAW;gBAAI,SAAS;;;;CAEC,CAAC;eAE3B,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAGnC,eAAO,MAAM,OAAO,EAAE,KA8BrB,CAAC"}
+{"version":3,"file":"FormGallery.stories.d.ts","sourceRoot":"","sources":["../../../form/FormGallery.stories.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,QAAA,MAAM,IAAI;;;;;QAKF,MAAM;QACN,IAAI;YAAI,WAAW;gBAAI,SAAS;;;;CAEC,CAAC;eAE3B,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AAGnC,eAAO,MAAM,OAAO,EAAE,KAuCrB,CAAC"}

package/dist/esm/form/FormGallery.stories.js

@@ -16,6 +16,7 @@ export const Gallery = {
         element: sceneGallery('gallery', [
             sceneComponent('inputText', 'inputText', { placeholder: 'Name' }),
             sceneComponent('inputTextarea', 'inputTextarea', { placeholder: 'Notes', rows: 3 }),
+            sceneComponent('editor', 'editor', { value: '<p>Write a <strong>rich</strong> note.</p>' }),
             sceneComponent('inputNumber', 'inputNumber', { value: 42, showButtons: true }),
             sceneComponent('password', 'password', { placeholder: 'Password' }),
             sceneComponent('floatLabel', 'floatLabel', { label: 'Project name' }),
@@ -25,6 +26,14 @@ export const Gallery = {
             sceneComponent('listBox', 'listBox', { options: ['Daily', 'Weekly', 'Monthly'] }),
             sceneComponent('selectButton', 'selectButton', { options: ['Day', 'Week', 'Month'], value: 'Week' }),
             sceneComponent('checkbox', 'checkbox', { label: 'Notify me', checked: true }),
+            sceneComponent('multiStateCheckbox', 'multiStateCheckbox', {
+                value: null,
+                options: [
+                    { label: 'Approved', value: 'approved', icon: 'pi pi-check' },
+                    { label: 'Rejected', value: 'rejected', icon: 'pi pi-times' },
+                ],
+                ariaLabel: 'Review state',
+            }),
             sceneComponent('radioButton', 'radioButton', { options: ['Email', 'SMS'], value: 'Email' }),
             sceneComponent('toggleSwitch', 'toggleSwitch', { label: 'Enabled', checked: true }),
             sceneComponent('slider', 'slider', { value: 35 }),

package/dist/esm/form/FormGallery.stories.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormGallery.stories.js","sourceRoot":"","sources":["../../../form/FormGallery.stories.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormGallery.stories.js","sourceRoot":"","sources":["../../../form/FormGallery.stories.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,IAAI,GAAG;IACT,KAAK,EAAE,iBAAiB;IACxB,SAAS,EAAE,gBAAgB;IAC3B,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,UAAU,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,2PAA2P,EAAE,EAAE;KACpS;CACoC,CAAC;AAE1C,eAAe,IAAI,CAAC;AAKpB,MAAM,CAAC,MAAM,OAAO,GAAU;IAC1B,IAAI,EAAE;QACF,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE;YAC7B,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;YACjE,cAAc,CAAC,eAAe,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACnF,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;YAC3F,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;YAC9E,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;YACnE,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;YACrE,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;YACzF,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;YAC/G,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;YACrH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;YACjF,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACpG,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7E,cAAc,CAAC,oBAAoB,EAAE,oBAAoB,EAAE;gBACvD,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE;oBACL,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE;oBAC7D,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE;iBAChE;gBACD,SAAS,EAAE,cAAc;aAC5B,CAAC;YACF,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YAC3F,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACjD,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YAChD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAC7C,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YAC/D,cAAc,CAAC,aAAa,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YAClE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YAC9D,cAAc,CAAC,cAAc,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAChH,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE;gBACvC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;aAChE,CAAC;SACL,CAAC;QACF,QAAQ,EAAE,oBAAoB;QAC9B,cAAc,EAAE,GAAG,EAAE,CAAC,SAAS;KAClC;CACJ,CAAC"}

package/dist/esm/form/MultiStateGlyph.d.ts

@@ -0,0 +1,8 @@
+import { MultiStateOption } from './MultiStateOption';
+export interface MultiStateGlyphProps {
+    state: MultiStateOption | undefined;
+    isEmpty: boolean;
+    isInactive: boolean;
+}
+export declare function MultiStateGlyph({ state, isEmpty, isInactive }: MultiStateGlyphProps): import("react").JSX.Element;
+//# sourceMappingURL=MultiStateGlyph.d.ts.map

package/dist/esm/form/MultiStateGlyph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiStateGlyph.d.ts","sourceRoot":"","sources":["../../../form/MultiStateGlyph.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IAEjC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAGpC,OAAO,EAAE,OAAO,CAAC;IAGjB,UAAU,EAAE,OAAO,CAAC;CACvB;AAQD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,oBAAoB,+BAkBnF"}

package/dist/esm/form/MultiStateGlyph.js

@@ -0,0 +1,57 @@
+import { jsx } from 'react/jsx-runtime';
+import { SceneIcon } from '@cratis/scene.react';
+
+/**
+ * The box a multi-state checkbox draws, themed with the PrimeReact checkbox tokens (`--p-checkbox-*`), so
+ * it follows the active Scene theme and looks like its sibling `checkbox`. It holds the state's icon - a
+ * PrimeIcons class or a qualified icon reference - or a check mark when the state has no icon of its own.
+ * An empty state draws only its own icon, if it has one. It is decorative: the state is announced through the control's text, not through this glyph.
+ */ function MultiStateGlyph({ state, isEmpty, isInactive }) {
+    const icon = state?.icon;
+    return /*#__PURE__*/ jsx("span", {
+        "aria-hidden": "true",
+        "data-scene-part": "glyph",
+        style: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            flexShrink: 0,
+            boxSizing: 'border-box',
+            width: 'var(--p-checkbox-width, 1.125rem)',
+            height: 'var(--p-checkbox-height, 1.125rem)',
+            borderRadius: 'var(--p-checkbox-border-radius, 4px)',
+            border: `1px solid ${isEmpty ? 'var(--p-checkbox-border-color, currentColor)' : 'var(--p-checkbox-checked-border-color, currentColor)'}`,
+            backgroundColor: isEmpty ? 'var(--p-checkbox-background, transparent)' : 'var(--p-checkbox-checked-background, currentColor)',
+            color: glyphColor(isEmpty, isInactive),
+            fontSize: 'var(--p-checkbox-icon-size, 0.75rem)'
+        },
+        children: icon === undefined ? !isEmpty && /*#__PURE__*/ jsx(CheckMark, {}) : typeof icon === 'string' ? /*#__PURE__*/ jsx("i", {
+            className: icon
+        }) : /*#__PURE__*/ jsx(SceneIcon, {
+            reference: icon,
+            size: "var(--p-checkbox-icon-size, 0.75rem)"
+        })
+    });
+}
+function glyphColor(isEmpty, isInactive) {
+    if (isInactive) return 'var(--p-checkbox-icon-disabled-color, currentColor)';
+    return isEmpty ? 'var(--p-checkbox-icon-color, currentColor)' : 'var(--p-checkbox-icon-checked-color, Canvas)';
+}
+function CheckMark() {
+    return /*#__PURE__*/ jsx("svg", {
+        viewBox: "0 0 12 12",
+        width: "1em",
+        height: "1em",
+        fill: "none",
+        stroke: "currentColor",
+        strokeWidth: "2",
+        strokeLinecap: "round",
+        strokeLinejoin: "round",
+        children: /*#__PURE__*/ jsx("path", {
+            d: "M2 6.5 5 9.5 10 3"
+        })
+    });
+}
+
+export { MultiStateGlyph };
+//# sourceMappingURL=MultiStateGlyph.js.map

package/dist/esm/form/MultiStateGlyph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiStateGlyph.js","sources":["../../../form/MultiStateGlyph.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 { SceneIcon } from '@cratis/scene.react';\nimport { MultiStateOption } from './MultiStateOption';\n\nexport interface MultiStateGlyphProps {\n    /** The state being shown. */\n    state: MultiStateOption | undefined;\n\n    /** Whether the state is the empty (`null`) state, drawn as an empty box. */\n    isEmpty: boolean;\n\n    /** Whether the control is disabled or read only. */\n    isInactive: boolean;\n}\n\n/**\n * The box a multi-state checkbox draws, themed with the PrimeReact checkbox tokens (`--p-checkbox-*`), so\n * it follows the active Scene theme and looks like its sibling `checkbox`. It holds the state's icon - a\n * PrimeIcons class or a qualified icon reference - or a check mark when the state has no icon of its own.\n * An empty state draws only its own icon, if it has one. It is decorative: the state is announced through the control's text, not through this glyph.\n */\nexport function MultiStateGlyph({ state, isEmpty, isInactive }: MultiStateGlyphProps) {\n    const icon = state?.icon;\n    return (\n        <span\n            aria-hidden='true'\n            data-scene-part='glyph'\n            style={{\n                display: 'inline-flex', alignItems: 'center', justifyContent: 'center', flexShrink: 0, boxSizing: 'border-box',\n                width: 'var(--p-checkbox-width, 1.125rem)', height: 'var(--p-checkbox-height, 1.125rem)',\n                borderRadius: 'var(--p-checkbox-border-radius, 4px)',\n                border: `1px solid ${isEmpty ? 'var(--p-checkbox-border-color, currentColor)' : 'var(--p-checkbox-checked-border-color, currentColor)'}`,\n                backgroundColor: isEmpty ? 'var(--p-checkbox-background, transparent)' : 'var(--p-checkbox-checked-background, currentColor)',\n                color: glyphColor(isEmpty, isInactive),\n                fontSize: 'var(--p-checkbox-icon-size, 0.75rem)',\n            }}>\n            {icon === undefined ? !isEmpty && <CheckMark /> : typeof icon === 'string' ? <i className={icon} /> : <SceneIcon reference={icon} size='var(--p-checkbox-icon-size, 0.75rem)' />}\n        </span>\n    );\n}\n\nfunction glyphColor(isEmpty: boolean, isInactive: boolean): string {\n    if (isInactive) return 'var(--p-checkbox-icon-disabled-color, currentColor)';\n    return isEmpty ? 'var(--p-checkbox-icon-color, currentColor)' : 'var(--p-checkbox-icon-checked-color, Canvas)';\n}\n\nfunction CheckMark() {\n    return (\n        <svg viewBox='0 0 12 12' width='1em' height='1em' fill='none' stroke='currentColor' strokeWidth='2' strokeLinecap='round' strokeLinejoin='round'>\n            <path d='M2 6.5 5 9.5 10 3' />\n        </svg>\n    );\n}\n"],"names":["MultiStateGlyph","state","isEmpty","isInactive","icon","_jsx","span","aria-hidden","data-scene-part","style","display","alignItems","justifyContent","flexShrink","boxSizing","width","height","borderRadius","border","backgroundColor","color","glyphColor","fontSize","undefined","CheckMark","i","className","SceneIcon","reference","size","svg","viewBox","fill","stroke","strokeWidth","strokeLinecap","strokeLinejoin","path","d"],"mappings":";;;AAiBA;;;;;IAMO,SAASA,eAAAA,CAAgB,EAAEC,KAAK,EAAEC,OAAO,EAAEC,UAAU,EAAwB,EAAA;AAChF,IAAA,MAAMC,OAAOH,KAAAA,EAAOG,IAAAA;AACpB,IAAA,qBACIC,GAAA,CAACC,MAAAA,EAAAA;QACGC,aAAAA,EAAY,MAAA;QACZC,iBAAAA,EAAgB,OAAA;QAChBC,KAAAA,EAAO;YACHC,OAAAA,EAAS,aAAA;YAAeC,UAAAA,EAAY,QAAA;YAAUC,cAAAA,EAAgB,QAAA;YAAUC,UAAAA,EAAY,CAAA;YAAGC,SAAAA,EAAW,YAAA;YAClGC,KAAAA,EAAO,mCAAA;YAAqCC,MAAAA,EAAQ,oCAAA;YACpDC,YAAAA,EAAc,sCAAA;AACdC,YAAAA,MAAAA,EAAQ,CAAC,UAAU,EAAEhB,OAAAA,GAAU,iDAAiD,sDAAA,CAAA,CAAwD;AACxIiB,YAAAA,eAAAA,EAAiBjB,UAAU,2CAAA,GAA8C,oDAAA;AACzEkB,YAAAA,KAAAA,EAAOC,WAAWnB,OAAAA,EAASC,UAAAA,CAAAA;YAC3BmB,QAAAA,EAAU;AACd,SAAA;kBACClB,IAAAA,KAASmB,SAAAA,GAAY,CAACrB,OAAAA,kBAAWG,GAAA,CAACmB,iBAAe,OAAOpB,IAAAA,KAAS,yBAAWC,GAAA,CAACoB,GAAAA,EAAAA;YAAEC,SAAAA,EAAWtB;2BAAWC,GAAA,CAACsB,SAAAA,EAAAA;YAAUC,SAAAA,EAAWxB,IAAAA;YAAMyB,IAAAA,EAAK;;;AAGnJ;AAEA,SAASR,UAAAA,CAAWnB,OAAgB,EAAEC,UAAmB,EAAA;AACrD,IAAA,IAAIA,YAAY,OAAO,qDAAA;AACvB,IAAA,OAAOD,UAAU,4CAAA,GAA+C,8CAAA;AACpE;AAEA,SAASsB,SAAAA,GAAAA;AACL,IAAA,qBACInB,GAAA,CAACyB,KAAAA,EAAAA;QAAIC,OAAAA,EAAQ,WAAA;QAAYhB,KAAAA,EAAM,KAAA;QAAMC,MAAAA,EAAO,KAAA;QAAMgB,IAAAA,EAAK,MAAA;QAAOC,MAAAA,EAAO,cAAA;QAAeC,WAAAA,EAAY,GAAA;QAAIC,aAAAA,EAAc,OAAA;QAAQC,cAAAA,EAAe,OAAA;AACrI,QAAA,QAAA,gBAAA/B,GAAA,CAACgC,MAAAA,EAAAA;YAAKC,CAAAA,EAAE;;;AAGpB;;"}