universal-game-modder 0.1.4

package/dist/decoders/texture-decode.js

@@ -0,0 +1,278 @@
+/**
+ * texture-decode.ts — turn raw Unity texture bytes + a TextureFormat into RGBA pixels.
+ *
+ * Two paths:
+ *   1. UNCOMPRESSED formats (RGBA32, RGB24, Alpha8, ARGB32, BGRA32, RGB565, R8, R16...)
+ *      are unpacked here directly — no WASM needed. Baldi is overwhelmingly RGBA32, so
+ *      this path carries most of the corpus.
+ *   2. COMPRESSED formats (DXT/BC, ETC, ASTC, PVRTC, ATC, EAC, and the Crunched variants)
+ *      are decoded by texture2ddecoder-wasm. Crunched formats are unpacked first
+ *      (unpack_unity_crunch) then decoded by their base codec. The WASM decoders emit
+ *      BGRA; we swap to RGBA on the way out so the PNG encoder gets a consistent layout.
+ *
+ * Output is ALWAYS tightly-packed RGBA8 (width*height*4 bytes), top-left origin. Unity
+ * stores textures bottom-up, so the caller (png-encode) flips vertically.
+ *
+ * A format we cannot decode returns { ok:false, reason } rather than throwing — the
+ * decode_assets tool turns that into a decoded=0 asset row with a note (never a silent drop).
+ */
+import { initialize, decode_bc1, decode_bc3, decode_bc4, decode_bc5, decode_bc6, decode_bc7, decode_etc1, decode_etc2, decode_etc2a1, decode_etc2a8, decode_pvrtc, decode_astc, decode_atc_rgb4, decode_atc_rgba8, unpack_unity_crunch, } from 'texture2ddecoder-wasm';
+import { TextureFormat } from './unity/texture2d.js';
+let wasmReady = false;
+async function ensureWasm() {
+    if (!wasmReady) {
+        await initialize();
+        wasmReady = true;
+    }
+}
+/** BGRA (or BGRA-ish) -> RGBA in place-ish (returns a new Buffer). */
+function bgraToRgba(bgra, width, height) {
+    const n = width * height * 4;
+    const out = Buffer.allocUnsafe(n);
+    for (let i = 0; i < n; i += 4) {
+        out[i] = bgra[i + 2]; // R <- B
+        out[i + 1] = bgra[i + 1]; // G
+        out[i + 2] = bgra[i]; // B <- R
+        out[i + 3] = bgra[i + 3]; // A
+    }
+    return out;
+}
+/** ASTC block dimensions per format. */
+function astcBlock(fmt) {
+    switch (fmt) {
+        case TextureFormat.ASTC_RGB_4x4:
+        case TextureFormat.ASTC_RGBA_4x4:
+            return [4, 4];
+        case TextureFormat.ASTC_RGB_5x5:
+        case TextureFormat.ASTC_RGBA_5x5:
+            return [5, 5];
+        case TextureFormat.ASTC_RGB_6x6:
+        case TextureFormat.ASTC_RGBA_6x6:
+            return [6, 6];
+        case TextureFormat.ASTC_RGB_8x8:
+        case TextureFormat.ASTC_RGBA_8x8:
+            return [8, 8];
+        case TextureFormat.ASTC_RGB_10x10:
+        case TextureFormat.ASTC_RGBA_10x10:
+            return [10, 10];
+        case TextureFormat.ASTC_RGB_12x12:
+        case TextureFormat.ASTC_RGBA_12x12:
+            return [12, 12];
+        default:
+            return null;
+    }
+}
+/** Decode an uncompressed Unity texture format directly to RGBA8. Returns null if not uncompressed. */
+function decodeUncompressed(data, fmt, width, height) {
+    const px = width * height;
+    const out = Buffer.alloc(px * 4);
+    const need = (bytes) => data.length >= bytes;
+    switch (fmt) {
+        case TextureFormat.RGBA32: {
+            if (!need(px * 4))
+                return null;
+            data.copy(out, 0, 0, px * 4);
+            return out;
+        }
+        case TextureFormat.ARGB32: {
+            if (!need(px * 4))
+                return null;
+            for (let i = 0; i < px; i++) {
+                const s = i * 4;
+                out[s] = data[s + 1];
+                out[s + 1] = data[s + 2];
+                out[s + 2] = data[s + 3];
+                out[s + 3] = data[s];
+            }
+            return out;
+        }
+        case TextureFormat.BGRA32: {
+            if (!need(px * 4))
+                return null;
+            for (let i = 0; i < px; i++) {
+                const s = i * 4;
+                out[s] = data[s + 2];
+                out[s + 1] = data[s + 1];
+                out[s + 2] = data[s];
+                out[s + 3] = data[s + 3];
+            }
+            return out;
+        }
+        case TextureFormat.RGB24: {
+            if (!need(px * 3))
+                return null;
+            for (let i = 0; i < px; i++) {
+                out[i * 4] = data[i * 3];
+                out[i * 4 + 1] = data[i * 3 + 1];
+                out[i * 4 + 2] = data[i * 3 + 2];
+                out[i * 4 + 3] = 255;
+            }
+            return out;
+        }
+        case TextureFormat.Alpha8: {
+            if (!need(px))
+                return null;
+            for (let i = 0; i < px; i++) {
+                out[i * 4] = 255;
+                out[i * 4 + 1] = 255;
+                out[i * 4 + 2] = 255;
+                out[i * 4 + 3] = data[i];
+            }
+            return out;
+        }
+        case TextureFormat.R8: {
+            if (!need(px))
+                return null;
+            for (let i = 0; i < px; i++) {
+                out[i * 4] = data[i];
+                out[i * 4 + 1] = data[i];
+                out[i * 4 + 2] = data[i];
+                out[i * 4 + 3] = 255;
+            }
+            return out;
+        }
+        case TextureFormat.RGB565: {
+            if (!need(px * 2))
+                return null;
+            for (let i = 0; i < px; i++) {
+                const v = data.readUInt16LE(i * 2);
+                const r = (v >> 11) & 0x1f;
+                const g = (v >> 5) & 0x3f;
+                const b = v & 0x1f;
+                out[i * 4] = (r << 3) | (r >> 2);
+                out[i * 4 + 1] = (g << 2) | (g >> 4);
+                out[i * 4 + 2] = (b << 3) | (b >> 2);
+                out[i * 4 + 3] = 255;
+            }
+            return out;
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Decode any supported Unity texture format to tightly-packed RGBA8.
+ * `data` is the raw (possibly streamed) texture bytes; `fmt` is the Unity TextureFormat int.
+ */
+export async function decodeTexture(data, fmt, width, height) {
+    if (width <= 0 || height <= 0)
+        return { ok: false, reason: `bad dimensions ${width}x${height}` };
+    if (data.length === 0)
+        return { ok: false, reason: 'no pixel data' };
+    // 1) Uncompressed fast path (no WASM).
+    const direct = decodeUncompressed(data, fmt, width, height);
+    if (direct)
+        return { ok: true, rgba: direct };
+    // 2) Crunched -> unpack to the base codec stream first.
+    let payload = data;
+    let effFmt = fmt;
+    try {
+        if (fmt === TextureFormat.DXT1Crunched) {
+            const u = await unpackCrunch(data);
+            if (!u)
+                return { ok: false, reason: 'DXT1Crunched unpack failed' };
+            payload = u;
+            effFmt = TextureFormat.DXT1;
+        }
+        else if (fmt === TextureFormat.DXT5Crunched) {
+            const u = await unpackCrunch(data);
+            if (!u)
+                return { ok: false, reason: 'DXT5Crunched unpack failed' };
+            payload = u;
+            effFmt = TextureFormat.DXT5;
+        }
+        else if (fmt === TextureFormat.ETC_RGB4Crunched) {
+            const u = await unpackCrunch(data);
+            if (!u)
+                return { ok: false, reason: 'ETC_RGB4Crunched unpack failed' };
+            payload = u;
+            effFmt = TextureFormat.ETC_RGB4;
+        }
+        else if (fmt === TextureFormat.ETC2_RGBA8Crunched) {
+            const u = await unpackCrunch(data);
+            if (!u)
+                return { ok: false, reason: 'ETC2_RGBA8Crunched unpack failed' };
+            payload = u;
+            effFmt = TextureFormat.ETC2_RGBA8;
+        }
+    }
+    catch (e) {
+        return { ok: false, reason: `crunch unpack threw: ${e.message}` };
+    }
+    // 3) Compressed (WASM). All WASM decoders emit BGRA -> swap to RGBA.
+    try {
+        await ensureWasm();
+        let bgra = null;
+        switch (effFmt) {
+            case TextureFormat.DXT1:
+                bgra = await decode_bc1(payload, width, height);
+                break;
+            case TextureFormat.DXT5:
+                bgra = await decode_bc3(payload, width, height);
+                break;
+            case TextureFormat.BC4:
+                bgra = await decode_bc4(payload, width, height);
+                break;
+            case TextureFormat.BC5:
+                bgra = await decode_bc5(payload, width, height);
+                break;
+            case TextureFormat.BC6H:
+                bgra = await decode_bc6(payload, width, height);
+                break;
+            case TextureFormat.BC7:
+                bgra = await decode_bc7(payload, width, height);
+                break;
+            case TextureFormat.ETC_RGB4:
+                bgra = await decode_etc1(payload, width, height);
+                break;
+            case TextureFormat.ETC2_RGB:
+                bgra = await decode_etc2(payload, width, height);
+                break;
+            case TextureFormat.ETC2_RGBA1:
+                bgra = await decode_etc2a1(payload, width, height);
+                break;
+            case TextureFormat.ETC2_RGBA8:
+                bgra = await decode_etc2a8(payload, width, height);
+                break;
+            case TextureFormat.ATC_RGB4:
+                bgra = await decode_atc_rgb4(payload, width, height);
+                break;
+            case TextureFormat.ATC_RGBA8:
+                bgra = await decode_atc_rgba8(payload, width, height);
+                break;
+            case TextureFormat.PVRTC_RGB2:
+            case TextureFormat.PVRTC_RGBA2:
+                bgra = await decode_pvrtc(payload, width, height, true);
+                break;
+            case TextureFormat.PVRTC_RGB4:
+            case TextureFormat.PVRTC_RGBA4:
+                bgra = await decode_pvrtc(payload, width, height, false);
+                break;
+            default: {
+                const block = astcBlock(effFmt);
+                if (block) {
+                    bgra = await decode_astc(payload, width, height, block[0], block[1]);
+                }
+                else {
+                    return {
+                        ok: false,
+                        reason: `unsupported TextureFormat ${TextureFormat[fmt] ?? fmt}`,
+                    };
+                }
+            }
+        }
+        if (!bgra)
+            return { ok: false, reason: `decoder returned null for ${TextureFormat[effFmt] ?? effFmt}` };
+        return { ok: true, rgba: bgraToRgba(bgra, width, height) };
+    }
+    catch (e) {
+        return { ok: false, reason: `decode threw: ${e.message}` };
+    }
+}
+async function unpackCrunch(data) {
+    await ensureWasm();
+    // Unity uses a modified crunch; unpack_unity_crunch is the Unity-specific variant.
+    const u = await unpack_unity_crunch(data);
+    return u ? Buffer.from(u) : null;
+}
+//# sourceMappingURL=texture-decode.js.map

package/dist/decoders/texture-decode.js.map

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

package/dist/decoders/unity/audioclip.d.ts

@@ -0,0 +1,55 @@
+/**
+ * audioclip.ts — parse a Unity AudioClip object (Unity 2020.3 / format v22, typeTree DISABLED).
+ *
+ * AudioClip stores its audio in a streamed resource (.resource / .resS), referenced by an
+ * m_Resource { source, offset, size, compressionFormat } block. The audio is NOT inside the
+ * .assets file — the .assets holds only the metadata + the pointer.
+ *
+ * SCOPE (PR-2.3 first slice): extract the metadata (name, channels, frequency, bits) and the
+ * StreamedResource pointer. The actual sample bytes are pulled by the caller via the .resource
+ * stream reader. Two on-disk formats are handled downstream without a codec library:
+ *   - PCM (compressionFormat 0): raw little-endian samples -> wrap in a WAV header.
+ *   - Vorbis (compressionFormat 1): the bytes ARE a complete Ogg-Vorbis stream -> write .ogg.
+ * Other compression formats (ADPCM/MP3/etc.) are reported unsupported (noted decoded=0 row).
+ *
+ * Reference field order: Unity 2020.3 AudioClip (AssetStudio AudioClip.cs), little-endian.
+ *   m_Name : AlignedString
+ *   m_LoadType : Int32
+ *   m_Channels : Int32
+ *   m_Frequency : Int32
+ *   m_BitsPerSample : Int32
+ *   m_Length : float
+ *   m_IsTrackerFormat : bool ; align(4)
+ *   m_SubsoundIndex : Int32
+ *   m_PreloadAudioData : bool ; m_LoadInBackground : bool ; m_Legacy3D : bool ; align(4)
+ *   m_Resource : StreamedResource { m_Source:AlignedString, m_Offset:UInt64, m_Size:UInt64 }
+ *   m_CompressionFormat : Int32
+ */
+import type { ObjectInfo, SerializedFileHeader } from './serialized-file.js';
+/** Unity AudioCompressionFormat. */
+export declare enum AudioCompressionFormat {
+    PCM = 0,
+    Vorbis = 1,
+    ADPCM = 2,
+    MP3 = 3,
+    VAG = 4,
+    HEVAG = 5,
+    XMA = 6,
+    AAC = 7,
+    GCADPCM = 8,
+    ATRAC9 = 9
+}
+export interface ParsedAudioClip {
+    name: string;
+    channels: number;
+    frequency: number;
+    bitsPerSample: number;
+    length: number;
+    compressionFormat: number;
+    compressionName: string;
+    /** stream pointer into the sibling .resource/.resS. */
+    source: string;
+    offset: bigint;
+    size: number;
+}
+export declare function parseAudioClip(buf: Buffer, header: SerializedFileHeader, obj: ObjectInfo): ParsedAudioClip;

package/dist/decoders/unity/audioclip.js

@@ -0,0 +1,87 @@
+/**
+ * audioclip.ts — parse a Unity AudioClip object (Unity 2020.3 / format v22, typeTree DISABLED).
+ *
+ * AudioClip stores its audio in a streamed resource (.resource / .resS), referenced by an
+ * m_Resource { source, offset, size, compressionFormat } block. The audio is NOT inside the
+ * .assets file — the .assets holds only the metadata + the pointer.
+ *
+ * SCOPE (PR-2.3 first slice): extract the metadata (name, channels, frequency, bits) and the
+ * StreamedResource pointer. The actual sample bytes are pulled by the caller via the .resource
+ * stream reader. Two on-disk formats are handled downstream without a codec library:
+ *   - PCM (compressionFormat 0): raw little-endian samples -> wrap in a WAV header.
+ *   - Vorbis (compressionFormat 1): the bytes ARE a complete Ogg-Vorbis stream -> write .ogg.
+ * Other compression formats (ADPCM/MP3/etc.) are reported unsupported (noted decoded=0 row).
+ *
+ * Reference field order: Unity 2020.3 AudioClip (AssetStudio AudioClip.cs), little-endian.
+ *   m_Name : AlignedString
+ *   m_LoadType : Int32
+ *   m_Channels : Int32
+ *   m_Frequency : Int32
+ *   m_BitsPerSample : Int32
+ *   m_Length : float
+ *   m_IsTrackerFormat : bool ; align(4)
+ *   m_SubsoundIndex : Int32
+ *   m_PreloadAudioData : bool ; m_LoadInBackground : bool ; m_Legacy3D : bool ; align(4)
+ *   m_Resource : StreamedResource { m_Source:AlignedString, m_Offset:UInt64, m_Size:UInt64 }
+ *   m_CompressionFormat : Int32
+ */
+import { BinaryReader } from './binary-reader.js';
+/** Unity AudioCompressionFormat. */
+export var AudioCompressionFormat;
+(function (AudioCompressionFormat) {
+    AudioCompressionFormat[AudioCompressionFormat["PCM"] = 0] = "PCM";
+    AudioCompressionFormat[AudioCompressionFormat["Vorbis"] = 1] = "Vorbis";
+    AudioCompressionFormat[AudioCompressionFormat["ADPCM"] = 2] = "ADPCM";
+    AudioCompressionFormat[AudioCompressionFormat["MP3"] = 3] = "MP3";
+    AudioCompressionFormat[AudioCompressionFormat["VAG"] = 4] = "VAG";
+    AudioCompressionFormat[AudioCompressionFormat["HEVAG"] = 5] = "HEVAG";
+    AudioCompressionFormat[AudioCompressionFormat["XMA"] = 6] = "XMA";
+    AudioCompressionFormat[AudioCompressionFormat["AAC"] = 7] = "AAC";
+    AudioCompressionFormat[AudioCompressionFormat["GCADPCM"] = 8] = "GCADPCM";
+    AudioCompressionFormat[AudioCompressionFormat["ATRAC9"] = 9] = "ATRAC9";
+})(AudioCompressionFormat || (AudioCompressionFormat = {}));
+export function parseAudioClip(buf, header, obj) {
+    const little = header.endianess === 0;
+    const start = Number(header.dataOffset + obj.byteStart);
+    const end = start + obj.byteSize;
+    if (start < 0 || end > buf.length) {
+        throw new RangeError(`parseAudioClip: object range [${start}, ${end}] outside buffer ${buf.length}`);
+    }
+    const r = new BinaryReader(buf.subarray(start, end), !little, 0);
+    const name = r.readAlignedString();
+    /* m_LoadType */ r.readInt32();
+    const channels = r.readInt32();
+    const frequency = r.readInt32();
+    const bitsPerSample = r.readInt32();
+    const length = r.buf.readFloatLE(r.pos);
+    r.pos += 4;
+    r.readUInt8(); // m_IsTrackerFormat
+    r.align(4);
+    r.readInt32(); // m_SubsoundIndex
+    r.readUInt8(); // m_PreloadAudioData
+    r.readUInt8(); // m_LoadInBackground
+    r.readUInt8(); // m_Legacy3D
+    r.align(4);
+    // m_Resource (StreamedResource)
+    const source = r.readAlignedString();
+    const offset = r.readUInt64();
+    const sizeBig = r.readUInt64();
+    const compressionFormat = r.readInt32();
+    const size = Number(sizeBig);
+    if (channels <= 0 || channels > 32 || frequency <= 0 || frequency > 384000 || size < 0) {
+        throw new RangeError(`parseAudioClip("${name}"): implausible fields (ch=${channels} freq=${frequency} size=${size}) — field-order mismatch`);
+    }
+    return {
+        name,
+        channels,
+        frequency,
+        bitsPerSample,
+        length,
+        compressionFormat,
+        compressionName: AudioCompressionFormat[compressionFormat] ?? `comp${compressionFormat}`,
+        source,
+        offset,
+        size,
+    };
+}
+//# sourceMappingURL=audioclip.js.map

package/dist/decoders/unity/audioclip.js.map

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

package/dist/decoders/unity/binary-reader.d.ts

@@ -0,0 +1,45 @@
+/**
+ * binary-reader.ts — a minimal, bounds-checked binary reader for Unity serialized files.
+ *
+ * Unity serialized files (.assets) mix endianness: the HEADER is big-endian, the
+ * METADATA + object data are written in the endianness declared by the header's
+ * m_Endianess byte (little-endian on desktop/Windows). This reader supports both and
+ * lets the caller flip endianness per-field, exactly as the format requires.
+ *
+ * Every read is bounds-checked: a read past the buffer throws a precise RangeError
+ * rather than returning silent garbage. This is the anti-silent-corruption discipline —
+ * the bug that killed the candidate library (asset-studio-web) was an unchecked offset
+ * walk that produced "Out of bounds" only by luck; here every primitive is guarded.
+ */
+export declare class BinaryReader {
+    readonly buf: Buffer;
+    pos: number;
+    /** true => big-endian for multi-byte reads; false => little-endian. */
+    bigEndian: boolean;
+    constructor(buf: Buffer, bigEndian?: boolean, pos?: number);
+    get length(): number;
+    get remaining(): number;
+    private ensure;
+    seek(pos: number): void;
+    skip(n: number): void;
+    /** Align the cursor up to the next multiple of `n` (Unity aligns to 4 after many fields). */
+    align(n?: number): void;
+    readUInt8(): number;
+    readInt8(): number;
+    readUInt16(): number;
+    readInt16(): number;
+    readUInt32(): number;
+    readInt32(): number;
+    readUInt64(): bigint;
+    readInt64(): bigint;
+    readBytes(n: number): Buffer;
+    /** Read a NUL-terminated ASCII/UTF-8 string starting at the cursor. */
+    readCString(maxLen?: number): string;
+    /** Read a NUL-terminated string at an absolute offset WITHOUT moving the cursor. */
+    peekCStringAt(offset: number, maxLen?: number): string;
+    /**
+     * Read a Unity "aligned string": an Int32 length prefix, the bytes, then align(4).
+     * Used for m_Name and m_StreamData.path inside object payloads.
+     */
+    readAlignedString(): string;
+}

package/dist/decoders/unity/binary-reader.js

@@ -0,0 +1,141 @@
+/**
+ * binary-reader.ts — a minimal, bounds-checked binary reader for Unity serialized files.
+ *
+ * Unity serialized files (.assets) mix endianness: the HEADER is big-endian, the
+ * METADATA + object data are written in the endianness declared by the header's
+ * m_Endianess byte (little-endian on desktop/Windows). This reader supports both and
+ * lets the caller flip endianness per-field, exactly as the format requires.
+ *
+ * Every read is bounds-checked: a read past the buffer throws a precise RangeError
+ * rather than returning silent garbage. This is the anti-silent-corruption discipline —
+ * the bug that killed the candidate library (asset-studio-web) was an unchecked offset
+ * walk that produced "Out of bounds" only by luck; here every primitive is guarded.
+ */
+export class BinaryReader {
+    buf;
+    pos;
+    /** true => big-endian for multi-byte reads; false => little-endian. */
+    bigEndian;
+    constructor(buf, bigEndian = false, pos = 0) {
+        this.buf = buf;
+        this.bigEndian = bigEndian;
+        this.pos = pos;
+    }
+    get length() {
+        return this.buf.length;
+    }
+    get remaining() {
+        return this.buf.length - this.pos;
+    }
+    ensure(n) {
+        if (this.pos + n > this.buf.length) {
+            throw new RangeError(`BinaryReader: read of ${n} byte(s) at offset ${this.pos} exceeds buffer length ${this.buf.length}`);
+        }
+    }
+    seek(pos) {
+        if (pos < 0 || pos > this.buf.length) {
+            throw new RangeError(`BinaryReader: seek to ${pos} out of range [0, ${this.buf.length}]`);
+        }
+        this.pos = pos;
+    }
+    skip(n) {
+        this.seek(this.pos + n);
+    }
+    /** Align the cursor up to the next multiple of `n` (Unity aligns to 4 after many fields). */
+    align(n = 4) {
+        const rem = this.pos % n;
+        if (rem !== 0)
+            this.skip(n - rem);
+    }
+    readUInt8() {
+        this.ensure(1);
+        const v = this.buf.readUInt8(this.pos);
+        this.pos += 1;
+        return v;
+    }
+    readInt8() {
+        this.ensure(1);
+        const v = this.buf.readInt8(this.pos);
+        this.pos += 1;
+        return v;
+    }
+    readUInt16() {
+        this.ensure(2);
+        const v = this.bigEndian ? this.buf.readUInt16BE(this.pos) : this.buf.readUInt16LE(this.pos);
+        this.pos += 2;
+        return v;
+    }
+    readInt16() {
+        this.ensure(2);
+        const v = this.bigEndian ? this.buf.readInt16BE(this.pos) : this.buf.readInt16LE(this.pos);
+        this.pos += 2;
+        return v;
+    }
+    readUInt32() {
+        this.ensure(4);
+        const v = this.bigEndian ? this.buf.readUInt32BE(this.pos) : this.buf.readUInt32LE(this.pos);
+        this.pos += 4;
+        return v;
+    }
+    readInt32() {
+        this.ensure(4);
+        const v = this.bigEndian ? this.buf.readInt32BE(this.pos) : this.buf.readInt32LE(this.pos);
+        this.pos += 4;
+        return v;
+    }
+    readUInt64() {
+        this.ensure(8);
+        const v = this.bigEndian ? this.buf.readBigUInt64BE(this.pos) : this.buf.readBigUInt64LE(this.pos);
+        this.pos += 8;
+        return v;
+    }
+    readInt64() {
+        this.ensure(8);
+        const v = this.bigEndian ? this.buf.readBigInt64BE(this.pos) : this.buf.readBigInt64LE(this.pos);
+        this.pos += 8;
+        return v;
+    }
+    readBytes(n) {
+        this.ensure(n);
+        const out = this.buf.subarray(this.pos, this.pos + n);
+        this.pos += n;
+        return out;
+    }
+    /** Read a NUL-terminated ASCII/UTF-8 string starting at the cursor. */
+    readCString(maxLen = 4096) {
+        const start = this.pos;
+        let end = start;
+        const hardStop = Math.min(this.buf.length, start + maxLen);
+        while (end < hardStop && this.buf[end] !== 0)
+            end++;
+        const s = this.buf.toString('utf8', start, end);
+        // advance past the string and its NUL terminator (if present)
+        this.pos = end < this.buf.length ? end + 1 : end;
+        return s;
+    }
+    /** Read a NUL-terminated string at an absolute offset WITHOUT moving the cursor. */
+    peekCStringAt(offset, maxLen = 4096) {
+        if (offset < 0 || offset >= this.buf.length)
+            return '';
+        let end = offset;
+        const hardStop = Math.min(this.buf.length, offset + maxLen);
+        while (end < hardStop && this.buf[end] !== 0)
+            end++;
+        return this.buf.toString('utf8', offset, end);
+    }
+    /**
+     * Read a Unity "aligned string": an Int32 length prefix, the bytes, then align(4).
+     * Used for m_Name and m_StreamData.path inside object payloads.
+     */
+    readAlignedString() {
+        const len = this.readInt32();
+        if (len < 0 || len > this.remaining) {
+            throw new RangeError(`BinaryReader.readAlignedString: implausible length ${len} at offset ${this.pos} (remaining ${this.remaining})`);
+        }
+        const s = this.buf.toString('utf8', this.pos, this.pos + len);
+        this.pos += len;
+        this.align(4);
+        return s;
+    }
+}
+//# sourceMappingURL=binary-reader.js.map

package/dist/decoders/unity/binary-reader.js.map

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