@kensio/pinyinjs 1.7.3 → 1.7.5

package/dist/format/slug.js.map

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

package/dist/grade/check-readings.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The reading this library produces for a text, as the checker compares it.
+ *
+ * One of the two sides `check.ts` pairs up; `typed-reading.ts` is the other.
+ * They are separate because they are reduced from different things — this from
+ * a conversion, that from a string somebody typed — and meet only in being the
+ * same shape, a syllable at a time with what was on offer beside it.
+ */
+import type { ConvertOptions } from "../decode/convert.js";
+import type { Dictionary } from "../dictionary/dictionary.js";
+import type { Syllable } from "../syllable/syllable.js";
+import type { Tone } from "../tone/tone.js";
+/**
+ * An expected syllable, with everything a typed one is allowed to be.
+ */
+export interface ExpectedSyllable {
+    readonly syllable: Syllable;
+    /**
+     * Which tones each acceptable spelling may carry.
+     *
+     * Keyed by the toneless spelling, because the two questions a verdict asks
+     * are separate: an unknown spelling is the wrong syllable, and a known
+     * spelling with an unlisted tone is the right syllable in the wrong tone.
+     */
+    readonly accepted: ReadonlyMap<string, ReadonlySet<Tone | undefined>>;
+    /** Whether a word may begin here. */
+    readonly acceptsBreak: boolean;
+    /** Whether this may be written on to the syllable before it. */
+    readonly acceptsJoin: boolean;
+    readonly source: string | undefined;
+    readonly at: number;
+}
+/**
+ * Read the text, and work out what a typed syllable is allowed to be.
+ *
+ * The three conversions each answer a different question; see
+ * {@link readingsThreeWays}. What is left here is putting one syllable's worth
+ * of all three together.
+ */
+export declare function expectedReading(dictionary: Dictionary, text: string, options: ConvertOptions): readonly ExpectedSyllable[];
+//# sourceMappingURL=check-readings.d.ts.map

package/dist/grade/check-readings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-readings.d.ts","sourceRoot":"","sources":["../../src/grade/check-readings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAO5C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;IACtE,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,SAAS,gBAAgB,EAAE,CA+B7B"}

package/dist/grade/check-readings.js

@@ -0,0 +1,36 @@
+import { acceptedReadings, readingsThreeWays, rejectedReadings, } from "./reading-tolerance.js";
+/**
+ * Read the text, and work out what a typed syllable is allowed to be.
+ *
+ * The three conversions each answer a different question; see
+ * {@link readingsThreeWays}. What is left here is putting one syllable's worth
+ * of all three together.
+ */
+export function expectedReading(dictionary, text, options) {
+    const { written, said, spaced } = readingsThreeWays(dictionary, text, options);
+    return written.map(({ piece, at, junction }, index) => {
+        // Sliced rather than indexed, so that a conversion somehow reporting fewer
+        // syllables than the others contributes nothing rather than needing a
+        // fallback: the caller's own conversion decides alone.
+        const alternate = said
+            .slice(index, index + 1)
+            .map((one) => one.piece.syllable);
+        const other = spaced.slice(index, index + 1).map((one) => one.junction);
+        return {
+            syllable: piece.syllable,
+            accepted: acceptedReadings([
+                piece.syllable,
+                ...alternate,
+                ...rejectedReadings(piece),
+            ]),
+            // A hyphen is neither a break nor a join, and so allows both: it is a
+            // boundary the standard writes inside a word, and a learner rendering it
+            // as a space has not invented one.
+            acceptsBreak: junction !== "join" || other.some((one) => one !== "join"),
+            acceptsJoin: junction !== "break" || other.some((one) => one !== "break"),
+            source: piece.source,
+            at,
+        };
+    });
+}
+//# sourceMappingURL=check-readings.js.map

package/dist/grade/check-readings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-readings.js","sourceRoot":"","sources":["../../src/grade/check-readings.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAuBhC;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAsB,EACtB,IAAY,EACZ,OAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,iBAAiB,CACjD,UAAU,EACV,IAAI,EACJ,OAAO,CACR,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE;QACpD,2EAA2E;QAC3E,sEAAsE;QACtE,uDAAuD;QACvD,MAAM,SAAS,GAAG,IAAI;aACnB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;aACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,gBAAgB,CAAC;gBACzB,KAAK,CAAC,QAAQ;gBACd,GAAG,SAAS;gBACZ,GAAG,gBAAgB,CAAC,KAAK,CAAC;aAC3B,CAAC;YACF,sEAAsE;YACtE,yEAAyE;YACzE,mCAAmC;YACnC,YAAY,EAAE,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC;YACxE,WAAW,EAAE,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC;YACzE,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,EAAE;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/grade/check.d.ts

@@ -1,4 +1,4 @@
-import { type ConvertOptions } from "../decode/convert.js";
+import type { ConvertOptions } from "../decode/convert.js";
 import type { Dictionary } from "../dictionary/dictionary.js";
 import { type Syllable } from "../syllable/syllable.js";
 /**
@@ -80,8 +80,8 @@ export interface CheckedSyllable {
      * The characters the expected syllable reads.
      *
      * Undefined where a syllable reads on into the characters named before it,
-     * exactly as {@link ConvertedPiece.source} is, and where nothing was
-     * expected at all.
+     * exactly as {@link import("../decode/convert.js").ConvertedPiece.source}
+     * is, and where nothing was expected at all.
      */
     readonly source: string | undefined;
     /**
@@ -127,7 +127,7 @@ export interface PinyinCheck {
  *   and both parse, so `bei3jīng` is not a spelling mistake.
  * - **A reading the decoder itself was unsure of.** Where another reading of
  *   the same character was there for the taking, it is accepted — see
- *   {@link rejectedReadings}. 银行 is not one of those: the word settles both
+ *   {@link import("./reading-tolerance.js").rejectedReadings}. 银行 is not one of those: the word settles both
  *   syllables, so `yínxíng` really is wrong.
  * - **Sandhi either way.** 你好 is written `nǐ hǎo` and said `ní hǎo`, and 不是
  *   is `bú shì` written and `bù shì` underneath. Both pass.

package/dist/grade/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/grade/check.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,MAAM,GACN,OAAO,GACP,SAAS,GACT,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAqaD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,WAAW,CAuBb"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/grade/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAyB,MAAM,yBAAyB,CAAC;AAI/E;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,UAAU,GACV,MAAM,GACN,OAAO,GACP,SAAS,GACT,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAkDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,KAAK,CACnB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAiB,GACzB,WAAW,CAuBb"}

package/dist/grade/check.js

@@ -1,272 +1,7 @@
-import { alignSequences } from "../accuracy/align.js";
-import { tokenisePinyin } from "../accuracy/tokenise.js";
-import { convertPieces, convertPiecesUnscored, } from "../decode/convert.js";
-import { READING_CHARGE } from "../decode/lattice.js";
-import { toCharacters } from "../script/characters.js";
-import { readSyllable, writeSyllableSpelling, } from "../syllable/syllable.js";
-import { NEUTRAL_TONE } from "../tone/tone.js";
-/**
- * The other corner of the sandhi square.
- *
- * A learner may write the underlying tones or the tones actually said, and both
- * are right — 你好 is written `nǐ hǎo` and said `ní hǎo`. Rather than convert
- * four times for the four combinations of {@link SandhiOptions}, this converts
- * twice and inverts both switches at once, which reaches every tone: 一 and 不
- * sandhi applies to syllables in the first and fourth tones, third-tone sandhi
- * only to syllables in the third, so the two passes never touch the same
- * syllable and each one's two forms both appear across the two corners.
- */
-function oppositeSandhi(sandhi) {
-    return {
-        yiBu: !(sandhi?.yiBu ?? true),
-        thirdTone: !(sandhi?.thirdTone ?? false),
-    };
-}
-/**
- * Where each piece's source characters start, in code points.
- *
- * Read off the sources rather than tracked through the conversion, which works
- * because every character of the text is named by exactly one piece — a piece
- * naming none is either pinyin orthography the source has no trace of, such as
- * the space between two words, or a syllable reading on into the characters the
- * piece before it named.
- */
-function sourcePositions(pieces) {
-    const positions = [];
-    let at = 0;
-    for (const piece of pieces) {
-        positions.push(at);
-        at += toCharacters(piece.source ?? "").length;
-    }
-    return positions;
-}
-/**
- * What a piece written between two syllables makes of the join.
- *
- * Only a hyphen written where the syllables would otherwise have run together
- * is 分词连写's internal boundary; anything else — a space, punctuation, a
- * stretch that was never Han — separates two words.
- */
-function junctionOver(text, held) {
-    return text === "-" && held === "join" ? "hyphen" : "break";
-}
-/**
- * The syllables a conversion writes, with their positions and what joins them.
- *
- * A conversion writes its syllables as adjacent pieces within a word — the
- * 隔音符号 is part of a syllable's own spelling rather than a piece of its own —
- * so anything standing between two of them is a boundary, and the hyphen of
- * 分词连写 is the one that is not a word boundary.
- */
-function readingSyllables(pieces) {
-    const positions = sourcePositions(pieces);
-    const syllables = [];
-    // The first syllable of a text begins a word, whatever comes before it.
-    let junction = "break";
-    for (const [at, piece] of pieces.entries()) {
-        if (piece.syllable === undefined) {
-            junction = junctionOver(piece.text, junction);
-            continue;
-        }
-        syllables.push({
-            piece: { ...piece, syllable: piece.syllable },
-            /* c8 ignore next -- one position is recorded for each piece there is */
-            at: positions[at] ?? 0,
-            junction,
-        });
-        junction = "join";
-    }
-    return syllables;
-}
-/**
- * The readings the decode turned down without much reason to.
- *
- * The decode charges {@link READING_CHARGE} for a word boundary, so a rejected
- * reading costing less than that was available without breaking any dictionary
- * word apart — see {@link import("../decode/confidence.js").isUncertain}, which
- * is the same threshold read as a question rather than as a filter. The library
- * knows it was guessing there, so a learner who guessed the other way is not
- * wrong.
- *
- * Only a rejected reading of exactly the one character this syllable reads is
- * taken. An alternative can cover a different stretch — 玩儿 read as `wánr`
- * competes with 玩 `wán` and 儿 `ér` — and a claim about other characters says
- * nothing about what belongs in this position.
- */
-function rejectedReadings(piece) {
-    const { confidence, source } = piece;
-    if (source === undefined || toCharacters(source).length !== 1) {
-        return [];
-    }
-    return (confidence?.alternatives ?? []).flatMap((alternative) => {
-        const [syllable] = alternative.reading;
-        return alternative.cost < READING_CHARGE &&
-            alternative.to - alternative.from === 1 &&
-            alternative.reading.length === 1 &&
-            syllable !== undefined
-            ? [syllable]
-            : [];
-    });
-}
-/**
- * Gather readings into the spellings and tones they allow.
- *
- * The tone is allowed to be undefined only because {@link Syllable.tone} is: a
- * reading that came out of the dictionary always carries one.
- */
-function acceptedReadings(readings) {
-    const accepted = new Map();
-    for (const syllable of readings) {
-        const base = writeSyllableSpelling(syllable);
-        const tones = accepted.get(base) ?? new Set();
-        tones.add(syllable.tone);
-        accepted.set(base, tones);
-    }
-    return accepted;
-}
-/**
- * Read the text, and work out what a typed syllable is allowed to be.
- *
- * Three conversions of the same text, and each one answers a different question.
- * The first is the answer itself, with the confidence report beside it. The
- * second is the other corner of the sandhi square, which is where the second
- * form of every tone comes from. The third is the same text written under the
- * other spacing convention, which is where a boundary's tolerance comes from:
- * 分词连写 is what puts 了 on its verb and separates 市 from 南京, and a learner
- * who wrote the words the dictionary knows instead — `tā kàn le`, `Nánjīngshì`
- * — has written one of the two conventions this package implements rather than
- * made a mistake.
- *
- * All three decode identically. Sandhi rewrites tones and 分词连写 moves
- * boundaries; neither touches the syllables underneath, so all three line up one
- * for one.
- */
-function expectedReading(dictionary, text, options) {
-    const written = readingSyllables(convertPieces(dictionary, text, options));
-    const said = readingSyllables(convertPiecesUnscored(dictionary, text, {
-        ...options,
-        sandhi: oppositeSandhi(options.sandhi),
-    }));
-    const spaced = readingSyllables(convertPiecesUnscored(dictionary, text, {
-        ...options,
-        grouping: !(options.grouping ?? true),
-    }));
-    return written.map(({ piece, at, junction }, index) => {
-        // Sliced rather than indexed, so that a conversion somehow reporting fewer
-        // syllables than the others contributes nothing rather than needing a
-        // fallback: the caller's own conversion decides alone.
-        const alternate = said
-            .slice(index, index + 1)
-            .map((one) => one.piece.syllable);
-        const other = spaced.slice(index, index + 1).map((one) => one.junction);
-        return {
-            syllable: piece.syllable,
-            accepted: acceptedReadings([
-                piece.syllable,
-                ...alternate,
-                ...rejectedReadings(piece),
-            ]),
-            // A hyphen is neither a break nor a join, and so allows both: it is a
-            // boundary the standard writes inside a word, and a learner rendering it
-            // as a space has not invented one.
-            acceptsBreak: junction !== "join" || other.some((one) => one !== "join"),
-            acceptsJoin: junction !== "break" || other.some((one) => one !== "break"),
-            source: piece.source,
-            at,
-        };
-    });
-}
-/**
- * Read what was typed, one syllable at a time.
- *
- * {@link tokenisePinyin} is what the decoder is scored with, and it is tolerant
- * in the two ways that matter here: word spacing is discarded, and the
- * apostrophes and hyphens inside a word are read as the syllable boundaries
- * they are and dropped. Both are orthography rather than pronunciation.
- *
- * A stretch that is not pinyin at all comes back whole, and is reported as
- * written rather than thrown away.
- */
-function typedReading(typed) {
-    const { syllables, wordStarts } = tokenisePinyin(typed);
-    return syllables.map((text, at) => {
-        const syllable = readSyllable(text);
-        return {
-            text,
-            syllable,
-            base: syllable === undefined
-                ? text.toLowerCase().normalize("NFC")
-                : writeSyllableSpelling(syllable),
-            tone: syllable?.tone,
-            startsWord: wordStarts.has(at),
-        };
-    });
-}
-/**
- * Match the expected syllables up with the typed ones.
- *
- * Aligned on the toneless spellings, for the reason
- * {@link import("../accuracy/score.js").scoreCase} aligns on them: a syllable
- * dropped or invented halfway through would otherwise knock everything after it
- * out of step, and be reported as a mistake on every syllable rather than on
- * the one.
- *
- * What the alignment leaves over is then paired off within each gap, which is
- * what turns two unrelated stretches into substitutions: 银行 typed `yínxíng`
- * anchors on `yín`, leaving one expected `háng` against one typed `xíng` — one
- * wrong syllable rather than one missing and one invented.
- */
-function pairSyllables(expected, actual) {
-    const pairs = [];
-    let held = 0;
-    let typed = 0;
-    const gap = (untilExpected, untilActual) => {
-        while (held < untilExpected || typed < untilActual) {
-            const takesExpected = held < untilExpected;
-            const takesActual = typed < untilActual;
-            pairs.push({
-                expected: takesExpected ? held : undefined,
-                actual: takesActual ? typed : undefined,
-            });
-            held += takesExpected ? 1 : 0;
-            typed += takesActual ? 1 : 0;
-        }
-    };
-    for (const anchor of alignSequences(expected, actual)) {
-        gap(anchor.expected, anchor.actual);
-        pairs.push({ expected: held, actual: typed });
-        held++;
-        typed++;
-    }
-    gap(expected.length, actual.length);
-    return pairs;
-}
-/**
- * What a typed syllable is, against what was expected in its place.
- *
- * The neutral tone is the one tone pinyin writes with no mark at all, so a
- * syllable expected in it and typed without one has had its tone written
- * correctly rather than left off.
- */
-function verdictFor(expected, actual) {
-    const tones = expected.accepted.get(actual.base);
-    if (tones === undefined) {
-        return "wrong";
-    }
-    if (actual.tone === undefined) {
-        return tones.has(NEUTRAL_TONE) ? "correct" : "toneless";
-    }
-    return tones.has(actual.tone) ? "correct" : "tone";
-}
-/**
- * Where a typed syllable falls against the word boundaries.
- */
-function spacingFor(expected, actual) {
-    if (actual.startsWord) {
-        return expected.acceptsBreak ? "correct" : "split";
-    }
-    return expected.acceptsJoin ? "correct" : "joined";
-}
+import { pairSyllables, spacingFor, verdictFor } from "./pair-syllables.js";
+import { writeSyllableSpelling } from "../syllable/syllable.js";
+import { expectedReading } from "./check-readings.js";
+import { typedReading } from "./typed-reading.js";
 /**
  * Mark one pairing.
  *
@@ -315,7 +50,7 @@ function checkPair(expected, actual, required) {
  *   and both parse, so `bei3jīng` is not a spelling mistake.
  * - **A reading the decoder itself was unsure of.** Where another reading of
  *   the same character was there for the taking, it is accepted — see
- *   {@link rejectedReadings}. 银行 is not one of those: the word settles both
+ *   {@link import("./reading-tolerance.js").rejectedReadings}. 银行 is not one of those: the word settles both
  *   syllables, so `yínxíng` really is wrong.
  * - **Sandhi either way.** 你好 is written `nǐ hǎo` and said `ní hǎo`, and 不是
  *   is `bú shì` written and `bù shì` underneath. Both pass.

package/dist/grade/check.js.map

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

package/dist/grade/pair-syllables.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Matching the expected syllables up with the typed ones.
+ *
+ * Aligned on the toneless spellings, so one dropped syllable is one mistake
+ * rather than a mistake on every syllable after it.
+ */
+import type { PinyinVerdict, SpacingVerdict } from "./check.js";
+import type { ExpectedSyllable } from "./check-readings.js";
+import type { TypedSyllable } from "./typed-reading.js";
+/**
+ * Which expected syllable a typed one was matched with, where either has one.
+ */
+interface Pairing {
+    readonly expected: number | undefined;
+    readonly actual: number | undefined;
+}
+/**
+ * Match the expected syllables up with the typed ones.
+ *
+ * Aligned on the toneless spellings, for the reason
+ * {@link import("../accuracy/score.js").scoreCase} aligns on them: a syllable
+ * dropped or invented halfway through would otherwise knock everything after it
+ * out of step, and be reported as a mistake on every syllable rather than on
+ * the one.
+ *
+ * What the alignment leaves over is then paired off within each gap, which is
+ * what turns two unrelated stretches into substitutions: 银行 typed `yínxíng`
+ * anchors on `yín`, leaving one expected `háng` against one typed `xíng` — one
+ * wrong syllable rather than one missing and one invented.
+ */
+export declare function pairSyllables(expected: readonly string[], actual: readonly string[]): readonly Pairing[];
+/**
+ * What a typed syllable is, against what was expected in its place.
+ *
+ * The neutral tone is the one tone pinyin writes with no mark at all, so a
+ * syllable expected in it and typed without one has had its tone written
+ * correctly rather than left off.
+ */
+export declare function verdictFor(expected: ExpectedSyllable, actual: TypedSyllable): PinyinVerdict;
+/**
+ * Where a typed syllable falls against the word boundaries.
+ */
+export declare function spacingFor(expected: ExpectedSyllable, actual: TypedSyllable): SpacingVerdict;
+export {};
+/**
+ * What is required of a check beyond reading the syllables right.
+ */
+//# sourceMappingURL=pair-syllables.d.ts.map

package/dist/grade/pair-syllables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-syllables.d.ts","sourceRoot":"","sources":["../../src/grade/pair-syllables.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,SAAS,OAAO,EAAE,CA2BpB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,aAAa,GACpB,aAAa,CASf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,aAAa,GACpB,cAAc,CAKhB;;AAED;;GAEG"}

package/dist/grade/pair-syllables.js

@@ -0,0 +1,71 @@
+import { alignSequences } from "../accuracy/align.js";
+import { NEUTRAL_TONE } from "../tone/tone.js";
+/**
+ * Match the expected syllables up with the typed ones.
+ *
+ * Aligned on the toneless spellings, for the reason
+ * {@link import("../accuracy/score.js").scoreCase} aligns on them: a syllable
+ * dropped or invented halfway through would otherwise knock everything after it
+ * out of step, and be reported as a mistake on every syllable rather than on
+ * the one.
+ *
+ * What the alignment leaves over is then paired off within each gap, which is
+ * what turns two unrelated stretches into substitutions: 银行 typed `yínxíng`
+ * anchors on `yín`, leaving one expected `háng` against one typed `xíng` — one
+ * wrong syllable rather than one missing and one invented.
+ */
+export function pairSyllables(expected, actual) {
+    const pairs = [];
+    let held = 0;
+    let typed = 0;
+    const gap = (untilExpected, untilActual) => {
+        while (held < untilExpected || typed < untilActual) {
+            const takesExpected = held < untilExpected;
+            const takesActual = typed < untilActual;
+            pairs.push({
+                expected: takesExpected ? held : undefined,
+                actual: takesActual ? typed : undefined,
+            });
+            held += takesExpected ? 1 : 0;
+            typed += takesActual ? 1 : 0;
+        }
+    };
+    for (const anchor of alignSequences(expected, actual)) {
+        gap(anchor.expected, anchor.actual);
+        pairs.push({ expected: held, actual: typed });
+        held++;
+        typed++;
+    }
+    gap(expected.length, actual.length);
+    return pairs;
+}
+/**
+ * What a typed syllable is, against what was expected in its place.
+ *
+ * The neutral tone is the one tone pinyin writes with no mark at all, so a
+ * syllable expected in it and typed without one has had its tone written
+ * correctly rather than left off.
+ */
+export function verdictFor(expected, actual) {
+    const tones = expected.accepted.get(actual.base);
+    if (tones === undefined) {
+        return "wrong";
+    }
+    if (actual.tone === undefined) {
+        return tones.has(NEUTRAL_TONE) ? "correct" : "toneless";
+    }
+    return tones.has(actual.tone) ? "correct" : "tone";
+}
+/**
+ * Where a typed syllable falls against the word boundaries.
+ */
+export function spacingFor(expected, actual) {
+    if (actual.startsWord) {
+        return expected.acceptsBreak ? "correct" : "split";
+    }
+    return expected.acceptsJoin ? "correct" : "joined";
+}
+/**
+ * What is required of a check beyond reading the syllables right.
+ */
+//# sourceMappingURL=pair-syllables.js.map

package/dist/grade/pair-syllables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair-syllables.js","sourceRoot":"","sources":["../../src/grade/pair-syllables.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAY/C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,MAAyB;IAEzB,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,GAAG,GAAG,CAAC,aAAqB,EAAE,WAAmB,EAAQ,EAAE;QAC/D,OAAO,IAAI,GAAG,aAAa,IAAI,KAAK,GAAG,WAAW,EAAE,CAAC;YACnD,MAAM,aAAa,GAAG,IAAI,GAAG,aAAa,CAAC;YAC3C,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC;gBACT,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAC1C,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aACxC,CAAC,CAAC;YACH,IAAI,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;IACV,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,MAAqB;IAErB,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,MAAqB;IAErB,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED;;GAEG"}

package/dist/grade/reading-syllables.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The syllables a conversion wrote, and what stands between them.
+ *
+ * The first half of reducing an answer to something comparable: a list of
+ * pieces becomes a list of syllables, each knowing where in the text it came
+ * from and whether a word began there. Nothing here weighs anything — that is
+ * `reading-tolerance.ts`, which decides what a learner may have written
+ * instead.
+ */
+import type { ConvertedPiece } from "../decode/convert.js";
+import type { Syllable } from "../syllable/syllable.js";
+/**
+ * A piece of a conversion that writes a syllable.
+ */
+export type ReadingPiece = ConvertedPiece & {
+    readonly syllable: Syllable;
+};
+/**
+ * What a conversion writes between one syllable and the one before it.
+ *
+ * `hyphen` is its own answer rather than a kind of break because it is one:
+ * 干干净净 is `gāngān-jìngjìng`, a single orthographic word with a boundary
+ * inside it, which is why {@link import("../syllable/split.js").splitSyllables}
+ * reads a hyphen as a syllable boundary and not a word one.
+ */
+export type Junction = "join" | "hyphen" | "break";
+/**
+ * One syllable of a conversion, with where it is and what precedes it.
+ */
+export interface ReadingSyllable {
+    readonly piece: ReadingPiece;
+    readonly at: number;
+    readonly junction: Junction;
+}
+/**
+ * Where each piece's source characters start, in code points.
+ *
+ * Read off the sources rather than tracked through the conversion, which works
+ * because every character of the text is named by exactly one piece — a piece
+ * naming none is either pinyin orthography the source has no trace of, such as
+ * the space between two words, or a syllable reading on into the characters the
+ * piece before it named.
+ */
+export declare function sourcePositions(pieces: readonly ConvertedPiece[]): readonly number[];
+/**
+ * What a piece written between two syllables makes of the join.
+ *
+ * Only a hyphen written where the syllables would otherwise have run together
+ * is 分词连写's internal boundary; anything else — a space, punctuation, a
+ * stretch that was never Han — separates two words.
+ */
+export declare function junctionOver(text: string, held: Junction): Junction;
+/**
+ * The syllables a conversion writes, with their positions and what joins them.
+ *
+ * A conversion writes its syllables as adjacent pieces within a word — the
+ * 隔音符号 is part of a syllable's own spelling rather than a piece of its own —
+ * so anything standing between two of them is a boundary, and the hyphen of
+ * 分词连写 is the one that is not a word boundary.
+ */
+export declare function readingSyllables(pieces: readonly ConvertedPiece[]): readonly ReadingSyllable[];
+//# sourceMappingURL=reading-syllables.d.ts.map