react-cheminfo 0.11.0 → 0.13.0

package/lib/pedagogy/core/glossarySearch.d.ts

@@ -0,0 +1,23 @@
+import type { Glossary, GlossaryEntry, GlossaryExample } from './glossary.ts';
+/** One entry of a glossary, with the key it is stored under. */
+export interface GlossaryListing<TExample = GlossaryExample> {
+    /** The lowercased marker text the entry is keyed by. */
+    key: string;
+    /** The entry itself. */
+    entry: GlossaryEntry<TExample>;
+}
+/**
+ * Every entry of a glossary in alphabetical order of title, or only the ones
+ * a search names.
+ *
+ * A query matches, whatever its case, the key, the title, the summary, or any
+ * text an example carries — its code, its input and its note, or whichever
+ * text fields a tool's own example shape has. That is what a student types
+ * when they remember `c1ccccc1` but not that it was filed under `aromatic
+ * atom`.
+ * @param glossary - The terms the site defines.
+ * @param query - What the student typed; blank lists every entry.
+ * @returns The matching entries, sorted by title.
+ */
+export declare function listGlossary<TExample>(glossary: Glossary<TExample>, query?: string): Array<GlossaryListing<TExample>>;
+//# sourceMappingURL=glossarySearch.d.ts.map

package/lib/pedagogy/core/glossarySearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossarySearch.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/glossarySearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAE9E,gEAAgE;AAChE,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,eAAe;IACzD,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAC5B,KAAK,SAAK,GACT,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAWlC"}

package/lib/pedagogy/core/glossarySearch.js

@@ -0,0 +1,52 @@
+/**
+ * Every entry of a glossary in alphabetical order of title, or only the ones
+ * a search names.
+ *
+ * A query matches, whatever its case, the key, the title, the summary, or any
+ * text an example carries — its code, its input and its note, or whichever
+ * text fields a tool's own example shape has. That is what a student types
+ * when they remember `c1ccccc1` but not that it was filed under `aromatic
+ * atom`.
+ * @param glossary - The terms the site defines.
+ * @param query - What the student typed; blank lists every entry.
+ * @returns The matching entries, sorted by title.
+ */
+export function listGlossary(glossary, query = '') {
+    const needle = query.trim().toLowerCase();
+    const listings = [];
+    for (const [key, entry] of Object.entries(glossary)) {
+        if (needle === '' || entryMatches(key, entry, needle)) {
+            listings.push({ key, entry });
+        }
+    }
+    return listings.toSorted((first, second) => first.entry.title.localeCompare(second.entry.title, 'en'));
+}
+function entryMatches(key, entry, needle) {
+    if (key.includes(needle))
+        return true;
+    if (includesNeedle(entry.title, needle))
+        return true;
+    if (includesNeedle(entry.summary, needle))
+        return true;
+    for (const example of entry.examples) {
+        if (exampleMatches(example, needle))
+            return true;
+    }
+    return false;
+}
+function exampleMatches(example, needle) {
+    if (typeof example === 'string')
+        return includesNeedle(example, needle);
+    if (typeof example !== 'object' || example === null)
+        return false;
+    for (const value of Object.values(example)) {
+        if (typeof value === 'string' && includesNeedle(value, needle)) {
+            return true;
+        }
+    }
+    return false;
+}
+function includesNeedle(text, needle) {
+    return text.toLowerCase().includes(needle);
+}
+//# sourceMappingURL=glossarySearch.js.map

package/lib/pedagogy/core/glossarySearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossarySearch.js","sourceRoot":"","sources":["../../../src/pedagogy/core/glossarySearch.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA4B,EAC5B,KAAK,GAAG,EAAE;IAEV,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAqC,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,MAAM,KAAK,EAAE,IAAI,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CACzC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,GAAW,EACX,KAA6B,EAC7B,MAAc;IAEd,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,OAAgB,EAAE,MAAc;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,MAAc;IAClD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -1,7 +1,13 @@
 export type { Glossary, GlossaryEntry, GlossaryExample, GlossarySegment, } from './glossary.ts';
-export { parseGlossaryMarkers } from './glossary.ts';
+export { lookupGlossaryTerm, parseGlossaryMarkers } from './glossary.ts';
+export type { GlossaryListing } from './glossarySearch.ts';
+export { listGlossary } from './glossarySearch.ts';
+export type { InlineSegment, ParseInlineMarksOptions } from './inlineMarks.ts';
+export { parseInlineMarks } from './inlineMarks.ts';
+export type { BucketProgressStoreOptions, ProgressBucket, } from './bucketProgressStore.ts';
+export { bucketProgressStore } from './bucketProgressStore.ts';
 export type { ExerciseProgress, LocalStorageProgressStoreOptions, ProgressRecords, ProgressStore, ProgressSummary, } from './progress.ts';
-export { localStorageProgressStore, progressSummary } from './progress.ts';
+export { emptyProgress, localStorageProgressStore, mergeExerciseProgress, progressSummary, } from './progress.ts';
 export type { BaseExercise, ExerciseLevel, ExerciseSet, ExerciseStatus, TutorialStep, } from './types.ts';
 export type { FinishValidationOptions, TestCaseResult, ValidationResult, } from './validation.ts';
 export { failedValidation, finishValidation } from './validation.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,gCAAgC,EAChC,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EACV,0BAA0B,EAC1B,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,gBAAgB,EAChB,gCAAgC,EAChC,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/pedagogy/core/index.js

@@ -1,4 +1,7 @@
-export { parseGlossaryMarkers } from "./glossary.js";
-export { localStorageProgressStore, progressSummary } from "./progress.js";
+export { lookupGlossaryTerm, parseGlossaryMarkers } from "./glossary.js";
+export { listGlossary } from "./glossarySearch.js";
+export { parseInlineMarks } from "./inlineMarks.js";
+export { bucketProgressStore } from "./bucketProgressStore.js";
+export { emptyProgress, localStorageProgressStore, mergeExerciseProgress, progressSummary, } from "./progress.js";
 export { failedValidation, finishValidation } from "./validation.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAQrD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAa3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pedagogy/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAQ/D,OAAO,EACL,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,GAChB,MAAM,eAAe,CAAC;AAavB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/pedagogy/core/inlineMarks.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The light inline markup authored prose is written in: `` `code` ``,
+ * `**strong**` and `*emphasis*`, plus — for prose that links its jargon — the
+ * `[[term]]` markers of the glossary.
+ *
+ * One left-to-right pass, without a DOM. Whatever opens first is read whole
+ * before anything inside it is looked at, so `` `[*+]` `` and `` `*!@*` `` stay
+ * notation rather than opening an emphasis. An emphasis may neither open nor
+ * close on whitespace, which keeps a lone asterisk in `2 * 3` from pairing
+ * with one three sentences later.
+ */
+/**
+ * One piece of parsed prose.
+ *
+ * `start` is the offset of the piece in the source string, which makes it a
+ * stable and unique React key. A strong or emphasised run holds its own
+ * pieces, since a code span or a marker may sit inside it.
+ */
+export type InlineSegment = {
+    kind: 'text';
+    start: number;
+    text: string;
+} | {
+    kind: 'code';
+    start: number;
+    text: string;
+} | {
+    kind: 'term';
+    start: number;
+    term: string;
+    text: string;
+} | {
+    kind: 'strong' | 'emphasis';
+    start: number;
+    children: InlineSegment[];
+};
+/** What {@link parseInlineMarks} reads besides the three marks. */
+export interface ParseInlineMarksOptions {
+    /**
+     * Whether `[[term]]` and `[[term|displayed text]]` markers are read too, as
+     * `term` segments. Prose shown without a glossary leaves them as typed.
+     * @default false
+     */
+    glossaryMarkers?: boolean;
+}
+/**
+ * Split authored prose into runs of text, code spans, strong and emphasised
+ * runs, and — when asked — glossary markers.
+ *
+ * Anything that does not close is not markup and comes back verbatim inside a
+ * `text` segment: a lone backtick, `**bold` with no closing pair, `[[term`.
+ * @param text - Authored prose.
+ * @param options - Whether glossary markers are part of the language.
+ * @returns The segments, in order, with no empty run between two marks.
+ */
+export declare function parseInlineMarks(text: string, options?: ParseInlineMarksOptions): InlineSegment[];
+//# sourceMappingURL=inlineMarks.d.ts.map

package/lib/pedagogy/core/inlineMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inlineMarks.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/inlineMarks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAE9E,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,aAAa,EAAE,CAEjB"}

package/lib/pedagogy/core/inlineMarks.js

@@ -0,0 +1,78 @@
+/**
+ * The light inline markup authored prose is written in: `` `code` ``,
+ * `**strong**` and `*emphasis*`, plus — for prose that links its jargon — the
+ * `[[term]]` markers of the glossary.
+ *
+ * One left-to-right pass, without a DOM. Whatever opens first is read whole
+ * before anything inside it is looked at, so `` `[*+]` `` and `` `*!@*` `` stay
+ * notation rather than opening an emphasis. An emphasis may neither open nor
+ * close on whitespace, which keeps a lone asterisk in `2 * 3` from pairing
+ * with one three sentences later.
+ */
+import { GLOSSARY_MARKER_SOURCE, readMarker } from "./glossary.js";
+/**
+ * Split authored prose into runs of text, code spans, strong and emphasised
+ * runs, and — when asked — glossary markers.
+ *
+ * Anything that does not close is not markup and comes back verbatim inside a
+ * `text` segment: a lone backtick, `**bold` with no closing pair, `[[term`.
+ * @param text - Authored prose.
+ * @param options - Whether glossary markers are part of the language.
+ * @returns The segments, in order, with no empty run between two marks.
+ */
+export function parseInlineMarks(text, options = {}) {
+    return parseFrom(text, 0, options.glossaryMarkers === true);
+}
+const CODE_SOURCE = '`(?<code>[^`]+)`';
+const STRONG_SOURCE = String.raw `\*\*(?<strong>[^*]+)\*\*`;
+const EMPHASIS_SOURCE = String.raw `\*(?<emphasis>[^\s*](?:[^*]*[^\s*])?)\*`;
+const MARKS_SOURCE = [CODE_SOURCE, STRONG_SOURCE, EMPHASIS_SOURCE].join('|');
+const MARKS_AND_MARKERS_SOURCE = `${GLOSSARY_MARKER_SOURCE}|${MARKS_SOURCE}`;
+function parseFrom(text, offset, markers) {
+    const segments = [];
+    // A fresh regexp per call: a /g/ literal carries `lastIndex` between calls.
+    const pattern = new RegExp(markers ? MARKS_AND_MARKERS_SOURCE : MARKS_SOURCE, 'g');
+    let cursor = 0;
+    let match = pattern.exec(text);
+    while (match !== null) {
+        if (match.index > cursor) {
+            segments.push({
+                kind: 'text',
+                start: offset + cursor,
+                text: text.slice(cursor, match.index),
+            });
+        }
+        segments.push(toSegment(match, offset, markers));
+        cursor = match.index + match[0].length;
+        match = pattern.exec(text);
+    }
+    if (cursor < text.length) {
+        segments.push({
+            kind: 'text',
+            start: offset + cursor,
+            text: text.slice(cursor),
+        });
+    }
+    return segments;
+}
+function toSegment(match, offset, markers) {
+    const start = offset + match.index;
+    const { term, code, strong, emphasis } = match.groups ?? {};
+    if (term !== undefined)
+        return readMarker(term, start);
+    if (code !== undefined)
+        return { kind: 'code', start, text: code };
+    if (strong !== undefined) {
+        return {
+            kind: 'strong',
+            start,
+            children: parseFrom(strong, start + 2, markers),
+        };
+    }
+    return {
+        kind: 'emphasis',
+        start,
+        children: parseFrom(emphasis ?? '', start + 1, markers),
+    };
+}
+//# sourceMappingURL=inlineMarks.js.map

package/lib/pedagogy/core/inlineMarks.js.map

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

package/lib/pedagogy/core/progress.d.ts

@@ -8,6 +8,7 @@
 import type { ExerciseStatus } from './types.ts';
 /** What is remembered about one exercise. */
 export interface ExerciseProgress {
+    /** Where the student stands on it: untouched, handed in, or right. */
     status: ExerciseStatus;
     /** What the student last wrote or drew, exactly as they left it. */
     answer: string;
@@ -42,24 +43,15 @@ export interface ProgressStore<TProgress = ExerciseProgress> {
  */
 export declare function emptyProgress(): ExerciseProgress;
 /**
- * Read one stored record over its defaults, field by field.
+ * Read one stored {@link ExerciseProgress} into a record the page can trust.
  *
- * A stored field is taken only when it has the same shape as its default, so a
- * payload written by an older version of the page, or a corrupted one, falls
- * back field by field rather than wholesale — and a field added after the last
- * save simply keeps its default. A `null` default accepts anything.
+ * The record is merged over {@link emptyProgress} field by field, as a
+ * preferences bucket is, and its two constrained fields are checked rather
+ * than merely shape-matched: a status outside the three the page knows reads
+ * as `idle`, and a hint count that is negative, fractional or not finite reads
+ * as the whole hints it names, none when below one.
  * @param stored - Whatever came out of the store for this exercise.
- * @param defaults - The record a fresh exercise starts from.
- * @returns A complete record, with nothing unreadable carried over.
- */
-export declare function mergeProgressRecord<TProgress extends object>(stored: unknown, defaults: TProgress): TProgress;
-/**
- * Read one stored {@link ExerciseProgress}, with its two constrained fields
- * checked rather than merely shape-matched: a status outside the three the
- * page knows reads as `idle`, and a hint count that is negative or fractional
- * reads as none revealed.
- * @param stored - Whatever came out of the store for this exercise.
- * @returns A record the page can trust.
+ * @returns A complete record.
  */
 export declare function mergeExerciseProgress(stored: unknown): ExerciseProgress;
 /** What {@link localStorageProgressStore} is built from. */
@@ -74,8 +66,10 @@ export interface LocalStorageProgressStoreOptions<TProgress> {
     version?: number;
     /**
      * The record a fresh exercise starts from. When given, every stored record is
-     * read over it with {@link mergeProgressRecord}; when left out, a stored
-     * record is handed back as it was written.
+     * merged over it field by field, as a preferences bucket is: a missing field
+     * keeps its default, a field of the wrong shape is discarded, and a field the
+     * defaults do not name is kept. When left out, a stored record is handed back
+     * as it was written.
      * @default undefined
      */
     defaults?: TProgress;
@@ -84,6 +78,12 @@ export interface LocalStorageProgressStoreOptions<TProgress> {
      * @default 'this browser'
      */
     name?: string;
+    /**
+     * Called when a save was refused because the store is full, so the page can
+     * tell the student their work is no longer being kept.
+     * @default undefined
+     */
+    onQuotaExceeded?: (error: unknown) => void;
 }
 /**
  * Keep the work in `localStorage`, under one namespaced and versioned entry.

package/lib/pedagogy/core/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/progress.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,MAAM,eAAe,CAAC,SAAS,GAAG,gBAAgB,IAAI,MAAM,CAChE,MAAM,EACN,SAAS,CACV,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,SAAS,GAAG,gBAAgB;IACzD,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,eAAe,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,oDAAoD;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,SAAS,MAAM,EAC1D,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,GAClB,SAAS,CAUX;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAQvE;AAED,4DAA4D;AAC5D,MAAM,WAAW,gCAAgC,CAAC,SAAS;IACzD,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,SAAS,MAAM,EAChE,OAAO,EAAE,gCAAgC,CAAC,SAAS,CAAC,GACnD,aAAa,CAAC,SAAS,CAAC,CAsB1B;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,SAAS;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,EAC1E,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EACnC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GACtB,eAAe,CAWjB"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/progress.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,MAAM,eAAe,CAAC,SAAS,GAAG,gBAAgB,IAAI,MAAM,CAChE,MAAM,EACN,SAAS,CACV,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,SAAS,GAAG,gBAAgB;IACzD,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,eAAe,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,oDAAoD;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAWvE;AAQD,4DAA4D;AAC5D,MAAM,WAAW,gCAAgC,CAAC,SAAS;IACzD,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,SAAS,MAAM,EAChE,OAAO,EAAE,gCAAgC,CAAC,SAAS,CAAC,GACnD,aAAa,CAAC,SAAS,CAAC,CA4B1B;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,SAAS;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,EAC1E,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EACnC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GACtB,eAAe,CAWjB"}

package/lib/pedagogy/core/progress.js

@@ -5,7 +5,8 @@
  * service implements the same two calls and is plugged in instead, without
  * anything else in the page knowing where the work went.
  */
-import { readJsonEntry, writeJsonEntry } from "./jsonStorage.js";
+import { isPlainRecord, mergeStored } from "../../state/core/mergeStored.js";
+import { readStorageEntry, versionedStorageKey, writeStorageEntry, } from "../../state/core/storageEntry.js";
 /**
  * The record an exercise nobody has touched starts from.
  * @returns A blank record.
@@ -14,57 +15,45 @@ export function emptyProgress() {
     return { status: 'idle', answer: '', hintsRevealed: 0, showSolution: false };
 }
 /**
- * Read one stored record over its defaults, field by field.
+ * Read one stored {@link ExerciseProgress} into a record the page can trust.
  *
- * A stored field is taken only when it has the same shape as its default, so a
- * payload written by an older version of the page, or a corrupted one, falls
- * back field by field rather than wholesale — and a field added after the last
- * save simply keeps its default. A `null` default accepts anything.
+ * The record is merged over {@link emptyProgress} field by field, as a
+ * preferences bucket is, and its two constrained fields are checked rather
+ * than merely shape-matched: a status outside the three the page knows reads
+ * as `idle`, and a hint count that is negative, fractional or not finite reads
+ * as the whole hints it names, none when below one.
  * @param stored - Whatever came out of the store for this exercise.
- * @param defaults - The record a fresh exercise starts from.
- * @returns A complete record, with nothing unreadable carried over.
- */
-export function mergeProgressRecord(stored, defaults) {
-    const merged = { ...defaults };
-    if (!isPlainRecord(stored))
-        return merged;
-    for (const [field, fallback] of Object.entries(defaults)) {
-        const value = stored[field];
-        if (value !== undefined && isSameShape(fallback, value)) {
-            merged[field] = value;
-        }
-    }
-    return merged;
-}
-/**
- * Read one stored {@link ExerciseProgress}, with its two constrained fields
- * checked rather than merely shape-matched: a status outside the three the
- * page knows reads as `idle`, and a hint count that is negative or fractional
- * reads as none revealed.
- * @param stored - Whatever came out of the store for this exercise.
- * @returns A record the page can trust.
+ * @returns A complete record.
  */
 export function mergeExerciseProgress(stored) {
-    const merged = mergeProgressRecord(stored, emptyProgress());
+    const merged = mergeStored(emptyProgress(), stored);
+    const { status, hintsRevealed } = merged;
     return {
         ...merged,
-        status: STATUSES.has(merged.status) ? merged.status : 'idle',
-        hintsRevealed: merged.hintsRevealed > 0 ? Math.floor(merged.hintsRevealed) : 0,
+        status: EXERCISE_STATUSES.has(status) ? status : 'idle',
+        hintsRevealed: Number.isFinite(hintsRevealed) && hintsRevealed >= 1
+            ? Math.floor(hintsRevealed)
+            : 0,
     };
 }
+const EXERCISE_STATUSES = new Set([
+    'idle',
+    'attempted',
+    'solved',
+]);
 /**
  * Keep the work in `localStorage`, under one namespaced and versioned entry.
  * @param options - Which entry to use, and what a fresh record looks like.
  * @returns The binding, ready to be handed to the page.
  */
 export function localStorageProgressStore(options) {
-    const { key, version = 1, defaults, name = 'this browser' } = options;
-    const storageKey = `${key}:v${version}`;
+    const { key, version = 1, defaults, name = 'this browser', onQuotaExceeded, } = options;
+    const storageKey = versionedStorageKey(key, version);
     return {
         name,
         load() {
             const records = {};
-            const stored = readJsonEntry(storageKey);
+            const stored = readStorageEntry(storageKey);
             if (!isPlainRecord(stored))
                 return records;
             for (const [id, value] of Object.entries(stored)) {
@@ -73,12 +62,12 @@ export function localStorageProgressStore(options) {
                 records[id] =
                     defaults === undefined
                         ? value
-                        : mergeProgressRecord(value, defaults);
+                        : mergeStored(defaults, value);
             }
             return records;
         },
         save(records) {
-            writeJsonEntry(storageKey, records);
+            writeStorageEntry(storageKey, records, onQuotaExceeded);
         },
     };
 }
@@ -104,19 +93,4 @@ export function progressSummary(records, ids) {
     const total = keys.length;
     return { solved, attempted, total, ratio: total === 0 ? 0 : solved / total };
 }
-const STATUSES = new Set([
-    'idle',
-    'attempted',
-    'solved',
-]);
-function isPlainRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function isSameShape(fallback, stored) {
-    if (fallback === null)
-        return true;
-    if (Array.isArray(fallback) !== Array.isArray(stored))
-        return false;
-    return typeof fallback === typeof stored && stored !== null;
-}
 //# sourceMappingURL=progress.js.map

package/lib/pedagogy/core/progress.js.map

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

package/lib/pedagogy/core/types.d.ts

@@ -25,6 +25,7 @@ export interface BaseExercise {
     id: string;
     /** How the exercise is listed. */
     title: string;
+    /** How hard it is, which is also how it is coloured in the list. */
     level: ExerciseLevel;
     /** What to do, in a few sentences; may carry `[[term]]` markers. */
     description: string;
@@ -45,6 +46,7 @@ export interface BaseExercise {
 export interface ExerciseSet<TExercise = BaseExercise> {
     /** Stable and URL-safe. */
     id: string;
+    /** How the set is named where it is picked. */
     title: string;
     /** One line on what the set drills. */
     description: string;
@@ -54,6 +56,7 @@ export interface ExerciseSet<TExercise = BaseExercise> {
      * @default undefined
      */
     level?: ExerciseLevel;
+    /** The questions, in the order the set hands them out. */
     exercises: TExercise[];
 }
 /**
@@ -65,6 +68,7 @@ export interface ExerciseSet<TExercise = BaseExercise> {
 export type TutorialStep<TPayload = unknown> = {
     /** Stable and URL-safe: it is what a link to the step carries. */
     id: string;
+    /** The heading of the step, and its name in the step strip. */
     title: string;
     /** One short paragraph; may carry `[[term]]` markers. */
     description: string;

package/lib/pedagogy/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,GAAG,YAAY;IACnD,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,OAAO,IAAI;IAC7C,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,aAAa,CAAC;IACrB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,SAAS,GAAG,YAAY;IACnD,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,0DAA0D;IAC1D,SAAS,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,QAAQ,GAAG,OAAO,IAAI;IAC7C,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,QAAQ,CAAC"}

package/lib/pedagogy/core/validation.d.ts

@@ -7,6 +7,7 @@
  */
 /** How one test case came out. */
 export interface TestCaseResult {
+    /** Whether the answer did what the case asks. */
     passed: boolean;
     /**
      * What happened, written the way a tutor would say it — `match was "cat",
@@ -27,6 +28,7 @@ export interface TestCaseResult {
  * type through.
  */
 export interface ValidationResult<TCase extends TestCaseResult = TestCaseResult> {
+    /** Whether the answer ran, carries every required option and passed every case. */
     passed: boolean;
     /**
      * The one thing that stopped the cases from running at all: an answer that
@@ -34,6 +36,7 @@ export interface ValidationResult<TCase extends TestCaseResult = TestCaseResult>
      * badly it did.
      */
     error: string | null;
+    /** Every graded case, in the order they were run. */
     cases: TCase[];
     /**
      * The options the exercise requires and the answer does not carry — a regex

package/lib/pedagogy/core/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAC/B,KAAK,SAAS,cAAc,GAAG,cAAc;IAE7C,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,KAAK,EAAE,CAAC;IACf;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAC3D,KAAK,EAAE,KAAK,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAAC,KAAK,CAAC,CASzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAC3D,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,KAAK,EAAO,GAClB,gBAAgB,CAAC,KAAK,CAAC,CAEzB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB,CAC/B,KAAK,SAAS,cAAc,GAAG,cAAc;IAE7C,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qDAAqD;IACrD,KAAK,EAAE,KAAK,EAAE,CAAC;IACf;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAC3D,KAAK,EAAE,KAAK,EAAE,EACd,OAAO,GAAE,uBAA4B,GACpC,gBAAgB,CAAC,KAAK,CAAC,CASzB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,cAAc,EAC3D,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,KAAK,EAAO,GAClB,gBAAgB,CAAC,KAAK,CAAC,CAEzB"}

package/lib/pedagogy/core/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/pedagogy/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyDH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,UAAmC,EAAE;IAErC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACpC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,OAAO;QACL,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;QACzE,KAAK;QACL,KAAK;QACL,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,QAAiB,EAAE;IAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,KAAgC;IACjD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/pedagogy/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4DH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,UAAmC,EAAE;IAErC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACpC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,OAAO;QACL,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;QACzE,KAAK;QACL,KAAK;QACL,cAAc;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,QAAiB,EAAE;IAEnB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,KAAgC;IACjD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/pedagogy/ui/ExerciseActions.d.ts

@@ -1,4 +1,5 @@
 import type { ReactElement, ReactNode } from 'react';
+/** What {@link ExerciseActions} needs: its handlers, and the labels of its buttons. */
 export interface ExerciseActionsProps {
     /**
      * Records the attempt. Grading itself runs on every keystroke, so this

package/lib/pedagogy/ui/ExerciseActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExerciseActions.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CA+CzE"}
+{"version":3,"file":"ExerciseActions.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseActions.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CA+CzE"}

package/lib/pedagogy/ui/ExerciseActions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExerciseActions.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseActions.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAiE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,OAAO,EACP,UAAU,GAAG,OAAO,EACpB,aAAa,GAAG,KAAK,EACrB,YAAY,EACZ,aAAa,GAAG,CAAC,EACjB,SAAS,GAAG,CAAC,EACb,gBAAgB,EAChB,YAAY,GAAG,KAAK,EACpB,OAAO,EACP,QAAQ,EACR,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,eAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,aACxC,OAAO,KAAK,SAAS,IAAI,CACxB,KAAC,MAAM,IACL,MAAM,EAAC,SAAS,EAChB,IAAI,EAAC,MAAM,EACX,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,OAAO,GAChB,CACH,EACA,YAAY,KAAK,SAAS,IAAI,CAC7B,KAAC,MAAM,IACL,IAAI,EAAC,WAAW,EAChB,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,SAAS,GAAG,EACxE,QAAQ,EAAE,aAAa,IAAI,SAAS,EACpC,OAAO,EAAE,YAAY,GACrB,CACH,EACA,gBAAgB,KAAK,SAAS,IAAI,CACjC,KAAC,MAAM,IACL,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EACtC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,EACxD,OAAO,EAAE,gBAAgB,GACzB,CACH,EACA,OAAO,KAAK,SAAS,IAAI,CACxB,KAAC,MAAM,IAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAC,OAAO,EAAC,OAAO,EAAE,OAAO,GAAI,CACvD,EACA,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAkB;IAC/B,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,GAAG,EAAE,CAAC;CACP,CAAC"}
+{"version":3,"file":"ExerciseActions.js","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseActions.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAkE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EACJ,OAAO,EACP,UAAU,GAAG,OAAO,EACpB,aAAa,GAAG,KAAK,EACrB,YAAY,EACZ,aAAa,GAAG,CAAC,EACjB,SAAS,GAAG,CAAC,EACb,gBAAgB,EAChB,YAAY,GAAG,KAAK,EACpB,OAAO,EACP,QAAQ,EACR,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,eAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,aACxC,OAAO,KAAK,SAAS,IAAI,CACxB,KAAC,MAAM,IACL,MAAM,EAAC,SAAS,EAChB,IAAI,EAAC,MAAM,EACX,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,OAAO,GAChB,CACH,EACA,YAAY,KAAK,SAAS,IAAI,CAC7B,KAAC,MAAM,IACL,IAAI,EAAC,WAAW,EAChB,IAAI,EAAE,gBAAgB,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,SAAS,GAAG,EACxE,QAAQ,EAAE,aAAa,IAAI,SAAS,EACpC,OAAO,EAAE,YAAY,GACrB,CACH,EACA,gBAAgB,KAAK,SAAS,IAAI,CACjC,KAAC,MAAM,IACL,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EACtC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,EACxD,OAAO,EAAE,gBAAgB,GACzB,CACH,EACA,OAAO,KAAK,SAAS,IAAI,CACxB,KAAC,MAAM,IAAC,IAAI,EAAC,OAAO,EAAC,IAAI,EAAC,OAAO,EAAC,OAAO,EAAE,OAAO,GAAI,CACvD,EACA,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAkB;IAC/B,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,GAAG,EAAE,CAAC;CACP,CAAC"}

package/lib/pedagogy/ui/ExerciseProgressHeader.d.ts

@@ -1,5 +1,6 @@
 import type { ReactElement, ReactNode } from 'react';
 import type { ProgressSummary } from '../core/progress.ts';
+/** What {@link ExerciseProgressHeader} needs. */
 export interface ExerciseProgressHeaderProps {
     /** Where the student stands, as `progressSummary` counted it. */
     summary: ProgressSummary;

package/lib/pedagogy/ui/ExerciseProgressHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExerciseProgressHeader.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseProgressHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,YAAY,CA+Dd"}
+{"version":3,"file":"ExerciseProgressHeader.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/ui/ExerciseProgressHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,iDAAiD;AACjD,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,OAAO,EAAE,eAAe,CAAC;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,YAAY,CA+Dd"}