@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.
Files changed (259) hide show
  1. package/LICENSE +21 -21
  2. package/NOTICE +29 -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 +59 -59
  9. package/dist/_virtual/_rollupPluginBabelHelpers.js +153 -153
  10. package/dist/format/CjsBlueReader.js +269 -269
  11. package/dist/format/CjsFormat.js +192 -192
  12. package/dist/format/CjsReader.js +18 -18
  13. package/dist/format/CjsResourceProbe.js +277 -277
  14. package/dist/format/payloadContract.js +173 -173
  15. package/dist/formats/black/CjsBlackFormat.js +278 -278
  16. package/dist/formats/black/core/CjsBlackBinaryReader.js +153 -153
  17. package/dist/formats/black/core/CjsBlackPropertyReaders.js +382 -382
  18. package/dist/formats/black/core/CjsBlackReader.js +639 -639
  19. package/dist/formats/black/core/CjsBlackSchemaRegistry.js +433 -433
  20. package/dist/formats/black/core/black-schema-v1-2026-07-11.json.js +4 -4
  21. package/dist/formats/black/core/blackConstants.js +7 -7
  22. package/dist/formats/black/core/blackDefinitions.js +10 -10
  23. package/dist/formats/black/core/blackEnums.js +6 -6
  24. package/dist/formats/black/core/blackSchema.js +3 -3
  25. package/dist/formats/black/core/blackVersion.js +22 -22
  26. package/dist/formats/black/core/helpers.js +182 -182
  27. package/dist/formats/black/core/schema.js +4 -4
  28. package/dist/formats/black/index.js +2 -2
  29. package/dist/formats/bnk/CjsBnkFormat.js +125 -125
  30. package/dist/formats/bnk/core/graph.js +140 -140
  31. package/dist/formats/bnk/core/helpers.js +409 -409
  32. package/dist/formats/bnk/core/musicNodes.js +489 -489
  33. package/dist/formats/bnk/core/soundbanksInfo.js +246 -246
  34. package/dist/formats/bnk/index.js +2 -2
  35. package/dist/formats/cmf/CjsCmfFormat.js +497 -497
  36. package/dist/formats/cmf/core/binary.js +118 -118
  37. package/dist/formats/cmf/core/buffers.js +233 -233
  38. package/dist/formats/cmf/core/constants.js +47 -47
  39. package/dist/formats/cmf/core/gr2Anim.js +453 -453
  40. package/dist/formats/cmf/core/helpers.js +287 -287
  41. package/dist/formats/cmf/core/pack.js +276 -276
  42. package/dist/formats/cmf/core/schema.js +364 -364
  43. package/dist/formats/cmf/core/shared.js +268 -268
  44. package/dist/formats/cmf/core/writer.js +517 -517
  45. package/dist/formats/cmf/index.js +2 -2
  46. package/dist/formats/dds/CjsDdsFormat.js +193 -193
  47. package/dist/formats/dds/core/bc6h.js +288 -288
  48. package/dist/formats/dds/core/bc7.js +251 -251
  49. package/dist/formats/dds/core/helpers.js +815 -815
  50. package/dist/formats/dds/index.js +2 -2
  51. package/dist/formats/fbx/CjsFbxFormat.js +266 -266
  52. package/dist/formats/fbx/core/helpers.js +3901 -3901
  53. package/dist/formats/fbx/index.js +2 -2
  54. package/dist/formats/flac/CjsFlacFormat.js +87 -87
  55. package/dist/formats/flac/core/helpers.js +295 -295
  56. package/dist/formats/flac/index.js +2 -2
  57. package/dist/formats/gif/CjsGifFormat.js +87 -87
  58. package/dist/formats/gif/core/helpers.js +360 -360
  59. package/dist/formats/gif/index.js +2 -2
  60. package/dist/formats/gltf/CjsGltfFormat.js +290 -290
  61. package/dist/formats/gltf/core/helpers.js +292 -292
  62. package/dist/formats/gltf/core/json.js +79 -79
  63. package/dist/formats/gltf/core/parser.js +666 -666
  64. package/dist/formats/gltf/core/targets.js +163 -163
  65. package/dist/formats/gltf/index.js +2 -2
  66. package/dist/formats/gr2/CjsGr2Format.js +46 -0
  67. package/dist/formats/gr2/CjsGr2Format.js.map +1 -0
  68. package/dist/formats/gr2/core/CjsFormatGr2.js +273 -0
  69. package/dist/formats/gr2/core/CjsFormatGr2.js.map +1 -0
  70. package/dist/formats/gr2/core/bitknit2.js +280 -0
  71. package/dist/formats/gr2/core/bitknit2.js.map +1 -0
  72. package/dist/formats/gr2/core/curves.js +1047 -0
  73. package/dist/formats/gr2/core/curves.js.map +1 -0
  74. package/dist/formats/gr2/core/gsf.js +72 -0
  75. package/dist/formats/gr2/core/gsf.js.map +1 -0
  76. package/dist/formats/gr2/core/helpers.js +332 -0
  77. package/dist/formats/gr2/core/helpers.js.map +1 -0
  78. package/dist/formats/gr2/core/json.js +622 -0
  79. package/dist/formats/gr2/core/json.js.map +1 -0
  80. package/dist/formats/gr2/core/oodle1.js +388 -0
  81. package/dist/formats/gr2/core/oodle1.js.map +1 -0
  82. package/dist/formats/gr2/core/reader.js +617 -0
  83. package/dist/formats/gr2/core/reader.js.map +1 -0
  84. package/dist/formats/gr2/core/tangents.js +48 -0
  85. package/dist/formats/gr2/core/tangents.js.map +1 -0
  86. package/dist/formats/gr2/core/targets.js +351 -0
  87. package/dist/formats/gr2/core/targets.js.map +1 -0
  88. package/dist/formats/gr2/index.js +3 -0
  89. package/dist/formats/gr2/index.js.map +1 -0
  90. package/dist/formats/index.js +30 -23
  91. package/dist/formats/index.js.map +1 -1
  92. package/dist/formats/jpeg/CjsJpegFormat.js +206 -206
  93. package/dist/formats/jpeg/core/helpers.js +350 -350
  94. package/dist/formats/jpeg/core/jpeg.js +377 -377
  95. package/dist/formats/jpeg/index.js +2 -2
  96. package/dist/formats/mp3/CjsMp3Format.js +192 -192
  97. package/dist/formats/mp3/core/helpers.js +338 -338
  98. package/dist/formats/mp3/index.js +2 -2
  99. package/dist/formats/mp4/CjsMp4Format.js +191 -191
  100. package/dist/formats/mp4/core/helpers.js +449 -449
  101. package/dist/formats/mp4/index.js +2 -2
  102. package/dist/formats/obj/CjsObjFormat.js +253 -253
  103. package/dist/formats/obj/core/helpers.js +573 -573
  104. package/dist/formats/obj/core/json.js +64 -64
  105. package/dist/formats/obj/core/parser.js +321 -321
  106. package/dist/formats/obj/index.js +2 -2
  107. package/dist/formats/ogg/CjsOggFormat.js +88 -88
  108. package/dist/formats/ogg/core/helpers.js +387 -387
  109. package/dist/formats/ogg/core/imdct.js +178 -178
  110. package/dist/formats/ogg/core/vorbis.js +999 -999
  111. package/dist/formats/ogg/index.js +2 -2
  112. package/dist/formats/png/CjsPngFormat.js +195 -195
  113. package/dist/formats/png/core/helpers.js +583 -583
  114. package/dist/formats/png/index.js +2 -2
  115. package/dist/formats/red/CjsRedFormat.js +261 -261
  116. package/dist/formats/red/core/CjsRedReader.js +194 -194
  117. package/dist/formats/red/core/blackDefinitions.js +3 -3
  118. package/dist/formats/red/core/helpers.js +139 -139
  119. package/dist/formats/red/core/redGraph.js +68 -68
  120. package/dist/formats/red/core/schema.js +4 -4
  121. package/dist/formats/red/index.js +2 -2
  122. package/dist/formats/stl/CjsStlFormat.js +365 -365
  123. package/dist/formats/stl/core/helpers.js +261 -261
  124. package/dist/formats/stl/core/json.js +51 -51
  125. package/dist/formats/stl/core/stl.js +629 -629
  126. package/dist/formats/stl/core/targets.js +163 -163
  127. package/dist/formats/stl/index.js +2 -2
  128. package/dist/formats/tga/CjsTgaFormat.js +192 -192
  129. package/dist/formats/tga/core/helpers.js +446 -446
  130. package/dist/formats/tga/index.js +2 -2
  131. package/dist/formats/wav/CjsWavFormat.js +192 -192
  132. package/dist/formats/wav/core/helpers.js +328 -328
  133. package/dist/formats/wav/index.js +2 -2
  134. package/dist/formats/webm/CjsWebmFormat.js +191 -191
  135. package/dist/formats/webm/core/helpers.js +537 -537
  136. package/dist/formats/webm/index.js +2 -2
  137. package/dist/formats/webp/CjsWebpFormat.js +86 -86
  138. package/dist/formats/webp/core/helpers.js +214 -214
  139. package/dist/formats/webp/index.js +2 -2
  140. package/dist/formats/wem/CjsWemFormat.js +241 -241
  141. package/dist/formats/wem/core/bitStream.js +259 -259
  142. package/dist/formats/wem/core/codebookLibrary.js +164 -164
  143. package/dist/formats/wem/core/helpers.js +417 -417
  144. package/dist/formats/wem/core/packedCodebooksAotuv603.js +30 -30
  145. package/dist/formats/wem/core/ptadpcm.js +77 -77
  146. package/dist/formats/wem/core/resolve.js +121 -121
  147. package/dist/formats/wem/core/wemToOgg.js +485 -485
  148. package/dist/formats/wem/index.js +2 -2
  149. package/dist/formats/yaml/CjsYamlFormat.js +83 -83
  150. package/dist/formats/yaml/core/CjsYamlReader.js +305 -305
  151. package/dist/formats/yaml/core/helpers.js +160 -160
  152. package/dist/formats/yaml/index.js +2 -2
  153. package/dist/index.js +49 -48
  154. package/dist/index.js.map +1 -1
  155. package/dist/resourcePath.js +18 -18
  156. package/dist/resourceStates.js +9 -9
  157. package/dist/resources/AudioGeometryResData.js +47 -47
  158. package/dist/resources/GStateBindingCallbackData.js +31 -31
  159. package/dist/resources/MeshDecalData.js +37 -37
  160. package/dist/resources/MeshDecalLodData.js +34 -34
  161. package/dist/resources/Tr2EffectRes.js +71 -71
  162. package/dist/resources/Tr2GrannyIntersectionResult.js +60 -60
  163. package/dist/resources/Tr2GrannyStateRes.js +44 -44
  164. package/dist/resources/Tr2ImageRes.js +114 -114
  165. package/dist/resources/Tr2LightProfileRes.js +40 -40
  166. package/dist/resources/Tr2MaterialArea.js +34 -34
  167. package/dist/resources/Tr2MaterialMesh.js +31 -31
  168. package/dist/resources/Tr2MaterialRes.js +34 -34
  169. package/dist/resources/Tr2ShaderPermutation.js +43 -43
  170. package/dist/resources/Tr2TextureLodManager.js +80 -80
  171. package/dist/resources/Tr2TextureLodUpdateRequest.js +37 -37
  172. package/dist/resources/Tr2TexturePackChannel.js +37 -37
  173. package/dist/resources/Tr2TexturePipeline.js +52 -52
  174. package/dist/resources/Tr2TexturePipelineParams.js +34 -34
  175. package/dist/resources/Tr2TexturePipelineStepCompress.js +40 -40
  176. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js +22 -0
  177. package/dist/resources/Tr2TexturePipelineStepGenerateMips.js.map +1 -0
  178. package/dist/resources/Tr2TexturePipelineStepLimitSize.js +34 -34
  179. package/dist/resources/Tr2TexturePipelineStepLoad.js +31 -31
  180. package/dist/resources/Tr2TexturePipelineStepPack.js +43 -43
  181. package/dist/resources/TriGeometryRes.js +239 -239
  182. package/dist/resources/TriGeometryResAreaData.js +59 -59
  183. package/dist/resources/TriGeometryResJointData.js +38 -38
  184. package/dist/resources/TriGeometryResLodData.js +88 -88
  185. package/dist/resources/TriGeometryResMeshData.js +63 -63
  186. package/dist/resources/TriGeometryResSkeletonData.js +34 -34
  187. package/dist/resources/TriGrannyRes.js +43 -43
  188. package/dist/resources/TriJointBinding.js +38 -38
  189. package/dist/resources/TriMorphTargetGeometryConstants.js +46 -46
  190. package/dist/resources/TriRtGeometryConstants.js +88 -88
  191. package/dist/resources/TriTextureRes.js +304 -304
  192. package/dist/resources/enums.js +18 -18
  193. package/dist/resources/resourceBoundary.js +47 -47
  194. package/dist/resources/texturePipelineBehavior.js +308 -308
  195. package/dist/texture/CjsTextureArrayRes.js +406 -406
  196. package/dist/texture/CjsTextureParameterProxy.js +133 -133
  197. package/docs/README.md +69 -0
  198. package/docs/architecture.md +86 -0
  199. package/docs/concepts/resource-lifecycle.md +217 -0
  200. package/docs/formats/README.md +104 -0
  201. package/{FORMAT-PROVENANCE.md → docs/formats/provenance.md} +173 -155
  202. package/docs/formats/stl.md +37 -0
  203. package/docs/formats/wwise.md +44 -0
  204. package/docs/reference/events.md +92 -0
  205. package/docs/reference/motherlode-cache.md +244 -0
  206. package/docs/reference/queues.md +102 -0
  207. package/docs/reference/reload.md +107 -0
  208. package/docs/reference/texture-arrays.md +113 -0
  209. package/docs/reference/texture-pipeline.md +53 -0
  210. package/docs/roadmap.md +104 -0
  211. package/format-notices/black/LICENSE +21 -21
  212. package/format-notices/black/NOTICE +47 -47
  213. package/format-notices/bnk/LICENSE +21 -21
  214. package/format-notices/bnk/NOTICE +20 -20
  215. package/format-notices/cmf/LICENSE +21 -21
  216. package/format-notices/cmf/NOTICE +36 -36
  217. package/format-notices/dds/LICENSE +21 -21
  218. package/format-notices/dds/NOTICE +14 -14
  219. package/format-notices/fbx/LICENSE +21 -21
  220. package/format-notices/fbx/NOTICE +14 -14
  221. package/format-notices/flac/LICENSE +21 -21
  222. package/format-notices/flac/NOTICE +14 -14
  223. package/format-notices/gif/LICENSE +21 -21
  224. package/format-notices/gif/NOTICE +14 -14
  225. package/format-notices/gltf/LICENSE +21 -21
  226. package/format-notices/gltf/NOTICE +27 -27
  227. package/format-notices/gr2/LICENSE +21 -0
  228. package/format-notices/gr2/NOTICE +60 -0
  229. package/format-notices/gr2/THIRD-PARTY-NOTICES.md +93 -0
  230. package/format-notices/jpeg/LICENSE +21 -21
  231. package/format-notices/jpeg/NOTICE +14 -14
  232. package/format-notices/mp3/LICENSE +21 -21
  233. package/format-notices/mp3/NOTICE +14 -14
  234. package/format-notices/mp4/LICENSE +21 -21
  235. package/format-notices/mp4/NOTICE +14 -14
  236. package/format-notices/obj/LICENSE +21 -21
  237. package/format-notices/obj/NOTICE +26 -26
  238. package/format-notices/ogg/LICENSE +21 -21
  239. package/format-notices/ogg/NOTICE +28 -28
  240. package/format-notices/png/LICENSE +21 -21
  241. package/format-notices/png/NOTICE +14 -14
  242. package/format-notices/red/LICENSE +21 -21
  243. package/format-notices/red/NOTICE +31 -31
  244. package/format-notices/stl/LICENSE +21 -21
  245. package/format-notices/stl/NOTICE +21 -21
  246. package/format-notices/tga/LICENSE +21 -21
  247. package/format-notices/tga/NOTICE +14 -14
  248. package/format-notices/wav/LICENSE +21 -21
  249. package/format-notices/wav/NOTICE +14 -14
  250. package/format-notices/webm/LICENSE +21 -21
  251. package/format-notices/webm/NOTICE +14 -14
  252. package/format-notices/webp/LICENSE +21 -21
  253. package/format-notices/webp/NOTICE +14 -14
  254. package/format-notices/wem/LICENSE +57 -57
  255. package/format-notices/wem/NOTICE +33 -33
  256. package/format-notices/yaml/LICENSE +21 -21
  257. package/format-notices/yaml/NOTICE +44 -44
  258. package/package.json +52 -51
  259. package/resource-lifecycle.md +0 -679
@@ -1,2 +1,2 @@
1
- export { CjsDdsFormat, CjsDdsFormat as default } from './CjsDdsFormat.js';
2
- //# sourceMappingURL=index.js.map
1
+ export { CjsDdsFormat, CjsDdsFormat as default } from './CjsDdsFormat.js';
2
+ //# sourceMappingURL=index.js.map
@@ -1,266 +1,266 @@
1
- import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, isFBX, toBytes, OUTPUT_FBX_JSON, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_GR2, OUTPUT_CMF, CLASS_KEYS } from './core/helpers.js';
2
-
3
- const FORMAT_NAME = "CjsFbxFormat";
4
-
5
- /**
6
- * CarbonEngineJS-facing FBX format surface.
7
- *
8
- * FBX is recognized and inspected in-browser. Basic static mesh GR2/CMF output
9
- * is available; full CarbonEngine-equivalent FBX import still follows the
10
- * cmfprocessor/ufbx importer behavior and needs more pure JS coverage.
11
- */
12
- class CjsFbxFormat {
13
- #values = DEFAULT_VALUES;
14
-
15
- /**
16
- * Create a reusable FBX format profile.
17
- *
18
- * @param {object} [options] Default read/inspect options.
19
- */
20
- constructor(options = {}) {
21
- this.SetValues(options);
22
- }
23
-
24
- /**
25
- * Merge options into this profile.
26
- *
27
- * @param {object} [options] Values to merge.
28
- * @returns {CjsFbxFormat} This format profile.
29
- */
30
- SetValues(options = {}) {
31
- this.#values = normalizeValues(this.#values, {
32
- inputType: "fbx",
33
- ...options
34
- }, FORMAT_NAME);
35
- return this;
36
- }
37
-
38
- /**
39
- * Get normalized profile values with optional per-call overrides.
40
- *
41
- * @param {object} [options] Per-call values.
42
- * @returns {object} Normalized read values.
43
- */
44
- GetValues(options = {}) {
45
- return normalizeValues(this.#values, {
46
- inputType: "fbx",
47
- ...options
48
- }, FORMAT_NAME);
49
- }
50
-
51
- /**
52
- * Set multiple output node constructors for this profile.
53
- *
54
- * These constructors are used only for explicit runtime output targets such
55
- * as `emit: "gr2"` and `emit: "cmf"` paths. Debug `fbxJson` output
56
- * remains plain data.
57
- *
58
- * @param {object} [classes] Map of output node class keys to constructors.
59
- * @returns {CjsFbxFormat} This format profile.
60
- */
61
- SetClasses(classes = {}) {
62
- return this.SetValues({
63
- classes
64
- });
65
- }
66
-
67
- /**
68
- * Set one output node constructor for this profile.
69
- *
70
- * @param {string} type Output node class key.
71
- * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
72
- * @returns {CjsFbxFormat} This format profile.
73
- */
74
- SetClass(type, Class) {
75
- validateClassKey(type, FORMAT_NAME);
76
- if (Class === null || Class === undefined) {
77
- const classes = {
78
- ...this.#values.classes
79
- };
80
- delete classes[type];
81
- this.#values = {
82
- ...this.#values,
83
- classes
84
- };
85
- return this;
86
- }
87
- validateClass(type, Class, FORMAT_NAME);
88
- return this.SetValues({
89
- classes: {
90
- [type]: Class
91
- }
92
- });
93
- }
94
-
95
- /**
96
- * Get a configured output node constructor.
97
- *
98
- * @param {string} type Output node class key.
99
- * @returns {Function|undefined} The registered constructor, if any.
100
- */
101
- GetClass(type) {
102
- validateClassKey(type, FORMAT_NAME);
103
- return this.#values.classes[type];
104
- }
105
-
106
- /**
107
- * Whether this profile has a constructor registered for an output node key.
108
- *
109
- * @param {string} type Output node class key.
110
- * @returns {boolean} True when a constructor is registered.
111
- */
112
- HasClass(type) {
113
- return !!this.GetClass(type);
114
- }
115
-
116
- /**
117
- * Read FBX bytes with this profile.
118
- *
119
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
120
- * @param {object} [options] Per-call values.
121
- * @returns {object} Raw or debug payload for the selected emit target.
122
- */
123
- Read(input, options = {}) {
124
- return readWithValues(input, this.GetValues(options));
125
- }
126
-
127
- /**
128
- * Read FBX bytes asynchronously with this profile.
129
- *
130
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
131
- * @param {object} [options] Per-call values.
132
- * @returns {Promise<object>} Raw or debug payload for the selected emit target.
133
- */
134
- async ReadAsync(input, options = {}) {
135
- return this.Read(input, options);
136
- }
137
-
138
- /**
139
- * Inspect FBX bytes without converting geometry.
140
- *
141
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
142
- * @param {object} [options] Per-call values.
143
- * @returns {object} Lightweight FBX metadata.
144
- */
145
- Inspect(input, options = {}) {
146
- return inspectWithValues(input, this.GetValues(options));
147
- }
148
-
149
- /**
150
- * Report whether this package supports the input and requested variants.
151
- *
152
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
153
- * @param {object} [options] Per-call values.
154
- * @returns {object} Support/probe report.
155
- */
156
- IsSupported(input, options = {}) {
157
- return isSupportedWithValues(input, this.GetValues(options));
158
- }
159
-
160
- /**
161
- * Convert format output into JSON-compatible debug data.
162
- *
163
- * @param {any} value Format output.
164
- * @returns {any} JSON-compatible value.
165
- */
166
- ToJSON(value) {
167
- return toJsonValue(value);
168
- }
169
-
170
- /**
171
- * One-shot FBX read.
172
- *
173
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
174
- * @param {object} [options] Read options.
175
- * @returns {object} Raw or debug payload for the selected emit target.
176
- */
177
- static read(input, options = {}) {
178
- return readWithValues(input, normalizeValues(DEFAULT_VALUES, {
179
- inputType: "fbx",
180
- ...options
181
- }, FORMAT_NAME));
182
- }
183
-
184
- /**
185
- * One-shot asynchronous FBX read.
186
- *
187
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
188
- * @param {object} [options] Read options.
189
- * @returns {Promise<object>} Raw or debug payload for the selected emit target.
190
- */
191
- static async readAsync(input, options = {}) {
192
- return CjsFbxFormat.read(input, options);
193
- }
194
-
195
- /**
196
- * One-shot FBX inspection.
197
- *
198
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
199
- * @param {object} [options] Inspect options.
200
- * @returns {object} Lightweight FBX metadata.
201
- */
202
- static inspect(input, options = {}) {
203
- return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, {
204
- inputType: "fbx",
205
- ...options
206
- }, FORMAT_NAME));
207
- }
208
-
209
- /**
210
- * One-shot FBX support probe.
211
- *
212
- * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
213
- * @param {object} [options] Probe options.
214
- * @returns {object} Support/probe report.
215
- */
216
- static isSupported(input, options = {}) {
217
- return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, {
218
- inputType: "fbx",
219
- ...options
220
- }, FORMAT_NAME));
221
- }
222
-
223
- /**
224
- * Convert format output into JSON-compatible debug data.
225
- *
226
- * @param {any} value Format output.
227
- * @returns {any} JSON-compatible value.
228
- */
229
- static toJSON(value) {
230
- return toJsonValue(value);
231
- }
232
-
233
- /**
234
- * Test whether bytes look like an FBX file.
235
- *
236
- * @param {Uint8Array|ArrayBuffer|DataView} input Candidate FBX bytes.
237
- * @returns {boolean} True when the input appears to be FBX.
238
- */
239
- static isFBX(input) {
240
- try {
241
- return isFBX(toBytes(input));
242
- } catch {
243
- return false;
244
- }
245
- }
246
-
247
- /**
248
- * Emit targets for this format (canonical frozen enum).
249
- */
250
- static Output = Object.freeze({
251
- CMF: OUTPUT_CMF,
252
- GR2: OUTPUT_GR2,
253
- RAW: OUTPUT_RAW,
254
- JSON: OUTPUT_JSON,
255
- FBX_JSON: OUTPUT_FBX_JSON
256
- });
257
- static CLASS_KEYS = CLASS_KEYS;
258
- static type = Object.freeze(["geometry"]);
259
- static mediaTypes = Object.freeze(["geometry"]);
260
- static inputTypes = Object.freeze(["fbx"]);
261
- static outputTypes = Object.freeze([OUTPUT_GR2, OUTPUT_CMF]);
262
- static debugOutputTypes = Object.freeze([OUTPUT_FBX_JSON, OUTPUT_RAW]);
263
- }
264
-
265
- export { CjsFbxFormat, CjsFbxFormat as default };
266
- //# sourceMappingURL=CjsFbxFormat.js.map
1
+ import { DEFAULT_VALUES, normalizeValues, validateClassKey, validateClass, readWithValues, inspectWithValues, isSupportedWithValues, toJsonValue, isFBX, toBytes, OUTPUT_FBX_JSON, OUTPUT_JSON, OUTPUT_RAW, OUTPUT_GR2, OUTPUT_CMF, CLASS_KEYS } from './core/helpers.js';
2
+
3
+ const FORMAT_NAME = "CjsFbxFormat";
4
+
5
+ /**
6
+ * CarbonEngineJS-facing FBX format surface.
7
+ *
8
+ * FBX is recognized and inspected in-browser. Basic static mesh GR2/CMF output
9
+ * is available; full CarbonEngine-equivalent FBX import still follows the
10
+ * cmfprocessor/ufbx importer behavior and needs more pure JS coverage.
11
+ */
12
+ class CjsFbxFormat {
13
+ #values = DEFAULT_VALUES;
14
+
15
+ /**
16
+ * Create a reusable FBX format profile.
17
+ *
18
+ * @param {object} [options] Default read/inspect options.
19
+ */
20
+ constructor(options = {}) {
21
+ this.SetValues(options);
22
+ }
23
+
24
+ /**
25
+ * Merge options into this profile.
26
+ *
27
+ * @param {object} [options] Values to merge.
28
+ * @returns {CjsFbxFormat} This format profile.
29
+ */
30
+ SetValues(options = {}) {
31
+ this.#values = normalizeValues(this.#values, {
32
+ inputType: "fbx",
33
+ ...options
34
+ }, FORMAT_NAME);
35
+ return this;
36
+ }
37
+
38
+ /**
39
+ * Get normalized profile values with optional per-call overrides.
40
+ *
41
+ * @param {object} [options] Per-call values.
42
+ * @returns {object} Normalized read values.
43
+ */
44
+ GetValues(options = {}) {
45
+ return normalizeValues(this.#values, {
46
+ inputType: "fbx",
47
+ ...options
48
+ }, FORMAT_NAME);
49
+ }
50
+
51
+ /**
52
+ * Set multiple output node constructors for this profile.
53
+ *
54
+ * These constructors are used only for explicit runtime output targets such
55
+ * as `emit: "gr2"` and `emit: "cmf"` paths. Debug `fbxJson` output
56
+ * remains plain data.
57
+ *
58
+ * @param {object} [classes] Map of output node class keys to constructors.
59
+ * @returns {CjsFbxFormat} This format profile.
60
+ */
61
+ SetClasses(classes = {}) {
62
+ return this.SetValues({
63
+ classes
64
+ });
65
+ }
66
+
67
+ /**
68
+ * Set one output node constructor for this profile.
69
+ *
70
+ * @param {string} type Output node class key.
71
+ * @param {Function|null|undefined} Class Constructor to use, or nullish to delete.
72
+ * @returns {CjsFbxFormat} This format profile.
73
+ */
74
+ SetClass(type, Class) {
75
+ validateClassKey(type, FORMAT_NAME);
76
+ if (Class === null || Class === undefined) {
77
+ const classes = {
78
+ ...this.#values.classes
79
+ };
80
+ delete classes[type];
81
+ this.#values = {
82
+ ...this.#values,
83
+ classes
84
+ };
85
+ return this;
86
+ }
87
+ validateClass(type, Class, FORMAT_NAME);
88
+ return this.SetValues({
89
+ classes: {
90
+ [type]: Class
91
+ }
92
+ });
93
+ }
94
+
95
+ /**
96
+ * Get a configured output node constructor.
97
+ *
98
+ * @param {string} type Output node class key.
99
+ * @returns {Function|undefined} The registered constructor, if any.
100
+ */
101
+ GetClass(type) {
102
+ validateClassKey(type, FORMAT_NAME);
103
+ return this.#values.classes[type];
104
+ }
105
+
106
+ /**
107
+ * Whether this profile has a constructor registered for an output node key.
108
+ *
109
+ * @param {string} type Output node class key.
110
+ * @returns {boolean} True when a constructor is registered.
111
+ */
112
+ HasClass(type) {
113
+ return !!this.GetClass(type);
114
+ }
115
+
116
+ /**
117
+ * Read FBX bytes with this profile.
118
+ *
119
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
120
+ * @param {object} [options] Per-call values.
121
+ * @returns {object} Raw or debug payload for the selected emit target.
122
+ */
123
+ Read(input, options = {}) {
124
+ return readWithValues(input, this.GetValues(options));
125
+ }
126
+
127
+ /**
128
+ * Read FBX bytes asynchronously with this profile.
129
+ *
130
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
131
+ * @param {object} [options] Per-call values.
132
+ * @returns {Promise<object>} Raw or debug payload for the selected emit target.
133
+ */
134
+ async ReadAsync(input, options = {}) {
135
+ return this.Read(input, options);
136
+ }
137
+
138
+ /**
139
+ * Inspect FBX bytes without converting geometry.
140
+ *
141
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
142
+ * @param {object} [options] Per-call values.
143
+ * @returns {object} Lightweight FBX metadata.
144
+ */
145
+ Inspect(input, options = {}) {
146
+ return inspectWithValues(input, this.GetValues(options));
147
+ }
148
+
149
+ /**
150
+ * Report whether this package supports the input and requested variants.
151
+ *
152
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
153
+ * @param {object} [options] Per-call values.
154
+ * @returns {object} Support/probe report.
155
+ */
156
+ IsSupported(input, options = {}) {
157
+ return isSupportedWithValues(input, this.GetValues(options));
158
+ }
159
+
160
+ /**
161
+ * Convert format output into JSON-compatible debug data.
162
+ *
163
+ * @param {any} value Format output.
164
+ * @returns {any} JSON-compatible value.
165
+ */
166
+ ToJSON(value) {
167
+ return toJsonValue(value);
168
+ }
169
+
170
+ /**
171
+ * One-shot FBX read.
172
+ *
173
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
174
+ * @param {object} [options] Read options.
175
+ * @returns {object} Raw or debug payload for the selected emit target.
176
+ */
177
+ static read(input, options = {}) {
178
+ return readWithValues(input, normalizeValues(DEFAULT_VALUES, {
179
+ inputType: "fbx",
180
+ ...options
181
+ }, FORMAT_NAME));
182
+ }
183
+
184
+ /**
185
+ * One-shot asynchronous FBX read.
186
+ *
187
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
188
+ * @param {object} [options] Read options.
189
+ * @returns {Promise<object>} Raw or debug payload for the selected emit target.
190
+ */
191
+ static async readAsync(input, options = {}) {
192
+ return CjsFbxFormat.read(input, options);
193
+ }
194
+
195
+ /**
196
+ * One-shot FBX inspection.
197
+ *
198
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
199
+ * @param {object} [options] Inspect options.
200
+ * @returns {object} Lightweight FBX metadata.
201
+ */
202
+ static inspect(input, options = {}) {
203
+ return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, {
204
+ inputType: "fbx",
205
+ ...options
206
+ }, FORMAT_NAME));
207
+ }
208
+
209
+ /**
210
+ * One-shot FBX support probe.
211
+ *
212
+ * @param {Uint8Array|ArrayBuffer|DataView} input FBX bytes.
213
+ * @param {object} [options] Probe options.
214
+ * @returns {object} Support/probe report.
215
+ */
216
+ static isSupported(input, options = {}) {
217
+ return isSupportedWithValues(input, normalizeValues(DEFAULT_VALUES, {
218
+ inputType: "fbx",
219
+ ...options
220
+ }, FORMAT_NAME));
221
+ }
222
+
223
+ /**
224
+ * Convert format output into JSON-compatible debug data.
225
+ *
226
+ * @param {any} value Format output.
227
+ * @returns {any} JSON-compatible value.
228
+ */
229
+ static toJSON(value) {
230
+ return toJsonValue(value);
231
+ }
232
+
233
+ /**
234
+ * Test whether bytes look like an FBX file.
235
+ *
236
+ * @param {Uint8Array|ArrayBuffer|DataView} input Candidate FBX bytes.
237
+ * @returns {boolean} True when the input appears to be FBX.
238
+ */
239
+ static isFBX(input) {
240
+ try {
241
+ return isFBX(toBytes(input));
242
+ } catch {
243
+ return false;
244
+ }
245
+ }
246
+
247
+ /**
248
+ * Emit targets for this format (canonical frozen enum).
249
+ */
250
+ static Output = Object.freeze({
251
+ CMF: OUTPUT_CMF,
252
+ GR2: OUTPUT_GR2,
253
+ RAW: OUTPUT_RAW,
254
+ JSON: OUTPUT_JSON,
255
+ FBX_JSON: OUTPUT_FBX_JSON
256
+ });
257
+ static CLASS_KEYS = CLASS_KEYS;
258
+ static type = Object.freeze(["geometry"]);
259
+ static mediaTypes = Object.freeze(["geometry"]);
260
+ static inputTypes = Object.freeze(["fbx"]);
261
+ static outputTypes = Object.freeze([OUTPUT_GR2, OUTPUT_CMF]);
262
+ static debugOutputTypes = Object.freeze([OUTPUT_FBX_JSON, OUTPUT_RAW]);
263
+ }
264
+
265
+ export { CjsFbxFormat, CjsFbxFormat as default };
266
+ //# sourceMappingURL=CjsFbxFormat.js.map