@carbonenginejs/runtime-resource 0.1.0

package/dist/formats/bnk/core/helpers.js

@@ -0,0 +1,354 @@
+const OUTPUT_RAW = "raw";
+const OUTPUT_JSON = "json";
+const OUTPUT_BNK_JSON = "bnkJson";
+const OUTPUT_MEDIA = "media";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_RAW,
+  inputType: "bnk",
+  source: ""
+});
+
+/**
+ * Advisory names for classic HIRC object type ids.
+ *
+ * Type ids shifted in later Wwise releases, so these names are hints for
+ * debugging and inventory work, not a version-exact schema. Unknown ids are
+ * reported as `hirc-type-<n>`.
+ */
+const HIRC_TYPE_NAMES = Object.freeze({
+  1: "settings",
+  2: "sound",
+  3: "event-action",
+  4: "event",
+  5: "random-sequence-container",
+  6: "switch-container",
+  7: "actor-mixer",
+  8: "audio-bus",
+  9: "blend-container",
+  10: "music-segment",
+  11: "music-track",
+  12: "music-switch-container",
+  13: "music-playlist-container",
+  14: "attenuation",
+  15: "dialogue-event",
+  16: "motion-bus",
+  17: "motion-fx",
+  18: "effect",
+  19: "auxiliary-bus",
+  20: "lfo",
+  21: "envelope",
+  22: "audio-device"
+});
+function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsBnkFormat") {
+  const values = {
+    ...DEFAULT_VALUES,
+    ...(base || {}),
+    ...(options || {})
+  };
+  values.inputType = values.inputType ? String(values.inputType).replace(/^\./u, "").toLowerCase() : "bnk";
+  values.emit = normalizeEmit(values.emit, readerName);
+  return values;
+}
+function normalizeEmit(emit, readerName) {
+  if (emit === undefined || emit === null) return OUTPUT_RAW;
+  if (emit === OUTPUT_JSON) return OUTPUT_BNK_JSON;
+  if ([OUTPUT_RAW, OUTPUT_BNK_JSON, OUTPUT_MEDIA].includes(emit)) return emit;
+  throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
+}
+function toBytes(input) {
+  if (input instanceof Uint8Array) return input;
+  if (input instanceof ArrayBuffer) return new Uint8Array(input);
+  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  throw new TypeError("Bnk input must be Uint8Array, ArrayBuffer, or DataView");
+}
+
+/**
+ * Test for a Wwise soundbank BKHD signature.
+ *
+ * @param {Uint8Array} bytes Candidate bytes.
+ * @returns {boolean} True when the bank header chunk is present.
+ */
+function isBNK(bytes) {
+  return bytes.byteLength >= 8 && fourCc(bytes, 0) === "BKHD";
+}
+
+/**
+ * Inspect Wwise soundbank bytes without copying media payloads.
+ *
+ * Walks the chunk sequence and decodes the bank header (BKHD), embedded media
+ * index (DIDX/DATA), object hierarchy listing (HIRC), and referenced bank
+ * names (STID). Unknown chunks are recorded, never rejected; a truncated
+ * trailing chunk stops the walk and is flagged.
+ *
+ * Wwise soundbanks are written little-endian on all platforms EVE ships on;
+ * this reader assumes little-endian data.
+ *
+ * @param {Uint8Array} bytes Soundbank bytes.
+ * @returns {object} Soundbank metadata.
+ */
+function inspectBNK(bytes) {
+  const info = {
+    sourceFormat: "bnk",
+    bankVersion: 0,
+    bankId: 0,
+    languageId: 0,
+    media: [],
+    hirc: [],
+    names: [],
+    chunks: []
+  };
+  let dataChunkOffset = 0;
+  let dataChunkSize = 0;
+  let mediaIndex = [];
+  let offset = 0;
+  while (offset + 8 <= bytes.byteLength) {
+    const id = fourCc(bytes, offset);
+    const size = readU32(bytes, offset + 4);
+    const dataOffset = offset + 8;
+    if (dataOffset + size > bytes.byteLength) {
+      info.chunks.push({
+        id,
+        offset,
+        dataOffset,
+        size,
+        truncated: true
+      });
+      break;
+    }
+    info.chunks.push({
+      id,
+      offset,
+      dataOffset,
+      size
+    });
+    if (id === "BKHD" && size >= 12) {
+      info.bankVersion = readU32(bytes, dataOffset);
+      info.bankId = readU32(bytes, dataOffset + 4);
+      info.languageId = readU32(bytes, dataOffset + 8);
+    }
+    if (id === "DIDX") {
+      mediaIndex = readMediaIndex(bytes, dataOffset, size);
+    }
+    if (id === "DATA") {
+      dataChunkOffset = dataOffset;
+      dataChunkSize = size;
+    }
+    if (id === "HIRC") {
+      info.hirc = readHircListing(bytes, dataOffset, size);
+    }
+    if (id === "STID") {
+      info.names = readNameTable(bytes, dataOffset, size);
+    }
+    offset = dataOffset + size;
+  }
+  info.media = mediaIndex.map(entry => {
+    const absoluteOffset = dataChunkOffset + entry.offset;
+    const available = dataChunkOffset > 0 && entry.offset + entry.length <= dataChunkSize && absoluteOffset + entry.length <= bytes.byteLength;
+    return {
+      id: entry.id,
+      offset: entry.offset,
+      absoluteOffset: dataChunkOffset > 0 ? absoluteOffset : 0,
+      length: entry.length,
+      available
+    };
+  });
+  info.mediaCount = info.media.length;
+  info.hircCount = info.hirc.length;
+  return info;
+}
+function readMediaIndex(bytes, dataOffset, size) {
+  const entries = [];
+  const count = Math.floor(size / 12);
+  for (let i = 0; i < count; i++) {
+    const entryOffset = dataOffset + i * 12;
+    entries.push({
+      id: readU32(bytes, entryOffset),
+      offset: readU32(bytes, entryOffset + 4),
+      length: readU32(bytes, entryOffset + 8)
+    });
+  }
+  return entries;
+}
+function readHircListing(bytes, dataOffset, size) {
+  const entries = [];
+  if (size < 4) return entries;
+  const count = readU32(bytes, dataOffset);
+  const end = dataOffset + size;
+  let offset = dataOffset + 4;
+  for (let i = 0; i < count; i++) {
+    if (offset + 9 > end) break;
+    const type = bytes[offset];
+    const entrySize = readU32(bytes, offset + 1);
+    const payloadOffset = offset + 5;
+    if (entrySize < 4 || payloadOffset + entrySize > end) break;
+    entries.push({
+      type,
+      typeName: HIRC_TYPE_NAMES[type] || `hirc-type-${type}`,
+      id: readU32(bytes, payloadOffset),
+      offset: payloadOffset,
+      size: entrySize
+    });
+    offset = payloadOffset + entrySize;
+  }
+  return entries;
+}
+function readNameTable(bytes, dataOffset, size) {
+  const names = [];
+  if (size < 8) return names;
+  const count = readU32(bytes, dataOffset + 4);
+  const end = dataOffset + size;
+  let offset = dataOffset + 8;
+  for (let i = 0; i < count; i++) {
+    if (offset + 5 > end) break;
+    const bankId = readU32(bytes, offset);
+    const length = bytes[offset + 4];
+    if (offset + 5 + length > end) break;
+    names.push({
+      bankId,
+      name: asciiString(bytes, offset + 5, length)
+    });
+    offset += 5 + length;
+  }
+  return names;
+}
+function inspectWithValues(input, values = DEFAULT_VALUES) {
+  const bytes = toBytes(input);
+  if (!isBNK(bytes)) {
+    throw new TypeError("CjsBnkFormat: expected a Wwise soundbank starting with a BKHD chunk");
+  }
+  return {
+    payloadType: "audio",
+    mediaTypes: ["audio"],
+    byteLength: bytes.byteLength,
+    source: values.source || "buffer",
+    ...inspectBNK(bytes)
+  };
+}
+
+/**
+ * Extract embedded media payloads as views over the soundbank bytes.
+ *
+ * Returned `bytes` are subarray views, not copies; callers that outlive the
+ * source buffer should copy them.
+ *
+ * @param {Uint8Array} bytes Soundbank bytes.
+ * @param {object} metadata Inspection result for those bytes.
+ * @param {number} [mediaId] Optional single media id filter.
+ * @returns {Array<object>} Extracted media items.
+ */
+function extractMedia(bytes, metadata, mediaId) {
+  const items = [];
+  for (const entry of metadata.media) {
+    if (mediaId !== undefined && entry.id !== mediaId) continue;
+    if (!entry.available) continue;
+    const payload = bytes.subarray(entry.absoluteOffset, entry.absoluteOffset + entry.length);
+    items.push({
+      id: entry.id,
+      length: entry.length,
+      isWem: payload.length >= 12 && (fourCc(payload, 0) === "RIFF" || fourCc(payload, 0) === "RIFX") && fourCc(payload, 8) === "WAVE",
+      bytes: payload
+    });
+  }
+  return items;
+}
+function isSupportedWithValues(input, values = DEFAULT_VALUES) {
+  try {
+    const metadata = inspectWithValues(input, values);
+    const extractable = metadata.media.some(entry => entry.available);
+    return {
+      format: "bnk",
+      source: values.source || "buffer",
+      supported: "partial",
+      confidence: 1,
+      preferred: extractable ? OUTPUT_MEDIA : "raw",
+      reason: extractable ? "Soundbank recognized; embedded media can be extracted undecoded." : "Soundbank recognized; it carries no extractable embedded media.",
+      metadata,
+      variants: [{
+        kind: "raw",
+        payloadType: "raw",
+        codec: "wwise-soundbank",
+        mimeType: "application/octet-stream",
+        supported: true,
+        containerOnly: true,
+        isDecoded: false,
+        pcmDecodeSupported: false
+      }, {
+        kind: OUTPUT_MEDIA,
+        payloadType: OUTPUT_MEDIA,
+        codec: "wem",
+        supported: extractable,
+        containerOnly: true,
+        isDecoded: false,
+        reason: extractable ? "" : "No DIDX/DATA media entries are present."
+      }],
+      warnings: [],
+      errors: []
+    };
+  } catch (error) {
+    return {
+      format: "bnk",
+      source: values.source || "buffer",
+      supported: "none",
+      confidence: 0,
+      preferred: "",
+      reason: error.message,
+      metadata: null,
+      variants: [],
+      warnings: [],
+      errors: [error.message]
+    };
+  }
+}
+function readWithValues(input, values = DEFAULT_VALUES) {
+  const bytes = toBytes(input);
+  const metadata = inspectWithValues(bytes, values);
+  if (values.emit === OUTPUT_BNK_JSON) return metadata;
+  if (values.emit === OUTPUT_MEDIA) {
+    return {
+      payloadType: OUTPUT_MEDIA,
+      sourceFormat: "bnk",
+      containerOnly: true,
+      isDecoded: false,
+      metadata,
+      items: extractMedia(bytes, metadata)
+    };
+  }
+  return {
+    payloadType: "raw",
+    sourceFormat: "bnk",
+    mimeType: "application/octet-stream",
+    containerOnly: true,
+    isDecoded: false,
+    pcmDecodeSupported: false,
+    metadata,
+    bytes
+  };
+}
+function toJsonValue(value) {
+  if (value instanceof Uint8Array) return {
+    byteLength: value.byteLength
+  };
+  if (Array.isArray(value)) return value.map(toJsonValue);
+  if (value && typeof value === "object") {
+    const output = {};
+    for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
+    return output;
+  }
+  return value;
+}
+function asciiString(bytes, offset, length) {
+  let value = "";
+  for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i]);
+  return value;
+}
+function fourCc(bytes, offset, length = 4) {
+  let value = "";
+  for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);
+  return value;
+}
+function readU32(bytes, offset) {
+  return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] * 0x1000000) >>> 0;
+}
+
+export { DEFAULT_VALUES, HIRC_TYPE_NAMES, OUTPUT_BNK_JSON, OUTPUT_JSON, OUTPUT_MEDIA, OUTPUT_RAW, extractMedia, inspectBNK, inspectWithValues, isBNK, isSupportedWithValues, normalizeEmit, normalizeValues, readWithValues, toBytes, toJsonValue };
+//# sourceMappingURL=helpers.js.map

package/dist/formats/bnk/core/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/bnk/core/helpers.js"],"sourcesContent":["export const OUTPUT_RAW = \"raw\";\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_BNK_JSON = \"bnkJson\";\nexport const OUTPUT_MEDIA = \"media\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_RAW,\n    inputType: \"bnk\",\n    source: \"\"\n});\n\n/**\n * Advisory names for classic HIRC object type ids.\n *\n * Type ids shifted in later Wwise releases, so these names are hints for\n * debugging and inventory work, not a version-exact schema. Unknown ids are\n * reported as `hirc-type-<n>`.\n */\nexport const HIRC_TYPE_NAMES = Object.freeze({\n    1: \"settings\",\n    2: \"sound\",\n    3: \"event-action\",\n    4: \"event\",\n    5: \"random-sequence-container\",\n    6: \"switch-container\",\n    7: \"actor-mixer\",\n    8: \"audio-bus\",\n    9: \"blend-container\",\n    10: \"music-segment\",\n    11: \"music-track\",\n    12: \"music-switch-container\",\n    13: \"music-playlist-container\",\n    14: \"attenuation\",\n    15: \"dialogue-event\",\n    16: \"motion-bus\",\n    17: \"motion-fx\",\n    18: \"effect\",\n    19: \"auxiliary-bus\",\n    20: \"lfo\",\n    21: \"envelope\",\n    22: \"audio-device\"\n});\n\nexport function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = \"CjsBnkFormat\")\n{\n    const values = { ...DEFAULT_VALUES, ...(base || {}), ...(options || {}) };\n    values.inputType = values.inputType ? String(values.inputType).replace(/^\\./u, \"\").toLowerCase() : \"bnk\";\n    values.emit = normalizeEmit(values.emit, readerName);\n    return values;\n}\n\nexport function normalizeEmit(emit, readerName)\n{\n    if (emit === undefined || emit === null) return OUTPUT_RAW;\n    if (emit === OUTPUT_JSON) return OUTPUT_BNK_JSON;\n    if ([ OUTPUT_RAW, OUTPUT_BNK_JSON, OUTPUT_MEDIA ].includes(emit)) return emit;\n    throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);\n}\n\nexport function toBytes(input)\n{\n    if (input instanceof Uint8Array) return input;\n    if (input instanceof ArrayBuffer) return new Uint8Array(input);\n    if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n    throw new TypeError(\"Bnk input must be Uint8Array, ArrayBuffer, or DataView\");\n}\n\n/**\n * Test for a Wwise soundbank BKHD signature.\n *\n * @param {Uint8Array} bytes Candidate bytes.\n * @returns {boolean} True when the bank header chunk is present.\n */\nexport function isBNK(bytes)\n{\n    return bytes.byteLength >= 8 && fourCc(bytes, 0) === \"BKHD\";\n}\n\n/**\n * Inspect Wwise soundbank bytes without copying media payloads.\n *\n * Walks the chunk sequence and decodes the bank header (BKHD), embedded media\n * index (DIDX/DATA), object hierarchy listing (HIRC), and referenced bank\n * names (STID). Unknown chunks are recorded, never rejected; a truncated\n * trailing chunk stops the walk and is flagged.\n *\n * Wwise soundbanks are written little-endian on all platforms EVE ships on;\n * this reader assumes little-endian data.\n *\n * @param {Uint8Array} bytes Soundbank bytes.\n * @returns {object} Soundbank metadata.\n */\nexport function inspectBNK(bytes)\n{\n    const info = {\n        sourceFormat: \"bnk\",\n        bankVersion: 0,\n        bankId: 0,\n        languageId: 0,\n        media: [],\n        hirc: [],\n        names: [],\n        chunks: []\n    };\n\n    let dataChunkOffset = 0;\n    let dataChunkSize = 0;\n    let mediaIndex = [];\n    let offset = 0;\n\n    while (offset + 8 <= bytes.byteLength)\n    {\n        const id = fourCc(bytes, offset);\n        const size = readU32(bytes, offset + 4);\n        const dataOffset = offset + 8;\n        if (dataOffset + size > bytes.byteLength)\n        {\n            info.chunks.push({ id, offset, dataOffset, size, truncated: true });\n            break;\n        }\n        info.chunks.push({ id, offset, dataOffset, size });\n\n        if (id === \"BKHD\" && size >= 12)\n        {\n            info.bankVersion = readU32(bytes, dataOffset);\n            info.bankId = readU32(bytes, dataOffset + 4);\n            info.languageId = readU32(bytes, dataOffset + 8);\n        }\n        if (id === \"DIDX\")\n        {\n            mediaIndex = readMediaIndex(bytes, dataOffset, size);\n        }\n        if (id === \"DATA\")\n        {\n            dataChunkOffset = dataOffset;\n            dataChunkSize = size;\n        }\n        if (id === \"HIRC\")\n        {\n            info.hirc = readHircListing(bytes, dataOffset, size);\n        }\n        if (id === \"STID\")\n        {\n            info.names = readNameTable(bytes, dataOffset, size);\n        }\n\n        offset = dataOffset + size;\n    }\n\n    info.media = mediaIndex.map((entry) =>\n    {\n        const absoluteOffset = dataChunkOffset + entry.offset;\n        const available = dataChunkOffset > 0 &&\n            entry.offset + entry.length <= dataChunkSize &&\n            absoluteOffset + entry.length <= bytes.byteLength;\n        return {\n            id: entry.id,\n            offset: entry.offset,\n            absoluteOffset: dataChunkOffset > 0 ? absoluteOffset : 0,\n            length: entry.length,\n            available\n        };\n    });\n\n    info.mediaCount = info.media.length;\n    info.hircCount = info.hirc.length;\n    return info;\n}\n\nfunction readMediaIndex(bytes, dataOffset, size)\n{\n    const entries = [];\n    const count = Math.floor(size / 12);\n    for (let i = 0; i < count; i++)\n    {\n        const entryOffset = dataOffset + i * 12;\n        entries.push({\n            id: readU32(bytes, entryOffset),\n            offset: readU32(bytes, entryOffset + 4),\n            length: readU32(bytes, entryOffset + 8)\n        });\n    }\n    return entries;\n}\n\nfunction readHircListing(bytes, dataOffset, size)\n{\n    const entries = [];\n    if (size < 4) return entries;\n    const count = readU32(bytes, dataOffset);\n    const end = dataOffset + size;\n    let offset = dataOffset + 4;\n\n    for (let i = 0; i < count; i++)\n    {\n        if (offset + 9 > end) break;\n        const type = bytes[offset];\n        const entrySize = readU32(bytes, offset + 1);\n        const payloadOffset = offset + 5;\n        if (entrySize < 4 || payloadOffset + entrySize > end) break;\n        entries.push({\n            type,\n            typeName: HIRC_TYPE_NAMES[type] || `hirc-type-${type}`,\n            id: readU32(bytes, payloadOffset),\n            offset: payloadOffset,\n            size: entrySize\n        });\n        offset = payloadOffset + entrySize;\n    }\n\n    return entries;\n}\n\nfunction readNameTable(bytes, dataOffset, size)\n{\n    const names = [];\n    if (size < 8) return names;\n    const count = readU32(bytes, dataOffset + 4);\n    const end = dataOffset + size;\n    let offset = dataOffset + 8;\n\n    for (let i = 0; i < count; i++)\n    {\n        if (offset + 5 > end) break;\n        const bankId = readU32(bytes, offset);\n        const length = bytes[offset + 4];\n        if (offset + 5 + length > end) break;\n        names.push({\n            bankId,\n            name: asciiString(bytes, offset + 5, length)\n        });\n        offset += 5 + length;\n    }\n\n    return names;\n}\n\nexport function inspectWithValues(input, values = DEFAULT_VALUES)\n{\n    const bytes = toBytes(input);\n    if (!isBNK(bytes))\n    {\n        throw new TypeError(\"CjsBnkFormat: expected a Wwise soundbank starting with a BKHD chunk\");\n    }\n    return {\n        payloadType: \"audio\",\n        mediaTypes: [ \"audio\" ],\n        byteLength: bytes.byteLength,\n        source: values.source || \"buffer\",\n        ...inspectBNK(bytes)\n    };\n}\n\n/**\n * Extract embedded media payloads as views over the soundbank bytes.\n *\n * Returned `bytes` are subarray views, not copies; callers that outlive the\n * source buffer should copy them.\n *\n * @param {Uint8Array} bytes Soundbank bytes.\n * @param {object} metadata Inspection result for those bytes.\n * @param {number} [mediaId] Optional single media id filter.\n * @returns {Array<object>} Extracted media items.\n */\nexport function extractMedia(bytes, metadata, mediaId)\n{\n    const items = [];\n    for (const entry of metadata.media)\n    {\n        if (mediaId !== undefined && entry.id !== mediaId) continue;\n        if (!entry.available) continue;\n        const payload = bytes.subarray(entry.absoluteOffset, entry.absoluteOffset + entry.length);\n        items.push({\n            id: entry.id,\n            length: entry.length,\n            isWem: payload.length >= 12 &&\n                (fourCc(payload, 0) === \"RIFF\" || fourCc(payload, 0) === \"RIFX\") &&\n                fourCc(payload, 8) === \"WAVE\",\n            bytes: payload\n        });\n    }\n    return items;\n}\n\nexport function isSupportedWithValues(input, values = DEFAULT_VALUES)\n{\n    try\n    {\n        const metadata = inspectWithValues(input, values);\n        const extractable = metadata.media.some((entry) => entry.available);\n        return {\n            format: \"bnk\",\n            source: values.source || \"buffer\",\n            supported: \"partial\",\n            confidence: 1,\n            preferred: extractable ? OUTPUT_MEDIA : \"raw\",\n            reason: extractable\n                ? \"Soundbank recognized; embedded media can be extracted undecoded.\"\n                : \"Soundbank recognized; it carries no extractable embedded media.\",\n            metadata,\n            variants: [\n                {\n                    kind: \"raw\",\n                    payloadType: \"raw\",\n                    codec: \"wwise-soundbank\",\n                    mimeType: \"application/octet-stream\",\n                    supported: true,\n                    containerOnly: true,\n                    isDecoded: false,\n                    pcmDecodeSupported: false\n                },\n                {\n                    kind: OUTPUT_MEDIA,\n                    payloadType: OUTPUT_MEDIA,\n                    codec: \"wem\",\n                    supported: extractable,\n                    containerOnly: true,\n                    isDecoded: false,\n                    reason: extractable ? \"\" : \"No DIDX/DATA media entries are present.\"\n                }\n            ],\n            warnings: [],\n            errors: []\n        };\n    }\n    catch (error)\n    {\n        return {\n            format: \"bnk\",\n            source: values.source || \"buffer\",\n            supported: \"none\",\n            confidence: 0,\n            preferred: \"\",\n            reason: error.message,\n            metadata: null,\n            variants: [],\n            warnings: [],\n            errors: [ error.message ]\n        };\n    }\n}\n\nexport function readWithValues(input, values = DEFAULT_VALUES)\n{\n    const bytes = toBytes(input);\n    const metadata = inspectWithValues(bytes, values);\n    if (values.emit === OUTPUT_BNK_JSON) return metadata;\n    if (values.emit === OUTPUT_MEDIA)\n    {\n        return {\n            payloadType: OUTPUT_MEDIA,\n            sourceFormat: \"bnk\",\n            containerOnly: true,\n            isDecoded: false,\n            metadata,\n            items: extractMedia(bytes, metadata)\n        };\n    }\n    return {\n        payloadType: \"raw\",\n        sourceFormat: \"bnk\",\n        mimeType: \"application/octet-stream\",\n        containerOnly: true,\n        isDecoded: false,\n        pcmDecodeSupported: false,\n        metadata,\n        bytes\n    };\n}\n\nexport function toJsonValue(value)\n{\n    if (value instanceof Uint8Array) return { byteLength: value.byteLength };\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value && typeof value === \"object\")\n    {\n        const output = {};\n        for (const [ key, entry ] of Object.entries(value)) output[key] = toJsonValue(entry);\n        return output;\n    }\n    return value;\n}\n\nfunction asciiString(bytes, offset, length)\n{\n    let value = \"\";\n    for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i]);\n    return value;\n}\n\nfunction fourCc(bytes, offset, length = 4)\n{\n    let value = \"\";\n    for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);\n    return value;\n}\n\nfunction readU32(bytes, offset)\n{\n    return (bytes[offset] | (bytes[offset + 1] << 8) | (bytes[offset + 2] << 16) | (bytes[offset + 3] * 0x1000000)) >>> 0;\n}\n"],"names":["OUTPUT_RAW","OUTPUT_JSON","OUTPUT_BNK_JSON","OUTPUT_MEDIA","DEFAULT_VALUES","Object","freeze","emit","inputType","source","HIRC_TYPE_NAMES","normalizeValues","base","options","readerName","values","String","replace","toLowerCase","normalizeEmit","undefined","includes","TypeError","JSON","stringify","toBytes","input","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","isBNK","bytes","fourCc","inspectBNK","info","sourceFormat","bankVersion","bankId","languageId","media","hirc","names","chunks","dataChunkOffset","dataChunkSize","mediaIndex","offset","id","size","readU32","dataOffset","push","truncated","readMediaIndex","readHircListing","readNameTable","map","entry","absoluteOffset","available","length","mediaCount","hircCount","entries","count","Math","floor","i","entryOffset","end","type","entrySize","payloadOffset","typeName","name","asciiString","inspectWithValues","payloadType","mediaTypes","extractMedia","metadata","mediaId","items","payload","subarray","isWem","isSupportedWithValues","extractable","some","format","supported","confidence","preferred","reason","variants","kind","codec","mimeType","containerOnly","isDecoded","pcmDecodeSupported","warnings","errors","error","message","readWithValues","toJsonValue","value","Array","isArray","output","key","fromCharCode"],"mappings":"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"}

package/dist/formats/bnk/core/soundbanksInfo.js

@@ -0,0 +1,246 @@
+/**
+ * Readers for Wwise SoundbanksInfo metadata (the `soundbanksinfo.json` file
+ * generated next to soundbanks).
+ *
+ * SoundbanksInfo is the authoring-name authority for soundbank content: it
+ * maps media ids to original source paths and lists per-bank events, switch
+ * groups, state groups, and game parameters. These helpers normalize that
+ * document and join it against `CjsBnkFormat` inspection output; they never
+ * touch audio bytes.
+ */
+
+/**
+ * Compute the Wwise 32-bit id for a name.
+ *
+ * Wwise derives bank, event, and language ids as the FNV-1 32-bit hash of the
+ * lowercased name (verified against EVE build 3421648 bank and language ids).
+ *
+ * @param {string} name Bank, event, switch, or language name.
+ * @returns {number} Unsigned 32-bit Wwise id.
+ */
+function wwiseIdFromName(name) {
+  let hash = 2166136261 >>> 0;
+  const text = String(name).toLowerCase();
+  for (let i = 0; i < text.length; i++) {
+    hash = Math.imul(hash, 16777619) >>> 0;
+    hash = (hash ^ text.charCodeAt(i)) >>> 0;
+  }
+  return hash;
+}
+function toSoundbanksInfoDocument(input) {
+  let value = input;
+  if (value instanceof ArrayBuffer) value = new Uint8Array(value);
+  if (ArrayBuffer.isView(value)) value = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+  if (value instanceof Uint8Array) value = utf8String(value);
+  if (typeof value === "string") {
+    try {
+      value = JSON.parse(value);
+    } catch (error) {
+      throw new TypeError(`CjsBnkFormat: SoundbanksInfo input is not valid JSON (${error.message})`);
+    }
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError("CjsBnkFormat: SoundbanksInfo input must be JSON bytes, text, or an object");
+  }
+  const document = value.SoundBanksInfo || value;
+  if (!document || typeof document !== "object" || !Array.isArray(document.SoundBanks)) {
+    throw new TypeError("CjsBnkFormat: input has no SoundBanksInfo.SoundBanks document");
+  }
+  return document;
+}
+
+/**
+ * Test whether input looks like a Wwise SoundbanksInfo document.
+ *
+ * @param {Uint8Array|ArrayBuffer|DataView|string|object} input Candidate document.
+ * @returns {boolean} True when a SoundBanksInfo bank list is present.
+ */
+function isSoundbanksInfo(input) {
+  try {
+    toSoundbanksInfoDocument(input);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Parse SoundbanksInfo into a normalized camelCase summary.
+ *
+ * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.
+ * @returns {object} Normalized document summary with per-bank details.
+ */
+function parseSoundbanksInfo(input) {
+  const document = toSoundbanksInfoDocument(input);
+  const banks = document.SoundBanks.map(normalizeBank);
+  const summary = {
+    platform: document.Platform || "",
+    basePlatform: document.BasePlatform || "",
+    schemaVersion: document.SchemaVersion || "",
+    soundBankVersion: document.SoundBankVersion || "",
+    bankCount: banks.length,
+    mediaCount: 0,
+    streamingMediaCount: 0,
+    eventCount: 0,
+    languages: [],
+    banks
+  };
+  const languages = new Set();
+  for (const bank of banks) {
+    summary.mediaCount += bank.media.length;
+    summary.streamingMediaCount += bank.media.filter(entry => entry.streaming).length;
+    summary.eventCount += bank.events.length;
+    if (bank.language) languages.add(bank.language);
+  }
+  summary.languages = [...languages].sort();
+  return summary;
+}
+function normalizeBank(bank) {
+  return {
+    id: String(bank.Id ?? ""),
+    type: bank.Type || "",
+    language: bank.Language || "",
+    shortName: bank.ShortName || "",
+    path: bank.Path || "",
+    media: (bank.Media || []).map(entry => ({
+      id: String(entry.Id ?? ""),
+      shortName: entry.ShortName || "",
+      cachePath: entry.CachePath || "",
+      language: entry.Language || "",
+      streaming: entry.Streaming === "true",
+      location: entry.Location || ""
+    })),
+    events: (bank.Events || []).map(entry => ({
+      id: String(entry.Id ?? ""),
+      name: entry.Name || ""
+    })),
+    switchGroups: (bank.SwitchGroups || []).map(group => ({
+      id: String(group.Id ?? ""),
+      name: group.Name || "",
+      switches: (group.Switches || []).map(entry => ({
+        id: String(entry.Id ?? ""),
+        name: entry.Name || ""
+      }))
+    })),
+    stateGroups: (bank.StateGroups || []).map(group => ({
+      id: String(group.Id ?? ""),
+      name: group.Name || "",
+      states: (group.States || []).map(entry => ({
+        id: String(entry.Id ?? ""),
+        name: entry.Name || ""
+      }))
+    })),
+    gameParameters: (bank.GameParameters || []).map(entry => ({
+      id: String(entry.Id ?? ""),
+      name: entry.Name || ""
+    }))
+  };
+}
+
+/**
+ * Build id-keyed lookup tables from SoundbanksInfo.
+ *
+ * Media ids repeat across language variants of the same bank, so
+ * `mediaById[id]` is an array of entries; event ids are unique.
+ *
+ * @param {Uint8Array|ArrayBuffer|DataView|string|object} input SoundbanksInfo JSON bytes, text, or object.
+ * @returns {object} Catalog with banksById, mediaById, eventsById, and eventsByName.
+ */
+function buildSoundbanksCatalog(input) {
+  const parsed = parseSoundbanksInfo(input);
+  const catalog = {
+    platform: parsed.platform,
+    soundBankVersion: parsed.soundBankVersion,
+    bankCount: parsed.bankCount,
+    mediaCount: parsed.mediaCount,
+    eventCount: parsed.eventCount,
+    languages: parsed.languages,
+    banksById: {},
+    bankVariantsById: {},
+    mediaById: {},
+    eventsById: {},
+    eventsByName: {}
+  };
+  for (const bank of parsed.banks) {
+    if (!catalog.banksById[bank.id]) catalog.banksById[bank.id] = bank;
+    if (!catalog.bankVariantsById[bank.id]) catalog.bankVariantsById[bank.id] = [];
+    catalog.bankVariantsById[bank.id].push(bank);
+    for (const entry of bank.media) {
+      const reference = {
+        ...entry,
+        bankId: bank.id,
+        bankName: bank.shortName
+      };
+      if (!catalog.mediaById[entry.id]) catalog.mediaById[entry.id] = [];
+      catalog.mediaById[entry.id].push(reference);
+    }
+    for (const entry of bank.events) {
+      const reference = {
+        ...entry,
+        bankId: bank.id,
+        bankName: bank.shortName
+      };
+      catalog.eventsById[entry.id] = reference;
+      catalog.eventsByName[entry.name] = reference;
+    }
+  }
+  return catalog;
+}
+
+/**
+ * Join a `CjsBnkFormat` inspection result with a SoundbanksInfo catalog.
+ *
+ * Annotates the bank's embedded media and HIRC event listing with authoring
+ * names. Entries with no catalog match keep `null` name fields rather than
+ * being dropped, so counts stay aligned with the inspected bank. Language
+ * variants of a bank share one bank id; the inspected BKHD `languageId`
+ * (an FNV-1 hash of the language name) selects the exact variant.
+ *
+ * @param {object} bankInfo `CjsBnkFormat` inspect output.
+ * @param {object} catalog `buildSoundbanksCatalog` output.
+ * @returns {object} Bank/media/event annotations for the inspected bank.
+ */
+function joinSoundbanksInfo(bankInfo, catalog) {
+  const bankId = String(bankInfo.bankId ?? "");
+  const variants = catalog.bankVariantsById[bankId] || [];
+  const bank = variants.find(variant => wwiseIdFromName(variant.language) === bankInfo.languageId) || catalog.banksById[bankId] || null;
+  const bankLanguage = bank ? bank.language : "";
+  const media = (bankInfo.media || []).map(entry => {
+    const references = catalog.mediaById[String(entry.id)] || [];
+    const match = references.find(reference => reference.bankId === bankId && reference.language === bankLanguage) || references.find(reference => reference.bankId === bankId) || references[0] || null;
+    return {
+      id: entry.id,
+      length: entry.length,
+      available: entry.available,
+      shortName: match ? match.shortName : null,
+      cachePath: match ? match.cachePath : null,
+      language: match ? match.language : null,
+      streaming: match ? match.streaming : null
+    };
+  });
+  const events = (bankInfo.hirc || []).filter(entry => entry.typeName === "event").map(entry => {
+    const match = catalog.eventsById[String(entry.id)] || null;
+    return {
+      id: entry.id,
+      name: match ? match.name : null,
+      bankName: match ? match.bankName : null
+    };
+  });
+  return {
+    bankId,
+    bank,
+    media,
+    namedMediaCount: media.filter(entry => entry.shortName !== null).length,
+    events,
+    namedEventCount: events.filter(entry => entry.name !== null).length
+  };
+}
+function utf8String(bytes) {
+  if (typeof TextDecoder !== "undefined") return new TextDecoder("utf-8").decode(bytes);
+  let value = "";
+  for (let i = 0; i < bytes.length; i++) value += String.fromCharCode(bytes[i]);
+  return value;
+}
+
+export { buildSoundbanksCatalog, isSoundbanksInfo, joinSoundbanksInfo, parseSoundbanksInfo, toSoundbanksInfoDocument, wwiseIdFromName };
+//# sourceMappingURL=soundbanksInfo.js.map