@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (541) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +32 -32
  3. package/README.md +129 -108
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3858 -3494
  6. package/dist/CjsResMan.js.map +1 -1
  7. package/dist/CjsResManFetchProvider.js +94 -94
  8. package/dist/CjsResManWorkQueue.js +301 -301
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +150 -150
  10. package/dist/format/CjsBlueReader.js +358 -358
  11. package/dist/format/CjsByteReader.js +310 -310
  12. package/dist/format/CjsByteWriter.js +242 -242
  13. package/dist/format/CjsFormat.js +223 -223
  14. package/dist/format/CjsFormatError.js +41 -41
  15. package/dist/format/CjsReader.js +22 -22
  16. package/dist/format/CjsResourceProbe.js +279 -279
  17. package/dist/format/CjsStringTable.js +268 -268
  18. package/dist/format/carbonEffect/CjsCarbonEffectReader.js +408 -361
  19. package/dist/format/carbonEffect/CjsCarbonEffectReader.js.map +1 -1
  20. package/dist/format/carbonEffect/CjsCarbonEffectWriter.js +373 -373
  21. package/dist/format/carbonEffect/buildCarbonEffectContainer.js +182 -0
  22. package/dist/format/carbonEffect/buildCarbonEffectContainer.js.map +1 -0
  23. package/dist/format/carbonEffect/carbonEffectBackendBlock.js +321 -427
  24. package/dist/format/carbonEffect/carbonEffectBackendBlock.js.map +1 -1
  25. package/dist/format/carbonEffect/carbonEffectRecords.js +1147 -955
  26. package/dist/format/carbonEffect/carbonEffectRecords.js.map +1 -1
  27. package/dist/format/carbonEffect/carbonEffectResourceTransform.js +197 -0
  28. package/dist/format/carbonEffect/carbonEffectResourceTransform.js.map +1 -0
  29. package/dist/format/compareUtf8.js +36 -36
  30. package/dist/format/effect/effectBodyInventory.js +146 -0
  31. package/dist/format/effect/effectBodyInventory.js.map +1 -0
  32. package/dist/format/effect/effectPermutationGraph.js +257 -257
  33. package/dist/format/effect/effectPermutationGraph.js.map +1 -1
  34. package/dist/format/effect/sha256.js +114 -114
  35. package/dist/format/index.js +11 -11
  36. package/dist/format/payloadContract.js +193 -193
  37. package/dist/formats/black/CjsBlackFormat.js +310 -292
  38. package/dist/formats/black/CjsBlackFormat.js.map +1 -1
  39. package/dist/formats/black/core/CjsBlackBinaryReader.js +260 -260
  40. package/dist/formats/black/core/CjsBlackPropertyReaders.js +448 -448
  41. package/dist/formats/black/core/CjsBlackReader.js +764 -764
  42. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +540 -540
  43. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -4
  44. package/dist/formats/black/core/blackConstants.js +7 -7
  45. package/dist/formats/black/core/blackDefinitions.js +10 -10
  46. package/dist/formats/black/core/blackEnums.js +6 -6
  47. package/dist/formats/black/core/blackSchema.js +3 -3
  48. package/dist/formats/black/core/blackVersion.js +22 -22
  49. package/dist/formats/black/core/helpers.js +199 -199
  50. package/dist/formats/black/core/schema.js +4 -4
  51. package/dist/formats/black/index.js +2 -2
  52. package/dist/formats/bnk/CjsBnkFormat.js +175 -156
  53. package/dist/formats/bnk/CjsBnkFormat.js.map +1 -1
  54. package/dist/formats/bnk/core/busNodes.js +252 -0
  55. package/dist/formats/bnk/core/busNodes.js.map +1 -0
  56. package/dist/formats/bnk/core/effectNodes.js +147 -0
  57. package/dist/formats/bnk/core/effectNodes.js.map +1 -0
  58. package/dist/formats/bnk/core/eventAction.js +416 -305
  59. package/dist/formats/bnk/core/eventAction.js.map +1 -1
  60. package/dist/formats/bnk/core/globalSettings.js +215 -0
  61. package/dist/formats/bnk/core/globalSettings.js.map +1 -0
  62. package/dist/formats/bnk/core/graph.js +137 -137
  63. package/dist/formats/bnk/core/helpers.js +512 -480
  64. package/dist/formats/bnk/core/helpers.js.map +1 -1
  65. package/dist/formats/bnk/core/musicNodes.js +533 -509
  66. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  67. package/dist/formats/bnk/core/nodeBase.js +553 -532
  68. package/dist/formats/bnk/core/nodeBase.js.map +1 -1
  69. package/dist/formats/bnk/core/sfxNodes.js +632 -632
  70. package/dist/formats/bnk/core/soundbanksInfo.js +209 -209
  71. package/dist/formats/bnk/index.js +2 -2
  72. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  73. package/dist/formats/cmf/core/binary.js +194 -194
  74. package/dist/formats/cmf/core/buffers.js +237 -237
  75. package/dist/formats/cmf/core/constants.js +47 -47
  76. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  77. package/dist/formats/cmf/core/helpers.js +318 -318
  78. package/dist/formats/cmf/core/pack.js +276 -276
  79. package/dist/formats/cmf/core/schema.js +374 -374
  80. package/dist/formats/cmf/core/shared.js +277 -277
  81. package/dist/formats/cmf/core/writer.js +571 -571
  82. package/dist/formats/cmf/index.js +2 -2
  83. package/dist/formats/dds/CjsDdsFormat.js +200 -200
  84. package/dist/formats/dds/core/bc6h.js +298 -298
  85. package/dist/formats/dds/core/bc7.js +272 -272
  86. package/dist/formats/dds/core/helpers.js +862 -862
  87. package/dist/formats/dds/index.js +2 -2
  88. package/dist/formats/dxbc/CjsDxbcFormat.js +142 -142
  89. package/dist/formats/dxbc/core/DxbcReader.js +266 -266
  90. package/dist/formats/dxbc/core/container.js +169 -169
  91. package/dist/formats/dxbc/core/decoder.js +789 -789
  92. package/dist/formats/dxbc/core/errors.js +19 -19
  93. package/dist/formats/dxbc/core/helpers.js +220 -220
  94. package/dist/formats/dxbc/core/opcodes.js +45 -45
  95. package/dist/formats/dxbc/core/program.js +91 -91
  96. package/dist/formats/dxbc/core/signature.js +172 -172
  97. package/dist/formats/dxbc/index.js +2 -2
  98. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  99. package/dist/formats/fbx/core/helpers.js +3932 -3932
  100. package/dist/formats/fbx/index.js +2 -2
  101. package/dist/formats/flac/CjsFlacFormat.js +142 -142
  102. package/dist/formats/flac/core/helpers.js +315 -315
  103. package/dist/formats/flac/index.js +2 -2
  104. package/dist/formats/gif/CjsGifFormat.js +141 -141
  105. package/dist/formats/gif/core/helpers.js +380 -380
  106. package/dist/formats/gif/index.js +2 -2
  107. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  108. package/dist/formats/gltf/core/helpers.js +307 -307
  109. package/dist/formats/gltf/core/json.js +79 -79
  110. package/dist/formats/gltf/core/parser.js +679 -679
  111. package/dist/formats/gltf/core/targets.js +173 -173
  112. package/dist/formats/gltf/index.js +2 -2
  113. package/dist/formats/gr2/CjsGr2Format.js +289 -289
  114. package/dist/formats/gr2/core/bitknit2.js +282 -282
  115. package/dist/formats/gr2/core/curves.js +1047 -1047
  116. package/dist/formats/gr2/core/gsf.js +72 -72
  117. package/dist/formats/gr2/core/helpers.js +352 -352
  118. package/dist/formats/gr2/core/json.js +622 -622
  119. package/dist/formats/gr2/core/oodle1.js +388 -388
  120. package/dist/formats/gr2/core/tangents.js +48 -48
  121. package/dist/formats/gr2/core/targets.js +361 -361
  122. package/dist/formats/gr2/index.js +2 -2
  123. package/dist/formats/hlsl/CjsHlslFormat.js +254 -254
  124. package/dist/formats/hlsl/core/HlslBinaryUtils.js +15 -15
  125. package/dist/formats/hlsl/core/HlslEffectReadError.js +19 -19
  126. package/dist/formats/hlsl/core/HlslEffectStateManager.js +130 -130
  127. package/dist/formats/hlsl/core/HlslRenderStateSetup.js +37 -37
  128. package/dist/formats/hlsl/core/HlslResourceSetDescription.js +94 -94
  129. package/dist/formats/hlsl/core/HlslShaderBytecode.js +44 -44
  130. package/dist/formats/hlsl/core/analysis.js +51 -51
  131. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js +850 -781
  132. package/dist/formats/hlsl/core/carbonDescriptionToRuntime.js.map +1 -1
  133. package/dist/formats/hlsl/core/detailMapFamily.js +128 -0
  134. package/dist/formats/hlsl/core/detailMapFamily.js.map +1 -0
  135. package/dist/formats/hlsl/core/helpers.js +270 -270
  136. package/dist/formats/hlsl/core/json.js +284 -284
  137. package/dist/formats/hlsl/core/localLightFamily.js +133 -0
  138. package/dist/formats/hlsl/core/localLightFamily.js.map +1 -0
  139. package/dist/formats/hlsl/core/metadata.js +327 -327
  140. package/dist/formats/hlsl/core/render-states.js +280 -280
  141. package/dist/formats/hlsl/core/tr2/HlslRenderContextEnum.js +43 -43
  142. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js +320 -314
  143. package/dist/formats/hlsl/core/tr2/resources/HlslEffectRes.js.map +1 -1
  144. package/dist/formats/hlsl/core/tr2/resources/HlslShaderPermutation.js +33 -33
  145. package/dist/formats/hlsl/core/tr2/shader/HlslEffectBindingManifest.js +416 -416
  146. package/dist/formats/hlsl/core/tr2/shader/HlslEffectConstant.js +40 -40
  147. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js +62 -742
  148. package/dist/formats/hlsl/core/tr2/shader/HlslEffectDescription.js.map +1 -1
  149. package/dist/formats/hlsl/core/tr2/shader/HlslEffectLibrary.js +52 -52
  150. package/dist/formats/hlsl/core/tr2/shader/HlslEffectParameterAnnotation.js +38 -38
  151. package/dist/formats/hlsl/core/tr2/shader/HlslEffectResource.js +50 -50
  152. package/dist/formats/hlsl/core/tr2/shader/HlslEffectStageInput.js +86 -86
  153. package/dist/formats/hlsl/core/tr2/shader/HlslEffectTechnique.js +31 -31
  154. package/dist/formats/hlsl/core/tr2/shader/HlslPass.js +42 -42
  155. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerDescription.js +55 -55
  156. package/dist/formats/hlsl/core/tr2/shader/HlslSamplerSetup.js +29 -29
  157. package/dist/formats/hlsl/core/tr2/shader/HlslShader.js +220 -220
  158. package/dist/formats/hlsl/core/tr2/shader/HlslShaderOption.js +30 -30
  159. package/dist/formats/hlsl/index.js +3 -3
  160. package/dist/formats/index.js +33 -31
  161. package/dist/formats/index.js.map +1 -1
  162. package/dist/formats/jpeg/CjsJpegFormat.js +212 -212
  163. package/dist/formats/jpeg/core/helpers.js +402 -402
  164. package/dist/formats/jpeg/core/jpeg.js +480 -480
  165. package/dist/formats/jpeg/index.js +2 -2
  166. package/dist/formats/mp3/CjsMp3Format.js +197 -197
  167. package/dist/formats/mp3/core/helpers.js +375 -375
  168. package/dist/formats/mp3/index.js +2 -2
  169. package/dist/formats/mp4/CjsMp4Format.js +197 -197
  170. package/dist/formats/mp4/core/helpers.js +484 -484
  171. package/dist/formats/mp4/index.js +2 -2
  172. package/dist/formats/obj/CjsObjFormat.js +253 -253
  173. package/dist/formats/obj/core/helpers.js +573 -573
  174. package/dist/formats/obj/core/json.js +64 -64
  175. package/dist/formats/obj/core/parser.js +321 -321
  176. package/dist/formats/obj/index.js +2 -2
  177. package/dist/formats/ogg/CjsOggFormat.js +143 -143
  178. package/dist/formats/ogg/core/helpers.js +410 -410
  179. package/dist/formats/ogg/core/imdct.js +178 -178
  180. package/dist/formats/ogg/core/vorbis.js +1017 -1017
  181. package/dist/formats/ogg/index.js +2 -2
  182. package/dist/formats/pickle/CjsPickleFormat.js +214 -0
  183. package/dist/formats/pickle/CjsPickleFormat.js.map +1 -0
  184. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js +551 -0
  185. package/dist/formats/pickle/core/CjsPickleProtocol0Reader.js.map +1 -0
  186. package/dist/formats/pickle/index.js +2 -0
  187. package/dist/formats/pickle/index.js.map +1 -0
  188. package/dist/formats/png/CjsPngFormat.js +201 -201
  189. package/dist/formats/png/core/helpers.js +635 -635
  190. package/dist/formats/png/index.js +2 -2
  191. package/dist/formats/red/CjsRedFormat.js +263 -263
  192. package/dist/formats/red/core/CjsRedReader.js +246 -246
  193. package/dist/formats/red/core/blackDefinitions.js +3 -3
  194. package/dist/formats/red/core/helpers.js +158 -158
  195. package/dist/formats/red/core/redGraph.js +71 -68
  196. package/dist/formats/red/core/redGraph.js.map +1 -1
  197. package/dist/formats/red/core/schema.js +4 -4
  198. package/dist/formats/red/index.js +2 -2
  199. package/dist/formats/stl/CjsStlFormat.js +365 -365
  200. package/dist/formats/stl/core/helpers.js +261 -261
  201. package/dist/formats/stl/core/json.js +51 -51
  202. package/dist/formats/stl/core/stl.js +642 -642
  203. package/dist/formats/stl/core/targets.js +173 -173
  204. package/dist/formats/stl/index.js +2 -2
  205. package/dist/formats/tga/CjsTgaFormat.js +197 -197
  206. package/dist/formats/tga/core/helpers.js +493 -493
  207. package/dist/formats/tga/index.js +2 -2
  208. package/dist/formats/wav/CjsWavFormat.js +198 -198
  209. package/dist/formats/wav/core/helpers.js +365 -365
  210. package/dist/formats/wav/index.js +2 -2
  211. package/dist/formats/webgl/CjsWebglFormat.js +199 -221
  212. package/dist/formats/webgl/CjsWebglFormat.js.map +1 -1
  213. package/dist/formats/webgl/core/buildGlslEffectContainer.js +70 -0
  214. package/dist/formats/webgl/core/buildGlslEffectContainer.js.map +1 -0
  215. package/dist/formats/webgl/core/effectPackage.js +900 -792
  216. package/dist/formats/webgl/core/effectPackage.js.map +1 -1
  217. package/dist/formats/webgl/core/errors.js +27 -27
  218. package/dist/formats/webgl/core/errors.js.map +1 -1
  219. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js +2820 -2678
  220. package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js.map +1 -1
  221. package/dist/formats/webgl/core/glsl/DxbcGlslHelpers.js +89 -89
  222. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js +486 -428
  223. package/dist/formats/webgl/core/glsl/DxbcGlslOperandFormatter.js.map +1 -1
  224. package/dist/formats/webgl/core/glsl/packedLightFixups.js +98 -0
  225. package/dist/formats/webgl/core/glsl/packedLightFixups.js.map +1 -0
  226. package/dist/formats/webgl/core/glslBackendBlock.js +552 -0
  227. package/dist/formats/webgl/core/glslBackendBlock.js.map +1 -0
  228. package/dist/formats/webgl/core/glslBackendBodySet.js +243 -0
  229. package/dist/formats/webgl/core/glslBackendBodySet.js.map +1 -0
  230. package/dist/formats/webgl/core/{cewgCompleteness.js → glslEffectCompleteness.js} +85 -81
  231. package/dist/formats/webgl/core/glslEffectCompleteness.js.map +1 -0
  232. package/dist/formats/webgl/core/helpers.js +167 -306
  233. package/dist/formats/webgl/core/helpers.js.map +1 -1
  234. package/dist/formats/webgl/core/inspectGlslEffectContainer.js +122 -0
  235. package/dist/formats/webgl/core/inspectGlslEffectContainer.js.map +1 -0
  236. package/dist/formats/webgl/core/readGlslEffectContainer.js +303 -0
  237. package/dist/formats/webgl/core/readGlslEffectContainer.js.map +1 -0
  238. package/dist/formats/webgl/index.js +2 -2
  239. package/dist/formats/webgpu/CjsWebgpuFormat.js +357 -357
  240. package/dist/formats/webgpu/CjsWebgpuFormat.js.map +1 -1
  241. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js +89 -197
  242. package/dist/formats/webgpu/core/buildCarbonEffectContainer.js.map +1 -1
  243. package/dist/formats/webgpu/core/{cewgpu/CewgpuContainer.js → carbonWebgpu/CarbonWebgpuContainer.js} +354 -368
  244. package/dist/formats/webgpu/core/carbonWebgpu/CarbonWebgpuContainer.js.map +1 -0
  245. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/containerViews.js +355 -355
  246. package/dist/formats/webgpu/core/carbonWebgpu/containerViews.js.map +1 -0
  247. package/dist/formats/webgpu/core/{cewgpu → carbonWebgpu}/validateContainer.js +90 -90
  248. package/dist/formats/webgpu/core/carbonWebgpu/validateContainer.js.map +1 -0
  249. package/dist/formats/webgpu/core/effectAnalysis.js +82 -82
  250. package/dist/formats/webgpu/core/effectBackendBodySet.js +289 -289
  251. package/dist/formats/webgpu/core/effectBackendBodySet.js.map +1 -1
  252. package/dist/formats/webgpu/core/errors.js +20 -20
  253. package/dist/formats/webgpu/core/errors.js.map +1 -1
  254. package/dist/formats/webgpu/core/helpers.js +443 -443
  255. package/dist/formats/webgpu/core/helpers.js.map +1 -1
  256. package/dist/formats/webgpu/core/ir/analyzeRegisterValues.js +212 -212
  257. package/dist/formats/webgpu/core/ir/buildControlFlow.js +220 -220
  258. package/dist/formats/webgpu/core/ir/indexableTemps.js +137 -137
  259. package/dist/formats/webgpu/core/ir/inferValueTypes.js +449 -449
  260. package/dist/formats/webgpu/core/ir/lowerDxbcToIr.js +494 -494
  261. package/dist/formats/webgpu/core/ir/resolveRegisterFlow.js +177 -177
  262. package/dist/formats/webgpu/core/ir/sourceLanes.js +61 -61
  263. package/dist/formats/webgpu/core/packageEffect.js +381 -385
  264. package/dist/formats/webgpu/core/packageEffect.js.map +1 -1
  265. package/dist/formats/webgpu/core/packageEffectSelection.js +164 -164
  266. package/dist/formats/webgpu/core/packageEffectSelection.js.map +1 -1
  267. package/dist/formats/webgpu/core/packageMetadata.js +17 -17
  268. package/dist/formats/webgpu/core/schema.js +4 -4
  269. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js +263 -263
  270. package/dist/formats/webgpu/core/wgsl/buildResourceTransformPlan.js.map +1 -1
  271. package/dist/formats/webgpu/core/wgsl/buildWgslBindingPlan.js +172 -172
  272. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js +320 -320
  273. package/dist/formats/webgpu/core/wgsl/buildWgslSet.js.map +1 -1
  274. package/dist/formats/webgpu/core/wgsl/emitWgsl.js +356 -356
  275. package/dist/formats/webgpu/core/wgsl/hoistEscapingValues.js +77 -77
  276. package/dist/formats/webgpu/core/wgsl/lowerBindingLayout.js +451 -451
  277. package/dist/formats/webgpu/core/wgsl/lowerComputeProgram.js +735 -735
  278. package/dist/formats/webgpu/core/wgsl/lowerCreateHistogramsComputeProgram.js +457 -457
  279. package/dist/formats/webgpu/core/wgsl/lowerFragmentProgram.js +1572 -1572
  280. package/dist/formats/webgpu/core/wgsl/lowerMergeHistogramsComputeProgram.js +659 -659
  281. package/dist/formats/webgpu/core/wgsl/lowerParticleClearComputePrograms.js +734 -734
  282. package/dist/formats/webgpu/core/wgsl/lowerParticleEmitComputeProgram.js +583 -583
  283. package/dist/formats/webgpu/core/wgsl/lowerSkinVerticesComputeProgram.js +621 -621
  284. package/dist/formats/webgpu/core/wgsl/lowerSortComputeProgram.js +824 -824
  285. package/dist/formats/webgpu/core/wgsl/lowerSortInnerComputeProgram.js +697 -697
  286. package/dist/formats/webgpu/core/wgsl/lowerSortStepComputeProgram.js +559 -559
  287. package/dist/formats/webgpu/core/wgsl/lowerVertexProgram.js +1328 -1328
  288. package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js +110 -110
  289. package/dist/formats/webgpu/core/wgsl/precisionControls.js +55 -55
  290. package/dist/formats/webgpu/core/wgsl/selectionPlans.js +717 -717
  291. package/dist/formats/webgpu/core/wgsl/uniformity.js +78 -78
  292. package/dist/formats/webgpu/core/wgsl/validateExactComputeIr.js +196 -196
  293. package/dist/formats/webgpu/core/wgsl/validateHandleOperand.js +37 -37
  294. package/dist/formats/webgpu/index.js +2 -2
  295. package/dist/formats/webm/CjsWebmFormat.js +197 -197
  296. package/dist/formats/webm/core/helpers.js +572 -572
  297. package/dist/formats/webm/index.js +2 -2
  298. package/dist/formats/webp/CjsWebpFormat.js +140 -140
  299. package/dist/formats/webp/core/helpers.js +237 -237
  300. package/dist/formats/webp/index.js +2 -2
  301. package/dist/formats/wem/CjsWemFormat.js +250 -250
  302. package/dist/formats/wem/core/bitStream.js +261 -261
  303. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  304. package/dist/formats/wem/core/helpers.js +437 -437
  305. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  306. package/dist/formats/wem/core/ptadpcm.js +77 -77
  307. package/dist/formats/wem/core/resolve.js +121 -121
  308. package/dist/formats/wem/core/wemToOgg.js +485 -485
  309. package/dist/formats/wem/index.js +2 -2
  310. package/dist/formats/yaml/CjsYamlFormat.js +134 -134
  311. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  312. package/dist/formats/yaml/core/CjsYamlReader.js +400 -402
  313. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  314. package/dist/formats/yaml/core/helpers.js +196 -170
  315. package/dist/formats/yaml/core/helpers.js.map +1 -1
  316. package/dist/formats/yaml/index.js +2 -2
  317. package/dist/index.js +64 -62
  318. package/dist/index.js.map +1 -1
  319. package/dist/resource/CjsLoadingObject.js +19 -0
  320. package/dist/resource/CjsLoadingObject.js.map +1 -0
  321. package/dist/resource/CjsResource.js +801 -797
  322. package/dist/resource/CjsResource.js.map +1 -1
  323. package/dist/resource/ResourceHandlerMode.js +14 -0
  324. package/dist/resource/ResourceHandlerMode.js.map +1 -0
  325. package/dist/resource/Tr2LightProfileRes.js +32 -32
  326. package/dist/resource/audio/AudioGeometryResData.js +47 -47
  327. package/dist/resource/audio/CjsAudioBufferRes.js +86 -86
  328. package/dist/resource/audio/CjsAudioRes.js +213 -213
  329. package/dist/resource/audio/index.js +4 -4
  330. package/dist/resource/geometry/MeshDecalData.js +37 -37
  331. package/dist/resource/geometry/MeshDecalLodData.js +34 -34
  332. package/dist/resource/geometry/TriGeometryRes.js +675 -675
  333. package/dist/resource/geometry/TriGeometryResAreaData.js +59 -59
  334. package/dist/resource/geometry/TriGeometryResJointData.js +38 -38
  335. package/dist/resource/geometry/TriGeometryResLodData.js +88 -88
  336. package/dist/resource/geometry/TriGeometryResMeshData.js +63 -63
  337. package/dist/resource/geometry/TriGeometryResSkeletonData.js +34 -34
  338. package/dist/resource/geometry/TriJointBinding.js +38 -38
  339. package/dist/resource/geometry/TriMorphTargetGeometryConstants.js +46 -46
  340. package/dist/resource/geometry/TriRtGeometryConstants.js +88 -88
  341. package/dist/resource/geometry/granny/GStateBindingCallbackData.js +31 -31
  342. package/dist/resource/geometry/granny/Tr2GrannyIntersectionResult.js +60 -60
  343. package/dist/resource/geometry/granny/Tr2GrannyStateRes.js +36 -36
  344. package/dist/resource/geometry/granny/TriGrannyRes.js +35 -35
  345. package/dist/resource/geometry/granny/enums.js +10 -10
  346. package/dist/resource/geometry/granny/index.js +6 -6
  347. package/dist/resource/geometry/index.js +17 -17
  348. package/dist/resource/index.js +54 -52
  349. package/dist/resource/index.js.map +1 -1
  350. package/dist/resource/resourceBoundary.js +64 -64
  351. package/dist/resource/shader/Tr2EffectRes.js +336 -431
  352. package/dist/resource/shader/Tr2EffectRes.js.map +1 -1
  353. package/dist/resource/shader/Tr2MaterialArea.js +31 -31
  354. package/dist/resource/shader/Tr2MaterialMesh.js +27 -27
  355. package/dist/resource/shader/Tr2MaterialRes.js +31 -31
  356. package/dist/resource/shader/Tr2Shader.js +283 -261
  357. package/dist/resource/shader/Tr2Shader.js.map +1 -1
  358. package/dist/resource/shader/Tr2ShaderPermutation.js +43 -43
  359. package/dist/resource/shader/index.js +17 -17
  360. package/dist/resource/shader/reflection/Tr2EffectConstant.js +143 -135
  361. package/dist/resource/shader/reflection/Tr2EffectConstant.js.map +1 -1
  362. package/dist/resource/shader/reflection/Tr2EffectDefine.js +30 -30
  363. package/dist/resource/shader/reflection/Tr2EffectDescription.js +114 -109
  364. package/dist/resource/shader/reflection/Tr2EffectDescription.js.map +1 -1
  365. package/dist/resource/shader/reflection/Tr2EffectLibrary.js +168 -147
  366. package/dist/resource/shader/reflection/Tr2EffectLibrary.js.map +1 -1
  367. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js +125 -105
  368. package/dist/resource/shader/reflection/Tr2EffectParameterAnnotation.js.map +1 -1
  369. package/dist/resource/shader/reflection/Tr2EffectResource.js +120 -86
  370. package/dist/resource/shader/reflection/Tr2EffectResource.js.map +1 -1
  371. package/dist/resource/shader/reflection/Tr2EffectStageInput.js +372 -241
  372. package/dist/resource/shader/reflection/Tr2EffectStageInput.js.map +1 -1
  373. package/dist/resource/shader/reflection/Tr2EffectTechnique.js +78 -68
  374. package/dist/resource/shader/reflection/Tr2EffectTechnique.js.map +1 -1
  375. package/dist/resource/shader/reflection/Tr2Pass.js +168 -111
  376. package/dist/resource/shader/reflection/Tr2Pass.js.map +1 -1
  377. package/dist/resource/shader/reflection/carbonRecordFields.js +159 -0
  378. package/dist/resource/shader/reflection/carbonRecordFields.js.map +1 -0
  379. package/dist/resource/shader/reflection/shaderStage.js +22 -0
  380. package/dist/resource/shader/reflection/shaderStage.js.map +1 -0
  381. package/dist/resource/shader/sampler/Tr2SamplerSetup.js +135 -77
  382. package/dist/resource/shader/sampler/Tr2SamplerSetup.js.map +1 -1
  383. package/dist/resource/texture/CjsTextureArrayRes.js +472 -472
  384. package/dist/resource/texture/CjsTextureArrayResParameterProxy.js +179 -179
  385. package/dist/resource/texture/Tr2ImageRes.js +120 -120
  386. package/dist/resource/texture/Tr2TextureLodManager.js +82 -82
  387. package/dist/resource/texture/Tr2TextureLodUpdateRequest.js +37 -37
  388. package/dist/resource/texture/Tr2TexturePackChannel.js +37 -37
  389. package/dist/resource/texture/Tr2TexturePipeline.js +54 -54
  390. package/dist/resource/texture/Tr2TexturePipelineParams.js +34 -34
  391. package/dist/resource/texture/Tr2TexturePipelineStepCompress.js +40 -40
  392. package/dist/resource/texture/Tr2TexturePipelineStepGenerateMips.js +22 -22
  393. package/dist/resource/texture/Tr2TexturePipelineStepLimitSize.js +34 -34
  394. package/dist/resource/texture/Tr2TexturePipelineStepLoad.js +31 -31
  395. package/dist/resource/texture/Tr2TexturePipelineStepPack.js +43 -43
  396. package/dist/resource/texture/TriTextureRes.js +359 -359
  397. package/dist/resource/texture/index.js +15 -15
  398. package/dist/resource/texture/texturePipelineBehavior.js +308 -308
  399. package/dist/worker/CjsResManMainThreadLoader.js +89 -87
  400. package/dist/worker/CjsResManMainThreadLoader.js.map +1 -1
  401. package/dist/worker/CjsResManWorker.js +218 -217
  402. package/dist/worker/CjsResManWorker.js.map +1 -1
  403. package/dist/worker/CjsResManWorkerLoader.js +437 -434
  404. package/dist/worker/CjsResManWorkerLoader.js.map +1 -1
  405. package/dist/worker/protocol.js +12 -12
  406. package/docs/README.md +98 -98
  407. package/docs/architecture.md +118 -109
  408. package/docs/concepts/resource-lifecycle.md +226 -225
  409. package/docs/concepts/shader-resource-model.md +111 -114
  410. package/docs/concepts/writing-an-engine-adapter.md +115 -115
  411. package/docs/formats/README.md +138 -136
  412. package/docs/formats/carbon-effect-container.md +553 -452
  413. package/docs/formats/dxbc/README.md +68 -68
  414. package/docs/formats/dxbc/architecture.md +80 -80
  415. package/docs/formats/dxbc/reference/api.md +77 -77
  416. package/docs/formats/dxbc/reference/classes/README.md +9 -9
  417. package/docs/formats/dxbc/reference/decoded-output.md +122 -122
  418. package/docs/formats/gr2.md +160 -160
  419. package/docs/formats/hlsl/README.md +54 -54
  420. package/docs/formats/hlsl/architecture.md +65 -67
  421. package/docs/formats/hlsl/guides/hydrating-json-output.md +60 -62
  422. package/docs/formats/hlsl/guides/reading-effects.md +64 -64
  423. package/docs/formats/hlsl/reference/advanced-analysis.md +61 -66
  424. package/docs/formats/hlsl/reference/api.md +92 -98
  425. package/docs/formats/hlsl/reference/classes/README.md +11 -11
  426. package/docs/formats/hlsl/reference/json-graph.md +97 -100
  427. package/docs/formats/pickle.md +82 -0
  428. package/docs/formats/provenance.md +196 -196
  429. package/docs/formats/stl.md +37 -37
  430. package/docs/formats/webgl/README.md +115 -57
  431. package/docs/formats/webgl/architecture.md +69 -70
  432. package/docs/formats/webgl/carbon-constant-layouts.md +326 -326
  433. package/docs/formats/webgl/decl-io.md +1234 -1234
  434. package/docs/formats/webgl/memory-structured.md +890 -871
  435. package/docs/formats/webgl/reference/classes/README.md +9 -9
  436. package/docs/formats/webgl/texture-sample.md +964 -964
  437. package/docs/formats/webgpu/README.md +84 -84
  438. package/docs/formats/webgpu/architecture.md +95 -96
  439. package/docs/formats/webgpu/formats/{cewgpu.md → carbon-webgpu.md} +215 -216
  440. package/docs/formats/webgpu/guides/effect-packaging.md +189 -191
  441. package/docs/formats/webgpu/reference/api.md +196 -197
  442. package/docs/formats/webgpu/reference/classes/README.md +9 -9
  443. package/docs/formats/webgpu/reference/wgsl-compatibility.md +1546 -1543
  444. package/docs/formats/wwise.md +146 -85
  445. package/docs/reference/classes/README.md +35 -35
  446. package/docs/reference/classes/audio.md +30 -30
  447. package/docs/reference/classes/core.md +216 -206
  448. package/docs/reference/classes/dropped.md +46 -46
  449. package/docs/reference/classes/formats.md +944 -952
  450. package/docs/reference/classes/resources.md +456 -456
  451. package/docs/reference/classes/texture.md +26 -26
  452. package/docs/reference/events.md +117 -117
  453. package/docs/reference/motherlode-cache.md +275 -275
  454. package/docs/reference/queues.md +194 -110
  455. package/docs/reference/reload.md +107 -107
  456. package/docs/reference/texture-arrays.md +113 -113
  457. package/docs/reference/texture-pipeline.md +53 -53
  458. package/docs/reference/workers.md +142 -135
  459. package/docs/roadmap.md +150 -150
  460. package/format-notices/black/LICENSE +21 -21
  461. package/format-notices/black/NOTICE +47 -47
  462. package/format-notices/bnk/LICENSE +21 -21
  463. package/format-notices/bnk/NOTICE +21 -21
  464. package/format-notices/cmf/LICENSE +21 -21
  465. package/format-notices/cmf/NOTICE +36 -36
  466. package/format-notices/dds/LICENSE +21 -21
  467. package/format-notices/dds/NOTICE +14 -14
  468. package/format-notices/dxbc/LICENSE +21 -21
  469. package/format-notices/dxbc/NOTICE +20 -20
  470. package/format-notices/fbx/LICENSE +21 -21
  471. package/format-notices/fbx/NOTICE +14 -14
  472. package/format-notices/flac/LICENSE +21 -21
  473. package/format-notices/flac/NOTICE +14 -14
  474. package/format-notices/gif/LICENSE +21 -21
  475. package/format-notices/gif/NOTICE +14 -14
  476. package/format-notices/gltf/LICENSE +21 -21
  477. package/format-notices/gltf/NOTICE +27 -27
  478. package/format-notices/gr2/LICENSE +21 -21
  479. package/format-notices/gr2/NOTICE +60 -60
  480. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -93
  481. package/format-notices/hlsl/LICENSE +21 -21
  482. package/format-notices/hlsl/NOTICE +25 -25
  483. package/format-notices/jpeg/LICENSE +21 -21
  484. package/format-notices/jpeg/NOTICE +14 -14
  485. package/format-notices/mp3/LICENSE +21 -21
  486. package/format-notices/mp3/NOTICE +14 -14
  487. package/format-notices/mp4/LICENSE +21 -21
  488. package/format-notices/mp4/NOTICE +14 -14
  489. package/format-notices/obj/LICENSE +21 -21
  490. package/format-notices/obj/NOTICE +26 -26
  491. package/format-notices/ogg/LICENSE +21 -21
  492. package/format-notices/ogg/NOTICE +28 -28
  493. package/format-notices/png/LICENSE +21 -21
  494. package/format-notices/png/NOTICE +14 -14
  495. package/format-notices/red/LICENSE +21 -21
  496. package/format-notices/red/NOTICE +31 -31
  497. package/format-notices/stl/LICENSE +21 -21
  498. package/format-notices/stl/NOTICE +21 -21
  499. package/format-notices/tga/LICENSE +21 -21
  500. package/format-notices/tga/NOTICE +14 -14
  501. package/format-notices/wav/LICENSE +21 -21
  502. package/format-notices/wav/NOTICE +14 -14
  503. package/format-notices/webgl/LICENSE +21 -21
  504. package/format-notices/webgl/NOTICE +35 -35
  505. package/format-notices/webgpu/LICENSE +21 -21
  506. package/format-notices/webgpu/NOTICE +31 -31
  507. package/format-notices/webm/LICENSE +21 -21
  508. package/format-notices/webm/NOTICE +14 -14
  509. package/format-notices/webp/LICENSE +21 -21
  510. package/format-notices/webp/NOTICE +14 -14
  511. package/format-notices/wem/LICENSE +57 -57
  512. package/format-notices/wem/NOTICE +33 -33
  513. package/format-notices/yaml/LICENSE +21 -21
  514. package/format-notices/yaml/NOTICE +44 -44
  515. package/package.json +63 -63
  516. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js +0 -372
  517. package/dist/format/carbonEffect/carbonDescriptionFromPortable.js.map +0 -1
  518. package/dist/format/effect/effectReflectionPackage.js +0 -636
  519. package/dist/format/effect/effectReflectionPackage.js.map +0 -1
  520. package/dist/formats/hlsl/core/HlslReader.js +0 -16
  521. package/dist/formats/hlsl/core/HlslReader.js.map +0 -1
  522. package/dist/formats/hlsl/core/portableReflection.js +0 -848
  523. package/dist/formats/hlsl/core/portableReflection.js.map +0 -1
  524. package/dist/formats/hlsl/portable.js +0 -2
  525. package/dist/formats/hlsl/portable.js.map +0 -1
  526. package/dist/formats/webgl/core/cewg/CewgPackage.js +0 -340
  527. package/dist/formats/webgl/core/cewg/CewgPackage.js.map +0 -1
  528. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js +0 -104
  529. package/dist/formats/webgl/core/cewg/CewgPackageBuilder.js.map +0 -1
  530. package/dist/formats/webgl/core/cewg/binary.js +0 -19
  531. package/dist/formats/webgl/core/cewg/binary.js.map +0 -1
  532. package/dist/formats/webgl/core/cewgCompleteness.js.map +0 -1
  533. package/dist/formats/webgl/core/effectPackageValidation.js +0 -331
  534. package/dist/formats/webgl/core/effectPackageValidation.js.map +0 -1
  535. package/dist/formats/webgpu/core/cewgpu/CewgpuContainer.js.map +0 -1
  536. package/dist/formats/webgpu/core/cewgpu/containerViews.js.map +0 -1
  537. package/dist/formats/webgpu/core/cewgpu/validateContainer.js.map +0 -1
  538. package/dist/resource/shader/portable.js +0 -33
  539. package/dist/resource/shader/portable.js.map +0 -1
  540. package/docs/formats/hlsl/reference/portable-reflection.md +0 -141
  541. package/docs/formats/webgl/effect-reflection.md +0 -127
@@ -1,1017 +1,1017 @@
1
- import { imdct, vorbisWindowSlope } from './imdct.js';
2
-
3
- /**
4
- * Pure-JS Ogg Vorbis PCM decoder.
5
- *
6
- * Implements Vorbis I decode: setup-header codebooks (huffman + VQ), floor
7
- * type 1 with the spec's exact integer line rendering, residue types 0/1/2,
8
- * square-polar channel de-coupling, IMDCT, and windowed center-aligned
9
- * overlap-add with final granule trimming. Behavior follows the Vorbis I
10
- * specification with stb_vorbis (public domain) consulted as a reference;
11
- * floor type 0 streams are rejected (never produced by modern encoders).
12
- */
13
-
14
- const NO_CODE = 255;
15
- const FAST_BITS = 10;
16
- const FAST_SIZE = 1 << FAST_BITS;
17
-
18
- /**
19
- * The floor1 amplitude table from the Vorbis I specification
20
- * (inverse_db_table); indexed by the integer floor curve value.
21
- */
22
- const INVERSE_DB_TABLE = new Float32Array([1.0649863e-07, 1.1341951e-07, 1.2079015e-07, 1.2863978e-07, 1.3699951e-07, 1.4590251e-07, 1.5538408e-07, 1.6548181e-07, 1.7623575e-07, 1.8768855e-07, 1.9988561e-07, 2.1287530e-07, 2.2670913e-07, 2.4144197e-07, 2.5713223e-07, 2.7384213e-07, 2.9163793e-07, 3.1059021e-07, 3.3077411e-07, 3.5226968e-07, 3.7516214e-07, 3.9954229e-07, 4.2550680e-07, 4.5315863e-07, 4.8260743e-07, 5.1396998e-07, 5.4737065e-07, 5.8294187e-07, 6.2082472e-07, 6.6116941e-07, 7.0413592e-07, 7.4989464e-07, 7.9862701e-07, 8.5052630e-07, 9.0579828e-07, 9.6466216e-07, 1.0273513e-06, 1.0941144e-06, 1.1652161e-06, 1.2409384e-06, 1.3215816e-06, 1.4074654e-06, 1.4989305e-06, 1.5963394e-06, 1.7000785e-06, 1.8105592e-06, 1.9282195e-06, 2.0535261e-06, 2.1869758e-06, 2.3290978e-06, 2.4804557e-06, 2.6416497e-06, 2.8133190e-06, 2.9961443e-06, 3.1908506e-06, 3.3982101e-06, 3.6190449e-06, 3.8542308e-06, 4.1047004e-06, 4.3714470e-06, 4.6555282e-06, 4.9580707e-06, 5.2802740e-06, 5.6234160e-06, 5.9888572e-06, 6.3780469e-06, 6.7925283e-06, 7.2339451e-06, 7.7040476e-06, 8.2047000e-06, 8.7378876e-06, 9.3057248e-06, 9.9104632e-06, 1.0554501e-05, 1.1240392e-05, 1.1970856e-05, 1.2748789e-05, 1.3577278e-05, 1.4459606e-05, 1.5399272e-05, 1.6400004e-05, 1.7465768e-05, 1.8600792e-05, 1.9809576e-05, 2.1096914e-05, 2.2467911e-05, 2.3928002e-05, 2.5482978e-05, 2.7139006e-05, 2.8902651e-05, 3.0780908e-05, 3.2781225e-05, 3.4911534e-05, 3.7180282e-05, 3.9596466e-05, 4.2169667e-05, 4.4910090e-05, 4.7828601e-05, 5.0936773e-05, 5.4246931e-05, 5.7772202e-05, 6.1526565e-05, 6.5524908e-05, 6.9783085e-05, 7.4317983e-05, 7.9147585e-05, 8.4291040e-05, 8.9768747e-05, 9.5602426e-05, 0.00010181521, 0.00010843174, 0.00011547824, 0.00012298267, 0.00013097477, 0.00013948625, 0.00014855085, 0.00015820453, 0.00016848555, 0.00017943469, 0.00019109536, 0.00020351382, 0.00021673929, 0.00023082423, 0.00024582449, 0.00026179955, 0.00027881276, 0.00029693158, 0.00031622787, 0.00033677814, 0.00035866388, 0.00038197188, 0.00040679456, 0.00043323036, 0.00046138411, 0.00049136745, 0.00052329927, 0.00055730621, 0.00059352311, 0.00063209358, 0.00067317058, 0.00071691700, 0.00076350630, 0.00081312324, 0.00086596457, 0.00092223983, 0.00098217216, 0.0010459992, 0.0011139742, 0.0011863665, 0.0012634633, 0.0013455702, 0.0014330129, 0.0015261382, 0.0016253153, 0.0017309374, 0.0018434235, 0.0019632195, 0.0020908006, 0.0022266726, 0.0023713743, 0.0025254795, 0.0026895994, 0.0028643847, 0.0030505286, 0.0032487691, 0.0034598925, 0.0036847358, 0.0039241906, 0.0041792066, 0.0044507950, 0.0047400328, 0.0050480668, 0.0053761186, 0.0057254891, 0.0060975636, 0.0064938176, 0.0069158225, 0.0073652516, 0.0078438871, 0.0083536271, 0.0088964928, 0.0094746370, 0.0100903520, 0.0107460800, 0.0114444210, 0.0121881440, 0.0129801980, 0.0138237250, 0.0147220680, 0.0156787910, 0.0166976870, 0.0177827970, 0.0189384230, 0.0201691490, 0.0214798540, 0.0228757350, 0.0243623300, 0.0259455310, 0.0276316180, 0.0294272760, 0.0313396260, 0.0333762520, 0.0355452280, 0.0378551570, 0.0403151990, 0.0429351080, 0.0457252730, 0.0486967580, 0.0518613480, 0.0552315910, 0.0588208500, 0.0626433610, 0.0667142790, 0.0710497490, 0.0756669620, 0.0805842270, 0.0858210440, 0.0913981790, 0.0973377470, 0.1036633000, 0.1103999300, 0.1175743400, 0.1252149800, 0.1333521500, 0.1420181300, 0.1512472700, 0.1610761700, 0.1715438000, 0.1826916800, 0.1945640200, 0.2072078800, 0.2206734200, 0.2350140200, 0.2502865600, 0.2665515900, 0.2838736100, 0.3023213200, 0.3219678600, 0.3428911400, 0.3651741400, 0.3889052100, 0.4141784700, 0.4410941200, 0.4697589000, 0.5002864800, 0.5327979100, 0.5674221200, 0.6042964000, 0.6435669900, 0.6853895900, 0.7299300700, 0.7773650400, 0.8278826000, 0.8816830700, 0.9389798000, 1.0]);
23
- function decodeError(message) {
24
- const error = new Error(`ogg: ${message}`);
25
- error.code = "CJS_FORMAT_PARSE_ERROR";
26
- return error;
27
- }
28
- function ilog(value) {
29
- let result = 0;
30
- let v = value | 0;
31
- if (v < 0) return 0;
32
- while (v) {
33
- result++;
34
- v >>= 1;
35
- }
36
- return result;
37
- }
38
- function float32Unpack(x) {
39
- const mantissa = x & 0x1fffff;
40
- const sign = x & 0x80000000;
41
- const exponent = (x & 0x7fe00000) >>> 21;
42
- const value = sign ? -mantissa : mantissa;
43
- return value * Math.pow(2, exponent - 788);
44
- }
45
- function lookup1Values(entries, dimensions) {
46
- if (dimensions === 0) return 0;
47
- const bits = ilog(entries);
48
- let vals = entries >>> Math.floor((bits - 1) * (dimensions - 1) / dimensions);
49
- for (;;) {
50
- let acc = 1;
51
- let acc1 = 1;
52
- for (let i = 0; i < dimensions; i++) {
53
- acc *= vals;
54
- acc1 *= vals + 1;
55
- }
56
- if (acc <= entries && acc1 > entries) return vals;
57
- if (acc > entries) vals--;else vals++;
58
- }
59
- }
60
-
61
- /**
62
- * LSB-first bit reader over one Vorbis packet; reading past the end sets
63
- * `eop` instead of throwing (end-of-packet is a defined decode condition).
64
- */
65
- class PacketReader {
66
- /** Creates a PacketReader over caller-provided Ogg bytes and reader options. */
67
- constructor(bytes) {
68
- this.bytes = bytes;
69
- this.position = 0;
70
- this.bitBuffer = 0;
71
- this.bitsLeft = 0;
72
- this.eop = false;
73
- }
74
-
75
- /** Reads bits from the current Ogg binary reader. */
76
- readBits(count) {
77
- let value = 0;
78
- for (let i = 0; i < count; i++) {
79
- if (this.bitsLeft === 0) {
80
- if (this.position >= this.bytes.length) {
81
- this.eop = true;
82
- return -1;
83
- }
84
- this.bitBuffer = this.bytes[this.position++];
85
- this.bitsLeft = 8;
86
- }
87
- value |= (this.bitBuffer & 1) << i;
88
- this.bitBuffer >>= 1;
89
- this.bitsLeft--;
90
- }
91
- return value >>> 0;
92
- }
93
- }
94
-
95
- /**
96
- * Vorbis codebook that builds Huffman decode trees and VQ lookup vectors for
97
- * scalar and vector packet decoding.
98
- */
99
- class Codebook {
100
- /** Creates a Codebook with caller-provided initial state. */
101
- constructor() {
102
- this.dimensions = 0;
103
- this.entries = 0;
104
- this.lookupType = 0;
105
- this.sequenceP = false;
106
- this.quantvals = 0;
107
- this.values = null;
108
- this.fastTable = null;
109
- this.treeNodes = null;
110
- this.maxLength = 0;
111
- }
112
-
113
- /**
114
- * Builds the canonical Vorbis Huffman decode tree for this codebook for the
115
- * Ogg decoder.
116
- */
117
- buildHuffman(lengths) {
118
- const available = new Uint32Array(33);
119
- this.fastTable = new Int32Array(FAST_SIZE).fill(-1);
120
- // flat binary trie: two child slots per node; negative = -(symbol+1)
121
- const nodes = [0, 0];
122
- let assigned = false;
123
- for (let symbol = 0; symbol < lengths.length; symbol++) {
124
- const length = lengths[symbol];
125
- if (length === NO_CODE) continue;
126
- if (length > this.maxLength) this.maxLength = length;
127
- let code;
128
- if (!assigned) {
129
- code = 0;
130
- assigned = true;
131
- for (let i = 1; i <= length; i++) available[i] = 1 << 32 - i >>> 0;
132
- } else {
133
- let z = length;
134
- while (z > 0 && !available[z]) z--;
135
- if (z === 0) throw decodeError("over-specified huffman codebook");
136
- code = available[z];
137
- available[z] = 0;
138
- if (z !== length) {
139
- for (let y = length; y > z; y--) {
140
- available[y] = code + (1 << 32 - y) >>> 0;
141
- }
142
- }
143
- }
144
-
145
- // reversed code: first stream bit in bit 0
146
- let reversed = 0;
147
- for (let i = 0; i < length; i++) {
148
- reversed |= (code >>> 31 - i & 1) << i;
149
- }
150
- reversed >>>= 0;
151
- if (length <= FAST_BITS) {
152
- for (let z = reversed; z < FAST_SIZE; z += 1 << length) {
153
- this.fastTable[z] = symbol << 6 | length;
154
- }
155
- } else {
156
- let node = 0;
157
- for (let i = 0; i < length; i++) {
158
- const bit = reversed >>> i & 1;
159
- const slot = node * 2 + bit;
160
- if (i === length - 1) {
161
- nodes[slot] = -(symbol + 1);
162
- } else {
163
- if (!nodes[slot]) {
164
- nodes[slot] = nodes.length / 2;
165
- nodes.push(0, 0);
166
- }
167
- node = nodes[slot];
168
- }
169
- }
170
- }
171
- }
172
- this.treeNodes = nodes;
173
- }
174
-
175
- /** Decodes the Ogg input into a normalized Ogg decoder result. */
176
- decode(reader) {
177
- // fast path: peek up to FAST_BITS without consuming
178
- let peek = 0;
179
- let peekBits = 0;
180
- const savedPosition = reader.position;
181
- const savedBuffer = reader.bitBuffer;
182
- const savedLeft = reader.bitsLeft;
183
- while (peekBits < FAST_BITS) {
184
- const bit = reader.readBits(1);
185
- if (bit < 0) break;
186
- peek |= bit << peekBits;
187
- peekBits++;
188
- }
189
- reader.position = savedPosition;
190
- reader.bitBuffer = savedBuffer;
191
- reader.bitsLeft = savedLeft;
192
- reader.eop = false;
193
- if (peekBits === FAST_BITS) {
194
- const hit = this.fastTable[peek];
195
- if (hit >= 0) {
196
- reader.readBits(hit & 63);
197
- return hit >> 6;
198
- }
199
- } else {
200
- // short remainder: try fast table over what's left
201
- const hit = this.fastTable[peek];
202
- if (hit >= 0 && (hit & 63) <= peekBits) {
203
- reader.readBits(hit & 63);
204
- return hit >> 6;
205
- }
206
- }
207
-
208
- // slow path: walk the trie bit by bit
209
- let node = 0;
210
- for (let i = 0; i < this.maxLength; i++) {
211
- const bit = reader.readBits(1);
212
- if (bit < 0) return -1;
213
- const value = this.treeNodes[node * 2 + bit];
214
- if (value < 0) return -value - 1;
215
- if (value === 0) throw decodeError("invalid huffman code in stream");
216
- node = value;
217
- }
218
- throw decodeError("huffman walk exceeded max code length");
219
- }
220
-
221
- /** Reconstructs one vector-quantized codebook component for the Ogg decoder. */
222
- vqValue(symbol, element) {
223
- if (this.lookupType === 1) {
224
- let index = symbol;
225
- for (let i = 0; i < element; i++) index = Math.floor(index / this.quantvals);
226
- return this.values[index % this.quantvals];
227
- }
228
- return this.values[symbol * this.dimensions + element];
229
- }
230
- }
231
- function parseCodebook(reader) {
232
- const sync = reader.readBits(24);
233
- if (sync !== 0x564342) throw decodeError("invalid codebook sync pattern");
234
- const book = new Codebook();
235
- book.dimensions = reader.readBits(16);
236
- book.entries = reader.readBits(24);
237
- const lengths = new Uint8Array(book.entries);
238
- const ordered = reader.readBits(1);
239
- if (ordered) {
240
- let currentEntry = 0;
241
- let currentLength = reader.readBits(5) + 1;
242
- while (currentEntry < book.entries) {
243
- const number = reader.readBits(ilog(book.entries - currentEntry));
244
- if (reader.eop) throw decodeError("codebook lengths truncated");
245
- for (let i = 0; i < number; i++) lengths[currentEntry + i] = currentLength;
246
- currentEntry += number;
247
- currentLength++;
248
- if (currentEntry > book.entries) throw decodeError("codebook entry overflow");
249
- }
250
- } else {
251
- const sparse = reader.readBits(1);
252
- for (let i = 0; i < book.entries; i++) {
253
- const present = sparse ? reader.readBits(1) : 1;
254
- lengths[i] = present ? reader.readBits(5) + 1 : NO_CODE;
255
- }
256
- }
257
- if (reader.eop) throw decodeError("codebook lengths truncated");
258
- book.buildHuffman(lengths);
259
- book.lookupType = reader.readBits(4);
260
- if (book.lookupType > 2) throw decodeError(`invalid codebook lookup type ${book.lookupType}`);
261
- if (book.lookupType > 0) {
262
- const minimum = float32Unpack(reader.readBits(32));
263
- const delta = float32Unpack(reader.readBits(32));
264
- const valueBits = reader.readBits(4) + 1;
265
- book.sequenceP = reader.readBits(1) === 1;
266
- const count = book.lookupType === 1 ? lookup1Values(book.entries, book.dimensions) : book.entries * book.dimensions;
267
- book.quantvals = book.lookupType === 1 ? count : 0;
268
- book.values = new Float32Array(count);
269
- for (let i = 0; i < count; i++) {
270
- book.values[i] = minimum + reader.readBits(valueBits) * delta;
271
- }
272
- if (reader.eop) throw decodeError("codebook lookup values truncated");
273
- }
274
- return book;
275
- }
276
- function parseFloor(reader, codebooks) {
277
- const type = reader.readBits(16);
278
- if (type !== 1) {
279
- throw decodeError(`floor type ${type} is not supported (only floor 1)`);
280
- }
281
- const floor = {
282
- partitions: reader.readBits(5),
283
- partitionClassList: [],
284
- classDimensions: [],
285
- classSubclasses: [],
286
- classMasterbooks: [],
287
- subclassBooks: [],
288
- multiplier: 0,
289
- rangebits: 0,
290
- xList: [0, 0]
291
- };
292
- let maximumClass = -1;
293
- for (let i = 0; i < floor.partitions; i++) {
294
- const partitionClass = reader.readBits(4);
295
- floor.partitionClassList.push(partitionClass);
296
- if (partitionClass > maximumClass) maximumClass = partitionClass;
297
- }
298
- for (let i = 0; i <= maximumClass; i++) {
299
- floor.classDimensions.push(reader.readBits(3) + 1);
300
- const subclasses = reader.readBits(2);
301
- floor.classSubclasses.push(subclasses);
302
- floor.classMasterbooks.push(subclasses ? reader.readBits(8) : -1);
303
- const books = [];
304
- for (let j = 0; j < 1 << subclasses; j++) {
305
- books.push(reader.readBits(8) - 1);
306
- }
307
- floor.subclassBooks.push(books);
308
- }
309
- floor.multiplier = reader.readBits(2) + 1;
310
- floor.rangebits = reader.readBits(4);
311
- floor.xList = [0, 1 << floor.rangebits];
312
- for (let i = 0; i < floor.partitions; i++) {
313
- for (let j = 0; j < floor.classDimensions[floor.partitionClassList[i]]; j++) {
314
- floor.xList.push(reader.readBits(floor.rangebits));
315
- }
316
- }
317
- if (reader.eop) throw decodeError("floor configuration truncated");
318
- for (const bookIndex of [...floor.classMasterbooks, ...floor.subclassBooks.flat()]) {
319
- if (bookIndex >= codebooks.length) throw decodeError("floor references invalid codebook");
320
- }
321
-
322
- // sorted render order over unique X positions, computed once
323
- floor.sortedIndex = floor.xList.map((x, index) => ({
324
- x,
325
- index
326
- })).sort((a, b) => a.x - b.x || a.index - b.index).map(entry => entry.index);
327
-
328
- // neighbor tables (over original ordering) computed once
329
- floor.lowNeighbors = [];
330
- floor.highNeighbors = [];
331
- for (let i = 2; i < floor.xList.length; i++) {
332
- let low = 0;
333
- let high = 1;
334
- for (let j = 0; j < i; j++) {
335
- if (floor.xList[j] < floor.xList[i] && floor.xList[j] >= floor.xList[low]) low = j;
336
- if (floor.xList[j] > floor.xList[i] && floor.xList[j] <= floor.xList[high]) high = j;
337
- }
338
- floor.lowNeighbors.push(low);
339
- floor.highNeighbors.push(high);
340
- }
341
- return floor;
342
- }
343
- function parseResidue(reader, codebooks) {
344
- const type = reader.readBits(16);
345
- if (type > 2) throw decodeError(`invalid residue type ${type}`);
346
- const residue = {
347
- type,
348
- begin: reader.readBits(24),
349
- end: reader.readBits(24),
350
- partSize: reader.readBits(24) + 1,
351
- classifications: reader.readBits(6) + 1,
352
- classbook: reader.readBits(8),
353
- books: []
354
- };
355
- if (residue.classbook >= codebooks.length) throw decodeError("residue classbook out of range");
356
- const cascades = [];
357
- for (let i = 0; i < residue.classifications; i++) {
358
- const lowBits = reader.readBits(3);
359
- const flag = reader.readBits(1);
360
- const highBits = flag ? reader.readBits(5) : 0;
361
- cascades.push(highBits * 8 + lowBits);
362
- }
363
- for (let i = 0; i < residue.classifications; i++) {
364
- const passBooks = [];
365
- for (let pass = 0; pass < 8; pass++) {
366
- if (cascades[i] & 1 << pass) {
367
- const bookIndex = reader.readBits(8);
368
- if (bookIndex >= codebooks.length) throw decodeError("residue book out of range");
369
- if (codebooks[bookIndex].lookupType === 0) throw decodeError("residue book has no lookup values");
370
- passBooks.push(bookIndex);
371
- } else {
372
- passBooks.push(-1);
373
- }
374
- }
375
- residue.books.push(passBooks);
376
- }
377
- if (reader.eop) throw decodeError("residue configuration truncated");
378
- return residue;
379
- }
380
- function parseMapping(reader, channels, floorCount, residueCount) {
381
- const type = reader.readBits(16);
382
- if (type !== 0) throw decodeError(`invalid mapping type ${type}`);
383
- const mapping = {
384
- submaps: 1,
385
- couplingSteps: [],
386
- mux: new Array(channels).fill(0),
387
- submapFloor: [],
388
- submapResidue: []
389
- };
390
- if (reader.readBits(1)) mapping.submaps = reader.readBits(4) + 1;
391
- if (reader.readBits(1)) {
392
- const steps = reader.readBits(8) + 1;
393
- const bits = ilog(channels - 1);
394
- for (let i = 0; i < steps; i++) {
395
- const magnitude = reader.readBits(bits);
396
- const angle = reader.readBits(bits);
397
- if (magnitude === angle || magnitude >= channels || angle >= channels) {
398
- throw decodeError("invalid channel coupling");
399
- }
400
- mapping.couplingSteps.push({
401
- magnitude,
402
- angle
403
- });
404
- }
405
- }
406
- if (reader.readBits(2) !== 0) throw decodeError("mapping reserved bits nonzero");
407
- if (mapping.submaps > 1) {
408
- for (let i = 0; i < channels; i++) {
409
- mapping.mux[i] = reader.readBits(4);
410
- if (mapping.mux[i] >= mapping.submaps) throw decodeError("mapping mux out of range");
411
- }
412
- }
413
- for (let i = 0; i < mapping.submaps; i++) {
414
- reader.readBits(8);
415
- const floorIndex = reader.readBits(8);
416
- const residueIndex = reader.readBits(8);
417
- if (floorIndex >= floorCount || residueIndex >= residueCount) {
418
- throw decodeError("mapping references invalid floor or residue");
419
- }
420
- mapping.submapFloor.push(floorIndex);
421
- mapping.submapResidue.push(residueIndex);
422
- }
423
- return mapping;
424
- }
425
- const FLOOR1_RANGES = [256, 128, 86, 64];
426
- function renderPoint(x0, y0, x1, y1, x) {
427
- const dy = y1 - y0;
428
- const adx = x1 - x0;
429
- const err = Math.floor(Math.abs(dy) * (x - x0) / adx);
430
- return dy < 0 ? y0 - err : y0 + err;
431
- }
432
- function decodeFloor1Posts(reader, floor, codebooks) {
433
- if (reader.readBits(1) !== 1) return null;
434
- const range = FLOOR1_RANGES[floor.multiplier - 1];
435
- const posts = new Int32Array(floor.xList.length);
436
- const yBits = ilog(range - 1);
437
- posts[0] = reader.readBits(yBits);
438
- posts[1] = reader.readBits(yBits);
439
- let offset = 2;
440
- for (let i = 0; i < floor.partitions; i++) {
441
- const partitionClass = floor.partitionClassList[i];
442
- const cdim = floor.classDimensions[partitionClass];
443
- const cbits = floor.classSubclasses[partitionClass];
444
- const csub = (1 << cbits) - 1;
445
- let cval = 0;
446
- if (cbits) {
447
- cval = codebooks[floor.classMasterbooks[partitionClass]].decode(reader);
448
- if (cval < 0) return null;
449
- }
450
- for (let j = 0; j < cdim; j++) {
451
- const bookIndex = floor.subclassBooks[partitionClass][cval & csub];
452
- cval >>= cbits;
453
- if (bookIndex >= 0) {
454
- const value = codebooks[bookIndex].decode(reader);
455
- if (value < 0) return null;
456
- posts[offset + j] = value;
457
- } else {
458
- posts[offset + j] = 0;
459
- }
460
- }
461
- offset += cdim;
462
- }
463
- if (reader.eop) return null;
464
- return posts;
465
- }
466
- function computeFloor1Curve(floor, posts, n2, output) {
467
- const range = FLOOR1_RANGES[floor.multiplier - 1];
468
- const count = floor.xList.length;
469
- const finalY = new Int32Array(count);
470
- const step2 = new Uint8Array(count);
471
- step2[0] = 1;
472
- step2[1] = 1;
473
- finalY[0] = posts[0];
474
- finalY[1] = posts[1];
475
- for (let i = 2; i < count; i++) {
476
- const low = floor.lowNeighbors[i - 2];
477
- const high = floor.highNeighbors[i - 2];
478
- const predicted = renderPoint(floor.xList[low], finalY[low], floor.xList[high], finalY[high], floor.xList[i]);
479
- const value = posts[i];
480
- const highroom = range - predicted;
481
- const lowroom = predicted;
482
- const room = (highroom < lowroom ? highroom : lowroom) * 2;
483
- if (value) {
484
- step2[low] = 1;
485
- step2[high] = 1;
486
- step2[i] = 1;
487
- if (value >= room) {
488
- finalY[i] = highroom > lowroom ? value - lowroom + predicted : predicted - value + highroom - 1;
489
- } else {
490
- finalY[i] = value & 1 ? predicted - (value + 1 >> 1) : predicted + (value >> 1);
491
- }
492
- } else {
493
- step2[i] = 0;
494
- finalY[i] = predicted;
495
- }
496
- }
497
- output.fill(0);
498
- let lx = 0;
499
- let ly = finalY[floor.sortedIndex[0]] * floor.multiplier;
500
- for (const index of floor.sortedIndex) {
501
- if (!step2[index]) continue;
502
- const hx = floor.xList[index];
503
- const hy = finalY[index] * floor.multiplier;
504
- if (hx > lx) renderLine(lx, ly, hx, hy, output, n2);
505
- if (hx >= n2) return;
506
- lx = hx;
507
- ly = hy;
508
- }
509
- if (lx < n2) {
510
- for (let i = lx; i < n2; i++) output[i] = INVERSE_DB_TABLE[ly & 255];
511
- }
512
- }
513
- function renderLine(x0, y0, x1, y1, output, n) {
514
- const dy = y1 - y0;
515
- const adx = x1 - x0;
516
- let ady = Math.abs(dy);
517
- const base = dy / adx | 0;
518
- const sy = dy < 0 ? base - 1 : base + 1;
519
- let x = x0;
520
- let y = y0;
521
- let err = 0;
522
- ady -= Math.abs(base) * adx;
523
- const limit = x1 > n ? n : x1;
524
- if (x < limit) output[x] = INVERSE_DB_TABLE[y & 255];
525
- for (x++; x < limit; x++) {
526
- err += ady;
527
- if (err >= adx) {
528
- err -= adx;
529
- y += sy;
530
- } else {
531
- y += base;
532
- }
533
- output[x] = INVERSE_DB_TABLE[y & 255];
534
- }
535
- }
536
- function decodeResidue(residue, reader, codebooks, buffers, doNotDecode, n2) {
537
- const channelCount = buffers.length;
538
- const classbook = codebooks[residue.classbook];
539
- const classwords = classbook.dimensions;
540
- const actualSize = residue.type === 2 ? n2 * channelCount : n2;
541
- const limitBegin = Math.min(residue.begin, actualSize);
542
- const limitEnd = Math.min(residue.end, actualSize);
543
- const nRead = limitEnd - limitBegin;
544
- const partRead = Math.floor(nRead / residue.partSize);
545
- if (partRead <= 0) return;
546
- if (residue.type === 2 && channelCount > 1) {
547
- if (doNotDecode.every(Boolean)) return;
548
- const classifications = new Int32Array(partRead + classwords);
549
- for (let pass = 0; pass < 8; pass++) {
550
- let pcount = 0;
551
- while (pcount < partRead) {
552
- if (pass === 0) {
553
- let symbol = classbook.decode(reader);
554
- if (symbol < 0) return;
555
- for (let i = classwords - 1; i >= 0; i--) {
556
- classifications[i + pcount] = symbol % residue.classifications;
557
- symbol = Math.floor(symbol / residue.classifications);
558
- }
559
- }
560
- for (let i = 0; i < classwords && pcount < partRead; i++, pcount++) {
561
- const z = residue.begin + pcount * residue.partSize;
562
- const bookIndex = residue.books[classifications[pcount]][pass];
563
- if (bookIndex < 0) continue;
564
- const book = codebooks[bookIndex];
565
- let cInter = z % channelCount;
566
- let pInter = Math.floor(z / channelCount);
567
- let decoded = 0;
568
- while (decoded < residue.partSize) {
569
- const symbol = book.decode(reader);
570
- if (symbol < 0) return;
571
- let last = 0;
572
- for (let e = 0; e < book.dimensions; e++) {
573
- const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
574
- if (book.sequenceP) last = value;
575
- buffers[cInter][pInter] += value;
576
- cInter++;
577
- if (cInter === channelCount) {
578
- cInter = 0;
579
- pInter++;
580
- }
581
- }
582
- decoded += book.dimensions;
583
- }
584
- }
585
- }
586
- }
587
- return;
588
- }
589
- const classifications = [];
590
- for (let j = 0; j < channelCount; j++) classifications.push(new Int32Array(partRead + classwords));
591
- for (let pass = 0; pass < 8; pass++) {
592
- let pcount = 0;
593
- while (pcount < partRead) {
594
- if (pass === 0) {
595
- for (let j = 0; j < channelCount; j++) {
596
- if (doNotDecode[j]) continue;
597
- let symbol = classbook.decode(reader);
598
- if (symbol < 0) return;
599
- for (let i = classwords - 1; i >= 0; i--) {
600
- classifications[j][i + pcount] = symbol % residue.classifications;
601
- symbol = Math.floor(symbol / residue.classifications);
602
- }
603
- }
604
- }
605
- for (let i = 0; i < classwords && pcount < partRead; i++, pcount++) {
606
- for (let j = 0; j < channelCount; j++) {
607
- if (doNotDecode[j]) continue;
608
- const bookIndex = residue.books[classifications[j][pcount]][pass];
609
- if (bookIndex < 0) continue;
610
- const book = codebooks[bookIndex];
611
- const target = buffers[j];
612
- const offset = residue.begin + pcount * residue.partSize;
613
- if (residue.type === 0) {
614
- const step = Math.floor(residue.partSize / book.dimensions);
615
- for (let k = 0; k < step; k++) {
616
- const symbol = book.decode(reader);
617
- if (symbol < 0) return;
618
- let last = 0;
619
- for (let e = 0; e < book.dimensions; e++) {
620
- const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
621
- if (book.sequenceP) last = value;
622
- target[offset + k + e * step] += value;
623
- }
624
- }
625
- } else {
626
- let k = 0;
627
- while (k < residue.partSize) {
628
- const symbol = book.decode(reader);
629
- if (symbol < 0) return;
630
- let last = 0;
631
- for (let e = 0; e < book.dimensions; e++) {
632
- const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
633
- if (book.sequenceP) last = value;
634
- target[offset + k + e] += value;
635
- }
636
- k += book.dimensions;
637
- }
638
- }
639
- }
640
- }
641
- }
642
- }
643
- }
644
- function buildWindow(n, blockflag, prevFlag, nextFlag, blocksize0) {
645
- const window = new Float32Array(n);
646
- const center = n >> 1;
647
- let leftStart = 0;
648
- let leftEnd = center;
649
- let leftN = center;
650
- let rightStart = center;
651
- let rightEnd = n;
652
- let rightN = center;
653
- if (blockflag && !prevFlag) {
654
- leftStart = (n >> 2) - (blocksize0 >> 2);
655
- leftEnd = (n >> 2) + (blocksize0 >> 2);
656
- leftN = blocksize0 >> 1;
657
- }
658
- if (blockflag && !nextFlag) {
659
- rightStart = n - (n >> 2) - (blocksize0 >> 2);
660
- rightEnd = n - (n >> 2) + (blocksize0 >> 2);
661
- rightN = blocksize0 >> 1;
662
- }
663
- const leftSlope = vorbisWindowSlope(leftN);
664
- const rightSlope = vorbisWindowSlope(rightN);
665
- for (let i = leftStart; i < leftEnd; i++) window[i] = leftSlope[i - leftStart];
666
- for (let i = leftEnd; i < rightStart; i++) window[i] = 1;
667
- for (let i = rightStart; i < rightEnd; i++) window[i] = rightSlope[rightN - 1 - (i - rightStart)];
668
- return window;
669
- }
670
- const windowVariantCache = new Map();
671
- function getWindow(n, blockflag, prevFlag, nextFlag, blocksize0) {
672
- const key = `${n}:${blockflag ? 1 : 0}${prevFlag ? 1 : 0}${nextFlag ? 1 : 0}:${blocksize0}`;
673
- let window = windowVariantCache.get(key);
674
- if (!window) {
675
- window = buildWindow(n, blockflag, prevFlag, nextFlag, blocksize0);
676
- windowVariantCache.set(key, window);
677
- }
678
- return window;
679
- }
680
-
681
- /**
682
- * Split an Ogg stream into the first logical stream's packets.
683
- *
684
- * @param {Uint8Array} bytes Ogg bytes (already CRC-validated by inspection).
685
- * @returns {object} `{ packets, lastGranule }` for the first stream.
686
- */
687
- function extractOggPackets(bytes) {
688
- const packets = [];
689
- let pending = [];
690
- let serial = null;
691
- let lastGranule = 0;
692
- let offset = 0;
693
- while (offset + 27 <= bytes.length) {
694
- if (bytes[offset] !== 0x4f || bytes[offset + 1] !== 0x67 || bytes[offset + 2] !== 0x67 || bytes[offset + 3] !== 0x53) {
695
- throw decodeError(`invalid page at byte ${offset}`);
696
- }
697
- const headerType = bytes[offset + 5];
698
- let granule = 0;
699
- for (let i = 7; i >= 0; i--) granule = granule * 256 + bytes[offset + 6 + i];
700
- const pageSerial = (bytes[offset + 14] | bytes[offset + 15] << 8 | bytes[offset + 16] << 16 | bytes[offset + 17] * 0x1000000) >>> 0;
701
- const segmentCount = bytes[offset + 26];
702
- const tableOffset = offset + 27;
703
- let cursor = tableOffset + segmentCount;
704
- const isBos = (headerType & 0x02) !== 0;
705
- if (serial === null && isBos) serial = pageSerial;
706
- const ours = pageSerial === serial;
707
- for (let i = 0; i < segmentCount; i++) {
708
- const length = bytes[tableOffset + i];
709
- if (ours && length > 0) pending.push(bytes.subarray(cursor, cursor + length));
710
- cursor += length;
711
- if (length < 255 && ours) {
712
- packets.push(concatChunks(pending));
713
- pending = [];
714
- }
715
- }
716
- if (ours && granule !== 0xffffffffffffffff && Number.isSafeInteger(granule)) {
717
- lastGranule = granule;
718
- }
719
- offset = cursor;
720
- }
721
- if (pending.length) packets.push(concatChunks(pending));
722
- return {
723
- packets,
724
- lastGranule
725
- };
726
- }
727
- function concatChunks(chunks) {
728
- if (chunks.length === 1) return chunks[0];
729
- let total = 0;
730
- for (const chunk of chunks) total += chunk.length;
731
- const bytes = new Uint8Array(total);
732
- let cursor = 0;
733
- for (const chunk of chunks) {
734
- bytes.set(chunk, cursor);
735
- cursor += chunk.length;
736
- }
737
- return bytes;
738
- }
739
- function expectHeader(packet, type) {
740
- if (packet.length < 7 || packet[0] !== type || packet[1] !== 0x76 || packet[2] !== 0x6f || packet[3] !== 0x72 || packet[4] !== 0x62 || packet[5] !== 0x69 || packet[6] !== 0x73) {
741
- throw decodeError(`missing vorbis header packet type ${type}`);
742
- }
743
- const reader = new PacketReader(packet);
744
- reader.readBits(8);
745
- for (let i = 0; i < 6; i++) reader.readBits(8);
746
- return reader;
747
- }
748
- function parseComments(packet) {
749
- const reader = new PacketReader(packet);
750
- reader.readBits(8);
751
- for (let i = 0; i < 6; i++) reader.readBits(8);
752
- const readString = () => {
753
- const length = reader.readBits(32);
754
- let text = "";
755
- for (let i = 0; i < length; i++) text += String.fromCharCode(reader.readBits(8));
756
- return text;
757
- };
758
- const vendor = readString();
759
- const count = reader.readBits(32);
760
- const comments = [];
761
- for (let i = 0; i < count && !reader.eop; i++) comments.push(readString());
762
- let loop = null;
763
- let loopStart = null;
764
- let loopEnd = null;
765
- for (const comment of comments) {
766
- const match = /^(loopstart|loopend)=(\d+)$/iu.exec(comment);
767
- if (!match) continue;
768
- if (match[1].toLowerCase() === "loopstart") loopStart = Number(match[2]);else loopEnd = Number(match[2]);
769
- }
770
- if (loopStart !== null && loopEnd !== null) loop = {
771
- start: loopStart,
772
- end: loopEnd
773
- };
774
- return {
775
- vendor,
776
- comments,
777
- loop
778
- };
779
- }
780
-
781
- /**
782
- * Decode an Ogg Vorbis stream to planar float PCM.
783
- *
784
- * @param {Uint8Array} bytes Complete Ogg Vorbis stream bytes.
785
- * @returns {object} `{ channels, sampleRate, sampleCount, channelData, vendor, comments, loop, packetCount }`.
786
- */
787
- function decodeVorbis(bytes) {
788
- const {
789
- packets,
790
- lastGranule
791
- } = extractOggPackets(bytes);
792
- if (packets.length < 3) throw decodeError("stream has no audio packets");
793
-
794
- // identification header
795
- const identReader = expectHeader(packets[0], 1);
796
- if (identReader.readBits(32) !== 0) throw decodeError("unsupported vorbis version");
797
- const channels = identReader.readBits(8);
798
- const sampleRate = identReader.readBits(32);
799
- identReader.readBits(32);
800
- identReader.readBits(32);
801
- identReader.readBits(32);
802
- const blocksize0 = 1 << identReader.readBits(4);
803
- const blocksize1 = 1 << identReader.readBits(4);
804
- if (!channels || !sampleRate) throw decodeError("invalid identification header");
805
- if (blocksize0 > blocksize1 || blocksize0 < 64 || blocksize1 > 8192) {
806
- throw decodeError("invalid blocksizes");
807
- }
808
- const {
809
- vendor,
810
- comments,
811
- loop
812
- } = parseComments(packets[1]);
813
-
814
- // setup header
815
- const setup = expectHeader(packets[2], 5);
816
- const codebooks = [];
817
- const codebookCount = setup.readBits(8) + 1;
818
- for (let i = 0; i < codebookCount; i++) codebooks.push(parseCodebook(setup));
819
- const timeCount = setup.readBits(6) + 1;
820
- for (let i = 0; i < timeCount; i++) {
821
- if (setup.readBits(16) !== 0) throw decodeError("nonzero time-domain transform");
822
- }
823
- const floors = [];
824
- const floorCount = setup.readBits(6) + 1;
825
- for (let i = 0; i < floorCount; i++) floors.push(parseFloor(setup, codebooks));
826
- const residues = [];
827
- const residueCount = setup.readBits(6) + 1;
828
- for (let i = 0; i < residueCount; i++) residues.push(parseResidue(setup, codebooks));
829
- const mappings = [];
830
- const mappingCount = setup.readBits(6) + 1;
831
- for (let i = 0; i < mappingCount; i++) mappings.push(parseMapping(setup, channels, floorCount, residueCount));
832
- const modes = [];
833
- const modeCount = setup.readBits(6) + 1;
834
- for (let i = 0; i < modeCount; i++) {
835
- const blockflag = setup.readBits(1) === 1;
836
- if (setup.readBits(16) !== 0 || setup.readBits(16) !== 0) {
837
- throw decodeError("nonzero mode window/transform type");
838
- }
839
- const mapping = setup.readBits(8);
840
- if (mapping >= mappingCount) throw decodeError("mode references invalid mapping");
841
- modes.push({
842
- blockflag,
843
- mapping
844
- });
845
- }
846
- if (setup.readBits(1) !== 1) throw decodeError("missing setup framing bit");
847
- const modeBits = ilog(modeCount - 1);
848
-
849
- // synthesis state
850
- const n1 = blocksize1;
851
- const spectrum = [];
852
- const floorCurves = [];
853
- const imdctOut = [];
854
- for (let j = 0; j < channels; j++) {
855
- spectrum.push(new Float32Array(n1 >> 1));
856
- floorCurves.push(new Float32Array(n1 >> 1));
857
- imdctOut.push(new Float32Array(n1));
858
- }
859
- const zeroChannel = new Array(channels).fill(false);
860
- const floorPosts = new Array(channels).fill(null);
861
- const tails = [];
862
- for (let j = 0; j < channels; j++) tails.push(new Float32Array(n1 >> 1));
863
- let prevN = 0;
864
- const outputChunks = [];
865
- let totalSamples = 0;
866
- let packetCount = 0;
867
- for (let p = 3; p < packets.length; p++) {
868
- const reader = new PacketReader(packets[p]);
869
- if (reader.readBits(1) !== 0) continue;
870
- const modeNumber = reader.readBits(modeBits);
871
- if (modeNumber < 0 || modeNumber >= modeCount) continue;
872
- const mode = modes[modeNumber];
873
- const mapping = mappings[mode.mapping];
874
- const n = mode.blockflag ? blocksize1 : blocksize0;
875
- const n2 = n >> 1;
876
- let prevFlag = false;
877
- let nextFlag = false;
878
- if (mode.blockflag) {
879
- prevFlag = reader.readBits(1) === 1;
880
- nextFlag = reader.readBits(1) === 1;
881
- }
882
-
883
- // floors
884
- for (let j = 0; j < channels; j++) {
885
- const floor = floors[mapping.submapFloor[mapping.mux[j]]];
886
- floorPosts[j] = decodeFloor1Posts(reader, floor, codebooks);
887
- zeroChannel[j] = floorPosts[j] === null;
888
- }
889
-
890
- // coupling keeps partners decoding together
891
- const reallyZero = zeroChannel.slice();
892
- for (const step of mapping.couplingSteps) {
893
- if (!zeroChannel[step.magnitude] || !zeroChannel[step.angle]) {
894
- zeroChannel[step.magnitude] = false;
895
- zeroChannel[step.angle] = false;
896
- }
897
- }
898
-
899
- // residues per submap
900
- for (let j = 0; j < channels; j++) spectrum[j].fill(0);
901
- for (let s = 0; s < mapping.submaps; s++) {
902
- const submapChannels = [];
903
- const doNotDecode = [];
904
- for (let j = 0; j < channels; j++) {
905
- if (mapping.mux[j] !== s) continue;
906
- submapChannels.push(spectrum[j]);
907
- doNotDecode.push(zeroChannel[j]);
908
- }
909
- if (!submapChannels.length) continue;
910
- decodeResidue(residues[mapping.submapResidue[s]], reader, codebooks, submapChannels, doNotDecode, n2);
911
- }
912
-
913
- // inverse coupling (reverse order)
914
- for (let i = mapping.couplingSteps.length - 1; i >= 0; i--) {
915
- const {
916
- magnitude,
917
- angle
918
- } = mapping.couplingSteps[i];
919
- const magnitudeVector = spectrum[magnitude];
920
- const angleVector = spectrum[angle];
921
- for (let k = 0; k < n2; k++) {
922
- const m = magnitudeVector[k];
923
- const a = angleVector[k];
924
- let newM;
925
- let newA;
926
- if (m > 0) {
927
- if (a > 0) {
928
- newM = m;
929
- newA = m - a;
930
- } else {
931
- newA = m;
932
- newM = m + a;
933
- }
934
- } else if (a > 0) {
935
- newM = m;
936
- newA = m + a;
937
- } else {
938
- newA = m;
939
- newM = m - a;
940
- }
941
- magnitudeVector[k] = newM;
942
- angleVector[k] = newA;
943
- }
944
- }
945
-
946
- // floor curve multiply + IMDCT + window
947
- const window = getWindow(n, mode.blockflag, prevFlag, nextFlag, blocksize0);
948
- for (let j = 0; j < channels; j++) {
949
- const out = imdctOut[j];
950
- if (reallyZero[j]) {
951
- out.fill(0, 0, n);
952
- continue;
953
- }
954
- const floor = floors[mapping.submapFloor[mapping.mux[j]]];
955
- computeFloor1Curve(floor, floorPosts[j], n2, floorCurves[j]);
956
- const curve = floorCurves[j];
957
- const spec = spectrum[j];
958
- for (let k = 0; k < n2; k++) spec[k] *= curve[k];
959
- imdct(spec.subarray(0, n2), out, n);
960
- for (let k = 0; k < n; k++) out[k] *= window[k];
961
- }
962
-
963
- // center-aligned overlap-add
964
- if (prevN) {
965
- const outCount = prevN + n >> 2;
966
- const curStart = (prevN >> 2) - (n >> 2);
967
- const chunk = [];
968
- for (let j = 0; j < channels; j++) {
969
- const samples = new Float32Array(outCount);
970
- const tail = tails[j];
971
- const cur = imdctOut[j];
972
- for (let i = 0; i < outCount; i++) {
973
- let value = i < prevN >> 1 ? tail[i] : 0;
974
- const curIndex = i - curStart;
975
- if (curIndex >= 0) value += cur[curIndex];
976
- samples[i] = value;
977
- }
978
- chunk.push(samples);
979
- }
980
- outputChunks.push(chunk);
981
- totalSamples += outCount;
982
- }
983
- for (let j = 0; j < channels; j++) {
984
- tails[j].set(imdctOut[j].subarray(n >> 1, n));
985
- }
986
- prevN = n;
987
- packetCount++;
988
- }
989
-
990
- // assemble planar output, trimmed to the stream's final granule
991
- const finalCount = lastGranule && lastGranule < totalSamples ? lastGranule : totalSamples;
992
- const channelData = [];
993
- for (let j = 0; j < channels; j++) channelData.push(new Float32Array(finalCount));
994
- let cursor = 0;
995
- for (const chunk of outputChunks) {
996
- const copyCount = Math.min(chunk[0].length, finalCount - cursor);
997
- if (copyCount <= 0) break;
998
- for (let j = 0; j < channels; j++) {
999
- channelData[j].set(chunk[j].subarray(0, copyCount), cursor);
1000
- }
1001
- cursor += copyCount;
1002
- }
1003
- return {
1004
- channels,
1005
- sampleRate,
1006
- sampleCount: finalCount,
1007
- channelData,
1008
- vendor,
1009
- comments,
1010
- loop,
1011
- packetCount,
1012
- declaredGranule: lastGranule
1013
- };
1014
- }
1015
-
1016
- export { decodeVorbis, extractOggPackets };
1017
- //# sourceMappingURL=vorbis.js.map
1
+ import { imdct, vorbisWindowSlope } from './imdct.js';
2
+
3
+ /**
4
+ * Pure-JS Ogg Vorbis PCM decoder.
5
+ *
6
+ * Implements Vorbis I decode: setup-header codebooks (huffman + VQ), floor
7
+ * type 1 with the spec's exact integer line rendering, residue types 0/1/2,
8
+ * square-polar channel de-coupling, IMDCT, and windowed center-aligned
9
+ * overlap-add with final granule trimming. Behavior follows the Vorbis I
10
+ * specification with stb_vorbis (public domain) consulted as a reference;
11
+ * floor type 0 streams are rejected (never produced by modern encoders).
12
+ */
13
+
14
+ const NO_CODE = 255;
15
+ const FAST_BITS = 10;
16
+ const FAST_SIZE = 1 << FAST_BITS;
17
+
18
+ /**
19
+ * The floor1 amplitude table from the Vorbis I specification
20
+ * (inverse_db_table); indexed by the integer floor curve value.
21
+ */
22
+ const INVERSE_DB_TABLE = new Float32Array([1.0649863e-07, 1.1341951e-07, 1.2079015e-07, 1.2863978e-07, 1.3699951e-07, 1.4590251e-07, 1.5538408e-07, 1.6548181e-07, 1.7623575e-07, 1.8768855e-07, 1.9988561e-07, 2.1287530e-07, 2.2670913e-07, 2.4144197e-07, 2.5713223e-07, 2.7384213e-07, 2.9163793e-07, 3.1059021e-07, 3.3077411e-07, 3.5226968e-07, 3.7516214e-07, 3.9954229e-07, 4.2550680e-07, 4.5315863e-07, 4.8260743e-07, 5.1396998e-07, 5.4737065e-07, 5.8294187e-07, 6.2082472e-07, 6.6116941e-07, 7.0413592e-07, 7.4989464e-07, 7.9862701e-07, 8.5052630e-07, 9.0579828e-07, 9.6466216e-07, 1.0273513e-06, 1.0941144e-06, 1.1652161e-06, 1.2409384e-06, 1.3215816e-06, 1.4074654e-06, 1.4989305e-06, 1.5963394e-06, 1.7000785e-06, 1.8105592e-06, 1.9282195e-06, 2.0535261e-06, 2.1869758e-06, 2.3290978e-06, 2.4804557e-06, 2.6416497e-06, 2.8133190e-06, 2.9961443e-06, 3.1908506e-06, 3.3982101e-06, 3.6190449e-06, 3.8542308e-06, 4.1047004e-06, 4.3714470e-06, 4.6555282e-06, 4.9580707e-06, 5.2802740e-06, 5.6234160e-06, 5.9888572e-06, 6.3780469e-06, 6.7925283e-06, 7.2339451e-06, 7.7040476e-06, 8.2047000e-06, 8.7378876e-06, 9.3057248e-06, 9.9104632e-06, 1.0554501e-05, 1.1240392e-05, 1.1970856e-05, 1.2748789e-05, 1.3577278e-05, 1.4459606e-05, 1.5399272e-05, 1.6400004e-05, 1.7465768e-05, 1.8600792e-05, 1.9809576e-05, 2.1096914e-05, 2.2467911e-05, 2.3928002e-05, 2.5482978e-05, 2.7139006e-05, 2.8902651e-05, 3.0780908e-05, 3.2781225e-05, 3.4911534e-05, 3.7180282e-05, 3.9596466e-05, 4.2169667e-05, 4.4910090e-05, 4.7828601e-05, 5.0936773e-05, 5.4246931e-05, 5.7772202e-05, 6.1526565e-05, 6.5524908e-05, 6.9783085e-05, 7.4317983e-05, 7.9147585e-05, 8.4291040e-05, 8.9768747e-05, 9.5602426e-05, 0.00010181521, 0.00010843174, 0.00011547824, 0.00012298267, 0.00013097477, 0.00013948625, 0.00014855085, 0.00015820453, 0.00016848555, 0.00017943469, 0.00019109536, 0.00020351382, 0.00021673929, 0.00023082423, 0.00024582449, 0.00026179955, 0.00027881276, 0.00029693158, 0.00031622787, 0.00033677814, 0.00035866388, 0.00038197188, 0.00040679456, 0.00043323036, 0.00046138411, 0.00049136745, 0.00052329927, 0.00055730621, 0.00059352311, 0.00063209358, 0.00067317058, 0.00071691700, 0.00076350630, 0.00081312324, 0.00086596457, 0.00092223983, 0.00098217216, 0.0010459992, 0.0011139742, 0.0011863665, 0.0012634633, 0.0013455702, 0.0014330129, 0.0015261382, 0.0016253153, 0.0017309374, 0.0018434235, 0.0019632195, 0.0020908006, 0.0022266726, 0.0023713743, 0.0025254795, 0.0026895994, 0.0028643847, 0.0030505286, 0.0032487691, 0.0034598925, 0.0036847358, 0.0039241906, 0.0041792066, 0.0044507950, 0.0047400328, 0.0050480668, 0.0053761186, 0.0057254891, 0.0060975636, 0.0064938176, 0.0069158225, 0.0073652516, 0.0078438871, 0.0083536271, 0.0088964928, 0.0094746370, 0.0100903520, 0.0107460800, 0.0114444210, 0.0121881440, 0.0129801980, 0.0138237250, 0.0147220680, 0.0156787910, 0.0166976870, 0.0177827970, 0.0189384230, 0.0201691490, 0.0214798540, 0.0228757350, 0.0243623300, 0.0259455310, 0.0276316180, 0.0294272760, 0.0313396260, 0.0333762520, 0.0355452280, 0.0378551570, 0.0403151990, 0.0429351080, 0.0457252730, 0.0486967580, 0.0518613480, 0.0552315910, 0.0588208500, 0.0626433610, 0.0667142790, 0.0710497490, 0.0756669620, 0.0805842270, 0.0858210440, 0.0913981790, 0.0973377470, 0.1036633000, 0.1103999300, 0.1175743400, 0.1252149800, 0.1333521500, 0.1420181300, 0.1512472700, 0.1610761700, 0.1715438000, 0.1826916800, 0.1945640200, 0.2072078800, 0.2206734200, 0.2350140200, 0.2502865600, 0.2665515900, 0.2838736100, 0.3023213200, 0.3219678600, 0.3428911400, 0.3651741400, 0.3889052100, 0.4141784700, 0.4410941200, 0.4697589000, 0.5002864800, 0.5327979100, 0.5674221200, 0.6042964000, 0.6435669900, 0.6853895900, 0.7299300700, 0.7773650400, 0.8278826000, 0.8816830700, 0.9389798000, 1.0]);
23
+ function decodeError(message) {
24
+ const error = new Error(`ogg: ${message}`);
25
+ error.code = "CJS_FORMAT_PARSE_ERROR";
26
+ return error;
27
+ }
28
+ function ilog(value) {
29
+ let result = 0;
30
+ let v = value | 0;
31
+ if (v < 0) return 0;
32
+ while (v) {
33
+ result++;
34
+ v >>= 1;
35
+ }
36
+ return result;
37
+ }
38
+ function float32Unpack(x) {
39
+ const mantissa = x & 0x1fffff;
40
+ const sign = x & 0x80000000;
41
+ const exponent = (x & 0x7fe00000) >>> 21;
42
+ const value = sign ? -mantissa : mantissa;
43
+ return value * Math.pow(2, exponent - 788);
44
+ }
45
+ function lookup1Values(entries, dimensions) {
46
+ if (dimensions === 0) return 0;
47
+ const bits = ilog(entries);
48
+ let vals = entries >>> Math.floor((bits - 1) * (dimensions - 1) / dimensions);
49
+ for (;;) {
50
+ let acc = 1;
51
+ let acc1 = 1;
52
+ for (let i = 0; i < dimensions; i++) {
53
+ acc *= vals;
54
+ acc1 *= vals + 1;
55
+ }
56
+ if (acc <= entries && acc1 > entries) return vals;
57
+ if (acc > entries) vals--;else vals++;
58
+ }
59
+ }
60
+
61
+ /**
62
+ * LSB-first bit reader over one Vorbis packet; reading past the end sets
63
+ * `eop` instead of throwing (end-of-packet is a defined decode condition).
64
+ */
65
+ class PacketReader {
66
+ /** Creates a PacketReader over caller-provided Ogg bytes and reader options. */
67
+ constructor(bytes) {
68
+ this.bytes = bytes;
69
+ this.position = 0;
70
+ this.bitBuffer = 0;
71
+ this.bitsLeft = 0;
72
+ this.eop = false;
73
+ }
74
+
75
+ /** Reads bits from the current Ogg binary reader. */
76
+ readBits(count) {
77
+ let value = 0;
78
+ for (let i = 0; i < count; i++) {
79
+ if (this.bitsLeft === 0) {
80
+ if (this.position >= this.bytes.length) {
81
+ this.eop = true;
82
+ return -1;
83
+ }
84
+ this.bitBuffer = this.bytes[this.position++];
85
+ this.bitsLeft = 8;
86
+ }
87
+ value |= (this.bitBuffer & 1) << i;
88
+ this.bitBuffer >>= 1;
89
+ this.bitsLeft--;
90
+ }
91
+ return value >>> 0;
92
+ }
93
+ }
94
+
95
+ /**
96
+ * Vorbis codebook that builds Huffman decode trees and VQ lookup vectors for
97
+ * scalar and vector packet decoding.
98
+ */
99
+ class Codebook {
100
+ /** Creates a Codebook with caller-provided initial state. */
101
+ constructor() {
102
+ this.dimensions = 0;
103
+ this.entries = 0;
104
+ this.lookupType = 0;
105
+ this.sequenceP = false;
106
+ this.quantvals = 0;
107
+ this.values = null;
108
+ this.fastTable = null;
109
+ this.treeNodes = null;
110
+ this.maxLength = 0;
111
+ }
112
+
113
+ /**
114
+ * Builds the canonical Vorbis Huffman decode tree for this codebook for the
115
+ * Ogg decoder.
116
+ */
117
+ buildHuffman(lengths) {
118
+ const available = new Uint32Array(33);
119
+ this.fastTable = new Int32Array(FAST_SIZE).fill(-1);
120
+ // flat binary trie: two child slots per node; negative = -(symbol+1)
121
+ const nodes = [0, 0];
122
+ let assigned = false;
123
+ for (let symbol = 0; symbol < lengths.length; symbol++) {
124
+ const length = lengths[symbol];
125
+ if (length === NO_CODE) continue;
126
+ if (length > this.maxLength) this.maxLength = length;
127
+ let code;
128
+ if (!assigned) {
129
+ code = 0;
130
+ assigned = true;
131
+ for (let i = 1; i <= length; i++) available[i] = 1 << 32 - i >>> 0;
132
+ } else {
133
+ let z = length;
134
+ while (z > 0 && !available[z]) z--;
135
+ if (z === 0) throw decodeError("over-specified huffman codebook");
136
+ code = available[z];
137
+ available[z] = 0;
138
+ if (z !== length) {
139
+ for (let y = length; y > z; y--) {
140
+ available[y] = code + (1 << 32 - y) >>> 0;
141
+ }
142
+ }
143
+ }
144
+
145
+ // reversed code: first stream bit in bit 0
146
+ let reversed = 0;
147
+ for (let i = 0; i < length; i++) {
148
+ reversed |= (code >>> 31 - i & 1) << i;
149
+ }
150
+ reversed >>>= 0;
151
+ if (length <= FAST_BITS) {
152
+ for (let z = reversed; z < FAST_SIZE; z += 1 << length) {
153
+ this.fastTable[z] = symbol << 6 | length;
154
+ }
155
+ } else {
156
+ let node = 0;
157
+ for (let i = 0; i < length; i++) {
158
+ const bit = reversed >>> i & 1;
159
+ const slot = node * 2 + bit;
160
+ if (i === length - 1) {
161
+ nodes[slot] = -(symbol + 1);
162
+ } else {
163
+ if (!nodes[slot]) {
164
+ nodes[slot] = nodes.length / 2;
165
+ nodes.push(0, 0);
166
+ }
167
+ node = nodes[slot];
168
+ }
169
+ }
170
+ }
171
+ }
172
+ this.treeNodes = nodes;
173
+ }
174
+
175
+ /** Decodes the Ogg input into a normalized Ogg decoder result. */
176
+ decode(reader) {
177
+ // fast path: peek up to FAST_BITS without consuming
178
+ let peek = 0;
179
+ let peekBits = 0;
180
+ const savedPosition = reader.position;
181
+ const savedBuffer = reader.bitBuffer;
182
+ const savedLeft = reader.bitsLeft;
183
+ while (peekBits < FAST_BITS) {
184
+ const bit = reader.readBits(1);
185
+ if (bit < 0) break;
186
+ peek |= bit << peekBits;
187
+ peekBits++;
188
+ }
189
+ reader.position = savedPosition;
190
+ reader.bitBuffer = savedBuffer;
191
+ reader.bitsLeft = savedLeft;
192
+ reader.eop = false;
193
+ if (peekBits === FAST_BITS) {
194
+ const hit = this.fastTable[peek];
195
+ if (hit >= 0) {
196
+ reader.readBits(hit & 63);
197
+ return hit >> 6;
198
+ }
199
+ } else {
200
+ // short remainder: try fast table over what's left
201
+ const hit = this.fastTable[peek];
202
+ if (hit >= 0 && (hit & 63) <= peekBits) {
203
+ reader.readBits(hit & 63);
204
+ return hit >> 6;
205
+ }
206
+ }
207
+
208
+ // slow path: walk the trie bit by bit
209
+ let node = 0;
210
+ for (let i = 0; i < this.maxLength; i++) {
211
+ const bit = reader.readBits(1);
212
+ if (bit < 0) return -1;
213
+ const value = this.treeNodes[node * 2 + bit];
214
+ if (value < 0) return -value - 1;
215
+ if (value === 0) throw decodeError("invalid huffman code in stream");
216
+ node = value;
217
+ }
218
+ throw decodeError("huffman walk exceeded max code length");
219
+ }
220
+
221
+ /** Reconstructs one vector-quantized codebook component for the Ogg decoder. */
222
+ vqValue(symbol, element) {
223
+ if (this.lookupType === 1) {
224
+ let index = symbol;
225
+ for (let i = 0; i < element; i++) index = Math.floor(index / this.quantvals);
226
+ return this.values[index % this.quantvals];
227
+ }
228
+ return this.values[symbol * this.dimensions + element];
229
+ }
230
+ }
231
+ function parseCodebook(reader) {
232
+ const sync = reader.readBits(24);
233
+ if (sync !== 0x564342) throw decodeError("invalid codebook sync pattern");
234
+ const book = new Codebook();
235
+ book.dimensions = reader.readBits(16);
236
+ book.entries = reader.readBits(24);
237
+ const lengths = new Uint8Array(book.entries);
238
+ const ordered = reader.readBits(1);
239
+ if (ordered) {
240
+ let currentEntry = 0;
241
+ let currentLength = reader.readBits(5) + 1;
242
+ while (currentEntry < book.entries) {
243
+ const number = reader.readBits(ilog(book.entries - currentEntry));
244
+ if (reader.eop) throw decodeError("codebook lengths truncated");
245
+ for (let i = 0; i < number; i++) lengths[currentEntry + i] = currentLength;
246
+ currentEntry += number;
247
+ currentLength++;
248
+ if (currentEntry > book.entries) throw decodeError("codebook entry overflow");
249
+ }
250
+ } else {
251
+ const sparse = reader.readBits(1);
252
+ for (let i = 0; i < book.entries; i++) {
253
+ const present = sparse ? reader.readBits(1) : 1;
254
+ lengths[i] = present ? reader.readBits(5) + 1 : NO_CODE;
255
+ }
256
+ }
257
+ if (reader.eop) throw decodeError("codebook lengths truncated");
258
+ book.buildHuffman(lengths);
259
+ book.lookupType = reader.readBits(4);
260
+ if (book.lookupType > 2) throw decodeError(`invalid codebook lookup type ${book.lookupType}`);
261
+ if (book.lookupType > 0) {
262
+ const minimum = float32Unpack(reader.readBits(32));
263
+ const delta = float32Unpack(reader.readBits(32));
264
+ const valueBits = reader.readBits(4) + 1;
265
+ book.sequenceP = reader.readBits(1) === 1;
266
+ const count = book.lookupType === 1 ? lookup1Values(book.entries, book.dimensions) : book.entries * book.dimensions;
267
+ book.quantvals = book.lookupType === 1 ? count : 0;
268
+ book.values = new Float32Array(count);
269
+ for (let i = 0; i < count; i++) {
270
+ book.values[i] = minimum + reader.readBits(valueBits) * delta;
271
+ }
272
+ if (reader.eop) throw decodeError("codebook lookup values truncated");
273
+ }
274
+ return book;
275
+ }
276
+ function parseFloor(reader, codebooks) {
277
+ const type = reader.readBits(16);
278
+ if (type !== 1) {
279
+ throw decodeError(`floor type ${type} is not supported (only floor 1)`);
280
+ }
281
+ const floor = {
282
+ partitions: reader.readBits(5),
283
+ partitionClassList: [],
284
+ classDimensions: [],
285
+ classSubclasses: [],
286
+ classMasterbooks: [],
287
+ subclassBooks: [],
288
+ multiplier: 0,
289
+ rangebits: 0,
290
+ xList: [0, 0]
291
+ };
292
+ let maximumClass = -1;
293
+ for (let i = 0; i < floor.partitions; i++) {
294
+ const partitionClass = reader.readBits(4);
295
+ floor.partitionClassList.push(partitionClass);
296
+ if (partitionClass > maximumClass) maximumClass = partitionClass;
297
+ }
298
+ for (let i = 0; i <= maximumClass; i++) {
299
+ floor.classDimensions.push(reader.readBits(3) + 1);
300
+ const subclasses = reader.readBits(2);
301
+ floor.classSubclasses.push(subclasses);
302
+ floor.classMasterbooks.push(subclasses ? reader.readBits(8) : -1);
303
+ const books = [];
304
+ for (let j = 0; j < 1 << subclasses; j++) {
305
+ books.push(reader.readBits(8) - 1);
306
+ }
307
+ floor.subclassBooks.push(books);
308
+ }
309
+ floor.multiplier = reader.readBits(2) + 1;
310
+ floor.rangebits = reader.readBits(4);
311
+ floor.xList = [0, 1 << floor.rangebits];
312
+ for (let i = 0; i < floor.partitions; i++) {
313
+ for (let j = 0; j < floor.classDimensions[floor.partitionClassList[i]]; j++) {
314
+ floor.xList.push(reader.readBits(floor.rangebits));
315
+ }
316
+ }
317
+ if (reader.eop) throw decodeError("floor configuration truncated");
318
+ for (const bookIndex of [...floor.classMasterbooks, ...floor.subclassBooks.flat()]) {
319
+ if (bookIndex >= codebooks.length) throw decodeError("floor references invalid codebook");
320
+ }
321
+
322
+ // sorted render order over unique X positions, computed once
323
+ floor.sortedIndex = floor.xList.map((x, index) => ({
324
+ x,
325
+ index
326
+ })).sort((a, b) => a.x - b.x || a.index - b.index).map(entry => entry.index);
327
+
328
+ // neighbor tables (over original ordering) computed once
329
+ floor.lowNeighbors = [];
330
+ floor.highNeighbors = [];
331
+ for (let i = 2; i < floor.xList.length; i++) {
332
+ let low = 0;
333
+ let high = 1;
334
+ for (let j = 0; j < i; j++) {
335
+ if (floor.xList[j] < floor.xList[i] && floor.xList[j] >= floor.xList[low]) low = j;
336
+ if (floor.xList[j] > floor.xList[i] && floor.xList[j] <= floor.xList[high]) high = j;
337
+ }
338
+ floor.lowNeighbors.push(low);
339
+ floor.highNeighbors.push(high);
340
+ }
341
+ return floor;
342
+ }
343
+ function parseResidue(reader, codebooks) {
344
+ const type = reader.readBits(16);
345
+ if (type > 2) throw decodeError(`invalid residue type ${type}`);
346
+ const residue = {
347
+ type,
348
+ begin: reader.readBits(24),
349
+ end: reader.readBits(24),
350
+ partSize: reader.readBits(24) + 1,
351
+ classifications: reader.readBits(6) + 1,
352
+ classbook: reader.readBits(8),
353
+ books: []
354
+ };
355
+ if (residue.classbook >= codebooks.length) throw decodeError("residue classbook out of range");
356
+ const cascades = [];
357
+ for (let i = 0; i < residue.classifications; i++) {
358
+ const lowBits = reader.readBits(3);
359
+ const flag = reader.readBits(1);
360
+ const highBits = flag ? reader.readBits(5) : 0;
361
+ cascades.push(highBits * 8 + lowBits);
362
+ }
363
+ for (let i = 0; i < residue.classifications; i++) {
364
+ const passBooks = [];
365
+ for (let pass = 0; pass < 8; pass++) {
366
+ if (cascades[i] & 1 << pass) {
367
+ const bookIndex = reader.readBits(8);
368
+ if (bookIndex >= codebooks.length) throw decodeError("residue book out of range");
369
+ if (codebooks[bookIndex].lookupType === 0) throw decodeError("residue book has no lookup values");
370
+ passBooks.push(bookIndex);
371
+ } else {
372
+ passBooks.push(-1);
373
+ }
374
+ }
375
+ residue.books.push(passBooks);
376
+ }
377
+ if (reader.eop) throw decodeError("residue configuration truncated");
378
+ return residue;
379
+ }
380
+ function parseMapping(reader, channels, floorCount, residueCount) {
381
+ const type = reader.readBits(16);
382
+ if (type !== 0) throw decodeError(`invalid mapping type ${type}`);
383
+ const mapping = {
384
+ submaps: 1,
385
+ couplingSteps: [],
386
+ mux: new Array(channels).fill(0),
387
+ submapFloor: [],
388
+ submapResidue: []
389
+ };
390
+ if (reader.readBits(1)) mapping.submaps = reader.readBits(4) + 1;
391
+ if (reader.readBits(1)) {
392
+ const steps = reader.readBits(8) + 1;
393
+ const bits = ilog(channels - 1);
394
+ for (let i = 0; i < steps; i++) {
395
+ const magnitude = reader.readBits(bits);
396
+ const angle = reader.readBits(bits);
397
+ if (magnitude === angle || magnitude >= channels || angle >= channels) {
398
+ throw decodeError("invalid channel coupling");
399
+ }
400
+ mapping.couplingSteps.push({
401
+ magnitude,
402
+ angle
403
+ });
404
+ }
405
+ }
406
+ if (reader.readBits(2) !== 0) throw decodeError("mapping reserved bits nonzero");
407
+ if (mapping.submaps > 1) {
408
+ for (let i = 0; i < channels; i++) {
409
+ mapping.mux[i] = reader.readBits(4);
410
+ if (mapping.mux[i] >= mapping.submaps) throw decodeError("mapping mux out of range");
411
+ }
412
+ }
413
+ for (let i = 0; i < mapping.submaps; i++) {
414
+ reader.readBits(8);
415
+ const floorIndex = reader.readBits(8);
416
+ const residueIndex = reader.readBits(8);
417
+ if (floorIndex >= floorCount || residueIndex >= residueCount) {
418
+ throw decodeError("mapping references invalid floor or residue");
419
+ }
420
+ mapping.submapFloor.push(floorIndex);
421
+ mapping.submapResidue.push(residueIndex);
422
+ }
423
+ return mapping;
424
+ }
425
+ const FLOOR1_RANGES = [256, 128, 86, 64];
426
+ function renderPoint(x0, y0, x1, y1, x) {
427
+ const dy = y1 - y0;
428
+ const adx = x1 - x0;
429
+ const err = Math.floor(Math.abs(dy) * (x - x0) / adx);
430
+ return dy < 0 ? y0 - err : y0 + err;
431
+ }
432
+ function decodeFloor1Posts(reader, floor, codebooks) {
433
+ if (reader.readBits(1) !== 1) return null;
434
+ const range = FLOOR1_RANGES[floor.multiplier - 1];
435
+ const posts = new Int32Array(floor.xList.length);
436
+ const yBits = ilog(range - 1);
437
+ posts[0] = reader.readBits(yBits);
438
+ posts[1] = reader.readBits(yBits);
439
+ let offset = 2;
440
+ for (let i = 0; i < floor.partitions; i++) {
441
+ const partitionClass = floor.partitionClassList[i];
442
+ const cdim = floor.classDimensions[partitionClass];
443
+ const cbits = floor.classSubclasses[partitionClass];
444
+ const csub = (1 << cbits) - 1;
445
+ let cval = 0;
446
+ if (cbits) {
447
+ cval = codebooks[floor.classMasterbooks[partitionClass]].decode(reader);
448
+ if (cval < 0) return null;
449
+ }
450
+ for (let j = 0; j < cdim; j++) {
451
+ const bookIndex = floor.subclassBooks[partitionClass][cval & csub];
452
+ cval >>= cbits;
453
+ if (bookIndex >= 0) {
454
+ const value = codebooks[bookIndex].decode(reader);
455
+ if (value < 0) return null;
456
+ posts[offset + j] = value;
457
+ } else {
458
+ posts[offset + j] = 0;
459
+ }
460
+ }
461
+ offset += cdim;
462
+ }
463
+ if (reader.eop) return null;
464
+ return posts;
465
+ }
466
+ function computeFloor1Curve(floor, posts, n2, output) {
467
+ const range = FLOOR1_RANGES[floor.multiplier - 1];
468
+ const count = floor.xList.length;
469
+ const finalY = new Int32Array(count);
470
+ const step2 = new Uint8Array(count);
471
+ step2[0] = 1;
472
+ step2[1] = 1;
473
+ finalY[0] = posts[0];
474
+ finalY[1] = posts[1];
475
+ for (let i = 2; i < count; i++) {
476
+ const low = floor.lowNeighbors[i - 2];
477
+ const high = floor.highNeighbors[i - 2];
478
+ const predicted = renderPoint(floor.xList[low], finalY[low], floor.xList[high], finalY[high], floor.xList[i]);
479
+ const value = posts[i];
480
+ const highroom = range - predicted;
481
+ const lowroom = predicted;
482
+ const room = (highroom < lowroom ? highroom : lowroom) * 2;
483
+ if (value) {
484
+ step2[low] = 1;
485
+ step2[high] = 1;
486
+ step2[i] = 1;
487
+ if (value >= room) {
488
+ finalY[i] = highroom > lowroom ? value - lowroom + predicted : predicted - value + highroom - 1;
489
+ } else {
490
+ finalY[i] = value & 1 ? predicted - (value + 1 >> 1) : predicted + (value >> 1);
491
+ }
492
+ } else {
493
+ step2[i] = 0;
494
+ finalY[i] = predicted;
495
+ }
496
+ }
497
+ output.fill(0);
498
+ let lx = 0;
499
+ let ly = finalY[floor.sortedIndex[0]] * floor.multiplier;
500
+ for (const index of floor.sortedIndex) {
501
+ if (!step2[index]) continue;
502
+ const hx = floor.xList[index];
503
+ const hy = finalY[index] * floor.multiplier;
504
+ if (hx > lx) renderLine(lx, ly, hx, hy, output, n2);
505
+ if (hx >= n2) return;
506
+ lx = hx;
507
+ ly = hy;
508
+ }
509
+ if (lx < n2) {
510
+ for (let i = lx; i < n2; i++) output[i] = INVERSE_DB_TABLE[ly & 255];
511
+ }
512
+ }
513
+ function renderLine(x0, y0, x1, y1, output, n) {
514
+ const dy = y1 - y0;
515
+ const adx = x1 - x0;
516
+ let ady = Math.abs(dy);
517
+ const base = dy / adx | 0;
518
+ const sy = dy < 0 ? base - 1 : base + 1;
519
+ let x = x0;
520
+ let y = y0;
521
+ let err = 0;
522
+ ady -= Math.abs(base) * adx;
523
+ const limit = x1 > n ? n : x1;
524
+ if (x < limit) output[x] = INVERSE_DB_TABLE[y & 255];
525
+ for (x++; x < limit; x++) {
526
+ err += ady;
527
+ if (err >= adx) {
528
+ err -= adx;
529
+ y += sy;
530
+ } else {
531
+ y += base;
532
+ }
533
+ output[x] = INVERSE_DB_TABLE[y & 255];
534
+ }
535
+ }
536
+ function decodeResidue(residue, reader, codebooks, buffers, doNotDecode, n2) {
537
+ const channelCount = buffers.length;
538
+ const classbook = codebooks[residue.classbook];
539
+ const classwords = classbook.dimensions;
540
+ const actualSize = residue.type === 2 ? n2 * channelCount : n2;
541
+ const limitBegin = Math.min(residue.begin, actualSize);
542
+ const limitEnd = Math.min(residue.end, actualSize);
543
+ const nRead = limitEnd - limitBegin;
544
+ const partRead = Math.floor(nRead / residue.partSize);
545
+ if (partRead <= 0) return;
546
+ if (residue.type === 2 && channelCount > 1) {
547
+ if (doNotDecode.every(Boolean)) return;
548
+ const classifications = new Int32Array(partRead + classwords);
549
+ for (let pass = 0; pass < 8; pass++) {
550
+ let pcount = 0;
551
+ while (pcount < partRead) {
552
+ if (pass === 0) {
553
+ let symbol = classbook.decode(reader);
554
+ if (symbol < 0) return;
555
+ for (let i = classwords - 1; i >= 0; i--) {
556
+ classifications[i + pcount] = symbol % residue.classifications;
557
+ symbol = Math.floor(symbol / residue.classifications);
558
+ }
559
+ }
560
+ for (let i = 0; i < classwords && pcount < partRead; i++, pcount++) {
561
+ const z = residue.begin + pcount * residue.partSize;
562
+ const bookIndex = residue.books[classifications[pcount]][pass];
563
+ if (bookIndex < 0) continue;
564
+ const book = codebooks[bookIndex];
565
+ let cInter = z % channelCount;
566
+ let pInter = Math.floor(z / channelCount);
567
+ let decoded = 0;
568
+ while (decoded < residue.partSize) {
569
+ const symbol = book.decode(reader);
570
+ if (symbol < 0) return;
571
+ let last = 0;
572
+ for (let e = 0; e < book.dimensions; e++) {
573
+ const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
574
+ if (book.sequenceP) last = value;
575
+ buffers[cInter][pInter] += value;
576
+ cInter++;
577
+ if (cInter === channelCount) {
578
+ cInter = 0;
579
+ pInter++;
580
+ }
581
+ }
582
+ decoded += book.dimensions;
583
+ }
584
+ }
585
+ }
586
+ }
587
+ return;
588
+ }
589
+ const classifications = [];
590
+ for (let j = 0; j < channelCount; j++) classifications.push(new Int32Array(partRead + classwords));
591
+ for (let pass = 0; pass < 8; pass++) {
592
+ let pcount = 0;
593
+ while (pcount < partRead) {
594
+ if (pass === 0) {
595
+ for (let j = 0; j < channelCount; j++) {
596
+ if (doNotDecode[j]) continue;
597
+ let symbol = classbook.decode(reader);
598
+ if (symbol < 0) return;
599
+ for (let i = classwords - 1; i >= 0; i--) {
600
+ classifications[j][i + pcount] = symbol % residue.classifications;
601
+ symbol = Math.floor(symbol / residue.classifications);
602
+ }
603
+ }
604
+ }
605
+ for (let i = 0; i < classwords && pcount < partRead; i++, pcount++) {
606
+ for (let j = 0; j < channelCount; j++) {
607
+ if (doNotDecode[j]) continue;
608
+ const bookIndex = residue.books[classifications[j][pcount]][pass];
609
+ if (bookIndex < 0) continue;
610
+ const book = codebooks[bookIndex];
611
+ const target = buffers[j];
612
+ const offset = residue.begin + pcount * residue.partSize;
613
+ if (residue.type === 0) {
614
+ const step = Math.floor(residue.partSize / book.dimensions);
615
+ for (let k = 0; k < step; k++) {
616
+ const symbol = book.decode(reader);
617
+ if (symbol < 0) return;
618
+ let last = 0;
619
+ for (let e = 0; e < book.dimensions; e++) {
620
+ const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
621
+ if (book.sequenceP) last = value;
622
+ target[offset + k + e * step] += value;
623
+ }
624
+ }
625
+ } else {
626
+ let k = 0;
627
+ while (k < residue.partSize) {
628
+ const symbol = book.decode(reader);
629
+ if (symbol < 0) return;
630
+ let last = 0;
631
+ for (let e = 0; e < book.dimensions; e++) {
632
+ const value = book.vqValue(symbol, e) + (book.sequenceP ? last : 0);
633
+ if (book.sequenceP) last = value;
634
+ target[offset + k + e] += value;
635
+ }
636
+ k += book.dimensions;
637
+ }
638
+ }
639
+ }
640
+ }
641
+ }
642
+ }
643
+ }
644
+ function buildWindow(n, blockflag, prevFlag, nextFlag, blocksize0) {
645
+ const window = new Float32Array(n);
646
+ const center = n >> 1;
647
+ let leftStart = 0;
648
+ let leftEnd = center;
649
+ let leftN = center;
650
+ let rightStart = center;
651
+ let rightEnd = n;
652
+ let rightN = center;
653
+ if (blockflag && !prevFlag) {
654
+ leftStart = (n >> 2) - (blocksize0 >> 2);
655
+ leftEnd = (n >> 2) + (blocksize0 >> 2);
656
+ leftN = blocksize0 >> 1;
657
+ }
658
+ if (blockflag && !nextFlag) {
659
+ rightStart = n - (n >> 2) - (blocksize0 >> 2);
660
+ rightEnd = n - (n >> 2) + (blocksize0 >> 2);
661
+ rightN = blocksize0 >> 1;
662
+ }
663
+ const leftSlope = vorbisWindowSlope(leftN);
664
+ const rightSlope = vorbisWindowSlope(rightN);
665
+ for (let i = leftStart; i < leftEnd; i++) window[i] = leftSlope[i - leftStart];
666
+ for (let i = leftEnd; i < rightStart; i++) window[i] = 1;
667
+ for (let i = rightStart; i < rightEnd; i++) window[i] = rightSlope[rightN - 1 - (i - rightStart)];
668
+ return window;
669
+ }
670
+ const windowVariantCache = new Map();
671
+ function getWindow(n, blockflag, prevFlag, nextFlag, blocksize0) {
672
+ const key = `${n}:${blockflag ? 1 : 0}${prevFlag ? 1 : 0}${nextFlag ? 1 : 0}:${blocksize0}`;
673
+ let window = windowVariantCache.get(key);
674
+ if (!window) {
675
+ window = buildWindow(n, blockflag, prevFlag, nextFlag, blocksize0);
676
+ windowVariantCache.set(key, window);
677
+ }
678
+ return window;
679
+ }
680
+
681
+ /**
682
+ * Split an Ogg stream into the first logical stream's packets.
683
+ *
684
+ * @param {Uint8Array} bytes Ogg bytes (already CRC-validated by inspection).
685
+ * @returns {object} `{ packets, lastGranule }` for the first stream.
686
+ */
687
+ function extractOggPackets(bytes) {
688
+ const packets = [];
689
+ let pending = [];
690
+ let serial = null;
691
+ let lastGranule = 0;
692
+ let offset = 0;
693
+ while (offset + 27 <= bytes.length) {
694
+ if (bytes[offset] !== 0x4f || bytes[offset + 1] !== 0x67 || bytes[offset + 2] !== 0x67 || bytes[offset + 3] !== 0x53) {
695
+ throw decodeError(`invalid page at byte ${offset}`);
696
+ }
697
+ const headerType = bytes[offset + 5];
698
+ let granule = 0;
699
+ for (let i = 7; i >= 0; i--) granule = granule * 256 + bytes[offset + 6 + i];
700
+ const pageSerial = (bytes[offset + 14] | bytes[offset + 15] << 8 | bytes[offset + 16] << 16 | bytes[offset + 17] * 0x1000000) >>> 0;
701
+ const segmentCount = bytes[offset + 26];
702
+ const tableOffset = offset + 27;
703
+ let cursor = tableOffset + segmentCount;
704
+ const isBos = (headerType & 0x02) !== 0;
705
+ if (serial === null && isBos) serial = pageSerial;
706
+ const ours = pageSerial === serial;
707
+ for (let i = 0; i < segmentCount; i++) {
708
+ const length = bytes[tableOffset + i];
709
+ if (ours && length > 0) pending.push(bytes.subarray(cursor, cursor + length));
710
+ cursor += length;
711
+ if (length < 255 && ours) {
712
+ packets.push(concatChunks(pending));
713
+ pending = [];
714
+ }
715
+ }
716
+ if (ours && granule !== 0xffffffffffffffff && Number.isSafeInteger(granule)) {
717
+ lastGranule = granule;
718
+ }
719
+ offset = cursor;
720
+ }
721
+ if (pending.length) packets.push(concatChunks(pending));
722
+ return {
723
+ packets,
724
+ lastGranule
725
+ };
726
+ }
727
+ function concatChunks(chunks) {
728
+ if (chunks.length === 1) return chunks[0];
729
+ let total = 0;
730
+ for (const chunk of chunks) total += chunk.length;
731
+ const bytes = new Uint8Array(total);
732
+ let cursor = 0;
733
+ for (const chunk of chunks) {
734
+ bytes.set(chunk, cursor);
735
+ cursor += chunk.length;
736
+ }
737
+ return bytes;
738
+ }
739
+ function expectHeader(packet, type) {
740
+ if (packet.length < 7 || packet[0] !== type || packet[1] !== 0x76 || packet[2] !== 0x6f || packet[3] !== 0x72 || packet[4] !== 0x62 || packet[5] !== 0x69 || packet[6] !== 0x73) {
741
+ throw decodeError(`missing vorbis header packet type ${type}`);
742
+ }
743
+ const reader = new PacketReader(packet);
744
+ reader.readBits(8);
745
+ for (let i = 0; i < 6; i++) reader.readBits(8);
746
+ return reader;
747
+ }
748
+ function parseComments(packet) {
749
+ const reader = new PacketReader(packet);
750
+ reader.readBits(8);
751
+ for (let i = 0; i < 6; i++) reader.readBits(8);
752
+ const readString = () => {
753
+ const length = reader.readBits(32);
754
+ let text = "";
755
+ for (let i = 0; i < length; i++) text += String.fromCharCode(reader.readBits(8));
756
+ return text;
757
+ };
758
+ const vendor = readString();
759
+ const count = reader.readBits(32);
760
+ const comments = [];
761
+ for (let i = 0; i < count && !reader.eop; i++) comments.push(readString());
762
+ let loop = null;
763
+ let loopStart = null;
764
+ let loopEnd = null;
765
+ for (const comment of comments) {
766
+ const match = /^(loopstart|loopend)=(\d+)$/iu.exec(comment);
767
+ if (!match) continue;
768
+ if (match[1].toLowerCase() === "loopstart") loopStart = Number(match[2]);else loopEnd = Number(match[2]);
769
+ }
770
+ if (loopStart !== null && loopEnd !== null) loop = {
771
+ start: loopStart,
772
+ end: loopEnd
773
+ };
774
+ return {
775
+ vendor,
776
+ comments,
777
+ loop
778
+ };
779
+ }
780
+
781
+ /**
782
+ * Decode an Ogg Vorbis stream to planar float PCM.
783
+ *
784
+ * @param {Uint8Array} bytes Complete Ogg Vorbis stream bytes.
785
+ * @returns {object} `{ channels, sampleRate, sampleCount, channelData, vendor, comments, loop, packetCount }`.
786
+ */
787
+ function decodeVorbis(bytes) {
788
+ const {
789
+ packets,
790
+ lastGranule
791
+ } = extractOggPackets(bytes);
792
+ if (packets.length < 3) throw decodeError("stream has no audio packets");
793
+
794
+ // identification header
795
+ const identReader = expectHeader(packets[0], 1);
796
+ if (identReader.readBits(32) !== 0) throw decodeError("unsupported vorbis version");
797
+ const channels = identReader.readBits(8);
798
+ const sampleRate = identReader.readBits(32);
799
+ identReader.readBits(32);
800
+ identReader.readBits(32);
801
+ identReader.readBits(32);
802
+ const blocksize0 = 1 << identReader.readBits(4);
803
+ const blocksize1 = 1 << identReader.readBits(4);
804
+ if (!channels || !sampleRate) throw decodeError("invalid identification header");
805
+ if (blocksize0 > blocksize1 || blocksize0 < 64 || blocksize1 > 8192) {
806
+ throw decodeError("invalid blocksizes");
807
+ }
808
+ const {
809
+ vendor,
810
+ comments,
811
+ loop
812
+ } = parseComments(packets[1]);
813
+
814
+ // setup header
815
+ const setup = expectHeader(packets[2], 5);
816
+ const codebooks = [];
817
+ const codebookCount = setup.readBits(8) + 1;
818
+ for (let i = 0; i < codebookCount; i++) codebooks.push(parseCodebook(setup));
819
+ const timeCount = setup.readBits(6) + 1;
820
+ for (let i = 0; i < timeCount; i++) {
821
+ if (setup.readBits(16) !== 0) throw decodeError("nonzero time-domain transform");
822
+ }
823
+ const floors = [];
824
+ const floorCount = setup.readBits(6) + 1;
825
+ for (let i = 0; i < floorCount; i++) floors.push(parseFloor(setup, codebooks));
826
+ const residues = [];
827
+ const residueCount = setup.readBits(6) + 1;
828
+ for (let i = 0; i < residueCount; i++) residues.push(parseResidue(setup, codebooks));
829
+ const mappings = [];
830
+ const mappingCount = setup.readBits(6) + 1;
831
+ for (let i = 0; i < mappingCount; i++) mappings.push(parseMapping(setup, channels, floorCount, residueCount));
832
+ const modes = [];
833
+ const modeCount = setup.readBits(6) + 1;
834
+ for (let i = 0; i < modeCount; i++) {
835
+ const blockflag = setup.readBits(1) === 1;
836
+ if (setup.readBits(16) !== 0 || setup.readBits(16) !== 0) {
837
+ throw decodeError("nonzero mode window/transform type");
838
+ }
839
+ const mapping = setup.readBits(8);
840
+ if (mapping >= mappingCount) throw decodeError("mode references invalid mapping");
841
+ modes.push({
842
+ blockflag,
843
+ mapping
844
+ });
845
+ }
846
+ if (setup.readBits(1) !== 1) throw decodeError("missing setup framing bit");
847
+ const modeBits = ilog(modeCount - 1);
848
+
849
+ // synthesis state
850
+ const n1 = blocksize1;
851
+ const spectrum = [];
852
+ const floorCurves = [];
853
+ const imdctOut = [];
854
+ for (let j = 0; j < channels; j++) {
855
+ spectrum.push(new Float32Array(n1 >> 1));
856
+ floorCurves.push(new Float32Array(n1 >> 1));
857
+ imdctOut.push(new Float32Array(n1));
858
+ }
859
+ const zeroChannel = new Array(channels).fill(false);
860
+ const floorPosts = new Array(channels).fill(null);
861
+ const tails = [];
862
+ for (let j = 0; j < channels; j++) tails.push(new Float32Array(n1 >> 1));
863
+ let prevN = 0;
864
+ const outputChunks = [];
865
+ let totalSamples = 0;
866
+ let packetCount = 0;
867
+ for (let p = 3; p < packets.length; p++) {
868
+ const reader = new PacketReader(packets[p]);
869
+ if (reader.readBits(1) !== 0) continue;
870
+ const modeNumber = reader.readBits(modeBits);
871
+ if (modeNumber < 0 || modeNumber >= modeCount) continue;
872
+ const mode = modes[modeNumber];
873
+ const mapping = mappings[mode.mapping];
874
+ const n = mode.blockflag ? blocksize1 : blocksize0;
875
+ const n2 = n >> 1;
876
+ let prevFlag = false;
877
+ let nextFlag = false;
878
+ if (mode.blockflag) {
879
+ prevFlag = reader.readBits(1) === 1;
880
+ nextFlag = reader.readBits(1) === 1;
881
+ }
882
+
883
+ // floors
884
+ for (let j = 0; j < channels; j++) {
885
+ const floor = floors[mapping.submapFloor[mapping.mux[j]]];
886
+ floorPosts[j] = decodeFloor1Posts(reader, floor, codebooks);
887
+ zeroChannel[j] = floorPosts[j] === null;
888
+ }
889
+
890
+ // coupling keeps partners decoding together
891
+ const reallyZero = zeroChannel.slice();
892
+ for (const step of mapping.couplingSteps) {
893
+ if (!zeroChannel[step.magnitude] || !zeroChannel[step.angle]) {
894
+ zeroChannel[step.magnitude] = false;
895
+ zeroChannel[step.angle] = false;
896
+ }
897
+ }
898
+
899
+ // residues per submap
900
+ for (let j = 0; j < channels; j++) spectrum[j].fill(0);
901
+ for (let s = 0; s < mapping.submaps; s++) {
902
+ const submapChannels = [];
903
+ const doNotDecode = [];
904
+ for (let j = 0; j < channels; j++) {
905
+ if (mapping.mux[j] !== s) continue;
906
+ submapChannels.push(spectrum[j]);
907
+ doNotDecode.push(zeroChannel[j]);
908
+ }
909
+ if (!submapChannels.length) continue;
910
+ decodeResidue(residues[mapping.submapResidue[s]], reader, codebooks, submapChannels, doNotDecode, n2);
911
+ }
912
+
913
+ // inverse coupling (reverse order)
914
+ for (let i = mapping.couplingSteps.length - 1; i >= 0; i--) {
915
+ const {
916
+ magnitude,
917
+ angle
918
+ } = mapping.couplingSteps[i];
919
+ const magnitudeVector = spectrum[magnitude];
920
+ const angleVector = spectrum[angle];
921
+ for (let k = 0; k < n2; k++) {
922
+ const m = magnitudeVector[k];
923
+ const a = angleVector[k];
924
+ let newM;
925
+ let newA;
926
+ if (m > 0) {
927
+ if (a > 0) {
928
+ newM = m;
929
+ newA = m - a;
930
+ } else {
931
+ newA = m;
932
+ newM = m + a;
933
+ }
934
+ } else if (a > 0) {
935
+ newM = m;
936
+ newA = m + a;
937
+ } else {
938
+ newA = m;
939
+ newM = m - a;
940
+ }
941
+ magnitudeVector[k] = newM;
942
+ angleVector[k] = newA;
943
+ }
944
+ }
945
+
946
+ // floor curve multiply + IMDCT + window
947
+ const window = getWindow(n, mode.blockflag, prevFlag, nextFlag, blocksize0);
948
+ for (let j = 0; j < channels; j++) {
949
+ const out = imdctOut[j];
950
+ if (reallyZero[j]) {
951
+ out.fill(0, 0, n);
952
+ continue;
953
+ }
954
+ const floor = floors[mapping.submapFloor[mapping.mux[j]]];
955
+ computeFloor1Curve(floor, floorPosts[j], n2, floorCurves[j]);
956
+ const curve = floorCurves[j];
957
+ const spec = spectrum[j];
958
+ for (let k = 0; k < n2; k++) spec[k] *= curve[k];
959
+ imdct(spec.subarray(0, n2), out, n);
960
+ for (let k = 0; k < n; k++) out[k] *= window[k];
961
+ }
962
+
963
+ // center-aligned overlap-add
964
+ if (prevN) {
965
+ const outCount = prevN + n >> 2;
966
+ const curStart = (prevN >> 2) - (n >> 2);
967
+ const chunk = [];
968
+ for (let j = 0; j < channels; j++) {
969
+ const samples = new Float32Array(outCount);
970
+ const tail = tails[j];
971
+ const cur = imdctOut[j];
972
+ for (let i = 0; i < outCount; i++) {
973
+ let value = i < prevN >> 1 ? tail[i] : 0;
974
+ const curIndex = i - curStart;
975
+ if (curIndex >= 0) value += cur[curIndex];
976
+ samples[i] = value;
977
+ }
978
+ chunk.push(samples);
979
+ }
980
+ outputChunks.push(chunk);
981
+ totalSamples += outCount;
982
+ }
983
+ for (let j = 0; j < channels; j++) {
984
+ tails[j].set(imdctOut[j].subarray(n >> 1, n));
985
+ }
986
+ prevN = n;
987
+ packetCount++;
988
+ }
989
+
990
+ // assemble planar output, trimmed to the stream's final granule
991
+ const finalCount = lastGranule && lastGranule < totalSamples ? lastGranule : totalSamples;
992
+ const channelData = [];
993
+ for (let j = 0; j < channels; j++) channelData.push(new Float32Array(finalCount));
994
+ let cursor = 0;
995
+ for (const chunk of outputChunks) {
996
+ const copyCount = Math.min(chunk[0].length, finalCount - cursor);
997
+ if (copyCount <= 0) break;
998
+ for (let j = 0; j < channels; j++) {
999
+ channelData[j].set(chunk[j].subarray(0, copyCount), cursor);
1000
+ }
1001
+ cursor += copyCount;
1002
+ }
1003
+ return {
1004
+ channels,
1005
+ sampleRate,
1006
+ sampleCount: finalCount,
1007
+ channelData,
1008
+ vendor,
1009
+ comments,
1010
+ loop,
1011
+ packetCount,
1012
+ declaredGranule: lastGranule
1013
+ };
1014
+ }
1015
+
1016
+ export { decodeVorbis, extractOggPackets };
1017
+ //# sourceMappingURL=vorbis.js.map