spliterator 6.0.1 → 6.2.0

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

@@ -0,0 +1,131 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { type CharacterSequenceInput } from "../core/CharacterSequence.js";
+import { type AsyncSpliteratorInit, type SpliteratorInit } from "../core/Spliterator.js";
+import type { AsyncChunkIterator, AsyncDataResource } from "../internal/shared.js";
+import { AsyncSequence } from "../iterators/AsyncSequence.js";
+import { type RowEmitter, type RowOutputMode, type RowTransformer, type RowTransformerEntry, type RowTransformerRecord, type RowTuple } from "./row-emitters.js";
+export type { RowTuple } from "./row-emitters.js";
+/**
+ * An output mode for the CSV generator.
+ */
+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>;
+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.
+     *
+     * - `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.
+     *
+     * Note that {@linkcode CSVSpliteratorInit.header} defaults to `true` in every mode — the first row is consumed as the
+     * header even in `array` mode. Pass `header: false` for headerless data.
+     *
+     * When {@linkcode SpliteratorInit.enableQuoteHandling} is set, quoting is handled end-to-end: rows do not split on
+     * delimiters inside quotes (embedded newlines stay in their row), columns do not split on quoted column delimiters,
+     * wrapping quotes are stripped, and doubled quotes (`""`) unescape to `"`.
+     *
+     * {@linkcode SpliteratorInit.crlf} defaults to `true` here (unlike everywhere else): RFC 4180 mandates CRLF row
+     * terminators, so a correct CSV parser must accept them without leaking `\r` into the last column.
+     */
+    mode?: CSVOutputMode;
+    /**
+     * The delimiter to use for columns in a row.
+     *
+     * @default Delimiter.Comma
+     */
+    columnDelimiter?: CharacterSequenceInput;
+    /**
+     * Whether to normalize the keys of the header row into `snake_case`, and to disambiguate duplicates by suffixing
+     * `_2`, `_3`, … — making them usable as object keys.
+     *
+     * **A header that is already ALL CAPS is left alone**, on the reasoning that its casing is deliberate. So an
+     * OpenAddresses header (`LON,LAT,NUMBER,STREET`) normalizes to `LON`/`NUMBER`, NOT `lon`/`number`, and a row is read
+     * as `row.STREET`. Lower-case your own keys if you want case-folding — this option does not provide it.
+     *
+     * @default `mode !== "array"` — object and entries rows need keyable names; array rows have no keys to normalize.
+     */
+    normalizeKeys?: boolean;
+    /**
+     * Whether to treat the first row as a header.
+     *
+     * @default true
+     */
+    header?: boolean;
+    transformers?: Iterable<CSVTransformerEntry> | CSVTransformerRecord;
+}
+/**
+ * A static class spliterator for comma-separated values.
+ *
+ * **Performance:** the SIMD delimiter scan wins when scanning dominates — many rows, a few columns pulled out cheaply,
+ * streaming to bound memory. When per-row work is heavy (a full `JSON.parse`, expensive transforms) it can dominate the
+ * scan and erase the advantage; benchmark against a mature native parser before swapping an existing loop for speed.
+ * See {@link JSONSpliterator} for the measured case where per-row `JSON.parse` makes the streamed path a net loss.
+ *
+ * @see {@linkcode CSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode CSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export declare abstract class CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Comma
+     */
+    static ColumnDelimiter: number;
+    constructor();
+    static from<T extends CSVSpliteratorEmittedRecord = CSVSpliteratorEmittedRecord>(source: CharacterSequenceInput, options?: CSVSpliteratorInit & {
+        mode: "object";
+    }): Generator<T>;
+    /**
+     * @yields Each row as a 3-tuple [key, value, idx].
+     */
+    static from<T extends RowTuple[] = RowTuple[]>(source: CharacterSequenceInput, options?: CSVSpliteratorInit & {
+        mode: "entries";
+    }): Generator<T>;
+    /**
+     * Given a byte array or string, yield each row as an array of columns.
+     *
+     * @yields Each row as an array of columns.
+     */
+    static from<T extends string[] = string[]>(source: CharacterSequenceInput, options?: CSVSpliteratorInit & {
+        mode?: "array";
+    }): Generator<T>;
+    /**
+     * @yields Each row as an object with the header names as keys.
+     */
+    static fromAsync<T extends CSVSpliteratorEmittedRecord = CSVSpliteratorEmittedRecord>(source: AsyncDataResource | AsyncChunkIterator, options?: CSVSpliteratorInit & AsyncSpliteratorInit & {
+        mode: "object";
+    }): AsyncSequence<T>;
+    /**
+     * @yields Each row as a 3-tuple [key, value, idx].
+     */
+    static fromAsync<T extends RowTuple[] = RowTuple[]>(source: AsyncDataResource | AsyncChunkIterator, options?: CSVSpliteratorInit & AsyncSpliteratorInit & {
+        mode: "entries";
+    }): AsyncSequence<T>;
+    /**
+     * @yields Each row as an array of columns.
+     */
+    static fromAsync<T extends string[] = string[]>(source: AsyncDataResource | AsyncChunkIterator, options?: CSVSpliteratorInit & AsyncSpliteratorInit & {
+        mode?: "array";
+    }): AsyncSequence<T>;
+    /**
+     * Given an asychronous data source, splits the data by rows(usually by newline) and then by columns (usually by
+     * comma).
+     *
+     * @param source The data source to split.
+     * @param init Options for the spliterator.
+     *
+     * @yields Each row, shaped according to the `mode` option.
+     */
+    static fromAsync(source: AsyncDataResource | AsyncChunkIterator, init?: CSVSpliteratorInit & AsyncSpliteratorInit): AsyncSequence<unknown>;
+}
+//# sourceMappingURL=CSVSpliterator.d.ts.map

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

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

package/out/lib/formats/CSVSpliterator.js

@@ -0,0 +1,172 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { CharacterSequence, Delimiters } from "../core/CharacterSequence.js";
+import { Spliterator } from "../core/Spliterator.js";
+import { openDelimitedRows } from "../io/adaptive-source.js";
+import { AsyncSequence } from "../iterators/AsyncSequence.js";
+import { normalizeColumnNames } from "./casing.js";
+import { bindTransformers, createRowEmitters, } from "./row-emitters.js";
+const doubleQuoteSequence = new CharacterSequence('"');
+/**
+ * Decode a single column, stripping wrapping quotes and unescaping doubled quotes (`""` → `"`) when quote handling is
+ * on. The unescape allocates only when the field was actually quoted.
+ */
+function decodeColumn(bytes, decoder, enableQuoteHandling) {
+    const value = decoder.decode(bytes);
+    if (enableQuoteHandling && value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+        return value.slice(1, -1).replaceAll('""', '"');
+    }
+    return value;
+}
+/**
+ * Split one row's bytes into decoded column strings.
+ *
+ * Without quote handling this is a plain delimiter scan. With it, a column delimiter inside a double-quoted region does
+ * not split, and each field is unquoted/unescaped via {@linkcode decodeColumn}. Empty columns are always preserved — a
+ * 30-column row must stay 30 columns regardless of the caller's row-level `skipEmpty`.
+ */
+function splitRowColumns(row, columnDelimiter, decoder, enableQuoteHandling) {
+    if (!enableQuoteHandling) {
+        return columnDelimiter.searchAll(row).map(([start, end]) => decoder.decode(row.subarray(start, end)));
+    }
+    const columns = [];
+    let sliceStart = 0;
+    let insideQuotes = false;
+    for (const match of columnDelimiter.searchMatches(row, doubleQuoteSequence)) {
+        if (match.patternId === 1) {
+            insideQuotes = !insideQuotes;
+            continue;
+        }
+        if (insideQuotes)
+            continue;
+        columns.push(decodeColumn(row.subarray(sliceStart, match.offset), decoder, enableQuoteHandling));
+        sliceStart = match.offset + columnDelimiter.length;
+    }
+    columns.push(decodeColumn(row.subarray(sliceStart), decoder, enableQuoteHandling));
+    return columns;
+}
+export const CSVSpliteratorEmitters = createRowEmitters("");
+/**
+ * A static class spliterator for comma-separated values.
+ *
+ * **Performance:** the SIMD delimiter scan wins when scanning dominates — many rows, a few columns pulled out cheaply,
+ * streaming to bound memory. When per-row work is heavy (a full `JSON.parse`, expensive transforms) it can dominate the
+ * scan and erase the advantage; benchmark against a mature native parser before swapping an existing loop for speed.
+ * See {@link JSONSpliterator} for the measured case where per-row `JSON.parse` makes the streamed path a net loss.
+ *
+ * @see {@linkcode CSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode CSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export class CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Comma
+     */
+    static ColumnDelimiter = Delimiters.Comma;
+    constructor() {
+        throw new TypeError("Static class cannot be instantiated. Did you mean `CSVSpliterator.from`?");
+    }
+    /**
+     * Given a byte array or string, yield each row as an array of columns.
+     *
+     * @yields Each row as an array of columns.
+     */
+    static *from(source, init = {}) {
+        const { 
+        // ---
+        header = true, 
+        // `mode` is destructured before `normalizeKeys` because the latter's default reads it.
+        mode = "array", transformers: transformersInput = [], 
+        // Matches `fromAsync`. These two defaulted differently until 4.0.1, so the same options
+        // object produced `row.some_name` from one entry point and `row["Some Name"]` from the other.
+        normalizeKeys = mode !== "array", columnDelimiter: columnDelimiterInput = this.ColumnDelimiter, enableQuoteHandling = false, 
+        // RFC 4180 mandates CRLF row terminators — accept them by default so the last column
+        // never carries a stray `\r` on Windows-lineage sources.
+        crlf = true, take = Infinity, drop = 0, ...rowInit } = init;
+        const emitter = CSVSpliteratorEmitters[mode];
+        let transformers = [];
+        let yieldCount = 0;
+        const yieldLimit = take + drop;
+        const decoder = new TextDecoder();
+        const columnDelimiter = new CharacterSequence(columnDelimiterInput ?? this.ColumnDelimiter);
+        // Quote handling applies at both levels: rows must not split on newlines inside quotes,
+        // columns must not split on quoted column delimiters.
+        const rows = Spliterator.fromSync(source, { ...rowInit, crlf, enableQuoteHandling });
+        if (header) {
+            const result = rows.next();
+            if (result.done)
+                return;
+            const columns = splitRowColumns(result.value, columnDelimiter, decoder, enableQuoteHandling);
+            const headers = normalizeKeys ? normalizeColumnNames(columns) : columns;
+            transformers = bindTransformers(headers, transformersInput);
+        }
+        for (const row of rows) {
+            if (yieldCount < drop) {
+                yieldCount++;
+                continue;
+            }
+            if (yieldCount >= yieldLimit)
+                break;
+            const columns = splitRowColumns(row, columnDelimiter, decoder, enableQuoteHandling);
+            yield emitter ? emitter(columns, transformers) : columns;
+            yieldCount++;
+        }
+    }
+    /**
+     * Given an asychronous data source, splits the data by rows (usually by newline) and then by columns (usually by
+     * comma).
+     *
+     * @param source The data source to split.
+     * @param init Options for the spliterator.
+     *
+     * @yields Each row, shaped according to the `mode` option.
+     */
+    static fromAsync(source, init = {}) {
+        const defaultColumnDelimiter = this.ColumnDelimiter;
+        const { 
+        // ---
+        header = true, mode = "array", transformers: transformersInput = [], normalizeKeys = mode !== "array", columnDelimiter: columnDelimiterInput, enableQuoteHandling = false, 
+        // RFC 4180 mandates CRLF row terminators — accept them by default so the last column
+        // never carries a stray `\r` on Windows-lineage sources.
+        crlf = true, take = Infinity, drop = 0, ...rowInit } = init;
+        const emitter = CSVSpliteratorEmitters[mode];
+        const columnDelimiter = new CharacterSequence(columnDelimiterInput ?? defaultColumnDelimiter);
+        const decoder = new TextDecoder();
+        // Populated by the header pass below before the first row op runs, since the source thunk resolves on the first
+        // pull and the ops only run against what it returns.
+        let transformers = [];
+        const openRows = async () => {
+            // Quote handling applies at both levels: rows must not split on newlines inside quotes,
+            // columns must not split on quoted column delimiters.
+            const rows = await openDelimitedRows(source, { ...rowInit, crlf, enableQuoteHandling });
+            if (header) {
+                // Both engines return `this` from their iterator method, so consuming the header row here advances the very
+                // cursor the row ops will go on to read — returning `rows` afterwards resumes at row two, not row one.
+                const iterator = Symbol.asyncIterator in rows ? rows[Symbol.asyncIterator]() : rows[Symbol.iterator]();
+                const result = await iterator.next();
+                if (result.done)
+                    return rows;
+                const columns = splitRowColumns(result.value, columnDelimiter, decoder, enableQuoteHandling);
+                const headers = normalizeKeys ? normalizeColumnNames(columns) : columns;
+                transformers = bindTransformers(headers, transformersInput);
+            }
+            return rows;
+        };
+        let sequence = AsyncSequence.from(openRows).map((row) => {
+            const columns = splitRowColumns(row, columnDelimiter, decoder, enableQuoteHandling);
+            return emitter ? emitter(columns, transformers) : columns;
+        });
+        if (drop > 0) {
+            sequence = sequence.drop(drop);
+        }
+        if (Number.isFinite(take)) {
+            sequence = sequence.take(take);
+        }
+        return sequence;
+    }
+}
+//# sourceMappingURL=CSVSpliterator.js.map

package/out/lib/formats/CSVSpliterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSVSpliterator.js","sourceRoot":"","sources":["../../../lib/formats/CSVSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAA+B,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzG,OAAO,EAA6B,WAAW,EAAwB,MAAM,wBAAwB,CAAA;AAErG,OAAO,EAA2B,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACN,gBAAgB,EAChB,iBAAiB,GAOjB,MAAM,mBAAmB,CAAA;AAiB1B,MAAM,mBAAmB,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAA;AAEtD;;;GAGG;AACH,SAAS,YAAY,CAAC,KAAiB,EAAE,OAAoB,EAAE,mBAA4B;IAC1F,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEnC,IAAI,mBAAmB,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9F,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAChD,CAAC;IAED,OAAO,KAAK,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CACvB,GAAe,EACf,eAAkC,EAClC,OAAoB,EACpB,mBAA4B;IAE5B,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACtG,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,YAAY,GAAG,KAAK,CAAA;IAExB,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,aAAa,CAAC,GAAG,EAAE,mBAAmB,CAAC,EAAE,CAAC;QAC7E,IAAI,KAAK,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;YAC3B,YAAY,GAAG,CAAC,YAAY,CAAA;YAE5B,SAAQ;QACT,CAAC;QAED,IAAI,YAAY;YAAE,SAAQ;QAE1B,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAChG,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAA;IACnD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAElF,OAAO,OAAO,CAAA;AACf,CAAC;AAID,MAAM,CAAC,MAAM,sBAAsB,GAA6C,iBAAiB,CAAS,EAAE,CAAC,CAAA;AAmD7G;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,cAAc;IACnC;;;;OAIG;IACI,MAAM,CAAC,eAAe,GAAW,UAAU,CAAC,KAAK,CAAA;IAExD;QACC,MAAM,IAAI,SAAS,CAAC,0EAA0E,CAAC,CAAA;IAChG,CAAC;IAuBD;;;;OAIG;IACH,MAAM,CAAC,CAAC,IAAI,CAAC,MAA8B,EAAE,IAAI,GAAuB,EAAE;QACzE,MAAM;QACL,MAAM;QACN,MAAM,GAAG,IAAI;QACb,uFAAuF;QACvF,IAAI,GAAG,OAAO,EACd,YAAY,EAAE,iBAAiB,GAAG,EAAE;QACpC,wFAAwF;QACxF,8FAA8F;QAC9F,aAAa,GAAG,IAAI,KAAK,OAAO,EAChC,eAAe,EAAE,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAC5D,mBAAmB,GAAG,KAAK;QAC3B,qFAAqF;QACrF,yDAAyD;QACzD,IAAI,GAAG,IAAI,EACX,IAAI,GAAG,QAAQ,EACf,IAAI,GAAG,CAAC,EACR,GAAG,OAAO,EACV,GAAG,IAAI,CAAA;QAER,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,YAAY,GAA0B,EAAE,CAAA;QAC5C,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAA;QAE9B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QACjC,MAAM,eAAe,GAAG,IAAI,iBAAiB,CAAC,oBAAoB,IAAI,IAAI,CAAC,eAAe,CAAC,CAAA;QAE3F,wFAAwF;QACxF,sDAAsD;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAA;QAEpF,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAE1B,IAAI,MAAM,CAAC,IAAI;gBAAE,OAAM;YAEvB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;YAC5F,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;YAEvE,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QAC5D,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;gBACvB,UAAU,EAAE,CAAA;gBAEZ,SAAQ;YACT,CAAC;YAED,IAAI,UAAU,IAAI,UAAU;gBAAE,MAAK;YAEnC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;YAEnF,MAAM,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;YAExD,UAAU,EAAE,CAAA;QACb,CAAC;IACF,CAAC;IAqCD;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CACf,MAA8C,EAC9C,IAAI,GAA4C,EAAE;QAElD,MAAM,sBAAsB,GAAG,IAAI,CAAC,eAAe,CAAA;QAEnD,MAAM;QACL,MAAM;QACN,MAAM,GAAG,IAAI,EACb,IAAI,GAAG,OAAO,EACd,YAAY,EAAE,iBAAiB,GAAG,EAAE,EACpC,aAAa,GAAG,IAAI,KAAK,OAAO,EAChC,eAAe,EAAE,oBAAoB,EACrC,mBAAmB,GAAG,KAAK;QAC3B,qFAAqF;QACrF,yDAAyD;QACzD,IAAI,GAAG,IAAI,EACX,IAAI,GAAG,QAAQ,EACf,IAAI,GAAG,CAAC,EACR,GAAG,OAAO,EACV,GAAG,IAAI,CAAA;QAER,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAA;QAC5C,MAAM,eAAe,GAAG,IAAI,iBAAiB,CAAC,oBAAoB,IAAI,sBAAsB,CAAC,CAAA;QAC7F,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QAEjC,gHAAgH;QAChH,qDAAqD;QACrD,IAAI,YAAY,GAA0B,EAAE,CAAA;QAE5C,MAAM,QAAQ,GAAG,KAAK,IAA+D,EAAE;YACtF,wFAAwF;YACxF,sDAAsD;YACtD,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAA;YAEvF,IAAI,MAAM,EAAE,CAAC;gBACZ,4GAA4G;gBAC5G,uGAAuG;gBACvG,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAA;gBACtG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;gBAEpC,IAAI,MAAM,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAA;gBAE5B,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;gBAC5F,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;gBAEvE,YAAY,GAAG,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;YAC5D,CAAC;YAED,OAAO,IAAI,CAAA;QACZ,CAAC,CAAA;QAED,IAAI,QAAQ,GAA2B,aAAa,CAAC,IAAI,CAAa,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC3F,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAA;YAEnF,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1D,CAAC,CAAC,CAAA;QAEF,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACd,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAA;IAChB,CAAC;CACD"}

package/out/lib/formats/JSONSpliterator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import type { CharacterSequenceInput } from "../core/CharacterSequence.js";
+import { type SpliteratorInit } from "../core/Spliterator.js";
+import type { AsyncDataResource } from "../internal/shared.js";
+import { type AdaptiveSourceInit } from "../io/adaptive-source.js";
+import { AsyncSequence } from "../iterators/AsyncSequence.js";
+/**
+ * Stream a delimited byte source and `JSON.parse` each row — one parsed value per line, for JSONL / NDJSON. The row
+ * delimiter defaults to a line feed; override it via `options.delimiter`. `skipEmpty` (on by default) drops blank
+ * rows.
+ *
+ * **Performance caveat — this path is `JSON.parse`-bound, not scan-bound.** Measured over 500k rows (88MB, ~177B per
+ * row, Node 26): the delimiter scan is ~140ms and decoding ~46ms, while `JSON.parse` and the per-row async machinery
+ * account for the rest of ~1280ms. Against Node's `readline` + `JSON.parse` at ~630ms, this runs **roughly half the
+ * speed — a net loss.** Use it for API convenience, or when streaming to bound memory; do NOT swap a working `readline`
+ * loop to it expecting a speedup on parse-heavy JSONL.
+ *
+ * The scan advantage only shows when you _don't_ fully parse every row. Filtering on the raw text and parsing only what
+ * survives is the shape that wins — parsing 20% of rows measured ~2.5× faster than parsing all of them:
+ *
+ * ```ts
+ * TextSpliterator.fromAsync(path, { delimiter: "\n" })
+ * 	.filter((line) => line.includes('"category":"Novelty"'))
+ * 	.map((line) => JSON.parse(line))
+ * ```
+ *
+ * For segmentation or counting, use {@link Spliterator} (raw byte ranges) or {@link TextSpliterator}. When unsure,
+ * benchmark.
+ */
+export declare abstract class JSONSpliterator {
+    constructor();
+    static from<T = unknown>(source: CharacterSequenceInput, options?: SpliteratorInit): Generator<T>;
+    /**
+     * Given a byte array or string, yield each row as an array of columns.
+     *
+     * @yields Each row as an array of columns.
+     */
+    static fromAsync<T = unknown>(source: AsyncDataResource, options?: AdaptiveSourceInit): AsyncSequence<T>;
+}
+//# sourceMappingURL=JSONSpliterator.d.ts.map

package/out/lib/formats/JSONSpliterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONSpliterator.d.ts","sourceRoot":"","sources":["../../../lib/formats/JSONSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,KAAK,kBAAkB,EAAqB,MAAM,0BAA0B,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,eAAe;IACpC,cAEC;IAED,MAAM,CAAE,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS,CAAC,CAAC,CAAC,CAwBrG;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAE,kBAAuB,GAAG,aAAa,CAAC,CAAC,CAAC,CAgB3G;CACD"}

package/out/lib/formats/JSONSpliterator.js

@@ -0,0 +1,77 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { Spliterator } from "../core/Spliterator.js";
+import { openDelimitedRows } from "../io/adaptive-source.js";
+import { AsyncSequence } from "../iterators/AsyncSequence.js";
+/**
+ * Stream a delimited byte source and `JSON.parse` each row — one parsed value per line, for JSONL / NDJSON. The row
+ * delimiter defaults to a line feed; override it via `options.delimiter`. `skipEmpty` (on by default) drops blank
+ * rows.
+ *
+ * **Performance caveat — this path is `JSON.parse`-bound, not scan-bound.** Measured over 500k rows (88MB, ~177B per
+ * row, Node 26): the delimiter scan is ~140ms and decoding ~46ms, while `JSON.parse` and the per-row async machinery
+ * account for the rest of ~1280ms. Against Node's `readline` + `JSON.parse` at ~630ms, this runs **roughly half the
+ * speed — a net loss.** Use it for API convenience, or when streaming to bound memory; do NOT swap a working `readline`
+ * loop to it expecting a speedup on parse-heavy JSONL.
+ *
+ * The scan advantage only shows when you _don't_ fully parse every row. Filtering on the raw text and parsing only what
+ * survives is the shape that wins — parsing 20% of rows measured ~2.5× faster than parsing all of them:
+ *
+ * ```ts
+ * TextSpliterator.fromAsync(path, { delimiter: "\n" })
+ * 	.filter((line) => line.includes('"category":"Novelty"'))
+ * 	.map((line) => JSON.parse(line))
+ * ```
+ *
+ * For segmentation or counting, use {@link Spliterator} (raw byte ranges) or {@link TextSpliterator}. When unsure,
+ * benchmark.
+ */
+export class JSONSpliterator {
+    constructor() {
+        throw new TypeError("Static class cannot be instantiated. Did you mean `JSONSpliterator.from`?");
+    }
+    static *from(source, options = {}) {
+        const decoder = new TextDecoder();
+        let rowCursor = 0;
+        const spliterator = Spliterator.fromSync(source, options);
+        for (const row of spliterator) {
+            let parsed;
+            try {
+                const content = decoder.decode(row);
+                parsed = JSON.parse(content);
+            }
+            catch (parsedError) {
+                const error = new SyntaxError(`Failed to parse JSON at row ${rowCursor}`);
+                error.cause = parsedError;
+                throw error;
+            }
+            yield parsed;
+            rowCursor++;
+        }
+    }
+    /**
+     * Given a byte array or string, yield each row as an array of columns.
+     *
+     * @yields Each row as an array of columns.
+     */
+    static fromAsync(source, options = {}) {
+        const decoder = new TextDecoder();
+        // Parsing is an op on the sequence, not a generator wrapped inside one. An allocating row body makes the extra
+        // async frame a wrapping generator adds disproportionately expensive: 1460ms against 1278ms over 500k rows, where
+        // the same layer costs a third as much when the body only decodes.
+        return AsyncSequence.from(() => openDelimitedRows(source, options)).map((row, rowCursor) => {
+            try {
+                return JSON.parse(decoder.decode(row));
+            }
+            catch (parsedError) {
+                const error = new SyntaxError(`Failed to parse JSON at row ${rowCursor}`);
+                error.cause = parsedError;
+                throw error;
+            }
+        });
+    }
+}
+//# sourceMappingURL=JSONSpliterator.js.map

package/out/lib/formats/JSONSpliterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONSpliterator.js","sourceRoot":"","sources":["../../../lib/formats/JSONSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAA6B,WAAW,EAAwB,MAAM,wBAAwB,CAAA;AAErG,OAAO,EAA2B,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,eAAe;IACpC;QACC,MAAM,IAAI,SAAS,CAAC,2EAA2E,CAAC,CAAA;IACjG,CAAC;IAED,MAAM,CAAC,CAAC,IAAI,CAAc,MAA8B,EAAE,OAAO,GAAoB,EAAE;QACtF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QACjC,IAAI,SAAS,GAAG,CAAC,CAAA;QAEjB,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAEzD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,MAAS,CAAA;YAEb,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAEnC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAA;YAClC,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAA;gBACzE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAA;gBAEzB,MAAM,KAAK,CAAA;YACZ,CAAC;YAED,MAAM,MAAM,CAAA;YAEZ,SAAS,EAAE,CAAA;QACZ,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAc,MAAyB,EAAE,OAAO,GAAuB,EAAE;QACxF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;QAEjC,+GAA+G;QAC/G,kHAAkH;QAClH,mEAAmE;QACnE,OAAO,aAAa,CAAC,IAAI,CAAa,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;YACtG,IAAI,CAAC;gBACJ,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAM,CAAA;YAC5C,CAAC;YAAC,OAAO,WAAW,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAA;gBACzE,KAAK,CAAC,KAAK,GAAG,WAAW,CAAA;gBAEzB,MAAM,KAAK,CAAA;YACZ,CAAC;QACF,CAAC,CAAC,CAAA;IACH,CAAC;CACD"}

package/out/lib/formats/PSVSpliterator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { CSVSpliterator } from "./CSVSpliterator.js";
+/**
+ * A static class spliterator for pipe-separated values.
+ *
+ * @see {@linkcode PSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode PSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export declare abstract class PSVSpliterator extends CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Pipe
+     */
+    static ColumnDelimiter: number;
+}
+//# sourceMappingURL=PSVSpliterator.d.ts.map

package/out/lib/formats/PSVSpliterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PSVSpliterator.d.ts","sourceRoot":"","sources":["../../../lib/formats/PSVSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,8BAAsB,cAAe,SAAQ,cAAc;IAC1D;;;;OAIG;IACH,OAAuB,eAAe,EAAE,MAAM,CAAkB;CAChE"}

package/out/lib/formats/PSVSpliterator.js

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { Delimiters } from "../core/CharacterSequence.js";
+import { CSVSpliterator } from "./CSVSpliterator.js";
+/**
+ * A static class spliterator for pipe-separated values.
+ *
+ * @see {@linkcode PSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode PSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export class PSVSpliterator extends CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Pipe
+     */
+    static ColumnDelimiter = Delimiters.Pipe;
+}
+//# sourceMappingURL=PSVSpliterator.js.map

package/out/lib/formats/PSVSpliterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PSVSpliterator.js","sourceRoot":"","sources":["../../../lib/formats/PSVSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,OAAgB,cAAe,SAAQ,cAAc;IAC1D;;;;OAIG;IACI,MAAM,CAAU,eAAe,GAAW,UAAU,CAAC,IAAI,CAAA;CAChE"}

package/out/lib/formats/TSVSpliterator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { CSVSpliterator } from "./CSVSpliterator.js";
+/**
+ * A static class spliterator for tab-separated values.
+ *
+ * @see {@linkcode TSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode TSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export declare abstract class TSVSpliterator extends CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Tab
+     */
+    static ColumnDelimiter: number;
+}
+//# sourceMappingURL=TSVSpliterator.d.ts.map

package/out/lib/formats/TSVSpliterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TSVSpliterator.d.ts","sourceRoot":"","sources":["../../../lib/formats/TSVSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,8BAAsB,cAAe,SAAQ,cAAc;IAC1D;;;;OAIG;IACH,OAAuB,eAAe,EAAE,MAAM,CAAiB;CAC/D"}

package/out/lib/formats/TSVSpliterator.js

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import { Delimiters } from "../core/CharacterSequence.js";
+import { CSVSpliterator } from "./CSVSpliterator.js";
+/**
+ * A static class spliterator for tab-separated values.
+ *
+ * @see {@linkcode TSVSpliterator.from} for synchronous usage.
+ * @see {@linkcode TSVSpliterator.fromAsync} for asynchronous usage.
+ */
+export class TSVSpliterator extends CSVSpliterator {
+    /**
+     * The column delimiter used by the spliterator.
+     *
+     * @default Delimiters.Tab
+     */
+    static ColumnDelimiter = Delimiters.Tab;
+}
+//# sourceMappingURL=TSVSpliterator.js.map

package/out/lib/formats/TSVSpliterator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TSVSpliterator.js","sourceRoot":"","sources":["../../../lib/formats/TSVSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,OAAgB,cAAe,SAAQ,cAAc;IAC1D;;;;OAIG;IACI,MAAM,CAAU,eAAe,GAAW,UAAU,CAAC,GAAG,CAAA;CAC/D"}

package/out/lib/formats/TextSpliterator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @copyright Sister Software
+ * @license MIT
+ * @author Teffen Ellis, et al.
+ */
+import type { CharacterSequenceInput } from "../core/CharacterSequence.js";
+import { type SpliteratorInit } from "../core/Spliterator.js";
+import type { AsyncDataResource } from "../internal/shared.js";
+import { type AdaptiveSourceInit } from "../io/adaptive-source.js";
+import { AsyncSequence } from "../iterators/AsyncSequence.js";
+export interface TextSpliteratorInit {
+    /**
+     * The encoding to use when decoding the data.
+     *
+     * @default "utf-8"
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/TextDecoder/TextDecoder
+     */
+    encoding?: string;
+    /**
+     * Whether to throw an error when encountering invalid data, or to swap it with a replacement character.
+     */
+    fatal?: boolean;
+    /**
+     * Whether to ignore BOM characters.
+     */
+    ignoreBOM?: boolean;
+}
+export declare abstract class TextSpliterator {
+    constructor();
+    /**
+     * Synchronously yield delimited text from a byte array or string.
+     *
+     * @param source The source content to split.
+     * @param options The options to use when splitting the content.
+     *
+     * @yields Each slice of the source content.
+     * @see {@linkcode TextSpliterator.fromAsync} for asynchronous iteration with decoding.
+     * @see {@linkcode Spliterator.fromSync} for synchronous iteration without decoding.
+     */
+    static from(source: CharacterSequenceInput, { encoding, fatal, ignoreBOM, ...options }?: TextSpliteratorInit & SpliteratorInit): Generator<string>;
+    /**
+     * Asynchronously yield delimited text from a byte array or string.
+     *
+     * @param source The async data resource to split.
+     * @param options The options to use when splitting the content.
+     *
+     * @yields Each slice of the source content.
+     * @see {@linkcode TextSpliterator.from} for synchronous iteration with decoding.
+     * @see {@linkcode Spliterator.fromAsync} for asynchronous iteration without decoding.
+     */
+    static fromAsync(source: AsyncDataResource, { encoding, fatal, ignoreBOM, ...options }?: TextSpliteratorInit & AdaptiveSourceInit): AsyncSequence<string>;
+}
+//# sourceMappingURL=TextSpliterator.d.ts.map

package/out/lib/formats/TextSpliterator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSpliterator.d.ts","sourceRoot":"","sources":["../../../lib/formats/TextSpliterator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACrG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,KAAK,kBAAkB,EAAqB,MAAM,0BAA0B,CAAA;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,8BAAsB,eAAe;IACpC,cAEC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAE,IAAI,CACX,MAAM,EAAE,sBAAsB,EAC9B,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAE,mBAAmB,GAAG,eAAoB,GACpF,SAAS,CAAC,MAAM,CAAC,CAsBnB;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,CACf,MAAM,EAAE,iBAAiB,EACzB,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAE,mBAAmB,GAAG,kBAAuB,GACvF,aAAa,CAAC,MAAM,CAAC,CAevB;CACD"}