@ac-kit/format-osc 0.0.0-stage → 0.1.0

package/dist/framing/osc-size-prefixed-encoder.js

@@ -0,0 +1,20 @@
+import { OscWriter_ } from "../packet/_osc-writer.js";
+import { writeOscPacket_ } from "../packet/_write-osc-packet.js";
+/**
+ * Creates the write half of OSC 1.0's stream framing: each packet preceded by
+ * its size as a big-endian int32, in one buffer.
+ *
+ * @throws {RangeError} From `encode`, as {@link encodeOscPacket}.
+ */
+export function createOscSizePrefixedEncoder() {
+    return {
+        encode(packet) {
+            const writer = new OscWriter_();
+            const sizeOffset = writer.allocate(4);
+            writeOscPacket_(writer, packet);
+            writer.patchUint32(sizeOffset, writer.length - 4);
+            return writer.finish();
+        },
+    };
+}
+//# sourceMappingURL=osc-size-prefixed-encoder.js.map

package/dist/framing/osc-size-prefixed-encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osc-size-prefixed-encoder.js","sourceRoot":"","sources":["../../src/framing/osc-size-prefixed-encoder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC3C,OAAO;QACN,MAAM,CAAC,MAAiB;YACvB,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAChC,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAElD,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./errors.js";
+export * from "./framing/osc-datagram-codec.js";
+export * from "./framing/osc-datagram-decoder.js";
+export * from "./framing/osc-datagram-encoder.js";
+export * from "./framing/osc-size-prefixed-codec.js";
+export * from "./framing/osc-size-prefixed-decoder.js";
+export * from "./framing/osc-size-prefixed-encoder.js";
+export * from "./packet/decode-osc-packet.js";
+export * from "./packet/encode-osc-packet.js";
+export * from "./packet/osc-packet.js";
+export * from "./time-tag/osc-time-tag-from-date.js";
+export * from "./time-tag/osc-time-tag-to-date.js";
+export * from "./time-tag/osc-time-tag.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from "./errors.js";
+export * from "./framing/osc-datagram-codec.js";
+export * from "./framing/osc-datagram-decoder.js";
+export * from "./framing/osc-datagram-encoder.js";
+export * from "./framing/osc-size-prefixed-codec.js";
+export * from "./framing/osc-size-prefixed-decoder.js";
+export * from "./framing/osc-size-prefixed-encoder.js";
+export * from "./packet/decode-osc-packet.js";
+export * from "./packet/encode-osc-packet.js";
+export * from "./packet/osc-packet.js";
+export * from "./time-tag/osc-time-tag-from-date.js";
+export * from "./time-tag/osc-time-tag-to-date.js";
+export * from "./time-tag/osc-time-tag.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC"}

package/dist/packet/_bundle-marker.d.ts

@@ -0,0 +1,3 @@
+/** `#bundle` and its NUL terminator: the first 8 bytes of every OSC bundle. */
+export declare const BUNDLE_MARKER_: Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=_bundle-marker.d.ts.map

package/dist/packet/_bundle-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bundle-marker.d.ts","sourceRoot":"","sources":["../../src/packet/_bundle-marker.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,cAAc,yBAS1B,CAAC"}

package/dist/packet/_bundle-marker.js

@@ -0,0 +1,3 @@
+/** `#bundle` and its NUL terminator: the first 8 bytes of every OSC bundle. */
+export const BUNDLE_MARKER_ = Uint8Array.of(0x23, 0x62, 0x75, 0x6e, 0x64, 0x6c, 0x65, 0x00);
+//# sourceMappingURL=_bundle-marker.js.map

package/dist/packet/_bundle-marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_bundle-marker.js","sourceRoot":"","sources":["../../src/packet/_bundle-marker.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC,EAAE,CAC1C,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,CACJ,CAAC"}

package/dist/packet/_osc-writer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A growable big-endian byte buffer for the OSC encoder.
+ *
+ * Doubling growth keeps a whole packet at one amortised O(n) copy. The size of
+ * a bundle element is only known once it is written, so its prefix is reserved
+ * and patched afterwards rather than measured in a separate pass that would
+ * have to agree with this one.
+ *
+ * Bytes past `length` are never written before they are allocated, so every
+ * allocation arrives zeroed and padding needs no explicit write.
+ */
+export declare class OscWriter_ {
+    private bytes;
+    private length_;
+    get length(): number;
+    /** Reserves `count` bytes and returns their offset. */
+    allocate(count: number): number;
+    writeUint32(value: number): void;
+    writeUint64(value: bigint): void;
+    writeFloat32(value: number): void;
+    writeFloat64(value: number): void;
+    writeBytes4(byte0: number, byte1: number, byte2: number, byte3: number): void;
+    patchUint32(offset: number, value: number): void;
+    /**
+     * Writes `data`, then `terminator` NUL bytes, then NUL bytes up to the next
+     * multiple of 4: an OSC-string with `terminator` 1, a blob's data with 0.
+     */
+    writePadded(data: Uint8Array, terminator: 0 | 1): void;
+    finish(): Uint8Array<ArrayBuffer>;
+}
+//# sourceMappingURL=_osc-writer.d.ts.map

package/dist/packet/_osc-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_osc-writer.d.ts","sourceRoot":"","sources":["../../src/packet/_osc-writer.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,KAAK,CAAsB;IAEnC,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW9B;IAID,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhC;IAED,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGhC;IAED,WAAW,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,IAAI,CAMN;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE/C;IAED;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAIrD;IAED,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAEhC;CACD"}

package/dist/packet/_osc-writer.js

@@ -0,0 +1,72 @@
+import { setBigUint64Be, setFloat32Be, setFloat64Be, setUint32Be, } from "@ac-kit/core";
+/**
+ * A growable big-endian byte buffer for the OSC encoder.
+ *
+ * Doubling growth keeps a whole packet at one amortised O(n) copy. The size of
+ * a bundle element is only known once it is written, so its prefix is reserved
+ * and patched afterwards rather than measured in a separate pass that would
+ * have to agree with this one.
+ *
+ * Bytes past `length` are never written before they are allocated, so every
+ * allocation arrives zeroed and padding needs no explicit write.
+ */
+export class OscWriter_ {
+    bytes = new Uint8Array(64);
+    length_ = 0;
+    get length() {
+        return this.length_;
+    }
+    /** Reserves `count` bytes and returns their offset. */
+    allocate(count) {
+        const offset = this.length_;
+        const needed = offset + count;
+        if (needed > this.bytes.length) {
+            const grown = new Uint8Array(Math.max(needed, this.bytes.length * 2));
+            grown.set(this.bytes.subarray(0, offset));
+            this.bytes = grown;
+        }
+        this.length_ = needed;
+        return offset;
+    }
+    // Each write allocates first: `allocate` may replace `bytes`, so reading the
+    // field in the same argument list as the call would write to the old buffer.
+    writeUint32(value) {
+        const offset = this.allocate(4);
+        setUint32Be(this.bytes, offset, value);
+    }
+    writeUint64(value) {
+        const offset = this.allocate(8);
+        setBigUint64Be(this.bytes, offset, value);
+    }
+    writeFloat32(value) {
+        const offset = this.allocate(4);
+        setFloat32Be(this.bytes, offset, value);
+    }
+    writeFloat64(value) {
+        const offset = this.allocate(8);
+        setFloat64Be(this.bytes, offset, value);
+    }
+    writeBytes4(byte0, byte1, byte2, byte3) {
+        const offset = this.allocate(4);
+        this.bytes[offset] = byte0;
+        this.bytes[offset + 1] = byte1;
+        this.bytes[offset + 2] = byte2;
+        this.bytes[offset + 3] = byte3;
+    }
+    patchUint32(offset, value) {
+        setUint32Be(this.bytes, offset, value);
+    }
+    /**
+     * Writes `data`, then `terminator` NUL bytes, then NUL bytes up to the next
+     * multiple of 4: an OSC-string with `terminator` 1, a blob's data with 0.
+     */
+    writePadded(data, terminator) {
+        // Arithmetic, not `& ~3`, which wraps for a blob near 2^31 bytes.
+        const offset = this.allocate(Math.ceil((data.length + terminator) / 4) * 4);
+        this.bytes.set(data, offset);
+    }
+    finish() {
+        return this.bytes.slice(0, this.length_);
+    }
+}
+//# sourceMappingURL=_osc-writer.js.map

package/dist/packet/_osc-writer.js.map

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

package/dist/packet/_read-osc-packet.d.ts

@@ -0,0 +1,19 @@
+import type { OscPacket } from "./osc-packet.js";
+/** Resolves and validates the `maxDepth` decode option. */
+export declare function resolveMaxDepth_(maxDepth: number | undefined): number;
+/**
+ * Decodes the whole of `bytes` as one OSC packet — the single implementation of
+ * the OSC read grammar, OSC 1.0 §"OSC Packets" through §"OSC Bundles", with the
+ * OSC 1.1 type tags.
+ *
+ * Every read is bounds-checked against the end of the enclosing packet or
+ * bundle element before it happens, so a hostile size can make it throw but
+ * never read past `bytes` or allocate more than `bytes` holds. Bundles recurse,
+ * at most `maxDepth` deep; arrays are walked iteratively against the same
+ * bound. Time is O(n) in `bytes.length`; memory is O(n) for the result plus
+ * O(maxDepth) of stack.
+ *
+ * @throws {OscPacketError} On any malformed input, with the offset in `bytes`.
+ */
+export declare function readOscPacket_(bytes: Uint8Array, maxDepth: number): OscPacket;
+//# sourceMappingURL=_read-osc-packet.d.ts.map

package/dist/packet/_read-osc-packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_read-osc-packet.d.ts","sourceRoot":"","sources":["../../src/packet/_read-osc-packet.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAIX,SAAS,EACT,MAAM,iBAAiB,CAAC;AAazB,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWrE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAE7E"}

package/dist/packet/_read-osc-packet.js

@@ -0,0 +1,290 @@
+import { ByteReader, bytesIsEqual, COMMA, decodeText, getBigUint64Be, getFloat32Be, getFloat64Be, getUint32Be, HASH, LEFT_SQUARE_BRACKET, NUL, RIGHT_SQUARE_BRACKET, SLASH, } from "@ac-kit/core";
+import { OscPacketError } from "../errors.js";
+import { BUNDLE_MARKER_ } from "./_bundle-marker.js";
+/**
+ * Default bound on nested bundles and arrays together.
+ *
+ * Bundles recurse on the call stack, and a 64 KiB datagram could otherwise nest
+ * about 4,000 of them, or 65,000 arrays in a type tag string; no OSC
+ * implementation in use sends more than two or three levels. 32 leaves an order
+ * of magnitude of headroom for real traffic while keeping a hostile packet far
+ * below any engine's stack limit.
+ */
+const DEFAULT_MAX_DEPTH_ = 32;
+/** Resolves and validates the `maxDepth` decode option. */
+export function resolveMaxDepth_(maxDepth) {
+    if (maxDepth === undefined) {
+        return DEFAULT_MAX_DEPTH_;
+    }
+    if (!Number.isInteger(maxDepth) || maxDepth < 0) {
+        throw new RangeError(`maxDepth must be a non-negative integer, got ${maxDepth}`);
+    }
+    return maxDepth;
+}
+/**
+ * Decodes the whole of `bytes` as one OSC packet — the single implementation of
+ * the OSC read grammar, OSC 1.0 §"OSC Packets" through §"OSC Bundles", with the
+ * OSC 1.1 type tags.
+ *
+ * Every read is bounds-checked against the end of the enclosing packet or
+ * bundle element before it happens, so a hostile size can make it throw but
+ * never read past `bytes` or allocate more than `bytes` holds. Bundles recurse,
+ * at most `maxDepth` deep; arrays are walked iteratively against the same
+ * bound. Time is O(n) in `bytes.length`; memory is O(n) for the result plus
+ * O(maxDepth) of stack.
+ *
+ * @throws {OscPacketError} On any malformed input, with the offset in `bytes`.
+ */
+export function readOscPacket_(bytes, maxDepth) {
+    return readPacket_(new ByteReader(bytes), bytes.length, 0, maxDepth);
+}
+/**
+ * Reads the packet occupying `[reader.position, end)`; `depth` is the number of
+ * bundles enclosing it.
+ */
+function readPacket_(reader, end, depth, maxDepth) {
+    const start = reader.position;
+    const size = end - start;
+    if (size === 0) {
+        throw new OscPacketError("Empty OSC packet", start);
+    }
+    if (size % 4 !== 0) {
+        throw new OscPacketError(`OSC packet size ${size} is not a multiple of 4`, start);
+    }
+    const first = reader.peekByte();
+    if (first === SLASH) {
+        return readMessage_(reader, end, depth, maxDepth);
+    }
+    if (first === HASH) {
+        return readBundle_(reader, end, depth, maxDepth);
+    }
+    throw new OscPacketError('OSC packet begins with neither "/" nor "#bundle"', start);
+}
+function readBundle_(reader, end, depth, maxDepth) {
+    const start = reader.position;
+    if (depth >= maxDepth) {
+        throw new OscPacketError(`Bundle nesting exceeds maxDepth ${maxDepth}`, start);
+    }
+    need_(reader, end, 16, "bundle header");
+    if (!bytesIsEqual(reader.read(8), BUNDLE_MARKER_)) {
+        throw new OscPacketError('Expected "#bundle"', start);
+    }
+    const timeTag = reader.read(8);
+    const elements = [];
+    while (reader.position < end) {
+        const sizeOffset = reader.position;
+        need_(reader, end, 4, "bundle element size");
+        const size = getUint32Be(reader.read(4), 0) | 0;
+        if (size < 0 || size > end - reader.position) {
+            throw new OscPacketError(`Bundle element size ${size} does not fit the ${end - reader.position} bytes left in its bundle`, sizeOffset);
+        }
+        elements.push(readPacket_(reader, reader.position + size, depth + 1, maxDepth));
+    }
+    return {
+        kind: "bundle",
+        timeTag: {
+            seconds: getUint32Be(timeTag, 0),
+            fraction: getUint32Be(timeTag, 4),
+        },
+        elements,
+    };
+}
+function readMessage_(reader, end, depth, maxDepth) {
+    const address = readText_(reader, end, "address");
+    // OSC 1.0 asks receivers to accept a message from an older sender that has
+    // no type tag string; only one with nothing after its address can be read
+    // without guessing the types of what follows.
+    if (reader.position === end) {
+        return { kind: "message", address, arguments: [] };
+    }
+    if (reader.peekByte() !== COMMA) {
+        throw new OscPacketError('Expected a type tag string beginning with ","', reader.position);
+    }
+    const tagsOffset = reader.position;
+    const tags = readStringBytes_(reader, end, "type tag string");
+    const root = [];
+    const stack = [root];
+    for (let index = 1; index < tags.length; index++) {
+        const tag = tags[index];
+        const tagOffset = tagsOffset + index;
+        // `stack` always holds at least `root`.
+        const items = stack[stack.length - 1];
+        if (tag === LEFT_SQUARE_BRACKET) {
+            if (depth + stack.length > maxDepth) {
+                throw new OscPacketError(`Array nesting exceeds maxDepth ${maxDepth}`, tagOffset);
+            }
+            const nested = [];
+            items.push({ type: "array", items: nested });
+            stack.push(nested);
+            continue;
+        }
+        if (tag === RIGHT_SQUARE_BRACKET) {
+            if (stack.length === 1) {
+                throw new OscPacketError('Unmatched "]" in type tag string', tagOffset);
+            }
+            stack.pop();
+            continue;
+        }
+        items.push(readArgument_(reader, end, tag, tagOffset));
+    }
+    if (stack.length > 1) {
+        throw new OscPacketError('Unclosed "[" in type tag string', tagsOffset);
+    }
+    if (reader.position !== end) {
+        throw new OscPacketError(`${end - reader.position} bytes follow the last argument`, reader.position);
+    }
+    return { kind: "message", address, arguments: root };
+}
+function readArgument_(reader, end, tag, tagOffset) {
+    const tagChar = String.fromCharCode(tag);
+    switch (tagChar) {
+        case "i":
+            need_(reader, end, 4, "int32");
+            return { type: "int32", value: getUint32Be(reader.read(4), 0) | 0 };
+        case "f":
+            need_(reader, end, 4, "float32");
+            return { type: "float32", value: getFloat32Be(reader.read(4), 0) };
+        case "s":
+            return { type: "string", value: readText_(reader, end, "string") };
+        case "S":
+            return { type: "symbol", value: readText_(reader, end, "symbol") };
+        case "b":
+            return { type: "blob", value: readBlob_(reader, end) };
+        case "h":
+            need_(reader, end, 8, "int64");
+            return {
+                type: "int64",
+                value: BigInt.asIntN(64, getBigUint64Be(reader.read(8), 0)),
+            };
+        case "t": {
+            need_(reader, end, 8, "timeTag");
+            const field = reader.read(8);
+            return {
+                type: "timeTag",
+                value: {
+                    seconds: getUint32Be(field, 0),
+                    fraction: getUint32Be(field, 4),
+                },
+            };
+        }
+        case "d":
+            need_(reader, end, 8, "float64");
+            return { type: "float64", value: getFloat64Be(reader.read(8), 0) };
+        case "c":
+            return { type: "char", value: readChar_(reader, end) };
+        case "r": {
+            need_(reader, end, 4, "rgba");
+            const field = reader.read(4);
+            return {
+                type: "rgba",
+                red: field[0],
+                green: field[1],
+                blue: field[2],
+                alpha: field[3],
+            };
+        }
+        case "m": {
+            need_(reader, end, 4, "midi");
+            const field = reader.read(4);
+            return {
+                type: "midi",
+                port: field[0],
+                status: field[1],
+                data1: field[2],
+                data2: field[3],
+            };
+        }
+        case "T":
+            return { type: "true" };
+        case "F":
+            return { type: "false" };
+        case "N":
+            return { type: "nil" };
+        case "I":
+            return { type: "impulse" };
+        default:
+            throw new OscPacketError(`Unknown type tag 0x${tag.toString(16).padStart(2, "0")}`, tagOffset);
+    }
+}
+function readChar_(reader, end) {
+    const start = reader.position;
+    need_(reader, end, 4, "char");
+    const codePoint = getUint32Be(reader.read(4), 0);
+    if (codePoint > 0x10ffff || (codePoint >= 0xd800 && codePoint <= 0xdfff)) {
+        throw new OscPacketError(`char 0x${codePoint.toString(16)} is not a Unicode scalar value`, start);
+    }
+    return String.fromCodePoint(codePoint);
+}
+/** Reads a blob: an int32 size, the bytes, and NUL padding to a multiple of 4. */
+function readBlob_(reader, end) {
+    const start = reader.position;
+    need_(reader, end, 4, "blob size");
+    const size = getUint32Be(reader.read(4), 0) | 0;
+    if (size < 0) {
+        throw new OscPacketError(`Negative blob size ${size}`, start);
+    }
+    const padded = roundUp4_(size);
+    if (padded > end - reader.position) {
+        throw new OscPacketError(`Truncated blob: needs ${padded} bytes, ${end - reader.position} remain`, start);
+    }
+    const field = reader.read(padded);
+    checkPadding_(field, size, start + 4, "blob");
+    // Copy: the input is a caller's or a driver's buffer and may be reused.
+    return field.slice(0, size);
+}
+/** Reads an OSC-string as UTF-8. */
+function readText_(reader, end, what) {
+    const start = reader.position;
+    const bytes = readStringBytes_(reader, end, what);
+    try {
+        return decodeText(bytes, "utf-8", { fatal: true, ignoreBOM: true });
+    }
+    catch (error) {
+        throw new OscPacketError(`Invalid UTF-8 in ${what}`, start, {
+            cause: error,
+        });
+    }
+}
+/**
+ * Reads an OSC-string — bytes, a NUL, and NUL padding to a multiple of 4 — and
+ * returns the bytes before the terminator as a view into the input.
+ */
+function readStringBytes_(reader, end, what) {
+    const start = reader.position;
+    const length = reader
+        .peekRemaining()
+        .subarray(0, end - start)
+        .indexOf(NUL);
+    if (length === -1) {
+        throw new OscPacketError(`Unterminated ${what}`, start);
+    }
+    const padded = roundUp4_(length + 1);
+    if (padded > end - start) {
+        throw new OscPacketError(`Truncated ${what} padding`, start + length + 1);
+    }
+    const field = reader.read(padded);
+    checkPadding_(field, length + 1, start, what);
+    return field.subarray(0, length);
+}
+/**
+ * Padding is checked strictly: every OSC implementation pads with NUL, so any
+ * other byte means the packet is misframed, not merely untidy.
+ */
+function checkPadding_(field, from, fieldOffset, what) {
+    for (let index = from; index < field.length; index++) {
+        if (field[index] !== NUL) {
+            throw new OscPacketError(`Non-zero padding byte after ${what}`, fieldOffset + index);
+        }
+    }
+}
+function need_(reader, end, count, what) {
+    const remaining = end - reader.position;
+    if (remaining < count) {
+        throw new OscPacketError(`Truncated ${what}: needs ${count} bytes, ${remaining} remain`, reader.position);
+    }
+}
+/** Bitwise `& ~3` would wrap above 2^31; a blob size may reach 2^31 − 1. */
+function roundUp4_(value) {
+    return Math.ceil(value / 4) * 4;
+}
+//# sourceMappingURL=_read-osc-packet.js.map

package/dist/packet/_read-osc-packet.js.map

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

package/dist/packet/_write-osc-packet.d.ts

@@ -0,0 +1,12 @@
+import type { OscWriter_ } from "./_osc-writer.js";
+import type { OscPacket } from "./osc-packet.js";
+/**
+ * Appends `packet` to `writer` — the single implementation of the OSC write
+ * grammar, OSC 1.0 §"OSC Packets" through §"OSC Bundles".
+ *
+ * A type tag string is always written, `,` alone for no arguments, as OSC 1.1
+ * requires. Recursion depth is the caller's own nesting; nothing here bounds
+ * it.
+ */
+export declare function writeOscPacket_(writer: OscWriter_, packet: OscPacket): void;
+//# sourceMappingURL=_write-osc-packet.d.ts.map

package/dist/packet/_write-osc-packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_write-osc-packet.d.ts","sourceRoot":"","sources":["../../src/packet/_write-osc-packet.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA0B9D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAuB3E"}