react-cheminfo 0.11.0 → 0.13.0

package/lib/spectra/ui/fieldStyles.js

@@ -0,0 +1,61 @@
+/*
+ * The field vocabulary every spectra panel is drawn with. Every colour and
+ * radius is a reference to the family's tokens with no literal after it:
+ * `chrome.css` is required on every page, and a fallback typed here would only
+ * drift from the value it copies.
+ */
+/** The small name above a control. */
+export const LABEL_STYLE = {
+    fontSize: 11,
+    fontWeight: 600,
+    color: 'var(--text-muted)',
+};
+/** The one line under a control or a list saying what it changes. */
+export const HELP_STYLE = {
+    fontSize: 11,
+    color: 'var(--text-faint)',
+};
+/** What a list says when it holds nothing. */
+export const EMPTY_STYLE = {
+    fontSize: 12,
+    color: 'var(--text-faint)',
+};
+/** A Blueprint switch or checkbox set in the panel's own type size. */
+export const SWITCH_STYLE = {
+    margin: 0,
+    fontSize: 12,
+};
+/** A label stacked over its control. */
+export const FIELD_STYLE = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 2,
+};
+/** Rows stacked one under the other. */
+export const LIST_STYLE = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 6,
+};
+/** Fields side by side, wrapping, their boxes lined up along the bottom. */
+export const ROW_STYLE = {
+    display: 'flex',
+    flexWrap: 'wrap',
+    alignItems: 'flex-end',
+    gap: 8,
+};
+/** A box that holds code rather than prose: a formula, an expression. */
+export const MONOSPACE_STYLE = {
+    fontFamily: 'var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)',
+};
+/**
+ * A stacked field that shares a row with others, never narrower than it can be
+ * read at.
+ * @param width - The narrowest it may get, in pixels.
+ * @param grow - How much of the spare room it takes against its neighbours.
+ * @returns The style.
+ */
+export function sizedFieldStyle(width, grow = 1) {
+    return { ...FIELD_STYLE, minWidth: width, flex: `${grow} 1 ${width}px` };
+}
+//# sourceMappingURL=fieldStyles.js.map

package/lib/spectra/ui/fieldStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldStyles.js","sourceRoot":"","sources":["../../../src/spectra/ui/fieldStyles.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,mBAAmB;CACM,CAAC;AAEnC,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,mBAAmB;CACM,CAAC;AAEnC,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,mBAAmB;CACM,CAAC;AAEnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,EAAE;CACoB,CAAC;AAEnC,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,CAAC;CAC0B,CAAC;AAEnC,wCAAwC;AACxC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,CAAC;CAC0B,CAAC;AAEnC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,UAAU;IACtB,GAAG,EAAE,CAAC;CAC0B,CAAC;AAEnC,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EACR,kEAAkE;CACpC,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC;IACrD,OAAO,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;AAC3E,CAAC"}

package/lib/spectra/ui/problemsAbout.d.ts

@@ -1,14 +1,14 @@
-import type { SettingsProblem } from '../core/problems.ts';
+import type { ProblemPart, SettingsProblem } from '../core/problems.ts';
 /**
- * The problems whose `where` is, or starts with, one of the given words.
+ * The problems about one part of the settings.
  *
- * The `where` strings are what `settingsProblems` writes, so a part of the
- * panel asks for its own by naming the same words it is headed with — which
- * keeps a problem next to the field that causes it rather than in one list at
- * the top, far from anything the reader can act on.
+ * A part of the panel asks for its own by the `part` every problem carries and
+ * never by the `where` it is labelled with, so rewording a label cannot move a
+ * problem away from the field that causes it — which is what keeps a problem
+ * next to that field rather than in one list at the top.
  * @param problems - Every problem the settings have.
- * @param prefixes - The `where` strings the part answers for.
+ * @param part - The part the panel answers for.
  * @returns Only those problems, in the order they were found.
  */
-export declare function problemsAbout(problems: readonly SettingsProblem[], ...prefixes: readonly string[]): SettingsProblem[];
+export declare function problemsAbout(problems: readonly SettingsProblem[], part: ProblemPart): SettingsProblem[];
 //# sourceMappingURL=problemsAbout.d.ts.map

package/lib/spectra/ui/problemsAbout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"problemsAbout.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC7B,eAAe,EAAE,CAInB"}
+{"version":3,"file":"problemsAbout.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,IAAI,EAAE,WAAW,GAChB,eAAe,EAAE,CAEnB"}

package/lib/spectra/ui/problemsAbout.js

@@ -1,15 +1,15 @@
 /**
- * The problems whose `where` is, or starts with, one of the given words.
+ * The problems about one part of the settings.
  *
- * The `where` strings are what `settingsProblems` writes, so a part of the
- * panel asks for its own by naming the same words it is headed with — which
- * keeps a problem next to the field that causes it rather than in one list at
- * the top, far from anything the reader can act on.
+ * A part of the panel asks for its own by the `part` every problem carries and
+ * never by the `where` it is labelled with, so rewording a label cannot move a
+ * problem away from the field that causes it — which is what keeps a problem
+ * next to that field rather than in one list at the top.
  * @param problems - Every problem the settings have.
- * @param prefixes - The `where` strings the part answers for.
+ * @param part - The part the panel answers for.
  * @returns Only those problems, in the order they were found.
  */
-export function problemsAbout(problems, ...prefixes) {
-    return problems.filter((entry) => prefixes.some((prefix) => entry.where.startsWith(prefix)));
+export function problemsAbout(problems, part) {
+    return problems.filter((entry) => entry.part === part);
 }
 //# sourceMappingURL=problemsAbout.js.map

package/lib/spectra/ui/problemsAbout.js.map

@@ -1 +1 @@
-{"version":3,"file":"problemsAbout.js","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAoC,EACpC,GAAG,QAA2B;IAE9B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"problemsAbout.js","sourceRoot":"","sources":["../../../src/spectra/ui/problemsAbout.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAoC,EACpC,IAAiB;IAEjB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/lib/spectra/ui/rowKeys.d.ts

@@ -1,10 +1,31 @@
+/** The keys of a list of rows, and the edits that keep them in step with it. */
+interface RowKeys {
+    /** One key per row, in the order the rows are drawn. */
+    keys: readonly number[];
+    /** Call when a row is added at the end of the list. */
+    append: () => void;
+    /** Call when a row is inserted just after the one at `index`. */
+    insertAfter: (index: number) => void;
+    /** Call when the row at `index` is removed. */
+    removeAt: (index: number) => void;
+    /** Call when the row at `index` moves to `target`. */
+    move: (index: number, target: number) => void;
+}
 /**
- * A key no row is using yet.
+ * A key for every row of a list whose entries carry no identity of their own.
  *
  * A row of the settings — a zone, a matrix step, a range — carries no identity
  * of its own, so one is kept beside the list. Without it React reuses a removed
  * row's box for the row that slides up, and the half-typed number in it goes
- * with the wrong entry.
+ * with the wrong entry. Call the matching edit together with every change the
+ * list makes itself; a change from elsewhere — a preset, a reset — is caught up
+ * with on the next render by trimming or extending the keys.
+ * @param length - How many rows the list has now.
+ * @returns The keys and their edits. See {@link RowKeys}.
+ */
+export declare function useRowKeys(length: number): RowKeys;
+/**
+ * A key no row is using yet.
  * @param keys - The keys in force.
  * @returns The next free one.
  */
@@ -16,12 +37,5 @@ export declare function nextKey(keys: readonly number[]): number;
  * @returns One key per row.
  */
 export declare function fitKeys(keys: readonly number[], length: number): number[];
-/**
- * A list with one entry moved to another position.
- * @param list - What to reorder.
- * @param index - Which entry to move.
- * @param target - Where it lands.
- * @returns A new list.
- */
-export declare function reorder<T>(list: readonly T[], index: number, target: number): T[];
+export {};
 //# sourceMappingURL=rowKeys.d.ts.map

package/lib/spectra/ui/rowKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rowKeys.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,CAAC,EAAE,CAKL"}
+{"version":3,"file":"rowKeys.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAIA,gFAAgF;AAChF,UAAU,OAAO;IACf,wDAAwD;IACxD,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,uDAAuD;IACvD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,iEAAiE;IACjE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,sDAAsD;IACtD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAsBlD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMvD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzE"}

package/lib/spectra/ui/rowKeys.js

@@ -1,10 +1,40 @@
+import { useState } from 'react';
+import { reorder } from "../core/filterChain.js";
 /**
- * A key no row is using yet.
+ * A key for every row of a list whose entries carry no identity of their own.
  *
  * A row of the settings — a zone, a matrix step, a range — carries no identity
  * of its own, so one is kept beside the list. Without it React reuses a removed
  * row's box for the row that slides up, and the half-typed number in it goes
- * with the wrong entry.
+ * with the wrong entry. Call the matching edit together with every change the
+ * list makes itself; a change from elsewhere — a preset, a reset — is caught up
+ * with on the next render by trimming or extending the keys.
+ * @param length - How many rows the list has now.
+ * @returns The keys and their edits. See {@link RowKeys}.
+ */
+export function useRowKeys(length) {
+    const [keys, setKeys] = useState(() => fitKeys([], length));
+    const current = keys.length === length ? keys : fitKeys(keys, length);
+    if (current !== keys)
+        setKeys(current);
+    return {
+        keys: current,
+        append: () => {
+            setKeys([...current, nextKey(current)]);
+        },
+        insertAfter: (index) => {
+            setKeys(current.toSpliced(index + 1, 0, nextKey(current)));
+        },
+        removeAt: (index) => {
+            setKeys(current.toSpliced(index, 1));
+        },
+        move: (index, target) => {
+            setKeys(reorder(current, index, target));
+        },
+    };
+}
+/**
+ * A key no row is using yet.
  * @param keys - The keys in force.
  * @returns The next free one.
  */
@@ -28,18 +58,4 @@ export function fitKeys(keys, length) {
         fitted.push(nextKey(fitted));
     return fitted;
 }
-/**
- * A list with one entry moved to another position.
- * @param list - What to reorder.
- * @param index - Which entry to move.
- * @param target - Where it lands.
- * @returns A new list.
- */
-export function reorder(list, index, target) {
-    const moved = [...list];
-    const [entry] = moved.splice(index, 1);
-    if (entry !== undefined)
-        moved.splice(target, 0, entry);
-    return moved;
-}
 //# sourceMappingURL=rowKeys.js.map

package/lib/spectra/ui/rowKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"rowKeys.js","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB;IAC7C,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,OAAO;YAAE,OAAO,GAAG,GAAG,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,IAAkB,EAClB,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"rowKeys.js","sourceRoot":"","sources":["../../../src/spectra/ui/rowKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAoB,GAAG,EAAE,CACvD,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CACpB,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,GAAG,EAAE;YACX,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE;YACrB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACtB,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB;IAC7C,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,OAAO;YAAE,OAAO,GAAG,GAAG,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAuB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/spectra/ui/scaleOptions.d.ts

@@ -1,6 +1,11 @@
 import type { ScaleSettings } from '../core/settings.ts';
 /** The stretch of x a scaling is measured over. */
 export type ScaleRange = NonNullable<ScaleSettings['range']>;
+/**
+ * How the processor resolves a window given both ways, said once for the
+ * scaling and for the ranges, which resolve theirs with the same call.
+ */
+export declare const POINT_NUMBER_WINS = "A point number silently wins over an x value: with From point set, From is never read.";
 /** The method menu: leaving the spectra alone, then the only four that run. */
 export declare const SCALE_METHOD_OPTIONS: ReadonlyArray<{
     value: string;

package/lib/spectra/ui/scaleOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaleOptions.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/scaleOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAU7D,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,aAAa,CAYf"}
+{"version":3,"file":"scaleOptions.d.ts","sourceRoot":"","sources":["../../../src/spectra/ui/scaleOptions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2FAC4D,CAAC;AAE3F,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,GACb,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,GACf,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,aAAa,CAYf"}

package/lib/spectra/ui/scaleOptions.js

@@ -1,17 +1,15 @@
-import { SCALE_METHODS } from "../core/settingsProblems.js";
-/** What each scaling is called, in the order the processor's switch lists them. */
-const METHOD_LABELS = {
-    min: 'Smallest value',
-    max: 'Largest value',
-    minmax: 'Both ends',
-    integration: 'Integral',
-};
+import { SCALE_METHODS, SCALE_METHOD_LABELS, isScaleMethod, } from "../core/matrixCatalog.js";
+/**
+ * How the processor resolves a window given both ways, said once for the
+ * scaling and for the ranges, which resolve theirs with the same call.
+ */
+export const POINT_NUMBER_WINS = 'A point number silently wins over an x value: with From point set, From is never read.';
 /** The method menu: leaving the spectra alone, then the only four that run. */
 export const SCALE_METHOD_OPTIONS = [
     { value: '', label: 'None — every spectrum is left as it is' },
     ...SCALE_METHODS.map((method) => ({
         value: method,
-        label: METHOD_LABELS[method] ?? method,
+        label: SCALE_METHOD_LABELS[method],
     })),
 ];
 /**
@@ -33,7 +31,10 @@ export function scaleMethodOptions(method) {
         if (option.value === method)
             return SCALE_METHOD_OPTIONS;
     }
-    const known = METHOD_LABELS[method.toLowerCase()];
+    const lowered = method.toLowerCase();
+    const known = isScaleMethod(lowered)
+        ? SCALE_METHOD_LABELS[lowered]
+        : undefined;
     return [
         ...SCALE_METHOD_OPTIONS,
         {

package/lib/spectra/ui/scaleOptions.js.map

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

package/lib/spectra.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The editor for `spectra-processor` settings and the principal-component
+ * picker that goes with it.
+ *
+ * An entry point of its own, and not part of `react-cheminfo/core` or
+ * `react-cheminfo/ui`, because its types are read off three optional peers —
+ * `spectra-processor`, `ml-signal-processing` and `ml-pca` — that a site with
+ * no spectra to process never installs. The vocabulary and the checks need
+ * no React and are exported beside the components.
+ */
+export * from './spectra/core/index.ts';
+export * from './spectra/ui/index.ts';
+//# sourceMappingURL=spectra.d.ts.map

package/lib/spectra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectra.d.ts","sourceRoot":"","sources":["../src/spectra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

package/lib/spectra.js

@@ -0,0 +1,13 @@
+/**
+ * The editor for `spectra-processor` settings and the principal-component
+ * picker that goes with it.
+ *
+ * An entry point of its own, and not part of `react-cheminfo/core` or
+ * `react-cheminfo/ui`, because its types are read off three optional peers —
+ * `spectra-processor`, `ml-signal-processing` and `ml-pca` — that a site with
+ * no spectra to process never installs. The vocabulary and the checks need
+ * no React and are exported beside the components.
+ */
+export * from "./spectra/core/index.js";
+export * from "./spectra/ui/index.js";
+//# sourceMappingURL=spectra.js.map

package/lib/spectra.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spectra.js","sourceRoot":"","sources":["../src/spectra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC"}

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

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

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

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

package/lib/state/core/index.js

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"mergeStored.d.ts","sourceRoot":"","sources":["../../../src/state/core/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/core/mergeStored.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistBucket.d.ts","sourceRoot":"","sources":["../../../src/state/core/persistBucket.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,eAAe,CAAC,CAAC,CAAC,CAqBpB;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/core/persistBucket.js

@@ -0,0 +1,36 @@
+import { isPlainRecord, mergeStored } from "./mergeStored.js";
+import { readStorageEntry, removeStorageEntry, versionedStorageKey, writeStorageEntry, } from "./storageEntry.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 = versionedStorageKey(key, version);
+    return {
+        storageKey,
+        read: () => {
+            const stored = readStorageEntry(storageKey);
+            const usable = isPlainRecord(stored) ? stored : undefined;
+            return {
+                value: mergeStored(defaults, usable),
+                firstRun: usable === undefined,
+            };
+        },
+        write: (value) => {
+            writeStorageEntry(storageKey, value, onQuotaExceeded);
+        },
+        clear: () => {
+            removeStorageEntry(storageKey);
+        },
+    };
+}
+//# sourceMappingURL=persistBucket.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistBucket.js","sourceRoot":"","sources":["../../../src/state/core/persistBucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;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,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAErD,OAAO;QACL,UAAU;QACV,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,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,iBAAiB,CAAC,UAAU,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/state/core/persistSignalBucket.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Keep a tree of signals in `localStorage`, under one versioned key.
+ *
+ * A bucket is a plain object whose leaves are writable signals, grouped in
+ * plain objects as deeply as needed. The whole tree is stored as one JSON
+ * mirror of itself, so the stability contract is the property names, never a
+ * key per signal. On the way in, the stored payload is merged over the bucket
+ * as it was declared ({@link persistBucket}), so a leaf added since the last
+ * save keeps its default and a stored value of the wrong shape is discarded.
+ * On the way out, `effect` re-runs whenever a leaf changes and the whole tree
+ * is written again; its first run only subscribes, so opening a page never
+ * writes the defaults back.
+ *
+ * The leaves are recognised by their shape (`value`, `peek` and `subscribe`),
+ * so any `@preact/signals` flavour works, and `effect` is the page's own, so
+ * the tracking is always done by the copy of the library that made the
+ * signals. A member that is neither a signal nor a plain object is ignored.
+ * Never put a `computed()` in a bucket: it cannot be written back.
+ * @param options - See {@link PersistSignalBucketOptions}.
+ * @returns The same bucket, rehydrated, so it can be exported directly.
+ */
+export declare function persistSignalBucket<TBucket extends object>(options: PersistSignalBucketOptions<TBucket>): TBucket;
+/**
+ * Runs a callback now and again whenever a signal it read changes, as
+ * `effect` from `@preact/signals-react` does.
+ */
+export type SignalEffect = (callback: () => void) => unknown;
+/** What {@link persistSignalBucket} is given. */
+export interface PersistSignalBucketOptions<TBucket extends object> {
+    /**
+     * Name of the bucket, namespaced by the site and without its version, e.g.
+     * `vcl:preferences`.
+     */
+    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.
+     * @default 1
+     */
+    version?: number;
+    /** The tree of signals, rehydrated in place and followed from then on. */
+    bucket: TBucket;
+    /** The page's own `effect`, imported from its signals package. */
+    effect: SignalEffect;
+    /**
+     * Called when a write was refused because the store is full.
+     * @default undefined
+     */
+    onQuotaExceeded?: (error: unknown) => void;
+}
+//# sourceMappingURL=persistSignalBucket.d.ts.map

package/lib/state/core/persistSignalBucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistSignalBucket.d.ts","sourceRoot":"","sources":["../../../src/state/core/persistSignalBucket.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,MAAM,EACxD,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC,GAC3C,OAAO,CAuBT;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;AAE7D,iDAAiD;AACjD,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,MAAM;IAChE;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C"}

package/lib/state/core/persistSignalBucket.js

@@ -0,0 +1,79 @@
+import { isPlainRecord } from "./mergeStored.js";
+import { persistBucket } from "./persistBucket.js";
+/**
+ * Keep a tree of signals in `localStorage`, under one versioned key.
+ *
+ * A bucket is a plain object whose leaves are writable signals, grouped in
+ * plain objects as deeply as needed. The whole tree is stored as one JSON
+ * mirror of itself, so the stability contract is the property names, never a
+ * key per signal. On the way in, the stored payload is merged over the bucket
+ * as it was declared ({@link persistBucket}), so a leaf added since the last
+ * save keeps its default and a stored value of the wrong shape is discarded.
+ * On the way out, `effect` re-runs whenever a leaf changes and the whole tree
+ * is written again; its first run only subscribes, so opening a page never
+ * writes the defaults back.
+ *
+ * The leaves are recognised by their shape (`value`, `peek` and `subscribe`),
+ * so any `@preact/signals` flavour works, and `effect` is the page's own, so
+ * the tracking is always done by the copy of the library that made the
+ * signals. A member that is neither a signal nor a plain object is ignored.
+ * Never put a `computed()` in a bucket: it cannot be written back.
+ * @param options - See {@link PersistSignalBucketOptions}.
+ * @returns The same bucket, rehydrated, so it can be exported directly.
+ */
+export function persistSignalBucket(options) {
+    const { key, version, bucket, effect, onQuotaExceeded } = options;
+    const stored = persistBucket({
+        key,
+        version,
+        defaults: snapshotBucket(bucket),
+        onQuotaExceeded,
+    });
+    const { value, firstRun } = stored.read();
+    if (!firstRun)
+        hydrateBucket(bucket, value);
+    let subscribed = false;
+    effect(() => {
+        const snapshot = snapshotBucket(bucket);
+        if (!subscribed) {
+            subscribed = true;
+            return;
+        }
+        stored.write(snapshot);
+    });
+    return bucket;
+}
+function snapshotBucket(node) {
+    const snapshot = {};
+    for (const [name, member] of Object.entries(node)) {
+        if (isSignalLeaf(member)) {
+            snapshot[name] = member.value;
+        }
+        else if (isPlainRecord(member)) {
+            snapshot[name] = snapshotBucket(member);
+        }
+    }
+    return snapshot;
+}
+function hydrateBucket(node, stored) {
+    for (const [name, member] of Object.entries(node)) {
+        const value = stored[name];
+        if (value === undefined)
+            continue;
+        if (isSignalLeaf(member)) {
+            member.value = value;
+        }
+        else if (isPlainRecord(member) && isPlainRecord(value)) {
+            hydrateBucket(member, value);
+        }
+    }
+}
+function isSignalLeaf(member) {
+    if (typeof member !== 'object' || member === null)
+        return false;
+    const candidate = member;
+    return ('value' in member &&
+        typeof candidate.peek === 'function' &&
+        typeof candidate.subscribe === 'function');
+}
+//# sourceMappingURL=persistSignalBucket.js.map

package/lib/state/core/persistSignalBucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistSignalBucket.js","sourceRoot":"","sources":["../../../src/state/core/persistSignalBucket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA4C;IAE5C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAClE,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,GAAG;QACH,OAAO;QACP,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC;QAChC,eAAe;KAChB,CAAC,CAAC;IAEH,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5C,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE;QACV,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,UAAU,GAAG,IAAI,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAoCD,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAChC,CAAC;aAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,MAA+B;IAClE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,CAAC;aAAM,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,SAAS,GAAG,MAAiD,CAAC;IACpE,OAAO,CACL,OAAO,IAAI,MAAM;QACjB,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU;QACpC,OAAO,SAAS,CAAC,SAAS,KAAK,UAAU,CAC1C,CAAC;AACJ,CAAC"}

package/lib/state/core/storageEntry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The storage key an entry occupies once its schema version is appended.
+ * @param key - Name of the entry, namespaced by the site, e.g. `smiles:exercises`.
+ * @param version - Schema version of what is stored under it.
+ * @returns The versioned key, e.g. `smiles:exercises:v1`.
+ */
+export declare function versionedStorageKey(key: string, version: number): string;
+/**
+ * Read one `localStorage` entry back as JSON.
+ *
+ * A page framed by a course may have no storage at all — third-party storage
+ * is partitioned in Chrome and blocked in Safari — so touching the store may
+ * throw before it is even reached. Nothing of that reaches the caller: an
+ * unreadable store, a missing entry and corrupt JSON all read as nothing.
+ * @param storageKey - The full key, version included.
+ * @returns What was parsed, or `undefined` when there is nothing readable.
+ */
+export declare function readStorageEntry(storageKey: string): unknown;
+/**
+ * Write one `localStorage` entry as JSON, replacing what was there.
+ *
+ * Best effort: a value that cannot be serialised, an unavailable store and a
+ * refused write are all swallowed. A write refused because the store is full
+ * is reported through `onQuotaExceeded`, so a page can tell its visitor that
+ * what they are doing is no longer being kept.
+ * @param storageKey - The full key, version included.
+ * @param value - What to store; it must be JSON serialisable.
+ * @param onQuotaExceeded - Called with the error when the store is full.
+ */
+export declare function writeStorageEntry(storageKey: string, value: unknown, onQuotaExceeded?: (error: unknown) => void): void;
+/**
+ * Forget one `localStorage` entry. An unavailable store has nothing to forget.
+ * @param storageKey - The full key, version included.
+ */
+export declare function removeStorageEntry(storageKey: string): void;
+//# sourceMappingURL=storageEntry.d.ts.map