rbx-api-ts 1.6.9

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,24 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

package/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "npm" 
+    directory: "/"
+    schedule:
+      interval: "daily"

package/README.md

@@ -0,0 +1,13 @@
+# rbx-reader
+A module that allows for reading of `.rbxm` and `.rbxl` files.
+
+**Huge thanks to @shiinazzz for helping to get the code into useful TypeScript form.**
+
+## Usage
+Basic reading:
+```js
+const fs = require("node:fs")
+const reader = require("rbx-reader")
+const buf = fs.readFileSync("./path/to/roblox/file.rbxm") // Can also be an .rbxl
+const result = reader.parseFile(buf)
+```

package/dist/BinaryParser.d.ts

@@ -0,0 +1,29 @@
+import ByteReader from './ByteReader';
+import { Instance, InstanceRoot } from './Instance';
+export interface ParserResult {
+    result: InstanceRoot;
+    reader: ByteReader;
+    instances: Instance[];
+    groups: Group[];
+    sharedStrings: string[];
+    meta: object;
+    arrays: any[][];
+    arrayIndex: number;
+}
+export interface Group {
+    ClassName: string;
+    Objects: Instance[];
+}
+declare const BinaryParser: {
+    HeaderBytes: number[];
+    Faces: number[][];
+    DataTypes: (string | null)[];
+    parse(buffer: ArrayBuffer): ParserResult;
+    parseChunk(parser: ParserResult, startIndex: number): void;
+    parseMETA(parser: any, chunk: any): void;
+    parseSSTR(parser: any, chunk: any): void;
+    parseINST(parser: any, chunk: any): void;
+    parsePROP(parser: any, chunk: any): void;
+    parsePRNT(parser: any, chunk: any): void;
+};
+export default BinaryParser;

package/dist/BinaryParser.js

@@ -0,0 +1,539 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ByteReader_1 = __importDefault(require("./ByteReader"));
+const Instance_1 = require("./Instance");
+const attributes_parser_1 = require("./attributes-parser/attributes_parser");
+const BinaryParser = {
+    HeaderBytes: [0x3C, 0x72, 0x6F, 0x62, 0x6C, 0x6F, 0x78, 0x21, 0x89, 0xFF, 0x0D, 0x0A, 0x1A, 0x0A, 0x00, 0x00],
+    Faces: [[1, 0, 0], [0, 1, 0], [0, 0, 1], [-1, 0, 0], [0, -1, 0], [0, 0, -1]],
+    DataTypes: [
+        null, 'string', 'bool', 'int', 'float', 'double', 'UDim', 'UDim2', // 7
+        'Ray', 'Faces', 'Axes', 'BrickColor', 'Color3', 'Vector2', 'Vector3', 'Vector2int16', // 15
+        'CFrame', 'Quaternion', 'Enum', 'Instance', 'Vector3int16', 'NumberSequence', 'ColorSequence', // 22
+        'NumberRange', 'Rect2D', 'PhysicalProperties', 'Color3uint8', 'int64', 'SharedString', 'UnknownScriptFormat', // 29
+        'Optional', 'UniqueId'
+    ],
+    parse(buffer) {
+        const reader = new ByteReader_1.default(buffer);
+        if (!reader.Match(this.HeaderBytes)) {
+            throw new Error('[RobloxBinaryParser] Header bytes did not match (Did binary format change?)');
+        }
+        const groupsCount = reader.UInt32LE();
+        const instancesCount = reader.UInt32LE();
+        reader.Jump(8);
+        const parser = {
+            result: new Instance_1.InstanceRoot(),
+            reader: reader,
+            instances: [],
+            groups: [],
+            sharedStrings: [],
+            meta: {},
+            arrays: [],
+            arrayIndex: 0,
+        };
+        for (var i = 0; i < 6; i++) {
+            parser.arrays.push(new Array(256));
+        }
+        reader.GetIndex();
+        var maxChunkSize = 0;
+        var chunkIndices = [];
+        while (reader.GetRemaining() >= 4) {
+            chunkIndices.push(reader.GetIndex());
+            reader.String(4);
+            const comLength = reader.UInt32LE();
+            const decomLength = reader.UInt32LE();
+            if (comLength > 0) {
+                reader.Jump(4 + comLength);
+                if (decomLength > maxChunkSize) {
+                    maxChunkSize = decomLength;
+                }
+            }
+            else {
+                reader.Jump(4 + decomLength);
+            }
+        }
+        reader.chunkBuffer = new Uint8Array(maxChunkSize);
+        for (const startIndex of chunkIndices) {
+            this.parseChunk(parser, startIndex);
+        }
+        return parser;
+    },
+    parseChunk(parser, startIndex) {
+        parser.reader.SetIndex(startIndex);
+        const chunkType = parser.reader.String(4);
+        if (chunkType === 'END\0') {
+            return;
+        }
+        const chunkData = parser.reader.LZ4(parser.reader.chunkBuffer);
+        const chunkReader = new ByteReader_1.default(chunkData);
+        parser.arrayIndex = 0;
+        switch (chunkType) {
+            case 'INST':
+                this.parseINST(parser, chunkReader);
+                break;
+            case 'PROP':
+                this.parsePROP(parser, chunkReader);
+                break;
+            case 'PRNT':
+                this.parsePRNT(parser, chunkReader);
+                break;
+            case 'SSTR':
+                this.parseSSTR(parser, chunkReader);
+                break;
+            case 'META':
+                this.parseMETA(parser, chunkReader);
+                break;
+            case 'SIGN':
+                break;
+            default:
+        }
+    },
+    parseMETA(parser, chunk) {
+        const numEntries = chunk.UInt32LE();
+        for (var i = 0; i < numEntries; i++) {
+            const key = chunk.String(chunk.UInt32LE());
+            const value = chunk.String(chunk.UInt32LE());
+            parser.meta[key] = value;
+        }
+    },
+    parseSSTR(parser, chunk) {
+        chunk.UInt32LE(); // version
+        const stringCount = chunk.UInt32LE();
+        for (var i = 0; i < stringCount; i++) {
+            const md5 = chunk.Array(16);
+            const length = chunk.UInt32LE();
+            const value = chunk.String(length);
+            parser.sharedStrings[i] = { md5, value };
+        }
+    },
+    parseINST(parser, chunk) {
+        const groupId = chunk.UInt32LE();
+        const className = chunk.String(chunk.UInt32LE());
+        chunk.Byte(); // isService
+        const instCount = chunk.UInt32LE();
+        const instIds = chunk.RBXInterleavedInt32(instCount, parser.arrays[parser.arrayIndex++]);
+        const group = parser.groups[groupId] = {
+            ClassName: className,
+            Objects: []
+        };
+        var instId = 0;
+        for (var i = 0; i < instCount; i++) {
+            instId += instIds[i];
+            group.Objects.push(parser.instances[instId] = Instance_1.Instance.new(className));
+        }
+    },
+    parsePROP(parser, chunk) {
+        const group = parser.groups[chunk.UInt32LE()];
+        const prop = chunk.String(chunk.UInt32LE());
+        if (chunk.GetRemaining() <= 0) {
+            return; // empty chunk?
+        }
+        const instCount = group.Objects.length;
+        const values = parser.arrays[parser.arrayIndex++];
+        var dataType = chunk.Byte();
+        var typeName = this.DataTypes[dataType];
+        var isOptional = typeName === 'Optional';
+        if (isOptional) {
+            dataType = chunk.Byte();
+            typeName = this.DataTypes[dataType];
+        }
+        var resultTypeName = typeName || 'Unknown';
+        switch (typeName) {
+            case 'string':
+                for (var i = 0; i < instCount; i++) {
+                    const len = chunk.UInt32LE();
+                    values[i] = chunk.String(len);
+                }
+                break;
+            case 'bool':
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = chunk.Byte() !== 0;
+                }
+                break;
+            case 'int':
+                chunk.RBXInterleavedInt32(instCount, values);
+                break;
+            case 'float':
+                chunk.RBXInterleavedFloat(instCount, values);
+                break;
+            case 'double':
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = chunk.DoubleLE();
+                }
+                break;
+            case 'UDim': {
+                const scale = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const offset = chunk.RBXInterleavedInt32(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [scale[i], offset[i]];
+                }
+                break;
+            }
+            case 'UDim2': {
+                const scaleX = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const scaleY = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const offsetX = chunk.RBXInterleavedInt32(instCount, parser.arrays[parser.arrayIndex++]);
+                const offsetY = chunk.RBXInterleavedInt32(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [
+                        [scaleX[i], offsetX[i]],
+                        [scaleY[i], offsetY[i]]
+                    ];
+                }
+                break;
+            }
+            case 'Ray': {
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [
+                        [chunk.RBXFloatLE(), chunk.RBXFloatLE(), chunk.RBXFloatLE()],
+                        [chunk.RBXFloatLE(), chunk.RBXFloatLE(), chunk.RBXFloatLE()]
+                    ];
+                }
+                break;
+            }
+            case 'Faces':
+                for (var i = 0; i < instCount; i++) {
+                    const data = chunk.Byte();
+                    values[i] = {
+                        Right: !!(data & 1),
+                        Top: !!(data & 2),
+                        Back: !!(data & 4),
+                        Left: !!(data & 8),
+                        Bottom: !!(data & 16),
+                        Front: !!(data & 32)
+                    };
+                }
+                break;
+            case 'Axes':
+                for (var i = 0; i < instCount; i++) {
+                    const data = chunk.Byte();
+                    values[i] = {
+                        X: !!(data & 1),
+                        Y: !!(data & 2),
+                        Z: !!(data & 4)
+                    };
+                }
+                break;
+            case 'BrickColor':
+                chunk.RBXInterleavedUint32(instCount, values);
+                break;
+            case 'Color3': {
+                const red = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const green = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const blue = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [red[i], green[i], blue[i]];
+                }
+                break;
+            }
+            case 'Vector2': {
+                const vecX = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const vecY = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [vecX[i], vecY[i]];
+                }
+                break;
+            }
+            case 'Vector3': {
+                const vecX = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const vecY = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const vecZ = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [vecX[i], vecY[i], vecZ[i]];
+                }
+                break;
+            }
+            case 'Vector2int16': break; // Not used anywhere?
+            case 'CFrame': {
+                for (var vi = 0; vi < instCount; vi++) {
+                    const value = values[vi] = [0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1];
+                    const type = chunk.Byte();
+                    if (type !== 0) {
+                        const right = this.Faces[Math.floor((type - 1) / 6)];
+                        const up = this.Faces[Math.floor(type - 1) % 6];
+                        const back = [
+                            right[1] * up[2] - up[1] * right[2],
+                            right[2] * up[0] - up[2] * right[0],
+                            right[0] * up[1] - up[0] * right[1]
+                        ];
+                        for (var i = 0; i < 3; i++) {
+                            value[3 + i * 3] = right[i];
+                            value[4 + i * 3] = up[i];
+                            value[5 + i * 3] = back[i];
+                        }
+                    }
+                    else {
+                        for (var i = 0; i < 9; i++) {
+                            value[i + 3] = chunk.FloatLE();
+                        }
+                    }
+                }
+                const vecX = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const vecY = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const vecZ = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i][0] = vecX[i];
+                    values[i][1] = vecY[i];
+                    values[i][2] = vecZ[i];
+                }
+                break;
+            }
+            // case 'Quaternion': break // Not used anywhere?
+            case 'Enum':
+                chunk.RBXInterleavedUint32(instCount, values);
+                break;
+            case 'Instance': {
+                const refIds = chunk.RBXInterleavedInt32(instCount, parser.arrays[parser.arrayIndex++]);
+                var refId = 0;
+                for (var i = 0; i < instCount; i++) {
+                    refId += refIds[i];
+                    values[i] = parser.instances[refId];
+                }
+                break;
+            }
+            case 'Vector3int16':
+                break; // Not used anywhere?
+            case 'NumberSequence': {
+                for (var i = 0; i < instCount; i++) {
+                    const seqLength = chunk.UInt32LE();
+                    const seq = values[i] = [];
+                    for (var j = 0; j < seqLength; j++) {
+                        seq.push({
+                            Time: chunk.FloatLE(),
+                            Value: chunk.FloatLE(),
+                            Envelope: chunk.FloatLE()
+                        });
+                    }
+                }
+                break;
+            }
+            case 'ColorSequence':
+                for (var i = 0; i < instCount; i++) {
+                    const seqLength = chunk.UInt32LE();
+                    const seq = values[i] = [];
+                    for (var j = 0; j < seqLength; j++) {
+                        seq.push({
+                            Time: chunk.FloatLE(),
+                            Color: [chunk.FloatLE(), chunk.FloatLE(), chunk.FloatLE()],
+                            EnvelopeMaybe: chunk.FloatLE()
+                        });
+                    }
+                }
+                break;
+            case 'NumberRange':
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = {
+                        Min: chunk.FloatLE(),
+                        Max: chunk.FloatLE()
+                    };
+                }
+                break;
+            case 'Rect2D': {
+                const x0 = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const y0 = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const x1 = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                const y1 = chunk.RBXInterleavedFloat(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [x0[i], y0[i], x1[i], y1[i]];
+                }
+                break;
+            }
+            case 'PhysicalProperties':
+                for (var i = 0; i < instCount; i++) {
+                    const enabled = chunk.Byte() !== 0;
+                    values[i] = {
+                        CustomPhysics: enabled,
+                        Density: enabled ? chunk.RBXFloatLE() : undefined,
+                        Friction: enabled ? chunk.RBXFloatLE() : undefined,
+                        Elasticity: enabled ? chunk.RBXFloatLE() : undefined,
+                        FrictionWeight: enabled ? chunk.RBXFloatLE() : undefined,
+                        ElasticityWeight: enabled ? chunk.RBXFloatLE() : undefined
+                    };
+                }
+                break;
+            case 'Color3uint8': {
+                const rgb = chunk.Array(instCount * 3);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = [rgb[i] / 255, rgb[i + instCount] / 255, rgb[i + instCount * 2] / 255];
+                }
+                resultTypeName = 'Color3';
+                break;
+            }
+            case 'int64': { // Two's complement
+                const bytes = chunk.Array(instCount * 8);
+                for (var i = 0; i < instCount; i++) {
+                    var byte0 = bytes[i + instCount * 0] * (256 ** 3) + bytes[i + instCount * 1] * (256 ** 2) +
+                        bytes[i + instCount * 2] * 256 + bytes[i + instCount * 3];
+                    var byte1 = bytes[i + instCount * 4] * (256 ** 3) + bytes[i + instCount * 5] * (256 ** 2) +
+                        bytes[i + instCount * 6] * 256 + bytes[i + instCount * 7];
+                    const neg = byte1 % 2;
+                    byte1 = (byte0 % 2) * (2 ** 31) + (byte1 + neg) / 2;
+                    byte0 = Math.floor(byte0 / 2);
+                    if (byte0 < 2097152) {
+                        const value = byte0 * (256 ** 4) + byte1;
+                        values[i] = String(neg ? -value : value);
+                    }
+                    else { // Slow path
+                        var result = '';
+                        while (byte1 || byte0) {
+                            const cur0 = byte0;
+                            const res0 = cur0 % 10;
+                            byte0 = (cur0 - res0) / 10;
+                            const cur1 = byte1 + res0 * (256 ** 4);
+                            const res1 = cur1 % 10;
+                            byte1 = (cur1 - res1) / 10;
+                            result = res1 + result;
+                        }
+                        values[i] = (neg ? '-' : '') + (result || '0');
+                    }
+                }
+                break;
+            }
+            case 'SharedString': {
+                const indices = chunk.RBXInterleavedUint32(instCount, parser.arrays[parser.arrayIndex++]);
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = parser.sharedStrings[indices[i]].value;
+                }
+                break;
+            }
+            case 'UniqueId': {
+                const bytes = chunk.Array(instCount * 16);
+                for (var i = 0; i < instCount; i++) {
+                    var result = '';
+                    for (var j = 0; j < 16; j++) {
+                        const byte = bytes[j * instCount + i];
+                        result += ('0' + byte.toString(16)).slice(-2);
+                    }
+                    values[i] = result;
+                }
+                break;
+            }
+            default:
+                if (!typeName) {
+                    // console.warn(`[RobloxBinaryParser] Unknown dataType 0x${dataType.toString(16).toUpperCase()} (${dataType}) for ${group.ClassName}.${prop}`)
+                }
+                else {
+                    // console.warn(`[RobloxBinaryParser] Unimplemented dataType '${typeName}' for ${group.ClassName}.${prop}`)
+                }
+                break;
+            case 'UnknownScriptFormat':
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = `<${typeName || 'Unknown'}>`;
+                }
+                break;
+        }
+        if (isOptional) {
+            if (this.DataTypes[chunk.Byte()] !== 'bool' || chunk.GetRemaining() !== instCount) {
+                // console.warn(`[RobloxBinaryParser] Missing byte array at end of optional`)
+                isOptional = false;
+                for (var i = 0; i < instCount; i++) {
+                    values[i] = `<Optional>`;
+                }
+            }
+        }
+        for (var index = 0; index < instCount; index++) {
+            if (isOptional)
+                if (chunk.Byte() === 0)
+                    continue;
+            if (prop == 'AttributesSerialize') {
+                try {
+                    const result = (0, attributes_parser_1.parse_attrs)(Buffer.from(values[index]));
+                    const Attributes = {};
+                    result.forEach((v, k) => {
+                        Attributes[k] = v;
+                    });
+                    const finalAttrs = {};
+                    Object.keys(Attributes).forEach(k => {
+                        const v = Attributes[k];
+                        if (Instance_1.AttrAssertions.isBoolAttr(v))
+                            finalAttrs[k] = v.Bool;
+                        else if (Instance_1.AttrAssertions.isStringAttr(v))
+                            finalAttrs[k] = v.BinaryString;
+                        else if (Instance_1.AttrAssertions.isNumberSequenceAttr(v))
+                            finalAttrs[k] = v.NumberSequence;
+                        else if (Instance_1.AttrAssertions.isRectAttr(v))
+                            finalAttrs[k] = v.Rect;
+                        else if (Instance_1.AttrAssertions.isCFrameAttr(v))
+                            finalAttrs[k] = v.CFrame;
+                        else if (Instance_1.AttrAssertions.isNumberRangeAttr(v))
+                            finalAttrs[k] = {
+                                lower: v.NumberRange[0],
+                                upper: v.NumberRange[1]
+                            };
+                        else if (Instance_1.AttrAssertions.isColorSequenceAttr(v))
+                            finalAttrs[k] = v.ColorSequence;
+                        else if (Instance_1.AttrAssertions.isVector3Attr(v))
+                            finalAttrs[k] = {
+                                x: v.Vector3[0],
+                                y: v.Vector3[1],
+                                z: v.Vector3[2]
+                            };
+                        else if (Instance_1.AttrAssertions.isUDim2Attr(v))
+                            finalAttrs[k] = {
+                                x: {
+                                    scale: v.UDim2[0][0],
+                                    offset: v.UDim2[0][1]
+                                },
+                                y: {
+                                    scale: v.UDim2[1][0],
+                                    offset: v.UDim2[1][1]
+                                }
+                            };
+                        else if (Instance_1.AttrAssertions.isVector2Attr(v))
+                            finalAttrs[k] = {
+                                x: v.Vector2[0],
+                                y: v.Vector2[1]
+                            };
+                        else if (Instance_1.AttrAssertions.isColor3Attr(v))
+                            finalAttrs[k] = {
+                                r: v.Color3[0],
+                                g: v.Color3[1],
+                                b: v.Color3[2]
+                            };
+                        else if (Instance_1.AttrAssertions.isNumberAttr(v))
+                            finalAttrs[k] = v.Float64;
+                        else if (Instance_1.AttrAssertions.isUDimAttr(v))
+                            finalAttrs[k] = {
+                                scale: v.UDim[0],
+                                offset: v.UDim[1]
+                            };
+                        else if (Instance_1.AttrAssertions.isBrickColorAttr(v))
+                            finalAttrs[k] = {
+                                ...v
+                            };
+                    });
+                    group.Objects[index].Attributes = finalAttrs;
+                }
+                catch {
+                    group.Objects[index].setProperty(prop, values[index], resultTypeName);
+                }
+            }
+            else {
+                group.Objects[index].setProperty(prop, values[index], resultTypeName);
+            }
+        }
+    },
+    parsePRNT(parser, chunk) {
+        chunk.Byte();
+        const parentCount = chunk.UInt32LE();
+        const childIds = chunk.RBXInterleavedInt32(parentCount, parser.arrays[parser.arrayIndex++]);
+        const parentIds = chunk.RBXInterleavedInt32(parentCount, parser.arrays[parser.arrayIndex++]);
+        var childId = 0;
+        var parentId = 0;
+        for (var i = 0; i < parentCount; i++) {
+            childId += childIds[i];
+            parentId += parentIds[i];
+            const child = parser.instances[childId];
+            if (parentId === -1) {
+                parser.result.push(child);
+            }
+            else {
+                child.setProperty('Parent', parser.instances[parentId], 'Instance');
+            }
+        }
+    }
+};
+exports.default = BinaryParser;

package/dist/ByteReader.d.ts

@@ -0,0 +1,38 @@
+declare class ByteReader extends Uint8Array {
+    index: number;
+    chunkBuffer: Uint8Array;
+    static ParseFloat(long: any): number;
+    static ParseRBXFloat(long: any): number;
+    static ParseDouble(long0: any, long1: any): number;
+    constructor(...args: any[]);
+    SetIndex(n: number): void;
+    GetIndex(): number;
+    GetRemaining(): number;
+    GetLength(): number;
+    Jump(n: number): void;
+    Array(n: number): Uint8Array<ArrayBuffer>;
+    Match(arr: any): boolean;
+    Byte(): number;
+    UInt8(): number;
+    UInt16LE(): number;
+    UInt16BE(): number;
+    UInt32LE(): number;
+    UInt32BE(): number;
+    Int8(): number;
+    Int16LE(): number;
+    Int16BE(): number;
+    Int32LE(): number;
+    Int32BE(): number;
+    FloatLE(): number;
+    FloatBE(): number;
+    DoubleLE(): number;
+    DoubleBE(): number;
+    String(n: number): string;
+    LZ4(buffer: any): any;
+    RBXFloatLE(): number;
+    RBXFloatBE(): number;
+    RBXInterleavedUint32(count: any, result: any): any;
+    RBXInterleavedInt32(count: any, result: any): any;
+    RBXInterleavedFloat(count: any, result: any): any;
+}
+export default ByteReader;