@carbonenginejs/runtime-resource 0.8.0 → 0.9.1

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 (297) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +31 -29
  3. package/README.md +67 -548
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3005 -3005
  6. package/dist/CjsResManQueue.js +214 -214
  7. package/dist/CjsResource.js +566 -566
  8. package/dist/CjsResourceSource.js +68 -59
  9. package/dist/CjsResourceSource.js.map +1 -1
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +197 -192
  13. package/dist/format/CjsFormat.js.map +1 -1
  14. package/dist/format/CjsReader.js +18 -18
  15. package/dist/format/CjsResourceProbe.js +277 -277
  16. package/dist/format/payloadContract.js +173 -173
  17. package/dist/formats/black/CjsBlackFormat.js +278 -278
  18. package/dist/formats/black/core/CjsBlackBinaryReader.js +157 -153
  19. package/dist/formats/black/core/CjsBlackBinaryReader.js.map +1 -1
  20. package/dist/formats/black/core/CjsBlackPropertyReaders.js +387 -382
  21. package/dist/formats/black/core/CjsBlackPropertyReaders.js.map +1 -1
  22. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  23. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +437 -433
  24. package/dist/formats/black/core/CjsBlackSchemaRegistry.js.map +1 -1
  25. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -0
  26. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js.map +1 -0
  27. package/dist/formats/black/core/blackConstants.js +7 -7
  28. package/dist/formats/black/core/blackDefinitions.js +10 -10
  29. package/dist/formats/black/core/blackDefinitions.js.map +1 -1
  30. package/dist/formats/black/core/blackEnums.js +6 -6
  31. package/dist/formats/black/core/blackSchema.js +3 -3
  32. package/dist/formats/black/core/blackVersion.js +22 -22
  33. package/dist/formats/black/core/helpers.js +182 -182
  34. package/dist/formats/black/core/schema.js +4 -4
  35. package/dist/formats/black/index.js +2 -2
  36. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  37. package/dist/formats/bnk/core/graph.js +140 -140
  38. package/dist/formats/bnk/core/helpers.js +409 -409
  39. package/dist/formats/bnk/core/musicNodes.js +493 -489
  40. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  41. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  42. package/dist/formats/bnk/index.js +2 -2
  43. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  44. package/dist/formats/cmf/core/binary.js +123 -118
  45. package/dist/formats/cmf/core/binary.js.map +1 -1
  46. package/dist/formats/cmf/core/buffers.js +233 -233
  47. package/dist/formats/cmf/core/constants.js +47 -47
  48. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  49. package/dist/formats/cmf/core/helpers.js +287 -287
  50. package/dist/formats/cmf/core/pack.js +276 -276
  51. package/dist/formats/cmf/core/schema.js +364 -364
  52. package/dist/formats/cmf/core/shared.js +268 -268
  53. package/dist/formats/cmf/core/writer.js +517 -517
  54. package/dist/formats/cmf/index.js +2 -2
  55. package/dist/formats/dds/CjsDdsFormat.js +200 -193
  56. package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
  57. package/dist/formats/dds/core/bc6h.js +288 -288
  58. package/dist/formats/dds/core/bc7.js +256 -251
  59. package/dist/formats/dds/core/bc7.js.map +1 -1
  60. package/dist/formats/dds/core/helpers.js +815 -815
  61. package/dist/formats/dds/index.js +2 -2
  62. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  63. package/dist/formats/fbx/core/helpers.js +3911 -3901
  64. package/dist/formats/fbx/core/helpers.js.map +1 -1
  65. package/dist/formats/fbx/index.js +2 -2
  66. package/dist/formats/flac/CjsFlacFormat.js +93 -87
  67. package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
  68. package/dist/formats/flac/core/helpers.js +295 -295
  69. package/dist/formats/flac/index.js +2 -2
  70. package/dist/formats/gif/CjsGifFormat.js +92 -87
  71. package/dist/formats/gif/CjsGifFormat.js.map +1 -1
  72. package/dist/formats/gif/core/helpers.js +360 -360
  73. package/dist/formats/gif/index.js +2 -2
  74. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  75. package/dist/formats/gltf/core/helpers.js +292 -292
  76. package/dist/formats/gltf/core/json.js +79 -79
  77. package/dist/formats/gltf/core/parser.js +666 -666
  78. package/dist/formats/gltf/core/targets.js +163 -163
  79. package/dist/formats/gltf/index.js +2 -2
  80. package/dist/formats/gr2/CjsGr2Format.js +46 -0
  81. package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
  82. package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
  83. package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
  84. package/dist/formats/gr2/core/bitknit2.js +280 -0
  85. package/dist/formats/gr2/core/bitknit2.js.map +1 -0
  86. package/dist/formats/gr2/core/curves.js +1047 -0
  87. package/dist/formats/gr2/core/curves.js.map +1 -0
  88. package/dist/formats/gr2/core/gsf.js +72 -0
  89. package/dist/formats/gr2/core/gsf.js.map +1 -0
  90. package/dist/formats/gr2/core/helpers.js +332 -0
  91. package/dist/formats/gr2/core/helpers.js.map +1 -0
  92. package/dist/formats/gr2/core/json.js +622 -0
  93. package/dist/formats/gr2/core/json.js.map +1 -0
  94. package/dist/formats/gr2/core/oodle1.js +388 -0
  95. package/dist/formats/gr2/core/oodle1.js.map +1 -0
  96. package/dist/formats/gr2/core/reader.js +617 -0
  97. package/dist/formats/gr2/core/reader.js.map +1 -0
  98. package/dist/formats/gr2/core/tangents.js +48 -0
  99. package/dist/formats/gr2/core/tangents.js.map +1 -0
  100. package/dist/formats/gr2/core/targets.js +351 -0
  101. package/dist/formats/gr2/core/targets.js.map +1 -0
  102. package/dist/formats/gr2/index.js +3 -0
  103. package/dist/formats/gr2/index.js.map +1 -0
  104. package/dist/formats/index.js +30 -23
  105. package/dist/formats/index.js.map +1 -1
  106. package/dist/formats/jpeg/CjsJpegFormat.js +212 -206
  107. package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
  108. package/dist/formats/jpeg/core/helpers.js +350 -350
  109. package/dist/formats/jpeg/core/jpeg.js +387 -377
  110. package/dist/formats/jpeg/core/jpeg.js.map +1 -1
  111. package/dist/formats/jpeg/index.js +2 -2
  112. package/dist/formats/mp3/CjsMp3Format.js +197 -192
  113. package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
  114. package/dist/formats/mp3/core/helpers.js +338 -338
  115. package/dist/formats/mp3/index.js +2 -2
  116. package/dist/formats/mp4/CjsMp4Format.js +197 -191
  117. package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
  118. package/dist/formats/mp4/core/helpers.js +449 -449
  119. package/dist/formats/mp4/index.js +2 -2
  120. package/dist/formats/obj/CjsObjFormat.js +253 -253
  121. package/dist/formats/obj/core/helpers.js +573 -573
  122. package/dist/formats/obj/core/json.js +64 -64
  123. package/dist/formats/obj/core/parser.js +321 -321
  124. package/dist/formats/obj/index.js +2 -2
  125. package/dist/formats/ogg/CjsOggFormat.js +94 -88
  126. package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
  127. package/dist/formats/ogg/core/helpers.js +387 -387
  128. package/dist/formats/ogg/core/imdct.js +178 -178
  129. package/dist/formats/ogg/core/vorbis.js +1004 -999
  130. package/dist/formats/ogg/core/vorbis.js.map +1 -1
  131. package/dist/formats/ogg/index.js +2 -2
  132. package/dist/formats/png/CjsPngFormat.js +201 -195
  133. package/dist/formats/png/CjsPngFormat.js.map +1 -1
  134. package/dist/formats/png/core/helpers.js +583 -583
  135. package/dist/formats/png/index.js +2 -2
  136. package/dist/formats/red/CjsRedFormat.js +261 -261
  137. package/dist/formats/red/core/CjsRedReader.js +194 -194
  138. package/dist/formats/red/core/blackDefinitions.js +3 -3
  139. package/dist/formats/red/core/helpers.js +139 -139
  140. package/dist/formats/red/core/redGraph.js +68 -68
  141. package/dist/formats/red/core/schema.js +4 -4
  142. package/dist/formats/red/index.js +2 -2
  143. package/dist/formats/stl/CjsStlFormat.js +365 -365
  144. package/dist/formats/stl/core/helpers.js +261 -261
  145. package/dist/formats/stl/core/json.js +51 -51
  146. package/dist/formats/stl/core/stl.js +634 -629
  147. package/dist/formats/stl/core/stl.js.map +1 -1
  148. package/dist/formats/stl/core/targets.js +163 -163
  149. package/dist/formats/stl/index.js +2 -2
  150. package/dist/formats/tga/CjsTgaFormat.js +197 -192
  151. package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
  152. package/dist/formats/tga/core/helpers.js +446 -446
  153. package/dist/formats/tga/index.js +2 -2
  154. package/dist/formats/wav/CjsWavFormat.js +198 -192
  155. package/dist/formats/wav/CjsWavFormat.js.map +1 -1
  156. package/dist/formats/wav/core/helpers.js +328 -328
  157. package/dist/formats/wav/index.js +2 -2
  158. package/dist/formats/webm/CjsWebmFormat.js +197 -191
  159. package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
  160. package/dist/formats/webm/core/helpers.js +537 -537
  161. package/dist/formats/webm/index.js +2 -2
  162. package/dist/formats/webp/CjsWebpFormat.js +91 -86
  163. package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
  164. package/dist/formats/webp/core/helpers.js +214 -214
  165. package/dist/formats/webp/index.js +2 -2
  166. package/dist/formats/wem/CjsWemFormat.js +242 -241
  167. package/dist/formats/wem/CjsWemFormat.js.map +1 -1
  168. package/dist/formats/wem/core/bitStream.js +259 -259
  169. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  170. package/dist/formats/wem/core/helpers.js +417 -417
  171. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  172. package/dist/formats/wem/core/ptadpcm.js +77 -77
  173. package/dist/formats/wem/core/resolve.js +121 -121
  174. package/dist/formats/wem/core/wemToOgg.js +485 -485
  175. package/dist/formats/wem/index.js +2 -2
  176. package/dist/formats/yaml/CjsYamlFormat.js +89 -83
  177. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  178. package/dist/formats/yaml/core/CjsYamlReader.js +311 -305
  179. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  180. package/dist/formats/yaml/core/helpers.js +160 -160
  181. package/dist/formats/yaml/index.js +2 -2
  182. package/dist/index.js +49 -48
  183. package/dist/index.js.map +1 -1
  184. package/dist/resourcePath.js +18 -18
  185. package/dist/resourceStates.js +9 -9
  186. package/dist/resources/AudioGeometryResData.js +47 -47
  187. package/dist/resources/GStateBindingCallbackData.js +31 -31
  188. package/dist/resources/MeshDecalData.js +37 -37
  189. package/dist/resources/MeshDecalLodData.js +34 -34
  190. package/dist/resources/Tr2EffectRes.js +71 -71
  191. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  192. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  193. package/dist/resources/Tr2ImageRes.js +114 -114
  194. package/dist/resources/Tr2LightProfileRes.js +40 -40
  195. package/dist/resources/Tr2MaterialArea.js +34 -34
  196. package/dist/resources/Tr2MaterialMesh.js +31 -31
  197. package/dist/resources/Tr2MaterialRes.js +34 -34
  198. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  199. package/dist/resources/Tr2TextureLodManager.js +80 -80
  200. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  201. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  202. package/dist/resources/Tr2TexturePipeline.js +52 -52
  203. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  204. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  205. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
  206. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
  207. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  208. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  209. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  210. package/dist/resources/TriGeometryRes.js +239 -239
  211. package/dist/resources/TriGeometryResAreaData.js +59 -59
  212. package/dist/resources/TriGeometryResJointData.js +38 -38
  213. package/dist/resources/TriGeometryResLodData.js +88 -88
  214. package/dist/resources/TriGeometryResMeshData.js +63 -63
  215. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  216. package/dist/resources/TriGrannyRes.js +43 -43
  217. package/dist/resources/TriJointBinding.js +38 -38
  218. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  219. package/dist/resources/TriRtGeometryConstants.js +88 -88
  220. package/dist/resources/TriTextureRes.js +304 -304
  221. package/dist/resources/enums.js +18 -18
  222. package/dist/resources/resourceBoundary.js +47 -47
  223. package/dist/resources/texturePipelineBehavior.js +308 -308
  224. package/dist/texture/CjsTextureArrayRes.js +406 -406
  225. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  226. package/docs/README.md +73 -0
  227. package/docs/architecture.md +86 -0
  228. package/docs/concepts/resource-lifecycle.md +217 -0
  229. package/docs/formats/README.md +105 -0
  230. package/docs/formats/gr2.md +161 -0
  231. package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
  232. package/docs/formats/stl.md +37 -0
  233. package/docs/formats/wwise.md +44 -0
  234. package/docs/reference/classes/README.md +33 -0
  235. package/docs/reference/classes/core.md +106 -0
  236. package/docs/reference/classes/dropped.md +46 -0
  237. package/docs/reference/classes/formats.md +522 -0
  238. package/docs/reference/classes/resources.md +346 -0
  239. package/docs/reference/classes/texture.md +26 -0
  240. package/docs/reference/events.md +92 -0
  241. package/docs/reference/motherlode-cache.md +244 -0
  242. package/docs/reference/queues.md +102 -0
  243. package/docs/reference/reload.md +107 -0
  244. package/docs/reference/texture-arrays.md +113 -0
  245. package/docs/reference/texture-pipeline.md +53 -0
  246. package/docs/roadmap.md +104 -0
  247. package/format-notices/black/LICENSE +21 -21
  248. package/format-notices/black/NOTICE +47 -47
  249. package/format-notices/bnk/LICENSE +21 -21
  250. package/format-notices/bnk/NOTICE +20 -20
  251. package/format-notices/cmf/LICENSE +21 -21
  252. package/format-notices/cmf/NOTICE +36 -36
  253. package/format-notices/dds/LICENSE +21 -21
  254. package/format-notices/dds/NOTICE +14 -14
  255. package/format-notices/fbx/LICENSE +21 -21
  256. package/format-notices/fbx/NOTICE +14 -14
  257. package/format-notices/flac/LICENSE +21 -21
  258. package/format-notices/flac/NOTICE +14 -14
  259. package/format-notices/gif/LICENSE +21 -21
  260. package/format-notices/gif/NOTICE +14 -14
  261. package/format-notices/gltf/LICENSE +21 -21
  262. package/format-notices/gltf/NOTICE +27 -27
  263. package/format-notices/gr2/LICENSE +21 -0
  264. package/format-notices/gr2/NOTICE +60 -0
  265. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
  266. package/format-notices/jpeg/LICENSE +21 -21
  267. package/format-notices/jpeg/NOTICE +14 -14
  268. package/format-notices/mp3/LICENSE +21 -21
  269. package/format-notices/mp3/NOTICE +14 -14
  270. package/format-notices/mp4/LICENSE +21 -21
  271. package/format-notices/mp4/NOTICE +14 -14
  272. package/format-notices/obj/LICENSE +21 -21
  273. package/format-notices/obj/NOTICE +26 -26
  274. package/format-notices/ogg/LICENSE +21 -21
  275. package/format-notices/ogg/NOTICE +28 -28
  276. package/format-notices/png/LICENSE +21 -21
  277. package/format-notices/png/NOTICE +14 -14
  278. package/format-notices/red/LICENSE +21 -21
  279. package/format-notices/red/NOTICE +31 -31
  280. package/format-notices/stl/LICENSE +21 -21
  281. package/format-notices/stl/NOTICE +21 -21
  282. package/format-notices/tga/LICENSE +21 -21
  283. package/format-notices/tga/NOTICE +14 -14
  284. package/format-notices/wav/LICENSE +21 -21
  285. package/format-notices/wav/NOTICE +14 -14
  286. package/format-notices/webm/LICENSE +21 -21
  287. package/format-notices/webm/NOTICE +14 -14
  288. package/format-notices/webp/LICENSE +21 -21
  289. package/format-notices/webp/NOTICE +14 -14
  290. package/format-notices/wem/LICENSE +57 -57
  291. package/format-notices/wem/NOTICE +33 -33
  292. package/format-notices/yaml/LICENSE +21 -21
  293. package/format-notices/yaml/NOTICE +44 -44
  294. package/package.json +52 -51
  295. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +0 -4
  296. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js.map +0 -1
  297. package/resource-lifecycle.md +0 -679
@@ -1,338 +1,338 @@
1
- const OUTPUT_AUDIO = "audio";
2
- const OUTPUT_PCM = "pcm";
3
- const OUTPUT_RAW = "raw";
4
- const OUTPUT_JSON = "json";
5
- const DEFAULT_VALUES = Object.freeze({
6
- emit: OUTPUT_RAW,
7
- inputType: "",
8
- source: ""
9
- });
10
- const DEBUG_OUTPUTS = Object.freeze({
11
- wav: "wavJson",
12
- mp3: "mp3Json"
13
- });
14
- function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsAudioFormat") {
15
- const values = {
16
- ...DEFAULT_VALUES,
17
- ...(base || {}),
18
- ...(options || {})
19
- };
20
- values.inputType = normalizeInputType(values.inputType);
21
- values.emit = normalizeEmit(values.emit, values.inputType, readerName);
22
- return values;
23
- }
24
- function normalizeInputType(inputType) {
25
- return inputType ? String(inputType).replace(/^\./u, "").toLowerCase() : "";
26
- }
27
- function normalizeEmit(emit, inputType, readerName) {
28
- if (emit === undefined || emit === null) return OUTPUT_RAW;
29
- if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
30
- if ([OUTPUT_AUDIO, OUTPUT_PCM, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
31
- if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
32
- throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
33
- }
34
- function toBytes(input) {
35
- if (input instanceof Uint8Array) return input;
36
- if (input instanceof ArrayBuffer) return new Uint8Array(input);
37
- if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
38
- throw new TypeError("Audio input must be Uint8Array, ArrayBuffer, or DataView");
39
- }
40
- function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
41
- const bytes = toBytes(input);
42
- const metadata = inspectBytes(bytes);
43
- if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
44
- throw new TypeError(`CjsAudioFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
45
- }
46
- return {
47
- payloadType: "audio",
48
- mediaTypes: ["audio"],
49
- byteLength: bytes.byteLength,
50
- sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
51
- ...metadata
52
- };
53
- }
54
- function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
55
- try {
56
- const metadata = inspectWithValues(input, values, expectedType);
57
- const mimeType = getAudioMimeType(metadata);
58
- const variants = [{
59
- kind: "raw",
60
- payloadType: "raw",
61
- codec: metadata.audioFormat || metadata.sourceFormat,
62
- mimeType,
63
- supported: true,
64
- containerOnly: true,
65
- isDecoded: false,
66
- pcmDecodeSupported: false
67
- }, {
68
- kind: "pcm",
69
- payloadType: "pcm",
70
- codec: "pcm",
71
- supported: false,
72
- reason: "MP3 PCM decode/output is not implemented yet."
73
- }];
74
- return {
75
- format: metadata.sourceFormat,
76
- source: values.source || "buffer",
77
- supported: metadata.sourceFormat ? "partial" : "none",
78
- confidence: metadata.sourceFormat ? 1 : 0,
79
- preferred: variants.find(variant => variant.supported)?.codec || "",
80
- reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized audio format.",
81
- metadata,
82
- variants,
83
- warnings: [],
84
- errors: []
85
- };
86
- } catch (error) {
87
- return {
88
- format: expectedType || values.inputType || "",
89
- source: values.source || "buffer",
90
- supported: "none",
91
- confidence: 0,
92
- preferred: "",
93
- reason: error.message,
94
- metadata: null,
95
- variants: [],
96
- warnings: [],
97
- errors: [error.message]
98
- };
99
- }
100
- }
101
- function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
102
- const bytes = toBytes(input);
103
- const metadata = inspectWithValues(bytes, values, expectedType);
104
- if (values.emit === OUTPUT_RAW) {
105
- return {
106
- payloadType: "raw",
107
- sourceFormat: metadata.sourceFormat,
108
- mimeType: getAudioMimeType(metadata),
109
- containerOnly: true,
110
- isDecoded: false,
111
- pcmDecodeSupported: false,
112
- metadata,
113
- bytes
114
- };
115
- }
116
- if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
117
- const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
118
- error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
119
- error.sourceFormat = metadata.sourceFormat;
120
- error.emit = values.emit;
121
- throw error;
122
- }
123
- function getAudioMimeType(metadata) {
124
- if (metadata.sourceFormat === "wav") return "audio/wav";
125
- return "audio/mpeg";
126
- }
127
- function toJsonValue(value) {
128
- if (value instanceof Uint8Array) return {
129
- byteLength: value.byteLength
130
- };
131
- if (Array.isArray(value)) return value.map(toJsonValue);
132
- if (value && typeof value === "object") {
133
- const output = {};
134
- for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
135
- return output;
136
- }
137
- return value;
138
- }
139
- function inspectBytes(bytes) {
140
- if (isWAV(bytes)) return inspectWAV(bytes);
141
- if (isMP3(bytes)) return inspectMP3(bytes);
142
- return {
143
- sourceFormat: "",
144
- audioFormat: ""
145
- };
146
- }
147
- function isWAV(bytes) {
148
- return bytes.byteLength >= 12 && fourCc(bytes, 0) === "RIFF" && fourCc(bytes, 8) === "WAVE";
149
- }
150
- function isMP3(bytes) {
151
- return bytes.byteLength >= 3 && (fourCc(bytes, 0, 3) === "ID3" || bytes[0] === 0xff && (bytes[1] & 0xe0) === 0xe0);
152
- }
153
- function inspectWAV(bytes) {
154
- let offset = 12;
155
- const info = {
156
- sourceFormat: "wav",
157
- audioFormat: "wav",
158
- sampleRate: 0,
159
- channels: 0,
160
- bitsPerSample: 0,
161
- dataBytes: 0
162
- };
163
- while (offset + 8 <= bytes.byteLength) {
164
- const id = fourCc(bytes, offset),
165
- size = readU32LE(bytes, offset + 4),
166
- dataOffset = offset + 8;
167
- if (id === "fmt " && dataOffset + 16 <= bytes.byteLength) {
168
- info.formatTag = readU16LE(bytes, dataOffset);
169
- info.channels = readU16LE(bytes, dataOffset + 2);
170
- info.sampleRate = readU32LE(bytes, dataOffset + 4);
171
- info.bitsPerSample = readU16LE(bytes, dataOffset + 14);
172
- }
173
- if (id === "data") info.dataBytes = size;
174
- offset = dataOffset + size + (size & 1);
175
- }
176
- return info;
177
- }
178
- function inspectMP3(bytes) {
179
- const frame = readMp3FrameHeader(bytes, findMp3FrameOffset(bytes));
180
- const id3 = readId3Header(bytes);
181
- const info = {
182
- sourceFormat: "mp3",
183
- audioFormat: "mp3",
184
- hasId3: !!id3,
185
- id3Version: id3?.version || 0,
186
- id3Revision: id3?.revision || 0,
187
- id3Flags: id3?.flags || 0,
188
- id3Size: id3?.size || 0,
189
- firstFrameOffset: frame?.offset || 0,
190
- version: frame?.version || "",
191
- layer: frame?.layer || "",
192
- bitrateKbps: frame?.bitrateKbps || 0,
193
- sampleRate: frame?.sampleRate || 0,
194
- channels: frame?.channels || 0,
195
- samplesPerFrame: frame?.samplesPerFrame || 0,
196
- frameLength: frame?.frameLength || 0,
197
- frameCount: 0,
198
- durationSeconds: 0,
199
- declaredFrameCount: 0,
200
- declaredByteCount: 0,
201
- vbrHeader: "",
202
- encoderDelay: 0,
203
- encoderPadding: 0
204
- };
205
- if (frame) {
206
- const vbr = readVbrHeader(bytes, frame);
207
- if (vbr) {
208
- info.declaredFrameCount = vbr.frameCount;
209
- info.declaredByteCount = vbr.byteCount;
210
- info.vbrHeader = vbr.kind;
211
- info.encoderDelay = vbr.encoderDelay;
212
- info.encoderPadding = vbr.encoderPadding;
213
- }
214
- let offset = frame.offset;
215
- while (offset + 4 <= bytes.byteLength && info.frameCount < 1000000) {
216
- const next = readMp3FrameHeader(bytes, offset);
217
- if (!next || next.frameLength <= 0) break;
218
- info.frameCount++;
219
- offset += next.frameLength;
220
- }
221
- const frameCount = info.declaredFrameCount || info.frameCount;
222
- const trimmedSamples = Math.max(0, frameCount * info.samplesPerFrame - info.encoderDelay - info.encoderPadding);
223
- info.durationSeconds = info.sampleRate ? trimmedSamples / info.sampleRate : 0;
224
- }
225
- return info;
226
- }
227
- function readId3Header(bytes) {
228
- if (bytes.byteLength < 10 || fourCc(bytes, 0, 3) !== "ID3") return null;
229
- return {
230
- version: bytes[3],
231
- revision: bytes[4],
232
- flags: bytes[5],
233
- size: bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9]
234
- };
235
- }
236
- function readVbrHeader(bytes, frame) {
237
- const sideInfoLength = frame.version === "mpeg1" ? frame.channels === 1 ? 17 : 32 : frame.channels === 1 ? 9 : 17;
238
- const xingOffset = frame.offset + 4 + sideInfoLength;
239
- for (const kind of ["Xing", "Info"]) {
240
- if (fourCc(bytes, xingOffset, 4) !== kind) continue;
241
- const flags = readU32BE(bytes, xingOffset + 4);
242
- const frameCount = (flags & 1) !== 0 ? readU32BE(bytes, xingOffset + 8) : 0;
243
- const byteCount = (flags & 2) !== 0 ? readU32BE(bytes, xingOffset + 12) : 0;
244
- const gapless = readLameGapless(bytes, xingOffset + 8 + ((flags & 1) !== 0 ? 4 : 0) + ((flags & 2) !== 0 ? 4 : 0) + ((flags & 4) !== 0 ? 100 : 0));
245
- return {
246
- kind,
247
- frameCount,
248
- byteCount,
249
- ...gapless
250
- };
251
- }
252
- const vbriOffset = frame.offset + 36;
253
- if (fourCc(bytes, vbriOffset, 4) === "VBRI") {
254
- return {
255
- kind: "VBRI",
256
- frameCount: readU32BE(bytes, vbriOffset + 14),
257
- byteCount: readU32BE(bytes, vbriOffset + 10),
258
- encoderDelay: 0,
259
- encoderPadding: 0
260
- };
261
- }
262
- return null;
263
- }
264
- function readLameGapless(bytes, searchStart) {
265
- const end = Math.min(bytes.byteLength - 3, searchStart + 160);
266
- for (let offset = searchStart; offset < end; offset++) {
267
- if (fourCc(bytes, offset, 4) !== "LAME") continue;
268
- const value = bytes[offset + 0x15] << 16 | bytes[offset + 0x16] << 8 | bytes[offset + 0x17];
269
- return {
270
- encoderDelay: value >>> 12 & 0xfff,
271
- encoderPadding: value & 0xfff
272
- };
273
- }
274
- return {
275
- encoderDelay: 0,
276
- encoderPadding: 0
277
- };
278
- }
279
- function findMp3FrameOffset(bytes) {
280
- let offset = 0;
281
- if (fourCc(bytes, 0, 3) === "ID3" && bytes.byteLength >= 10) {
282
- const size = bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9];
283
- offset = 10 + size + (bytes[5] & 0x10 ? 10 : 0);
284
- }
285
- for (; offset + 4 <= bytes.byteLength; offset++) {
286
- if (readMp3FrameHeader(bytes, offset)) return offset;
287
- }
288
- return -1;
289
- }
290
- function readMp3FrameHeader(bytes, offset) {
291
- if (offset < 0 || offset + 4 > bytes.byteLength) return null;
292
- const header = (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
293
- if ((header & 0xffe00000) >>> 0 !== 0xffe00000) return null;
294
- const versionBits = header >>> 19 & 3;
295
- const layerBits = header >>> 17 & 3;
296
- const bitrateIndex = header >>> 12 & 0xf;
297
- const sampleRateIndex = header >>> 10 & 3;
298
- const padding = header >>> 9 & 1;
299
- const channelMode = header >>> 6 & 3;
300
- if (versionBits === 1 || layerBits !== 1 || bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
301
- return null;
302
- }
303
- const version = versionBits === 3 ? "mpeg1" : versionBits === 2 ? "mpeg2" : "mpeg2.5";
304
- const bitrateTable = version === "mpeg1" ? [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320] : [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160];
305
- const sampleRateTable = version === "mpeg1" ? [44100, 48000, 32000] : version === "mpeg2" ? [22050, 24000, 16000] : [11025, 12000, 8000];
306
- const bitrateKbps = bitrateTable[bitrateIndex];
307
- const sampleRate = sampleRateTable[sampleRateIndex];
308
- const samplesPerFrame = version === "mpeg1" ? 1152 : 576;
309
- const frameLength = Math.floor((version === "mpeg1" ? 144000 : 72000) * bitrateKbps / sampleRate) + padding;
310
- if (offset + frameLength > bytes.byteLength) return null;
311
- return {
312
- offset,
313
- version,
314
- layer: "layer3",
315
- bitrateKbps,
316
- sampleRate,
317
- channels: channelMode === 3 ? 1 : 2,
318
- samplesPerFrame,
319
- frameLength
320
- };
321
- }
322
- function fourCc(bytes, offset, length = 4) {
323
- let value = "";
324
- for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);
325
- return value;
326
- }
327
- function readU16LE(bytes, offset) {
328
- return bytes[offset] | bytes[offset + 1] << 8;
329
- }
330
- function readU32LE(bytes, offset) {
331
- return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] * 0x1000000) >>> 0;
332
- }
333
- function readU32BE(bytes, offset) {
334
- return bytes[offset] * 0x1000000 + (bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
335
- }
336
-
337
- export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectBytes, inspectWithValues, isMP3, isSupportedWithValues, isWAV, normalizeEmit, normalizeInputType, normalizeValues, readWithValues, toBytes, toJsonValue };
338
- //# sourceMappingURL=helpers.js.map
1
+ const OUTPUT_AUDIO = "audio";
2
+ const OUTPUT_PCM = "pcm";
3
+ const OUTPUT_RAW = "raw";
4
+ const OUTPUT_JSON = "json";
5
+ const DEFAULT_VALUES = Object.freeze({
6
+ emit: OUTPUT_RAW,
7
+ inputType: "",
8
+ source: ""
9
+ });
10
+ const DEBUG_OUTPUTS = Object.freeze({
11
+ wav: "wavJson",
12
+ mp3: "mp3Json"
13
+ });
14
+ function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsAudioFormat") {
15
+ const values = {
16
+ ...DEFAULT_VALUES,
17
+ ...(base || {}),
18
+ ...(options || {})
19
+ };
20
+ values.inputType = normalizeInputType(values.inputType);
21
+ values.emit = normalizeEmit(values.emit, values.inputType, readerName);
22
+ return values;
23
+ }
24
+ function normalizeInputType(inputType) {
25
+ return inputType ? String(inputType).replace(/^\./u, "").toLowerCase() : "";
26
+ }
27
+ function normalizeEmit(emit, inputType, readerName) {
28
+ if (emit === undefined || emit === null) return OUTPUT_RAW;
29
+ if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
30
+ if ([OUTPUT_AUDIO, OUTPUT_PCM, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
31
+ if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
32
+ throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
33
+ }
34
+ function toBytes(input) {
35
+ if (input instanceof Uint8Array) return input;
36
+ if (input instanceof ArrayBuffer) return new Uint8Array(input);
37
+ if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
38
+ throw new TypeError("Audio input must be Uint8Array, ArrayBuffer, or DataView");
39
+ }
40
+ function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
41
+ const bytes = toBytes(input);
42
+ const metadata = inspectBytes(bytes);
43
+ if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
44
+ throw new TypeError(`CjsAudioFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
45
+ }
46
+ return {
47
+ payloadType: "audio",
48
+ mediaTypes: ["audio"],
49
+ byteLength: bytes.byteLength,
50
+ sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
51
+ ...metadata
52
+ };
53
+ }
54
+ function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
55
+ try {
56
+ const metadata = inspectWithValues(input, values, expectedType);
57
+ const mimeType = getAudioMimeType(metadata);
58
+ const variants = [{
59
+ kind: "raw",
60
+ payloadType: "raw",
61
+ codec: metadata.audioFormat || metadata.sourceFormat,
62
+ mimeType,
63
+ supported: true,
64
+ containerOnly: true,
65
+ isDecoded: false,
66
+ pcmDecodeSupported: false
67
+ }, {
68
+ kind: "pcm",
69
+ payloadType: "pcm",
70
+ codec: "pcm",
71
+ supported: false,
72
+ reason: "MP3 PCM decode/output is not implemented yet."
73
+ }];
74
+ return {
75
+ format: metadata.sourceFormat,
76
+ source: values.source || "buffer",
77
+ supported: metadata.sourceFormat ? "partial" : "none",
78
+ confidence: metadata.sourceFormat ? 1 : 0,
79
+ preferred: variants.find(variant => variant.supported)?.codec || "",
80
+ reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized audio format.",
81
+ metadata,
82
+ variants,
83
+ warnings: [],
84
+ errors: []
85
+ };
86
+ } catch (error) {
87
+ return {
88
+ format: expectedType || values.inputType || "",
89
+ source: values.source || "buffer",
90
+ supported: "none",
91
+ confidence: 0,
92
+ preferred: "",
93
+ reason: error.message,
94
+ metadata: null,
95
+ variants: [],
96
+ warnings: [],
97
+ errors: [error.message]
98
+ };
99
+ }
100
+ }
101
+ function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
102
+ const bytes = toBytes(input);
103
+ const metadata = inspectWithValues(bytes, values, expectedType);
104
+ if (values.emit === OUTPUT_RAW) {
105
+ return {
106
+ payloadType: "raw",
107
+ sourceFormat: metadata.sourceFormat,
108
+ mimeType: getAudioMimeType(metadata),
109
+ containerOnly: true,
110
+ isDecoded: false,
111
+ pcmDecodeSupported: false,
112
+ metadata,
113
+ bytes
114
+ };
115
+ }
116
+ if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
117
+ const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
118
+ error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
119
+ error.sourceFormat = metadata.sourceFormat;
120
+ error.emit = values.emit;
121
+ throw error;
122
+ }
123
+ function getAudioMimeType(metadata) {
124
+ if (metadata.sourceFormat === "wav") return "audio/wav";
125
+ return "audio/mpeg";
126
+ }
127
+ function toJsonValue(value) {
128
+ if (value instanceof Uint8Array) return {
129
+ byteLength: value.byteLength
130
+ };
131
+ if (Array.isArray(value)) return value.map(toJsonValue);
132
+ if (value && typeof value === "object") {
133
+ const output = {};
134
+ for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
135
+ return output;
136
+ }
137
+ return value;
138
+ }
139
+ function inspectBytes(bytes) {
140
+ if (isWAV(bytes)) return inspectWAV(bytes);
141
+ if (isMP3(bytes)) return inspectMP3(bytes);
142
+ return {
143
+ sourceFormat: "",
144
+ audioFormat: ""
145
+ };
146
+ }
147
+ function isWAV(bytes) {
148
+ return bytes.byteLength >= 12 && fourCc(bytes, 0) === "RIFF" && fourCc(bytes, 8) === "WAVE";
149
+ }
150
+ function isMP3(bytes) {
151
+ return bytes.byteLength >= 3 && (fourCc(bytes, 0, 3) === "ID3" || bytes[0] === 0xff && (bytes[1] & 0xe0) === 0xe0);
152
+ }
153
+ function inspectWAV(bytes) {
154
+ let offset = 12;
155
+ const info = {
156
+ sourceFormat: "wav",
157
+ audioFormat: "wav",
158
+ sampleRate: 0,
159
+ channels: 0,
160
+ bitsPerSample: 0,
161
+ dataBytes: 0
162
+ };
163
+ while (offset + 8 <= bytes.byteLength) {
164
+ const id = fourCc(bytes, offset),
165
+ size = readU32LE(bytes, offset + 4),
166
+ dataOffset = offset + 8;
167
+ if (id === "fmt " && dataOffset + 16 <= bytes.byteLength) {
168
+ info.formatTag = readU16LE(bytes, dataOffset);
169
+ info.channels = readU16LE(bytes, dataOffset + 2);
170
+ info.sampleRate = readU32LE(bytes, dataOffset + 4);
171
+ info.bitsPerSample = readU16LE(bytes, dataOffset + 14);
172
+ }
173
+ if (id === "data") info.dataBytes = size;
174
+ offset = dataOffset + size + (size & 1);
175
+ }
176
+ return info;
177
+ }
178
+ function inspectMP3(bytes) {
179
+ const frame = readMp3FrameHeader(bytes, findMp3FrameOffset(bytes));
180
+ const id3 = readId3Header(bytes);
181
+ const info = {
182
+ sourceFormat: "mp3",
183
+ audioFormat: "mp3",
184
+ hasId3: !!id3,
185
+ id3Version: id3?.version || 0,
186
+ id3Revision: id3?.revision || 0,
187
+ id3Flags: id3?.flags || 0,
188
+ id3Size: id3?.size || 0,
189
+ firstFrameOffset: frame?.offset || 0,
190
+ version: frame?.version || "",
191
+ layer: frame?.layer || "",
192
+ bitrateKbps: frame?.bitrateKbps || 0,
193
+ sampleRate: frame?.sampleRate || 0,
194
+ channels: frame?.channels || 0,
195
+ samplesPerFrame: frame?.samplesPerFrame || 0,
196
+ frameLength: frame?.frameLength || 0,
197
+ frameCount: 0,
198
+ durationSeconds: 0,
199
+ declaredFrameCount: 0,
200
+ declaredByteCount: 0,
201
+ vbrHeader: "",
202
+ encoderDelay: 0,
203
+ encoderPadding: 0
204
+ };
205
+ if (frame) {
206
+ const vbr = readVbrHeader(bytes, frame);
207
+ if (vbr) {
208
+ info.declaredFrameCount = vbr.frameCount;
209
+ info.declaredByteCount = vbr.byteCount;
210
+ info.vbrHeader = vbr.kind;
211
+ info.encoderDelay = vbr.encoderDelay;
212
+ info.encoderPadding = vbr.encoderPadding;
213
+ }
214
+ let offset = frame.offset;
215
+ while (offset + 4 <= bytes.byteLength && info.frameCount < 1000000) {
216
+ const next = readMp3FrameHeader(bytes, offset);
217
+ if (!next || next.frameLength <= 0) break;
218
+ info.frameCount++;
219
+ offset += next.frameLength;
220
+ }
221
+ const frameCount = info.declaredFrameCount || info.frameCount;
222
+ const trimmedSamples = Math.max(0, frameCount * info.samplesPerFrame - info.encoderDelay - info.encoderPadding);
223
+ info.durationSeconds = info.sampleRate ? trimmedSamples / info.sampleRate : 0;
224
+ }
225
+ return info;
226
+ }
227
+ function readId3Header(bytes) {
228
+ if (bytes.byteLength < 10 || fourCc(bytes, 0, 3) !== "ID3") return null;
229
+ return {
230
+ version: bytes[3],
231
+ revision: bytes[4],
232
+ flags: bytes[5],
233
+ size: bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9]
234
+ };
235
+ }
236
+ function readVbrHeader(bytes, frame) {
237
+ const sideInfoLength = frame.version === "mpeg1" ? frame.channels === 1 ? 17 : 32 : frame.channels === 1 ? 9 : 17;
238
+ const xingOffset = frame.offset + 4 + sideInfoLength;
239
+ for (const kind of ["Xing", "Info"]) {
240
+ if (fourCc(bytes, xingOffset, 4) !== kind) continue;
241
+ const flags = readU32BE(bytes, xingOffset + 4);
242
+ const frameCount = (flags & 1) !== 0 ? readU32BE(bytes, xingOffset + 8) : 0;
243
+ const byteCount = (flags & 2) !== 0 ? readU32BE(bytes, xingOffset + 12) : 0;
244
+ const gapless = readLameGapless(bytes, xingOffset + 8 + ((flags & 1) !== 0 ? 4 : 0) + ((flags & 2) !== 0 ? 4 : 0) + ((flags & 4) !== 0 ? 100 : 0));
245
+ return {
246
+ kind,
247
+ frameCount,
248
+ byteCount,
249
+ ...gapless
250
+ };
251
+ }
252
+ const vbriOffset = frame.offset + 36;
253
+ if (fourCc(bytes, vbriOffset, 4) === "VBRI") {
254
+ return {
255
+ kind: "VBRI",
256
+ frameCount: readU32BE(bytes, vbriOffset + 14),
257
+ byteCount: readU32BE(bytes, vbriOffset + 10),
258
+ encoderDelay: 0,
259
+ encoderPadding: 0
260
+ };
261
+ }
262
+ return null;
263
+ }
264
+ function readLameGapless(bytes, searchStart) {
265
+ const end = Math.min(bytes.byteLength - 3, searchStart + 160);
266
+ for (let offset = searchStart; offset < end; offset++) {
267
+ if (fourCc(bytes, offset, 4) !== "LAME") continue;
268
+ const value = bytes[offset + 0x15] << 16 | bytes[offset + 0x16] << 8 | bytes[offset + 0x17];
269
+ return {
270
+ encoderDelay: value >>> 12 & 0xfff,
271
+ encoderPadding: value & 0xfff
272
+ };
273
+ }
274
+ return {
275
+ encoderDelay: 0,
276
+ encoderPadding: 0
277
+ };
278
+ }
279
+ function findMp3FrameOffset(bytes) {
280
+ let offset = 0;
281
+ if (fourCc(bytes, 0, 3) === "ID3" && bytes.byteLength >= 10) {
282
+ const size = bytes[6] << 21 | bytes[7] << 14 | bytes[8] << 7 | bytes[9];
283
+ offset = 10 + size + (bytes[5] & 0x10 ? 10 : 0);
284
+ }
285
+ for (; offset + 4 <= bytes.byteLength; offset++) {
286
+ if (readMp3FrameHeader(bytes, offset)) return offset;
287
+ }
288
+ return -1;
289
+ }
290
+ function readMp3FrameHeader(bytes, offset) {
291
+ if (offset < 0 || offset + 4 > bytes.byteLength) return null;
292
+ const header = (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
293
+ if ((header & 0xffe00000) >>> 0 !== 0xffe00000) return null;
294
+ const versionBits = header >>> 19 & 3;
295
+ const layerBits = header >>> 17 & 3;
296
+ const bitrateIndex = header >>> 12 & 0xf;
297
+ const sampleRateIndex = header >>> 10 & 3;
298
+ const padding = header >>> 9 & 1;
299
+ const channelMode = header >>> 6 & 3;
300
+ if (versionBits === 1 || layerBits !== 1 || bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
301
+ return null;
302
+ }
303
+ const version = versionBits === 3 ? "mpeg1" : versionBits === 2 ? "mpeg2" : "mpeg2.5";
304
+ const bitrateTable = version === "mpeg1" ? [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320] : [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160];
305
+ const sampleRateTable = version === "mpeg1" ? [44100, 48000, 32000] : version === "mpeg2" ? [22050, 24000, 16000] : [11025, 12000, 8000];
306
+ const bitrateKbps = bitrateTable[bitrateIndex];
307
+ const sampleRate = sampleRateTable[sampleRateIndex];
308
+ const samplesPerFrame = version === "mpeg1" ? 1152 : 576;
309
+ const frameLength = Math.floor((version === "mpeg1" ? 144000 : 72000) * bitrateKbps / sampleRate) + padding;
310
+ if (offset + frameLength > bytes.byteLength) return null;
311
+ return {
312
+ offset,
313
+ version,
314
+ layer: "layer3",
315
+ bitrateKbps,
316
+ sampleRate,
317
+ channels: channelMode === 3 ? 1 : 2,
318
+ samplesPerFrame,
319
+ frameLength
320
+ };
321
+ }
322
+ function fourCc(bytes, offset, length = 4) {
323
+ let value = "";
324
+ for (let i = 0; i < length; i++) value += String.fromCharCode(bytes[offset + i] || 0);
325
+ return value;
326
+ }
327
+ function readU16LE(bytes, offset) {
328
+ return bytes[offset] | bytes[offset + 1] << 8;
329
+ }
330
+ function readU32LE(bytes, offset) {
331
+ return (bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] * 0x1000000) >>> 0;
332
+ }
333
+ function readU32BE(bytes, offset) {
334
+ return bytes[offset] * 0x1000000 + (bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
335
+ }
336
+
337
+ export { DEFAULT_VALUES, OUTPUT_AUDIO, OUTPUT_JSON, OUTPUT_PCM, OUTPUT_RAW, inspectBytes, inspectWithValues, isMP3, isSupportedWithValues, isWAV, normalizeEmit, normalizeInputType, normalizeValues, readWithValues, toBytes, toJsonValue };
338
+ //# sourceMappingURL=helpers.js.map