@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

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

@@ -1 +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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"}
+{"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        const entry = {\n            type,\n            typeName: HIRC_TYPE_NAMES[type] || `hirc-type-${type}`,\n            id: readU32(bytes, payloadOffset),\n            offset: payloadOffset,\n            size: entrySize,\n            // View over the object body AFTER the leading u32 id; not a copy.\n            payload: bytes.subarray(payloadOffset + 4, payloadOffset + entrySize)\n        };\n        decodeHircFields(entry);\n        entries.push(entry);\n        offset = payloadOffset + entrySize;\n    }\n\n    return entries;\n}\n\n/**\n * Decode the version-stable typed fields of common HIRC object types in\n * place. Field layouts verified by hexdump against EVE soundbanks (bank\n * generator version 150 / Wwise 2022.1); every read is bounds-checked, and a\n * body too short for its type's layout simply keeps the raw payload only.\n *\n * - event (4): `u8 actionCount` + `actionCount x u32` -> `actionIds`.\n * - event-action (3): `u16 actionType` (high byte = family: 0x04 play,\n *   0x01 stop, 0x02 pause, 0x03 resume) + `u32 targetId`.\n * - sound (2): `u32 pluginId, u8 streamType, u32 sourceId (wem id),\n *   u32 inMemoryMediaSize` (streamType 0 = embedded, 1 = streamed).\n * - music-track (11): `u8 flags, u32 sourceCount`, then per source the same\n *   plugin/stream/source/size quad as sound -> `sources`.\n *\n * Deeper structures (container children, positioning, RTPC curves) remain\n * undecoded; consumers interpret `payload` themselves.\n */\nfunction decodeHircFields(entry)\n{\n    const body = entry.payload;\n    if (entry.type === 4 && body.byteLength >= 1)\n    {\n        const actionIds = [];\n        const actionCount = body[0];\n        for (let i = 0; i < actionCount && 1 + i * 4 + 4 <= body.byteLength; i++)\n        {\n            actionIds.push(readU32(body, 1 + i * 4));\n        }\n        entry.actionIds = actionIds;\n    }\n    else if (entry.type === 3 && body.byteLength >= 6)\n    {\n        entry.actionType = body[0] | (body[1] << 8);\n        entry.targetId = readU32(body, 2);\n    }\n    else if (entry.type === 2 && body.byteLength >= 13)\n    {\n        entry.pluginId = readU32(body, 0);\n        entry.streamType = body[4];\n        entry.sourceId = readU32(body, 5);\n        entry.inMemoryMediaSize = readU32(body, 9);\n    }\n    else if (entry.type === 11 && body.byteLength >= 5)\n    {\n        const sources = [];\n        const sourceCount = readU32(body, 1);\n        for (let i = 0; i < sourceCount; i++)\n        {\n            const at = 5 + i * 14;\n            if (at + 13 > body.byteLength) break;\n            sources.push({\n                pluginId: readU32(body, at),\n                streamType: body[at + 4],\n                sourceId: readU32(body, at + 5),\n                inMemoryMediaSize: readU32(body, at + 9)\n            });\n        }\n        entry.sources = sources;\n    }\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","payload","subarray","decodeHircFields","body","actionIds","actionCount","actionType","targetId","pluginId","streamType","sourceId","inMemoryMediaSize","sources","sourceCount","at","name","asciiString","inspectWithValues","payloadType","mediaTypes","extractMedia","metadata","mediaId","items","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/musicNodes.js

@@ -0,0 +1,521 @@
+// Wwise interactive-music node decoding: typed payloads for music-segment
+// (10), music-track (11), music-switch-container (12), and
+// music-playlist-container (13) HIRC entries. Exposed through
+// `CjsBnkFormat.wwise` next to the event graph walk - interpretation over
+// `inspect()` results, never part of the format read path.
+//
+// Verified against EVE soundbanks (bank generator version 150 / Wwise
+// 2022.1): 2,484 tracks, 1,326 segments, 214 playlists, and 54 switch
+// containers across music.bnk + music_essential.bnk all decode with the
+// exact-end validation below (2026-07-19 corpus run).
+//
+// Approach: consumers of these nodes (music schedulers) only need the fields
+// AFTER the variable-length NodeBaseParams block - children, meter, stingers,
+// and each type's tail - so segment/playlist/switch payloads are parsed from
+// a children+meter ANCHOR (a u32 child count and child ids that exist in the
+// bank, followed by a plausible AkMeterInfo) and the parse is accepted only
+// when it consumes the payload EXACTLY to its end. Track clips live at the
+// head (before NodeBaseParams) and the track's type block is tail-validated
+// the same way.
+
+class MusicCursor {
+  constructor(bytes, offset = 0) {
+    this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    this.bytes = bytes;
+    this.at = offset;
+  }
+  get remaining() {
+    return this.bytes.byteLength - this.at;
+  }
+  u8() {
+    return this.view.getUint8(this.at++);
+  }
+  u16() {
+    const value = this.view.getUint16(this.at, true);
+    this.at += 2;
+    return value;
+  }
+  s16() {
+    const value = this.view.getInt16(this.at, true);
+    this.at += 2;
+    return value;
+  }
+  u32() {
+    const value = this.view.getUint32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+  s32() {
+    const value = this.view.getInt32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+  f32() {
+    const value = this.view.getFloat32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+  f64() {
+    const value = this.view.getFloat64(this.at, true);
+    this.at += 8;
+    return value;
+  }
+  stringZ() {
+    let end = this.at;
+    while (end < this.bytes.byteLength && this.bytes[end] !== 0) end++;
+    let value = "";
+    for (let i = this.at; i < end; i++) value += String.fromCharCode(this.bytes[i]);
+    this.at = end + 1;
+    return value;
+  }
+}
+function plausibleMeter(view, at, byteLength) {
+  if (at + 22 > byteLength) return false;
+  const grid = view.getFloat64(at, true);
+  const offset = view.getFloat64(at + 8, true);
+  const tempo = view.getFloat32(at + 16, true);
+  const beats = view.getUint8(at + 20);
+  const beatValue = view.getUint8(at + 21);
+  return Number.isFinite(grid) && grid >= 0 && grid < 600000 && Number.isFinite(offset) && offset >= 0 && offset < 600000 && Number.isFinite(tempo) && tempo > 0 && tempo < 1000 && beats >= 1 && beats <= 64 && [1, 2, 4, 8, 16, 32].includes(beatValue);
+}
+function findAnchors(bytes, knownIds) {
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const anchors = [];
+  for (let at = 1; at + 4 <= bytes.byteLength; at++) {
+    const count = view.getUint32(at, true);
+    if (count > 256 || at + 4 + count * 4 + 22 > bytes.byteLength) continue;
+    let valid = true;
+    for (let i = 0; i < count; i++) {
+      if (!knownIds.has(view.getUint32(at + 4 + i * 4, true))) {
+        valid = false;
+        break;
+      }
+    }
+    if (valid && plausibleMeter(view, at + 4 + count * 4, bytes.byteLength)) {
+      anchors.push(at);
+    }
+  }
+  return anchors;
+}
+function readMusicNodeTail(cursor) {
+  const childCount = cursor.u32();
+  const children = [];
+  for (let i = 0; i < childCount; i++) children.push(cursor.u32());
+  const meter = {
+    gridPeriod: cursor.f64(),
+    gridOffset: cursor.f64(),
+    tempo: cursor.f32(),
+    beatsPerBar: cursor.u8(),
+    beatValue: cursor.u8()
+  };
+  const meterOverride = cursor.u8() !== 0;
+  const stingerCount = cursor.u32();
+  const stingers = [];
+  for (let i = 0; i < stingerCount; i++) {
+    stingers.push({
+      triggerId: cursor.u32(),
+      segmentId: cursor.u32(),
+      syncPlayAt: cursor.u32(),
+      cueFilterHash: cursor.u32(),
+      dontRepeatTime: cursor.s32(),
+      numSegmentLookAhead: cursor.u32()
+    });
+  }
+  return {
+    children,
+    meter,
+    meterOverride,
+    stingers
+  };
+}
+
+/** AkMusicTransNodeParams: transition rules shared by playlist + switch containers. */
+function readTransRules(cursor) {
+  const ruleCount = cursor.u32();
+  if (ruleCount > 4096) throw new RangeError("rule count");
+  const rules = [];
+  for (let i = 0; i < ruleCount; i++) {
+    const srcCount = cursor.u32();
+    if (srcCount > 1024) throw new RangeError("src count");
+    const srcIds = [];
+    for (let j = 0; j < srcCount; j++) srcIds.push(cursor.s32());
+    const dstCount = cursor.u32();
+    if (dstCount > 1024) throw new RangeError("dst count");
+    const dstIds = [];
+    for (let j = 0; j < dstCount; j++) dstIds.push(cursor.s32());
+    const src = {
+      transitionTime: cursor.s32(),
+      fadeCurve: cursor.u32(),
+      fadeOffset: cursor.s32(),
+      syncType: cursor.u32(),
+      cueFilterHash: cursor.u32(),
+      playPostExit: cursor.u8() !== 0
+    };
+    const dst = {
+      transitionTime: cursor.s32(),
+      fadeCurve: cursor.u32(),
+      fadeOffset: cursor.s32(),
+      cueFilterHash: cursor.u32(),
+      jumpToId: cursor.u32(),
+      jumpToType: cursor.u16(),
+      entryType: cursor.u16(),
+      playPreEntry: cursor.u8() !== 0,
+      matchSourceCueName: cursor.u8() !== 0
+    };
+    let transitionSegment = null;
+    if (cursor.u8() !== 0) {
+      transitionSegment = {
+        segmentId: cursor.u32(),
+        fadeIn: {
+          transitionTime: cursor.s32(),
+          fadeCurve: cursor.u32(),
+          fadeOffset: cursor.s32()
+        },
+        fadeOut: {
+          transitionTime: cursor.s32(),
+          fadeCurve: cursor.u32(),
+          fadeOffset: cursor.s32()
+        },
+        playPreEntry: cursor.u8() !== 0,
+        playPostExit: cursor.u8() !== 0
+      };
+    }
+    rules.push({
+      srcIds,
+      dstIds,
+      src,
+      dst,
+      transitionSegment
+    });
+  }
+  return rules;
+}
+
+/**
+ * Decode a music-segment (HIRC 10) payload: children, meter, stingers,
+ * duration, and entry/exit markers.
+ *
+ * @param {Uint8Array} bytes Entry payload view from `inspect()`.
+ * @param {Set<number>} knownIds Every HIRC object id in the same bank.
+ * @returns {object|null} Decoded segment, or null when no anchored parse consumes the payload exactly.
+ */
+function parseMusicSegment(bytes, knownIds) {
+  for (const anchor of findAnchors(bytes, knownIds)) {
+    try {
+      const cursor = new MusicCursor(bytes, anchor);
+      const node = readMusicNodeTail(cursor);
+      const duration = cursor.f64();
+      if (!Number.isFinite(duration) || duration < 0 || duration > 36000000) continue;
+      const markerCount = cursor.u32();
+      if (markerCount > 1024) continue;
+      const markers = [];
+      for (let i = 0; i < markerCount; i++) {
+        markers.push({
+          id: cursor.u32(),
+          position: cursor.f64(),
+          name: cursor.stringZ()
+        });
+      }
+      if (cursor.at !== bytes.byteLength) continue;
+      if (markers.some(marker => !Number.isFinite(marker.position) || marker.position < 0)) continue;
+      return {
+        ...node,
+        duration,
+        markers
+      };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+/**
+ * Decode a music-track (HIRC 11) payload: sources, clips (play position and
+ * trims per subtrack), track type, and switch parameters for switch tracks.
+ *
+ * @param {Uint8Array} bytes Entry payload view from `inspect()`.
+ * @returns {object|null} Decoded track, or null when neither tail layout validates.
+ */
+function parseMusicTrack(bytes) {
+  const cursor = new MusicCursor(bytes, 0);
+  cursor.u8(); // uFlags (midi/override bits)
+  const sourceCount = cursor.u32();
+  if (sourceCount > 512) return null;
+  const sources = [];
+  for (let i = 0; i < sourceCount; i++) {
+    const pluginId = cursor.u32();
+    const streamType = cursor.u8();
+    const sourceId = cursor.u32();
+    const inMemoryMediaSize = cursor.u32();
+    const sourceBits = cursor.u8();
+    if ((pluginId & 0x0f) === 0x02) {
+      const size = cursor.u32();
+      cursor.at += size;
+    }
+    sources.push({
+      pluginId,
+      streamType,
+      sourceId,
+      inMemoryMediaSize,
+      sourceBits
+    });
+  }
+  const clipCount = cursor.u32();
+  if (clipCount > 4096) return null;
+  const clips = [];
+  for (let i = 0; i < clipCount; i++) {
+    clips.push({
+      trackId: cursor.u32(),
+      sourceId: cursor.u32(),
+      eventId: cursor.u32(),
+      playAt: cursor.f64(),
+      beginTrimOffset: cursor.f64(),
+      endTrimOffset: cursor.f64(),
+      srcDuration: cursor.f64()
+    });
+  }
+  const subTrackCount = clipCount > 0 ? cursor.u32() : 0;
+  const autoCount = cursor.u32();
+  if (autoCount > 4096) return null;
+  for (let i = 0; i < autoCount; i++) {
+    cursor.u32(); // clip index
+    cursor.u32(); // automation type
+    const points = cursor.u32();
+    if (points > 65536) return null;
+    cursor.at += points * 12;
+  }
+  const headEnd = cursor.at;
+
+  // Tail: [NodeBaseParams...] u8 trackType, [switch+trans params when the
+  // type is 3], f32 lookAheadTime. The switch layout is tried FIRST because
+  // it validates every field to the exact payload end - the simple layout
+  // only checks one byte, and a switch tail ending in zero bytes would
+  // satisfy it falsely.
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const end = bytes.byteLength;
+  for (let typeAt = headEnd; typeAt <= end - 5; typeAt++) {
+    if (view.getUint8(typeAt) !== 3) continue;
+    const tail = new MusicCursor(bytes, typeAt + 1);
+    try {
+      const groupType = tail.u8();
+      if (groupType > 1) continue;
+      const groupId = tail.u32();
+      const defaultSwitch = tail.u32();
+      const assocCount = tail.u32();
+      if (assocCount > 1024) continue;
+      const assoc = [];
+      for (let i = 0; i < assocCount; i++) assoc.push(tail.u32());
+      const trans = {
+        srcTransitionTime: tail.s32(),
+        srcFadeCurve: tail.u32(),
+        srcFadeOffset: tail.s32(),
+        syncType: tail.u32(),
+        cueFilterHash: tail.u32(),
+        dstTransitionTime: tail.s32(),
+        dstFadeCurve: tail.u32(),
+        dstFadeOffset: tail.s32()
+      };
+      const lookAheadTime = tail.f32();
+      if (tail.at !== end) continue;
+      return {
+        sources,
+        clips,
+        subTrackCount,
+        trackType: 3,
+        lookAheadTime,
+        switchParams: {
+          groupType,
+          groupId,
+          defaultSwitch,
+          assoc,
+          trans
+        }
+      };
+    } catch {
+      continue;
+    }
+  }
+  const simpleAt = end - 5;
+  if (simpleAt >= headEnd) {
+    const type = view.getUint8(simpleAt);
+    if (type <= 2) {
+      return {
+        sources,
+        clips,
+        subTrackCount,
+        trackType: type,
+        lookAheadTime: view.getFloat32(end - 4, true),
+        switchParams: null
+      };
+    }
+  }
+  return null;
+}
+
+/**
+ * Decode a music-playlist-container (HIRC 13) payload: children, meter,
+ * stingers, transition rules, and the flat pre-order playlist tree.
+ *
+ * @param {Uint8Array} bytes Entry payload view from `inspect()`.
+ * @param {Set<number>} knownIds Every HIRC object id in the same bank.
+ * @returns {object|null} Decoded playlist container, or null when no anchored parse validates.
+ */
+function parseMusicPlaylist(bytes, knownIds) {
+  for (const anchor of findAnchors(bytes, knownIds)) {
+    try {
+      const cursor = new MusicCursor(bytes, anchor);
+      const node = readMusicNodeTail(cursor);
+      const rules = readTransRules(cursor);
+      const itemCount = cursor.u32();
+      if (itemCount > 8192) continue;
+      if (cursor.remaining !== itemCount * 30) continue;
+      const items = [];
+      for (let i = 0; i < itemCount; i++) {
+        items.push({
+          segmentId: cursor.u32(),
+          playlistItemId: cursor.u32(),
+          childCount: cursor.u32(),
+          rsType: cursor.s32(),
+          loop: cursor.s16(),
+          loopMin: cursor.s16(),
+          loopMax: cursor.s16(),
+          weight: cursor.u32(),
+          avoidRepeatCount: cursor.u16(),
+          usingWeight: cursor.u8() !== 0,
+          shuffle: cursor.u8() !== 0
+        });
+      }
+      if (cursor.at !== bytes.byteLength) continue;
+      return {
+        ...node,
+        rules,
+        playlist: items
+      };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+/**
+ * Decode a music-switch-container (HIRC 12) payload: children, meter,
+ * stingers, transition rules, argument groups, and the decision tree.
+ *
+ * @param {Uint8Array} bytes Entry payload view from `inspect()`.
+ * @param {Set<number>} knownIds Every HIRC object id in the same bank.
+ * @returns {object|null} Decoded switch container, or null when no anchored parse validates.
+ */
+function parseMusicSwitch(bytes, knownIds) {
+  for (const anchor of findAnchors(bytes, knownIds)) {
+    try {
+      const cursor = new MusicCursor(bytes, anchor);
+      const node = readMusicNodeTail(cursor);
+      const rules = readTransRules(cursor);
+      const continuePlayback = cursor.u8() !== 0;
+      const treeDepth = cursor.u32();
+      if (treeDepth > 16) continue;
+      const argumentGroups = [];
+      for (let i = 0; i < treeDepth; i++) argumentGroups.push({
+        groupId: cursor.u32()
+      });
+      for (let i = 0; i < treeDepth; i++) argumentGroups[i].groupType = cursor.u8();
+      const treeDataSize = cursor.u32();
+      const mode = cursor.u8();
+      if (cursor.remaining !== treeDataSize) continue;
+      if (treeDataSize % 12 !== 0) continue;
+      const treeNodes = [];
+      const nodeCount = treeDataSize / 12;
+      for (let i = 0; i < nodeCount; i++) {
+        const key = cursor.u32();
+        // 4-byte union: leaf = audioNodeId, internal = childrenIdx + count.
+        const audioNodeId = cursor.view.getUint32(cursor.at, true);
+        const childrenIdx = cursor.u16();
+        const childrenCount = cursor.u16();
+        const weight = cursor.u16();
+        const probability = cursor.u16();
+        treeNodes.push({
+          key,
+          audioNodeId,
+          childrenIdx,
+          childrenCount,
+          weight,
+          probability
+        });
+      }
+      if (cursor.at !== bytes.byteLength) continue;
+      return {
+        ...node,
+        rules,
+        continuePlayback,
+        argumentGroups,
+        mode,
+        treeNodes
+      };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+const MUSIC_PARSERS = Object.freeze({
+  10: (payload, knownIds) => parseMusicSegment(payload, knownIds),
+  11: payload => parseMusicTrack(payload),
+  12: (payload, knownIds) => parseMusicSwitch(payload, knownIds),
+  13: (payload, knownIds) => parseMusicPlaylist(payload, knownIds)
+});
+const MUSIC_TYPE_NAMES = Object.freeze({
+  10: "music-segment",
+  11: "music-track",
+  12: "music-switch-container",
+  13: "music-playlist-container"
+});
+
+/**
+ * Decode every interactive-music node across one or more inspected banks.
+ *
+ * @param {Array<object>} inspections `CjsBnkFormat.inspect()` results for every related music bank.
+ * @returns {{nodes: Map<number, object>, diagnostics: {parsed: number, failed: Array<{bank: string, type: string, id: number}>}}} Decoded nodes keyed by object id plus per-entry failures.
+ */
+function musicNodesFromBanks(inspections) {
+  const banks = Array.isArray(inspections) ? inspections : [inspections];
+  const nodes = new Map();
+  const failed = [];
+  let parsed = 0;
+  for (const inspection of banks) {
+    const knownIds = new Set();
+    for (const entry of inspection.hirc ?? []) knownIds.add(entry.id);
+    for (const entry of inspection.hirc ?? []) {
+      const parser = MUSIC_PARSERS[entry.type];
+      if (!parser) continue;
+      const payload = entry.payload instanceof Uint8Array ? entry.payload : null;
+      const decoded = payload ? parser(payload, knownIds) : null;
+      if (!decoded) {
+        failed.push({
+          bank: inspection.source || "",
+          type: MUSIC_TYPE_NAMES[entry.type],
+          id: entry.id
+        });
+        continue;
+      }
+      parsed++;
+      nodes.set(entry.id, {
+        id: entry.id,
+        type: MUSIC_TYPE_NAMES[entry.type],
+        bank: inspection.source || "",
+        ...decoded
+      });
+    }
+  }
+  return {
+    nodes,
+    diagnostics: {
+      parsed,
+      failed
+    }
+  };
+}
+
+export { musicNodesFromBanks, parseMusicPlaylist, parseMusicSegment, parseMusicSwitch, parseMusicTrack };
+//# sourceMappingURL=musicNodes.js.map