@blamnetwork/blf 1.0.0-beta.1 → 1.0.0-beta.4

package/dist/helpers/game_variant_json.js

@@ -0,0 +1,121 @@
+/**
+ * JSON round-trip for game variant class graphs.
+ *
+ * Uses `c.json` when a type is decorated with `@c.struct()`.
+ * Bitstream-decoded game variant types fall back to a cstruct-compatible walk
+ * that preserves numeric enums and serializes bigint values as strings.
+ */
+import { c } from "@craftycodie/cstruct";
+function hasStructLayout(ctor) {
+    return c.CSTRUCT_LAYOUT in ctor;
+}
+function instanceToJson(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (value instanceof Uint8Array) {
+        return { __bytes__: Buffer.from(value).toString("hex") };
+    }
+    if (typeof value !== "object") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(instanceToJson);
+    }
+    const out = {};
+    for (const key of Object.keys(value)) {
+        out[key] = instanceToJson(value[key]);
+    }
+    return out;
+}
+function resolveTargetConstructor(templateValue, ctorMap) {
+    if (templateValue === null ||
+        typeof templateValue !== "object" ||
+        Array.isArray(templateValue)) {
+        return;
+    }
+    const sourceCtor = templateValue.constructor;
+    if (typeof sourceCtor !== "function") {
+        return;
+    }
+    return (ctorMap.get(sourceCtor) ??
+        sourceCtor);
+}
+function jsonToInstance(Ctor, json, template, ctorMap) {
+    if (json === null || json === undefined) {
+        return json;
+    }
+    if (typeof json !== "object") {
+        return json;
+    }
+    if (Array.isArray(json)) {
+        const templateArray = Array.isArray(template) ? template : [];
+        return json.map((item, index) => {
+            const itemTemplate = templateArray[index] ?? templateArray[0];
+            const itemCtor = resolveTargetConstructor(itemTemplate, ctorMap);
+            if (itemCtor && typeof item === "object" && item !== null) {
+                return jsonToInstance(itemCtor, item, itemTemplate, ctorMap);
+            }
+            return item;
+        });
+    }
+    const TargetCtor = ctorMap.get(Ctor) ?? Ctor;
+    const instance = new TargetCtor();
+    const templateRecord = template !== null &&
+        typeof template === "object" &&
+        !Array.isArray(template)
+        ? template
+        : {};
+    for (const key of Object.keys(json)) {
+        const jsonValue = json[key];
+        const templateValue = templateRecord[key];
+        const nestedCtor = resolveTargetConstructor(templateValue, ctorMap);
+        if (nestedCtor &&
+            typeof jsonValue === "object" &&
+            jsonValue !== null &&
+            !Array.isArray(jsonValue)) {
+            instance[key] = jsonToInstance(nestedCtor, jsonValue, templateValue, ctorMap);
+            continue;
+        }
+        if (Array.isArray(jsonValue)) {
+            instance[key] = jsonToInstance(TargetCtor, jsonValue, templateValue, ctorMap);
+            continue;
+        }
+        instance[key] = jsonValue;
+    }
+    return instance;
+}
+/** Serialize a game variant instance to a cstruct-compatible JSON object. */
+export function variantToJson(ctor, instance) {
+    if (hasStructLayout(ctor)) {
+        return c.json(ctor, instance);
+    }
+    return instanceToJson(instance);
+}
+/** Build a game variant instance from JSON, optionally remapping nested constructors. */
+export function variantFromJson(ctor, json, template, ctorMap = new Map()) {
+    return jsonToInstance(ctor, json, template ?? new ctor(), ctorMap);
+}
+/** Pair same-named exports from two version bundles for cross-build hydration. */
+export function buildCrossVersionConstructorMap(sourceModule, targetModule) {
+    const map = new Map();
+    for (const key of Object.keys(sourceModule)) {
+        const sourceExport = sourceModule[key];
+        const targetExport = targetModule[key];
+        if (typeof sourceExport === "function" &&
+            typeof targetExport === "function") {
+            map.set(sourceExport, targetExport);
+        }
+    }
+    return map;
+}
+/** Deep-clone a variant instance through JSON using cstruct-compatible encoding. */
+export function cloneVariantViaJson(ctor, instance, template, ctorMap = new Map()) {
+    return variantFromJson(ctor, variantToJson(ctor, instance), template, ctorMap);
+}

package/dist/helpers/index.d.ts

@@ -1,2 +1,2 @@
-export { convert_reach_gametype } from "./convert_reach_gametype";
+export { convert_reach_gametype, e_reach_gametype_conversion_error, } from "./convert_reach_gametype";
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,0BAA0B,CAAC"}

package/dist/helpers/index.js

@@ -1 +1 @@
-export { convert_reach_gametype } from "./convert_reach_gametype";
+export { convert_reach_gametype, e_reach_gametype_conversion_error, } from "./convert_reach_gametype";

package/dist/helpers/reach_gametype_automap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Registers AutoMapper cross-version profiles for Reach gametype conversion.
+ * Mapping metadata comes from `@AutoMap()` on game classes.
+ */
+import { type ClassConstructor } from "../automapper";
+export declare const MCC_TO_TU1_CTORS: Map<ClassConstructor, ClassConstructor>;
+export declare const TU1_TO_MCC_CTORS: Map<ClassConstructor, ClassConstructor>;
+export declare const mccToTu1Mapper: import("@automapper/core").Mapper;
+export declare const tu1ToMccMapper: import("@automapper/core").Mapper;
+//# sourceMappingURL=reach_gametype_automap.d.ts.map

package/dist/helpers/reach_gametype_automap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach_gametype_automap.d.ts","sourceRoot":"","sources":["../../src/helpers/reach_gametype_automap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,KAAK,gBAAgB,EAMtB,MAAM,eAAe,CAAC;AAiCvB,eAAO,MAAM,gBAAgB,yCAA+C,CAAC;AAC7E,eAAO,MAAM,gBAAgB,yCAA+C,CAAC;AAE7E,eAAO,MAAM,cAAc,mCAAwB,CAAC;AACpD,eAAO,MAAM,cAAc,mCAAwB,CAAC"}

package/dist/helpers/reach_gametype_automap.js

@@ -0,0 +1,45 @@
+/**
+ * Registers AutoMapper cross-version profiles for Reach gametype conversion.
+ * Mapping metadata comes from `@AutoMap()` on game classes.
+ */
+import { createClassesMapper, createMapWithEnumByName, installStage3AutoMapperMetadataForCtorMap, } from "../automapper";
+import * as tu1_game from "../blam/haloreach/v12065_11_08_24_1738_tu1actual/game";
+import { c_game_variant as c_game_variant_tu1 } from "../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import * as mcc_game from "../blam/haloreach_mcc/v_untracked_25_08_16_1352/game";
+import { c_game_variant as c_game_variant_mcc } from "../blam/haloreach_mcc/v_untracked_25_08_16_1352/game/c_game_variant";
+function isClassConstructor(value) {
+    return (typeof value === "function" &&
+        value.prototype !== undefined &&
+        value.prototype.constructor === value);
+}
+function buildClassConstructorMap(sourceModule, targetModule) {
+    const map = new Map();
+    for (const key of Object.keys(sourceModule)) {
+        const sourceExport = sourceModule[key];
+        const targetExport = targetModule[key];
+        if (isClassConstructor(sourceExport) &&
+            isClassConstructor(targetExport) &&
+            sourceExport !== targetExport) {
+            map.set(sourceExport, targetExport);
+        }
+    }
+    return map;
+}
+export const MCC_TO_TU1_CTORS = buildClassConstructorMap(mcc_game, tu1_game);
+export const TU1_TO_MCC_CTORS = buildClassConstructorMap(tu1_game, mcc_game);
+export const mccToTu1Mapper = createClassesMapper();
+export const tu1ToMccMapper = createClassesMapper();
+installStage3AutoMapperMetadataForCtorMap(MCC_TO_TU1_CTORS, c_game_variant_mcc, c_game_variant_tu1);
+installStage3AutoMapperMetadataForCtorMap(TU1_TO_MCC_CTORS, c_game_variant_tu1, c_game_variant_mcc);
+function registerCrossVersionProfiles(mapper, ctorMap, rootSource, rootDest, modulePairs) {
+    const pairs = new Map();
+    for (const [sourceCtor, destCtor] of ctorMap) {
+        pairs.set(sourceCtor, destCtor);
+    }
+    pairs.set(rootSource, rootDest);
+    for (const [source, dest] of pairs) {
+        createMapWithEnumByName(mapper, source, dest, modulePairs);
+    }
+}
+registerCrossVersionProfiles(mccToTu1Mapper, MCC_TO_TU1_CTORS, c_game_variant_mcc, c_game_variant_tu1, [[mcc_game, tu1_game]]);
+registerCrossVersionProfiles(tu1ToMccMapper, TU1_TO_MCC_CTORS, c_game_variant_tu1, c_game_variant_mcc, [[tu1_game, mcc_game]]);

package/dist/helpers/reach_gametype_automapper.d.ts

@@ -0,0 +1,5 @@
+import { c_game_variant as c_game_variant_tu1 } from "../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { c_game_variant as c_game_variant_mcc } from "../blam/haloreach_mcc/v_untracked_25_08_16_1352/game/c_game_variant";
+export declare function map_reach_gametype_mcc_to_tu1(from: c_game_variant_mcc): c_game_variant_tu1;
+export declare function map_reach_gametype_tu1_to_mcc(from: c_game_variant_tu1): c_game_variant_mcc;
+//# sourceMappingURL=reach_gametype_automapper.d.ts.map

package/dist/helpers/reach_gametype_automapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach_gametype_automapper.d.ts","sourceRoot":"","sources":["../../src/helpers/reach_gametype_automapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,sEAAsE,CAAC;AAC5H,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,qEAAqE,CAAC;AAG3H,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,CAEpB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,kBAAkB,GACvB,kBAAkB,CAEpB"}

package/dist/helpers/reach_gametype_automapper.js

@@ -0,0 +1,9 @@
+import { c_game_variant as c_game_variant_tu1 } from "../blam/haloreach/v12065_11_08_24_1738_tu1actual/game/c_game_variant";
+import { c_game_variant as c_game_variant_mcc } from "../blam/haloreach_mcc/v_untracked_25_08_16_1352/game/c_game_variant";
+import { mccToTu1Mapper, tu1ToMccMapper } from "./reach_gametype_automap";
+export function map_reach_gametype_mcc_to_tu1(from) {
+    return mccToTu1Mapper.map(from, c_game_variant_mcc, c_game_variant_tu1);
+}
+export function map_reach_gametype_tu1_to_mcc(from) {
+    return tu1ToMccMapper.map(from, c_game_variant_tu1, c_game_variant_mcc);
+}

package/dist/helpers/reach_gametype_conversion_error.d.ts

@@ -0,0 +1,11 @@
+/** Result codes for Reach TU1 ↔ MCC gametype conversion. */
+export declare enum e_reach_gametype_conversion_error {
+    ok = 0,
+    forge_variant = 1,
+    campaign_variant = 2,
+    mcc_exclusive_action = 3,
+    mcc_exclusive_math_operator = 4,
+    mcc_survival_additional_flags = 5,
+    insufficient_global_slots = 6
+}
+//# sourceMappingURL=reach_gametype_conversion_error.d.ts.map

package/dist/helpers/reach_gametype_conversion_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reach_gametype_conversion_error.d.ts","sourceRoot":"","sources":["../../src/helpers/reach_gametype_conversion_error.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,oBAAY,iCAAiC;IAC3C,EAAE,IAAI;IACN,aAAa,IAAI;IACjB,gBAAgB,IAAI;IACpB,oBAAoB,IAAI;IACxB,2BAA2B,IAAI;IAC/B,6BAA6B,IAAI;IACjC,yBAAyB,IAAI;CAC9B"}

package/dist/helpers/reach_gametype_conversion_error.js

@@ -0,0 +1,11 @@
+/** Result codes for Reach TU1 ↔ MCC gametype conversion. */
+export var e_reach_gametype_conversion_error;
+(function (e_reach_gametype_conversion_error) {
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["ok"] = 0] = "ok";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["forge_variant"] = 1] = "forge_variant";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["campaign_variant"] = 2] = "campaign_variant";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["mcc_exclusive_action"] = 3] = "mcc_exclusive_action";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["mcc_exclusive_math_operator"] = 4] = "mcc_exclusive_math_operator";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["mcc_survival_additional_flags"] = 5] = "mcc_survival_additional_flags";
+    e_reach_gametype_conversion_error[e_reach_gametype_conversion_error["insufficient_global_slots"] = 6] = "insufficient_global_slots";
+})(e_reach_gametype_conversion_error || (e_reach_gametype_conversion_error = {}));

package/dist/types/static_array.d.ts

@@ -0,0 +1,6 @@
+/** Fixed-length array type matching blf_lib `StaticArray<T, N>`. */
+type BuildStaticArray<T, N extends number, Acc extends readonly T[] = []> = Acc["length"] extends N ? Acc : BuildStaticArray<T, N, readonly [...Acc, T]>;
+export type StaticArray<T, N extends number> = BuildStaticArray<T, N>;
+export declare function staticArray<const N extends number, T>(length: N, init: () => T): StaticArray<T, N>;
+export {};
+//# sourceMappingURL=static_array.d.ts.map

package/dist/types/static_array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static_array.d.ts","sourceRoot":"","sources":["../../src/types/static_array.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,KAAK,gBAAgB,CACnB,CAAC,EACD,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,SAAS,CAAC,EAAE,GAAG,EAAE,IAC3B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GACvB,GAAG,GACH,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjD,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEtE,wBAAgB,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EACnD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,MAAM,CAAC,GACZ,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAEnB"}

package/dist/types/static_array.js

@@ -0,0 +1,3 @@
+export function staticArray(length, init) {
+    return Array.from({ length }, init);
+}

package/dist/versions/haloreach/v12065_11_08_24_1738_tu1actual.d.ts

@@ -6,5 +6,6 @@ export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_st
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_author";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant";
+export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_map_variant";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant";
 //# sourceMappingURL=v12065_11_08_24_1738_tu1actual.d.ts.map

package/dist/versions/haloreach/v12065_11_08_24_1738_tu1actual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v12065_11_08_24_1738_tu1actual.d.ts","sourceRoot":"","sources":["../../../src/versions/haloreach/v12065_11_08_24_1738_tu1actual.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qDAAqD,CAAC;AACpE,cAAc,gFAAgF,CAAC;AAC/F,cAAc,4EAA4E,CAAC;AAC3F,cAAc,8EAA8E,CAAC;AAC7F,cAAc,0EAA0E,CAAC;AACzF,cAAc,kFAAkF,CAAC;AACjG,cAAc,gFAAgF,CAAC;AAC/F,cAAc,uFAAuF,CAAC"}
+{"version":3,"file":"v12065_11_08_24_1738_tu1actual.d.ts","sourceRoot":"","sources":["../../../src/versions/haloreach/v12065_11_08_24_1738_tu1actual.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qDAAqD,CAAC;AACpE,cAAc,gFAAgF,CAAC;AAC/F,cAAc,4EAA4E,CAAC;AAC3F,cAAc,8EAA8E,CAAC;AAC7F,cAAc,0EAA0E,CAAC;AACzF,cAAc,kFAAkF,CAAC;AACjG,cAAc,gFAAgF,CAAC;AAC/F,cAAc,+EAA+E,CAAC;AAC9F,cAAc,uFAAuF,CAAC"}

package/dist/versions/haloreach/v12065_11_08_24_1738_tu1actual.js

@@ -6,4 +6,5 @@ export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_st
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_author";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant";
+export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_map_variant";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant";

package/dist/versions/haloreach_mcc/{v_untracked_25_08_19_1352.js → v_untracked_25_08_16_1352.d.ts}

@@ -1,8 +1,10 @@
 export * from "../../blam/common";
-export * from "../../blam/haloreach_mcc/v_untracked_25_08_19_1352";
+export * from "../../blam/haloreach_mcc/v_untracked_25_08_16_1352";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_compressed_data";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_end_of_file";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_start_of_file";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header";
-export * from "../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_game_variant";
-export * from "../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_packed_game_variant";
+export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_map_variant";
+export * from "../../chunks/haloreach_mcc/v_untracked_25_08_16_1352/s_blf_chunk_game_variant";
+export * from "../../chunks/haloreach_mcc/v_untracked_25_08_16_1352/s_blf_chunk_packed_game_variant";
+//# sourceMappingURL=v_untracked_25_08_16_1352.d.ts.map

package/dist/versions/haloreach_mcc/{v_untracked_25_08_19_1352.d.ts.map → v_untracked_25_08_16_1352.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"v_untracked_25_08_19_1352.d.ts","sourceRoot":"","sources":["../../../src/versions/haloreach_mcc/v_untracked_25_08_19_1352.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oDAAoD,CAAC;AACnE,cAAc,gFAAgF,CAAC;AAC/F,cAAc,4EAA4E,CAAC;AAC3F,cAAc,8EAA8E,CAAC;AAC7F,cAAc,kFAAkF,CAAC;AACjG,cAAc,+EAA+E,CAAC;AAC9F,cAAc,sFAAsF,CAAC"}
+{"version":3,"file":"v_untracked_25_08_16_1352.d.ts","sourceRoot":"","sources":["../../../src/versions/haloreach_mcc/v_untracked_25_08_16_1352.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oDAAoD,CAAC;AACnE,cAAc,gFAAgF,CAAC;AAC/F,cAAc,4EAA4E,CAAC;AAC3F,cAAc,8EAA8E,CAAC;AAC7F,cAAc,kFAAkF,CAAC;AACjG,cAAc,+EAA+E,CAAC;AAC9F,cAAc,+EAA+E,CAAC;AAC9F,cAAc,sFAAsF,CAAC"}

package/dist/versions/haloreach_mcc/{v_untracked_25_08_19_1352.d.ts → v_untracked_25_08_16_1352.js}

@@ -1,9 +1,9 @@
 export * from "../../blam/common";
-export * from "../../blam/haloreach_mcc/v_untracked_25_08_19_1352";
+export * from "../../blam/haloreach_mcc/v_untracked_25_08_16_1352";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_compressed_data";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_end_of_file";
 export * from "../../chunks/halo3/v12070_08_09_05_2031_halo3_ship/s_blf_chunk_start_of_file";
 export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header";
-export * from "../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_game_variant";
-export * from "../../chunks/haloreach_mcc/v_untracked_25_08_19_1352/s_blf_chunk_packed_game_variant";
-//# sourceMappingURL=v_untracked_25_08_19_1352.d.ts.map
+export * from "../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_map_variant";
+export * from "../../chunks/haloreach_mcc/v_untracked_25_08_16_1352/s_blf_chunk_game_variant";
+export * from "../../chunks/haloreach_mcc/v_untracked_25_08_16_1352/s_blf_chunk_packed_game_variant";

package/dist/versions/mcc/v2025_08_16_178512_1_release.d.ts

@@ -0,0 +1,4 @@
+/** MCC menu build string (matches blf_lib `k_build_string_mcc_2025_08_16_178512_1_release` in `blf/versions/mcc`). */
+export declare const k_build_string_mcc_2025_08_16_178512_1_release: "2025.08.16.178512.1-Release";
+export * from "../../chunks/mcc/s_blf_chunk_fileshare_metadata";
+//# sourceMappingURL=v2025_08_16_178512_1_release.d.ts.map

package/dist/versions/mcc/v2025_08_16_178512_1_release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2025_08_16_178512_1_release.d.ts","sourceRoot":"","sources":["../../../src/versions/mcc/v2025_08_16_178512_1_release.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,eAAO,MAAM,8CAA8C,EACzD,6BAAsC,CAAC;AAEzC,cAAc,iDAAiD,CAAC"}

package/dist/versions/mcc/v2025_08_16_178512_1_release.js

@@ -0,0 +1,3 @@
+/** MCC menu build string (matches blf_lib `k_build_string_mcc_2025_08_16_178512_1_release` in `blf/versions/mcc`). */
+export const k_build_string_mcc_2025_08_16_178512_1_release = "2025.08.16.178512.1-Release";
+export * from "../../chunks/mcc/s_blf_chunk_fileshare_metadata";

package/dist-cjs/automapper/create_map.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMapWithEnumByName = createMapWithEnumByName;
+const core_1 = require("@automapper/core");
+const enum_by_name_1 = require("./enum_by_name");
+/** `createMap` with enum-by-name converters derived from module export pairs. */
+function createMapWithEnumByName(mapper, source, destination, modulePairs, ...configurations) {
+    return (0, core_1.createMap)(mapper, source, destination, ...(0, enum_by_name_1.enumTypeConverterConfigs)(...modulePairs), ...configurations);
+}

package/dist-cjs/automapper/create_mapper.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClassesMapper = createClassesMapper;
+const classes_1 = require("@automapper/classes");
+const core_1 = require("@automapper/core");
+/** Standard BLF mapper using the `@automapper/classes` strategy. */
+function createClassesMapper(options = {}) {
+    return (0, core_1.createMapper)({
+        ...options,
+        strategyInitializer: (mapper) => (0, classes_1.classes)()(mapper),
+    });
+}

package/dist-cjs/automapper/enum_by_name.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * AutoMapper enum conversion by member name (not ordinal).
+ *
+ * TypeScript numeric enums on the wire are plain numbers; AutoMapper copies them
+ * as-is unless a `typeConverter` is registered. Use these helpers when paired
+ * enums share member names but differ in numeric values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTypeScriptEnum = isTypeScriptEnum;
+exports.convertEnumByName = convertEnumByName;
+exports.enumTypeConverterConfigs = enumTypeConverterConfigs;
+const core_1 = require("@automapper/core");
+const enumTypeConverter = core_1.typeConverter;
+function isTypeScriptEnum(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    let hasNamedMember = false;
+    const record = value;
+    for (const key of Object.keys(record)) {
+        if (Number.isNaN(Number(key))) {
+            hasNamedMember = typeof record[key] === "number";
+        }
+    }
+    return hasNamedMember;
+}
+function convertEnumByName(sourceEnum, destEnum, ordinal) {
+    const name = sourceEnum[ordinal];
+    if (typeof name !== "string") {
+        return ordinal;
+    }
+    const destOrdinal = destEnum[name];
+    return typeof destOrdinal === "number" ? destOrdinal : ordinal;
+}
+/** Build shared enum `typeConverter` configs from one or more module export pairs. */
+function enumTypeConverterConfigs(...modulePairs) {
+    const configs = [];
+    const registered = new Set();
+    for (const [sourceModule, destModule] of modulePairs) {
+        for (const key of Object.keys(sourceModule)) {
+            const sourceEnum = sourceModule[key];
+            const destEnum = destModule[key];
+            if (!(isTypeScriptEnum(sourceEnum) && isTypeScriptEnum(destEnum))) {
+                continue;
+            }
+            if (registered.has(key)) {
+                continue;
+            }
+            registered.add(key);
+            configs.push(enumTypeConverter(sourceEnum, destEnum, (value) => convertEnumByName(sourceEnum, destEnum, value)));
+        }
+    }
+    return configs;
+}

package/dist-cjs/automapper/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installStage3AutoMapperMetadataForMany = exports.installStage3AutoMapperMetadataForCtorMap = exports.installStage3AutoMapperMetadata = exports.isTypeScriptEnum = exports.enumTypeConverterConfigs = exports.convertEnumByName = exports.createClassesMapper = exports.createMapWithEnumByName = exports.stage3AutoMapMetadata = exports.AutoMap = exports.AUTOMAP_PROPERTIES_METADATA_KEY = void 0;
+var classes_1 = require("@automapper/classes");
+Object.defineProperty(exports, "AUTOMAP_PROPERTIES_METADATA_KEY", { enumerable: true, get: function () { return classes_1.AUTOMAP_PROPERTIES_METADATA_KEY; } });
+var automap_1 = require("../helpers/automap");
+Object.defineProperty(exports, "AutoMap", { enumerable: true, get: function () { return automap_1.AutoMap; } });
+Object.defineProperty(exports, "stage3AutoMapMetadata", { enumerable: true, get: function () { return automap_1.stage3AutoMapMetadata; } });
+var create_map_1 = require("./create_map");
+Object.defineProperty(exports, "createMapWithEnumByName", { enumerable: true, get: function () { return create_map_1.createMapWithEnumByName; } });
+var create_mapper_1 = require("./create_mapper");
+Object.defineProperty(exports, "createClassesMapper", { enumerable: true, get: function () { return create_mapper_1.createClassesMapper; } });
+var enum_by_name_1 = require("./enum_by_name");
+Object.defineProperty(exports, "convertEnumByName", { enumerable: true, get: function () { return enum_by_name_1.convertEnumByName; } });
+Object.defineProperty(exports, "enumTypeConverterConfigs", { enumerable: true, get: function () { return enum_by_name_1.enumTypeConverterConfigs; } });
+Object.defineProperty(exports, "isTypeScriptEnum", { enumerable: true, get: function () { return enum_by_name_1.isTypeScriptEnum; } });
+var stage3_metadata_1 = require("./stage3_metadata");
+Object.defineProperty(exports, "installStage3AutoMapperMetadata", { enumerable: true, get: function () { return stage3_metadata_1.installStage3AutoMapperMetadata; } });
+Object.defineProperty(exports, "installStage3AutoMapperMetadataForCtorMap", { enumerable: true, get: function () { return stage3_metadata_1.installStage3AutoMapperMetadataForCtorMap; } });
+Object.defineProperty(exports, "installStage3AutoMapperMetadataForMany", { enumerable: true, get: function () { return stage3_metadata_1.installStage3AutoMapperMetadataForMany; } });

package/dist-cjs/automapper/stage3_metadata.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installStage3AutoMapperMetadata = installStage3AutoMapperMetadata;
+exports.installStage3AutoMapperMetadataForMany = installStage3AutoMapperMetadataForMany;
+exports.installStage3AutoMapperMetadataForCtorMap = installStage3AutoMapperMetadataForCtorMap;
+const classes_1 = require("@automapper/classes");
+const automap_1 = require("../helpers/automap");
+function mergeMetadataEntries(existing, extra) {
+    const merged = new Map();
+    for (const entry of existing) {
+        merged.set(entry[0], entry);
+    }
+    for (const entry of extra) {
+        merged.set(entry[0], entry);
+    }
+    return [...merged.values()];
+}
+/** Bridge stage-3 `@AutoMap()` metadata into `@automapper/classes` factory hook. */
+function installStage3AutoMapperMetadata(ctor) {
+    const entries = (0, automap_1.stage3AutoMapMetadata)(ctor);
+    if (entries.length === 0) {
+        return;
+    }
+    const record = ctor;
+    const existingFactory = record[classes_1.AUTOMAPPER_METADATA_FACTORY_KEY];
+    record[classes_1.AUTOMAPPER_METADATA_FACTORY_KEY] = () => {
+        const existing = existingFactory?.() ?? [];
+        return mergeMetadataEntries(existing, entries);
+    };
+}
+function installStage3AutoMapperMetadataForMany(...ctors) {
+    for (const ctor of ctors) {
+        installStage3AutoMapperMetadata(ctor);
+    }
+}
+function installStage3AutoMapperMetadataForCtorMap(ctorMap, ...extra) {
+    const ctors = new Set(extra);
+    for (const [source, dest] of ctorMap) {
+        ctors.add(source);
+        ctors.add(dest);
+    }
+    installStage3AutoMapperMetadataForMany(...ctors);
+}

package/dist-cjs/bitstream/enum.js

@@ -1,9 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isNumericEnumValue = isNumericEnumValue;
+exports.enumMembersInDeclarationOrder = enumMembersInDeclarationOrder;
+exports.enumMemberFromWireIndex = enumMemberFromWireIndex;
+exports.enumWireIndexFromMember = enumWireIndexFromMember;
+exports.enumMembersIncludeValue = enumMembersIncludeValue;
 exports.assertFitsInBits = assertFitsInBits;
 const errors_1 = require("./errors");
-function isNumericEnumValue(enumObj, value) {
+/** Numeric enum members in source declaration order (wire index order). */
+function enumMembersInDeclarationOrder(enumObj) {
+    return Object.keys(enumObj)
+        .filter((key) => Number.isNaN(Number(key)))
+        .map((key) => enumObj[key]);
+}
+function enumMemberFromWireIndex(enumObj, index, name) {
+    const members = enumMembersInDeclarationOrder(enumObj);
+    if (!Number.isInteger(index) || index < 0 || index >= members.length) {
+        throw new errors_1.BitstreamError(`Unexpected enum value for ${name}: ${index}`);
+    }
+    return members[index];
+}
+function enumWireIndexFromMember(enumObj, member, name) {
+    const index = enumMembersInDeclarationOrder(enumObj).indexOf(member);
+    if (index === -1) {
+        throw new errors_1.BitstreamError(`Unexpected enum member for ${name}: ${member}`);
+    }
+    return index;
+}
+function enumMembersIncludeValue(enumObj, value) {
     for (const member of Object.values(enumObj)) {
         if (typeof member === "number" && member === value) {
             return true;

package/dist-cjs/bitstream/reader.js

@@ -207,10 +207,7 @@ class c_bitstream_reader {
             (0, enum_1.assertFitsInBits)(name, integer, size_in_bits);
             return integer;
         }
-        if (!(0, enum_1.isNumericEnumValue)(enumObjOrParser, integer)) {
-            throw new errors_1.BitstreamError(`Unexpected enum value for ${name}: ${integer}`);
-        }
-        return integer;
+        return (0, enum_1.enumMemberFromWireIndex)(enumObjOrParser, integer, name);
     }
     read_integer(_name, size_in_bits) {
         (0, errors_1.assert_ok)(size_in_bits > 0);
@@ -327,7 +324,7 @@ class c_bitstream_reader {
             const byte = this.read_integer("???", 8);
             bytes[i] = byte;
             if (byte === 0) {
-                return String.fromCharCode(...Array.from(bytes.subarray(0, i)));
+                return new TextDecoder("utf-8").decode(bytes.subarray(0, i));
             }
         }
         throw new errors_1.BitstreamError("Exceeded max string size reading utf8 string.");

package/dist-cjs/bitstream/writer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.c_bitstream_writer = void 0;
+const enum_1 = require("./enum");
 const enums_1 = require("./enums");
 const errors_1 = require("./errors");
 const math_1 = require("./math");
@@ -57,8 +58,8 @@ class c_bitstream_writer {
             this.current_stream_bit_position,
         ];
     }
-    write_enum(value, size_in_bits) {
-        this.write_integer(value, size_in_bits);
+    write_enum(value, size_in_bits, enumObj) {
+        this.write_integer((0, enum_1.enumWireIndexFromMember)(enumObj, value, "enum"), size_in_bits);
     }
     write_integer(value, size_in_bits) {
         (0, errors_1.assert_ok)(this.writing());

package/dist-cjs/blam/common/math/real_types.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.real_point3d_default = real_point3d_default;
+exports.real_bounds_default = real_bounds_default;
+exports.real_rectangle3d_default = real_rectangle3d_default;
+exports.point_in_rectangle3d = point_in_rectangle3d;
+function real_point3d_default() {
+    return { x: 0, y: 0, z: 0 };
+}
+function real_bounds_default() {
+    return { lower: 0, upper: 0 };
+}
+function real_rectangle3d_default() {
+    return {
+        x: real_bounds_default(),
+        y: real_bounds_default(),
+        z: real_bounds_default(),
+    };
+}
+function point_in_rectangle3d(point, rect) {
+    return (rect.x.lower <= point.x &&
+        point.x <= rect.x.upper &&
+        rect.y.lower <= point.y &&
+        point.y <= rect.y.upper &&
+        rect.z.lower <= point.z &&
+        point.z <= rect.z.upper);
+}

package/dist-cjs/blam/common/math/unit_vector_quantization.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_unit_vector_encoding_constants = get_unit_vector_encoding_constants;
+const k_unit_vector_quantization_minimum_bit_count = 6;
+const k_unit_vector_quantization_maximum_bit_count = 30;
+function compute_encoding_constants(bit_count) {
+    let mask = 0;
+    for (let i = 0, bit = bit_count - 2; bit >= 0; bit--, i++) {
+        if (i % 2 === 1) {
+            mask |= 1 << bit;
+        }
+    }
+    return {
+        actual_per_axis_max_count: mask,
+        quantized_value_count: Math.floor(Math.sqrt(mask)) - 1,
+    };
+}
+const g_unit_vector_generated_encoding_constants = Array.from({
+    length: k_unit_vector_quantization_maximum_bit_count -
+        k_unit_vector_quantization_minimum_bit_count +
+        1,
+}, (_, index) => compute_encoding_constants(index + k_unit_vector_quantization_minimum_bit_count));
+function get_unit_vector_encoding_constants(bit_count) {
+    if (bit_count < k_unit_vector_quantization_minimum_bit_count ||
+        bit_count > k_unit_vector_quantization_maximum_bit_count) {
+        throw new Error(`Invalid unit vector bit count: ${bit_count}`);
+    }
+    return g_unit_vector_generated_encoding_constants[bit_count - k_unit_vector_quantization_minimum_bit_count];
+}