postext 1.58.2 → 1.59.0

package/dist/exercises/configWarnings.js

@@ -0,0 +1,175 @@
+/**
+ * The checks of the exercise settings (#1226): a key an exercise style, one
+ * of its parts or the book's `exercises` do not have (`unknownConfigKey`),
+ * a word outside a setting's choices (`unknownConfigValue`, `used` the
+ * default the engine reads instead) and a numbering style it does not know
+ * (`unknownNumberFormat`).
+ */
+import { closestKey } from '../util/closestKey.js';
+import { isCounterStyle } from '../numbering.js';
+import { isResourceCounterReset } from '../defaults/resourceTypes.js';
+// The keys of each part, checked against its type: a key added to a type
+// fails to compile until it is listed here.
+const STYLE_KEYS = {
+    id: true, name: true, extends: true, box: true, number: true, instruction: true, options: true, blank: true,
+    trueFalse: true, match: true, bank: true, area: true, grid: true, arithmetic: true, level: true, icons: true,
+    answers: true, solutions: true, digital: true, marginTop: true, marginBottom: true, itemSpacing: true,
+};
+const NUMBER_KEYS = {
+    show: true, label: true, shape: true, color: true, background: true, fontFamily: true, fontSize: true,
+    fontWeight: true, suffix: true, template: true, resetOn: true, counter: true, format: true,
+};
+const INSTRUCTION_KEYS = { bold: true, italic: true, color: true, fontFamily: true, fontSize: true };
+const OPTIONS_KEYS = {
+    labels: true, prefix: true, suffix: true, marker: true, layout: true, columns: true, shuffle: true, indent: true, bracket: true,
+};
+const BLANK_KEYS = { look: true, width: true, extra: true, minWidth: true, color: true, weight: true };
+const TRUE_FALSE_KEYS = { labels: true, look: true };
+const MATCH_KEYS = { look: true, gap: true, dotSize: true, color: true };
+const BANK_KEYS = { box: true, order: true, separator: true };
+const AREA_KEYS = { kind: true, lines: true, spacing: true, color: true, weight: true };
+const GRID_KEYS = {
+    cell: true, fontFamily: true, fontSize: true, color: true, rule: true, ruleWidth: true, blocked: true, uppercase: true,
+};
+const ARITHMETIC_KEYS = { division: true, columns: true };
+const LEVEL_KEYS = { glyph: true, empty: true, max: true, color: true };
+const ICON_KEYS = { resourceId: true, glyph: true, fontFamily: true, color: true, alt: true, size: true };
+const ANSWERS_KEYS = { color: true, fontFamily: true, italic: true };
+const SOLUTIONS_KEYS = { placement: true, box: true, heading: true, layout: true };
+const DIGITAL_KEYS = { correctColor: true, wrongColor: true };
+const EXERCISES_KEYS = { edition: true, solutions: true, seed: true, digital: true };
+const EXERCISES_DIGITAL_KEYS = { interactive: true, persist: true, check: true };
+/** The words each setting takes, and the one read in place of another. */
+const CHOICES = {
+    shape: [['none', 'disc', 'square', 'rounded'], 'none'],
+    marker: [['none', 'box', 'circle'], 'none'],
+    layout: [['stack', 'row'], 'stack'],
+    blankLook: [['line', 'dots', 'box', 'none'], 'line'],
+    blankWidth: [['answer', 'longest'], 'longest'],
+    trueFalseLook: [['boxes', 'bracket'], 'boxes'],
+    matchLook: [['dots', 'letters'], 'dots'],
+    order: [['shuffle', 'alpha', 'written'], 'shuffle'],
+    area: [['lines', 'dots', 'grid', 'seyes', 'tianzige', 'box', 'none'], 'lines'],
+    division: [['bracket', 'potence', 'inline'], 'bracket'],
+    placement: [['none', 'after', 'inverted', 'chapterEnd', 'directive'], 'none'],
+    solutionsLayout: [['key', 'full'], 'full'],
+    edition: [['student', 'teacher'], 'student'],
+    check: [['button', 'instant'], 'button'],
+};
+const record = (v) => v && typeof v === 'object' && !Array.isArray(v) ? v : undefined;
+export function exerciseConfigWarnings(config) {
+    const out = [];
+    const keys = (node, known, path) => {
+        const r = record(node);
+        if (!r)
+            return;
+        const names = Object.keys(known);
+        for (const [key, value] of Object.entries(r)) {
+            if (value === undefined || Object.prototype.hasOwnProperty.call(known, key))
+                continue;
+            const suggestion = closestKey(key, names);
+            out.push({ kind: 'unknownConfigKey', path: `${path}.${key}`, value: key, used: '', ...(suggestion ? { suggestion } : {}) });
+        }
+    };
+    const choice = (value, [choices, used], path) => {
+        if (value === undefined || (typeof value === 'string' && choices.includes(value)))
+            return;
+        const written = String(value);
+        const suggestion = closestKey(written, [...choices]);
+        out.push({ kind: 'unknownConfigValue', path, value: written, used, ...(suggestion ? { suggestion } : {}) });
+    };
+    const format = (value, path, none) => {
+        if (value === undefined || (none && value === 'none') || (typeof value === 'string' && isCounterStyle(value)))
+            return;
+        out.push({ kind: 'unknownNumberFormat', path, value: String(value), used: 'decimal' });
+    };
+    const solutions = (node, path) => {
+        const s = record(node);
+        if (!s)
+            return;
+        keys(s, SOLUTIONS_KEYS, path);
+        choice(s.placement, CHOICES.placement, `${path}.placement`);
+        choice(s.layout, CHOICES.solutionsLayout, `${path}.layout`);
+    };
+    if (Array.isArray(config.exerciseStyles)) {
+        config.exerciseStyles.forEach((raw, i) => {
+            const s = record(raw);
+            if (!s)
+                return;
+            const at = `exerciseStyles[${i}]`;
+            keys(s, STYLE_KEYS, at);
+            const number = record(s.number);
+            if (number) {
+                keys(number, NUMBER_KEYS, `${at}.number`);
+                choice(number.shape, CHOICES.shape, `${at}.number.shape`);
+                if (number.resetOn !== undefined && !isResourceCounterReset(number.resetOn)) {
+                    out.push({ kind: 'unknownConfigValue', path: `${at}.number.resetOn`, value: String(number.resetOn), used: 'h1' });
+                }
+                format(number.format, `${at}.number.format`, false);
+            }
+            keys(s.instruction, INSTRUCTION_KEYS, `${at}.instruction`);
+            const options = record(s.options);
+            if (options) {
+                keys(options, OPTIONS_KEYS, `${at}.options`);
+                format(options.labels, `${at}.options.labels`, true);
+                choice(options.marker, CHOICES.marker, `${at}.options.marker`);
+                choice(options.layout, CHOICES.layout, `${at}.options.layout`);
+            }
+            const blank = record(s.blank);
+            if (blank) {
+                keys(blank, BLANK_KEYS, `${at}.blank`);
+                choice(blank.look, CHOICES.blankLook, `${at}.blank.look`);
+                // A length, or one of two words.
+                if (typeof blank.width === 'string')
+                    choice(blank.width, CHOICES.blankWidth, `${at}.blank.width`);
+            }
+            const trueFalse = record(s.trueFalse);
+            if (trueFalse) {
+                keys(trueFalse, TRUE_FALSE_KEYS, `${at}.trueFalse`);
+                choice(trueFalse.look, CHOICES.trueFalseLook, `${at}.trueFalse.look`);
+            }
+            const match = record(s.match);
+            if (match) {
+                keys(match, MATCH_KEYS, `${at}.match`);
+                choice(match.look, CHOICES.matchLook, `${at}.match.look`);
+            }
+            const bank = record(s.bank);
+            if (bank) {
+                keys(bank, BANK_KEYS, `${at}.bank`);
+                choice(bank.order, CHOICES.order, `${at}.bank.order`);
+            }
+            const area = record(s.area);
+            if (area) {
+                keys(area, AREA_KEYS, `${at}.area`);
+                choice(area.kind, CHOICES.area, `${at}.area.kind`);
+            }
+            keys(s.grid, GRID_KEYS, `${at}.grid`);
+            const arithmetic = record(s.arithmetic);
+            if (arithmetic) {
+                keys(arithmetic, ARITHMETIC_KEYS, `${at}.arithmetic`);
+                choice(arithmetic.division, CHOICES.division, `${at}.arithmetic.division`);
+            }
+            keys(s.level, LEVEL_KEYS, `${at}.level`);
+            const icons = record(s.icons);
+            if (icons)
+                for (const [id, icon] of Object.entries(icons))
+                    keys(icon, ICON_KEYS, `${at}.icons.${id}`);
+            keys(s.answers, ANSWERS_KEYS, `${at}.answers`);
+            solutions(s.solutions, `${at}.solutions`);
+            keys(s.digital, DIGITAL_KEYS, `${at}.digital`);
+        });
+    }
+    const book = record(config.exercises);
+    if (book) {
+        keys(book, EXERCISES_KEYS, 'exercises');
+        choice(book.edition, CHOICES.edition, 'exercises.edition');
+        solutions(book.solutions, 'exercises.solutions');
+        const digital = record(book.digital);
+        if (digital) {
+            keys(digital, EXERCISES_DIGITAL_KEYS, 'exercises.digital');
+            choice(digital.check, CHOICES.check, 'exercises.digital.check');
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=configWarnings.js.map

package/dist/exercises/configWarnings.js.map

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

package/dist/exercises/designs.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The drawn parts of an exercise (#1227, #1228): writing areas, and the
+ * grids of word searches, crosswords and operations in columns. Each is a
+ * frameless box whose design draws it — paths for the rules, texts for the
+ * letters — so every output paints it as it paints any box design, a
+ * right-to-left page mirrors it, and the layout places and keeps it whole.
+ * Lengths are given in points.
+ */
+import type { CalloutStyleConfig, ColorValue, DesignElement, DesignPathElement, DesignTextElement } from '../types.js';
+/** A frameless box drawn by `elements`, `heightPt` tall. */
+export declare function drawnBox(id: string, elements: DesignElement[], heightPt: number, marginTopPt?: number, marginBottomPt?: number): CalloutStyleConfig;
+/** A path element over `[0, w] × [0, h]` points, from the box's top left. */
+export declare function pathElement(id: string, d: string, wPt: number, hPt: number, stroke: ColorValue, widthPt: number, extra?: Partial<DesignPathElement>): DesignPathElement;
+/** A text element: `content` set in a box `wPt` × `hPt` at (`xPt`, `yPt`). */
+export declare function textElement(id: string, content: string, xPt: number, yPt: number, wPt: number, hPt: number, sizePt: number, extra?: Partial<DesignTextElement>): DesignTextElement;
+export type AreaKind = 'lines' | 'dots' | 'grid' | 'seyes' | 'tianzige' | 'box' | 'none';
+export interface AreaSpec {
+    kind: AreaKind;
+    lines: number;
+    /** Distance between two lines (the side of a grid's square), points. */
+    spacingPt: number;
+    /** The room the area may take across, points. */
+    widthPt: number;
+    color: ColorValue;
+    weightPt: number;
+    /** Answers written on the lines (a teacher's edition), one a line, in
+     *  `answerColor`. */
+    answers?: string[];
+    answerColor?: ColorValue;
+    answerSizePt?: number;
+    answerFont?: string;
+}
+/** The elements and height of a writing area. */
+export declare function areaElements(a: AreaSpec): {
+    elements: DesignElement[];
+    heightPt: number;
+};
+//# sourceMappingURL=designs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"designs.d.ts","sourceRoot":"","sources":["../../src/exercises/designs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AAMlI,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,cAAc,SAAI,GAAG,kBAAkB,CAgBzI;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,iBAAiB,CAW3K;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAAG,iBAAiB,CAYtL;AAID,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB;yBACqB;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuEzF"}

package/dist/exercises/designs.js

@@ -0,0 +1,143 @@
+/**
+ * The drawn parts of an exercise (#1227, #1228): writing areas, and the
+ * grids of word searches, crosswords and operations in columns. Each is a
+ * frameless box whose design draws it — paths for the rules, texts for the
+ * letters — so every output paints it as it paints any box design, a
+ * right-to-left page mirrors it, and the layout places and keeps it whole.
+ * Lengths are given in points.
+ */
+import { graphemesOf } from '../measure/graphemes.js';
+const PT = (value) => ({ value: Math.round(value * 1000) / 1000, unit: 'pt' });
+const ZERO = PT(0);
+/** A frameless box drawn by `elements`, `heightPt` tall. */
+export function drawnBox(id, elements, heightPt, marginTopPt = 3, marginBottomPt = 3) {
+    return {
+        id,
+        title: '',
+        backgroundEnabled: false,
+        border: { enabled: false },
+        padding: { top: ZERO, right: ZERO, bottom: ZERO, left: ZERO },
+        stripe: { enabled: false },
+        icon: { kind: 'none' },
+        marker: { kind: 'none' },
+        marginTop: PT(marginTopPt),
+        marginBottom: PT(marginBottomPt),
+        snapToGrid: false,
+        keepTogether: true,
+        design: { enabled: true, slot: { elements }, minHeight: PT(heightPt) },
+    };
+}
+/** A path element over `[0, w] × [0, h]` points, from the box's top left. */
+export function pathElement(id, d, wPt, hPt, stroke, widthPt, extra = {}) {
+    return {
+        kind: 'path',
+        id,
+        placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: PT(wPt), height: PT(hPt) } },
+        d,
+        viewBox: [Math.max(0.001, wPt), Math.max(0.001, hPt)],
+        stroke,
+        width: PT(widthPt),
+        ...extra,
+    };
+}
+/** A text element: `content` set in a box `wPt` × `hPt` at (`xPt`, `yPt`). */
+export function textElement(id, content, xPt, yPt, wPt, hPt, sizePt, extra = {}) {
+    return {
+        kind: 'text',
+        id,
+        content: content.replace(/[{}]/g, (c) => (c === '{' ? '\uFF5B' : '\uFF5D')),
+        fontSize: PT(sizePt),
+        align: 'center',
+        verticalAlign: 'middle',
+        overflow: 'clip',
+        placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { x: PT(xPt), y: PT(yPt) }, size: { width: PT(wPt), height: PT(hPt) } },
+        ...extra,
+    };
+}
+const r = (n) => String(Math.round(n * 100) / 100);
+/** The elements and height of a writing area. */
+export function areaElements(a) {
+    const n = Math.max(1, Math.floor(a.lines));
+    const sp = a.spacingPt;
+    const w = a.widthPt;
+    const els = [];
+    let h = n * sp;
+    switch (a.kind) {
+        case 'lines':
+        case 'dots': {
+            let d = '';
+            for (let i = 0; i < n; i++)
+                d += `M0 ${r((i + 0.85) * sp)}H${r(w)}`;
+            els.push(pathElement('area', d, w, h, a.color, a.weightPt, a.kind === 'dots' ? { dash: [PT(a.weightPt * 1.2), PT(a.weightPt * 3)] } : {}));
+            break;
+        }
+        case 'grid':
+        case 'tianzige': {
+            const cols = Math.max(1, Math.floor(w / sp));
+            const gw = cols * sp;
+            let d = '';
+            for (let i = 0; i <= n; i++)
+                d += `M0 ${r(i * sp)}H${r(gw)}`;
+            for (let j = 0; j <= cols; j++)
+                d += `M${r(j * sp)} 0V${r(h)}`;
+            els.push(pathElement('area', d, gw, h, a.color, a.weightPt));
+            if (a.kind === 'tianzige') {
+                let x = '';
+                for (let i = 0; i < n; i++)
+                    x += `M0 ${r((i + 0.5) * sp)}H${r(gw)}`;
+                for (let j = 0; j < cols; j++)
+                    x += `M${r((j + 0.5) * sp)} 0V${r(h)}`;
+                els.push(pathElement('cross', x, gw, h, a.color, a.weightPt * 0.6, { dash: [PT(a.weightPt * 3), PT(a.weightPt * 3)] }));
+            }
+            break;
+        }
+        case 'seyes': {
+            // French Seyès ruling: a heavy line every `sp`, three light ones
+            // between, light verticals every `sp`, a margin line on the left.
+            let heavy = '';
+            let light = '';
+            const cols = Math.max(1, Math.floor(w / sp));
+            for (let i = 0; i < n; i++) {
+                heavy += `M0 ${r((i + 1) * sp)}H${r(w)}`;
+                for (let k = 1; k < 4; k++)
+                    light += `M0 ${r((i + k / 4) * sp)}H${r(w)}`;
+            }
+            for (let j = 1; j <= cols; j++)
+                light += `M${r(j * sp)} 0V${r(h)}`;
+            h = n * sp + a.weightPt;
+            els.push(pathElement('light', light, w, h, a.color, a.weightPt * 0.5));
+            els.push(pathElement('heavy', heavy, w, h, a.color, a.weightPt));
+            break;
+        }
+        case 'box':
+            els.push(pathElement('area', `M0 0H${r(w)}V${r(h)}H0Z`, w, h, a.color, a.weightPt));
+            break;
+        case 'none':
+            break;
+    }
+    if (a.answers && a.answerColor && (a.kind === 'grid' || a.kind === 'tianzige')) {
+        // On squares a model answer is written a character to a square, row
+        // after row, as a pupil writes on 田字格 or squared paper.
+        const cols = Math.max(1, Math.floor(w / sp));
+        const chars = graphemesOf(a.answers.join(''));
+        chars.slice(0, cols * n).forEach((ch, k) => {
+            if (ch.trim() === '')
+                return;
+            els.push(textElement(`answer${k}`, ch, (k % cols) * sp, Math.floor(k / cols) * sp, sp, sp, sp * 0.62, {
+                color: a.answerColor, overflow: 'clip', ...(a.answerFont ? { fontFamily: a.answerFont } : {}),
+            }));
+        });
+    }
+    else if (a.answers && a.answerColor) {
+        const size = a.answerSizePt ?? sp * 0.6;
+        a.answers.slice(0, n).forEach((text, i) => {
+            if (!text)
+                return;
+            els.push(textElement(`answer${i}`, text, sp * 0.15, i * sp, w - sp * 0.3, sp * 0.85, size, {
+                align: 'start', verticalAlign: 'bottom', color: a.answerColor, overflow: 'ellipsis-end', ...(a.answerFont ? { fontFamily: a.answerFont } : {}),
+            }));
+        });
+    }
+    return { elements: els, heightPt: h };
+}
+//# sourceMappingURL=designs.js.map

package/dist/exercises/designs.js.map

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

package/dist/exercises/digital.d.ts

@@ -0,0 +1,69 @@
+/**
+ * What the digital outputs (#1230, #1231) need beside the records: the
+ * words of the exercise bar, how answers are checked and kept, and each
+ * style's colours. The layout carries it on `VDTDocument.exerciseDigital`;
+ * `exerciseDataOf` joins it with the records into the JSON the HTML output
+ * writes for the exercise script (`attachExercises`, `EXERCISE_SCRIPT`).
+ */
+import type { ExerciseSettings, ExerciseWords } from '../defaults/exercises.js';
+import type { ExerciseRecord } from './record.js';
+import type { Dimension } from '../types.js';
+/** The words of the digital outputs, in the document language. */
+export type ExerciseDigitalWords = Pick<ExerciseWords, 'exercise' | 'trueFalse' | 'check' | 'showSolution' | 'hideSolution' | 'reset' | 'correct' | 'wrong' | 'hint' | 'blank' | 'score'>;
+/** How one exercise style looks answered. */
+export interface ExerciseDigitalStyleInfo {
+    /** Right and wrong feedback, and the answers a solution shows. */
+    correct: string;
+    wrong: string;
+    answer: string;
+    /** The option marker (`options.marker`): a box or a ring is ticked, a
+     *  bare label is ringed. */
+    marker: 'none' | 'box' | 'circle';
+    /** The true and false labels (`trueFalse.labels`). */
+    trueFalse: [string, string];
+}
+export interface ExerciseDigital {
+    words: ExerciseDigitalWords;
+    /** `exercises.digital`. */
+    interactive: boolean;
+    persist: boolean;
+    check: 'button' | 'instant';
+    styles: Record<string, ExerciseDigitalStyleInfo>;
+}
+/** The digital part of a document's exercise settings. */
+export declare function exerciseDigitalOf(settings: ExerciseSettings): ExerciseDigital;
+/** The JSON an HTML output writes for the exercise script
+ *  (`<script type="application/json" class="pt-exercises">`). */
+export interface ExerciseData extends ExerciseDigital {
+    /** Page pixels to a point: grid geometry in the records is in points
+     *  from a drawn box's top left. */
+    pxPerPt: number;
+    /** The body text's size, page pixels: the size of the exercise bar. */
+    bodyPx: number;
+    /** The boxes stand in the text's flow (a reflowable book) rather than
+     *  on a positioned page: the bar and the solution follow the box, sized
+     *  in ems of its text. */
+    flow?: boolean;
+    exercises: ExerciseRecord[];
+}
+/** The exercise data of a laid-out document, or `undefined` when it has
+ *  no exercises (or its exercises are not answerable,
+ *  `exercises.digital.interactive: false`). */
+export declare function exerciseDataOf(doc: {
+    exercises?: ExerciseRecord[];
+    exerciseDigital?: ExerciseDigital;
+    config: {
+        page: {
+            dpi: number;
+        };
+        bodyText: {
+            fontSize: Dimension;
+        };
+    };
+}): ExerciseData | undefined;
+/** `data` as the text of a `<script type="application/json">`, in HTML
+ *  or XHTML: no `<` that would close the element early, no `&` an XML
+ *  parser would read as a reference, no line separators a reader might
+ *  trip on. */
+export declare function exerciseDataJson(data: ExerciseData): string;
+//# sourceMappingURL=digital.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digital.d.ts","sourceRoot":"","sources":["../../src/exercises/digital.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa,EACnD,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;AAErI,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;gCAC4B;IAC5B,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAClC,sDAAsD;IACtD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,2BAA2B;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAClD;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CAuB7E;AAED;iEACiE;AACjE,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD;uCACmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf;;8BAE0B;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;+CAE+C;AAC/C,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAClC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,EAAE;QAAE,IAAI,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,QAAQ,EAAE;YAAE,QAAQ,EAAE,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;CACtE,GAAG,YAAY,GAAG,SAAS,CAM3B;AAED;;;eAGe;AACf,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAO3D"}

package/dist/exercises/digital.js

@@ -0,0 +1,58 @@
+/**
+ * What the digital outputs (#1230, #1231) need beside the records: the
+ * words of the exercise bar, how answers are checked and kept, and each
+ * style's colours. The layout carries it on `VDTDocument.exerciseDigital`;
+ * `exerciseDataOf` joins it with the records into the JSON the HTML output
+ * writes for the exercise script (`attachExercises`, `EXERCISE_SCRIPT`).
+ */
+import { dimensionToPx } from '../units.js';
+/** The digital part of a document's exercise settings. */
+export function exerciseDigitalOf(settings) {
+    const w = settings.exercises.words;
+    const styles = {};
+    for (const s of settings.styles) {
+        if (styles[s.id])
+            continue;
+        styles[s.id] = {
+            correct: s.digital.correctColor.hex,
+            wrong: s.digital.wrongColor.hex,
+            answer: s.answers.color.hex,
+            marker: s.options.marker === 'box' || s.options.marker === 'circle' ? s.options.marker : 'none',
+            trueFalse: [s.trueFalse.labels[0], s.trueFalse.labels[1]],
+        };
+    }
+    return {
+        words: {
+            exercise: w.exercise, trueFalse: w.trueFalse, check: w.check, showSolution: w.showSolution, hideSolution: w.hideSolution,
+            reset: w.reset, correct: w.correct, wrong: w.wrong, hint: w.hint, blank: w.blank, score: w.score,
+        },
+        interactive: settings.exercises.digital.interactive,
+        persist: settings.exercises.digital.persist,
+        check: settings.exercises.digital.check,
+        styles,
+    };
+}
+/** The exercise data of a laid-out document, or `undefined` when it has
+ *  no exercises (or its exercises are not answerable,
+ *  `exercises.digital.interactive: false`). */
+export function exerciseDataOf(doc) {
+    const records = doc.exercises;
+    const digital = doc.exerciseDigital;
+    if (!records || records.length === 0 || !digital || !digital.interactive)
+        return undefined;
+    const pxPerPt = doc.config.page.dpi / 72;
+    return { ...digital, pxPerPt, bodyPx: dimensionToPx(doc.config.bodyText.fontSize, doc.config.page.dpi), exercises: records };
+}
+/** `data` as the text of a `<script type="application/json">`, in HTML
+ *  or XHTML: no `<` that would close the element early, no `&` an XML
+ *  parser would read as a reference, no line separators a reader might
+ *  trip on. */
+export function exerciseDataJson(data) {
+    return JSON.stringify(data)
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+//# sourceMappingURL=digital.js.map

package/dist/exercises/digital.js.map

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

package/dist/exercises/expand.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The exercises of a document set as ordinary blocks (#1227): each
+ * `:::exercise` becomes a box (its style's `box`, or a frameless one) of
+ * paragraphs, chips and drawn boxes the layout already knows — so an
+ * exercise is placed, split, balanced, tagged and painted as any box is.
+ * Its solutions go where the book says (#1229), and every exercise leaves
+ * a record of what it asks and answers for the digital outputs (#1230).
+ */
+import type { ContentBlock } from '../parse/index.js';
+import type { CalloutStyleConfig, ChipStyleConfig, DigitSystem, HeadingCounters, OutlineEntry, ParagraphStyleConfig } from '../types.js';
+import type { ExerciseSettings } from '../defaults/exercises.js';
+import type { ExerciseIssue, ExerciseModel } from './types.js';
+import type { ExerciseRecord } from './record.js';
+/** Container ids of the synthetic boxes and groups (clear of the parser's
+ *  and of the other synthetic bases: 1e9 chapter-end notes, 1.5e9
+ *  listings, 1.75e9 flow columns, 1.8e9 frames, 1.9e9 comic text, 2e9
+ *  page-span embeds). */
+export declare const EXERCISE_CONTAINER_BASE = 1600000000;
+/** What the expansion needs from the document. */
+export interface ExpandContext {
+    settings: ExerciseSettings;
+    /** The document's locale and digits. */
+    locale?: string;
+    digits?: DigitSystem;
+    /** Heading counters before the document (a book's earlier chapters). */
+    headings?: HeadingCounters;
+    /** Exercise counters carried from earlier chapters, by counter name. */
+    counters?: Record<string, number>;
+    /** The size of the text, points, and the room across a column. */
+    bodySizePt: number;
+    lineHeightPt: number;
+    measurePt: number;
+    /** A right-to-left document (its designs are mirrored). */
+    rtl?: boolean;
+    /** The text's font family: drawn letters (grids, matching) use it. */
+    bodyFont?: string;
+    /** Ids of the configured box styles (a style's `box` must name one). */
+    boxIds: ReadonlySet<string>;
+    /** The room a box style takes across (its side padding and border),
+     *  points, by id: what an exercise set on that box has less to draw on. */
+    boxInsets?: ReadonlyMap<string, number>;
+    /** The book's outline, whose `exercise` entries a
+     *  `:::solutions{scope="book"}` prints (#1229). */
+    outline?: readonly OutlineEntry[];
+}
+export interface ExerciseExpansion {
+    blocks: ContentBlock[];
+    /** Whether any exercise was set. */
+    wrapped: boolean;
+    boxes: CalloutStyleConfig[];
+    paragraphStyles: ParagraphStyleConfig[];
+    chipStyles: ChipStyleConfig[];
+    records: ExerciseRecord[];
+    issues: ExerciseIssue[];
+    /** The counters after the document, for the next chapter. */
+    counters: Record<string, number>;
+}
+/** The exercise numbers of a document, each exercise's own counter reset
+ *  by the heading level its style names. */
+export declare function numberExercises(blocks: readonly ContentBlock[], exercises: ExerciseModel[], ctx: ExpandContext): {
+    numbers: Map<number, string>;
+    counters: Record<string, number>;
+};
+/**
+ * Set the exercises of `blocks`. Blocks outside exercises pass as they are;
+ * a `:::solutions` line becomes the solutions the book prints there.
+ */
+export declare function expandExercises(blocks: readonly ContentBlock[], ctx: ExpandContext): ExerciseExpansion;
+/** A length in points, `em` read against `sizePt`. */
+export declare function dimPt(d: {
+    value: number;
+    unit: string;
+}, sizePt: number): number;
+//# sourceMappingURL=expand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expand.d.ts","sourceRoot":"","sources":["../../src/exercises/expand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAuD,MAAM,mBAAmB,CAAC;AAE3G,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACzI,OAAO,KAAK,EAAE,gBAAgB,EAAkD,MAAM,0BAA0B,CAAC;AAIjH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM/D,OAAO,KAAK,EAAoB,cAAc,EAAgB,MAAM,aAAa,CAAC;AAElF;;;yBAGyB;AACzB,eAAO,MAAM,uBAAuB,aAAgB,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B;+EAC2E;IAC3E,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;uDACmD;IACnD,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAyCD;4CAC4C;AAC5C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA6BnL;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,iBAAiB,CAmGtG;AAi1BD,sDAAsD;AACtD,wBAAgB,KAAK,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAShF"}