react-cheminfo 0.2.0 → 0.4.0

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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"}

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

@@ -0,0 +1,65 @@
+/**
+ * A bucket of preferences kept in `localStorage` under one versioned key.
+ *
+ * Everything here is best effort. In a page framed by a course, third-party
+ * storage is partitioned in Chrome and blocked in Safari, so a read may find
+ * nothing, a write may be refused, and touching the store may throw before it
+ * is even reached — none of which may ever reach the interface. A visitor whose
+ * quota is full still gets a working site, with their preferences lasting only
+ * as long as the tab.
+ * @param options - See {@link PersistBucketOptions}.
+ * @returns The three ways to use the bucket: read it, write it, forget it.
+ */
+export declare function persistBucket<T extends object>(options: PersistBucketOptions<T>): PersistedBucket<T>;
+/** How a bucket is named, versioned and filled in. */
+export interface PersistBucketOptions<T extends object> {
+    /**
+     * Name of the bucket, namespaced by the site, e.g. `smiles:exercises`. The
+     * version is appended to it, so this never carries one itself.
+     */
+    key: string;
+    /**
+     * Schema version, appended to the key as `:v<version>`. Raise it when a new
+     * shape cannot be reconciled with the old one field by field, and every entry
+     * written by the previous shape is then ignored rather than migrated.
+     * @default 1
+     */
+    version?: number;
+    /**
+     * What a visitor who has stored nothing gets, and what every missing or
+     * unusable field of a stored payload falls back to. Must be JSON
+     * serialisable, since that is how it is stored.
+     */
+    defaults: T;
+    /**
+     * Called when a write was refused because the store is full, with the error
+     * the store threw. The write is swallowed either way; this only exists so a
+     * page can tell its visitor that what they are doing is no longer being kept.
+     * @default undefined
+     */
+    onQuotaExceeded?: (error: unknown) => void;
+}
+/** The three ways a page uses its bucket. */
+export interface PersistedBucket<T extends object> {
+    /** The versioned key the bucket occupies, e.g. `smiles:exercises:v1`. */
+    readonly storageKey: string;
+    /** What was stored, merged over the defaults. */
+    read: () => BucketRead<T>;
+    /** Store the bucket as it now stands, replacing what was there. */
+    write: (value: T) => void;
+    /** Forget the bucket, leaving whatever the page holds in memory untouched. */
+    clear: () => void;
+}
+/** What one read of a bucket found. */
+export interface BucketRead<T> {
+    /** The stored payload merged over the defaults, ready to be used as is. */
+    value: T;
+    /**
+     * True when nothing usable was there: no entry, an unreadable store, or a
+     * payload that is not an object. It tells a first visit from a visitor who
+     * chose exactly the defaults, which is what decides whether a page opens on
+     * its welcome state or writes the bucket straight back.
+     */
+    firstRun: boolean;
+}
+//# sourceMappingURL=persistBucket.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistBucket.d.ts","sourceRoot":"","sources":["../../../src/state/ui/persistBucket.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,eAAe,CAAC,CAAC,CAAC,CAwBpB;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM;IACpD;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC;IACZ;;;;;OAKG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM;IAC/C,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,IAAI,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1B,mEAAmE;IACnE,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,2EAA2E;IAC3E,KAAK,EAAE,CAAC,CAAC;IACT;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB"}

package/lib/state/ui/persistBucket.js

@@ -0,0 +1,90 @@
+import { isPlainRecord, mergeStored } from "./mergeStored.js";
+/**
+ * A bucket of preferences kept in `localStorage` under one versioned key.
+ *
+ * Everything here is best effort. In a page framed by a course, third-party
+ * storage is partitioned in Chrome and blocked in Safari, so a read may find
+ * nothing, a write may be refused, and touching the store may throw before it
+ * is even reached — none of which may ever reach the interface. A visitor whose
+ * quota is full still gets a working site, with their preferences lasting only
+ * as long as the tab.
+ * @param options - See {@link PersistBucketOptions}.
+ * @returns The three ways to use the bucket: read it, write it, forget it.
+ */
+export function persistBucket(options) {
+    const { key, version = 1, defaults, onQuotaExceeded } = options;
+    const storageKey = `${key}:v${version}`;
+    return {
+        storageKey,
+        read: () => {
+            const stored = readEntry(storageKey);
+            return {
+                value: mergeStored(defaults, stored),
+                firstRun: stored === undefined,
+            };
+        },
+        write: (value) => {
+            writeEntry(storageKey, value, onQuotaExceeded);
+        },
+        clear: () => {
+            try {
+                globalThis.localStorage?.removeItem(storageKey);
+            }
+            catch {
+                // An unavailable store has nothing to forget.
+            }
+        },
+    };
+}
+function readEntry(storageKey) {
+    let raw;
+    try {
+        raw = globalThis.localStorage?.getItem(storageKey) ?? null;
+    }
+    catch {
+        return undefined;
+    }
+    if (raw === null)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        return isPlainRecord(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeEntry(storageKey, value, onQuotaExceeded) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        // A value that cannot be serialised is a bug in the caller, never a reason
+        // to take the page down with it.
+        return;
+    }
+    try {
+        globalThis.localStorage?.setItem(storageKey, serialized);
+    }
+    catch (error) {
+        if (!isQuotaExceeded(error) || onQuotaExceeded === undefined)
+            return;
+        try {
+            onQuotaExceeded(error);
+        }
+        catch {
+            // A callback that throws must not turn a lost preference into a crash.
+        }
+    }
+}
+function isQuotaExceeded(error) {
+    if (typeof error !== 'object' || error === null)
+        return false;
+    const { name, code } = error;
+    return (name === 'QuotaExceededError' ||
+        name === 'NS_ERROR_DOM_QUOTA_REACHED' ||
+        code === 22 ||
+        code === 1014);
+}
+//# sourceMappingURL=persistBucket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistBucket.js","sourceRoot":"","sources":["../../../src/state/ui/persistBucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAgC;IAEhC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAChE,MAAM,UAAU,GAAG,GAAG,GAAG,KAAK,OAAO,EAAE,CAAC;IAExC,OAAO;QACL,UAAU;QACV,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO;gBACL,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACpC,QAAQ,EAAE,MAAM,KAAK,SAAS;aAC/B,CAAC;QACJ,CAAC;QACD,KAAK,EAAE,CAAC,KAAQ,EAAE,EAAE;YAClB,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,CAAC;gBACH,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAwDD,SAAS,SAAS,CAAC,UAAkB;IACnC,IAAI,GAAkB,CAAC;IACvB,IAAI,CAAC;QACH,GAAG,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CACjB,UAAkB,EAClB,KAAc,EACd,eAAuD;IAEvD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,iCAAiC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO;QACrE,IAAI,CAAC;YACH,eAAe,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;QACzE,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAA2C,CAAC;IACnE,OAAO,CACL,IAAI,KAAK,oBAAoB;QAC7B,IAAI,KAAK,4BAA4B;QACrC,IAAI,KAAK,EAAE;QACX,IAAI,KAAK,IAAI,CACd,CAAC;AACJ,CAAC"}

package/lib/structure/core/editorValue.d.ts

@@ -0,0 +1,69 @@
+/** One structure of an editor's value, with whatever was written next to it. */
+export interface EditorLine {
+    /**
+     * The structure. On a line-oriented value this is the first blank-separated
+     * token, because a line notation never holds a blank; on a molfile it is the
+     * whole file.
+     */
+    structure: string;
+    /**
+     * What followed the structure on its line, which a Daylight `.smi` file uses
+     * as a name. Empty when nothing did.
+     */
+    label: string;
+    /** 1-based line the structure starts on, so an error can point back at it. */
+    line: number;
+}
+/** An editor's value, classified and cut into the structures it holds. */
+export interface EditorValue {
+    /** How the value is written; `empty` when it holds no structure at all. */
+    kind: 'molfile' | 'smiles' | 'empty';
+    /**
+     * The molfile, exactly as it arrived, when `kind` is `molfile`. Empty
+     * otherwise — a molfile's fixed-width header does not survive being trimmed.
+     */
+    molfile: string;
+    /**
+     * Every structure the value holds, in order: one per meaningful line for a
+     * line-oriented value, a single entry for a molfile, none for an empty one.
+     */
+    entries: EditorLine[];
+}
+/**
+ * Take an editor's value apart.
+ *
+ * A structure box is handed whatever the chemist had: one molfile pasted out
+ * of another tool, or a run of line notations one per line, possibly with a
+ * name after each and with blank and `#` comment lines in between. Both are
+ * read here so a page can take either without asking which it was given.
+ * @param text - The editor's value, as typed, pasted or dropped.
+ * @returns The notation, the molfile when it is one, and the structures.
+ */
+export declare function splitEditorValue(text: string): EditorValue;
+/** An idCode and, when the writer emitted one, the atom layout beside it. */
+export interface IdCodeValue {
+    idCode: string;
+    /** Absent when the value carried no coordinates. */
+    coordinates?: string;
+}
+/**
+ * Take an idCode apart.
+ *
+ * A drawing editor appends the atom coordinates after a space, which
+ * `Molecule.fromIDCode` takes as a second argument rather than as part of the
+ * first, and which two drawings of the same structure differ by.
+ * @param value - The editor value, coordinates included or not.
+ * @returns The idCode and the coordinates, the idCode empty for a blank value.
+ */
+export declare function splitIdCode(value: string): IdCodeValue;
+/**
+ * Whether an idCode describes nothing.
+ *
+ * Erasing a canvas does not leave the editor with an empty string: it leaves
+ * the idCode of the empty molecule, or of the empty fragment in query mode.
+ * Treating either as a structure keeps a filter alive with nothing drawn.
+ * @param value - The editor value, coordinates included or not.
+ * @returns True when there is nothing on the canvas.
+ */
+export declare function isEmptyIdCode(value: string): boolean;
+//# sourceMappingURL=editorValue.d.ts.map

package/lib/structure/core/editorValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorValue.d.ts","sourceRoot":"","sources":["../../../src/structure/core/editorValue.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAa1D;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAGtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/lib/structure/core/editorValue.js

@@ -0,0 +1,72 @@
+import { looksLikeMolfile } from "./molfile.js";
+/**
+ * Take an editor's value apart.
+ *
+ * A structure box is handed whatever the chemist had: one molfile pasted out
+ * of another tool, or a run of line notations one per line, possibly with a
+ * name after each and with blank and `#` comment lines in between. Both are
+ * read here so a page can take either without asking which it was given.
+ * @param text - The editor's value, as typed, pasted or dropped.
+ * @returns The notation, the molfile when it is one, and the structures.
+ */
+export function splitEditorValue(text) {
+    if (text.trim() === '')
+        return { kind: 'empty', molfile: '', entries: [] };
+    if (looksLikeMolfile(text)) {
+        return {
+            kind: 'molfile',
+            molfile: text,
+            entries: [{ structure: text, label: '', line: 1 }],
+        };
+    }
+    const entries = splitLines(text);
+    return entries.length === 0
+        ? { kind: 'empty', molfile: '', entries: [] }
+        : { kind: 'smiles', molfile: '', entries };
+}
+/**
+ * Take an idCode apart.
+ *
+ * A drawing editor appends the atom coordinates after a space, which
+ * `Molecule.fromIDCode` takes as a second argument rather than as part of the
+ * first, and which two drawings of the same structure differ by.
+ * @param value - The editor value, coordinates included or not.
+ * @returns The idCode and the coordinates, the idCode empty for a blank value.
+ */
+export function splitIdCode(value) {
+    const [idCode = '', coordinates] = value.trim().split(' ');
+    return coordinates === undefined ? { idCode } : { idCode, coordinates };
+}
+/**
+ * Whether an idCode describes nothing.
+ *
+ * Erasing a canvas does not leave the editor with an empty string: it leaves
+ * the idCode of the empty molecule, or of the empty fragment in query mode.
+ * Treating either as a structure keeps a filter alive with nothing drawn.
+ * @param value - The editor value, coordinates included or not.
+ * @returns True when there is nothing on the canvas.
+ */
+export function isEmptyIdCode(value) {
+    return EMPTY_ID_CODES.has(splitIdCode(value).idCode);
+}
+/** What openchemlib writes for a structure with no atoms: molecule, fragment. */
+const EMPTY_ID_CODES = new Set(['', 'd@', 'dH']);
+function splitLines(text) {
+    const entries = [];
+    const lines = text.split('\n');
+    for (let index = 0; index < lines.length; index++) {
+        const line = (lines[index] ?? '').trim();
+        if (line === '' || line.startsWith('#'))
+            continue;
+        const blank = line.search(/\s/);
+        entries.push(blank === -1
+            ? { structure: line, label: '', line: index + 1 }
+            : {
+                structure: line.slice(0, blank),
+                label: line.slice(blank).trim(),
+                line: index + 1,
+            });
+    }
+    return entries;
+}
+//# sourceMappingURL=editorValue.js.map