spliterator 4.0.0 → 6.0.0

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

package/out/node/cli/utils.js

@@ -3,68 +3,68 @@
  * @license MIT
  * @author Teffen Ellis, et al.
  */
-export const commonCommandsBuilder = (argv) => {
-    return argv
-        .option("split", {
-        alias: "s",
-        description: "Delimiter to split lines on",
-        default: "\n",
-        defaultDescription: "<newline>",
-    })
-        .option("join", {
-        alias: "j",
-        description: "Delimiter to join lines on",
-        default: "\n",
-        defaultDescription: "<newline>",
-    })
-        .option("skip-empty", {
-        alias: "e",
-        description: "Skip empty lines",
-        default: true,
-    })
-        .option("take", {
-        alias: "t",
-        description: "Number of lines to take",
-        defaultDescription: "Infinity",
-        number: true,
-    })
-        .option("drop", {
-        alias: "p",
-        description: "Number of lines to drop",
-        default: 0,
-    })
-        .option("debug", {
-        alias: "v",
-        description: "Debug mode",
-        default: false,
-    })
-        .option("reader-high-water-mark", {
-        alias: "w",
-        description: "High water mark for the read stream",
-        default: 4096 * 16, // 64 KiB
-    })
-        .options("writer-high-water-mark", {
-        alias: "W",
-        description: "High water mark for the write stream",
-        default: 4096 * 16 * 4, // 256 KiB
-    })
-        .option("filter", {
-        alias: "f",
-        description: "Path to JS file exporting default a filter function",
-        string: true,
-        normalize: true,
-    })
-        .positional("source", {
-        description: "Path to the source input file",
-        alias: "i",
-        string: true,
-        demandOption: true,
-    })
-        .positional("destination", {
-        description: "Path to the destination output file",
-        alias: "o",
-        string: true,
-        demandOption: true,
-    });
+/**
+ * Options accepted by every Spliterator command.
+ */
+export const commonOptions = {
+    split: { type: "string", short: "s", default: "\n" },
+    join: { type: "string", short: "j", default: "\n" },
+    "skip-empty": { type: "boolean", short: "e", default: true },
+    take: { type: "string", short: "t" },
+    drop: { type: "string", short: "p", default: "0" },
+    debug: { type: "boolean", short: "v", default: false },
+    "reader-high-water-mark": { type: "string", short: "w", default: String(4096 * 16) },
+    "writer-high-water-mark": { type: "string", short: "W", default: String(4096 * 16 * 4) },
+    filter: { type: "string", short: "f" },
+    source: { type: "string", short: "i" },
+    destination: { type: "string", short: "o" },
+    help: { type: "boolean", short: "h", default: false },
 };
+export const commonOptionsHelp = [
+    "  -s, --split <delimiter>       Delimiter to split lines on (default: newline)",
+    "  -j, --join <delimiter>        Delimiter to join lines on (default: newline)",
+    "  -e, --skip-empty              Skip empty lines (default: true, disable with --no-skip-empty)",
+    "  -t, --take <count>            Number of lines to take (default: all)",
+    "  -p, --drop <count>            Number of lines to drop (default: 0)",
+    "  -v, --debug                   Debug mode",
+    "  -w, --reader-high-water-mark  High water mark for the read stream (default: 65536)",
+    "  -W, --writer-high-water-mark  High water mark for the write stream (default: 262144)",
+    "  -f, --filter <path>           Path to JS file exporting a default filter function",
+    "  -i, --source <path>           Source file, if not given positionally",
+    "  -o, --destination <path>      Destination file, if not given positionally",
+    "  -h, --help                    Show this help",
+].join("\n");
+/**
+ * Coerce a numeric option, exiting with a usage error if it isn't a number.
+ */
+export function toNumber(name, input) {
+    if (input === undefined)
+        return undefined;
+    const value = Number(input);
+    if (!Number.isFinite(value)) {
+        usageError(`Option --${name} expects a number, received "${input}".`);
+    }
+    return value;
+}
+/**
+ * Resolve the source and destination paths from positionals, falling back to their flag forms.
+ */
+export function resolveIO(positionals, values) {
+    const source = values.source ?? positionals[0];
+    const destination = values.destination ?? positionals[1];
+    if (!source) {
+        usageError("Missing required argument: source.");
+    }
+    if (!destination) {
+        usageError("Missing required argument: destination.");
+    }
+    return [source, destination];
+}
+/**
+ * Print a usage error and exit.
+ */
+export function usageError(message) {
+    console.error(`${message}\n\nRun \`spliterator --help\` for usage.`);
+    return process.exit(1);
+}
 //# sourceMappingURL=utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../node/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAU,EAAE,EAAE;IACnD,OAAO,IAAI;SACT,MAAM,CAAC,OAAO,EAAE;QAChB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,IAAI;QACb,kBAAkB,EAAE,WAAW;KAC/B,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,IAAI;QACb,kBAAkB,EAAE,WAAW;KAC/B,CAAC;SACD,MAAM,CAAC,YAAY,EAAE;QACrB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,kBAAkB;QAC/B,OAAO,EAAE,IAAI;KACb,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,yBAAyB;QACtC,kBAAkB,EAAE,UAAU;QAC9B,MAAM,EAAE,IAAI;KACZ,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,CAAC;KACV,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QAChB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,KAAK;KACd,CAAC;SACD,MAAM,CAAC,wBAAwB,EAAE;QACjC,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS;KAC7B,CAAC;SACD,OAAO,CAAC,wBAAwB,EAAE;QAClC,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,sCAAsC;QACnD,OAAO,EAAE,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,UAAU;KAClC,CAAC;SACD,MAAM,CAAC,QAAQ,EAAE;QACjB,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,qDAAqD;QAClE,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;KACf,CAAC;SACD,UAAU,CAAC,QAAQ,EAAE;QACrB,WAAW,EAAE,+BAA+B;QAC5C,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;KAClB,CAAC;SACD,UAAU,CAAC,aAAa,EAAE;QAC1B,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,IAAI;KAClB,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../node/cli/utils.ts"],"names":[],"mappings":"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"}

package/out/node/fs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../node/fs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,wBAAwB,EAAc,MAAM,kBAAkB,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAoB,MAAM,qBAAqB,CAAA;AAEvG;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgB1G;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC7C,WAAW,EAAE,OAAO,EACpB,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,cAAc,CAAC,CAkDzB;AAED,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU7E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB7G;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,EAAE,aAAyB,EAAE,KAAS,EAAE,GAAG,EAAE,GAAE,0BAA+B,GAC5E,OAAO,CAAC,kBAAkB,CAAC,CAmD7B;AAED,eAAe,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../node/fs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,wBAAwB,EAAc,MAAM,kBAAkB,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIhD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAoB,MAAM,qBAAqB,CAAA;AAEvG;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgB1G;AAED;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC7C,WAAW,EAAE,OAAO,EACpB,OAAO,GAAE,wBAA6B,GACpC,OAAO,CAAC,cAAc,CAAC,CAkDzB;AAED,MAAM,WAAW,0BAA0B;IAC1C;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAU7E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB7G;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,EAC9C,EAAE,aAAyB,EAAE,KAAS,EAAE,GAAG,EAAE,GAAE,0BAA+B,GAC5E,OAAO,CAAC,kBAAkB,CAAC,CAuD7B;eAEc,mBAAmB"}

package/out/node/fs/index.js

@@ -4,8 +4,8 @@
  * @author Teffen Ellis, et al.
  */
 import { open, stat } from "node:fs/promises";
-import { Writable } from "node:stream";
 import { WritableStream } from "node:stream/web";
+import { PathBuilder } from "path-ts";
 import { isFileHandleLike } from "../../lib/shared.js";
 /**
  * Create a readable stream from a file system source.
@@ -61,7 +61,7 @@ export async function createFileWritableStream(destination, options = {}) {
         async write(chunk) {
             const canWrite = nodeWriteStream.write(chunk);
             if (canWrite)
-                return Promise.resolve();
+                return;
             return new Promise((resolve) => {
                 nodeWriteStream.once("drain", resolve);
             });
@@ -119,8 +119,9 @@ export async function readBytes(source, start, length) {
     }
     finally {
         // Only close handles we opened.
-        if (!isFileHandleLike(source))
+        if (!isFileHandleLike(source)) {
             await handle.close();
+        }
     }
 }
 /**
@@ -133,6 +134,9 @@ export async function createChunkIterator(source, { highWaterMark = 4096 * 16, s
     if (!source) {
         throw new TypeError("Cannot create a chunk iterator from an undefined or null source.");
     }
+    if (source instanceof PathBuilder) {
+        source = source.toString();
+    }
     if (typeof source === "string" || source instanceof URL) {
         const statable = await stat(source)
             .then(() => true)

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../node/fs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiC,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAmD,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEvG;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAe,EAAE,aAAqB;IAC5E,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,+DAA+D;QAC/D,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,2EAA2E,CAAC,CAAA;QACjG,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAA;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEtC,OAAO,MAAM,CAAC,gBAAgB,CAAC;QAC9B,SAAS,EAAE,IAAI;QACf,aAAa;KACb,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,WAAoB,EACpB,UAAoC,EAAE;IAEtC,IAAI,eAAyB,CAAA;IAE7B,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QACrD,eAAe,GAAG,OAAO,CAAC,MAAM,CAAA;IACjC,CAAC;SAAM,CAAC;QACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QAE3C,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC;YAC1C,SAAS,EAAE,IAAI;YACf,GAAG,OAAO;SACV,CAAC,CAAA;IACH,CAAC;IAED,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAA;QAElE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC,CAAC,CAAA;IAEF,OAAO,IAAI,cAAc,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,KAAK;YAChB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAE7C,IAAI,QAAQ;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;YAEtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC9B,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACvC,CAAC,CAAC,CAAA;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,MAAM;YACjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACtC,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;oBAClC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBAChC,CAAC;gBAED,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBACrC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACvC,CAAC,CAAC,CAAA;QACH,CAAC;QAED,KAAK,CAAC,KAAK;YACV,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACtC,eAAe,CAAC,GAAG,EAAE,CAAA;gBACrB,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBACrC,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACxC,CAAC,CAAC,CAAA;QACH,CAAC;KACD,CAAC,CAAA;AACH,CAAC;AAoBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAyB;IAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,YAAY,GAAG,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAA;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAyB,EAAE,KAAa,EAAE,MAAc;IACvF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAA;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE1E,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;QACrC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;QAEjE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACrC,CAAC;YAAS,CAAC;QACV,gCAAgC;QAChC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACpD,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAA8C,EAC9C,EAAE,aAAa,GAAG,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,KAAiC,EAAE;IAE9E,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,kEAAkE,CAAC,CAAA;IACxF,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,YAAY,GAAG,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC;aACjC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAEpB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,mFAAmF;YACnF,+CAA+C;YAC/C,MAAM,IAAI,SAAS,CAClB,iGAAiG,CACjG,CAAA;QACF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAEtC,MAAM,UAAU,GAAG,MAAM,CAAC,gBAAgB,CAAC;YAC1C,KAAK;YACL,GAAG;YACH,aAAa;YACb,SAAS,EAAE,IAAI;SACf,CAAC,CAAA;QAEF,OAAO,UAAU,CAAA;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAA;IACd,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC,gBAAgB,CAAC;gBAC9B,KAAK;gBACL,GAAG;gBACH,aAAa;aACb,CAAC,CAAA;QACH,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,iBAAiB,EAAE,CAAA;QAClC,CAAC;QAED,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAA;IACvF,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAA;AAC7E,CAAC;AAED,eAAe,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../node/fs/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "spliterator",
-	"version": "4.0.0",
+	"version": "6.0.0",
 	"description": "Line-delimited iterator library for CSV, NDJSON, and other delimited formats.",
 	"keywords": [
 		"csv",
@@ -64,25 +64,21 @@
 		"release": "release-it",
 		"test": "yarn compile && vitest"
 	},
-	"dependencies": {
-		"yargs": "^18.0.0"
-	},
 	"devDependencies": {
-		"@sister.software/oxfmt-config": "^9.1.0",
-		"@sister.software/oxlint-config": "^9.1.0",
-		"@sister.software/tsconfig": "^9.0.0",
-		"@types/node": "^25.9.0",
-		"@types/yargs": "^17.0.35",
+		"@sister.software/oxfmt-config": "^12.1.3",
+		"@sister.software/oxlint-config": "^12.1.3",
+		"@sister.software/tsconfig": "^12.1.3",
+		"@types/node": "^26.1.2",
 		"change-case": "^5.4.4",
 		"colorette": "^2.0.20",
 		"npm-run-all": "^4.1.5",
-		"oxfmt": "0.56.0",
-		"oxlint": "1.71.0",
-		"path-ts": "^1.0.5",
-		"release-it": "^17.10.0",
-		"type-fest": "^5.6.0",
-		"typescript": "^6.0.3",
-		"vitest": "^4.1.6"
+		"oxfmt": "0.62.0",
+		"oxlint": "1.77.0",
+		"path-ts": "^2.1.0",
+		"release-it": "^21.0.1",
+		"type-fest": "^5.8.0",
+		"typescript": "^7.0.2",
+		"vitest": "^4.1.10"
 	},
 	"peerDependencies": {
 		"change-case": "^5.4.4",
@@ -99,7 +95,7 @@
 	"engines": {
 		"node": ">= 24.0.0"
 	},
-	"packageManager": "yarn@4.5.1",
+	"packageManager": "yarn@4.18.0",
 	"release-it": {
 		"npm": {
 			"publish": true