@blamnetwork/blf 1.0.0-alpha.1

package/dist-cjs/s_blf_header.js

@@ -0,0 +1,117 @@
+"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_header = void 0;
+exports.parse_blf_chunk_version = parse_blf_chunk_version;
+const cstruct_1 = require("@craftycodie/cstruct");
+const chunk_signature_1 = require("./chunk_signature");
+const error_1 = require("./error");
+function parse_blf_chunk_version(version) {
+    if (typeof version === "number") {
+        version = version.toString();
+    }
+    const [majorStr, minorStr = "0"] = version.split(".");
+    const major = Number.parseInt(majorStr, 10);
+    const minor = Number.parseInt(minorStr, 10);
+    if (Number.isNaN(major) || Number.isNaN(minor)) {
+        throw new error_1.BlfError(`BLF chunk version must be major.minor (e.g. "1.1"), got "${version}"`);
+    }
+    return { major, minor };
+}
+let s_blf_header = (() => {
+    let _classDecorators = [cstruct_1.c.struct()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _signature_decorators;
+    let _signature_initializers = [];
+    let _signature_extraInitializers = [];
+    let _chunk_length_decorators;
+    let _chunk_length_initializers = [];
+    let _chunk_length_extraInitializers = [];
+    let _major_decorators;
+    let _major_initializers = [];
+    let _major_extraInitializers = [];
+    let _minor_decorators;
+    let _minor_initializers = [];
+    let _minor_extraInitializers = [];
+    var s_blf_header = class {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _signature_decorators = [cstruct_1.c.field((0, chunk_signature_1.chunkSignature)())];
+            _chunk_length_decorators = [cstruct_1.c.field("u32")];
+            _major_decorators = [cstruct_1.c.field("u16")];
+            _minor_decorators = [cstruct_1.c.field("u16")];
+            __esDecorate(null, null, _signature_decorators, { kind: "field", name: "signature", static: false, private: false, access: { has: obj => "signature" in obj, get: obj => obj.signature, set: (obj, value) => { obj.signature = value; } }, metadata: _metadata }, _signature_initializers, _signature_extraInitializers);
+            __esDecorate(null, null, _chunk_length_decorators, { kind: "field", name: "chunk_length", static: false, private: false, access: { has: obj => "chunk_length" in obj, get: obj => obj.chunk_length, set: (obj, value) => { obj.chunk_length = value; } }, metadata: _metadata }, _chunk_length_initializers, _chunk_length_extraInitializers);
+            __esDecorate(null, null, _major_decorators, { kind: "field", name: "major", static: false, private: false, access: { has: obj => "major" in obj, get: obj => obj.major, set: (obj, value) => { obj.major = value; } }, metadata: _metadata }, _major_initializers, _major_extraInitializers);
+            __esDecorate(null, null, _minor_decorators, { kind: "field", name: "minor", static: false, private: false, access: { has: obj => "minor" in obj, get: obj => obj.minor, set: (obj, value) => { obj.minor = value; } }, metadata: _metadata }, _minor_initializers, _minor_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            s_blf_header = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        signature = __runInitializers(this, _signature_initializers, "");
+        chunk_length = (__runInitializers(this, _signature_extraInitializers), __runInitializers(this, _chunk_length_initializers, 0));
+        major = (__runInitializers(this, _chunk_length_extraInitializers), __runInitializers(this, _major_initializers, 0));
+        minor = (__runInitializers(this, _major_extraInitializers), __runInitializers(this, _minor_initializers, 0));
+        static create(signature, chunk_length, major, minor) {
+            if (signature.length !== 4) {
+                throw new error_1.BlfError(`BLF chunk signature must be exactly 4 characters, got ${signature.length}: "${signature}"`);
+            }
+            if (!Number.isInteger(chunk_length) || chunk_length < 0) {
+                throw new error_1.BlfError(`BLF chunk length must be a non-negative integer, got ${chunk_length}`);
+            }
+            const header = new s_blf_header();
+            header.signature = signature;
+            header.chunk_length = chunk_length;
+            header.major = major;
+            header.minor = minor;
+            return header;
+        }
+        /** Build from a `major.minor` float (e.g. `1.1`). */
+        static from_version_float(signature, chunk_length, version) {
+            const { major, minor } = parse_blf_chunk_version(version);
+            return s_blf_header.create(signature, chunk_length, major, minor);
+        }
+        constructor() {
+            __runInitializers(this, _minor_extraInitializers);
+        }
+    };
+    return s_blf_header = _classThis;
+})();
+exports.s_blf_header = s_blf_header;

package/dist-cjs/versions/halo3/v12070_08_09_05_2031_halo3_ship.js

@@ -0,0 +1,20 @@
+"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("../../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);

package/dist-cjs/versions/halo3odst/v13895_09_04_27_2201_atlas_release.js

@@ -0,0 +1,20 @@
+"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("../../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);

package/dist-cjs/versions/haloreach/v12065_11_08_24_1738_tu1actual.js

@@ -0,0 +1,25 @@
+"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/v12065_11_08_24_1738_tu1actual"), 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_author"), exports);
+__exportStar(require("../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_content_header"), exports);
+__exportStar(require("../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_game_variant"), exports);
+__exportStar(require("../../chunks/haloreach/v12065_11_08_24_1738_tu1actual/s_blf_chunk_packed_game_variant"), exports);

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@blamnetwork/blf",
+  "version": "1.0.0-alpha.1",
+  "description": "BLF chunk library for Halo (TypeScript)",
+  "type": "module",
+  "main": "./dist-cjs/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "haloreach/*": [
+        "./dist/versions/haloreach/*"
+      ],
+      "halo3/*": [
+        "./dist/versions/halo3/*"
+      ],
+      "halo3odst/*": [
+        "./dist/versions/halo3odst/*"
+      ]
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.js",
+      "default": "./dist/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"
+    },
+    "./halo3/*": {
+      "types": "./dist/versions/halo3/*.d.ts",
+      "import": "./dist/versions/halo3/*.js",
+      "require": "./dist-cjs/versions/halo3/*.js",
+      "default": "./dist/versions/halo3/*.js"
+    },
+    "./halo3odst/*": {
+      "types": "./dist/versions/halo3odst/*.d.ts",
+      "import": "./dist/versions/halo3odst/*.js",
+      "require": "./dist-cjs/versions/halo3odst/*.js",
+      "default": "./dist/versions/halo3odst/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "dist-cjs"
+  ],
+  "scripts": {
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && tsc -p tsconfig.build.cjs.json && node scripts/write-cjs-package-json.mjs",
+    "check": "ultracite check",
+    "fix": "ultracite fix",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "validate": "npm run check && npm run test && npm run typecheck",
+    "release": "node scripts/release.mjs",
+    "prepack": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blam-Network/blf.git",
+    "directory": "blf-ts"
+  },
+  "bugs": {
+    "url": "https://github.com/Blam-Network/blf/issues"
+  },
+  "homepage": "https://github.com/Blam-Network/blf/tree/main/blf-ts#readme",
+  "keywords": [
+    "blf",
+    "halo",
+    "haloreach",
+    "halo3",
+    "halo3odst",
+    "chunks",
+    "binary",
+    "fileshare"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@craftycodie/cstruct": "^1.0.0-alpha.10",
+    "js-sha1": "^0.7.0",
+    "pako": "^2.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.15",
+    "@swc/core": "^1.15.33",
+    "@types/node": "^22",
+    "@types/pako": "^2.0.3",
+    "typescript": "^5",
+    "ultracite": "7.7.0",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^3.2.4"
+  }
+}