@blamnetwork/blf 1.0.0-alpha.1

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_author.js

@@ -0,0 +1,109 @@
+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;
+};
+import { c } from "@craftycodie/cstruct";
+import pkg from "../../../../package.json";
+import { blf, CStructBLFChunk } from "../../../blf_chunk";
+/** BLF author chunk (`athr` 3.1) — same layout as Halo 3: ODST Atlas. */
+let s_blf_chunk_author = (() => {
+    let _classDecorators = [blf.chunk("athr", 3.1), c.struct()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = CStructBLFChunk;
+    let _program_name_decorators;
+    let _program_name_initializers = [];
+    let _program_name_extraInitializers = [];
+    let _build_number_decorators;
+    let _build_number_initializers = [];
+    let _build_number_extraInitializers = [];
+    let _build_number_sequence_decorators;
+    let _build_number_sequence_initializers = [];
+    let _build_number_sequence_extraInitializers = [];
+    let _build_string_decorators;
+    let _build_string_initializers = [];
+    let _build_string_extraInitializers = [];
+    let _author_name_decorators;
+    let _author_name_initializers = [];
+    let _author_name_extraInitializers = [];
+    var s_blf_chunk_author = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _program_name_decorators = [c.field(c.String(16))];
+            _build_number_decorators = [c.field("u32")];
+            _build_number_sequence_decorators = [c.field("u32")];
+            _build_string_decorators = [c.field(c.String(28))];
+            _author_name_decorators = [c.field(c.String(16))];
+            __esDecorate(null, null, _program_name_decorators, { kind: "field", name: "program_name", static: false, private: false, access: { has: obj => "program_name" in obj, get: obj => obj.program_name, set: (obj, value) => { obj.program_name = value; } }, metadata: _metadata }, _program_name_initializers, _program_name_extraInitializers);
+            __esDecorate(null, null, _build_number_decorators, { kind: "field", name: "build_number", static: false, private: false, access: { has: obj => "build_number" in obj, get: obj => obj.build_number, set: (obj, value) => { obj.build_number = value; } }, metadata: _metadata }, _build_number_initializers, _build_number_extraInitializers);
+            __esDecorate(null, null, _build_number_sequence_decorators, { kind: "field", name: "build_number_sequence", static: false, private: false, access: { has: obj => "build_number_sequence" in obj, get: obj => obj.build_number_sequence, set: (obj, value) => { obj.build_number_sequence = value; } }, metadata: _metadata }, _build_number_sequence_initializers, _build_number_sequence_extraInitializers);
+            __esDecorate(null, null, _build_string_decorators, { kind: "field", name: "build_string", static: false, private: false, access: { has: obj => "build_string" in obj, get: obj => obj.build_string, set: (obj, value) => { obj.build_string = value; } }, metadata: _metadata }, _build_string_initializers, _build_string_extraInitializers);
+            __esDecorate(null, null, _author_name_decorators, { kind: "field", name: "author_name", static: false, private: false, access: { has: obj => "author_name" in obj, get: obj => obj.author_name, set: (obj, value) => { obj.author_name = value; } }, metadata: _metadata }, _author_name_initializers, _author_name_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            s_blf_chunk_author = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /** e.g. `GameData.Reach`, or blf_lib package name from `for_build`. */
+        program_name = __runInitializers(this, _program_name_initializers, "");
+        /** e.g. 12065 */
+        build_number = (__runInitializers(this, _program_name_extraInitializers), __runInitializers(this, _build_number_initializers, 0));
+        /** e.g. 2 for Reach title storage exports */
+        build_number_sequence = (__runInitializers(this, _build_number_extraInitializers), __runInitializers(this, _build_number_sequence_initializers, 0));
+        /** e.g. `12065.11.08.24.1738.tu1actual` */
+        build_string = (__runInitializers(this, _build_number_sequence_extraInitializers), __runInitializers(this, _build_string_initializers, ""));
+        /** e.g. `davidav`, `dagasca` */
+        author_name = (__runInitializers(this, _build_string_extraInitializers), __runInitializers(this, _author_name_initializers, ""));
+        /**
+         * Default author chunk for Reach TU1 exports.
+         * Mirrors `s_blf_chunk_author::for_build` in blf_lib (ODST 3.1 layout).
+         */
+        static forBuild(options) {
+            const chunk = new s_blf_chunk_author();
+            chunk.program_name = options?.programName ?? `blf-ts ${pkg.version}`;
+            chunk.build_number = options?.buildNumber ?? 0;
+            chunk.build_number_sequence = options?.buildNumberSequence ?? 0;
+            chunk.build_string = (options?.buildString ?? "").slice(0, 28);
+            chunk.author_name = options?.authorName ?? "";
+            return chunk;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _author_name_extraInitializers);
+        }
+    };
+    return s_blf_chunk_author = _classThis;
+})();
+export { s_blf_chunk_author };

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_compressed_data.d.ts

@@ -0,0 +1,4 @@
+export { s_blf_chunk_compressed_data } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_compressed_data";
+export { s_blf_chunk_end_of_file } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_end_of_file";
+export { e_byte_order_mark, s_blf_chunk_start_of_file, } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_start_of_file";
+//# sourceMappingURL=s_blf_chunk_compressed_data.d.ts.map

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_compressed_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s_blf_chunk_compressed_data.d.ts","sourceRoot":"","sources":["../../../../src/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_compressed_data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yEAAyE,CAAC;AACtH,OAAO,EAAE,uBAAuB,EAAE,MAAM,qEAAqE,CAAC;AAC9G,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uEAAuE,CAAC"}

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_compressed_data.js

@@ -0,0 +1,3 @@
+export { s_blf_chunk_compressed_data } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_compressed_data";
+export { s_blf_chunk_end_of_file } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_end_of_file";
+export { e_byte_order_mark, s_blf_chunk_start_of_file, } from "../../halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_start_of_file";

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header.d.ts

@@ -0,0 +1,8 @@
+import { s_content_item_metadata } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/saved_games/saved_game_files";
+import { CStructBLFChunk } from "../../../blf_chunk";
+export declare class s_blf_chunk_content_header extends CStructBLFChunk {
+    build_number: number;
+    map_minor_version: number;
+    metadata: s_content_item_metadata;
+}
+//# sourceMappingURL=s_blf_chunk_content_header.d.ts.map

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s_blf_chunk_content_header.d.ts","sourceRoot":"","sources":["../../../../src/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qFAAqF,CAAC;AAC9H,OAAO,EAAO,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAEa,0BAA2B,SAAQ,eAAe;IAE7D,YAAY,EAAG,MAAM,CAAC;IAGtB,iBAAiB,EAAG,MAAM,CAAC;IAG3B,QAAQ,EAAG,uBAAuB,CAAC;CACpC"}

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header.js

@@ -0,0 +1,78 @@
+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;
+};
+import { c } from "@craftycodie/cstruct";
+import { s_content_item_metadata } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/saved_games/saved_game_files";
+import { blf, CStructBLFChunk } from "../../../blf_chunk";
+let s_blf_chunk_content_header = (() => {
+    let _classDecorators = [blf.chunk("chdr", 10.2), c.struct()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = CStructBLFChunk;
+    let _build_number_decorators;
+    let _build_number_initializers = [];
+    let _build_number_extraInitializers = [];
+    let _map_minor_version_decorators;
+    let _map_minor_version_initializers = [];
+    let _map_minor_version_extraInitializers = [];
+    let _metadata_decorators;
+    let _metadata_initializers = [];
+    let _metadata_extraInitializers = [];
+    var s_blf_chunk_content_header = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _build_number_decorators = [c.field("u16")];
+            _map_minor_version_decorators = [c.field("u16")];
+            _metadata_decorators = [c.field(s_content_item_metadata)];
+            __esDecorate(null, null, _build_number_decorators, { kind: "field", name: "build_number", static: false, private: false, access: { has: obj => "build_number" in obj, get: obj => obj.build_number, set: (obj, value) => { obj.build_number = value; } }, metadata: _metadata }, _build_number_initializers, _build_number_extraInitializers);
+            __esDecorate(null, null, _map_minor_version_decorators, { kind: "field", name: "map_minor_version", static: false, private: false, access: { has: obj => "map_minor_version" in obj, get: obj => obj.map_minor_version, set: (obj, value) => { obj.map_minor_version = value; } }, metadata: _metadata }, _map_minor_version_initializers, _map_minor_version_extraInitializers);
+            __esDecorate(null, null, _metadata_decorators, { kind: "field", name: "metadata", static: false, private: false, access: { has: obj => "metadata" in obj, get: obj => obj.metadata, set: (obj, value) => { obj.metadata = value; } }, metadata: _metadata }, _metadata_initializers, _metadata_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            s_blf_chunk_content_header = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        build_number = __runInitializers(this, _build_number_initializers, void 0);
+        map_minor_version = (__runInitializers(this, _build_number_extraInitializers), __runInitializers(this, _map_minor_version_initializers, void 0));
+        metadata = (__runInitializers(this, _map_minor_version_extraInitializers), __runInitializers(this, _metadata_initializers, void 0));
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _metadata_extraInitializers);
+        }
+    };
+    return s_blf_chunk_content_header = _classThis;
+})();
+export { s_blf_chunk_content_header };

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant.d.ts

@@ -0,0 +1,24 @@
+import type { c } from "@craftycodie/cstruct";
+import { c_game_variant } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { BLFChunkBase } from "../../../blf_chunk";
+/** Gametype storage slot size (bytes). */
+export declare const variant_storage_capacity = 20480;
+/** mpvr body size: hash/header (28) + padded gametype slot. */
+export declare const MPVR_PAYLOAD_SIZE: number;
+/**
+ * Reach game variant chunk (`mpvr` 54.1).
+ *
+ * Payload layout matches blf_lib: hash + header fields + gametype bitstream,
+ * all read through one big-endian bitstream.
+ */
+export declare class s_blf_chunk_game_variant extends BLFChunkBase {
+    hash: Uint8Array;
+    unknown04: number;
+    unknown06: number;
+    variant_length: number;
+    game_variant: c_game_variant;
+    static create(game_variant: c_game_variant): s_blf_chunk_game_variant;
+    read_body(payload: Uint8Array, endian: c.Endian): void;
+    write_body(endian: c.Endian): Uint8Array;
+}
+//# sourceMappingURL=s_blf_chunk_game_variant.d.ts.map

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s_blf_chunk_game_variant.d.ts","sourceRoot":"","sources":["../../../../src/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAC;AAO9C,OAAO,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAO,MAAM,oBAAoB,CAAC;AAGvD,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAE/D;;;;;GAKG;AACH,qBACa,wBAAyB,SAAQ,YAAY;IACxD,IAAI,EAAE,UAAU,CAAsB;IACtC,SAAS,SAAM;IACf,SAAS,SAAK;IACd,cAAc,SAAK;IACnB,YAAY,iBAAwB;IAEpC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,GAAG,wBAAwB;IAMrE,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,IAAI;IAwBtD,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,UAAU;CAuDzC"}

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant.js

@@ -0,0 +1,130 @@
+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;
+};
+import { c_bitstream_reader, c_bitstream_writer, e_bitstream_byte_order, } from "../../../bitstream";
+import { security_calculate_hash } from "../../../blam/common/cache/security_functions";
+import { c_game_variant } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { BLFChunkBase, blf } from "../../../blf_chunk";
+import { BlfError } from "../../../error";
+/** Gametype storage slot size (bytes). */
+export const variant_storage_capacity = 0x5000;
+/** mpvr body size: hash/header (28) + padded gametype slot. */
+export const MPVR_PAYLOAD_SIZE = 28 + 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("mpvr", 54.1)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = 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();
+        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 BlfError("mpvr chunk payload is empty");
+            }
+            const byte_order = endian === "big"
+                ? e_bitstream_byte_order._bitstream_byte_order_big_endian
+                : e_bitstream_byte_order._bitstream_byte_order_little_endian;
+            const bitstream = 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();
+            this.game_variant.decode(bitstream);
+            bitstream.finish_reading();
+        }
+        write_body(endian) {
+            const byte_order = endian === "big"
+                ? e_bitstream_byte_order._bitstream_byte_order_big_endian
+                : e_bitstream_byte_order._bitstream_byte_order_little_endian;
+            const gametype_bitstream = c_bitstream_writer.new(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 > variant_storage_capacity) {
+                throw new BlfError(`mpvr gametype too large: ${gametype_length} bytes (max ${variant_storage_capacity})`);
+            }
+            const hashable_bitstream = 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 = security_calculate_hash(hashable_bitstream.get_data());
+            const payload_bitstream = c_bitstream_writer.new(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 = 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;
+})();
+export { s_blf_chunk_game_variant };

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant.d.ts

@@ -0,0 +1,15 @@
+import type { c } from "@craftycodie/cstruct";
+import { c_game_variant } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { BLFChunkBase } from "../../../blf_chunk";
+/**
+ * Reach matchmaking game variant chunk (`gvar` 54.1).
+ *
+ * Payload is the gametype bitstream only (no mpvr hash/header wrapper).
+ */
+export declare class s_blf_chunk_packed_game_variant extends BLFChunkBase {
+    game_variant: c_game_variant;
+    static create(game_variant: c_game_variant): s_blf_chunk_packed_game_variant;
+    read_body(payload: Uint8Array, _endian: c.Endian): void;
+    write_body(_endian: c.Endian): Uint8Array;
+}
+//# sourceMappingURL=s_blf_chunk_packed_game_variant.d.ts.map

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s_blf_chunk_packed_game_variant.d.ts","sourceRoot":"","sources":["../../../../src/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,sBAAsB,CAAC;AAM9C,OAAO,EAAE,cAAc,EAAE,MAAM,4EAA4E,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAO,MAAM,oBAAoB,CAAC;AAGvD;;;;GAIG;AACH,qBACa,+BAAgC,SAAQ,YAAY;IAC/D,YAAY,iBAAwB;IAEpC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,GAAG,+BAA+B;IAM5E,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,IAAI;IAevD,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,GAAG,UAAU;CAU1C"}

package/dist/chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant.js

@@ -0,0 +1,85 @@
+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;
+};
+import { c_bitstream_reader, c_bitstream_writer, e_bitstream_byte_order, } from "../../../bitstream";
+import { c_game_variant } from "../../../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { BLFChunkBase, blf } from "../../../blf_chunk";
+import { BlfError } from "../../../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("gvar", 54.1)];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = 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();
+        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 BlfError("gvar chunk payload is empty");
+            }
+            const bitstream = c_bitstream_reader.new(payload, e_bitstream_byte_order._bitstream_byte_order_big_endian);
+            bitstream.begin_reading();
+            this.game_variant = new c_game_variant();
+            this.game_variant.decode(bitstream);
+            bitstream.finish_reading();
+        }
+        write_body(_endian) {
+            const bitstream = c_bitstream_writer.new(0x5028, 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;
+})();
+export { s_blf_chunk_packed_game_variant };

package/dist/decorators.d.ts

@@ -0,0 +1,38 @@
+import type { BLFChunk, BLFChunkConstructor, s_blf_header } from "./blf_chunk";
+type StringLength<S extends string, Acc extends unknown[] = []> = S extends `${string}${infer Rest}` ? StringLength<Rest, [...Acc, unknown]> : Acc["length"];
+/** Exactly four characters (FourCC). */
+export type BLFSignature<T extends string = string> = string extends T ? string : StringLength<T> extends 4 ? T : never;
+/** Major.minor version as a float literal, e.g. `1.1` (major 1, minor 1). */
+export type BLFVersion<T extends number = number> = T;
+/** Metadata attached by `@blf.chunk(sig, version)`. */
+export type ChunkMetadata<TSignature extends BLFSignature<string> = BLFSignature, TVersion extends BLFVersion = BLFVersion> = {
+    readonly signature: TSignature;
+    readonly version: TVersion;
+    readonly major: number;
+    readonly minor: number;
+};
+export declare const BLF_CHUNK_META: unique symbol;
+export type BLFChunkInfo = ChunkMetadata;
+/** Constructor after `@blf.chunk` — instances include {@link ChunkMetadata}. */
+export type ChunkDecorator<T extends abstract new (...args: any[]) => BLFChunk, TSignature extends BLFSignature<string>, TVersion extends BLFVersion> = (abstract new (...args: ConstructorParameters<T>) => InstanceType<T> & ChunkMetadata<TSignature, TVersion>) & T & {
+    readonly [BLF_CHUNK_META]: BLFChunkInfo & {
+        signature: TSignature;
+        version: TVersion;
+    };
+};
+/** Instance or constructor for a class decorated with `@blf.chunk`. */
+export type BLFChunkLookup = BLFChunkConstructor | BLFChunk;
+/**
+ * Registers BLF signature/version on the class (runtime getters + constructor meta).
+ * Implement {@link BLFChunk} `read_body` / `write_body`, or extend {@link CStructBLFChunk} with `@c.struct`.
+ */
+export declare function chunk<TSignature extends BLFSignature<string>, TVersion extends BLFVersion>(signature: TSignature, version: TVersion): <T extends abstract new (...args: any[]) => BLFChunk>(target: T, _context: ClassDecoratorContext) => ChunkDecorator<T, TSignature, TVersion>;
+/** `@blf.chunk` decorator and namespace. */
+export declare const blf: {
+    readonly chunk: typeof chunk;
+};
+export declare function getBlfChunkMeta(from: BLFChunkLookup): BLFChunkInfo;
+export declare function createBlfChunk<T extends new (...args: any[]) => object>(ctor: T): InstanceType<T>;
+export declare function chunkMatches(header: s_blf_header, meta: BLFChunkInfo): boolean;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI/E,KAAK,YAAY,CACf,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,OAAO,EAAE,GAAG,EAAE,IACxB,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,IAAI,EAAE,GAClC,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,GACrC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAElB,wCAAwC;AACxC,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,SAAS,CAAC,GAClE,MAAM,GACN,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,GACvB,CAAC,GACD,KAAK,CAAC;AAEZ,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;AAEtD,uDAAuD;AACvD,MAAM,MAAM,aAAa,CACvB,UAAU,SAAS,YAAY,CAAC,MAAM,CAAC,GAAG,YAAY,EACtD,QAAQ,SAAS,UAAU,GAAG,UAAU,IACtC;IACF,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,cAAc,eAA+B,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC,gFAAgF;AAChF,MAAM,MAAM,cAAc,CACxB,CAAC,SAAS,QAAQ,MAChB,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,QAAQ,EACb,UAAU,SAAS,YAAY,CAAC,MAAM,CAAC,EACvC,QAAQ,SAAS,UAAU,IACzB,CAAC,QAAQ,MACX,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAC9B,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,GACzD,CAAC,GAAG;IACF,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG;QACxC,SAAS,EAAE,UAAU,CAAC;QACtB,OAAO,EAAE,QAAQ,CAAC;KACnB,CAAC;CACH,CAAC;AAEJ,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAyC5D;;;GAGG;AACH,wBAAgB,KAAK,CACnB,UAAU,SAAS,YAAY,CAAC,MAAM,CAAC,EACvC,QAAQ,SAAS,UAAU,EAC3B,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,IAGhC,CAAC,SAAS,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,EACzD,QAAQ,CAAC,EACT,UAAU,qBAAqB,KAC9B,cAAc,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAI3C;AAED,4CAA4C;AAC5C,eAAO,MAAM,GAAG;;CAAqB,CAAC;AAEtC,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAkBlE;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,EACrE,IAAI,EAAE,CAAC,GACN,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAMT"}

package/dist/decorators.js

@@ -0,0 +1,68 @@
+import { BlfError } from "./error";
+import { parse_blf_chunk_version } from "./s_blf_header";
+export const BLF_CHUNK_META = Symbol.for("blf.chunk.meta");
+function attach_chunk_metadata(target, info) {
+    Object.defineProperty(target, BLF_CHUNK_META, {
+        value: info,
+        enumerable: false,
+        configurable: false,
+    });
+    for (const key of ["signature", "version", "major", "minor"]) {
+        Object.defineProperty(target.prototype, key, {
+            get() {
+                return info[key];
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    }
+}
+function chunk_info(signature, version) {
+    if (signature.length !== 4) {
+        throw new BlfError(`BLF chunk signature must be exactly 4 characters, got ${signature.length}: "${signature}"`);
+    }
+    const parsed = parse_blf_chunk_version(version);
+    return {
+        signature,
+        version,
+        major: parsed.major,
+        minor: parsed.minor,
+    };
+}
+/**
+ * Registers BLF signature/version on the class (runtime getters + constructor meta).
+ * Implement {@link BLFChunk} `read_body` / `write_body`, or extend {@link CStructBLFChunk} with `@c.struct`.
+ */
+export function chunk(signature, version) {
+    const info = chunk_info(signature, version);
+    return (target, _context) => {
+        attach_chunk_metadata(target, info);
+        return target;
+    };
+}
+/** `@blf.chunk` decorator and namespace. */
+export const blf = { chunk };
+export function getBlfChunkMeta(from) {
+    if (typeof from === "function") {
+        const meta = from[BLF_CHUNK_META];
+        if (!meta) {
+            throw new BlfError(`${from.name} is not decorated with @blf.chunk`);
+        }
+        return meta;
+    }
+    const inst = from;
+    return {
+        signature: inst.signature,
+        version: inst.version,
+        major: inst.major,
+        minor: inst.minor,
+    };
+}
+export function createBlfChunk(ctor) {
+    return new ctor();
+}
+export function chunkMatches(header, meta) {
+    return (header.signature === meta.signature &&
+        header.major === meta.major &&
+        header.minor === meta.minor);
+}

package/dist/error.d.ts

@@ -0,0 +1,4 @@
+export declare class BlfError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/error.js

@@ -0,0 +1,6 @@
+export class BlfError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BlfError";
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * as bitstream from "./bitstream";
+export * from "./blam/common";
+export { type BLFChunk, BLFChunkBase, type BLFChunkConstructor as BlfChunkConstructor, type BLFChunkInfo as BlfChunkInfo, blf, CStructBLFChunk, find_chunk, type IBLFChunk, search_for_chunk, } from "./blf_chunk";
+export { write_blffile } from "./blffile";
+export { BlfError } from "./error";
+export { s_blf_header } from "./s_blf_header";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,cAAc,eAAe,CAAC;AAE9B,OAAO,EACL,KAAK,QAAQ,EACb,YAAY,EACZ,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,YAAY,IAAI,YAAY,EACjC,GAAG,EACH,eAAe,EACf,UAAU,EACV,KAAK,SAAS,EACd,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * as bitstream from "./bitstream";
+export * from "./blam/common";
+export { BLFChunkBase, blf, CStructBLFChunk, find_chunk, search_for_chunk, } from "./blf_chunk";
+export { write_blffile } from "./blffile";
+export { BlfError } from "./error";
+export { s_blf_header } from "./s_blf_header";