@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,31 @@
1
+ import { Nova3DTexture } from './Texture.js';
2
+ /**
3
+ * Options of `app.createEnvironment`.
4
+ * @experimental
5
+ */
6
+ export interface EnvironmentOptions3D {
7
+ /** Equirectangular radiance texture, usually linear RGBA16F. */
8
+ source: Nova3DTexture;
9
+ /** Radiance multiplier. Default 1. */
10
+ intensity?: number;
11
+ /** Rotation about world Y in radians. Default 0. */
12
+ rotation?: number;
13
+ }
14
+ /**
15
+ * Image-based lighting from a source texture it keeps; the prefiltered GPU copies
16
+ * belong to the renderer generation.
17
+ * @experimental
18
+ */
19
+ export declare class Nova3DEnvironment {
20
+ protected constructor();
21
+ private readonly _release;
22
+ private readonly _users;
23
+ private _destroyed;
24
+ private _version;
25
+ readonly source: Nova3DTexture;
26
+ readonly intensity: number;
27
+ readonly rotation: number;
28
+ get destroyed(): boolean;
29
+ get version(): number;
30
+ destroy(): void;
31
+ }
@@ -0,0 +1,59 @@
1
+ import { GeometryDeformation3D, GeometryDeformationOptions3D } from '../deformation/GeometryDeformation.js';
2
+ import { Bounds3D, GeometryColumns3D, GeometryDirtyRange3D, GeometryOptions3D, VertexPatch3D } from '../types.js';
3
+ export interface GeometryChange3D {
4
+ readonly version: number;
5
+ readonly attributes: Readonly<Partial<Record<'positions' | 'normals' | 'uvs' | 'uvs1' | 'tangents' | 'colors' | 'indices', GeometryDirtyRange3D>>>;
6
+ }
7
+ /**
8
+ * App-owned vertex data kept on the CPU; GPU copies belong to the backend generation.
9
+ * @experimental
10
+ */
11
+ export declare class Nova3DGeometry {
12
+ protected constructor();
13
+ private _release;
14
+ private readonly _positions;
15
+ private readonly _normals?;
16
+ private readonly _uvs?;
17
+ private readonly _uvs1?;
18
+ private readonly _tangents?;
19
+ /** Input colours and their linear copy uploaded to the GPU (the same array for linear input). */
20
+ private readonly _colors?;
21
+ private readonly _linearColors?;
22
+ private readonly _indices?;
23
+ private readonly _users;
24
+ private readonly _changes;
25
+ private _deformation?;
26
+ private _version;
27
+ private _bounds?;
28
+ private _documentWrite?;
29
+ private _destroyed;
30
+ private _drawStart;
31
+ private _drawCount;
32
+ /** Immutable draw range snapshot, replaced when the range changes. */
33
+ private _drawRange?;
34
+ private _bufferRecord?;
35
+ readonly topology: 'triangles' | 'lines' | 'points';
36
+ readonly usage: 'static' | 'dynamic';
37
+ readonly colorSpace: 'srgb' | 'linear';
38
+ get version(): number;
39
+ get destroyed(): boolean;
40
+ get vertexCount(): number;
41
+ get drawRange(): Readonly<{
42
+ start: number;
43
+ count: number;
44
+ }>;
45
+ getBounds(): Bounds3D | null;
46
+ set(index: number, patch: VertexPatch3D): void;
47
+ /**
48
+ * Validates every column before writing; `start` counts vertices.
49
+ */
50
+ updateRange(start: number, columns: GeometryColumns3D): void;
51
+ updateIndices(start: number, data: Uint16Array | Uint32Array): void;
52
+ setDrawRange(start: number, count: number): void;
53
+ destroy(): void;
54
+ private _column;
55
+ private _assertAlive;
56
+ private _validateColors;
57
+ private _validateFloats;
58
+ private _changed;
59
+ }
@@ -0,0 +1,134 @@
1
+ import { Bounds3D, Color3D, Ray3D, Transform3D, TransformPatch3D } from '../types.js';
2
+ import { Hit3D, MeshOptions3D, Nova3DMesh } from './Mesh.js';
3
+ import { Nova3DScene } from './Scene.js';
4
+ /** @experimental */
5
+ export type InstancedMeshOptions3D = MeshOptions3D & {
6
+ capacity: number;
7
+ count?: number;
8
+ /**
9
+ * Per-instance RGBA (sRGB in [0, 1], default white) multiplying the material
10
+ * colour, as three.js InstancedMesh.setColorAt.
11
+ * @experimental
12
+ */
13
+ colors?: boolean;
14
+ /**
15
+ * Per-instance sprite-sheet frame (default 0) for materials with `spriteSheet`.
16
+ * @experimental
17
+ */
18
+ frames?: boolean;
19
+ };
20
+ export declare const instancedMeshKeys3D: ReadonlySet<string>;
21
+ export interface InstanceChanges3D {
22
+ readonly start: number;
23
+ readonly end: number;
24
+ }
25
+ /** @internal */
26
+ export declare function linearChannelTable(value: number): number;
27
+ /**
28
+ * Fixed-capacity copied instance poses, matrices and a bounded sparse update journal.
29
+ * @experimental
30
+ */
31
+ export declare class Nova3DInstancedMesh extends Nova3DMesh {
32
+ protected constructor();
33
+ readonly capacity: number;
34
+ private _count;
35
+ private readonly _poses;
36
+ private readonly _matrices;
37
+ private _version;
38
+ private readonly _journal;
39
+ private _instancesBounds?;
40
+ private _instancesBoundsVersion;
41
+ private _instancesBoundsWorld;
42
+ private _instancesBoundsGeometry;
43
+ /** Per-instance world boxes `[minX,minY,minZ,maxX,maxY,maxZ]`, valid for a world/geometry version. */
44
+ private _boxes?;
45
+ private _boxesWorld;
46
+ private _boxesGeometry;
47
+ /** Prefix of `_boxes` computed since the last full rebuild. */
48
+ private _boxesCount;
49
+ /** Instance range written since the boxes were last refreshed. */
50
+ private _dirtyStart;
51
+ private _dirtyEnd;
52
+ /** Linear RGBA per instance when created with `colors`. */
53
+ private readonly _colors;
54
+ private _colorVersion;
55
+ private _colorStart;
56
+ private _colorEnd;
57
+ /** Sprite-sheet frame per instance when created with `frames`. */
58
+ private readonly _frames;
59
+ private _frameVersion;
60
+ private _frameStart;
61
+ private _frameEnd;
62
+ get count(): number;
63
+ /** 1 where the instance scale has a negative product (a mirrored instance). */
64
+ private readonly _mirrored;
65
+ private _mirroredCount;
66
+ /** Recounts mirrored instances in [start, end) from the pose scales. */
67
+ private _countMirrors;
68
+ /** Owner pose source behind the last `_writeRecords`; the instance arrays derive from it on first read. */
69
+ private _recordPoses;
70
+ private _recordCount;
71
+ /** Derives poses, matrices, colours and frames of the last records write. */
72
+ private _sync;
73
+ setCount(count: number): void;
74
+ setTransform(transform: TransformPatch3D): void;
75
+ setTransform(index: number, transform: TransformPatch3D): void;
76
+ updateRange(start: number, transforms: readonly TransformPatch3D[]): void;
77
+ /**
78
+ * Writes poses of `[start, start + count)` from packed numbers, 10 per instance:
79
+ * position xyz, quaternion xyzw (normalized here), scale xyz. Validated before
80
+ * any write and allocation-free, for particles and simulations.
81
+ * @experimental
82
+ */
83
+ updatePoses(start: number, data: ArrayLike<number>, count?: number): void;
84
+ /**
85
+ * Whether the mesh was created with per-instance colours (`colors: true`).
86
+ * @experimental
87
+ */
88
+ get colors(): boolean;
89
+ /**
90
+ * Sets the sRGB colour of one instance; [r, g, b] is opaque.
91
+ * @experimental
92
+ */
93
+ setColor(index: number, color: Color3D): void;
94
+ /**
95
+ * Writes sRGB RGBA colours of `[start, start + count)`, 4 numbers each.
96
+ * @experimental
97
+ */
98
+ updateColors(start: number, data: ArrayLike<number>, count?: number): void;
99
+ /**
100
+ * Whether the mesh has per-instance sprite-sheet frames.
101
+ * @experimental
102
+ */
103
+ get frames(): boolean;
104
+ /**
105
+ * Sets the sprite-sheet frame of one instance.
106
+ * @experimental
107
+ */
108
+ setFrame(index: number, frame: number): void;
109
+ /**
110
+ * Writes sprite-sheet frames of `[start, start + count)`: nonnegative integers;
111
+ * frames past the material grid wrap.
112
+ * @experimental
113
+ */
114
+ updateFrames(start: number, data: ArrayLike<number>, count?: number): void;
115
+ getTransform(): Transform3D;
116
+ getTransform(index: number): Transform3D;
117
+ /**
118
+ * Brings the per-instance world boxes of `[0,count)` up to date and returns them.
119
+ * Rewritten boxes below `count` are merged into `rewrittenUnion`; their ranges are
120
+ * left in `rewrittenRanges` so the caller scans only the rest.
121
+ */
122
+ private _refreshBoxes;
123
+ /**
124
+ * World boxes of instances `[start, end)` by the centre/extent form of the affine
125
+ * world × instance matrix, merged into `rewrittenUnion`.
126
+ */
127
+ private _writeBoxes;
128
+ private _worldInstance;
129
+ private _readPose;
130
+ private _write;
131
+ private _checkIndex;
132
+ private _boundsOverride;
133
+ private _changed;
134
+ }
@@ -0,0 +1,31 @@
1
+ import { NodeOptions3D } from '../types.js';
2
+ import { Nova3DCamera } from './Camera.js';
3
+ import { Nova3DScene } from './Scene.js';
4
+ import { Nova3DNode } from './Node.js';
5
+ /**
6
+ * One level of detail: `root` shows from `distance` (metres from the camera) on.
7
+ * @experimental
8
+ */
9
+ export interface LODLevel3D {
10
+ distance: number;
11
+ root: Nova3DNode;
12
+ }
13
+ /** @experimental */
14
+ export type LODOptions3D = NodeOptions3D & {
15
+ /** Levels by increasing distance; the first starts at 0. */
16
+ levels: readonly LODLevel3D[];
17
+ /** Fraction of a switch distance that must be crossed back before switching back, in [0, 0.5). Default 0.1. */
18
+ hysteresis?: number;
19
+ };
20
+ export declare const lodKeys3D: ReadonlySet<string>;
21
+ /**
22
+ * Owns explicit level roots; derived selection never overwrites user visibility.
23
+ * @experimental
24
+ */
25
+ export declare class Nova3DLOD extends Nova3DNode {
26
+ protected constructor();
27
+ private readonly _levels;
28
+ private readonly _hysteresis;
29
+ private _active;
30
+ private _selected;
31
+ }
@@ -0,0 +1,200 @@
1
+ import { Color3D, NodeOptions3D } from '../types.js';
2
+ import { Nova3DScene } from './Scene.js';
3
+ import { Nova3DNode } from './Node.js';
4
+ /**
5
+ * Shadow map settings of a directional, point or spot light (`light.setShadows`).
6
+ * @experimental
7
+ */
8
+ export interface LightShadowOptions3D {
9
+ enabled?: boolean;
10
+ resolution?: number;
11
+ bias?: number;
12
+ normalBias?: number;
13
+ near?: number;
14
+ far?: number;
15
+ extent?: number;
16
+ /**
17
+ * 'hard' (default) takes one hardware-filtered sample; 'pcf' averages a rotated
18
+ * 16-tap Poisson kernel of `filterRadius` texels (cube texels across the light
19
+ * direction for point lights); 'pcss' (percentage-closer soft shadows, Babylon
20
+ * contact hardening, PlayCanvas PCSS) searches blockers and widens the kernel with
21
+ * the distance between blocker and receiver.
22
+ * @experimental
23
+ */
24
+ filter?: 'hard' | 'pcf' | 'pcss';
25
+ /** PCF kernel radius in shadow-map texels. Default 1.5. */
26
+ filterRadius?: number;
27
+ /**
28
+ * PCSS emitter size: angular diameter in radians for directional lights (default
29
+ * 0.02), emitter diameter in metres for point and spot lights (default 0.2).
30
+ * @experimental
31
+ */
32
+ lightSize?: number;
33
+ /**
34
+ * Cascaded shadow maps for a directional light (1–4): the camera frustum up to
35
+ * `cascadeDistance` splits by the practical scheme (`cascadeLambda` 0 uniform …
36
+ * 1 logarithmic), each cascade fitted to its slice. One cascaded light per scene;
37
+ * `extent` then is how far behind each slice casters reach.
38
+ * @experimental
39
+ */
40
+ cascades?: number;
41
+ cascadeDistance?: number;
42
+ cascadeLambda?: number;
43
+ }
44
+ /**
45
+ * Sun-like light along the node's local −Z, without falloff.
46
+ * @experimental
47
+ */
48
+ export type DirectionalLightOptions3D = NodeOptions3D & {
49
+ /** sRGB colour; alpha is ignored. Default white. */
50
+ color?: Color3D;
51
+ /** Illuminance in lux (lm/m²) on a surface facing the light. */
52
+ intensity: number;
53
+ };
54
+ /**
55
+ * Omnidirectional light at the node position.
56
+ * @experimental
57
+ */
58
+ export type PointLightOptions3D = NodeOptions3D & {
59
+ /** sRGB colour; alpha is ignored. Default white. */
60
+ color?: Color3D;
61
+ /** Luminous intensity in candela (cd). */
62
+ intensity: number;
63
+ /** Distance in metres where the light fades out; 0 (default) is unlimited inverse-square falloff. */
64
+ range?: number;
65
+ };
66
+ /**
67
+ * Cone light at the node position along its local −Z.
68
+ * @experimental
69
+ */
70
+ export type SpotLightOptions3D = PointLightOptions3D & {
71
+ /** Radians from the axis where the falloff starts, in [0, outerConeAngle]. */
72
+ innerConeAngle: number;
73
+ /** Radians from the axis where the light ends, in (0, π/2). */
74
+ outerConeAngle: number;
75
+ };
76
+ /**
77
+ * Uniform irradiance from every direction; affects PBR diffuse only.
78
+ * @experimental
79
+ */
80
+ export type AmbientLightOptions3D = NodeOptions3D & {
81
+ /** sRGB colour; alpha is ignored. Default white. */
82
+ color?: Color3D;
83
+ /** Irradiance in lux, as a directional light's; π on a white surface gives its albedo. */
84
+ intensity: number;
85
+ };
86
+ /**
87
+ * Sky colour from the node's local +Y, ground colour from −Y, blended by the
88
+ * surface normal; affects PBR diffuse only.
89
+ * @experimental
90
+ */
91
+ export type HemisphereLightOptions3D = NodeOptions3D & {
92
+ /** sRGB sky colour; alpha is ignored. Default white. */
93
+ skyColor?: Color3D;
94
+ /** sRGB ground colour; alpha is ignored. Default the sky colour. */
95
+ groundColor?: Color3D;
96
+ /** Irradiance in lux, as an ambient light's. */
97
+ intensity: number;
98
+ };
99
+ /**
100
+ * Rectangular area light (three.js RectAreaLight, Babylon RectAreaLight): a width ×
101
+ * height rectangle in its local XY plane emitting toward local −Z. No shadows.
102
+ * Created by `createRectAreaLight` from `@nova-lab/core/3d/area-lights`.
103
+ * @experimental
104
+ */
105
+ export type RectAreaLightOptions3D = NodeOptions3D & {
106
+ /** sRGB colour; alpha is ignored. Default white. */
107
+ color?: Color3D;
108
+ /** Luminance in nits (cd/m²). */
109
+ intensity: number;
110
+ /** Metres along local X. */
111
+ width: number;
112
+ /** Metres along local Y. */
113
+ height: number;
114
+ };
115
+ /**
116
+ * Global light probe (three.js LightProbe): 9 linear RGB radiance coefficients
117
+ * (27 numbers) of second-order spherical harmonics, as
118
+ * sphericalHarmonicsFromEquirect returns, adding irradiance to lit materials.
119
+ * @experimental
120
+ */
121
+ export type LightProbeOptions3D = NodeOptions3D & {
122
+ coefficients: ArrayLike<number>;
123
+ /** Unitless multiplier of the coefficients. Default 1. */
124
+ intensity?: number;
125
+ };
126
+ /** @experimental */
127
+ export type LightKind3D = 'directional' | 'point' | 'spot' | 'ambient' | 'hemisphere' | 'rect' | 'probe';
128
+ export interface LightState3D {
129
+ readonly color: readonly [
130
+ number,
131
+ number,
132
+ number,
133
+ number
134
+ ];
135
+ /** Hemisphere ground colour; equals `color` for other kinds. */
136
+ readonly groundColor: readonly [
137
+ number,
138
+ number,
139
+ number,
140
+ number
141
+ ];
142
+ readonly intensity: number;
143
+ readonly range: number;
144
+ readonly innerConeAngle: number;
145
+ readonly outerConeAngle: number;
146
+ /** Rectangle size of an area light (0 otherwise). */
147
+ readonly width: number;
148
+ readonly height: number;
149
+ /** Radiance coefficients of a light probe, otherwise null. */
150
+ readonly coefficients: Float32Array | null;
151
+ }
152
+ /**
153
+ * Patch of `light.set` and the result of `light.getOptions()`: the photometric options
154
+ * of the light's kind (node options have their own setters). `color` applies to every
155
+ * kind but hemisphere (`skyColor`, `groundColor`) and probe.
156
+ * @experimental
157
+ */
158
+ export interface LightPatch3D {
159
+ /** sRGB colour; alpha is ignored. */
160
+ color?: Color3D;
161
+ skyColor?: Color3D;
162
+ groundColor?: Color3D;
163
+ intensity?: number;
164
+ range?: number;
165
+ innerConeAngle?: number;
166
+ outerConeAngle?: number;
167
+ width?: number;
168
+ height?: number;
169
+ coefficients?: ArrayLike<number>;
170
+ }
171
+ /**
172
+ * Photometric light source. Its shadow maps belong to the renderer generation.
173
+ * Colours are sRGB with alpha ignored; `intensity` units depend on the kind (see
174
+ * the options of each kind).
175
+ * @experimental
176
+ */
177
+ export declare class Nova3DLight extends Nova3DNode {
178
+ protected constructor();
179
+ readonly kind: LightKind3D;
180
+ private _light;
181
+ private _shadow;
182
+ /**
183
+ * Patches the photometric options of the light's kind (colour, intensity, range, cone, size).
184
+ * @experimental
185
+ */
186
+ set(patch: LightPatch3D): void;
187
+ /**
188
+ * The photometric options of the light's kind; colours as normalized sRGB triples.
189
+ * @experimental
190
+ */
191
+ getOptions(): Readonly<LightPatch3D>;
192
+ /** True for ambient and hemisphere lights, which have no position, range or shadow. */
193
+ get ambient(): boolean;
194
+ /**
195
+ * Patches the shadow settings; `enabled: true` turns shadows on.
196
+ * @experimental
197
+ */
198
+ setShadows(patch: LightShadowOptions3D): void;
199
+ private static _validateShadow;
200
+ }