postext 1.58.2 → 1.59.0

package/dist/exercises/model.js

@@ -0,0 +1,360 @@
+/**
+ * Reading the exercises of a document (#1225): each `:::exercise` fence's
+ * blocks read into an {@link ExerciseModel} — its kind (written or told by
+ * its content), instruction, items, answers, solutions and hints. Pure: the
+ * blocks are not changed.
+ */
+import { EXERCISE_KINDS } from './types.js';
+import { runOf, sliceRun, splitRun, trimRun } from './text.js';
+/** Whether the blocks hold an exercise. */
+export function hasExercises(blocks) {
+    return blocks.some((b) => b.type === 'containerStart' && b.containerName === 'exercise');
+}
+/** The index of the marker closing the container opened at `start`. */
+export function containerEndOf(blocks, start) {
+    const id = blocks[start].containerId;
+    for (let k = start + 1; k < blocks.length; k++) {
+        const b = blocks[k];
+        if (b.type === 'containerEnd' && b.containerId === id)
+            return k;
+    }
+    return blocks.length - 1;
+}
+/** The pair separator of a `match` item: ` -> `, `→`, `⟶`. */
+export const PAIR_RE = /\s*(?:->|→|⟶)\s*/;
+/** What separates the items of a `sort` category. */
+const CATEGORY_ITEM_RE = /\s*[,;、，；،؛]\s*/;
+/** The colon after a category or a crossword word. */
+const COLON_RE = /\s*[:：]\s*/;
+/** The kinds a fence may name, with a few spellings authors reach for. */
+const KIND_ALIASES = {
+    multiplechoice: 'choice', mcq: 'choice', quiz: 'choice', test: 'choice',
+    tf: 'truefalse', 'true-false': 'truefalse', truefalse: 'truefalse',
+    cloze: 'gaps', gap: 'gaps', blanks: 'gaps', fill: 'gaps',
+    matching: 'match', pairs: 'match', ordering: 'order', sequence: 'order',
+    sorting: 'sort', classify: 'sort', categories: 'sort',
+    free: 'open', essay: 'open', answer: 'open', 'word-search': 'wordsearch', 'crossword-puzzle': 'crossword',
+    operations: 'arithmetic', column: 'arithmetic', vertical: 'arithmetic',
+};
+export function exerciseKindOf(type) {
+    if (type === undefined)
+        return undefined;
+    const t = type.trim().toLowerCase();
+    if (EXERCISE_KINDS.includes(t))
+        return t;
+    return KIND_ALIASES[t];
+}
+const isListItem = (b) => b.type === 'listItem';
+const isTask = (b) => b.type === 'listItem' && b.listKind === 'task';
+/** The kind the content tells when the fence names none. */
+function inferredKind(blocks, body, gaps) {
+    if (body.some((k) => isTask(blocks[k])))
+        return 'choice';
+    if (body.some((k) => isListItem(blocks[k]) && PAIR_RE.test(blocks[k].text)))
+        return 'match';
+    if (gaps > 0)
+        return 'gaps';
+    return 'open';
+}
+/** The digits of `n` in the script `like` is written in (Arabic-Indic and
+ *  Persian digits kept). */
+function digitsLike(n, like) {
+    if (/[٠-٩]/.test(like))
+        return n.replace(/[0-9]/g, (d) => String.fromCharCode(0x0660 + Number(d)));
+    if (/[۰-۹]/.test(like))
+        return n.replace(/[0-9]/g, (d) => String.fromCharCode(0x06f0 + Number(d)));
+    return n;
+}
+const ascii = (s) => s
+    .replace(/[٠-٩]/g, (d) => String(d.charCodeAt(0) - 0x0660))
+    .replace(/[۰-۹]/g, (d) => String(d.charCodeAt(0) - 0x06f0));
+const OPERATION_RE = /^\s*(\d+)\s*([+\-−×xX*·⋅÷:/])\s*(\d+)\s*(?:=\s*)?$/u;
+/** The sign an operation prints, from the one written: a German `216 · 4`
+ *  keeps its dot, a `864 : 4` its colon; ASCII stand-ins become the signs. */
+const PRINTED_SIGN = { '-': '−', x: '×', X: '×', '*': '×', '⋅': '·', '/': '÷' };
+/** An operation item (`345 + 278`), its result worked out: whole numbers. */
+export function readOperation(text, block) {
+    const m = OPERATION_RE.exec(ascii(text));
+    if (!m)
+        return undefined;
+    const [a, b] = [m[1], m[3]];
+    const sign = m[2];
+    const op = sign === '+' ? '+' : sign === '-' || sign === '−' ? '-' : sign === '÷' || sign === ':' || sign === '/' ? '÷' : '×';
+    const x = BigInt(a);
+    const y = BigInt(b);
+    let result;
+    let remainder;
+    if (op === '+')
+        result = x + y;
+    else if (op === '-')
+        result = x - y;
+    else if (op === '×')
+        result = x * y;
+    else {
+        if (y === 0n)
+            return undefined;
+        result = x / y;
+        remainder = x % y;
+    }
+    const raw = text.trim();
+    return {
+        block,
+        a: digitsLike(a, raw),
+        b: digitsLike(b, raw),
+        op,
+        sign: PRINTED_SIGN[sign] ?? sign,
+        result: digitsLike(result.toString(), raw),
+        ...(remainder !== undefined && remainder !== 0n ? { remainder: digitsLike(remainder.toString(), raw) } : {}),
+    };
+}
+/** Read every exercise of `blocks`, in order. A `:::solution` or `:::hint`
+ *  outside an exercise, and an exercise inside another, are reported. */
+export function readExercises(blocks) {
+    const exercises = [];
+    const issues = [];
+    for (let i = 0; i < blocks.length; i++) {
+        const b = blocks[i];
+        if (b.type !== 'containerStart')
+            continue;
+        if (b.containerName === 'solution' || b.containerName === 'hint') {
+            issues.push({ kind: 'solutionOutside', sourceStart: b.sourceStart, sourceEnd: b.sourceEnd });
+            continue;
+        }
+        if (b.containerName !== 'exercise')
+            continue;
+        const end = containerEndOf(blocks, i);
+        exercises.push(readExercise(blocks, i, end, exercises.length, issues));
+        i = end;
+    }
+    return { exercises, issues };
+}
+function readExercise(blocks, start, end, ordinal, issues) {
+    const open = blocks[start];
+    const attrs = open.containerAttrs ?? {};
+    const id = open.containerId;
+    const solutions = [];
+    const hints = [];
+    const banks = [];
+    const instruction = [];
+    const body = [];
+    let leading = true;
+    for (let k = start + 1; k < end; k++) {
+        const b = blocks[k];
+        if (b.type === 'containerStart' && (b.containerName === 'solution' || b.containerName === 'hint')) {
+            const close = containerEndOf(blocks, k);
+            (b.containerName === 'solution' ? solutions : hints).push({ start: k, end: close });
+            k = close;
+            continue;
+        }
+        if (b.type === 'containerStart' && b.containerName === 'exercise') {
+            issues.push({ kind: 'exerciseNested', exercise: id, sourceStart: b.sourceStart, sourceEnd: b.sourceEnd });
+            const close = containerEndOf(blocks, k);
+            for (let j = k + 1; j < close; j++)
+                body.push(j);
+            k = close;
+            leading = false;
+            continue;
+        }
+        if (b.type === 'directive' && b.directiveName === 'bank') {
+            banks.push(k);
+            leading = false;
+            continue;
+        }
+        const gapless = !b.spans.some((s) => s.chip?.gap);
+        if (leading && b.type === 'paragraph' && gapless) {
+            instruction.push(k);
+            continue;
+        }
+        leading = false;
+        body.push(k);
+    }
+    const gaps = [];
+    for (const k of body) {
+        blocks[k].spans.forEach((s, span) => {
+            if (s.chip?.gap)
+                gaps.push({ block: k, span, gap: s.chip.gap, n: gaps.length + 1 });
+        });
+    }
+    const written = exerciseKindOf(attrs.type);
+    if (attrs.type !== undefined && !written) {
+        issues.push({ kind: 'exerciseUnknownType', exercise: id, detail: attrs.type, sourceStart: open.sourceStart, sourceEnd: open.sourceEnd });
+    }
+    const kind = written ?? inferredKind(blocks, body, gaps.length);
+    const model = {
+        id, ordinal, kind, attrs, start, end, instruction, body, items: new Set(), solutions, hints, banks, gaps,
+        questions: [], pairs: [], sequence: [], sentences: [], categories: [], entries: [], operations: [],
+        sourceStart: open.sourceStart, sourceEnd: blocks[end].sourceEnd,
+    };
+    readItems(blocks, model, issues);
+    if (gradedWithoutAnswer(model)) {
+        issues.push({ kind: 'exerciseNoAnswer', exercise: id, sourceStart: open.sourceStart, sourceEnd: open.sourceEnd });
+    }
+    return model;
+}
+/** A graded exercise with nothing to grade: no right option, no gap, no
+ *  pair… */
+function gradedWithoutAnswer(m) {
+    switch (m.kind) {
+        case 'choice': return m.questions.length === 0 ? m.gaps.length === 0 : m.questions.some((q) => !q.options.some((o) => o.correct));
+        case 'truefalse': return m.questions.length === 0;
+        case 'gaps':
+        case 'mark': return m.gaps.length === 0;
+        case 'match': return !m.pairs.some((p) => p.left.text !== '');
+        case 'order': return m.sequence.length < 2;
+        case 'scramble': return m.sentences.length === 0;
+        case 'sort': return m.categories.length === 0;
+        case 'wordsearch':
+        case 'crossword': return m.entries.length === 0;
+        case 'arithmetic': return m.operations.length === 0;
+        case 'open': return false;
+    }
+}
+/** The text of a list item after its marker (the parser keeps only the
+ *  item's own text). */
+const itemRun = (b) => trimRun(runOf(b));
+function readItems(blocks, m, issues) {
+    const select = m.attrs.select?.trim().toLowerCase();
+    const unread = (k) => {
+        const b = blocks[k];
+        issues.push({ kind: 'exerciseUnreadItem', exercise: m.id, detail: b.text, sourceStart: b.sourceStart, sourceEnd: b.sourceEnd });
+    };
+    switch (m.kind) {
+        case 'choice': {
+            let current;
+            let currentDepth = -1;
+            for (let j = 0; j < m.body.length; j++) {
+                const k = m.body[j];
+                const b = blocks[k];
+                if (isTask(b)) {
+                    const depth = b.depth ?? 0;
+                    if (!current || depth !== currentDepth) {
+                        // A list item right before at the depth above is the stem.
+                        const prev = j > 0 ? blocks[m.body[j - 1]] : undefined;
+                        const stem = prev && isListItem(prev) && !isTask(prev) && (prev.depth ?? 0) === depth - 1 ? m.body[j - 1] : undefined;
+                        current = { ...(stem !== undefined ? { stem } : {}), options: [], multiple: false };
+                        currentDepth = depth;
+                        m.questions.push(current);
+                    }
+                    current.options.push({ block: k, correct: b.checked === true });
+                    m.items.add(k);
+                    continue;
+                }
+                if (isListItem(b) && (b.depth ?? 0) < currentDepth) {
+                    current = undefined;
+                    currentDepth = -1;
+                }
+                else if (!isListItem(b)) {
+                    current = undefined;
+                    currentDepth = -1;
+                }
+            }
+            for (const q of m.questions) {
+                if (q.stem !== undefined)
+                    m.items.add(q.stem);
+                const right = q.options.filter((o) => o.correct).length;
+                q.multiple = select === 'many' || select === 'multiple' || (select !== 'one' && select !== 'single' && right > 1);
+            }
+            return;
+        }
+        case 'truefalse':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isTask(b))
+                    continue;
+                m.questions.push({ options: [{ block: k, correct: b.checked === true }], multiple: false });
+                m.items.add(k);
+            }
+            return;
+        case 'match':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isListItem(b))
+                    continue;
+                const run = itemRun(b);
+                const at = PAIR_RE.exec(run.text);
+                if (!at) {
+                    unread(k);
+                    continue;
+                }
+                m.pairs.push({ block: k, left: trimRun(sliceRun(run, 0, at.index)), right: trimRun(sliceRun(run, at.index + at[0].length)) });
+                m.items.add(k);
+            }
+            return;
+        case 'order': {
+            // The items of the list's top level (depth 1).
+            const top = Math.min(...m.body.filter((k) => isListItem(blocks[k])).map((k) => blocks[k].depth ?? 1));
+            const lists = m.body.filter((k) => isListItem(blocks[k]) && (blocks[k].depth ?? 1) === top);
+            m.sequence.push(...lists);
+            lists.forEach((k) => m.items.add(k));
+            return;
+        }
+        case 'scramble':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isListItem(b))
+                    continue;
+                const run = itemRun(b);
+                const pieces = /\s\/\s|\//.test(run.text) ? splitRun(run, /\s*\/\s*/) : splitRun(run, /\s+/);
+                m.sentences.push({ block: k, pieces: pieces.filter((p) => p.text !== '') });
+                m.items.add(k);
+            }
+            return;
+        case 'sort':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isListItem(b))
+                    continue;
+                const run = itemRun(b);
+                const at = COLON_RE.exec(run.text);
+                if (!at) {
+                    unread(k);
+                    continue;
+                }
+                const cat = {
+                    block: k,
+                    name: trimRun(sliceRun(run, 0, at.index)),
+                    items: splitRun(sliceRun(run, at.index + at[0].length), CATEGORY_ITEM_RE).filter((r) => r.text !== ''),
+                };
+                m.categories.push(cat);
+                m.items.add(k);
+            }
+            return;
+        case 'wordsearch':
+        case 'crossword':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isListItem(b))
+                    continue;
+                const run = itemRun(b);
+                const at = COLON_RE.exec(run.text);
+                const word = (at ? run.text.slice(0, at.index) : run.text).replace(/[\s\-‐]+/gu, '');
+                if (!word) {
+                    unread(k);
+                    continue;
+                }
+                const entry = { block: k, word, ...(at ? { clue: trimRun(sliceRun(run, at.index + at[0].length)) } : {}) };
+                m.entries.push(entry);
+                m.items.add(k);
+            }
+            return;
+        case 'arithmetic':
+            for (const k of m.body) {
+                const b = blocks[k];
+                if (!isListItem(b))
+                    continue;
+                const op = readOperation(b.text, k);
+                if (!op) {
+                    unread(k);
+                    continue;
+                }
+                m.operations.push(op);
+                m.items.add(k);
+            }
+            return;
+        case 'gaps':
+        case 'mark':
+        case 'open':
+            return;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/exercises/model.js.map

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

package/dist/exercises/record.d.ts

@@ -0,0 +1,94 @@
+/**
+ * What an exercise leaves for the digital outputs (#1230): its slots — the
+ * places it is answered on the page — and what each accepts, its key, its
+ * worked solution and hints as text. The layout carries one record per
+ * exercise laid out (`VDTDocument.exercises`); the HTML and EPUB outputs
+ * write them into the page for the exercise script.
+ */
+import type { ExerciseKind } from './types.js';
+/** How a slot is answered. */
+export type ExerciseSlotKind = 
+/** Typed into a blank; `accept` lists the right answers. */
+'gap'
+/** One option (or several, `multiple`) of `options` ticked; `correct`
+ *  are the right ones, 1-based in printed order. Its options are the
+ *  slots `<key>o<n>`. */
+ | 'choice'
+/** A statement: `correct` is `[1]` when true, `[2]` when false; its
+ *  boxes the slots `<key>t` and `<key>f` (or itself, typed, in the
+ *  bracket look). */
+ | 'truefalse'
+/** A word to mark; `correct` `[1]` (a word of the text not to mark has
+ *  no slot). */
+ | 'mark'
+/** A left item of a match: `correct` is the 1-based printed position of
+ *  its partner in the right column; in the letters look, `accept` its
+ *  printed label. */
+ | 'pair'
+/** An item to number (order): `accept` is its rank. */
+ | 'rank'
+/** A word of a sort exercise's bank: `accept` is its category. */
+ | 'category'
+/** Text written on an area (open, scramble, sort): `accept` the model
+ *  answers, which an open question only shows. */
+ | 'text'
+/** A cell of a grid (crossword, operation): `accept` its character. */
+ | 'cell'
+/** A word to find in a word search: `accept` its cells, `r,c` each. */
+ | 'word';
+export interface ExerciseSlot {
+    key: string;
+    kind: ExerciseSlotKind;
+    accept?: string[];
+    correct?: number[];
+    options?: number;
+    multiple?: boolean;
+    /** The container id of the drawn box the slot stands on (an area, a
+     *  grid): the digital outputs find its frame by it. */
+    box?: number;
+    /** A cell's place in its grid: row and column from 0. */
+    cell?: [number, number];
+    /** A writing area's line spacing, points. */
+    linePt?: number;
+}
+/** A grid's geometry, for the digital outputs to place its cells. */
+export interface ExerciseGridInfo {
+    box: number;
+    kind: 'match' | 'wordsearch' | 'crossword' | 'arithmetic';
+    rows: number;
+    cols: number;
+    /** A cell's side over the box's width (the grid starts at the box's top
+     *  left, in the flow's direction). */
+    cellPt: number;
+    /** The grid's left and top inside its box, points. */
+    xPt: number;
+    yPt: number;
+    /** Match: the middle of each row, points from the box's top, and the
+     *  left and right dots' x. */
+    rowsPt?: number[];
+    dotsPt?: [number, number];
+}
+export interface ExerciseRecord {
+    /** The fence's container id (the box's `containerId` in the layout). */
+    id: number;
+    ordinal: number;
+    number: string;
+    kind: ExerciseKind;
+    style: string;
+    slots: ExerciseSlot[];
+    /** The key as one line of text. */
+    key: string;
+    /** The worked solution's paragraphs, as text. */
+    solution?: string[];
+    hints?: string[];
+    /** The fence's `{#id}`. */
+    anchor?: string;
+    /** What a reference to it prints ("Exercise 3"). */
+    anchorText?: string;
+    /** The fence's `title`. */
+    title?: string;
+    /** A mark exercise's `mark` (`circle`, `underline`…). */
+    mark?: string;
+    grids?: ExerciseGridInfo[];
+}
+//# sourceMappingURL=record.d.ts.map

package/dist/exercises/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/exercises/record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB;AAC1B,4DAA4D;AAC1D,KAAK;AACP;;yBAEyB;GACvB,QAAQ;AACV;;qBAEqB;GACnB,WAAW;AACb;gBACgB;GACd,MAAM;AACR;;qBAEqB;GACnB,MAAM;AACR,uDAAuD;GACrD,MAAM;AACR,kEAAkE;GAChE,UAAU;AACZ;kDACkD;GAChD,MAAM;AACR,uEAAuE;GACrE,MAAM;AACR,uEAAuE;GACrE,MAAM,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;2DACuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;0CACsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ;kCAC8B;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B"}

package/dist/exercises/record.js

@@ -0,0 +1,9 @@
+/**
+ * What an exercise leaves for the digital outputs (#1230): its slots — the
+ * places it is answered on the page — and what each accepts, its key, its
+ * worked solution and hints as text. The layout carries one record per
+ * exercise laid out (`VDTDocument.exercises`); the HTML and EPUB outputs
+ * write them into the page for the exercise script.
+ */
+export {};
+//# sourceMappingURL=record.js.map

package/dist/exercises/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/exercises/record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/exercises/runtime.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The exercise script (#1230, #1231): makes the exercises of an HTML or EPUB
+ * output answerable, checks the answers and keeps them.
+ *
+ * The HTML output marks where an exercise is answered — its slots
+ * (`.pt-ex-slot[data-pt-ex][data-pt-slot]`, the chips of blanks, options,
+ * words) and its boxes (`.pt-ex-box[data-pt-box]`, the outer frame, the
+ * writing areas and grids) — and writes the records once, in
+ * `<script type="application/json" class="pt-exercises">`. The script lays
+ * its controls over those places: an input in a blank or a grid cell, a
+ * toggle on an option, lines between the dots of a match, a capsule in a
+ * word search, a text area on a writing area, a chooser on a word to sort;
+ * and a bar per exercise with Check, Show solution and Try again, a score
+ * read out to assistive technology (`aria-live`) and right or wrong marks
+ * that do not rest on colour alone (✓ and ✗).
+ *
+ * The whole runtime is one function with nothing from outside it, so the
+ * same code runs from the package (`attachExercises`) and as a standalone
+ * script (`EXERCISE_SCRIPT`, its source text). It keeps to syntax every
+ * reading system and transpiler leaves as it is: no spread, no `for…of`,
+ * no `async`.
+ */
+import type { ExerciseData } from './digital.js';
+import type { ExerciseRecord, ExerciseSlot } from './record.js';
+export interface AttachExercisesOptions {
+    /** What the answers are kept under (with each exercise's anchor or id):
+     *  a book and chapter, say. Default: the page's path. */
+    storageKey?: string;
+    /** Keep the answers in `localStorage`. Default: the document's
+     *  `exercises.digital.persist`. */
+    persist?: boolean;
+    /** `'button'`: checked on demand; `'instant'`: as answered. Default: the
+     *  document's `exercises.digital.check`. */
+    check?: 'button' | 'instant';
+    /** The exercise data, for a host that patches the pages and so holds
+     *  it itself (`HtmlRenderIndex.exercises`); otherwise read from the
+     *  `script.pt-exercises` elements under the root. */
+    data?: ExerciseData;
+}
+/** What a reader answered in a slot: text typed, the options ticked
+ *  (1-based), a true/false (1 or 2), a mark, a right item of a match, the
+ *  ends of the words found in a word search (`r,c-r,c`). */
+export type ExerciseValue = string | number | number[] | boolean | string[] | null | undefined;
+/** An answer as the exercise script compares it (see `attachExercises`). */
+export declare const normalizeAnswer: (text: string) => string;
+/** Whether a slot counts in an exercise's score. */
+export declare const isGradedSlot: (slot: ExerciseSlot, record: Pick<ExerciseRecord, 'kind'>) => boolean;
+/** Whether `value` answers `slot` rightly (`true`), wrongly (`false`), or
+ *  is no answer or not graded (`null`). `trueFalse` are the style's true
+ *  and false labels, for a typed true/false. */
+export declare const checkExerciseSlot: (slot: ExerciseSlot, value: ExerciseValue, record: Pick<ExerciseRecord, 'kind'>, trueFalse?: [string, string]) => boolean | null;
+/** What a slot shows when the solution is shown. */
+export declare const exerciseSolutionValue: (slot: ExerciseSlot, record: Pick<ExerciseRecord, 'kind'>, trueFalse?: [string, string]) => ExerciseValue;
+/** Makes the exercises of the HTML output under `root` answerable (see the
+ *  module comment). Call it once the markup is in place, again after the
+ *  markup changes (calling the previous call's return value first).
+ *  Returns a function that takes every control off and puts the page's
+ *  markup back as it was. */
+export declare function attachExercises(root: Element | ShadowRoot | Document, options?: AttachExercisesOptions): () => void;
+/** The exercise script as a standalone script, for an output with no host
+ *  page to call `attachExercises`: the HTML file of the command line, an
+ *  EPUB content document. It attaches to the document once it is parsed;
+ *  the answers are kept under the page's path. */
+export declare const EXERCISE_SCRIPT: string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/exercises/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/exercises/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC;6DACyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uCACmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B;;yDAEqD;IACrD,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;4DAE4D;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AA4+B/F,4EAA4E;AAC5E,eAAO,MAAM,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAgC,CAAC;AAEjF,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,OAA0B,CAAC;AAEpH;;gDAEgD;AAChD,eAAO,MAAM,iBAAiB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,IAAwB,CAAC;AAErL,oDAAoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,aAAqC,CAAC;AAEtK;;;;6BAI6B;AAC7B,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAEnH;AAED;;;kDAGkD;AAClD,eAAO,MAAM,eAAe,QAM3B,CAAC"}