@blamnetwork/blf 1.0.0-alpha.5 → 1.0.0-beta.1

package/dist-cjs/chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_game_variant.js

@@ -0,0 +1,133 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.s_blf_chunk_game_variant = exports.MPVR_PAYLOAD_SIZE = exports.variant_storage_capacity = void 0;
+const bitstream_1 = require("../../../bitstream");
+const security_functions_1 = require("../../../blam/common/cache/security_functions");
+const c_game_variant_1 = require("../../../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/c_game_variant");
+const blf_chunk_1 = require("../../../blf_chunk");
+const error_1 = require("../../../error");
+/** Gametype storage slot size (bytes). */
+exports.variant_storage_capacity = 0x5000;
+/** mpvr body size: hash/header (28) + padded gametype slot. */
+exports.MPVR_PAYLOAD_SIZE = 28 + exports.variant_storage_capacity;
+/**
+ * Reach game variant chunk (`mpvr` 54.1).
+ *
+ * Payload layout matches blf_lib: hash + header fields + gametype bitstream,
+ * all read through one big-endian bitstream.
+ */
+let s_blf_chunk_game_variant = (() => {
+    let _classDecorators = [blf_chunk_1.blf.chunk("mpvr", 54.1)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = blf_chunk_1.BLFChunkBase;
+    var s_blf_chunk_game_variant = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            s_blf_chunk_game_variant = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        hash = new Uint8Array(20);
+        unknown04 = -1;
+        unknown06 = 0;
+        variant_length = 0;
+        game_variant = new c_game_variant_1.c_game_variant();
+        static create(game_variant) {
+            const chunk = new s_blf_chunk_game_variant();
+            chunk.game_variant = game_variant;
+            return chunk;
+        }
+        read_body(payload, endian) {
+            if (payload.length === 0) {
+                throw new error_1.BlfError("mpvr chunk payload is empty");
+            }
+            const byte_order = endian === "big"
+                ? bitstream_1.e_bitstream_byte_order._bitstream_byte_order_big_endian
+                : bitstream_1.e_bitstream_byte_order._bitstream_byte_order_little_endian;
+            const bitstream = bitstream_1.c_bitstream_reader.new(payload, byte_order);
+            bitstream.begin_reading();
+            this.hash = bitstream.read_raw_data(20 * 8);
+            this.unknown04 = bitstream.read_signed_integer("unknown04", 16);
+            this.unknown06 = bitstream.read_integer("unknown06", 16);
+            this.variant_length = bitstream.read_integer("variant-length", 32);
+            this.game_variant = new c_game_variant_1.c_game_variant();
+            this.game_variant.decode(bitstream);
+            bitstream.finish_reading();
+        }
+        write_body(endian) {
+            const byte_order = endian === "big"
+                ? bitstream_1.e_bitstream_byte_order._bitstream_byte_order_big_endian
+                : bitstream_1.e_bitstream_byte_order._bitstream_byte_order_little_endian;
+            const gametype_bitstream = bitstream_1.c_bitstream_writer.new(exports.variant_storage_capacity, byte_order);
+            gametype_bitstream.begin_writing();
+            this.game_variant.encode(gametype_bitstream);
+            gametype_bitstream.finish_writing();
+            const gametype_data = gametype_bitstream.get_data();
+            const gametype_length = gametype_data.length;
+            if (gametype_length > exports.variant_storage_capacity) {
+                throw new error_1.BlfError(`mpvr gametype too large: ${gametype_length} bytes (max ${exports.variant_storage_capacity})`);
+            }
+            const hashable_bitstream = bitstream_1.c_bitstream_writer.new(4 + gametype_length, byte_order);
+            hashable_bitstream.begin_writing();
+            hashable_bitstream.write_integer(gametype_length, 32);
+            hashable_bitstream.write_raw_data(gametype_data, gametype_length * 8);
+            hashable_bitstream.finish_writing();
+            const hash = (0, security_functions_1.security_calculate_hash)(hashable_bitstream.get_data());
+            const payload_bitstream = bitstream_1.c_bitstream_writer.new(exports.variant_storage_capacity, byte_order);
+            payload_bitstream.begin_writing();
+            payload_bitstream.write_raw_data(hash, hash.length * 8);
+            payload_bitstream.write_signed_integer(this.unknown04, 16);
+            payload_bitstream.write_integer(this.unknown06, 16);
+            payload_bitstream.write_integer(gametype_length, 32);
+            payload_bitstream.write_raw_data(gametype_data, gametype_length * 8);
+            const pad_bytes = exports.variant_storage_capacity - gametype_length;
+            if (pad_bytes > 0) {
+                payload_bitstream.seek_relative(pad_bytes * 8);
+            }
+            payload_bitstream.finish_writing();
+            this.hash = hash;
+            this.variant_length = gametype_length;
+            return payload_bitstream.get_data();
+        }
+    };
+    return s_blf_chunk_game_variant = _classThis;
+})();
+exports.s_blf_chunk_game_variant = s_blf_chunk_game_variant;

package/dist-cjs/chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_packed_game_variant.js

@@ -0,0 +1,88 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.s_blf_chunk_packed_game_variant = void 0;
+const bitstream_1 = require("../../../bitstream");
+const c_game_variant_1 = require("../../../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/c_game_variant");
+const blf_chunk_1 = require("../../../blf_chunk");
+const error_1 = require("../../../error");
+/**
+ * Reach matchmaking game variant chunk (`gvar` 54.1).
+ *
+ * Payload is the gametype bitstream only (no mpvr hash/header wrapper).
+ */
+let s_blf_chunk_packed_game_variant = (() => {
+    let _classDecorators = [blf_chunk_1.blf.chunk("gvar", 54.1)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = blf_chunk_1.BLFChunkBase;
+    var s_blf_chunk_packed_game_variant = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            s_blf_chunk_packed_game_variant = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        game_variant = new c_game_variant_1.c_game_variant();
+        static create(game_variant) {
+            const chunk = new s_blf_chunk_packed_game_variant();
+            chunk.game_variant = game_variant;
+            return chunk;
+        }
+        read_body(payload, _endian) {
+            if (payload.length === 0) {
+                throw new error_1.BlfError("gvar chunk payload is empty");
+            }
+            const bitstream = bitstream_1.c_bitstream_reader.new(payload, bitstream_1.e_bitstream_byte_order._bitstream_byte_order_big_endian);
+            bitstream.begin_reading();
+            this.game_variant = new c_game_variant_1.c_game_variant();
+            this.game_variant.decode(bitstream);
+            bitstream.finish_reading();
+        }
+        write_body(_endian) {
+            const bitstream = bitstream_1.c_bitstream_writer.new(0x5028, bitstream_1.e_bitstream_byte_order._bitstream_byte_order_big_endian);
+            bitstream.begin_writing();
+            this.game_variant.encode(bitstream);
+            bitstream.finish_writing();
+            return bitstream.get_data();
+        }
+    };
+    return s_blf_chunk_packed_game_variant = _classThis;
+})();
+exports.s_blf_chunk_packed_game_variant = s_blf_chunk_packed_game_variant;

package/dist-cjs/helpers/convert_reach_gametype.js

@@ -0,0 +1,194 @@
+"use strict";
+/**
+ * Convert game variants between Halo Reach TU1 and MCC builds.
+ *
+ * JSON-clone the variant, reject MCC-only megalo features, remap what moved
+ * between builds, then write the four top-level fields onto `to`.
+ *
+ * Differences handled here:
+ * - MCC-only: temporary explicit refs, `<<=`, `>>=`
+ * - `set_to_absolute` exists in both builds but moved (TU1 = 10, MCC = 12)
+ * - Survival: unrelated fields — MCC→TU1 sets `m_campaign_difficulty_level` to 1;
+ *   TU1→MCC sets `m_encoding_version` to 2; `m_additional_flags` only on MCC
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convert_reach_gametype = convert_reach_gametype;
+const c_game_variant_1 = require("../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant");
+const megalogamengine_actions_1 = require("../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/megalogamengine/megalogamengine_actions");
+const c_game_variant_2 = require("../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/c_game_variant");
+const megalogamengine_actions_2 = require("../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/megalogamengine/megalogamengine_actions");
+const megalogamengine_explicit_object_1 = require("../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/megalogamengine/megalogamengine_explicit_object");
+const megalogamengine_explicit_player_1 = require("../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/megalogamengine/megalogamengine_explicit_player");
+const megalogamengine_explicit_team_1 = require("../blam/haloreach_mcc/v_untracked_25_08_19_1352/game/megalogamengine/megalogamengine_explicit_team");
+const error_1 = require("../error");
+/** MCC math ops with no TU1 equivalent (`<<=`, `>>=`). */
+const MCC_ONLY_MATH_OPS = [
+    megalogamengine_actions_2.e_math_operation.shift_left_with,
+    megalogamengine_actions_2.e_math_operation.shift_right_with,
+];
+/** TU1 survival `m_campaign_difficulty_level` when converting from MCC. */
+const TU1_SURVIVAL_CAMPAIGN_DIFFICULTY = 1;
+/** MCC survival `m_encoding_version` when converting from TU1. */
+const MCC_SURVIVAL_ENCODING_VERSION = 2;
+// ---------------------------------------------------------------------------
+// JSON helpers
+// ---------------------------------------------------------------------------
+function json_clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function write_game_variant_json(to, data) {
+    to.m_game_engine = data.m_game_engine;
+    to.m_campaign_variant = data.m_campaign_variant;
+    to.m_custom_variant = data.m_custom_variant;
+    to.m_survival_variant = data.m_survival_variant;
+}
+// ---------------------------------------------------------------------------
+// Tree walk
+// ---------------------------------------------------------------------------
+function visit_object_tree(root, fn) {
+    if (root === null || typeof root !== "object") {
+        return;
+    }
+    if (Array.isArray(root)) {
+        for (const item of root) {
+            visit_object_tree(item, fn);
+        }
+        return;
+    }
+    const obj = root;
+    fn(obj);
+    for (const value of Object.values(obj)) {
+        visit_object_tree(value, fn);
+    }
+}
+function remap_set_to_absolute_mcc_to_tu1(root) {
+    visit_object_tree(root, (obj) => {
+        if (obj.m_operation === megalogamengine_actions_2.e_math_operation.set_to_absolute) {
+            obj.m_operation = megalogamengine_actions_1.e_math_operation.set_to_absolute;
+        }
+        if (obj.m_math_operation === megalogamengine_actions_2.e_math_operation.set_to_absolute) {
+            obj.m_math_operation = megalogamengine_actions_1.e_math_operation.set_to_absolute;
+        }
+    });
+}
+function remap_set_to_absolute_tu1_to_mcc(root) {
+    visit_object_tree(root, (obj) => {
+        if (obj.m_operation === megalogamengine_actions_1.e_math_operation.set_to_absolute) {
+            obj.m_operation = megalogamengine_actions_2.e_math_operation.set_to_absolute;
+        }
+        if (obj.m_math_operation === megalogamengine_actions_1.e_math_operation.set_to_absolute) {
+            obj.m_math_operation = megalogamengine_actions_2.e_math_operation.set_to_absolute;
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// MCC → TU1 compatibility checks
+// ---------------------------------------------------------------------------
+function variant_uses_temporary_explicit_refs(variant) {
+    let found = false;
+    visit_object_tree(variant, (obj) => {
+        if (found) {
+            return;
+        }
+        const team = obj.m_explicit_team_type;
+        if (typeof team === "number" &&
+            team >= megalogamengine_explicit_team_1.e_explicit_team_type.temporary_0 &&
+            team <= megalogamengine_explicit_team_1.e_explicit_team_type.temporary_5) {
+            found = true;
+            return;
+        }
+        const player = obj.m_explicit_player_type;
+        if (typeof player === "number" &&
+            player >= megalogamengine_explicit_player_1.e_explicit_player_type.temporary_0 &&
+            player <= megalogamengine_explicit_player_1.e_explicit_player_type.temporary_2) {
+            found = true;
+            return;
+        }
+        const object = obj.m_explicit_object_type;
+        if (typeof object === "number" &&
+            object >= megalogamengine_explicit_object_1.e_explicit_object_type.temporary_0 &&
+            object <= megalogamengine_explicit_object_1.e_explicit_object_type.temporary_7) {
+            found = true;
+        }
+    });
+    return found;
+}
+function variant_uses_mcc_only_math_ops(variant) {
+    let found = false;
+    visit_object_tree(variant, (obj) => {
+        if (found) {
+            return;
+        }
+        const op = obj.m_operation ?? obj.m_math_operation;
+        if (typeof op === "number" && MCC_ONLY_MATH_OPS.includes(op)) {
+            found = true;
+        }
+    });
+    return found;
+}
+/** Returns false when MCC features cannot be represented in TU1. */
+function can_convert_mcc_game_variant_to_tu1(from) {
+    if (from.m_game_engine === c_game_variant_2.e_game_mode.survival &&
+        from.m_survival_variant !== undefined &&
+        from.m_survival_variant.m_additional_flags !== 0) {
+        return false;
+    }
+    if (variant_uses_temporary_explicit_refs(from)) {
+        return false;
+    }
+    if (variant_uses_mcc_only_math_ops(from)) {
+        return false;
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Survival (MCC and TU1 use different field names for unrelated data)
+// ---------------------------------------------------------------------------
+function survival_json_mcc_to_tu1(survival) {
+    survival.m_campaign_difficulty_level = TU1_SURVIVAL_CAMPAIGN_DIFFICULTY;
+    survival.m_encoding_version = undefined;
+    survival.m_additional_flags = undefined;
+}
+function survival_json_tu1_to_mcc(survival) {
+    survival.m_encoding_version = MCC_SURVIVAL_ENCODING_VERSION;
+    survival.m_campaign_difficulty_level = undefined;
+    survival.m_additional_flags = 0;
+}
+// ---------------------------------------------------------------------------
+// Conversion (cross-version only)
+// ---------------------------------------------------------------------------
+function convert_mcc_to_tu1(from, to) {
+    if (!can_convert_mcc_game_variant_to_tu1(from)) {
+        return false;
+    }
+    const data = json_clone(from);
+    remap_set_to_absolute_mcc_to_tu1(data);
+    if (data.m_survival_variant !== undefined) {
+        survival_json_mcc_to_tu1(data.m_survival_variant);
+    }
+    write_game_variant_json(to, data);
+    return true;
+}
+function convert_tu1_to_mcc(from, to) {
+    const data = json_clone(from);
+    remap_set_to_absolute_tu1_to_mcc(data);
+    if (data.m_survival_variant !== undefined) {
+        survival_json_tu1_to_mcc(data.m_survival_variant);
+    }
+    write_game_variant_json(to, data);
+    return true;
+}
+function convert_reach_gametype(from, to) {
+    if (from.m_game_engine === c_game_variant_1.e_game_mode.sandbox) {
+        throw new error_1.BlfError("Forge game variants are not supported. Where did you even get this?");
+    }
+    const from_is_mcc = from instanceof c_game_variant_2.c_game_variant;
+    const to_is_mcc = to instanceof c_game_variant_2.c_game_variant;
+    if (from_is_mcc === to_is_mcc) {
+        throw new error_1.BlfError("convert_reach_gametype only supports cross-version conversion between Reach TU1 and Reach MCC");
+    }
+    if (from_is_mcc) {
+        return convert_mcc_to_tu1(from, to);
+    }
+    return convert_tu1_to_mcc(from, to);
+}

package/dist-cjs/helpers/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convert_reach_gametype = void 0;
+var convert_reach_gametype_1 = require("./convert_reach_gametype");
+Object.defineProperty(exports, "convert_reach_gametype", { enumerable: true, get: function () { return convert_reach_gametype_1.convert_reach_gametype; } });

package/dist-cjs/versions/haloreach_mcc/v_untracked_25_08_19_1352.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../../blam/common"), exports);
+__exportStar(require("../../blam/haloreach_mcc/v_untracked_25_08_19_1352"), exports);
+__exportStar(require("../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_compressed_data"), exports);
+__exportStar(require("../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_end_of_file"), exports);
+__exportStar(require("../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_start_of_file"), exports);
+__exportStar(require("../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header"), exports);
+__exportStar(require("../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_game_variant"), exports);
+__exportStar(require("../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_packed_game_variant"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamnetwork/blf",
-  "version": "1.0.0-alpha.5",
+  "version": "1.0.0-beta.1",
   "description": "BLF chunk library for Halo (TypeScript)",
   "type": "module",
   "main": "./dist-cjs/index.js",
@@ -10,6 +10,9 @@
       "haloreach/*": [
         "./dist/versions/haloreach/*"
       ],
+      "haloreach_mcc/*": [
+        "./dist/versions/haloreach_mcc/*"
+      ],
       "halo3/*": [
         "./dist/versions/halo3/*"
       ],
@@ -25,12 +28,24 @@
       "require": "./dist-cjs/index.js",
       "default": "./dist/index.js"
     },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
+      "import": "./dist/helpers/index.js",
+      "require": "./dist-cjs/helpers/index.js",
+      "default": "./dist/helpers/index.js"
+    },
     "./haloreach/*": {
       "types": "./dist/versions/haloreach/*.d.ts",
       "import": "./dist/versions/haloreach/*.js",
       "require": "./dist-cjs/versions/haloreach/*.js",
       "default": "./dist/versions/haloreach/*.js"
     },
+    "./haloreach_mcc/*": {
+      "types": "./dist/versions/haloreach_mcc/*.d.ts",
+      "import": "./dist/versions/haloreach_mcc/*.js",
+      "require": "./dist-cjs/versions/haloreach_mcc/*.js",
+      "default": "./dist/versions/haloreach_mcc/*.js"
+    },
     "./halo3/*": {
       "types": "./dist/versions/halo3/*.d.ts",
       "import": "./dist/versions/halo3/*.js",
@@ -54,9 +69,15 @@
     "fix": "ultracite fix",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "validate": "npm run check && npm run test && npm run typecheck",
+    "docs:gen": "node scripts/generate-docs-version-exports.mjs",
+    "docs": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "validate": "npm run check && npm run test && npm run typecheck && npm run docs:build",
     "release": "node scripts/release.mjs",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "predocs": "npm run docs:gen",
+    "predocs:build": "npm run docs:gen"
   },
   "repository": {
     "type": "git",
@@ -66,7 +87,7 @@
   "bugs": {
     "url": "https://github.com/Blam-Network/blf/issues"
   },
-  "homepage": "https://github.com/Blam-Network/blf/tree/main/blf-ts#readme",
+  "homepage": "https://blam-network.github.io/blf/",
   "keywords": [
     "blf",
     "halo",
@@ -91,6 +112,7 @@
     "typescript": "^5",
     "ultracite": "7.7.0",
     "unplugin-swc": "^1.5.9",
+    "vitepress": "^1.6.4",
     "vitest": "^3.2.4"
   }
 }