@carbonenginejs/runtime-resource 0.7.0 → 0.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/FORMAT-PROVENANCE.md +155 -144
  2. package/LICENSE +21 -21
  3. package/NOTICE +29 -29
  4. package/README.md +11 -0
  5. package/dist/CjsMotherLode.js +1271 -1271
  6. package/dist/CjsResMan.js +3005 -3005
  7. package/dist/CjsResManQueue.js +214 -214
  8. package/dist/CjsResource.js +566 -566
  9. package/dist/CjsResourceSource.js +59 -59
  10. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  11. package/dist/format/CjsBlueReader.js +269 -269
  12. package/dist/format/CjsFormat.js +192 -192
  13. package/dist/format/CjsReader.js +18 -18
  14. package/dist/format/CjsResourceProbe.js +277 -277
  15. package/dist/format/payloadContract.js +173 -173
  16. package/dist/formats/black/CjsBlackFormat.js +278 -278
  17. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  18. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  19. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  20. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  21. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  22. package/dist/formats/black/core/blackConstants.js +7 -7
  23. package/dist/formats/black/core/blackDefinitions.js +10 -10
  24. package/dist/formats/black/core/blackEnums.js +6 -6
  25. package/dist/formats/black/core/blackSchema.js +3 -3
  26. package/dist/formats/black/core/blackVersion.js +22 -22
  27. package/dist/formats/black/core/helpers.js +182 -182
  28. package/dist/formats/black/core/schema.js +4 -4
  29. package/dist/formats/black/index.js +2 -2
  30. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  31. package/dist/formats/bnk/core/graph.js +140 -140
  32. package/dist/formats/bnk/core/helpers.js +409 -409
  33. package/dist/formats/bnk/core/musicNodes.js +489 -489
  34. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  35. package/dist/formats/bnk/index.js +2 -2
  36. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  37. package/dist/formats/cmf/core/binary.js +118 -118
  38. package/dist/formats/cmf/core/buffers.js +233 -233
  39. package/dist/formats/cmf/core/constants.js +47 -47
  40. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  41. package/dist/formats/cmf/core/helpers.js +287 -287
  42. package/dist/formats/cmf/core/pack.js +276 -276
  43. package/dist/formats/cmf/core/schema.js +364 -364
  44. package/dist/formats/cmf/core/shared.js +268 -268
  45. package/dist/formats/cmf/core/writer.js +517 -517
  46. package/dist/formats/cmf/index.js +2 -2
  47. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  48. package/dist/formats/dds/core/bc6h.js +288 -0
  49. package/dist/formats/dds/core/bc6h.js.map +1 -0
  50. package/dist/formats/dds/core/bc7.js +251 -0
  51. package/dist/formats/dds/core/bc7.js.map +1 -0
  52. package/dist/formats/dds/core/helpers.js +815 -812
  53. package/dist/formats/dds/core/helpers.js.map +1 -1
  54. package/dist/formats/dds/index.js +2 -2
  55. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  56. package/dist/formats/fbx/core/helpers.js +3901 -3901
  57. package/dist/formats/fbx/index.js +2 -2
  58. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  59. package/dist/formats/flac/core/helpers.js +295 -295
  60. package/dist/formats/flac/index.js +2 -2
  61. package/dist/formats/gif/CjsGifFormat.js +87 -87
  62. package/dist/formats/gif/core/helpers.js +360 -360
  63. package/dist/formats/gif/index.js +2 -2
  64. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  65. package/dist/formats/gltf/core/helpers.js +292 -292
  66. package/dist/formats/gltf/core/json.js +79 -79
  67. package/dist/formats/gltf/core/parser.js +666 -666
  68. package/dist/formats/gltf/core/targets.js +163 -163
  69. package/dist/formats/gltf/index.js +2 -2
  70. package/dist/formats/index.js +23 -23
  71. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  72. package/dist/formats/jpeg/core/helpers.js +350 -350
  73. package/dist/formats/jpeg/core/jpeg.js +377 -377
  74. package/dist/formats/jpeg/index.js +2 -2
  75. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  76. package/dist/formats/mp3/core/helpers.js +338 -338
  77. package/dist/formats/mp3/index.js +2 -2
  78. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  79. package/dist/formats/mp4/core/helpers.js +449 -449
  80. package/dist/formats/mp4/index.js +2 -2
  81. package/dist/formats/obj/CjsObjFormat.js +253 -253
  82. package/dist/formats/obj/core/helpers.js +573 -573
  83. package/dist/formats/obj/core/json.js +64 -64
  84. package/dist/formats/obj/core/parser.js +321 -321
  85. package/dist/formats/obj/index.js +2 -2
  86. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  87. package/dist/formats/ogg/core/helpers.js +387 -387
  88. package/dist/formats/ogg/core/imdct.js +178 -178
  89. package/dist/formats/ogg/core/vorbis.js +999 -999
  90. package/dist/formats/ogg/index.js +2 -2
  91. package/dist/formats/png/CjsPngFormat.js +195 -195
  92. package/dist/formats/png/core/helpers.js +583 -583
  93. package/dist/formats/png/index.js +2 -2
  94. package/dist/formats/red/CjsRedFormat.js +261 -261
  95. package/dist/formats/red/core/CjsRedReader.js +194 -194
  96. package/dist/formats/red/core/blackDefinitions.js +3 -3
  97. package/dist/formats/red/core/helpers.js +139 -139
  98. package/dist/formats/red/core/redGraph.js +68 -68
  99. package/dist/formats/red/core/schema.js +4 -4
  100. package/dist/formats/red/index.js +2 -2
  101. package/dist/formats/stl/CjsStlFormat.js +365 -365
  102. package/dist/formats/stl/core/helpers.js +261 -261
  103. package/dist/formats/stl/core/json.js +51 -51
  104. package/dist/formats/stl/core/stl.js +629 -629
  105. package/dist/formats/stl/core/targets.js +163 -163
  106. package/dist/formats/stl/index.js +2 -2
  107. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  108. package/dist/formats/tga/core/helpers.js +446 -446
  109. package/dist/formats/tga/index.js +2 -2
  110. package/dist/formats/wav/CjsWavFormat.js +192 -192
  111. package/dist/formats/wav/core/helpers.js +328 -328
  112. package/dist/formats/wav/index.js +2 -2
  113. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  114. package/dist/formats/webm/core/helpers.js +537 -537
  115. package/dist/formats/webm/index.js +2 -2
  116. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  117. package/dist/formats/webp/core/helpers.js +214 -214
  118. package/dist/formats/webp/index.js +2 -2
  119. package/dist/formats/wem/CjsWemFormat.js +241 -241
  120. package/dist/formats/wem/core/bitStream.js +259 -259
  121. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  122. package/dist/formats/wem/core/helpers.js +417 -417
  123. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  124. package/dist/formats/wem/core/ptadpcm.js +77 -77
  125. package/dist/formats/wem/core/resolve.js +121 -121
  126. package/dist/formats/wem/core/wemToOgg.js +485 -485
  127. package/dist/formats/wem/index.js +2 -2
  128. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  129. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  130. package/dist/formats/yaml/core/helpers.js +160 -160
  131. package/dist/formats/yaml/index.js +2 -2
  132. package/dist/index.js +48 -48
  133. package/dist/resourcePath.js +18 -18
  134. package/dist/resourceStates.js +9 -9
  135. package/dist/resources/AudioGeometryResData.js +47 -47
  136. package/dist/resources/GStateBindingCallbackData.js +31 -31
  137. package/dist/resources/MeshDecalData.js +37 -37
  138. package/dist/resources/MeshDecalLodData.js +34 -34
  139. package/dist/resources/Tr2EffectRes.js +71 -71
  140. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  141. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  142. package/dist/resources/Tr2ImageRes.js +114 -114
  143. package/dist/resources/Tr2LightProfileRes.js +40 -40
  144. package/dist/resources/Tr2MaterialArea.js +34 -34
  145. package/dist/resources/Tr2MaterialMesh.js +31 -31
  146. package/dist/resources/Tr2MaterialRes.js +34 -34
  147. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  148. package/dist/resources/Tr2TextureLodManager.js +80 -80
  149. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  150. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  151. package/dist/resources/Tr2TexturePipeline.js +52 -52
  152. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  153. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  154. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  155. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  156. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  157. package/dist/resources/TriGeometryRes.js +239 -216
  158. package/dist/resources/TriGeometryRes.js.map +1 -1
  159. package/dist/resources/TriGeometryResAreaData.js +59 -59
  160. package/dist/resources/TriGeometryResJointData.js +38 -38
  161. package/dist/resources/TriGeometryResLodData.js +88 -88
  162. package/dist/resources/TriGeometryResMeshData.js +63 -63
  163. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  164. package/dist/resources/TriGrannyRes.js +43 -43
  165. package/dist/resources/TriJointBinding.js +38 -38
  166. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  167. package/dist/resources/TriRtGeometryConstants.js +88 -88
  168. package/dist/resources/TriTextureRes.js +304 -304
  169. package/dist/resources/enums.js +18 -18
  170. package/dist/resources/resourceBoundary.js +47 -47
  171. package/dist/resources/texturePipelineBehavior.js +308 -308
  172. package/dist/texture/CjsTextureArrayRes.js +406 -406
  173. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  174. package/format-notices/black/LICENSE +21 -21
  175. package/format-notices/black/NOTICE +47 -47
  176. package/format-notices/bnk/LICENSE +21 -21
  177. package/format-notices/bnk/NOTICE +20 -20
  178. package/format-notices/cmf/LICENSE +21 -21
  179. package/format-notices/cmf/NOTICE +36 -36
  180. package/format-notices/dds/LICENSE +21 -21
  181. package/format-notices/dds/NOTICE +14 -14
  182. package/format-notices/fbx/LICENSE +21 -21
  183. package/format-notices/fbx/NOTICE +14 -14
  184. package/format-notices/flac/LICENSE +21 -21
  185. package/format-notices/flac/NOTICE +14 -14
  186. package/format-notices/gif/LICENSE +21 -21
  187. package/format-notices/gif/NOTICE +14 -14
  188. package/format-notices/gltf/LICENSE +21 -21
  189. package/format-notices/gltf/NOTICE +27 -27
  190. package/format-notices/jpeg/LICENSE +21 -21
  191. package/format-notices/jpeg/NOTICE +14 -14
  192. package/format-notices/mp3/LICENSE +21 -21
  193. package/format-notices/mp3/NOTICE +14 -14
  194. package/format-notices/mp4/LICENSE +21 -21
  195. package/format-notices/mp4/NOTICE +14 -14
  196. package/format-notices/obj/LICENSE +21 -21
  197. package/format-notices/obj/NOTICE +26 -26
  198. package/format-notices/ogg/LICENSE +21 -21
  199. package/format-notices/ogg/NOTICE +28 -28
  200. package/format-notices/png/LICENSE +21 -21
  201. package/format-notices/png/NOTICE +14 -14
  202. package/format-notices/red/LICENSE +21 -21
  203. package/format-notices/red/NOTICE +31 -31
  204. package/format-notices/stl/LICENSE +21 -21
  205. package/format-notices/stl/NOTICE +21 -21
  206. package/format-notices/tga/LICENSE +21 -21
  207. package/format-notices/tga/NOTICE +14 -14
  208. package/format-notices/wav/LICENSE +21 -21
  209. package/format-notices/wav/NOTICE +14 -14
  210. package/format-notices/webm/LICENSE +21 -21
  211. package/format-notices/webm/NOTICE +14 -14
  212. package/format-notices/webp/LICENSE +21 -21
  213. package/format-notices/webp/NOTICE +14 -14
  214. package/format-notices/wem/LICENSE +57 -57
  215. package/format-notices/wem/NOTICE +33 -33
  216. package/format-notices/yaml/LICENSE +21 -21
  217. package/format-notices/yaml/NOTICE +44 -44
  218. package/package.json +2 -2
  219. package/resource-lifecycle.md +679 -679
@@ -1,292 +1,292 @@
1
- import { CLASS_KEYS as CLASS_KEYS$1, hydrateJson } from './json.js';
2
- import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
3
- import { parseInput, parseGltfToJson, inspectGltf } from './parser.js';
4
- export { isGlb, toBytes } from './parser.js';
5
- import { generateNormals, generateTangents, generateBiNormals } from '@carbonenginejs/core-math/mesh';
6
- import { packTangentFrames } from '@carbonenginejs/core-math/tangent';
7
- import { normalize, cross } from '@carbonenginejs/core-math/vec3';
8
-
9
- /**
10
- * Internal read-pipeline glue for CjsGltfFormat.
11
- */
12
-
13
- const CLASS_KEYS = Object.freeze(Array.from(new Set([...CLASS_KEYS$1, ...CMF_CLASS_KEYS])));
14
- const OUTPUT_JSON = "json";
15
- const OUTPUT_GLTF_JSON = "gltfJson";
16
- const OUTPUT_SHARED = "shared";
17
- const OUTPUT_GR2 = "gr2";
18
- const OUTPUT_CMF = "cmf";
19
- const DEFAULT_VALUES = Object.freeze({
20
- emit: OUTPUT_GLTF_JSON,
21
- source: "memory",
22
- buffers: null,
23
- packTangents: false,
24
- uvHandedness: "right",
25
- rebuildMissingNormals: false,
26
- rebuildMissingTangents: false,
27
- rebuildMissingBiNormals: false,
28
- classes: Object.freeze({})
29
- });
30
- const OPTION_KEYS = new Set(["emit", "source", "buffers", "packTangents", "uvHandedness", "rebuildMissingNormals", "rebuildMissingTangents", "rebuildMissingBiNormals", "classes"]);
31
- function validateClassKey(key, readerName = "CjsGltfFormat") {
32
- if (!CLASS_KEYS.includes(key)) {
33
- throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
34
- }
35
- }
36
- function validateClass(key, Class, readerName = "CjsGltfFormat") {
37
- validateClassKey(key, readerName);
38
- if (typeof Class !== "function") {
39
- throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
40
- }
41
- }
42
- function mergeClasses(base, classes, readerName) {
43
- if (!classes || typeof classes !== "object") {
44
- throw new TypeError(`${readerName}: classes option must be an object`);
45
- }
46
- const next = {
47
- ...base
48
- };
49
- for (const [key, Class] of Object.entries(classes)) {
50
- if (Class === null || Class === undefined) {
51
- delete next[key];
52
- continue;
53
- }
54
- validateClass(key, Class, readerName);
55
- next[key] = Class;
56
- }
57
- return next;
58
- }
59
- function validateRule(name, value, readerName) {
60
- if (typeof value === "boolean" || typeof value === "function") return value;
61
- throw new TypeError(`${readerName}: ${name} must be true, false, or a function`);
62
- }
63
- function normalizeUvHandedness(value, readerName) {
64
- if (value === undefined || value === null) return DEFAULT_VALUES.uvHandedness;
65
- if (value === "right" || value === 1 || value === "positive") return "right";
66
- if (value === "left" || value === -1 || value === "negative") return "left";
67
- throw new TypeError(`${readerName}: uvHandedness must be "right" or "left"`);
68
- }
69
- function normalizeValues(base, options = {}, readerName = "CjsGltfFormat") {
70
- if (!options || typeof options !== "object") {
71
- throw new TypeError(`${readerName}: options must be an object`);
72
- }
73
- for (const key of Object.keys(options)) {
74
- if (!OPTION_KEYS.has(key)) {
75
- throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
76
- }
77
- }
78
- const values = {
79
- ...base,
80
- ...options
81
- };
82
- const emit = normalizeEmit(values.emit, readerName);
83
- const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
84
- ...(base.classes || {})
85
- };
86
- if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
87
- throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
88
- }
89
- if (typeof values.source !== "string" || !values.source) {
90
- values.source = DEFAULT_VALUES.source;
91
- }
92
- return {
93
- emit,
94
- source: values.source,
95
- buffers: values.buffers || null,
96
- packTangents: validateRule("packTangents", values.packTangents, readerName),
97
- uvHandedness: normalizeUvHandedness(values.uvHandedness, readerName),
98
- rebuildMissingNormals: validateRule("rebuildMissingNormals", values.rebuildMissingNormals, readerName),
99
- rebuildMissingTangents: validateRule("rebuildMissingTangents", values.rebuildMissingTangents, readerName),
100
- rebuildMissingBiNormals: validateRule("rebuildMissingBiNormals", values.rebuildMissingBiNormals, readerName),
101
- classes
102
- };
103
- }
104
- function normalizeEmit(emit, readerName) {
105
- if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_GLTF_JSON || emit === OUTPUT_SHARED) {
106
- return OUTPUT_GLTF_JSON;
107
- }
108
- if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
109
- throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_GLTF_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
110
- }
111
- function hasClasses(classes) {
112
- return !!classes && Object.values(classes).some(Class => typeof Class === "function");
113
- }
114
- function hasVertexChannel(mesh, channel) {
115
- const value = mesh && mesh.vertex && mesh.vertex[channel];
116
- return !!value && value.length > 0;
117
- }
118
- function requireVertexChannel(mesh, meshIndex, channel, feature) {
119
- const value = mesh && mesh.vertex && mesh.vertex[channel];
120
- if (!value || value.length === 0) {
121
- const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
122
- throw new Error(`CjsGltfFormat: ${feature} requires mesh.vertex.${channel} for mesh ${name}`);
123
- }
124
- return value;
125
- }
126
- function triangleFaces(mesh, meshIndex, feature) {
127
- const faces = [];
128
- for (const group of mesh.indices || []) {
129
- if (group && group.faces) faces.push(...group.faces);
130
- }
131
- if (faces.length === 0) {
132
- const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
133
- throw new Error(`CjsGltfFormat: ${feature} requires triangle indices for mesh ${name}`);
134
- }
135
- return faces;
136
- }
137
- function shouldApplyMeshRule(format, rule, context) {
138
- if (typeof rule === "function") {
139
- const result = rule({
140
- format,
141
- reader: format,
142
- ...context
143
- });
144
- if (typeof result !== "boolean") {
145
- throw new TypeError(`CjsGltfFormat: ${context.feature} rule must return true or false`);
146
- }
147
- return result;
148
- }
149
- return rule;
150
- }
151
- function vertexCount(mesh) {
152
- return mesh.vertex.position.length / 3;
153
- }
154
- function tangentXyz(mesh) {
155
- const tangent = requireVertexChannel(mesh, 0, "tangent", "tangent conversion"),
156
- count = vertexCount(mesh),
157
- width = tangent.length / count;
158
- if (width === 3) return tangent.slice();
159
- if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
160
- const out = new Array(count * 3);
161
- for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
162
- out[o] = tangent[i];
163
- out[o + 1] = tangent[i + 1];
164
- out[o + 2] = tangent[i + 2];
165
- }
166
- return out;
167
- }
168
- function generatedBiNormalsForMesh(mesh, values) {
169
- const normals = requireVertexChannel(mesh, 0, "normal", "binormal generation"),
170
- tangent = requireVertexChannel(mesh, 0, "tangent", "binormal generation"),
171
- count = vertexCount(mesh),
172
- width = tangent.length / count;
173
- if (width === 3) {
174
- return generateBiNormals(normals, tangent, {
175
- uvHandedness: values.uvHandedness
176
- });
177
- }
178
- if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
179
- const out = new Array(count * 3);
180
- for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
181
- const b = normalize([0, 0, 0], cross([0, 0, 0], [normals[o], normals[o + 1], normals[o + 2]], [tangent[i], tangent[i + 1], tangent[i + 2]]));
182
- const sign = tangent[i + 3] < 0 ? -1 : 1;
183
- out[o] = b[0] * sign;
184
- out[o + 1] = b[1] * sign;
185
- out[o + 2] = b[2] * sign;
186
- }
187
- return out;
188
- }
189
- function rebuildMissingMeshData(format, json, values) {
190
- for (let meshIndex = 0; meshIndex < json.meshes.length; meshIndex++) {
191
- const mesh = json.meshes[meshIndex],
192
- common = {
193
- options: values,
194
- raw: null,
195
- json,
196
- mesh,
197
- meshIndex
198
- },
199
- shouldPackTangents = shouldApplyMeshRule(format, values.packTangents, {
200
- ...common,
201
- feature: "packTangents",
202
- channel: "tangent"
203
- });
204
- if (!hasVertexChannel(mesh, "normal") && (shouldApplyMeshRule(format, values.rebuildMissingNormals, {
205
- ...common,
206
- feature: "rebuildMissingNormals",
207
- channel: "normal"
208
- }) || shouldPackTangents)) {
209
- mesh.vertex.normal = generateNormals(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingNormals"), triangleFaces(mesh, meshIndex, "rebuildMissingNormals"));
210
- }
211
- if (!hasVertexChannel(mesh, "tangent") && (shouldApplyMeshRule(format, values.rebuildMissingTangents, {
212
- ...common,
213
- feature: "rebuildMissingTangents",
214
- channel: "tangent"
215
- }) || shouldPackTangents)) {
216
- mesh.vertex.tangent = generateTangents(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "normal", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "texcoord0", "rebuildMissingTangents"), triangleFaces(mesh, meshIndex, "rebuildMissingTangents"));
217
- }
218
- if (!hasVertexChannel(mesh, "binormal") && (shouldApplyMeshRule(format, values.rebuildMissingBiNormals, {
219
- ...common,
220
- feature: "rebuildMissingBiNormals",
221
- channel: "binormal"
222
- }) || shouldPackTangents)) {
223
- mesh.vertex.binormal = generatedBiNormalsForMesh(mesh, values);
224
- }
225
- if (shouldPackTangents) {
226
- mesh.vertex.tangent = packTangentFrames(requireVertexChannel(mesh, meshIndex, "normal", "packTangents"), tangentXyz(mesh), requireVertexChannel(mesh, meshIndex, "binormal", "packTangents"));
227
- mesh.vertex.normal = [];
228
- mesh.vertex.binormal = [];
229
- }
230
- }
231
- }
232
- function readWithValues(format, input, values) {
233
- const parsed = parseInput(input);
234
- const json = parseGltfToJson(parsed.gltf, {
235
- binaryChunk: parsed.binaryChunk,
236
- source: values.source,
237
- buffers: values.buffers
238
- });
239
- rebuildMissingMeshData(format, json, values);
240
- if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
241
- source: values.source
242
- });
243
- return hydrateJson(json, {
244
- classes: values.classes,
245
- source: values.source
246
- });
247
- }
248
- function inspectWithValues(input, values) {
249
- const parsed = parseInput(input);
250
- return inspectGltf(parsed.gltf, {
251
- format: parsed.format,
252
- source: values.source
253
- });
254
- }
255
- function toJsonValue(value) {
256
- if (value === null || value === undefined) return value;
257
- if (typeof value !== "object") return value;
258
- if (typeof value.toJSON === "function") {
259
- const next = value.toJSON();
260
- if (next !== value) return toJsonValue(next);
261
- }
262
- if (Array.isArray(value)) return value.map(toJsonValue);
263
- if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
264
- const out = {};
265
- for (const key of Object.keys(value)) {
266
- out[key] = toJsonValue(value[key]);
267
- }
268
- return out;
269
- }
270
-
271
- /**
272
- * Imports a Node built-in module without exposing the specifier to any
273
- * bundler's static import graph.
274
- *
275
- * `await import("node:fs/promises")` written as a literal is resolved
276
- * eagerly by webpack/Rollup/esbuild alike when they walk the module
277
- * graph, breaking browser builds even though this path only ever runs
278
- * under Node (readFile is a Node-only convenience). Building the
279
- * specifier inside a `Function` body hides it from every bundler's
280
- * static analysis - it only exists at runtime, in the Node process that
281
- * actually calls readFile.
282
- *
283
- * @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
284
- * @returns {Promise<any>} The imported module namespace.
285
- */
286
- function importNodeModule(specifier) {
287
- // eslint-disable-next-line no-new-func
288
- return new Function("s", "return import(s)")(specifier);
289
- }
290
-
291
- export { CLASS_KEYS, DEFAULT_VALUES, OUTPUT_CMF, OUTPUT_GLTF_JSON, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey };
292
- //# sourceMappingURL=helpers.js.map
1
+ import { CLASS_KEYS as CLASS_KEYS$1, hydrateJson } from './json.js';
2
+ import { CMF_CLASS_KEYS, hydrateCmf, buildCmfFromShared } from './targets.js';
3
+ import { parseInput, parseGltfToJson, inspectGltf } from './parser.js';
4
+ export { isGlb, toBytes } from './parser.js';
5
+ import { generateNormals, generateTangents, generateBiNormals } from '@carbonenginejs/core-math/mesh';
6
+ import { packTangentFrames } from '@carbonenginejs/core-math/tangent';
7
+ import { normalize, cross } from '@carbonenginejs/core-math/vec3';
8
+
9
+ /**
10
+ * Internal read-pipeline glue for CjsGltfFormat.
11
+ */
12
+
13
+ const CLASS_KEYS = Object.freeze(Array.from(new Set([...CLASS_KEYS$1, ...CMF_CLASS_KEYS])));
14
+ const OUTPUT_JSON = "json";
15
+ const OUTPUT_GLTF_JSON = "gltfJson";
16
+ const OUTPUT_SHARED = "shared";
17
+ const OUTPUT_GR2 = "gr2";
18
+ const OUTPUT_CMF = "cmf";
19
+ const DEFAULT_VALUES = Object.freeze({
20
+ emit: OUTPUT_GLTF_JSON,
21
+ source: "memory",
22
+ buffers: null,
23
+ packTangents: false,
24
+ uvHandedness: "right",
25
+ rebuildMissingNormals: false,
26
+ rebuildMissingTangents: false,
27
+ rebuildMissingBiNormals: false,
28
+ classes: Object.freeze({})
29
+ });
30
+ const OPTION_KEYS = new Set(["emit", "source", "buffers", "packTangents", "uvHandedness", "rebuildMissingNormals", "rebuildMissingTangents", "rebuildMissingBiNormals", "classes"]);
31
+ function validateClassKey(key, readerName = "CjsGltfFormat") {
32
+ if (!CLASS_KEYS.includes(key)) {
33
+ throw new Error(`${readerName}: unknown class key ${JSON.stringify(key)}; expected one of ${CLASS_KEYS.join(", ")}`);
34
+ }
35
+ }
36
+ function validateClass(key, Class, readerName = "CjsGltfFormat") {
37
+ validateClassKey(key, readerName);
38
+ if (typeof Class !== "function") {
39
+ throw new TypeError(`${readerName}: class ${JSON.stringify(key)} must be a constructor`);
40
+ }
41
+ }
42
+ function mergeClasses(base, classes, readerName) {
43
+ if (!classes || typeof classes !== "object") {
44
+ throw new TypeError(`${readerName}: classes option must be an object`);
45
+ }
46
+ const next = {
47
+ ...base
48
+ };
49
+ for (const [key, Class] of Object.entries(classes)) {
50
+ if (Class === null || Class === undefined) {
51
+ delete next[key];
52
+ continue;
53
+ }
54
+ validateClass(key, Class, readerName);
55
+ next[key] = Class;
56
+ }
57
+ return next;
58
+ }
59
+ function validateRule(name, value, readerName) {
60
+ if (typeof value === "boolean" || typeof value === "function") return value;
61
+ throw new TypeError(`${readerName}: ${name} must be true, false, or a function`);
62
+ }
63
+ function normalizeUvHandedness(value, readerName) {
64
+ if (value === undefined || value === null) return DEFAULT_VALUES.uvHandedness;
65
+ if (value === "right" || value === 1 || value === "positive") return "right";
66
+ if (value === "left" || value === -1 || value === "negative") return "left";
67
+ throw new TypeError(`${readerName}: uvHandedness must be "right" or "left"`);
68
+ }
69
+ function normalizeValues(base, options = {}, readerName = "CjsGltfFormat") {
70
+ if (!options || typeof options !== "object") {
71
+ throw new TypeError(`${readerName}: options must be an object`);
72
+ }
73
+ for (const key of Object.keys(options)) {
74
+ if (!OPTION_KEYS.has(key)) {
75
+ throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
76
+ }
77
+ }
78
+ const values = {
79
+ ...base,
80
+ ...options
81
+ };
82
+ const emit = normalizeEmit(values.emit, readerName);
83
+ const classes = Object.prototype.hasOwnProperty.call(options, "classes") ? mergeClasses(base.classes || {}, options.classes, readerName) : {
84
+ ...(base.classes || {})
85
+ };
86
+ if ((emit === OUTPUT_GR2 || emit === OUTPUT_CMF) && !hasClasses(classes)) {
87
+ throw new TypeError(`${readerName}: emit "${emit}" requires explicit classes`);
88
+ }
89
+ if (typeof values.source !== "string" || !values.source) {
90
+ values.source = DEFAULT_VALUES.source;
91
+ }
92
+ return {
93
+ emit,
94
+ source: values.source,
95
+ buffers: values.buffers || null,
96
+ packTangents: validateRule("packTangents", values.packTangents, readerName),
97
+ uvHandedness: normalizeUvHandedness(values.uvHandedness, readerName),
98
+ rebuildMissingNormals: validateRule("rebuildMissingNormals", values.rebuildMissingNormals, readerName),
99
+ rebuildMissingTangents: validateRule("rebuildMissingTangents", values.rebuildMissingTangents, readerName),
100
+ rebuildMissingBiNormals: validateRule("rebuildMissingBiNormals", values.rebuildMissingBiNormals, readerName),
101
+ classes
102
+ };
103
+ }
104
+ function normalizeEmit(emit, readerName) {
105
+ if (emit === undefined || emit === null || emit === OUTPUT_JSON || emit === OUTPUT_GLTF_JSON || emit === OUTPUT_SHARED) {
106
+ return OUTPUT_GLTF_JSON;
107
+ }
108
+ if (emit === OUTPUT_GR2 || emit === OUTPUT_CMF) return emit;
109
+ throw new TypeError(`${readerName}: emit must be "${OUTPUT_SHARED}", "${OUTPUT_GLTF_JSON}", "${OUTPUT_GR2}", or "${OUTPUT_CMF}", got ${JSON.stringify(emit)}`);
110
+ }
111
+ function hasClasses(classes) {
112
+ return !!classes && Object.values(classes).some(Class => typeof Class === "function");
113
+ }
114
+ function hasVertexChannel(mesh, channel) {
115
+ const value = mesh && mesh.vertex && mesh.vertex[channel];
116
+ return !!value && value.length > 0;
117
+ }
118
+ function requireVertexChannel(mesh, meshIndex, channel, feature) {
119
+ const value = mesh && mesh.vertex && mesh.vertex[channel];
120
+ if (!value || value.length === 0) {
121
+ const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
122
+ throw new Error(`CjsGltfFormat: ${feature} requires mesh.vertex.${channel} for mesh ${name}`);
123
+ }
124
+ return value;
125
+ }
126
+ function triangleFaces(mesh, meshIndex, feature) {
127
+ const faces = [];
128
+ for (const group of mesh.indices || []) {
129
+ if (group && group.faces) faces.push(...group.faces);
130
+ }
131
+ if (faces.length === 0) {
132
+ const name = mesh && mesh.name ? JSON.stringify(mesh.name) : `#${meshIndex}`;
133
+ throw new Error(`CjsGltfFormat: ${feature} requires triangle indices for mesh ${name}`);
134
+ }
135
+ return faces;
136
+ }
137
+ function shouldApplyMeshRule(format, rule, context) {
138
+ if (typeof rule === "function") {
139
+ const result = rule({
140
+ format,
141
+ reader: format,
142
+ ...context
143
+ });
144
+ if (typeof result !== "boolean") {
145
+ throw new TypeError(`CjsGltfFormat: ${context.feature} rule must return true or false`);
146
+ }
147
+ return result;
148
+ }
149
+ return rule;
150
+ }
151
+ function vertexCount(mesh) {
152
+ return mesh.vertex.position.length / 3;
153
+ }
154
+ function tangentXyz(mesh) {
155
+ const tangent = requireVertexChannel(mesh, 0, "tangent", "tangent conversion"),
156
+ count = vertexCount(mesh),
157
+ width = tangent.length / count;
158
+ if (width === 3) return tangent.slice();
159
+ if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
160
+ const out = new Array(count * 3);
161
+ for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
162
+ out[o] = tangent[i];
163
+ out[o + 1] = tangent[i + 1];
164
+ out[o + 2] = tangent[i + 2];
165
+ }
166
+ return out;
167
+ }
168
+ function generatedBiNormalsForMesh(mesh, values) {
169
+ const normals = requireVertexChannel(mesh, 0, "normal", "binormal generation"),
170
+ tangent = requireVertexChannel(mesh, 0, "tangent", "binormal generation"),
171
+ count = vertexCount(mesh),
172
+ width = tangent.length / count;
173
+ if (width === 3) {
174
+ return generateBiNormals(normals, tangent, {
175
+ uvHandedness: values.uvHandedness
176
+ });
177
+ }
178
+ if (width !== 4) throw new Error("CjsGltfFormat: tangent channel must have 3 or 4 components per vertex");
179
+ const out = new Array(count * 3);
180
+ for (let i = 0, o = 0; i < tangent.length; i += 4, o += 3) {
181
+ const b = normalize([0, 0, 0], cross([0, 0, 0], [normals[o], normals[o + 1], normals[o + 2]], [tangent[i], tangent[i + 1], tangent[i + 2]]));
182
+ const sign = tangent[i + 3] < 0 ? -1 : 1;
183
+ out[o] = b[0] * sign;
184
+ out[o + 1] = b[1] * sign;
185
+ out[o + 2] = b[2] * sign;
186
+ }
187
+ return out;
188
+ }
189
+ function rebuildMissingMeshData(format, json, values) {
190
+ for (let meshIndex = 0; meshIndex < json.meshes.length; meshIndex++) {
191
+ const mesh = json.meshes[meshIndex],
192
+ common = {
193
+ options: values,
194
+ raw: null,
195
+ json,
196
+ mesh,
197
+ meshIndex
198
+ },
199
+ shouldPackTangents = shouldApplyMeshRule(format, values.packTangents, {
200
+ ...common,
201
+ feature: "packTangents",
202
+ channel: "tangent"
203
+ });
204
+ if (!hasVertexChannel(mesh, "normal") && (shouldApplyMeshRule(format, values.rebuildMissingNormals, {
205
+ ...common,
206
+ feature: "rebuildMissingNormals",
207
+ channel: "normal"
208
+ }) || shouldPackTangents)) {
209
+ mesh.vertex.normal = generateNormals(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingNormals"), triangleFaces(mesh, meshIndex, "rebuildMissingNormals"));
210
+ }
211
+ if (!hasVertexChannel(mesh, "tangent") && (shouldApplyMeshRule(format, values.rebuildMissingTangents, {
212
+ ...common,
213
+ feature: "rebuildMissingTangents",
214
+ channel: "tangent"
215
+ }) || shouldPackTangents)) {
216
+ mesh.vertex.tangent = generateTangents(requireVertexChannel(mesh, meshIndex, "position", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "normal", "rebuildMissingTangents"), requireVertexChannel(mesh, meshIndex, "texcoord0", "rebuildMissingTangents"), triangleFaces(mesh, meshIndex, "rebuildMissingTangents"));
217
+ }
218
+ if (!hasVertexChannel(mesh, "binormal") && (shouldApplyMeshRule(format, values.rebuildMissingBiNormals, {
219
+ ...common,
220
+ feature: "rebuildMissingBiNormals",
221
+ channel: "binormal"
222
+ }) || shouldPackTangents)) {
223
+ mesh.vertex.binormal = generatedBiNormalsForMesh(mesh, values);
224
+ }
225
+ if (shouldPackTangents) {
226
+ mesh.vertex.tangent = packTangentFrames(requireVertexChannel(mesh, meshIndex, "normal", "packTangents"), tangentXyz(mesh), requireVertexChannel(mesh, meshIndex, "binormal", "packTangents"));
227
+ mesh.vertex.normal = [];
228
+ mesh.vertex.binormal = [];
229
+ }
230
+ }
231
+ }
232
+ function readWithValues(format, input, values) {
233
+ const parsed = parseInput(input);
234
+ const json = parseGltfToJson(parsed.gltf, {
235
+ binaryChunk: parsed.binaryChunk,
236
+ source: values.source,
237
+ buffers: values.buffers
238
+ });
239
+ rebuildMissingMeshData(format, json, values);
240
+ if (values.emit === OUTPUT_CMF) return hydrateCmf(buildCmfFromShared(json), values.classes, {
241
+ source: values.source
242
+ });
243
+ return hydrateJson(json, {
244
+ classes: values.classes,
245
+ source: values.source
246
+ });
247
+ }
248
+ function inspectWithValues(input, values) {
249
+ const parsed = parseInput(input);
250
+ return inspectGltf(parsed.gltf, {
251
+ format: parsed.format,
252
+ source: values.source
253
+ });
254
+ }
255
+ function toJsonValue(value) {
256
+ if (value === null || value === undefined) return value;
257
+ if (typeof value !== "object") return value;
258
+ if (typeof value.toJSON === "function") {
259
+ const next = value.toJSON();
260
+ if (next !== value) return toJsonValue(next);
261
+ }
262
+ if (Array.isArray(value)) return value.map(toJsonValue);
263
+ if (ArrayBuffer.isView(value) && !(value instanceof DataView)) return Array.from(value);
264
+ const out = {};
265
+ for (const key of Object.keys(value)) {
266
+ out[key] = toJsonValue(value[key]);
267
+ }
268
+ return out;
269
+ }
270
+
271
+ /**
272
+ * Imports a Node built-in module without exposing the specifier to any
273
+ * bundler's static import graph.
274
+ *
275
+ * `await import("node:fs/promises")` written as a literal is resolved
276
+ * eagerly by webpack/Rollup/esbuild alike when they walk the module
277
+ * graph, breaking browser builds even though this path only ever runs
278
+ * under Node (readFile is a Node-only convenience). Building the
279
+ * specifier inside a `Function` body hides it from every bundler's
280
+ * static analysis - it only exists at runtime, in the Node process that
281
+ * actually calls readFile.
282
+ *
283
+ * @param {string} specifier Node built-in module specifier, e.g. "node:fs/promises".
284
+ * @returns {Promise<any>} The imported module namespace.
285
+ */
286
+ function importNodeModule(specifier) {
287
+ // eslint-disable-next-line no-new-func
288
+ return new Function("s", "return import(s)")(specifier);
289
+ }
290
+
291
+ export { CLASS_KEYS, DEFAULT_VALUES, OUTPUT_CMF, OUTPUT_GLTF_JSON, OUTPUT_GR2, OUTPUT_JSON, OUTPUT_SHARED, importNodeModule, inspectWithValues, normalizeValues, readWithValues, toJsonValue, validateClass, validateClassKey };
292
+ //# sourceMappingURL=helpers.js.map