@nova-lab/core 1.0.0-dev.19 → 1.1.0-dev.229

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 (501) hide show
  1. package/README.md +1035 -10
  2. package/THIRD_PARTY_NOTICES.md +26 -0
  3. package/dist/2d/accessibility.d.ts +2 -0
  4. package/dist/2d/accessibility.js +171 -0
  5. package/dist/2d/commands.d.ts +2 -0
  6. package/dist/2d/commands.js +80 -0
  7. package/dist/2d/effects.d.ts +10 -0
  8. package/dist/2d/effects.js +566 -0
  9. package/dist/2d/ktx2.d.ts +5 -0
  10. package/dist/2d/ktx2.js +542 -0
  11. package/dist/2d/lighting.d.ts +3 -0
  12. package/dist/2d/lighting.js +495 -0
  13. package/dist/2d/lottie.d.ts +3 -0
  14. package/dist/2d/lottie.js +254 -0
  15. package/dist/2d/meshes.d.ts +4 -0
  16. package/dist/2d/meshes.js +451 -0
  17. package/dist/2d/primitives.d.ts +3 -0
  18. package/dist/2d/primitives.js +85 -0
  19. package/dist/2d/render-textures.d.ts +3 -0
  20. package/dist/2d/render-textures.js +539 -0
  21. package/dist/2d/svg/documents.d.ts +5 -0
  22. package/dist/2d/svg/documents.js +7 -0
  23. package/dist/2d/svg/renderer.d.ts +3 -0
  24. package/dist/2d/svg/renderer.js +222 -0
  25. package/dist/2d/svg.d.ts +3 -0
  26. package/dist/2d/svg.js +4 -0
  27. package/dist/2d/tools.d.ts +2 -0
  28. package/dist/2d/tools.js +100 -0
  29. package/dist/2d/video.d.ts +5 -0
  30. package/dist/2d/video.js +90 -0
  31. package/dist/2d.d.ts +2 -0
  32. package/dist/2d.js +220 -0
  33. package/dist/3d/animation.d.ts +8 -0
  34. package/dist/3d/animation.js +1396 -0
  35. package/dist/3d/area-lights.d.ts +2 -0
  36. package/dist/3d/area-lights.js +19 -0
  37. package/dist/3d/audio.d.ts +4 -0
  38. package/dist/3d/audio.js +500 -0
  39. package/dist/3d/character.d.ts +2 -0
  40. package/dist/3d/character.js +136 -0
  41. package/dist/3d/collision.d.ts +3 -0
  42. package/dist/3d/collision.js +387 -0
  43. package/dist/3d/commands.d.ts +2 -0
  44. package/dist/3d/commands.js +108 -0
  45. package/dist/3d/controls.d.ts +8 -0
  46. package/dist/3d/controls.js +1041 -0
  47. package/dist/3d/documents.d.ts +5 -0
  48. package/dist/3d/documents.js +227 -0
  49. package/dist/3d/effects.d.ts +5 -0
  50. package/dist/3d/effects.js +1986 -0
  51. package/dist/3d/export.d.ts +4 -0
  52. package/dist/3d/export.js +347 -0
  53. package/dist/3d/fbx.d.ts +2 -0
  54. package/dist/3d/fbx.js +784 -0
  55. package/dist/3d/gltf.d.ts +2 -0
  56. package/dist/3d/gltf.js +5 -0
  57. package/dist/3d/helpers.d.ts +5 -0
  58. package/dist/3d/helpers.js +191 -0
  59. package/dist/3d/ik.d.ts +9 -0
  60. package/dist/3d/ik.js +777 -0
  61. package/dist/3d/loaders.d.ts +17 -0
  62. package/dist/3d/loaders.js +1406 -0
  63. package/dist/3d/nodes.d.ts +8 -0
  64. package/dist/3d/nodes.js +49 -0
  65. package/dist/3d/particles.d.ts +5 -0
  66. package/dist/3d/particles.js +1574 -0
  67. package/dist/3d/physics/backend.d.ts +7 -0
  68. package/dist/3d/physics/backend.js +1 -0
  69. package/dist/3d/physics/rapier.d.ts +3 -0
  70. package/dist/3d/physics/rapier.js +765 -0
  71. package/dist/3d/physics.d.ts +5 -0
  72. package/dist/3d/physics.js +3346 -0
  73. package/dist/3d/splats.d.ts +7 -0
  74. package/dist/3d/splats.js +862 -0
  75. package/dist/3d/text.d.ts +5 -0
  76. package/dist/3d/text.js +1043 -0
  77. package/dist/3d/tiles.d.ts +24 -0
  78. package/dist/3d/tiles.js +1705 -0
  79. package/dist/3d/tools.d.ts +12 -0
  80. package/dist/3d/tools.js +338 -0
  81. package/dist/3d/usdz.d.ts +2 -0
  82. package/dist/3d/usdz.js +634 -0
  83. package/dist/3d/xr.d.ts +2 -0
  84. package/dist/3d/xr.js +202 -0
  85. package/dist/3d-B4jWF8Qb.js +5591 -0
  86. package/dist/3d.d.ts +40 -0
  87. package/dist/3d.js +44 -0
  88. package/dist/Capsule-BFVpZfvc.js +44 -0
  89. package/dist/Clip-CAN7t03k.js +204 -0
  90. package/dist/Color-vuv9UnoY.js +34 -0
  91. package/dist/DeformedMesh-CPi0P_vc.js +280 -0
  92. package/dist/Document-DCVEZSvM.js +415 -0
  93. package/dist/Errors-B2ekO9bZ.js +30 -0
  94. package/dist/Features-BsjmePtc.js +557 -0
  95. package/dist/GLTFResourceIO-CYJyCUTt.js +124 -0
  96. package/dist/GPUParticleState-CQlNpoDa.js +545 -0
  97. package/dist/Geometry-DytO490z.js +227 -0
  98. package/dist/Inflate-DWw0V-Up.js +42 -0
  99. package/dist/InstancedMesh-DPrgrw5z.js +527 -0
  100. package/dist/Limits-Bw5XQdFr.js +20 -0
  101. package/dist/LineHelper-Ad0z9uDi.js +131 -0
  102. package/dist/LoaderIO-BwrM84OM.js +114 -0
  103. package/dist/Material-BpfLPmK9.js +777 -0
  104. package/dist/Mesh-BaRxAAJq.js +209 -0
  105. package/dist/Node-QfgAE2_v.js +877 -0
  106. package/dist/NovaAssetRegistry-p2QlCwvT.js +1168 -0
  107. package/dist/NovaNode-CBZ-Ol-W.js +2016 -0
  108. package/dist/NovaRenderCommandWriter-CWQRa42y.js +1949 -0
  109. package/dist/NovaTextSelectionService-CipuujCT.js +18526 -0
  110. package/dist/NovaWebGLProgram-BO250QNF.js +97 -0
  111. package/dist/Options-CajE7LLJ.js +15 -0
  112. package/dist/PolygonMesh-D4PnnfIo.js +657 -0
  113. package/dist/Ready-BzyhRtjD.js +21 -0
  114. package/dist/Scene-CDfNgf9I.js +911 -0
  115. package/dist/Shader-b6_HDndT.js +48 -0
  116. package/dist/SplatShader-wJ6GJ3vo.js +130 -0
  117. package/dist/Texture-dTKMlTpK.js +267 -0
  118. package/dist/TextureLoader-CfDzdy2m.js +411 -0
  119. package/dist/Textures-CGL4Kf-8.js +651 -0
  120. package/dist/ToneMapping-D9IWvN0u.js +46 -0
  121. package/dist/WebGPURenderer-DjD0IxVC.js +4921 -0
  122. package/dist/ZipReader-C-MSEsSr.js +84 -0
  123. package/dist/core.js +218 -24024
  124. package/dist/domain/types/base.types.d.ts +18 -9
  125. package/dist/domain/types/component.types.d.ts +5 -5
  126. package/dist/domain/types/cursor.types.d.ts +1 -1
  127. package/dist/domain/types/diagnostics.types.d.ts +2 -0
  128. package/dist/domain/types/export.types.d.ts +2 -2
  129. package/dist/domain/types/hit-test.types.d.ts +1 -1
  130. package/dist/domain/types/motion.types.d.ts +2 -2
  131. package/dist/domain/types/renderer.types.d.ts +88 -4
  132. package/dist/domain/types/rendering/index.d.ts +29 -4
  133. package/dist/domain/types/sound.types.d.ts +1 -1
  134. package/dist/domain/types/theme.types.d.ts +1 -1
  135. package/dist/domain/utils/bounds.d.ts +1 -1
  136. package/dist/domain/utils/nova-text.d.ts +9 -0
  137. package/dist/domain/utils/schemaBounds.d.ts +2 -2
  138. package/dist/export-svg-document-ChaNXMaG.js +668 -0
  139. package/dist/features/3d/Errors.d.ts +57 -0
  140. package/dist/features/3d/Nova3DApp.d.ts +429 -0
  141. package/dist/features/3d/animation/Animator.d.ts +260 -0
  142. package/dist/features/3d/animation/Clip.d.ts +74 -0
  143. package/dist/features/3d/animation/Graph.d.ts +158 -0
  144. package/dist/features/3d/animation/Mask.d.ts +40 -0
  145. package/dist/features/3d/audio/Audio.d.ts +114 -0
  146. package/dist/features/3d/audio/Sound.d.ts +133 -0
  147. package/dist/features/3d/character/CharacterController.d.ts +61 -0
  148. package/dist/features/3d/collision/Capsule.d.ts +25 -0
  149. package/dist/features/3d/collision/Octree.d.ts +94 -0
  150. package/dist/features/3d/controls/CameraMotionControls.d.ts +154 -0
  151. package/dist/features/3d/controls/CameraOrientation.d.ts +47 -0
  152. package/dist/features/3d/controls/OrbitControls.d.ts +73 -0
  153. package/dist/features/3d/controls/PointerGesture.d.ts +25 -0
  154. package/dist/features/3d/controls/PointerLock.d.ts +36 -0
  155. package/dist/features/3d/controls/Snapping.d.ts +32 -0
  156. package/dist/features/3d/controls/TransformGizmo.d.ts +79 -0
  157. package/dist/features/3d/deformation/DeformationGPU.d.ts +52 -0
  158. package/dist/features/3d/deformation/DeformationShader.d.ts +2 -0
  159. package/dist/features/3d/deformation/DeformedMesh.d.ts +36 -0
  160. package/dist/features/3d/deformation/GeometryDeformation.d.ts +25 -0
  161. package/dist/features/3d/documents/Document.d.ts +59 -0
  162. package/dist/features/3d/documents/DocumentCommands.d.ts +45 -0
  163. package/dist/features/3d/documents/DocumentSchema.d.ts +18 -0
  164. package/dist/features/3d/documents/DocumentTransform.d.ts +4 -0
  165. package/dist/features/3d/documents/DocumentTypes.d.ts +182 -0
  166. package/dist/features/3d/documents/DocumentValidation.d.ts +18 -0
  167. package/dist/features/3d/documents/Projection.d.ts +65 -0
  168. package/dist/features/3d/effects/CubeLUT.d.ts +24 -0
  169. package/dist/features/3d/effects/Effects.d.ts +32 -0
  170. package/dist/features/3d/effects/EffectsGPU.d.ts +80 -0
  171. package/dist/features/3d/effects/EffectsPlan.d.ts +268 -0
  172. package/dist/features/3d/effects/EffectsShaders.d.ts +35 -0
  173. package/dist/features/3d/export/GLTFExporter.d.ts +49 -0
  174. package/dist/features/3d/export/ThreeMFExporter.d.ts +19 -0
  175. package/dist/features/3d/export/ZipWriter.d.ts +9 -0
  176. package/dist/features/3d/fbx/FBXLoader.d.ts +26 -0
  177. package/dist/features/3d/fbx/FBXParser.d.ts +35 -0
  178. package/dist/features/3d/fbx/FBXScene.d.ts +20 -0
  179. package/dist/features/3d/gltf/GLTFLoader.d.ts +16 -0
  180. package/dist/features/3d/gltf/GLTFTypes.d.ts +64 -0
  181. package/dist/features/3d/gltf/services/GLTFBinary.d.ts +21 -0
  182. package/dist/features/3d/gltf/services/GLTFGeometry.d.ts +14 -0
  183. package/dist/features/3d/gltf/services/GLTFResourceIO.d.ts +64 -0
  184. package/dist/features/3d/helpers/LineHelper.d.ts +51 -0
  185. package/dist/features/3d/helpers/StaticHelpers.d.ts +47 -0
  186. package/dist/features/3d/helpers/TrackedHelpers.d.ts +84 -0
  187. package/dist/features/3d/ik/ChainIK.d.ts +44 -0
  188. package/dist/features/3d/ik/IKChain.d.ts +92 -0
  189. package/dist/features/3d/ik/IKMath.d.ts +49 -0
  190. package/dist/features/3d/ik/IKSolver.d.ts +97 -0
  191. package/dist/features/3d/ik/LookAtIK.d.ts +58 -0
  192. package/dist/features/3d/ik/TwoBoneIK.d.ts +57 -0
  193. package/dist/features/3d/import/ImportAnimation.d.ts +20 -0
  194. package/dist/features/3d/import/ImportMath.d.ts +42 -0
  195. package/dist/features/3d/import/ImportedModel.d.ts +135 -0
  196. package/dist/features/3d/import/Inflate.d.ts +5 -0
  197. package/dist/features/3d/import/ModelAsset.d.ts +149 -0
  198. package/dist/features/3d/import/PolygonMesh.d.ts +54 -0
  199. package/dist/features/3d/lights/AreaLightTables.d.ts +8 -0
  200. package/dist/features/3d/lights/AreaLights.d.ts +11 -0
  201. package/dist/features/3d/loaders/EXRCompression.d.ts +13 -0
  202. package/dist/features/3d/loaders/EXRLoader.d.ts +39 -0
  203. package/dist/features/3d/loaders/HDRLoader.d.ts +26 -0
  204. package/dist/features/3d/loaders/Limits.d.ts +70 -0
  205. package/dist/features/3d/loaders/LoaderBuffers.d.ts +42 -0
  206. package/dist/features/3d/loaders/LoaderIO.d.ts +81 -0
  207. package/dist/features/3d/loaders/LoaderModel.d.ts +80 -0
  208. package/dist/features/3d/loaders/LoaderText.d.ts +27 -0
  209. package/dist/features/3d/loaders/MTLLoader.d.ts +105 -0
  210. package/dist/features/3d/loaders/OBJLoader.d.ts +70 -0
  211. package/dist/features/3d/loaders/PLYLoader.d.ts +47 -0
  212. package/dist/features/3d/loaders/STLLoader.d.ts +27 -0
  213. package/dist/features/3d/model/Camera.d.ts +33 -0
  214. package/dist/features/3d/model/Environment.d.ts +31 -0
  215. package/dist/features/3d/model/Geometry.d.ts +59 -0
  216. package/dist/features/3d/model/InstancedMesh.d.ts +134 -0
  217. package/dist/features/3d/model/LOD.d.ts +31 -0
  218. package/dist/features/3d/model/Light.d.ts +200 -0
  219. package/dist/features/3d/model/Material.d.ts +308 -0
  220. package/dist/features/3d/model/MaterialExtensions.d.ts +200 -0
  221. package/dist/features/3d/model/Mesh.d.ts +92 -0
  222. package/dist/features/3d/model/Node.d.ts +87 -0
  223. package/dist/features/3d/model/ReflectionProbe.d.ts +45 -0
  224. package/dist/features/3d/model/RenderTarget.d.ts +41 -0
  225. package/dist/features/3d/model/Scene.d.ts +173 -0
  226. package/dist/features/3d/model/Texture.d.ts +143 -0
  227. package/dist/features/3d/nodes/Nodes.d.ts +8 -0
  228. package/dist/features/3d/nodes/ShaderNode.d.ts +240 -0
  229. package/dist/features/3d/particles/GPUParticleSchedule.d.ts +67 -0
  230. package/dist/features/3d/particles/GPUParticleShaders.d.ts +19 -0
  231. package/dist/features/3d/particles/GPUParticleState.d.ts +106 -0
  232. package/dist/features/3d/particles/GPUParticleSystem.d.ts +192 -0
  233. package/dist/features/3d/particles/ParticleCurves.d.ts +34 -0
  234. package/dist/features/3d/particles/ParticleOptions.d.ts +78 -0
  235. package/dist/features/3d/particles/ParticleSystem.d.ts +368 -0
  236. package/dist/features/3d/physics/PhysicsBackend.d.ts +352 -0
  237. package/dist/features/3d/physics/PhysicsDebug.d.ts +24 -0
  238. package/dist/features/3d/physics/PhysicsWorld.d.ts +352 -0
  239. package/dist/features/3d/physics/basic/BasicCollision.d.ts +75 -0
  240. package/dist/features/3d/physics/basic/BasicPhysics.d.ts +24 -0
  241. package/dist/features/3d/physics/basic/BasicShapes.d.ts +103 -0
  242. package/dist/features/3d/physics/rapier/ContactBuffer.d.ts +32 -0
  243. package/dist/features/3d/physics/rapier/RapierBackend.d.ts +17 -0
  244. package/dist/features/3d/physics/rapier/RapierShapes.d.ts +4 -0
  245. package/dist/features/3d/physics/rapier/RapierWorld.d.ts +198 -0
  246. package/dist/features/3d/physics/rapier/Validation.d.ts +8 -0
  247. package/dist/features/3d/services/Background.d.ts +22 -0
  248. package/dist/features/3d/services/BasicShader.d.ts +55 -0
  249. package/dist/features/3d/services/ClusteredLights.d.ts +69 -0
  250. package/dist/features/3d/services/DrawOrder.d.ts +37 -0
  251. package/dist/features/3d/services/EffectsProcessor.d.ts +38 -0
  252. package/dist/features/3d/services/EnvironmentBRDF.d.ts +35 -0
  253. package/dist/features/3d/services/EnvironmentMaps.d.ts +55 -0
  254. package/dist/features/3d/services/FogShader.d.ts +6 -0
  255. package/dist/features/3d/services/Frustum.d.ts +7 -0
  256. package/dist/features/3d/services/GLState.d.ts +86 -0
  257. package/dist/features/3d/services/GPUPicker.d.ts +31 -0
  258. package/dist/features/3d/services/InstanceShader.d.ts +3 -0
  259. package/dist/features/3d/services/LineProgram.d.ts +32 -0
  260. package/dist/features/3d/services/PBRProgram.d.ts +115 -0
  261. package/dist/features/3d/services/Renderer.d.ts +50 -0
  262. package/dist/features/3d/services/Shader.d.ts +22 -0
  263. package/dist/features/3d/services/ShaderProgram.d.ts +38 -0
  264. package/dist/features/3d/services/ShadowMaps.d.ts +97 -0
  265. package/dist/features/3d/services/SpatialIndex.d.ts +16 -0
  266. package/dist/features/3d/services/TextureLoader.d.ts +40 -0
  267. package/dist/features/3d/services/TextureMipmaps.d.ts +42 -0
  268. package/dist/features/3d/services/ToneMapping.d.ts +12 -0
  269. package/dist/features/3d/services/WebGLRenderer.d.ts +261 -0
  270. package/dist/features/3d/splats/SplatData.d.ts +136 -0
  271. package/dist/features/3d/splats/SplatLoaders.d.ts +64 -0
  272. package/dist/features/3d/splats/SplatShader.d.ts +14 -0
  273. package/dist/features/3d/splats/SplatSort.d.ts +69 -0
  274. package/dist/features/3d/splats/Splats.d.ts +116 -0
  275. package/dist/features/3d/text/FontAtlas.d.ts +246 -0
  276. package/dist/features/3d/text/SDF.d.ts +28 -0
  277. package/dist/features/3d/text/Text.d.ts +179 -0
  278. package/dist/features/3d/text/TextLayout.d.ts +73 -0
  279. package/dist/features/3d/text/TextShader.d.ts +12 -0
  280. package/dist/features/3d/tiles/BoundingVolume.d.ts +43 -0
  281. package/dist/features/3d/tiles/Geodesy.d.ts +106 -0
  282. package/dist/features/3d/tiles/GlobeControls.d.ts +147 -0
  283. package/dist/features/3d/tiles/TileContent.d.ts +35 -0
  284. package/dist/features/3d/tiles/TileFormats.d.ts +77 -0
  285. package/dist/features/3d/tiles/Tiles3D.d.ts +236 -0
  286. package/dist/features/3d/tiles/Tileset.d.ts +81 -0
  287. package/dist/features/3d/tools/BatchedMesh.d.ts +74 -0
  288. package/dist/features/3d/tools/CanvasSurface.d.ts +81 -0
  289. package/dist/features/3d/tools/Color.d.ts +11 -0
  290. package/dist/features/3d/tools/MergeGeometries.d.ts +22 -0
  291. package/dist/features/3d/tools/Options.d.ts +15 -0
  292. package/dist/features/3d/tools/Polyhedra.d.ts +30 -0
  293. package/dist/features/3d/tools/PrimitiveBuffers.d.ts +42 -0
  294. package/dist/features/3d/tools/Primitives.d.ts +164 -0
  295. package/dist/features/3d/tools/Ready.d.ts +12 -0
  296. package/dist/features/3d/tools/SpatialMath.d.ts +57 -0
  297. package/dist/features/3d/tools/SphericalHarmonics.d.ts +9 -0
  298. package/dist/features/3d/tools/math/mat3.d.ts +7 -0
  299. package/dist/features/3d/tools/math/mat4.d.ts +19 -0
  300. package/dist/features/3d/tools/math/quat.d.ts +6 -0
  301. package/dist/features/3d/tools/math/vec3.d.ts +16 -0
  302. package/dist/features/3d/tools/math/vec4.d.ts +5 -0
  303. package/dist/features/3d/types.d.ts +359 -0
  304. package/dist/features/3d/usdz/USDAParser.d.ts +50 -0
  305. package/dist/features/3d/usdz/USDScene.d.ts +20 -0
  306. package/dist/features/3d/usdz/USDZLoader.d.ts +27 -0
  307. package/dist/features/3d/usdz/ZipReader.d.ts +16 -0
  308. package/dist/features/3d/webgpu/Backend.d.ts +40 -0
  309. package/dist/features/3d/webgpu/BasicShader.d.ts +10 -0
  310. package/dist/features/3d/webgpu/Constants.d.ts +32 -0
  311. package/dist/features/3d/webgpu/Deformation.d.ts +71 -0
  312. package/dist/features/3d/webgpu/Environment.d.ts +66 -0
  313. package/dist/features/3d/webgpu/Features.d.ts +68 -0
  314. package/dist/features/3d/webgpu/Layouts.d.ts +27 -0
  315. package/dist/features/3d/webgpu/Lines.d.ts +40 -0
  316. package/dist/features/3d/webgpu/LitExtras.d.ts +46 -0
  317. package/dist/features/3d/webgpu/LitFeatures.d.ts +41 -0
  318. package/dist/features/3d/webgpu/LitScene.d.ts +60 -0
  319. package/dist/features/3d/webgpu/LitShader.d.ts +68 -0
  320. package/dist/features/3d/webgpu/Particles.d.ts +114 -0
  321. package/dist/features/3d/webgpu/Picking.d.ts +59 -0
  322. package/dist/features/3d/webgpu/PipelineKey.d.ts +33 -0
  323. package/dist/features/3d/webgpu/Points.d.ts +41 -0
  324. package/dist/features/3d/webgpu/Probes.d.ts +45 -0
  325. package/dist/features/3d/webgpu/ShaderChunks.d.ts +18 -0
  326. package/dist/features/3d/webgpu/ShaderMaterial.d.ts +57 -0
  327. package/dist/features/3d/webgpu/ShaderMaterialSource.d.ts +5 -0
  328. package/dist/features/3d/webgpu/Shadows.d.ts +49 -0
  329. package/dist/features/3d/webgpu/Splats.d.ts +47 -0
  330. package/dist/features/3d/webgpu/Textures.d.ts +52 -0
  331. package/dist/features/3d/webgpu/Transmission.d.ts +30 -0
  332. package/dist/features/3d/webgpu/UniformLayout.d.ts +30 -0
  333. package/dist/features/3d/webgpu/UtilityShaders.d.ts +38 -0
  334. package/dist/features/3d/webgpu/WebGPURenderer.d.ts +327 -0
  335. package/dist/features/3d/webgpu/effects/EffectsShaders.d.ts +74 -0
  336. package/dist/features/3d/webgpu/effects/WebGPUEffects.d.ts +140 -0
  337. package/dist/features/3d/xr/XR.d.ts +100 -0
  338. package/dist/gltf-By-n0qEg.js +960 -0
  339. package/dist/index.d.ts +86 -81
  340. package/dist/model/document-actions/document-commands.d.ts +18 -0
  341. package/dist/model/documents/svg/create-svg-document-renderer.d.ts +32 -0
  342. package/dist/model/documents/svg/export-svg-document.d.ts +5 -0
  343. package/dist/model/documents/svg/import-svg-document.d.ts +6 -0
  344. package/dist/model/documents/svg/svg-document.types.d.ts +111 -0
  345. package/dist/model/documents/svg/svg-values.d.ts +16 -0
  346. package/dist/model/documents/svg/svg-xml.d.ts +18 -0
  347. package/dist/model/input/NovaInputProxy_Adapter.d.ts +2 -1
  348. package/dist/model/input/NovaInputValidationController.d.ts +1 -1
  349. package/dist/model/input/NovaTextInputController.d.ts +1 -1
  350. package/dist/model/input/NovaTextLayoutEngine.d.ts +2 -6
  351. package/dist/model/input/index.d.ts +7 -7
  352. package/dist/model/input/nova-input.types.d.ts +1 -1
  353. package/dist/model/lighting/LightingRenderer2D.d.ts +58 -0
  354. package/dist/model/lighting/NovaLighting2D.d.ts +56 -0
  355. package/dist/model/lighting/lighting-shaders.d.ts +3 -0
  356. package/dist/model/lighting/lighting-state.d.ts +27 -0
  357. package/dist/model/lighting/lighting.types.d.ts +107 -0
  358. package/dist/model/lottie/LottieNode.d.ts +4 -0
  359. package/dist/model/lottie/lottie.types.d.ts +83 -0
  360. package/dist/model/lottie/prepare-lottie.d.ts +3 -0
  361. package/dist/model/lottie/sample-position.d.ts +9 -0
  362. package/dist/model/motion/NovaMotionEngine.d.ts +3 -3
  363. package/dist/model/motion/nova-motion-easing.d.ts +1 -1
  364. package/dist/model/motion/nova-motion-interpolation.d.ts +1 -1
  365. package/dist/model/motion/nova-motion-presets.d.ts +2 -2
  366. package/dist/model/motion/nova-motion-timeline.d.ts +1 -1
  367. package/dist/model/platform/NovaCanvas.d.ts +7 -6
  368. package/dist/model/primitives/NovaPrimitiveUnsupportedError.d.ts +13 -0
  369. package/dist/model/primitives/definePrimitive.d.ts +5 -0
  370. package/dist/model/primitives/primitive.types.d.ts +28 -0
  371. package/dist/model/render/backends/canvas2d/NovaCanvas2DTargetManager.d.ts +3 -3
  372. package/dist/model/render/backends/canvas2d/NovaRenderer2D.d.ts +61 -15
  373. package/dist/model/render/backends/canvas2d/nova-canvas-blend.d.ts +5 -0
  374. package/dist/model/render/backends/nova-render-backend-factory.d.ts +6 -6
  375. package/dist/model/render/backends/nova-render-backend.d.ts +8 -2
  376. package/dist/model/render/backends/webgl/NovaRendererWebGL.d.ts +32 -11
  377. package/dist/model/render/backends/webgl/NovaStreamCacheIdleLedger.d.ts +12 -1
  378. package/dist/model/render/backends/webgl/NovaWebGLBatcher.d.ts +1 -1
  379. package/dist/model/render/backends/webgl/NovaWebGLCircleImagePass.d.ts +23 -0
  380. package/dist/model/render/backends/webgl/NovaWebGLCompositionPass.d.ts +9 -0
  381. package/dist/model/render/backends/webgl/NovaWebGLDevice.d.ts +3 -1
  382. package/dist/model/render/backends/webgl/NovaWebGLDiagnostics.d.ts +1 -1
  383. package/dist/model/render/backends/webgl/NovaWebGLFrameRenderer.d.ts +162 -53
  384. package/dist/model/render/backends/webgl/NovaWebGLPathClipPass.d.ts +13 -0
  385. package/dist/model/render/backends/webgl/NovaWebGLPathUnion.d.ts +23 -0
  386. package/dist/model/render/compiler/NovaRenderBuilder.d.ts +24 -10
  387. package/dist/model/render/compiler/NovaRenderCommandWriter.d.ts +10 -5
  388. package/dist/model/render/compiler/NovaRenderCompiler.d.ts +7 -6
  389. package/dist/model/render/compiler/NovaRenderFrameBuilder.d.ts +4 -3
  390. package/dist/model/render/effects/blur.d.ts +8 -0
  391. package/dist/model/render/effects/color-matrix.d.ts +8 -0
  392. package/dist/model/render/effects/drop-shadow.d.ts +18 -0
  393. package/dist/model/render/effects/nova-effect-registry.d.ts +66 -0
  394. package/dist/model/render/effects/nova-gaussian-kernel.d.ts +7 -0
  395. package/dist/model/render/effects/nova-gaussian-textures.d.ts +11 -0
  396. package/dist/model/render/effects/shader-effect.d.ts +64 -0
  397. package/dist/model/render/geometry/nova-alpha-mask.d.ts +5 -0
  398. package/dist/model/render/geometry/nova-composition.d.ts +9 -0
  399. package/dist/model/render/geometry/nova-node-clip.d.ts +17 -0
  400. package/dist/model/render/geometry/nova-path-geometry.d.ts +24 -0
  401. package/dist/model/render/geometry/nova-path-tessellation.d.ts +7 -0
  402. package/dist/model/render/geometry/nova-polygon-triangulation.d.ts +1 -1
  403. package/dist/model/render/graph/NovaRectBatchBuffer.d.ts +58 -0
  404. package/dist/model/render/graph/NovaRenderGraph.d.ts +40 -6
  405. package/dist/model/render/graph/NovaRenderHitIndex.d.ts +1 -1
  406. package/dist/model/render/graph/nova-auto-rect.d.ts +1 -1
  407. package/dist/model/render/graph/nova-linear-rect-repack.d.ts +4 -4
  408. package/dist/model/render/graph/nova-linear-rect-transition.d.ts +2 -2
  409. package/dist/model/render/graph/nova-render-culling.d.ts +2 -2
  410. package/dist/model/render/graph/nova-render-dirty-items.d.ts +1 -1
  411. package/dist/model/render/graph/nova-render-group.d.ts +1 -1
  412. package/dist/model/render/graph/nova-render-item.d.ts +2 -2
  413. package/dist/model/render/graph/nova-render-layer.d.ts +1 -1
  414. package/dist/model/render/graph/nova-render-payload-snapshot.d.ts +3 -1
  415. package/dist/model/render/graph/nova-render-program.d.ts +5 -3
  416. package/dist/model/render/graph/nova-render-sequence.d.ts +1 -1
  417. package/dist/model/render/graph/nova-render-stream.d.ts +2 -2
  418. package/dist/model/render/ktx2/BasisSession.d.ts +45 -0
  419. package/dist/model/render/ktx2/KTX2Container.d.ts +26 -0
  420. package/dist/model/render/ktx2/KTX2Loader.d.ts +55 -0
  421. package/dist/model/render/meshes/MeshNode.d.ts +13 -0
  422. package/dist/model/render/meshes/NovaMeshWebGLDevice.d.ts +27 -0
  423. package/dist/model/render/meshes/geometry.d.ts +7 -0
  424. package/dist/model/render/meshes/mesh.d.ts +3 -0
  425. package/dist/model/render/meshes/mesh.types.d.ts +116 -0
  426. package/dist/model/render/meshes/nova-mesh-registry.d.ts +55 -0
  427. package/dist/model/render/orchestration/NovaRenderOrchestrator.d.ts +25 -3
  428. package/dist/model/render/policy/nova-render-policy.d.ts +1 -1
  429. package/dist/model/render/resources/NovaGlyphAtlasManager.d.ts +2 -2
  430. package/dist/model/render/resources/NovaTextAtlasManager.d.ts +3 -3
  431. package/dist/model/render/resources/NovaTextLayoutEngine.d.ts +1 -1
  432. package/dist/model/render/resources/nova-bitmap-upload.d.ts +10 -0
  433. package/dist/model/render/schema/NovaRenderContext.d.ts +6 -4
  434. package/dist/model/render/schema/nova-style-compiler.d.ts +5 -2
  435. package/dist/model/render/targets/NovaNodeRenderTextureSource.d.ts +29 -0
  436. package/dist/model/render/targets/NovaRenderTargetManager.d.ts +1 -1
  437. package/dist/model/render/targets/NovaRenderTexture.d.ts +57 -0
  438. package/dist/model/render/targets/nova-render-target-refs.d.ts +5 -0
  439. package/dist/model/render/targets/nova-render-target-resource.d.ts +1 -1
  440. package/dist/model/render/targets/nova-render-texture-runtime.d.ts +71 -0
  441. package/dist/model/render/textures/nova-compressed-image.d.ts +20 -0
  442. package/dist/model/render/utils/nova-icon-rendering.d.ts +3 -1
  443. package/dist/model/render/utils/nova-image-geometry.d.ts +11 -0
  444. package/dist/model/render/utils/nova-markdown-layout.d.ts +19 -0
  445. package/dist/model/render/utils/nova-text-paint.d.ts +26 -0
  446. package/dist/model/render/utils/nova-wrapped-text-layout.d.ts +19 -0
  447. package/dist/model/runtime/app/Nova.d.ts +35 -35
  448. package/dist/model/runtime/app/NovaApp.d.ts +58 -30
  449. package/dist/model/runtime/app/NovaRaphRuntime.d.ts +2 -2
  450. package/dist/model/runtime/app/createNovaRaphRuntime.d.ts +3 -3
  451. package/dist/model/runtime/assets/NovaAssetRegistry.d.ts +89 -2
  452. package/dist/model/runtime/assets/NovaVideoTexture.d.ts +38 -0
  453. package/dist/model/runtime/assets/nova-render-texture-image-identity.d.ts +4 -0
  454. package/dist/model/runtime/commands/NovaCommandBus.d.ts +1 -1
  455. package/dist/model/runtime/components/NovaComponentNode.d.ts +6 -6
  456. package/dist/model/runtime/components/NovaComponentRegistry.d.ts +1 -1
  457. package/dist/model/runtime/components/NovaSchemaRegistry.d.ts +7 -6
  458. package/dist/model/runtime/components/nova-component-metadata.d.ts +1 -1
  459. package/dist/model/runtime/components/nova-component.decorator.d.ts +2 -2
  460. package/dist/model/runtime/components/nova-defined-component.d.ts +3 -3
  461. package/dist/model/runtime/context/nova-context.d.ts +1 -1
  462. package/dist/model/runtime/cursor/NovaCursorManager.d.ts +3 -3
  463. package/dist/model/runtime/diagnostics/NovaDiagnostics_Module.d.ts +3 -3
  464. package/dist/model/runtime/interaction/NovaEvents.d.ts +16 -6
  465. package/dist/model/runtime/interaction/NovaHitIndex.d.ts +1 -1
  466. package/dist/model/runtime/interaction/NovaSpatialIndex.d.ts +2 -2
  467. package/dist/model/runtime/scene/NovaScene.d.ts +3 -3
  468. package/dist/model/runtime/scene/nova-scene-components.d.ts +6 -6
  469. package/dist/model/runtime/state/nova-store-decorators.d.ts +1 -1
  470. package/dist/model/runtime/state/nova-store-runtime.d.ts +1 -1
  471. package/dist/model/runtime/state/nova-store-tracking.d.ts +7 -3
  472. package/dist/model/runtime/sync/NovaSyncScope.d.ts +11 -2
  473. package/dist/model/runtime/sync/nova-sync-context.d.ts +2 -2
  474. package/dist/model/runtime/sync/nova-sync-ports.d.ts +2 -2
  475. package/dist/model/runtime/sync/nova-sync.types.d.ts +15 -3
  476. package/dist/model/runtime/template/NovaTemplateRuntime.d.ts +6 -6
  477. package/dist/model/runtime/tree/NovaContainer.d.ts +4 -4
  478. package/dist/model/runtime/tree/NovaNode.d.ts +58 -18
  479. package/dist/model/runtime/tree/NovaRaphNode.d.ts +8 -2
  480. package/dist/model/runtime/tree/NovaSurface.d.ts +32 -10
  481. package/dist/model/runtime/tree/nova-node-capture-invalidation.d.ts +11 -0
  482. package/dist/model/semantic/NovaSemanticService.d.ts +1 -1
  483. package/dist/model/semantic/browser/createAccessibilityBridge.d.ts +29 -0
  484. package/dist/model/sound/NovaSoundEngine.d.ts +3 -2
  485. package/dist/model/text-selection/NovaTextSelectionService.d.ts +2 -2
  486. package/dist/model/text-selection/index.d.ts +2 -2
  487. package/dist/model/text-selection/nova-text-selection.types.d.ts +1 -1
  488. package/dist/model/theme/NovaGlobalThemeRegistry.d.ts +2 -2
  489. package/dist/model/theme/NovaThemeService.d.ts +5 -3
  490. package/dist/model/theme/createTokenTheme.d.ts +15 -0
  491. package/dist/model/tools/transform-tools.d.ts +43 -0
  492. package/dist/nodes--Ds4IS2h.js +621 -0
  493. package/dist/nova-color-parser-BCN_rFRN.js +250 -0
  494. package/dist/nova-compressed-image-CE2Ya9Xa.js +46 -0
  495. package/dist/nova-mesh-registry-B7Xz5mhU.js +24 -0
  496. package/dist/nova-render-texture-image-identity-DQ09XFKs.js +15 -0
  497. package/dist/nova-text-paint-CcntsRjI.js +48 -0
  498. package/dist/tokens.d.ts +2 -0
  499. package/dist/tokens.js +50 -0
  500. package/dist/vec4-BTNv1fUp.js +20 -0
  501. package/package.json +223 -4
@@ -0,0 +1,80 @@
1
+ import { Nova3DMesh } from '../model/Mesh.js';
2
+ import { EffectsFrame3D, EffectsProcessor3D } from '../services/EffectsProcessor.js';
3
+ import { EffectsPlan3D } from './EffectsPlan.js';
4
+ /** Generation-owned GPU block of every effect stage, created only by its addon. */
5
+ export declare class EffectsGPU3D implements EffectsProcessor3D {
6
+ private readonly _gl;
7
+ private _plan;
8
+ private readonly _targets;
9
+ private readonly _programs;
10
+ private _bytes;
11
+ private _basePerPixel;
12
+ private _depthPerPixel;
13
+ private _baseColors;
14
+ /** Advances on configure and on target size changes; static uniforms follow it. */
15
+ private _version;
16
+ private _width;
17
+ private _height;
18
+ /** Plan and base bytes the resident targets were last validated for at `_width`×`_height`. */
19
+ private _layoutPlan?;
20
+ private _layoutBase;
21
+ /** Scene colour texture whose sampler was switched to linear filtering. */
22
+ private _linearSource?;
23
+ private _cameraStamp;
24
+ private readonly _inverseProjection;
25
+ /** Motion blur: view-projection of the previous presented frame. */
26
+ private readonly _previous;
27
+ private _previousStamp;
28
+ private readonly _reprojection;
29
+ private _grainFrame;
30
+ private _selection;
31
+ /** Projection of the current camera, a view of the renderer's frame record. */
32
+ private _projection;
33
+ /** Output of the most recent pass into an effect target. */
34
+ private _last;
35
+ /** TAA: jitter sample index, history parity, previous unjittered view-projection. */
36
+ private _jitterIndex;
37
+ private readonly _jitter;
38
+ private _historyParity;
39
+ private _historyValid;
40
+ private readonly _taaPrevious;
41
+ private readonly _taaReprojection;
42
+ constructor(_gl: WebGL2RenderingContext, _plan: EffectsPlan3D);
43
+ get bytes(): number;
44
+ get depth(): boolean;
45
+ /** Sub-pixel projection offset for the next frame (device pixels), or null without TAA. */
46
+ jitter(): Float32Array | null;
47
+ validateSize(width: number, height: number, baseBytes: number, baseColors: number, depthBytes: number): void;
48
+ configure(plan: EffectsPlan3D): void;
49
+ /** Replaces the outline selection; the array is owned by the caller's copy. */
50
+ select(meshes: readonly Nova3DMesh[]): void;
51
+ present(source: WebGLTexture, width: number, height: number, display: (source: WebGLTexture, output: WebGLFramebuffer | null) => void, frame: EffectsFrame3D): number;
52
+ reset(discard: boolean): void;
53
+ /** Linear ping-pong target that does not hold `current`. */
54
+ private _next;
55
+ private _baseBytes;
56
+ private _common;
57
+ private _program;
58
+ private _u;
59
+ /** Binds the output and program; returns true when static uniforms must be written. */
60
+ private _begin;
61
+ private _bind;
62
+ private _draw;
63
+ /** Writes inverse size and inverse projection, shared by the depth helpers. */
64
+ private _depthUniforms;
65
+ private _ssao;
66
+ private _ssr;
67
+ private _dof;
68
+ private _taa;
69
+ /** Updates the reprojection; false when the camera did not move since the last frame. */
70
+ private _motion;
71
+ private _motionBlur;
72
+ private _bloom;
73
+ private _outline;
74
+ private _finish;
75
+ private _fxaa;
76
+ private _smaa;
77
+ private _releaseStale;
78
+ private _ensureTargets;
79
+ private _release;
80
+ }
@@ -0,0 +1,268 @@
1
+ import { Nova3DTexture } from '../model/Texture.js';
2
+ import { Color3D } from '../types.js';
3
+ /**
4
+ * Screen-space ambient occlusion from scene depth (SAO-style spiral estimate,
5
+ * normals reconstructed from depth, bilateral blur). Darkens the linear colour.
6
+ * @experimental
7
+ */
8
+ export interface SSAOStage3D {
9
+ type: 'ssao';
10
+ /** World-space sampling radius, (0, 100]. Default 0.5. */
11
+ radius?: number;
12
+ /** Occlusion strength, [0, 8]. Default 1. */
13
+ intensity?: number;
14
+ /** World-space bias against self-occlusion, [0, 10]. Default 0.025. */
15
+ bias?: number;
16
+ /** Samples per pixel, integer 4..32. Default 16. */
17
+ samples?: number;
18
+ }
19
+ /**
20
+ * Screen-space reflections from depth and reconstructed normals. Without a
21
+ * G-buffer every surface reflects with the same `intensity`.
22
+ * @experimental
23
+ */
24
+ export interface SSRStage3D {
25
+ type: 'ssr';
26
+ /** World-space ray length, (0, 1000]. Default 10. */
27
+ maxDistance?: number;
28
+ /** World-space depth tolerance of a hit, (0, 100]. Default 0.2. */
29
+ thickness?: number;
30
+ /** Ray-march steps, integer 8..128. Default 32. */
31
+ steps?: number;
32
+ /** Reflection mix, [0, 1]. Default 0.5. */
33
+ intensity?: number;
34
+ /** Screen-edge fade width as a fraction of the view, [0, 0.5]. Default 0.1. */
35
+ edgeFade?: number;
36
+ }
37
+ /**
38
+ * Thin-lens depth of field with a single-pass gather bokeh.
39
+ * @experimental
40
+ */
41
+ export interface DOFStage3D {
42
+ type: 'dof';
43
+ /** World-space distance of the focal plane (1 unit = 1 m), (0, 1e6]. Required. */
44
+ focusDistance: number;
45
+ /** Lens focal length in millimetres, [1, 1000]. Default 50. */
46
+ focalLength?: number;
47
+ /** Aperture f-number, [0.5, 64]. Default 2.8. */
48
+ fStop?: number;
49
+ /** Largest blur radius as a fraction of the view height, [0, 0.05]. Default 0.01. */
50
+ maxBlur?: number;
51
+ /** Gather samples, integer 8..64. Default 32. */
52
+ samples?: number;
53
+ }
54
+ /**
55
+ * Camera motion blur: reprojects depth with the previous frame's
56
+ * view-projection. Frames without camera motion skip the pass.
57
+ * @experimental
58
+ */
59
+ export interface MotionBlurStage3D {
60
+ type: 'motion-blur';
61
+ /** Fraction of the frame motion to smear, [0, 4]. Default 1. */
62
+ intensity?: number;
63
+ /** Samples along the motion, integer 2..32. Default 8. */
64
+ samples?: number;
65
+ }
66
+ /**
67
+ * Temporal antialiasing (three.js TAARenderPass, Babylon TAA, PlayCanvas TAA): the
68
+ * projection is jittered by a Halton(2, 3) sequence and each frame blends with the
69
+ * depth-reprojected history clamped to the current 3×3 neighbourhood. It converges
70
+ * while frames keep coming, so run the app loop.
71
+ * @experimental
72
+ */
73
+ export interface TAAStage3D {
74
+ type: 'taa';
75
+ /** History weight, [0, 0.98]. Default 0.9. */
76
+ feedback?: number;
77
+ }
78
+ /** @experimental */
79
+ export interface BloomStage3D {
80
+ type: 'bloom';
81
+ threshold?: number;
82
+ strength?: number;
83
+ }
84
+ /**
85
+ * Outline of the meshes passed to `Nova3DEffects.setOutlineSelection`. Parts of
86
+ * a selected mesh hidden behind other surfaces use `hiddenColor`.
87
+ * @experimental
88
+ */
89
+ export interface OutlineStage3D {
90
+ type: 'outline';
91
+ /** sRGB colour of visible edges; alpha is their opacity. Default ≈ #ffcb59 (linear [1, 0.6, 0.1]). */
92
+ color?: Color3D;
93
+ /** sRGB colour of hidden edges; alpha is their opacity. Default ≈ #593827 (linear [0.1, 0.04, 0.02]). */
94
+ hiddenColor?: Color3D;
95
+ /** Edge width in device pixels, integer 1..8. Default 2. */
96
+ thickness?: number;
97
+ }
98
+ /**
99
+ * 3D colour lookup table for the finish pass; see `parseCubeLUT`.
100
+ * @experimental
101
+ */
102
+ export interface FinishLUT3D {
103
+ /** A cubic `dimension: '3d'` texture with linear colour space and linear filtering. */
104
+ texture: Nova3DTexture;
105
+ /** Mix of graded and source colour, [0, 1]. Default 1. */
106
+ intensity?: number;
107
+ /** Input domain of the table. Defaults [0, 0, 0] and [1, 1, 1]. */
108
+ domainMin?: readonly [number, number, number];
109
+ domainMax?: readonly [number, number, number];
110
+ }
111
+ /**
112
+ * Darkens the frame towards its edges.
113
+ * @experimental
114
+ */
115
+ export interface FinishVignette3D {
116
+ /** [0, 1]. Default 0.5. */
117
+ intensity?: number;
118
+ /** Distance from the centre (1 = edge midpoint) where darkening starts, [0, 2]. Default 0.75. */
119
+ radius?: number;
120
+ /** Width of the falloff, (0, 2]. Default 0.5. */
121
+ softness?: number;
122
+ /** Display-referred sRGB colour the edges fade to; alpha is ignored. Default black. */
123
+ color?: Color3D;
124
+ }
125
+ /**
126
+ * One fused display pass: tone mapping and sRGB encoding with chromatic
127
+ * aberration, CAS sharpening, 3D LUT grading, vignette and film grain.
128
+ * It replaces the plain display conversion.
129
+ * @experimental
130
+ */
131
+ export interface FinishStage3D {
132
+ type: 'finish';
133
+ /** Radial channel offset at the corners as a fraction of the view, [0, 0.05]. Default 0. */
134
+ chromaticAberration?: number;
135
+ /** Contrast-adaptive sharpening, [0, 1]. Default 0 (off). */
136
+ sharpen?: number;
137
+ /** Animated film grain amplitude in display values, [0, 1]. Default 0. */
138
+ grain?: number;
139
+ vignette?: FinishVignette3D;
140
+ lut?: FinishLUT3D;
141
+ }
142
+ /**
143
+ * Subpixel morphological antialiasing (SMAA 1x-style, orthogonal patterns).
144
+ * @experimental
145
+ */
146
+ export interface SMAAStage3D {
147
+ type: 'smaa';
148
+ /** Luma edge threshold, [0.01, 0.5]. Default 0.1. */
149
+ threshold?: number;
150
+ }
151
+ /** @experimental */
152
+ export type EffectStage3D = SSAOStage3D | SSRStage3D | TAAStage3D | DOFStage3D | MotionBlurStage3D | BloomStage3D | OutlineStage3D | FinishStage3D | SMAAStage3D | {
153
+ type: 'fxaa';
154
+ } | {
155
+ type: 'display';
156
+ };
157
+ /**
158
+ * Memory guard of an effects pipeline; creation and `setStages` throw when a plan exceeds it.
159
+ * @experimental
160
+ */
161
+ export interface EffectsBudget3D {
162
+ /** Bytes of scene and effect targets, 1 to 256 MiB. Default 256 MiB. */
163
+ maxBytes?: number;
164
+ /** Colour targets, 1 to 16. Default 16. */
165
+ maxTargets?: number;
166
+ }
167
+ /** @experimental */
168
+ export interface EffectsOptions3D {
169
+ stages: readonly EffectStage3D[];
170
+ /** Default: the largest budget (256 MiB, 16 targets). */
171
+ budget?: EffectsBudget3D;
172
+ }
173
+ type Color4 = readonly [number, number, number, number];
174
+ type Color3 = readonly [number, number, number];
175
+ export interface EffectsPlan3D {
176
+ readonly stages: readonly EffectStage3D[];
177
+ readonly budget: Readonly<Required<EffectsBudget3D>>;
178
+ readonly ssao?: Readonly<{
179
+ radius: number;
180
+ intensity: number;
181
+ bias: number;
182
+ samples: number;
183
+ }>;
184
+ readonly ssr?: Readonly<{
185
+ maxDistance: number;
186
+ thickness: number;
187
+ steps: number;
188
+ intensity: number;
189
+ edgeFade: number;
190
+ }>;
191
+ readonly taa?: Readonly<{
192
+ feedback: number;
193
+ }>;
194
+ readonly dof?: Readonly<{
195
+ focusDistance: number;
196
+ focalLength: number;
197
+ fStop: number;
198
+ maxBlur: number;
199
+ samples: number;
200
+ }>;
201
+ readonly motionBlur?: Readonly<{
202
+ intensity: number;
203
+ samples: number;
204
+ }>;
205
+ readonly bloom?: Readonly<{
206
+ threshold: number;
207
+ strength: number;
208
+ }>;
209
+ readonly outline?: Readonly<{
210
+ color: Color4;
211
+ hiddenColor: Color4;
212
+ thickness: number;
213
+ }>;
214
+ readonly finish?: Readonly<{
215
+ chromaticAberration: number;
216
+ sharpen: number;
217
+ grain: number;
218
+ vignette?: Readonly<{
219
+ intensity: number;
220
+ radius: number;
221
+ softness: number;
222
+ color: Color3;
223
+ }>;
224
+ lut?: Readonly<{
225
+ texture: Nova3DTexture;
226
+ intensity: number;
227
+ domainMin: Color3;
228
+ domainMax: Color3;
229
+ }>;
230
+ }>;
231
+ readonly fxaa: boolean;
232
+ readonly smaa?: Readonly<{
233
+ threshold: number;
234
+ }>;
235
+ /** Some stage samples scene depth. */
236
+ readonly depth: boolean;
237
+ /** Number of stages that run on the linear HDR image. */
238
+ readonly linearStages: number;
239
+ }
240
+ export interface EffectTarget3D {
241
+ key: 'aoA' | 'aoB' | 'bloomA' | 'bloomB' | 'maskA' | 'maskB' | 'linear' | 'linearB' | 'encoded' | 'edges' | 'weights' | 'historyA' | 'historyB';
242
+ width: number;
243
+ height: number;
244
+ format: 'rgba16f' | 'rgba8' | 'rg8' | 'r8';
245
+ bytes: number;
246
+ }
247
+ export interface EffectLayout3D {
248
+ readonly targets: readonly EffectTarget3D[];
249
+ readonly bytes: number;
250
+ readonly count: number;
251
+ }
252
+ /**
253
+ * Canonical stage order. Linear HDR stages come first; `finish`, the
254
+ * antialiasing stage and `display` form the final display block.
255
+ * @experimental
256
+ */
257
+ export declare const effectStageOrder: readonly ["ssao", "ssr", "taa", "dof", "motion-blur", "bloom", "outline", "finish", "fxaa", "smaa", "display"];
258
+ /**
259
+ * Pure copied pipeline definition. Stages follow `effectStageOrder`, each at
260
+ * most once; `display` is last and `fxaa`/`smaa` (exclusive) sit right before it.
261
+ */
262
+ export declare function effectsPlan3D(options: EffectsOptions3D): EffectsPlan3D;
263
+ /**
264
+ * Budget includes scene color/depth/MSAA bytes (`baseBytes`, with the sampled
265
+ * depth texture when the plan needs depth) and every additional color target.
266
+ */
267
+ export declare function effectLayout3D(plan: EffectsPlan3D, width: number, height: number, baseBytes: number, baseColors: number): EffectLayout3D;
268
+ export {};
@@ -0,0 +1,35 @@
1
+ export declare const fullscreenVertex3D = "#version 300 es\nout vec2 uv;\nvoid main(){vec2 p=vec2(float((gl_VertexID<<1)&2),float(gl_VertexID&2));uv=p;gl_Position=vec4(p*2.0-1.0,0.0,1.0);}\n";
2
+ export declare const bloomBlurFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform vec2 offset;\nuniform bool extractBright;\nuniform float threshold;\nvec4 sampleBright(vec2 coordinate){\n vec4 p=texture(source,coordinate);if(!extractBright)return p;\n vec3 straight=p.a>0.0?p.rgb/p.a:vec3(0.0);\n float brightness=dot(straight,vec3(0.2126,0.7152,0.0722));\n return p*max(0.0,(brightness-threshold)/max(brightness,1e-6));\n}\nvoid main(){\n vec4 p=sampleBright(uv)*0.2270270270;\n p+=(sampleBright(uv+offset)+sampleBright(uv-offset))*0.1945945946;\n p+=(sampleBright(uv+offset*2.0)+sampleBright(uv-offset*2.0))*0.1216216216;\n p+=(sampleBright(uv+offset*3.0)+sampleBright(uv-offset*3.0))*0.0540540541;\n p+=(sampleBright(uv+offset*4.0)+sampleBright(uv-offset*4.0))*0.0162162162;\n result=finiteHalf(p);\n}\n";
3
+ export declare const bloomCompositeFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform sampler2D bloom;\nuniform float strength;\nvoid main(){result=finiteHalf(texture(source,uv)+texture(bloom,uv)*strength);}\n";
4
+ /** Directional FXAA on the once-encoded premultiplied display image. */
5
+ export declare const fxaaFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform vec2 inverseSize;\nfloat edgeLuma(vec4 p){return dot(p.rgb,vec3(0.299,0.587,0.114))+0.25*p.a;}\nvoid main(){\n vec4 center=texture(source,uv);\n float m=edgeLuma(center);\n float nw=edgeLuma(texture(source,uv+inverseSize*vec2(-1.0,-1.0)));\n float ne=edgeLuma(texture(source,uv+inverseSize*vec2(1.0,-1.0)));\n float sw=edgeLuma(texture(source,uv+inverseSize*vec2(-1.0,1.0)));\n float se=edgeLuma(texture(source,uv+inverseSize*vec2(1.0,1.0)));\n float low=min(m,min(min(nw,ne),min(sw,se)));\n float high=max(m,max(max(nw,ne),max(sw,se)));\n if(high-low<max(0.0312,high*0.125)){result=center;return;}\n vec2 direction=vec2(sw+se-nw-ne,nw+sw-ne-se);\n float reduction=max((nw+ne+sw+se)*0.03125,1.0/128.0);\n direction=clamp(direction/(min(abs(direction.x),abs(direction.y))+reduction),vec2(-8.0),vec2(8.0))*inverseSize;\n vec4 narrow=(texture(source,uv-direction/6.0)+texture(source,uv+direction/6.0))*0.5;\n vec4 wide=narrow*0.5+(texture(source,uv-direction*0.5)+texture(source,uv+direction*0.5))*0.25;\n float candidate=edgeLuma(wide);\n result=candidate<low||candidate>high?narrow:wide;\n}\n";
6
+ /** SAO-style spiral obscurance (McGuire et al. 2012) on reconstructed normals. */
7
+ export declare function ssaoFragment3D(samples: number): string;
8
+ /** Depth-aware 9-tap blur of the occlusion; APPLY also multiplies the scene colour. */
9
+ export declare function ssaoBlurFragment3D(apply: boolean): string;
10
+ /** View-space linear ray march with a binary refinement. */
11
+ export declare function ssrFragment3D(steps: number): string;
12
+ /** Thin-lens circle of confusion with a scatter-as-gather spiral. */
13
+ export declare function dofFragment3D(samples: number): string;
14
+ /** Camera-only blur along the depth reprojection into the previous frame. */
15
+ export declare function motionBlurFragment3D(samples: number): string;
16
+ /** Selection mask: 1 where visible, 0.5 where behind the scene depth. */
17
+ export declare const outlineMaskFragment3D = "#version 300 es\nprecision highp float;\nprecision highp int;\n__INSTANCE__\nprecision highp sampler2D;\nin vec2 texCoord;\nuniform sampler2D depthMap;\nuniform vec2 inverseSize;\nout vec4 result;\nvoid main(){cullInstance();result=vec4(gl_FragCoord.z<=texture(depthMap,gl_FragCoord.xy*inverseSize).r+2e-4?1.0:0.5);}\n";
18
+ /** Separable max dilation; COMPOSITE blends the edge colour over the image. */
19
+ export declare function outlineFragment3D(composite: boolean): string;
20
+ /**
21
+ * Display conversion fused with the finishing effects. Feature bits:
22
+ * 1 aberration, 2 sharpen, 4 LUT, 8 vignette, 16 grain.
23
+ */
24
+ export declare function finishFragment3D(features: number, toneMapping: string): string;
25
+ /** SMAA luma edges with local contrast adaptation: r = left edge, g = bottom edge. */
26
+ export declare const smaaEdgesFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform vec2 inverseSize;\nuniform float threshold;\nfloat luma(vec4 p){return dot(p.rgb,vec3(0.2126,0.7152,0.0722))+0.25*p.a;}\nfloat at(vec2 o){return luma(texture(source,uv+o*inverseSize));}\nvoid main(){\n float l=at(vec2(0.0));\n float left=at(vec2(-1.0,0.0));\n float bottom=at(vec2(0.0,-1.0));\n vec2 delta=abs(l-vec2(left,bottom));\n vec2 edges=step(threshold,delta);\n if(edges.x+edges.y==0.0){result=vec4(0.0);return;}\n vec2 most=max(delta,abs(l-vec2(at(vec2(1.0,0.0)),at(vec2(0.0,1.0)))));\n most=max(most,abs(vec2(left,bottom)-vec2(at(vec2(-2.0,0.0)),at(vec2(0.0,-2.0)))));\n edges*=step(max(most.x,most.y),2.0*delta);\n result=vec4(edges,0.0,1.0);\n}\n";
27
+ /**
28
+ * Blend weights from line-end search and analytic MLAA areas (no lookup
29
+ * textures). rg: left edge (this pixel, left pixel); ba: bottom edge (this, below).
30
+ */
31
+ export declare const smaaWeightsFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\n#define MAX_SEARCH 16\nivec2 limit;\nvec2 edgeAt(ivec2 p){return texelFetch(source,clamp(p,ivec2(0),limit),0).rg;}\n\nvec2 segmentArea(vec2 p0,vec2 p1,float a,float b){\n a=max(a,p0.x);b=min(b,p1.x);\n if(b<=a)return vec2(0.0);\n float slope=(p1.y-p0.y)/(p1.x-p0.x);\n float ya=p0.y+slope*(a-p0.x);\n float yb=p0.y+slope*(b-p0.x);\n if(ya*yb>=0.0){float m=(ya+yb)*0.5*(b-a);return m>0.0?vec2(m,0.0):vec2(0.0,-m);}\n float z=a+(b-a)*ya/(ya-yb);\n float first=ya*(z-a)*0.5;\n float second=yb*(b-z)*0.5;\n return vec2(max(first,0.0)+max(second,0.0),max(-first,0.0)+max(-second,0.0));\n}\nvec2 lineArea(float h1,float h2,float len,float i){\n if(h1!=0.0&&h2!=0.0&&h1!=h2)return segmentArea(vec2(0.0,h1),vec2(len,h2),i,i+1.0);\n vec2 area=vec2(0.0);\n if(h1!=0.0)area+=segmentArea(vec2(0.0,h1),vec2(len*0.5,0.0),i,i+1.0);\n if(h2!=0.0)area+=segmentArea(vec2(len*0.5,0.0),vec2(len,h2),i,i+1.0);\n return area;\n}\nfloat crossing(float own,float other){return own>0.5&&other<0.5?0.5:other>0.5&&own<0.5?-0.5:0.0;}\nvoid main(){\n limit=textureSize(source,0)-1;\n ivec2 p=ivec2(gl_FragCoord.xy);\n vec2 e=edgeAt(p);\n vec4 weights=vec4(0.0);\n if(e.x>0.5){\n int up=0;int down=0;\n for(int k=1;k<=MAX_SEARCH;k++){if(edgeAt(p+ivec2(0,k)).x<0.5)break;up=k;}\n for(int k=1;k<=MAX_SEARCH;k++){if(edgeAt(p-ivec2(0,k)).x<0.5)break;down=k;}\n ivec2 bottom=p-ivec2(0,down);\n ivec2 top=p+ivec2(0,up+1);\n float h1=down==MAX_SEARCH?0.0:crossing(edgeAt(bottom).y,edgeAt(bottom-ivec2(1,0)).y);\n float h2=up==MAX_SEARCH?0.0:crossing(edgeAt(top).y,edgeAt(top-ivec2(1,0)).y);\n weights.rg=lineArea(h1,h2,float(up+down+1),float(down));\n }\n if(e.y>0.5){\n int right=0;int left=0;\n for(int k=1;k<=MAX_SEARCH;k++){if(edgeAt(p+ivec2(k,0)).y<0.5)break;right=k;}\n for(int k=1;k<=MAX_SEARCH;k++){if(edgeAt(p-ivec2(k,0)).y<0.5)break;left=k;}\n ivec2 start=p-ivec2(left,0);\n ivec2 end=p+ivec2(right+1,0);\n float h1=left==MAX_SEARCH?0.0:crossing(edgeAt(start).x,edgeAt(start-ivec2(0,1)).x);\n float h2=right==MAX_SEARCH?0.0:crossing(edgeAt(end).x,edgeAt(end-ivec2(0,1)).x);\n weights.ba=lineArea(h1,h2,float(left+right+1),float(left));\n }\n result=weights;\n}\n";
32
+ /** Neighbourhood blending along the dominant edge direction. */
33
+ export declare const smaaBlendFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform sampler2D weightMap;\nvoid main(){\n ivec2 limit=textureSize(source,0)-1;\n ivec2 p=ivec2(gl_FragCoord.xy);\n vec4 w=texelFetch(weightMap,p,0);\n float left=w.r;\n float right=texelFetch(weightMap,min(p+ivec2(1,0),limit),0).g;\n float below=w.b;\n float above=texelFetch(weightMap,min(p+ivec2(0,1),limit),0).a;\n vec4 c=texelFetch(source,p,0);\n if(max(left,right)+max(below,above)<1e-5){result=c;return;}\n if(max(left,right)>=max(below,above)){\n result=c*(1.0-left-right)+texelFetch(source,max(p-ivec2(1,0),ivec2(0)),0)*left+texelFetch(source,min(p+ivec2(1,0),limit),0)*right;\n }\n else{\n result=c*(1.0-below-above)+texelFetch(source,max(p-ivec2(0,1),ivec2(0)),0)*below+texelFetch(source,min(p+ivec2(0,1),limit),0)*above;\n }\n}\n";
34
+ /** Temporal antialiasing: reprojected history clamped to the current 3×3 neighbourhood. */
35
+ export declare const taaFragment3D = "#version 300 es\nprecision highp float;\nprecision highp sampler2D;\nin vec2 uv;\nout vec4 result;\nuniform sampler2D source;\nvec4 finiteHalf(vec4 value){return vec4(clamp(value.rgb,vec3(0.0),vec3(65504.0)),clamp(value.a,0.0,1.0));}\n\nuniform sampler2D depthMap;\nuniform sampler2D colorMap;\nuniform mat4 reprojection;\nuniform vec2 inverseSize;\nuniform float feedback;\nuniform bool resetHistory;\nvoid main(){\n vec4 current=texture(source,uv);\n vec4 low=current,high=current;\n for(int y=-1;y<=1;y++){\n for(int x=-1;x<=1;x++){\n vec4 neighbour=texture(source,uv+vec2(float(x),float(y))*inverseSize);\n low=min(low,neighbour);\n high=max(high,neighbour);\n }\n }\n vec4 previous=reprojection*vec4(vec3(uv,texture(depthMap,uv).r)*2.0-1.0,1.0);\n vec2 previousUV=previous.xy/previous.w*0.5+0.5;\n if(resetHistory||any(lessThan(previousUV,vec2(0.0)))||any(greaterThan(previousUV,vec2(1.0)))){result=finiteHalf(current);return;}\n vec4 history=clamp(texture(colorMap,previousUV),low,high);\n result=finiteHalf(mix(current,history,feedback));\n}\n";
@@ -0,0 +1,49 @@
1
+ import { Nova3DAnimationClip } from '../animation/Clip.js';
2
+ import { Nova3DWarning } from '../Errors.js';
3
+ import { Nova3DNode } from '../model/Node.js';
4
+ import { Nova3DScene } from '../model/Scene.js';
5
+ /** @experimental */
6
+ export interface GLTFExportOptions3D {
7
+ /** Also export nodes hidden by `visible: false` (and their subtrees). Default false. */
8
+ includeHidden?: boolean;
9
+ /** Clips whose track targets are exported node ids become glTF animations. */
10
+ animations?: readonly Nova3DAnimationClip[];
11
+ }
12
+ /**
13
+ * A glTF 2.0 document: JSON plus one binary buffer (GLB packs both).
14
+ * @experimental
15
+ */
16
+ export interface GLTFExport3D {
17
+ readonly json: Record<string, unknown>;
18
+ readonly binary: Uint8Array;
19
+ /** Content that could not be represented, such as float textures. */
20
+ readonly warnings: readonly Nova3DWarning[];
21
+ }
22
+ /**
23
+ * A binary file export (GLB, 3MF) and its notes.
24
+ * @experimental
25
+ */
26
+ export interface BinaryExport3D {
27
+ readonly data: Uint8Array;
28
+ /** Content that could not be represented and was skipped or approximated. */
29
+ readonly warnings: readonly Nova3DWarning[];
30
+ }
31
+ /**
32
+ * Exports scene content as glTF 2.0 (three.js GLTFExporter, Babylon GLTF2Export):
33
+ * nodes with TRS, meshes per geometry and material, instanced meshes through
34
+ * EXT_mesh_gpu_instancing, PBR materials with KHR_materials_* and
35
+ * KHR_texture_transform, unlit basic materials, 8-bit textures as PNG, cameras and
36
+ * KHR_lights_punctual lights, skins, morph targets and animation clips.
37
+ * @experimental
38
+ */
39
+ export declare function exportGLTF(source: Nova3DScene | readonly Nova3DNode[], options?: GLTFExportOptions3D): Promise<GLTFExport3D>;
40
+ /**
41
+ * Packs an export as a GLB container (binary glTF).
42
+ * @experimental
43
+ */
44
+ export declare function toGLB(document: GLTFExport3D): Uint8Array;
45
+ /**
46
+ * Exports as GLB in one call.
47
+ * @experimental
48
+ */
49
+ export declare function exportGLB(source: Nova3DScene | readonly Nova3DNode[], options?: GLTFExportOptions3D): Promise<BinaryExport3D>;
@@ -0,0 +1,19 @@
1
+ import { BinaryExport3D } from './GLTFExporter.js';
2
+ import { Nova3DNode } from '../model/Node.js';
3
+ import { Nova3DScene } from '../model/Scene.js';
4
+ /** @experimental */
5
+ export interface ThreeMFExportOptions3D {
6
+ /** Also export hidden nodes. Default false. */
7
+ includeHidden?: boolean;
8
+ /** Scene units per 3MF unit: the document is in millimetres, a scene unit is a metre by default (1000). */
9
+ unitScale?: number;
10
+ }
11
+ /**
12
+ * Exports triangle meshes as a 3MF package (three.js 3MFExporter is not in core;
13
+ * Babylon and PlayCanvas have none): one object per geometry with its vertices,
14
+ * triangles and a base material colour, and one build item per mesh or instance
15
+ * with its world transform. Y-up scene axes become 3MF Z-up; lines, points and
16
+ * non-triangle content are skipped (with a warning).
17
+ * @experimental
18
+ */
19
+ export declare function export3MF(source: Nova3DScene | readonly Nova3DNode[], options?: ThreeMFExportOptions3D): Promise<BinaryExport3D>;
@@ -0,0 +1,9 @@
1
+ export interface ZipFile3D {
2
+ readonly name: string;
3
+ readonly data: Uint8Array;
4
+ }
5
+ /**
6
+ * Writes a store-only ZIP archive (no compression, no ZIP64): enough for 3MF and
7
+ * USDZ packages, which readers accept uncompressed.
8
+ */
9
+ export declare function writeZip3D(files: readonly ZipFile3D[]): Uint8Array;
@@ -0,0 +1,26 @@
1
+ import { ModelLoadOptions3D, ModelParseOptions3D } from '../import/ImportedModel.js';
2
+ import { Nova3DModelAsset } from '../import/ModelAsset.js';
3
+ import { LoaderInput3D } from '../loaders/LoaderIO.js';
4
+ /**
5
+ * Options of `loadFBX`.
6
+ * @experimental
7
+ */
8
+ export type FBXLoadOptions3D = ModelLoadOptions3D;
9
+ /**
10
+ * Options of `parseFBX`; `baseUrl` resolves relative texture files.
11
+ * @experimental
12
+ */
13
+ export type FBXParseOptions3D = ModelParseOptions3D;
14
+ /**
15
+ * Parses binary (7.x, 32/64-bit records, raw or zlib arrays) or ASCII FBX into
16
+ * an asset. Converts to right-handed Y-up metres unless disabled.
17
+ * Needs no app: the asset is bound to one by its first `instantiate`; cancel with `signal`.
18
+ * @experimental
19
+ */
20
+ export declare function parseFBX(data: LoaderInput3D, options?: FBXParseOptions3D): Promise<Nova3DModelAsset>;
21
+ /**
22
+ * Fetches an FBX file with bounded streaming; textures resolve relative to it.
23
+ * Needs no app: the asset is bound to one by its first `instantiate`; cancel with `signal`.
24
+ * @experimental
25
+ */
26
+ export declare function loadFBX(url: string | URL, options?: FBXLoadOptions3D): Promise<Nova3DModelAsset>;
@@ -0,0 +1,35 @@
1
+ import { ByteBudget3D } from '../import/ImportedModel.js';
2
+ export type FBXArrayType3D = 'f' | 'd' | 'l' | 'i' | 'b';
3
+ export type FBXNumericArray3D = Float32Array | Float64Array | Int32Array | Uint8Array;
4
+ /** Array property; binary payloads stay encoded until a reader asks for them. */
5
+ export declare class FBXArray3D {
6
+ readonly type: FBXArrayType3D;
7
+ readonly length: number;
8
+ readonly encoding: 0 | 1;
9
+ readonly bytes: Uint8Array | null;
10
+ values: FBXNumericArray3D | null;
11
+ constructor(type: FBXArrayType3D, length: number, encoding: 0 | 1, bytes: Uint8Array | null, values: FBXNumericArray3D | null);
12
+ }
13
+ export type FBXProperty3D = number | bigint | string | Uint8Array | FBXArray3D;
14
+ export interface FBXNode3D {
15
+ name: string;
16
+ props: FBXProperty3D[];
17
+ children: FBXNode3D[];
18
+ }
19
+ export interface FBXDocument3D {
20
+ version: number;
21
+ binary: boolean;
22
+ nodes: FBXNode3D[];
23
+ }
24
+ export interface FBXParseLimits3D {
25
+ maxRecords: number;
26
+ /** Largest single decoded array in bytes. */
27
+ maxArrayBytes: number;
28
+ }
29
+ export declare function isBinaryFBX3D(bytes: Uint8Array): boolean;
30
+ /** Parses a binary or ASCII FBX 7.x document into a node tree. */
31
+ export declare function parseFBXDocument3D(bytes: Uint8Array, limits: FBXParseLimits3D): FBXDocument3D;
32
+ /** Decodes one array (raw or zlib) into a typed array; 'l' becomes Float64Array. */
33
+ export declare function decodeFBXArray3D(array: FBXArray3D, budget: ByteBudget3D, signal?: AbortSignal): Promise<FBXNumericArray3D>;
34
+ /** Decodes, in parallel, every array whose owning node name is in `names`. */
35
+ export declare function decodeFBXArrays3D(nodes: readonly FBXNode3D[], names: ReadonlySet<string>, budget: ByteBudget3D, signal?: AbortSignal): Promise<void>;
@@ -0,0 +1,20 @@
1
+ import { ImportScene3D } from '../import/ImportedModel.js';
2
+ import { FBXDocument3D } from './FBXParser.js';
3
+ /** FBX time unit: ticks per second. */
4
+ export declare const FBX_TICKS_PER_SECOND = 46186158000;
5
+ export interface FBXSceneOptions3D {
6
+ maxRecords: number;
7
+ maxArrayBytes: number;
8
+ maxDecompressedBytes: number;
9
+ maxNodes: number;
10
+ maxVertices: number;
11
+ maxPrimitives: number;
12
+ maxAnimationKeys: number;
13
+ convertUnits: boolean;
14
+ convertAxes: boolean;
15
+ baseUrl?: string;
16
+ signal?: AbortSignal;
17
+ }
18
+ /** Interprets a parsed FBX document as a format-neutral import scene. */
19
+ export declare function fbxScene3D(bytes: Uint8Array, options: FBXSceneOptions3D): Promise<ImportScene3D>;
20
+ export declare function interpretFBX3D(document: FBXDocument3D, options: FBXSceneOptions3D): Promise<ImportScene3D>;
@@ -0,0 +1,16 @@
1
+ import { LoaderInput3D } from '../loaders/LoaderIO.js';
2
+ import { GLTFLoadOptions3D, GLTFParseOptions3D } from './GLTFTypes.js';
3
+ import { Nova3DModelAsset } from '../import/ModelAsset.js';
4
+ /**
5
+ * Parses glTF JSON text or GLB bytes into a model asset without an app; external
6
+ * resources resolve against `baseUrl` (or `resolveResource`). Cancel with `signal`.
7
+ * The asset is bound to an app by its first `instantiate`.
8
+ * @experimental
9
+ */
10
+ export declare function parseGLTF(data: LoaderInput3D, options?: GLTFParseOptions3D): Promise<Nova3DModelAsset>;
11
+ /**
12
+ * Fetches a glTF or GLB file with bounded streaming and parses it like `parseGLTF`;
13
+ * relative resources resolve against the file URL. Cancel with `signal`.
14
+ * @experimental
15
+ */
16
+ export declare function loadGLTF(url: string | URL, options?: GLTFLoadOptions3D): Promise<Nova3DModelAsset>;
@@ -0,0 +1,64 @@
1
+ import { TextureOptions3D } from '../model/Texture.js';
2
+ import { GeometryOptions3D } from '../types.js';
3
+ import { GLTFIOOptions3D } from './services/GLTFResourceIO.js';
4
+ /**
5
+ * What a Draco decoder receives with a KHR_draco_mesh_compression payload.
6
+ * @experimental
7
+ */
8
+ export interface DracoDecodeOptions3D {
9
+ /** glTF attribute names (POSITION, NORMAL, …) to Draco attribute ids. */
10
+ readonly attributes: Readonly<Record<string, number>>;
11
+ readonly signal: AbortSignal;
12
+ /** Vertices the asset may still add. */
13
+ readonly maxVertices: number;
14
+ /** Output bytes the decoded geometry may use. */
15
+ readonly maxAccessorBytes: number;
16
+ }
17
+ /**
18
+ * What a meshopt decoder receives with an EXT_meshopt_compression buffer view.
19
+ * @experimental
20
+ */
21
+ export interface MeshoptDecodeOptions3D {
22
+ readonly count: number;
23
+ readonly byteStride: number;
24
+ readonly mode: 'ATTRIBUTES' | 'TRIANGLES' | 'INDICES';
25
+ readonly filter: 'NONE' | 'OCTAHEDRAL' | 'QUATERNION' | 'EXPONENTIAL';
26
+ readonly signal: AbortSignal;
27
+ }
28
+ /**
29
+ * What a KTX2 transcoder receives with a KHR_texture_basisu image.
30
+ * @experimental
31
+ */
32
+ export interface KTX2DecodeOptions3D {
33
+ readonly colorSpace: 'srgb' | 'linear';
34
+ readonly signal: AbortSignal;
35
+ /** Decoded bytes the asset may still add. */
36
+ readonly maxDecodedImageBytes: number;
37
+ readonly maxImageDimension: number;
38
+ }
39
+ /**
40
+ * Optional decoders of compressed glTF extensions; Nova bundles none.
41
+ * @experimental
42
+ */
43
+ export interface GLTFDecoders3D {
44
+ draco?: (data: Uint8Array, options: DracoDecodeOptions3D) => Promise<GeometryOptions3D>;
45
+ meshopt?: (data: Uint8Array, options: MeshoptDecodeOptions3D) => Promise<Uint8Array>;
46
+ ktx2?: (data: Uint8Array, options: KTX2DecodeOptions3D) => Promise<TextureOptions3D>;
47
+ }
48
+ /**
49
+ * Options of `loadGLTF`.
50
+ * @experimental
51
+ */
52
+ export interface GLTFLoadOptions3D extends GLTFIOOptions3D {
53
+ decoders?: GLTFDecoders3D;
54
+ }
55
+ /**
56
+ * Options of `parseGLTF`; `baseUrl` resolves relative resources.
57
+ * @experimental
58
+ */
59
+ export interface GLTFParseOptions3D extends GLTFLoadOptions3D {
60
+ baseUrl?: string;
61
+ }
62
+ export declare const gltfLoadKeys3D: ReadonlySet<string>;
63
+ export declare const gltfParseKeys3D: ReadonlySet<string>;
64
+ export declare const gltfDecoderKeys3D: ReadonlySet<string>;
@@ -0,0 +1,21 @@
1
+ export declare function gltfContainer3D(data: Uint8Array, maxJSONBytes: number): {
2
+ json: unknown;
3
+ binary?: Uint8Array;
4
+ };
5
+ export type JSONRecord3D = Record<string, unknown>;
6
+ export declare function object3D(value: unknown, label: string): JSONRecord3D;
7
+ export declare function array3D(value: unknown, label: string, maximum: number): unknown[];
8
+ export declare function integer3D(value: unknown, label: string, maximum?: number): number;
9
+ interface BufferView3D {
10
+ data: Uint8Array;
11
+ stride?: number;
12
+ offset?: number;
13
+ }
14
+ export declare function gltfAccessor3D(input: unknown, views: readonly BufferView3D[], maximumElements: number): {
15
+ values: Float64Array;
16
+ count: number;
17
+ components: number;
18
+ componentType: number;
19
+ normalized: boolean;
20
+ };
21
+ export {};