@kensio/pinyinjs 1.7.4 → 1.7.6

package/dist/cli/flag-values.js

@@ -0,0 +1,56 @@
+import { chosen, SOURCES } from "./flag-lists.js";
+export { APOSTROPHES, CAPITALS, chosen, counted, LOCALES, NOTATIONS, PUNCTUATION, SLUG_SYLLABLES, SLUG_TONES, SLUG_UMLAUTS, TIERS, } from "./flag-lists.js";
+/**
+ * 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.
+ */
+export 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;
+}
+//# sourceMappingURL=flag-values.js.map

package/dist/cli/flag-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag-values.js","sourceRoot":"","sources":["../../src/cli/flag-values.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,OAAO,EAA4B,MAAM,iBAAiB,CAAC;AAE5E,OAAO,EACL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACX,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,GAEN,MAAM,iBAAiB,CAAC;AAUzB;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,UAAU;IACV,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,KAAK;CACN,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAY;IAEZ,OAAO,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAoB;IAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACtC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/flags.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Every flag the CLI accepts.
+ *
+ * One table rather than one per command, because the parser needs the whole set
+ * up front; a command's own list is what rejects a flag it has no use for.
+ * Negated forms are spelled out, since `parseArgs` has no `--no-` convention of
+ * its own.
+ */
+export declare const FLAGS: {
+    readonly data: {
+        readonly type: "string";
+    };
+    readonly tier: {
+        readonly type: "string";
+    };
+    readonly notation: {
+        readonly type: "string";
+        readonly short: "n";
+    };
+    readonly locale: {
+        readonly type: "string";
+        readonly short: "l";
+    };
+    readonly apostrophe: {
+        readonly type: "string";
+    };
+    readonly capitals: {
+        readonly type: "string";
+    };
+    readonly punctuation: {
+        readonly type: "string";
+    };
+    readonly "no-grouping": {
+        readonly type: "boolean";
+    };
+    readonly "keep-numbers": {
+        readonly type: "boolean";
+    };
+    readonly "read-numbers": {
+        readonly type: "boolean";
+    };
+    readonly "third-tone": {
+        readonly type: "boolean";
+    };
+    readonly "no-sandhi": {
+        readonly type: "boolean";
+    };
+    readonly tones: {
+        readonly type: "string";
+    };
+    readonly "require-tones": {
+        readonly type: "boolean";
+    };
+    readonly "require-spacing": {
+        readonly type: "boolean";
+    };
+    readonly separator: {
+        readonly type: "string";
+    };
+    readonly syllables: {
+        readonly type: "string";
+    };
+    readonly umlaut: {
+        readonly type: "string";
+    };
+    readonly query: {
+        readonly type: "string";
+    };
+    readonly hash: {
+        readonly type: "boolean";
+    };
+    readonly "hash-length": {
+        readonly type: "string";
+    };
+    readonly "max-length": {
+        readonly type: "string";
+    };
+    readonly fallback: {
+        readonly type: "string";
+    };
+    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 to: {
+        readonly type: "string";
+    };
+    readonly "from-script": {
+        readonly type: "string";
+    };
+    readonly system: {
+        readonly type: "string";
+    };
+    readonly "no-tone-classes": {
+        readonly type: "boolean";
+    };
+    readonly "no-uncertain": {
+        readonly type: "boolean";
+    };
+    readonly "no-lang": {
+        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";
+    };
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+    };
+    readonly version: {
+        readonly type: "boolean";
+        readonly short: "v";
+    };
+};
+/**
+ * A flag's name as it is written on the command line.
+ */
+export type FlagName = keyof typeof FLAGS;
+/**
+ * Flags every command takes, whatever else it takes.
+ */
+export declare const GLOBAL_FLAGS: readonly FlagName[];
+/**
+ * The flags that map onto `ConvertOptions`, and so belong to every command that
+ * converts anything.
+ */
+export declare const CONVERT_FLAGS: readonly FlagName[];
+/**
+ * The flags `check` takes, beyond the conversion ones.
+ *
+ * Positive rather than negated — `--require-tones` rather than `--no-tones` —
+ * because both dimensions default to lenient, and a flag naming what it turns
+ * on is the one that reads the way the library's own option does.
+ */
+export declare const CHECK_FLAGS: readonly FlagName[];
+/**
+ * The flags `slug` takes, beyond the global ones.
+ *
+ * It shares the reading flags with the conversion commands and none of the
+ * writing ones: a slug settles its own notation, capitals, apostrophes and
+ * spacing, and a `--capitals` that changed nothing would be worse than an
+ * error. `--read-numbers` rather than `--keep-numbers` because a slug keeps
+ * digits by default, which is the one place it departs from `convert`.
+ */
+export declare const SLUG_FLAGS: readonly FlagName[];
+/**
+ * The flags `match` takes, beyond the global ones.
+ *
+ * The query is a flag rather than the first argument, so that the texts stay
+ * where every other command has them: `match` reads a list to filter from
+ * standard input, and a command line whose first positional meant something
+ * else could not be piped into.
+ */
+export declare const MATCH_FLAGS: readonly FlagName[];
+/**
+ * The flags `script` takes, beyond the global ones.
+ *
+ * `--from-script` rather than `--from` because `--from` already means the
+ * transcription a text is written in, and one flag name cannot carry two
+ * meanings in one help table.
+ */
+export declare const SCRIPT_FLAGS: readonly FlagName[];
+/**
+ * The flags a parse produced, before any command has looked at them.
+ */
+export type Flags = Partial<Record<FlagName, string | boolean>>;
+//# sourceMappingURL=flags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../src/cli/flags.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK;;iBACR,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;;;iBACd,IAAI,EAAE,SAAS;;;iBACf,IAAI,EAAE,SAAS;;;iBACjB,IAAI,EAAE,SAAS;;;iBAChB,IAAI,EAAE,SAAS;;;iBACrB,IAAI,EAAE,QAAQ;;;iBACJ,IAAI,EAAE,SAAS;;;iBACb,IAAI,EAAE,SAAS;;;iBACvB,IAAI,EAAE,QAAQ;;;iBACd,IAAI,EAAE,QAAQ;;;iBACjB,IAAI,EAAE,QAAQ;;;iBACf,IAAI,EAAE,QAAQ;;;iBACf,IAAI,EAAE,SAAS;;;iBACN,IAAI,EAAE,QAAQ;;;iBACf,IAAI,EAAE,QAAQ;;;iBAClB,IAAI,EAAE,QAAQ;;;iBAChB,IAAI,EAAE,SAAS;;;iBACf,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,SAAS;;;iBACR,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,QAAQ;;;iBAChB,IAAI,EAAE,QAAQ;;;iBACH,IAAI,EAAE,QAAQ;;;iBACrB,IAAI,EAAE,QAAQ;;;iBACH,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,SAAS;;;iBACpB,IAAI,EAAE,SAAS;;;iBAClB,IAAI,EAAE,SAAS;;;iBAChB,IAAI,EAAE,SAAS;;;iBACT,IAAI,EAAE,SAAS;;;iBAChB,IAAI,EAAE,SAAS;;;iBACrB,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,EAU3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAU5C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,QAAQ,EAG1C,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAazC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,QAAQ,EAAc,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,QAAQ,EAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC"}

package/dist/cli/flags.js

@@ -0,0 +1,133 @@
+/**
+ * Every flag the CLI accepts.
+ *
+ * One table rather than one per command, because the parser needs the whole set
+ * up front; a command's own list is what rejects a flag it has no use for.
+ * Negated forms are spelled out, since `parseArgs` has no `--no-` convention of
+ * its own.
+ */
+export const FLAGS = {
+    data: { type: "string" },
+    tier: { type: "string" },
+    notation: { type: "string", short: "n" },
+    locale: { type: "string", short: "l" },
+    apostrophe: { type: "string" },
+    capitals: { type: "string" },
+    punctuation: { type: "string" },
+    "no-grouping": { type: "boolean" },
+    "keep-numbers": { type: "boolean" },
+    "read-numbers": { type: "boolean" },
+    "third-tone": { type: "boolean" },
+    "no-sandhi": { type: "boolean" },
+    tones: { type: "string" },
+    "require-tones": { type: "boolean" },
+    "require-spacing": { type: "boolean" },
+    separator: { type: "string" },
+    syllables: { type: "string" },
+    umlaut: { type: "string" },
+    query: { type: "string" },
+    hash: { type: "boolean" },
+    "hash-length": { type: "string" },
+    "max-length": { type: "string" },
+    fallback: { type: "string" },
+    greedy: { type: "boolean" },
+    digits: { type: "boolean" },
+    yao: { type: "boolean" },
+    "no-liang": { type: "boolean" },
+    percent: { type: "boolean" },
+    from: { type: "string" },
+    to: { type: "string" },
+    "from-script": { type: "string" },
+    system: { type: "string" },
+    "no-tone-classes": { type: "boolean" },
+    "no-uncertain": { type: "boolean" },
+    "no-lang": { 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" },
+};
+/**
+ * Flags every command takes, whatever else it takes.
+ */
+export const GLOBAL_FLAGS = [
+    "data",
+    "tier",
+    "colour",
+    "color",
+    "no-colour",
+    "no-color",
+    "json",
+    "help",
+    "version",
+];
+/**
+ * The flags that map onto `ConvertOptions`, and so belong to every command that
+ * converts anything.
+ */
+export const CONVERT_FLAGS = [
+    "notation",
+    "locale",
+    "apostrophe",
+    "capitals",
+    "punctuation",
+    "no-grouping",
+    "keep-numbers",
+    "third-tone",
+    "no-sandhi",
+];
+/**
+ * The flags `check` takes, beyond the conversion ones.
+ *
+ * Positive rather than negated — `--require-tones` rather than `--no-tones` —
+ * because both dimensions default to lenient, and a flag naming what it turns
+ * on is the one that reads the way the library's own option does.
+ */
+export const CHECK_FLAGS = [
+    "require-tones",
+    "require-spacing",
+];
+/**
+ * The flags `slug` takes, beyond the global ones.
+ *
+ * It shares the reading flags with the conversion commands and none of the
+ * writing ones: a slug settles its own notation, capitals, apostrophes and
+ * spacing, and a `--capitals` that changed nothing would be worse than an
+ * error. `--read-numbers` rather than `--keep-numbers` because a slug keeps
+ * digits by default, which is the one place it departs from `convert`.
+ */
+export const SLUG_FLAGS = [
+    "tones",
+    "separator",
+    "syllables",
+    "umlaut",
+    "hash",
+    "hash-length",
+    "max-length",
+    "fallback",
+    "read-numbers",
+    "locale",
+    "third-tone",
+    "no-sandhi",
+];
+/**
+ * The flags `match` takes, beyond the global ones.
+ *
+ * The query is a flag rather than the first argument, so that the texts stay
+ * where every other command has them: `match` reads a list to filter from
+ * standard input, and a command line whose first positional meant something
+ * else could not be piped into.
+ */
+export const MATCH_FLAGS = ["query"];
+/**
+ * The flags `script` takes, beyond the global ones.
+ *
+ * `--from-script` rather than `--from` because `--from` already means the
+ * transcription a text is written in, and one flag name cannot carry two
+ * meanings in one help table.
+ */
+export const SCRIPT_FLAGS = ["to", "from-script"];
+//# sourceMappingURL=flags.js.map

package/dist/cli/flags.js.map

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

package/dist/cli/format-options.d.ts

@@ -0,0 +1,29 @@
+import { type ScriptTarget } from "../decode/script.js";
+import type { HtmlOptions } from "../format/html.js";
+import type { SlugOptions } from "../format/slug.js";
+import { type Script } from "../script/script.js";
+import type { Flags } from "./flags.js";
+export { colourDepth, type TranscriptionSource, transcriptionSource, transcriptionSystem, } from "./flag-values.js";
+/**
+ * Turn the slug flags into the options the library takes.
+ *
+ * `--hash-length` implies `--hash`, because asking how long the hash should be
+ * and not getting one is not a reading anybody intends.
+ */
+export declare function slugOptions(flags: Flags): SlugOptions;
+/**
+ * The same, plus the three flags that only mean anything in HTML.
+ */
+export declare function htmlOptions(flags: Flags): HtmlOptions;
+/**
+ * Which orthography `script` was asked to write. `zh-Hans` by default.
+ */
+export declare function scriptTarget(flags: Flags): ScriptTarget;
+/**
+ * The script the text was declared to be in, where the caller named one.
+ *
+ * Detection settles it otherwise, and gets it right for anything longer than a
+ * word or two. Naming it matters for text short enough to be script-neutral.
+ */
+export declare function scriptFrom(flags: Flags): Script | undefined;
+//# sourceMappingURL=format-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-options.d.ts","sourceRoot":"","sources":["../../src/cli/format-options.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,qBAAqB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUxC,OAAO,EACL,WAAW,EACX,KAAK,mBAAmB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CA4BrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAOrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAE3D"}

package/dist/cli/format-options.js

@@ -0,0 +1,72 @@
+/**
+ * The options for the commands that write a text out in some other form.
+ *
+ * Slugs, HTML and script conversion each take a shape of their own, and none
+ * of them is what the conversion itself is given.
+ */
+import { convertOptions } from "./options.js";
+import { SCRIPT_TARGETS } from "../decode/script.js";
+import { SCRIPTS } from "../script/script.js";
+import { chosen, counted, LOCALES, SLUG_SYLLABLES, SLUG_TONES, SLUG_UMLAUTS, } from "./flag-values.js";
+export { colourDepth, transcriptionSource, transcriptionSystem, } from "./flag-values.js";
+/**
+ * Turn the slug flags into the options the library takes.
+ *
+ * `--hash-length` implies `--hash`, because asking how long the hash should be
+ * and not getting one is not a reading anybody intends.
+ */
+export function slugOptions(flags) {
+    const sandhi = {
+        ...(flags["no-sandhi"] === true && { yiBu: false }),
+        ...(flags["third-tone"] === true && { thirdTone: true }),
+    };
+    const tones = chosen(flags, "tones", SLUG_TONES);
+    const syllables = chosen(flags, "syllables", SLUG_SYLLABLES);
+    const umlaut = chosen(flags, "umlaut", SLUG_UMLAUTS);
+    const locale = chosen(flags, "locale", LOCALES);
+    const separator = flags.separator;
+    const fallback = flags.fallback;
+    const hashLength = counted(flags, "hash-length");
+    const maxLength = counted(flags, "max-length");
+    return {
+        ...(flags["read-numbers"] === true && { numbers: "read" }),
+        ...(tones !== undefined && { tones }),
+        ...(syllables !== undefined && { syllables }),
+        ...(umlaut !== undefined && { umlaut }),
+        ...(locale !== undefined && { locale }),
+        ...(separator !== undefined && { separator: String(separator) }),
+        ...(fallback !== undefined && { fallback: String(fallback) }),
+        ...(hashLength === undefined
+            ? flags.hash === true && { hash: true }
+            : { hash: hashLength }),
+        ...(maxLength !== undefined && { maxLength }),
+        ...(Object.keys(sandhi).length > 0 && { sandhi }),
+    };
+}
+/**
+ * The same, plus the three flags that only mean anything in HTML.
+ */
+export function htmlOptions(flags) {
+    return {
+        ...convertOptions(flags),
+        ...(flags["no-tone-classes"] === true && { toneClasses: false }),
+        ...(flags["no-uncertain"] === true && { markUncertain: false }),
+        ...(flags["no-lang"] === true && { lang: false }),
+    };
+}
+/**
+ * Which orthography `script` was asked to write. `zh-Hans` by default.
+ */
+export function scriptTarget(flags) {
+    return chosen(flags, "to", SCRIPT_TARGETS) ?? "zh-Hans";
+}
+/**
+ * The script the text was declared to be in, where the caller named one.
+ *
+ * Detection settles it otherwise, and gets it right for anything longer than a
+ * word or two. Naming it matters for text short enough to be script-neutral.
+ */
+export function scriptFrom(flags) {
+    return chosen(flags, "from-script", SCRIPTS);
+}
+//# sourceMappingURL=format-options.js.map

package/dist/cli/format-options.js.map

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

package/dist/cli/global-help.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+export declare const GLOBAL_FLAG_HELP: readonly [readonly ["--data <dir>", "read the dictionary from this directory"], readonly ["--tier <tier>", "core, standard or full (default)"], readonly ["--colour, --color", "colour the tones, terminal or not"], readonly ["--no-colour, --no-color", "leave the tones uncoloured"], readonly ["--json", "write one JSON document per answer"], readonly ["-h, --help", "show this help"], readonly ["-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.
+ */
+export declare const FLAG_WIDTH: number;
+export declare const GLOBAL_HELP: readonly string[];
+/**
+ * A flag as the help lists it.
+ */
+export declare function flagLine(name: string): string;
+/**
+ * The help for one command.
+ */
+//# sourceMappingURL=global-help.d.ts.map

package/dist/cli/global-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-help.d.ts","sourceRoot":"","sources":["../../src/cli/global-help.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,sBAC1B,cAAc,EAAE,yCAAyC,aACzD,eAAe,EAAE,kCAAkC,aACnD,mBAAmB,EAAE,mCAAmC,aACxD,yBAAyB,EAAE,4BAA4B,aACvD,QAAQ,EAAE,oCAAoC,aAC9C,YAAY,EAAE,gBAAgB,aAC9B,eAAe,EAAE,kBAAkB,EAC5B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,UAAU,QAIhB,CAAC;AAER,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAExC,CAAC;AAEF;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;GAEG"}

package/dist/cli/global-help.js

@@ -0,0 +1,40 @@
+/**
+ * The help for the flags every command takes.
+ *
+ * Laid out to the widest flag name so the descriptions line up, which is a
+ * different table from the one a command's own flags are written into.
+ */
+import { FLAG_HELP, flagWritten } from "./flag-help.js";
+/**
+ * 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.
+ */
+export 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.
+ */
+export const FLAG_WIDTH = Math.max(...GLOBAL_FLAG_HELP.map(([flag]) => flag.length), ...[...FLAG_HELP.keys()].map((name) => flagWritten(name).length)) + 2;
+export const GLOBAL_HELP = GLOBAL_FLAG_HELP.map(([flag, help]) => `  ${flag.padEnd(FLAG_WIDTH)}${help}`);
+/**
+ * A flag as the help lists it.
+ */
+export function flagLine(name) {
+    return `  ${flagWritten(name).padEnd(FLAG_WIDTH)}${FLAG_HELP.get(name) ?? ""}`;
+}
+/**
+ * The help for one command.
+ */
+//# sourceMappingURL=global-help.js.map

package/dist/cli/global-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-help.js","sourceRoot":"","sources":["../../src/cli/global-help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,CAAC,cAAc,EAAE,yCAAyC,CAAC;IAC3D,CAAC,eAAe,EAAE,kCAAkC,CAAC;IACrD,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;IAC1D,CAAC,yBAAyB,EAAE,4BAA4B,CAAC;IACzD,CAAC,QAAQ,EAAE,oCAAoC,CAAC;IAChD,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAChC,CAAC,eAAe,EAAE,kBAAkB,CAAC;CAC7B,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GACrB,IAAI,CAAC,GAAG,CACN,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAChD,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CACjE,GAAG,CAAC,CAAC;AAER,MAAM,CAAC,MAAM,WAAW,GAAsB,gBAAgB,CAAC,GAAG,CAChE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AACjF,CAAC;AAED;;GAEG"}

package/dist/cli/help.d.ts

@@ -1,6 +1,6 @@
 import { type Command } from "./commands.js";
 /**
- * The help for one command.
+ * The help for one command: what it does, and the flags it takes.
  */
 export declare function commandHelp(command: Command): readonly string[];
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAY,MAAM,eAAe,CAAC;AAyHvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAe/D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CA2B/C"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAY,MAAM,eAAe,CAAC;AAcvD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAe/D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,MAAM,EAAE,CA2B/C"}