@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,153 +1,157 @@
1
- class CjsBlackBinaryReader {
2
- constructor(dataView, context = null) {
3
- if (!(dataView instanceof DataView)) {
4
- throw new TypeError("CjsBlackBinaryReader expected a DataView");
5
- }
6
- this.data = dataView;
7
- this.context = context;
8
- this.offset = 0;
9
- }
10
- get remaining() {
11
- return this.data.byteLength - this.offset;
12
- }
13
- AtEnd() {
14
- return this.remaining === 0;
15
- }
16
- ExpectEnd(message = "Black reader did not reach end") {
17
- if (!this.AtEnd()) {
18
- throw new RangeError(`${message}: ${this.remaining} bytes remain`);
19
- }
20
- }
21
- ExpectU32(expected, message) {
22
- const actual = this.ReadU32();
23
- if (actual !== expected) {
24
- throw new RangeError(`${message}: expected ${expected}, got ${actual}`);
25
- }
26
- return actual;
27
- }
28
- ReadBinaryReader(byteLength) {
29
- return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);
30
- }
31
- ReadBytes(byteLength) {
32
- const view = this.ReadDataView(byteLength);
33
- return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
34
- }
35
- ReadCString() {
36
- const startOffset = this.offset;
37
- while (this.ReadU8() !== 0) {
38
- // Scan to null terminator.
39
- }
40
- const byteOffset = this.data.byteOffset + startOffset;
41
- const byteLength = this.offset - startOffset - 1;
42
- const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
43
- return CjsBlackBinaryReader.utf8Decoder.decode(bytes);
44
- }
45
- ReadCWString() {
46
- const startOffset = this.offset;
47
- while (this.ReadU16() !== 0) {
48
- // Scan to UTF-16 null terminator.
49
- }
50
- const byteOffset = this.data.byteOffset + startOffset;
51
- const byteLength = this.offset - startOffset - 2;
52
- const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
53
- return CjsBlackBinaryReader.utf16Decoder.decode(bytes);
54
- }
55
- ReadDataView(byteLength) {
56
- if (!Number.isInteger(byteLength) || byteLength < 0) {
57
- throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);
58
- }
59
- if (this.remaining < byteLength) {
60
- throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
61
- }
62
- const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);
63
- this.offset += byteLength;
64
- return result;
65
- }
66
- ReadF32() {
67
- const value = this.data.getFloat32(this.offset, true);
68
- this.offset += 4;
69
- return value;
70
- }
71
- ReadF64() {
72
- const value = this.data.getFloat64(this.offset, true);
73
- this.offset += 8;
74
- return value;
75
- }
76
- ReadI8() {
77
- const value = this.data.getInt8(this.offset);
78
- this.offset += 1;
79
- return value;
80
- }
81
- ReadI16() {
82
- const value = this.data.getInt16(this.offset, true);
83
- this.offset += 2;
84
- return value;
85
- }
86
- ReadI32() {
87
- const value = this.data.getInt32(this.offset, true);
88
- this.offset += 4;
89
- return value;
90
- }
91
- ReadI64() {
92
- return this.data.getBigInt64(this.ConsumeOffset(8), true);
93
- }
94
- ReadStringRef() {
95
- const index = this.ReadU16();
96
- const strings = this.context?.info?.strings || [];
97
- if (index >= strings.length) {
98
- throw new RangeError(`Invalid Black string index: ${index}`);
99
- }
100
- return strings[index];
101
- }
102
- ReadWideStringRef() {
103
- const index = this.ReadU16();
104
- const strings = this.context?.info?.wideStrings || [];
105
- if (index >= strings.length) {
106
- throw new RangeError(`Invalid Black wide string index: ${index}`);
107
- }
108
- return strings[index];
109
- }
110
- ReadU8() {
111
- const value = this.data.getUint8(this.offset);
112
- this.offset += 1;
113
- return value;
114
- }
115
- ReadU16() {
116
- const value = this.data.getUint16(this.offset, true);
117
- this.offset += 2;
118
- return value;
119
- }
120
- ReadU32() {
121
- const value = this.data.getUint32(this.offset, true);
122
- this.offset += 4;
123
- return value;
124
- }
125
- ReadU64() {
126
- return this.data.getBigUint64(this.ConsumeOffset(8), true);
127
- }
128
- Skip(byteLength) {
129
- this.ReadDataView(byteLength);
130
- }
131
- ConsumeOffset(byteLength) {
132
- if (this.remaining < byteLength) {
133
- throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
134
- }
135
- const offset = this.offset;
136
- this.offset += byteLength;
137
- return offset;
138
- }
139
- static from(input, context = null) {
140
- if (input instanceof CjsBlackBinaryReader) return input;
141
- if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);
142
- if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);
143
- if (ArrayBuffer.isView(input)) {
144
- return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);
145
- }
146
- throw new TypeError("Black input must be an ArrayBuffer, DataView, or typed array");
147
- }
148
- static utf8Decoder = new TextDecoder("utf-8");
149
- static utf16Decoder = new TextDecoder("utf-16le");
150
- }
151
-
152
- export { CjsBlackBinaryReader };
153
- //# sourceMappingURL=CjsBlackBinaryReader.js.map
1
+ /**
2
+ * Bounds-aware `DataView` cursor that provides the primitive reads and
3
+ * end-of-stream checks the Black transport decodes with.
4
+ */
5
+ class CjsBlackBinaryReader {
6
+ constructor(dataView, context = null) {
7
+ if (!(dataView instanceof DataView)) {
8
+ throw new TypeError("CjsBlackBinaryReader expected a DataView");
9
+ }
10
+ this.data = dataView;
11
+ this.context = context;
12
+ this.offset = 0;
13
+ }
14
+ get remaining() {
15
+ return this.data.byteLength - this.offset;
16
+ }
17
+ AtEnd() {
18
+ return this.remaining === 0;
19
+ }
20
+ ExpectEnd(message = "Black reader did not reach end") {
21
+ if (!this.AtEnd()) {
22
+ throw new RangeError(`${message}: ${this.remaining} bytes remain`);
23
+ }
24
+ }
25
+ ExpectU32(expected, message) {
26
+ const actual = this.ReadU32();
27
+ if (actual !== expected) {
28
+ throw new RangeError(`${message}: expected ${expected}, got ${actual}`);
29
+ }
30
+ return actual;
31
+ }
32
+ ReadBinaryReader(byteLength) {
33
+ return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);
34
+ }
35
+ ReadBytes(byteLength) {
36
+ const view = this.ReadDataView(byteLength);
37
+ return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
38
+ }
39
+ ReadCString() {
40
+ const startOffset = this.offset;
41
+ while (this.ReadU8() !== 0) {
42
+ // Scan to null terminator.
43
+ }
44
+ const byteOffset = this.data.byteOffset + startOffset;
45
+ const byteLength = this.offset - startOffset - 1;
46
+ const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
47
+ return CjsBlackBinaryReader.utf8Decoder.decode(bytes);
48
+ }
49
+ ReadCWString() {
50
+ const startOffset = this.offset;
51
+ while (this.ReadU16() !== 0) {
52
+ // Scan to UTF-16 null terminator.
53
+ }
54
+ const byteOffset = this.data.byteOffset + startOffset;
55
+ const byteLength = this.offset - startOffset - 2;
56
+ const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);
57
+ return CjsBlackBinaryReader.utf16Decoder.decode(bytes);
58
+ }
59
+ ReadDataView(byteLength) {
60
+ if (!Number.isInteger(byteLength) || byteLength < 0) {
61
+ throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);
62
+ }
63
+ if (this.remaining < byteLength) {
64
+ throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
65
+ }
66
+ const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);
67
+ this.offset += byteLength;
68
+ return result;
69
+ }
70
+ ReadF32() {
71
+ const value = this.data.getFloat32(this.offset, true);
72
+ this.offset += 4;
73
+ return value;
74
+ }
75
+ ReadF64() {
76
+ const value = this.data.getFloat64(this.offset, true);
77
+ this.offset += 8;
78
+ return value;
79
+ }
80
+ ReadI8() {
81
+ const value = this.data.getInt8(this.offset);
82
+ this.offset += 1;
83
+ return value;
84
+ }
85
+ ReadI16() {
86
+ const value = this.data.getInt16(this.offset, true);
87
+ this.offset += 2;
88
+ return value;
89
+ }
90
+ ReadI32() {
91
+ const value = this.data.getInt32(this.offset, true);
92
+ this.offset += 4;
93
+ return value;
94
+ }
95
+ ReadI64() {
96
+ return this.data.getBigInt64(this.ConsumeOffset(8), true);
97
+ }
98
+ ReadStringRef() {
99
+ const index = this.ReadU16();
100
+ const strings = this.context?.info?.strings || [];
101
+ if (index >= strings.length) {
102
+ throw new RangeError(`Invalid Black string index: ${index}`);
103
+ }
104
+ return strings[index];
105
+ }
106
+ ReadWideStringRef() {
107
+ const index = this.ReadU16();
108
+ const strings = this.context?.info?.wideStrings || [];
109
+ if (index >= strings.length) {
110
+ throw new RangeError(`Invalid Black wide string index: ${index}`);
111
+ }
112
+ return strings[index];
113
+ }
114
+ ReadU8() {
115
+ const value = this.data.getUint8(this.offset);
116
+ this.offset += 1;
117
+ return value;
118
+ }
119
+ ReadU16() {
120
+ const value = this.data.getUint16(this.offset, true);
121
+ this.offset += 2;
122
+ return value;
123
+ }
124
+ ReadU32() {
125
+ const value = this.data.getUint32(this.offset, true);
126
+ this.offset += 4;
127
+ return value;
128
+ }
129
+ ReadU64() {
130
+ return this.data.getBigUint64(this.ConsumeOffset(8), true);
131
+ }
132
+ Skip(byteLength) {
133
+ this.ReadDataView(byteLength);
134
+ }
135
+ ConsumeOffset(byteLength) {
136
+ if (this.remaining < byteLength) {
137
+ throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);
138
+ }
139
+ const offset = this.offset;
140
+ this.offset += byteLength;
141
+ return offset;
142
+ }
143
+ static from(input, context = null) {
144
+ if (input instanceof CjsBlackBinaryReader) return input;
145
+ if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);
146
+ if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);
147
+ if (ArrayBuffer.isView(input)) {
148
+ return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);
149
+ }
150
+ throw new TypeError("Black input must be an ArrayBuffer, DataView, or typed array");
151
+ }
152
+ static utf8Decoder = new TextDecoder("utf-8");
153
+ static utf16Decoder = new TextDecoder("utf-16le");
154
+ }
155
+
156
+ export { CjsBlackBinaryReader };
157
+ //# sourceMappingURL=CjsBlackBinaryReader.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"CjsBlackBinaryReader.js","sources":["../../../../../src/formats/black/core/CjsBlackBinaryReader.js"],"sourcesContent":["export class CjsBlackBinaryReader\n{\n constructor(dataView, context = null)\n {\n if (!(dataView instanceof DataView))\n {\n throw new TypeError(\"CjsBlackBinaryReader expected a DataView\");\n }\n\n this.data = dataView;\n this.context = context;\n this.offset = 0;\n }\n\n get remaining()\n {\n return this.data.byteLength - this.offset;\n }\n\n AtEnd()\n {\n return this.remaining === 0;\n }\n\n ExpectEnd(message = \"Black reader did not reach end\")\n {\n if (!this.AtEnd())\n {\n throw new RangeError(`${message}: ${this.remaining} bytes remain`);\n }\n }\n\n ExpectU32(expected, message)\n {\n const actual = this.ReadU32();\n if (actual !== expected)\n {\n throw new RangeError(`${message}: expected ${expected}, got ${actual}`);\n }\n return actual;\n }\n\n ReadBinaryReader(byteLength)\n {\n return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);\n }\n\n ReadBytes(byteLength)\n {\n const view = this.ReadDataView(byteLength);\n return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n }\n\n ReadCString()\n {\n const startOffset = this.offset;\n while (this.ReadU8() !== 0)\n {\n // Scan to null terminator.\n }\n\n const byteOffset = this.data.byteOffset + startOffset;\n const byteLength = this.offset - startOffset - 1;\n const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);\n return CjsBlackBinaryReader.utf8Decoder.decode(bytes);\n }\n\n ReadCWString()\n {\n const startOffset = this.offset;\n while (this.ReadU16() !== 0)\n {\n // Scan to UTF-16 null terminator.\n }\n\n const byteOffset = this.data.byteOffset + startOffset;\n const byteLength = this.offset - startOffset - 2;\n const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);\n return CjsBlackBinaryReader.utf16Decoder.decode(bytes);\n }\n\n ReadDataView(byteLength)\n {\n if (!Number.isInteger(byteLength) || byteLength < 0)\n {\n throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);\n }\n\n if (this.remaining < byteLength)\n {\n throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);\n }\n\n const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);\n this.offset += byteLength;\n return result;\n }\n\n ReadF32()\n {\n const value = this.data.getFloat32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadF64()\n {\n const value = this.data.getFloat64(this.offset, true);\n this.offset += 8;\n return value;\n }\n\n ReadI8()\n {\n const value = this.data.getInt8(this.offset);\n this.offset += 1;\n return value;\n }\n\n ReadI16()\n {\n const value = this.data.getInt16(this.offset, true);\n this.offset += 2;\n return value;\n }\n\n ReadI32()\n {\n const value = this.data.getInt32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadI64()\n {\n return this.data.getBigInt64(this.ConsumeOffset(8), true);\n }\n\n ReadStringRef()\n {\n const index = this.ReadU16();\n const strings = this.context?.info?.strings || [];\n if (index >= strings.length)\n {\n throw new RangeError(`Invalid Black string index: ${index}`);\n }\n return strings[index];\n }\n\n ReadWideStringRef()\n {\n const index = this.ReadU16();\n const strings = this.context?.info?.wideStrings || [];\n if (index >= strings.length)\n {\n throw new RangeError(`Invalid Black wide string index: ${index}`);\n }\n return strings[index];\n }\n\n ReadU8()\n {\n const value = this.data.getUint8(this.offset);\n this.offset += 1;\n return value;\n }\n\n ReadU16()\n {\n const value = this.data.getUint16(this.offset, true);\n this.offset += 2;\n return value;\n }\n\n ReadU32()\n {\n const value = this.data.getUint32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadU64()\n {\n return this.data.getBigUint64(this.ConsumeOffset(8), true);\n }\n\n Skip(byteLength)\n {\n this.ReadDataView(byteLength);\n }\n\n ConsumeOffset(byteLength)\n {\n if (this.remaining < byteLength)\n {\n throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);\n }\n\n const offset = this.offset;\n this.offset += byteLength;\n return offset;\n }\n\n static from(input, context = null)\n {\n if (input instanceof CjsBlackBinaryReader) return input;\n if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);\n if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);\n if (ArrayBuffer.isView(input))\n {\n return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);\n }\n\n throw new TypeError(\"Black input must be an ArrayBuffer, DataView, or typed array\");\n }\n\n static utf8Decoder = new TextDecoder(\"utf-8\");\n static utf16Decoder = new TextDecoder(\"utf-16le\");\n}\n"],"names":["CjsBlackBinaryReader","constructor","dataView","context","DataView","TypeError","data","offset","remaining","byteLength","AtEnd","ExpectEnd","message","RangeError","ExpectU32","expected","actual","ReadU32","ReadBinaryReader","ReadDataView","ReadBytes","view","Uint8Array","buffer","byteOffset","ReadCString","startOffset","ReadU8","bytes","utf8Decoder","decode","ReadCWString","ReadU16","utf16Decoder","Number","isInteger","String","result","ReadF32","value","getFloat32","ReadF64","getFloat64","ReadI8","getInt8","ReadI16","getInt16","ReadI32","getInt32","ReadI64","getBigInt64","ConsumeOffset","ReadStringRef","index","strings","info","length","ReadWideStringRef","wideStrings","getUint8","getUint16","getUint32","ReadU64","getBigUint64","Skip","from","input","ArrayBuffer","isView","TextDecoder"],"mappings":"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"}
1
+ {"version":3,"file":"CjsBlackBinaryReader.js","sources":["../../../../../src/formats/black/core/CjsBlackBinaryReader.js"],"sourcesContent":["/**\n * Bounds-aware `DataView` cursor that provides the primitive reads and\n * end-of-stream checks the Black transport decodes with.\n */\nexport class CjsBlackBinaryReader\n{\n constructor(dataView, context = null)\n {\n if (!(dataView instanceof DataView))\n {\n throw new TypeError(\"CjsBlackBinaryReader expected a DataView\");\n }\n\n this.data = dataView;\n this.context = context;\n this.offset = 0;\n }\n\n get remaining()\n {\n return this.data.byteLength - this.offset;\n }\n\n AtEnd()\n {\n return this.remaining === 0;\n }\n\n ExpectEnd(message = \"Black reader did not reach end\")\n {\n if (!this.AtEnd())\n {\n throw new RangeError(`${message}: ${this.remaining} bytes remain`);\n }\n }\n\n ExpectU32(expected, message)\n {\n const actual = this.ReadU32();\n if (actual !== expected)\n {\n throw new RangeError(`${message}: expected ${expected}, got ${actual}`);\n }\n return actual;\n }\n\n ReadBinaryReader(byteLength)\n {\n return new CjsBlackBinaryReader(this.ReadDataView(byteLength), this.context);\n }\n\n ReadBytes(byteLength)\n {\n const view = this.ReadDataView(byteLength);\n return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);\n }\n\n ReadCString()\n {\n const startOffset = this.offset;\n while (this.ReadU8() !== 0)\n {\n // Scan to null terminator.\n }\n\n const byteOffset = this.data.byteOffset + startOffset;\n const byteLength = this.offset - startOffset - 1;\n const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);\n return CjsBlackBinaryReader.utf8Decoder.decode(bytes);\n }\n\n ReadCWString()\n {\n const startOffset = this.offset;\n while (this.ReadU16() !== 0)\n {\n // Scan to UTF-16 null terminator.\n }\n\n const byteOffset = this.data.byteOffset + startOffset;\n const byteLength = this.offset - startOffset - 2;\n const bytes = new Uint8Array(this.data.buffer, byteOffset, byteLength);\n return CjsBlackBinaryReader.utf16Decoder.decode(bytes);\n }\n\n ReadDataView(byteLength)\n {\n if (!Number.isInteger(byteLength) || byteLength < 0)\n {\n throw new RangeError(`Invalid Black byte length: ${String(byteLength)}`);\n }\n\n if (this.remaining < byteLength)\n {\n throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);\n }\n\n const result = new DataView(this.data.buffer, this.data.byteOffset + this.offset, byteLength);\n this.offset += byteLength;\n return result;\n }\n\n ReadF32()\n {\n const value = this.data.getFloat32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadF64()\n {\n const value = this.data.getFloat64(this.offset, true);\n this.offset += 8;\n return value;\n }\n\n ReadI8()\n {\n const value = this.data.getInt8(this.offset);\n this.offset += 1;\n return value;\n }\n\n ReadI16()\n {\n const value = this.data.getInt16(this.offset, true);\n this.offset += 2;\n return value;\n }\n\n ReadI32()\n {\n const value = this.data.getInt32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadI64()\n {\n return this.data.getBigInt64(this.ConsumeOffset(8), true);\n }\n\n ReadStringRef()\n {\n const index = this.ReadU16();\n const strings = this.context?.info?.strings || [];\n if (index >= strings.length)\n {\n throw new RangeError(`Invalid Black string index: ${index}`);\n }\n return strings[index];\n }\n\n ReadWideStringRef()\n {\n const index = this.ReadU16();\n const strings = this.context?.info?.wideStrings || [];\n if (index >= strings.length)\n {\n throw new RangeError(`Invalid Black wide string index: ${index}`);\n }\n return strings[index];\n }\n\n ReadU8()\n {\n const value = this.data.getUint8(this.offset);\n this.offset += 1;\n return value;\n }\n\n ReadU16()\n {\n const value = this.data.getUint16(this.offset, true);\n this.offset += 2;\n return value;\n }\n\n ReadU32()\n {\n const value = this.data.getUint32(this.offset, true);\n this.offset += 4;\n return value;\n }\n\n ReadU64()\n {\n return this.data.getBigUint64(this.ConsumeOffset(8), true);\n }\n\n Skip(byteLength)\n {\n this.ReadDataView(byteLength);\n }\n\n ConsumeOffset(byteLength)\n {\n if (this.remaining < byteLength)\n {\n throw new RangeError(`Black reader needs ${byteLength} bytes but only ${this.remaining} remain`);\n }\n\n const offset = this.offset;\n this.offset += byteLength;\n return offset;\n }\n\n static from(input, context = null)\n {\n if (input instanceof CjsBlackBinaryReader) return input;\n if (input instanceof DataView) return new CjsBlackBinaryReader(input, context);\n if (input instanceof ArrayBuffer) return new CjsBlackBinaryReader(new DataView(input), context);\n if (ArrayBuffer.isView(input))\n {\n return new CjsBlackBinaryReader(new DataView(input.buffer, input.byteOffset, input.byteLength), context);\n }\n\n throw new TypeError(\"Black input must be an ArrayBuffer, DataView, or typed array\");\n }\n\n static utf8Decoder = new TextDecoder(\"utf-8\");\n static utf16Decoder = new TextDecoder(\"utf-16le\");\n}\n"],"names":["CjsBlackBinaryReader","constructor","dataView","context","DataView","TypeError","data","offset","remaining","byteLength","AtEnd","ExpectEnd","message","RangeError","ExpectU32","expected","actual","ReadU32","ReadBinaryReader","ReadDataView","ReadBytes","view","Uint8Array","buffer","byteOffset","ReadCString","startOffset","ReadU8","bytes","utf8Decoder","decode","ReadCWString","ReadU16","utf16Decoder","Number","isInteger","String","result","ReadF32","value","getFloat32","ReadF64","getFloat64","ReadI8","getInt8","ReadI16","getInt16","ReadI32","getInt32","ReadI64","getBigInt64","ConsumeOffset","ReadStringRef","index","strings","info","length","ReadWideStringRef","wideStrings","getUint8","getUint16","getUint32","ReadU64","getBigUint64","Skip","from","input","ArrayBuffer","isView","TextDecoder"],"mappings":"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"}