@kensio/pinyinjs 0.1.0-beta.0 → 1.0.0

package/dist/cli/arguments.d.ts

@@ -1,4 +1,5 @@
 import type { ConvertOptions } from "../decode/convert.js";
+import type { ColourDepth } from "./colour.js";
 import type { Tier } from "../dictionary/tiers.js";
 import type { HtmlOptions } from "../format/html.js";
 /**
@@ -36,6 +37,9 @@ declare const FLAGS: {
     readonly "no-grouping": {
         readonly type: "boolean";
     };
+    readonly "keep-numbers": {
+        readonly type: "boolean";
+    };
     readonly "third-tone": {
         readonly type: "boolean";
     };
@@ -45,12 +49,42 @@ declare const FLAGS: {
     readonly greedy: {
         readonly type: "boolean";
     };
+    readonly digits: {
+        readonly type: "boolean";
+    };
+    readonly yao: {
+        readonly type: "boolean";
+    };
+    readonly "no-liang": {
+        readonly type: "boolean";
+    };
+    readonly percent: {
+        readonly type: "boolean";
+    };
+    readonly from: {
+        readonly type: "string";
+    };
+    readonly system: {
+        readonly type: "string";
+    };
     readonly "no-tone-classes": {
         readonly type: "boolean";
     };
     readonly "no-uncertain": {
         readonly type: "boolean";
     };
+    readonly colour: {
+        readonly type: "boolean";
+    };
+    readonly color: {
+        readonly type: "boolean";
+    };
+    readonly "no-colour": {
+        readonly type: "boolean";
+    };
+    readonly "no-color": {
+        readonly type: "boolean";
+    };
     readonly json: {
         readonly type: "boolean";
     };
@@ -109,6 +143,39 @@ export declare function parseArguments(argv: readonly string[]): ParsedArguments
  * --no-uncertain` would look like it had been honoured.
  */
 export declare function checkFlags(flags: Flags, allowed: readonly FlagName[], command: string): void;
+/**
+ * Which system the text handed to `transcribe` is written in.
+ *
+ * `auto` reads bopomofo as bopomofo and everything else as pinyin, which is as
+ * far as detection can honestly go: bopomofo has a script of its own, while
+ * `chi` is a well-formed spelling in both pinyin and Wade-Giles and means
+ * different syllables in each.
+ */
+export type TranscriptionSource = "auto" | "pinyin" | "wade-giles" | "bopomofo" | "yale" | "gwoyeu" | "ipa";
+/**
+ * Read the `--from` flag.
+ */
+export declare function transcriptionSource(flags: Flags): TranscriptionSource;
+/**
+ * Read the `--system` flag.
+ */
+export declare function transcriptionSystem(flags: Flags): TranscriptionSource | undefined;
+/**
+ * How much colour a run should write, given what the terminal offered.
+ *
+ * `--colour` and `--no-colour` force it either way, and `--color` is accepted
+ * as a spelling because every other tool spells it that way and nobody should
+ * have to discover which this one chose.
+ *
+ * **`--json` is never coloured**, whatever the flags say: the option is about
+ * the plain output, and the JSON already carries the tone as a number for a
+ * caller that will do its own rendering.
+ *
+ * Forcing colour where the environment offered none — into a pipe, or past
+ * `NO_COLOR` — gets the sixteen every terminal has, because nothing is known
+ * about where that output is going.
+ */
+export declare function colourDepth(flags: Flags, offered: ColourDepth): ColourDepth;
 /**
  * Which dictionary a run should read.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD;;;;;;;GAOG;AACH,QAAA,MAAM,KAAK;;iBACD,IAAI,EAAE,QAAQ;;;iBACd,IAAI,EAAE,QAAQ;;;iBACV,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBAC5B,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBACtB,IAAI,EAAE,QAAQ;;;iBAChB,IAAI,EAAE,QAAQ;;;iBACX,IAAI,EAAE,QAAQ;;;iBACZ,IAAI,EAAE,SAAS;;;iBAChB,IAAI,EAAE,SAAS;;;iBAChB,IAAI,EAAE,SAAS;;;iBACpB,IAAI,EAAE,SAAS;;;iBACJ,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,SAAS;;;iBACzB,IAAI,EAAE,SAAS;;;iBACf,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;;iBACxB,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;CACoB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,KAAK,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EAM3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAS5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CAiBvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd,IAAI,CAMN;AAyCD;;GAEG;AACH,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,CAoB3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAMrD"}
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"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"}

package/dist/cli/arguments.js

@@ -16,11 +16,22 @@ const FLAGS = {
     capitals: { type: "string" },
     punctuation: { type: "string" },
     "no-grouping": { type: "boolean" },
+    "keep-numbers": { type: "boolean" },
     "third-tone": { type: "boolean" },
     "no-sandhi": { type: "boolean" },
     greedy: { type: "boolean" },
+    digits: { type: "boolean" },
+    yao: { type: "boolean" },
+    "no-liang": { type: "boolean" },
+    percent: { type: "boolean" },
+    from: { type: "string" },
+    system: { type: "string" },
     "no-tone-classes": { type: "boolean" },
     "no-uncertain": { type: "boolean" },
+    colour: { type: "boolean" },
+    color: { type: "boolean" },
+    "no-colour": { type: "boolean" },
+    "no-color": { type: "boolean" },
     json: { type: "boolean" },
     help: { type: "boolean", short: "h" },
     version: { type: "boolean", short: "v" },
@@ -31,6 +42,10 @@ const FLAGS = {
 export const GLOBAL_FLAGS = [
     "data",
     "tier",
+    "colour",
+    "color",
+    "no-colour",
+    "no-color",
     "json",
     "help",
     "version",
@@ -46,6 +61,7 @@ export const CONVERT_FLAGS = [
     "capitals",
     "punctuation",
     "no-grouping",
+    "keep-numbers",
     "third-tone",
     "no-sandhi",
 ];
@@ -115,6 +131,68 @@ const APOSTROPHES = ["always", "standard", "never"];
 const CAPITALS = ["auto", "proper", "none"];
 const PUNCTUATION = ["latin", "keep"];
 const TIERS = ["core", "standard", "full"];
+const SOURCES = [
+    "auto",
+    "pinyin",
+    "wade-giles",
+    "bopomofo",
+    "yale",
+    "gwoyeu",
+    "ipa",
+];
+/**
+ * Read the `--from` flag.
+ */
+export function transcriptionSource(flags) {
+    return chosen(flags, "from", SOURCES) ?? "auto";
+}
+/**
+ * Which system a conversion should be written in.
+ *
+ * `pinyin` is not a value: writing pinyin is what `convert` does with no flag
+ * at all, and offering a name for the default would suggest the others are
+ * alternatives to it rather than things it is put through afterwards.
+ */
+const SYSTEMS_WRITTEN = [
+    "bopomofo",
+    "wade-giles",
+    "yale",
+    "gwoyeu",
+    "ipa",
+];
+/**
+ * Read the `--system` flag.
+ */
+export function transcriptionSystem(flags) {
+    return chosen(flags, "system", SYSTEMS_WRITTEN);
+}
+/**
+ * How much colour a run should write, given what the terminal offered.
+ *
+ * `--colour` and `--no-colour` force it either way, and `--color` is accepted
+ * as a spelling because every other tool spells it that way and nobody should
+ * have to discover which this one chose.
+ *
+ * **`--json` is never coloured**, whatever the flags say: the option is about
+ * the plain output, and the JSON already carries the tone as a number for a
+ * caller that will do its own rendering.
+ *
+ * Forcing colour where the environment offered none — into a pipe, or past
+ * `NO_COLOR` — gets the sixteen every terminal has, because nothing is known
+ * about where that output is going.
+ */
+export function colourDepth(flags, offered) {
+    if (flags.json === true) {
+        return 0;
+    }
+    if (flags["no-colour"] === true || flags["no-color"] === true) {
+        return 0;
+    }
+    if (flags.colour === true || flags.color === true) {
+        return offered === 0 ? 16 : offered;
+    }
+    return offered;
+}
 /**
  * Read the dictionary flags.
  */
@@ -142,6 +220,7 @@ export function convertOptions(flags) {
     const capitals = chosen(flags, "capitals", CAPITALS);
     const punctuation = chosen(flags, "punctuation", PUNCTUATION);
     return {
+        ...(flags["keep-numbers"] === true && { numbers: "keep" }),
         ...(notation !== undefined && { notation }),
         ...(locale !== undefined && { locale }),
         ...(apostrophe !== undefined && { apostrophe }),

package/dist/cli/arguments.js.map

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

package/dist/cli/colour.d.ts

@@ -0,0 +1,77 @@
+import type { Tone } from "../tone/tone.js";
+/**
+ * How much colour the output can carry.
+ *
+ * Two tiers rather than one because the sixteen colours every terminal has
+ * cannot carry this palette: the nearest basic yellow to MDBG's second tone is
+ * `#cdcd00`, which is ΔE00 22.7 away and contrasts 1.70:1 against a white
+ * background. The 256-colour cube gets every tone within ΔE00 8.6 and above
+ * 3:1 on both backgrounds. See {@link TONE_COLOURS} for the numbers.
+ */
+export type ColourDepth = 0 | 16 | 256;
+/**
+ * Paint one syllable's text in its tone's colour.
+ *
+ * Takes the tone rather than the syllable so that a system spelling its
+ * syllables some other way — bopomofo, Wade-Giles — paints them the same. A
+ * tone the source never wrote is not painted, for the same reason tone 5 is
+ * not: MDBG has no colour for either.
+ */
+export type Painter = (text: string, tone: Tone | undefined) => string;
+/**
+ * One tone's colour, as the docs and their guards need it.
+ */
+export interface PaletteEntry {
+    readonly tone: Tone;
+    /** MDBG's own value, so a page quoting it cannot drift from the source. */
+    readonly mdbg: string;
+    readonly escape: string;
+}
+/**
+ * Everything the palette knows, at a given depth.
+ */
+export declare function paletteAt(depth: ColourDepth): readonly PaletteEntry[];
+/**
+ * A painter that hands text back exactly as it was.
+ */
+export declare const PLAIN: Painter;
+/**
+ * A painter for a terminal of a given depth.
+ *
+ * Depth 0 is {@link PLAIN}, so a caller never has to ask twice.
+ */
+export declare function painterFor(depth: ColourDepth): Painter;
+/**
+ * A line with its colour taken back off.
+ */
+export declare function stripColour(text: string): string;
+/**
+ * How many characters of a string a reader actually sees.
+ *
+ * A column padded with `padEnd` counts the escapes, so a coloured cell comes
+ * out short by however many bytes its colour took.
+ */
+export declare function visibleLength(text: string): number;
+/**
+ * What a terminal says about itself.
+ */
+export interface TerminalSignals {
+    /** Whether the output is going to a terminal rather than a pipe or a file. */
+    readonly isTerminal: boolean;
+    /** `NO_COLOR`, honoured whenever it is set to anything but the empty string. */
+    readonly noColour: string | undefined;
+    readonly term: string | undefined;
+    readonly colorterm: string | undefined;
+}
+/**
+ * How much colour to write, from what the terminal says about itself.
+ *
+ * Pure, and separate from the Node adapter that reads the signals, so that both
+ * answers can be asked for in a test rather than sniffed at run time.
+ *
+ * A file full of escape sequences is worse than no colour at all, so a pipe
+ * gets none; `NO_COLOR` is honoured because it is the convention every other
+ * tool honours; and `TERM=dumb` means what it says.
+ */
+export declare function depthFrom(signals: TerminalSignals): ColourDepth;
+//# sourceMappingURL=colour.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colour.d.ts","sourceRoot":"","sources":["../../src/cli/colour.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;AA6DvE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,YAAY,EAAE,CAMrE;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,OAAwB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAatD;AAYD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAgB/D"}

package/dist/cli/colour.js

@@ -0,0 +1,117 @@
+/**
+ * The palette, pinned against MDBG's stylesheet rather than guessed at.
+ *
+ * | Tone | MDBG | 256 | ΔE00 | 16 | ΔE00 |
+ * | ---: | --- | --- | ---: | --- | ---: |
+ * | 1 | `#ff0000` | 196 `#ff0000` | 0.0 | bright red | 0.0 |
+ * | 2 | `#d09000` | 136 `#af8700` | 7.8 | yellow | 22.7 |
+ * | 3 | `#00a000` | 28 `#008700` | 8.6 | green | 12.7 |
+ * | 4 | `#0044ff` | 27 `#005fff` | 7.7 | bright blue | 8.3 |
+ *
+ * **Tone 5 is not here, and that is MDBG's answer rather than an omission.**
+ * Its fifth colour is `#000000` on a light page and `#ffffff` on a dark one —
+ * the plain text colour, which in a terminal means writing no escape at all.
+ * The grey the roadmap recorded is Pleco's fifth colour, not MDBG's.
+ *
+ * A tone that was never written gets no colour either. MDBG's stylesheet
+ * carries a sixth class, `.mptd` `#808080`, but no page it serves uses it, so
+ * there is nothing attested to copy.
+ */
+const TONE_COLOURS = [
+    { tone: 1, mdbg: "#ff0000", basic: 91, extended: 196 },
+    { tone: 2, mdbg: "#d09000", basic: 33, extended: 136 },
+    { tone: 3, mdbg: "#00a000", basic: 32, extended: 28 },
+    { tone: 4, mdbg: "#0044ff", basic: 94, extended: 27 },
+];
+/**
+ * The escape that puts a terminal back to its own colours.
+ */
+const RESET = "\u{1B}[0m";
+/**
+ * The escape sequence a tone is written in, at a given depth.
+ */
+function escapeFor(colour, depth) {
+    return depth === 256
+        ? `\u{1B}[38;5;${String(colour.extended)}m`
+        : `\u{1B}[${String(colour.basic)}m`;
+}
+/**
+ * Everything the palette knows, at a given depth.
+ */
+export function paletteAt(depth) {
+    return TONE_COLOURS.map((colour) => ({
+        tone: colour.tone,
+        mdbg: colour.mdbg,
+        escape: escapeFor(colour, depth),
+    }));
+}
+/**
+ * A painter that hands text back exactly as it was.
+ */
+export const PLAIN = (text) => text;
+/**
+ * A painter for a terminal of a given depth.
+ *
+ * Depth 0 is {@link PLAIN}, so a caller never has to ask twice.
+ */
+export function painterFor(depth) {
+    if (depth === 0) {
+        return PLAIN;
+    }
+    const escapes = new Map(TONE_COLOURS.map((colour) => [colour.tone, escapeFor(colour, depth)]));
+    return (text, tone) => {
+        const escape = tone === undefined ? undefined : escapes.get(tone);
+        return escape === undefined || text === ""
+            ? text
+            : `${escape}${text}${RESET}`;
+    };
+}
+/**
+ * The escape sequences a painter writes, for measuring a line's real width.
+ *
+ * The control character is the thing being matched — it is what a terminal
+ * reads and a reader never sees — so `no-control-regex` has nothing to say
+ * here.
+ */
+// eslint-disable-next-line no-control-regex
+const ESCAPES = /\u{1B}\[[\d;]*m/gu;
+/**
+ * A line with its colour taken back off.
+ */
+export function stripColour(text) {
+    return text.replaceAll(ESCAPES, "");
+}
+/**
+ * How many characters of a string a reader actually sees.
+ *
+ * A column padded with `padEnd` counts the escapes, so a coloured cell comes
+ * out short by however many bytes its colour took.
+ */
+export function visibleLength(text) {
+    return stripColour(text).length;
+}
+/**
+ * How much colour to write, from what the terminal says about itself.
+ *
+ * Pure, and separate from the Node adapter that reads the signals, so that both
+ * answers can be asked for in a test rather than sniffed at run time.
+ *
+ * A file full of escape sequences is worse than no colour at all, so a pipe
+ * gets none; `NO_COLOR` is honoured because it is the convention every other
+ * tool honours; and `TERM=dumb` means what it says.
+ */
+export function depthFrom(signals) {
+    const { isTerminal, noColour, term = "", colorterm = "" } = signals;
+    if (!isTerminal ||
+        (noColour ?? "") !== "" ||
+        term === "dumb" ||
+        term === "") {
+        return 0;
+    }
+    const isExtended = colorterm === "truecolor" ||
+        colorterm === "24bit" ||
+        term.includes("256color") ||
+        term.includes("direct");
+    return isExtended ? 256 : 16;
+}
+//# sourceMappingURL=colour.js.map

package/dist/cli/colour.js.map

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

package/dist/cli/commands.d.ts

@@ -1,5 +1,7 @@
 import type { Dictionary } from "../dictionary/dictionary.js";
-import { type DictionaryChoice, type Flags, type FlagName } from "./arguments.js";
+import { type Syllable } from "../syllable/syllable.js";
+import { type DictionaryChoice, type Flags, type FlagName, type TranscriptionSource } from "./arguments.js";
+import { type Painter } from "./colour.js";
 /**
  * What a command is given to work with.
  */
@@ -10,6 +12,15 @@ export interface CommandInput {
     /** Loaded for the commands that declare they need one. */
     readonly dictionary: Dictionary | undefined;
     readonly choice: DictionaryChoice;
+    /**
+     * How to write a syllable, which is where tone colour is applied.
+     *
+     * Handed in rather than worked out, because whether the output is a terminal
+     * is a fact about the run and not about the command. A command that writes no
+     * syllables never calls it, and `html` deliberately does not: markup is a
+     * format for a machine, exactly as `--json` is.
+     */
+    readonly paint: Painter;
 }
 /**
  * One answer, in both the forms the CLI can write it.
@@ -44,6 +55,43 @@ export interface Command {
     readonly needsDictionary: boolean;
     readonly run: (input: CommandInput) => readonly Reported[];
 }
+/**
+ * How one system writes a word: a syllable at a time, and what it joins on.
+ *
+ * The `write*Word` helpers are each a map and a join, and this takes them apart
+ * so that every syllable can be painted its own colour. That duplicates five
+ * separators, so each entry carries the helper it stands in for and
+ * `commands.test.ts` asserts the two agree over the whole inventory in every
+ * tone state — rather than the list being trusted.
+ */
+export interface System {
+    /** What `--from` and `--system` call it. */
+    readonly name: TranscriptionSource;
+    readonly write: (syllable: Syllable) => string;
+    readonly separator: string;
+    /**
+     * How the system writes a word, with its tones or without them.
+     *
+     * `--notation none` can only be honoured where the tone is written
+     * separately*: Wade-Giles, Yale and IPA all have a way to leave it off.
+     * Bopomofo marks it with a symbol of the script and Gwoyeu Romatzyh spells
+     * it into the syllable, so for those two there is nothing to leave off and
+     * the flag is ignored rather than approximated.
+     */
+    readonly word: (syllables: readonly Syllable[], hasTones: boolean) => string;
+}
+/**
+ * Every system `transcribe` writes a column for, for the guard above.
+ */
+export declare const SYSTEMS: readonly System[];
+/**
+ * The system a `--system` or `--from` name stands for.
+ */
+export declare function systemNamed(name: TranscriptionSource | undefined): System | undefined;
+/**
+ * Write a run of syllables in one system, each syllable in its tone's colour.
+ */
+export declare function writtenWith(syllables: readonly Syllable[], system: System, paint: Painter): string;
 /**
  * Every subcommand, in the order the help lists them.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAa9D,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,QAAQ,EAGd,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,QAAQ,EAAE,CAAC;CAC5D;AAoWD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAQtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9D"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AA6B9D,OAAO,EAEL,KAAK,QAAQ,EAGd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,KAAK,EACV,KAAK,QAAQ,EAEb,KAAK,mBAAmB,EAIzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,aAAa,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,SAAS,QAAQ,EAAE,CAAC;CAC5D;AAmbD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;CAC9E;AAwCD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAMpC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,mBAAmB,GAAG,SAAS,GACpC,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,MAAM,CAIR;AAkUD;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAUtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9D"}