react-cheminfo 0.64.0 → 0.65.0

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

@@ -0,0 +1,86 @@
+/**
+ * How far a student has got on a graded series, kept in this browser.
+ *
+ * Best effort and never a precondition: a framed page whose storage is
+ * partitioned still works, it just forgets. An attempt is keyed by tool, series
+ * and question, so a new series starts clean and a shared link reopens its own.
+ * The store is a plain subscribable value, so a page reads it with React's
+ * `useSyncExternalStore` or from a signal of its own, and the series components
+ * re-render on it without knowing which.
+ */
+import type { ProgressRecords, ProgressStore } from './progress.ts';
+import type { ExerciseStatus } from './types.ts';
+/** One question as the student left it. */
+export interface Attempt {
+    /** Where the student stands on it. */
+    status: ExerciseStatus;
+    /** What was typed, or drawn, field by field. */
+    answers: Record<string, string>;
+    /** The answers as they were when last checked, so a change hides the verdict. */
+    checked: string | null;
+    /** How many hints of the ladder are open. */
+    hintsRevealed: number;
+    /** Whether the worked answer is on screen. */
+    showSolution: boolean;
+}
+/**
+ * What a question looks like before anything is typed into it.
+ * @returns A fresh attempt.
+ */
+export declare function emptyAttempt(): Attempt;
+/**
+ * The key an attempt is kept under.
+ * @param tool - The tool.
+ * @param seed - The series.
+ * @param question - The question's key in the tool's pool.
+ * @returns `tool/seed/question`.
+ */
+export declare function attemptKey(tool: string, seed: number, question: string): string;
+/** What {@link createAttemptStore} is built from. */
+export interface AttemptStoreOptions {
+    /**
+     * The site, which namespaces both entries: `atoms` keeps its attempts under
+     * `atoms:attempts:v1` and the series each tool was last on under
+     * `atoms:seeds:v1`.
+     */
+    key: string;
+    /**
+     * Where the attempts are kept, for a course that keeps them itself.
+     * @default the browser's `localStorage`, under `<key>:attempts:v1`
+     */
+    binding?: ProgressStore<Attempt>;
+    /**
+     * Called when a save was refused because the store is full.
+     * @default undefined
+     */
+    onQuotaExceeded?: (error: unknown) => void;
+}
+/** The attempts of a site, and the series each of its tools was last on. */
+export interface AttemptStore {
+    /** Every attempt this browser remembers; a new object after each change. */
+    records: () => ProgressRecords<Attempt>;
+    /** Be told after each change; returns the function that stops it. */
+    subscribe: (listener: () => void) => () => void;
+    /** One question's attempt, or a fresh one. */
+    attemptFor: (key: string) => Attempt;
+    /** Change one attempt and keep it. */
+    updateAttempt: (key: string, change: Partial<Attempt>) => void;
+    /** Forget the attempts of some questions. */
+    clearAttempts: (keys: readonly string[]) => void;
+    /**
+     * Forget every series of a tool but one, so storage does not grow with every
+     * new series drawn.
+     */
+    forgetOtherSeries: (tool: string, seed: number) => void;
+    /** The series a tool was last on in this browser, or null. */
+    storedSeed: (tool: string) => number | null;
+    /** Remember the series a tool is on. */
+    storeSeed: (tool: string, seed: number) => void;
+}
+/**
+ * The attempts of a site's graded series, kept in this browser.
+ * @param options - The site's namespace, and where else to keep them.
+ * @returns The store.
+ */
+export declare function createAttemptStore(options: AttemptStoreOptions): AttemptStore;
+//# sourceMappingURL=attempts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attempts.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/attempts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,2CAA2C;AAC3C,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iFAAiF;IACjF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAQtC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5C;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,qEAAqE;IACrE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,8CAA8C;IAC9C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,sCAAsC;IACtC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/D,6CAA6C;IAC7C,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IACjD;;;OAGG;IACH,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,8DAA8D;IAC9D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,wCAAwC;IACxC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAqF7E"}

package/lib/pedagogy/core/attempts.js

@@ -0,0 +1,117 @@
+/**
+ * How far a student has got on a graded series, kept in this browser.
+ *
+ * Best effort and never a precondition: a framed page whose storage is
+ * partitioned still works, it just forgets. An attempt is keyed by tool, series
+ * and question, so a new series starts clean and a shared link reopens its own.
+ * The store is a plain subscribable value, so a page reads it with React's
+ * `useSyncExternalStore` or from a signal of its own, and the series components
+ * re-render on it without knowing which.
+ */
+import { persistBucket } from "../../state/core/persistBucket.js";
+import { localStorageProgressStore } from "./progress.js";
+/**
+ * What a question looks like before anything is typed into it.
+ * @returns A fresh attempt.
+ */
+export function emptyAttempt() {
+    return {
+        status: 'idle',
+        answers: {},
+        checked: null,
+        hintsRevealed: 0,
+        showSolution: false,
+    };
+}
+/**
+ * The key an attempt is kept under.
+ * @param tool - The tool.
+ * @param seed - The series.
+ * @param question - The question's key in the tool's pool.
+ * @returns `tool/seed/question`.
+ */
+export function attemptKey(tool, seed, question) {
+    return `${tool}/${seed}/${question}`;
+}
+/**
+ * The attempts of a site's graded series, kept in this browser.
+ * @param options - The site's namespace, and where else to keep them.
+ * @returns The store.
+ */
+export function createAttemptStore(options) {
+    const { key, onQuotaExceeded } = options;
+    const binding = options.binding ??
+        localStorageProgressStore({
+            key: `${key}:attempts`,
+            version: 1,
+            defaults: emptyAttempt(),
+            onQuotaExceeded,
+        });
+    const seeds = persistBucket({
+        key: `${key}:seeds`,
+        version: 1,
+        defaults: {},
+        onQuotaExceeded,
+    });
+    const listeners = new Set();
+    let current = {};
+    // Kept in memory as well, so a framed page whose storage is blocked still
+    // reopens the series it is on for as long as it stays open.
+    let seedsByTool = seeds.read().value;
+    function publish(next, save) {
+        current = next;
+        if (save)
+            void binding.save(next);
+        for (const listener of listeners)
+            listener();
+    }
+    const loaded = binding.load();
+    if (loaded instanceof Promise) {
+        void loaded.then((records) => {
+            publish(records, false);
+        }, () => {
+            // A binding that cannot answer leaves the page working from nothing.
+        });
+    }
+    else {
+        current = loaded;
+    }
+    function attemptFor(attempt) {
+        return current[attempt] ?? emptyAttempt();
+    }
+    return {
+        records: () => current,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        attemptFor,
+        updateAttempt(attempt, change) {
+            publish({ ...current, [attempt]: { ...attemptFor(attempt), ...change } }, true);
+        },
+        clearAttempts(keys) {
+            const cleared = new Set(keys);
+            publish(keep(current, (attempt) => !cleared.has(attempt)), true);
+        },
+        forgetOtherSeries(tool, seed) {
+            const kept = `${tool}/${seed}/`;
+            publish(keep(current, (attempt) => !attempt.startsWith(`${tool}/`) || attempt.startsWith(kept)), true);
+        },
+        storedSeed: (tool) => seedsByTool[tool] ?? null,
+        storeSeed(tool, seed) {
+            seedsByTool = { ...seedsByTool, [tool]: seed };
+            seeds.write(seedsByTool);
+        },
+    };
+}
+function keep(records, wanted) {
+    const next = {};
+    for (const [key, attempt] of Object.entries(records)) {
+        if (wanted(key))
+            next[key] = attempt;
+    }
+    return next;
+}
+//# sourceMappingURL=attempts.js.map

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

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

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

@@ -11,4 +11,12 @@ export { emptyProgress, localStorageProgressStore, mergeExerciseProgress, progre
 export type { BaseExercise, ExerciseLevel, ExerciseSet, ExerciseStatus, TutorialStep, } from './types.ts';
 export type { FinishValidationOptions, TestCaseResult, ValidationResult, } from './validation.ts';
 export { failedValidation, finishValidation } from './validation.ts';
+export { emptyCase, formatSigned, readAnswerNumber, unreadableCase, } from './answers.ts';
+export type { Attempt, AttemptStore, AttemptStoreOptions } from './attempts.ts';
+export { attemptKey, createAttemptStore, emptyAttempt } from './attempts.ts';
+export type { ControlledProgress, ProgressController, ProgressControllerOptions, ProgressSignal, } from './progressController.ts';
+export { createProgressController } from './progressController.ts';
+export type { PickSeededOptions, SeedDraw, SeedRange, SeedValue, } from './seed.ts';
+export { EACH_SEED, LARGEST_SEED, freshSeed, parseSeed, pickSeeded, seedParam, } from './seed.ts';
+export type { AnswerCheck, AnswerField, Answers, FieldCase, SeriesTool, } from './series.ts';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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;AACrE,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7E,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC"}

package/lib/pedagogy/core/index.js

@@ -4,4 +4,8 @@ export { parseInlineMarks } from "./inlineMarks.js";
 export { bucketProgressStore } from "./bucketProgressStore.js";
 export { emptyProgress, localStorageProgressStore, mergeExerciseProgress, progressSummary, } from "./progress.js";
 export { failedValidation, finishValidation } from "./validation.js";
+export { emptyCase, formatSigned, readAnswerNumber, unreadableCase, } from "./answers.js";
+export { attemptKey, createAttemptStore, emptyAttempt } from "./attempts.js";
+export { createProgressController } from "./progressController.js";
+export { EACH_SEED, LARGEST_SEED, freshSeed, parseSeed, pickSeeded, seedParam, } from "./seed.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,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"}
+{"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;AACrE,OAAO,EACL,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAOnE,OAAO,EACL,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * The handful of actions every exercise page performs on the progress it keeps:
+ * read one record, mark it, open a hint, show the answer, forget it.
+ *
+ * The records live in whatever the page already holds its state in — a signal
+ * of `@preact/signals-react`, or anything with a writable `value` — and every
+ * action replaces that value rather than mutating it, so whatever renders from
+ * it is told.
+ */
+import type { ExerciseProgress, ProgressRecords } from './progress.ts';
+import type { ExerciseStatus } from './types.ts';
+/** A writable box holding the records, which a signal is. */
+export interface ProgressSignal<TProgress> {
+    /** The records by exercise id; replaced, never mutated. */
+    value: ProgressRecords<TProgress>;
+}
+/** The least a record has to carry for the controller to act on it. */
+export interface ControlledProgress {
+    /** Where the student stands. */
+    status: ExerciseStatus;
+    /** How many hints are open. */
+    hintsRevealed: number;
+    /** Whether the sample answer is on screen. */
+    showSolution: boolean;
+}
+/** What {@link createProgressController} is built with. */
+export interface ProgressControllerOptions<TProgress> {
+    /**
+     * The record an exercise nobody has touched reads as.
+     * @default emptyProgress — status, answer, hints and solution
+     */
+    empty?: () => TProgress;
+}
+/** The actions on one page's progress. */
+export interface ProgressController<TProgress extends ControlledProgress> {
+    /** One exercise's record, defaults included; reads the signal. */
+    getExerciseProgress: (id: string) => TProgress;
+    /** Record an attempt or a success. */
+    setExerciseStatus: (id: string, status: ExerciseStatus) => void;
+    /** Change any fields of one record, the others kept. */
+    updateProgress: (id: string, patch: Partial<TProgress>) => void;
+    /**
+     * Open the next hint, one at a time, stopping at the last when the count is
+     * given.
+     */
+    revealNextHint: (id: string, hintCount?: number) => void;
+    /** Show or hide the sample answer. */
+    setShowSolution: (id: string, show: boolean) => void;
+    /** Forget one exercise. */
+    resetExercise: (id: string) => void;
+    /**
+     * Forget every exercise. The page puts this behind a confirmation dialog,
+     * because it wipes a week of a student's work.
+     */
+    clearAllProgress: () => void;
+}
+/**
+ * The actions on the progress a page keeps in a signal.
+ * @param progress - The signal holding the records by exercise id.
+ * @param options - What an untouched exercise reads as.
+ * @returns The actions.
+ */
+export declare function createProgressController<TProgress extends ControlledProgress = ExerciseProgress>(progress: ProgressSignal<TProgress>, options?: ProgressControllerOptions<TProgress>): ProgressController<TProgress>;
+//# sourceMappingURL=progressController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressController.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/progressController.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,6DAA6D;AAC7D,MAAM,WAAW,cAAc,CAAC,SAAS;IACvC,2DAA2D;IAC3D,KAAK,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;CACnC;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,WAAW,yBAAyB,CAAC,SAAS;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,SAAS,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB,CAAC,SAAS,SAAS,kBAAkB;IACtE,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;IAC/C,sCAAsC;IACtC,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAChE,wDAAwD;IACxD,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAChE;;;OAGG;IACH,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,sCAAsC;IACtC,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,2BAA2B;IAC3B,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,SAAS,kBAAkB,GAAG,gBAAgB,EAEvD,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,EACnC,OAAO,GAAE,yBAAyB,CAAC,SAAS,CAAM,GACjD,kBAAkB,CAAC,SAAS,CAAC,CAyC/B"}

package/lib/pedagogy/core/progressController.js

@@ -0,0 +1,56 @@
+/**
+ * The handful of actions every exercise page performs on the progress it keeps:
+ * read one record, mark it, open a hint, show the answer, forget it.
+ *
+ * The records live in whatever the page already holds its state in — a signal
+ * of `@preact/signals-react`, or anything with a writable `value` — and every
+ * action replaces that value rather than mutating it, so whatever renders from
+ * it is told.
+ */
+import { emptyProgress } from "./progress.js";
+/**
+ * The actions on the progress a page keeps in a signal.
+ * @param progress - The signal holding the records by exercise id.
+ * @param options - What an untouched exercise reads as.
+ * @returns The actions.
+ */
+export function createProgressController(progress, options = {}) {
+    const empty = options.empty ?? emptyProgress;
+    function getExerciseProgress(id) {
+        return { ...empty(), ...progress.value[id] };
+    }
+    function updateProgress(id, patch) {
+        progress.value = {
+            ...progress.value,
+            [id]: { ...getExerciseProgress(id), ...patch },
+        };
+    }
+    return {
+        getExerciseProgress,
+        updateProgress,
+        setExerciseStatus(id, status) {
+            updateProgress(id, { status });
+        },
+        revealNextHint(id, hintCount) {
+            const revealed = getExerciseProgress(id).hintsRevealed + 1;
+            updateProgress(id, {
+                hintsRevealed: hintCount === undefined ? revealed : Math.min(revealed, hintCount),
+            });
+        },
+        setShowSolution(id, show) {
+            updateProgress(id, { showSolution: show });
+        },
+        resetExercise(id) {
+            const next = {};
+            for (const [key, value] of Object.entries(progress.value)) {
+                if (key !== id)
+                    next[key] = value;
+            }
+            progress.value = next;
+        },
+        clearAllProgress() {
+            progress.value = {};
+        },
+    };
+}
+//# sourceMappingURL=progressController.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressController.js","sourceRoot":"","sources":["../../../src/pedagogy/core/progressController.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAoD9C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAGtC,QAAmC,EACnC,UAAgD,EAAE;IAElD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAK,aAA4C,CAAC;IAE7E,SAAS,mBAAmB,CAAC,EAAU;QACrC,OAAO,EAAE,GAAG,KAAK,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,SAAS,cAAc,CAAC,EAAU,EAAE,KAAyB;QAC3D,QAAQ,CAAC,KAAK,GAAG;YACf,GAAG,QAAQ,CAAC,KAAK;YACjB,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,mBAAmB,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,cAAc;QACd,iBAAiB,CAAC,EAAE,EAAE,MAAM;YAC1B,cAAc,CAAC,EAAE,EAAE,EAAE,MAAM,EAAwB,CAAC,CAAC;QACvD,CAAC;QACD,cAAc,CAAC,EAAE,EAAE,SAAS;YAC1B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC;YAC3D,cAAc,CAAC,EAAE,EAAE;gBACjB,aAAa,EACX,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC;aAC/C,CAAC,CAAC;QAC3B,CAAC;QACD,eAAe,CAAC,EAAE,EAAE,IAAI;YACtB,cAAc,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAwB,CAAC,CAAC;QACnE,CAAC;QACD,aAAa,CAAC,EAAE;YACd,MAAM,IAAI,GAA+B,EAAE,CAAC;YAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1D,IAAI,GAAG,KAAK,EAAE;oBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACpC,CAAC;YACD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,gBAAgB;YACd,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,96 @@
+/**
+ * The seed a series is drawn from, and the drawing itself.
+ *
+ * A series is a link: `?seed=4271` hands the same questions, in the same order,
+ * to everybody who opens it, on every machine and in every browser. So the
+ * drawing goes through `ml-xsadd` and nothing else — a hand-rolled generator
+ * silently changes its sequence the day somebody improves it, and every link
+ * that pinned a seed then opens a different problem set.
+ */
+import type { ShareParamCodec } from '../../share/core/params.ts';
+/** The largest seed a link may carry: an unsigned 32-bit integer. */
+export declare const LARGEST_SEED: number;
+/** The seeds a link may pin, both ends included. */
+export interface SeedRange {
+    /** The smallest seed. */
+    min: number;
+    /** The largest seed. */
+    max: number;
+}
+/**
+ * Which call of the generator a shuffle draws from. Both are reproducible; they
+ * are two different sequences, so a site keeps the one its links were written
+ * with.
+ */
+export type SeedDraw = 'getFloat' | 'getUint32';
+/** How {@link pickSeeded} draws. */
+export interface PickSeededOptions {
+    /**
+     * The generator call the shuffle is driven by: `getFloat`, scaled to the
+     * remaining positions, or `getUint32`, taken modulo them.
+     * @default 'getFloat'
+     */
+    draw?: SeedDraw;
+    /**
+     * Whether a series longer than the pool goes round it again, so it is always
+     * exactly as long as asked. Otherwise it stops at the pool.
+     * @default false
+     */
+    wrap?: boolean;
+}
+/**
+ * Pick `count` items out of a pool, the same ones in the same order for the
+ * same seed.
+ *
+ * The pool is shuffled by Fisher–Yates driven by XSadd and the series is the
+ * head of that shuffle, so asking for more questions from the same seed keeps
+ * the ones already on screen. The pool itself is never reordered.
+ * @param pool - Everything a series can draw from.
+ * @param count - How many to take; more than the pool holds takes them all,
+ * or goes round again with `wrap`.
+ * @param seed - An unsigned 32-bit integer.
+ * @param options - Which generator call drives the shuffle, and whether the
+ * series wraps.
+ * @returns The picked items, in drawn order.
+ */
+export declare function pickSeeded<T>(pool: readonly T[], count: number, seed: number, options?: PickSeededOptions): T[];
+/**
+ * A seed for a series nobody has asked for yet.
+ *
+ * `ml-xsadd` unseeded rather than `Math.random`, so the one generator the page
+ * draws from is the one every link pins.
+ * @param range - The seeds a link may carry, so a drawn one is one of them.
+ * @default range { min: 0, max: LARGEST_SEED }
+ * @returns A whole number inside the range.
+ */
+export declare function freshSeed(range?: SeedRange): number;
+/**
+ * Read a seed out of an address, strictly: anything that is not a whole number
+ * inside the range reads as no seed at all.
+ * @param raw - The `seed` parameter, as typed or as a link carries it.
+ * @param range - The seeds a link may carry.
+ * @default range { min: 0, max: LARGEST_SEED }
+ * @returns The seed, or null when the parameter is absent or not one.
+ */
+export declare function parseSeed(raw: string | null | undefined, range?: SeedRange): number | null;
+/** What a link writes to ask for a series per student rather than one per class. */
+export declare const EACH_SEED = "each";
+/**
+ * What `?seed=` can say: a pinned series, a series per student, or no series —
+ * `null` rather than a number for the last, because `0` is a seed somebody may
+ * pin.
+ */
+export type SeedValue = number | typeof EACH_SEED | null;
+/**
+ * The codec of a `?seed=` that also understands `each`.
+ *
+ * A number is a problem set handed to a whole class; `each` is one link under
+ * which no two students work on the same set, the site drawing one seed per
+ * browser the first time it opens. A number outside the range is brought back
+ * inside it, and anything else reads as no series, so a hand-edited
+ * `?seed=today` still opens something.
+ * @param range - The seeds a link may pin.
+ * @returns The codec.
+ */
+export declare function seedParam(range: SeedRange): ShareParamCodec<SeedValue>;
+//# sourceMappingURL=seed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/pedagogy/core/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,qEAAqE;AACrE,eAAO,MAAM,YAAY,QAAc,CAAC;AAExC,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,CAAC,EAAE,CAWL;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAKnD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,KAAK,CAAC,EAAE,SAAS,GAChB,MAAM,GAAG,IAAI,CAOf;AAED,oFAAoF;AACpF,eAAO,MAAM,SAAS,SAAS,CAAC;AAEhC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,SAAS,GAAG,IAAI,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC,CAiBtE"}

package/lib/pedagogy/core/seed.js

@@ -0,0 +1,128 @@
+/**
+ * The seed a series is drawn from, and the drawing itself.
+ *
+ * A series is a link: `?seed=4271` hands the same questions, in the same order,
+ * to everybody who opens it, on every machine and in every browser. So the
+ * drawing goes through `ml-xsadd` and nothing else — a hand-rolled generator
+ * silently changes its sequence the day somebody improves it, and every link
+ * that pinned a seed then opens a different problem set.
+ */
+import { XSadd } from 'ml-xsadd';
+/** The largest seed a link may carry: an unsigned 32-bit integer. */
+export const LARGEST_SEED = 2 ** 32 - 1;
+/**
+ * Pick `count` items out of a pool, the same ones in the same order for the
+ * same seed.
+ *
+ * The pool is shuffled by Fisher–Yates driven by XSadd and the series is the
+ * head of that shuffle, so asking for more questions from the same seed keeps
+ * the ones already on screen. The pool itself is never reordered.
+ * @param pool - Everything a series can draw from.
+ * @param count - How many to take; more than the pool holds takes them all,
+ * or goes round again with `wrap`.
+ * @param seed - An unsigned 32-bit integer.
+ * @param options - Which generator call drives the shuffle, and whether the
+ * series wraps.
+ * @returns The picked items, in drawn order.
+ */
+export function pickSeeded(pool, count, seed, options = {}) {
+    const { draw = 'getFloat', wrap = false } = options;
+    const order = shuffledOrder(pool.length, seed, draw);
+    const wanted = Math.max(0, Math.trunc(count));
+    const size = pool.length === 0 ? 0 : wrap ? wanted : Math.min(wanted, pool.length);
+    const picked = new Array(size);
+    for (let index = 0; index < size; index++) {
+        picked[index] = pool[order[index % order.length]];
+    }
+    return picked;
+}
+/**
+ * A seed for a series nobody has asked for yet.
+ *
+ * `ml-xsadd` unseeded rather than `Math.random`, so the one generator the page
+ * draws from is the one every link pins.
+ * @param range - The seeds a link may carry, so a drawn one is one of them.
+ * @default range { min: 0, max: LARGEST_SEED }
+ * @returns A whole number inside the range.
+ */
+export function freshSeed(range) {
+    const drawn = new XSadd().getUint32();
+    if (range === undefined)
+        return drawn;
+    const span = range.max - range.min + 1;
+    return range.min + (drawn % span);
+}
+/**
+ * Read a seed out of an address, strictly: anything that is not a whole number
+ * inside the range reads as no seed at all.
+ * @param raw - The `seed` parameter, as typed or as a link carries it.
+ * @param range - The seeds a link may carry.
+ * @default range { min: 0, max: LARGEST_SEED }
+ * @returns The seed, or null when the parameter is absent or not one.
+ */
+export function parseSeed(raw, range) {
+    if (raw === null || raw === undefined || !/^\d{1,10}$/u.test(raw)) {
+        return null;
+    }
+    const seed = Number(raw);
+    const { min = 0, max = LARGEST_SEED } = range ?? {};
+    return seed >= min && seed <= max ? seed : null;
+}
+/** What a link writes to ask for a series per student rather than one per class. */
+export const EACH_SEED = 'each';
+/**
+ * The codec of a `?seed=` that also understands `each`.
+ *
+ * A number is a problem set handed to a whole class; `each` is one link under
+ * which no two students work on the same set, the site drawing one seed per
+ * browser the first time it opens. A number outside the range is brought back
+ * inside it, and anything else reads as no series, so a hand-edited
+ * `?seed=today` still opens something.
+ * @param range - The seeds a link may pin.
+ * @returns The codec.
+ */
+export function seedParam(range) {
+    return {
+        parse(raw) {
+            if (raw === null)
+                return null;
+            const text = raw.trim();
+            if (text === '')
+                return null;
+            if (text.toLowerCase() === EACH_SEED)
+                return EACH_SEED;
+            const parsed = Number(text);
+            if (Number.isNaN(parsed))
+                return null;
+            return clampSeed(parsed, range);
+        },
+        serialize(value) {
+            if (value === EACH_SEED)
+                return EACH_SEED;
+            if (typeof value !== 'number')
+                return null;
+            return String(clampSeed(value, range));
+        },
+    };
+}
+function clampSeed(value, range) {
+    if (!Number.isFinite(value))
+        return range.min;
+    return Math.min(range.max, Math.max(range.min, Math.round(value)));
+}
+function shuffledOrder(length, seed, draw) {
+    const generator = new XSadd(seed);
+    const order = new Array(length);
+    for (let index = 0; index < length; index++)
+        order[index] = index;
+    for (let index = length - 1; index > 0; index--) {
+        const other = draw === 'getUint32'
+            ? generator.getUint32() % (index + 1)
+            : Math.floor(generator.getFloat() * (index + 1));
+        const kept = order[index];
+        order[index] = order[other];
+        order[other] = kept;
+    }
+    return order;
+}
+//# sourceMappingURL=seed.js.map

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

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