@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,449 +1,449 @@
1
- const OUTPUT_VIDEO = "video";
2
- const OUTPUT_RAW = "raw";
3
- const OUTPUT_JSON = "json";
4
- const DEFAULT_VALUES = Object.freeze({
5
- emit: OUTPUT_RAW,
6
- inputType: "",
7
- source: ""
8
- });
9
- const DEBUG_OUTPUTS = Object.freeze({
10
- mp4: "mp4Json",
11
- m4a: "mp4Json",
12
- webm: "webmJson"
13
- });
14
- function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsVideoFormat") {
15
- const values = {
16
- ...DEFAULT_VALUES,
17
- ...(base || {}),
18
- ...(options || {})
19
- };
20
- values.inputType = values.inputType ? String(values.inputType).replace(/^\./u, "").toLowerCase() : "";
21
- values.emit = normalizeEmit(values.emit, values.inputType, readerName);
22
- return values;
23
- }
24
- function normalizeEmit(emit, inputType, readerName) {
25
- if (emit === undefined || emit === null) return OUTPUT_RAW;
26
- if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
27
- if ([OUTPUT_VIDEO, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
28
- if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
29
- throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
30
- }
31
- function toBytes(input) {
32
- if (input instanceof Uint8Array) return input;
33
- if (input instanceof ArrayBuffer) return new Uint8Array(input);
34
- if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
35
- throw new TypeError("Video input must be Uint8Array, ArrayBuffer, or DataView");
36
- }
37
- function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
38
- const bytes = toBytes(input);
39
- const metadata = inspectBytes(bytes);
40
- if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
41
- throw new TypeError(`CjsVideoFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
42
- }
43
- return {
44
- payloadType: "video",
45
- mediaTypes: ["video"],
46
- byteLength: bytes.byteLength,
47
- sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
48
- ...metadata
49
- };
50
- }
51
- function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
52
- try {
53
- const metadata = inspectWithValues(input, values, expectedType);
54
- const codecs = getTrackCodecSummary(metadata);
55
- const mimeType = getMediaMimeType(metadata);
56
- return {
57
- format: metadata.sourceFormat,
58
- source: values.source || "buffer",
59
- supported: metadata.sourceFormat ? "partial" : "none",
60
- confidence: metadata.sourceFormat ? 1 : 0,
61
- preferred: "container",
62
- reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized video format.",
63
- metadata,
64
- variants: [{
65
- kind: "raw",
66
- payloadType: "raw",
67
- codec: metadata.sourceFormat,
68
- mimeType,
69
- supported: true,
70
- containerOnly: true,
71
- isDecoded: false,
72
- frameDecodeSupported: false
73
- }, {
74
- kind: "container",
75
- payloadType: "video",
76
- codec: metadata.sourceFormat,
77
- mimeType,
78
- codecs: codecs.codecs,
79
- videoCodecs: codecs.videoCodecs,
80
- audioCodecs: codecs.audioCodecs,
81
- supported: true,
82
- containerOnly: true,
83
- isDecoded: false,
84
- frameDecodeSupported: false
85
- }, {
86
- kind: "decoded",
87
- payloadType: "video-frame",
88
- codec: "frames",
89
- supported: false,
90
- reason: "Video decode is not implemented in this package."
91
- }],
92
- warnings: [],
93
- errors: []
94
- };
95
- } catch (error) {
96
- return {
97
- format: expectedType || values.inputType || "",
98
- source: values.source || "buffer",
99
- supported: "none",
100
- confidence: 0,
101
- preferred: "",
102
- reason: error.message,
103
- metadata: null,
104
- variants: [],
105
- warnings: [],
106
- errors: [error.message]
107
- };
108
- }
109
- }
110
- function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
111
- const bytes = toBytes(input);
112
- const metadata = inspectWithValues(bytes, values, expectedType);
113
- if (values.emit === OUTPUT_RAW) {
114
- return {
115
- payloadType: "raw",
116
- sourceFormat: metadata.sourceFormat,
117
- metadata,
118
- bytes
119
- };
120
- }
121
- if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
122
- if (values.emit === OUTPUT_VIDEO && metadata.sourceFormat === "mp4") {
123
- const codecs = getTrackCodecSummary(metadata);
124
- const mimeType = getMediaMimeType(metadata);
125
- return {
126
- payloadType: OUTPUT_VIDEO,
127
- sourceFormat: "mp4",
128
- container: metadata.container,
129
- mimeType,
130
- containerOnly: true,
131
- isDecoded: false,
132
- frameDecodeSupported: false,
133
- codecs: codecs.codecs,
134
- videoCodecs: codecs.videoCodecs,
135
- audioCodecs: codecs.audioCodecs,
136
- duration: metadata.duration || 0,
137
- durationTimescale: metadata.durationTimescale || 1,
138
- tracks: metadata.tracks || [],
139
- metadata,
140
- sourceBytes: bytes
141
- };
142
- }
143
- const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
144
- error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
145
- error.sourceFormat = metadata.sourceFormat;
146
- error.emit = values.emit;
147
- throw error;
148
- }
149
- function getTrackCodecSummary(metadata) {
150
- const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
151
- return {
152
- codecs: uniqueTrackCodecs(tracks),
153
- videoCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "video")),
154
- audioCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "audio"))
155
- };
156
- }
157
- function uniqueTrackCodecs(tracks) {
158
- return [...new Set(tracks.map(track => track.codec).filter(Boolean))];
159
- }
160
- function getMediaMimeType(metadata) {
161
- const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
162
- return tracks.some(track => track.type === "video") ? "video/mp4" : "audio/mp4";
163
- }
164
- function inspectBytes(bytes) {
165
- if (isMP4(bytes)) return inspectMP4(bytes);
166
- if (isWebM(bytes)) return inspectWebM();
167
- return {
168
- sourceFormat: ""
169
- };
170
- }
171
- function isMP4(bytes) {
172
- return bytes.byteLength >= 12 && fourCc(bytes, 4) === "ftyp";
173
- }
174
- function isWebM(bytes) {
175
- return bytes.byteLength >= 4 && bytes[0] === 0x1a && bytes[1] === 0x45 && bytes[2] === 0xdf && bytes[3] === 0xa3;
176
- }
177
- function toJsonValue(value) {
178
- if (value instanceof Uint8Array) return {
179
- byteLength: value.byteLength
180
- };
181
- if (Array.isArray(value)) return value.map(toJsonValue);
182
- if (value && typeof value === "object") {
183
- const output = {};
184
- for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
185
- return output;
186
- }
187
- return value;
188
- }
189
- function inspectMP4(bytes) {
190
- const boxes = readMp4Boxes(bytes, 0, bytes.byteLength);
191
- const ftyp = boxes.find(box => box.type === "ftyp");
192
- const moov = boxes.find(box => box.type === "moov");
193
- const movie = moov ? inspectMp4Movie(bytes, moov) : {
194
- duration: 0,
195
- durationTimescale: 1,
196
- tracks: []
197
- };
198
- return {
199
- sourceFormat: "mp4",
200
- brand: ftyp ? fourCc(bytes, ftyp.dataStart) : fourCc(bytes, 8),
201
- compatibleBrands: ftyp ? readMp4Brands(bytes, ftyp) : [],
202
- container: "isobmff",
203
- ...movie
204
- };
205
- }
206
- function inspectMp4Movie(bytes, moov) {
207
- const mvhd = findMp4Child(bytes, moov, "mvhd");
208
- const movieTiming = mvhd ? readMp4Timing(bytes, mvhd) : {
209
- duration: 0,
210
- durationTimescale: 1
211
- };
212
- const tracks = findMp4Children(bytes, moov, "trak").map(trak => inspectMp4Track(bytes, trak));
213
- return {
214
- ...movieTiming,
215
- tracks
216
- };
217
- }
218
- function inspectMp4Track(bytes, trak) {
219
- const tkhd = findMp4Child(bytes, trak, "tkhd");
220
- const mdia = findMp4Child(bytes, trak, "mdia");
221
- const mdhd = mdia ? findMp4Child(bytes, mdia, "mdhd") : null;
222
- const hdlr = mdia ? findMp4Child(bytes, mdia, "hdlr") : null;
223
- const minf = mdia ? findMp4Child(bytes, mdia, "minf") : null;
224
- const stbl = minf ? findMp4Child(bytes, minf, "stbl") : null;
225
- const stsd = stbl ? findMp4Child(bytes, stbl, "stsd") : null;
226
- const sampleTable = stbl ? readMp4SampleTable(bytes, stbl) : null;
227
- const timing = mdhd ? readMp4Timing(bytes, mdhd) : {
228
- duration: 0,
229
- durationTimescale: 1
230
- };
231
- const handler = hdlr && hdlr.dataLength >= 12 ? fourCc(bytes, hdlr.dataStart + 8) : "";
232
- const sample = stsd ? readMp4SampleEntry(bytes, stsd) : null;
233
- const track = {
234
- id: tkhd ? readMp4TrackId(bytes, tkhd) : 0,
235
- type: handler === "vide" ? "video" : handler === "soun" ? "audio" : handler || "unknown",
236
- handler,
237
- codec: sample?.codec || "",
238
- duration: timing.duration,
239
- durationTimescale: timing.durationTimescale,
240
- language: mdhd ? readMp4Language(bytes, mdhd) : "und"
241
- };
242
- if (sample?.width) track.width = sample.width;
243
- if (sample?.height) track.height = sample.height;
244
- if (sample?.channels) track.channels = sample.channels;
245
- if (sample?.sampleRate) track.sampleRate = sample.sampleRate;
246
- if (sampleTable) track.sampleTable = sampleTable;
247
- return track;
248
- }
249
- function readMp4SampleTable(bytes, stbl) {
250
- const stts = findMp4Child(bytes, stbl, "stts");
251
- const stsc = findMp4Child(bytes, stbl, "stsc");
252
- const stsz = findMp4Child(bytes, stbl, "stsz");
253
- const stco = findMp4Child(bytes, stbl, "stco");
254
- const co64 = findMp4Child(bytes, stbl, "co64");
255
- const stss = findMp4Child(bytes, stbl, "stss");
256
- const ctts = findMp4Child(bytes, stbl, "ctts");
257
- if (!stts && !stsc && !stsz && !stco && !co64 && !stss && !ctts) return null;
258
- const timing = stts ? readMp4TimeToSample(bytes, stts) : {
259
- entryCount: 0,
260
- sampleCount: 0,
261
- duration: 0
262
- };
263
- const composition = ctts ? readMp4CompositionOffsets(bytes, ctts) : {
264
- entryCount: 0,
265
- sampleCount: 0,
266
- minOffset: 0,
267
- maxOffset: 0
268
- };
269
- const sizes = stsz ? readMp4SampleSizes(bytes, stsz) : {
270
- sampleCount: 0,
271
- bytes: 0,
272
- fixedSize: 0
273
- };
274
- return {
275
- sampleCount: sizes.sampleCount || timing.sampleCount,
276
- sampleBytes: sizes.bytes,
277
- fixedSampleBytes: sizes.fixedSize,
278
- decodeTimeEntries: timing.entryCount,
279
- decodeDuration: timing.duration,
280
- compositionTimeEntries: composition.entryCount,
281
- compositionSampleCount: composition.sampleCount,
282
- compositionOffsetMin: composition.minOffset,
283
- compositionOffsetMax: composition.maxOffset,
284
- chunkCount: stco ? readMp4Count(bytes, stco, 4) : co64 ? readMp4Count(bytes, co64, 4) : 0,
285
- chunkOffsetType: stco ? "stco" : co64 ? "co64" : "",
286
- sampleToChunkEntries: stsc ? readMp4Count(bytes, stsc, 4) : 0,
287
- keyframeCount: stss ? readMp4Count(bytes, stss, 4) : 0
288
- };
289
- }
290
- function readMp4TimeToSample(bytes, box) {
291
- const entryCount = readMp4Count(bytes, box, 4);
292
- let sampleCount = 0;
293
- let duration = 0;
294
- for (let index = 0; index < entryCount; index++) {
295
- const offset = box.dataStart + 8 + index * 8;
296
- if (offset + 8 > box.end) break;
297
- const count = readU32BE(bytes, offset);
298
- const delta = readU32BE(bytes, offset + 4);
299
- sampleCount += count;
300
- duration += count * delta;
301
- }
302
- return {
303
- entryCount,
304
- sampleCount,
305
- duration
306
- };
307
- }
308
- function readMp4CompositionOffsets(bytes, box) {
309
- const version = bytes[box.dataStart];
310
- const entryCount = readMp4Count(bytes, box, 4);
311
- let sampleCount = 0;
312
- let minOffset = 0;
313
- let maxOffset = 0;
314
- for (let index = 0; index < entryCount; index++) {
315
- const offset = box.dataStart + 8 + index * 8;
316
- if (offset + 8 > box.end) break;
317
- const count = readU32BE(bytes, offset);
318
- const compositionOffset = version === 1 ? readI32BE(bytes, offset + 4) : readU32BE(bytes, offset + 4);
319
- sampleCount += count;
320
- minOffset = index === 0 ? compositionOffset : Math.min(minOffset, compositionOffset);
321
- maxOffset = index === 0 ? compositionOffset : Math.max(maxOffset, compositionOffset);
322
- }
323
- return {
324
- entryCount,
325
- sampleCount,
326
- minOffset,
327
- maxOffset
328
- };
329
- }
330
- function readMp4SampleSizes(bytes, box) {
331
- const fixedSize = readU32BE(bytes, box.dataStart + 4);
332
- const sampleCount = readU32BE(bytes, box.dataStart + 8);
333
- if (fixedSize !== 0) return {
334
- sampleCount,
335
- bytes: fixedSize * sampleCount,
336
- fixedSize
337
- };
338
- let total = 0;
339
- for (let index = 0; index < sampleCount; index++) {
340
- const offset = box.dataStart + 12 + index * 4;
341
- if (offset + 4 > box.end) break;
342
- total += readU32BE(bytes, offset);
343
- }
344
- return {
345
- sampleCount,
346
- bytes: total,
347
- fixedSize: 0
348
- };
349
- }
350
- function readMp4Count(bytes, box, offset) {
351
- return box.dataStart + offset + 4 <= box.end ? readU32BE(bytes, box.dataStart + offset) : 0;
352
- }
353
- function readMp4Timing(bytes, box) {
354
- const version = bytes[box.dataStart];
355
- const offset = version === 1 ? 20 : 12;
356
- const durationOffset = version === 1 ? 28 : 16;
357
- return {
358
- durationTimescale: readU32BE(bytes, box.dataStart + offset) || 1,
359
- duration: version === 1 ? readU64BE(bytes, box.dataStart + durationOffset) : readU32BE(bytes, box.dataStart + durationOffset)
360
- };
361
- }
362
- function readMp4TrackId(bytes, box) {
363
- return readU32BE(bytes, box.dataStart + (bytes[box.dataStart] === 1 ? 20 : 12));
364
- }
365
- function readMp4Language(bytes, box) {
366
- const offset = box.dataStart + (bytes[box.dataStart] === 1 ? 32 : 20);
367
- const value = readU16BE(bytes, offset) & 0x7fff;
368
- if (!value) return "und";
369
- return String.fromCharCode((value >>> 10 & 0x1f) + 0x60, (value >>> 5 & 0x1f) + 0x60, (value & 0x1f) + 0x60);
370
- }
371
- function readMp4SampleEntry(bytes, stsd) {
372
- if (stsd.dataLength < 16) return null;
373
- const entryCount = readU32BE(bytes, stsd.dataStart + 4);
374
- if (!entryCount) return null;
375
- const entry = readMp4Boxes(bytes, stsd.dataStart + 8, stsd.end)[0];
376
- if (!entry) return null;
377
- const result = {
378
- codec: fourCc(bytes, entry.start + 4)
379
- };
380
- if (result.codec === "avc1" || result.codec === "avc3" || result.codec === "hvc1" || result.codec === "hev1" || result.codec === "vp09" || result.codec === "av01") {
381
- result.width = readU16BE(bytes, entry.dataStart + 16);
382
- result.height = readU16BE(bytes, entry.dataStart + 18);
383
- } else if (["mp4a", "ac-3", "ec-3", "Opus"].includes(result.codec)) {
384
- result.channels = readU16BE(bytes, entry.dataStart + 8);
385
- result.sampleRate = readU32BE(bytes, entry.dataStart + 16) >>> 16;
386
- }
387
- return result;
388
- }
389
- function readMp4Brands(bytes, ftyp) {
390
- const brands = [];
391
- for (let offset = ftyp.dataStart + 8; offset + 4 <= ftyp.end; offset += 4) {
392
- brands.push(fourCc(bytes, offset));
393
- }
394
- return brands;
395
- }
396
- function readMp4Boxes(bytes, start, end) {
397
- const boxes = [];
398
- let offset = start;
399
- while (offset + 8 <= end) {
400
- let size = readU32BE(bytes, offset);
401
- const type = fourCc(bytes, offset + 4);
402
- let headerSize = 8;
403
- if (size === 1 && offset + 16 <= end) {
404
- size = readU64BE(bytes, offset + 8);
405
- headerSize = 16;
406
- }
407
- if (size === 0) size = end - offset;
408
- if (size < headerSize || offset + size > end) break;
409
- boxes.push({
410
- type,
411
- start: offset,
412
- dataStart: offset + headerSize,
413
- dataLength: size - headerSize,
414
- end: offset + size
415
- });
416
- offset += size;
417
- }
418
- return boxes;
419
- }
420
- function findMp4Child(bytes, parent, type) {
421
- return readMp4Boxes(bytes, parent.dataStart, parent.end).find(box => box.type === type) || null;
422
- }
423
- function findMp4Children(bytes, parent, type) {
424
- return readMp4Boxes(bytes, parent.dataStart, parent.end).filter(box => box.type === type);
425
- }
426
- function inspectWebM() {
427
- return {
428
- sourceFormat: "webm",
429
- container: "ebml"
430
- };
431
- }
432
- function fourCc(bytes, offset) {
433
- return String.fromCharCode(bytes[offset] || 0, bytes[offset + 1] || 0, bytes[offset + 2] || 0, bytes[offset + 3] || 0);
434
- }
435
- function readU16BE(bytes, offset) {
436
- return (bytes[offset] || 0) << 8 | (bytes[offset + 1] || 0);
437
- }
438
- function readU32BE(bytes, offset) {
439
- return (bytes[offset] || 0) * 0x1000000 + ((bytes[offset + 1] || 0) << 16) + ((bytes[offset + 2] || 0) << 8) + (bytes[offset + 3] || 0) >>> 0;
440
- }
441
- function readI32BE(bytes, offset) {
442
- return readU32BE(bytes, offset) | 0;
443
- }
444
- function readU64BE(bytes, offset) {
445
- return readU32BE(bytes, offset) * 0x100000000 + readU32BE(bytes, offset + 4);
446
- }
447
-
448
- export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_VIDEO, inspectBytes, inspectWithValues, isMP4, isSupportedWithValues, isWebM, normalizeEmit, normalizeValues, readWithValues, toBytes, toJsonValue };
449
- //# sourceMappingURL=helpers.js.map
1
+ const OUTPUT_VIDEO = "video";
2
+ const OUTPUT_RAW = "raw";
3
+ const OUTPUT_JSON = "json";
4
+ const DEFAULT_VALUES = Object.freeze({
5
+ emit: OUTPUT_RAW,
6
+ inputType: "",
7
+ source: ""
8
+ });
9
+ const DEBUG_OUTPUTS = Object.freeze({
10
+ mp4: "mp4Json",
11
+ m4a: "mp4Json",
12
+ webm: "webmJson"
13
+ });
14
+ function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsVideoFormat") {
15
+ const values = {
16
+ ...DEFAULT_VALUES,
17
+ ...(base || {}),
18
+ ...(options || {})
19
+ };
20
+ values.inputType = values.inputType ? String(values.inputType).replace(/^\./u, "").toLowerCase() : "";
21
+ values.emit = normalizeEmit(values.emit, values.inputType, readerName);
22
+ return values;
23
+ }
24
+ function normalizeEmit(emit, inputType, readerName) {
25
+ if (emit === undefined || emit === null) return OUTPUT_RAW;
26
+ if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
27
+ if ([OUTPUT_VIDEO, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
28
+ if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
29
+ throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
30
+ }
31
+ function toBytes(input) {
32
+ if (input instanceof Uint8Array) return input;
33
+ if (input instanceof ArrayBuffer) return new Uint8Array(input);
34
+ if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
35
+ throw new TypeError("Video input must be Uint8Array, ArrayBuffer, or DataView");
36
+ }
37
+ function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
38
+ const bytes = toBytes(input);
39
+ const metadata = inspectBytes(bytes);
40
+ if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
41
+ throw new TypeError(`CjsVideoFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
42
+ }
43
+ return {
44
+ payloadType: "video",
45
+ mediaTypes: ["video"],
46
+ byteLength: bytes.byteLength,
47
+ sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
48
+ ...metadata
49
+ };
50
+ }
51
+ function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
52
+ try {
53
+ const metadata = inspectWithValues(input, values, expectedType);
54
+ const codecs = getTrackCodecSummary(metadata);
55
+ const mimeType = getMediaMimeType(metadata);
56
+ return {
57
+ format: metadata.sourceFormat,
58
+ source: values.source || "buffer",
59
+ supported: metadata.sourceFormat ? "partial" : "none",
60
+ confidence: metadata.sourceFormat ? 1 : 0,
61
+ preferred: "container",
62
+ reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized video format.",
63
+ metadata,
64
+ variants: [{
65
+ kind: "raw",
66
+ payloadType: "raw",
67
+ codec: metadata.sourceFormat,
68
+ mimeType,
69
+ supported: true,
70
+ containerOnly: true,
71
+ isDecoded: false,
72
+ frameDecodeSupported: false
73
+ }, {
74
+ kind: "container",
75
+ payloadType: "video",
76
+ codec: metadata.sourceFormat,
77
+ mimeType,
78
+ codecs: codecs.codecs,
79
+ videoCodecs: codecs.videoCodecs,
80
+ audioCodecs: codecs.audioCodecs,
81
+ supported: true,
82
+ containerOnly: true,
83
+ isDecoded: false,
84
+ frameDecodeSupported: false
85
+ }, {
86
+ kind: "decoded",
87
+ payloadType: "video-frame",
88
+ codec: "frames",
89
+ supported: false,
90
+ reason: "Video decode is not implemented in this package."
91
+ }],
92
+ warnings: [],
93
+ errors: []
94
+ };
95
+ } catch (error) {
96
+ return {
97
+ format: expectedType || values.inputType || "",
98
+ source: values.source || "buffer",
99
+ supported: "none",
100
+ confidence: 0,
101
+ preferred: "",
102
+ reason: error.message,
103
+ metadata: null,
104
+ variants: [],
105
+ warnings: [],
106
+ errors: [error.message]
107
+ };
108
+ }
109
+ }
110
+ function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
111
+ const bytes = toBytes(input);
112
+ const metadata = inspectWithValues(bytes, values, expectedType);
113
+ if (values.emit === OUTPUT_RAW) {
114
+ return {
115
+ payloadType: "raw",
116
+ sourceFormat: metadata.sourceFormat,
117
+ metadata,
118
+ bytes
119
+ };
120
+ }
121
+ if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
122
+ if (values.emit === OUTPUT_VIDEO && metadata.sourceFormat === "mp4") {
123
+ const codecs = getTrackCodecSummary(metadata);
124
+ const mimeType = getMediaMimeType(metadata);
125
+ return {
126
+ payloadType: OUTPUT_VIDEO,
127
+ sourceFormat: "mp4",
128
+ container: metadata.container,
129
+ mimeType,
130
+ containerOnly: true,
131
+ isDecoded: false,
132
+ frameDecodeSupported: false,
133
+ codecs: codecs.codecs,
134
+ videoCodecs: codecs.videoCodecs,
135
+ audioCodecs: codecs.audioCodecs,
136
+ duration: metadata.duration || 0,
137
+ durationTimescale: metadata.durationTimescale || 1,
138
+ tracks: metadata.tracks || [],
139
+ metadata,
140
+ sourceBytes: bytes
141
+ };
142
+ }
143
+ const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
144
+ error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
145
+ error.sourceFormat = metadata.sourceFormat;
146
+ error.emit = values.emit;
147
+ throw error;
148
+ }
149
+ function getTrackCodecSummary(metadata) {
150
+ const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
151
+ return {
152
+ codecs: uniqueTrackCodecs(tracks),
153
+ videoCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "video")),
154
+ audioCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "audio"))
155
+ };
156
+ }
157
+ function uniqueTrackCodecs(tracks) {
158
+ return [...new Set(tracks.map(track => track.codec).filter(Boolean))];
159
+ }
160
+ function getMediaMimeType(metadata) {
161
+ const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
162
+ return tracks.some(track => track.type === "video") ? "video/mp4" : "audio/mp4";
163
+ }
164
+ function inspectBytes(bytes) {
165
+ if (isMP4(bytes)) return inspectMP4(bytes);
166
+ if (isWebM(bytes)) return inspectWebM();
167
+ return {
168
+ sourceFormat: ""
169
+ };
170
+ }
171
+ function isMP4(bytes) {
172
+ return bytes.byteLength >= 12 && fourCc(bytes, 4) === "ftyp";
173
+ }
174
+ function isWebM(bytes) {
175
+ return bytes.byteLength >= 4 && bytes[0] === 0x1a && bytes[1] === 0x45 && bytes[2] === 0xdf && bytes[3] === 0xa3;
176
+ }
177
+ function toJsonValue(value) {
178
+ if (value instanceof Uint8Array) return {
179
+ byteLength: value.byteLength
180
+ };
181
+ if (Array.isArray(value)) return value.map(toJsonValue);
182
+ if (value && typeof value === "object") {
183
+ const output = {};
184
+ for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
185
+ return output;
186
+ }
187
+ return value;
188
+ }
189
+ function inspectMP4(bytes) {
190
+ const boxes = readMp4Boxes(bytes, 0, bytes.byteLength);
191
+ const ftyp = boxes.find(box => box.type === "ftyp");
192
+ const moov = boxes.find(box => box.type === "moov");
193
+ const movie = moov ? inspectMp4Movie(bytes, moov) : {
194
+ duration: 0,
195
+ durationTimescale: 1,
196
+ tracks: []
197
+ };
198
+ return {
199
+ sourceFormat: "mp4",
200
+ brand: ftyp ? fourCc(bytes, ftyp.dataStart) : fourCc(bytes, 8),
201
+ compatibleBrands: ftyp ? readMp4Brands(bytes, ftyp) : [],
202
+ container: "isobmff",
203
+ ...movie
204
+ };
205
+ }
206
+ function inspectMp4Movie(bytes, moov) {
207
+ const mvhd = findMp4Child(bytes, moov, "mvhd");
208
+ const movieTiming = mvhd ? readMp4Timing(bytes, mvhd) : {
209
+ duration: 0,
210
+ durationTimescale: 1
211
+ };
212
+ const tracks = findMp4Children(bytes, moov, "trak").map(trak => inspectMp4Track(bytes, trak));
213
+ return {
214
+ ...movieTiming,
215
+ tracks
216
+ };
217
+ }
218
+ function inspectMp4Track(bytes, trak) {
219
+ const tkhd = findMp4Child(bytes, trak, "tkhd");
220
+ const mdia = findMp4Child(bytes, trak, "mdia");
221
+ const mdhd = mdia ? findMp4Child(bytes, mdia, "mdhd") : null;
222
+ const hdlr = mdia ? findMp4Child(bytes, mdia, "hdlr") : null;
223
+ const minf = mdia ? findMp4Child(bytes, mdia, "minf") : null;
224
+ const stbl = minf ? findMp4Child(bytes, minf, "stbl") : null;
225
+ const stsd = stbl ? findMp4Child(bytes, stbl, "stsd") : null;
226
+ const sampleTable = stbl ? readMp4SampleTable(bytes, stbl) : null;
227
+ const timing = mdhd ? readMp4Timing(bytes, mdhd) : {
228
+ duration: 0,
229
+ durationTimescale: 1
230
+ };
231
+ const handler = hdlr && hdlr.dataLength >= 12 ? fourCc(bytes, hdlr.dataStart + 8) : "";
232
+ const sample = stsd ? readMp4SampleEntry(bytes, stsd) : null;
233
+ const track = {
234
+ id: tkhd ? readMp4TrackId(bytes, tkhd) : 0,
235
+ type: handler === "vide" ? "video" : handler === "soun" ? "audio" : handler || "unknown",
236
+ handler,
237
+ codec: sample?.codec || "",
238
+ duration: timing.duration,
239
+ durationTimescale: timing.durationTimescale,
240
+ language: mdhd ? readMp4Language(bytes, mdhd) : "und"
241
+ };
242
+ if (sample?.width) track.width = sample.width;
243
+ if (sample?.height) track.height = sample.height;
244
+ if (sample?.channels) track.channels = sample.channels;
245
+ if (sample?.sampleRate) track.sampleRate = sample.sampleRate;
246
+ if (sampleTable) track.sampleTable = sampleTable;
247
+ return track;
248
+ }
249
+ function readMp4SampleTable(bytes, stbl) {
250
+ const stts = findMp4Child(bytes, stbl, "stts");
251
+ const stsc = findMp4Child(bytes, stbl, "stsc");
252
+ const stsz = findMp4Child(bytes, stbl, "stsz");
253
+ const stco = findMp4Child(bytes, stbl, "stco");
254
+ const co64 = findMp4Child(bytes, stbl, "co64");
255
+ const stss = findMp4Child(bytes, stbl, "stss");
256
+ const ctts = findMp4Child(bytes, stbl, "ctts");
257
+ if (!stts && !stsc && !stsz && !stco && !co64 && !stss && !ctts) return null;
258
+ const timing = stts ? readMp4TimeToSample(bytes, stts) : {
259
+ entryCount: 0,
260
+ sampleCount: 0,
261
+ duration: 0
262
+ };
263
+ const composition = ctts ? readMp4CompositionOffsets(bytes, ctts) : {
264
+ entryCount: 0,
265
+ sampleCount: 0,
266
+ minOffset: 0,
267
+ maxOffset: 0
268
+ };
269
+ const sizes = stsz ? readMp4SampleSizes(bytes, stsz) : {
270
+ sampleCount: 0,
271
+ bytes: 0,
272
+ fixedSize: 0
273
+ };
274
+ return {
275
+ sampleCount: sizes.sampleCount || timing.sampleCount,
276
+ sampleBytes: sizes.bytes,
277
+ fixedSampleBytes: sizes.fixedSize,
278
+ decodeTimeEntries: timing.entryCount,
279
+ decodeDuration: timing.duration,
280
+ compositionTimeEntries: composition.entryCount,
281
+ compositionSampleCount: composition.sampleCount,
282
+ compositionOffsetMin: composition.minOffset,
283
+ compositionOffsetMax: composition.maxOffset,
284
+ chunkCount: stco ? readMp4Count(bytes, stco, 4) : co64 ? readMp4Count(bytes, co64, 4) : 0,
285
+ chunkOffsetType: stco ? "stco" : co64 ? "co64" : "",
286
+ sampleToChunkEntries: stsc ? readMp4Count(bytes, stsc, 4) : 0,
287
+ keyframeCount: stss ? readMp4Count(bytes, stss, 4) : 0
288
+ };
289
+ }
290
+ function readMp4TimeToSample(bytes, box) {
291
+ const entryCount = readMp4Count(bytes, box, 4);
292
+ let sampleCount = 0;
293
+ let duration = 0;
294
+ for (let index = 0; index < entryCount; index++) {
295
+ const offset = box.dataStart + 8 + index * 8;
296
+ if (offset + 8 > box.end) break;
297
+ const count = readU32BE(bytes, offset);
298
+ const delta = readU32BE(bytes, offset + 4);
299
+ sampleCount += count;
300
+ duration += count * delta;
301
+ }
302
+ return {
303
+ entryCount,
304
+ sampleCount,
305
+ duration
306
+ };
307
+ }
308
+ function readMp4CompositionOffsets(bytes, box) {
309
+ const version = bytes[box.dataStart];
310
+ const entryCount = readMp4Count(bytes, box, 4);
311
+ let sampleCount = 0;
312
+ let minOffset = 0;
313
+ let maxOffset = 0;
314
+ for (let index = 0; index < entryCount; index++) {
315
+ const offset = box.dataStart + 8 + index * 8;
316
+ if (offset + 8 > box.end) break;
317
+ const count = readU32BE(bytes, offset);
318
+ const compositionOffset = version === 1 ? readI32BE(bytes, offset + 4) : readU32BE(bytes, offset + 4);
319
+ sampleCount += count;
320
+ minOffset = index === 0 ? compositionOffset : Math.min(minOffset, compositionOffset);
321
+ maxOffset = index === 0 ? compositionOffset : Math.max(maxOffset, compositionOffset);
322
+ }
323
+ return {
324
+ entryCount,
325
+ sampleCount,
326
+ minOffset,
327
+ maxOffset
328
+ };
329
+ }
330
+ function readMp4SampleSizes(bytes, box) {
331
+ const fixedSize = readU32BE(bytes, box.dataStart + 4);
332
+ const sampleCount = readU32BE(bytes, box.dataStart + 8);
333
+ if (fixedSize !== 0) return {
334
+ sampleCount,
335
+ bytes: fixedSize * sampleCount,
336
+ fixedSize
337
+ };
338
+ let total = 0;
339
+ for (let index = 0; index < sampleCount; index++) {
340
+ const offset = box.dataStart + 12 + index * 4;
341
+ if (offset + 4 > box.end) break;
342
+ total += readU32BE(bytes, offset);
343
+ }
344
+ return {
345
+ sampleCount,
346
+ bytes: total,
347
+ fixedSize: 0
348
+ };
349
+ }
350
+ function readMp4Count(bytes, box, offset) {
351
+ return box.dataStart + offset + 4 <= box.end ? readU32BE(bytes, box.dataStart + offset) : 0;
352
+ }
353
+ function readMp4Timing(bytes, box) {
354
+ const version = bytes[box.dataStart];
355
+ const offset = version === 1 ? 20 : 12;
356
+ const durationOffset = version === 1 ? 28 : 16;
357
+ return {
358
+ durationTimescale: readU32BE(bytes, box.dataStart + offset) || 1,
359
+ duration: version === 1 ? readU64BE(bytes, box.dataStart + durationOffset) : readU32BE(bytes, box.dataStart + durationOffset)
360
+ };
361
+ }
362
+ function readMp4TrackId(bytes, box) {
363
+ return readU32BE(bytes, box.dataStart + (bytes[box.dataStart] === 1 ? 20 : 12));
364
+ }
365
+ function readMp4Language(bytes, box) {
366
+ const offset = box.dataStart + (bytes[box.dataStart] === 1 ? 32 : 20);
367
+ const value = readU16BE(bytes, offset) & 0x7fff;
368
+ if (!value) return "und";
369
+ return String.fromCharCode((value >>> 10 & 0x1f) + 0x60, (value >>> 5 & 0x1f) + 0x60, (value & 0x1f) + 0x60);
370
+ }
371
+ function readMp4SampleEntry(bytes, stsd) {
372
+ if (stsd.dataLength < 16) return null;
373
+ const entryCount = readU32BE(bytes, stsd.dataStart + 4);
374
+ if (!entryCount) return null;
375
+ const entry = readMp4Boxes(bytes, stsd.dataStart + 8, stsd.end)[0];
376
+ if (!entry) return null;
377
+ const result = {
378
+ codec: fourCc(bytes, entry.start + 4)
379
+ };
380
+ if (result.codec === "avc1" || result.codec === "avc3" || result.codec === "hvc1" || result.codec === "hev1" || result.codec === "vp09" || result.codec === "av01") {
381
+ result.width = readU16BE(bytes, entry.dataStart + 16);
382
+ result.height = readU16BE(bytes, entry.dataStart + 18);
383
+ } else if (["mp4a", "ac-3", "ec-3", "Opus"].includes(result.codec)) {
384
+ result.channels = readU16BE(bytes, entry.dataStart + 8);
385
+ result.sampleRate = readU32BE(bytes, entry.dataStart + 16) >>> 16;
386
+ }
387
+ return result;
388
+ }
389
+ function readMp4Brands(bytes, ftyp) {
390
+ const brands = [];
391
+ for (let offset = ftyp.dataStart + 8; offset + 4 <= ftyp.end; offset += 4) {
392
+ brands.push(fourCc(bytes, offset));
393
+ }
394
+ return brands;
395
+ }
396
+ function readMp4Boxes(bytes, start, end) {
397
+ const boxes = [];
398
+ let offset = start;
399
+ while (offset + 8 <= end) {
400
+ let size = readU32BE(bytes, offset);
401
+ const type = fourCc(bytes, offset + 4);
402
+ let headerSize = 8;
403
+ if (size === 1 && offset + 16 <= end) {
404
+ size = readU64BE(bytes, offset + 8);
405
+ headerSize = 16;
406
+ }
407
+ if (size === 0) size = end - offset;
408
+ if (size < headerSize || offset + size > end) break;
409
+ boxes.push({
410
+ type,
411
+ start: offset,
412
+ dataStart: offset + headerSize,
413
+ dataLength: size - headerSize,
414
+ end: offset + size
415
+ });
416
+ offset += size;
417
+ }
418
+ return boxes;
419
+ }
420
+ function findMp4Child(bytes, parent, type) {
421
+ return readMp4Boxes(bytes, parent.dataStart, parent.end).find(box => box.type === type) || null;
422
+ }
423
+ function findMp4Children(bytes, parent, type) {
424
+ return readMp4Boxes(bytes, parent.dataStart, parent.end).filter(box => box.type === type);
425
+ }
426
+ function inspectWebM() {
427
+ return {
428
+ sourceFormat: "webm",
429
+ container: "ebml"
430
+ };
431
+ }
432
+ function fourCc(bytes, offset) {
433
+ return String.fromCharCode(bytes[offset] || 0, bytes[offset + 1] || 0, bytes[offset + 2] || 0, bytes[offset + 3] || 0);
434
+ }
435
+ function readU16BE(bytes, offset) {
436
+ return (bytes[offset] || 0) << 8 | (bytes[offset + 1] || 0);
437
+ }
438
+ function readU32BE(bytes, offset) {
439
+ return (bytes[offset] || 0) * 0x1000000 + ((bytes[offset + 1] || 0) << 16) + ((bytes[offset + 2] || 0) << 8) + (bytes[offset + 3] || 0) >>> 0;
440
+ }
441
+ function readI32BE(bytes, offset) {
442
+ return readU32BE(bytes, offset) | 0;
443
+ }
444
+ function readU64BE(bytes, offset) {
445
+ return readU32BE(bytes, offset) * 0x100000000 + readU32BE(bytes, offset + 4);
446
+ }
447
+
448
+ export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_VIDEO, inspectBytes, inspectWithValues, isMP4, isSupportedWithValues, isWebM, normalizeEmit, normalizeValues, readWithValues, toBytes, toJsonValue };
449
+ //# sourceMappingURL=helpers.js.map