react-cheminfo 0.3.0 → 0.4.0

package/lib/share/ui/ShareButton.d.ts

@@ -0,0 +1,42 @@
+import type { ReactElement } from 'react';
+/** How the button is dressed for the bar it sits in. */
+export type ShareButtonVariant = 'nav-link' | 'blueprint';
+export interface ShareButtonProps {
+    /** Called when the button is pressed; what it opens is the caller's business. */
+    onClick: () => void;
+    /**
+     * A plain entry of a site's own header bar, or a Blueprint button for a
+     * toolbar already made of them.
+     * @default 'nav-link'
+     */
+    variant?: ShareButtonVariant;
+    /**
+     * Text of the button, and what a screen reader is told.
+     * @default 'Share'
+     */
+    label?: string;
+    /**
+     * Whether the button is reduced to its icon, for a bar that has run out of
+     * room. It is still named to the pointer and to a screen reader.
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * What the pointer is told.
+     * @default 'Share a link to this page, or embed it in your own site'
+     */
+    title?: string;
+    /**
+     * Class the button carries, on top of the one its variant gives it.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * The Share entry of a site header: the button that offers the open page as a
+ * link, or as the iframe that frames it in someone else's site.
+ * @param props - What the button does, how it is dressed, and how it is named.
+ * @returns The button.
+ */
+export declare function ShareButton(props: ShareButtonProps): ReactElement;
+//# sourceMappingURL=ShareButton.d.ts.map

package/lib/share/ui/ShareButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareButton.d.ts","sourceRoot":"","sources":["../../../src/share/ui/ShareButton.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,wDAAwD;AACxD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAqCjE"}

package/lib/share/ui/ShareButton.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Icon } from '@blueprintjs/core';
+const SHARE_TITLE = 'Share a link to this page, or embed it in your own site';
+/**
+ * The Share entry of a site header: the button that offers the open page as a
+ * link, or as the iframe that frames it in someone else's site.
+ * @param props - What the button does, how it is dressed, and how it is named.
+ * @returns The button.
+ */
+export function ShareButton(props) {
+    const { onClick, variant = 'nav-link', label = 'Share', compact = false, title = SHARE_TITLE, className, } = props;
+    const text = compact ? undefined : label;
+    if (variant === 'blueprint') {
+        return (_jsx(Button, { className: className, variant: "minimal", icon: "share", text: text, title: title, "aria-label": label, onClick: onClick }));
+    }
+    return (_jsxs("button", { type: "button", className: className === undefined ? 'nav-link' : `nav-link ${className}`, title: title, "aria-label": label, onClick: onClick, children: [_jsx(Icon, { icon: "share", size: 14 }), text] }));
+}
+//# sourceMappingURL=ShareButton.js.map

package/lib/share/ui/ShareButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareButton.js","sourceRoot":"","sources":["../../../src/share/ui/ShareButton.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,GAAG,yDAAyD,CAAC;AAqC9E;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EACJ,OAAO,EACP,OAAO,GAAG,UAAU,EACpB,KAAK,GAAG,OAAO,EACf,OAAO,GAAG,KAAK,EACf,KAAK,GAAG,WAAW,EACnB,SAAS,GACV,GAAG,KAAK,CAAC;IACV,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzC,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;QAC5B,OAAO,CACL,KAAC,MAAM,IACL,SAAS,EAAE,SAAS,EACpB,OAAO,EAAC,SAAS,EACjB,IAAI,EAAC,OAAO,EACZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,gBACA,KAAK,EACjB,OAAO,EAAE,OAAO,GAChB,CACH,CAAC;IACJ,CAAC;IAED,OAAO,CACL,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,SAAS,EAAE,EACzE,KAAK,EAAE,KAAK,gBACA,KAAK,EACjB,OAAO,EAAE,OAAO,aAEhB,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAE,EAAE,GAAI,EAC9B,IAAI,IACE,CACV,CAAC;AACJ,CAAC"}

package/lib/share/ui/ShareDialog.d.ts

@@ -0,0 +1,73 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { ShareConfig, ShareParamCodecs, ShareParamValues, ShareVocabulary } from '../core/index.ts';
+/**
+ * The configuration the dialog is holding, handed to a tool-specific section so
+ * it can read it and change it.
+ */
+export interface ShareDraft<Codecs extends ShareParamCodecs = Record<string, never>> {
+    /** What the link would say if it were handed out now. */
+    config: ShareConfig<Codecs>;
+    /** Frame the page, or give it its chrome back. */
+    setEmbed: (embed: boolean) => void;
+    /** Switch one part of the page off, or on again. */
+    setPartHidden: (part: string, hidden: boolean) => void;
+    /** Give one of the tool's own parameters a new value. */
+    setParam: <Key extends keyof ShareParamValues<Codecs>>(key: Key, value: ShareParamValues<Codecs>[Key]) => void;
+}
+export interface ShareDialogProps<Codecs extends ShareParamCodecs = Record<string, never>> {
+    /** Whether the dialog is on screen. */
+    isOpen: boolean;
+    /** Called when the dialog is dismissed. */
+    onClose: () => void;
+    /** What this site's links can say: the hideable parts, and the tool's own parameters. */
+    vocabulary: ShareVocabulary<Codecs>;
+    /** How the open page is named in the dialog, and in the frame. */
+    title: string;
+    /**
+     * Where the page is served from — origin and path. Anything from the first
+     * `?` or `#` is dropped, so an address can be handed over as it is.
+     * @default the address of the page
+     */
+    baseUrl?: string;
+    /**
+     * The address as it stands, so the tool's own inputs travel with the link and
+     * a page already running a configuration opens on that one.
+     * @default the query string of the page
+     */
+    search?: string;
+    /**
+     * What a screen reader announces the frame as. A frame in someone else's page
+     * is usually named after the site as well as the page.
+     * @default the title
+     */
+    frameTitle?: string;
+    /**
+     * Height of the frame, in pixels.
+     * @default 700
+     */
+    frameHeight?: number;
+    /**
+     * Whether the dialog is rendered through a portal on `document.body`.
+     * @default true
+     */
+    usePortal?: boolean;
+    /**
+     * An extra section for what only this tool can configure — a series length, a
+     * difficulty, a seed. A function is handed the draft, so such a section can
+     * write the tool's own parameters into the link.
+     * @default undefined — the dialog shows the sections every site shares
+     */
+    children?: ReactNode | ((draft: ShareDraft<Codecs>) => ReactNode);
+}
+/**
+ * Hand the open page out as a link, or as the iframe that frames it in someone
+ * else's site.
+ *
+ * The dialog opens on the link one actually hands out: framed, and with the
+ * parts a host page has no use for already switched off. A page that is itself
+ * running a configuration shows that one instead.
+ * @param props - Whether the dialog is open, what the site's links can say, and how the page is named.
+ * @returns The dialog.
+ */
+export declare function ShareDialog<Codecs extends ShareParamCodecs = Record<string, never>>(props: ShareDialogProps<Codecs>): ReactElement;
+//# sourceMappingURL=ShareDialog.d.ts.map

package/lib/share/ui/ShareDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareDialog.d.ts","sourceRoot":"","sources":["../../../src/share/ui/ShareDialog.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAM1B;;;GAGG;AACH,MAAM,WAAW,UAAU,CACzB,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvD,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,yDAAyD;IACzD,QAAQ,EAAE,CAAC,GAAG,SAAS,MAAM,gBAAgB,CAAC,MAAM,CAAC,EACnD,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KACjC,IAAI,CAAC;CACX;AAED,MAAM,WAAW,gBAAgB,CAC/B,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvD,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;IAChB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,yFAAyF;IACzF,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC;CACnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACvD,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,YAAY,CAmB/C"}

package/lib/share/ui/ShareDialog.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Dialog } from '@blueprintjs/core';
+import { ShareDialogContent } from "./ShareDialogContent.js";
+const DIALOG_STYLE = { width: 'min(680px, 94vw)' };
+/**
+ * Hand the open page out as a link, or as the iframe that frames it in someone
+ * else's site.
+ *
+ * The dialog opens on the link one actually hands out: framed, and with the
+ * parts a host page has no use for already switched off. A page that is itself
+ * running a configuration shows that one instead.
+ * @param props - Whether the dialog is open, what the site's links can say, and how the page is named.
+ * @returns The dialog.
+ */
+export function ShareDialog(props) {
+    const { isOpen, onClose, usePortal = true, ...rest } = props;
+    return (_jsx(Dialog, { isOpen: isOpen, onClose: onClose, usePortal: usePortal, title: "Share or embed", icon: "share", className: "share-dialog", style: DIALOG_STYLE, children: isOpen ? _jsx(ShareDialogContent, { ...rest, onClose: onClose }) : null }));
+}
+//# sourceMappingURL=ShareDialog.js.map

package/lib/share/ui/ShareDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareDialog.js","sourceRoot":"","sources":["../../../src/share/ui/ShareDialog.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAU3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAA0B,CAAC;AAE9D,MAAM,YAAY,GAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;AAsElE;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAEzB,KAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAE7D,OAAO,CACL,KAAC,MAAM,IACL,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAC,gBAAgB,EACtB,IAAI,EAAC,OAAO,EACZ,SAAS,EAAC,cAAc,EACxB,KAAK,EAAE,YAAY,YAKlB,MAAM,CAAC,CAAC,CAAC,KAAC,kBAAkB,OAAK,IAAI,EAAE,OAAO,EAAE,OAAO,GAAI,CAAC,CAAC,CAAC,IAAI,GAC5D,CACV,CAAC;AACJ,CAAC"}

package/lib/share/ui/ShareDialogContent.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement } from 'react';
+import type { ShareParamCodecs } from '../core/index.ts';
+import type { ShareDialogProps } from './ShareDialog.tsx';
+/** Everything the dialog holds, minus what only its shell is concerned with. */
+export type ShareDialogContentProps<Codecs extends ShareParamCodecs = Record<string, never>> = Omit<ShareDialogProps<Codecs>, 'isOpen' | 'usePortal'>;
+/**
+ * The sections of the share dialog: what the link says, what it hands out, and
+ * the markup that frames it.
+ * @param props - What the site's links can say, how the page is named, and the extra section.
+ * @returns The body and the footer of the dialog.
+ */
+export declare function ShareDialogContent<Codecs extends ShareParamCodecs = Record<string, never>>(props: ShareDialogContentProps<Codecs>): ReactElement;
+//# sourceMappingURL=ShareDialogContent.d.ts.map

package/lib/share/ui/ShareDialogContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareDialogContent.d.ts","sourceRoot":"","sources":["../../../src/share/ui/ShareDialogContent.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAIzD,OAAO,KAAK,EAEV,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,mBAAmB,CAAC;AAmBtE,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,CACjC,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IACrD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,SAAS,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACvD,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,YAAY,CAwHtD"}

package/lib/share/ui/ShareDialogContent.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { AnchorButton, Button, Checkbox, DialogBody, DialogFooter, H6, } from '@blueprintjs/core';
+import { useState } from 'react';
+import { CodeBlock, CopyButton } from "../../clipboard/ui/index.js";
+import { buildEmbedCode, buildShareUrl, isShareConfigured, parseShareConfig, suggestedShareConfig, } from "../core/index.js";
+import { SharePartOptions } from "./SharePartOptions.js";
+import { withPart } from "./draft.js";
+const LEAD_STYLE = { marginTop: 0, color: '#5b6875' };
+const SECTION_STYLE = { marginBottom: 18 };
+const ACTIONS_STYLE = {
+    display: 'flex',
+    flexWrap: 'wrap',
+    gap: 8,
+    marginTop: 8,
+};
+const HINT_STYLE = {
+    display: 'block',
+    marginLeft: 26,
+    color: '#5b6875',
+    fontSize: 12,
+};
+/**
+ * The sections of the share dialog: what the link says, what it hands out, and
+ * the markup that frames it.
+ * @param props - What the site's links can say, how the page is named, and the extra section.
+ * @returns The body and the footer of the dialog.
+ */
+export function ShareDialogContent(props) {
+    const { onClose, vocabulary, title, baseUrl, search, frameTitle, frameHeight, children, } = props;
+    const address = globalThis.location;
+    const base = baseUrl ?? address?.href ?? '';
+    const query = search ?? address?.search ?? '';
+    const [config, setConfig] = useState(() => initialDraft(query, vocabulary));
+    function setEmbed(embed) {
+        setConfig((previous) => ({ ...previous, embed }));
+    }
+    function setPartHidden(part, hidden) {
+        setConfig((previous) => ({
+            ...previous,
+            hidden: withPart(previous.hidden, part, hidden),
+        }));
+    }
+    function setParam(key, value) {
+        setConfig((previous) => ({
+            ...previous,
+            params: { ...previous.params, [key]: value },
+        }));
+    }
+    const draft = {
+        config,
+        setEmbed,
+        setPartHidden,
+        setParam,
+    };
+    const url = buildShareUrl({ base, search: query, config, vocabulary });
+    const frame = buildEmbedCode({
+        url,
+        title: frameTitle ?? title,
+        height: frameHeight,
+    });
+    return (_jsxs(_Fragment, { children: [_jsxs(DialogBody, { children: [_jsxs("p", { style: LEAD_STYLE, children: ["A link to ", _jsx("b", { children: title }), " as you have it set up now."] }), _jsxs("section", { className: "share-section", style: SECTION_STYLE, children: [_jsx(H6, { children: "Layout" }), _jsx(Checkbox, { checked: config.embed, label: "Embed in another page", onChange: (event) => {
+                                    setEmbed(event.currentTarget.checked);
+                                } }), _jsx("span", { style: HINT_STYLE, children: "Drops the site header and its navigation, so the page sits inside a page of your own." })] }), vocabulary.parts.length > 0 ? (_jsxs("section", { className: "share-section", style: SECTION_STYLE, children: [_jsx(H6, { children: "Show on the page" }), _jsx(SharePartOptions, { parts: vocabulary.parts, hidden: config.hidden, onChange: setPartHidden })] })) : null, children === undefined ? null : (_jsx("section", { className: "share-section", style: SECTION_STYLE, children: typeof children === 'function' ? children(draft) : children })), _jsxs("section", { className: "share-section", style: SECTION_STYLE, children: [_jsx(H6, { children: "Link" }), _jsx(CodeBlock, { code: url, tone: "muted" }), _jsxs("div", { style: ACTIONS_STYLE, children: [_jsx(CopyButton, { content: url, label: "Copy the link" }), _jsx(AnchorButton, { icon: "share", text: "Open in a new tab", href: url, target: "_blank", rel: "noopener noreferrer" })] })] }), _jsxs("section", { className: "share-section", style: SECTION_STYLE, children: [_jsx(H6, { children: "Iframe" }), _jsx(CodeBlock, { code: frame, tone: "muted" }), _jsx("div", { style: ACTIONS_STYLE, children: _jsx(CopyButton, { content: frame, label: "Copy the iframe" }) })] })] }), _jsx(DialogFooter, { actions: _jsx(Button, { intent: "primary", text: "Done", onClick: onClose }) })] }));
+}
+function initialDraft(search, vocabulary) {
+    const current = parseShareConfig(search, vocabulary);
+    return isShareConfigured(current, vocabulary)
+        ? current
+        : suggestedShareConfig(vocabulary);
+}
+//# sourceMappingURL=ShareDialogContent.js.map

package/lib/share/ui/ShareDialogContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShareDialogContent.js","sourceRoot":"","sources":["../../../src/share/ui/ShareDialogContent.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,EAAE,GACH,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAOpE,OAAO,EACL,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,UAAU,GAAkB,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrE,MAAM,aAAa,GAAkB,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;AAC1D,MAAM,aAAa,GAAkB;IACnC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,GAAG,EAAE,CAAC;IACN,SAAS,EAAE,CAAC;CACb,CAAC;AACF,MAAM,UAAU,GAAkB;IAChC,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,EAAE;IACd,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,EAAE;CACb,CAAC;AAOF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAEhC,KAAsC;IACtC,MAAM,EACJ,OAAO,EACP,UAAU,EACV,KAAK,EACL,OAAO,EACP,MAAM,EACN,UAAU,EACV,WAAW,EACX,QAAQ,GACT,GAAG,KAAK,CAAC;IAEV,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC;IACpC,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;IAC9C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAsB,GAAG,EAAE,CAC7D,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAChC,CAAC;IAEF,SAAS,QAAQ,CAAC,KAAc;QAC9B,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAAe;QAClD,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvB,GAAG,QAAQ;YACX,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;SAChD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,SAAS,QAAQ,CACf,GAAQ,EACR,KAAoC;QAEpC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACvB,GAAG,QAAQ;YACX,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;SAC7C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,KAAK,GAAuB;QAChC,MAAM;QACN,QAAQ;QACR,aAAa;QACb,QAAQ;KACT,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,cAAc,CAAC;QAC3B,GAAG;QACH,KAAK,EAAE,UAAU,IAAI,KAAK;QAC1B,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;IAEH,OAAO,CACL,8BACE,MAAC,UAAU,eACT,aAAG,KAAK,EAAE,UAAU,2BACR,sBAAI,KAAK,GAAK,mCACtB,EAEJ,mBAAS,SAAS,EAAC,eAAe,EAAC,KAAK,EAAE,aAAa,aACrD,KAAC,EAAE,yBAAY,EACf,KAAC,QAAQ,IACP,OAAO,EAAE,MAAM,CAAC,KAAK,EACrB,KAAK,EAAC,uBAAuB,EAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;oCAClB,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gCACxC,CAAC,GACD,EACF,eAAM,KAAK,EAAE,UAAU,sGAGhB,IACC,EAET,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAC7B,mBAAS,SAAS,EAAC,eAAe,EAAC,KAAK,EAAE,aAAa,aACrD,KAAC,EAAE,mCAAsB,EACzB,KAAC,gBAAgB,IACf,KAAK,EAAE,UAAU,CAAC,KAAK,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,QAAQ,EAAE,aAAa,GACvB,IACM,CACX,CAAC,CAAC,CAAC,IAAI,EAEP,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAC/B,kBAAS,SAAS,EAAC,eAAe,EAAC,KAAK,EAAE,aAAa,YACpD,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,GACpD,CACX,EAED,mBAAS,SAAS,EAAC,eAAe,EAAC,KAAK,EAAE,aAAa,aACrD,KAAC,EAAE,uBAAU,EACb,KAAC,SAAS,IAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAC,OAAO,GAAG,EACrC,eAAK,KAAK,EAAE,aAAa,aACvB,KAAC,UAAU,IAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAC,eAAe,GAAG,EAClD,KAAC,YAAY,IACX,IAAI,EAAC,OAAO,EACZ,IAAI,EAAC,mBAAmB,EACxB,IAAI,EAAE,GAAG,EACT,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,GACzB,IACE,IACE,EAEV,mBAAS,SAAS,EAAC,eAAe,EAAC,KAAK,EAAE,aAAa,aACrD,KAAC,EAAE,yBAAY,EACf,KAAC,SAAS,IAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,OAAO,GAAG,EACvC,cAAK,KAAK,EAAE,aAAa,YACvB,KAAC,UAAU,IAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAC,iBAAiB,GAAG,GAClD,IACE,IACC,EACb,KAAC,YAAY,IACX,OAAO,EAAE,KAAC,MAAM,IAAC,MAAM,EAAC,SAAS,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,EAAE,OAAO,GAAI,GAClE,IACD,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,MAAc,EACd,UAAmC;IAEnC,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD,OAAO,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC;QAC3C,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC"}

package/lib/share/ui/SharePartOptions.d.ts

@@ -0,0 +1,18 @@
+import type { ReactElement } from 'react';
+import type { HideablePart } from '../core/index.ts';
+export interface SharePartOptionsProps {
+    /** The parts this page can switch off, in the order the vocabulary lists them. */
+    parts: readonly HideablePart[];
+    /** The parts the draft currently switches off. */
+    hidden: readonly string[];
+    /** Called with the part and whether the link should switch it off. */
+    onChange: (part: string, hidden: boolean) => void;
+}
+/**
+ * One box per part of the page, worded positively: a ticked box is a part the
+ * link keeps, which is how somebody building a course tile thinks about it.
+ * @param props - The parts, what is switched off, and how to change it.
+ * @returns The list of boxes.
+ */
+export declare function SharePartOptions(props: SharePartOptionsProps): ReactElement;
+//# sourceMappingURL=SharePartOptions.d.ts.map

package/lib/share/ui/SharePartOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharePartOptions.d.ts","sourceRoot":"","sources":["../../../src/share/ui/SharePartOptions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAWrD,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,kDAAkD;IAClD,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAqB3E"}

package/lib/share/ui/SharePartOptions.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Checkbox } from '@blueprintjs/core';
+const OPTION_STYLE = { marginBottom: 8 };
+const DESCRIPTION_STYLE = {
+    display: 'block',
+    marginLeft: 26,
+    color: '#5b6875',
+    fontSize: 12,
+};
+/**
+ * One box per part of the page, worded positively: a ticked box is a part the
+ * link keeps, which is how somebody building a course tile thinks about it.
+ * @param props - The parts, what is switched off, and how to change it.
+ * @returns The list of boxes.
+ */
+export function SharePartOptions(props) {
+    const { parts, hidden, onChange } = props;
+    return (_jsx(_Fragment, { children: parts.map((part) => (_jsxs("div", { style: OPTION_STYLE, className: "share-part", children: [_jsx(Checkbox, { checked: !hidden.includes(part.key), label: part.label, onChange: (event) => {
+                        onChange(part.key, !event.currentTarget.checked);
+                    } }), _jsx("span", { style: DESCRIPTION_STYLE, className: "share-part-description", children: part.description })] }, part.key))) }));
+}
+//# sourceMappingURL=SharePartOptions.js.map

package/lib/share/ui/SharePartOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharePartOptions.js","sourceRoot":"","sources":["../../../src/share/ui/SharePartOptions.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C,MAAM,YAAY,GAAkB,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AAExD,MAAM,iBAAiB,GAAkB;IACvC,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,EAAE;IACd,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,EAAE;CACb,CAAC;AAWF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAE1C,OAAO,CACL,4BACG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,eAAoB,KAAK,EAAE,YAAY,EAAE,SAAS,EAAC,YAAY,aAC7D,KAAC,QAAQ,IACP,OAAO,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EACnC,KAAK,EAAE,IAAI,CAAC,KAAK,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;wBAClB,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;oBACnD,CAAC,GACD,EACF,eAAM,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAC,wBAAwB,YAC/D,IAAI,CAAC,WAAW,GACZ,KAVC,IAAI,CAAC,GAAG,CAWZ,CACP,CAAC,GACD,CACJ,CAAC;AACJ,CAAC"}

package/lib/share/ui/draft.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Switch one part of the page off, or on again, in the draft the dialog holds.
+ *
+ * A part is named once however many times it is ticked, and the order the
+ * vocabulary gives is restored when the link is written, so two people who
+ * ticked the same boxes hand out the same link.
+ * @param hidden - The parts the draft switches off.
+ * @param part - The part being ticked.
+ * @param off - Whether the link should switch it off.
+ * @returns The parts the draft switches off after the change.
+ */
+export declare function withPart(hidden: readonly string[], part: string, off: boolean): readonly string[];
+//# sourceMappingURL=draft.d.ts.map

package/lib/share/ui/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../../src/share/ui/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,GACX,SAAS,MAAM,EAAE,CAGnB"}

package/lib/share/ui/draft.js

@@ -0,0 +1,16 @@
+/**
+ * Switch one part of the page off, or on again, in the draft the dialog holds.
+ *
+ * A part is named once however many times it is ticked, and the order the
+ * vocabulary gives is restored when the link is written, so two people who
+ * ticked the same boxes hand out the same link.
+ * @param hidden - The parts the draft switches off.
+ * @param part - The part being ticked.
+ * @param off - Whether the link should switch it off.
+ * @returns The parts the draft switches off after the change.
+ */
+export function withPart(hidden, part, off) {
+    const rest = hidden.filter((entry) => entry !== part);
+    return off ? [...rest, part] : rest;
+}
+//# sourceMappingURL=draft.js.map

package/lib/share/ui/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../../src/share/ui/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAyB,EACzB,IAAY,EACZ,GAAY;IAEZ,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC"}

package/lib/share/ui/hiddenParts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The parts the link switched off, so a component that can be left out of an
+ * embedded page reads the configuration instead of taking it as a prop.
+ *
+ * A page with no provider above it hides nothing, which is what a site that
+ * hands out no links wants.
+ */
+export declare const HiddenPartsContext: import("react").Context<ReadonlySet<string>>;
+/**
+ * Ask whether the link the page was opened with switches a part off.
+ *
+ * Hidden means hidden, not disabled: the value a hidden control carries still
+ * applies, so an embedder can preset what a visitor may not change.
+ * @returns A predicate over the part keys of the site's vocabulary.
+ */
+export declare function useIsHidden(): (part: string) => boolean;
+//# sourceMappingURL=hiddenParts.d.ts.map

package/lib/share/ui/hiddenParts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hiddenParts.d.ts","sourceRoot":"","sources":["../../../src/share/ui/hiddenParts.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,8CAAgD,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAGvD"}

package/lib/share/ui/hiddenParts.js

@@ -0,0 +1,21 @@
+import { createContext, useCallback, useContext } from 'react';
+/**
+ * The parts the link switched off, so a component that can be left out of an
+ * embedded page reads the configuration instead of taking it as a prop.
+ *
+ * A page with no provider above it hides nothing, which is what a site that
+ * hands out no links wants.
+ */
+export const HiddenPartsContext = createContext(new Set());
+/**
+ * Ask whether the link the page was opened with switches a part off.
+ *
+ * Hidden means hidden, not disabled: the value a hidden control carries still
+ * applies, so an embedder can preset what a visitor may not change.
+ * @returns A predicate over the part keys of the site's vocabulary.
+ */
+export function useIsHidden() {
+    const hidden = useContext(HiddenPartsContext);
+    return useCallback((part) => hidden.has(part), [hidden]);
+}
+//# sourceMappingURL=hiddenParts.js.map

package/lib/share/ui/hiddenParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hiddenParts.js","sourceRoot":"","sources":["../../../src/share/ui/hiddenParts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC9C,OAAO,WAAW,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/lib/share/ui/index.d.ts

@@ -0,0 +1,10 @@
+export type { HiddenPartsProviderProps } from './HiddenPartsProvider.tsx';
+export { HiddenPartsProvider } from './HiddenPartsProvider.tsx';
+export { useIsHidden } from './hiddenParts.ts';
+export type { PagePartProps } from './PagePart.tsx';
+export { PagePart } from './PagePart.tsx';
+export type { ShareButtonProps, ShareButtonVariant } from './ShareButton.tsx';
+export { ShareButton } from './ShareButton.tsx';
+export type { ShareDialogProps } from './ShareDialog.tsx';
+export { ShareDialog } from './ShareDialog.tsx';
+//# sourceMappingURL=index.d.ts.map

package/lib/share/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/share/ui/index.js

@@ -0,0 +1,6 @@
+export { HiddenPartsProvider } from "./HiddenPartsProvider.js";
+export { useIsHidden } from "./hiddenParts.js";
+export { PagePart } from "./PagePart.js";
+export { ShareButton } from "./ShareButton.js";
+export { ShareDialog } from "./ShareDialog.js";
+//# sourceMappingURL=index.js.map

package/lib/share/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/share/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC"}

package/lib/shared/ui/index.d.ts

@@ -1,2 +1,3 @@
-export type { HeaderButtonProps } from './MenuButton.tsx';
+export type { HeaderButtonProps, MenuButtonProps } from './MenuButton.tsx';
+export { MenuButton } from './MenuButton.tsx';
 //# sourceMappingURL=index.d.ts.map

package/lib/shared/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/shared/ui/index.js

@@ -1,2 +1,2 @@
-export {};
+export { MenuButton } from "./MenuButton.js";
 //# sourceMappingURL=index.js.map

package/lib/shared/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC"}

package/lib/state/ui/index.d.ts

@@ -0,0 +1,3 @@
+export type { BucketRead, PersistBucketOptions, PersistedBucket, } from './persistBucket.ts';
+export { persistBucket } from './persistBucket.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/state/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/state/ui/index.js

@@ -0,0 +1,2 @@
+export { persistBucket } from "./persistBucket.js";
+//# sourceMappingURL=index.js.map

package/lib/state/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/ui/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/lib/state/ui/mergeStored.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Merge what came out of storage over the defaults it was stored against.
+ *
+ * A field the defaults name and the payload does not keeps its default, so a
+ * field added after the last save lands as its default rather than as
+ * `undefined`. A field whose stored value no longer has the shape of its
+ * default — a number where a string is expected, an object where an array is —
+ * is discarded, because a payload written by an older version of a page must
+ * never reach the interface as the wrong type. A key the defaults do not name
+ * is kept, so a bucket whose default is an empty dictionary keeps everything
+ * that was ever put in it.
+ *
+ * The result shares no object and no array with `defaults`, so a caller may
+ * write into it.
+ * @param defaults - What every missing or unusable field falls back to.
+ * @param stored - Whatever `JSON.parse` gave back, trusted for nothing.
+ * @returns The defaults, with whatever was stored and is usable on top.
+ */
+export declare function mergeStored<T extends object>(defaults: T, stored: unknown): T;
+/**
+ * Whether a value is a plain object — the shape the JSON payload of a bucket
+ * takes — rather than an array, a primitive or null.
+ * @param value - Value to inspect.
+ * @returns True for a plain object.
+ */
+export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=mergeStored.d.ts.map

package/lib/state/ui/mergeStored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeStored.d.ts","sourceRoot":"","sources":["../../../src/state/ui/mergeStored.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAG7E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElC"}

package/lib/state/ui/mergeStored.js

@@ -0,0 +1,82 @@
+/**
+ * Merge what came out of storage over the defaults it was stored against.
+ *
+ * A field the defaults name and the payload does not keeps its default, so a
+ * field added after the last save lands as its default rather than as
+ * `undefined`. A field whose stored value no longer has the shape of its
+ * default — a number where a string is expected, an object where an array is —
+ * is discarded, because a payload written by an older version of a page must
+ * never reach the interface as the wrong type. A key the defaults do not name
+ * is kept, so a bucket whose default is an empty dictionary keeps everything
+ * that was ever put in it.
+ *
+ * The result shares no object and no array with `defaults`, so a caller may
+ * write into it.
+ * @param defaults - What every missing or unusable field falls back to.
+ * @param stored - Whatever `JSON.parse` gave back, trusted for nothing.
+ * @returns The defaults, with whatever was stored and is usable on top.
+ */
+export function mergeStored(defaults, stored) {
+    const source = isPlainRecord(stored) ? stored : {};
+    return mergeRecord(defaults, source);
+}
+/**
+ * Whether a value is a plain object — the shape the JSON payload of a bucket
+ * takes — rather than an array, a primitive or null.
+ * @param value - Value to inspect.
+ * @returns True for a plain object.
+ */
+export function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function mergeRecord(defaults, stored) {
+    const merged = {};
+    for (const [name, value] of Object.entries(defaults)) {
+        merged[name] = cloneValue(value);
+    }
+    for (const [name, value] of Object.entries(stored)) {
+        if (value === undefined)
+            continue;
+        merged[name] = Object.hasOwn(defaults, name)
+            ? mergeValue(defaults[name], value)
+            : value;
+    }
+    return merged;
+}
+function mergeValue(defaultValue, storedValue) {
+    if (isPlainRecord(defaultValue) && isPlainRecord(storedValue)) {
+        return mergeRecord(defaultValue, storedValue);
+    }
+    return hasSameShape(defaultValue, storedValue)
+        ? storedValue
+        : cloneValue(defaultValue);
+}
+// A default that is `null` or absent accepts anything, since it names no shape
+// of its own.
+function hasSameShape(defaultValue, storedValue) {
+    if (defaultValue === null || defaultValue === undefined)
+        return true;
+    if (storedValue === null)
+        return false;
+    if (Array.isArray(defaultValue) !== Array.isArray(storedValue))
+        return false;
+    return typeof defaultValue === typeof storedValue;
+}
+function cloneValue(value) {
+    if (Array.isArray(value)) {
+        const copy = new Array(value.length);
+        for (let index = 0; index < value.length; index++) {
+            copy[index] = cloneValue(value[index]);
+        }
+        return copy;
+    }
+    if (isPlainRecord(value)) {
+        const copy = {};
+        for (const [name, item] of Object.entries(value)) {
+            copy[name] = cloneValue(item);
+        }
+        return copy;
+    }
+    return value;
+}
+//# sourceMappingURL=mergeStored.js.map

package/lib/state/ui/mergeStored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeStored.js","sourceRoot":"","sources":["../../../src/state/ui/mergeStored.ts"],"names":[],"mappings":"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"}