spliterator 3.2.0 → 5.0.0

package/out/node/cli/commands/iterate.d.ts

@@ -2,36 +2,8 @@
  * @copyright Sister Software
  * @license MIT
  * @author Teffen Ellis, et al.
+ * @file Default command — iterate over a file, line by line.
  */
-import type { ArgumentsCamelCase, Argv } from "yargs";
-import { type PluckArgv } from "../utils.js";
-export declare const command = "$0 [source] [destination]";
-export declare const describe = false;
-export declare const builder: (argv: Argv) => Argv<{
-    split: string;
-} & {
-    join: string;
-} & {
-    "skip-empty": boolean;
-} & {
-    take: number | undefined;
-} & {
-    drop: number;
-} & {
-    debug: boolean;
-} & {
-    "reader-high-water-mark": number;
-} & {
-    "writer-high-water-mark": number;
-} & {
-    filter: string | undefined;
-} & {
-    source: unknown;
-} & {
-    destination: unknown;
-} & {
-    transformer: string | undefined;
-}>;
-export type IterateCommandArgs = PluckArgv<typeof builder>;
-export declare const handler: (argv: ArgumentsCamelCase<IterateCommandArgs>) => Promise<void>;
+export declare const help: string;
+export declare function run(args: string[]): Promise<void>;
 //# sourceMappingURL=iterate.d.ts.map

package/out/node/cli/commands/iterate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterate.d.ts","sourceRoot":"","sources":["../../../../node/cli/commands/iterate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,EAIN,KAAK,SAAS,EAEd,MAAM,aAAa,CAAA;AAEpB,eAAO,MAAM,OAAO,8BAA8B,CAAA;AAClD,eAAO,MAAM,QAAQ,QAAQ,CAAA;AAE7B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;EAMjC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC,OAAO,OAAO,CAAC,CAAA;AAE1D,eAAO,MAAM,OAAO,GAAU,MAAM,kBAAkB,CAAC,kBAAkB,CAAC,kBA2CzE,CAAA"}
+{"version":3,"file":"iterate.d.ts","sourceRoot":"","sources":["../../../../node/cli/commands/iterate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,eAAO,MAAM,IAAI,QAQL,CAAA;AAEZ,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEvD"}

package/out/node/cli/commands/iterate.js

@@ -2,45 +2,65 @@
  * @copyright Sister Software
  * @license MIT
  * @author Teffen Ellis, et al.
+ * @file Default command — iterate over a file, line by line.
  */
 import { resolve as resolvePath } from "node:path";
+import { parseArgs } from "node:util";
 import { CharacterSequence, Spliterator } from "spliterator";
 import { createFileWritableStream, createReadStream } from "spliterator/node/fs";
-import { commonCommandsBuilder, } from "../utils.js";
-export const command = "$0 [source] [destination]";
-export const describe = false;
-export const builder = (argv) => {
-    return commonCommandsBuilder(argv).option("transformer", {
-        alias: "t",
-        description: "Path to JS file exporting a default transformer function",
-        string: true,
+import { commonOptions, commonOptionsHelp, resolveIO, toNumber, } from "../utils.js";
+export const help = [
+    "Iterate over a file, line by line, writing the transformed output to a new file.",
+    "",
+    "Usage: spliterator [source] [destination] [options]",
+    "",
+    "Options:",
+    commonOptionsHelp,
+    "  -T, --transformer <path>      Path to JS file exporting a default transformer function",
+].join("\n");
+export async function run(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        allowNegative: true,
+        options: {
+            ...commonOptions,
+            transformer: { type: "string", short: "T" },
+        },
     });
-};
-export const handler = async (argv) => {
+    if (values.help) {
+        console.log(help);
+        return;
+    }
+    const [source, destination] = resolveIO(positionals, values);
+    const take = toNumber("take", values.take);
+    const drop = toNumber("drop", values.drop);
+    const readerHighWaterMark = toNumber("reader-high-water-mark", values["reader-high-water-mark"]);
+    const writerHighWaterMark = toNumber("writer-high-water-mark", values["writer-high-water-mark"]);
     let transformer = (line) => line;
-    const joinDelimiter = new CharacterSequence(argv.join);
-    if (argv.transformer) {
-        const module = await import(resolvePath(argv.transformer));
+    const joinDelimiter = new CharacterSequence(values.join);
+    if (values.transformer) {
+        const module = await import(resolvePath(values.transformer));
         transformer = module.default;
     }
     let filter = () => true;
-    if (argv.filter) {
-        const module = await import(resolvePath(argv.filter));
+    if (values.filter) {
+        const module = await import(resolvePath(values.filter));
         filter = module.default;
     }
     const [readStream, writeStream] = await Promise.all([
-        createReadStream(argv.source, argv.readerHighWaterMark),
-        createFileWritableStream(argv.destination, {
-            highWaterMark: argv.writerHighWaterMark,
+        createReadStream(source, readerHighWaterMark),
+        createFileWritableStream(destination, {
+            highWaterMark: writerHighWaterMark,
         }),
     ]);
     const writer = writeStream.getWriter();
     const spliterator = Spliterator.from(readStream, {
-        delimiter: argv.split,
-        skipEmpty: argv.skipEmpty,
-        take: argv.take,
-        drop: argv.drop,
-        debug: argv.debug,
+        delimiter: values.split,
+        skipEmpty: values["skip-empty"],
+        take,
+        drop,
+        debug: values.debug,
     });
     for await (const line of spliterator) {
         const transformed = await transformer(line);
@@ -50,5 +70,6 @@ export const handler = async (argv) => {
         await writer.write(transformed);
         await writer.write(joinDelimiter);
     }
-};
+    await writer.close();
+}
 //# sourceMappingURL=iterate.js.map

package/out/node/cli/commands/iterate.js.map

@@ -1 +1 @@
-{"version":3,"file":"iterate.js","sourceRoot":"","sources":["../../../../node/cli/commands/iterate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGhF,OAAO,EACN,qBAAqB,GAKrB,MAAM,aAAa,CAAA;AAEpB,MAAM,CAAC,MAAM,OAAO,GAAG,2BAA2B,CAAA;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAE,EAAE;IACrC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE;QACxD,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,0DAA0D;QACvE,MAAM,EAAE,IAAI;KACZ,CAAC,CAAA;AACH,CAAC,CAAA;AAID,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAA4C,EAAE,EAAE;IAC7E,IAAI,WAAW,GAAoB,CAAC,IAAgB,EAAE,EAAE,CAAC,IAAI,CAAA;IAC7D,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEtD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,MAAM,GAAiC,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;QACxF,WAAW,GAAG,MAAM,CAAC,OAAO,CAAA;IAC7B,CAAC;IAED,IAAI,MAAM,GAAsB,GAAG,EAAE,CAAC,IAAI,CAAA;IAE1C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QACrD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,CAAC;QACvD,wBAAwB,CAAC,IAAI,CAAC,WAAW,EAAE;YAC1C,aAAa,EAAE,IAAI,CAAC,mBAAmB;SACvC,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAA;IAEtC,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE;QAChD,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC,CAAA;IAEF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QAE3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;QAE/B,IAAI,CAAC,IAAI;YAAE,SAAQ;QAEnB,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAC/B,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IAClC,CAAC;AACF,CAAC,CAAA"}
+{"version":3,"file":"iterate.js","sourceRoot":"","sources":["../../../../node/cli/commands/iterate.ts"],"names":[],"mappings":"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"}

package/out/node/cli/index.js

@@ -5,30 +5,44 @@
  * @author Teffen Ellis, et al.
  * @file CLI entry point for the Spliterator library.
  */
-import { hideBin } from "yargs/helpers";
-import yargs from "yargs/yargs";
-const argv = yargs(hideBin(process.argv));
-argv
-    .command(await import("./commands/iterate.js"))
-    .usage([
-    // ---
-    "Iterate over a file, line by line, writing the transformed output to a new file.",
-    "$0 [source] [destination]",
+import { createRequire } from "node:module";
+import * as csv from "./commands/csv.js";
+import * as iterate from "./commands/iterate.js";
+import { usageError } from "./utils.js";
+const rootHelp = [
+    iterate.help,
     "",
-].join("\n"))
-    .command(await import("./commands/csv.js"))
-    .usage([
-    // ---
-    "Split a CSV file into JSONL format.",
-    "$0 csv [source] [destination]",
+    "Commands:",
+    "  csv                           Split a CSV file into JSONL format.",
     "",
-].join("\n"))
-    .epilogue([
-    // ---
     "Sister Software, AGPL-3.0",
     "https://sister.software",
-].join("\n"))
-    .wrap(Math.min(120, argv.terminalWidth()))
-    .scriptName("spliterator")
-    .parse();
+].join("\n");
+const argv = process.argv.slice(2);
+const [first, ...rest] = argv;
+try {
+    switch (first) {
+        case "csv":
+            await csv.run(rest);
+            break;
+        case "--version":
+            console.log(createRequire(import.meta.url)("../../../package.json").version);
+            break;
+        case undefined:
+        case "help":
+        case "--help":
+        case "-h":
+            console.log(rootHelp);
+            break;
+        default:
+            await iterate.run(argv);
+    }
+}
+catch (error) {
+    // `parseArgs` rejects unknown or malformed flags — report those as usage errors, not crashes.
+    if (error instanceof Error && String(error.code).startsWith("ERR_PARSE_ARGS")) {
+        usageError(error.message);
+    }
+    throw error;
+}
 //# sourceMappingURL=index.js.map

package/out/node/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../node/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,aAAa,CAAA;AAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AAEzC,IAAI;KACF,OAAO,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;KAC9C,KAAK,CACL;IACC,MAAM;IACN,kFAAkF;IAClF,2BAA2B;IAC3B,EAAE;CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ;KACA,OAAO,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;KAC1C,KAAK,CACL;IACC,MAAM;IACN,qCAAqC;IACrC,+BAA+B;IAC/B,EAAE;CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ;KACA,QAAQ,CACR;IACC,MAAM;IACN,2BAA2B;IAC3B,yBAAyB;CACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CACZ;KACA,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;KACzC,UAAU,CAAC,aAAa,CAAC;KACzB,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../node/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAA;AACxC,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,QAAQ,GAAG;IAChB,OAAO,CAAC,IAAI;IACZ,EAAE;IACF,WAAW;IACX,qEAAqE;IACrE,EAAE;IACF,2BAA2B;IAC3B,yBAAyB;CACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;AAE7B,IAAI,CAAC;IACJ,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,KAAK;YACT,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACnB,MAAK;QAEN,KAAK,WAAW;YACf,OAAO,CAAC,GAAG,CAAE,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,uBAAuB,CAAyB,CAAC,OAAO,CAAC,CAAA;YACrG,MAAK;QAEN,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACR,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACrB,MAAK;QAEN;YACC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;AACF,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IAChB,8FAA8F;IAC9F,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,CAAE,KAA+B,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1G,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC1B,CAAC;IAED,MAAM,KAAK,CAAA;AACZ,CAAC"}

package/out/node/cli/parse-args.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ * @file A minimal command/option layer over Node's built-in `util.parseArgs`.
+ */
+/**
+ * Declarative description of a single command line option.
+ */
+export interface OptionSpec {
+    /**
+     * The value type. `number` options are parsed as strings and coerced.
+     */
+    type: "string" | "boolean" | "number";
+    /**
+     * Single-character alias, e.g. `s` for `-s`.
+     */
+    short?: string;
+    /**
+     * Help text shown alongside the option.
+     */
+    description: string;
+    /**
+     * Value used when the option is omitted.
+     */
+    default?: string | number | boolean;
+    /**
+     * Human-readable stand-in for `default` in help output, e.g. `<newline>`.
+     */
+    defaultDescription?: string;
+    /**
+     * Permitted values for string options. Anything else is rejected.
+     */
+    choices?: readonly string[];
+}
+export type OptionRecord = Record<string, OptionSpec>;
+/**
+ * Declarative description of a positional argument.
+ */
+export interface PositionalSpec {
+    /**
+     * Help text shown alongside the positional.
+     */
+    description: string;
+    /**
+     * Whether the positional must be present.
+     */
+    required?: boolean;
+}
+export type PositionalRecord = Record<string, PositionalSpec>;
+type KebabToCamel<T extends string> = T extends `${infer Head}-${infer Tail}` ? `${Head}${Capitalize<KebabToCamel<Tail>>}` : T;
+type OptionValue<S extends OptionSpec> = S extends {
+    choices: readonly (infer Choice)[];
+} ? Choice : S["type"] extends "boolean" ? boolean : S["type"] extends "number" ? number : string;
+type OptionalKeys<O extends OptionRecord> = {
+    [K in keyof O]: O[K] extends {
+        default: unknown;
+    } ? never : K;
+}[keyof O];
+/**
+ * The parsed shape of an option record, with kebab-case keys camel-cased.
+ */
+export type InferOptions<O extends OptionRecord> = {
+    [K in Exclude<keyof O, OptionalKeys<O>> & string as KebabToCamel<K>]: OptionValue<O[K]>;
+} & {
+    [K in OptionalKeys<O> & string as KebabToCamel<K>]?: OptionValue<O[K]>;
+};
+/**
+ * The parsed shape of a positional record.
+ */
+export type InferPositionals<P extends PositionalRecord> = {
+    [K in keyof P & string as KebabToCamel<K>]: P[K] extends {
+        required: true;
+    } ? string : string | undefined;
+};
+/**
+ * A CLI command — a name, its options, and the handler invoked with parsed arguments.
+ */
+export interface Command<O extends OptionRecord = OptionRecord, P extends PositionalRecord = PositionalRecord> {
+    /**
+     * The subcommand name, or `null` for the default command.
+     */
+    name: string | null;
+    /**
+     * One-line summary shown in the top-level help.
+     */
+    description: string;
+    /**
+     * Usage line shown in the command's help, sans script name.
+     */
+    usage: string;
+    options: O;
+    positionals: P;
+    handler: (args: InferOptions<O> & InferPositionals<P>) => Promise<void>;
+}
+/**
+ * Identity helper preserving the literal types of a command's option and positional records.
+ */
+export declare function defineCommand<O extends OptionRecord, P extends PositionalRecord>(command: Command<O, P>): Command<O, P>;
+/**
+ * Thrown when the user supplies arguments the command cannot accept.
+ *
+ * The CLI entry point prints the message and exits without a stack trace.
+ */
+export declare class UsageError extends Error {
+    name: string;
+}
+/**
+ * Parse `argv` against a command, applying defaults, coercion, and validation.
+ *
+ * @param command - The command to parse against.
+ * @param argv - Arguments following the command name.
+ */
+export declare function parseCommand<O extends OptionRecord, P extends PositionalRecord>(command: Command<O, P>, argv: string[]): InferOptions<O> & InferPositionals<P>;
+/**
+ * Render the help text for a single command.
+ */
+export declare function formatCommandHelp(scriptName: string, command: Command): string;
+export {};
+//# sourceMappingURL=parse-args.d.ts.map

package/out/node/cli/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../../../node/cli/parse-args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;IAErC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAEnC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAE7D,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GAC1E,GAAG,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,GAC1C,CAAC,CAAA;AAEJ,KAAK,WAAW,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,CAAA;CAAE,GACtF,MAAM,GACN,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAC1B,OAAO,GACP,CAAC,CAAC,MAAM,CAAC,SAAS,QAAQ,GACzB,MAAM,GACN,MAAM,CAAA;AAEX,KAAK,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,KAAK,GAAG,CAAC;CAC7D,CAAC,MAAM,CAAC,CAAC,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI;KACjD,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvF,GAAG;KACF,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,gBAAgB,IAAI;KACzD,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;CACzG,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,CAAC,SAAS,gBAAgB,GAAG,gBAAgB;IAC5G;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb,OAAO,EAAE,CAAC,CAAA;IACV,WAAW,EAAE,CAAC,CAAA;IAEd,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,gBAAgB,EAC/E,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAEf;AAMD;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IAC3B,IAAI,SAAe;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,gBAAgB,EAC9E,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,IAAI,EAAE,MAAM,EAAE,GACZ,YAAY,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAwEvC;AASD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CA0B9E"}

package/out/node/cli/parse-args.js

@@ -0,0 +1,118 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ * @file A minimal command/option layer over Node's built-in `util.parseArgs`.
+ */
+import { parseArgs } from "node:util";
+/**
+ * Identity helper preserving the literal types of a command's option and positional records.
+ */
+export function defineCommand(command) {
+    return command;
+}
+function camelCase(input) {
+    return input.replace(/-([a-z])/g, (_, character) => character.toUpperCase());
+}
+/**
+ * Thrown when the user supplies arguments the command cannot accept.
+ *
+ * The CLI entry point prints the message and exits without a stack trace.
+ */
+export class UsageError extends Error {
+    name = "UsageError";
+}
+/**
+ * Parse `argv` against a command, applying defaults, coercion, and validation.
+ *
+ * @param command - The command to parse against.
+ * @param argv - Arguments following the command name.
+ */
+export function parseCommand(command, argv) {
+    const config = {};
+    for (const [name, spec] of Object.entries(command.options)) {
+        config[name] = {
+            type: spec.type === "number" ? "string" : spec.type,
+            ...(spec.short ? { short: spec.short } : {}),
+        };
+    }
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: argv,
+            options: config,
+            allowPositionals: true,
+            allowNegative: true,
+            strict: true,
+        });
+    }
+    catch (error) {
+        throw new UsageError(error instanceof Error ? error.message : String(error));
+    }
+    const result = {};
+    for (const [name, spec] of Object.entries(command.options)) {
+        const key = camelCase(name);
+        const raw = parsed.values[name];
+        if (raw === undefined) {
+            if (spec.default !== undefined)
+                result[key] = spec.default;
+            continue;
+        }
+        if (spec.type === "number") {
+            const value = Number(raw);
+            if (!Number.isFinite(value)) {
+                throw new UsageError(`Option --${name} expects a number, received "${String(raw)}".`);
+            }
+            result[key] = value;
+            continue;
+        }
+        if (spec.choices && !spec.choices.includes(raw)) {
+            throw new UsageError(`Option --${name} expects one of: ${spec.choices.join(", ")}.`);
+        }
+        result[key] = raw;
+    }
+    const positionalNames = Object.keys(command.positionals);
+    if (parsed.positionals.length > positionalNames.length) {
+        throw new UsageError(`Unexpected argument "${parsed.positionals[positionalNames.length]}".`);
+    }
+    for (const [index, name] of positionalNames.entries()) {
+        const key = camelCase(name);
+        // An explicit `--source`/`--destination` option wins over the positional slot.
+        const value = result[key] ?? parsed.positionals[index];
+        if (value === undefined && command.positionals[name].required) {
+            throw new UsageError(`Missing required argument "${name}".`);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+function formatDefault(spec) {
+    if (spec.defaultDescription)
+        return spec.defaultDescription;
+    if (spec.default === undefined)
+        return "";
+    return JSON.stringify(spec.default);
+}
+/**
+ * Render the help text for a single command.
+ */
+export function formatCommandHelp(scriptName, command) {
+    const lines = [command.description, "", `Usage: ${scriptName} ${command.usage}`, ""];
+    const positionalEntries = Object.entries(command.positionals);
+    if (positionalEntries.length) {
+        lines.push("Positionals:");
+        for (const [name, spec] of positionalEntries) {
+            lines.push(`  ${name.padEnd(28)}${spec.description}${spec.required ? "" : " (optional)"}`);
+        }
+        lines.push("");
+    }
+    lines.push("Options:");
+    for (const [name, spec] of Object.entries(command.options)) {
+        const flag = [spec.short ? `-${spec.short},` : "   ", `--${name}`].join(" ");
+        const fallback = formatDefault(spec);
+        const choices = spec.choices ? ` [${spec.choices.join("|")}]` : "";
+        lines.push(`  ${flag.padEnd(32)}${spec.description}${choices}${fallback ? ` (default: ${fallback})` : ""}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=parse-args.js.map

package/out/node/cli/parse-args.js.map

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

package/out/node/cli/utils.d.ts

@@ -3,32 +3,83 @@
  * @license MIT
  * @author Teffen Ellis, et al.
  */
-import type { Argv } from "yargs";
-export type PluckArgv<T extends (...args: any[]) => any> = ReturnType<T> extends Argv<infer U> ? U : never;
-export declare const commonCommandsBuilder: (argv: Argv) => Argv<{
-    split: string;
-} & {
-    join: string;
-} & {
-    "skip-empty": boolean;
-} & {
-    take: number | undefined;
-} & {
-    drop: number;
-} & {
-    debug: boolean;
-} & {
-    "reader-high-water-mark": number;
-} & {
-    "writer-high-water-mark": number;
-} & {
-    filter: string | undefined;
-} & {
-    source: unknown;
-} & {
-    destination: unknown;
-}>;
-export type CommonCommandArgs = PluckArgv<typeof commonCommandsBuilder>;
+/**
+ * Options accepted by every Spliterator command.
+ */
+export declare const commonOptions: {
+    readonly split: {
+        readonly type: "string";
+        readonly short: "s";
+        readonly default: "\n";
+    };
+    readonly join: {
+        readonly type: "string";
+        readonly short: "j";
+        readonly default: "\n";
+    };
+    readonly "skip-empty": {
+        readonly type: "boolean";
+        readonly short: "e";
+        readonly default: true;
+    };
+    readonly take: {
+        readonly type: "string";
+        readonly short: "t";
+    };
+    readonly drop: {
+        readonly type: "string";
+        readonly short: "p";
+        readonly default: "0";
+    };
+    readonly debug: {
+        readonly type: "boolean";
+        readonly short: "v";
+        readonly default: false;
+    };
+    readonly "reader-high-water-mark": {
+        readonly type: "string";
+        readonly short: "w";
+        readonly default: string;
+    };
+    readonly "writer-high-water-mark": {
+        readonly type: "string";
+        readonly short: "W";
+        readonly default: string;
+    };
+    readonly filter: {
+        readonly type: "string";
+        readonly short: "f";
+    };
+    readonly source: {
+        readonly type: "string";
+        readonly short: "i";
+    };
+    readonly destination: {
+        readonly type: "string";
+        readonly short: "o";
+    };
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+        readonly default: false;
+    };
+};
+export declare const commonOptionsHelp: string;
+/**
+ * Coerce a numeric option, exiting with a usage error if it isn't a number.
+ */
+export declare function toNumber(name: string, input: string | undefined): number | undefined;
+/**
+ * Resolve the source and destination paths from positionals, falling back to their flag forms.
+ */
+export declare function resolveIO(positionals: string[], values: {
+    source?: string;
+    destination?: string;
+}): [source: string, destination: string];
+/**
+ * Print a usage error and exit.
+ */
+export declare function usageError(message: string): never;
 /**
  * A function that filters lines from a spliterator's output.
  *
@@ -46,7 +97,7 @@ export type LineTransformer<T = unknown> = (line: Uint8Array) => T | PromiseLike
 /**
  * The default export from a module that exports a `LineTransformer`.
  */
-export type LineTransformerModuleExports = {
+export interface LineTransformerModuleExports {
     default: LineTransformer;
-};
+}
 //# sourceMappingURL=utils.d.ts.map

package/out/node/cli/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../node/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAE1G,eAAO,MAAM,qBAAqB,GAAI,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;EA+D/C,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAEjF;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEnF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE,eAAe,CAAA;CACxB,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../node/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,eAAO,MAAM,aAAa;;iBAChB,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO,EAAE,IAAI;;;iBAC1C,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO,EAAE,IAAI;;;iBACjC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO;;;iBAC5C,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBAC1B,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO,EAAE,GAAG;;;iBACvC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO;;;iBACjB,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO;;;iBACnC,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO;;;iBACrD,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBAC1B,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBACrB,IAAI,EAAE,QAAQ;iBAAE,KAAK,EAAE,GAAG;;;iBACjC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;iBAAE,OAAO;;CACF,CAAA;AAE3C,eAAO,MAAM,iBAAiB,QAalB,CAAA;AAEZ;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUpF;AAED;;GAEG;AACH,wBAAgB,SAAS,CACxB,WAAW,EAAE,MAAM,EAAE,EACrB,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAavC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAIjD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAEjF;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC5C,OAAO,EAAE,eAAe,CAAA;CACxB"}