@carbonenginejs/runtime-resource 0.8.0 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (297) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +31 -29
  3. package/README.md +67 -548
  4. package/dist/CjsMotherLode.js +1271 -1271
  5. package/dist/CjsResMan.js +3005 -3005
  6. package/dist/CjsResManQueue.js +214 -214
  7. package/dist/CjsResource.js +566 -566
  8. package/dist/CjsResourceSource.js +68 -59
  9. package/dist/CjsResourceSource.js.map +1 -1
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +197 -192
  13. package/dist/format/CjsFormat.js.map +1 -1
  14. package/dist/format/CjsReader.js +18 -18
  15. package/dist/format/CjsResourceProbe.js +277 -277
  16. package/dist/format/payloadContract.js +173 -173
  17. package/dist/formats/black/CjsBlackFormat.js +278 -278
  18. package/dist/formats/black/core/CjsBlackBinaryReader.js +157 -153
  19. package/dist/formats/black/core/CjsBlackBinaryReader.js.map +1 -1
  20. package/dist/formats/black/core/CjsBlackPropertyReaders.js +387 -382
  21. package/dist/formats/black/core/CjsBlackPropertyReaders.js.map +1 -1
  22. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  23. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +437 -433
  24. package/dist/formats/black/core/CjsBlackSchemaRegistry.js.map +1 -1
  25. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js +4 -0
  26. package/dist/formats/black/core/black-schema-v1-2026-07-23.json.js.map +1 -0
  27. package/dist/formats/black/core/blackConstants.js +7 -7
  28. package/dist/formats/black/core/blackDefinitions.js +10 -10
  29. package/dist/formats/black/core/blackDefinitions.js.map +1 -1
  30. package/dist/formats/black/core/blackEnums.js +6 -6
  31. package/dist/formats/black/core/blackSchema.js +3 -3
  32. package/dist/formats/black/core/blackVersion.js +22 -22
  33. package/dist/formats/black/core/helpers.js +182 -182
  34. package/dist/formats/black/core/schema.js +4 -4
  35. package/dist/formats/black/index.js +2 -2
  36. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  37. package/dist/formats/bnk/core/graph.js +140 -140
  38. package/dist/formats/bnk/core/helpers.js +409 -409
  39. package/dist/formats/bnk/core/musicNodes.js +493 -489
  40. package/dist/formats/bnk/core/musicNodes.js.map +1 -1
  41. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  42. package/dist/formats/bnk/index.js +2 -2
  43. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  44. package/dist/formats/cmf/core/binary.js +123 -118
  45. package/dist/formats/cmf/core/binary.js.map +1 -1
  46. package/dist/formats/cmf/core/buffers.js +233 -233
  47. package/dist/formats/cmf/core/constants.js +47 -47
  48. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  49. package/dist/formats/cmf/core/helpers.js +287 -287
  50. package/dist/formats/cmf/core/pack.js +276 -276
  51. package/dist/formats/cmf/core/schema.js +364 -364
  52. package/dist/formats/cmf/core/shared.js +268 -268
  53. package/dist/formats/cmf/core/writer.js +517 -517
  54. package/dist/formats/cmf/index.js +2 -2
  55. package/dist/formats/dds/CjsDdsFormat.js +200 -193
  56. package/dist/formats/dds/CjsDdsFormat.js.map +1 -1
  57. package/dist/formats/dds/core/bc6h.js +288 -288
  58. package/dist/formats/dds/core/bc7.js +256 -251
  59. package/dist/formats/dds/core/bc7.js.map +1 -1
  60. package/dist/formats/dds/core/helpers.js +815 -815
  61. package/dist/formats/dds/index.js +2 -2
  62. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  63. package/dist/formats/fbx/core/helpers.js +3911 -3901
  64. package/dist/formats/fbx/core/helpers.js.map +1 -1
  65. package/dist/formats/fbx/index.js +2 -2
  66. package/dist/formats/flac/CjsFlacFormat.js +93 -87
  67. package/dist/formats/flac/CjsFlacFormat.js.map +1 -1
  68. package/dist/formats/flac/core/helpers.js +295 -295
  69. package/dist/formats/flac/index.js +2 -2
  70. package/dist/formats/gif/CjsGifFormat.js +92 -87
  71. package/dist/formats/gif/CjsGifFormat.js.map +1 -1
  72. package/dist/formats/gif/core/helpers.js +360 -360
  73. package/dist/formats/gif/index.js +2 -2
  74. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  75. package/dist/formats/gltf/core/helpers.js +292 -292
  76. package/dist/formats/gltf/core/json.js +79 -79
  77. package/dist/formats/gltf/core/parser.js +666 -666
  78. package/dist/formats/gltf/core/targets.js +163 -163
  79. package/dist/formats/gltf/index.js +2 -2
  80. package/dist/formats/gr2/CjsGr2Format.js +46 -0
  81. package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
  82. package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
  83. package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
  84. package/dist/formats/gr2/core/bitknit2.js +280 -0
  85. package/dist/formats/gr2/core/bitknit2.js.map +1 -0
  86. package/dist/formats/gr2/core/curves.js +1047 -0
  87. package/dist/formats/gr2/core/curves.js.map +1 -0
  88. package/dist/formats/gr2/core/gsf.js +72 -0
  89. package/dist/formats/gr2/core/gsf.js.map +1 -0
  90. package/dist/formats/gr2/core/helpers.js +332 -0
  91. package/dist/formats/gr2/core/helpers.js.map +1 -0
  92. package/dist/formats/gr2/core/json.js +622 -0
  93. package/dist/formats/gr2/core/json.js.map +1 -0
  94. package/dist/formats/gr2/core/oodle1.js +388 -0
  95. package/dist/formats/gr2/core/oodle1.js.map +1 -0
  96. package/dist/formats/gr2/core/reader.js +617 -0
  97. package/dist/formats/gr2/core/reader.js.map +1 -0
  98. package/dist/formats/gr2/core/tangents.js +48 -0
  99. package/dist/formats/gr2/core/tangents.js.map +1 -0
  100. package/dist/formats/gr2/core/targets.js +351 -0
  101. package/dist/formats/gr2/core/targets.js.map +1 -0
  102. package/dist/formats/gr2/index.js +3 -0
  103. package/dist/formats/gr2/index.js.map +1 -0
  104. package/dist/formats/index.js +30 -23
  105. package/dist/formats/index.js.map +1 -1
  106. package/dist/formats/jpeg/CjsJpegFormat.js +212 -206
  107. package/dist/formats/jpeg/CjsJpegFormat.js.map +1 -1
  108. package/dist/formats/jpeg/core/helpers.js +350 -350
  109. package/dist/formats/jpeg/core/jpeg.js +387 -377
  110. package/dist/formats/jpeg/core/jpeg.js.map +1 -1
  111. package/dist/formats/jpeg/index.js +2 -2
  112. package/dist/formats/mp3/CjsMp3Format.js +197 -192
  113. package/dist/formats/mp3/CjsMp3Format.js.map +1 -1
  114. package/dist/formats/mp3/core/helpers.js +338 -338
  115. package/dist/formats/mp3/index.js +2 -2
  116. package/dist/formats/mp4/CjsMp4Format.js +197 -191
  117. package/dist/formats/mp4/CjsMp4Format.js.map +1 -1
  118. package/dist/formats/mp4/core/helpers.js +449 -449
  119. package/dist/formats/mp4/index.js +2 -2
  120. package/dist/formats/obj/CjsObjFormat.js +253 -253
  121. package/dist/formats/obj/core/helpers.js +573 -573
  122. package/dist/formats/obj/core/json.js +64 -64
  123. package/dist/formats/obj/core/parser.js +321 -321
  124. package/dist/formats/obj/index.js +2 -2
  125. package/dist/formats/ogg/CjsOggFormat.js +94 -88
  126. package/dist/formats/ogg/CjsOggFormat.js.map +1 -1
  127. package/dist/formats/ogg/core/helpers.js +387 -387
  128. package/dist/formats/ogg/core/imdct.js +178 -178
  129. package/dist/formats/ogg/core/vorbis.js +1004 -999
  130. package/dist/formats/ogg/core/vorbis.js.map +1 -1
  131. package/dist/formats/ogg/index.js +2 -2
  132. package/dist/formats/png/CjsPngFormat.js +201 -195
  133. package/dist/formats/png/CjsPngFormat.js.map +1 -1
  134. package/dist/formats/png/core/helpers.js +583 -583
  135. package/dist/formats/png/index.js +2 -2
  136. package/dist/formats/red/CjsRedFormat.js +261 -261
  137. package/dist/formats/red/core/CjsRedReader.js +194 -194
  138. package/dist/formats/red/core/blackDefinitions.js +3 -3
  139. package/dist/formats/red/core/helpers.js +139 -139
  140. package/dist/formats/red/core/redGraph.js +68 -68
  141. package/dist/formats/red/core/schema.js +4 -4
  142. package/dist/formats/red/index.js +2 -2
  143. package/dist/formats/stl/CjsStlFormat.js +365 -365
  144. package/dist/formats/stl/core/helpers.js +261 -261
  145. package/dist/formats/stl/core/json.js +51 -51
  146. package/dist/formats/stl/core/stl.js +634 -629
  147. package/dist/formats/stl/core/stl.js.map +1 -1
  148. package/dist/formats/stl/core/targets.js +163 -163
  149. package/dist/formats/stl/index.js +2 -2
  150. package/dist/formats/tga/CjsTgaFormat.js +197 -192
  151. package/dist/formats/tga/CjsTgaFormat.js.map +1 -1
  152. package/dist/formats/tga/core/helpers.js +446 -446
  153. package/dist/formats/tga/index.js +2 -2
  154. package/dist/formats/wav/CjsWavFormat.js +198 -192
  155. package/dist/formats/wav/CjsWavFormat.js.map +1 -1
  156. package/dist/formats/wav/core/helpers.js +328 -328
  157. package/dist/formats/wav/index.js +2 -2
  158. package/dist/formats/webm/CjsWebmFormat.js +197 -191
  159. package/dist/formats/webm/CjsWebmFormat.js.map +1 -1
  160. package/dist/formats/webm/core/helpers.js +537 -537
  161. package/dist/formats/webm/index.js +2 -2
  162. package/dist/formats/webp/CjsWebpFormat.js +91 -86
  163. package/dist/formats/webp/CjsWebpFormat.js.map +1 -1
  164. package/dist/formats/webp/core/helpers.js +214 -214
  165. package/dist/formats/webp/index.js +2 -2
  166. package/dist/formats/wem/CjsWemFormat.js +242 -241
  167. package/dist/formats/wem/CjsWemFormat.js.map +1 -1
  168. package/dist/formats/wem/core/bitStream.js +259 -259
  169. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  170. package/dist/formats/wem/core/helpers.js +417 -417
  171. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  172. package/dist/formats/wem/core/ptadpcm.js +77 -77
  173. package/dist/formats/wem/core/resolve.js +121 -121
  174. package/dist/formats/wem/core/wemToOgg.js +485 -485
  175. package/dist/formats/wem/index.js +2 -2
  176. package/dist/formats/yaml/CjsYamlFormat.js +89 -83
  177. package/dist/formats/yaml/CjsYamlFormat.js.map +1 -1
  178. package/dist/formats/yaml/core/CjsYamlReader.js +311 -305
  179. package/dist/formats/yaml/core/CjsYamlReader.js.map +1 -1
  180. package/dist/formats/yaml/core/helpers.js +160 -160
  181. package/dist/formats/yaml/index.js +2 -2
  182. package/dist/index.js +49 -48
  183. package/dist/index.js.map +1 -1
  184. package/dist/resourcePath.js +18 -18
  185. package/dist/resourceStates.js +9 -9
  186. package/dist/resources/AudioGeometryResData.js +47 -47
  187. package/dist/resources/GStateBindingCallbackData.js +31 -31
  188. package/dist/resources/MeshDecalData.js +37 -37
  189. package/dist/resources/MeshDecalLodData.js +34 -34
  190. package/dist/resources/Tr2EffectRes.js +71 -71
  191. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  192. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  193. package/dist/resources/Tr2ImageRes.js +114 -114
  194. package/dist/resources/Tr2LightProfileRes.js +40 -40
  195. package/dist/resources/Tr2MaterialArea.js +34 -34
  196. package/dist/resources/Tr2MaterialMesh.js +31 -31
  197. package/dist/resources/Tr2MaterialRes.js +34 -34
  198. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  199. package/dist/resources/Tr2TextureLodManager.js +80 -80
  200. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  201. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  202. package/dist/resources/Tr2TexturePipeline.js +52 -52
  203. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  204. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  205. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
  206. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
  207. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  208. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  209. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  210. package/dist/resources/TriGeometryRes.js +239 -239
  211. package/dist/resources/TriGeometryResAreaData.js +59 -59
  212. package/dist/resources/TriGeometryResJointData.js +38 -38
  213. package/dist/resources/TriGeometryResLodData.js +88 -88
  214. package/dist/resources/TriGeometryResMeshData.js +63 -63
  215. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  216. package/dist/resources/TriGrannyRes.js +43 -43
  217. package/dist/resources/TriJointBinding.js +38 -38
  218. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  219. package/dist/resources/TriRtGeometryConstants.js +88 -88
  220. package/dist/resources/TriTextureRes.js +304 -304
  221. package/dist/resources/enums.js +18 -18
  222. package/dist/resources/resourceBoundary.js +47 -47
  223. package/dist/resources/texturePipelineBehavior.js +308 -308
  224. package/dist/texture/CjsTextureArrayRes.js +406 -406
  225. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  226. package/docs/README.md +73 -0
  227. package/docs/architecture.md +86 -0
  228. package/docs/concepts/resource-lifecycle.md +217 -0
  229. package/docs/formats/README.md +105 -0
  230. package/docs/formats/gr2.md +161 -0
  231. package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
  232. package/docs/formats/stl.md +37 -0
  233. package/docs/formats/wwise.md +44 -0
  234. package/docs/reference/classes/README.md +33 -0
  235. package/docs/reference/classes/core.md +106 -0
  236. package/docs/reference/classes/dropped.md +46 -0
  237. package/docs/reference/classes/formats.md +522 -0
  238. package/docs/reference/classes/resources.md +346 -0
  239. package/docs/reference/classes/texture.md +26 -0
  240. package/docs/reference/events.md +92 -0
  241. package/docs/reference/motherlode-cache.md +244 -0
  242. package/docs/reference/queues.md +102 -0
  243. package/docs/reference/reload.md +107 -0
  244. package/docs/reference/texture-arrays.md +113 -0
  245. package/docs/reference/texture-pipeline.md +53 -0
  246. package/docs/roadmap.md +104 -0
  247. package/format-notices/black/LICENSE +21 -21
  248. package/format-notices/black/NOTICE +47 -47
  249. package/format-notices/bnk/LICENSE +21 -21
  250. package/format-notices/bnk/NOTICE +20 -20
  251. package/format-notices/cmf/LICENSE +21 -21
  252. package/format-notices/cmf/NOTICE +36 -36
  253. package/format-notices/dds/LICENSE +21 -21
  254. package/format-notices/dds/NOTICE +14 -14
  255. package/format-notices/fbx/LICENSE +21 -21
  256. package/format-notices/fbx/NOTICE +14 -14
  257. package/format-notices/flac/LICENSE +21 -21
  258. package/format-notices/flac/NOTICE +14 -14
  259. package/format-notices/gif/LICENSE +21 -21
  260. package/format-notices/gif/NOTICE +14 -14
  261. package/format-notices/gltf/LICENSE +21 -21
  262. package/format-notices/gltf/NOTICE +27 -27
  263. package/format-notices/gr2/LICENSE +21 -0
  264. package/format-notices/gr2/NOTICE +60 -0
  265. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
  266. package/format-notices/jpeg/LICENSE +21 -21
  267. package/format-notices/jpeg/NOTICE +14 -14
  268. package/format-notices/mp3/LICENSE +21 -21
  269. package/format-notices/mp3/NOTICE +14 -14
  270. package/format-notices/mp4/LICENSE +21 -21
  271. package/format-notices/mp4/NOTICE +14 -14
  272. package/format-notices/obj/LICENSE +21 -21
  273. package/format-notices/obj/NOTICE +26 -26
  274. package/format-notices/ogg/LICENSE +21 -21
  275. package/format-notices/ogg/NOTICE +28 -28
  276. package/format-notices/png/LICENSE +21 -21
  277. package/format-notices/png/NOTICE +14 -14
  278. package/format-notices/red/LICENSE +21 -21
  279. package/format-notices/red/NOTICE +31 -31
  280. package/format-notices/stl/LICENSE +21 -21
  281. package/format-notices/stl/NOTICE +21 -21
  282. package/format-notices/tga/LICENSE +21 -21
  283. package/format-notices/tga/NOTICE +14 -14
  284. package/format-notices/wav/LICENSE +21 -21
  285. package/format-notices/wav/NOTICE +14 -14
  286. package/format-notices/webm/LICENSE +21 -21
  287. package/format-notices/webm/NOTICE +14 -14
  288. package/format-notices/webp/LICENSE +21 -21
  289. package/format-notices/webp/NOTICE +14 -14
  290. package/format-notices/wem/LICENSE +57 -57
  291. package/format-notices/wem/NOTICE +33 -33
  292. package/format-notices/yaml/LICENSE +21 -21
  293. package/format-notices/yaml/NOTICE +44 -44
  294. package/package.json +52 -51
  295. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +0 -4
  296. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js.map +0 -1
  297. package/resource-lifecycle.md +0 -679
@@ -1,377 +1,387 @@
1
- const ZIGZAG = [0, 1, 5, 6, 14, 15, 27, 28, 2, 4, 7, 13, 16, 26, 29, 42, 3, 8, 12, 17, 25, 30, 41, 43, 9, 11, 18, 24, 31, 40, 44, 53, 10, 19, 23, 32, 39, 45, 52, 54, 20, 22, 33, 38, 46, 51, 55, 60, 21, 34, 37, 47, 50, 56, 59, 61, 35, 36, 48, 49, 57, 58, 62, 63];
2
- const COSINE = Array.from({
3
- length: 8
4
- }, (_, x) => Array.from({
5
- length: 8
6
- }, (_, u) => Math.cos((2 * x + 1) * u * Math.PI / 16)));
7
- const SCALE = Array.from({
8
- length: 8
9
- }, (_, value) => value === 0 ? 1 / Math.sqrt(2) : 1);
10
- function decodeJpegToRgba(bytes, metadata = {}) {
11
- const decoder = new BaselineJpegDecoder(bytes);
12
- const image = decoder.decode();
13
- return {
14
- payloadType: "rgba",
15
- sourceFormat: "jpeg",
16
- mimeType: "image/jpeg",
17
- containerOnly: false,
18
- isDecoded: true,
19
- rgbaDecodeSupported: true,
20
- width: image.width,
21
- height: image.height,
22
- pixelFormat: "rgba8unorm",
23
- data: image.data,
24
- strideBytes: image.width * 4,
25
- origin: "top-left",
26
- colorSpace: "srgb",
27
- alphaMode: "opaque",
28
- metadata: {
29
- ...metadata,
30
- decoder: "software-baseline"
31
- }
32
- };
33
- }
34
- function canDecodeJpeg(metadata = {}) {
35
- return metadata.sourceFormat === "jpeg" && metadata.precision === 8 && metadata.components >= 1 && metadata.components <= 3 && (metadata.marker === 0xc0 || metadata.marker === 0xc1) && metadata.progressive !== true;
36
- }
37
- class BaselineJpegDecoder {
38
- #bytes;
39
- #offset = 0;
40
- #quantization = new Map();
41
- #huffman = new Map();
42
- #frame = null;
43
- #scan = null;
44
- #restartInterval = 0;
45
- constructor(bytes) {
46
- this.#bytes = bytes;
47
- }
48
- decode() {
49
- this.readMarker(0xd8);
50
- while (this.#offset < this.#bytes.length) {
51
- const marker = this.nextMarker();
52
- if (marker === 0xd9) break;
53
- if (marker === 0xda) {
54
- this.readScanHeader();
55
- return this.decodeScan();
56
- }
57
- if (marker === 0xdb) this.readQuantizationTables();else if (marker === 0xc0 || marker === 0xc1 || marker === 0xc2) this.readFrame(marker);else if (marker === 0xc4) this.readHuffmanTables();else if (marker === 0xdd) this.readRestartInterval();else if (marker >= 0xe0 && marker <= 0xef || marker === 0xfe) this.skipSegment();else if (marker === 0xd8 || marker === 0x01 || marker >= 0xd0 && marker <= 0xd7) continue;else this.skipSegment();
58
- }
59
- throw new Error("jpeg: no baseline scan found");
60
- }
61
- readFrame(marker) {
62
- const length = this.readU16();
63
- const precision = this.readU8();
64
- const height = this.readU16();
65
- const width = this.readU16();
66
- const components = this.readU8();
67
- if (precision !== 8) throw new Error(`jpeg: unsupported sample precision ${precision}`);
68
- if (!width || !height || !components || components > 3) throw new Error("jpeg: unsupported frame layout");
69
- const list = [];
70
- let maxH = 0,
71
- maxV = 0;
72
- for (let i = 0; i < components; i++) {
73
- const id = this.readU8();
74
- const sampling = this.readU8();
75
- const component = {
76
- id,
77
- h: sampling >>> 4,
78
- v: sampling & 0x0f,
79
- quantizationId: this.readU8(),
80
- dc: 0,
81
- ac: 0,
82
- previousDc: 0,
83
- plane: null,
84
- planeWidth: 0,
85
- planeHeight: 0
86
- };
87
- if (!component.h || !component.v || component.h > 4 || component.v > 4) {
88
- throw new Error("jpeg: unsupported component sampling");
89
- }
90
- maxH = Math.max(maxH, component.h);
91
- maxV = Math.max(maxV, component.v);
92
- list.push(component);
93
- }
94
- const consumed = 8 + components * 3;
95
- if (length !== consumed) this.#offset += Math.max(0, length - consumed);
96
- if (marker === 0xc2) throw new Error("jpeg: progressive scans are not supported by the software decoder");
97
- this.#frame = {
98
- width,
99
- height,
100
- precision,
101
- components: list,
102
- maxH,
103
- maxV
104
- };
105
- }
106
- readQuantizationTables() {
107
- const end = this.#offset + this.readU16() - 2;
108
- while (this.#offset < end) {
109
- const info = this.readU8();
110
- const precision = info >>> 4;
111
- const id = info & 0x0f;
112
- if (precision > 1) throw new Error("jpeg: unsupported 16-bit quantization table");
113
- const table = new Uint16Array(64);
114
- for (let i = 0; i < 64; i++) table[ZIGZAG[i]] = precision ? this.readU16() : this.readU8();
115
- this.#quantization.set(id, table);
116
- }
117
- this.#offset = end;
118
- }
119
- readHuffmanTables() {
120
- const end = this.#offset + this.readU16() - 2;
121
- while (this.#offset < end) {
122
- const info = this.readU8();
123
- const table = new Array(17).fill(null).map(() => []);
124
- const counts = [];
125
- for (let length = 1; length <= 16; length++) counts.push(this.readU8());
126
- let code = 0;
127
- let valueIndex = 0;
128
- for (let length = 1; length <= 16; length++) {
129
- for (let i = 0; i < counts[length - 1]; i++) {
130
- table[length].push({
131
- code,
132
- value: this.#bytes[this.#offset + valueIndex]
133
- });
134
- valueIndex++;
135
- code++;
136
- }
137
- code <<= 1;
138
- }
139
- this.#offset += valueIndex;
140
- this.#huffman.set(`${info >>> 4}:${info & 0x0f}`, table);
141
- }
142
- this.#offset = end;
143
- }
144
- readRestartInterval() {
145
- const length = this.readU16();
146
- if (length !== 4) throw new Error("jpeg: invalid restart interval segment");
147
- this.#restartInterval = this.readU16();
148
- }
149
- readScanHeader() {
150
- const length = this.readU16();
151
- const count = this.readU8();
152
- if (!this.#frame || count !== this.#frame.components.length) throw new Error("jpeg: unsupported scan component count");
153
- const byId = new Map(this.#frame.components.map(component => [component.id, component]));
154
- for (let i = 0; i < count; i++) {
155
- const id = this.readU8();
156
- const tables = this.readU8();
157
- const component = byId.get(id);
158
- if (!component) throw new Error(`jpeg: scan references unknown component ${id}`);
159
- component.dc = tables >>> 4;
160
- component.ac = tables & 0x0f;
161
- }
162
- const spectralStart = this.readU8();
163
- const spectralEnd = this.readU8();
164
- const successive = this.readU8();
165
- if (spectralStart !== 0 || spectralEnd !== 63 || successive !== 0) {
166
- throw new Error("jpeg: progressive or non-sequential scan is not supported");
167
- }
168
- const consumed = 6 + count * 2;
169
- if (length !== consumed) this.#offset += Math.max(0, length - consumed);
170
- this.#scan = {
171
- byId
172
- };
173
- }
174
- decodeScan() {
175
- const frame = this.#frame;
176
- const mcuWidth = 8 * frame.maxH;
177
- const mcuHeight = 8 * frame.maxV;
178
- const mcuColumns = Math.ceil(frame.width / mcuWidth);
179
- const mcuRows = Math.ceil(frame.height / mcuHeight);
180
- for (const component of frame.components) {
181
- component.planeWidth = mcuColumns * component.h * 8;
182
- component.planeHeight = mcuRows * component.v * 8;
183
- component.plane = new Uint8Array(component.planeWidth * component.planeHeight);
184
- }
185
- const reader = new EntropyReader(this.#bytes, this.#offset);
186
- let mcuIndex = 0;
187
- for (let row = 0; row < mcuRows; row++) {
188
- for (let column = 0; column < mcuColumns; column++) {
189
- for (const component of frame.components) {
190
- for (let y = 0; y < component.v; y++) {
191
- for (let x = 0; x < component.h; x++) {
192
- const block = this.decodeBlock(reader, component);
193
- const originX = (column * component.h + x) * 8;
194
- const originY = (row * component.v + y) * 8;
195
- writeBlock(component.plane, component.planeWidth, originX, originY, block);
196
- }
197
- }
198
- }
199
- mcuIndex++;
200
- if (this.#restartInterval && mcuIndex % this.#restartInterval === 0 && mcuIndex < mcuColumns * mcuRows) {
201
- reader.align();
202
- reader.consumeRestart();
203
- for (const component of frame.components) component.previousDc = 0;
204
- }
205
- }
206
- }
207
- const data = new Uint8Array(frame.width * frame.height * 4);
208
- for (let y = 0; y < frame.height; y++) {
209
- for (let x = 0; x < frame.width; x++) {
210
- const offset = (y * frame.width + x) * 4;
211
- if (frame.components.length === 1) {
212
- const value = frame.components[0].plane[y * frame.components[0].planeWidth + x];
213
- data[offset] = value;
214
- data[offset + 1] = value;
215
- data[offset + 2] = value;
216
- } else {
217
- const yValue = sampleComponent(frame.components[0], x, y, frame.width, frame.height);
218
- const cb = sampleComponent(frame.components[1], x, y, frame.width, frame.height) - 128;
219
- const cr = sampleComponent(frame.components[2], x, y, frame.width, frame.height) - 128;
220
- data[offset] = clampByte(yValue + 1.402 * cr);
221
- data[offset + 1] = clampByte(yValue - 0.344136 * cb - 0.714136 * cr);
222
- data[offset + 2] = clampByte(yValue + 1.772 * cb);
223
- }
224
- data[offset + 3] = 255;
225
- }
226
- }
227
- return {
228
- width: frame.width,
229
- height: frame.height,
230
- data
231
- };
232
- }
233
- decodeBlock(reader, component) {
234
- const quantization = this.#quantization.get(component.quantizationId);
235
- const dcTable = this.#huffman.get(`0:${component.dc}`);
236
- const acTable = this.#huffman.get(`1:${component.ac}`);
237
- if (!quantization || !dcTable || !acTable) throw new Error("jpeg: missing quantization or Huffman table");
238
- const coefficients = new Int32Array(64);
239
- const category = decodeHuffman(reader, dcTable);
240
- const delta = receiveExtend(reader, category);
241
- component.previousDc += delta;
242
- coefficients[0] = component.previousDc;
243
- let index = 1;
244
- while (index < 64) {
245
- const value = decodeHuffman(reader, acTable);
246
- if (value === 0) break;
247
- if (value === 0xf0) {
248
- index += 16;
249
- continue;
250
- }
251
- index += value >>> 4;
252
- if (index >= 64) throw new Error("jpeg: invalid AC coefficient run");
253
- coefficients[ZIGZAG[index]] = receiveExtend(reader, value & 0x0f);
254
- index++;
255
- }
256
- for (let i = 0; i < 64; i++) coefficients[i] *= quantization[i];
257
- return inverseDct(coefficients);
258
- }
259
- readU8() {
260
- if (this.#offset >= this.#bytes.length) throw new Error("jpeg: unexpected end of input");
261
- return this.#bytes[this.#offset++];
262
- }
263
- readU16() {
264
- return this.readU8() << 8 | this.readU8();
265
- }
266
- readMarker(expected = null) {
267
- const marker = this.nextMarker();
268
- if (expected !== null && marker !== expected) throw new Error("jpeg: missing SOI marker");
269
- return marker;
270
- }
271
- nextMarker() {
272
- while (this.#offset < this.#bytes.length && this.#bytes[this.#offset++] !== 0xff) {
273
- // Scan forward to the next marker prefix.
274
- }
275
- while (this.#offset < this.#bytes.length && this.#bytes[this.#offset] === 0xff) this.#offset++;
276
- if (this.#offset >= this.#bytes.length) throw new Error("jpeg: unexpected end while reading marker");
277
- return this.#bytes[this.#offset++];
278
- }
279
- skipSegment() {
280
- const length = this.readU16();
281
- if (length < 2 || this.#offset + length - 2 > this.#bytes.length) throw new Error("jpeg: invalid segment length");
282
- this.#offset += length - 2;
283
- }
284
- }
285
- class EntropyReader {
286
- #bytes;
287
- #offset;
288
- #buffer = 0;
289
- #bits = 0;
290
- #marker = null;
291
- constructor(bytes, offset) {
292
- this.#bytes = bytes;
293
- this.#offset = offset;
294
- }
295
- readBit() {
296
- if (!this.#bits) {
297
- let value = this.#bytes[this.#offset++];
298
- if (value === 0xff) {
299
- while (this.#bytes[this.#offset] === 0xff) this.#offset++;
300
- const marker = this.#bytes[this.#offset++];
301
- if (marker !== 0x00) {
302
- this.#marker = marker;
303
- throw new Error("jpeg: unexpected marker in entropy data");
304
- }
305
- value = 0xff;
306
- }
307
- if (value === undefined) throw new Error("jpeg: unexpected end in entropy data");
308
- this.#buffer = value;
309
- this.#bits = 8;
310
- }
311
- return this.#buffer >>> --this.#bits & 1;
312
- }
313
- readBits(count) {
314
- let value = 0;
315
- for (let i = 0; i < count; i++) value = value << 1 | this.readBit();
316
- return value;
317
- }
318
- align() {
319
- this.#bits = 0;
320
- }
321
- consumeRestart() {
322
- while (this.#bytes[this.#offset] === 0xff) this.#offset++;
323
- const marker = this.#bytes[this.#offset++];
324
- if (marker < 0xd0 || marker > 0xd7) throw new Error("jpeg: missing restart marker");
325
- }
326
- }
327
- function decodeHuffman(reader, table) {
328
- let code = 0;
329
- for (let length = 1; length <= 16; length++) {
330
- code = code << 1 | reader.readBit();
331
- const entry = table[length].find(item => item.code === code);
332
- if (entry) return entry.value;
333
- }
334
- throw new Error("jpeg: invalid Huffman code");
335
- }
336
- function receiveExtend(reader, size) {
337
- if (!size) return 0;
338
- const value = reader.readBits(size);
339
- const threshold = 1 << size - 1;
340
- return value < threshold ? value - ((1 << size) - 1) : value;
341
- }
342
- function inverseDct(coefficients) {
343
- const output = new Uint8Array(64);
344
- for (let y = 0; y < 8; y++) {
345
- for (let x = 0; x < 8; x++) {
346
- let sum = 0;
347
- for (let v = 0; v < 8; v++) {
348
- for (let u = 0; u < 8; u++) {
349
- sum += SCALE[u] * SCALE[v] * coefficients[v * 8 + u] * COSINE[x][u] * COSINE[y][v];
350
- }
351
- }
352
- output[y * 8 + x] = clampByte(128 + sum / 4);
353
- }
354
- }
355
- return output;
356
- }
357
- function writeBlock(plane, planeWidth, originX, originY, block) {
358
- for (let y = 0; y < 8; y++) {
359
- const targetY = originY + y;
360
- if (targetY >= plane.length / planeWidth) continue;
361
- for (let x = 0; x < 8; x++) {
362
- const targetX = originX + x;
363
- if (targetX < planeWidth) plane[targetY * planeWidth + targetX] = block[y * 8 + x];
364
- }
365
- }
366
- }
367
- function sampleComponent(component, x, y, width, height) {
368
- const sampleX = Math.min(component.planeWidth - 1, Math.floor(x * component.planeWidth / width));
369
- const sampleY = Math.min(component.planeHeight - 1, Math.floor(y * component.planeHeight / height));
370
- return component.plane[sampleY * component.planeWidth + sampleX];
371
- }
372
- function clampByte(value) {
373
- return Math.max(0, Math.min(255, Math.round(value)));
374
- }
375
-
376
- export { canDecodeJpeg, decodeJpegToRgba };
377
- //# sourceMappingURL=jpeg.js.map
1
+ const ZIGZAG = [0, 1, 5, 6, 14, 15, 27, 28, 2, 4, 7, 13, 16, 26, 29, 42, 3, 8, 12, 17, 25, 30, 41, 43, 9, 11, 18, 24, 31, 40, 44, 53, 10, 19, 23, 32, 39, 45, 52, 54, 20, 22, 33, 38, 46, 51, 55, 60, 21, 34, 37, 47, 50, 56, 59, 61, 35, 36, 48, 49, 57, 58, 62, 63];
2
+ const COSINE = Array.from({
3
+ length: 8
4
+ }, (_, x) => Array.from({
5
+ length: 8
6
+ }, (_, u) => Math.cos((2 * x + 1) * u * Math.PI / 16)));
7
+ const SCALE = Array.from({
8
+ length: 8
9
+ }, (_, value) => value === 0 ? 1 / Math.sqrt(2) : 1);
10
+ function decodeJpegToRgba(bytes, metadata = {}) {
11
+ const decoder = new BaselineJpegDecoder(bytes);
12
+ const image = decoder.decode();
13
+ return {
14
+ payloadType: "rgba",
15
+ sourceFormat: "jpeg",
16
+ mimeType: "image/jpeg",
17
+ containerOnly: false,
18
+ isDecoded: true,
19
+ rgbaDecodeSupported: true,
20
+ width: image.width,
21
+ height: image.height,
22
+ pixelFormat: "rgba8unorm",
23
+ data: image.data,
24
+ strideBytes: image.width * 4,
25
+ origin: "top-left",
26
+ colorSpace: "srgb",
27
+ alphaMode: "opaque",
28
+ metadata: {
29
+ ...metadata,
30
+ decoder: "software-baseline"
31
+ }
32
+ };
33
+ }
34
+ function canDecodeJpeg(metadata = {}) {
35
+ return metadata.sourceFormat === "jpeg" && metadata.precision === 8 && metadata.components >= 1 && metadata.components <= 3 && (metadata.marker === 0xc0 || metadata.marker === 0xc1) && metadata.progressive !== true;
36
+ }
37
+
38
+ /**
39
+ * Pure-JS baseline sequential JPEG decoder that parses markers, quantization
40
+ * and Huffman tables, and entropy-coded scans into RGBA pixels.
41
+ */
42
+ class BaselineJpegDecoder {
43
+ #bytes;
44
+ #offset = 0;
45
+ #quantization = new Map();
46
+ #huffman = new Map();
47
+ #frame = null;
48
+ #scan = null;
49
+ #restartInterval = 0;
50
+ constructor(bytes) {
51
+ this.#bytes = bytes;
52
+ }
53
+ decode() {
54
+ this.readMarker(0xd8);
55
+ while (this.#offset < this.#bytes.length) {
56
+ const marker = this.nextMarker();
57
+ if (marker === 0xd9) break;
58
+ if (marker === 0xda) {
59
+ this.readScanHeader();
60
+ return this.decodeScan();
61
+ }
62
+ if (marker === 0xdb) this.readQuantizationTables();else if (marker === 0xc0 || marker === 0xc1 || marker === 0xc2) this.readFrame(marker);else if (marker === 0xc4) this.readHuffmanTables();else if (marker === 0xdd) this.readRestartInterval();else if (marker >= 0xe0 && marker <= 0xef || marker === 0xfe) this.skipSegment();else if (marker === 0xd8 || marker === 0x01 || marker >= 0xd0 && marker <= 0xd7) continue;else this.skipSegment();
63
+ }
64
+ throw new Error("jpeg: no baseline scan found");
65
+ }
66
+ readFrame(marker) {
67
+ const length = this.readU16();
68
+ const precision = this.readU8();
69
+ const height = this.readU16();
70
+ const width = this.readU16();
71
+ const components = this.readU8();
72
+ if (precision !== 8) throw new Error(`jpeg: unsupported sample precision ${precision}`);
73
+ if (!width || !height || !components || components > 3) throw new Error("jpeg: unsupported frame layout");
74
+ const list = [];
75
+ let maxH = 0,
76
+ maxV = 0;
77
+ for (let i = 0; i < components; i++) {
78
+ const id = this.readU8();
79
+ const sampling = this.readU8();
80
+ const component = {
81
+ id,
82
+ h: sampling >>> 4,
83
+ v: sampling & 0x0f,
84
+ quantizationId: this.readU8(),
85
+ dc: 0,
86
+ ac: 0,
87
+ previousDc: 0,
88
+ plane: null,
89
+ planeWidth: 0,
90
+ planeHeight: 0
91
+ };
92
+ if (!component.h || !component.v || component.h > 4 || component.v > 4) {
93
+ throw new Error("jpeg: unsupported component sampling");
94
+ }
95
+ maxH = Math.max(maxH, component.h);
96
+ maxV = Math.max(maxV, component.v);
97
+ list.push(component);
98
+ }
99
+ const consumed = 8 + components * 3;
100
+ if (length !== consumed) this.#offset += Math.max(0, length - consumed);
101
+ if (marker === 0xc2) throw new Error("jpeg: progressive scans are not supported by the software decoder");
102
+ this.#frame = {
103
+ width,
104
+ height,
105
+ precision,
106
+ components: list,
107
+ maxH,
108
+ maxV
109
+ };
110
+ }
111
+ readQuantizationTables() {
112
+ const end = this.#offset + this.readU16() - 2;
113
+ while (this.#offset < end) {
114
+ const info = this.readU8();
115
+ const precision = info >>> 4;
116
+ const id = info & 0x0f;
117
+ if (precision > 1) throw new Error("jpeg: unsupported 16-bit quantization table");
118
+ const table = new Uint16Array(64);
119
+ for (let i = 0; i < 64; i++) table[ZIGZAG[i]] = precision ? this.readU16() : this.readU8();
120
+ this.#quantization.set(id, table);
121
+ }
122
+ this.#offset = end;
123
+ }
124
+ readHuffmanTables() {
125
+ const end = this.#offset + this.readU16() - 2;
126
+ while (this.#offset < end) {
127
+ const info = this.readU8();
128
+ const table = new Array(17).fill(null).map(() => []);
129
+ const counts = [];
130
+ for (let length = 1; length <= 16; length++) counts.push(this.readU8());
131
+ let code = 0;
132
+ let valueIndex = 0;
133
+ for (let length = 1; length <= 16; length++) {
134
+ for (let i = 0; i < counts[length - 1]; i++) {
135
+ table[length].push({
136
+ code,
137
+ value: this.#bytes[this.#offset + valueIndex]
138
+ });
139
+ valueIndex++;
140
+ code++;
141
+ }
142
+ code <<= 1;
143
+ }
144
+ this.#offset += valueIndex;
145
+ this.#huffman.set(`${info >>> 4}:${info & 0x0f}`, table);
146
+ }
147
+ this.#offset = end;
148
+ }
149
+ readRestartInterval() {
150
+ const length = this.readU16();
151
+ if (length !== 4) throw new Error("jpeg: invalid restart interval segment");
152
+ this.#restartInterval = this.readU16();
153
+ }
154
+ readScanHeader() {
155
+ const length = this.readU16();
156
+ const count = this.readU8();
157
+ if (!this.#frame || count !== this.#frame.components.length) throw new Error("jpeg: unsupported scan component count");
158
+ const byId = new Map(this.#frame.components.map(component => [component.id, component]));
159
+ for (let i = 0; i < count; i++) {
160
+ const id = this.readU8();
161
+ const tables = this.readU8();
162
+ const component = byId.get(id);
163
+ if (!component) throw new Error(`jpeg: scan references unknown component ${id}`);
164
+ component.dc = tables >>> 4;
165
+ component.ac = tables & 0x0f;
166
+ }
167
+ const spectralStart = this.readU8();
168
+ const spectralEnd = this.readU8();
169
+ const successive = this.readU8();
170
+ if (spectralStart !== 0 || spectralEnd !== 63 || successive !== 0) {
171
+ throw new Error("jpeg: progressive or non-sequential scan is not supported");
172
+ }
173
+ const consumed = 6 + count * 2;
174
+ if (length !== consumed) this.#offset += Math.max(0, length - consumed);
175
+ this.#scan = {
176
+ byId
177
+ };
178
+ }
179
+ decodeScan() {
180
+ const frame = this.#frame;
181
+ const mcuWidth = 8 * frame.maxH;
182
+ const mcuHeight = 8 * frame.maxV;
183
+ const mcuColumns = Math.ceil(frame.width / mcuWidth);
184
+ const mcuRows = Math.ceil(frame.height / mcuHeight);
185
+ for (const component of frame.components) {
186
+ component.planeWidth = mcuColumns * component.h * 8;
187
+ component.planeHeight = mcuRows * component.v * 8;
188
+ component.plane = new Uint8Array(component.planeWidth * component.planeHeight);
189
+ }
190
+ const reader = new EntropyReader(this.#bytes, this.#offset);
191
+ let mcuIndex = 0;
192
+ for (let row = 0; row < mcuRows; row++) {
193
+ for (let column = 0; column < mcuColumns; column++) {
194
+ for (const component of frame.components) {
195
+ for (let y = 0; y < component.v; y++) {
196
+ for (let x = 0; x < component.h; x++) {
197
+ const block = this.decodeBlock(reader, component);
198
+ const originX = (column * component.h + x) * 8;
199
+ const originY = (row * component.v + y) * 8;
200
+ writeBlock(component.plane, component.planeWidth, originX, originY, block);
201
+ }
202
+ }
203
+ }
204
+ mcuIndex++;
205
+ if (this.#restartInterval && mcuIndex % this.#restartInterval === 0 && mcuIndex < mcuColumns * mcuRows) {
206
+ reader.align();
207
+ reader.consumeRestart();
208
+ for (const component of frame.components) component.previousDc = 0;
209
+ }
210
+ }
211
+ }
212
+ const data = new Uint8Array(frame.width * frame.height * 4);
213
+ for (let y = 0; y < frame.height; y++) {
214
+ for (let x = 0; x < frame.width; x++) {
215
+ const offset = (y * frame.width + x) * 4;
216
+ if (frame.components.length === 1) {
217
+ const value = frame.components[0].plane[y * frame.components[0].planeWidth + x];
218
+ data[offset] = value;
219
+ data[offset + 1] = value;
220
+ data[offset + 2] = value;
221
+ } else {
222
+ const yValue = sampleComponent(frame.components[0], x, y, frame.width, frame.height);
223
+ const cb = sampleComponent(frame.components[1], x, y, frame.width, frame.height) - 128;
224
+ const cr = sampleComponent(frame.components[2], x, y, frame.width, frame.height) - 128;
225
+ data[offset] = clampByte(yValue + 1.402 * cr);
226
+ data[offset + 1] = clampByte(yValue - 0.344136 * cb - 0.714136 * cr);
227
+ data[offset + 2] = clampByte(yValue + 1.772 * cb);
228
+ }
229
+ data[offset + 3] = 255;
230
+ }
231
+ }
232
+ return {
233
+ width: frame.width,
234
+ height: frame.height,
235
+ data
236
+ };
237
+ }
238
+ decodeBlock(reader, component) {
239
+ const quantization = this.#quantization.get(component.quantizationId);
240
+ const dcTable = this.#huffman.get(`0:${component.dc}`);
241
+ const acTable = this.#huffman.get(`1:${component.ac}`);
242
+ if (!quantization || !dcTable || !acTable) throw new Error("jpeg: missing quantization or Huffman table");
243
+ const coefficients = new Int32Array(64);
244
+ const category = decodeHuffman(reader, dcTable);
245
+ const delta = receiveExtend(reader, category);
246
+ component.previousDc += delta;
247
+ coefficients[0] = component.previousDc;
248
+ let index = 1;
249
+ while (index < 64) {
250
+ const value = decodeHuffman(reader, acTable);
251
+ if (value === 0) break;
252
+ if (value === 0xf0) {
253
+ index += 16;
254
+ continue;
255
+ }
256
+ index += value >>> 4;
257
+ if (index >= 64) throw new Error("jpeg: invalid AC coefficient run");
258
+ coefficients[ZIGZAG[index]] = receiveExtend(reader, value & 0x0f);
259
+ index++;
260
+ }
261
+ for (let i = 0; i < 64; i++) coefficients[i] *= quantization[i];
262
+ return inverseDct(coefficients);
263
+ }
264
+ readU8() {
265
+ if (this.#offset >= this.#bytes.length) throw new Error("jpeg: unexpected end of input");
266
+ return this.#bytes[this.#offset++];
267
+ }
268
+ readU16() {
269
+ return this.readU8() << 8 | this.readU8();
270
+ }
271
+ readMarker(expected = null) {
272
+ const marker = this.nextMarker();
273
+ if (expected !== null && marker !== expected) throw new Error("jpeg: missing SOI marker");
274
+ return marker;
275
+ }
276
+ nextMarker() {
277
+ while (this.#offset < this.#bytes.length && this.#bytes[this.#offset++] !== 0xff) {
278
+ // Scan forward to the next marker prefix.
279
+ }
280
+ while (this.#offset < this.#bytes.length && this.#bytes[this.#offset] === 0xff) this.#offset++;
281
+ if (this.#offset >= this.#bytes.length) throw new Error("jpeg: unexpected end while reading marker");
282
+ return this.#bytes[this.#offset++];
283
+ }
284
+ skipSegment() {
285
+ const length = this.readU16();
286
+ if (length < 2 || this.#offset + length - 2 > this.#bytes.length) throw new Error("jpeg: invalid segment length");
287
+ this.#offset += length - 2;
288
+ }
289
+ }
290
+
291
+ /**
292
+ * Bit-level reader over JPEG entropy-coded data that handles byte stuffing
293
+ * and restart markers for the baseline decoder.
294
+ */
295
+ class EntropyReader {
296
+ #bytes;
297
+ #offset;
298
+ #buffer = 0;
299
+ #bits = 0;
300
+ #marker = null;
301
+ constructor(bytes, offset) {
302
+ this.#bytes = bytes;
303
+ this.#offset = offset;
304
+ }
305
+ readBit() {
306
+ if (!this.#bits) {
307
+ let value = this.#bytes[this.#offset++];
308
+ if (value === 0xff) {
309
+ while (this.#bytes[this.#offset] === 0xff) this.#offset++;
310
+ const marker = this.#bytes[this.#offset++];
311
+ if (marker !== 0x00) {
312
+ this.#marker = marker;
313
+ throw new Error("jpeg: unexpected marker in entropy data");
314
+ }
315
+ value = 0xff;
316
+ }
317
+ if (value === undefined) throw new Error("jpeg: unexpected end in entropy data");
318
+ this.#buffer = value;
319
+ this.#bits = 8;
320
+ }
321
+ return this.#buffer >>> --this.#bits & 1;
322
+ }
323
+ readBits(count) {
324
+ let value = 0;
325
+ for (let i = 0; i < count; i++) value = value << 1 | this.readBit();
326
+ return value;
327
+ }
328
+ align() {
329
+ this.#bits = 0;
330
+ }
331
+ consumeRestart() {
332
+ while (this.#bytes[this.#offset] === 0xff) this.#offset++;
333
+ const marker = this.#bytes[this.#offset++];
334
+ if (marker < 0xd0 || marker > 0xd7) throw new Error("jpeg: missing restart marker");
335
+ }
336
+ }
337
+ function decodeHuffman(reader, table) {
338
+ let code = 0;
339
+ for (let length = 1; length <= 16; length++) {
340
+ code = code << 1 | reader.readBit();
341
+ const entry = table[length].find(item => item.code === code);
342
+ if (entry) return entry.value;
343
+ }
344
+ throw new Error("jpeg: invalid Huffman code");
345
+ }
346
+ function receiveExtend(reader, size) {
347
+ if (!size) return 0;
348
+ const value = reader.readBits(size);
349
+ const threshold = 1 << size - 1;
350
+ return value < threshold ? value - ((1 << size) - 1) : value;
351
+ }
352
+ function inverseDct(coefficients) {
353
+ const output = new Uint8Array(64);
354
+ for (let y = 0; y < 8; y++) {
355
+ for (let x = 0; x < 8; x++) {
356
+ let sum = 0;
357
+ for (let v = 0; v < 8; v++) {
358
+ for (let u = 0; u < 8; u++) {
359
+ sum += SCALE[u] * SCALE[v] * coefficients[v * 8 + u] * COSINE[x][u] * COSINE[y][v];
360
+ }
361
+ }
362
+ output[y * 8 + x] = clampByte(128 + sum / 4);
363
+ }
364
+ }
365
+ return output;
366
+ }
367
+ function writeBlock(plane, planeWidth, originX, originY, block) {
368
+ for (let y = 0; y < 8; y++) {
369
+ const targetY = originY + y;
370
+ if (targetY >= plane.length / planeWidth) continue;
371
+ for (let x = 0; x < 8; x++) {
372
+ const targetX = originX + x;
373
+ if (targetX < planeWidth) plane[targetY * planeWidth + targetX] = block[y * 8 + x];
374
+ }
375
+ }
376
+ }
377
+ function sampleComponent(component, x, y, width, height) {
378
+ const sampleX = Math.min(component.planeWidth - 1, Math.floor(x * component.planeWidth / width));
379
+ const sampleY = Math.min(component.planeHeight - 1, Math.floor(y * component.planeHeight / height));
380
+ return component.plane[sampleY * component.planeWidth + sampleX];
381
+ }
382
+ function clampByte(value) {
383
+ return Math.max(0, Math.min(255, Math.round(value)));
384
+ }
385
+
386
+ export { canDecodeJpeg, decodeJpegToRgba };
387
+ //# sourceMappingURL=jpeg.js.map