@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/resource/formats/wem/CjsWemFormat.js

@@ -1,7 +1,8 @@
 import { asUint8Array } from '#utils/bytes';
 import { CjsFormat } from '../../format/CjsFormat.js';
-import { DEFAULT_VALUES, OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM, OUTPUT_WEM_JSON, normalizeValues, readWithValues, inspectWithValues, toJsonValue, isWEM, OUTPUT_JSON, WEM_CODEC_NAMES } from './core/helpers.js';
+import { DEFAULT_VALUES, OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM, OUTPUT_WEM_JSON, normalizeValues, readWithValues, inspectWithValues, isWEM, OUTPUT_JSON, WEM_CODEC_NAMES } from './core/helpers.js';
 import { probeCodecSupportWithValues } from './core/probeCodecSupport.js';
+import { toJsonWithByteSummary } from '../../format/jsonPolicies.js';
 
 const FORMAT_NAME = "CjsWemFormat";
 
@@ -97,7 +98,7 @@ class CjsWemFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   ToJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**
@@ -151,7 +152,7 @@ class CjsWemFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   static toJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**

package/dist/resource/formats/wem/CjsWemFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWemFormat.js","sources":["../../../../../src/resource/formats/wem/CjsWemFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_OGG,\n    OUTPUT_PCM,\n    OUTPUT_RAW,\n    OUTPUT_WEM_JSON,\n    WEM_CODEC_NAMES,\n    inspectWithValues,\n    probeSupportWithValues,\n    isWEM,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { probeCodecSupportWithValues } from \"./core/probeCodecSupport.js\";\n\nconst FORMAT_NAME = \"CjsWemFormat\";\n\n/**\n * Reader for Audiokinetic Wwise media (.wem) containers.\n *\n * Inspection identifies the codec, channel/rate layout, and Vorbis duration\n * without decoding audio data. Read emits the container bytes untouched by\n * default; `emit: \"ogg\"` repacks Wwise Vorbis into a standard Ogg stream and\n * `emit: \"pcm\"` decodes PTADPCM / 16-bit PCM media to float32 samples.\n */\nexport class CjsWemFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Browser-worker module declaration consumed by CjsResManWorkerLoader.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsWemFormat\",\n        outputTypes: Object.freeze([ OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM, OUTPUT_WEM_JSON ]),\n        defaultOutput: OUTPUT_RAW\n    });\n\n    /**\n     * Create a reusable wem format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsWemFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read wem bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read wem bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect wem bytes without decoding audio data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Wwise container metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot asynchronous wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsWemFormat.read(input, options);\n    }\n\n    /**\n     * One-shot wem inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Wwise container metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot wem support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeCodecSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a Wwise media container.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.\n     * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.\n     */\n    static isWEM(input)\n    {\n        try\n        {\n            return isWEM(asUint8Array(input, \"Wem input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.\n     *\n     * Lossless container transform (no audio decode/re-encode); output plays\n     * natively where Ogg Vorbis is supported. Equivalent to\n     * `read(input, { emit: \"ogg\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Options, including a `codebooks` override.\n     * @returns {object} Ogg payload with bytes, timing, and loop metadata.\n     */\n    static toOgg(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_OGG });\n    }\n\n    /**\n     * Decode wem audio data to per-channel float32 PCM (AudioBuffer-ready).\n     *\n     * Covers Wwise PTADPCM (0x8311) and uncompressed 16-bit PCM. Wwise Vorbis\n     * is not decoded here - repack it with `toOgg()` instead. Equivalent to\n     * `read(input, { emit: \"pcm\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} PCM payload with channelData, sample rate, and timing.\n     */\n    static toPcm(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_PCM });\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON,\n        WEM_JSON: OUTPUT_WEM_JSON,\n        OGG: OUTPUT_OGG,\n        PCM: OUTPUT_PCM\n    });\n    static CODEC_NAMES = WEM_CODEC_NAMES;\n    static id = \"wem\";\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static outputs = CjsFormat.defineOutputs({\n        raw: { default: true, passthrough: true },\n        ogg: {  },\n        pcm: { decoded: true },\n        wemJson: { role: \"debug\", probes: [ \"wemJson\", \"raw\" ] }\n    });\n    static extensions = Object.freeze([ \".wem\" ]);\n}\n\nexport default CjsWemFormat;\n"],"names":["FORMAT_NAME","CjsWemFormat","CjsFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_RAW","OUTPUT_OGG","OUTPUT_PCM","OUTPUT_WEM_JSON","defaultOutput","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeCodecSupportWithValues","toJSON","isWEM","asUint8Array","toOgg","emit","toPcm","Output","RAW","JSON","OUTPUT_JSON","WEM_JSON","OGG","PCM","CODEC_NAMES","WEM_CODEC_NAMES","id","mediaTypes","outputs","defineOutputs","raw","default","passthrough","ogg","pcm","decoded","wemJson","role","probes","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsWemFormat.js","sources":["../../../../../src/resource/formats/wem/CjsWemFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_OGG,\n    OUTPUT_PCM,\n    OUTPUT_RAW,\n    OUTPUT_WEM_JSON,\n    WEM_CODEC_NAMES,\n    inspectWithValues,\n    probeSupportWithValues,\n    isWEM,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { probeCodecSupportWithValues } from \"./core/probeCodecSupport.js\";\n\nconst FORMAT_NAME = \"CjsWemFormat\";\n\n/**\n * Reader for Audiokinetic Wwise media (.wem) containers.\n *\n * Inspection identifies the codec, channel/rate layout, and Vorbis duration\n * without decoding audio data. Read emits the container bytes untouched by\n * default; `emit: \"ogg\"` repacks Wwise Vorbis into a standard Ogg stream and\n * `emit: \"pcm\"` decodes PTADPCM / 16-bit PCM media to float32 samples.\n */\nexport class CjsWemFormat extends CjsFormat\n{\n    #values = DEFAULT_VALUES;\n\n    /**\n     * Browser-worker module declaration consumed by CjsResManWorkerLoader.\n     */\n    static worker = Object.freeze({\n        module: import.meta.url,\n        exportName: \"CjsWemFormat\",\n        outputTypes: Object.freeze([ OUTPUT_RAW, OUTPUT_OGG, OUTPUT_PCM, OUTPUT_WEM_JSON ]),\n        defaultOutput: OUTPUT_RAW\n    });\n\n    /**\n     * Create a reusable wem format profile.\n     *\n     * @param {object} [options] Default read/inspect options.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Merge options into this profile.\n     *\n     * @param {object} [options] Values to merge.\n     * @returns {CjsWemFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    /**\n     * Get normalized profile values with optional per-call overrides.\n     *\n     * @param {object} [options] Per-call values.\n     * @returns {object} Normalized read values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    /**\n     * Read wem bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read wem bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect wem bytes without decoding audio data.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Wwise container metadata.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * One-shot wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug payload for the selected emit target.\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot asynchronous wem read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsWemFormat.read(input, options);\n    }\n\n    /**\n     * One-shot wem inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Wwise container metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot wem support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeCodecSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Convert format output into JSON-compatible debug data.\n     *\n     * @param {any} value Format output.\n     * @returns {any} JSON-compatible value.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Test whether bytes look like a Wwise media container.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate wem bytes.\n     * @returns {boolean} True when RIFF/RIFX WAVE signatures are present.\n     */\n    static isWEM(input)\n    {\n        try\n        {\n            return isWEM(asUint8Array(input, \"Wem input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Repack Wwise Vorbis wem bytes into a standard Ogg Vorbis stream.\n     *\n     * Lossless container transform (no audio decode/re-encode); output plays\n     * natively where Ogg Vorbis is supported. Equivalent to\n     * `read(input, { emit: \"ogg\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Options, including a `codebooks` override.\n     * @returns {object} Ogg payload with bytes, timing, and loop metadata.\n     */\n    static toOgg(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_OGG });\n    }\n\n    /**\n     * Decode wem audio data to per-channel float32 PCM (AudioBuffer-ready).\n     *\n     * Covers Wwise PTADPCM (0x8311) and uncompressed 16-bit PCM. Wwise Vorbis\n     * is not decoded here - repack it with `toOgg()` instead. Equivalent to\n     * `read(input, { emit: \"pcm\" })`.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Wem bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} PCM payload with channelData, sample rate, and timing.\n     */\n    static toPcm(input, options = {})\n    {\n        return CjsWemFormat.read(input, { ...options, emit: OUTPUT_PCM });\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        RAW: OUTPUT_RAW,\n        JSON: OUTPUT_JSON,\n        WEM_JSON: OUTPUT_WEM_JSON,\n        OGG: OUTPUT_OGG,\n        PCM: OUTPUT_PCM\n    });\n    static CODEC_NAMES = WEM_CODEC_NAMES;\n    static id = \"wem\";\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n    static outputs = CjsFormat.defineOutputs({\n        raw: { default: true, passthrough: true },\n        ogg: {  },\n        pcm: { decoded: true },\n        wemJson: { role: \"debug\", probes: [ \"wemJson\", \"raw\" ] }\n    });\n    static extensions = Object.freeze([ \".wem\" ]);\n}\n\nexport default CjsWemFormat;\n"],"names":["FORMAT_NAME","CjsWemFormat","CjsFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_RAW","OUTPUT_OGG","OUTPUT_PCM","OUTPUT_WEM_JSON","defaultOutput","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeCodecSupportWithValues","toJSON","isWEM","asUint8Array","toOgg","emit","toPcm","Output","RAW","JSON","OUTPUT_JSON","WEM_JSON","OGG","PCM","CODEC_NAMES","WEM_CODEC_NAMES","id","mediaTypes","outputs","defineOutputs","raw","default","passthrough","ogg","pcm","decoded","wemJson","role","probes","extensions"],"mappings":"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"}

package/dist/resource/formats/wem/core/bitStream.js

@@ -1,10 +1,13 @@
-/**
- * Bit-level IO for Wwise Vorbis repacking.
- *
- * Vorbis bitstreams are LSB-first within each byte; both the reader and the
- * Ogg writer here follow that convention. The writer assembles one Ogg page
- * per packet (identification, comment, setup, then one page per audio
- * packet), matching the ww2ogg reference behavior.
+import { CjsBitReader } from '../../../format/CjsBitReader.js';
+import { CjsFormatRangeError } from '../../../format/CjsFormatError.js';
+
+/**
+ * Bit-level IO for Wwise Vorbis repacking.
+ *
+ * Vorbis bitstreams are LSB-first within each byte; both the reader and the
+ * Ogg writer here follow that convention. The writer assembles one Ogg page
+ * per packet (identification, comment, setup, then one page per audio
+ * packet), matching the ww2ogg reference behavior.
  */
 
 const OGG_HEADER_BYTES = 27;
@@ -24,13 +27,13 @@ function buildCrcTable() {
   return table;
 }
 
-/**
- * Compute the Ogg page checksum (forward CRC-32, polynomial 0x04c11db7,
- * zero initial value, no final xor).
- *
- * @param {Uint8Array} bytes Page bytes with the checksum field zeroed.
- * @param {number} length Number of bytes to include.
- * @returns {number} Unsigned 32-bit checksum.
+/**
+ * Compute the Ogg page checksum (forward CRC-32, polynomial 0x04c11db7,
+ * zero initial value, no final xor).
+ *
+ * @param {Uint8Array} bytes Page bytes with the checksum field zeroed.
+ * @param {number} length Number of bytes to include.
+ * @returns {number} Unsigned 32-bit checksum.
  */
 function oggChecksum(bytes, length) {
   let crc = 0;
@@ -40,75 +43,49 @@ function oggChecksum(bytes, length) {
   return crc;
 }
 
-/**
- * LSB-first bit reader over a byte range.
+/**
+ * Error raised when a Wwise Vorbis bitstream runs out mid-read.
+ *
+ * The `code` is the package-wide truncation code, which `CjsFormatReadError`
+ * does not itself carry.
  */
-class BitReader {
-  #bytes;
-  #position;
-  #bitBuffer = 0;
-  #bitsLeft = 0;
-  #totalBitsRead = 0;
-
-  /**
-   * Create a reader over `bytes` starting at `offset`.
-   *
-   * @param {Uint8Array} bytes Source bytes.
-   * @param {number} [offset] Starting byte offset.
-   */
-  constructor(bytes, offset = 0) {
-    this.#bytes = bytes;
-    this.#position = offset;
-  }
-
-  /**
-   * Read a single bit.
-   *
-   * @returns {number} 0 or 1.
-   */
-  readBit() {
-    if (this.#bitsLeft === 0) {
-      if (this.#position >= this.#bytes.length) {
-        const error = new Error("wem: bitstream out of bits");
-        error.code = "CJS_FORMAT_TRUNCATED";
-        throw error;
-      }
-      this.#bitBuffer = this.#bytes[this.#position++];
-      this.#bitsLeft = 8;
-    }
-    const bit = this.#bitBuffer & 1;
-    this.#bitBuffer >>= 1;
-    this.#bitsLeft--;
-    this.#totalBitsRead++;
-    return bit;
-  }
-
-  /**
-   * Read `count` bits as an unsigned integer (LSB-first).
-   *
-   * @param {number} count Bit count (0..32).
-   * @returns {number} Unsigned value.
-   */
-  readBits(count) {
-    let value = 0;
-    for (let i = 0; i < count; i++) {
-      if (this.readBit()) value |= 1 << i;
-    }
-    return value >>> 0;
+class WemBitstreamError extends CjsFormatRangeError {
+  /** Creates a truncation error with the cursor state that produced it. */
+  constructor(message, details = {}) {
+    super(message, details);
+    this.name = "WemBitstreamError";
+    this.code = "CJS_FORMAT_TRUNCATED";
   }
+}
 
-  /**
-   * Total bits consumed so far.
-   *
-   * @returns {number} Bit count.
+/**
+ * LSB-first bit reader over a byte range.
+ *
+ * The bit cursor itself is shared (`CjsBitReader`); Vorbis is LSB-first, which
+ * is the shared convention. Only the error identity is Wwise's own: a truncated
+ * bitstream here is a truncated FILE, so it throws rather than reporting a
+ * recoverable end-of-packet the way the Ogg packet reader does.
+ */
+class BitReader extends CjsBitReader {
+  static ReadError = WemBitstreamError;
+  static endOfDataMessage = "wem: bitstream out of bits";
+
+  /**
+   * Create a reader over `bytes` starting at `offset`.
+   *
+   * @param {Uint8Array} bytes Source bytes.
+   * @param {number} [offset] Starting byte offset.
    */
-  get totalBitsRead() {
-    return this.#totalBitsRead;
+  constructor(bytes, offset = 0) {
+    super(bytes, {
+      offset,
+      source: "wem"
+    });
   }
 }
 
-/**
- * LSB-first bit writer that assembles Ogg pages, one packet per page.
+/**
+ * LSB-first bit writer that assembles Ogg pages, one packet per page.
  */
 class OggPageWriter {
   #pages = [];
@@ -121,10 +98,10 @@ class OggPageWriter {
   #first = true;
   #continued = false;
 
-  /**
-   * Write a single bit.
-   *
-   * @param {number|boolean} bit Bit value.
+  /**
+   * Write a single bit.
+   *
+   * @param {number|boolean} bit Bit value.
    */
   writeBit(bit) {
     if (bit) this.#bitBuffer |= 1 << this.#bitsStored;
@@ -132,11 +109,11 @@ class OggPageWriter {
     if (this.#bitsStored === 8) this.#flushBits();
   }
 
-  /**
-   * Write `count` bits of `value` (LSB-first).
-   *
-   * @param {number} value Unsigned value.
-   * @param {number} count Bit count (0..32).
+  /**
+   * Write `count` bits of `value` (LSB-first).
+   *
+   * @param {number} value Unsigned value.
+   * @param {number} count Bit count (0..32).
    */
   writeBits(value, count) {
     for (let i = 0; i < count; i++) {
@@ -144,10 +121,10 @@ class OggPageWriter {
     }
   }
 
-  /**
-   * Set the granule position recorded on the next flushed page.
-   *
-   * @param {number} granule Unsigned granule position (< 2^53).
+  /**
+   * Set the granule position recorded on the next flushed page.
+   *
+   * @param {number} granule Unsigned granule position (< 2^53).
    */
   setGranule(granule) {
     this.#granule = granule;
@@ -166,10 +143,10 @@ class OggPageWriter {
     this.#bitBuffer = 0;
   }
 
-  /**
-   * Finish the current packet and emit it as one Ogg page.
-   *
-   * @param {boolean} [last] Mark this page as end-of-stream.
+  /**
+   * Finish the current packet and emit it as one Ogg page.
+   *
+   * @param {boolean} [last] Mark this page as end-of-stream.
    */
   flushPage(last = false) {
     this.#flushBits();
@@ -208,10 +185,10 @@ class OggPageWriter {
     this.#payloadBytes = 0;
   }
 
-  /**
-   * Concatenate all flushed pages into one buffer.
-   *
-   * @returns {Uint8Array} Complete Ogg stream bytes.
+  /**
+   * Concatenate all flushed pages into one buffer.
+   *
+   * @returns {Uint8Array} Complete Ogg stream bytes.
    */
   toBytes() {
     let total = 0;
@@ -225,10 +202,10 @@ class OggPageWriter {
     return bytes;
   }
 
-  /**
-   * Number of pages flushed so far.
-   *
-   * @returns {number} Page count.
+  /**
+   * Number of pages flushed so far.
+   *
+   * @returns {number} Page count.
    */
   get pageCount() {
     return this.#pages.length;
@@ -241,11 +218,11 @@ function writeU32(bytes, offset, value) {
   bytes[offset + 3] = value >>> 24 & 0xff;
 }
 
-/**
- * Smallest number of bits needed to represent `value` (Vorbis ilog).
- *
- * @param {number} value Unsigned value.
- * @returns {number} Bit count; 0 when value is 0.
+/**
+ * Smallest number of bits needed to represent `value` (Vorbis ilog).
+ *
+ * @param {number} value Unsigned value.
+ * @returns {number} Bit count; 0 when value is 0.
  */
 function ilog(value) {
   let result = 0;

package/dist/resource/formats/wem/core/bitStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"bitStream.js","sources":["../../../../../../src/resource/formats/wem/core/bitStream.js"],"sourcesContent":["/**\r\n * Bit-level IO for Wwise Vorbis repacking.\r\n *\r\n * Vorbis bitstreams are LSB-first within each byte; both the reader and the\r\n * Ogg writer here follow that convention. The writer assembles one Ogg page\r\n * per packet (identification, comment, setup, then one page per audio\r\n * packet), matching the ww2ogg reference behavior.\r\n */\r\n\r\nconst OGG_HEADER_BYTES = 27;\r\nconst OGG_MAX_SEGMENTS = 255;\r\nconst OGG_SEGMENT_SIZE = 255;\r\nconst OGG_MAX_PAYLOAD = OGG_MAX_SEGMENTS * OGG_SEGMENT_SIZE;\r\n\r\nconst CRC_TABLE = buildCrcTable();\r\n\r\nfunction buildCrcTable()\r\n{\r\n    const table = new Uint32Array(256);\r\n    for (let i = 0; i < 256; i++)\r\n    {\r\n        let r = (i << 24) >>> 0;\r\n        for (let bit = 0; bit < 8; bit++)\r\n        {\r\n            r = ((r & 0x80000000) ? ((r << 1) ^ 0x04c11db7) : (r << 1)) >>> 0;\r\n        }\r\n        table[i] = r;\r\n    }\r\n    return table;\r\n}\r\n\r\n/**\r\n * Compute the Ogg page checksum (forward CRC-32, polynomial 0x04c11db7,\r\n * zero initial value, no final xor).\r\n *\r\n * @param {Uint8Array} bytes Page bytes with the checksum field zeroed.\r\n * @param {number} length Number of bytes to include.\r\n * @returns {number} Unsigned 32-bit checksum.\r\n */\r\nexport function oggChecksum(bytes, length)\r\n{\r\n    let crc = 0;\r\n    for (let i = 0; i < length; i++)\r\n    {\r\n        crc = (((crc << 8) >>> 0) ^ CRC_TABLE[((crc >>> 24) ^ bytes[i]) & 0xff]) >>> 0;\r\n    }\r\n    return crc;\r\n}\r\n\r\n/**\r\n * LSB-first bit reader over a byte range.\r\n */\r\nexport class BitReader\r\n{\r\n    #bytes;\r\n    #position;\r\n    #bitBuffer = 0;\r\n    #bitsLeft = 0;\r\n    #totalBitsRead = 0;\r\n\r\n    /**\r\n     * Create a reader over `bytes` starting at `offset`.\r\n     *\r\n     * @param {Uint8Array} bytes Source bytes.\r\n     * @param {number} [offset] Starting byte offset.\r\n     */\r\n    constructor(bytes, offset = 0)\r\n    {\r\n        this.#bytes = bytes;\r\n        this.#position = offset;\r\n    }\r\n\r\n    /**\r\n     * Read a single bit.\r\n     *\r\n     * @returns {number} 0 or 1.\r\n     */\r\n    readBit()\r\n    {\r\n        if (this.#bitsLeft === 0)\r\n        {\r\n            if (this.#position >= this.#bytes.length)\r\n            {\r\n                const error = new Error(\"wem: bitstream out of bits\");\r\n                error.code = \"CJS_FORMAT_TRUNCATED\";\r\n                throw error;\r\n            }\r\n            this.#bitBuffer = this.#bytes[this.#position++];\r\n            this.#bitsLeft = 8;\r\n        }\r\n        const bit = this.#bitBuffer & 1;\r\n        this.#bitBuffer >>= 1;\r\n        this.#bitsLeft--;\r\n        this.#totalBitsRead++;\r\n        return bit;\r\n    }\r\n\r\n    /**\r\n     * Read `count` bits as an unsigned integer (LSB-first).\r\n     *\r\n     * @param {number} count Bit count (0..32).\r\n     * @returns {number} Unsigned value.\r\n     */\r\n    readBits(count)\r\n    {\r\n        let value = 0;\r\n        for (let i = 0; i < count; i++)\r\n        {\r\n            if (this.readBit()) value |= (1 << i);\r\n        }\r\n        return value >>> 0;\r\n    }\r\n\r\n    /**\r\n     * Total bits consumed so far.\r\n     *\r\n     * @returns {number} Bit count.\r\n     */\r\n    get totalBitsRead()\r\n    {\r\n        return this.#totalBitsRead;\r\n    }\r\n}\r\n\r\n/**\r\n * LSB-first bit writer that assembles Ogg pages, one packet per page.\r\n */\r\nexport class OggPageWriter\r\n{\r\n    #pages = [];\r\n    #payload = new Uint8Array(OGG_MAX_PAYLOAD);\r\n    #payloadBytes = 0;\r\n    #bitBuffer = 0;\r\n    #bitsStored = 0;\r\n    #granule = 0;\r\n    #sequenceNumber = 0;\r\n    #first = true;\r\n    #continued = false;\r\n\r\n    /**\r\n     * Write a single bit.\r\n     *\r\n     * @param {number|boolean} bit Bit value.\r\n     */\r\n    writeBit(bit)\r\n    {\r\n        if (bit) this.#bitBuffer |= (1 << this.#bitsStored);\r\n        this.#bitsStored++;\r\n        if (this.#bitsStored === 8) this.#flushBits();\r\n    }\r\n\r\n    /**\r\n     * Write `count` bits of `value` (LSB-first).\r\n     *\r\n     * @param {number} value Unsigned value.\r\n     * @param {number} count Bit count (0..32).\r\n     */\r\n    writeBits(value, count)\r\n    {\r\n        for (let i = 0; i < count; i++)\r\n        {\r\n            this.writeBit((value >>> i) & 1);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Set the granule position recorded on the next flushed page.\r\n     *\r\n     * @param {number} granule Unsigned granule position (< 2^53).\r\n     */\r\n    setGranule(granule)\r\n    {\r\n        this.#granule = granule;\r\n    }\r\n\r\n    /** Flushes bits into the current WEM binary writer output. */\r\n    #flushBits()\r\n    {\r\n        if (this.#bitsStored === 0) return;\r\n        if (this.#payloadBytes === OGG_MAX_PAYLOAD)\r\n        {\r\n            const error = new Error(\"wem: packet too large for one Ogg page\");\r\n            error.code = \"CJS_FORMAT_OUTPUT_NOT_SUPPORTED\";\r\n            throw error;\r\n        }\r\n        this.#payload[this.#payloadBytes++] = this.#bitBuffer;\r\n        this.#bitsStored = 0;\r\n        this.#bitBuffer = 0;\r\n    }\r\n\r\n    /**\r\n     * Finish the current packet and emit it as one Ogg page.\r\n     *\r\n     * @param {boolean} [last] Mark this page as end-of-stream.\r\n     */\r\n    flushPage(last = false)\r\n    {\r\n        this.#flushBits();\r\n        if (this.#payloadBytes === 0) return;\r\n\r\n        const payloadBytes = this.#payloadBytes;\r\n        let segments = Math.floor((payloadBytes + OGG_SEGMENT_SIZE) / OGG_SEGMENT_SIZE);\r\n        if (segments === OGG_MAX_SEGMENTS + 1) segments = OGG_MAX_SEGMENTS;\r\n\r\n        const page = new Uint8Array(OGG_HEADER_BYTES + segments + payloadBytes);\r\n        page[0] = 0x4f;\r\n        page[1] = 0x67;\r\n        page[2] = 0x67;\r\n        page[3] = 0x53;\r\n        page[4] = 0;\r\n        page[5] = (this.#continued ? 1 : 0) | (this.#first ? 2 : 0) | (last ? 4 : 0);\r\n        writeU32(page, 6, this.#granule % 0x100000000);\r\n        writeU32(page, 10, Math.floor(this.#granule / 0x100000000));\r\n        writeU32(page, 14, 1);\r\n        writeU32(page, 18, this.#sequenceNumber);\r\n        writeU32(page, 22, 0);\r\n        page[26] = segments;\r\n\r\n        let bytesLeft = payloadBytes;\r\n        for (let i = 0; i < segments; i++)\r\n        {\r\n            if (bytesLeft >= OGG_SEGMENT_SIZE)\r\n            {\r\n                page[27 + i] = OGG_SEGMENT_SIZE;\r\n                bytesLeft -= OGG_SEGMENT_SIZE;\r\n            }\r\n            else\r\n            {\r\n                page[27 + i] = bytesLeft;\r\n            }\r\n        }\r\n\r\n        page.set(this.#payload.subarray(0, payloadBytes), OGG_HEADER_BYTES + segments);\r\n        writeU32(page, 22, oggChecksum(page, page.length));\r\n\r\n        this.#pages.push(page);\r\n        this.#sequenceNumber++;\r\n        this.#first = false;\r\n        this.#continued = false;\r\n        this.#payloadBytes = 0;\r\n    }\r\n\r\n    /**\r\n     * Concatenate all flushed pages into one buffer.\r\n     *\r\n     * @returns {Uint8Array} Complete Ogg stream bytes.\r\n     */\r\n    toBytes()\r\n    {\r\n        let total = 0;\r\n        for (const page of this.#pages) total += page.length;\r\n        const bytes = new Uint8Array(total);\r\n        let offset = 0;\r\n        for (const page of this.#pages)\r\n        {\r\n            bytes.set(page, offset);\r\n            offset += page.length;\r\n        }\r\n        return bytes;\r\n    }\r\n\r\n    /**\r\n     * Number of pages flushed so far.\r\n     *\r\n     * @returns {number} Page count.\r\n     */\r\n    get pageCount()\r\n    {\r\n        return this.#pages.length;\r\n    }\r\n}\r\n\r\nfunction writeU32(bytes, offset, value)\r\n{\r\n    bytes[offset] = value & 0xff;\r\n    bytes[offset + 1] = (value >>> 8) & 0xff;\r\n    bytes[offset + 2] = (value >>> 16) & 0xff;\r\n    bytes[offset + 3] = (value >>> 24) & 0xff;\r\n}\r\n\r\n/**\r\n * Smallest number of bits needed to represent `value` (Vorbis ilog).\r\n *\r\n * @param {number} value Unsigned value.\r\n * @returns {number} Bit count; 0 when value is 0.\r\n */\r\nexport function ilog(value)\r\n{\r\n    let result = 0;\r\n    let v = value >>> 0;\r\n    while (v)\r\n    {\r\n        result++;\r\n        v >>>= 1;\r\n    }\r\n    return result;\r\n}\r\n"],"names":["OGG_HEADER_BYTES","OGG_MAX_SEGMENTS","OGG_SEGMENT_SIZE","OGG_MAX_PAYLOAD","CRC_TABLE","buildCrcTable","table","Uint32Array","i","r","bit","oggChecksum","bytes","length","crc","BitReader","constructor","offset","readBit","error","Error","code","readBits","count","value","totalBitsRead","OggPageWriter","Uint8Array","writeBit","writeBits","setGranule","granule","#flushBits","flushPage","last","payloadBytes","segments","Math","floor","page","writeU32","bytesLeft","set","subarray","push","toBytes","total","pageCount","ilog","result","v"],"mappings":"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"}
+{"version":3,"file":"bitStream.js","sources":["../../../../../../src/resource/formats/wem/core/bitStream.js"],"sourcesContent":["/**\n * Bit-level IO for Wwise Vorbis repacking.\n *\n * Vorbis bitstreams are LSB-first within each byte; both the reader and the\n * Ogg writer here follow that convention. The writer assembles one Ogg page\n * per packet (identification, comment, setup, then one page per audio\n * packet), matching the ww2ogg reference behavior.\n */\n\nimport { CjsBitReader } from \"../../../format/CjsBitReader.js\";\nimport { CjsFormatRangeError } from \"../../../format/CjsFormatError.js\";\n\nconst OGG_HEADER_BYTES = 27;\nconst OGG_MAX_SEGMENTS = 255;\nconst OGG_SEGMENT_SIZE = 255;\nconst OGG_MAX_PAYLOAD = OGG_MAX_SEGMENTS * OGG_SEGMENT_SIZE;\n\nconst CRC_TABLE = buildCrcTable();\n\nfunction buildCrcTable()\n{\n    const table = new Uint32Array(256);\n    for (let i = 0; i < 256; i++)\n    {\n        let r = (i << 24) >>> 0;\n        for (let bit = 0; bit < 8; bit++)\n        {\n            r = ((r & 0x80000000) ? ((r << 1) ^ 0x04c11db7) : (r << 1)) >>> 0;\n        }\n        table[i] = r;\n    }\n    return table;\n}\n\n/**\n * Compute the Ogg page checksum (forward CRC-32, polynomial 0x04c11db7,\n * zero initial value, no final xor).\n *\n * @param {Uint8Array} bytes Page bytes with the checksum field zeroed.\n * @param {number} length Number of bytes to include.\n * @returns {number} Unsigned 32-bit checksum.\n */\nexport function oggChecksum(bytes, length)\n{\n    let crc = 0;\n    for (let i = 0; i < length; i++)\n    {\n        crc = (((crc << 8) >>> 0) ^ CRC_TABLE[((crc >>> 24) ^ bytes[i]) & 0xff]) >>> 0;\n    }\n    return crc;\n}\n\n/**\n * Error raised when a Wwise Vorbis bitstream runs out mid-read.\n *\n * The `code` is the package-wide truncation code, which `CjsFormatReadError`\n * does not itself carry.\n */\nclass WemBitstreamError extends CjsFormatRangeError\n{\n    /** Creates a truncation error with the cursor state that produced it. */\n    constructor(message, details = {})\n    {\n        super(message, details);\n        this.name = \"WemBitstreamError\";\n        this.code = \"CJS_FORMAT_TRUNCATED\";\n    }\n}\n\n/**\n * LSB-first bit reader over a byte range.\n *\n * The bit cursor itself is shared (`CjsBitReader`); Vorbis is LSB-first, which\n * is the shared convention. Only the error identity is Wwise's own: a truncated\n * bitstream here is a truncated FILE, so it throws rather than reporting a\n * recoverable end-of-packet the way the Ogg packet reader does.\n */\nexport class BitReader extends CjsBitReader\n{\n    static ReadError = WemBitstreamError;\n\n    static endOfDataMessage = \"wem: bitstream out of bits\";\n\n    /**\n     * Create a reader over `bytes` starting at `offset`.\n     *\n     * @param {Uint8Array} bytes Source bytes.\n     * @param {number} [offset] Starting byte offset.\n     */\n    constructor(bytes, offset = 0)\n    {\n        super(bytes, { offset, source: \"wem\" });\n    }\n}\n\n/**\n * LSB-first bit writer that assembles Ogg pages, one packet per page.\n */\nexport class OggPageWriter\n{\n    #pages = [];\n    #payload = new Uint8Array(OGG_MAX_PAYLOAD);\n    #payloadBytes = 0;\n    #bitBuffer = 0;\n    #bitsStored = 0;\n    #granule = 0;\n    #sequenceNumber = 0;\n    #first = true;\n    #continued = false;\n\n    /**\n     * Write a single bit.\n     *\n     * @param {number|boolean} bit Bit value.\n     */\n    writeBit(bit)\n    {\n        if (bit) this.#bitBuffer |= (1 << this.#bitsStored);\n        this.#bitsStored++;\n        if (this.#bitsStored === 8) this.#flushBits();\n    }\n\n    /**\n     * Write `count` bits of `value` (LSB-first).\n     *\n     * @param {number} value Unsigned value.\n     * @param {number} count Bit count (0..32).\n     */\n    writeBits(value, count)\n    {\n        for (let i = 0; i < count; i++)\n        {\n            this.writeBit((value >>> i) & 1);\n        }\n    }\n\n    /**\n     * Set the granule position recorded on the next flushed page.\n     *\n     * @param {number} granule Unsigned granule position (< 2^53).\n     */\n    setGranule(granule)\n    {\n        this.#granule = granule;\n    }\n\n    /** Flushes bits into the current WEM binary writer output. */\n    #flushBits()\n    {\n        if (this.#bitsStored === 0) return;\n        if (this.#payloadBytes === OGG_MAX_PAYLOAD)\n        {\n            const error = new Error(\"wem: packet too large for one Ogg page\");\n            error.code = \"CJS_FORMAT_OUTPUT_NOT_SUPPORTED\";\n            throw error;\n        }\n        this.#payload[this.#payloadBytes++] = this.#bitBuffer;\n        this.#bitsStored = 0;\n        this.#bitBuffer = 0;\n    }\n\n    /**\n     * Finish the current packet and emit it as one Ogg page.\n     *\n     * @param {boolean} [last] Mark this page as end-of-stream.\n     */\n    flushPage(last = false)\n    {\n        this.#flushBits();\n        if (this.#payloadBytes === 0) return;\n\n        const payloadBytes = this.#payloadBytes;\n        let segments = Math.floor((payloadBytes + OGG_SEGMENT_SIZE) / OGG_SEGMENT_SIZE);\n        if (segments === OGG_MAX_SEGMENTS + 1) segments = OGG_MAX_SEGMENTS;\n\n        const page = new Uint8Array(OGG_HEADER_BYTES + segments + payloadBytes);\n        page[0] = 0x4f;\n        page[1] = 0x67;\n        page[2] = 0x67;\n        page[3] = 0x53;\n        page[4] = 0;\n        page[5] = (this.#continued ? 1 : 0) | (this.#first ? 2 : 0) | (last ? 4 : 0);\n        writeU32(page, 6, this.#granule % 0x100000000);\n        writeU32(page, 10, Math.floor(this.#granule / 0x100000000));\n        writeU32(page, 14, 1);\n        writeU32(page, 18, this.#sequenceNumber);\n        writeU32(page, 22, 0);\n        page[26] = segments;\n\n        let bytesLeft = payloadBytes;\n        for (let i = 0; i < segments; i++)\n        {\n            if (bytesLeft >= OGG_SEGMENT_SIZE)\n            {\n                page[27 + i] = OGG_SEGMENT_SIZE;\n                bytesLeft -= OGG_SEGMENT_SIZE;\n            }\n            else\n            {\n                page[27 + i] = bytesLeft;\n            }\n        }\n\n        page.set(this.#payload.subarray(0, payloadBytes), OGG_HEADER_BYTES + segments);\n        writeU32(page, 22, oggChecksum(page, page.length));\n\n        this.#pages.push(page);\n        this.#sequenceNumber++;\n        this.#first = false;\n        this.#continued = false;\n        this.#payloadBytes = 0;\n    }\n\n    /**\n     * Concatenate all flushed pages into one buffer.\n     *\n     * @returns {Uint8Array} Complete Ogg stream bytes.\n     */\n    toBytes()\n    {\n        let total = 0;\n        for (const page of this.#pages) total += page.length;\n        const bytes = new Uint8Array(total);\n        let offset = 0;\n        for (const page of this.#pages)\n        {\n            bytes.set(page, offset);\n            offset += page.length;\n        }\n        return bytes;\n    }\n\n    /**\n     * Number of pages flushed so far.\n     *\n     * @returns {number} Page count.\n     */\n    get pageCount()\n    {\n        return this.#pages.length;\n    }\n}\n\nfunction writeU32(bytes, offset, value)\n{\n    bytes[offset] = value & 0xff;\n    bytes[offset + 1] = (value >>> 8) & 0xff;\n    bytes[offset + 2] = (value >>> 16) & 0xff;\n    bytes[offset + 3] = (value >>> 24) & 0xff;\n}\n\n/**\n * Smallest number of bits needed to represent `value` (Vorbis ilog).\n *\n * @param {number} value Unsigned value.\n * @returns {number} Bit count; 0 when value is 0.\n */\nexport function ilog(value)\n{\n    let result = 0;\n    let v = value >>> 0;\n    while (v)\n    {\n        result++;\n        v >>>= 1;\n    }\n    return result;\n}\n"],"names":["OGG_HEADER_BYTES","OGG_MAX_SEGMENTS","OGG_SEGMENT_SIZE","OGG_MAX_PAYLOAD","CRC_TABLE","buildCrcTable","table","Uint32Array","i","r","bit","oggChecksum","bytes","length","crc","WemBitstreamError","CjsFormatRangeError","constructor","message","details","name","code","BitReader","CjsBitReader","ReadError","endOfDataMessage","offset","source","OggPageWriter","Uint8Array","writeBit","writeBits","value","count","setGranule","granule","#flushBits","error","Error","flushPage","last","payloadBytes","segments","Math","floor","page","writeU32","bytesLeft","set","subarray","push","toBytes","total","pageCount","ilog","result","v"],"mappings":"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"}

package/dist/resource/formats/wem/core/codebookLibrary.js

@@ -1,13 +1,13 @@
 import { BitReader, ilog } from './bitStream.js';
 
-/**
- * Packed Vorbis codebook library handling for Wwise Vorbis repacking.
- *
- * Wwise strips the standard Vorbis codebooks from the setup header and
- * references entries in a shared packed library by 10-bit id. Rebuilding
- * expands each packed codebook back into the standard Vorbis codebook
- * encoding. Behavior mirrors the ww2ogg reference (BSD-licensed, Xiph.org
- * Foundation / Adam Gashlin); this is an original reimplementation.
+/**
+ * Packed Vorbis codebook library handling for Wwise Vorbis repacking.
+ *
+ * Wwise strips the standard Vorbis codebooks from the setup header and
+ * references entries in a shared packed library by 10-bit id. Rebuilding
+ * expands each packed codebook back into the standard Vorbis codebook
+ * encoding. Behavior mirrors the ww2ogg reference (BSD-licensed, Xiph.org
+ * Foundation / Adam Gashlin); this is an original reimplementation.
  */
 
 function parseError(message) {
@@ -16,15 +16,15 @@ function parseError(message) {
   return error;
 }
 
-/**
- * Parse a packed codebook library blob.
- *
- * Layout: codebook data, then a table of u32-le offsets; the last u32 in the
- * file points at the start of the offset table. Codebook `i` spans
- * offsets[i]..offsets[i+1].
- *
- * @param {Uint8Array} bytes Packed codebook library bytes.
- * @returns {object} Parsed library with `count` usable codebooks.
+/**
+ * Parse a packed codebook library blob.
+ *
+ * Layout: codebook data, then a table of u32-le offsets; the last u32 in the
+ * file points at the start of the offset table. Codebook `i` spans
+ * offsets[i]..offsets[i+1].
+ *
+ * @param {Uint8Array} bytes Packed codebook library bytes.
+ * @returns {object} Parsed library with `count` usable codebooks.
  */
 function parseCodebookLibrary(bytes) {
   if (bytes.length < 4) throw parseError("packed codebook library is truncated");
@@ -46,12 +46,12 @@ function parseCodebookLibrary(bytes) {
   };
 }
 
-/**
- * Rebuild one packed codebook, referenced by library id, into `writer`.
- *
- * @param {object} library `parseCodebookLibrary` output.
- * @param {number} id Codebook id from the setup header.
- * @param {object} writer OggPageWriter positioned inside the setup packet.
+/**
+ * Rebuild one packed codebook, referenced by library id, into `writer`.
+ *
+ * @param {object} library `parseCodebookLibrary` output.
+ * @param {number} id Codebook id from the setup header.
+ * @param {object} writer OggPageWriter positioned inside the setup packet.
  */
 function rebuildCodebookById(library, id, writer) {
   if (id < 0 || id >= library.count) {
@@ -63,36 +63,36 @@ function rebuildCodebookById(library, id, writer) {
   rebuildCodebook(reader, size, writer);
 }
 
-/**
- * Rebuild one packed codebook from `reader` into the standard Vorbis
- * codebook encoding on `writer`.
- *
- * @param {object} reader BitReader at the start of the packed codebook.
- * @param {number} size Packed codebook size in bytes (0 skips the size check).
- * @param {object} writer OggPageWriter positioned inside the setup packet.
+/**
+ * Rebuild one packed codebook from `reader` into the standard Vorbis
+ * codebook encoding on `writer`.
+ *
+ * @param {object} reader BitReader at the start of the packed codebook.
+ * @param {number} size Packed codebook size in bytes (0 skips the size check).
+ * @param {object} writer OggPageWriter positioned inside the setup packet.
  */
 function rebuildCodebook(reader, size, writer) {
-  const dimensions = reader.readBits(4);
-  const entries = reader.readBits(14);
+  const dimensions = reader.ReadBits(4);
+  const entries = reader.ReadBits(14);
   writer.writeBits(0x564342, 24);
   writer.writeBits(dimensions, 16);
   writer.writeBits(entries, 24);
-  const ordered = reader.readBits(1);
+  const ordered = reader.ReadBits(1);
   writer.writeBits(ordered, 1);
   if (ordered) {
-    const initialLength = reader.readBits(5);
+    const initialLength = reader.ReadBits(5);
     writer.writeBits(initialLength, 5);
     let currentEntry = 0;
     while (currentEntry < entries) {
       const bits = ilog(entries - currentEntry);
-      const number = reader.readBits(bits);
+      const number = reader.ReadBits(bits);
       writer.writeBits(number, bits);
       currentEntry += number;
     }
     if (currentEntry > entries) throw parseError("codebook current entry out of range");
   } else {
-    const codewordLengthLength = reader.readBits(3);
-    const sparse = reader.readBits(1);
+    const codewordLengthLength = reader.ReadBits(3);
+    const sparse = reader.ReadBits(1);
     if (codewordLengthLength === 0 || codewordLengthLength > 5) {
       throw parseError("nonsense codeword length");
     }
@@ -100,30 +100,30 @@ function rebuildCodebook(reader, size, writer) {
     for (let i = 0; i < entries; i++) {
       let present = true;
       if (sparse) {
-        const presentBit = reader.readBits(1);
+        const presentBit = reader.ReadBits(1);
         writer.writeBits(presentBit, 1);
         present = presentBit !== 0;
       }
       if (present) {
-        const codewordLength = reader.readBits(codewordLengthLength);
+        const codewordLength = reader.ReadBits(codewordLengthLength);
         writer.writeBits(codewordLength, 5);
       }
     }
   }
-  const lookupType = reader.readBits(1);
+  const lookupType = reader.ReadBits(1);
   writer.writeBits(lookupType, 4);
   if (lookupType === 1) {
-    const min = reader.readBits(32);
-    const max = reader.readBits(32);
-    const valueLength = reader.readBits(4);
-    const sequenceFlag = reader.readBits(1);
+    const min = reader.ReadBits(32);
+    const max = reader.ReadBits(32);
+    const valueLength = reader.ReadBits(4);
+    const sequenceFlag = reader.ReadBits(1);
     writer.writeBits(min, 32);
     writer.writeBits(max, 32);
     writer.writeBits(valueLength, 4);
     writer.writeBits(sequenceFlag, 1);
     const quantvals = bookMaptype1Quantvals(entries, dimensions);
     for (let i = 0; i < quantvals; i++) {
-      writer.writeBits(reader.readBits(valueLength + 1), valueLength + 1);
+      writer.writeBits(reader.ReadBits(valueLength + 1), valueLength + 1);
     }
   } else if (lookupType !== 0) {
     throw parseError(`unexpected codebook lookup type ${lookupType}`);
@@ -133,13 +133,13 @@ function rebuildCodebook(reader, size, writer) {
   }
 }
 
-/**
- * Number of quantized values for a maptype-1 codebook lookup table
- * (Vorbis/Tremor `_book_maptype1_quantvals`).
- *
- * @param {number} entries Codebook entry count.
- * @param {number} dimensions Codebook dimensions.
- * @returns {number} Quantized value count.
+/**
+ * Number of quantized values for a maptype-1 codebook lookup table
+ * (Vorbis/Tremor `_book_maptype1_quantvals`).
+ *
+ * @param {number} entries Codebook entry count.
+ * @param {number} dimensions Codebook dimensions.
+ * @returns {number} Quantized value count.
  */
 function bookMaptype1Quantvals(entries, dimensions) {
   if (dimensions === 0) return 0;