@carbonenginejs/runtime-resource 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/NOTICE +29 -29
- package/README.md +67 -548
- package/dist/CjsMotherLode.js +1271 -1271
- package/dist/CjsResMan.js +3005 -3005
- package/dist/CjsResManQueue.js +214 -214
- package/dist/CjsResource.js +566 -566
- package/dist/CjsResourceSource.js +59 -59
- package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
- package/dist/format/CjsBlueReader.js +269 -269
- package/dist/format/CjsFormat.js +192 -192
- package/dist/format/CjsReader.js +18 -18
- package/dist/format/CjsResourceProbe.js +277 -277
- package/dist/format/payloadContract.js +173 -173
- package/dist/formats/black/CjsBlackFormat.js +278 -278
- package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
- package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
- package/dist/formats/black/core/CjsBlackReader.js +639 -639
- package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
- package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
- package/dist/formats/black/core/blackConstants.js +7 -7
- package/dist/formats/black/core/blackDefinitions.js +10 -10
- package/dist/formats/black/core/blackEnums.js +6 -6
- package/dist/formats/black/core/blackSchema.js +3 -3
- package/dist/formats/black/core/blackVersion.js +22 -22
- package/dist/formats/black/core/helpers.js +182 -182
- package/dist/formats/black/core/schema.js +4 -4
- package/dist/formats/black/index.js +2 -2
- package/dist/formats/bnk/CjsBnkFormat.js +125 -125
- package/dist/formats/bnk/core/graph.js +140 -140
- package/dist/formats/bnk/core/helpers.js +409 -409
- package/dist/formats/bnk/core/musicNodes.js +489 -489
- package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
- package/dist/formats/bnk/index.js +2 -2
- package/dist/formats/cmf/CjsCmfFormat.js +497 -497
- package/dist/formats/cmf/core/binary.js +118 -118
- package/dist/formats/cmf/core/buffers.js +233 -233
- package/dist/formats/cmf/core/constants.js +47 -47
- package/dist/formats/cmf/core/gr2Anim.js +453 -453
- package/dist/formats/cmf/core/helpers.js +287 -287
- package/dist/formats/cmf/core/pack.js +276 -276
- package/dist/formats/cmf/core/schema.js +364 -364
- package/dist/formats/cmf/core/shared.js +268 -268
- package/dist/formats/cmf/core/writer.js +517 -517
- package/dist/formats/cmf/index.js +2 -2
- package/dist/formats/dds/CjsDdsFormat.js +193 -193
- package/dist/formats/dds/core/bc6h.js +288 -288
- package/dist/formats/dds/core/bc7.js +251 -251
- package/dist/formats/dds/core/helpers.js +815 -815
- package/dist/formats/dds/index.js +2 -2
- package/dist/formats/fbx/CjsFbxFormat.js +266 -266
- package/dist/formats/fbx/core/helpers.js +3901 -3901
- package/dist/formats/fbx/index.js +2 -2
- package/dist/formats/flac/CjsFlacFormat.js +87 -87
- package/dist/formats/flac/core/helpers.js +295 -295
- package/dist/formats/flac/index.js +2 -2
- package/dist/formats/gif/CjsGifFormat.js +87 -87
- package/dist/formats/gif/core/helpers.js +360 -360
- package/dist/formats/gif/index.js +2 -2
- package/dist/formats/gltf/CjsGltfFormat.js +290 -290
- package/dist/formats/gltf/core/helpers.js +292 -292
- package/dist/formats/gltf/core/json.js +79 -79
- package/dist/formats/gltf/core/parser.js +666 -666
- package/dist/formats/gltf/core/targets.js +163 -163
- package/dist/formats/gltf/index.js +2 -2
- package/dist/formats/gr2/CjsGr2Format.js +46 -0
- package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
- package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
- package/dist/formats/gr2/core/bitknit2.js +280 -0
- package/dist/formats/gr2/core/bitknit2.js.map +1 -0
- package/dist/formats/gr2/core/curves.js +1047 -0
- package/dist/formats/gr2/core/curves.js.map +1 -0
- package/dist/formats/gr2/core/gsf.js +72 -0
- package/dist/formats/gr2/core/gsf.js.map +1 -0
- package/dist/formats/gr2/core/helpers.js +332 -0
- package/dist/formats/gr2/core/helpers.js.map +1 -0
- package/dist/formats/gr2/core/json.js +622 -0
- package/dist/formats/gr2/core/json.js.map +1 -0
- package/dist/formats/gr2/core/oodle1.js +388 -0
- package/dist/formats/gr2/core/oodle1.js.map +1 -0
- package/dist/formats/gr2/core/reader.js +617 -0
- package/dist/formats/gr2/core/reader.js.map +1 -0
- package/dist/formats/gr2/core/tangents.js +48 -0
- package/dist/formats/gr2/core/tangents.js.map +1 -0
- package/dist/formats/gr2/core/targets.js +351 -0
- package/dist/formats/gr2/core/targets.js.map +1 -0
- package/dist/formats/gr2/index.js +3 -0
- package/dist/formats/gr2/index.js.map +1 -0
- package/dist/formats/index.js +30 -23
- package/dist/formats/index.js.map +1 -1
- package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
- package/dist/formats/jpeg/core/helpers.js +350 -350
- package/dist/formats/jpeg/core/jpeg.js +377 -377
- package/dist/formats/jpeg/index.js +2 -2
- package/dist/formats/mp3/CjsMp3Format.js +192 -192
- package/dist/formats/mp3/core/helpers.js +338 -338
- package/dist/formats/mp3/index.js +2 -2
- package/dist/formats/mp4/CjsMp4Format.js +191 -191
- package/dist/formats/mp4/core/helpers.js +449 -449
- package/dist/formats/mp4/index.js +2 -2
- package/dist/formats/obj/CjsObjFormat.js +253 -253
- package/dist/formats/obj/core/helpers.js +573 -573
- package/dist/formats/obj/core/json.js +64 -64
- package/dist/formats/obj/core/parser.js +321 -321
- package/dist/formats/obj/index.js +2 -2
- package/dist/formats/ogg/CjsOggFormat.js +88 -88
- package/dist/formats/ogg/core/helpers.js +387 -387
- package/dist/formats/ogg/core/imdct.js +178 -178
- package/dist/formats/ogg/core/vorbis.js +999 -999
- package/dist/formats/ogg/index.js +2 -2
- package/dist/formats/png/CjsPngFormat.js +195 -195
- package/dist/formats/png/core/helpers.js +583 -583
- package/dist/formats/png/index.js +2 -2
- package/dist/formats/red/CjsRedFormat.js +261 -261
- package/dist/formats/red/core/CjsRedReader.js +194 -194
- package/dist/formats/red/core/blackDefinitions.js +3 -3
- package/dist/formats/red/core/helpers.js +139 -139
- package/dist/formats/red/core/redGraph.js +68 -68
- package/dist/formats/red/core/schema.js +4 -4
- package/dist/formats/red/index.js +2 -2
- package/dist/formats/stl/CjsStlFormat.js +365 -365
- package/dist/formats/stl/core/helpers.js +261 -261
- package/dist/formats/stl/core/json.js +51 -51
- package/dist/formats/stl/core/stl.js +629 -629
- package/dist/formats/stl/core/targets.js +163 -163
- package/dist/formats/stl/index.js +2 -2
- package/dist/formats/tga/CjsTgaFormat.js +192 -192
- package/dist/formats/tga/core/helpers.js +446 -446
- package/dist/formats/tga/index.js +2 -2
- package/dist/formats/wav/CjsWavFormat.js +192 -192
- package/dist/formats/wav/core/helpers.js +328 -328
- package/dist/formats/wav/index.js +2 -2
- package/dist/formats/webm/CjsWebmFormat.js +191 -191
- package/dist/formats/webm/core/helpers.js +537 -537
- package/dist/formats/webm/index.js +2 -2
- package/dist/formats/webp/CjsWebpFormat.js +86 -86
- package/dist/formats/webp/core/helpers.js +214 -214
- package/dist/formats/webp/index.js +2 -2
- package/dist/formats/wem/CjsWemFormat.js +241 -241
- package/dist/formats/wem/core/bitStream.js +259 -259
- package/dist/formats/wem/core/codebookLibrary.js +164 -164
- package/dist/formats/wem/core/helpers.js +417 -417
- package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
- package/dist/formats/wem/core/ptadpcm.js +77 -77
- package/dist/formats/wem/core/resolve.js +121 -121
- package/dist/formats/wem/core/wemToOgg.js +485 -485
- package/dist/formats/wem/index.js +2 -2
- package/dist/formats/yaml/CjsYamlFormat.js +83 -83
- package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
- package/dist/formats/yaml/core/helpers.js +160 -160
- package/dist/formats/yaml/index.js +2 -2
- package/dist/index.js +49 -48
- package/dist/index.js.map +1 -1
- package/dist/resourcePath.js +18 -18
- package/dist/resourceStates.js +9 -9
- package/dist/resources/AudioGeometryResData.js +47 -47
- package/dist/resources/GStateBindingCallbackData.js +31 -31
- package/dist/resources/MeshDecalData.js +37 -37
- package/dist/resources/MeshDecalLodData.js +34 -34
- package/dist/resources/Tr2EffectRes.js +71 -71
- package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
- package/dist/resources/Tr2GrannyStateRes.js +44 -44
- package/dist/resources/Tr2ImageRes.js +114 -114
- package/dist/resources/Tr2LightProfileRes.js +40 -40
- package/dist/resources/Tr2MaterialArea.js +34 -34
- package/dist/resources/Tr2MaterialMesh.js +31 -31
- package/dist/resources/Tr2MaterialRes.js +34 -34
- package/dist/resources/Tr2ShaderPermutation.js +43 -43
- package/dist/resources/Tr2TextureLodManager.js +80 -80
- package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
- package/dist/resources/Tr2TexturePackChannel.js +37 -37
- package/dist/resources/Tr2TexturePipeline.js +52 -52
- package/dist/resources/Tr2TexturePipelineParams.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
- package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
- package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
- package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
- package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
- package/dist/resources/TriGeometryRes.js +239 -239
- package/dist/resources/TriGeometryResAreaData.js +59 -59
- package/dist/resources/TriGeometryResJointData.js +38 -38
- package/dist/resources/TriGeometryResLodData.js +88 -88
- package/dist/resources/TriGeometryResMeshData.js +63 -63
- package/dist/resources/TriGeometryResSkeletonData.js +34 -34
- package/dist/resources/TriGrannyRes.js +43 -43
- package/dist/resources/TriJointBinding.js +38 -38
- package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
- package/dist/resources/TriRtGeometryConstants.js +88 -88
- package/dist/resources/TriTextureRes.js +304 -304
- package/dist/resources/enums.js +18 -18
- package/dist/resources/resourceBoundary.js +47 -47
- package/dist/resources/texturePipelineBehavior.js +308 -308
- package/dist/texture/CjsTextureArrayRes.js +406 -406
- package/dist/texture/CjsTextureParameterProxy.js +133 -133
- package/docs/README.md +69 -0
- package/docs/architecture.md +86 -0
- package/docs/concepts/resource-lifecycle.md +217 -0
- package/docs/formats/README.md +104 -0
- package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
- package/docs/formats/stl.md +37 -0
- package/docs/formats/wwise.md +44 -0
- package/docs/reference/events.md +92 -0
- package/docs/reference/motherlode-cache.md +244 -0
- package/docs/reference/queues.md +102 -0
- package/docs/reference/reload.md +107 -0
- package/docs/reference/texture-arrays.md +113 -0
- package/docs/reference/texture-pipeline.md +53 -0
- package/docs/roadmap.md +104 -0
- package/format-notices/black/LICENSE +21 -21
- package/format-notices/black/NOTICE +47 -47
- package/format-notices/bnk/LICENSE +21 -21
- package/format-notices/bnk/NOTICE +20 -20
- package/format-notices/cmf/LICENSE +21 -21
- package/format-notices/cmf/NOTICE +36 -36
- package/format-notices/dds/LICENSE +21 -21
- package/format-notices/dds/NOTICE +14 -14
- package/format-notices/fbx/LICENSE +21 -21
- package/format-notices/fbx/NOTICE +14 -14
- package/format-notices/flac/LICENSE +21 -21
- package/format-notices/flac/NOTICE +14 -14
- package/format-notices/gif/LICENSE +21 -21
- package/format-notices/gif/NOTICE +14 -14
- package/format-notices/gltf/LICENSE +21 -21
- package/format-notices/gltf/NOTICE +27 -27
- package/format-notices/gr2/LICENSE +21 -0
- package/format-notices/gr2/NOTICE +60 -0
- package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
- package/format-notices/jpeg/LICENSE +21 -21
- package/format-notices/jpeg/NOTICE +14 -14
- package/format-notices/mp3/LICENSE +21 -21
- package/format-notices/mp3/NOTICE +14 -14
- package/format-notices/mp4/LICENSE +21 -21
- package/format-notices/mp4/NOTICE +14 -14
- package/format-notices/obj/LICENSE +21 -21
- package/format-notices/obj/NOTICE +26 -26
- package/format-notices/ogg/LICENSE +21 -21
- package/format-notices/ogg/NOTICE +28 -28
- package/format-notices/png/LICENSE +21 -21
- package/format-notices/png/NOTICE +14 -14
- package/format-notices/red/LICENSE +21 -21
- package/format-notices/red/NOTICE +31 -31
- package/format-notices/stl/LICENSE +21 -21
- package/format-notices/stl/NOTICE +21 -21
- package/format-notices/tga/LICENSE +21 -21
- package/format-notices/tga/NOTICE +14 -14
- package/format-notices/wav/LICENSE +21 -21
- package/format-notices/wav/NOTICE +14 -14
- package/format-notices/webm/LICENSE +21 -21
- package/format-notices/webm/NOTICE +14 -14
- package/format-notices/webp/LICENSE +21 -21
- package/format-notices/webp/NOTICE +14 -14
- package/format-notices/wem/LICENSE +57 -57
- package/format-notices/wem/NOTICE +33 -33
- package/format-notices/yaml/LICENSE +21 -21
- package/format-notices/yaml/NOTICE +44 -44
- package/package.json +52 -51
- package/resource-lifecycle.md +0 -679
|
@@ -1,153 +1,153 @@
|
|
|
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
|
+
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
|