@carbonenginejs/runtime-resource 0.1.0 → 0.8.0

package/dist/formats/wem/core/ptadpcm.js

@@ -0,0 +1,77 @@
+// Wwise PTADPCM (RIFF format tag 0x8311, "Platinum ADPCM") decoder.
+//
+// Original CarbonEngineJS implementation of the publicly documented algorithm
+// (community documentation of the codec: vgmstream/wwiser); no code copied.
+// Verified against EVE Online media (turret/artillery SFX banks).
+//
+// Frame layout, per channel (frames externally interleaved channel-by-channel;
+// frame size = fmt blockAlign / channels, typically 0x24 bytes):
+//   0x00 int16 LE  hist2 (second-newest history sample, emitted first)
+//   0x02 int16 LE  hist1 (newest history sample, emitted second)
+//   0x04 u8        step table index (clamped to 12)
+//   0x05...        4-bit codes, low nibble first
+// Samples per frame = 2 + (frameSize - 5) * 2.
+// Per code: sample = clamp16(step + 2*hist1 - hist2), then the index moves to
+// the row's nextIndex - {step, nextIndex} from PTADPCM_TABLE[index][code].
+
+// [index][code] -> [stepDelta, nextIndex]. Rows 12-15 are zero: the header
+// index is clamped to 12 and no transition targets a row above 11.
+const PTADPCM_TABLE = [[[-14, 2], [-10, 2], [-7, 1], [-5, 1], [-3, 0], [-2, 0], [-1, 0], [0, 0], [0, 0], [1, 0], [2, 0], [3, 0], [5, 1], [7, 1], [10, 2], [14, 2]], [[-28, 3], [-20, 3], [-14, 2], [-10, 2], [-7, 1], [-5, 1], [-3, 1], [-1, 0], [1, 0], [3, 1], [5, 1], [7, 1], [10, 2], [14, 2], [20, 3], [28, 3]], [[-56, 4], [-40, 4], [-28, 3], [-20, 3], [-14, 2], [-10, 2], [-6, 2], [-2, 1], [2, 1], [6, 2], [10, 2], [14, 2], [20, 3], [28, 3], [40, 4], [56, 4]], [[-112, 5], [-80, 5], [-56, 4], [-40, 4], [-28, 3], [-20, 3], [-12, 3], [-4, 2], [4, 2], [12, 3], [20, 3], [28, 3], [40, 4], [56, 4], [80, 5], [112, 5]], [[-224, 6], [-160, 6], [-112, 5], [-80, 5], [-56, 4], [-40, 4], [-24, 4], [-8, 3], [8, 3], [24, 4], [40, 4], [56, 4], [80, 5], [112, 5], [160, 6], [224, 6]], [[-448, 7], [-320, 7], [-224, 6], [-160, 6], [-112, 5], [-80, 5], [-48, 5], [-16, 4], [16, 4], [48, 5], [80, 5], [112, 5], [160, 6], [224, 6], [320, 7], [448, 7]], [[-896, 8], [-640, 8], [-448, 7], [-320, 7], [-224, 6], [-160, 6], [-96, 6], [-32, 5], [32, 5], [96, 6], [160, 6], [224, 6], [320, 7], [448, 7], [640, 8], [896, 8]], [[-1792, 9], [-1280, 9], [-896, 8], [-640, 8], [-448, 7], [-320, 7], [-192, 7], [-64, 6], [64, 6], [192, 7], [320, 7], [448, 7], [640, 8], [896, 8], [1280, 9], [1792, 9]], [[-3584, 10], [-2560, 10], [-1792, 9], [-1280, 9], [-896, 8], [-640, 8], [-384, 8], [-128, 7], [128, 7], [384, 8], [640, 8], [896, 8], [1280, 9], [1792, 9], [2560, 10], [3584, 10]], [[-7168, 11], [-5120, 11], [-3584, 10], [-2560, 10], [-1792, 9], [-1280, 9], [-768, 9], [-256, 8], [256, 8], [768, 9], [1280, 9], [1792, 9], [2560, 10], [3584, 10], [5120, 11], [7168, 11]], [[-14336, 11], [-10240, 11], [-7168, 11], [-5120, 11], [-3584, 10], [-2560, 10], [-1536, 10], [-512, 9], [512, 9], [1536, 10], [2560, 10], [3584, 10], [5120, 11], [7168, 11], [10240, 11], [14336, 11]], [[-28672, 11], [-20480, 11], [-14336, 11], [-10240, 11], [-7168, 11], [-5120, 11], [-3072, 11], [-1024, 10], [1024, 10], [3072, 11], [5120, 11], [7168, 11], [10240, 11], [14336, 11], [20480, 11], [28672, 11]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0]], [[0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0], [0, 0]]];
+
+/**
+ * Decode PTADPCM audio data to per-channel float32 samples.
+ *
+ * @param {Uint8Array} bytes Whole wem bytes.
+ * @param {object} metadata `inspectWEM` result for those bytes (fmt + data chunk facts).
+ * @returns {{channelData: Float32Array[], sampleCount: number, sampleRate: number, channels: number}} AudioBuffer-ready samples.
+ */
+function decodePtadpcm(bytes, metadata) {
+  const channels = metadata.channels;
+  const frameSize = channels > 0 ? Math.floor(metadata.blockAlign / channels) : 0;
+  if (channels < 1 || frameSize < 6 || metadata.blockAlign !== frameSize * channels) {
+    throw new Error(`wem: unsupported PTADPCM layout (channels ${channels}, blockAlign ${metadata.blockAlign})`);
+  }
+  const samplesPerFrame = 2 + (frameSize - 5) * 2;
+  const frameGroups = Math.floor(metadata.dataBytes / metadata.blockAlign);
+  const sampleCount = frameGroups * samplesPerFrame;
+  const channelData = [];
+  for (let channel = 0; channel < channels; channel++) {
+    channelData.push(new Float32Array(sampleCount));
+  }
+  for (let group = 0; group < frameGroups; group++) {
+    for (let channel = 0; channel < channels; channel++) {
+      const frame = metadata.dataOffset + (group * channels + channel) * frameSize;
+      const output = channelData[channel];
+      let at = group * samplesPerFrame;
+      let hist2 = readS16(bytes, frame);
+      let hist1 = readS16(bytes, frame + 2);
+      let index = Math.min(bytes[frame + 4], 12);
+      output[at++] = hist2 / 32768;
+      output[at++] = hist1 / 32768;
+      for (let i = 0; i < samplesPerFrame - 2; i++) {
+        const byte = bytes[frame + 5 + (i >> 1)];
+        const code = (i & 1) === 0 ? byte & 0x0f : byte >> 4;
+        const [step, nextIndex] = PTADPCM_TABLE[index][code];
+        let sample = step + 2 * hist1 - hist2;
+        if (sample > 32767) sample = 32767;else if (sample < -32768) sample = -32768;
+        index = nextIndex;
+        hist2 = hist1;
+        hist1 = sample;
+        output[at++] = sample / 32768;
+      }
+    }
+  }
+  return {
+    channelData,
+    sampleCount,
+    sampleRate: metadata.sampleRate,
+    channels
+  };
+}
+function readS16(bytes, offset) {
+  const value = bytes[offset] | bytes[offset + 1] << 8;
+  return value >= 0x8000 ? value - 0x10000 : value;
+}
+
+export { decodePtadpcm };
+//# sourceMappingURL=ptadpcm.js.map

package/dist/formats/wem/core/ptadpcm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ptadpcm.js","sources":["../../../../../src/formats/wem/core/ptadpcm.js"],"sourcesContent":["// Wwise PTADPCM (RIFF format tag 0x8311, \"Platinum ADPCM\") decoder.\n//\n// Original CarbonEngineJS implementation of the publicly documented algorithm\n// (community documentation of the codec: vgmstream/wwiser); no code copied.\n// Verified against EVE Online media (turret/artillery SFX banks).\n//\n// Frame layout, per channel (frames externally interleaved channel-by-channel;\n// frame size = fmt blockAlign / channels, typically 0x24 bytes):\n//   0x00 int16 LE  hist2 (second-newest history sample, emitted first)\n//   0x02 int16 LE  hist1 (newest history sample, emitted second)\n//   0x04 u8        step table index (clamped to 12)\n//   0x05...        4-bit codes, low nibble first\n// Samples per frame = 2 + (frameSize - 5) * 2.\n// Per code: sample = clamp16(step + 2*hist1 - hist2), then the index moves to\n// the row's nextIndex - {step, nextIndex} from PTADPCM_TABLE[index][code].\n\n// [index][code] -> [stepDelta, nextIndex]. Rows 12-15 are zero: the header\n// index is clamped to 12 and no transition targets a row above 11.\nconst PTADPCM_TABLE = [\n    [ [ -14, 2 ], [ -10, 2 ], [ -7, 1 ], [ -5, 1 ], [ -3, 0 ], [ -2, 0 ], [ -1, 0 ], [ 0, 0 ],\n      [ 0, 0 ], [ 1, 0 ], [ 2, 0 ], [ 3, 0 ], [ 5, 1 ], [ 7, 1 ], [ 10, 2 ], [ 14, 2 ] ],\n    [ [ -28, 3 ], [ -20, 3 ], [ -14, 2 ], [ -10, 2 ], [ -7, 1 ], [ -5, 1 ], [ -3, 1 ], [ -1, 0 ],\n      [ 1, 0 ], [ 3, 1 ], [ 5, 1 ], [ 7, 1 ], [ 10, 2 ], [ 14, 2 ], [ 20, 3 ], [ 28, 3 ] ],\n    [ [ -56, 4 ], [ -40, 4 ], [ -28, 3 ], [ -20, 3 ], [ -14, 2 ], [ -10, 2 ], [ -6, 2 ], [ -2, 1 ],\n      [ 2, 1 ], [ 6, 2 ], [ 10, 2 ], [ 14, 2 ], [ 20, 3 ], [ 28, 3 ], [ 40, 4 ], [ 56, 4 ] ],\n    [ [ -112, 5 ], [ -80, 5 ], [ -56, 4 ], [ -40, 4 ], [ -28, 3 ], [ -20, 3 ], [ -12, 3 ], [ -4, 2 ],\n      [ 4, 2 ], [ 12, 3 ], [ 20, 3 ], [ 28, 3 ], [ 40, 4 ], [ 56, 4 ], [ 80, 5 ], [ 112, 5 ] ],\n    [ [ -224, 6 ], [ -160, 6 ], [ -112, 5 ], [ -80, 5 ], [ -56, 4 ], [ -40, 4 ], [ -24, 4 ], [ -8, 3 ],\n      [ 8, 3 ], [ 24, 4 ], [ 40, 4 ], [ 56, 4 ], [ 80, 5 ], [ 112, 5 ], [ 160, 6 ], [ 224, 6 ] ],\n    [ [ -448, 7 ], [ -320, 7 ], [ -224, 6 ], [ -160, 6 ], [ -112, 5 ], [ -80, 5 ], [ -48, 5 ], [ -16, 4 ],\n      [ 16, 4 ], [ 48, 5 ], [ 80, 5 ], [ 112, 5 ], [ 160, 6 ], [ 224, 6 ], [ 320, 7 ], [ 448, 7 ] ],\n    [ [ -896, 8 ], [ -640, 8 ], [ -448, 7 ], [ -320, 7 ], [ -224, 6 ], [ -160, 6 ], [ -96, 6 ], [ -32, 5 ],\n      [ 32, 5 ], [ 96, 6 ], [ 160, 6 ], [ 224, 6 ], [ 320, 7 ], [ 448, 7 ], [ 640, 8 ], [ 896, 8 ] ],\n    [ [ -1792, 9 ], [ -1280, 9 ], [ -896, 8 ], [ -640, 8 ], [ -448, 7 ], [ -320, 7 ], [ -192, 7 ], [ -64, 6 ],\n      [ 64, 6 ], [ 192, 7 ], [ 320, 7 ], [ 448, 7 ], [ 640, 8 ], [ 896, 8 ], [ 1280, 9 ], [ 1792, 9 ] ],\n    [ [ -3584, 10 ], [ -2560, 10 ], [ -1792, 9 ], [ -1280, 9 ], [ -896, 8 ], [ -640, 8 ], [ -384, 8 ], [ -128, 7 ],\n      [ 128, 7 ], [ 384, 8 ], [ 640, 8 ], [ 896, 8 ], [ 1280, 9 ], [ 1792, 9 ], [ 2560, 10 ], [ 3584, 10 ] ],\n    [ [ -7168, 11 ], [ -5120, 11 ], [ -3584, 10 ], [ -2560, 10 ], [ -1792, 9 ], [ -1280, 9 ], [ -768, 9 ], [ -256, 8 ],\n      [ 256, 8 ], [ 768, 9 ], [ 1280, 9 ], [ 1792, 9 ], [ 2560, 10 ], [ 3584, 10 ], [ 5120, 11 ], [ 7168, 11 ] ],\n    [ [ -14336, 11 ], [ -10240, 11 ], [ -7168, 11 ], [ -5120, 11 ], [ -3584, 10 ], [ -2560, 10 ], [ -1536, 10 ], [ -512, 9 ],\n      [ 512, 9 ], [ 1536, 10 ], [ 2560, 10 ], [ 3584, 10 ], [ 5120, 11 ], [ 7168, 11 ], [ 10240, 11 ], [ 14336, 11 ] ],\n    [ [ -28672, 11 ], [ -20480, 11 ], [ -14336, 11 ], [ -10240, 11 ], [ -7168, 11 ], [ -5120, 11 ], [ -3072, 11 ], [ -1024, 10 ],\n      [ 1024, 10 ], [ 3072, 11 ], [ 5120, 11 ], [ 7168, 11 ], [ 10240, 11 ], [ 14336, 11 ], [ 20480, 11 ], [ 28672, 11 ] ],\n    [ [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ],\n      [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ] ],\n    [ [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ],\n      [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ] ],\n    [ [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ],\n      [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ] ],\n    [ [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ],\n      [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ], [ 0, 0 ] ]\n];\n\n/**\n * Decode PTADPCM audio data to per-channel float32 samples.\n *\n * @param {Uint8Array} bytes Whole wem bytes.\n * @param {object} metadata `inspectWEM` result for those bytes (fmt + data chunk facts).\n * @returns {{channelData: Float32Array[], sampleCount: number, sampleRate: number, channels: number}} AudioBuffer-ready samples.\n */\nexport function decodePtadpcm(bytes, metadata)\n{\n    const channels = metadata.channels;\n    const frameSize = channels > 0 ? Math.floor(metadata.blockAlign / channels) : 0;\n    if (channels < 1 || frameSize < 6 || metadata.blockAlign !== frameSize * channels)\n    {\n        throw new Error(`wem: unsupported PTADPCM layout (channels ${channels}, blockAlign ${metadata.blockAlign})`);\n    }\n\n    const samplesPerFrame = 2 + (frameSize - 5) * 2;\n    const frameGroups = Math.floor(metadata.dataBytes / metadata.blockAlign);\n    const sampleCount = frameGroups * samplesPerFrame;\n    const channelData = [];\n    for (let channel = 0; channel < channels; channel++)\n    {\n        channelData.push(new Float32Array(sampleCount));\n    }\n\n    for (let group = 0; group < frameGroups; group++)\n    {\n        for (let channel = 0; channel < channels; channel++)\n        {\n            const frame = metadata.dataOffset + (group * channels + channel) * frameSize;\n            const output = channelData[channel];\n            let at = group * samplesPerFrame;\n\n            let hist2 = readS16(bytes, frame);\n            let hist1 = readS16(bytes, frame + 2);\n            let index = Math.min(bytes[frame + 4], 12);\n\n            output[at++] = hist2 / 32768;\n            output[at++] = hist1 / 32768;\n\n            for (let i = 0; i < samplesPerFrame - 2; i++)\n            {\n                const byte = bytes[frame + 5 + (i >> 1)];\n                const code = (i & 1) === 0 ? byte & 0x0f : byte >> 4;\n                const [ step, nextIndex ] = PTADPCM_TABLE[index][code];\n                let sample = step + 2 * hist1 - hist2;\n                if (sample > 32767) sample = 32767;\n                else if (sample < -32768) sample = -32768;\n                index = nextIndex;\n                hist2 = hist1;\n                hist1 = sample;\n                output[at++] = sample / 32768;\n            }\n        }\n    }\n\n    return { channelData, sampleCount, sampleRate: metadata.sampleRate, channels };\n}\n\nfunction readS16(bytes, offset)\n{\n    const value = bytes[offset] | (bytes[offset + 1] << 8);\n    return value >= 0x8000 ? value - 0x10000 : value;\n}\n"],"names":["PTADPCM_TABLE","decodePtadpcm","bytes","metadata","channels","frameSize","Math","floor","blockAlign","Error","samplesPerFrame","frameGroups","dataBytes","sampleCount","channelData","channel","push","Float32Array","group","frame","dataOffset","output","at","hist2","readS16","hist1","index","min","i","byte","code","step","nextIndex","sample","sampleRate","offset","value"],"mappings":"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,CAAE,CAAE,EACtH,CAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAC9E,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,CAAE,EAClF,CAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAC9E,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,CAAE,EAClF,CAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAC9E,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,CAAE,EAClF,CAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAC9E,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE,CAAE,CACrF;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,aAAaA,CAACC,KAAK,EAAEC,QAAQ,EAC7C;AACI,EAAA,MAAMC,QAAQ,GAAGD,QAAQ,CAACC,QAAQ;AAClC,EAAA,MAAMC,SAAS,GAAGD,QAAQ,GAAG,CAAC,GAAGE,IAAI,CAACC,KAAK,CAACJ,QAAQ,CAACK,UAAU,GAAGJ,QAAQ,CAAC,GAAG,CAAC;AAC/E,EAAA,IAAIA,QAAQ,GAAG,CAAC,IAAIC,SAAS,GAAG,CAAC,IAAIF,QAAQ,CAACK,UAAU,KAAKH,SAAS,GAAGD,QAAQ,EACjF;IACI,MAAM,IAAIK,KAAK,CAAC,CAAA,0CAAA,EAA6CL,QAAQ,gBAAgBD,QAAQ,CAACK,UAAU,CAAA,CAAA,CAAG,CAAC;AAChH,EAAA;EAEA,MAAME,eAAe,GAAG,CAAC,GAAG,CAACL,SAAS,GAAG,CAAC,IAAI,CAAC;AAC/C,EAAA,MAAMM,WAAW,GAAGL,IAAI,CAACC,KAAK,CAACJ,QAAQ,CAACS,SAAS,GAAGT,QAAQ,CAACK,UAAU,CAAC;AACxE,EAAA,MAAMK,WAAW,GAAGF,WAAW,GAAGD,eAAe;EACjD,MAAMI,WAAW,GAAG,EAAE;EACtB,KAAK,IAAIC,OAAO,GAAG,CAAC,EAAEA,OAAO,GAAGX,QAAQ,EAAEW,OAAO,EAAE,EACnD;IACID,WAAW,CAACE,IAAI,CAAC,IAAIC,YAAY,CAACJ,WAAW,CAAC,CAAC;AACnD,EAAA;EAEA,KAAK,IAAIK,KAAK,GAAG,CAAC,EAAEA,KAAK,GAAGP,WAAW,EAAEO,KAAK,EAAE,EAChD;IACI,KAAK,IAAIH,OAAO,GAAG,CAAC,EAAEA,OAAO,GAAGX,QAAQ,EAAEW,OAAO,EAAE,EACnD;AACI,MAAA,MAAMI,KAAK,GAAGhB,QAAQ,CAACiB,UAAU,GAAG,CAACF,KAAK,GAAGd,QAAQ,GAAGW,OAAO,IAAIV,SAAS;AAC5E,MAAA,MAAMgB,MAAM,GAAGP,WAAW,CAACC,OAAO,CAAC;AACnC,MAAA,IAAIO,EAAE,GAAGJ,KAAK,GAAGR,eAAe;AAEhC,MAAA,IAAIa,KAAK,GAAGC,OAAO,CAACtB,KAAK,EAAEiB,KAAK,CAAC;MACjC,IAAIM,KAAK,GAAGD,OAAO,CAACtB,KAAK,EAAEiB,KAAK,GAAG,CAAC,CAAC;AACrC,MAAA,IAAIO,KAAK,GAAGpB,IAAI,CAACqB,GAAG,CAACzB,KAAK,CAACiB,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;AAE1CE,MAAAA,MAAM,CAACC,EAAE,EAAE,CAAC,GAAGC,KAAK,GAAG,KAAK;AAC5BF,MAAAA,MAAM,CAACC,EAAE,EAAE,CAAC,GAAGG,KAAK,GAAG,KAAK;AAE5B,MAAA,KAAK,IAAIG,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGlB,eAAe,GAAG,CAAC,EAAEkB,CAAC,EAAE,EAC5C;AACI,QAAA,MAAMC,IAAI,GAAG3B,KAAK,CAACiB,KAAK,GAAG,CAAC,IAAIS,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,QAAA,MAAME,IAAI,GAAG,CAACF,CAAC,GAAG,CAAC,MAAM,CAAC,GAAGC,IAAI,GAAG,IAAI,GAAGA,IAAI,IAAI,CAAC;AACpD,QAAA,MAAM,CAAEE,IAAI,EAAEC,SAAS,CAAE,GAAGhC,aAAa,CAAC0B,KAAK,CAAC,CAACI,IAAI,CAAC;QACtD,IAAIG,MAAM,GAAGF,IAAI,GAAG,CAAC,GAAGN,KAAK,GAAGF,KAAK;AACrC,QAAA,IAAIU,MAAM,GAAG,KAAK,EAAEA,MAAM,GAAG,KAAK,CAAC,KAC9B,IAAIA,MAAM,GAAG,MAAM,EAAEA,MAAM,GAAG,MAAM;AACzCP,QAAAA,KAAK,GAAGM,SAAS;AACjBT,QAAAA,KAAK,GAAGE,KAAK;AACbA,QAAAA,KAAK,GAAGQ,MAAM;AACdZ,QAAAA,MAAM,CAACC,EAAE,EAAE,CAAC,GAAGW,MAAM,GAAG,KAAK;AACjC,MAAA;AACJ,IAAA;AACJ,EAAA;EAEA,OAAO;IAAEnB,WAAW;IAAED,WAAW;IAAEqB,UAAU,EAAE/B,QAAQ,CAAC+B,UAAU;AAAE9B,IAAAA;GAAU;AAClF;AAEA,SAASoB,OAAOA,CAACtB,KAAK,EAAEiC,MAAM,EAC9B;AACI,EAAA,MAAMC,KAAK,GAAGlC,KAAK,CAACiC,MAAM,CAAC,GAAIjC,KAAK,CAACiC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAE;EACtD,OAAOC,KAAK,IAAI,MAAM,GAAGA,KAAK,GAAG,OAAO,GAAGA,KAAK;AACpD;;;;"}

package/dist/formats/wem/core/resolve.js

@@ -0,0 +1,121 @@
+import { inspectWithValues } from './helpers.js';
+
+// Content-verified codec resolution for wem media (kb §5 resolveType seam).
+// The fmt tag is the declaration; each candidate codec gets ONE bounded
+// structural check against the actual container facts - no audio is decoded:
+//
+// - wwise-vorbis: the Wwise Vorbis sidecar must exist (vorb chunk or inline
+//   fmt-0x42 layout) with a positive sample count and data payload;
+// - wwise-ptadpcm: the frame layout must satisfy the decoder's own guard
+//   (blockAlign = frameSize * channels, frameSize >= 6) with block-aligned
+//   data;
+// - pcm / pcm-extensible: 16-bit with self-consistent blockAlign/byteRate
+//   and sample-aligned data.
+//
+// The declared codec is validated FIRST; when its check fails (a mislabeled
+// tag), the other candidates are tried in order. A 2026-07-19 census of all
+// 8,987 embedded wems in EVE build 3435006 found no mislabeled tags, so
+// mismatch is the exceptional path - but the check is what makes that a
+// verified fact per file rather than a corpus-wide assumption.
+const CANDIDATES = ["wwise-vorbis", "wwise-ptadpcm", "pcm"];
+function validateVorbis(metadata) {
+  if (metadata.codec === "wwise-vorbis") {
+    return metadata.vorbis !== null && metadata.sampleCount > 0 && metadata.dataBytes > 0;
+  }
+  // Mislabeled tag: inspect() only fills `vorbis` when the tag says so, but
+  // the chunk walk always records a standalone vorb sidecar chunk.
+  return (metadata.chunks ?? []).some(chunk => chunk.id === "vorb") && metadata.dataBytes > 0;
+}
+function validatePtadpcm(metadata) {
+  const channels = metadata.channels;
+  const frameSize = channels > 0 ? Math.floor(metadata.blockAlign / channels) : 0;
+  return channels >= 1 && frameSize >= 6 && metadata.blockAlign === frameSize * channels && metadata.dataBytes >= metadata.blockAlign && metadata.dataBytes % metadata.blockAlign === 0;
+}
+function validatePcm(metadata) {
+  return metadata.bitsPerSample === 16 && metadata.channels >= 1 && metadata.blockAlign === metadata.channels * 2 && metadata.byteRate === metadata.sampleRate * metadata.blockAlign && metadata.dataBytes > 0 && metadata.dataBytes % metadata.blockAlign === 0;
+}
+function validate(candidate, metadata) {
+  if (candidate === "wwise-vorbis") return validateVorbis(metadata);
+  if (candidate === "wwise-ptadpcm") return validatePtadpcm(metadata);
+  return validatePcm(metadata);
+}
+function candidateFor(codec) {
+  if (codec === "pcm-extensible") return "pcm";
+  return CANDIDATES.includes(codec) ? codec : null;
+}
+function emitFor(candidate) {
+  if (candidate === "wwise-vorbis") return "ogg";
+  if (candidate === "wwise-ptadpcm" || candidate === "pcm") return "pcm";
+  return "raw";
+}
+
+/**
+ * Resolve a wem's actual decode route from content, not just its fmt tag.
+ *
+ * @param {*} input Wem bytes.
+ * @param {object} values Normalized read values.
+ * @returns {object} Probe-shaped report: verified variant flags, `preferred`
+ *   route, and declared/resolved/mismatch evidence in `metadata`.
+ */
+function resolveTypeWithValues(input, values) {
+  const metadata = inspectWithValues(input, values);
+  const declared = metadata.codec || null;
+  let resolved = null;
+  const declaredCandidate = candidateFor(declared);
+  if (declaredCandidate && validate(declaredCandidate, metadata)) {
+    resolved = declaredCandidate;
+  } else {
+    for (const candidate of CANDIDATES) {
+      if (candidate === declaredCandidate) continue;
+      if (validate(candidate, metadata)) {
+        resolved = candidate;
+        break;
+      }
+    }
+  }
+  const preferred = emitFor(resolved);
+  const mismatch = resolved !== null && declaredCandidate !== resolved;
+  return {
+    format: "wem",
+    source: values.source || "buffer",
+    supported: metadata.codec ? "partial" : "none",
+    confidence: resolved ? 1 : 0,
+    verified: true,
+    preferred,
+    reason: resolved ? mismatch ? `Declared codec ${declared} failed content validation; ${resolved} validated instead.` : `Declared codec validated by content.` : `No decodable codec validated against the content (declared ${declared ?? "none"}).`,
+    metadata: {
+      ...metadata,
+      declared,
+      resolved,
+      mismatch
+    },
+    variants: [{
+      kind: "raw",
+      payloadType: "raw",
+      codec: declared || "unknown",
+      mimeType: "application/octet-stream",
+      supported: true,
+      containerOnly: true,
+      isDecoded: false,
+      pcmDecodeSupported: false
+    }, {
+      kind: "ogg",
+      payloadType: "raw",
+      codec: "vorbis",
+      mimeType: "audio/ogg",
+      supported: resolved === "wwise-vorbis",
+      containerOnly: true,
+      isDecoded: false
+    }, {
+      kind: "pcm",
+      payloadType: "pcm",
+      codec: "float32",
+      supported: resolved === "wwise-ptadpcm" || resolved === "pcm",
+      isDecoded: true,
+      pcmDecodeSupported: resolved === "wwise-ptadpcm" || resolved === "pcm"
+    }]
+  };
+}
+
+export { resolveTypeWithValues };
+//# sourceMappingURL=resolve.js.map

package/dist/formats/wem/core/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sources":["../../../../../src/formats/wem/core/resolve.js"],"sourcesContent":["// Content-verified codec resolution for wem media (kb §5 resolveType seam).\n// The fmt tag is the declaration; each candidate codec gets ONE bounded\n// structural check against the actual container facts - no audio is decoded:\n//\n// - wwise-vorbis: the Wwise Vorbis sidecar must exist (vorb chunk or inline\n//   fmt-0x42 layout) with a positive sample count and data payload;\n// - wwise-ptadpcm: the frame layout must satisfy the decoder's own guard\n//   (blockAlign = frameSize * channels, frameSize >= 6) with block-aligned\n//   data;\n// - pcm / pcm-extensible: 16-bit with self-consistent blockAlign/byteRate\n//   and sample-aligned data.\n//\n// The declared codec is validated FIRST; when its check fails (a mislabeled\n// tag), the other candidates are tried in order. A 2026-07-19 census of all\n// 8,987 embedded wems in EVE build 3435006 found no mislabeled tags, so\n// mismatch is the exceptional path - but the check is what makes that a\n// verified fact per file rather than a corpus-wide assumption.\nimport { inspectWithValues } from \"./helpers.js\";\n\nconst CANDIDATES = [ \"wwise-vorbis\", \"wwise-ptadpcm\", \"pcm\" ];\n\nfunction validateVorbis(metadata)\n{\n    if (metadata.codec === \"wwise-vorbis\")\n    {\n        return metadata.vorbis !== null && metadata.sampleCount > 0 && metadata.dataBytes > 0;\n    }\n    // Mislabeled tag: inspect() only fills `vorbis` when the tag says so, but\n    // the chunk walk always records a standalone vorb sidecar chunk.\n    return (metadata.chunks ?? []).some(chunk => chunk.id === \"vorb\") && metadata.dataBytes > 0;\n}\n\nfunction validatePtadpcm(metadata)\n{\n    const channels = metadata.channels;\n    const frameSize = channels > 0 ? Math.floor(metadata.blockAlign / channels) : 0;\n    return channels >= 1\n        && frameSize >= 6\n        && metadata.blockAlign === frameSize * channels\n        && metadata.dataBytes >= metadata.blockAlign\n        && metadata.dataBytes % metadata.blockAlign === 0;\n}\n\nfunction validatePcm(metadata)\n{\n    return metadata.bitsPerSample === 16\n        && metadata.channels >= 1\n        && metadata.blockAlign === metadata.channels * 2\n        && metadata.byteRate === metadata.sampleRate * metadata.blockAlign\n        && metadata.dataBytes > 0\n        && metadata.dataBytes % metadata.blockAlign === 0;\n}\n\nfunction validate(candidate, metadata)\n{\n    if (candidate === \"wwise-vorbis\") return validateVorbis(metadata);\n    if (candidate === \"wwise-ptadpcm\") return validatePtadpcm(metadata);\n    return validatePcm(metadata);\n}\n\nfunction candidateFor(codec)\n{\n    if (codec === \"pcm-extensible\") return \"pcm\";\n    return CANDIDATES.includes(codec) ? codec : null;\n}\n\nfunction emitFor(candidate)\n{\n    if (candidate === \"wwise-vorbis\") return \"ogg\";\n    if (candidate === \"wwise-ptadpcm\" || candidate === \"pcm\") return \"pcm\";\n    return \"raw\";\n}\n\n/**\n * Resolve a wem's actual decode route from content, not just its fmt tag.\n *\n * @param {*} input Wem bytes.\n * @param {object} values Normalized read values.\n * @returns {object} Probe-shaped report: verified variant flags, `preferred`\n *   route, and declared/resolved/mismatch evidence in `metadata`.\n */\nexport function resolveTypeWithValues(input, values)\n{\n    const metadata = inspectWithValues(input, values);\n    const declared = metadata.codec || null;\n    let resolved = null;\n    const declaredCandidate = candidateFor(declared);\n    if (declaredCandidate && validate(declaredCandidate, metadata))\n    {\n        resolved = declaredCandidate;\n    }\n    else\n    {\n        for (const candidate of CANDIDATES)\n        {\n            if (candidate === declaredCandidate) continue;\n            if (validate(candidate, metadata))\n            {\n                resolved = candidate;\n                break;\n            }\n        }\n    }\n\n    const preferred = emitFor(resolved);\n    const mismatch = resolved !== null && declaredCandidate !== resolved;\n    return {\n        format: \"wem\",\n        source: values.source || \"buffer\",\n        supported: metadata.codec ? \"partial\" : \"none\",\n        confidence: resolved ? 1 : 0,\n        verified: true,\n        preferred,\n        reason: resolved\n            ? (mismatch\n                ? `Declared codec ${declared} failed content validation; ${resolved} validated instead.`\n                : `Declared codec validated by content.`)\n            : `No decodable codec validated against the content (declared ${declared ?? \"none\"}).`,\n        metadata: { ...metadata, declared, resolved, mismatch },\n        variants: [\n            {\n                kind: \"raw\",\n                payloadType: \"raw\",\n                codec: declared || \"unknown\",\n                mimeType: \"application/octet-stream\",\n                supported: true,\n                containerOnly: true,\n                isDecoded: false,\n                pcmDecodeSupported: false\n            },\n            {\n                kind: \"ogg\",\n                payloadType: \"raw\",\n                codec: \"vorbis\",\n                mimeType: \"audio/ogg\",\n                supported: resolved === \"wwise-vorbis\",\n                containerOnly: true,\n                isDecoded: false\n            },\n            {\n                kind: \"pcm\",\n                payloadType: \"pcm\",\n                codec: \"float32\",\n                supported: resolved === \"wwise-ptadpcm\" || resolved === \"pcm\",\n                isDecoded: true,\n                pcmDecodeSupported: resolved === \"wwise-ptadpcm\" || resolved === \"pcm\"\n            }\n        ]\n    };\n}\n"],"names":["CANDIDATES","validateVorbis","metadata","codec","vorbis","sampleCount","dataBytes","chunks","some","chunk","id","validatePtadpcm","channels","frameSize","Math","floor","blockAlign","validatePcm","bitsPerSample","byteRate","sampleRate","validate","candidate","candidateFor","includes","emitFor","resolveTypeWithValues","input","values","inspectWithValues","declared","resolved","declaredCandidate","preferred","mismatch","format","source","supported","confidence","verified","reason","variants","kind","payloadType","mimeType","containerOnly","isDecoded","pcmDecodeSupported"],"mappings":"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"}