@kensio/pinyinjs 1.7.3 → 1.7.5

package/dist/cli/help.js

@@ -1,110 +1,16 @@
 import { COMMANDS } from "./commands.js";
+import { flagLine, GLOBAL_HELP } from "./global-help.js";
 /**
- * What each flag does, for the help.
+ * How wide the command column is, derived rather than written down.
  *
- * Keyed by flag name so that a command's help lists exactly the flags it takes
- * and nothing else.
- */
-const FLAG_HELP = new Map([
-    ["notation", "marks (default), numbers, superscript or none"],
-    ["locale", "zh-CN (default) or zh-TW"],
-    ["apostrophe", "always (default), standard or never"],
-    ["capitals", "auto (default), proper or none"],
-    ["punctuation", "latin (default) or keep"],
-    ["no-grouping", "do not apply GB/T 16159 word spacing"],
-    ["third-tone", "write third-tone sandhi: nǐ hǎo becomes ní hǎo"],
-    ["no-sandhi", "do not write 一 and 不 sandhi"],
-    ["tones", "numbers (default) or none"],
-    ["require-tones", "count a syllable typed with no tone as wrong"],
-    ["require-spacing", "count the word spacing towards the score"],
-    ["separator", "what goes between words, - by default"],
-    ["syllables", "join (default) or separate"],
-    ["umlaut", "how ü is written: v (default) or u"],
-    ["hash", "add a short hash of the text, to narrow collisions"],
-    ["hash-length", "how many characters that hash is, 4 by default"],
-    ["max-length", "the longest the slug may be, cut at a word"],
-    ["fallback", "what to write where a text slugs to nothing"],
-    ["read-numbers", "say the digits rather than keeping them"],
-    ["query", "the pinyin to look for: beijing, bei jing or bj"],
-    ["greedy", "decode with the old longest-match baseline"],
-    ["system", "write it in bopomofo, wade-giles, yale, gwoyeu or ipa"],
-    ["no-tone-classes", "leave the tone classes off"],
-    ["no-uncertain", "do not mark uncertain readings"],
-    ["no-lang", "leave the lang attribute off"],
-    ["from", "pinyin, wade-giles or bopomofo (auto by default)"],
-    ["to", "zh-Hans (default), zh-Hant, zh-Hant-TW or zh-Hant-HK"],
-    ["from-script", "Hans or Hant, where detection cannot tell"],
-    ["data", "read the dictionary from this directory"],
-    ["tier", "core, standard or full (default)"],
-]);
-/**
- * How wide the command column is in the listing.
- *
- * Derived from the longest name rather than fixed, because a fixed 10 was
- * exactly the width of `transcribe` and ran the summary straight into it. A
+ * Hard-coding it was how the table last went wrong: a fixed 12 was exactly
+ * the width of `transcribe` and ran the summary straight into it. A
  * number that has to be revisited whenever a command is added is a number that
  * will not be.
  */
 const COMMAND_WIDTH = Math.max(...COMMANDS.map((command) => command.name.length)) + 2;
 /**
- * The flags that take a value after them, as opposed to standing alone.
- */
-const VALUE_FLAGS = new Set([
-    "query",
-    "from",
-    "to",
-    "from-script",
-    "system",
-    "notation",
-    "locale",
-    "apostrophe",
-    "capitals",
-    "punctuation",
-    "tones",
-    "separator",
-    "syllables",
-    "umlaut",
-    "hash-length",
-    "max-length",
-    "fallback",
-]);
-/**
- * A flag as the help writes it, before its description.
- */
-function flagWritten(name) {
-    return `--${name}${VALUE_FLAGS.has(name) ? " <value>" : ""}`;
-}
-/**
- * The global flags, listed under every command's help.
- *
- * Both spellings of the colour flags are listed rather than one being a quiet
- * alias: nobody should have to discover which of the two this command chose.
- */
-const GLOBAL_FLAG_HELP = [
-    ["--data <dir>", "read the dictionary from this directory"],
-    ["--tier <tier>", "core, standard or full (default)"],
-    ["--colour, --color", "colour the tones, terminal or not"],
-    ["--no-colour, --no-color", "leave the tones uncoloured"],
-    ["--json", "write one JSON document per answer"],
-    ["-h, --help", "show this help"],
-    ["-v, --version", "show the version"],
-];
-/**
- * How wide the flag column is, which is the longest flag written plus a gap.
- *
- * Derived for the same reason {@link COMMAND_WIDTH} is: it was a fixed 23, and
- * `--no-colour, --no-color` is exactly 23 characters long.
- */
-const FLAG_WIDTH = Math.max(...GLOBAL_FLAG_HELP.map(([flag]) => flag.length), ...[...FLAG_HELP.keys()].map((name) => flagWritten(name).length)) + 2;
-const GLOBAL_HELP = GLOBAL_FLAG_HELP.map(([flag, help]) => `  ${flag.padEnd(FLAG_WIDTH)}${help}`);
-/**
- * A flag as the help lists it.
- */
-function flagLine(name) {
-    return `  ${flagWritten(name).padEnd(FLAG_WIDTH)}${FLAG_HELP.get(name) ?? ""}`;
-}
-/**
- * The help for one command.
+ * The help for one command: what it does, and the flags it takes.
  */
 export function commandHelp(command) {
     return [

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,aAAa,GACjB,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO;QACL,YAAY,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE;QAClF,EAAE;QACF,KAAK,OAAO,CAAC,OAAO,GAAG;QACvB,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAClC,CAAC,CAAC,CAAC,EAAE,EAAE,iDAAiD,CAAC;YACzD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC1B,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAClE,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;QACF,4BAA4B;QAC5B,GAAG,WAAW;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,4DAA4D;QAC5D,EAAE;QACF,iDAAiD;QACjD,EAAE;QACF,WAAW;QACX,GAAG,QAAQ,CAAC,GAAG,CACb,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CACzE;QACD,EAAE;QACF,4BAA4B;QAC5B,GAAG,WAAW;QACd,EAAE;QACF,4DAA4D;QAC5D,EAAE;QACF,WAAW;QACX,2BAA2B;QAC3B,0CAA0C;QAC1C,wBAAwB;QACxB,yBAAyB;QACzB,sBAAsB;QACtB,yCAAyC;QACzC,2BAA2B;QAC3B,+BAA+B;QAC/B,sCAAsC;KACvC,CAAC;AACJ,CAAC"}

package/dist/cli/html-commands.d.ts

@@ -0,0 +1,13 @@
+import { type Command } from "./command.js";
+/**
+ * Convert each text to HTML, one element per syllable.
+ */
+export declare const HTML: Command;
+/**
+ * Annotate each text: the hanzi, with its reading above.
+ *
+ * Uncoloured for the same reason `html` is — the classes are the hook, and a
+ * terminal escape code inside markup would be pasted into a page.
+ */
+export declare const ANNOTATE: Command;
+//# sourceMappingURL=html-commands.d.ts.map

package/dist/cli/html-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-commands.d.ts","sourceRoot":"","sources":["../../src/cli/html-commands.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,OAalB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,OAatB,CAAC"}

package/dist/cli/html-commands.js

@@ -0,0 +1,49 @@
+/**
+ * The conversions that hand back markup rather than text.
+ *
+ * `html` writes one element per syllable and `annotate` puts the reading above
+ * the hanzi as ruby. They sit together because they take the same options and
+ * are both uncoloured for the same reason: the classes are the hook, and a
+ * terminal escape code inside markup would be pasted into a page.
+ */
+import { convertToAnnotatedHtml, convertToHtml } from "../format/html.js";
+import { CONVERT_FLAGS, htmlOptions } from "./arguments.js";
+import { dictionaryOf } from "./command.js";
+/**
+ * Convert each text to HTML, one element per syllable.
+ */
+export const HTML = {
+    name: "html",
+    summary: "hanzi to pinyin as HTML, one element per syllable",
+    argument: "[text...]",
+    flags: [...CONVERT_FLAGS, "no-tone-classes", "no-uncertain", "no-lang"],
+    needsDictionary: true,
+    run: (input) => {
+        const options = htmlOptions(input.flags);
+        return input.texts.map((text) => {
+            const html = convertToHtml(dictionaryOf(input), text, options);
+            return { lines: [html], data: { text, html } };
+        });
+    },
+};
+/**
+ * Annotate each text: the hanzi, with its reading above.
+ *
+ * Uncoloured for the same reason `html` is — the classes are the hook, and a
+ * terminal escape code inside markup would be pasted into a page.
+ */
+export const ANNOTATE = {
+    name: "annotate",
+    summary: "hanzi with its pinyin above, as ruby HTML",
+    argument: "[text...]",
+    flags: [...CONVERT_FLAGS, "no-tone-classes", "no-uncertain", "no-lang"],
+    needsDictionary: true,
+    run: (input) => {
+        const options = htmlOptions(input.flags);
+        return input.texts.map((text) => {
+            const html = convertToAnnotatedHtml(dictionaryOf(input), text, options);
+            return { lines: [html], data: { text, html } };
+        });
+    },
+};
+//# sourceMappingURL=html-commands.js.map

package/dist/cli/html-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-commands.js","sourceRoot":"","sources":["../../src/cli/html-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAgB,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,mDAAmD;IAC5D,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,CAAC,GAAG,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/D,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,2CAA2C;IACpD,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,CAAC,GAAG,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,CAAC;IACvE,eAAe,EAAE,IAAI;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,sBAAsB,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACxE,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/cli/info-command.d.ts

@@ -0,0 +1,7 @@
+import { type Command } from "./command.js";
+/**
+ * Report what is loaded, which is the first thing to check when output looks
+ * wrong.
+ */
+export declare const INFO: Command;
+//# sourceMappingURL=info-command.d.ts.map

package/dist/cli/info-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-command.d.ts","sourceRoot":"","sources":["../../src/cli/info-command.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,OA2BlB,CAAC"}

package/dist/cli/info-command.js

@@ -0,0 +1,39 @@
+/**
+ * Reporting what is loaded, which is the first thing to check when output
+ * looks wrong.
+ */
+import { ATTESTED_SYLLABLES, DICTIONARY_SYLLABLES, } from "../syllable/inventory.js";
+import { dictionaryOf } from "./command.js";
+/**
+ * Report what is loaded, which is the first thing to check when output looks
+ * wrong.
+ */
+export const INFO = {
+    name: "info",
+    summary: "which dictionary is loaded, and how big it is",
+    argument: "",
+    flags: [],
+    needsDictionary: true,
+    run: (input) => {
+        const keys = dictionaryOf(input).size;
+        const directory = input.choice.directory;
+        return [
+            {
+                lines: [
+                    `tier       ${input.choice.tier}`,
+                    `data       ${directory ?? "the artifacts that shipped"}`,
+                    `keys       ${keys.toLocaleString("en-GB")}`,
+                    `syllables  ${String(ATTESTED_SYLLABLES.length)} attested, ${String(DICTIONARY_SYLLABLES.size)} spellings in the inventory`,
+                ],
+                data: {
+                    tier: input.choice.tier,
+                    ...(directory !== undefined && { data: directory }),
+                    keys,
+                    attestedSyllables: ATTESTED_SYLLABLES.length,
+                    inventorySpellings: DICTIONARY_SYLLABLES.size,
+                },
+            },
+        ];
+    },
+};
+//# sourceMappingURL=info-command.js.map

package/dist/cli/info-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-command.js","sourceRoot":"","sources":["../../src/cli/info-command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgB,YAAY,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAY;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,+CAA+C;IACxD,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,EAAE;IACT,eAAe,EAAE,IAAI;IACrB,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;QACzC,OAAO;YACL;gBACE,KAAK,EAAE;oBACL,cAAc,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;oBACjC,cAAc,SAAS,IAAI,4BAA4B,EAAE;oBACzD,cAAc,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE;oBAC5C,cAAc,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,cAAc,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,6BAA6B;iBAC5H;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;oBACvB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;oBACnD,IAAI;oBACJ,iBAAiB,EAAE,kBAAkB,CAAC,MAAM;oBAC5C,kBAAkB,EAAE,oBAAoB,CAAC,IAAI;iBAC9C;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/cli/lookup-commands.d.ts

@@ -0,0 +1,10 @@
+import { type Command } from "./command.js";
+/**
+ * Look words up in the dictionary.
+ */
+export declare const LOOKUP: Command;
+/**
+ * Apply sandhi to written pinyin, with no dictionary at all.
+ */
+export declare const SANDHI: Command;
+//# sourceMappingURL=lookup-commands.d.ts.map

package/dist/cli/lookup-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-commands.d.ts","sourceRoot":"","sources":["../../src/cli/lookup-commands.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,OAAO,EAIb,MAAM,cAAc,CAAC;AAoDtB;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,OAUpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,OAkCpB,CAAC"}

package/dist/cli/lookup-commands.js

@@ -0,0 +1,101 @@
+/**
+ * The subcommands that look a word up rather than decode one.
+ *
+ * `lookup` reports what the dictionary stores for a word and `sandhi` shows
+ * what the runtime pass does to a reading. Neither asks the decoder to choose
+ * anything, which is what separates them from `explain` and `syllable`.
+ */
+import { applySandhi } from "../decode/sandhi.js";
+import { readWord } from "../syllable/split.js";
+import { convertOptions } from "./arguments.js";
+import { PLAIN } from "./colour.js";
+import { dictionaryOf, written, } from "./command.js";
+/**
+ * What the dictionary holds for a word.
+ */
+function entryFound(dictionary, word, paint) {
+    const entry = dictionary.lookup(word);
+    if (entry === undefined) {
+        return {
+            lines: [`${word}  not in the dictionary`],
+            data: { word, found: false },
+        };
+    }
+    const tags = [
+        entry.partOfSpeech,
+        entry.isProperNoun ? "proper noun" : "",
+    ].filter((tag) => tag !== "");
+    const others = dictionary.readingsOf(word).slice(1);
+    return {
+        lines: [
+            `${word}  ${written(entry.reading, paint)}${tags.length > 0 ? `  ${tags.join(", ")}` : ""}`,
+            ...(entry.taiwanReading === undefined
+                ? []
+                : [`  zh-TW  ${written(entry.taiwanReading, paint)}`]),
+            ...(others.length > 0
+                ? [
+                    `  also   ${others
+                        .map((reading) => written(reading, paint))
+                        .join(", ")}`,
+                ]
+                : []),
+        ],
+        data: {
+            word,
+            found: true,
+            reading: written(entry.reading, PLAIN),
+            partOfSpeech: entry.partOfSpeech,
+            isProperNoun: entry.isProperNoun,
+            ...(entry.taiwanReading !== undefined && {
+                taiwanReading: written(entry.taiwanReading, PLAIN),
+            }),
+            otherReadings: others.map((reading) => written(reading, PLAIN)),
+        },
+    };
+}
+/**
+ * Look words up in the dictionary.
+ */
+export const LOOKUP = {
+    name: "lookup",
+    summary: "what the dictionary holds for a word",
+    argument: "<word...>",
+    flags: [],
+    needsDictionary: true,
+    run: (input) => input.texts.map((word) => entryFound(dictionaryOf(input), word, input.paint)),
+};
+/**
+ * Apply sandhi to written pinyin, with no dictionary at all.
+ */
+export const SANDHI = {
+    name: "sandhi",
+    summary: "apply tone sandhi to written pinyin",
+    argument: "<pinyin...>",
+    flags: ["third-tone", "no-sandhi"],
+    needsDictionary: false,
+    run: (input) => {
+        const options = convertOptions(input.flags).sandhi;
+        return input.texts.map((text) => {
+            // Whitespace is the only word boundary written pinyin has, and third-tone
+            // sandhi needs it: 行長很喜歡 is `hángzhǎng hén xǐhuan`, where a scan that
+            // could not see the boundary would lower the 長 as well.
+            const words = text
+                .split(/\s+/u)
+                .filter((part) => part !== "")
+                .map((part) => readWord(part));
+            if (words.length === 0 || words.some((word) => word === undefined)) {
+                return {
+                    lines: [`${text}  not readable as pinyin`],
+                    data: { text, read: false },
+                };
+            }
+            const read = words.filter((word) => word !== undefined);
+            const said = applySandhi(read.flat(), options, read.map((word) => word.length));
+            return {
+                lines: [`${text}  ${written(said, input.paint)}`],
+                data: { text, read: true, pinyin: written(said, PLAIN) },
+            };
+        });
+    },
+};
+//# sourceMappingURL=lookup-commands.js.map

package/dist/cli/lookup-commands.js.map

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

package/dist/cli/match-command.d.ts

@@ -0,0 +1,11 @@
+import { type Command } from "./command.js";
+/**
+ * Filter texts by a pinyin query, best match first.
+ *
+ * Ranked rather than left in the order given, because ranking is what the
+ * scores are for and a filter nobody can see the order of is a filter that
+ * looks arbitrary. Every text still gets a line, matched or not, so that a run
+ * over a file says what it did with each of them.
+ */
+export declare const MATCH: Command;
+//# sourceMappingURL=match-command.d.ts.map

package/dist/cli/match-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-command.d.ts","sourceRoot":"","sources":["../../src/cli/match-command.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,OAAO,EAAgB,MAAM,cAAc,CAAC;AAqB1D;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,OAgDnB,CAAC"}

package/dist/cli/match-command.js

@@ -0,0 +1,76 @@
+/**
+ * Filtering texts by a pinyin query, at the command line.
+ */
+import { match } from "../search/match.js";
+import { toCharacters } from "../script/characters.js";
+import { MATCH_FLAGS, matchQuery } from "./arguments.js";
+import { dictionaryOf } from "./command.js";
+/**
+ * A text with the matched stretches marked, for a terminal.
+ *
+ * Brackets rather than colour, because the output is as likely to be piped as
+ * read: a match is a position, and a position survives being redirected into a
+ * file where an escape sequence would only clutter it.
+ */
+function marked(text, ranges) {
+    const characters = toCharacters(text);
+    const opens = new Set(ranges.map((range) => range.at));
+    const closes = new Set(ranges.map((range) => range.at + range.length - 1));
+    return characters
+        .map((character, at) => `${opens.has(at) ? "[" : ""}${character}${closes.has(at) ? "]" : ""}`)
+        .join("");
+}
+/**
+ * Filter texts by a pinyin query, best match first.
+ *
+ * Ranked rather than left in the order given, because ranking is what the
+ * scores are for and a filter nobody can see the order of is a filter that
+ * looks arbitrary. Every text still gets a line, matched or not, so that a run
+ * over a file says what it did with each of them.
+ */
+export const MATCH = {
+    name: "match",
+    summary: "filter text by a pinyin query, best first",
+    argument: "[text...]",
+    flags: [...MATCH_FLAGS],
+    needsDictionary: true,
+    run: (input) => {
+        const query = matchQuery(input.flags);
+        const found = input.texts.map((text) => ({
+            text,
+            match: match(dictionaryOf(input), text, query),
+        }));
+        const ranked = [
+            ...found
+                .filter((one) => one.match !== undefined)
+                .toSorted((first, second) => (second.match?.score ?? 0) - (first.match?.score ?? 0)),
+            ...found.filter((one) => one.match === undefined),
+        ];
+        return ranked.map((one) => {
+            if (one.match === undefined) {
+                return {
+                    lines: [`${one.text}  no match`],
+                    data: { query, text: one.text, matched: false },
+                };
+            }
+            // Rounded for the reason `explain` rounds a cost: a score is a sum of
+            // weights and a fraction, and 6.333333333333333 in a column tells a
+            // reader nothing the first two places do not.
+            const score = Math.round(one.match.score * 100) / 100;
+            return {
+                lines: [`${marked(one.text, one.match.ranges)}  ${score.toFixed(2)}`],
+                data: {
+                    query,
+                    text: one.text,
+                    matched: true,
+                    score,
+                    ranges: one.match.ranges.map((range) => ({
+                        at: range.at,
+                        length: range.length,
+                    })),
+                },
+            };
+        });
+    },
+};
+//# sourceMappingURL=match-command.js.map

package/dist/cli/match-command.js.map

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

package/dist/cli/number-command.d.ts

@@ -0,0 +1,12 @@
+import { type Command } from "./command.js";
+/**
+ * Read numbers aloud, as quantities or digit by digit.
+ *
+ * Needs no dictionary, for the same reason `syllable` and `sandhi` do not:
+ * reading a number is arithmetic and a twenty-entry reading table, not a
+ * lookup. Which of the two styles a number takes is the caller's to say —
+ * 2026年 is read out digit by digit and 2026个 is counted — so the flag is
+ * where that choice lives rather than a guess about the text around it.
+ */
+export declare const NUMBER: Command;
+//# sourceMappingURL=number-command.d.ts.map

package/dist/cli/number-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-command.d.ts","sourceRoot":"","sources":["../../src/cli/number-command.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,cAAc,CAAC;AA4BpD;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,EAAE,OAmDpB,CAAC"}

package/dist/cli/number-command.js

@@ -0,0 +1,89 @@
+/**
+ * Reading numbers aloud, as quantities or digit by digit.
+ */
+import { applySandhi } from "../decode/sandhi.js";
+import { toCharacters } from "../script/characters.js";
+import { numeralHanzi, percentHanzi, readNumeralHanzi, } from "../numerals/numerals.js";
+import { writeSyllable } from "../syllable/syllable.js";
+import { convertOptions } from "./arguments.js";
+import { column } from "./command.js";
+/**
+ * Apply the sandhi a counted quantity takes, and only there.
+ *
+ * 一百 is said `yìbǎi`, but 110 read out is `yāo yāo líng` and never
+ * `yì yì líng`, and 3.14 is `sān diǎn yī sì`: a digit said on its own keeps its
+ * citation tone, and so does everything after the decimal point, which is read
+ * digit by digit whatever the style. So the sandhi pass runs over the counted
+ * part of the number and stops at the 点.
+ */
+function counted(hanzi, reading, options, sandhi) {
+    if (options.style === "digits") {
+        return reading;
+    }
+    const point = toCharacters(hanzi).indexOf("点");
+    const quantity = point === -1 ? reading.length : point;
+    return [
+        ...applySandhi(reading.slice(0, quantity), sandhi),
+        ...reading.slice(quantity),
+    ];
+}
+/**
+ * Read numbers aloud, as quantities or digit by digit.
+ *
+ * Needs no dictionary, for the same reason `syllable` and `sandhi` do not:
+ * reading a number is arithmetic and a twenty-entry reading table, not a
+ * lookup. Which of the two styles a number takes is the caller's to say —
+ * 2026年 is read out digit by digit and 2026个 is counted — so the flag is
+ * where that choice lives rather than a guess about the text around it.
+ */
+export const NUMBER = {
+    name: "number",
+    summary: "read a number as Chinese numerals",
+    argument: "<number...>",
+    flags: [
+        "notation",
+        "digits",
+        "yao",
+        "no-liang",
+        "percent",
+        "third-tone",
+        "no-sandhi",
+    ],
+    needsDictionary: false,
+    run: (input) => {
+        const { notation, sandhi } = convertOptions(input.flags);
+        const options = {
+            style: input.flags.digits === true ? "digits" : "cardinal",
+            ...(input.flags.yao === true && { yao: true }),
+            ...(input.flags["no-liang"] === true && { liang: "never" }),
+        };
+        return input.texts.map((text) => {
+            const hanzi = input.flags.percent === true
+                ? percentHanzi(text, options)
+                : numeralHanzi(text, options);
+            const reading = hanzi === undefined ? undefined : readNumeralHanzi(hanzi, options);
+            if (hanzi === undefined || reading === undefined) {
+                return {
+                    lines: [`${text}  not a number`],
+                    data: { text, read: false },
+                };
+            }
+            const said = counted(hanzi, reading, options, sandhi);
+            const spelled = said.map((syllable) => writeSyllable(syllable, notation));
+            return {
+                lines: [
+                    `${column(text, 12)}${column(hanzi, 18)}${spelled
+                        .map((written, at) => input.paint(written, said[at]?.tone))
+                        .join(" ")}`,
+                ],
+                data: {
+                    text,
+                    hanzi,
+                    pinyin: spelled.join(" "),
+                    style: options.style,
+                },
+            };
+        });
+    },
+};
+//# sourceMappingURL=number-command.js.map

package/dist/cli/number-command.js.map

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

package/dist/cli/options.d.ts

@@ -0,0 +1,30 @@
+import type { ConvertOptions } from "../decode/convert.js";
+export { htmlOptions, scriptFrom, scriptTarget, slugOptions, } from "./format-options.js";
+import type { CheckOptions } from "../grade/check.js";
+import type { Tier } from "../dictionary/tiers.js";
+import type { Flags } from "./flags.js";
+export { colourDepth, type TranscriptionSource, transcriptionSource, transcriptionSystem, } from "./flag-values.js";
+export interface DictionaryChoice {
+    readonly tier: Tier;
+    /** Where the artifacts are, or undefined for the ones that shipped. */
+    readonly directory: string | undefined;
+}
+/**
+ * Read the dictionary flags.
+ */
+export declare function dictionaryChoice(flags: Flags): DictionaryChoice;
+/**
+ * Turn the conversion flags into the options the library takes.
+ *
+ * Only the flags actually given are passed on, so that the library's defaults
+ * stay the CLI's defaults and there is one place they are written down.
+ */
+export declare function convertOptions(flags: Flags): ConvertOptions;
+/**
+ * Turn the checking flags into the options the library takes.
+ *
+ * Every conversion flag goes through too, since a check grades against a
+ * conversion and `--locale` or `--third-tone` changes what the answer is.
+ */
+export declare function checkOptions(flags: Flags): CheckOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/cli/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EACL,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAWxC,OAAO,EACL,WAAW,EACX,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAM/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,CAqB3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAMvD"}