@kensio/pinyinjs 1.7.4 → 1.7.5

package/dist/cli/arguments.js

@@ -1,130 +1,9 @@
 import { parseArgs } from "node:util";
-import { SCRIPT_TARGETS } from "../decode/script.js";
-import { SCRIPTS } from "../script/script.js";
-/**
- * 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.
- */
-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"];
+import { FLAGS } from "./flags.js";
+import { UsageError } from "./usage-error.js";
+export { UsageError } from "./usage-error.js";
+export { checkOptions, colourDepth, convertOptions, dictionaryChoice, htmlOptions, scriptFrom, scriptTarget, slugOptions, transcriptionSource, transcriptionSystem, } from "./options.js";
+export { CHECK_FLAGS, CONVERT_FLAGS, GLOBAL_FLAGS, MATCH_FLAGS, SCRIPT_FLAGS, SLUG_FLAGS, } from "./flags.js";
 /**
  * Read the `--query` flag, which `match` cannot do without.
  */
@@ -135,22 +14,6 @@ export function matchQuery(flags) {
     }
     return String(given);
 }
-/**
- * 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"];
-/**
- * Something the command line asked for that cannot be done.
- *
- * Thrown rather than exited on, so that the caller decides what a mistake at
- * the command line is worth.
- */
-export class UsageError extends Error {
-}
 /**
  * Split a command line into its command, its arguments and its flags.
  */
@@ -183,219 +46,4 @@ export function checkFlags(flags, allowed, command) {
         }
     }
 }
-/**
- * Read a flag that takes a value, checking it against what the library accepts.
- */
-function chosen(flags, name, allowed) {
-    const given = flags[name];
-    if (given === undefined) {
-        return undefined;
-    }
-    const value = String(given);
-    const found = allowed.find((candidate) => candidate === value);
-    if (found === undefined) {
-        throw new UsageError(`--${name} must be one of ${allowed.join(", ")}, not ${value}`);
-    }
-    return found;
-}
-const NOTATIONS = [
-    "marks",
-    "numbers",
-    "superscript",
-    "none",
-];
-/**
- * Read a flag that takes a whole number, which every one of them is a count of.
- */
-function counted(flags, name) {
-    const given = flags[name];
-    if (given === undefined) {
-        return undefined;
-    }
-    const value = Number(String(given));
-    if (!Number.isSafeInteger(value) || value < 0) {
-        throw new UsageError(`--${name} must be a whole number, not ${String(given)}`);
-    }
-    return value;
-}
-const LOCALES = ["zh-CN", "zh-TW"];
-const APOSTROPHES = ["always", "standard", "never"];
-const CAPITALS = ["auto", "proper", "none"];
-const PUNCTUATION = ["latin", "keep"];
-const SLUG_TONES = ["numbers", "none"];
-const SLUG_SYLLABLES = ["join", "separate"];
-const SLUG_UMLAUTS = ["v", "u"];
-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.
- */
-export function dictionaryChoice(flags) {
-    const directory = flags.data;
-    return {
-        tier: chosen(flags, "tier", TIERS) ?? "full",
-        directory: directory === undefined ? undefined : String(directory),
-    };
-}
-/**
- * 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 function convertOptions(flags) {
-    const sandhi = {
-        ...(flags["no-sandhi"] === true && { yiBu: false }),
-        ...(flags["third-tone"] === true && { thirdTone: true }),
-    };
-    const notation = chosen(flags, "notation", NOTATIONS);
-    const locale = chosen(flags, "locale", LOCALES);
-    const apostrophe = chosen(flags, "apostrophe", APOSTROPHES);
-    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 }),
-        ...(capitals !== undefined && { capitals }),
-        ...(punctuation !== undefined && { punctuation }),
-        ...(flags["no-grouping"] === true && { grouping: false }),
-        ...(Object.keys(sandhi).length > 0 && { sandhi }),
-    };
-}
-/**
- * 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 function checkOptions(flags) {
-    return {
-        ...convertOptions(flags),
-        ...(flags["require-tones"] === true && { tones: "required" }),
-        ...(flags["require-spacing"] === true && { spacing: "required" }),
-    };
-}
-/**
- * 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=arguments.js.map

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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,KAAK,EAA6B,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,WAAW,EACX,cAAc,EAEd,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EAEX,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,aAAa,EAGb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAaD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAuB;IACpD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;YACf,OAAO,EAAE,KAAK;YACd,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAClB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;IACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,KAAY,EACZ,OAA4B,EAC5B,OAAe;IAEf,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAgB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,GAAG,OAAO,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+import { type Command } from "./command.js";
+/**
+ * Mark typed pinyin against the text it was written for.
+ *
+ * The heading carries the answer the text converts to, because a check that
+ * says only what is wrong leaves a reader hunting for what was right.
+ */
+export declare const CHECK: Command;
+//# sourceMappingURL=check-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check-command.d.ts","sourceRoot":"","sources":["../../src/cli/check-command.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,OAAO,EAKb,MAAM,cAAc,CAAC;AAyDtB;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,OAwCnB,CAAC"}

package/dist/cli/check-command.js

@@ -0,0 +1,95 @@
+/**
+ * Marking typed pinyin against the text it was written for.
+ */
+import { convertPieces } from "../decode/convert.js";
+import { check } from "../grade/check.js";
+import { writeSyllable } from "../syllable/syllable.js";
+import { CHECK_FLAGS, checkOptions, CONVERT_FLAGS, UsageError, } from "./arguments.js";
+import { column, dictionaryOf, paintedPieces, } from "./command.js";
+/**
+ * The hanzi and the pinyin typed for it, as `check` is given them.
+ *
+ * Two arguments at a terminal — `pinyinjs check 银行 yínxíng` — with everything
+ * after the first joined back up, so that unquoted pinyin with spaces in it
+ * works the way anybody would expect it to. A piped file is one pair per line,
+ * separated by a tab, since pinyin has spaces in it and the hanzi may too.
+ */
+function checkPairs(texts) {
+    if (texts.some((text) => text.includes("\t"))) {
+        return texts.map((text) => {
+            const [hanzi = "", ...rest] = text.split("\t");
+            return [hanzi, rest.join("\t")];
+        });
+    }
+    const [hanzi = "", ...rest] = texts;
+    return [[hanzi, rest.join(" ")]];
+}
+/**
+ * One checked syllable, as a line and as data.
+ *
+ * The characters, then what was expected, then what was typed, then the two
+ * verdicts. Spacing is written only where it went wrong, since `correct` on
+ * every line would bury the one that did not.
+ */
+function checkedSyllable(one, input) {
+    const expected = one.expected === undefined ? "" : writeSyllable(one.expected);
+    // Written only where it went wrong: `correct` on every line would bury the
+    // one that did not.
+    const spacing = one.spacing === "correct" ? undefined : one.spacing;
+    return {
+        line: `  ${column(one.source ?? "", 6)}${column(input.paint(expected, one.expected?.tone), 8)}${column(one.text, 8)}${column(one.verdict, 10)}${spacing ?? ""}`.trimEnd(),
+        data: {
+            verdict: one.verdict,
+            isCorrect: one.isCorrect,
+            ...(one.spacing !== undefined && { spacing: one.spacing }),
+            ...(expected !== "" && { expected }),
+            ...(one.text !== "" && { typed: one.text }),
+            ...(one.source !== undefined && { source: one.source }),
+            ...(one.at !== undefined && { at: one.at }),
+        },
+    };
+}
+/**
+ * Mark typed pinyin against the text it was written for.
+ *
+ * The heading carries the answer the text converts to, because a check that
+ * says only what is wrong leaves a reader hunting for what was right.
+ */
+export const CHECK = {
+    name: "check",
+    summary: "mark typed pinyin against the text",
+    argument: "<text> <pinyin>",
+    flags: [...CONVERT_FLAGS, ...CHECK_FLAGS],
+    needsDictionary: true,
+    run: (input) => {
+        const dictionary = dictionaryOf(input);
+        const options = checkOptions(input.flags);
+        return checkPairs(input.texts).map(([text, typed]) => {
+            if (typed === "") {
+                throw new UsageError("check needs a text and the pinyin typed for it");
+            }
+            const marked = check(dictionary, text, typed, options);
+            const score = Math.round(marked.score * 100);
+            const syllables = marked.syllables.map((one) => checkedSyllable(one, input));
+            // The answer as the conversion writes it, spacing and all, since the
+            // spacing is one of the things being marked and a reading joined by
+            // spaces would show every word broken apart.
+            const pieces = convertPieces(dictionary, text, options);
+            return {
+                lines: [
+                    `${text}  ${paintedPieces(pieces, input)}  ${String(score)}%`,
+                    ...syllables.map((one) => one.line),
+                ],
+                data: {
+                    text,
+                    typed,
+                    isCorrect: marked.isCorrect,
+                    score: marked.score,
+                    pinyin: pieces.map((piece) => piece.text).join(""),
+                    syllables: syllables.map((one) => one.data),
+                },
+            };
+        });
+    },
+};
+//# sourceMappingURL=check-command.js.map

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

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

package/dist/cli/cli-input.d.ts

@@ -0,0 +1,49 @@
+/**
+ * What the CLI needs from the world outside it, and what it reads through it.
+ *
+ * Everything Node-only lives behind {@link CliEnvironment}, so that a run can
+ * be tested by handing it strings. The two functions here are the only part of
+ * a run that touches the outside at all before a command starts.
+ */
+import type { Dictionary } from "../dictionary/dictionary.js";
+import type { ScriptTables } from "../script/conversion.js";
+import { type DictionaryChoice } from "./arguments.js";
+import type { ColourDepth } from "./colour.js";
+import type { Command } from "./commands.js";
+/**
+ * What the CLI needs from the world outside it.
+ *
+ * Everything Node-only lives behind this, so that a run can be tested by
+ * handing it strings.
+ */
+export interface CliEnvironment {
+    readonly version: string;
+    /** Standard input, or the empty string where there is none to read. */
+    readonly readInput: () => Promise<string>;
+    readonly loadDictionary: (choice: DictionaryChoice) => Promise<Dictionary>;
+    /**
+     * The script conversion tables, for the one command that converts scripts.
+     *
+     * Separate from the dictionary because the file is: nothing that converts
+     * hanzi to pinyin should wait on 96 KB it will not read.
+     */
+    readonly loadScriptTables: (choice: DictionaryChoice) => Promise<ScriptTables>;
+    /**
+     * How much colour the output can carry, before any flag has its say.
+     *
+     * Here rather than sniffed inside a command, because a command reaching for
+     * `process.stdout.isTTY` would put a decision in the one place the coverage
+     * gate cannot see. An environment states the answer and a test can ask for
+     * either one. `depthFrom` in `colour.ts` is how the Node adapter arrives at
+     * it, and is a pure function for the same reason.
+     */
+    readonly colours: ColourDepth;
+}
+/**
+ * What a command was asked to act on, or a usage error saying it was nothing.
+ *
+ * A command that silently prints nothing because standard input was a terminal
+ * looks broken rather than misused.
+ */
+export declare function inputFor(command: Command, given: readonly string[], environment: CliEnvironment): Promise<readonly string[]>;
+//# sourceMappingURL=cli-input.d.ts.map

package/dist/cli/cli-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.d.ts","sourceRoot":"","sources":["../../src/cli/cli-input.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAAc,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3E;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CACzB,MAAM,EAAE,gBAAgB,KACrB,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAuBD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAQ5B"}

package/dist/cli/cli-input.js

@@ -0,0 +1,31 @@
+import { UsageError } from "./arguments.js";
+/**
+ * The lines a command should act on: its arguments, or standard input.
+ *
+ * Input is split into lines so that every command works the same way whether it
+ * was given arguments or piped a file, and so that `convert` writes one line
+ * out for each line in rather than running a whole document together.
+ */
+async function textsFor(command, given, environment) {
+    if (given.length > 0 || command.argument === "") {
+        return given;
+    }
+    const piped = await environment.readInput();
+    const lines = piped.split("\n");
+    // A file ends with a newline, and that last empty line is not a text.
+    return lines.at(-1) === "" ? lines.slice(0, -1) : lines;
+}
+/**
+ * What a command was asked to act on, or a usage error saying it was nothing.
+ *
+ * A command that silently prints nothing because standard input was a terminal
+ * looks broken rather than misused.
+ */
+export async function inputFor(command, given, environment) {
+    const texts = await textsFor(command, given, environment);
+    if (texts.length === 0 && command.argument !== "") {
+        throw new UsageError(`${command.name} needs ${command.argument}, or text on standard input`);
+    }
+    return texts;
+}
+//# sourceMappingURL=cli-input.js.map

package/dist/cli/cli-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.js","sourceRoot":"","sources":["../../src/cli/cli-input.ts"],"names":[],"mappings":"AASA,OAAO,EAAyB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAoCnE;;;;;;GAMG;AACH,KAAK,UAAU,QAAQ,CACrB,OAAgB,EAChB,KAAwB,EACxB,WAA2B;IAE3B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,sEAAsE;IACtE,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAgB,EAChB,KAAwB,EACxB,WAA2B;IAE3B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAClB,GAAG,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,QAAQ,6BAA6B,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}