quake2ts 0.0.573 → 0.0.575

package/packages/engine/dist/cjs/index.cjs

@@ -107,6 +107,7 @@ __export(index_exports, {
   SoundRegistry: () => SoundRegistry,
   SpriteLoader: () => SpriteLoader,
   SpriteParseError: () => SpriteParseError,
+  StreamingPakArchive: () => StreamingPakArchive,
   Texture2D: () => Texture2D,
   TextureCache: () => TextureCache,
   TextureCubeMap: () => TextureCubeMap,
@@ -2108,9 +2109,116 @@ function calculatePakChecksum(buffer) {
   return crc32(new Uint8Array(buffer));
 }
 
-// src/assets/pakWriter.ts
+// src/assets/streamingPak.ts
+var PAK_MAGIC2 = "PACK";
 var HEADER_SIZE2 = 12;
 var DIRECTORY_ENTRY_SIZE2 = 64;
+function normalizePath2(path) {
+  return path.replace(/\\/g, "/").replace(/^\/+/, "").toLowerCase();
+}
+var StreamingPakArchive = class {
+  constructor(source) {
+    this.source = source;
+    this.entries = null;
+  }
+  /**
+   * Read directory asynchronously.
+   * Caches the result so subsequent calls are fast.
+   */
+  async readDirectory() {
+    if (this.entries) {
+      return Array.from(this.entries.values());
+    }
+    const headerBuffer = await this.readChunk(0, HEADER_SIZE2);
+    const headerView = new DataView(headerBuffer);
+    const magic = String.fromCharCode(
+      headerView.getUint8(0),
+      headerView.getUint8(1),
+      headerView.getUint8(2),
+      headerView.getUint8(3)
+    );
+    if (magic !== PAK_MAGIC2) {
+      throw new PakParseError(`Invalid PAK header magic: ${magic}`);
+    }
+    const dirOffset = headerView.getInt32(4, true);
+    const dirLength = headerView.getInt32(8, true);
+    if (dirOffset < HEADER_SIZE2) {
+      throw new PakParseError(`Invalid directory offset: ${dirOffset}`);
+    }
+    if (dirLength < 0 || dirLength % DIRECTORY_ENTRY_SIZE2 !== 0) {
+      throw new PakParseError(`Invalid directory length: ${dirLength}`);
+    }
+    const dirBuffer = await this.readChunk(dirOffset, dirLength);
+    const dirView = new DataView(dirBuffer);
+    const entryCount = dirLength / DIRECTORY_ENTRY_SIZE2;
+    const entries = /* @__PURE__ */ new Map();
+    for (let i = 0; i < entryCount; i++) {
+      const offset = i * DIRECTORY_ENTRY_SIZE2;
+      const rawName = this.readCString(dirView, offset, 56);
+      const normalized = normalizePath2(rawName);
+      const fileOffset = dirView.getInt32(offset + 56, true);
+      const fileLength = dirView.getInt32(offset + 60, true);
+      if (fileOffset < 0 || fileLength < 0 || fileOffset + fileLength > this.source.size) {
+      }
+      if (normalized) {
+        entries.set(normalized, { name: normalized, offset: fileOffset, length: fileLength });
+      }
+    }
+    this.entries = entries;
+    return Array.from(entries.values());
+  }
+  /**
+   * Stream file contents on demand.
+   * Returns a ReadableStream of Uint8Array.
+   */
+  async readFile(path) {
+    const entry = await this.getEntry(path);
+    if (!entry) {
+      throw new PakParseError(`File not found in PAK: ${path}`);
+    }
+    const blob = this.source.slice(entry.offset, entry.offset + entry.length);
+    return blob.stream();
+  }
+  /**
+   * Get file as a Blob without loading entire file into memory.
+   */
+  async getFileBlob(path) {
+    const entry = await this.getEntry(path);
+    if (!entry) {
+      throw new PakParseError(`File not found in PAK: ${path}`);
+    }
+    return this.source.slice(entry.offset, entry.offset + entry.length);
+  }
+  async getEntry(path) {
+    if (!this.entries) {
+      await this.readDirectory();
+    }
+    return this.entries.get(normalizePath2(path));
+  }
+  async readChunk(offset, length2) {
+    const slice = this.source.slice(offset, offset + length2);
+    if ("arrayBuffer" in slice) {
+      return await slice.arrayBuffer();
+    } else {
+      return new Response(slice).arrayBuffer();
+    }
+  }
+  readCString(view, offset, maxLength) {
+    const codes = [];
+    for (let i = 0; i < maxLength; i += 1) {
+      const code = view.getUint8(offset + i);
+      if (code === 0) {
+        break;
+      }
+      codes.push(code);
+    }
+    return String.fromCharCode(...codes);
+  }
+};
+
+// src/assets/pakWriter.ts
+var HEADER_SIZE3 = 12;
+var DIRECTORY_ENTRY_SIZE3 = 64;
 var PakWriter = class _PakWriter {
   constructor() {
     this.entries = /* @__PURE__ */ new Map();
@@ -2143,18 +2251,18 @@ var PakWriter = class _PakWriter {
     for (const data of this.entries.values()) {
       fileDataSize += data.byteLength;
     }
-    const directorySize = this.entries.size * DIRECTORY_ENTRY_SIZE2;
-    const totalSize = HEADER_SIZE2 + fileDataSize + directorySize;
+    const directorySize = this.entries.size * DIRECTORY_ENTRY_SIZE3;
+    const totalSize = HEADER_SIZE3 + fileDataSize + directorySize;
     const buffer = new Uint8Array(totalSize);
     const view = new DataView(buffer.buffer);
     view.setUint8(0, "P".charCodeAt(0));
     view.setUint8(1, "A".charCodeAt(0));
     view.setUint8(2, "C".charCodeAt(0));
     view.setUint8(3, "K".charCodeAt(0));
-    const dirOffset = HEADER_SIZE2 + fileDataSize;
+    const dirOffset = HEADER_SIZE3 + fileDataSize;
     view.setInt32(4, dirOffset, true);
     view.setInt32(8, directorySize, true);
-    let currentOffset = HEADER_SIZE2;
+    let currentOffset = HEADER_SIZE3;
     const fileOffsets = /* @__PURE__ */ new Map();
     const sortedKeys = Array.from(this.entries.keys()).sort();
     for (const name of sortedKeys) {
@@ -2180,7 +2288,7 @@ var PakWriter = class _PakWriter {
       }
       view.setInt32(dirEntryOffset + 56, fileOffsets.get(name), true);
       view.setInt32(dirEntryOffset + 60, data.byteLength, true);
-      dirEntryOffset += DIRECTORY_ENTRY_SIZE2;
+      dirEntryOffset += DIRECTORY_ENTRY_SIZE3;
     }
     return buffer;
   }
@@ -2812,7 +2920,7 @@ function wireFileInput(input, handler) {
 var BSP_MAGIC = "IBSP";
 var BSP_VERSION = 38;
 var HEADER_LUMPS = 19;
-var HEADER_SIZE3 = 4 + 4 + HEADER_LUMPS * 8;
+var HEADER_SIZE4 = 4 + 4 + HEADER_LUMPS * 8;
 var BspParseError = class extends Error {
 };
 var BspLoader = class {
@@ -2827,7 +2935,7 @@ var BspLoader = class {
   }
 };
 function parseBsp(buffer) {
-  if (buffer.byteLength < HEADER_SIZE3) {
+  if (buffer.byteLength < HEADER_SIZE4) {
     throw new BspParseError("BSP too small to contain header");
   }
   const view = new DataView(buffer);
@@ -3280,7 +3388,7 @@ function createFaceLightmap(face, lightMaps, info) {
 // src/assets/md2.ts
 var MD2_MAGIC = 844121161;
 var MD2_VERSION = 8;
-var HEADER_SIZE4 = 17 * 4;
+var HEADER_SIZE5 = 17 * 4;
 var MD2_NORMALS = [
   { x: -0.525731, y: 0, z: 0.850651 },
   { x: -0.442863, y: 0.238856, z: 0.864188 },
@@ -3478,12 +3586,12 @@ function readCString2(view, offset, maxLength) {
 }
 function validateSection(buffer, offset, length2, label) {
   if (length2 === 0) return;
-  if (offset < HEADER_SIZE4 || offset + length2 > buffer.byteLength) {
+  if (offset < HEADER_SIZE5 || offset + length2 > buffer.byteLength) {
     throw new Md2ParseError(`${label} section is out of bounds`);
   }
 }
 function parseHeader(buffer) {
-  if (buffer.byteLength < HEADER_SIZE4) {
+  if (buffer.byteLength < HEADER_SIZE5) {
     throw new Md2ParseError("MD2 buffer too small to contain header");
   }
   const view = new DataView(buffer);
@@ -3920,7 +4028,7 @@ var Md3Loader = class {
 var IDSPRITEHEADER = 844317769;
 var SPRITE_VERSION = 2;
 var MAX_SKINNAME = 64;
-var HEADER_SIZE5 = 12;
+var HEADER_SIZE6 = 12;
 var SpriteParseError = class extends Error {
 };
 function readCString3(view, offset, maxLength) {
@@ -3933,7 +4041,7 @@ function readCString3(view, offset, maxLength) {
   return String.fromCharCode(...chars);
 }
 function parseSprite(buffer) {
-  if (buffer.byteLength < HEADER_SIZE5) {
+  if (buffer.byteLength < HEADER_SIZE6) {
     throw new SpriteParseError("Sprite buffer too small to contain header");
   }
   const view = new DataView(buffer);
@@ -3948,7 +4056,7 @@ function parseSprite(buffer) {
   }
   const frames = [];
   const frameSize = 16 + MAX_SKINNAME;
-  let offset = HEADER_SIZE5;
+  let offset = HEADER_SIZE6;
   for (let i = 0; i < numFrames; i += 1) {
     if (offset + frameSize > buffer.byteLength) {
       throw new SpriteParseError("Sprite frame data exceeds buffer length");
@@ -18118,6 +18226,7 @@ function createEngine(imports) {
   SoundRegistry,
   SpriteLoader,
   SpriteParseError,
+  StreamingPakArchive,
   Texture2D,
   TextureCache,
   TextureCubeMap,