@carbonenginejs/runtime-resource 0.7.0 → 0.8.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 (219) hide show
  1. package/FORMAT-PROVENANCE.md +155 -144
  2. package/LICENSE +21 -21
  3. package/NOTICE +29 -29
  4. package/README.md +11 -0
  5. package/dist/CjsMotherLode.js +1271 -1271
  6. package/dist/CjsResMan.js +3005 -3005
  7. package/dist/CjsResManQueue.js +214 -214
  8. package/dist/CjsResource.js +566 -566
  9. package/dist/CjsResourceSource.js +59 -59
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +192 -192
  13. package/dist/format/CjsReader.js +18 -18
  14. package/dist/format/CjsResourceProbe.js +277 -277
  15. package/dist/format/payloadContract.js +173 -173
  16. package/dist/formats/black/CjsBlackFormat.js +278 -278
  17. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  18. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  19. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  20. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  21. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  22. package/dist/formats/black/core/blackConstants.js +7 -7
  23. package/dist/formats/black/core/blackDefinitions.js +10 -10
  24. package/dist/formats/black/core/blackEnums.js +6 -6
  25. package/dist/formats/black/core/blackSchema.js +3 -3
  26. package/dist/formats/black/core/blackVersion.js +22 -22
  27. package/dist/formats/black/core/helpers.js +182 -182
  28. package/dist/formats/black/core/schema.js +4 -4
  29. package/dist/formats/black/index.js +2 -2
  30. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  31. package/dist/formats/bnk/core/graph.js +140 -140
  32. package/dist/formats/bnk/core/helpers.js +409 -409
  33. package/dist/formats/bnk/core/musicNodes.js +489 -489
  34. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  35. package/dist/formats/bnk/index.js +2 -2
  36. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  37. package/dist/formats/cmf/core/binary.js +118 -118
  38. package/dist/formats/cmf/core/buffers.js +233 -233
  39. package/dist/formats/cmf/core/constants.js +47 -47
  40. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  41. package/dist/formats/cmf/core/helpers.js +287 -287
  42. package/dist/formats/cmf/core/pack.js +276 -276
  43. package/dist/formats/cmf/core/schema.js +364 -364
  44. package/dist/formats/cmf/core/shared.js +268 -268
  45. package/dist/formats/cmf/core/writer.js +517 -517
  46. package/dist/formats/cmf/index.js +2 -2
  47. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  48. package/dist/formats/dds/core/bc6h.js +288 -0
  49. package/dist/formats/dds/core/bc6h.js.map +1 -0
  50. package/dist/formats/dds/core/bc7.js +251 -0
  51. package/dist/formats/dds/core/bc7.js.map +1 -0
  52. package/dist/formats/dds/core/helpers.js +815 -812
  53. package/dist/formats/dds/core/helpers.js.map +1 -1
  54. package/dist/formats/dds/index.js +2 -2
  55. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  56. package/dist/formats/fbx/core/helpers.js +3901 -3901
  57. package/dist/formats/fbx/index.js +2 -2
  58. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  59. package/dist/formats/flac/core/helpers.js +295 -295
  60. package/dist/formats/flac/index.js +2 -2
  61. package/dist/formats/gif/CjsGifFormat.js +87 -87
  62. package/dist/formats/gif/core/helpers.js +360 -360
  63. package/dist/formats/gif/index.js +2 -2
  64. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  65. package/dist/formats/gltf/core/helpers.js +292 -292
  66. package/dist/formats/gltf/core/json.js +79 -79
  67. package/dist/formats/gltf/core/parser.js +666 -666
  68. package/dist/formats/gltf/core/targets.js +163 -163
  69. package/dist/formats/gltf/index.js +2 -2
  70. package/dist/formats/index.js +23 -23
  71. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  72. package/dist/formats/jpeg/core/helpers.js +350 -350
  73. package/dist/formats/jpeg/core/jpeg.js +377 -377
  74. package/dist/formats/jpeg/index.js +2 -2
  75. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  76. package/dist/formats/mp3/core/helpers.js +338 -338
  77. package/dist/formats/mp3/index.js +2 -2
  78. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  79. package/dist/formats/mp4/core/helpers.js +449 -449
  80. package/dist/formats/mp4/index.js +2 -2
  81. package/dist/formats/obj/CjsObjFormat.js +253 -253
  82. package/dist/formats/obj/core/helpers.js +573 -573
  83. package/dist/formats/obj/core/json.js +64 -64
  84. package/dist/formats/obj/core/parser.js +321 -321
  85. package/dist/formats/obj/index.js +2 -2
  86. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  87. package/dist/formats/ogg/core/helpers.js +387 -387
  88. package/dist/formats/ogg/core/imdct.js +178 -178
  89. package/dist/formats/ogg/core/vorbis.js +999 -999
  90. package/dist/formats/ogg/index.js +2 -2
  91. package/dist/formats/png/CjsPngFormat.js +195 -195
  92. package/dist/formats/png/core/helpers.js +583 -583
  93. package/dist/formats/png/index.js +2 -2
  94. package/dist/formats/red/CjsRedFormat.js +261 -261
  95. package/dist/formats/red/core/CjsRedReader.js +194 -194
  96. package/dist/formats/red/core/blackDefinitions.js +3 -3
  97. package/dist/formats/red/core/helpers.js +139 -139
  98. package/dist/formats/red/core/redGraph.js +68 -68
  99. package/dist/formats/red/core/schema.js +4 -4
  100. package/dist/formats/red/index.js +2 -2
  101. package/dist/formats/stl/CjsStlFormat.js +365 -365
  102. package/dist/formats/stl/core/helpers.js +261 -261
  103. package/dist/formats/stl/core/json.js +51 -51
  104. package/dist/formats/stl/core/stl.js +629 -629
  105. package/dist/formats/stl/core/targets.js +163 -163
  106. package/dist/formats/stl/index.js +2 -2
  107. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  108. package/dist/formats/tga/core/helpers.js +446 -446
  109. package/dist/formats/tga/index.js +2 -2
  110. package/dist/formats/wav/CjsWavFormat.js +192 -192
  111. package/dist/formats/wav/core/helpers.js +328 -328
  112. package/dist/formats/wav/index.js +2 -2
  113. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  114. package/dist/formats/webm/core/helpers.js +537 -537
  115. package/dist/formats/webm/index.js +2 -2
  116. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  117. package/dist/formats/webp/core/helpers.js +214 -214
  118. package/dist/formats/webp/index.js +2 -2
  119. package/dist/formats/wem/CjsWemFormat.js +241 -241
  120. package/dist/formats/wem/core/bitStream.js +259 -259
  121. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  122. package/dist/formats/wem/core/helpers.js +417 -417
  123. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  124. package/dist/formats/wem/core/ptadpcm.js +77 -77
  125. package/dist/formats/wem/core/resolve.js +121 -121
  126. package/dist/formats/wem/core/wemToOgg.js +485 -485
  127. package/dist/formats/wem/index.js +2 -2
  128. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  129. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  130. package/dist/formats/yaml/core/helpers.js +160 -160
  131. package/dist/formats/yaml/index.js +2 -2
  132. package/dist/index.js +48 -48
  133. package/dist/resourcePath.js +18 -18
  134. package/dist/resourceStates.js +9 -9
  135. package/dist/resources/AudioGeometryResData.js +47 -47
  136. package/dist/resources/GStateBindingCallbackData.js +31 -31
  137. package/dist/resources/MeshDecalData.js +37 -37
  138. package/dist/resources/MeshDecalLodData.js +34 -34
  139. package/dist/resources/Tr2EffectRes.js +71 -71
  140. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  141. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  142. package/dist/resources/Tr2ImageRes.js +114 -114
  143. package/dist/resources/Tr2LightProfileRes.js +40 -40
  144. package/dist/resources/Tr2MaterialArea.js +34 -34
  145. package/dist/resources/Tr2MaterialMesh.js +31 -31
  146. package/dist/resources/Tr2MaterialRes.js +34 -34
  147. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  148. package/dist/resources/Tr2TextureLodManager.js +80 -80
  149. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  150. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  151. package/dist/resources/Tr2TexturePipeline.js +52 -52
  152. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  153. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  154. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  155. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  156. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  157. package/dist/resources/TriGeometryRes.js +239 -216
  158. package/dist/resources/TriGeometryRes.js.map +1 -1
  159. package/dist/resources/TriGeometryResAreaData.js +59 -59
  160. package/dist/resources/TriGeometryResJointData.js +38 -38
  161. package/dist/resources/TriGeometryResLodData.js +88 -88
  162. package/dist/resources/TriGeometryResMeshData.js +63 -63
  163. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  164. package/dist/resources/TriGrannyRes.js +43 -43
  165. package/dist/resources/TriJointBinding.js +38 -38
  166. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  167. package/dist/resources/TriRtGeometryConstants.js +88 -88
  168. package/dist/resources/TriTextureRes.js +304 -304
  169. package/dist/resources/enums.js +18 -18
  170. package/dist/resources/resourceBoundary.js +47 -47
  171. package/dist/resources/texturePipelineBehavior.js +308 -308
  172. package/dist/texture/CjsTextureArrayRes.js +406 -406
  173. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  174. package/format-notices/black/LICENSE +21 -21
  175. package/format-notices/black/NOTICE +47 -47
  176. package/format-notices/bnk/LICENSE +21 -21
  177. package/format-notices/bnk/NOTICE +20 -20
  178. package/format-notices/cmf/LICENSE +21 -21
  179. package/format-notices/cmf/NOTICE +36 -36
  180. package/format-notices/dds/LICENSE +21 -21
  181. package/format-notices/dds/NOTICE +14 -14
  182. package/format-notices/fbx/LICENSE +21 -21
  183. package/format-notices/fbx/NOTICE +14 -14
  184. package/format-notices/flac/LICENSE +21 -21
  185. package/format-notices/flac/NOTICE +14 -14
  186. package/format-notices/gif/LICENSE +21 -21
  187. package/format-notices/gif/NOTICE +14 -14
  188. package/format-notices/gltf/LICENSE +21 -21
  189. package/format-notices/gltf/NOTICE +27 -27
  190. package/format-notices/jpeg/LICENSE +21 -21
  191. package/format-notices/jpeg/NOTICE +14 -14
  192. package/format-notices/mp3/LICENSE +21 -21
  193. package/format-notices/mp3/NOTICE +14 -14
  194. package/format-notices/mp4/LICENSE +21 -21
  195. package/format-notices/mp4/NOTICE +14 -14
  196. package/format-notices/obj/LICENSE +21 -21
  197. package/format-notices/obj/NOTICE +26 -26
  198. package/format-notices/ogg/LICENSE +21 -21
  199. package/format-notices/ogg/NOTICE +28 -28
  200. package/format-notices/png/LICENSE +21 -21
  201. package/format-notices/png/NOTICE +14 -14
  202. package/format-notices/red/LICENSE +21 -21
  203. package/format-notices/red/NOTICE +31 -31
  204. package/format-notices/stl/LICENSE +21 -21
  205. package/format-notices/stl/NOTICE +21 -21
  206. package/format-notices/tga/LICENSE +21 -21
  207. package/format-notices/tga/NOTICE +14 -14
  208. package/format-notices/wav/LICENSE +21 -21
  209. package/format-notices/wav/NOTICE +14 -14
  210. package/format-notices/webm/LICENSE +21 -21
  211. package/format-notices/webm/NOTICE +14 -14
  212. package/format-notices/webp/LICENSE +21 -21
  213. package/format-notices/webp/NOTICE +14 -14
  214. package/format-notices/wem/LICENSE +57 -57
  215. package/format-notices/wem/NOTICE +33 -33
  216. package/format-notices/yaml/LICENSE +21 -21
  217. package/format-notices/yaml/NOTICE +44 -44
  218. package/package.json +2 -2
  219. package/resource-lifecycle.md +679 -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