@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,133 @@
1
+ import { Nova3DNode } from '../model/Node.js';
2
+ /** @experimental */
3
+ export type SoundState3D = 'stopped' | 'playing' | 'paused';
4
+ /** @experimental */
5
+ export type DistanceModel3D = 'linear' | 'inverse' | 'exponential';
6
+ /** @experimental */
7
+ export type PanningModel3D = 'HRTF' | 'equalpower';
8
+ /**
9
+ * Playback settings shared by plain and positional sounds.
10
+ * @experimental
11
+ */
12
+ export interface SoundOptions3D {
13
+ /** Decoded audio; `null` leaves the sound silent until a buffer is set. */
14
+ buffer?: AudioBuffer | null;
15
+ /** Linear gain, `>= 0`. Default 1. */
16
+ volume?: number;
17
+ muted?: boolean;
18
+ loop?: boolean;
19
+ /** Loop region start in seconds, `>= 0`. Default 0. */
20
+ loopStart?: number;
21
+ /** Loop region end in seconds; 0 loops to the buffer end. Default 0. */
22
+ loopEnd?: number;
23
+ /** Playback speed, `> 0`. Default 1. */
24
+ playbackRate?: number;
25
+ }
26
+ /**
27
+ * Distance attenuation and directional cone of a positional sound.
28
+ * @experimental
29
+ */
30
+ export interface SpatialOptions3D {
31
+ /** Default `'inverse'`. */
32
+ distanceModel?: DistanceModel3D;
33
+ /** Distance where attenuation starts, `>= 0`. Default 1. */
34
+ refDistance?: number;
35
+ /** Distance where linear attenuation stops, `> 0`. Default 10000. */
36
+ maxDistance?: number;
37
+ /** Attenuation speed, `>= 0`. Default 1. */
38
+ rolloffFactor?: number;
39
+ /** Full-volume cone around the node local −Z, radians in `[0, 2π]`. Default 2π. */
40
+ coneInnerAngle?: number;
41
+ /** Outer cone, radians in `[0, 2π]`. Default 2π. */
42
+ coneOuterAngle?: number;
43
+ /** Gain outside the outer cone, `[0, 1]`. Default 0. */
44
+ coneOuterGain?: number;
45
+ /** Default `'HRTF'`. */
46
+ panningModel?: PanningModel3D;
47
+ }
48
+ /**
49
+ * Patch of `positionalSound.set` and the result of its `getOptions`.
50
+ * @experimental
51
+ */
52
+ export interface PositionalSoundPatch3D extends SoundOptions3D, SpatialOptions3D {
53
+ }
54
+ /** @experimental */
55
+ export interface PositionalSoundOptions3D extends PositionalSoundPatch3D {
56
+ /** Node whose world position and local −Z drive the emitter. */
57
+ node: Nova3DNode;
58
+ }
59
+ export declare const soundKeys3D: ReadonlySet<string>;
60
+ export declare const positionalSoundKeys3D: ReadonlySet<string>;
61
+ /** Narrow view of the owning audio system. @internal */
62
+ export interface SoundHost3D {
63
+ readonly context: BaseAudioContext;
64
+ }
65
+ /**
66
+ * Non-positional sound: one buffer played through its own gain into the audio system.
67
+ * Each `play()` creates a one-shot `AudioBufferSourceNode`; the graph is otherwise fixed.
68
+ * @experimental
69
+ */
70
+ export declare class Nova3DSound {
71
+ protected constructor();
72
+ private _options;
73
+ private _source;
74
+ private _state;
75
+ /** Buffer position (seconds) at `_startedAt`. */
76
+ private _offset;
77
+ private _startedAt;
78
+ private readonly _endedListeners;
79
+ private readonly _ended;
80
+ get destroyed(): boolean;
81
+ /** A non-looping sound reached its end on its own (not by `stop`); returns unsubscribe. */
82
+ onEnded(listener: () => void): () => void;
83
+ get state(): SoundState3D;
84
+ get buffer(): AudioBuffer | null;
85
+ /** Buffer duration in seconds, 0 without a buffer. */
86
+ get duration(): number;
87
+ /** Current position in buffer seconds, folded into the loop region while looping. */
88
+ get currentTime(): number;
89
+ /** The playback options with every default filled in. */
90
+ getOptions(): Readonly<SoundOptions3D>;
91
+ /** Applies a validated patch; a new buffer stops current playback. */
92
+ set(patch: SoundOptions3D): void;
93
+ /** Starts or resumes from the current position. A no-op while playing. */
94
+ play(): void;
95
+ /** Keeps the position; `play()` continues from it. */
96
+ pause(): void;
97
+ /** Stops and rewinds to 0. */
98
+ stop(): void;
99
+ /** Moves to `time` seconds; playing sounds continue from there without a gap in state. */
100
+ seek(time: number): void;
101
+ /** Stops playback and disconnects every node this sound owns. */
102
+ destroy(): void;
103
+ private _apply;
104
+ private _start;
105
+ private _halt;
106
+ }
107
+ /**
108
+ * Sound placed at a node: a `PannerNode` follows the node world position and local −Z.
109
+ * The owning `Nova3DAudio` writes the panner only when the node world matrix changed.
110
+ * @experimental
111
+ */
112
+ export declare class Nova3DPositionalSound extends Nova3DSound {
113
+ protected constructor();
114
+ private readonly _panner;
115
+ private _node;
116
+ private _spatial;
117
+ /** Last written world matrix; NaN forces the next sync. */
118
+ private readonly _written;
119
+ get node(): Nova3DNode;
120
+ /** The panner, for advanced routing; Nova owns its position and orientation. */
121
+ get panner(): PannerNode;
122
+ /** Moves the emitter to another live node of the same app (Babylon `attachToMesh`). */
123
+ attach(node: Nova3DNode): void;
124
+ /** The playback and spatial options with every default filled in. */
125
+ getOptions(): Readonly<PositionalSoundPatch3D>;
126
+ /** Applies a validated playback and spatial patch; a new buffer stops current playback. */
127
+ set(patch: PositionalSoundPatch3D): void;
128
+ private _writeSpatial;
129
+ }
130
+ /** True when any of the 16 matrix values differs. */
131
+ export declare function changed(matrix: Float32Array, written: Float32Array): boolean;
132
+ /** Immediate on the first write or without smoothing, otherwise an exponential approach. */
133
+ export declare function write(param: AudioParam, value: number, time: number, smoothing: number, immediate: boolean): void;
@@ -0,0 +1,61 @@
1
+ import { Nova3DOctree } from '../collision/Octree.js';
2
+ import { Vector3D } from '../types.js';
3
+ /** Настройки капсулы для статического уровня. @experimental */
4
+ export interface CharacterControllerOptions3D {
5
+ position?: Vector3D;
6
+ radius?: number;
7
+ height?: number;
8
+ speed?: number;
9
+ gravity?: number;
10
+ jumpSpeed?: number;
11
+ stepHeight?: number;
12
+ maxSlopeAngle?: number;
13
+ skin?: number;
14
+ maxSubSteps?: number;
15
+ }
16
+ /** World-space ввод одного фиксированного тика. @experimental */
17
+ export interface CharacterInput3D {
18
+ moveX: number;
19
+ moveZ: number;
20
+ jump?: boolean;
21
+ }
22
+ /** Кинематическая капсула без собственного времени и подписок. @experimental */
23
+ export declare class Nova3DCharacterController {
24
+ protected constructor();
25
+ private readonly _octree;
26
+ private readonly _capsule;
27
+ private readonly _before;
28
+ private readonly _probe;
29
+ private readonly _offset;
30
+ private readonly _velocity;
31
+ private readonly _hit;
32
+ private readonly _stepHit;
33
+ private readonly _radius;
34
+ private readonly _height;
35
+ private readonly _speed;
36
+ private readonly _gravity;
37
+ private readonly _jumpSpeed;
38
+ private readonly _stepHeight;
39
+ private readonly _slope;
40
+ private readonly _skin;
41
+ private readonly _maxSubSteps;
42
+ private _grounded;
43
+ private _jumpHeld;
44
+ private _destroyed;
45
+ get grounded(): boolean;
46
+ get destroyed(): boolean;
47
+ get velocity(): Readonly<Float64Array>;
48
+ /** Положение ног в массив вызывающего. */
49
+ getPosition<T extends number[] | Float32Array | Float64Array>(out: T): T;
50
+ /** Перенос без сохранения скорости и состояния опоры. */
51
+ teleport(position: Vector3D): void;
52
+ /** Один фиксированный тик с ограниченными substeps, без временных объектов. */
53
+ update(dt: number, input: CharacterInput3D): void;
54
+ /** Не освобождает заимствованное дерево уровня. */
55
+ destroy(): void;
56
+ private _tryStep;
57
+ private _shift;
58
+ private _alive;
59
+ }
60
+ /** Создаёт контроллер со своими scratch-буферами. @experimental */
61
+ export declare function createCharacterController(octree: Nova3DOctree, options?: CharacterControllerOptions3D): Nova3DCharacterController;
@@ -0,0 +1,25 @@
1
+ /**
2
+ * A capsule: a segment from `start` to `end` swept by a sphere of `radius`. Positions are
3
+ * mutable xyz arrays so a character can move every substep without allocating.
4
+ * @experimental
5
+ */
6
+ export declare class Nova3DCapsule {
7
+ protected constructor();
8
+ readonly start: Float64Array;
9
+ readonly end: Float64Array;
10
+ radius: number;
11
+ /** Replaces both points and the radius. */
12
+ set(start: ArrayLike<number>, end: ArrayLike<number>, radius: number): this;
13
+ copy(capsule: Nova3DCapsule): this;
14
+ /** Middle of the segment into `out`. */
15
+ getCenter(out?: Float64Array | number[]): Float64Array | number[];
16
+ /** Moves both points by `offset` (scaled by `scale`). */
17
+ translate(offset: ArrayLike<number>, scale?: number): this;
18
+ /** Conservative test against an axis-aligned box `[minX, minY, minZ, maxX, maxY, maxZ]` at `offset`. */
19
+ intersectsBox(box: ArrayLike<number>, offset?: number): boolean;
20
+ }
21
+ /**
22
+ * Creates a capsule from `start` to `end` with `radius`.
23
+ * @experimental
24
+ */
25
+ export declare function createCapsule(start?: ArrayLike<number>, end?: ArrayLike<number>, radius?: number): Nova3DCapsule;
@@ -0,0 +1,94 @@
1
+ import { Nova3DNode } from '../model/Node.js';
2
+ import { Nova3DCapsule } from './Capsule.js';
3
+ /**
4
+ * Result of a collision query: push the shape by `normal * depth` to resolve it.
5
+ * `normal` is reused by the next query with the same `out`.
6
+ * @experimental
7
+ */
8
+ export interface CollisionHit3D {
9
+ readonly normal: Float64Array;
10
+ depth: number;
11
+ }
12
+ /**
13
+ * Result of `rayIntersect`: the nearest front-facing triangle along the ray.
14
+ * @experimental
15
+ */
16
+ export interface RayHit3D {
17
+ readonly point: Float64Array;
18
+ distance: number;
19
+ /** Index of the hit triangle in insertion order. */
20
+ triangle: number;
21
+ }
22
+ /**
23
+ * Octree options.
24
+ * @experimental
25
+ */
26
+ export interface OctreeOptions3D {
27
+ /** Leaf size before a node splits; defaults to 8, as in three.js. */
28
+ trianglesPerLeaf?: number;
29
+ /** Maximum depth; defaults to 16. */
30
+ maxLevel?: number;
31
+ }
32
+ /**
33
+ * Static triangle octree for character and projectile collisions against level geometry:
34
+ * capsule, sphere and ray queries. Built once from meshes or raw triangles; queries do not
35
+ * allocate when an `out` object is passed.
36
+ * @experimental
37
+ */
38
+ export declare class Nova3DOctree {
39
+ protected constructor();
40
+ private readonly _perLeaf;
41
+ private readonly _maxLevel;
42
+ private _pending;
43
+ private _built;
44
+ /** 9 coordinates per triangle. */
45
+ private _triangles;
46
+ /** Plane per triangle: normal xyz and constant. */
47
+ private _planes;
48
+ /** Node boxes, 6 per node: min xyz, max xyz. */
49
+ private _boxes;
50
+ /** Per node: first child index and child count, first leaf entry and leaf entry count. */
51
+ private _nodes;
52
+ private _children;
53
+ private _leaves;
54
+ private _visit;
55
+ private _stamp;
56
+ private _stack;
57
+ private _found;
58
+ private readonly _capsule;
59
+ private readonly _hit;
60
+ private readonly _v;
61
+ /** Number of triangles in the tree. */
62
+ get triangleCount(): number;
63
+ /** Bounds of the built tree `[minX, minY, minZ, maxX, maxY, maxZ]`, or null when empty. */
64
+ get bounds(): Float64Array | null;
65
+ /** Adds triangles from xyz positions, optional indices and an optional column-major world matrix. */
66
+ addTriangles(positions: ArrayLike<number>, indices?: ArrayLike<number> | null, matrix?: ArrayLike<number> | null): this;
67
+ /** Adds every triangle mesh under `node` (including it) in world space. Instanced meshes are skipped. */
68
+ addNode(node: Nova3DNode): this;
69
+ /** Splits the tree. Call once after adding triangles; queries need a built tree. */
70
+ build(): this;
71
+ /** Resolves a capsule against the level; returns null when it touches nothing. */
72
+ capsuleIntersect(capsule: Nova3DCapsule, out?: CollisionHit3D): CollisionHit3D | null;
73
+ /** Resolves a sphere at `center` with `radius`; returns null when it touches nothing. */
74
+ sphereIntersect(center: ArrayLike<number>, radius: number, out?: CollisionHit3D): CollisionHit3D | null;
75
+ /** Nearest front-facing triangle along a ray with a unit `direction`. */
76
+ rayIntersect(origin: ArrayLike<number>, direction: ArrayLike<number>, out?: RayHit3D): RayHit3D | null;
77
+ /** Visits leaf boxes `[minX, minY, minZ, maxX, maxY, maxZ]` for debug drawing. */
78
+ forEachLeafBox(visit: (box: Float64Array) => void): void;
79
+ private _split;
80
+ private _flatten;
81
+ /** Collects unique candidate triangles (three.js order) into `_found`; capsule or sphere bounds. */
82
+ private _collect;
83
+ private _pushChildren;
84
+ private _nextStamp;
85
+ private _triangleCapsule;
86
+ private _triangleSphere;
87
+ private _assertOpen;
88
+ private _assertBuilt;
89
+ }
90
+ /**
91
+ * Creates an empty octree; add triangles or nodes, then call `build()`.
92
+ * @experimental
93
+ */
94
+ export declare function createOctree(options?: OctreeOptions3D): Nova3DOctree;
@@ -0,0 +1,154 @@
1
+ import { Nova3DCamera } from '../model/Camera.js';
2
+ import { Nova3DApp } from '../Nova3DApp.js';
3
+ import { CameraOrientation } from './CameraOrientation.js';
4
+ /**
5
+ * Keyboard actions of fly and first-person controls.
6
+ * @experimental
7
+ */
8
+ export type CameraKeyAction3D = 'forward' | 'backward' | 'left' | 'right' | 'up' | 'down' | 'rollLeft' | 'rollRight' | 'boost';
9
+ /**
10
+ * Action → `KeyboardEvent.code` values (layout-independent codes such as `KeyW`).
11
+ * @experimental
12
+ */
13
+ export type CameraKeyMap3D = Readonly<Record<CameraKeyAction3D, readonly string[]>>;
14
+ /** @experimental */
15
+ export interface CameraMotionOptions3D {
16
+ camera: Nova3DCamera;
17
+ /** Speed in m/s; default 5. */
18
+ speed?: number;
19
+ /** Speed multiplier while `boost` is held; default 3. */
20
+ boostMultiplier?: number;
21
+ /** Radians per pixel of pointer motion; default 0.002. */
22
+ lookSpeed?: number;
23
+ /** 0 or 1 — no smoothing; otherwise the per-60 Hz-frame convergence share, as orbit controls. */
24
+ damping?: number;
25
+ /** A click on the canvas requests pointer lock instead of drag-look. */
26
+ pointerLock?: boolean;
27
+ /** Pitch limits in radians within [-π/2, π/2]. */
28
+ minPitch?: number;
29
+ maxPitch?: number;
30
+ /** Partial key map; actions left out keep their default keys. */
31
+ keys?: Partial<CameraKeyMap3D>;
32
+ }
33
+ /** @experimental */
34
+ export interface FlyControlsOptions3D extends CameraMotionOptions3D {
35
+ /** Free 6DOF orientation with roll; by default yaw about +Y with limited pitch. */
36
+ freeLook?: boolean;
37
+ /** Roll speed in radians per second with `freeLook`; default 1. */
38
+ rollSpeed?: number;
39
+ }
40
+ /** @experimental */
41
+ export type FirstPersonControlsOptions3D = CameraMotionOptions3D;
42
+ /**
43
+ * Keyboard motion and look of the active camera, shared by fly and first-person
44
+ * controls. Idle controls request no frames; motion runs on one frame lease and
45
+ * the move and tick paths allocate nothing.
46
+ * @experimental
47
+ */
48
+ export declare class Nova3DCameraMotionControls {
49
+ protected constructor();
50
+ private readonly _app;
51
+ private readonly _camera;
52
+ private readonly _orientation;
53
+ private readonly _label;
54
+ private readonly _gesture;
55
+ private readonly _lockSession;
56
+ private readonly _cleanup;
57
+ private readonly _lockListeners;
58
+ private readonly _codes;
59
+ private readonly _pressed;
60
+ private readonly _counts;
61
+ private readonly _position;
62
+ private readonly _quaternion;
63
+ private readonly _right;
64
+ private readonly _up;
65
+ private readonly _forward;
66
+ /** Velocity along right/up/forward in m/s. */
67
+ private readonly _velocity;
68
+ private readonly _patch;
69
+ private readonly _initial;
70
+ private readonly _speed;
71
+ private readonly _boost;
72
+ private readonly _look;
73
+ private readonly _damping;
74
+ private readonly _smooth;
75
+ private readonly _rollSpeed;
76
+ private readonly _pointerLock;
77
+ private readonly _loop;
78
+ private _pendingYaw;
79
+ private _pendingPitch;
80
+ private _lease?;
81
+ private _fresh;
82
+ private _lastX;
83
+ private _lastY;
84
+ private _enabled;
85
+ private _destroyed;
86
+ get enabled(): boolean;
87
+ /** Whether pointer lock is active. */
88
+ get locked(): boolean;
89
+ get destroyed(): boolean;
90
+ setEnabled(enabled: boolean): void;
91
+ /** Requests pointer lock on the canvas; call it from a user gesture handler. */
92
+ lock(): boolean;
93
+ unlock(): void;
94
+ onLockChange(listener: (locked: boolean) => void): () => void;
95
+ /** Re-reads the camera pose after an external change during motion. */
96
+ sync(): void;
97
+ reset(): void;
98
+ destroy(): void;
99
+ /**
100
+ * `full` also checks the active view; app.view copies the object, so hot
101
+ * paths (tick, move) use the light check.
102
+ */
103
+ private _active;
104
+ private _read;
105
+ private _write;
106
+ private _keyDown;
107
+ private _keyUp;
108
+ private _releaseKeys;
109
+ /** Without damping, released keys stop the motion at once and release the frame lease. */
110
+ private _settle;
111
+ private _held;
112
+ private _wantsFrames;
113
+ private _begin;
114
+ private _drag;
115
+ private _lockClick;
116
+ private _lockMove;
117
+ private _lockChanged;
118
+ private _turn;
119
+ private _focus;
120
+ private _schedule;
121
+ private _tick;
122
+ /** Stops all motion, the gesture and the lock; the camera keeps its current pose. */
123
+ private _halt;
124
+ private _clearMotion;
125
+ private _stop;
126
+ private _assertAlive;
127
+ }
128
+ /**
129
+ * Fly camera controls; see `createFlyControls`.
130
+ * @experimental
131
+ */
132
+ export declare class Nova3DFlyControls extends Nova3DCameraMotionControls {
133
+ protected constructor();
134
+ }
135
+ /**
136
+ * First-person camera controls; see `createFirstPersonControls`.
137
+ * @experimental
138
+ */
139
+ export declare class Nova3DFirstPersonControls extends Nova3DCameraMotionControls {
140
+ protected constructor();
141
+ }
142
+ /**
143
+ * Fly camera: WASD/QE motion along the camera axes, drag or pointer lock to look.
144
+ * Yaw turns about +Y with limited pitch by default; `freeLook` enables 6DOF with
145
+ * roll. Owned by the app: destroyed with it.
146
+ * @experimental
147
+ */
148
+ export declare function createFlyControls(app: Nova3DApp, options: FlyControlsOptions3D): Nova3DFlyControls;
149
+ /**
150
+ * First-person camera: pointer lock look, yaw about +Y, limited pitch and WASD
151
+ * motion in the horizontal plane. Owned by the app: destroyed with it.
152
+ * @experimental
153
+ */
154
+ export declare function createFirstPersonControls(app: Nova3DApp, options: FirstPersonControlsOptions3D): Nova3DFirstPersonControls;
@@ -0,0 +1,47 @@
1
+ type Vec3 = [number, number, number];
2
+ type Quat = [number, number, number, number];
3
+ /**
4
+ * Camera orientation model of fly and first-person controls. Every method writes into
5
+ * the arrays passed in and creates no objects.
6
+ */
7
+ export interface CameraOrientation {
8
+ /** Accepts roll input; otherwise roll keys are not captured. */
9
+ readonly rolls: boolean;
10
+ /** Reads the orientation from the camera's normalized local quaternion. */
11
+ read: (quaternion: Quat) => void;
12
+ /** Applies yaw/pitch/roll increments (radians) and writes the quaternion. */
13
+ rotate: (yaw: number, pitch: number, roll: number, quaternion: Quat) => void;
14
+ /** Writes the right/up/forward motion axes in the camera parent's space. */
15
+ basis: (quaternion: Quat, right: Vec3, up: Vec3, forward: Vec3) => void;
16
+ }
17
+ /** Wraps an angle into [-π, π). */
18
+ export declare function wrapAngle(angle: number): number;
19
+ /**
20
+ * Yaw about the parent's +Y and limited pitch about local X; roll is always 0.
21
+ * `flat` projects forward/right onto the horizontal plane (first-person).
22
+ */
23
+ export declare class LevelOrientation implements CameraOrientation {
24
+ private readonly _minPitch;
25
+ private readonly _maxPitch;
26
+ private readonly _flat;
27
+ readonly rolls = false;
28
+ yaw: number;
29
+ pitch: number;
30
+ constructor(_minPitch: number, _maxPitch: number, _flat: boolean);
31
+ read(q: Quat): void;
32
+ rotate(yaw: number, pitch: number, _roll: number, q: Quat): void;
33
+ /** q = Ry(yaw) · Rx(pitch). */
34
+ write(q: Quat): void;
35
+ basis(q: Quat, right: Vec3, up: Vec3, forward: Vec3): void;
36
+ }
37
+ /**
38
+ * Free 6DOF orientation: yaw/pitch/roll about the camera's local axes, unclamped.
39
+ */
40
+ export declare class FreeOrientation implements CameraOrientation {
41
+ readonly rolls = true;
42
+ read(): void;
43
+ /** q = q · Ry(yaw) · Rx(pitch) · Rz(roll), then normalized against accumulated error. */
44
+ rotate(yaw: number, pitch: number, roll: number, q: Quat): void;
45
+ basis(q: Quat, right: Vec3, up: Vec3, forward: Vec3): void;
46
+ }
47
+ export {};
@@ -0,0 +1,73 @@
1
+ import { Nova3DCamera } from '../model/Camera.js';
2
+ import { Nova3DApp } from '../Nova3DApp.js';
3
+ import { Vector3D } from '../types.js';
4
+ /** @experimental */
5
+ export interface OrbitControlsOptions3D {
6
+ camera: Nova3DCamera;
7
+ /** World point the camera orbits. */
8
+ target: Vector3D;
9
+ /** Closest camera distance to the target in metres. */
10
+ minDistance?: number;
11
+ /** Farthest camera distance to the target in metres. */
12
+ maxDistance?: number;
13
+ /** Smallest angle from world +Y in radians, in [0, π]. */
14
+ minPolarAngle?: number;
15
+ /** Largest angle from world +Y in radians, in [0, π]. */
16
+ maxPolarAngle?: number;
17
+ /** 0 or 1 — immediate; otherwise the per-60 Hz-frame convergence share. */
18
+ damping?: number;
19
+ }
20
+ /**
21
+ * Orbit, pan and wheel zoom of the active camera around a target. Idle controls
22
+ * request no frames; damping runs on one frame lease.
23
+ * @experimental
24
+ */
25
+ export declare class Nova3DOrbitControls {
26
+ protected constructor();
27
+ private readonly _app;
28
+ private readonly _camera;
29
+ private readonly _gesture;
30
+ private readonly _cleanup;
31
+ private readonly _initial;
32
+ private readonly _initialProjection;
33
+ private readonly _initialTarget;
34
+ private readonly _min;
35
+ private readonly _max;
36
+ private readonly _minPolar;
37
+ private readonly _maxPolar;
38
+ private readonly _damping;
39
+ private _target;
40
+ private _goal;
41
+ private _lease?;
42
+ private _saved?;
43
+ private _point;
44
+ private _button;
45
+ private _enabled;
46
+ private _destroyed;
47
+ get enabled(): boolean;
48
+ get destroyed(): boolean;
49
+ /** Disabling stops a drag and any damped motion. */
50
+ setEnabled(enabled: boolean): void;
51
+ /** Moves the orbit centre; the camera keeps its position and turns to the target. */
52
+ setTarget(target: Vector3D): void;
53
+ /** Restores the camera pose, projection and target from creation. */
54
+ reset(): void;
55
+ destroy(): void;
56
+ private _active;
57
+ private _begin;
58
+ private _move;
59
+ private _readSpherical;
60
+ private _apply;
61
+ private _schedule;
62
+ private _tick;
63
+ private _cancel;
64
+ private _stop;
65
+ private _clampRadius;
66
+ private _assertAlive;
67
+ }
68
+ /**
69
+ * Connects orbit, pan and wheel zoom to the active camera of `app`. Owned by the
70
+ * app: destroyed with it.
71
+ * @experimental
72
+ */
73
+ export declare function createOrbitControls(app: Nova3DApp, options: OrbitControlsOptions3D): Nova3DOrbitControls;
@@ -0,0 +1,25 @@
1
+ import { Nova3DApp } from '../Nova3DApp.js';
2
+ interface GestureCallbacks {
3
+ begin: (event: PointerEvent) => boolean;
4
+ move: (event: PointerEvent) => void;
5
+ end: (event: PointerEvent) => void;
6
+ cancel: () => void;
7
+ }
8
+ /**
9
+ * Owns the capture of one pointer and releases the shared input owner before the cancel callback.
10
+ */
11
+ export declare class PointerGesture {
12
+ private readonly _app;
13
+ private readonly _callbacks;
14
+ private _pointer;
15
+ private _destroyed;
16
+ private readonly _cleanup;
17
+ constructor(_app: Nova3DApp, _callbacks: GestureCallbacks, capture?: boolean);
18
+ cancel(): void;
19
+ destroy(): void;
20
+ private _begin;
21
+ private _move;
22
+ private _end;
23
+ private _release;
24
+ }
25
+ export {};
@@ -0,0 +1,36 @@
1
+ import { Nova3DApp } from '../Nova3DApp.js';
2
+ export type PointerLockState3D = 'unlocked' | 'pending' | 'locked';
3
+ interface PointerLockCallbacks {
4
+ change: (locked: boolean) => void;
5
+ move: (dx: number, dy: number) => void;
6
+ }
7
+ /**
8
+ * Owns the pointer lock of one canvas: unlocked → pending → locked and back.
9
+ * While the lock is requested or held, the session holds the app's shared input owner.
10
+ */
11
+ export declare class PointerLockSession {
12
+ private readonly _app;
13
+ private readonly _callbacks;
14
+ private _state;
15
+ private _request;
16
+ private _abandoned;
17
+ private _destroyed;
18
+ private readonly _document;
19
+ private readonly _cleanup;
20
+ constructor(_app: Nova3DApp, _callbacks: PointerLockCallbacks);
21
+ get state(): PointerLockState3D;
22
+ /**
23
+ * Requests the lock; the result arrives through pointerlockchange or pointerlockerror.
24
+ * Returns false when another owner already holds the canvas.
25
+ */
26
+ request(): boolean;
27
+ /** Releases the lock or cancels a request not yet granted. */
28
+ exit(): void;
29
+ destroy(): void;
30
+ private _changed;
31
+ private _failed;
32
+ private _move;
33
+ /** A lock granted after destroy goes back to the browser at once. */
34
+ private _releaseLateGrant;
35
+ }
36
+ export {};
@@ -0,0 +1,32 @@
1
+ import { Vector3D } from '../types.js';
2
+ /**
3
+ * Grid of `snapRotation` (radians) and `snapScale`.
4
+ * @experimental
5
+ */
6
+ export interface SnapOptions3D {
7
+ /** Positive grid step. */
8
+ step: number;
9
+ }
10
+ /**
11
+ * Grid of `snapTranslation`: a step in metres and the grid origin.
12
+ * @experimental
13
+ */
14
+ export interface TranslationSnapOptions3D extends SnapOptions3D {
15
+ /** Default [0, 0, 0]. */
16
+ origin?: Vector3D;
17
+ }
18
+ /**
19
+ * Snaps a world or local position to the caller's grid.
20
+ * @experimental
21
+ */
22
+ export declare function snapTranslation(position: Vector3D, options: TranslationSnapOptions3D): Vector3D;
23
+ /**
24
+ * Snaps an angle in radians to multiples of `step` radians, keeping its period.
25
+ * @experimental
26
+ */
27
+ export declare function snapRotation(angle: number, options: SnapOptions3D): number;
28
+ /**
29
+ * Snaps each scale axis to multiples of `step`; signs are kept and zero is a valid result.
30
+ * @experimental
31
+ */
32
+ export declare function snapScale(scale: Vector3D, options: SnapOptions3D): Vector3D;