@ac-kit/core 0.1.0

package/dist/buffer/stream/byte-accumulator.d.ts

@@ -0,0 +1,65 @@
+export type ByteAccumulatorOptions = {
+    /** Initial arena capacity; will grow as needed. */
+    initialCapacity?: number;
+};
+/**
+ * Growable byte arena with a read cursor — an incremental receive buffer for
+ * any producer/consumer pair where bytes arrive in arbitrary-sized chunks but
+ * must be consumed as a contiguous, possibly-partial window (a network receive
+ * path, a decompression sink, any stream reassembly).
+ *
+ * Incoming chunks are copied once into a contiguous arena; consumed bytes only
+ * advance a read offset. Total copy cost is therefore linear in the number of
+ * bytes received, rather than the quadratic cost of concatenating the pending
+ * buffer with every arriving chunk.
+ *
+ * ## View lifetime
+ *
+ * {@link view} returns a window into the arena, not a copy. It is valid **only
+ * until the next {@link append} or {@link consume}** — compaction and growth
+ * both relocate live bytes. A consumer that retains any part of a view must
+ * copy it first.
+ */
+export declare class ByteAccumulator {
+    private readonly maxSize;
+    private buffer;
+    private readPos;
+    private writePos;
+    /**
+     * Construct a new accumulator with a maximum retained byte count. The arena
+     * will grow as needed, but {@link append} will throw if the retained byte
+     * count would exceed `maxSize`.
+     *
+     * @param maxSize - Maximum retained byte count; must be greater than zero.
+     * @param options - See {@link ByteAccumulatorOptions}.
+     */
+    constructor(maxSize: number, options?: ByteAccumulatorOptions);
+    /** Number of unconsumed bytes currently held. */
+    get buffered(): number;
+    /** Current arena capacity, for diagnostics and tests. */
+    get capacity(): number;
+    /**
+     * Copy `chunk` into the arena, growing or compacting as needed.
+     *
+     * @throws {BufferOverflowError} If the retained byte count would exceed the
+     *   configured ceiling.
+     */
+    append(chunk: Uint8Array): void;
+    /**
+     * Window over the unconsumed bytes. Invalidated by the next {@link append} or
+     * {@link consume}; copy before retaining.
+     */
+    view(): Uint8Array<ArrayBuffer>;
+    /** Drop `count` bytes from the front. */
+    consume(count: number): void;
+    /**
+     * Copy out the unconsumed bytes and reset. Used to hand residue to another
+     * consumer across a protocol/format switch.
+     */
+    take(): Uint8Array<ArrayBuffer>;
+    /** Discard everything held. */
+    clear(): void;
+    private compact;
+    private grow;
+}
+//# sourceMappingURL=byte-accumulator.d.ts.map

package/dist/buffer/stream/byte-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-accumulator.d.ts","sourceRoot":"","sources":["../../../src/buffer/stream/byte-accumulator.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,sBAAsB,GAAG;IACpC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAc1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbzB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAK;IAErB;;;;;;;OAOG;IACH,YACkB,OAAO,EAAE,MAAM,EAChC,OAAO,CAAC,EAAE,sBAAsB,EAUhC;IAED,iDAAiD;IACjD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,yDAAyD;IACzD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAuB9B;IAED;;;OAGG;IACH,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,CAE9B;IAED,yCAAyC;IACzC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAU3B;IAED;;;OAGG;IACH,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,CAK9B;IAED,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAGZ;IAED,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,IAAI;CAcZ"}

package/dist/buffer/stream/byte-accumulator.js

@@ -0,0 +1,130 @@
+import { BufferOverflowError } from "../../error/buffer-overflow-error.js";
+const DEFAULT_INITIAL_CAPACITY_ = 8192;
+/**
+ * Growable byte arena with a read cursor — an incremental receive buffer for
+ * any producer/consumer pair where bytes arrive in arbitrary-sized chunks but
+ * must be consumed as a contiguous, possibly-partial window (a network receive
+ * path, a decompression sink, any stream reassembly).
+ *
+ * Incoming chunks are copied once into a contiguous arena; consumed bytes only
+ * advance a read offset. Total copy cost is therefore linear in the number of
+ * bytes received, rather than the quadratic cost of concatenating the pending
+ * buffer with every arriving chunk.
+ *
+ * ## View lifetime
+ *
+ * {@link view} returns a window into the arena, not a copy. It is valid **only
+ * until the next {@link append} or {@link consume}** — compaction and growth
+ * both relocate live bytes. A consumer that retains any part of a view must
+ * copy it first.
+ */
+export class ByteAccumulator {
+    maxSize;
+    buffer;
+    readPos = 0;
+    writePos = 0;
+    /**
+     * Construct a new accumulator with a maximum retained byte count. The arena
+     * will grow as needed, but {@link append} will throw if the retained byte
+     * count would exceed `maxSize`.
+     *
+     * @param maxSize - Maximum retained byte count; must be greater than zero.
+     * @param options - See {@link ByteAccumulatorOptions}.
+     */
+    constructor(maxSize, options) {
+        this.maxSize = maxSize;
+        if (maxSize <= 0) {
+            throw new RangeError("maxSize must be greater than zero");
+        }
+        const initial = Math.min(options?.initialCapacity ?? DEFAULT_INITIAL_CAPACITY_, maxSize);
+        this.buffer = new Uint8Array(initial);
+    }
+    /** Number of unconsumed bytes currently held. */
+    get buffered() {
+        return this.writePos - this.readPos;
+    }
+    /** Current arena capacity, for diagnostics and tests. */
+    get capacity() {
+        return this.buffer.length;
+    }
+    /**
+     * Copy `chunk` into the arena, growing or compacting as needed.
+     *
+     * @throws {BufferOverflowError} If the retained byte count would exceed the
+     *   configured ceiling.
+     */
+    append(chunk) {
+        if (chunk.length === 0) {
+            return;
+        }
+        const live = this.buffered;
+        const needed = live + chunk.length;
+        if (needed > this.maxSize) {
+            throw new BufferOverflowError(`Buffer limit exceeded: ${needed} > ${this.maxSize} bytes`);
+        }
+        if (this.writePos + chunk.length > this.buffer.length) {
+            if (needed <= this.buffer.length) {
+                this.compact();
+            }
+            else {
+                this.grow(needed);
+            }
+        }
+        this.buffer.set(chunk, this.writePos);
+        this.writePos += chunk.length;
+    }
+    /**
+     * Window over the unconsumed bytes. Invalidated by the next {@link append} or
+     * {@link consume}; copy before retaining.
+     */
+    view() {
+        return this.buffer.subarray(this.readPos, this.writePos);
+    }
+    /** Drop `count` bytes from the front. */
+    consume(count) {
+        if (count <= 0) {
+            return;
+        }
+        this.readPos += count > this.buffered ? this.buffered : count;
+        // Fully drained is the steady state: resetting here avoids ever copying.
+        if (this.readPos === this.writePos) {
+            this.readPos = 0;
+            this.writePos = 0;
+        }
+    }
+    /**
+     * Copy out the unconsumed bytes and reset. Used to hand residue to another
+     * consumer across a protocol/format switch.
+     */
+    take() {
+        const out = this.buffer.slice(this.readPos, this.writePos);
+        this.readPos = 0;
+        this.writePos = 0;
+        return out;
+    }
+    /** Discard everything held. */
+    clear() {
+        this.readPos = 0;
+        this.writePos = 0;
+    }
+    compact() {
+        this.buffer.copyWithin(0, this.readPos, this.writePos);
+        this.writePos -= this.readPos;
+        this.readPos = 0;
+    }
+    grow(needed) {
+        let capacity = this.buffer.length;
+        while (capacity < needed) {
+            capacity *= 2;
+        }
+        if (capacity > this.maxSize) {
+            capacity = this.maxSize;
+        }
+        const next = new Uint8Array(capacity);
+        next.set(this.buffer.subarray(this.readPos, this.writePos));
+        this.buffer = next;
+        this.writePos -= this.readPos;
+        this.readPos = 0;
+    }
+}
+//# sourceMappingURL=byte-accumulator.js.map

package/dist/buffer/stream/byte-accumulator.js.map

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

package/dist/buffer/stream/byte-builder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Accumulates byte chunks and concatenates them into one `Uint8Array` on demand
+ * — an incremental writer for any binary format built up byte-by-byte or
+ * chunk-by-chunk (PEM framing, SSH wire messages, PGP packets, ASN.1 codecs,
+ * …).
+ *
+ * Every `write`/`writeByte` call is O(1) (a chunk is only ever appended, never
+ * copied or re-allocated); the cost of concatenation is paid exactly once, in
+ * `toBytes()`.
+ */
+export declare class ByteBuilder {
+    private readonly chunks;
+    private byteLength_;
+    /** Total bytes written so far. */
+    get byteLength(): number;
+    /** Appends a single byte, taken mod 256. */
+    writeByte(byte: number): void;
+    /** Appends `bytes` verbatim. A zero-length input is a no-op. */
+    write(bytes: Uint8Array): void;
+    /** Concatenates every chunk written so far into one `Uint8Array`. */
+    toBytes(): Uint8Array;
+}
+//# sourceMappingURL=byte-builder.d.ts.map

package/dist/buffer/stream/byte-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-builder.d.ts","sourceRoot":"","sources":["../../../src/buffer/stream/byte-builder.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,WAAW,CAAK;IAExB,kCAAkC;IAClC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,4CAA4C;IAC5C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5B;IAED,gEAAgE;IAChE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAO7B;IAED,qEAAqE;IACrE,OAAO,IAAI,UAAU,CAMpB;CACD"}

package/dist/buffer/stream/byte-builder.js

@@ -0,0 +1,40 @@
+import { concatBytes } from "../concat-bytes.js";
+/**
+ * Accumulates byte chunks and concatenates them into one `Uint8Array` on demand
+ * — an incremental writer for any binary format built up byte-by-byte or
+ * chunk-by-chunk (PEM framing, SSH wire messages, PGP packets, ASN.1 codecs,
+ * …).
+ *
+ * Every `write`/`writeByte` call is O(1) (a chunk is only ever appended, never
+ * copied or re-allocated); the cost of concatenation is paid exactly once, in
+ * `toBytes()`.
+ */
+export class ByteBuilder {
+    chunks = [];
+    byteLength_ = 0;
+    /** Total bytes written so far. */
+    get byteLength() {
+        return this.byteLength_;
+    }
+    /** Appends a single byte, taken mod 256. */
+    writeByte(byte) {
+        this.chunks.push(Uint8Array.of(byte & 0xff));
+        this.byteLength_ += 1;
+    }
+    /** Appends `bytes` verbatim. A zero-length input is a no-op. */
+    write(bytes) {
+        if (bytes.length === 0) {
+            return;
+        }
+        this.chunks.push(bytes);
+        this.byteLength_ += bytes.length;
+    }
+    /** Concatenates every chunk written so far into one `Uint8Array`. */
+    toBytes() {
+        if (this.chunks.length === 1) {
+            return this.chunks[0];
+        }
+        return concatBytes(this.chunks);
+    }
+}
+//# sourceMappingURL=byte-builder.js.map

package/dist/buffer/stream/byte-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-builder.js","sourceRoot":"","sources":["../../../src/buffer/stream/byte-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,OAAO,WAAW;IACN,MAAM,GAAiB,EAAE,CAAC;IACnC,WAAW,GAAG,CAAC,CAAC;IAExB,kCAAkC;IAClC,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,SAAS,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,KAAiB;QACtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,qEAAqE;IACrE,OAAO;QACN,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;QACxB,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;CACD"}

package/dist/buffer/stream/byte-reader.d.ts

@@ -0,0 +1,68 @@
+/**
+ * A cursor over an existing `Uint8Array` — a sequential reader for any binary
+ * format consumed byte-by-byte or field-by-field (PEM framing, SSH wire
+ * messages, PGP packets, ASN.1 codecs, …).
+ *
+ * Every read advances `position`. Nothing is copied except when a caller
+ * explicitly asks for one: `read` returns a view via `subarray`, not a copy — a
+ * caller that needs an owned copy should call `.slice()` on the result itself.
+ */
+export declare class ByteReader {
+    private readonly bytes;
+    private position_;
+    /**
+     * @param bytes The bytes to read from. Not copied — mutating `bytes` after
+     *   construction is visible to this reader.
+     * @param initialPosition Where to start reading from. Defaults to 0.
+     * @throws {RangeError} When `initialPosition` is out of `bytes`' range.
+     */
+    constructor(bytes: Uint8Array, initialPosition?: number);
+    /**
+     * The current read position, in bytes from the start of the underlying
+     * buffer.
+     */
+    get position(): number;
+    /** How many bytes remain unread. */
+    get remaining(): number;
+    /** The total length of the underlying buffer, regardless of position. */
+    get byteLength(): number;
+    /** Whether every byte has been read. */
+    get atEnd(): boolean;
+    /**
+     * Reads and returns the next byte, advancing `position` by one.
+     *
+     * @throws {RangeError} When no bytes remain.
+     */
+    readByte(): number;
+    /**
+     * Returns the next byte without advancing `position`.
+     *
+     * @throws {RangeError} When no bytes remain.
+     */
+    peekByte(): number;
+    /**
+     * Reads and returns the next `count` bytes as a view (not a copy) into the
+     * underlying buffer, advancing `position` by `count`.
+     *
+     * @throws {RangeError} When fewer than `count` bytes remain.
+     */
+    read(count: number): Uint8Array;
+    /**
+     * Reads the next `count` bytes into a fresh, independent `ByteReader`
+     * positioned at its own start — for a nested, self-contained sub-structure
+     * (an ASN.1 TLV's contents, an SSH/PGP sub-packet) that should be read
+     * without risking overrunning into what follows it.
+     *
+     * @throws {RangeError} When fewer than `count` bytes remain.
+     */
+    readSubReader(count: number): ByteReader;
+    /** Returns every remaining byte as a view, without advancing `position`. */
+    peekRemaining(): Uint8Array;
+    /**
+     * Moves `position` to an absolute offset.
+     *
+     * @throws {RangeError} When `position` is out of range.
+     */
+    seek(position: number): void;
+}
+//# sourceMappingURL=byte-reader.d.ts.map

package/dist/buffer/stream/byte-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-reader.d.ts","sourceRoot":"","sources":["../../../src/buffer/stream/byte-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,UAAU;IAUrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IATvB,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;IACH,YACkB,KAAK,EAAE,UAAU,EAClC,eAAe,SAAI,EASnB;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,yEAAyE;IACzE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,wCAAwC;IACxC,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CASjB;IAED;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAMjB;IAED;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAW9B;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAEvC;IAED,4EAA4E;IAC5E,aAAa,IAAI,UAAU,CAE1B;IAED;;;;OAIG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ3B;CACD"}

package/dist/buffer/stream/byte-reader.js

@@ -0,0 +1,110 @@
+/**
+ * A cursor over an existing `Uint8Array` — a sequential reader for any binary
+ * format consumed byte-by-byte or field-by-field (PEM framing, SSH wire
+ * messages, PGP packets, ASN.1 codecs, …).
+ *
+ * Every read advances `position`. Nothing is copied except when a caller
+ * explicitly asks for one: `read` returns a view via `subarray`, not a copy — a
+ * caller that needs an owned copy should call `.slice()` on the result itself.
+ */
+export class ByteReader {
+    bytes;
+    position_;
+    /**
+     * @param bytes The bytes to read from. Not copied — mutating `bytes` after
+     *   construction is visible to this reader.
+     * @param initialPosition Where to start reading from. Defaults to 0.
+     * @throws {RangeError} When `initialPosition` is out of `bytes`' range.
+     */
+    constructor(bytes, initialPosition = 0) {
+        this.bytes = bytes;
+        if (initialPosition < 0 || initialPosition > bytes.length) {
+            throw new RangeError(`ByteReader: initialPosition ${initialPosition} out of range for ${bytes.length} bytes`);
+        }
+        this.position_ = initialPosition;
+    }
+    /**
+     * The current read position, in bytes from the start of the underlying
+     * buffer.
+     */
+    get position() {
+        return this.position_;
+    }
+    /** How many bytes remain unread. */
+    get remaining() {
+        return this.bytes.length - this.position_;
+    }
+    /** The total length of the underlying buffer, regardless of position. */
+    get byteLength() {
+        return this.bytes.length;
+    }
+    /** Whether every byte has been read. */
+    get atEnd() {
+        return this.position_ >= this.bytes.length;
+    }
+    /**
+     * Reads and returns the next byte, advancing `position` by one.
+     *
+     * @throws {RangeError} When no bytes remain.
+     */
+    readByte() {
+        if (this.atEnd) {
+            throw new RangeError("ByteReader.readByte: no bytes remaining");
+        }
+        const byte = this.bytes[this.position_];
+        this.position_ += 1;
+        return byte;
+    }
+    /**
+     * Returns the next byte without advancing `position`.
+     *
+     * @throws {RangeError} When no bytes remain.
+     */
+    peekByte() {
+        if (this.atEnd) {
+            throw new RangeError("ByteReader.peekByte: no bytes remaining");
+        }
+        return this.bytes[this.position_];
+    }
+    /**
+     * Reads and returns the next `count` bytes as a view (not a copy) into the
+     * underlying buffer, advancing `position` by `count`.
+     *
+     * @throws {RangeError} When fewer than `count` bytes remain.
+     */
+    read(count) {
+        if (count > this.remaining) {
+            throw new RangeError(`ByteReader.read: requested ${count} bytes, only ${this.remaining} remain`);
+        }
+        const view = this.bytes.subarray(this.position_, this.position_ + count);
+        this.position_ += count;
+        return view;
+    }
+    /**
+     * Reads the next `count` bytes into a fresh, independent `ByteReader`
+     * positioned at its own start — for a nested, self-contained sub-structure
+     * (an ASN.1 TLV's contents, an SSH/PGP sub-packet) that should be read
+     * without risking overrunning into what follows it.
+     *
+     * @throws {RangeError} When fewer than `count` bytes remain.
+     */
+    readSubReader(count) {
+        return new ByteReader(this.read(count));
+    }
+    /** Returns every remaining byte as a view, without advancing `position`. */
+    peekRemaining() {
+        return this.bytes.subarray(this.position_);
+    }
+    /**
+     * Moves `position` to an absolute offset.
+     *
+     * @throws {RangeError} When `position` is out of range.
+     */
+    seek(position) {
+        if (position < 0 || position > this.bytes.length) {
+            throw new RangeError(`ByteReader.seek: position ${position} out of range for ${this.bytes.length} bytes`);
+        }
+        this.position_ = position;
+    }
+}
+//# sourceMappingURL=byte-reader.js.map

package/dist/buffer/stream/byte-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-reader.js","sourceRoot":"","sources":["../../../src/buffer/stream/byte-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,UAAU;IAUJ,KAAK;IATf,SAAS,CAAS;IAE1B;;;;;OAKG;IACH,YACkB,KAAiB,EAClC,eAAe,GAAG,CAAC;qBADF,KAAK;QAGtB,IAAI,eAAe,GAAG,CAAC,IAAI,eAAe,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3D,MAAM,IAAI,UAAU,CACnB,+BAA+B,eAAe,qBAAqB,KAAK,CAAC,MAAM,QAAQ,CACvF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,oCAAoC;IACpC,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;IAC3C,CAAC;IAED,yEAAyE;IACzE,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACP,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAE,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;QAEpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACP,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,yCAAyC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAE,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,KAAa;QACjB,IAAI,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CACnB,8BAA8B,KAAK,gBAAgB,IAAI,CAAC,SAAS,SAAS,CAC1E,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;QACzE,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QAExB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,KAAa;QAC1B,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,4EAA4E;IAC5E,aAAa;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,QAAgB;QACpB,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClD,MAAM,IAAI,UAAU,CACnB,6BAA6B,QAAQ,qBAAqB,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CACnF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACD"}

package/dist/buffer/text/decode-text.d.ts

@@ -0,0 +1,46 @@
+import type { TextEncodingName } from "./text-encoding-name.js";
+/**
+ * Options mirroring `TextDecoderOptions` (see `TextDecoder`).
+ *
+ * Only `"utf-8"` and `"utf-16be"` honor both options — they are the only two
+ * encodings here backed by a real `TextDecoder` instance, and per the WHATWG
+ * Encoding Standard, BOM handling and the fatal/replacement error modes are
+ * likewise only defined for UTF-8 and UTF-16BE/LE.
+ *
+ * `"latin1"`/`"ascii"` ignore both options: they are deliberately _not_ the
+ * WHATWG-spec `"latin1"`/`"ascii"` labels, which the standard defines as
+ * aliases for windows-1252 (remapping bytes 0x80-0x9F to printable characters)
+ * — these decode every byte 1:1 to its own code point instead, matching true
+ * ISO-8859-1/ASCII. Neither option has a meaning for that mapping: every byte
+ * is valid, and there is no byte order mark for a single-byte encoding.
+ *
+ * `"utf-32be"` ignores `ignoreBOM` (no byte order mark exists for a
+ * 4-byte-per-code-point scheme) but honors `fatal`, since a 4-byte group can
+ * still decode to a surrogate or an out-of-range value.
+ */
+export type DecodeTextOptions = {
+    /**
+     * When `true`, throw a `TypeError` on invalid input instead of substituting
+     * U+FFFD. Defaults to `false`, matching `TextDecoder`.
+     */
+    fatal?: boolean;
+    /**
+     * When `false` (the default), a leading byte order mark is consumed and
+     * dropped rather than decoded as U+FEFF. Defaults to `false`, matching
+     * `TextDecoder`.
+     */
+    ignoreBOM?: boolean;
+};
+/**
+ * Decode bytes as text. Copies, so the result does not alias the input.
+ *
+ * @param bytes - Source bytes.
+ * @param encoding - Text encoding.
+ * @param options - See {@link DecodeTextOptions}.
+ * @returns The decoded string.
+ * @throws {TypeError} When `options.fatal` is `true` and `bytes` is not valid
+ *   for `encoding`. Never thrown for `"latin1"`/`"ascii"`, for which every byte
+ *   is valid.
+ */
+export declare function decodeText(bytes: Uint8Array, encoding: TextEncodingName, options?: DecodeTextOptions): string;
+//# sourceMappingURL=decode-text.d.ts.map

package/dist/buffer/text/decode-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-text.d.ts","sourceRoot":"","sources":["../../../src/buffer/text/decode-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAyBF;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GACzB,MAAM,CAwDR"}

package/dist/buffer/text/decode-text.js

@@ -0,0 +1,65 @@
+const utf8Decoders = new Map();
+const utf16BeDecoders = new Map();
+// `TextDecoder` construction is not free; a decoder only depends on
+// (label, fatal, ignoreBOM), so one instance per combination is reused across
+// every call instead of rebuilding it per call.
+function getCachedDecoder(cache, label, fatal, ignoreBOM) {
+    const key = `${fatal}:${ignoreBOM}`;
+    let decoder = cache.get(key);
+    if (!decoder) {
+        decoder = new TextDecoder(label, { fatal, ignoreBOM });
+        cache.set(key, decoder);
+    }
+    return decoder;
+}
+/**
+ * Decode bytes as text. Copies, so the result does not alias the input.
+ *
+ * @param bytes - Source bytes.
+ * @param encoding - Text encoding.
+ * @param options - See {@link DecodeTextOptions}.
+ * @returns The decoded string.
+ * @throws {TypeError} When `options.fatal` is `true` and `bytes` is not valid
+ *   for `encoding`. Never thrown for `"latin1"`/`"ascii"`, for which every byte
+ *   is valid.
+ */
+export function decodeText(bytes, encoding, options) {
+    const fatal = options?.fatal ?? false;
+    const ignoreBOM = options?.ignoreBOM ?? false;
+    if (encoding === "utf-8") {
+        return getCachedDecoder(utf8Decoders, "utf-8", fatal, ignoreBOM).decode(bytes);
+    }
+    if (encoding === "utf-16be") {
+        return getCachedDecoder(utf16BeDecoders, "utf-16be", fatal, ignoreBOM).decode(bytes);
+    }
+    if (encoding === "utf-32be") {
+        let out = "";
+        for (let index = 0; index + 3 < bytes.length; index += 4) {
+            const codePoint = ((bytes[index] << 24) |
+                (bytes[index + 1] << 16) |
+                (bytes[index + 2] << 8) |
+                bytes[index + 3]) >>>
+                0;
+            if (codePoint > 0x10ffff ||
+                (codePoint >= 0xd800 && codePoint <= 0xdfff)) {
+                if (fatal) {
+                    throw new TypeError(`decodeText: invalid utf-32be code point 0x${codePoint.toString(16)}`);
+                }
+                out += "\ufffd";
+                continue;
+            }
+            out += String.fromCodePoint(codePoint);
+        }
+        return out;
+    }
+    // latin1 and ascii are both one byte per code unit; ascii additionally masks
+    // the high bit, matching Node's Buffer behaviour — deliberately not the
+    // WHATWG "latin1"/"ascii" labels (windows-1252); see this function's doc.
+    const mask = encoding === "ascii" ? 0x7f : 0xff;
+    let out = "";
+    for (let index = 0; index < bytes.length; index++) {
+        out += String.fromCharCode(bytes[index] & mask);
+    }
+    return out;
+}
+//# sourceMappingURL=decode-text.js.map

package/dist/buffer/text/decode-text.js.map

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

package/dist/buffer/text/encode-text.d.ts

@@ -0,0 +1,15 @@
+import type { TextEncodingName } from "./text-encoding-name.js";
+/**
+ * Encode text as bytes.
+ *
+ * @param text - Source string.
+ * @param encoding - Text encoding.
+ * @returns The encoded bytes.
+ */
+export declare function encodeText(text: string, encoding: TextEncodingName): Uint8Array<ArrayBuffer>;
+export declare function encodeTextUtf8(text: string): Uint8Array<ArrayBuffer>;
+export declare function encodeTextAscii(text: string): Uint8Array<ArrayBuffer>;
+export declare function encodeTextLatin1(text: string): Uint8Array<ArrayBuffer>;
+export declare function encodeTextUtf16Be(text: string): Uint8Array<ArrayBuffer>;
+export declare function encodeTextUtf32Be(text: string): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=encode-text.d.ts.map

package/dist/buffer/text/encode-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-text.d.ts","sourceRoot":"","sources":["../../../src/buffer/text/encode-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GACxB,UAAU,CAAC,WAAW,CAAC,CAazB;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAEpE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAMrE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAMtE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAQvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAWvE"}