@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,106 @@
1
+ import { Matrix3D, Vector3D } from '../types.js';
2
+ /**
3
+ * An ellipsoid centred at the origin with semi-axes along X, Y and Z (metres).
4
+ * @experimental
5
+ */
6
+ export interface Ellipsoid3D {
7
+ readonly radii: readonly [number, number, number];
8
+ }
9
+ /**
10
+ * Geodetic coordinates: latitude and longitude in radians, height above the ellipsoid in metres.
11
+ * @experimental
12
+ */
13
+ export interface Geodetic3D {
14
+ /** Radians, north positive. */
15
+ readonly latitude: number;
16
+ /** Radians, east positive. */
17
+ readonly longitude: number;
18
+ /** Metres above the ellipsoid. */
19
+ readonly height: number;
20
+ }
21
+ /**
22
+ * Options of `ecefToLocalFrame`.
23
+ * @experimental
24
+ */
25
+ export interface LocalFrameOptions3D {
26
+ /** 'y' (default): east +X, up +Y, north −Z, the engine convention; 'z': plain ENU. */
27
+ upAxis?: 'y' | 'z';
28
+ /** Default WGS84. */
29
+ ellipsoid?: Ellipsoid3D;
30
+ }
31
+ /**
32
+ * WGS84 semi-major axis, flattening and semi-minor axis in metres.
33
+ * @experimental
34
+ */
35
+ export declare const WGS84: Readonly<{
36
+ semiMajorAxis: 6378137;
37
+ flattening: number;
38
+ semiMinorAxis: number;
39
+ }>;
40
+ /**
41
+ * The WGS84 ellipsoid used by 3D Tiles regions and ECEF data.
42
+ * @experimental
43
+ */
44
+ export declare const WGS84_ELLIPSOID: Ellipsoid3D;
45
+ /** Validates radii once; hot paths take the plain numbers. */
46
+ export declare function ellipsoidRadii3D(ellipsoid: Ellipsoid3D): readonly [number, number, number];
47
+ /**
48
+ * Writes the ECEF position of geodetic coordinates into `out` without validation.
49
+ * @internal
50
+ */
51
+ export declare function geodeticToECEFInto(out: Float64Array | number[], offset: number, latitude: number, longitude: number, height: number, radii: readonly [number, number, number]): void;
52
+ /**
53
+ * Projects `(x, y, z)` along the geodetic normal onto the ellipsoid surface (Newton
54
+ * iteration on the normal-scaling factor, converges to < 1e-12 relative). Returns
55
+ * false for points too close to the centre to have a defined surface projection.
56
+ * @internal
57
+ */
58
+ export declare function scaleToGeodeticSurfaceInto(out: Float64Array | number[], x: number, y: number, z: number, radii: readonly [number, number, number]): boolean;
59
+ /**
60
+ * Writes `[latitude, longitude, height]` of an ECEF point into `out`; returns false near the centre.
61
+ * @internal
62
+ */
63
+ export declare function ecefToGeodeticInto(out: Float64Array | number[], x: number, y: number, z: number, radii: readonly [number, number, number]): boolean;
64
+ /**
65
+ * ECEF metres of latitude and longitude in radians and height in metres on WGS84 (or another ellipsoid).
66
+ * @experimental
67
+ */
68
+ export declare function geodeticToECEF(latitude: number, longitude: number, height?: number, ellipsoid?: Ellipsoid3D): Vector3D;
69
+ /**
70
+ * Geodetic coordinates of an ECEF point, accurate to well below a millimetre from deep
71
+ * below the surface to orbit; throws only at the centre of the ellipsoid.
72
+ * @experimental
73
+ */
74
+ export declare function ecefToGeodetic(point: Vector3D, ellipsoid?: Ellipsoid3D): Geodetic3D;
75
+ /**
76
+ * Writes the column-major east-north-up frame (local → ECEF) at geodetic coordinates.
77
+ * @internal
78
+ */
79
+ export declare function enuFrameInto(out: Float64Array | number[], latitude: number, longitude: number, height: number, radii: readonly [number, number, number]): void;
80
+ /**
81
+ * Column-major east-north-up frame at geodetic coordinates (radians, metres): columns
82
+ * are east, north, up and the ECEF origin, so it maps local ENU metres to ECEF.
83
+ * @experimental
84
+ */
85
+ export declare function enuFrame(latitude: number, longitude: number, height?: number, ellipsoid?: Ellipsoid3D): Matrix3D;
86
+ /**
87
+ * The inverse use of {@link enuFrame}: maps ECEF to local metres around a geodetic
88
+ * point, so ECEF data lands near the scene origin. With `upAxis: 'y'` (default, the
89
+ * engine convention) east is +X, up is +Y and north is −Z; with `'z'` it is plain ENU.
90
+ * Pass it to `Tiles3D.setFrame` to keep the precision of double-precision composition.
91
+ * @experimental
92
+ */
93
+ export declare function ecefToLocalFrame(latitude: number, longitude: number, height?: number, options?: LocalFrameOptions3D): Matrix3D;
94
+ /** `ecefToLocalFrame` as a Float64Array. @internal */
95
+ export declare function ecefToLocalFrame64(latitude: number, longitude: number, height: number, options: LocalFrameOptions3D): Float64Array;
96
+ /**
97
+ * Inverts a rotation + translation matrix (orthonormal basis) in double precision.
98
+ * @internal
99
+ */
100
+ export declare function invertRigidInto(out: Float64Array | number[], m: ArrayLike<number>): void;
101
+ /**
102
+ * Nearest positive ray parameter at which `origin + t·direction` meets the ellipsoid,
103
+ * or −1 when it misses. Inputs are in the ellipsoid frame.
104
+ * @internal
105
+ */
106
+ export declare function rayEllipsoid(ox: number, oy: number, oz: number, dx: number, dy: number, dz: number, radii: readonly [number, number, number]): number;
@@ -0,0 +1,147 @@
1
+ import { Nova3DCamera } from '../model/Camera.js';
2
+ import { Nova3DApp } from '../Nova3DApp.js';
3
+ import { Matrix3D } from '../types.js';
4
+ import { Ellipsoid3D, Geodetic3D } from './Geodesy.js';
5
+ /** @experimental */
6
+ export interface GlobeControlsOptions3D {
7
+ /** Perspective camera the controls move. */
8
+ camera: Nova3DCamera;
9
+ /** Ellipsoid of the globe. Default WGS84. */
10
+ ellipsoid?: Ellipsoid3D;
11
+ /**
12
+ * Ellipsoid frame (ECEF) → world, rigid with uniform scale; e.g. `tiles.getEllipsoidTransform()`
13
+ * when the tileset is re-centred with a frame. Default identity (ECEF world).
14
+ */
15
+ frame?: Matrix3D;
16
+ /** Lowest camera height above the ellipsoid, in ellipsoid metres. Default 10. */
17
+ minDistance?: number;
18
+ /** Highest camera height above the ellipsoid. Default 4 × the largest radius. */
19
+ maxDistance?: number;
20
+ /** Largest tilt from the local vertical around the pivot, radians in [0, π/2). Default 1.4. */
21
+ maxTilt?: number;
22
+ /** 0 or 1 — immediate; otherwise the per-60 Hz-frame convergence share, as orbit controls. */
23
+ damping?: number;
24
+ /** Radians per pixel of heading/tilt drags and of rotation drags off the globe. Default 0.005. */
25
+ rotateSpeed?: number;
26
+ /** Zoom per wheel pixel (exponential). Default 0.002. */
27
+ zoomSpeed?: number;
28
+ /** Derive camera near/far from the height each change. Default true. */
29
+ adjustNearFar?: boolean;
30
+ }
31
+ /** @experimental */
32
+ export interface GlobeView3D {
33
+ /** Geodetic latitude in radians. */
34
+ latitude: number;
35
+ /** Longitude in radians, east positive. */
36
+ longitude: number;
37
+ /** Camera height above the ellipsoid in metres. */
38
+ height: number;
39
+ /** Clockwise from north, radians. Default 0. */
40
+ heading?: number;
41
+ /** From straight down toward the horizon, radians. Default 0. */
42
+ tilt?: number;
43
+ }
44
+ /**
45
+ * Geospatial camera controls for a globe: drag grabs and rotates the globe about its
46
+ * centre, the wheel zooms toward the cursor at a height-proportional rate, right or
47
+ * Ctrl/Shift drag (two fingers on touch) tilts and turns about the surface point at the
48
+ * view centre. The camera's right axis stays horizontal (up follows the local normal)
49
+ * and near/far follow the height. All math is double precision in the ellipsoid frame.
50
+ * @experimental
51
+ */
52
+ export declare class Nova3DGlobeControls {
53
+ protected constructor();
54
+ private readonly _app;
55
+ private readonly _camera;
56
+ private readonly _radii;
57
+ private readonly _min;
58
+ private readonly _max;
59
+ private readonly _maxTilt;
60
+ private readonly _damping;
61
+ private readonly _rotateSpeed;
62
+ private readonly _zoomSpeed;
63
+ private readonly _adjustNearFar;
64
+ private readonly _cleanup;
65
+ private readonly _initial;
66
+ private readonly _initialProjection;
67
+ private readonly _frame;
68
+ private readonly _inverse;
69
+ /** Displayed camera pose in the ellipsoid frame (columns right, up, back, position). */
70
+ private readonly _pose;
71
+ /** Pose the camera converges to (equal to `_pose` without damping). */
72
+ private readonly _goal;
73
+ private readonly _scratch;
74
+ private readonly _projection32;
75
+ private readonly _parent32;
76
+ private readonly _ray;
77
+ private readonly _point;
78
+ private readonly _grab;
79
+ private readonly _pivot;
80
+ private readonly _pointers;
81
+ private _written;
82
+ private _mode;
83
+ private _hasGrab;
84
+ private _lastX;
85
+ private _lastY;
86
+ private _touchDistance;
87
+ private _touchAngle;
88
+ private _lease?;
89
+ private _enabled;
90
+ private _destroyed;
91
+ get enabled(): boolean;
92
+ get destroyed(): boolean;
93
+ /** Camera height above the ellipsoid in ellipsoid metres. */
94
+ get altitude(): number;
95
+ setEnabled(enabled: boolean): void;
96
+ /** Replaces the ellipsoid frame → world matrix (the camera keeps its world pose). */
97
+ setFrame(matrix: Matrix3D): void;
98
+ /** Places the camera above geodetic coordinates. */
99
+ setView(view: GlobeView3D): void;
100
+ /** Geodetic position of the camera. */
101
+ getGeodetic(): Geodetic3D;
102
+ /** Re-reads the camera pose after external changes. */
103
+ sync(): void;
104
+ reset(): void;
105
+ destroy(): void;
106
+ private _setFrame;
107
+ /** World scale of ellipsoid metres. */
108
+ private _scale;
109
+ /** Camera world in double precision (parent world × local TRS), into the ellipsoid frame. */
110
+ private _readPose;
111
+ /** Re-reads the camera when something else moved it since the last write. */
112
+ private _syncIfMoved;
113
+ private _write;
114
+ private _height;
115
+ /** Keeps the right axis horizontal (up toward the local normal) after a move. */
116
+ private _alignUp;
117
+ /** Writes the pointer ray of `pose` (origin, unit direction) in the ellipsoid frame. */
118
+ private _pointerRay;
119
+ private _cameraRay;
120
+ /** Ray parameter of the ellipsoid hit of `_ray`, or −1. */
121
+ private _hit;
122
+ /** Height of a pose above the ellipsoid. */
123
+ private _altitudeOf;
124
+ /** Sets the heading/tilt pivot: the surface under the view centre, else under the pointer, else below the camera. */
125
+ private _choosePivot;
126
+ /** Starts a grab rotation: the ellipsoid point under the pointer, if any. */
127
+ private _beginRotate;
128
+ private _active;
129
+ private _listen;
130
+ private _down;
131
+ private _beginTouch;
132
+ private _moveEvent;
133
+ private _up;
134
+ private _wheel;
135
+ /** Ends a gesture where it is (the camera keeps the pose reached so far). */
136
+ private _cancel;
137
+ private _schedule;
138
+ private _tick;
139
+ private _stop;
140
+ private _assertAlive;
141
+ }
142
+ /**
143
+ * Globe (geospatial) camera controls for `options.camera` on `app`'s canvas.
144
+ * Owned by the app: destroyed with it.
145
+ * @experimental
146
+ */
147
+ export declare function createGlobeControls(app: Nova3DApp, options: GlobeControlsOptions3D): Nova3DGlobeControls;
@@ -0,0 +1,35 @@
1
+ import { GLTFLoadOptions3D } from '../gltf/GLTFTypes.js';
2
+ import { Nova3DNode } from '../model/Node.js';
3
+ import { Nova3DScene } from '../model/Scene.js';
4
+ import { Nova3DApp } from '../Nova3DApp.js';
5
+ import { TilePayload3D } from './TileFormats.js';
6
+ /** One drawable root of a tile and its matrix in the tile frame (null for identity). @internal */
7
+ export interface TileContentPart3D {
8
+ readonly node: Nova3DNode;
9
+ readonly local: Float64Array | null;
10
+ }
11
+ /** Live GPU content of a tile; `destroy` releases nodes and resources. @internal */
12
+ export interface TileContent3D {
13
+ readonly parts: readonly TileContentPart3D[];
14
+ destroy: () => void;
15
+ }
16
+ /** @internal */
17
+ export interface TileContentContext3D {
18
+ readonly url: string;
19
+ readonly signal: AbortSignal;
20
+ readonly upAxis: Float64Array;
21
+ }
22
+ /** Turns decoded payloads into scene nodes. @internal */
23
+ export type TileContentFactory3D = (payloads: readonly TilePayload3D[], context: TileContentContext3D) => Promise<TileContent3D>;
24
+ /** Fetches bytes through a user `fetch`, resolving responses and raw buffers alike. @internal */
25
+ export type TileBytes3D = (url: string, signal: AbortSignal) => Promise<Uint8Array>;
26
+ /**
27
+ * The default content factory: glTF (through `parseGLTF`), b3dm, i3dm as GPU instances
28
+ * of every glTF mesh, and pnts as point meshes.
29
+ * @internal
30
+ */
31
+ export declare function createTileContentFactory3D(app: Nova3DApp, scene: Nova3DScene, options: {
32
+ gltf?: GLTFLoadOptions3D;
33
+ bytes?: TileBytes3D;
34
+ pointSize: number;
35
+ }): TileContentFactory3D;
@@ -0,0 +1,77 @@
1
+ /** Decoded tile content before GPU upload. @internal */
2
+ export type TilePayload3D = {
3
+ readonly kind: 'gltf';
4
+ readonly data: Uint8Array;
5
+ readonly rtc: readonly number[] | null;
6
+ } | {
7
+ readonly kind: 'instances';
8
+ /** Embedded GLB/glTF bytes, or null when `uri` names an external glTF. */
9
+ readonly gltf: Uint8Array | null;
10
+ readonly uri: string | null;
11
+ /** Content origin (RTC_CENTER plus the instance centroid) in tile space. */
12
+ readonly origin: readonly number[];
13
+ /** Column-major instance matrices relative to `origin`, 16 numbers each. */
14
+ readonly matrices: Float64Array;
15
+ readonly count: number;
16
+ } | {
17
+ readonly kind: 'points';
18
+ readonly positions: Float32Array;
19
+ /** sRGB RGBA in [0, 1] per point, or null for `constant`. */
20
+ readonly colors: Float32Array | null;
21
+ readonly constant: readonly [number, number, number, number] | null;
22
+ readonly rtc: readonly number[] | null;
23
+ } | {
24
+ readonly kind: 'tileset';
25
+ readonly json: unknown;
26
+ };
27
+ /** The JSON + binary feature table of b3dm, i3dm and pnts. @internal */
28
+ export declare class FeatureTable3D {
29
+ readonly json: Record<string, unknown>;
30
+ private readonly _binary;
31
+ constructor(json: Record<string, unknown>, _binary: Uint8Array);
32
+ has(name: string): boolean;
33
+ /** A global property: an inline number/array, or a binary reference. */
34
+ global(name: string, components: number, type?: string): number[] | null;
35
+ /** A per-feature property in the binary body as doubles, or null when absent. */
36
+ array(name: string, count: number, components: number, defaultType: string): Float64Array | null;
37
+ }
38
+ interface TileHeader3D {
39
+ featureTable: FeatureTable3D;
40
+ /** Bytes after the batch table: the GLB (or glTF URI for i3dm). */
41
+ body: Uint8Array;
42
+ gltfFormat: number;
43
+ }
44
+ /**
45
+ * Splits a b3dm / i3dm / pnts container into its feature table and body. Accepts the
46
+ * two legacy b3dm header layouts as CesiumJS does.
47
+ * @internal
48
+ */
49
+ export declare function tileHeader3D(bytes: Uint8Array, expected: 'b3dm' | 'i3dm' | 'pnts'): TileHeader3D;
50
+ /**
51
+ * Reads the glTF CESIUM_RTC centre and strips the extension from the declared lists,
52
+ * so the core loader accepts the document; untouched bytes are returned as they are.
53
+ * @internal
54
+ */
55
+ export declare function prepareTileGLTF3D(bytes: Uint8Array): {
56
+ data: Uint8Array;
57
+ rtc: number[] | null;
58
+ };
59
+ /** @internal */
60
+ export declare function decodeI3DM3D(bytes: Uint8Array): Extract<TilePayload3D, {
61
+ kind: 'instances';
62
+ }>;
63
+ /** @internal */
64
+ export declare function decodePNTS3D(bytes: Uint8Array): Extract<TilePayload3D, {
65
+ kind: 'points';
66
+ }>;
67
+ /** @internal */
68
+ export declare function decodeB3DM3D(bytes: Uint8Array): Extract<TilePayload3D, {
69
+ kind: 'gltf';
70
+ }>;
71
+ /**
72
+ * Decodes tile content by its magic: glb / glTF JSON, b3dm, i3dm, pnts, cmpt (flattened
73
+ * recursively) or an external tileset JSON.
74
+ * @internal
75
+ */
76
+ export declare function decodeTileContent3D(bytes: Uint8Array, out?: TilePayload3D[], depth?: number): TilePayload3D[];
77
+ export {};
@@ -0,0 +1,236 @@
1
+ import { Nova3DWarning } from '../Errors.js';
2
+ import { GLTFLoadOptions3D } from '../gltf/GLTFTypes.js';
3
+ import { Nova3DCamera } from '../model/Camera.js';
4
+ import { Nova3DNode } from '../model/Node.js';
5
+ import { Nova3DScene } from '../model/Scene.js';
6
+ import { Nova3DApp } from '../Nova3DApp.js';
7
+ import { ReadyOptions3D } from '../tools/Ready.js';
8
+ import { Clock3D, Matrix3D, ScreenSize3D, Vector3D } from '../types.js';
9
+ import { Ellipsoid3D } from './Geodesy.js';
10
+ import { TileContentFactory3D } from './TileContent.js';
11
+ /**
12
+ * A `fetch`-compatible function; raw bytes are accepted as well as responses.
13
+ * @experimental
14
+ */
15
+ export type TilesFetch3D = (url: string, init: {
16
+ signal: AbortSignal;
17
+ }) => Promise<Response | ArrayBuffer | Uint8Array>;
18
+ /**
19
+ * glTF options of tile content: `loadGLTF` options without `signal` (the tileset owns aborts).
20
+ * @experimental
21
+ */
22
+ export type TilesGLTFOptions3D = Omit<GLTFLoadOptions3D, 'signal'>;
23
+ /**
24
+ * World-space bounding sphere (`tiles.getBoundingSphere`).
25
+ * @experimental
26
+ */
27
+ export interface BoundingSphere3D {
28
+ readonly center: Vector3D;
29
+ readonly radius: number;
30
+ }
31
+ /** @experimental */
32
+ export interface TilesOptions3D {
33
+ /** URL of the tileset JSON; either `url` or `json` is required. */
34
+ url?: string | URL;
35
+ /** An already loaded tileset document (object or JSON text). */
36
+ json?: unknown;
37
+ /** Base URL for content of `json`; defaults to the document base URI. */
38
+ baseUrl?: string | URL;
39
+ /** Replaces `globalThis.fetch` for the tileset, its content and external glTF resources. */
40
+ fetch?: TilesFetch3D;
41
+ /** Maximum screen-space error in CSS pixels before a tile refines. Default 16. */
42
+ errorTarget?: number;
43
+ /** Cache budget of downloaded content bytes; unused tiles beyond it are unloaded LRU first. Default 256 MiB. */
44
+ maxBytes?: number;
45
+ /** Concurrent content requests. Default 6. */
46
+ maxConcurrent?: number;
47
+ /** Upper bound of tiles in all parsed tileset documents. Default 1,000,000. */
48
+ maxTiles?: number;
49
+ /** Aborts the tileset: pending requests stop and no further content loads. */
50
+ signal?: AbortSignal;
51
+ /**
52
+ * 'app' (default) selects tiles before every rendered frame from the first view of
53
+ * `scene`; 'manual' only in `update(camera, viewport)`.
54
+ */
55
+ clock?: Clock3D;
56
+ /**
57
+ * Tileset space → `root` space, composed in double precision before node matrices are
58
+ * stored in Float32. Use `ecefToLocalFrame` to bring ECEF data to the origin.
59
+ */
60
+ frame?: Matrix3D;
61
+ /** Set `frame` to the local frame (east +X, up +Y, north −Z) at the root volume centre once it is known. */
62
+ recenter?: boolean;
63
+ /** Point size in CSS pixels of pnts content. Default 2. */
64
+ pointSize?: number;
65
+ /** glTF limits, decoders (Draco, meshopt, KTX2) and resource resolution for tile content. */
66
+ gltf?: TilesGLTFOptions3D;
67
+ /** Ellipsoid of region volumes. Default WGS84. */
68
+ ellipsoid?: Ellipsoid3D;
69
+ }
70
+ /**
71
+ * Live tile counters (one object, updated in place by `update`).
72
+ * @experimental
73
+ */
74
+ export interface TilesStats3D {
75
+ /** Tiles drawn by the last update. */
76
+ readonly visible: number;
77
+ /** Tiles with content in memory. */
78
+ readonly loaded: number;
79
+ /** Requests in flight (download and decode). */
80
+ readonly downloading: number;
81
+ /** Wanted tiles waiting for a request slot after the last update. */
82
+ readonly queued: number;
83
+ /** Downloaded bytes of the loaded content. */
84
+ readonly bytes: number;
85
+ /** Tiles known from parsed tileset documents. */
86
+ readonly tiles: number;
87
+ /** Tiles whose content failed to load. */
88
+ readonly failed: number;
89
+ }
90
+ /** @experimental */
91
+ export interface TileLoadEvent3D {
92
+ readonly url: string;
93
+ readonly nodes: readonly Nova3DNode[];
94
+ readonly depth: number;
95
+ readonly geometricError: number;
96
+ readonly bytes: number;
97
+ }
98
+ /** @experimental */
99
+ export interface TileErrorEvent3D {
100
+ readonly url: string | null;
101
+ readonly error: unknown;
102
+ }
103
+ /**
104
+ * A part of a tileset that was skipped or approximated without failing the load.
105
+ * @experimental
106
+ */
107
+ export interface TileWarningEvent3D {
108
+ readonly url: string | null;
109
+ readonly warning: Nova3DWarning;
110
+ }
111
+ /**
112
+ * Streams an OGC 3D Tiles 1.0/1.1 tileset into a scene: screen-space-error refinement
113
+ * (REPLACE keeps parents until every visible child can draw; ADD draws both), frustum
114
+ * culling, prioritised and cancellable requests, and an LRU byte budget.
115
+ * @experimental
116
+ */
117
+ export declare class Nova3DTiles {
118
+ protected constructor();
119
+ private readonly _app;
120
+ /** Group of every tile node; transform it freely (it composes after `frame`). */
121
+ readonly root: Nova3DNode;
122
+ private readonly _ready;
123
+ private readonly _scene;
124
+ private readonly _fetch;
125
+ private readonly _factory;
126
+ private readonly _radii;
127
+ private readonly _errorTarget;
128
+ private readonly _maxBytes;
129
+ private readonly _maxConcurrent;
130
+ private readonly _maxTiles;
131
+ private readonly _controller;
132
+ private readonly _cleanup;
133
+ private readonly _loadListeners;
134
+ private readonly _errorListeners;
135
+ private readonly _warningListeners;
136
+ private readonly _stats;
137
+ private readonly _loading;
138
+ private readonly _loaded;
139
+ private readonly _wanted;
140
+ private readonly _evictable;
141
+ private _shown;
142
+ private _previous;
143
+ private _tileset;
144
+ private _frame;
145
+ private _recenter;
146
+ private _destroyed;
147
+ private _frameIndex;
148
+ private readonly _camera32;
149
+ private readonly _projection32;
150
+ private readonly _root32;
151
+ private readonly _tilesetWorld;
152
+ private readonly _inverse;
153
+ private readonly _placement;
154
+ private readonly _clip;
155
+ private readonly _planes;
156
+ private readonly _eye;
157
+ private _sseScale;
158
+ private _perspective;
159
+ /** Live counters, updated in place. */
160
+ get stats(): Readonly<TilesStats3D>;
161
+ get destroyed(): boolean;
162
+ get errorTarget(): number;
163
+ /** Tileset space → root space, written into `out` when given. */
164
+ getFrame(out?: Matrix3D): Matrix3D;
165
+ /** Replaces the double-precision tileset frame; null restores identity. Loaded tiles are re-placed. */
166
+ setFrame(matrix: Matrix3D | null): void;
167
+ /**
168
+ * Tileset space (ECEF for geodata) → world: `root` world × `frame`. Pass it to
169
+ * globe controls so their ellipsoid follows the tileset.
170
+ */
171
+ getEllipsoidTransform(out?: Matrix3D): Matrix3D;
172
+ /** World-space bounding sphere of the root tile, or null before `whenReady` resolves. */
173
+ getBoundingSphere(): BoundingSphere3D | null;
174
+ onTileLoad(listener: (event: TileLoadEvent3D) => void): () => void;
175
+ /** Resolves once the root tileset document is parsed; rejects with its failure (also sent to `onError`). */
176
+ whenReady(options?: ReadyOptions3D): Promise<void>;
177
+ /** Tileset and content failures; the only place tiles report errors (never `app.onError`). */
178
+ onError(listener: (event: TileErrorEvent3D) => void): () => void;
179
+ /** Parts of the tileset skipped without failing it, such as implicit tiling. */
180
+ onWarning(listener: (event: TileWarningEvent3D) => void): () => void;
181
+ /**
182
+ * Selects, shows and requests tiles for `camera`. `viewport` is the view size in CSS
183
+ * pixels (default: the app view of this camera, else the canvas). Called before every
184
+ * frame with the 'app' clock; allocation-free apart from request start-up. Selection
185
+ * follows the camera, so it takes no time step.
186
+ */
187
+ update(camera: Nova3DCamera, viewport?: ScreenSize3D): void;
188
+ destroy(): void;
189
+ /** The app is going away: its scenes and resources are released by it. */
190
+ private _abandon;
191
+ private _documentBase;
192
+ private _start;
193
+ private _recentre;
194
+ private _bytes;
195
+ private _autoUpdate;
196
+ /** Camera position, frustum planes and SSE scale in tileset space. */
197
+ private _prepare;
198
+ private _visible;
199
+ private _computeError;
200
+ /** True when the content of a tile can cover its volume (drawn, failed or empty leaf). */
201
+ private _covers;
202
+ /**
203
+ * Marks used tiles (in view) and leaves (error met or no children), and returns
204
+ * whether the subtree can draw without holes this frame.
205
+ */
206
+ private _traverse;
207
+ private _select;
208
+ private _prefetch;
209
+ private _want;
210
+ private _show;
211
+ /**
212
+ * Shows a REPLACE tile, or while it is still loading keeps the descendants drawn by
213
+ * the previous update (zooming out never opens holes).
214
+ */
215
+ private _showOrKeep;
216
+ private _keep;
217
+ private _applyVisibility;
218
+ private _setVisible;
219
+ /** Shallower first (fallbacks for REPLACE), then the larger screen-space error. */
220
+ private readonly _priority;
221
+ private readonly _recency;
222
+ private _schedule;
223
+ private _evict;
224
+ private _unload;
225
+ private _place;
226
+ private _load;
227
+ private _emitError;
228
+ private _emitWarning;
229
+ private _assertAlive;
230
+ }
231
+ /**
232
+ * Streams an OGC 3D Tiles tileset (`url` or `json`) into `scene`, under `tiles.root`.
233
+ * Owned by the scene's app: destroyed with the scene or the app.
234
+ * @experimental
235
+ */
236
+ export declare function createTiles(scene: Nova3DScene, options: TilesOptions3D): Nova3DTiles;
@@ -0,0 +1,81 @@
1
+ import { Nova3DWarning } from '../Errors.js';
2
+ import { Nova3DTileVolume } from './BoundingVolume.js';
3
+ import { TileContent3D } from './TileContent.js';
4
+ /** Content states of a tile. @internal */
5
+ export declare const TILE_NONE = 0;
6
+ /** @internal */
7
+ export declare const TILE_LOADING = 1;
8
+ /** @internal */
9
+ export declare const TILE_READY = 2;
10
+ /** @internal */
11
+ export declare const TILE_FAILED = 3;
12
+ /** glTF up-axis corrections into the Z-up tile frame (column-major). @internal */
13
+ export declare const UP_AXIS_3D: Readonly<{
14
+ Y: Float64Array<ArrayBuffer>;
15
+ X: Float64Array<ArrayBuffer>;
16
+ Z: Float64Array<ArrayBuffer>;
17
+ }>;
18
+ /**
19
+ * One tile of a parsed tileset with its runtime streaming state. Volumes and the
20
+ * accumulated transform are in tileset space (the root's frame, ECEF for geodata).
21
+ * @internal
22
+ */
23
+ export declare class Tile3D {
24
+ readonly parent: Tile3D | null;
25
+ readonly depth: number;
26
+ readonly geometricError: number;
27
+ readonly refine: 'ADD' | 'REPLACE';
28
+ readonly transform: Float64Array;
29
+ readonly volume: Nova3DTileVolume;
30
+ readonly viewerRequestVolume: Nova3DTileVolume | null;
31
+ readonly contents: readonly string[];
32
+ readonly upAxis: Float64Array;
33
+ readonly children: Tile3D[];
34
+ /** Content is (or is hinted to be) an external tileset: never drawn, always refined. */
35
+ external: boolean;
36
+ /** External tileset children are attached. */
37
+ expanded: boolean;
38
+ state: number;
39
+ usedFrame: number;
40
+ leafFrame: number;
41
+ wantedFrame: number;
42
+ displayFrame: number;
43
+ /** Last update in which this tile or a descendant was drawn. */
44
+ shownFrame: number;
45
+ lastUsed: number;
46
+ sse: number;
47
+ distance: number;
48
+ childrenReady: boolean;
49
+ displayed: boolean;
50
+ bytes: number;
51
+ controller: AbortController | null;
52
+ content: TileContent3D | null;
53
+ constructor(parent: Tile3D | null, depth: number, geometricError: number, refine: 'ADD' | 'REPLACE', transform: Float64Array, volume: Nova3DTileVolume, viewerRequestVolume: Nova3DTileVolume | null, contents: readonly string[], upAxis: Float64Array);
54
+ get hasRenderable(): boolean;
55
+ }
56
+ /** Column-major double-precision 4×4 product `a · b`. @internal */
57
+ export declare function multiply3D(out: Float64Array, a: ArrayLike<number>, b: ArrayLike<number>): Float64Array;
58
+ /**
59
+ * Resolves a content URI against its tileset and carries over query parameters the
60
+ * child lacks (session keys of streamed services), as CesiumJS does.
61
+ * @internal
62
+ */
63
+ export declare function resolveTileURL3D(uri: string, base: string | undefined): string;
64
+ export interface TilesetParse3D {
65
+ root: Tile3D;
66
+ /** Problems that skipped parts of the tree without failing it (e.g. implicit tiling). */
67
+ warnings: Nova3DWarning[];
68
+ count: number;
69
+ }
70
+ /**
71
+ * Validates a tileset JSON document and builds its tile tree (iteratively, so deep
72
+ * trees cannot overflow the stack). Transforms accumulate down the tree from
73
+ * `parentTransform`; `refine` is inherited; `content.url` (pre-1.0) is accepted.
74
+ * @internal
75
+ */
76
+ export declare function parseTileset3D(input: unknown, options: {
77
+ baseUrl?: string;
78
+ parent?: Tile3D;
79
+ radii: readonly [number, number, number];
80
+ maxTiles: number;
81
+ }): TilesetParse3D;