universal-game-modder 0.1.4

package/dist/decoders/unity/mesh.js

@@ -0,0 +1,198 @@
+/**
+ * mesh.ts — parse a Unity Mesh object payload (Unity 2020.3 / format v22, typeTree DISABLED)
+ * into vertex positions/normals/uvs + triangle indices, for the PLAIN (uncompressed) case.
+ *
+ * SCOPE (first slice, deliberately bounded):
+ *   - Plain meshes only: m_MeshCompression == 0. A compressed mesh (PackedBitVector) is
+ *     detected and reported as unsupported (the caller writes a noted decoded=0 row) — NOT
+ *     mis-parsed. Skinned/blend-shape extras are skipped (we read past them), but positions,
+ *     normals, uvs, and the index buffer are extracted.
+ *
+ * Reference field order: Unity 2020.3 Mesh (AssetStudio Mesh.cs), little-endian, no type tree.
+ * The layout below is the 2020.3-era order. Because there is NO type tree to self-describe the
+ * fields, this is positional — every array is length-prefixed (Int32) and we read or skip each
+ * in order. A field-order miss is caught by sanity bounds (implausible counts throw) rather than
+ * silently producing garbage geometry.
+ *
+ * Field order (2020.3, condensed — arrays are Int32-count-prefixed unless noted):
+ *   m_Name : AlignedString
+ *   m_SubMeshes : count * SubMesh{ firstByte:u32, indexCount:u32, topology:i32, baseVertex:u32,
+ *                                  firstVertex:u32, vertexCount:u32, localAABB:{center:3f, extent:3f} }
+ *   m_Shapes (BlendShapeData) : vertices[] + shapes[] + channels[] + fullWeights[]  (skipped)
+ *   m_BindPose : count * 16 floats (Matrix4x4)   (skipped)
+ *   m_BoneNameHashes : count * u32               (skipped)
+ *   m_RootBoneNameHash : u32
+ *   m_BonesAABB : count * (6 floats)   (2019+)   (skipped)
+ *   m_VariableBoneCountWeights : count * u32     (2019+) (skipped)
+ *   m_MeshCompression : u8
+ *   m_IsReadable : u8 ; m_KeepVertices : u8 ; m_KeepIndices : u8 ; align(4)
+ *   m_IndexFormat : i32   (0 = UInt16, 1 = UInt32)   (2017.4+)
+ *   m_IndexBuffer : count(u32) * byte ; align(4)
+ *   m_VertexData : { m_CurrentChannels?(pre-2018) , m_VertexCount:u32, m_Channels[]:ChannelInfo,
+ *                    m_DataSize: count*byte ; align(4) }
+ *   ... (compression-related PackedBitVectors, m_StreamData at the end)
+ *   m_StreamData : { offset:u32(or u64 late), size:u32, path:AlignedString }  (NOT consumed in this slice)
+ */
+import { BinaryReader } from './binary-reader.js';
+import { extractAttribute } from './vertex-data.js';
+const MAX_COUNT = 50_000_000; // sanity bound for any length-prefixed array
+function readCount(r, what) {
+    const n = r.readInt32();
+    if (n < 0 || n > MAX_COUNT) {
+        throw new RangeError(`mesh: implausible ${what} count ${n} at offset ${r.pos} — field-order mismatch`);
+    }
+    return n;
+}
+export function parseMesh(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(`parseMesh: object range [${start}, ${end}] outside buffer ${buf.length}`);
+    }
+    const r = new BinaryReader(buf.subarray(start, end), !little, 0);
+    const name = r.readAlignedString();
+    // --- m_SubMeshes ---
+    const subMeshCount = readCount(r, 'subMesh');
+    const subMeshes = [];
+    for (let i = 0; i < subMeshCount; i++) {
+        const firstByte = r.readUInt32();
+        const indexCount = r.readUInt32();
+        const topology = r.readInt32();
+        /* baseVertex */ r.readUInt32();
+        const firstVertex = r.readUInt32();
+        const vertexCount = r.readUInt32();
+        // localAABB: Vector3 center + Vector3 extent (6 floats)
+        r.skip(6 * 4);
+        subMeshes.push({ firstByte, indexCount, topology, firstVertex, vertexCount });
+    }
+    // --- m_Shapes (BlendShapeData) : skip the four arrays ---
+    skipBlendShapeData(r);
+    // --- m_BindPose : count * Matrix4x4 (16 floats) ---
+    const bindPoseCount = readCount(r, 'bindPose');
+    r.skip(bindPoseCount * 16 * 4);
+    // --- m_BoneNameHashes : count * u32 ---
+    const boneNameCount = readCount(r, 'boneNameHash');
+    r.skip(boneNameCount * 4);
+    // --- m_RootBoneNameHash : u32 ---
+    r.readUInt32();
+    // --- m_BonesAABB : count * (Vector3 min + Vector3 max = 6 floats) (2019+) ---
+    const bonesAABBCount = readCount(r, 'bonesAABB');
+    r.skip(bonesAABBCount * 6 * 4);
+    // --- m_VariableBoneCountWeights : count * u32 (2019+) ---
+    const vbcwCount = readCount(r, 'variableBoneCountWeights');
+    r.skip(vbcwCount * 4);
+    // --- compression + flags ---
+    const meshCompression = r.readUInt8();
+    /* m_IsReadable */ r.readUInt8();
+    /* m_KeepVertices */ r.readUInt8();
+    /* m_KeepIndices */ r.readUInt8();
+    r.align(4);
+    const compressed = meshCompression !== 0;
+    // --- m_IndexFormat (2017.4+): 0 = UInt16, 1 = UInt32 ---
+    const indexFormat = r.readInt32();
+    // --- m_IndexBuffer ---
+    const indexBufLen = readCount(r, 'indexBuffer');
+    const indexBytes = Buffer.from(r.readBytes(indexBufLen));
+    r.align(4);
+    // If compressed, the vertex data lives in PackedBitVectors we don't unpack in this slice.
+    // Bail early with the metadata we have; the caller records a noted decoded=0 row.
+    if (compressed) {
+        return {
+            name,
+            compressed: true,
+            vertexCount: 0,
+            positions: null,
+            normals: null,
+            uvs: null,
+            indices: new Uint32Array(0),
+            subMeshCount,
+            attributesExported: [],
+        };
+    }
+    // --- m_VertexData ---
+    const vertexCount = r.readUInt32();
+    const channelCount = readCount(r, 'vertexChannel');
+    const channels = [];
+    for (let i = 0; i < channelCount; i++) {
+        const stream = r.readUInt8();
+        const offset = r.readUInt8();
+        const format = r.readUInt8();
+        const dimension = r.readUInt8();
+        channels.push({ stream, offset, format, dimension });
+    }
+    const dataSize = readCount(r, 'vertexDataSize');
+    let vertexBlob = Buffer.from(r.readBytes(dataSize));
+    r.align(4);
+    // Vertex data: for Baldi (verified) the vertex blob is INLINE, so it is populated above and
+    // attributes extract directly. STREAMED vertex data (when m_DataSize is empty and the bytes
+    // live in a sibling .resS via m_StreamData) is NOT implemented in this slice: we do not read
+    // m_StreamData here, the blob stays empty, positions come back null, and decode_assets writes
+    // a noted decoded=0 row ("streamed vertex data not yet supported"). A future slice will add
+    // the .resS resolution for meshes (textures already do this via ResSReader).
+    const vd = { vertexCount, channels, data: vertexBlob };
+    // Unity channel index convention: 0=Position, 1=Normal, 2=Tangent, 3=Color, 4=UV0, 5=UV1...
+    const positions = extractAttribute(vd, 0, 3);
+    const normals = extractAttribute(vd, 1, 3);
+    const uvs = extractAttribute(vd, 4, 2);
+    const attributesExported = [];
+    if (positions)
+        attributesExported.push('POSITION');
+    if (normals)
+        attributesExported.push('NORMAL');
+    if (uvs)
+        attributesExported.push('TEXCOORD_0');
+    // --- indices: decode per m_IndexFormat ---
+    const indices = decodeIndices(indexBytes, indexFormat);
+    return {
+        name,
+        compressed: false,
+        vertexCount,
+        positions,
+        normals,
+        uvs,
+        indices,
+        subMeshCount,
+        attributesExported,
+    };
+}
+/** Skip Unity's BlendShapeData block (4 length-prefixed arrays). */
+function skipBlendShapeData(r) {
+    // m_Vertices : count * BlendShapeVertex (Vector3 vertex + Vector3 normal + Vector3 tangent + u32 index = 10*4)
+    const vCount = readCount(r, 'blendVertices');
+    r.skip(vCount * (9 * 4 + 4));
+    // m_Shapes : count * MeshBlendShape (firstVertex:u32, vertexCount:u32, hasNormals:bool, hasTangents:bool, align)
+    const sCount = readCount(r, 'blendShapes');
+    for (let i = 0; i < sCount; i++) {
+        r.skip(4 + 4); // firstVertex + vertexCount
+        r.readUInt8(); // hasNormals
+        r.readUInt8(); // hasTangents
+        r.align(4);
+    }
+    // m_Channels : count * MeshBlendShapeChannel (name:AlignedString, nameHash:u32, frameIndex:i32, frameCount:i32)
+    const cCount = readCount(r, 'blendChannels');
+    for (let i = 0; i < cCount; i++) {
+        r.readAlignedString();
+        r.skip(4 + 4 + 4);
+    }
+    // m_FullWeights : count * float
+    const wCount = readCount(r, 'blendWeights');
+    r.skip(wCount * 4);
+}
+/** Decode the index buffer into a flat Uint32Array per m_IndexFormat (0=u16, 1=u32). */
+function decodeIndices(indexBytes, indexFormat) {
+    if (indexFormat === 1) {
+        const n = Math.floor(indexBytes.length / 4);
+        const out = new Uint32Array(n);
+        for (let i = 0; i < n; i++)
+            out[i] = indexBytes.readUInt32LE(i * 4);
+        return out;
+    }
+    // default UInt16
+    const n = Math.floor(indexBytes.length / 2);
+    const out = new Uint32Array(n);
+    for (let i = 0; i < n; i++)
+        out[i] = indexBytes.readUInt16LE(i * 2);
+    return out;
+}
+//# sourceMappingURL=mesh.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * ress-reader.ts — resolve a Texture2D's StreamingInfo to its raw bytes.
+ *
+ * Unity stores most texture pixels in a sibling stream file (.resS / .resource) and
+ * references them from the .assets object via m_StreamData { offset, size, path }.
+ * The `path` takes one of two shapes:
+ *   - "archive:/<something>/<file>.resS"  (bundle-style virtual path; we use the basename)
+ *   - "<file>.resS"                        (plain sibling filename)
+ * Either way the real bytes live in a file next to the .assets in the same directory.
+ *
+ * This reader opens the stream file and slices [offset, offset+size). It caches open
+ * file handles per stream file so decoding hundreds of textures from one .resS doesn't
+ * re-open it hundreds of times. Read-only: it never writes.
+ */
+import type { StreamingInfo } from './texture2d.js';
+export declare class ResSReader {
+    /** directory containing the .assets file (where sibling .resS/.resource live). */
+    private readonly dir;
+    private readonly handles;
+    private readonly sizes;
+    constructor(assetsFilePath: string);
+    /** Map a StreamData.path to an on-disk file path next to the .assets. */
+    private resolvePath;
+    private handleFor;
+    /**
+     * Read the bytes a StreamingInfo points at. Returns null (with no throw) when the
+     * stream file is missing or the range is out of bounds — the caller records a noted
+     * decoded=0 row rather than aborting the run.
+     */
+    read(stream: StreamingInfo): Buffer | null;
+    /** Close all cached handles. Call once when decoding for an .assets is done. */
+    close(): void;
+}

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

@@ -0,0 +1,82 @@
+/**
+ * ress-reader.ts — resolve a Texture2D's StreamingInfo to its raw bytes.
+ *
+ * Unity stores most texture pixels in a sibling stream file (.resS / .resource) and
+ * references them from the .assets object via m_StreamData { offset, size, path }.
+ * The `path` takes one of two shapes:
+ *   - "archive:/<something>/<file>.resS"  (bundle-style virtual path; we use the basename)
+ *   - "<file>.resS"                        (plain sibling filename)
+ * Either way the real bytes live in a file next to the .assets in the same directory.
+ *
+ * This reader opens the stream file and slices [offset, offset+size). It caches open
+ * file handles per stream file so decoding hundreds of textures from one .resS doesn't
+ * re-open it hundreds of times. Read-only: it never writes.
+ */
+import { openSync, readSync, closeSync, existsSync, statSync } from 'fs';
+import { basename, dirname, join } from 'path';
+export class ResSReader {
+    /** directory containing the .assets file (where sibling .resS/.resource live). */
+    dir;
+    handles = new Map();
+    sizes = new Map();
+    constructor(assetsFilePath) {
+        this.dir = dirname(assetsFilePath);
+    }
+    /** Map a StreamData.path to an on-disk file path next to the .assets. */
+    resolvePath(streamPath) {
+        // Normalize separators, take the basename (handles "archive:/.../file.resS").
+        const norm = streamPath.replace(/\\/g, '/');
+        const name = basename(norm);
+        return join(this.dir, name);
+    }
+    handleFor(filePath) {
+        const cached = this.handles.get(filePath);
+        if (cached !== undefined)
+            return cached;
+        if (!existsSync(filePath)) {
+            this.handles.set(filePath, -1);
+            return null;
+        }
+        const fd = openSync(filePath, 'r');
+        this.handles.set(filePath, fd);
+        this.sizes.set(filePath, statSync(filePath).size);
+        return fd;
+    }
+    /**
+     * Read the bytes a StreamingInfo points at. Returns null (with no throw) when the
+     * stream file is missing or the range is out of bounds — the caller records a noted
+     * decoded=0 row rather than aborting the run.
+     */
+    read(stream) {
+        const filePath = this.resolvePath(stream.path);
+        const fd = this.handleFor(filePath);
+        if (fd === null || fd < 0)
+            return null;
+        const fileSize = this.sizes.get(filePath) ?? 0;
+        const offset = Number(stream.offset);
+        const size = stream.size;
+        if (offset < 0 || size <= 0 || offset + size > fileSize)
+            return null;
+        const buf = Buffer.allocUnsafe(size);
+        const got = readSync(fd, buf, 0, size, offset);
+        if (got !== size)
+            return null;
+        return buf;
+    }
+    /** Close all cached handles. Call once when decoding for an .assets is done. */
+    close() {
+        for (const fd of this.handles.values()) {
+            if (fd >= 0) {
+                try {
+                    closeSync(fd);
+                }
+                catch {
+                    /* best effort */
+                }
+            }
+        }
+        this.handles.clear();
+        this.sizes.clear();
+    }
+}
+//# sourceMappingURL=ress-reader.js.map

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

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

package/dist/decoders/unity/serialized-file.d.ts

@@ -0,0 +1,65 @@
+/**
+ * serialized-file.ts — a bounded parser for Unity serialized files (.assets), format v22.
+ *
+ * SCOPE (deliberately narrow, per PR-2): parse the file-level structures needed to
+ * locate objects by class — header, type tree table (we only need the per-type classID),
+ * and the object table (path id, byte start/size, type index). We do NOT parse the full
+ * recursive type tree into typed fields; object payloads are parsed by class-specific
+ * readers (see texture2d.ts) using the byte ranges this module yields.
+ *
+ * Format reference: UnityFS SerializedFile, version 22 (LargeFilesSupport), as shipped by
+ * Unity 2020.3.x desktop players. Verified against Baldi's Basics Plus (2020.3.49f1):
+ *   - header is BIG-endian; metadata endianness is declared by header.m_Endianess.
+ *   - v>=22 uses a 64-bit metadata/file-size/data-offset layout with a relocated header.
+ *
+ * Anti-silent-corruption: every read goes through BinaryReader's bounds checks. A parse
+ * that runs off the rails throws with the exact offset, never returns plausible garbage.
+ */
+/** Header of a serialized file (the v22 large-files layout). */
+export interface SerializedFileHeader {
+    metadataSize: number;
+    fileSize: bigint;
+    version: number;
+    dataOffset: bigint;
+    endianess: number;
+    unityVersion: string;
+    targetPlatform: number;
+    enableTypeTree: boolean;
+}
+/** A serialized type entry — we keep only what object location needs. */
+export interface SerializedType {
+    classID: number;
+    isStrippedType: boolean;
+    scriptTypeIndex: number;
+}
+/** One object in the file's object table. */
+export interface ObjectInfo {
+    pathID: bigint;
+    byteStart: bigint;
+    byteSize: number;
+    typeIndex: number;
+    classID: number;
+}
+export interface ParsedSerializedFile {
+    header: SerializedFileHeader;
+    types: SerializedType[];
+    objects: ObjectInfo[];
+    /** the whole file buffer, retained so object payloads can be sliced on demand. */
+    buf: Buffer;
+}
+/** Unity ClassIDType values this PR cares about. (Full table lives in the decoder lib.) */
+export declare const ClassID: {
+    readonly Texture2D: 28;
+    readonly Sprite: 213;
+    readonly TextAsset: 49;
+    readonly AudioClip: 83;
+    readonly Mesh: 43;
+    readonly Shader: 48;
+    readonly Font: 128;
+    readonly Material: 21;
+};
+/**
+ * Parse a serialized file far enough to enumerate its objects by class.
+ * Throws on any structural inconsistency (never returns a half-parsed result).
+ */
+export declare function parseSerializedFile(buf: Buffer): ParsedSerializedFile;

package/dist/decoders/unity/serialized-file.js

@@ -0,0 +1,144 @@
+/**
+ * serialized-file.ts — a bounded parser for Unity serialized files (.assets), format v22.
+ *
+ * SCOPE (deliberately narrow, per PR-2): parse the file-level structures needed to
+ * locate objects by class — header, type tree table (we only need the per-type classID),
+ * and the object table (path id, byte start/size, type index). We do NOT parse the full
+ * recursive type tree into typed fields; object payloads are parsed by class-specific
+ * readers (see texture2d.ts) using the byte ranges this module yields.
+ *
+ * Format reference: UnityFS SerializedFile, version 22 (LargeFilesSupport), as shipped by
+ * Unity 2020.3.x desktop players. Verified against Baldi's Basics Plus (2020.3.49f1):
+ *   - header is BIG-endian; metadata endianness is declared by header.m_Endianess.
+ *   - v>=22 uses a 64-bit metadata/file-size/data-offset layout with a relocated header.
+ *
+ * Anti-silent-corruption: every read goes through BinaryReader's bounds checks. A parse
+ * that runs off the rails throws with the exact offset, never returns plausible garbage.
+ */
+import { BinaryReader } from './binary-reader.js';
+/** Unity ClassIDType values this PR cares about. (Full table lives in the decoder lib.) */
+export const ClassID = {
+    Texture2D: 28,
+    Sprite: 213,
+    TextAsset: 49,
+    AudioClip: 83,
+    Mesh: 43,
+    Shader: 48,
+    Font: 128,
+    Material: 21,
+};
+/**
+ * Parse a serialized file far enough to enumerate its objects by class.
+ * Throws on any structural inconsistency (never returns a half-parsed result).
+ */
+export function parseSerializedFile(buf) {
+    // ---- Header (big-endian) ----------------------------------------------------
+    const r = new BinaryReader(buf, /* bigEndian */ true, 0);
+    // legacy 32-bit header fields (kept for all versions)
+    /* metadataSize (legacy) */ r.readUInt32();
+    /* fileSize     (legacy) */ r.readUInt32();
+    const version = r.readUInt32();
+    /* dataOffset   (legacy) */ r.readUInt32();
+    if (version < 22) {
+        throw new Error(`serialized-file: unsupported format version ${version}; this PR targets v22 (Unity 2020.3+). ` +
+            `Older versions need the 32-bit header path (future slice).`);
+    }
+    // v>=22 large-files header: endianess byte + 3 reserved, then 64-bit sizes.
+    const endianess = r.readUInt8();
+    r.skip(3); // reserved
+    const metadataSize = r.readUInt32(); // still 32-bit count, but...
+    const fileSize = r.readUInt64();
+    const dataOffset = r.readUInt64();
+    r.readUInt64(); // unknown / reserved (large-files)
+    // ---- Metadata (endianness from header) -------------------------------------
+    const little = endianess === 0;
+    const m = new BinaryReader(buf, /* bigEndian */ !little, r.pos);
+    const unityVersion = m.readCString();
+    const targetPlatform = m.readInt32();
+    const enableTypeTree = m.readUInt8() !== 0;
+    // ---- Type table ------------------------------------------------------------
+    const typeCount = m.readInt32();
+    const types = [];
+    for (let i = 0; i < typeCount; i++) {
+        types.push(readSerializedType(m, enableTypeTree, /* isRefType */ false));
+    }
+    // ---- Object table ----------------------------------------------------------
+    const objectCount = m.readInt32();
+    const objects = [];
+    for (let i = 0; i < objectCount; i++) {
+        m.align(4);
+        const pathID = m.readInt64();
+        const byteStart = m.readInt64();
+        const byteSize = m.readUInt32();
+        const typeIndex = m.readInt32();
+        const t = types[typeIndex];
+        const classID = t ? t.classID : -1;
+        objects.push({ pathID, byteStart, byteSize, typeIndex, classID });
+    }
+    return {
+        header: {
+            metadataSize,
+            fileSize,
+            version,
+            dataOffset,
+            endianess,
+            unityVersion,
+            targetPlatform,
+            enableTypeTree,
+        },
+        types,
+        objects,
+        buf,
+    };
+}
+/**
+ * Read one SerializedType for v22. We extract classID and skip the rest precisely.
+ * Layout (v>=16 RefactoredClassId, with v17+/v18+/v19+/v21+ deltas folded in):
+ *   classID            : Int32
+ *   isStrippedType     : UInt8           (v>=16)
+ *   scriptTypeIndex    : Int16           (v>=17)
+ *   scriptID (16 bytes) : present when classID == 114 (MonoBehaviour)
+ *   oldTypeHash (16 bytes)
+ *   [typeTree blob]    : present when enableTypeTree
+ *   typeDependencies   : Int32 count + count*Int32   (v>=21, non-refType)
+ */
+function readSerializedType(m, enableTypeTree, isRefType) {
+    const classID = m.readInt32();
+    const isStrippedType = m.readUInt8() !== 0;
+    const scriptTypeIndex = m.readInt16();
+    // ScriptID (Hash128) only for MonoBehaviour (114), or refType always.
+    if (isRefType || classID === 114) {
+        m.skip(16);
+    }
+    // OldTypeHash (Hash128)
+    m.skip(16);
+    if (enableTypeTree) {
+        skipTypeTreeBlob(m);
+        if (!isRefType) {
+            // typeDependencies (v>=21)
+            const depCount = m.readInt32();
+            m.skip(depCount * 4);
+        }
+    }
+    return { classID, isStrippedType, scriptTypeIndex };
+}
+/**
+ * Skip the blob-format type tree (v>=12). Layout:
+ *   nodeCount   : Int32
+ *   stringBufLen: Int32
+ *   nodes       : nodeCount * 32 bytes  (v>=19 TypeTreeNodeWithTypeFlags = 32 bytes/node)
+ *   stringBuf   : stringBufLen bytes
+ * v18 introduced the blob format; the node struct is 24 bytes pre-v19 and 32 bytes v>=19.
+ * Baldi is v22 -> 32-byte nodes. We only need to SKIP it precisely so the object table
+ * lands at the right offset.
+ */
+function skipTypeTreeBlob(m) {
+    const nodeCount = m.readInt32();
+    const stringBufLen = m.readInt32();
+    // v>=19 node is 32 bytes: version(u16) level(u8) typeFlags(u8) typeStrOffset(u32)
+    //   nameStrOffset(u32) byteSize(i32) index(i32) metaFlag(u32) refTypeHash(u64)
+    const NODE_SIZE = 32;
+    m.skip(nodeCount * NODE_SIZE);
+    m.skip(stringBufLen);
+}
+//# sourceMappingURL=serialized-file.js.map