@carbonenginejs/runtime-resource 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (259) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +29 -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 +59 -59
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  10. package/dist/format/CjsBlueReader.js +269 -269
  11. package/dist/format/CjsFormat.js +192 -192
  12. package/dist/format/CjsReader.js +18 -18
  13. package/dist/format/CjsResourceProbe.js +277 -277
  14. package/dist/format/payloadContract.js +173 -173
  15. package/dist/formats/black/CjsBlackFormat.js +278 -278
  16. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  17. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  18. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  19. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  20. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  21. package/dist/formats/black/core/blackConstants.js +7 -7
  22. package/dist/formats/black/core/blackDefinitions.js +10 -10
  23. package/dist/formats/black/core/blackEnums.js +6 -6
  24. package/dist/formats/black/core/blackSchema.js +3 -3
  25. package/dist/formats/black/core/blackVersion.js +22 -22
  26. package/dist/formats/black/core/helpers.js +182 -182
  27. package/dist/formats/black/core/schema.js +4 -4
  28. package/dist/formats/black/index.js +2 -2
  29. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  30. package/dist/formats/bnk/core/graph.js +140 -140
  31. package/dist/formats/bnk/core/helpers.js +409 -409
  32. package/dist/formats/bnk/core/musicNodes.js +489 -489
  33. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  34. package/dist/formats/bnk/index.js +2 -2
  35. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  36. package/dist/formats/cmf/core/binary.js +118 -118
  37. package/dist/formats/cmf/core/buffers.js +233 -233
  38. package/dist/formats/cmf/core/constants.js +47 -47
  39. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  40. package/dist/formats/cmf/core/helpers.js +287 -287
  41. package/dist/formats/cmf/core/pack.js +276 -276
  42. package/dist/formats/cmf/core/schema.js +364 -364
  43. package/dist/formats/cmf/core/shared.js +268 -268
  44. package/dist/formats/cmf/core/writer.js +517 -517
  45. package/dist/formats/cmf/index.js +2 -2
  46. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  47. package/dist/formats/dds/core/bc6h.js +288 -288
  48. package/dist/formats/dds/core/bc7.js +251 -251
  49. package/dist/formats/dds/core/helpers.js +815 -815
  50. package/dist/formats/dds/index.js +2 -2
  51. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  52. package/dist/formats/fbx/core/helpers.js +3901 -3901
  53. package/dist/formats/fbx/index.js +2 -2
  54. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  55. package/dist/formats/flac/core/helpers.js +295 -295
  56. package/dist/formats/flac/index.js +2 -2
  57. package/dist/formats/gif/CjsGifFormat.js +87 -87
  58. package/dist/formats/gif/core/helpers.js +360 -360
  59. package/dist/formats/gif/index.js +2 -2
  60. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  61. package/dist/formats/gltf/core/helpers.js +292 -292
  62. package/dist/formats/gltf/core/json.js +79 -79
  63. package/dist/formats/gltf/core/parser.js +666 -666
  64. package/dist/formats/gltf/core/targets.js +163 -163
  65. package/dist/formats/gltf/index.js +2 -2
  66. package/dist/formats/gr2/CjsGr2Format.js +46 -0
  67. package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
  68. package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
  69. package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
  70. package/dist/formats/gr2/core/bitknit2.js +280 -0
  71. package/dist/formats/gr2/core/bitknit2.js.map +1 -0
  72. package/dist/formats/gr2/core/curves.js +1047 -0
  73. package/dist/formats/gr2/core/curves.js.map +1 -0
  74. package/dist/formats/gr2/core/gsf.js +72 -0
  75. package/dist/formats/gr2/core/gsf.js.map +1 -0
  76. package/dist/formats/gr2/core/helpers.js +332 -0
  77. package/dist/formats/gr2/core/helpers.js.map +1 -0
  78. package/dist/formats/gr2/core/json.js +622 -0
  79. package/dist/formats/gr2/core/json.js.map +1 -0
  80. package/dist/formats/gr2/core/oodle1.js +388 -0
  81. package/dist/formats/gr2/core/oodle1.js.map +1 -0
  82. package/dist/formats/gr2/core/reader.js +617 -0
  83. package/dist/formats/gr2/core/reader.js.map +1 -0
  84. package/dist/formats/gr2/core/tangents.js +48 -0
  85. package/dist/formats/gr2/core/tangents.js.map +1 -0
  86. package/dist/formats/gr2/core/targets.js +351 -0
  87. package/dist/formats/gr2/core/targets.js.map +1 -0
  88. package/dist/formats/gr2/index.js +3 -0
  89. package/dist/formats/gr2/index.js.map +1 -0
  90. package/dist/formats/index.js +30 -23
  91. package/dist/formats/index.js.map +1 -1
  92. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  93. package/dist/formats/jpeg/core/helpers.js +350 -350
  94. package/dist/formats/jpeg/core/jpeg.js +377 -377
  95. package/dist/formats/jpeg/index.js +2 -2
  96. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  97. package/dist/formats/mp3/core/helpers.js +338 -338
  98. package/dist/formats/mp3/index.js +2 -2
  99. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  100. package/dist/formats/mp4/core/helpers.js +449 -449
  101. package/dist/formats/mp4/index.js +2 -2
  102. package/dist/formats/obj/CjsObjFormat.js +253 -253
  103. package/dist/formats/obj/core/helpers.js +573 -573
  104. package/dist/formats/obj/core/json.js +64 -64
  105. package/dist/formats/obj/core/parser.js +321 -321
  106. package/dist/formats/obj/index.js +2 -2
  107. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  108. package/dist/formats/ogg/core/helpers.js +387 -387
  109. package/dist/formats/ogg/core/imdct.js +178 -178
  110. package/dist/formats/ogg/core/vorbis.js +999 -999
  111. package/dist/formats/ogg/index.js +2 -2
  112. package/dist/formats/png/CjsPngFormat.js +195 -195
  113. package/dist/formats/png/core/helpers.js +583 -583
  114. package/dist/formats/png/index.js +2 -2
  115. package/dist/formats/red/CjsRedFormat.js +261 -261
  116. package/dist/formats/red/core/CjsRedReader.js +194 -194
  117. package/dist/formats/red/core/blackDefinitions.js +3 -3
  118. package/dist/formats/red/core/helpers.js +139 -139
  119. package/dist/formats/red/core/redGraph.js +68 -68
  120. package/dist/formats/red/core/schema.js +4 -4
  121. package/dist/formats/red/index.js +2 -2
  122. package/dist/formats/stl/CjsStlFormat.js +365 -365
  123. package/dist/formats/stl/core/helpers.js +261 -261
  124. package/dist/formats/stl/core/json.js +51 -51
  125. package/dist/formats/stl/core/stl.js +629 -629
  126. package/dist/formats/stl/core/targets.js +163 -163
  127. package/dist/formats/stl/index.js +2 -2
  128. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  129. package/dist/formats/tga/core/helpers.js +446 -446
  130. package/dist/formats/tga/index.js +2 -2
  131. package/dist/formats/wav/CjsWavFormat.js +192 -192
  132. package/dist/formats/wav/core/helpers.js +328 -328
  133. package/dist/formats/wav/index.js +2 -2
  134. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  135. package/dist/formats/webm/core/helpers.js +537 -537
  136. package/dist/formats/webm/index.js +2 -2
  137. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  138. package/dist/formats/webp/core/helpers.js +214 -214
  139. package/dist/formats/webp/index.js +2 -2
  140. package/dist/formats/wem/CjsWemFormat.js +241 -241
  141. package/dist/formats/wem/core/bitStream.js +259 -259
  142. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  143. package/dist/formats/wem/core/helpers.js +417 -417
  144. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  145. package/dist/formats/wem/core/ptadpcm.js +77 -77
  146. package/dist/formats/wem/core/resolve.js +121 -121
  147. package/dist/formats/wem/core/wemToOgg.js +485 -485
  148. package/dist/formats/wem/index.js +2 -2
  149. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  150. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  151. package/dist/formats/yaml/core/helpers.js +160 -160
  152. package/dist/formats/yaml/index.js +2 -2
  153. package/dist/index.js +49 -48
  154. package/dist/index.js.map +1 -1
  155. package/dist/resourcePath.js +18 -18
  156. package/dist/resourceStates.js +9 -9
  157. package/dist/resources/AudioGeometryResData.js +47 -47
  158. package/dist/resources/GStateBindingCallbackData.js +31 -31
  159. package/dist/resources/MeshDecalData.js +37 -37
  160. package/dist/resources/MeshDecalLodData.js +34 -34
  161. package/dist/resources/Tr2EffectRes.js +71 -71
  162. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  163. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  164. package/dist/resources/Tr2ImageRes.js +114 -114
  165. package/dist/resources/Tr2LightProfileRes.js +40 -40
  166. package/dist/resources/Tr2MaterialArea.js +34 -34
  167. package/dist/resources/Tr2MaterialMesh.js +31 -31
  168. package/dist/resources/Tr2MaterialRes.js +34 -34
  169. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  170. package/dist/resources/Tr2TextureLodManager.js +80 -80
  171. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  172. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  173. package/dist/resources/Tr2TexturePipeline.js +52 -52
  174. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  175. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  176. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
  177. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
  178. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  179. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  180. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  181. package/dist/resources/TriGeometryRes.js +239 -239
  182. package/dist/resources/TriGeometryResAreaData.js +59 -59
  183. package/dist/resources/TriGeometryResJointData.js +38 -38
  184. package/dist/resources/TriGeometryResLodData.js +88 -88
  185. package/dist/resources/TriGeometryResMeshData.js +63 -63
  186. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  187. package/dist/resources/TriGrannyRes.js +43 -43
  188. package/dist/resources/TriJointBinding.js +38 -38
  189. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  190. package/dist/resources/TriRtGeometryConstants.js +88 -88
  191. package/dist/resources/TriTextureRes.js +304 -304
  192. package/dist/resources/enums.js +18 -18
  193. package/dist/resources/resourceBoundary.js +47 -47
  194. package/dist/resources/texturePipelineBehavior.js +308 -308
  195. package/dist/texture/CjsTextureArrayRes.js +406 -406
  196. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  197. package/docs/README.md +69 -0
  198. package/docs/architecture.md +86 -0
  199. package/docs/concepts/resource-lifecycle.md +217 -0
  200. package/docs/formats/README.md +104 -0
  201. package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
  202. package/docs/formats/stl.md +37 -0
  203. package/docs/formats/wwise.md +44 -0
  204. package/docs/reference/events.md +92 -0
  205. package/docs/reference/motherlode-cache.md +244 -0
  206. package/docs/reference/queues.md +102 -0
  207. package/docs/reference/reload.md +107 -0
  208. package/docs/reference/texture-arrays.md +113 -0
  209. package/docs/reference/texture-pipeline.md +53 -0
  210. package/docs/roadmap.md +104 -0
  211. package/format-notices/black/LICENSE +21 -21
  212. package/format-notices/black/NOTICE +47 -47
  213. package/format-notices/bnk/LICENSE +21 -21
  214. package/format-notices/bnk/NOTICE +20 -20
  215. package/format-notices/cmf/LICENSE +21 -21
  216. package/format-notices/cmf/NOTICE +36 -36
  217. package/format-notices/dds/LICENSE +21 -21
  218. package/format-notices/dds/NOTICE +14 -14
  219. package/format-notices/fbx/LICENSE +21 -21
  220. package/format-notices/fbx/NOTICE +14 -14
  221. package/format-notices/flac/LICENSE +21 -21
  222. package/format-notices/flac/NOTICE +14 -14
  223. package/format-notices/gif/LICENSE +21 -21
  224. package/format-notices/gif/NOTICE +14 -14
  225. package/format-notices/gltf/LICENSE +21 -21
  226. package/format-notices/gltf/NOTICE +27 -27
  227. package/format-notices/gr2/LICENSE +21 -0
  228. package/format-notices/gr2/NOTICE +60 -0
  229. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
  230. package/format-notices/jpeg/LICENSE +21 -21
  231. package/format-notices/jpeg/NOTICE +14 -14
  232. package/format-notices/mp3/LICENSE +21 -21
  233. package/format-notices/mp3/NOTICE +14 -14
  234. package/format-notices/mp4/LICENSE +21 -21
  235. package/format-notices/mp4/NOTICE +14 -14
  236. package/format-notices/obj/LICENSE +21 -21
  237. package/format-notices/obj/NOTICE +26 -26
  238. package/format-notices/ogg/LICENSE +21 -21
  239. package/format-notices/ogg/NOTICE +28 -28
  240. package/format-notices/png/LICENSE +21 -21
  241. package/format-notices/png/NOTICE +14 -14
  242. package/format-notices/red/LICENSE +21 -21
  243. package/format-notices/red/NOTICE +31 -31
  244. package/format-notices/stl/LICENSE +21 -21
  245. package/format-notices/stl/NOTICE +21 -21
  246. package/format-notices/tga/LICENSE +21 -21
  247. package/format-notices/tga/NOTICE +14 -14
  248. package/format-notices/wav/LICENSE +21 -21
  249. package/format-notices/wav/NOTICE +14 -14
  250. package/format-notices/webm/LICENSE +21 -21
  251. package/format-notices/webm/NOTICE +14 -14
  252. package/format-notices/webp/LICENSE +21 -21
  253. package/format-notices/webp/NOTICE +14 -14
  254. package/format-notices/wem/LICENSE +57 -57
  255. package/format-notices/wem/NOTICE +33 -33
  256. package/format-notices/yaml/LICENSE +21 -21
  257. package/format-notices/yaml/NOTICE +44 -44
  258. package/package.json +52 -51
  259. package/resource-lifecycle.md +0 -679
@@ -1,537 +1,537 @@
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
- webm: "webmJson"
12
- });
13
- function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsVideoFormat") {
14
- const values = {
15
- ...DEFAULT_VALUES,
16
- ...(base || {}),
17
- ...(options || {})
18
- };
19
- values.inputType = values.inputType ? String(values.inputType).replace(/^\./u, "").toLowerCase() : "";
20
- values.emit = normalizeEmit(values.emit, values.inputType, readerName);
21
- return values;
22
- }
23
- function normalizeEmit(emit, inputType, readerName) {
24
- if (emit === undefined || emit === null) return OUTPUT_RAW;
25
- if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
26
- if ([OUTPUT_VIDEO, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
27
- if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
28
- throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
29
- }
30
- function toBytes(input) {
31
- if (input instanceof Uint8Array) return input;
32
- if (input instanceof ArrayBuffer) return new Uint8Array(input);
33
- if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
34
- throw new TypeError("Video input must be Uint8Array, ArrayBuffer, or DataView");
35
- }
36
- function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
37
- const bytes = toBytes(input);
38
- const metadata = inspectBytes(bytes);
39
- if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
40
- throw new TypeError(`CjsVideoFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
41
- }
42
- return {
43
- payloadType: "video",
44
- mediaTypes: ["video"],
45
- byteLength: bytes.byteLength,
46
- sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
47
- ...metadata
48
- };
49
- }
50
- function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
51
- try {
52
- const metadata = inspectWithValues(input, values, expectedType);
53
- const codecs = getTrackCodecSummary(metadata);
54
- const mimeType = getMediaMimeType(metadata);
55
- return {
56
- format: metadata.sourceFormat,
57
- source: values.source || "buffer",
58
- supported: metadata.sourceFormat ? "partial" : "none",
59
- confidence: metadata.sourceFormat ? 1 : 0,
60
- preferred: "container",
61
- reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized video format.",
62
- metadata,
63
- variants: [{
64
- kind: "raw",
65
- payloadType: "raw",
66
- codec: metadata.sourceFormat,
67
- mimeType,
68
- supported: true,
69
- containerOnly: true,
70
- isDecoded: false,
71
- frameDecodeSupported: false
72
- }, {
73
- kind: "container",
74
- payloadType: "video",
75
- codec: metadata.sourceFormat,
76
- mimeType,
77
- codecs: codecs.codecs,
78
- videoCodecs: codecs.videoCodecs,
79
- audioCodecs: codecs.audioCodecs,
80
- supported: true,
81
- containerOnly: true,
82
- isDecoded: false,
83
- frameDecodeSupported: false
84
- }, {
85
- kind: "decoded",
86
- payloadType: "video-frame",
87
- codec: "frames",
88
- supported: false,
89
- reason: "Video decode is not implemented in this package."
90
- }],
91
- warnings: [],
92
- errors: []
93
- };
94
- } catch (error) {
95
- return {
96
- format: expectedType || values.inputType || "",
97
- source: values.source || "buffer",
98
- supported: "none",
99
- confidence: 0,
100
- preferred: "",
101
- reason: error.message,
102
- metadata: null,
103
- variants: [],
104
- warnings: [],
105
- errors: [error.message]
106
- };
107
- }
108
- }
109
- function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
110
- const bytes = toBytes(input);
111
- const metadata = inspectWithValues(bytes, values, expectedType);
112
- if (values.emit === OUTPUT_RAW) {
113
- return {
114
- payloadType: "raw",
115
- sourceFormat: metadata.sourceFormat,
116
- metadata,
117
- bytes
118
- };
119
- }
120
- if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
121
- if (values.emit === OUTPUT_VIDEO && metadata.sourceFormat === "webm") {
122
- const codecs = getTrackCodecSummary(metadata);
123
- const mimeType = getMediaMimeType(metadata);
124
- return {
125
- payloadType: OUTPUT_VIDEO,
126
- sourceFormat: "webm",
127
- container: metadata.container,
128
- mimeType,
129
- containerOnly: true,
130
- isDecoded: false,
131
- frameDecodeSupported: false,
132
- codecs: codecs.codecs,
133
- videoCodecs: codecs.videoCodecs,
134
- audioCodecs: codecs.audioCodecs,
135
- duration: metadata.duration || 0,
136
- durationTimescale: metadata.durationTimescale || 1,
137
- tracks: metadata.tracks || [],
138
- metadata,
139
- sourceBytes: bytes
140
- };
141
- }
142
- const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
143
- error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
144
- error.sourceFormat = metadata.sourceFormat;
145
- error.emit = values.emit;
146
- throw error;
147
- }
148
- function getTrackCodecSummary(metadata) {
149
- const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
150
- return {
151
- codecs: uniqueTrackCodecs(tracks),
152
- videoCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "video")),
153
- audioCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "audio"))
154
- };
155
- }
156
- function uniqueTrackCodecs(tracks) {
157
- return [...new Set(tracks.map(track => track.codec).filter(Boolean))];
158
- }
159
- function getMediaMimeType(metadata) {
160
- const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
161
- return tracks.some(track => track.type === "video") ? "video/webm" : "audio/webm";
162
- }
163
- function inspectBytes(bytes) {
164
- if (isMP4(bytes)) return inspectMP4(bytes);
165
- if (isWebM(bytes)) return inspectWebM(bytes);
166
- return {
167
- sourceFormat: ""
168
- };
169
- }
170
- function isMP4(bytes) {
171
- return bytes.byteLength >= 12 && fourCc(bytes, 4) === "ftyp";
172
- }
173
- function isWebM(bytes) {
174
- return bytes.byteLength >= 4 && bytes[0] === 0x1a && bytes[1] === 0x45 && bytes[2] === 0xdf && bytes[3] === 0xa3;
175
- }
176
- function toJsonValue(value) {
177
- if (value instanceof Uint8Array) return {
178
- byteLength: value.byteLength
179
- };
180
- if (Array.isArray(value)) return value.map(toJsonValue);
181
- if (value && typeof value === "object") {
182
- const output = {};
183
- for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
184
- return output;
185
- }
186
- return value;
187
- }
188
- function inspectMP4(bytes) {
189
- return {
190
- sourceFormat: "mp4",
191
- brand: fourCc(bytes, 8),
192
- container: "isobmff"
193
- };
194
- }
195
- function inspectWebM(bytes) {
196
- const roots = readEbmlElements(bytes, 0, bytes.byteLength);
197
- const fallbackRoots = readEbmlElements(bytes, 4, bytes.byteLength);
198
- const segment = roots.find(element => element.id === 0x18538067) || fallbackRoots.find(element => element.id === 0x18538067);
199
- if (!segment) {
200
- return {
201
- sourceFormat: "webm",
202
- container: "ebml",
203
- duration: 0,
204
- durationTimescale: 1,
205
- tracks: []
206
- };
207
- }
208
- const children = readEbmlElements(bytes, segment.dataStart, segment.end);
209
- const info = children.find(element => element.id === 0x1549a966);
210
- const tracks = children.find(element => element.id === 0x1654ae6b);
211
- const infoChildren = info ? readEbmlElements(bytes, info.dataStart, info.end) : [];
212
- const timecodeScale = readEbmlUnsignedValue(bytes, infoChildren.find(element => element.id === 0x2ad7b1)) || 1000000;
213
- const durationTicks = readEbmlFloatValue(bytes, infoChildren.find(element => element.id === 0x4489)) || 0;
214
- const duration = Math.round(durationTicks * timecodeScale);
215
- const clusters = children.filter(element => element.id === 0x1f43b675);
216
- const blockSummary = readWebmBlocks(bytes, clusters);
217
- return {
218
- sourceFormat: "webm",
219
- container: "ebml",
220
- timecodeScale,
221
- duration,
222
- durationTimescale: 1000000000,
223
- durationSeconds: duration / 1000000000,
224
- tracks: tracks ? readWebmTracks(bytes, tracks) : [],
225
- clusterCount: clusters.length,
226
- blockCount: blockSummary.blockCount,
227
- blockTrackIds: blockSummary.trackIds,
228
- clusterTimecodes: blockSummary.clusterTimecodes,
229
- blocks: blockSummary.blocks
230
- };
231
- }
232
- function readWebmTracks(bytes, tracksElement) {
233
- return readEbmlElements(bytes, tracksElement.dataStart, tracksElement.end).filter(element => element.id === 0xae).map(entry => {
234
- const fields = readEbmlElements(bytes, entry.dataStart, entry.end);
235
- const trackType = readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0x83));
236
- const video = fields.find(field => field.id === 0xe0);
237
- const audio = fields.find(field => field.id === 0xe1);
238
- const codecPrivate = fields.find(field => field.id === 0x63a2);
239
- const result = {
240
- id: readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0xd7)) || 0,
241
- type: trackType === 1 ? "video" : trackType === 2 ? "audio" : "unknown",
242
- codec: readEbmlStringValue(bytes, fields.find(field => field.id === 0x86)) || "",
243
- language: readEbmlStringValue(bytes, fields.find(field => field.id === 0x22b59c)) || "und"
244
- };
245
- const defaultDuration = readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0x23e383));
246
- if (defaultDuration) result.defaultDuration = defaultDuration;
247
- if (codecPrivate) result.codecPrivateBytes = codecPrivate.end - codecPrivate.dataStart;
248
- if (video) {
249
- const videoFields = readEbmlElements(bytes, video.dataStart, video.end);
250
- result.width = readEbmlUnsignedValue(bytes, videoFields.find(field => field.id === 0xb0)) || 0;
251
- result.height = readEbmlUnsignedValue(bytes, videoFields.find(field => field.id === 0xba)) || 0;
252
- }
253
- if (audio) {
254
- const audioFields = readEbmlElements(bytes, audio.dataStart, audio.end);
255
- result.channels = readEbmlUnsignedValue(bytes, audioFields.find(field => field.id === 0x9f)) || 0;
256
- result.sampleRate = readEbmlFloatValue(bytes, audioFields.find(field => field.id === 0xb5)) || 0;
257
- result.bitDepth = readEbmlUnsignedValue(bytes, audioFields.find(field => field.id === 0x6264)) || 0;
258
- }
259
- return result;
260
- });
261
- }
262
- function readWebmBlocks(bytes, clusters) {
263
- const trackIds = new Set();
264
- const clusterTimecodes = [];
265
- const blocks = [];
266
- let blockCount = 0;
267
- for (const cluster of clusters) {
268
- const children = readEbmlElements(bytes, cluster.dataStart, cluster.end);
269
- const clusterTimecode = readEbmlUnsignedValue(bytes, children.find(child => child.id === 0xe7));
270
- clusterTimecodes.push(clusterTimecode);
271
- for (const child of children) {
272
- if (child.id === 0xa3) {
273
- blockCount++;
274
- const block = readWebmBlock(bytes, child, clusterTimecode, true);
275
- if (block) {
276
- blocks.push(block);
277
- trackIds.add(block.trackId);
278
- }
279
- } else if (child.id === 0xa0) {
280
- const groupChildren = readEbmlElements(bytes, child.dataStart, child.end);
281
- const reference = groupChildren.some(groupChild => groupChild.id === 0xfb);
282
- for (const groupChild of groupChildren) {
283
- if (groupChild.id !== 0xa1) continue;
284
- blockCount++;
285
- const block = readWebmBlock(bytes, groupChild, clusterTimecode, false);
286
- if (block) {
287
- block.keyframe = !reference;
288
- blocks.push(block);
289
- trackIds.add(block.trackId);
290
- }
291
- }
292
- }
293
- }
294
- }
295
- return {
296
- blockCount,
297
- trackIds: Array.from(trackIds).sort((a, b) => a - b),
298
- clusterTimecodes,
299
- blocks
300
- };
301
- }
302
- function readWebmBlock(bytes, element, clusterTimecode, simple) {
303
- const track = readEbmlVint(bytes, element.dataStart, element.end);
304
- if (!track || track.value === null || element.dataStart + track.length + 3 > element.end) return null;
305
- const timecodeOffset = element.dataStart + track.length;
306
- const relativeTimecode = bytes[timecodeOffset] << 8 | bytes[timecodeOffset + 1];
307
- const signedTimecode = relativeTimecode & 0x8000 ? relativeTimecode - 0x10000 : relativeTimecode;
308
- const flags = bytes[timecodeOffset + 2];
309
- const lacing = ["none", "xiph", "fixed", "ebml"][flags >> 1 & 0x03];
310
- const frames = readWebmBlockFrames(bytes, timecodeOffset + 3, element.end, lacing);
311
- return {
312
- trackId: track.value,
313
- timecode: signedTimecode,
314
- absoluteTimecode: clusterTimecode + signedTimecode,
315
- keyframe: simple ? !!(flags & 0x80) : false,
316
- invisible: !!(flags & 0x08),
317
- lacing,
318
- frameCount: frames.frameCount,
319
- frameSizes: frames.frameSizes,
320
- payloadBytes: frames.payloadBytes,
321
- ...(frames.error ? {
322
- lacingError: frames.error
323
- } : {})
324
- };
325
- }
326
- function readWebmBlockFrames(bytes, payloadStart, payloadEnd, lacing) {
327
- const payloadBytes = Math.max(0, payloadEnd - payloadStart);
328
- if (payloadStart > payloadEnd) return {
329
- frameCount: 0,
330
- frameSizes: [],
331
- payloadBytes: 0,
332
- error: "invalid-payload-range"
333
- };
334
- if (lacing === "none") return {
335
- frameCount: 1,
336
- frameSizes: [payloadBytes],
337
- payloadBytes
338
- };
339
- if (payloadStart >= payloadEnd) return {
340
- frameCount: 0,
341
- frameSizes: [],
342
- payloadBytes,
343
- error: "missing-lacing-header"
344
- };
345
- const frameCount = bytes[payloadStart] + 1;
346
- const dataStart = payloadStart + 1;
347
- if (frameCount < 2) return {
348
- frameCount,
349
- frameSizes: [],
350
- payloadBytes,
351
- error: "invalid-laced-frame-count"
352
- };
353
- if (lacing === "fixed") return readFixedLacedFrames(payloadBytes, frameCount);
354
- if (lacing === "xiph") return readXiphLacedFrames(bytes, dataStart, payloadEnd, payloadBytes, frameCount);
355
- return readEbmlLacedFrames(bytes, dataStart, payloadEnd, payloadBytes, frameCount);
356
- }
357
- function readFixedLacedFrames(payloadBytes, frameCount) {
358
- const dataBytes = payloadBytes - 1;
359
- if (dataBytes < 0 || dataBytes % frameCount !== 0) {
360
- return {
361
- frameCount,
362
- frameSizes: [],
363
- payloadBytes,
364
- error: "invalid-fixed-lacing-size"
365
- };
366
- }
367
- return {
368
- frameCount,
369
- frameSizes: Array.from({
370
- length: frameCount
371
- }, () => dataBytes / frameCount),
372
- payloadBytes
373
- };
374
- }
375
- function readXiphLacedFrames(bytes, offset, end, payloadBytes, frameCount) {
376
- const frameSizes = [];
377
- for (let frame = 0; frame < frameCount - 1; frame++) {
378
- let size = 0;
379
- let closed = false;
380
- while (offset < end) {
381
- const value = bytes[offset++];
382
- size += value;
383
- if (value !== 255) {
384
- closed = true;
385
- break;
386
- }
387
- }
388
- if (!closed) return {
389
- frameCount,
390
- frameSizes: [],
391
- payloadBytes,
392
- error: "unterminated-xiph-lacing-size"
393
- };
394
- frameSizes.push(size);
395
- }
396
- const remaining = end - offset - frameSizes.reduce((sum, size) => sum + size, 0);
397
- if (remaining < 0) return {
398
- frameCount,
399
- frameSizes: [],
400
- payloadBytes,
401
- error: "invalid-xiph-lacing-size"
402
- };
403
- frameSizes.push(remaining);
404
- return {
405
- frameCount,
406
- frameSizes,
407
- payloadBytes
408
- };
409
- }
410
- function readEbmlLacedFrames(bytes, offset, end, payloadBytes, frameCount) {
411
- const first = readEbmlVint(bytes, offset, end);
412
- if (!first || first.value === null) return {
413
- frameCount,
414
- frameSizes: [],
415
- payloadBytes,
416
- error: "missing-ebml-lacing-size"
417
- };
418
- const frameSizes = [first.value];
419
- offset += first.length;
420
- for (let frame = 1; frame < frameCount - 1; frame++) {
421
- const delta = readEbmlSignedVint(bytes, offset, end);
422
- if (!delta) return {
423
- frameCount,
424
- frameSizes: [],
425
- payloadBytes,
426
- error: "missing-ebml-lacing-delta"
427
- };
428
- const size = frameSizes[frame - 1] + delta.value;
429
- if (size < 0) return {
430
- frameCount,
431
- frameSizes: [],
432
- payloadBytes,
433
- error: "invalid-ebml-lacing-size"
434
- };
435
- frameSizes.push(size);
436
- offset += delta.length;
437
- }
438
- const remaining = end - offset - frameSizes.reduce((sum, size) => sum + size, 0);
439
- if (remaining < 0) return {
440
- frameCount,
441
- frameSizes: [],
442
- payloadBytes,
443
- error: "invalid-ebml-lacing-size"
444
- };
445
- frameSizes.push(remaining);
446
- return {
447
- frameCount,
448
- frameSizes,
449
- payloadBytes
450
- };
451
- }
452
- function readEbmlElements(bytes, start, end) {
453
- const elements = [];
454
- let offset = start;
455
- while (offset < end) {
456
- const id = readEbmlId(bytes, offset, end);
457
- if (!id) break;
458
- const size = readEbmlVint(bytes, offset + id.length, end);
459
- if (!size) break;
460
- const dataStart = offset + id.length + size.length;
461
- const elementEnd = size.value === null ? end : dataStart + size.value;
462
- if (elementEnd > end) break;
463
- elements.push({
464
- id: id.value,
465
- dataStart,
466
- end: elementEnd
467
- });
468
- if (size.value === null) break;
469
- offset = elementEnd;
470
- }
471
- return elements;
472
- }
473
- function readEbmlId(bytes, offset, end) {
474
- if (offset >= end) return null;
475
- const first = bytes[offset];
476
- let length = 1;
477
- let mask = 0x80;
478
- while (length <= 4 && !(first & mask)) {
479
- length++;
480
- mask >>>= 1;
481
- }
482
- if (length > 4 || offset + length > end) return null;
483
- let value = 0;
484
- for (let i = 0; i < length; i++) value = value * 256 + bytes[offset + i];
485
- return {
486
- value,
487
- length
488
- };
489
- }
490
- function readEbmlVint(bytes, offset, end, removeMarker) {
491
- if (offset >= end) return null;
492
- const first = bytes[offset];
493
- let length = 1;
494
- let mask = 0x80;
495
- while (length <= 8 && !(first & mask)) {
496
- length++;
497
- mask >>>= 1;
498
- }
499
- if (length > 8 || offset + length > end) return null;
500
- let value = first & (~mask & 0xff) ;
501
- for (let i = 1; i < length; i++) value = value * 256 + bytes[offset + i];
502
- const unknown = value === Math.pow(2, length * 7) - 1;
503
- return {
504
- value: unknown ? null : value,
505
- length
506
- };
507
- }
508
- function readEbmlSignedVint(bytes, offset, end) {
509
- const vint = readEbmlVint(bytes, offset, end);
510
- if (!vint || vint.value === null) return null;
511
- const bias = Math.pow(2, vint.length * 7 - 1) - 1;
512
- return {
513
- value: vint.value - bias,
514
- length: vint.length
515
- };
516
- }
517
- function readEbmlUnsignedValue(bytes, element) {
518
- if (!element) return 0;
519
- let value = 0;
520
- for (let offset = element.dataStart; offset < element.end; offset++) value = value * 256 + bytes[offset];
521
- return value;
522
- }
523
- function readEbmlFloatValue(bytes, element) {
524
- if (!element || ![4, 8].includes(element.end - element.dataStart)) return 0;
525
- const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
526
- return element.end - element.dataStart === 4 ? view.getFloat32(element.dataStart, false) : view.getFloat64(element.dataStart, false);
527
- }
528
- function readEbmlStringValue(bytes, element) {
529
- if (!element) return "";
530
- return new TextDecoder().decode(bytes.subarray(element.dataStart, element.end));
531
- }
532
- function fourCc(bytes, offset) {
533
- return String.fromCharCode(bytes[offset] || 0, bytes[offset + 1] || 0, bytes[offset + 2] || 0, bytes[offset + 3] || 0);
534
- }
535
-
536
- export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_VIDEO, inspectBytes, inspectWithValues, isMP4, isSupportedWithValues, isWebM, normalizeEmit, normalizeValues, readWithValues, toBytes, toJsonValue };
537
- //# 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
+ webm: "webmJson"
12
+ });
13
+ function normalizeValues(base = DEFAULT_VALUES, options = {}, readerName = "CjsVideoFormat") {
14
+ const values = {
15
+ ...DEFAULT_VALUES,
16
+ ...(base || {}),
17
+ ...(options || {})
18
+ };
19
+ values.inputType = values.inputType ? String(values.inputType).replace(/^\./u, "").toLowerCase() : "";
20
+ values.emit = normalizeEmit(values.emit, values.inputType, readerName);
21
+ return values;
22
+ }
23
+ function normalizeEmit(emit, inputType, readerName) {
24
+ if (emit === undefined || emit === null) return OUTPUT_RAW;
25
+ if (emit === OUTPUT_JSON && inputType) return DEBUG_OUTPUTS[inputType] || OUTPUT_JSON;
26
+ if ([OUTPUT_VIDEO, OUTPUT_RAW, OUTPUT_JSON].includes(emit)) return emit;
27
+ if (Object.values(DEBUG_OUTPUTS).includes(emit)) return emit;
28
+ throw new TypeError(`${readerName}: unknown emit value ${JSON.stringify(emit)}`);
29
+ }
30
+ function toBytes(input) {
31
+ if (input instanceof Uint8Array) return input;
32
+ if (input instanceof ArrayBuffer) return new Uint8Array(input);
33
+ if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
34
+ throw new TypeError("Video input must be Uint8Array, ArrayBuffer, or DataView");
35
+ }
36
+ function inspectWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
37
+ const bytes = toBytes(input);
38
+ const metadata = inspectBytes(bytes);
39
+ if (expectedType && metadata.sourceFormat && metadata.sourceFormat !== expectedType) {
40
+ throw new TypeError(`CjsVideoFormat: expected ${expectedType}, got ${metadata.sourceFormat}`);
41
+ }
42
+ return {
43
+ payloadType: "video",
44
+ mediaTypes: ["video"],
45
+ byteLength: bytes.byteLength,
46
+ sourceFormat: expectedType || values.inputType || metadata.sourceFormat,
47
+ ...metadata
48
+ };
49
+ }
50
+ function isSupportedWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
51
+ try {
52
+ const metadata = inspectWithValues(input, values, expectedType);
53
+ const codecs = getTrackCodecSummary(metadata);
54
+ const mimeType = getMediaMimeType(metadata);
55
+ return {
56
+ format: metadata.sourceFormat,
57
+ source: values.source || "buffer",
58
+ supported: metadata.sourceFormat ? "partial" : "none",
59
+ confidence: metadata.sourceFormat ? 1 : 0,
60
+ preferred: "container",
61
+ reason: metadata.sourceFormat ? "Container/header recognized." : "Unrecognized video format.",
62
+ metadata,
63
+ variants: [{
64
+ kind: "raw",
65
+ payloadType: "raw",
66
+ codec: metadata.sourceFormat,
67
+ mimeType,
68
+ supported: true,
69
+ containerOnly: true,
70
+ isDecoded: false,
71
+ frameDecodeSupported: false
72
+ }, {
73
+ kind: "container",
74
+ payloadType: "video",
75
+ codec: metadata.sourceFormat,
76
+ mimeType,
77
+ codecs: codecs.codecs,
78
+ videoCodecs: codecs.videoCodecs,
79
+ audioCodecs: codecs.audioCodecs,
80
+ supported: true,
81
+ containerOnly: true,
82
+ isDecoded: false,
83
+ frameDecodeSupported: false
84
+ }, {
85
+ kind: "decoded",
86
+ payloadType: "video-frame",
87
+ codec: "frames",
88
+ supported: false,
89
+ reason: "Video decode is not implemented in this package."
90
+ }],
91
+ warnings: [],
92
+ errors: []
93
+ };
94
+ } catch (error) {
95
+ return {
96
+ format: expectedType || values.inputType || "",
97
+ source: values.source || "buffer",
98
+ supported: "none",
99
+ confidence: 0,
100
+ preferred: "",
101
+ reason: error.message,
102
+ metadata: null,
103
+ variants: [],
104
+ warnings: [],
105
+ errors: [error.message]
106
+ };
107
+ }
108
+ }
109
+ function readWithValues(input, values = DEFAULT_VALUES, expectedType = "") {
110
+ const bytes = toBytes(input);
111
+ const metadata = inspectWithValues(bytes, values, expectedType);
112
+ if (values.emit === OUTPUT_RAW) {
113
+ return {
114
+ payloadType: "raw",
115
+ sourceFormat: metadata.sourceFormat,
116
+ metadata,
117
+ bytes
118
+ };
119
+ }
120
+ if (values.emit === OUTPUT_JSON || values.emit === DEBUG_OUTPUTS[metadata.sourceFormat]) return metadata;
121
+ if (values.emit === OUTPUT_VIDEO && metadata.sourceFormat === "webm") {
122
+ const codecs = getTrackCodecSummary(metadata);
123
+ const mimeType = getMediaMimeType(metadata);
124
+ return {
125
+ payloadType: OUTPUT_VIDEO,
126
+ sourceFormat: "webm",
127
+ container: metadata.container,
128
+ mimeType,
129
+ containerOnly: true,
130
+ isDecoded: false,
131
+ frameDecodeSupported: false,
132
+ codecs: codecs.codecs,
133
+ videoCodecs: codecs.videoCodecs,
134
+ audioCodecs: codecs.audioCodecs,
135
+ duration: metadata.duration || 0,
136
+ durationTimescale: metadata.durationTimescale || 1,
137
+ tracks: metadata.tracks || [],
138
+ metadata,
139
+ sourceBytes: bytes
140
+ };
141
+ }
142
+ const error = new Error(`${metadata.sourceFormat}: emit "${values.emit}" is not implemented yet`);
143
+ error.code = "CJS_FORMAT_OUTPUT_NOT_IMPLEMENTED";
144
+ error.sourceFormat = metadata.sourceFormat;
145
+ error.emit = values.emit;
146
+ throw error;
147
+ }
148
+ function getTrackCodecSummary(metadata) {
149
+ const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
150
+ return {
151
+ codecs: uniqueTrackCodecs(tracks),
152
+ videoCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "video")),
153
+ audioCodecs: uniqueTrackCodecs(tracks.filter(track => track.type === "audio"))
154
+ };
155
+ }
156
+ function uniqueTrackCodecs(tracks) {
157
+ return [...new Set(tracks.map(track => track.codec).filter(Boolean))];
158
+ }
159
+ function getMediaMimeType(metadata) {
160
+ const tracks = Array.isArray(metadata.tracks) ? metadata.tracks : [];
161
+ return tracks.some(track => track.type === "video") ? "video/webm" : "audio/webm";
162
+ }
163
+ function inspectBytes(bytes) {
164
+ if (isMP4(bytes)) return inspectMP4(bytes);
165
+ if (isWebM(bytes)) return inspectWebM(bytes);
166
+ return {
167
+ sourceFormat: ""
168
+ };
169
+ }
170
+ function isMP4(bytes) {
171
+ return bytes.byteLength >= 12 && fourCc(bytes, 4) === "ftyp";
172
+ }
173
+ function isWebM(bytes) {
174
+ return bytes.byteLength >= 4 && bytes[0] === 0x1a && bytes[1] === 0x45 && bytes[2] === 0xdf && bytes[3] === 0xa3;
175
+ }
176
+ function toJsonValue(value) {
177
+ if (value instanceof Uint8Array) return {
178
+ byteLength: value.byteLength
179
+ };
180
+ if (Array.isArray(value)) return value.map(toJsonValue);
181
+ if (value && typeof value === "object") {
182
+ const output = {};
183
+ for (const [key, entry] of Object.entries(value)) output[key] = toJsonValue(entry);
184
+ return output;
185
+ }
186
+ return value;
187
+ }
188
+ function inspectMP4(bytes) {
189
+ return {
190
+ sourceFormat: "mp4",
191
+ brand: fourCc(bytes, 8),
192
+ container: "isobmff"
193
+ };
194
+ }
195
+ function inspectWebM(bytes) {
196
+ const roots = readEbmlElements(bytes, 0, bytes.byteLength);
197
+ const fallbackRoots = readEbmlElements(bytes, 4, bytes.byteLength);
198
+ const segment = roots.find(element => element.id === 0x18538067) || fallbackRoots.find(element => element.id === 0x18538067);
199
+ if (!segment) {
200
+ return {
201
+ sourceFormat: "webm",
202
+ container: "ebml",
203
+ duration: 0,
204
+ durationTimescale: 1,
205
+ tracks: []
206
+ };
207
+ }
208
+ const children = readEbmlElements(bytes, segment.dataStart, segment.end);
209
+ const info = children.find(element => element.id === 0x1549a966);
210
+ const tracks = children.find(element => element.id === 0x1654ae6b);
211
+ const infoChildren = info ? readEbmlElements(bytes, info.dataStart, info.end) : [];
212
+ const timecodeScale = readEbmlUnsignedValue(bytes, infoChildren.find(element => element.id === 0x2ad7b1)) || 1000000;
213
+ const durationTicks = readEbmlFloatValue(bytes, infoChildren.find(element => element.id === 0x4489)) || 0;
214
+ const duration = Math.round(durationTicks * timecodeScale);
215
+ const clusters = children.filter(element => element.id === 0x1f43b675);
216
+ const blockSummary = readWebmBlocks(bytes, clusters);
217
+ return {
218
+ sourceFormat: "webm",
219
+ container: "ebml",
220
+ timecodeScale,
221
+ duration,
222
+ durationTimescale: 1000000000,
223
+ durationSeconds: duration / 1000000000,
224
+ tracks: tracks ? readWebmTracks(bytes, tracks) : [],
225
+ clusterCount: clusters.length,
226
+ blockCount: blockSummary.blockCount,
227
+ blockTrackIds: blockSummary.trackIds,
228
+ clusterTimecodes: blockSummary.clusterTimecodes,
229
+ blocks: blockSummary.blocks
230
+ };
231
+ }
232
+ function readWebmTracks(bytes, tracksElement) {
233
+ return readEbmlElements(bytes, tracksElement.dataStart, tracksElement.end).filter(element => element.id === 0xae).map(entry => {
234
+ const fields = readEbmlElements(bytes, entry.dataStart, entry.end);
235
+ const trackType = readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0x83));
236
+ const video = fields.find(field => field.id === 0xe0);
237
+ const audio = fields.find(field => field.id === 0xe1);
238
+ const codecPrivate = fields.find(field => field.id === 0x63a2);
239
+ const result = {
240
+ id: readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0xd7)) || 0,
241
+ type: trackType === 1 ? "video" : trackType === 2 ? "audio" : "unknown",
242
+ codec: readEbmlStringValue(bytes, fields.find(field => field.id === 0x86)) || "",
243
+ language: readEbmlStringValue(bytes, fields.find(field => field.id === 0x22b59c)) || "und"
244
+ };
245
+ const defaultDuration = readEbmlUnsignedValue(bytes, fields.find(field => field.id === 0x23e383));
246
+ if (defaultDuration) result.defaultDuration = defaultDuration;
247
+ if (codecPrivate) result.codecPrivateBytes = codecPrivate.end - codecPrivate.dataStart;
248
+ if (video) {
249
+ const videoFields = readEbmlElements(bytes, video.dataStart, video.end);
250
+ result.width = readEbmlUnsignedValue(bytes, videoFields.find(field => field.id === 0xb0)) || 0;
251
+ result.height = readEbmlUnsignedValue(bytes, videoFields.find(field => field.id === 0xba)) || 0;
252
+ }
253
+ if (audio) {
254
+ const audioFields = readEbmlElements(bytes, audio.dataStart, audio.end);
255
+ result.channels = readEbmlUnsignedValue(bytes, audioFields.find(field => field.id === 0x9f)) || 0;
256
+ result.sampleRate = readEbmlFloatValue(bytes, audioFields.find(field => field.id === 0xb5)) || 0;
257
+ result.bitDepth = readEbmlUnsignedValue(bytes, audioFields.find(field => field.id === 0x6264)) || 0;
258
+ }
259
+ return result;
260
+ });
261
+ }
262
+ function readWebmBlocks(bytes, clusters) {
263
+ const trackIds = new Set();
264
+ const clusterTimecodes = [];
265
+ const blocks = [];
266
+ let blockCount = 0;
267
+ for (const cluster of clusters) {
268
+ const children = readEbmlElements(bytes, cluster.dataStart, cluster.end);
269
+ const clusterTimecode = readEbmlUnsignedValue(bytes, children.find(child => child.id === 0xe7));
270
+ clusterTimecodes.push(clusterTimecode);
271
+ for (const child of children) {
272
+ if (child.id === 0xa3) {
273
+ blockCount++;
274
+ const block = readWebmBlock(bytes, child, clusterTimecode, true);
275
+ if (block) {
276
+ blocks.push(block);
277
+ trackIds.add(block.trackId);
278
+ }
279
+ } else if (child.id === 0xa0) {
280
+ const groupChildren = readEbmlElements(bytes, child.dataStart, child.end);
281
+ const reference = groupChildren.some(groupChild => groupChild.id === 0xfb);
282
+ for (const groupChild of groupChildren) {
283
+ if (groupChild.id !== 0xa1) continue;
284
+ blockCount++;
285
+ const block = readWebmBlock(bytes, groupChild, clusterTimecode, false);
286
+ if (block) {
287
+ block.keyframe = !reference;
288
+ blocks.push(block);
289
+ trackIds.add(block.trackId);
290
+ }
291
+ }
292
+ }
293
+ }
294
+ }
295
+ return {
296
+ blockCount,
297
+ trackIds: Array.from(trackIds).sort((a, b) => a - b),
298
+ clusterTimecodes,
299
+ blocks
300
+ };
301
+ }
302
+ function readWebmBlock(bytes, element, clusterTimecode, simple) {
303
+ const track = readEbmlVint(bytes, element.dataStart, element.end);
304
+ if (!track || track.value === null || element.dataStart + track.length + 3 > element.end) return null;
305
+ const timecodeOffset = element.dataStart + track.length;
306
+ const relativeTimecode = bytes[timecodeOffset] << 8 | bytes[timecodeOffset + 1];
307
+ const signedTimecode = relativeTimecode & 0x8000 ? relativeTimecode - 0x10000 : relativeTimecode;
308
+ const flags = bytes[timecodeOffset + 2];
309
+ const lacing = ["none", "xiph", "fixed", "ebml"][flags >> 1 & 0x03];
310
+ const frames = readWebmBlockFrames(bytes, timecodeOffset + 3, element.end, lacing);
311
+ return {
312
+ trackId: track.value,
313
+ timecode: signedTimecode,
314
+ absoluteTimecode: clusterTimecode + signedTimecode,
315
+ keyframe: simple ? !!(flags & 0x80) : false,
316
+ invisible: !!(flags & 0x08),
317
+ lacing,
318
+ frameCount: frames.frameCount,
319
+ frameSizes: frames.frameSizes,
320
+ payloadBytes: frames.payloadBytes,
321
+ ...(frames.error ? {
322
+ lacingError: frames.error
323
+ } : {})
324
+ };
325
+ }
326
+ function readWebmBlockFrames(bytes, payloadStart, payloadEnd, lacing) {
327
+ const payloadBytes = Math.max(0, payloadEnd - payloadStart);
328
+ if (payloadStart > payloadEnd) return {
329
+ frameCount: 0,
330
+ frameSizes: [],
331
+ payloadBytes: 0,
332
+ error: "invalid-payload-range"
333
+ };
334
+ if (lacing === "none") return {
335
+ frameCount: 1,
336
+ frameSizes: [payloadBytes],
337
+ payloadBytes
338
+ };
339
+ if (payloadStart >= payloadEnd) return {
340
+ frameCount: 0,
341
+ frameSizes: [],
342
+ payloadBytes,
343
+ error: "missing-lacing-header"
344
+ };
345
+ const frameCount = bytes[payloadStart] + 1;
346
+ const dataStart = payloadStart + 1;
347
+ if (frameCount < 2) return {
348
+ frameCount,
349
+ frameSizes: [],
350
+ payloadBytes,
351
+ error: "invalid-laced-frame-count"
352
+ };
353
+ if (lacing === "fixed") return readFixedLacedFrames(payloadBytes, frameCount);
354
+ if (lacing === "xiph") return readXiphLacedFrames(bytes, dataStart, payloadEnd, payloadBytes, frameCount);
355
+ return readEbmlLacedFrames(bytes, dataStart, payloadEnd, payloadBytes, frameCount);
356
+ }
357
+ function readFixedLacedFrames(payloadBytes, frameCount) {
358
+ const dataBytes = payloadBytes - 1;
359
+ if (dataBytes < 0 || dataBytes % frameCount !== 0) {
360
+ return {
361
+ frameCount,
362
+ frameSizes: [],
363
+ payloadBytes,
364
+ error: "invalid-fixed-lacing-size"
365
+ };
366
+ }
367
+ return {
368
+ frameCount,
369
+ frameSizes: Array.from({
370
+ length: frameCount
371
+ }, () => dataBytes / frameCount),
372
+ payloadBytes
373
+ };
374
+ }
375
+ function readXiphLacedFrames(bytes, offset, end, payloadBytes, frameCount) {
376
+ const frameSizes = [];
377
+ for (let frame = 0; frame < frameCount - 1; frame++) {
378
+ let size = 0;
379
+ let closed = false;
380
+ while (offset < end) {
381
+ const value = bytes[offset++];
382
+ size += value;
383
+ if (value !== 255) {
384
+ closed = true;
385
+ break;
386
+ }
387
+ }
388
+ if (!closed) return {
389
+ frameCount,
390
+ frameSizes: [],
391
+ payloadBytes,
392
+ error: "unterminated-xiph-lacing-size"
393
+ };
394
+ frameSizes.push(size);
395
+ }
396
+ const remaining = end - offset - frameSizes.reduce((sum, size) => sum + size, 0);
397
+ if (remaining < 0) return {
398
+ frameCount,
399
+ frameSizes: [],
400
+ payloadBytes,
401
+ error: "invalid-xiph-lacing-size"
402
+ };
403
+ frameSizes.push(remaining);
404
+ return {
405
+ frameCount,
406
+ frameSizes,
407
+ payloadBytes
408
+ };
409
+ }
410
+ function readEbmlLacedFrames(bytes, offset, end, payloadBytes, frameCount) {
411
+ const first = readEbmlVint(bytes, offset, end);
412
+ if (!first || first.value === null) return {
413
+ frameCount,
414
+ frameSizes: [],
415
+ payloadBytes,
416
+ error: "missing-ebml-lacing-size"
417
+ };
418
+ const frameSizes = [first.value];
419
+ offset += first.length;
420
+ for (let frame = 1; frame < frameCount - 1; frame++) {
421
+ const delta = readEbmlSignedVint(bytes, offset, end);
422
+ if (!delta) return {
423
+ frameCount,
424
+ frameSizes: [],
425
+ payloadBytes,
426
+ error: "missing-ebml-lacing-delta"
427
+ };
428
+ const size = frameSizes[frame - 1] + delta.value;
429
+ if (size < 0) return {
430
+ frameCount,
431
+ frameSizes: [],
432
+ payloadBytes,
433
+ error: "invalid-ebml-lacing-size"
434
+ };
435
+ frameSizes.push(size);
436
+ offset += delta.length;
437
+ }
438
+ const remaining = end - offset - frameSizes.reduce((sum, size) => sum + size, 0);
439
+ if (remaining < 0) return {
440
+ frameCount,
441
+ frameSizes: [],
442
+ payloadBytes,
443
+ error: "invalid-ebml-lacing-size"
444
+ };
445
+ frameSizes.push(remaining);
446
+ return {
447
+ frameCount,
448
+ frameSizes,
449
+ payloadBytes
450
+ };
451
+ }
452
+ function readEbmlElements(bytes, start, end) {
453
+ const elements = [];
454
+ let offset = start;
455
+ while (offset < end) {
456
+ const id = readEbmlId(bytes, offset, end);
457
+ if (!id) break;
458
+ const size = readEbmlVint(bytes, offset + id.length, end);
459
+ if (!size) break;
460
+ const dataStart = offset + id.length + size.length;
461
+ const elementEnd = size.value === null ? end : dataStart + size.value;
462
+ if (elementEnd > end) break;
463
+ elements.push({
464
+ id: id.value,
465
+ dataStart,
466
+ end: elementEnd
467
+ });
468
+ if (size.value === null) break;
469
+ offset = elementEnd;
470
+ }
471
+ return elements;
472
+ }
473
+ function readEbmlId(bytes, offset, end) {
474
+ if (offset >= end) return null;
475
+ const first = bytes[offset];
476
+ let length = 1;
477
+ let mask = 0x80;
478
+ while (length <= 4 && !(first & mask)) {
479
+ length++;
480
+ mask >>>= 1;
481
+ }
482
+ if (length > 4 || offset + length > end) return null;
483
+ let value = 0;
484
+ for (let i = 0; i < length; i++) value = value * 256 + bytes[offset + i];
485
+ return {
486
+ value,
487
+ length
488
+ };
489
+ }
490
+ function readEbmlVint(bytes, offset, end, removeMarker) {
491
+ if (offset >= end) return null;
492
+ const first = bytes[offset];
493
+ let length = 1;
494
+ let mask = 0x80;
495
+ while (length <= 8 && !(first & mask)) {
496
+ length++;
497
+ mask >>>= 1;
498
+ }
499
+ if (length > 8 || offset + length > end) return null;
500
+ let value = first & (~mask & 0xff) ;
501
+ for (let i = 1; i < length; i++) value = value * 256 + bytes[offset + i];
502
+ const unknown = value === Math.pow(2, length * 7) - 1;
503
+ return {
504
+ value: unknown ? null : value,
505
+ length
506
+ };
507
+ }
508
+ function readEbmlSignedVint(bytes, offset, end) {
509
+ const vint = readEbmlVint(bytes, offset, end);
510
+ if (!vint || vint.value === null) return null;
511
+ const bias = Math.pow(2, vint.length * 7 - 1) - 1;
512
+ return {
513
+ value: vint.value - bias,
514
+ length: vint.length
515
+ };
516
+ }
517
+ function readEbmlUnsignedValue(bytes, element) {
518
+ if (!element) return 0;
519
+ let value = 0;
520
+ for (let offset = element.dataStart; offset < element.end; offset++) value = value * 256 + bytes[offset];
521
+ return value;
522
+ }
523
+ function readEbmlFloatValue(bytes, element) {
524
+ if (!element || ![4, 8].includes(element.end - element.dataStart)) return 0;
525
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
526
+ return element.end - element.dataStart === 4 ? view.getFloat32(element.dataStart, false) : view.getFloat64(element.dataStart, false);
527
+ }
528
+ function readEbmlStringValue(bytes, element) {
529
+ if (!element) return "";
530
+ return new TextDecoder().decode(bytes.subarray(element.dataStart, element.end));
531
+ }
532
+ function fourCc(bytes, offset) {
533
+ return String.fromCharCode(bytes[offset] || 0, bytes[offset + 1] || 0, bytes[offset + 2] || 0, bytes[offset + 3] || 0);
534
+ }
535
+
536
+ export { DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_VIDEO, inspectBytes, inspectWithValues, isMP4, isSupportedWithValues, isWebM, normalizeEmit, normalizeValues, readWithValues, toBytes, toJsonValue };
537
+ //# sourceMappingURL=helpers.js.map