/**
 * 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