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

package/dist/resource/formats/bnk/CjsBnkFormat.js

@@ -1,7 +1,7 @@
 import { asUint8Array } from '#utils/bytes';
 import { CjsFormat } from '../../format/CjsFormat.js';
 import { wwiseIdFromName, joinSoundbanksInfo, buildSoundbanksCatalog, parseSoundbanksInfo, isSoundbanksInfo } from './core/soundbanksInfo.js';
-import { DEFAULT_VALUES, OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON, normalizeValues, readWithValues, inspectWithValues, toJsonValue, probeSupportWithValues, extractMedia, isBNK, OUTPUT_JSON, HIRC_TYPE_NAMES, HIRC_V150_TYPE_NAMES } from './core/helpers.js';
+import { DEFAULT_VALUES, OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON, normalizeValues, readWithValues, inspectWithValues, probeSupportWithValues, extractMedia, isBNK, OUTPUT_JSON, HIRC_TYPE_NAMES, HIRC_V150_TYPE_NAMES } from './core/helpers.js';
 import { eventMediaFromBanks } from './core/graph.js';
 import { parseEventAction } from './core/eventAction.js';
 import { parseGlobalSettings } from './core/globalSettings.js';
@@ -9,6 +9,7 @@ import { parseBusNode, busNodesFromBanks } from './core/busNodes.js';
 import { parseEffectNode, effectNodesFromBanks } from './core/effectNodes.js';
 import { parseMusicSwitch, parseMusicPlaylist, parseMusicTrack, parseMusicSegment, musicNodesFromBanks } from './core/musicNodes.js';
 import { parseSfxLayer, parseSfxSwitch, parseSfxRandomSequence, parseSfxAttenuation, parseSfxActorMixer, sfxNodesFromBanks } from './core/sfxNodes.js';
+import { toJsonWithByteSummary } from '../../format/jsonPolicies.js';
 
 const FORMAT_NAME = "CjsBnkFormat";
 
@@ -107,7 +108,7 @@ class CjsBnkFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   ToJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**
@@ -174,7 +175,7 @@ class CjsBnkFormat extends CjsFormat {
    * @returns {any} JSON-compatible value.
    */
   static toJSON(value) {
-    return toJsonValue(value);
+    return toJsonWithByteSummary(value);
   }
 
   /**

package/dist/resource/formats/bnk/CjsBnkFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBnkFormat.js","sources":["../../../../../src/resource/formats/bnk/CjsBnkFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    buildSoundbanksCatalog,\n    isSoundbanksInfo,\n    joinSoundbanksInfo,\n    parseSoundbanksInfo,\n    wwiseIdFromName\n} from \"./core/soundbanksInfo.js\";\nimport {\n    DEFAULT_VALUES,\n    HIRC_TYPE_NAMES,\n    HIRC_V150_TYPE_NAMES,\n    OUTPUT_BNK_JSON,\n    OUTPUT_JSON,\n    OUTPUT_MEDIA,\n    OUTPUT_RAW,\n    extractMedia,\n    inspectWithValues,\n    isBNK,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { eventMediaFromBanks } from \"./core/graph.js\";\nimport { parseEventAction } from \"./core/eventAction.js\";\nimport { parseGlobalSettings } from \"./core/globalSettings.js\";\nimport {\n    busNodesFromBanks,\n    parseBusNode\n} from \"./core/busNodes.js\";\nimport {\n    effectNodesFromBanks,\n    parseEffectNode\n} from \"./core/effectNodes.js\";\nimport {\n    musicNodesFromBanks,\n    parseMusicPlaylist,\n    parseMusicSegment,\n    parseMusicSwitch,\n    parseMusicTrack\n} from \"./core/musicNodes.js\";\nimport {\n    parseSfxActorMixer,\n    parseSfxAttenuation,\n    parseSfxLayer,\n    parseSfxRandomSequence,\n    parseSfxSwitch,\n    sfxNodesFromBanks\n} from \"./core/sfxNodes.js\";\n\nconst FORMAT_NAME = \"CjsBnkFormat\";\n\n/**\n * Reader for Audiokinetic Wwise soundbank (.bnk) containers.\n *\n * Inspection decodes the bank header, embedded media index, exact v150 global\n * settings, object hierarchy listing (with version-stable typed fields), and\n * referenced bank names without copying payloads. Read can emit the raw bank,\n * debug JSON, or the embedded media items undecoded. The read path stays a\n * pure container reader; the Wwise-domain toolkit (SoundbanksInfo catalog\n * helpers, id hash, event -> media graph resolution) is grouped under the\n * `wwise` static.\n */\nexport class CjsBnkFormat 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: \"CjsBnkFormat\",\n        outputTypes: Object.freeze([ OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON ]),\n        defaultOutput: OUTPUT_RAW\n    });\n\n    /**\n     * Create a reusable bnk 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 {CjsBnkFormat} 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 soundbank bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read soundbank bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect soundbank bytes without copying media payloads.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Soundbank 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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug/media 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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsBnkFormat.read(input, options);\n    }\n\n    /**\n     * One-shot soundbank inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Soundbank metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot soundbank support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Extract embedded media payloads as views over the soundbank bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {number} [mediaId] Optional single media id filter.\n     * @returns {Array<object>} Extracted media items with undecoded bytes.\n     */\n    static extractMedia(input, mediaId)\n    {\n        const bytes = asUint8Array(input, \"Bnk input\");\n        const metadata = inspectWithValues(bytes, DEFAULT_VALUES);\n        return extractMedia(bytes, metadata, mediaId);\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 soundbank.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.\n     * @returns {boolean} True when the BKHD header chunk is present.\n     */\n    static isBNK(input)\n    {\n        try\n        {\n            return isBNK(asUint8Array(input, \"Bnk input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Wwise-domain toolkit, grouped apart from the container-reading statics -\n     * the single home for the SoundbanksInfo catalog helpers\n     * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,\n     * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the\n     * lowercased name), and event-graph resolution.\n     *\n     * `eventMediaFromBanks(inspections, options)` is graph interpretation over\n     * `inspect()` results, not a read path: banks may split events from their\n     * target objects (EVE keeps all events in one bank and their sounds in\n     * others), so always pass every related bank to one call. Returns\n     * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See\n     * core/graph.js for the walk policy.\n     *\n     * The interactive-music decoders (`musicNodesFromBanks` and the per-type\n     * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy\n     * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,\n     * clips, playlist trees, decision trees, and transition rules. See\n     * core/musicNodes.js for the anchored, exact-end-validated parse.\n     *\n     * The v150 authored-SFX decoders (`sfxNodesFromBanks` and the per-type\n     * Global Settings, Event Action, Random/Sequence, Switch, Layer,\n     * Actor-Mixer, and Attenuation parsers)\n     * preserve raw Wwise semantics for the runtime audio layer's optional builder.\n     * NodeBase facts, hierarchy-only Actor-Mixers, and attenuation objects\n     * remain distinct from playable container behavior.\n     *\n     * `busNodesFromBanks` and `parseBusNode` expose qualified complete v150\n     * Audio Bus and Auxiliary Bus bodies: ancestry, root output device,\n     * properties, aux topology, policy, ducking, effect/metadata references,\n     * RTPCs, and state values.\n     *\n     * `effectNodesFromBanks` and `parseEffectNode` expose complete generic\n     * v150 Fx ShareSet and Fx Custom bodies while leaving plug-in parameter\n     * blocks opaque for separately qualified DSP adapters.\n     */\n    static wwise = Object.freeze({\n        isSoundbanksInfo,\n        parseSoundbanksInfo,\n        buildSoundbanksCatalog,\n        joinSoundbanksInfo,\n        wwiseIdFromName,\n        eventMediaFromBanks,\n        parseGlobalSettings,\n        parseEventAction,\n        musicNodesFromBanks,\n        parseMusicSegment,\n        parseMusicTrack,\n        parseMusicPlaylist,\n        parseMusicSwitch,\n        busNodesFromBanks,\n        parseBusNode,\n        effectNodesFromBanks,\n        parseEffectNode,\n        sfxNodesFromBanks,\n        parseSfxActorMixer,\n        parseSfxAttenuation,\n        parseSfxRandomSequence,\n        parseSfxSwitch,\n        parseSfxLayer\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        BNK_JSON: OUTPUT_BNK_JSON,\n        MEDIA: OUTPUT_MEDIA\n    });\n\n    static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;\n\n    static HIRC_V150_TYPE_NAMES = HIRC_V150_TYPE_NAMES;\n\n    static id = \"bnk\";\n\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n\n    static outputs = CjsFormat.defineOutputs({\n\n        raw: { default: true, passthrough: true },\n\n        media: {  },\n\n        bnkJson: { role: \"debug\", probes: [ \"bnkJson\", \"raw\" ] }\n\n    });\n\n    static extensions = Object.freeze([ \".bnk\" ]);\n}\n\nexport default CjsBnkFormat;\n"],"names":["FORMAT_NAME","CjsBnkFormat","CjsFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_RAW","OUTPUT_MEDIA","OUTPUT_BNK_JSON","defaultOutput","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","extractMedia","mediaId","bytes","asUint8Array","metadata","toJSON","isBNK","wwise","isSoundbanksInfo","parseSoundbanksInfo","buildSoundbanksCatalog","joinSoundbanksInfo","wwiseIdFromName","eventMediaFromBanks","parseGlobalSettings","parseEventAction","musicNodesFromBanks","parseMusicSegment","parseMusicTrack","parseMusicPlaylist","parseMusicSwitch","busNodesFromBanks","parseBusNode","effectNodesFromBanks","parseEffectNode","sfxNodesFromBanks","parseSfxActorMixer","parseSfxAttenuation","parseSfxRandomSequence","parseSfxSwitch","parseSfxLayer","Output","RAW","JSON","OUTPUT_JSON","BNK_JSON","MEDIA","HIRC_TYPE_NAMES","HIRC_V150_TYPE_NAMES","id","mediaTypes","outputs","defineOutputs","raw","default","passthrough","media","bnkJson","role","probes","extensions"],"mappings":"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"}
+{"version":3,"file":"CjsBnkFormat.js","sources":["../../../../../src/resource/formats/bnk/CjsBnkFormat.js"],"sourcesContent":["import { asUint8Array } from \"#utils/bytes\";\nimport { CjsFormat } from \"../../format/CjsFormat.js\";\nimport {\n    buildSoundbanksCatalog,\n    isSoundbanksInfo,\n    joinSoundbanksInfo,\n    parseSoundbanksInfo,\n    wwiseIdFromName\n} from \"./core/soundbanksInfo.js\";\nimport {\n    DEFAULT_VALUES,\n    HIRC_TYPE_NAMES,\n    HIRC_V150_TYPE_NAMES,\n    OUTPUT_BNK_JSON,\n    OUTPUT_JSON,\n    OUTPUT_MEDIA,\n    OUTPUT_RAW,\n    extractMedia,\n    inspectWithValues,\n    isBNK,\n    probeSupportWithValues,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { eventMediaFromBanks } from \"./core/graph.js\";\nimport { parseEventAction } from \"./core/eventAction.js\";\nimport { parseGlobalSettings } from \"./core/globalSettings.js\";\nimport {\n    busNodesFromBanks,\n    parseBusNode\n} from \"./core/busNodes.js\";\nimport {\n    effectNodesFromBanks,\n    parseEffectNode\n} from \"./core/effectNodes.js\";\nimport {\n    musicNodesFromBanks,\n    parseMusicPlaylist,\n    parseMusicSegment,\n    parseMusicSwitch,\n    parseMusicTrack\n} from \"./core/musicNodes.js\";\nimport {\n    parseSfxActorMixer,\n    parseSfxAttenuation,\n    parseSfxLayer,\n    parseSfxRandomSequence,\n    parseSfxSwitch,\n    sfxNodesFromBanks\n} from \"./core/sfxNodes.js\";\n\nconst FORMAT_NAME = \"CjsBnkFormat\";\n\n/**\n * Reader for Audiokinetic Wwise soundbank (.bnk) containers.\n *\n * Inspection decodes the bank header, embedded media index, exact v150 global\n * settings, object hierarchy listing (with version-stable typed fields), and\n * referenced bank names without copying payloads. Read can emit the raw bank,\n * debug JSON, or the embedded media items undecoded. The read path stays a\n * pure container reader; the Wwise-domain toolkit (SoundbanksInfo catalog\n * helpers, id hash, event -> media graph resolution) is grouped under the\n * `wwise` static.\n */\nexport class CjsBnkFormat 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: \"CjsBnkFormat\",\n        outputTypes: Object.freeze([ OUTPUT_RAW, OUTPUT_MEDIA, OUTPUT_BNK_JSON ]),\n        defaultOutput: OUTPUT_RAW\n    });\n\n    /**\n     * Create a reusable bnk 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 {CjsBnkFormat} 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 soundbank bytes with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Read soundbank bytes asynchronously with this profile.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    async ReadAsync(input, options = {})\n    {\n        return this.Read(input, options);\n    }\n\n    /**\n     * Inspect soundbank bytes without copying media payloads.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Per-call values.\n     * @returns {object} Soundbank 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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {object} GPU-free raw/debug/media 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 soundbank read.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Read options.\n     * @returns {Promise<object>} GPU-free raw/debug/media payload for the selected emit target.\n     */\n    static async readAsync(input, options = {})\n    {\n        return CjsBnkFormat.read(input, options);\n    }\n\n    /**\n     * One-shot soundbank inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Inspect options.\n     * @returns {object} Soundbank metadata.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * One-shot soundbank support probe.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {object} [options] Probe options.\n     * @returns {object} Support/probe report.\n     */\n    static probeSupport(input, options = {})\n    {\n        return probeSupportWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Extract embedded media payloads as views over the soundbank bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Soundbank bytes.\n     * @param {number} [mediaId] Optional single media id filter.\n     * @returns {Array<object>} Extracted media items with undecoded bytes.\n     */\n    static extractMedia(input, mediaId)\n    {\n        const bytes = asUint8Array(input, \"Bnk input\");\n        const metadata = inspectWithValues(bytes, DEFAULT_VALUES);\n        return extractMedia(bytes, metadata, mediaId);\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 soundbank.\n     *\n     * @param {Uint8Array|ArrayBuffer|DataView} input Candidate soundbank bytes.\n     * @returns {boolean} True when the BKHD header chunk is present.\n     */\n    static isBNK(input)\n    {\n        try\n        {\n            return isBNK(asUint8Array(input, \"Bnk input\"));\n        }\n        catch\n        {\n            return false;\n        }\n    }\n\n    /**\n     * Wwise-domain toolkit, grouped apart from the container-reading statics -\n     * the single home for the SoundbanksInfo catalog helpers\n     * (`isSoundbanksInfo`, `parseSoundbanksInfo`, `buildSoundbanksCatalog`,\n     * `joinSoundbanksInfo`), the id hash (`wwiseIdFromName`, FNV-1 of the\n     * lowercased name), and event-graph resolution.\n     *\n     * `eventMediaFromBanks(inspections, options)` is graph interpretation over\n     * `inspect()` results, not a read path: banks may split events from their\n     * target objects (EVE keeps all events in one bank and their sounds in\n     * others), so always pass every related bank to one call. Returns\n     * `{ eventMedia: Map<eventObjectId, Set<wemId>>, diagnostics }`. See\n     * core/graph.js for the walk policy.\n     *\n     * The interactive-music decoders (`musicNodesFromBanks` and the per-type\n     * `parseMusicSegment/Track/Playlist/Switch`) turn the music-hierarchy\n     * entries (HIRC 10-13) into typed nodes - children, meter, cue markers,\n     * clips, playlist trees, decision trees, and transition rules. See\n     * core/musicNodes.js for the anchored, exact-end-validated parse.\n     *\n     * The v150 authored-SFX decoders (`sfxNodesFromBanks` and the per-type\n     * Global Settings, Event Action, Random/Sequence, Switch, Layer,\n     * Actor-Mixer, and Attenuation parsers)\n     * preserve raw Wwise semantics for the runtime audio layer's optional builder.\n     * NodeBase facts, hierarchy-only Actor-Mixers, and attenuation objects\n     * remain distinct from playable container behavior.\n     *\n     * `busNodesFromBanks` and `parseBusNode` expose qualified complete v150\n     * Audio Bus and Auxiliary Bus bodies: ancestry, root output device,\n     * properties, aux topology, policy, ducking, effect/metadata references,\n     * RTPCs, and state values.\n     *\n     * `effectNodesFromBanks` and `parseEffectNode` expose complete generic\n     * v150 Fx ShareSet and Fx Custom bodies while leaving plug-in parameter\n     * blocks opaque for separately qualified DSP adapters.\n     */\n    static wwise = Object.freeze({\n        isSoundbanksInfo,\n        parseSoundbanksInfo,\n        buildSoundbanksCatalog,\n        joinSoundbanksInfo,\n        wwiseIdFromName,\n        eventMediaFromBanks,\n        parseGlobalSettings,\n        parseEventAction,\n        musicNodesFromBanks,\n        parseMusicSegment,\n        parseMusicTrack,\n        parseMusicPlaylist,\n        parseMusicSwitch,\n        busNodesFromBanks,\n        parseBusNode,\n        effectNodesFromBanks,\n        parseEffectNode,\n        sfxNodesFromBanks,\n        parseSfxActorMixer,\n        parseSfxAttenuation,\n        parseSfxRandomSequence,\n        parseSfxSwitch,\n        parseSfxLayer\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        BNK_JSON: OUTPUT_BNK_JSON,\n        MEDIA: OUTPUT_MEDIA\n    });\n\n    static HIRC_TYPE_NAMES = HIRC_TYPE_NAMES;\n\n    static HIRC_V150_TYPE_NAMES = HIRC_V150_TYPE_NAMES;\n\n    static id = \"bnk\";\n\n    static mediaTypes = Object.freeze([ \"audio\" ]);\n\n    static outputs = CjsFormat.defineOutputs({\n\n        raw: { default: true, passthrough: true },\n\n        media: {  },\n\n        bnkJson: { role: \"debug\", probes: [ \"bnkJson\", \"raw\" ] }\n\n    });\n\n    static extensions = Object.freeze([ \".bnk\" ]);\n}\n\nexport default CjsBnkFormat;\n"],"names":["FORMAT_NAME","CjsBnkFormat","CjsFormat","DEFAULT_VALUES","worker","Object","freeze","module","import","meta","url","exportName","outputTypes","OUTPUT_RAW","OUTPUT_MEDIA","OUTPUT_BNK_JSON","defaultOutput","constructor","options","SetValues","normalizeValues","GetValues","Read","input","readWithValues","ReadAsync","Inspect","inspectWithValues","ToJSON","value","toJsonValue","read","readAsync","inspect","probeSupport","probeSupportWithValues","extractMedia","mediaId","bytes","asUint8Array","metadata","toJSON","isBNK","wwise","isSoundbanksInfo","parseSoundbanksInfo","buildSoundbanksCatalog","joinSoundbanksInfo","wwiseIdFromName","eventMediaFromBanks","parseGlobalSettings","parseEventAction","musicNodesFromBanks","parseMusicSegment","parseMusicTrack","parseMusicPlaylist","parseMusicSwitch","busNodesFromBanks","parseBusNode","effectNodesFromBanks","parseEffectNode","sfxNodesFromBanks","parseSfxActorMixer","parseSfxAttenuation","parseSfxRandomSequence","parseSfxSwitch","parseSfxLayer","Output","RAW","JSON","OUTPUT_JSON","BNK_JSON","MEDIA","HIRC_TYPE_NAMES","HIRC_V150_TYPE_NAMES","id","mediaTypes","outputs","defineOutputs","raw","default","passthrough","media","bnkJson","role","probes","extensions"],"mappings":"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"}

package/dist/resource/formats/bnk/core/WwiseCursor.js

@@ -0,0 +1,218 @@
+// The one byte cursor for every exact Wwise payload, and the variable-length
+// integer it reads.
+//
+// SELF-CONTAINED ON PURPOSE. This module imports nothing. It used to live in
+// `nodeBase.js`, which imports `helpers.js`, which imports `eventAction.js` -
+// so the moment `eventAction.js` started using the shared cursor the three
+// formed an import cycle. Rollup tolerated it; ES module cycles are a real
+// hazard and the fix is for the primitive everything reaches for to depend on
+// nothing.
+
+/**
+ * Reads Wwise's MSB-first base-128 unsigned integer.
+ *
+ * @returns {{value:number,nextOffset:number}|null} Decoded value and next
+ * offset, or null for truncated, overflowed, or non-canonical input.
+ */
+function readWwiseVar(bytes, offset = 0) {
+  let at = Number(offset);
+  let value = 0;
+  let count = 0;
+  if (!Number.isSafeInteger(at) || at < 0) {
+    return null;
+  }
+  while (at < bytes.byteLength && count < 5) {
+    const byte = bytes[at++];
+    if (count === 0 && byte === 0x80) {
+      return null;
+    }
+    if (value > 0x01ffffff) {
+      return null;
+    }
+    value = value * 128 + (byte & 0x7f);
+    count++;
+    if ((byte & 0x80) === 0) {
+      return value <= 0xffffffff ? {
+        value: value >>> 0,
+        nextOffset: at
+      } : null;
+    }
+  }
+  return null;
+}
+
+/** Bounds-aware little-endian cursor over one HIRC payload. */
+class WwiseCursor {
+  /**
+   * Creates a cursor over a bounded portion of a Wwise payload.
+   *
+   * @param {Uint8Array} bytes Payload bytes.
+   * @param {number} [offset=0] Initial byte offset.
+   * @param {number} [end=bytes.byteLength] Exclusive ending offset.
+   */
+  constructor(bytes, offset = 0, end = bytes?.byteLength) {
+    if (!(bytes instanceof Uint8Array) || !Number.isSafeInteger(offset) || !Number.isSafeInteger(end) || offset < 0 || end < offset || end > bytes.byteLength) {
+      throw new TypeError("Invalid Wwise cursor range");
+    }
+    this.bytes = bytes;
+    this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    this.at = offset;
+    this.end = end;
+  }
+
+  /** Gets the number of unread bytes in the bounded range. */
+  get remaining() {
+    return this.end - this.at;
+  }
+
+  /**
+   * Verifies that a read of the requested size stays within the range.
+   *
+   * @param {number} size Number of bytes to read.
+   * @throws {RangeError} The read would exceed the bounded range.
+   */
+  ensure(size) {
+    if (!Number.isSafeInteger(size) || size < 0 || this.at + size > this.end) {
+      throw new RangeError("truncated Wwise object");
+    }
+  }
+
+  /** Reads an unsigned 8-bit integer. */
+  u8() {
+    this.ensure(1);
+    return this.view.getUint8(this.at++);
+  }
+
+  /** Reads a signed 8-bit integer. */
+  s8() {
+    this.ensure(1);
+    return this.view.getInt8(this.at++);
+  }
+
+  /** Reads a little-endian unsigned 16-bit integer. */
+  u16() {
+    this.ensure(2);
+    const value = this.view.getUint16(this.at, true);
+    this.at += 2;
+    return value;
+  }
+
+  /** Reads a little-endian unsigned 32-bit integer. */
+  u32() {
+    this.ensure(4);
+    const value = this.view.getUint32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+
+  /** Reads a little-endian signed 32-bit integer. */
+  s32() {
+    this.ensure(4);
+    const value = this.view.getInt32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+
+  /** Reads a little-endian 32-bit floating-point value. */
+  f32() {
+    this.ensure(4);
+    const value = this.view.getFloat32(this.at, true);
+    this.at += 4;
+    return value;
+  }
+
+  /** Reads a little-endian signed 16-bit integer. */
+  s16() {
+    this.ensure(2);
+    const value = this.view.getInt16(this.at, true);
+    this.at += 2;
+    return value;
+  }
+
+  /** Reads a little-endian 64-bit floating-point value. */
+  f64() {
+    this.ensure(8);
+    const value = this.view.getFloat64(this.at, true);
+    this.at += 8;
+    return value;
+  }
+
+  /**
+   * Reads a 32-bit float and rejects a non-finite result.
+   *
+   * The cursor advances BEFORE the finiteness check, which is deliberate and
+   * was the donor behaviour: the four bytes were consumed either way, and a
+   * caller that catches the rejection and inspects the cursor must see it past
+   * the field it rejected.
+   *
+   * @returns {number} A finite float.
+   * @throws {RangeError} The stored value is NaN or infinite.
+   */
+  finiteF32() {
+    this.ensure(4);
+    const value = this.view.getFloat32(this.at, true);
+    this.at += 4;
+    if (!Number.isFinite(value)) {
+      throw new RangeError("Wwise float must be finite");
+    }
+    return value;
+  }
+
+  /**
+   * Reads a table element count and rejects one the payload cannot hold.
+   *
+   * A corrupt count is the cheapest way to make a reader allocate for a table
+   * that is not there, so it is checked against what remains rather than
+   * trusted and discovered later, one truncated element at a time.
+   *
+   * NAMED FOR THE READ, because this module already has a free
+   * `boundedCount(value, remaining, stride, maximum)` that validates a count
+   * someone else read, with an explicit ceiling. The two are different checks
+   * and must not share a name in one file.
+   *
+   * @param {number} minimumStride Smallest byte size one element can occupy.
+   * @returns {number} The element count.
+   * @throws {RangeError} The count exceeds what the remaining bytes allow.
+   */
+  readBoundedCount(minimumStride) {
+    const count = this.u32();
+    if (count > Math.floor(this.remaining / minimumStride)) {
+      throw new RangeError("Wwise table count exceeds payload");
+    }
+    return count;
+  }
+
+  /**
+   * Reads a NUL-terminated string and consumes its terminator.
+   *
+   * Decoded byte by byte through `String.fromCharCode`, NOT as UTF-8. That is
+   * the donor behaviour and it is load-bearing: the music parsers compare the
+   * decoded marker names while validating an exact end offset, so widening the
+   * decode would change which banks parse.
+   *
+   * @returns {string} The string, without its terminator.
+   */
+  stringZ() {
+    let end = this.at;
+    while (end < this.end && this.bytes[end] !== 0) end++;
+    let value = "";
+    for (let index = this.at; index < end; index++) {
+      value += String.fromCharCode(this.bytes[index]);
+    }
+    this.at = end + 1;
+    return value;
+  }
+
+  /** Reads a Wwise variable-length unsigned integer. */
+  variable() {
+    const result = readWwiseVar(this.bytes.subarray(0, this.end), this.at);
+    if (!result) {
+      throw new RangeError("invalid Wwise variable integer");
+    }
+    this.at = result.nextOffset;
+    return result.value;
+  }
+}
+
+export { WwiseCursor, readWwiseVar };
+//# sourceMappingURL=WwiseCursor.js.map

package/dist/resource/formats/bnk/core/WwiseCursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WwiseCursor.js","sources":["../../../../../../src/resource/formats/bnk/core/WwiseCursor.js"],"sourcesContent":["// The one byte cursor for every exact Wwise payload, and the variable-length\n// integer it reads.\n//\n// SELF-CONTAINED ON PURPOSE. This module imports nothing. It used to live in\n// `nodeBase.js`, which imports `helpers.js`, which imports `eventAction.js` -\n// so the moment `eventAction.js` started using the shared cursor the three\n// formed an import cycle. Rollup tolerated it; ES module cycles are a real\n// hazard and the fix is for the primitive everything reaches for to depend on\n// nothing.\n\n/**\n * Reads Wwise's MSB-first base-128 unsigned integer.\n *\n * @returns {{value:number,nextOffset:number}|null} Decoded value and next\n * offset, or null for truncated, overflowed, or non-canonical input.\n */\nexport function readWwiseVar(bytes, offset = 0)\n{\n    let at = Number(offset);\n    let value = 0;\n    let count = 0;\n\n    if (!Number.isSafeInteger(at) || at < 0)\n    {\n        return null;\n    }\n\n    while (at < bytes.byteLength && count < 5)\n    {\n        const byte = bytes[at++];\n\n        if (count === 0 && byte === 0x80)\n        {\n            return null;\n        }\n        if (value > 0x01ffffff)\n        {\n            return null;\n        }\n\n        value = value * 128 + (byte & 0x7f);\n        count++;\n\n        if ((byte & 0x80) === 0)\n        {\n            return value <= 0xffffffff\n                ? { value: value >>> 0, nextOffset: at }\n                : null;\n        }\n    }\n\n    return null;\n}\n\n/** Bounds-aware little-endian cursor over one HIRC payload. */\nexport class WwiseCursor\n{\n    /**\n     * Creates a cursor over a bounded portion of a Wwise payload.\n     *\n     * @param {Uint8Array} bytes Payload bytes.\n     * @param {number} [offset=0] Initial byte offset.\n     * @param {number} [end=bytes.byteLength] Exclusive ending offset.\n     */\n    constructor(bytes, offset = 0, end = bytes?.byteLength)\n    {\n        if (!(bytes instanceof Uint8Array)\n            || !Number.isSafeInteger(offset)\n            || !Number.isSafeInteger(end)\n            || offset < 0\n            || end < offset\n            || end > bytes.byteLength)\n        {\n            throw new TypeError(\"Invalid Wwise cursor range\");\n        }\n\n        this.bytes = bytes;\n        this.view = new DataView(\n            bytes.buffer,\n            bytes.byteOffset,\n            bytes.byteLength,\n        );\n        this.at = offset;\n        this.end = end;\n    }\n\n    /** Gets the number of unread bytes in the bounded range. */\n    get remaining()\n    {\n        return this.end - this.at;\n    }\n\n    /**\n     * Verifies that a read of the requested size stays within the range.\n     *\n     * @param {number} size Number of bytes to read.\n     * @throws {RangeError} The read would exceed the bounded range.\n     */\n    ensure(size)\n    {\n        if (!Number.isSafeInteger(size)\n            || size < 0\n            || this.at + size > this.end)\n        {\n            throw new RangeError(\"truncated Wwise object\");\n        }\n    }\n\n    /** Reads an unsigned 8-bit integer. */\n    u8()\n    {\n        this.ensure(1);\n        return this.view.getUint8(this.at++);\n    }\n\n    /** Reads a signed 8-bit integer. */\n    s8()\n    {\n        this.ensure(1);\n        return this.view.getInt8(this.at++);\n    }\n\n    /** Reads a little-endian unsigned 16-bit integer. */\n    u16()\n    {\n        this.ensure(2);\n        const value = this.view.getUint16(this.at, true);\n\n        this.at += 2;\n        return value;\n    }\n\n    /** Reads a little-endian unsigned 32-bit integer. */\n    u32()\n    {\n        this.ensure(4);\n        const value = this.view.getUint32(this.at, true);\n\n        this.at += 4;\n        return value;\n    }\n\n    /** Reads a little-endian signed 32-bit integer. */\n    s32()\n    {\n        this.ensure(4);\n        const value = this.view.getInt32(this.at, true);\n\n        this.at += 4;\n        return value;\n    }\n\n    /** Reads a little-endian 32-bit floating-point value. */\n    f32()\n    {\n        this.ensure(4);\n        const value = this.view.getFloat32(this.at, true);\n\n        this.at += 4;\n        return value;\n    }\n\n    /** Reads a little-endian signed 16-bit integer. */\n    s16()\n    {\n        this.ensure(2);\n        const value = this.view.getInt16(this.at, true);\n\n        this.at += 2;\n        return value;\n    }\n\n    /** Reads a little-endian 64-bit floating-point value. */\n    f64()\n    {\n        this.ensure(8);\n        const value = this.view.getFloat64(this.at, true);\n\n        this.at += 8;\n        return value;\n    }\n\n    /**\n     * Reads a 32-bit float and rejects a non-finite result.\n     *\n     * The cursor advances BEFORE the finiteness check, which is deliberate and\n     * was the donor behaviour: the four bytes were consumed either way, and a\n     * caller that catches the rejection and inspects the cursor must see it past\n     * the field it rejected.\n     *\n     * @returns {number} A finite float.\n     * @throws {RangeError} The stored value is NaN or infinite.\n     */\n    finiteF32()\n    {\n        this.ensure(4);\n        const value = this.view.getFloat32(this.at, true);\n\n        this.at += 4;\n        if (!Number.isFinite(value))\n        {\n            throw new RangeError(\"Wwise float must be finite\");\n        }\n        return value;\n    }\n\n    /**\n     * Reads a table element count and rejects one the payload cannot hold.\n     *\n     * A corrupt count is the cheapest way to make a reader allocate for a table\n     * that is not there, so it is checked against what remains rather than\n     * trusted and discovered later, one truncated element at a time.\n     *\n     * NAMED FOR THE READ, because this module already has a free\n     * `boundedCount(value, remaining, stride, maximum)` that validates a count\n     * someone else read, with an explicit ceiling. The two are different checks\n     * and must not share a name in one file.\n     *\n     * @param {number} minimumStride Smallest byte size one element can occupy.\n     * @returns {number} The element count.\n     * @throws {RangeError} The count exceeds what the remaining bytes allow.\n     */\n    readBoundedCount(minimumStride)\n    {\n        const count = this.u32();\n\n        if (count > Math.floor(this.remaining / minimumStride))\n        {\n            throw new RangeError(\"Wwise table count exceeds payload\");\n        }\n        return count;\n    }\n\n    /**\n     * Reads a NUL-terminated string and consumes its terminator.\n     *\n     * Decoded byte by byte through `String.fromCharCode`, NOT as UTF-8. That is\n     * the donor behaviour and it is load-bearing: the music parsers compare the\n     * decoded marker names while validating an exact end offset, so widening the\n     * decode would change which banks parse.\n     *\n     * @returns {string} The string, without its terminator.\n     */\n    stringZ()\n    {\n        let end = this.at;\n        while (end < this.end && this.bytes[end] !== 0) end++;\n\n        let value = \"\";\n        for (let index = this.at; index < end; index++)\n        {\n            value += String.fromCharCode(this.bytes[index]);\n        }\n\n        this.at = end + 1;\n        return value;\n    }\n\n    /** Reads a Wwise variable-length unsigned integer. */\n    variable()\n    {\n        const result = readWwiseVar(\n            this.bytes.subarray(0, this.end),\n            this.at,\n        );\n\n        if (!result)\n        {\n            throw new RangeError(\"invalid Wwise variable integer\");\n        }\n\n        this.at = result.nextOffset;\n        return result.value;\n    }\n}\n"],"names":["readWwiseVar","bytes","offset","at","Number","value","count","isSafeInteger","byteLength","byte","nextOffset","WwiseCursor","constructor","end","Uint8Array","TypeError","view","DataView","buffer","byteOffset","remaining","ensure","size","RangeError","u8","getUint8","s8","getInt8","u16","getUint16","u32","getUint32","s32","getInt32","f32","getFloat32","s16","getInt16","f64","getFloat64","finiteF32","isFinite","readBoundedCount","minimumStride","Math","floor","stringZ","index","String","fromCharCode","variable","result","subarray"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,YAAYA,CAACC,KAAK,EAAEC,MAAM,GAAG,CAAC,EAC9C;AACI,EAAA,IAAIC,EAAE,GAAGC,MAAM,CAACF,MAAM,CAAC;EACvB,IAAIG,KAAK,GAAG,CAAC;EACb,IAAIC,KAAK,GAAG,CAAC;EAEb,IAAI,CAACF,MAAM,CAACG,aAAa,CAACJ,EAAE,CAAC,IAAIA,EAAE,GAAG,CAAC,EACvC;AACI,IAAA,OAAO,IAAI;AACf,EAAA;EAEA,OAAOA,EAAE,GAAGF,KAAK,CAACO,UAAU,IAAIF,KAAK,GAAG,CAAC,EACzC;AACI,IAAA,MAAMG,IAAI,GAAGR,KAAK,CAACE,EAAE,EAAE,CAAC;AAExB,IAAA,IAAIG,KAAK,KAAK,CAAC,IAAIG,IAAI,KAAK,IAAI,EAChC;AACI,MAAA,OAAO,IAAI;AACf,IAAA;IACA,IAAIJ,KAAK,GAAG,UAAU,EACtB;AACI,MAAA,OAAO,IAAI;AACf,IAAA;IAEAA,KAAK,GAAGA,KAAK,GAAG,GAAG,IAAII,IAAI,GAAG,IAAI,CAAC;AACnCH,IAAAA,KAAK,EAAE;AAEP,IAAA,IAAI,CAACG,IAAI,GAAG,IAAI,MAAM,CAAC,EACvB;MACI,OAAOJ,KAAK,IAAI,UAAU,GACpB;QAAEA,KAAK,EAAEA,KAAK,KAAK,CAAC;AAAEK,QAAAA,UAAU,EAAEP;AAAG,OAAC,GACtC,IAAI;AACd,IAAA;AACJ,EAAA;AAEA,EAAA,OAAO,IAAI;AACf;;AAEA;AACO,MAAMQ,WAAW,CACxB;AACI;AACJ;AACA;AACA;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACX,KAAK,EAAEC,MAAM,GAAG,CAAC,EAAEW,GAAG,GAAGZ,KAAK,EAAEO,UAAU,EACtD;AACI,IAAA,IAAI,EAAEP,KAAK,YAAYa,UAAU,CAAC,IAC3B,CAACV,MAAM,CAACG,aAAa,CAACL,MAAM,CAAC,IAC7B,CAACE,MAAM,CAACG,aAAa,CAACM,GAAG,CAAC,IAC1BX,MAAM,GAAG,CAAC,IACVW,GAAG,GAAGX,MAAM,IACZW,GAAG,GAAGZ,KAAK,CAACO,UAAU,EAC7B;AACI,MAAA,MAAM,IAAIO,SAAS,CAAC,4BAA4B,CAAC;AACrD,IAAA;IAEA,IAAI,CAACd,KAAK,GAAGA,KAAK;AAClB,IAAA,IAAI,CAACe,IAAI,GAAG,IAAIC,QAAQ,CACpBhB,KAAK,CAACiB,MAAM,EACZjB,KAAK,CAACkB,UAAU,EAChBlB,KAAK,CAACO,UACV,CAAC;IACD,IAAI,CAACL,EAAE,GAAGD,MAAM;IAChB,IAAI,CAACW,GAAG,GAAGA,GAAG;AAClB,EAAA;;AAEA;EACA,IAAIO,SAASA,GACb;AACI,IAAA,OAAO,IAAI,CAACP,GAAG,GAAG,IAAI,CAACV,EAAE;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIkB,MAAMA,CAACC,IAAI,EACX;IACI,IAAI,CAAClB,MAAM,CAACG,aAAa,CAACe,IAAI,CAAC,IACxBA,IAAI,GAAG,CAAC,IACR,IAAI,CAACnB,EAAE,GAAGmB,IAAI,GAAG,IAAI,CAACT,GAAG,EAChC;AACI,MAAA,MAAM,IAAIU,UAAU,CAAC,wBAAwB,CAAC;AAClD,IAAA;AACJ,EAAA;;AAEA;AACAC,EAAAA,EAAEA,GACF;AACI,IAAA,IAAI,CAACH,MAAM,CAAC,CAAC,CAAC;IACd,OAAO,IAAI,CAACL,IAAI,CAACS,QAAQ,CAAC,IAAI,CAACtB,EAAE,EAAE,CAAC;AACxC,EAAA;;AAEA;AACAuB,EAAAA,EAAEA,GACF;AACI,IAAA,IAAI,CAACL,MAAM,CAAC,CAAC,CAAC;IACd,OAAO,IAAI,CAACL,IAAI,CAACW,OAAO,CAAC,IAAI,CAACxB,EAAE,EAAE,CAAC;AACvC,EAAA;;AAEA;AACAyB,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACP,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACa,SAAS,CAAC,IAAI,CAAC1B,EAAE,EAAE,IAAI,CAAC;IAEhD,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACAyB,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACT,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACe,SAAS,CAAC,IAAI,CAAC5B,EAAE,EAAE,IAAI,CAAC;IAEhD,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACA2B,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACX,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACiB,QAAQ,CAAC,IAAI,CAAC9B,EAAE,EAAE,IAAI,CAAC;IAE/C,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACA6B,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACb,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACmB,UAAU,CAAC,IAAI,CAAChC,EAAE,EAAE,IAAI,CAAC;IAEjD,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACA+B,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACf,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACqB,QAAQ,CAAC,IAAI,CAAClC,EAAE,EAAE,IAAI,CAAC;IAE/C,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACAiC,EAAAA,GAAGA,GACH;AACI,IAAA,IAAI,CAACjB,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACuB,UAAU,CAAC,IAAI,CAACpC,EAAE,EAAE,IAAI,CAAC;IAEjD,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,OAAOE,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACImC,EAAAA,SAASA,GACT;AACI,IAAA,IAAI,CAACnB,MAAM,CAAC,CAAC,CAAC;AACd,IAAA,MAAMhB,KAAK,GAAG,IAAI,CAACW,IAAI,CAACmB,UAAU,CAAC,IAAI,CAAChC,EAAE,EAAE,IAAI,CAAC;IAEjD,IAAI,CAACA,EAAE,IAAI,CAAC;AACZ,IAAA,IAAI,CAACC,MAAM,CAACqC,QAAQ,CAACpC,KAAK,CAAC,EAC3B;AACI,MAAA,MAAM,IAAIkB,UAAU,CAAC,4BAA4B,CAAC;AACtD,IAAA;AACA,IAAA,OAAOlB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACIqC,gBAAgBA,CAACC,aAAa,EAC9B;AACI,IAAA,MAAMrC,KAAK,GAAG,IAAI,CAACwB,GAAG,EAAE;AAExB,IAAA,IAAIxB,KAAK,GAAGsC,IAAI,CAACC,KAAK,CAAC,IAAI,CAACzB,SAAS,GAAGuB,aAAa,CAAC,EACtD;AACI,MAAA,MAAM,IAAIpB,UAAU,CAAC,mCAAmC,CAAC;AAC7D,IAAA;AACA,IAAA,OAAOjB,KAAK;AAChB,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACIwC,EAAAA,OAAOA,GACP;AACI,IAAA,IAAIjC,GAAG,GAAG,IAAI,CAACV,EAAE;AACjB,IAAA,OAAOU,GAAG,GAAG,IAAI,CAACA,GAAG,IAAI,IAAI,CAACZ,KAAK,CAACY,GAAG,CAAC,KAAK,CAAC,EAAEA,GAAG,EAAE;IAErD,IAAIR,KAAK,GAAG,EAAE;AACd,IAAA,KAAK,IAAI0C,KAAK,GAAG,IAAI,CAAC5C,EAAE,EAAE4C,KAAK,GAAGlC,GAAG,EAAEkC,KAAK,EAAE,EAC9C;MACI1C,KAAK,IAAI2C,MAAM,CAACC,YAAY,CAAC,IAAI,CAAChD,KAAK,CAAC8C,KAAK,CAAC,CAAC;AACnD,IAAA;AAEA,IAAA,IAAI,CAAC5C,EAAE,GAAGU,GAAG,GAAG,CAAC;AACjB,IAAA,OAAOR,KAAK;AAChB,EAAA;;AAEA;AACA6C,EAAAA,QAAQA,GACR;IACI,MAAMC,MAAM,GAAGnD,YAAY,CACvB,IAAI,CAACC,KAAK,CAACmD,QAAQ,CAAC,CAAC,EAAE,IAAI,CAACvC,GAAG,CAAC,EAChC,IAAI,CAACV,EACT,CAAC;IAED,IAAI,CAACgD,MAAM,EACX;AACI,MAAA,MAAM,IAAI5B,UAAU,CAAC,gCAAgC,CAAC;AAC1D,IAAA;AAEA,IAAA,IAAI,CAACpB,EAAE,GAAGgD,MAAM,CAACzC,UAAU;IAC3B,OAAOyC,MAAM,CAAC9C,KAAK;AACvB,EAAA;AACJ;;;;"}

package/dist/resource/formats/bnk/core/busNodes.js

@@ -1,4 +1,5 @@
-import { WwiseCursor, boundedCount, readPositioning, readAux, finite, readInitialRtpcs, readStateChunk } from './nodeBase.js';
+import { boundedCount, readPositioning, readAux, finite, readInitialRtpcs, readStateChunk } from './nodeBase.js';
+import { WwiseCursor } from './WwiseCursor.js';
 
 // Exact Wwise v150 Audio Bus and Auxiliary Bus decoding. The HIRC payload
 // supplied by inspect() starts after the object id. Records preserve authored

package/dist/resource/formats/bnk/core/busNodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"busNodes.js","sources":["../../../../../../src/resource/formats/bnk/core/busNodes.js"],"sourcesContent":["// Exact Wwise v150 Audio Bus and Auxiliary Bus decoding. The HIRC payload\r\n// supplied by inspect() starts after the object id. Records preserve authored\r\n// routing, bus policy, ducking, effect references, metadata, RTPCs, and state\r\n// without assigning runtime mixing or plug-in semantics.\r\n\r\nimport {\r\n    boundedCount,\r\n    finite,\r\n    readAux,\r\n    readInitialRtpcs,\r\n    readPositioning,\r\n    readStateChunk,\r\n    WwiseCursor,\r\n} from \"./nodeBase.js\";\r\n\r\nconst SUPPORTED_VERSION = 150;\r\nconst AUDIO_BUS_TYPE = 8;\r\nconst AUXILIARY_BUS_TYPE = 18;\r\nconst BUS_VOLUME_PROPERTY_ID = 0x04;\r\nconst MAKE_UP_GAIN_PROPERTY_ID = 0x05;\r\nconst OUTPUT_BUS_VOLUME_PROPERTY_ID = 0x0d;\r\nconst FINITE_GAIN_PROPERTY_IDS = new Set([\r\n    BUS_VOLUME_PROPERTY_ID,\r\n    MAKE_UP_GAIN_PROPERTY_ID,\r\n    OUTPUT_BUS_VOLUME_PROPERTY_ID,\r\n]);\r\n\r\n/**\r\n * Decodes one complete v150 Audio or Auxiliary Bus body.\r\n *\r\n * @param {Uint8Array} payload Entry payload view from `inspect()`.\r\n * @param {object} [options] Bank-version qualification.\r\n * @returns {object|null} Typed bus body, or null when it is invalid.\r\n */\r\nexport function parseBusNode(\r\n    payload,\r\n    { bankVersion = SUPPORTED_VERSION } = {},\r\n)\r\n{\r\n    if (!(payload instanceof Uint8Array)\r\n        || Number(bankVersion) !== SUPPORTED_VERSION\r\n        || payload.byteLength < 5)\r\n    {\r\n        return null;\r\n    }\r\n\r\n    try\r\n    {\r\n        const cursor = new WwiseCursor(payload);\r\n        const overrideBusId = cursor.u32();\r\n        let outputDeviceId = null;\r\n\r\n        if (overrideBusId === 0)\r\n        {\r\n            outputDeviceId = cursor.u32();\r\n        }\r\n\r\n        const propertyCount = boundedCount(\r\n            cursor.u8(),\r\n            cursor.remaining,\r\n            5,\r\n            255,\r\n        );\r\n        const ids = [];\r\n        const seen = new Set();\r\n        const properties = [];\r\n\r\n        for (let index = 0; index < propertyCount; index++)\r\n        {\r\n            ids.push(cursor.u8());\r\n        }\r\n\r\n        for (const id of ids)\r\n        {\r\n            if (seen.has(id)) return null;\r\n            seen.add(id);\r\n\r\n            const rawValue = cursor.u32();\r\n            const valueBytes = new ArrayBuffer(4);\r\n            const valueView = new DataView(valueBytes);\r\n\r\n            valueView.setUint32(0, rawValue, true);\r\n            const floatValue = valueView.getFloat32(0, true);\r\n\r\n            if (FINITE_GAIN_PROPERTY_IDS.has(id)\r\n                && !Number.isFinite(floatValue))\r\n            {\r\n                return null;\r\n            }\r\n\r\n            properties.push({ id, rawValue, floatValue });\r\n        }\r\n\r\n        const prefixByteLength = cursor.at;\r\n        const positioning = readPositioning(cursor);\r\n        const aux = readAux(cursor);\r\n        const policyFlags = cursor.u8();\r\n        const maxInstances = cursor.u16();\r\n        const channelConfigRaw = cursor.u32();\r\n        const hdrFlags = cursor.u8();\r\n        const recoveryTime = cursor.s32();\r\n        const maxDuckVolume = finite(cursor.f32());\r\n        const ducks = ReadDucks(cursor);\r\n        const fx = ReadEffects(cursor);\r\n        const metadata = ReadMetadata(cursor);\r\n        const rtpcs = readInitialRtpcs(cursor);\r\n        const state = readStateChunk(cursor);\r\n\r\n        if (cursor.remaining !== 0) return null;\r\n\r\n        const gainValue = id => properties.find(\r\n            property => property.id === id,\r\n        )?.floatValue ?? null;\r\n\r\n        return {\r\n            overrideBusId,\r\n            outputDeviceId,\r\n            properties,\r\n            busVolume: gainValue(BUS_VOLUME_PROPERTY_ID),\r\n            makeUpGain: gainValue(MAKE_UP_GAIN_PROPERTY_ID),\r\n            outputBusVolume: gainValue(OUTPUT_BUS_VOLUME_PROPERTY_ID),\r\n            prefixByteLength,\r\n            positioning,\r\n            aux,\r\n            policy: {\r\n                flags: policyFlags,\r\n                killNewest: Boolean(policyFlags & 0x01),\r\n                useVirtualBehavior: Boolean(policyFlags & 0x02),\r\n                ignoreParentMaxInstances: Boolean(policyFlags & 0x04),\r\n                backgroundMusic: Boolean(policyFlags & 0x08),\r\n                maxInstances,\r\n            },\r\n            channelConfig: {\r\n                raw: channelConfigRaw,\r\n                channelCount: channelConfigRaw & 0xff,\r\n                configType: (channelConfigRaw >>> 8) & 0x0f,\r\n                channelMask: channelConfigRaw >>> 12,\r\n            },\r\n            hdr: {\r\n                flags: hdrFlags,\r\n                enabled: Boolean(hdrFlags & 0x01),\r\n                exponentialRelease: Boolean(hdrFlags & 0x02),\r\n            },\r\n            recoveryTime,\r\n            maxDuckVolume,\r\n            ducks,\r\n            fx,\r\n            metadata,\r\n            rtpcs,\r\n            state,\r\n            byteLength: cursor.at,\r\n        };\r\n    }\r\n    catch\r\n    {\r\n        return null;\r\n    }\r\n}\r\n\r\nfunction ReadDucks(cursor)\r\n{\r\n    const count = boundedCount(cursor.u32(), cursor.remaining, 18, 65535);\r\n    const ducks = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const busId = cursor.u32();\r\n        const volume = finite(cursor.f32());\r\n        const fadeOutTime = cursor.s32();\r\n        const fadeInTime = cursor.s32();\r\n        const curve = cursor.u8();\r\n        const targetPropertyId = cursor.u8();\r\n\r\n        if (curve > 9)\r\n        {\r\n            throw new RangeError(\"invalid v150 Wwise duck curve\");\r\n        }\r\n\r\n        ducks.push({\r\n            busId,\r\n            volume,\r\n            fadeOutTime,\r\n            fadeInTime,\r\n            curve,\r\n            targetPropertyId,\r\n        });\r\n    }\r\n\r\n    return ducks;\r\n}\r\n\r\nfunction ReadEffects(cursor)\r\n{\r\n    const count = boundedCount(cursor.u8(), cursor.remaining, 6, 255);\r\n    const bypassAllRaw = count ? cursor.u8() : 0;\r\n    const slots = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const slot = cursor.u8();\r\n        const fxId = cursor.u32();\r\n        const flags = cursor.u8();\r\n\r\n        slots.push({\r\n            index: slot,\r\n            fxId,\r\n            flags,\r\n            bypass: Boolean(flags & 0x01),\r\n            shareSet: Boolean(flags & 0x02),\r\n        });\r\n    }\r\n\r\n    return {\r\n        bypassAllRaw,\r\n        bypassAll: Boolean(bypassAllRaw),\r\n        slots,\r\n    };\r\n}\r\n\r\nfunction ReadMetadata(cursor)\r\n{\r\n    const count = boundedCount(cursor.u8(), cursor.remaining, 6, 255);\r\n    const slots = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const slot = cursor.u8();\r\n        const fxId = cursor.u32();\r\n        const shareSetRaw = cursor.u8();\r\n\r\n        slots.push({\r\n            index: slot,\r\n            fxId,\r\n            shareSetRaw,\r\n            shareSet: Boolean(shareSetRaw),\r\n        });\r\n    }\r\n\r\n    return { slots };\r\n}\r\n\r\n/**\r\n * Decodes every v150 Audio and Auxiliary Bus across inspected banks.\r\n *\r\n * @param {Array<object>|object} inspections Related `CjsBnkFormat.inspect()` results.\r\n * @returns {{buses: Map<number, object>, diagnostics: object}} Typed bus catalog and failures.\r\n */\r\nexport function busNodesFromBanks(inspections)\r\n{\r\n    const banks = Array.isArray(inspections) ? inspections : [ inspections ];\r\n    const buses = new Map();\r\n    const failed = [];\r\n    const duplicates = [];\r\n    const unsupportedVersions = [];\r\n    let parsed = 0;\r\n\r\n    for (const inspection of banks)\r\n    {\r\n        const bank = inspection?.source || \"\";\r\n        const bankVersion = Number(inspection?.bankVersion) >>> 0;\r\n\r\n        if (bankVersion !== SUPPORTED_VERSION)\r\n        {\r\n            unsupportedVersions.push({ bank, version: bankVersion });\r\n            continue;\r\n        }\r\n\r\n        for (const entry of inspection?.hirc ?? [])\r\n        {\r\n            if (entry.type !== AUDIO_BUS_TYPE\r\n                && entry.type !== AUXILIARY_BUS_TYPE)\r\n            {\r\n                continue;\r\n            }\r\n\r\n            const decoded = parseBusNode(entry.payload, { bankVersion });\r\n            const type = entry.type === AUDIO_BUS_TYPE\r\n                ? \"audio-bus\"\r\n                : \"auxiliary-bus\";\r\n\r\n            if (!decoded)\r\n            {\r\n                failed.push({\r\n                    bank,\r\n                    version: bankVersion,\r\n                    type,\r\n                    id: entry.id,\r\n                    reason: \"invalid v150 bus body\",\r\n                });\r\n                continue;\r\n            }\r\n            if (buses.has(entry.id))\r\n            {\r\n                duplicates.push({\r\n                    id: entry.id,\r\n                    previousBank: buses.get(entry.id).bank,\r\n                    bank,\r\n                });\r\n            }\r\n\r\n            parsed++;\r\n            buses.set(entry.id, {\r\n                id: entry.id,\r\n                bank,\r\n                type,\r\n                ...decoded,\r\n            });\r\n        }\r\n    }\r\n\r\n    return {\r\n        buses,\r\n        diagnostics: {\r\n            parsed,\r\n            failed,\r\n            duplicates,\r\n            unsupportedVersions,\r\n        },\r\n    };\r\n}\r\n"],"names":["SUPPORTED_VERSION","AUDIO_BUS_TYPE","AUXILIARY_BUS_TYPE","BUS_VOLUME_PROPERTY_ID","MAKE_UP_GAIN_PROPERTY_ID","OUTPUT_BUS_VOLUME_PROPERTY_ID","FINITE_GAIN_PROPERTY_IDS","Set","parseBusNode","payload","bankVersion","Uint8Array","Number","byteLength","cursor","WwiseCursor","overrideBusId","u32","outputDeviceId","propertyCount","boundedCount","u8","remaining","ids","seen","properties","index","push","id","has","add","rawValue","valueBytes","ArrayBuffer","valueView","DataView","setUint32","floatValue","getFloat32","isFinite","prefixByteLength","at","positioning","readPositioning","aux","readAux","policyFlags","maxInstances","u16","channelConfigRaw","hdrFlags","recoveryTime","s32","maxDuckVolume","finite","f32","ducks","ReadDucks","fx","ReadEffects","metadata","ReadMetadata","rtpcs","readInitialRtpcs","state","readStateChunk","gainValue","find","property","busVolume","makeUpGain","outputBusVolume","policy","flags","killNewest","Boolean","useVirtualBehavior","ignoreParentMaxInstances","backgroundMusic","channelConfig","raw","channelCount","configType","channelMask","hdr","enabled","exponentialRelease","count","busId","volume","fadeOutTime","fadeInTime","curve","targetPropertyId","RangeError","bypassAllRaw","slots","slot","fxId","bypass","shareSet","bypassAll","shareSetRaw","busNodesFromBanks","inspections","banks","Array","isArray","buses","Map","failed","duplicates","unsupportedVersions","parsed","inspection","bank","source","version","entry","hirc","type","decoded","reason","previousBank","get","set","diagnostics"],"mappings":"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"}
+{"version":3,"file":"busNodes.js","sources":["../../../../../../src/resource/formats/bnk/core/busNodes.js"],"sourcesContent":["// Exact Wwise v150 Audio Bus and Auxiliary Bus decoding. The HIRC payload\r\n// supplied by inspect() starts after the object id. Records preserve authored\r\n// routing, bus policy, ducking, effect references, metadata, RTPCs, and state\r\n// without assigning runtime mixing or plug-in semantics.\r\n\r\nimport {\r\n    boundedCount,\r\n    finite,\r\n    readAux,\r\n    readInitialRtpcs,\r\n    readPositioning,\r\n    readStateChunk,\r\n    WwiseCursor,\r\n} from \"./nodeBase.js\";\r\n\r\nconst SUPPORTED_VERSION = 150;\r\nconst AUDIO_BUS_TYPE = 8;\r\nconst AUXILIARY_BUS_TYPE = 18;\r\nconst BUS_VOLUME_PROPERTY_ID = 0x04;\r\nconst MAKE_UP_GAIN_PROPERTY_ID = 0x05;\r\nconst OUTPUT_BUS_VOLUME_PROPERTY_ID = 0x0d;\r\nconst FINITE_GAIN_PROPERTY_IDS = new Set([\r\n    BUS_VOLUME_PROPERTY_ID,\r\n    MAKE_UP_GAIN_PROPERTY_ID,\r\n    OUTPUT_BUS_VOLUME_PROPERTY_ID,\r\n]);\r\n\r\n/**\r\n * Decodes one complete v150 Audio or Auxiliary Bus body.\r\n *\r\n * @param {Uint8Array} payload Entry payload view from `inspect()`.\r\n * @param {object} [options] Bank-version qualification.\r\n * @returns {object|null} Typed bus body, or null when it is invalid.\r\n */\r\nexport function parseBusNode(\r\n    payload,\r\n    { bankVersion = SUPPORTED_VERSION } = {},\r\n)\r\n{\r\n    if (!(payload instanceof Uint8Array)\r\n        || Number(bankVersion) !== SUPPORTED_VERSION\r\n        || payload.byteLength < 5)\r\n    {\r\n        return null;\r\n    }\r\n\r\n    try\r\n    {\r\n        const cursor = new WwiseCursor(payload);\r\n        const overrideBusId = cursor.u32();\r\n        let outputDeviceId = null;\r\n\r\n        if (overrideBusId === 0)\r\n        {\r\n            outputDeviceId = cursor.u32();\r\n        }\r\n\r\n        const propertyCount = boundedCount(\r\n            cursor.u8(),\r\n            cursor.remaining,\r\n            5,\r\n            255,\r\n        );\r\n        const ids = [];\r\n        const seen = new Set();\r\n        const properties = [];\r\n\r\n        for (let index = 0; index < propertyCount; index++)\r\n        {\r\n            ids.push(cursor.u8());\r\n        }\r\n\r\n        for (const id of ids)\r\n        {\r\n            if (seen.has(id)) return null;\r\n            seen.add(id);\r\n\r\n            const rawValue = cursor.u32();\r\n            const valueBytes = new ArrayBuffer(4);\r\n            const valueView = new DataView(valueBytes);\r\n\r\n            valueView.setUint32(0, rawValue, true);\r\n            const floatValue = valueView.getFloat32(0, true);\r\n\r\n            if (FINITE_GAIN_PROPERTY_IDS.has(id)\r\n                && !Number.isFinite(floatValue))\r\n            {\r\n                return null;\r\n            }\r\n\r\n            properties.push({ id, rawValue, floatValue });\r\n        }\r\n\r\n        const prefixByteLength = cursor.at;\r\n        const positioning = readPositioning(cursor);\r\n        const aux = readAux(cursor);\r\n        const policyFlags = cursor.u8();\r\n        const maxInstances = cursor.u16();\r\n        const channelConfigRaw = cursor.u32();\r\n        const hdrFlags = cursor.u8();\r\n        const recoveryTime = cursor.s32();\r\n        const maxDuckVolume = finite(cursor.f32());\r\n        const ducks = ReadDucks(cursor);\r\n        const fx = ReadEffects(cursor);\r\n        const metadata = ReadMetadata(cursor);\r\n        const rtpcs = readInitialRtpcs(cursor);\r\n        const state = readStateChunk(cursor);\r\n\r\n        if (cursor.remaining !== 0) return null;\r\n\r\n        const gainValue = id => properties.find(\r\n            property => property.id === id,\r\n        )?.floatValue ?? null;\r\n\r\n        return {\r\n            overrideBusId,\r\n            outputDeviceId,\r\n            properties,\r\n            busVolume: gainValue(BUS_VOLUME_PROPERTY_ID),\r\n            makeUpGain: gainValue(MAKE_UP_GAIN_PROPERTY_ID),\r\n            outputBusVolume: gainValue(OUTPUT_BUS_VOLUME_PROPERTY_ID),\r\n            prefixByteLength,\r\n            positioning,\r\n            aux,\r\n            policy: {\r\n                flags: policyFlags,\r\n                killNewest: Boolean(policyFlags & 0x01),\r\n                useVirtualBehavior: Boolean(policyFlags & 0x02),\r\n                ignoreParentMaxInstances: Boolean(policyFlags & 0x04),\r\n                backgroundMusic: Boolean(policyFlags & 0x08),\r\n                maxInstances,\r\n            },\r\n            channelConfig: {\r\n                raw: channelConfigRaw,\r\n                channelCount: channelConfigRaw & 0xff,\r\n                configType: (channelConfigRaw >>> 8) & 0x0f,\r\n                channelMask: channelConfigRaw >>> 12,\r\n            },\r\n            hdr: {\r\n                flags: hdrFlags,\r\n                enabled: Boolean(hdrFlags & 0x01),\r\n                exponentialRelease: Boolean(hdrFlags & 0x02),\r\n            },\r\n            recoveryTime,\r\n            maxDuckVolume,\r\n            ducks,\r\n            fx,\r\n            metadata,\r\n            rtpcs,\r\n            state,\r\n            byteLength: cursor.at,\r\n        };\r\n    }\r\n    catch\r\n    {\r\n        return null;\r\n    }\r\n}\r\n\r\nfunction ReadDucks(cursor)\r\n{\r\n    const count = boundedCount(cursor.u32(), cursor.remaining, 18, 65535);\r\n    const ducks = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const busId = cursor.u32();\r\n        const volume = finite(cursor.f32());\r\n        const fadeOutTime = cursor.s32();\r\n        const fadeInTime = cursor.s32();\r\n        const curve = cursor.u8();\r\n        const targetPropertyId = cursor.u8();\r\n\r\n        if (curve > 9)\r\n        {\r\n            throw new RangeError(\"invalid v150 Wwise duck curve\");\r\n        }\r\n\r\n        ducks.push({\r\n            busId,\r\n            volume,\r\n            fadeOutTime,\r\n            fadeInTime,\r\n            curve,\r\n            targetPropertyId,\r\n        });\r\n    }\r\n\r\n    return ducks;\r\n}\r\n\r\nfunction ReadEffects(cursor)\r\n{\r\n    const count = boundedCount(cursor.u8(), cursor.remaining, 6, 255);\r\n    const bypassAllRaw = count ? cursor.u8() : 0;\r\n    const slots = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const slot = cursor.u8();\r\n        const fxId = cursor.u32();\r\n        const flags = cursor.u8();\r\n\r\n        slots.push({\r\n            index: slot,\r\n            fxId,\r\n            flags,\r\n            bypass: Boolean(flags & 0x01),\r\n            shareSet: Boolean(flags & 0x02),\r\n        });\r\n    }\r\n\r\n    return {\r\n        bypassAllRaw,\r\n        bypassAll: Boolean(bypassAllRaw),\r\n        slots,\r\n    };\r\n}\r\n\r\nfunction ReadMetadata(cursor)\r\n{\r\n    const count = boundedCount(cursor.u8(), cursor.remaining, 6, 255);\r\n    const slots = [];\r\n\r\n    for (let index = 0; index < count; index++)\r\n    {\r\n        const slot = cursor.u8();\r\n        const fxId = cursor.u32();\r\n        const shareSetRaw = cursor.u8();\r\n\r\n        slots.push({\r\n            index: slot,\r\n            fxId,\r\n            shareSetRaw,\r\n            shareSet: Boolean(shareSetRaw),\r\n        });\r\n    }\r\n\r\n    return { slots };\r\n}\r\n\r\n/**\r\n * Decodes every v150 Audio and Auxiliary Bus across inspected banks.\r\n *\r\n * @param {Array<object>|object} inspections Related `CjsBnkFormat.inspect()` results.\r\n * @returns {{buses: Map<number, object>, diagnostics: object}} Typed bus catalog and failures.\r\n */\r\nexport function busNodesFromBanks(inspections)\r\n{\r\n    const banks = Array.isArray(inspections) ? inspections : [ inspections ];\r\n    const buses = new Map();\r\n    const failed = [];\r\n    const duplicates = [];\r\n    const unsupportedVersions = [];\r\n    let parsed = 0;\r\n\r\n    for (const inspection of banks)\r\n    {\r\n        const bank = inspection?.source || \"\";\r\n        const bankVersion = Number(inspection?.bankVersion) >>> 0;\r\n\r\n        if (bankVersion !== SUPPORTED_VERSION)\r\n        {\r\n            unsupportedVersions.push({ bank, version: bankVersion });\r\n            continue;\r\n        }\r\n\r\n        for (const entry of inspection?.hirc ?? [])\r\n        {\r\n            if (entry.type !== AUDIO_BUS_TYPE\r\n                && entry.type !== AUXILIARY_BUS_TYPE)\r\n            {\r\n                continue;\r\n            }\r\n\r\n            const decoded = parseBusNode(entry.payload, { bankVersion });\r\n            const type = entry.type === AUDIO_BUS_TYPE\r\n                ? \"audio-bus\"\r\n                : \"auxiliary-bus\";\r\n\r\n            if (!decoded)\r\n            {\r\n                failed.push({\r\n                    bank,\r\n                    version: bankVersion,\r\n                    type,\r\n                    id: entry.id,\r\n                    reason: \"invalid v150 bus body\",\r\n                });\r\n                continue;\r\n            }\r\n            if (buses.has(entry.id))\r\n            {\r\n                duplicates.push({\r\n                    id: entry.id,\r\n                    previousBank: buses.get(entry.id).bank,\r\n                    bank,\r\n                });\r\n            }\r\n\r\n            parsed++;\r\n            buses.set(entry.id, {\r\n                id: entry.id,\r\n                bank,\r\n                type,\r\n                ...decoded,\r\n            });\r\n        }\r\n    }\r\n\r\n    return {\r\n        buses,\r\n        diagnostics: {\r\n            parsed,\r\n            failed,\r\n            duplicates,\r\n            unsupportedVersions,\r\n        },\r\n    };\r\n}\r\n"],"names":["SUPPORTED_VERSION","AUDIO_BUS_TYPE","AUXILIARY_BUS_TYPE","BUS_VOLUME_PROPERTY_ID","MAKE_UP_GAIN_PROPERTY_ID","OUTPUT_BUS_VOLUME_PROPERTY_ID","FINITE_GAIN_PROPERTY_IDS","Set","parseBusNode","payload","bankVersion","Uint8Array","Number","byteLength","cursor","WwiseCursor","overrideBusId","u32","outputDeviceId","propertyCount","boundedCount","u8","remaining","ids","seen","properties","index","push","id","has","add","rawValue","valueBytes","ArrayBuffer","valueView","DataView","setUint32","floatValue","getFloat32","isFinite","prefixByteLength","at","positioning","readPositioning","aux","readAux","policyFlags","maxInstances","u16","channelConfigRaw","hdrFlags","recoveryTime","s32","maxDuckVolume","finite","f32","ducks","ReadDucks","fx","ReadEffects","metadata","ReadMetadata","rtpcs","readInitialRtpcs","state","readStateChunk","gainValue","find","property","busVolume","makeUpGain","outputBusVolume","policy","flags","killNewest","Boolean","useVirtualBehavior","ignoreParentMaxInstances","backgroundMusic","channelConfig","raw","channelCount","configType","channelMask","hdr","enabled","exponentialRelease","count","busId","volume","fadeOutTime","fadeInTime","curve","targetPropertyId","RangeError","bypassAllRaw","slots","slot","fxId","bypass","shareSet","bypassAll","shareSetRaw","busNodesFromBanks","inspections","banks","Array","isArray","buses","Map","failed","duplicates","unsupportedVersions","parsed","inspection","bank","source","version","entry","hirc","type","decoded","reason","previousBank","get","set","diagnostics"],"mappings":"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"}

package/dist/resource/formats/bnk/core/effectNodes.js

@@ -1,4 +1,5 @@
-import { WwiseCursor, boundedCount, readInitialRtpcs, readStateChunk, finite } from './nodeBase.js';
+import { boundedCount, readInitialRtpcs, readStateChunk, finite } from './nodeBase.js';
+import { WwiseCursor } from './WwiseCursor.js';
 
 // Exact generic Wwise v150 Fx ShareSet and Fx Custom object decoding. Plug-in
 // parameter blocks remain opaque bytes; the resource layer preserves identity,

package/dist/resource/formats/bnk/core/effectNodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"effectNodes.js","sources":["../../../../../../src/resource/formats/bnk/core/effectNodes.js"],"sourcesContent":["// Exact generic Wwise v150 Fx ShareSet and Fx Custom object decoding. Plug-in\r\n// parameter blocks remain opaque bytes; the resource layer preserves identity,\r\n// media, RTPC, state, and property records without interpreting DSP behavior.\r\n\r\nimport {\r\n    boundedCount,\r\n    finite,\r\n    readInitialRtpcs,\r\n    readStateChunk,\r\n    WwiseCursor,\r\n} from \"./nodeBase.js\";\r\n\r\nconst SUPPORTED_VERSION = 150;\r\nconst FX_SHARE_SET_TYPE = 16;\r\nconst FX_CUSTOM_TYPE = 17;\r\nconst NO_PLUGIN_ID = 0xffffffff;\r\n\r\n/**\r\n * Decodes one complete v150 Fx ShareSet or Fx Custom body.\r\n *\r\n * @param {Uint8Array} payload Entry payload view from `inspect()`.\r\n * @param {object} [options] Bank-version qualification.\r\n * @returns {object|null} Typed effect body, or null when it is invalid.\r\n */\r\nexport function parseEffectNode(\r\n    payload,\r\n    { bankVersion = SUPPORTED_VERSION } = {},\r\n)\r\n{\r\n    if (!(payload instanceof Uint8Array)\r\n        || Number(bankVersion) !== SUPPORTED_VERSION\r\n        || payload.byteLength < 4)\r\n    {\r\n        return null;\r\n    }\r\n\r\n    try\r\n    {\r\n        const cursor = new WwiseCursor(payload);\r\n        const pluginId = cursor.u32();\r\n        let parameterBlock = payload.subarray(cursor.at, cursor.at);\r\n\r\n        if (pluginId !== 0 && pluginId !== NO_PLUGIN_ID)\r\n        {\r\n            const parameterByteLength = cursor.u32();\r\n\r\n            cursor.ensure(parameterByteLength);\r\n            parameterBlock = payload.subarray(\r\n                cursor.at,\r\n                cursor.at + parameterByteLength,\r\n            );\r\n            cursor.at += parameterByteLength;\r\n        }\r\n\r\n        const mediaCount = boundedCount(\r\n            cursor.u8(),\r\n            cursor.remaining,\r\n            5,\r\n            255,\r\n        );\r\n        const media = [];\r\n\r\n        for (let index = 0; index < mediaCount; index++)\r\n        {\r\n            media.push({\r\n                index: cursor.u8(),\r\n                sourceId: cursor.u32(),\r\n            });\r\n        }\r\n\r\n        const rtpcs = readInitialRtpcs(cursor);\r\n        const state = readStateChunk(cursor);\r\n        const propertyCount = boundedCount(\r\n            cursor.u16(),\r\n            cursor.remaining,\r\n            6,\r\n            65535,\r\n        );\r\n        const propertyValues = [];\r\n\r\n        for (let index = 0; index < propertyCount; index++)\r\n        {\r\n            const propertyId = cursor.variable();\r\n            const accumulation = cursor.u8();\r\n            const value = finite(cursor.f32());\r\n\r\n            if (accumulation > 6)\r\n            {\r\n                throw new RangeError(\"invalid v150 effect accumulation\");\r\n            }\r\n\r\n            propertyValues.push({ propertyId, accumulation, value });\r\n        }\r\n\r\n        if (cursor.remaining !== 0) return null;\r\n\r\n        return {\r\n            pluginId,\r\n            pluginType: pluginId & 0x0f,\r\n            companyId: (pluginId >>> 4) & 0x0fff,\r\n            pluginClassId: pluginId >>> 16,\r\n            parameterBlock,\r\n            media,\r\n            rtpcs,\r\n            state,\r\n            propertyValues,\r\n            byteLength: cursor.at,\r\n        };\r\n    }\r\n    catch\r\n    {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Decodes every v150 Fx ShareSet and Fx Custom across inspected banks.\r\n *\r\n * @param {Array<object>|object} inspections Related `CjsBnkFormat.inspect()` results.\r\n * @returns {{effects: Map<number, object>, diagnostics: object}} Typed effect catalog and failures.\r\n */\r\nexport function effectNodesFromBanks(inspections)\r\n{\r\n    const banks = Array.isArray(inspections) ? inspections : [ inspections ];\r\n    const effects = new Map();\r\n    const failed = [];\r\n    const duplicates = [];\r\n    const unsupportedVersions = [];\r\n    let parsed = 0;\r\n\r\n    for (const inspection of banks)\r\n    {\r\n        const bank = inspection?.source || \"\";\r\n        const bankVersion = Number(inspection?.bankVersion) >>> 0;\r\n\r\n        if (bankVersion !== SUPPORTED_VERSION)\r\n        {\r\n            unsupportedVersions.push({ bank, version: bankVersion });\r\n            continue;\r\n        }\r\n\r\n        for (const entry of inspection?.hirc ?? [])\r\n        {\r\n            if (entry.type !== FX_SHARE_SET_TYPE\r\n                && entry.type !== FX_CUSTOM_TYPE)\r\n            {\r\n                continue;\r\n            }\r\n\r\n            const decoded = parseEffectNode(entry.payload, { bankVersion });\r\n            const type = entry.type === FX_SHARE_SET_TYPE\r\n                ? \"effect-share-set\"\r\n                : \"effect-custom\";\r\n\r\n            if (!decoded)\r\n            {\r\n                failed.push({\r\n                    bank,\r\n                    version: bankVersion,\r\n                    type,\r\n                    id: entry.id,\r\n                    reason: \"invalid v150 effect body\",\r\n                });\r\n                continue;\r\n            }\r\n            if (effects.has(entry.id))\r\n            {\r\n                duplicates.push({\r\n                    id: entry.id,\r\n                    previousBank: effects.get(entry.id).bank,\r\n                    bank,\r\n                });\r\n            }\r\n\r\n            parsed++;\r\n            effects.set(entry.id, {\r\n                id: entry.id,\r\n                bank,\r\n                type,\r\n                ...decoded,\r\n            });\r\n        }\r\n    }\r\n\r\n    return {\r\n        effects,\r\n        diagnostics: {\r\n            parsed,\r\n            failed,\r\n            duplicates,\r\n            unsupportedVersions,\r\n        },\r\n    };\r\n}\r\n"],"names":["SUPPORTED_VERSION","FX_SHARE_SET_TYPE","FX_CUSTOM_TYPE","NO_PLUGIN_ID","parseEffectNode","payload","bankVersion","Uint8Array","Number","byteLength","cursor","WwiseCursor","pluginId","u32","parameterBlock","subarray","at","parameterByteLength","ensure","mediaCount","boundedCount","u8","remaining","media","index","push","sourceId","rtpcs","readInitialRtpcs","state","readStateChunk","propertyCount","u16","propertyValues","propertyId","variable","accumulation","value","finite","f32","RangeError","pluginType","companyId","pluginClassId","effectNodesFromBanks","inspections","banks","Array","isArray","effects","Map","failed","duplicates","unsupportedVersions","parsed","inspection","bank","source","version","entry","hirc","type","decoded","id","reason","has","previousBank","get","set","diagnostics"],"mappings":"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"}
+{"version":3,"file":"effectNodes.js","sources":["../../../../../../src/resource/formats/bnk/core/effectNodes.js"],"sourcesContent":["// Exact generic Wwise v150 Fx ShareSet and Fx Custom object decoding. Plug-in\r\n// parameter blocks remain opaque bytes; the resource layer preserves identity,\r\n// media, RTPC, state, and property records without interpreting DSP behavior.\r\n\r\nimport {\r\n    boundedCount,\r\n    finite,\r\n    readInitialRtpcs,\r\n    readStateChunk,\r\n    WwiseCursor,\r\n} from \"./nodeBase.js\";\r\n\r\nconst SUPPORTED_VERSION = 150;\r\nconst FX_SHARE_SET_TYPE = 16;\r\nconst FX_CUSTOM_TYPE = 17;\r\nconst NO_PLUGIN_ID = 0xffffffff;\r\n\r\n/**\r\n * Decodes one complete v150 Fx ShareSet or Fx Custom body.\r\n *\r\n * @param {Uint8Array} payload Entry payload view from `inspect()`.\r\n * @param {object} [options] Bank-version qualification.\r\n * @returns {object|null} Typed effect body, or null when it is invalid.\r\n */\r\nexport function parseEffectNode(\r\n    payload,\r\n    { bankVersion = SUPPORTED_VERSION } = {},\r\n)\r\n{\r\n    if (!(payload instanceof Uint8Array)\r\n        || Number(bankVersion) !== SUPPORTED_VERSION\r\n        || payload.byteLength < 4)\r\n    {\r\n        return null;\r\n    }\r\n\r\n    try\r\n    {\r\n        const cursor = new WwiseCursor(payload);\r\n        const pluginId = cursor.u32();\r\n        let parameterBlock = payload.subarray(cursor.at, cursor.at);\r\n\r\n        if (pluginId !== 0 && pluginId !== NO_PLUGIN_ID)\r\n        {\r\n            const parameterByteLength = cursor.u32();\r\n\r\n            cursor.ensure(parameterByteLength);\r\n            parameterBlock = payload.subarray(\r\n                cursor.at,\r\n                cursor.at + parameterByteLength,\r\n            );\r\n            cursor.at += parameterByteLength;\r\n        }\r\n\r\n        const mediaCount = boundedCount(\r\n            cursor.u8(),\r\n            cursor.remaining,\r\n            5,\r\n            255,\r\n        );\r\n        const media = [];\r\n\r\n        for (let index = 0; index < mediaCount; index++)\r\n        {\r\n            media.push({\r\n                index: cursor.u8(),\r\n                sourceId: cursor.u32(),\r\n            });\r\n        }\r\n\r\n        const rtpcs = readInitialRtpcs(cursor);\r\n        const state = readStateChunk(cursor);\r\n        const propertyCount = boundedCount(\r\n            cursor.u16(),\r\n            cursor.remaining,\r\n            6,\r\n            65535,\r\n        );\r\n        const propertyValues = [];\r\n\r\n        for (let index = 0; index < propertyCount; index++)\r\n        {\r\n            const propertyId = cursor.variable();\r\n            const accumulation = cursor.u8();\r\n            const value = finite(cursor.f32());\r\n\r\n            if (accumulation > 6)\r\n            {\r\n                throw new RangeError(\"invalid v150 effect accumulation\");\r\n            }\r\n\r\n            propertyValues.push({ propertyId, accumulation, value });\r\n        }\r\n\r\n        if (cursor.remaining !== 0) return null;\r\n\r\n        return {\r\n            pluginId,\r\n            pluginType: pluginId & 0x0f,\r\n            companyId: (pluginId >>> 4) & 0x0fff,\r\n            pluginClassId: pluginId >>> 16,\r\n            parameterBlock,\r\n            media,\r\n            rtpcs,\r\n            state,\r\n            propertyValues,\r\n            byteLength: cursor.at,\r\n        };\r\n    }\r\n    catch\r\n    {\r\n        return null;\r\n    }\r\n}\r\n\r\n/**\r\n * Decodes every v150 Fx ShareSet and Fx Custom across inspected banks.\r\n *\r\n * @param {Array<object>|object} inspections Related `CjsBnkFormat.inspect()` results.\r\n * @returns {{effects: Map<number, object>, diagnostics: object}} Typed effect catalog and failures.\r\n */\r\nexport function effectNodesFromBanks(inspections)\r\n{\r\n    const banks = Array.isArray(inspections) ? inspections : [ inspections ];\r\n    const effects = new Map();\r\n    const failed = [];\r\n    const duplicates = [];\r\n    const unsupportedVersions = [];\r\n    let parsed = 0;\r\n\r\n    for (const inspection of banks)\r\n    {\r\n        const bank = inspection?.source || \"\";\r\n        const bankVersion = Number(inspection?.bankVersion) >>> 0;\r\n\r\n        if (bankVersion !== SUPPORTED_VERSION)\r\n        {\r\n            unsupportedVersions.push({ bank, version: bankVersion });\r\n            continue;\r\n        }\r\n\r\n        for (const entry of inspection?.hirc ?? [])\r\n        {\r\n            if (entry.type !== FX_SHARE_SET_TYPE\r\n                && entry.type !== FX_CUSTOM_TYPE)\r\n            {\r\n                continue;\r\n            }\r\n\r\n            const decoded = parseEffectNode(entry.payload, { bankVersion });\r\n            const type = entry.type === FX_SHARE_SET_TYPE\r\n                ? \"effect-share-set\"\r\n                : \"effect-custom\";\r\n\r\n            if (!decoded)\r\n            {\r\n                failed.push({\r\n                    bank,\r\n                    version: bankVersion,\r\n                    type,\r\n                    id: entry.id,\r\n                    reason: \"invalid v150 effect body\",\r\n                });\r\n                continue;\r\n            }\r\n            if (effects.has(entry.id))\r\n            {\r\n                duplicates.push({\r\n                    id: entry.id,\r\n                    previousBank: effects.get(entry.id).bank,\r\n                    bank,\r\n                });\r\n            }\r\n\r\n            parsed++;\r\n            effects.set(entry.id, {\r\n                id: entry.id,\r\n                bank,\r\n                type,\r\n                ...decoded,\r\n            });\r\n        }\r\n    }\r\n\r\n    return {\r\n        effects,\r\n        diagnostics: {\r\n            parsed,\r\n            failed,\r\n            duplicates,\r\n            unsupportedVersions,\r\n        },\r\n    };\r\n}\r\n"],"names":["SUPPORTED_VERSION","FX_SHARE_SET_TYPE","FX_CUSTOM_TYPE","NO_PLUGIN_ID","parseEffectNode","payload","bankVersion","Uint8Array","Number","byteLength","cursor","WwiseCursor","pluginId","u32","parameterBlock","subarray","at","parameterByteLength","ensure","mediaCount","boundedCount","u8","remaining","media","index","push","sourceId","rtpcs","readInitialRtpcs","state","readStateChunk","propertyCount","u16","propertyValues","propertyId","variable","accumulation","value","finite","f32","RangeError","pluginType","companyId","pluginClassId","effectNodesFromBanks","inspections","banks","Array","isArray","effects","Map","failed","duplicates","unsupportedVersions","parsed","inspection","bank","source","version","entry","hirc","type","decoded","id","reason","has","previousBank","get","set","diagnostics"],"mappings":"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"}