spliterator 4.0.0 → 6.0.0

package/out/lib/zip.js

@@ -0,0 +1,59 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+export function zippedEntries(zipped) {
+    return zipped.slice(0, 2);
+}
+/**
+ * Given two iterables, zip them together into a single iterable which yields pairs of elements.
+ *
+ * If one iterable is longer than the other, the shorter iterable will be padded with `undefined`.
+ *
+ * @param a The first iterable to zip.
+ * @param b The second iterable to zip.
+ *
+ * @yields Pairs of elements from the two iterables.
+ * @see {@linkcode zipAsync} for the asynchronous version.
+ */
+export function* zipSync(a, b) {
+    const aIterator = a[Symbol.iterator]();
+    const bIterator = b[Symbol.iterator]();
+    let index = 0;
+    while (true) {
+        const { done: aDone, value: aValue } = aIterator.next();
+        const { done: bDone, value: bValue } = bIterator.next();
+        if (aDone && bDone) {
+            break;
+        }
+        yield [aValue, bValue, index];
+        index++;
+    }
+}
+/**
+ * Given two iterables, zip them together into a single iterable which yields pairs of elements.
+ *
+ * If one iterable is longer than the other, the shorter iterable will be padded with `undefined`.
+ *
+ * @param a The first iterable to zip.
+ * @param b The second iterable to zip.
+ *
+ * @yields Pairs of elements from the two iterables.
+ * @see {@linkcode zipSync} for the synchronous version.
+ */
+export async function* zipAsync(a, b) {
+    const aIterator = Symbol.asyncIterator in a ? a[Symbol.asyncIterator]() : a[Symbol.iterator]();
+    const bIterator = Symbol.asyncIterator in b ? b[Symbol.asyncIterator]() : b[Symbol.iterator]();
+    let index = 0;
+    while (true) {
+        const { done: aDone, value: aValue } = await aIterator.next();
+        const { done: bDone, value: bValue } = await bIterator.next();
+        if (aDone && bDone) {
+            break;
+        }
+        yield [aValue, bValue, index];
+        index++;
+    }
+}
+//# sourceMappingURL=zip.js.map

package/out/lib/zip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.js","sourceRoot":"","sources":["../../lib/zip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,UAAU,aAAa,CAAO,MAAoB;IACvD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAgC,CAAA;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,SAAS,CAAC,CAAC,OAAO,CAAO,CAAc,EAAE,CAAc;IAC5D,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IACtC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAEtC,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;QACvD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;QAEvD,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACpB,MAAK;QACN,CAAC;QAED,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAE7B,KAAK,EAAE,CAAA;IACR,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAC9B,CAAiC,EACjC,CAAiC;IAEjC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;IAE9F,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;QAC7D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAA;QAE7D,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;YACpB,MAAK;QACN,CAAC;QAED,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAE7B,KAAK,EAAE,CAAA;IACR,CAAC;AACF,CAAC"}

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

@@ -2,43 +2,8 @@
  * @copyright Sister Software
  * @license MIT
  * @author Teffen Ellis, et al.
- * @file Yargs command to split a CSV file.
+ * @file Command to split a CSV file into JSONL format.
  */
-import { type ArgumentsCamelCase, type Argv } from "yargs";
-import { type PluckArgv } from "../utils.js";
-export declare const command = "csv [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;
-} & {
-    header: boolean;
-} & {
-    transformers: string | undefined;
-} & {
-    "column-delimiter": string;
-} & {
-    mode: string;
-}>;
-export type CSVCommandArgs = PluckArgv<typeof builder>;
-export declare const handler: (argv: ArgumentsCamelCase<CSVCommandArgs>) => Promise<void>;
+export declare const help: string;
+export declare function run(args: string[]): Promise<void>;
 //# sourceMappingURL=csv.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../../node/cli/commands/csv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,IAAI,EAAE,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAyB,KAAK,SAAS,EAA0B,MAAM,aAAa,CAAA;AAE3F,eAAO,MAAM,OAAO,+BAA+B,CAAA;AACnD,eAAO,MAAM,QAAQ,QAAQ,CAAA;AAE7B,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BjC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,OAAO,CAAC,CAAA;AAEtD,eAAO,MAAM,OAAO,GAAU,MAAM,kBAAkB,CAAC,cAAc,CAAC,kBA8CrE,CAAA"}
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../../node/cli/commands/csv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,eAAO,MAAM,IAAI,QAWL,CAAA;AAEZ,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4EvD"}

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

@@ -2,70 +2,78 @@
  * @copyright Sister Software
  * @license MIT
  * @author Teffen Ellis, et al.
- * @file Yargs command to split a CSV file.
+ * @file Command to split a CSV file into JSONL format.
  */
 import { resolve as resolvePath } from "node:path";
+import { parseArgs } from "node:util";
 import { CharacterSequence, CSVSpliterator, } from "spliterator";
 import { createFileWritableStream, createReadStream } from "spliterator/node/fs";
-import {} from "yargs";
-import { commonCommandsBuilder } from "../utils.js";
-export const command = "csv [source] [destination]";
-export const describe = false;
-export const builder = (argv) => {
-    return commonCommandsBuilder(argv)
-        .option("header", {
-        alias: "h",
-        description: "Whether the CSV file has a header",
-        default: true,
-        boolean: true,
-    })
-        .option("transformers", {
-        alias: "ts",
-        description: "Path to JS file exporting transformer functions",
-        string: true,
-        normalize: true,
-    })
-        .options("column-delimiter", {
-        alias: "c",
-        description: "Delimiter to split columns on",
-        default: ",",
-    })
-        .option("mode", {
-        alias: "m",
-        description: "Output mode",
-        choices: ["object", "array"],
-        default: "object",
-        string: true,
+import { commonOptions, commonOptionsHelp, resolveIO, toNumber, usageError } from "../utils.js";
+const MODES = ["object", "array"];
+export const help = [
+    "Split a CSV file into JSONL format.",
+    "",
+    "Usage: spliterator csv [source] [destination] [options]",
+    "",
+    "Options:",
+    commonOptionsHelp,
+    "  -H, --header                  Whether the CSV file has a header (default: true, disable with --no-header)",
+    "  -T, --transformers <path>     Path to JS file exporting transformer functions",
+    "  -c, --column-delimiter <str>  Delimiter to split columns on (default: ,)",
+    `  -m, --mode <mode>             Output mode: ${MODES.join(" | ")} (default: object)`,
+].join("\n");
+export async function run(args) {
+    const { values, positionals } = parseArgs({
+        args,
+        allowPositionals: true,
+        allowNegative: true,
+        options: {
+            ...commonOptions,
+            header: { type: "boolean", short: "H", default: true },
+            transformers: { type: "string", short: "T" },
+            "column-delimiter": { type: "string", short: "c", default: "," },
+            mode: { type: "string", short: "m", default: "object" },
+        },
     });
-};
-export const handler = async (argv) => {
-    const joinDelimiter = new CharacterSequence(argv.join).decode();
+    if (values.help) {
+        console.log(help);
+        return;
+    }
+    const [source, destination] = resolveIO(positionals, values);
+    if (!MODES.includes(values.mode)) {
+        usageError(`Option --mode expects one of: ${MODES.join(", ")}.`);
+    }
+    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"]);
+    const joinDelimiter = new CharacterSequence(values.join).decode();
     let transformers = {};
-    if (argv.transformers) {
-        transformers = await import(resolvePath(argv.transformers));
+    if (values.transformers) {
+        transformers = await import(resolvePath(values.transformers));
     }
     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, {
+        createReadStream(source, readerHighWaterMark),
+        createFileWritableStream(destination, {
             encoding: "utf8",
-            highWaterMark: argv.writerHighWaterMark,
+            highWaterMark: writerHighWaterMark,
         }),
     ]);
     const writer = writeStream.getWriter();
     const spliterator = CSVSpliterator.fromAsync(readStream, {
-        mode: argv.mode,
-        delimiter: argv.split,
+        mode: values.mode,
+        delimiter: values.split,
         autoDispose: true,
-        header: argv.header,
+        header: values.header,
         transformers,
-        columnDelimiter: argv.columnDelimiter,
-        take: argv.take,
-        drop: argv.drop,
+        columnDelimiter: values["column-delimiter"],
+        take,
+        drop,
     });
     for await (const row of spliterator) {
         const emit = await filter(row);
@@ -75,5 +83,5 @@ export const handler = async (argv) => {
         await writer.write(joinDelimiter);
     }
     await writer.close();
-};
+}
 //# sourceMappingURL=csv.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../../node/cli/commands/csv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EACN,iBAAiB,EACjB,cAAc,GAKd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAChF,OAAO,EAAsC,MAAM,OAAO,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAA0C,MAAM,aAAa,CAAA;AAE3F,MAAM,CAAC,MAAM,OAAO,GAAG,4BAA4B,CAAA;AACnD,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAU,EAAE,EAAE;IACrC,OAAO,qBAAqB,CAAC,IAAI,CAAC;SAChC,MAAM,CAAC,QAAQ,EAAE;QACjB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,mCAAmC;QAChD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACb,CAAC;SACD,MAAM,CAAC,cAAc,EAAE;QACvB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,iDAAiD;QAC9D,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;KACf,CAAC;SACD,OAAO,CAAC,kBAAkB,EAAE;QAC5B,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,GAAG;KACZ,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,aAAa;QAC1B,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAoC;QAC/D,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,IAAI;KACZ,CAAC,CAAA;AACJ,CAAC,CAAA;AAID,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAwC,EAAE,EAAE;IACzE,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;IAC/D,IAAI,YAAY,GAAyB,EAAE,CAAA;IAE3C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,YAAY,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;IAC5D,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,QAAQ,EAAE,MAAM;YAChB,aAAa,EAAE,IAAI,CAAC,mBAAmB;SACvC,CAAC;KACF,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAA;IAEtC,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,UAAU,EAAE;QACxD,IAAI,EAAE,IAAI,CAAC,IAAqB;QAChC,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY;QACZ,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;KACqC,CAAC,CAAA;IAEtD,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAA;QAE9B,IAAI,CAAC,IAAI;YAAE,SAAQ;QAEnB,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;QACvC,MAAM,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;AACrB,CAAC,CAAA"}
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../../node/cli/commands/csv.ts"],"names":[],"mappings":"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"}

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":"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"}