spliterator 6.0.1 → 6.1.0

package/README.md

@@ -92,6 +92,58 @@ for await (const columns of reader) {
 }
 ```
 
+## Excel workbooks (XLSX)
+
+Spliterator can read and write `.xlsx` workbooks through `XLSXSpliterator`. Support is powered by two optional peer dependencies — install the one you need:
+
+```bash
+yarn add read-excel-file  # for XLSXSpliterator.fromAsync
+yarn add write-excel-file # for XLSXSpliterator.write
+```
+
+Reading mirrors `CSVSpliterator`'s options — `mode`, `header`, `normalizeKeys`, `transformers`, `drop`, and `take` — plus a `sheet` option to pick a sheet by 1-based number or name. Unlike CSV columns, XLSX cells arrive **typed**: numbers, booleans, and dates are real values rather than strings, and empty cells are `null`.
+
+```ts
+import { XLSXSpliterator } from "spliterator"
+
+const reader = XLSXSpliterator.fromAsync("people.xlsx", { mode: "object", sheet: "Employees" })
+
+for await (const row of reader) {
+	console.log(row) // { full_name: "Morgan", hired: Date, age: 30 }, etc.
+}
+```
+
+Transformers receive those typed cell values, which makes them a natural place to coerce loosely-exported data — many real-world workbooks store everything as text:
+
+```ts
+const reader = XLSXSpliterator.fromAsync("form499.xlsx", {
+	mode: "object",
+	transformers: {
+		filer_499_id: (value) => Number(value),
+		alabama: (value) => value === "TRUE",
+	},
+})
+```
+
+Writing accepts any iterable or async iterable of rows — arrays of cells, or records whose keys become the header row — so a Spliterator pipeline can terminate in a workbook:
+
+```ts
+const rows = CSVSpliterator.fromAsync("people.csv", { mode: "object" }).map((person) => ({
+	...person,
+	age: Number(person.age),
+}))
+
+await XLSXSpliterator.write(rows, { sheet: "People" }).toFile("people.xlsx")
+```
+
+A few caveats worth knowing:
+
+- **The whole workbook is held in memory, in both directions.** XLSX is a ZIP archive of XML documents — shared strings live in a separate archive entry and the ZIP's central directory sits at the end of the file — so it cannot be parsed or produced as a bounded-memory stream the way delimited text can. Reading yields no rows until the entire sheet is parsed, and writing drains your source completely before producing bytes. Expect memory usage far above the file's size on disk (a 9 MB workbook can inflate to hundreds of MB parsed). For sources large enough that this matters, prefer CSV or JSONL.
+- **There is no synchronous reader.** Decompression and XML parsing are asynchronous in the underlying reader, so `XLSXSpliterator.from()` always throws, pointing you to `fromAsync`.
+- **One sheet at a time.** Reading targets a single sheet per call, and writing produces a single-sheet workbook. Cell styling, formats, and formulas are out of scope.
+
+See `examples/xlsx-to-jsonl.ts` for a complete conversion script with derived transformers.
+
 ## CLI Usage
 
 Spliterator also includes a CLI tool that can be used to stream delimited content from the command line, transform it, filter it, and more.

package/out/index.d.ts

@@ -11,11 +11,13 @@ export * from "./lib/CharacterSequence.js";
 export * from "./lib/chunks.js";
 export * from "./lib/CompositeDataView.js";
 export * from "./lib/CSVSpliterator.js";
+export * from "./lib/XLSXSpliterator.js";
 export * from "./lib/IndexQueue.js";
 export * from "./lib/JSONSpliterator.js";
 export * from "./lib/parallel-map.js";
 export * from "./lib/parallel-map-workers.js";
 export * from "./lib/pivot.js";
+export * from "./lib/row-emitters.js";
 export * from "./lib/PSVSpliterator.js";
 export * from "./lib/segments.js";
 export * from "./lib/shared.js";

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/out/index.js

@@ -11,11 +11,13 @@ export * from "./lib/CharacterSequence.js";
 export * from "./lib/chunks.js";
 export * from "./lib/CompositeDataView.js";
 export * from "./lib/CSVSpliterator.js";
+export * from "./lib/XLSXSpliterator.js";
 export * from "./lib/IndexQueue.js";
 export * from "./lib/JSONSpliterator.js";
 export * from "./lib/parallel-map.js";
 export * from "./lib/parallel-map-workers.js";
 export * from "./lib/pivot.js";
+export * from "./lib/row-emitters.js";
 export * from "./lib/PSVSpliterator.js";
 export * from "./lib/segments.js";
 export * from "./lib/shared.js";

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA"}

package/out/lib/CSVSpliterator.d.ts

@@ -5,30 +5,20 @@
  */
 import { AsyncSequence } from "./AsyncSequence.js";
 import { type CharacterSequenceInput } from "./CharacterSequence.js";
+import { type RowEmitter, type RowOutputMode, type RowTransformer, type RowTransformerEntry, type RowTransformerRecord, type RowTuple } from "./row-emitters.js";
 import type { AsyncChunkIterator, AsyncDataResource } from "./shared.js";
 import { type AsyncSpliteratorInit, type SpliteratorInit } from "./Spliterator.js";
+export type { RowTuple } from "./row-emitters.js";
 /**
  * An output mode for the CSV generator.
  */
-export type CSVOutputMode = "array" | "object" | "entries";
-export type CSVTransformer<T = unknown> = (value: string) => T;
-export type CSVTransformerEntry<T = unknown> = [columnName: string, transformer: CSVTransformer<T>];
-export type CSVTransformerRecord = Record<string, CSVTransformer | undefined>;
-export type CSVEmitter<T = unknown> = (columns: Iterable<string>, headerColumns?: Iterable<CSVTransformerEntry>) => T;
+export type CSVOutputMode = RowOutputMode;
+export type CSVTransformer<T = unknown> = RowTransformer<string, T>;
+export type CSVTransformerEntry<T = unknown> = RowTransformerEntry<string, T>;
+export type CSVTransformerRecord = RowTransformerRecord<string>;
+export type CSVEmitter<T = unknown> = RowEmitter<string, T>;
 export type CSVSpliteratorEmittedRecord<V = string | number | undefined> = Record<string, V>;
-/**
- * A row emitted by the CSV generator, as a 3-tuple:
- *
- * - The key of the column.
- * - The value of the column.
- * - The index of the row.
- */
-export type RowTuple<V = string | number> = [key: string, value: V, idx: number];
-export declare const CSVSpliteratorEmitters: {
-    readonly array: null;
-    readonly entries: (columns: Iterable<string>, headerColumns?: Iterable<CSVTransformerEntry>) => RowTuple<unknown>[];
-    readonly object: (columns: Iterable<string>, headerColumns?: Iterable<CSVTransformerEntry>) => CSVSpliteratorEmittedRecord<unknown>;
-};
+export declare const CSVSpliteratorEmitters: Record<CSVOutputMode, CSVEmitter | null>;
 export interface CSVSpliteratorInit extends SpliteratorInit {
     /**
      * The mode determines the shape of the data emitted by the generator.

package/out/lib/CSVSpliterator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CSVSpliterator.d.ts","sourceRoot":"","sources":["../../lib/CSVSpliterator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CSVSpliterator.d.ts","sourceRoot":"","sources":["../../lib/CSVSpliterator.ts"],"names":[],"mappings":"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"}

package/out/lib/CSVSpliterator.js

@@ -7,9 +7,8 @@ import { openDelimitedRows } from "./adaptive-source.js";
 import { AsyncSequence } from "./AsyncSequence.js";
 import { normalizeColumnNames } from "./casing.js";
 import { CharacterSequence, Delimiters } from "./CharacterSequence.js";
+import { bindTransformers, createRowEmitters, } from "./row-emitters.js";
 import { Spliterator } from "./Spliterator.js";
-import { zipSync } from "./zip.js";
-const identity = (value) => value;
 const doubleQuoteSequence = new CharacterSequence('"');
 /**
  * Decode a single column, stripping wrapping quotes and unescaping doubled quotes (`""` → `"`) when quote handling is
@@ -49,25 +48,7 @@ function splitRowColumns(row, columnDelimiter, decoder, enableQuoteHandling) {
     columns.push(decodeColumn(row.subarray(sliceStart), decoder, enableQuoteHandling));
     return columns;
 }
-export const CSVSpliteratorEmitters = {
-    array: null,
-    entries(columns, headerColumns = []) {
-        return Array.from(zipSync(headerColumns, columns), ([transformer, value], idx) => {
-            const key = transformer?.[0];
-            const transform = transformer?.[1] ?? identity;
-            return [key ?? `column_${idx}`, transform(value ?? ""), idx];
-        });
-    },
-    object(columns, headerColumns = []) {
-        const record = {};
-        for (const [transformer, value, idx] of zipSync(headerColumns, columns)) {
-            const key = transformer?.[0] ?? `column_${idx}`;
-            const transform = transformer?.[1] ?? identity;
-            record[key] = transform(value ?? "");
-        }
-        return record;
-    },
-};
+export const CSVSpliteratorEmitters = createRowEmitters("");
 /**
  * A static class spliterator for comma-separated values.
  *
@@ -121,19 +102,7 @@ export class CSVSpliterator {
                 return;
             const columns = splitRowColumns(result.value, columnDelimiter, decoder, enableQuoteHandling);
             const headers = normalizeKeys ? normalizeColumnNames(columns) : columns;
-            // oxlint-disable-next-line unicorn/prefer-ternary
-            if (Array.isArray(transformersInput)) {
-                transformers = Array.from(zipSync(headers, transformersInput), ([columnName, transformer]) => [
-                    columnName,
-                    transformer ?? identity,
-                ]);
-            }
-            else {
-                transformers = headers.map((columnName) => {
-                    const transform = transformersInput[columnName] || identity;
-                    return [columnName, transform];
-                });
-            }
+            transformers = bindTransformers(headers, transformersInput);
         }
         for (const row of rows) {
             if (yieldCount < drop) {
@@ -183,19 +152,7 @@ export class CSVSpliterator {
                     return rows;
                 const columns = splitRowColumns(result.value, columnDelimiter, decoder, enableQuoteHandling);
                 const headers = normalizeKeys ? normalizeColumnNames(columns) : columns;
-                // oxlint-disable-next-line unicorn/prefer-ternary
-                if (Array.isArray(transformersInput)) {
-                    transformers = Array.from(zipSync(headers, transformersInput), ([columnName, transformer]) => [
-                        columnName,
-                        transformer ?? identity,
-                    ]);
-                }
-                else {
-                    transformers = headers.map((columnName) => {
-                        const transform = transformersInput[columnName] || identity;
-                        return [columnName, transform];
-                    });
-                }
+                transformers = bindTransformers(headers, transformersInput);
             }
             return rows;
         };

package/out/lib/CSVSpliterator.js.map

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

package/out/lib/XLSXSpliterator.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { AsyncSequence } from "./AsyncSequence.js";
+import { type RowEmitter, type RowOutputMode, type RowTransformer, type RowTransformerEntry, type RowTransformerRecord, type RowTuple } from "./row-emitters.js";
+import type { AsyncChunkIterator } from "./shared.js";
+/**
+ * A cell value as parsed from an XLSX sheet. Unlike CSV columns, XLSX cells arrive typed — numbers, booleans, and dates
+ * are real values, not strings — and an empty cell is `null`.
+ */
+export type XLSXCellValue = string | number | boolean | Date | null;
+export type XLSXTransformer<T = unknown> = RowTransformer<XLSXCellValue, T>;
+export type XLSXTransformerEntry<T = unknown> = RowTransformerEntry<XLSXCellValue, T>;
+export type XLSXTransformerRecord = RowTransformerRecord<XLSXCellValue>;
+export type XLSXSpliteratorEmittedRecord<V = XLSXCellValue> = Record<string, V>;
+/**
+ * A readable XLSX source: a file path, a whole workbook in memory, or an asynchronous byte stream.
+ */
+export type XLSXSource = string | URL | Uint8Array | AsyncChunkIterator;
+/**
+ * A row accepted by {@linkcode XLSXSpliterator.write}: either an array of cells, or a record whose keys become the
+ * header row. `undefined` cells are written as empty (`null`) cells, so records read under `noUncheckedIndexedAccess`
+ * pass through without ceremony.
+ */
+export type XLSXWritableRow = readonly (XLSXCellValue | undefined)[] | Readonly<Record<string, XLSXCellValue | undefined>>;
+export declare const XLSXSpliteratorEmitters: Record<RowOutputMode, RowEmitter<XLSXCellValue> | null>;
+export interface XLSXSpliteratorInit {
+    /**
+     * The sheet to read, as a 1-based sheet number or a sheet name.
+     *
+     * @default 1
+     */
+    sheet?: number | string;
+    /**
+     * The mode determines the shape of the data emitted by the generator.
+     *
+     * - `object` will emit each row as an object with the header names as keys.
+     * - `array` will emit each row as an array.
+     * - `entries` will emit each row as an array of key-value pairs.
+     *
+     * @default "array"
+     */
+    mode?: RowOutputMode;
+    /**
+     * Whether to treat the first row as a header.
+     *
+     * @default true
+     */
+    header?: boolean;
+    /**
+     * Whether to normalize the keys of the header row into `snake_case`, matching {@linkcode CSVSpliterator}.
+     *
+     * @default `mode !== "array"`
+     */
+    normalizeKeys?: boolean;
+    /**
+     * Per-column transformers. Unlike CSV transformers, these receive typed cell values ({@linkcode XLSXCellValue}), not
+     * strings.
+     */
+    transformers?: Iterable<XLSXTransformerEntry> | XLSXTransformerRecord;
+    /**
+     * The number of data rows to skip before yielding.
+     */
+    drop?: number;
+    /**
+     * The maximum number of rows to yield.
+     */
+    take?: number;
+}
+export interface XLSXWriteInit {
+    /**
+     * The name of the written sheet.
+     */
+    sheet?: string;
+    /**
+     * Whether to emit a header row.
+     *
+     * @default true for record rows — the header is derived from the first record's keys. Array rows have no keys, so
+     *   this defaults to false and enabling it is a `TypeError`.
+     */
+    header?: boolean;
+}
+/**
+ * A handle over a pending XLSX serialization. The source rows are materialized on the first invocation of any method —
+ * XLSX is a ZIP archive, so the workbook must be complete before any bytes can be produced.
+ */
+export interface XLSXWriteHandle {
+    toFile(path: string): Promise<void>;
+    toBuffer(): Promise<Buffer>;
+    toStream(writable?: NodeJS.WritableStream): Promise<unknown>;
+}
+/**
+ * A static class spliterator for XLSX workbooks, reading through the optional peer dependency `read-excel-file` and
+ * writing through `write-excel-file`.
+ *
+ * **Memory:** XLSX is a ZIP archive of XML documents — shared strings live in a separate archive entry, and the central
+ * directory sits at the end of the file. Both reading and writing therefore materialize the whole workbook, unlike the
+ * byte-level spliterators. Prefer CSV for sources large enough that bounded memory matters.
+ *
+ * @see {@linkcode XLSXSpliterator.fromAsync} for reading.
+ * @see {@linkcode XLSXSpliterator.write} for writing.
+ */
+export declare abstract class XLSXSpliterator {
+    constructor();
+    /**
+     * XLSX cannot be parsed synchronously — decompression and XML parsing are asynchronous in the underlying reader.
+     *
+     * @throws {TypeError} Always. Use {@linkcode XLSXSpliterator.fromAsync}.
+     */
+    static from(_source?: unknown, _init?: unknown): never;
+    /**
+     * @yields Each row as an object with the header names as keys.
+     */
+    static fromAsync<T extends XLSXSpliteratorEmittedRecord = XLSXSpliteratorEmittedRecord>(source: XLSXSource, options?: XLSXSpliteratorInit & {
+        mode: "object";
+    }): AsyncSequence<T>;
+    /**
+     * @yields Each row as a 3-tuple [key, value, idx].
+     */
+    static fromAsync<T extends RowTuple<unknown>[] = RowTuple<XLSXCellValue>[]>(source: XLSXSource, options?: XLSXSpliteratorInit & {
+        mode: "entries";
+    }): AsyncSequence<T>;
+    /**
+     * @yields Each row as an array of typed cells.
+     */
+    static fromAsync<T extends XLSXCellValue[] = XLSXCellValue[]>(source: XLSXSource, options?: XLSXSpliteratorInit & {
+        mode?: "array";
+    }): AsyncSequence<T>;
+    /**
+     * Serialize rows into an XLSX workbook through the optional peer dependency `write-excel-file`.
+     *
+     * Rows may be arrays of cells, or records — record keys become the header row, read in the first record's key order.
+     * The source is materialized on the first invocation of a handle method: the workbook must be complete before any
+     * bytes can be produced.
+     *
+     * @param source The rows to write, as any iterable or async iterable.
+     * @param init Options for the writer.
+     */
+    static write(source: Iterable<XLSXWritableRow> | AsyncIterable<XLSXWritableRow>, init?: XLSXWriteInit): XLSXWriteHandle;
+}
+//# sourceMappingURL=XLSXSpliterator.d.ts.map

package/out/lib/XLSXSpliterator.d.ts.map

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

package/out/lib/XLSXSpliterator.js

@@ -0,0 +1,161 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { AsyncSequence } from "./AsyncSequence.js";
+import { normalizeColumnNames } from "./casing.js";
+import { bindTransformers, createRowEmitters, } from "./row-emitters.js";
+export const XLSXSpliteratorEmitters = createRowEmitters(null);
+/**
+ * Wrap the optional peer dependency import so a missing module names the package to install.
+ */
+async function importVendor(packageName, importer) {
+    try {
+        return await importer();
+    }
+    catch (error) {
+        throw new Error(`XLSXSpliterator requires the optional peer dependency "${packageName}". Install it to use this API.`, { cause: error });
+    }
+}
+/**
+ * Adapt a {@linkcode XLSXSource} to what `read-excel-file/node` accepts: a path, a `Buffer`, or a Node stream.
+ */
+async function resolveVendorInput(source) {
+    if (typeof source === "string")
+        return source;
+    if (source instanceof URL) {
+        const { fileURLToPath } = await import("node:url");
+        return fileURLToPath(source);
+    }
+    if (source instanceof Uint8Array) {
+        // Respect the byte offset: small `Buffer`s share a pool, so offset 0 of the
+        // underlying `ArrayBuffer` may be another allocation's data.
+        return Buffer.from(source.buffer, source.byteOffset, source.byteLength);
+    }
+    const { Readable } = await import("node:stream");
+    return Readable.from(source);
+}
+/**
+ * A static class spliterator for XLSX workbooks, reading through the optional peer dependency `read-excel-file` and
+ * writing through `write-excel-file`.
+ *
+ * **Memory:** XLSX is a ZIP archive of XML documents — shared strings live in a separate archive entry, and the central
+ * directory sits at the end of the file. Both reading and writing therefore materialize the whole workbook, unlike the
+ * byte-level spliterators. Prefer CSV for sources large enough that bounded memory matters.
+ *
+ * @see {@linkcode XLSXSpliterator.fromAsync} for reading.
+ * @see {@linkcode XLSXSpliterator.write} for writing.
+ */
+export class XLSXSpliterator {
+    constructor() {
+        throw new TypeError("Static class cannot be instantiated. Did you mean `XLSXSpliterator.fromAsync`?");
+    }
+    /**
+     * XLSX cannot be parsed synchronously — decompression and XML parsing are asynchronous in the underlying reader.
+     *
+     * @throws {TypeError} Always. Use {@linkcode XLSXSpliterator.fromAsync}.
+     */
+    static from(_source, _init) {
+        throw new TypeError("XLSX cannot be parsed synchronously. Did you mean `XLSXSpliterator.fromAsync`?");
+    }
+    /**
+     * Given an XLSX workbook, yield each row of a sheet, shaped according to the `mode` option.
+     *
+     * Note that unlike the byte-level spliterators, the whole sheet is materialized before the first row is yielded.
+     *
+     * @param source The workbook to read.
+     * @param init Options for the spliterator.
+     *
+     * @yields Each row, shaped according to the `mode` option.
+     */
+    static fromAsync(source, init = {}) {
+        const { 
+        // ---
+        sheet = 1, header = true, mode = "array", transformers: transformersInput = [], normalizeKeys = mode !== "array", take = Infinity, drop = 0, } = init;
+        const emitter = XLSXSpliteratorEmitters[mode];
+        // Populated by the header pass below before the first row op runs, matching `CSVSpliterator.fromAsync`.
+        let transformers = [];
+        const openRows = async () => {
+            const { readSheet } = await importVendor("read-excel-file", () => import("read-excel-file/node"));
+            const input = await resolveVendorInput(source);
+            const rows = (await readSheet(input, sheet));
+            if (!header)
+                return rows;
+            const headerRow = rows[0];
+            if (!headerRow)
+                return [];
+            // A header row may legally contain non-string cells — stringify before normalization.
+            const columns = headerRow.map((cell) => String(cell ?? ""));
+            const headers = normalizeKeys ? normalizeColumnNames(columns) : columns;
+            transformers = bindTransformers(headers, transformersInput);
+            return rows.slice(1);
+        };
+        let sequence = AsyncSequence.from(openRows).map((row) => {
+            return emitter ? emitter(row, transformers) : row;
+        });
+        if (drop > 0) {
+            sequence = sequence.drop(drop);
+        }
+        if (Number.isFinite(take)) {
+            sequence = sequence.take(take);
+        }
+        return sequence;
+    }
+    /**
+     * Serialize rows into an XLSX workbook through the optional peer dependency `write-excel-file`.
+     *
+     * Rows may be arrays of cells, or records — record keys become the header row, read in the first record's key order.
+     * The source is materialized on the first invocation of a handle method: the workbook must be complete before any
+     * bytes can be produced.
+     *
+     * @param source The rows to write, as any iterable or async iterable.
+     * @param init Options for the writer.
+     */
+    static write(source, init = {}) {
+        const open = async () => {
+            const { default: writeXlsxFile } = await importVendor("write-excel-file", () => import("write-excel-file/node"));
+            const data = await materializeSheetData(source, init);
+            return writeXlsxFile(data, init.sheet === undefined ? undefined : { sheet: init.sheet });
+        };
+        return {
+            async toFile(path) {
+                await (await open()).toFile(path);
+            },
+            async toBuffer() {
+                return (await open()).toBuffer();
+            },
+            async toStream(writable) {
+                return (await open()).toStream(writable);
+            },
+        };
+    }
+}
+/**
+ * Materialize writable rows into `write-excel-file`'s sheet data: bare cell values, with a header row derived from
+ * record keys when the rows are records.
+ */
+async function materializeSheetData(source, init) {
+    const data = [];
+    let keys;
+    for await (const row of source) {
+        if (Array.isArray(row)) {
+            if (init.header) {
+                throw new TypeError("`header` requires record rows — array rows have no keys to derive a header from.");
+            }
+            data.push(row);
+            continue;
+        }
+        const record = row;
+        if (!keys) {
+            // The header is derived from the first record's keys; later records are read in that order.
+            keys = Object.keys(record);
+            if (init.header !== false) {
+                data.push(keys);
+            }
+        }
+        data.push(keys.map((key) => record[key] ?? null));
+    }
+    return data;
+}
+//# sourceMappingURL=XLSXSpliterator.js.map

package/out/lib/XLSXSpliterator.js.map

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

package/out/lib/row-emitters.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * An output mode for row-emitting spliterators.
+ */
+export type RowOutputMode = "array" | "object" | "entries";
+export type RowTransformer<V, T = unknown> = (value: V) => T;
+export type RowTransformerEntry<V, T = unknown> = [columnName: string, transformer: RowTransformer<V, T>];
+export type RowTransformerRecord<V> = Record<string, RowTransformer<V> | undefined>;
+export type RowEmitter<V, T = unknown> = (columns: Iterable<V>, headerColumns?: Iterable<RowTransformerEntry<V>>) => T;
+export type EmittedRecord<V = unknown> = Record<string, V>;
+/**
+ * A row emitted in `entries` mode, as a 3-tuple:
+ *
+ * - The key of the column.
+ * - The value of the column.
+ * - The index of the row.
+ */
+export type RowTuple<V = string | number> = [key: string, value: V, idx: number];
+export declare const identity: <V>(value: V) => V;
+/**
+ * Create the `mode`-keyed emitter table for a cell type.
+ *
+ * `missingValue` fills columns absent from a short row (CSV binds `""`, XLSX binds `null`).
+ */
+export declare function createRowEmitters<V>(missingValue: V): Record<RowOutputMode, RowEmitter<V> | null>;
+/**
+ * Bind a header row to the caller's transformers, producing the `headerColumns` entries the emitters consume. Columns
+ * without a transformer pass through {@linkcode identity}.
+ */
+export declare function bindTransformers<V>(headers: string[], transformersInput: Iterable<RowTransformerEntry<V>> | RowTransformerRecord<V>): RowTransformerEntry<V>[];
+//# sourceMappingURL=row-emitters.d.ts.map

package/out/lib/row-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-emitters.d.ts","sourceRoot":"","sources":["../../lib/row-emitters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE1D,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;AAE5D,MAAM,MAAM,mBAAmB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEzG,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;AAEnF,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AAEtH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;AAEhF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,KAAG,CAAU,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAyBjG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EAAE,EACjB,iBAAiB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,GAC3E,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAa1B"}

package/out/lib/row-emitters.js

@@ -0,0 +1,50 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { zipSync } from "./zip.js";
+export const identity = (value) => value;
+/**
+ * Create the `mode`-keyed emitter table for a cell type.
+ *
+ * `missingValue` fills columns absent from a short row (CSV binds `""`, XLSX binds `null`).
+ */
+export function createRowEmitters(missingValue) {
+    return {
+        array: null,
+        entries(columns, headerColumns = []) {
+            return Array.from(zipSync(headerColumns, columns), ([transformer, value], idx) => {
+                const key = transformer?.[0];
+                const transform = transformer?.[1] ?? identity;
+                return [key ?? `column_${idx}`, transform(value ?? missingValue), idx];
+            });
+        },
+        object(columns, headerColumns = []) {
+            const record = {};
+            for (const [transformer, value, idx] of zipSync(headerColumns, columns)) {
+                const key = transformer?.[0] ?? `column_${idx}`;
+                const transform = transformer?.[1] ?? identity;
+                record[key] = transform(value ?? missingValue);
+            }
+            return record;
+        },
+    };
+}
+/**
+ * Bind a header row to the caller's transformers, producing the `headerColumns` entries the emitters consume. Columns
+ * without a transformer pass through {@linkcode identity}.
+ */
+export function bindTransformers(headers, transformersInput) {
+    if (Array.isArray(transformersInput)) {
+        return Array.from(zipSync(headers, transformersInput), ([columnName, transformer]) => [
+            columnName,
+            transformer ?? identity,
+        ]);
+    }
+    return headers.map((columnName) => {
+        const transform = transformersInput[columnName] || identity;
+        return [columnName, transform];
+    });
+}
+//# sourceMappingURL=row-emitters.js.map

package/out/lib/row-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-emitters.js","sourceRoot":"","sources":["../../lib/row-emitters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AA0BlC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,KAAK,CAAA;AAEjD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAI,YAAe;IACnD,OAAO;QACN,KAAK,EAAE,IAAI;QAEX,OAAO,CAAC,OAAoB,EAAE,aAAa,GAAqC,EAAE;YACjF,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE;gBAChF,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAA;gBAC5B,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;gBAE9C,OAAO,CAAC,GAAG,IAAI,UAAU,GAAG,EAAE,EAAE,SAAS,CAAC,KAAK,IAAI,YAAY,CAAC,EAAE,GAAG,CAAC,CAAA;YACvE,CAAC,CAAC,CAAA;QACH,CAAC;QACD,MAAM,CAAC,OAAoB,EAAE,aAAa,GAAqC,EAAE;YAChF,MAAM,MAAM,GAA2B,EAAE,CAAA;YAEzC,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC;gBACzE,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,GAAG,EAAE,CAAA;gBAC/C,MAAM,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;gBAE9C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,IAAI,YAAY,CAAC,CAAA;YAC/C,CAAC;YAED,OAAO,MAAM,CAAA;QACd,CAAC;KACD,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC/B,OAAiB,EACjB,iBAA6E;IAE7E,IAAI,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;YACrF,UAAW;YACV,WAA6C,IAAI,QAAQ;SAC1D,CAAC,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACjC,MAAM,SAAS,GAAI,iBAA6C,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAA;QAExF,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "spliterator",
-	"version": "6.0.1",
+	"version": "6.1.0",
 	"description": "Line-delimited iterator library for CSV, NDJSON, and other delimited formats.",
 	"keywords": [
 		"csv",
@@ -75,21 +75,31 @@
 		"oxfmt": "0.62.0",
 		"oxlint": "1.77.0",
 		"path-ts": "^2.1.0",
+		"read-excel-file": "^9.3.5",
 		"release-it": "^21.0.1",
 		"type-fest": "^5.8.0",
 		"typescript": "^7.0.2",
-		"vitest": "^4.1.10"
+		"vitest": "^4.1.10",
+		"write-excel-file": "^4.1.1"
 	},
 	"peerDependencies": {
 		"change-case": "^5.4.4",
-		"type-fest": "^5.6.0"
+		"read-excel-file": "^9.3.5",
+		"type-fest": "^5.6.0",
+		"write-excel-file": "^4.1.1"
 	},
 	"peerDependenciesMeta": {
 		"change-case": {
 			"optional": true
 		},
+		"read-excel-file": {
+			"optional": true
+		},
 		"type-fest": {
 			"optional": true
+		},
+		"write-excel-file": {
+			"optional": true
 		}
 	},
 	"engines": {