@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,79 @@
1
+ import { Nova3DCamera } from '../model/Camera.js';
2
+ import { Nova3DApp } from '../Nova3DApp.js';
3
+ import { Transform3D } from '../types.js';
4
+ import { Nova3DNode } from '../model/Node.js';
5
+ /** @experimental */
6
+ export type TransformMode3D = 'translate' | 'rotate' | 'scale';
7
+ /** @experimental */
8
+ export type TransformSpace3D = 'local' | 'world';
9
+ /** @experimental */
10
+ export interface TransformGesture3D {
11
+ readonly type: 'begin' | 'change' | 'end' | 'cancel';
12
+ readonly node: Nova3DNode;
13
+ readonly axis: 'x' | 'y' | 'z';
14
+ readonly mode: TransformMode3D;
15
+ readonly space: TransformSpace3D;
16
+ readonly from: Transform3D;
17
+ readonly transform: Transform3D;
18
+ }
19
+ /** @experimental */
20
+ export interface TransformGizmoOptions3D {
21
+ camera: Nova3DCamera;
22
+ mode: TransformMode3D;
23
+ space: TransformSpace3D;
24
+ onGesture: (event: TransformGesture3D) => void;
25
+ }
26
+ /**
27
+ * Transform gizmo: draws depth-tested axes or rings on the attached node and reports
28
+ * drag gestures through `onGesture`; it never writes the transform itself, so the
29
+ * caller applies it and keeps history.
30
+ * @experimental
31
+ */
32
+ export declare class Nova3DTransformGizmo {
33
+ protected constructor();
34
+ private readonly _app;
35
+ private readonly _options;
36
+ private readonly _gesture;
37
+ private readonly _cleanup;
38
+ private _mode;
39
+ private _space;
40
+ private _node?;
41
+ private _root?;
42
+ private readonly _geometry;
43
+ private readonly _materials;
44
+ private readonly _positions;
45
+ private _drag?;
46
+ private _enabled;
47
+ private _destroyed;
48
+ get enabled(): boolean;
49
+ get destroyed(): boolean;
50
+ /** Disabled gizmos stay visible but ignore pointer input; disabling cancels a drag. */
51
+ setEnabled(enabled: boolean): void;
52
+ /** Shows the gizmo on `node`, a live object of the active scene. */
53
+ attach(node: Nova3DNode): void;
54
+ detach(): void;
55
+ setMode(mode: TransformMode3D): void;
56
+ setSpace(space: TransformSpace3D): void;
57
+ cancel(): void;
58
+ destroy(): void;
59
+ private _basis;
60
+ private _createVisuals;
61
+ private _points;
62
+ private _updateVisuals;
63
+ private _point;
64
+ private _begin;
65
+ private _move;
66
+ private _angle;
67
+ private _finish;
68
+ private _emit;
69
+ private _disposeVisuals;
70
+ private _validateMode;
71
+ private _validateSpace;
72
+ private _assertAlive;
73
+ }
74
+ /**
75
+ * Creates a transform gizmo for the active camera of `app`; gestures go to
76
+ * `options.onGesture`. Owned by the app: destroyed with it.
77
+ * @experimental
78
+ */
79
+ export declare function createTransformGizmo(app: Nova3DApp, options: TransformGizmoOptions3D): Nova3DTransformGizmo;
@@ -0,0 +1,52 @@
1
+ import { Nova3DGeometry } from '../model/Geometry.js';
2
+ import { Nova3DMesh } from '../model/Mesh.js';
3
+ import { Nova3DNode } from '../model/Node.js';
4
+ import { Nova3DDeformedMesh } from './DeformedMesh.js';
5
+ export declare class DeformationGPU3D {
6
+ private readonly _gl;
7
+ private readonly _programs;
8
+ private readonly _geometry;
9
+ private readonly _poses;
10
+ /**
11
+ * One palette atlas for every skinned mesh, uploaded by one call per frame: each
12
+ * texture upload costs about 10 µs of GPU time on ANGLE/Vulkan whatever its size
13
+ * (50 per-mesh palettes cost 0.5 ms on Intel UHD 630).
14
+ */
15
+ private _atlas;
16
+ private _atlasRows;
17
+ private _staging;
18
+ /** Free entry ranges [start, end) of the atlas, sorted by start. */
19
+ private _free;
20
+ private _dirtyLow;
21
+ private _dirtyHigh;
22
+ private _uploads;
23
+ private readonly _capable;
24
+ constructor(_gl: WebGL2RenderingContext);
25
+ get bytes(): number;
26
+ /**
27
+ * Copies a changed skin palette into the atlas staging; `flush` uploads every staged
28
+ * palette at once before the frame's passes.
29
+ */
30
+ stage(node: Nova3DDeformedMesh): void;
31
+ /**
32
+ * Uploads the staged palette rows in one call on unit 16. Returns true when it changed
33
+ * the active unit and binding (the caller resynchronizes its state cache).
34
+ */
35
+ flush(): boolean;
36
+ /** First-fit range of `joints` entries; the atlas grows by whole rows. */
37
+ private _allocate;
38
+ consumeUploads(): number;
39
+ /**
40
+ * Prepares the deformation uniforms of `program` for `node`.
41
+ * Returns true when GL state outside the program uniforms was changed.
42
+ */
43
+ bind(node: Nova3DMesh, program: WebGLProgram): boolean;
44
+ private _uniforms;
45
+ private _writeDefaults;
46
+ releaseNode(node: Nova3DNode): void;
47
+ /** Returns entries [start, end) to the free list, merging neighbours. */
48
+ private _release;
49
+ releaseGeometry(geometry: Nova3DGeometry): void;
50
+ reset(discard: boolean): void;
51
+ private _deleteGeometry;
52
+ }
@@ -0,0 +1,2 @@
1
+ /** Shared by all three concrete draw pipelines; no shader/device work on import. */
2
+ export declare const deformationDeclarations3D = "\nprecision highp sampler2D;\nprecision highp sampler2DArray;\nlayout(location=8) in vec4 jointIndices;\nlayout(location=9) in vec4 jointWeights;\nuniform bool hasSkin;\n\nuniform sampler2D skinMatrices;\nuniform int skinOffset;\nuniform sampler2DArray morphAtlas;\nuniform int morphCount;\nuniform int morphWidth;\nuniform float morphWeights[8];\nmat4 jointMatrix(int joint){int entry=skinOffset+joint;ivec2 at=ivec2((entry&255)<<2,entry>>8);return mat4(texelFetch(skinMatrices,at,0),texelFetch(skinMatrices,at+ivec2(1,0),0),texelFetch(skinMatrices,at+ivec2(2,0),0),texelFetch(skinMatrices,at+ivec2(3,0),0));}\n\n#ifdef NOVA_NO_SKIN\nmat4 skinTransform(){return mat4(1.0);}\n#else\nmat4 skinTransform(){if(!hasSkin)return mat4(1.0);return jointMatrix(int(jointIndices.x))*jointWeights.x+jointMatrix(int(jointIndices.y))*jointWeights.y+jointMatrix(int(jointIndices.z))*jointWeights.z+jointMatrix(int(jointIndices.w))*jointWeights.w;}\n#endif\n#ifdef NOVA_NO_MORPH\nvec3 morphDelta(int normalOffset){return vec3(0.0);}\n#else\nvec3 morphDelta(int normalOffset){\n vec3 result=vec3(0.0);if(morphCount==0)return result;\n ivec2 texel=ivec2(gl_VertexID%morphWidth,gl_VertexID/morphWidth);\n for(int target=0;target<8;target++){if(target>=morphCount)break;result+=texelFetch(morphAtlas,ivec3(texel,target*2+normalOffset),0).xyz*morphWeights[target];}\n return result;\n}\n#endif\n";
@@ -0,0 +1,36 @@
1
+ import { mat4 as Matrix4 } from 'gl-matrix';
2
+ import { Nova3DGeometry } from '../model/Geometry.js';
3
+ import { MeshOptions3D, Nova3DMesh } from '../model/Mesh.js';
4
+ import { Nova3DNode } from '../model/Node.js';
5
+ import { Nova3DScene } from '../model/Scene.js';
6
+ import { Bounds3D } from '../types.js';
7
+ import { GeometryDeformation3D } from './GeometryDeformation.js';
8
+ export interface SkinBinding3D {
9
+ joints: readonly Nova3DNode[];
10
+ inverseBindMatrices: Float32Array;
11
+ }
12
+ /** Internal glTF primitive instance. Immutable columns are geometry-owned; pose is model-local. */
13
+ export declare class Nova3DDeformedMesh extends Nova3DMesh {
14
+ protected constructor();
15
+ private readonly _data;
16
+ private readonly _skin?;
17
+ private _weights;
18
+ private _weightPose?;
19
+ private _weightOwner?;
20
+ private _palette;
21
+ /** World version of each joint when its palette entry was written (-1: never). */
22
+ private _paletteVersions;
23
+ private _poseVersion;
24
+ private _dirtyPose;
25
+ private _geometryVersion;
26
+ private _influence;
27
+ private readonly _deltas;
28
+ private _worldBounds;
29
+ /** The one record behind `_worldBounds`, rewritten in place. */
30
+ private _boundsRecord?;
31
+ private _spatialPositions?;
32
+ private _spatialVersion;
33
+ private readonly _pose;
34
+ setGeometry(geometry: Nova3DGeometry): void;
35
+ private _prepareDeformation;
36
+ }
@@ -0,0 +1,25 @@
1
+ import { Bounds3D } from '../types.js';
2
+ export interface MorphTarget3D {
3
+ positions: Float32Array;
4
+ normals?: Float32Array;
5
+ }
6
+ export interface GeometryDeformationOptions3D {
7
+ joints?: Uint16Array;
8
+ weights?: Float32Array;
9
+ targets?: readonly MorphTarget3D[];
10
+ flatNormals: boolean;
11
+ }
12
+ export interface GeometryDeformation3D {
13
+ readonly joints?: Uint16Array;
14
+ readonly weights?: Float32Array;
15
+ readonly targets: readonly MorphTarget3D[];
16
+ readonly flatNormals: boolean;
17
+ readonly atlasWidth: number;
18
+ readonly atlasHeight: number;
19
+ readonly atlasBytes: number;
20
+ }
21
+ /** Internal immutable primitive data, shared by imported model instances. */
22
+ export declare function copyGeometryDeformation3D(source: GeometryDeformationOptions3D, vertices: number): GeometryDeformation3D;
23
+ /** Conservative influence boxes; optional morph deltas expand before skinning. */
24
+ export declare function influenceBounds3D(positions: Float32Array, data: GeometryDeformation3D): readonly (Bounds3D | null)[];
25
+ export declare function morphDeltaBounds3D(data: GeometryDeformation3D): readonly Bounds3D[];
@@ -0,0 +1,59 @@
1
+ import { Limits3D } from '../loaders/Limits.js';
2
+ import { Transform3D, TransformPatch3D } from '../types.js';
3
+ import { DocumentChange3D, DocumentEvent3D, DocumentSnapshot3D } from './DocumentTypes.js';
4
+ /**
5
+ * Options of `parseDocument`. `limits` applies `maxInputBytes` (JSON length),
6
+ * `maxNodes`, `maxResources`, `maxDepth`, `maxGeometryValues` and
7
+ * `maxDecodedImageBytes` (texture data); none may exceed its default.
8
+ * @experimental
9
+ */
10
+ export interface DocumentParseOptions3D {
11
+ limits?: Limits3D;
12
+ }
13
+ /**
14
+ * Options of `document.apply`.
15
+ * @experimental
16
+ */
17
+ export interface DocumentApplyOptions3D {
18
+ /** Refuses the changes unless the document is still at this revision. */
19
+ expectedRevision?: number;
20
+ }
21
+ /**
22
+ * Versioned logical source of truth; playback and gesture preview never enter snapshots.
23
+ * @experimental
24
+ */
25
+ export declare class Nova3DDocument {
26
+ protected constructor();
27
+ private _snapshot;
28
+ private _notifying;
29
+ private _destroyed;
30
+ private readonly _listeners;
31
+ private _commandsOwner?;
32
+ private readonly _preview;
33
+ get destroyed(): boolean;
34
+ getSnapshot(): DocumentSnapshot3D;
35
+ apply(changes: readonly DocumentChange3D[], options?: DocumentApplyOptions3D): DocumentSnapshot3D;
36
+ /** Commits (`change`), transform previews (`preview`) and `destroy`; returns unsubscribe. */
37
+ onChange(listener: (event: DocumentEvent3D) => void): () => void;
38
+ destroy(): void;
39
+ private _emit;
40
+ private _assertMutable;
41
+ private _assertAlive;
42
+ }
43
+ /**
44
+ * Owned by the caller; not tied to an app.
45
+ * @experimental
46
+ */
47
+ export declare function createDocument(snapshot?: DocumentSnapshot3D): Nova3DDocument;
48
+ /** @experimental */
49
+ export declare function parseDocument(json: string, options?: DocumentParseOptions3D): Promise<DocumentSnapshot3D>;
50
+ /** @experimental */
51
+ export declare function serializeDocument(document: Nova3DDocument): string;
52
+ /**
53
+ * Reads a stored snapshot: v3 is idempotent; v1 gets its camelCase node types
54
+ * renamed to the kebab-case of v2, and v1 and v2 directional lights get
55
+ * `illuminance` renamed to `intensity` (v3). Other versions are explicitly refused.
56
+ * @experimental
57
+ */
58
+ export declare function migrateDocument(snapshot: unknown): DocumentSnapshot3D;
59
+ export declare function sameDocument3D(a: DocumentSnapshot3D, b: DocumentSnapshot3D): boolean;
@@ -0,0 +1,45 @@
1
+ import { Command, CommandScope } from '@typedworks/commands';
2
+ import { History } from '@typedworks/history';
3
+ import { TransformGesture3D } from '../controls/TransformGizmo.js';
4
+ import { Nova3DDocument } from './Document.js';
5
+ import { DocumentChange3D, DocumentSnapshot3D } from './DocumentTypes.js';
6
+ /** @experimental */
7
+ export interface DocumentCommandInput3D {
8
+ readonly changes: readonly DocumentChange3D[];
9
+ readonly expectedRevision?: number;
10
+ }
11
+ /** @experimental */
12
+ export declare const documentCommands: Readonly<{
13
+ apply: Command<DocumentCommandInput3D, DocumentSnapshot3D>;
14
+ undo: Command<void, void>;
15
+ redo: Command<void, void>;
16
+ }>;
17
+ /** @experimental */
18
+ export interface DocumentCommandsOptions3D {
19
+ commandScope: CommandScope;
20
+ history: History;
21
+ }
22
+ /**
23
+ * Scoped commands use only the provided History; one complete gesture becomes one operation.
24
+ * @experimental
25
+ */
26
+ export declare class Nova3DDocumentCommands {
27
+ protected constructor();
28
+ private readonly _cleanup;
29
+ private _destroyed;
30
+ private _gesture?;
31
+ private readonly _options;
32
+ execute(input: DocumentCommandInput3D): Promise<DocumentSnapshot3D>;
33
+ /** Pass to the gizmo callback; returned completion handles command failures explicitly. */
34
+ onGesture(event: TransformGesture3D): Promise<void>;
35
+ cancelGesture(): void;
36
+ get destroyed(): boolean;
37
+ destroy(): void;
38
+ private _assertAlive;
39
+ }
40
+ /**
41
+ * Binds the apply/undo/redo commands of `document` to a command scope and its history.
42
+ * Owned by the caller; destroyed with its document.
43
+ * @experimental
44
+ */
45
+ export declare function createDocumentCommands(document: Nova3DDocument, options: DocumentCommandsOptions3D): Nova3DDocumentCommands;
@@ -0,0 +1,18 @@
1
+ import { Limits3D } from '../loaders/Limits.js';
2
+ import { DocumentSnapshot3D } from './DocumentTypes.js';
3
+ /** Document limits; the defaults are also the hard maximum. */
4
+ export declare const documentDefaults3D: Readonly<{
5
+ maxInputBytes: number;
6
+ maxNodes: 10000;
7
+ maxResources: 2048;
8
+ maxDepth: 128;
9
+ maxGeometryValues: 2000000;
10
+ maxDecodedImageBytes: number;
11
+ }>;
12
+ export type ResolvedDocumentLimits3D = {
13
+ readonly [K in keyof typeof documentDefaults3D]: number;
14
+ };
15
+ export declare function documentLimits3D(input?: Limits3D): ResolvedDocumentLimits3D;
16
+ export declare function readDocument3D(text: string, limits: ResolvedDocumentLimits3D): DocumentSnapshot3D;
17
+ export declare function copyDocument3D(value: unknown): DocumentSnapshot3D;
18
+ export declare function writeDocument3D(value: DocumentSnapshot3D): string;
@@ -0,0 +1,4 @@
1
+ import { Transform3D, TransformPatch3D } from '../types.js';
2
+ /** Keeps already-normalized persisted quaternions stable across save/load and no-op actions. */
3
+ export declare function documentTransform3D(previous: Transform3D, patch: TransformPatch3D): Transform3D;
4
+ export declare function sameDocumentTransform3D(a: Transform3D, b: Transform3D): boolean;
@@ -0,0 +1,182 @@
1
+ import { Transform3D, TransformPatch3D } from '../types.js';
2
+ /** @experimental */
3
+ export interface DocumentGeometry3D {
4
+ readonly type: 'geometry';
5
+ readonly id: string;
6
+ readonly positions: readonly number[];
7
+ readonly normals?: readonly number[];
8
+ readonly uvs?: readonly number[];
9
+ readonly indices?: readonly number[];
10
+ readonly topology?: 'triangles' | 'lines' | 'points';
11
+ }
12
+ /** @experimental */
13
+ export interface DocumentTexture3D {
14
+ readonly type: 'texture';
15
+ readonly id: string;
16
+ readonly width: number;
17
+ readonly height: number;
18
+ readonly data: readonly number[];
19
+ readonly colorSpace?: 'srgb' | 'linear';
20
+ readonly filter?: 'nearest' | 'linear';
21
+ readonly wrap?: 'clamp' | 'repeat' | 'mirror';
22
+ readonly mipmaps?: boolean;
23
+ }
24
+ /** @experimental */
25
+ export interface DocumentMaterial3D {
26
+ readonly type: 'material';
27
+ readonly id: string;
28
+ readonly shading: 'basic' | 'pbr';
29
+ readonly color?: readonly [
30
+ number,
31
+ number,
32
+ number,
33
+ number
34
+ ];
35
+ readonly opacity?: number;
36
+ readonly side?: 'front' | 'back' | 'double';
37
+ readonly alphaMode?: 'opaque' | 'mask' | 'blend';
38
+ readonly alphaCutoff?: number;
39
+ readonly map?: string | null;
40
+ readonly metallicFactor?: number;
41
+ readonly roughnessFactor?: number;
42
+ readonly emissiveFactor?: readonly [
43
+ number,
44
+ number,
45
+ number
46
+ ];
47
+ readonly normalScale?: number;
48
+ readonly occlusionStrength?: number;
49
+ readonly metallicRoughnessMap?: string | null;
50
+ readonly normalMap?: string | null;
51
+ readonly occlusionMap?: string | null;
52
+ readonly emissiveMap?: string | null;
53
+ }
54
+ /** @experimental */
55
+ export interface DocumentAsset3D {
56
+ readonly type: 'asset';
57
+ readonly id: string;
58
+ readonly uri: string;
59
+ }
60
+ /** @experimental */
61
+ export type DocumentResource3D = DocumentGeometry3D | DocumentTexture3D | DocumentMaterial3D | DocumentAsset3D;
62
+ /** @experimental */
63
+ export interface DocumentNodeBase3D {
64
+ readonly id: string;
65
+ readonly parent: string | null;
66
+ readonly transform?: TransformPatch3D;
67
+ readonly visible?: boolean;
68
+ readonly pickable?: boolean;
69
+ }
70
+ /** @experimental */
71
+ export type DocumentNode3D = DocumentNodeBase3D & ({
72
+ readonly type: 'group';
73
+ } | {
74
+ readonly type: 'mesh';
75
+ readonly geometry: string;
76
+ readonly material: string;
77
+ readonly castShadow?: boolean;
78
+ readonly receiveShadow?: boolean;
79
+ } | {
80
+ readonly type: 'asset';
81
+ readonly asset: string;
82
+ readonly sceneIndex?: number;
83
+ } | {
84
+ readonly type: 'perspective-camera';
85
+ readonly fov: number;
86
+ readonly near: number;
87
+ readonly far: number;
88
+ } | {
89
+ readonly type: 'orthographic-camera';
90
+ readonly verticalSize: number;
91
+ readonly near: number;
92
+ readonly far: number;
93
+ } | {
94
+ readonly type: 'directional-light';
95
+ readonly color?: readonly [
96
+ number,
97
+ number,
98
+ number,
99
+ number
100
+ ];
101
+ /** Lux, as `DirectionalLightOptions3D.intensity`. */
102
+ readonly intensity: number;
103
+ } | {
104
+ readonly type: 'point-light';
105
+ readonly color?: readonly [
106
+ number,
107
+ number,
108
+ number,
109
+ number
110
+ ];
111
+ readonly intensity: number;
112
+ readonly range?: number;
113
+ } | {
114
+ readonly type: 'spot-light';
115
+ readonly color?: readonly [
116
+ number,
117
+ number,
118
+ number,
119
+ number
120
+ ];
121
+ readonly intensity: number;
122
+ readonly range?: number;
123
+ readonly innerConeAngle: number;
124
+ readonly outerConeAngle: number;
125
+ });
126
+ /** @experimental */
127
+ export type DocumentNodeState3D = Omit<DocumentNodeBase3D, 'transform' | 'visible' | 'pickable'> & {
128
+ readonly transform: Transform3D;
129
+ readonly visible: boolean;
130
+ readonly pickable: boolean;
131
+ } & DocumentNode3D;
132
+ /** @experimental */
133
+ export interface DocumentSnapshot3D {
134
+ readonly version: 3;
135
+ readonly revision: number;
136
+ readonly nodes: readonly DocumentNode3D[];
137
+ readonly resources: readonly DocumentResource3D[];
138
+ }
139
+ /** @experimental */
140
+ export type DocumentChange3D = {
141
+ readonly type: 'create-node';
142
+ node: DocumentNode3D;
143
+ } | {
144
+ readonly type: 'delete-node';
145
+ readonly id: string;
146
+ } | {
147
+ readonly type: 'transform';
148
+ readonly id: string;
149
+ readonly transform: TransformPatch3D;
150
+ } | {
151
+ readonly type: 'reparent';
152
+ readonly id: string;
153
+ readonly parent: string | null;
154
+ preserve?: 'local' | 'world';
155
+ } | {
156
+ readonly type: 'visibility';
157
+ readonly id: string;
158
+ readonly visible: boolean;
159
+ } | {
160
+ readonly type: 'pickable';
161
+ readonly id: string;
162
+ readonly pickable: boolean;
163
+ } | {
164
+ readonly type: 'assign-material';
165
+ readonly id: string;
166
+ readonly material: string;
167
+ } | {
168
+ readonly type: 'material';
169
+ readonly id: string;
170
+ patch: Partial<Omit<DocumentMaterial3D, 'id' | 'type' | 'shading'>>;
171
+ } | {
172
+ readonly type: 'put-resource';
173
+ resource: DocumentResource3D;
174
+ } | {
175
+ readonly type: 'delete-resource';
176
+ readonly id: string;
177
+ };
178
+ /** @experimental */
179
+ export interface DocumentEvent3D {
180
+ readonly kind: 'change' | 'preview' | 'destroy';
181
+ readonly snapshot: DocumentSnapshot3D;
182
+ }
@@ -0,0 +1,18 @@
1
+ import { MaterialOptions3D } from '../model/Material.js';
2
+ import { ResolvedDocumentLimits3D } from './DocumentSchema.js';
3
+ import { DocumentMaterial3D, DocumentResource3D, DocumentSnapshot3D } from './DocumentTypes.js';
4
+ import { Nova3DTexture } from '../model/Texture.js';
5
+ export declare function materialOptions3D(resource: DocumentMaterial3D, textures: ReadonlyMap<string, Nova3DTexture>): MaterialOptions3D;
6
+ export declare function geometryOptions3D(resource: Extract<DocumentResource3D, {
7
+ type: 'geometry';
8
+ }>): {
9
+ positions: Float32Array<ArrayBuffer>;
10
+ normals: Float32Array<ArrayBuffer> | undefined;
11
+ uvs: Float32Array<ArrayBuffer> | undefined;
12
+ indices: Uint32Array<ArrayBuffer> | undefined;
13
+ topology: "triangles" | "points" | "lines" | undefined;
14
+ };
15
+ /** Uses the canonical CPU validators; no app, device or GPU is created. */
16
+ /** Validates a snapshot; failures of the shared object validators count as malformed content (`format`). */
17
+ export declare function validateDocument3D(input: unknown, limits: ResolvedDocumentLimits3D): DocumentSnapshot3D;
18
+ export declare function freezeDocument3D<T>(value: T): T;
@@ -0,0 +1,65 @@
1
+ import { Nova3DModelAsset } from '../import/ModelAsset.js';
2
+ import { Nova3DApp } from '../Nova3DApp.js';
3
+ import { ReadyOptions3D } from '../tools/Ready.js';
4
+ import { Nova3DDocument } from './Document.js';
5
+ import { DocumentAsset3D } from './DocumentTypes.js';
6
+ import { Nova3DNode } from '../model/Node.js';
7
+ /**
8
+ * What `resolveAsset` receives with each asset reference.
9
+ * @experimental
10
+ */
11
+ export interface DocumentAssetContext3D {
12
+ readonly app: Nova3DApp;
13
+ readonly signal: AbortSignal;
14
+ }
15
+ /**
16
+ * Options of `createDocumentProjection`.
17
+ * @experimental
18
+ */
19
+ export interface DocumentProjectionOptions3D {
20
+ /** Assets are borrowed from the resolver; projection owns only their model instances. */
21
+ resolveAsset?: (reference: Readonly<DocumentAsset3D>, context: DocumentAssetContext3D) => Nova3DModelAsset | PromiseLike<Nova3DModelAsset>;
22
+ }
23
+ /**
24
+ * Projects logical state into a dedicated scene; external editor helpers remain independent.
25
+ * @experimental
26
+ */
27
+ export declare class Nova3DDocumentProjection {
28
+ protected constructor();
29
+ private readonly _app;
30
+ private readonly _document;
31
+ private readonly _options;
32
+ readonly scene: ReturnType<Nova3DApp['createScene']>;
33
+ private readonly _nodes;
34
+ private readonly _models;
35
+ private _resources;
36
+ private _snapshot?;
37
+ private readonly _assets;
38
+ private _controller?;
39
+ private _pending;
40
+ private _epoch;
41
+ private _writing;
42
+ private _destroyed;
43
+ private readonly _detach;
44
+ private readonly _unsubscribe;
45
+ private readonly _guard;
46
+ getNode(id: string): Nova3DNode | undefined;
47
+ /** Resolves once the latest document snapshot is applied; rejects when it fails or the projection is destroyed. */
48
+ whenReady(options?: ReadyOptions3D): Promise<void>;
49
+ get destroyed(): boolean;
50
+ destroy(): void;
51
+ private _schedule;
52
+ private _resolve;
53
+ private _reconcile;
54
+ private _createNode;
55
+ private _applyTransforms;
56
+ private _guardTree;
57
+ private _release;
58
+ private _write;
59
+ }
60
+ /**
61
+ * Projects `document` into a new scene of `app`, kept in sync until destroyed.
62
+ * Owned by the app: destroyed with it.
63
+ * @experimental
64
+ */
65
+ export declare function createDocumentProjection(app: Nova3DApp, document: Nova3DDocument, options?: DocumentProjectionOptions3D): Nova3DDocumentProjection;
@@ -0,0 +1,24 @@
1
+ import { TextureOptions3D } from '../model/Texture.js';
2
+ /**
3
+ * A parsed Adobe/Resolve `.cube` 3D table.
4
+ * @experimental
5
+ */
6
+ export interface CubeLUT3D {
7
+ readonly title: string;
8
+ readonly size: number;
9
+ readonly domainMin: readonly [number, number, number];
10
+ readonly domainMax: readonly [number, number, number];
11
+ /** Options for `app.createTexture`: a cubic linear rgba16f volume, red fastest. */
12
+ readonly texture: TextureOptions3D & {
13
+ dimension: '3d';
14
+ format: 'rgba16f';
15
+ data: Float32Array;
16
+ };
17
+ }
18
+ /**
19
+ * Parses a `.cube` 3D LUT (TITLE, LUT_3D_SIZE 2..256, DOMAIN_MIN/MAX, then
20
+ * size³ RGB rows with red changing fastest). Values are clamped to the
21
+ * rgba16f range [0, 65504]; 1D tables are rejected.
22
+ * @experimental
23
+ */
24
+ export declare function parseCubeLUT(text: string): Promise<CubeLUT3D>;
@@ -0,0 +1,32 @@
1
+ import { Nova3DApp } from '../Nova3DApp.js';
2
+ import { EffectsOptions3D, EffectStage3D } from './EffectsPlan.js';
3
+ import { Nova3DMesh } from '../model/Mesh.js';
4
+ /**
5
+ * Explicit optional addon; app owns its attachment and renderer owns its GPU generation.
6
+ * @experimental
7
+ */
8
+ export declare class Nova3DEffects {
9
+ protected constructor();
10
+ private readonly _app;
11
+ private readonly _processor;
12
+ private readonly _cleanup;
13
+ private readonly _budget;
14
+ private _destroyed;
15
+ /** Replaces the whole ordered stage list; a rejected list leaves the active one unchanged. */
16
+ setStages(stages: readonly EffectStage3D[]): void;
17
+ /**
18
+ * Meshes drawn into the `outline` stage mask, in the scene of the first canvas
19
+ * view. Destroyed, hidden or other-scene meshes are skipped while drawing.
20
+ * The list is copied; at most 1024 meshes.
21
+ * @experimental
22
+ */
23
+ setOutlineSelection(meshes: readonly Nova3DMesh[]): void;
24
+ get destroyed(): boolean;
25
+ destroy(): void;
26
+ private _assertAlive;
27
+ }
28
+ /**
29
+ * Owned by the app: destroyed with it.
30
+ * @experimental
31
+ */
32
+ export declare function createEffects(app: Nova3DApp, options: EffectsOptions3D): Nova3DEffects;