super-three 0.181.0 → 0.185.0

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 (693) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +3 -4
  3. package/build/three.cjs +21332 -19201
  4. package/build/three.core.js +20908 -19853
  5. package/build/three.core.min.js +2 -2
  6. package/build/three.module.js +1947 -862
  7. package/build/three.module.min.js +2 -2
  8. package/build/three.tsl.js +37 -16
  9. package/build/three.tsl.min.js +2 -2
  10. package/build/three.webgpu.js +33628 -25197
  11. package/build/three.webgpu.min.js +2 -2
  12. package/build/three.webgpu.nodes.js +33394 -25000
  13. package/build/three.webgpu.nodes.min.js +2 -2
  14. package/examples/jsm/Addons.js +14 -3
  15. package/examples/jsm/animation/CCDIKSolver.js +7 -3
  16. package/examples/jsm/controls/ArcballControls.js +13 -6
  17. package/examples/jsm/controls/DragControls.js +2 -2
  18. package/examples/jsm/controls/FirstPersonControls.js +127 -86
  19. package/examples/jsm/controls/FlyControls.js +4 -0
  20. package/examples/jsm/controls/MapControls.js +55 -1
  21. package/examples/jsm/controls/OrbitControls.js +111 -8
  22. package/examples/jsm/controls/TrackballControls.js +8 -8
  23. package/examples/jsm/controls/TransformControls.js +102 -17
  24. package/examples/jsm/csm/CSM.js +2 -1
  25. package/examples/jsm/csm/CSMFrustum.js +31 -6
  26. package/examples/jsm/csm/CSMShadowNode.js +10 -3
  27. package/examples/jsm/effects/AnaglyphEffect.js +102 -7
  28. package/examples/jsm/effects/AsciiEffect.js +14 -1
  29. package/examples/jsm/environments/ColorEnvironment.js +59 -0
  30. package/examples/jsm/environments/RoomEnvironment.js +3 -0
  31. package/examples/jsm/exporters/DRACOExporter.js +27 -6
  32. package/examples/jsm/exporters/EXRExporter.js +1 -1
  33. package/examples/jsm/exporters/GLTFExporter.js +266 -21
  34. package/examples/jsm/exporters/PLYExporter.js +286 -73
  35. package/examples/jsm/exporters/USDZExporter.js +353 -99
  36. package/examples/jsm/generators/CityGenerator.js +346 -0
  37. package/examples/jsm/generators/ForestGenerator.js +347 -0
  38. package/examples/jsm/generators/TerrainGenerator.js +504 -0
  39. package/examples/jsm/generators/TreeGenerator.js +377 -0
  40. package/examples/jsm/generators/city/SidewalkGenerator.js +253 -0
  41. package/examples/jsm/generators/city/SkyscraperGenerator.js +1357 -0
  42. package/examples/jsm/geometries/DecalGeometry.js +1 -1
  43. package/examples/jsm/geometries/LoftGeometry.js +355 -0
  44. package/examples/jsm/geometries/TextGeometry.js +18 -0
  45. package/examples/jsm/helpers/AnimationPathHelper.js +302 -0
  46. package/examples/jsm/helpers/LightProbeGridHelper.js +221 -0
  47. package/examples/jsm/helpers/LightProbeHelper.js +5 -4
  48. package/examples/jsm/helpers/LightProbeHelperGPU.js +1 -1
  49. package/examples/jsm/helpers/TextureHelperGPU.js +1 -1
  50. package/examples/jsm/helpers/ViewHelper.js +83 -14
  51. package/examples/jsm/inspector/Extension.js +13 -0
  52. package/examples/jsm/inspector/Inspector.js +244 -91
  53. package/examples/jsm/inspector/RendererInspector.js +165 -39
  54. package/examples/jsm/inspector/extensions/tsl-graph/TSLGraphEditor.js +916 -0
  55. package/examples/jsm/inspector/extensions/tsl-graph/TSLGraphLoader.js +281 -0
  56. package/examples/jsm/inspector/tabs/Console.js +241 -25
  57. package/examples/jsm/inspector/tabs/Memory.js +136 -0
  58. package/examples/jsm/inspector/tabs/Parameters.js +115 -7
  59. package/examples/jsm/inspector/tabs/Performance.js +24 -9
  60. package/examples/jsm/inspector/tabs/Settings.js +306 -0
  61. package/examples/jsm/inspector/tabs/Timeline.js +1696 -0
  62. package/examples/jsm/inspector/tabs/Viewer.js +723 -9
  63. package/examples/jsm/inspector/ui/Graph.js +162 -25
  64. package/examples/jsm/inspector/ui/Item.js +92 -13
  65. package/examples/jsm/inspector/ui/List.js +2 -2
  66. package/examples/jsm/inspector/ui/Profiler.js +1991 -44
  67. package/examples/jsm/inspector/ui/Style.js +1943 -543
  68. package/examples/jsm/inspector/ui/Tab.js +226 -5
  69. package/examples/jsm/inspector/ui/Values.js +126 -8
  70. package/examples/jsm/inspector/ui/utils.js +143 -10
  71. package/examples/jsm/interaction/InteractionManager.js +226 -0
  72. package/examples/jsm/libs/basis/README.md +0 -1
  73. package/examples/jsm/libs/demuxer_mp4.js +3 -3
  74. package/examples/jsm/libs/draco/README.md +0 -1
  75. package/examples/jsm/libs/meshopt_clusterizer.module.js +421 -0
  76. package/examples/jsm/libs/meshopt_decoder.module.js +9 -8
  77. package/examples/jsm/libs/meshopt_simplifier.module.js +627 -0
  78. package/examples/jsm/libs/mikktspace.module.js +34 -9
  79. package/examples/jsm/lighting/ClusteredLighting.js +55 -0
  80. package/examples/jsm/lighting/DynamicLighting.js +82 -0
  81. package/examples/jsm/lighting/LightProbeGrid.js +681 -0
  82. package/examples/jsm/lines/LineMaterial.js +45 -16
  83. package/examples/jsm/lines/LineSegments2.js +8 -0
  84. package/examples/jsm/lines/webgpu/LineSegments2.js +8 -0
  85. package/examples/jsm/loaders/3DMLoader.js +6 -5
  86. package/examples/jsm/loaders/3MFLoader.js +2 -2
  87. package/examples/jsm/loaders/AMFLoader.js +2 -2
  88. package/examples/jsm/loaders/ColladaLoader.js +24 -4026
  89. package/examples/jsm/loaders/DRACOLoader.js +51 -18
  90. package/examples/jsm/loaders/EXRLoader.js +701 -90
  91. package/examples/jsm/loaders/FBXLoader.js +235 -37
  92. package/examples/jsm/loaders/GCodeLoader.js +34 -8
  93. package/examples/jsm/loaders/GLTFLoader.js +146 -178
  94. package/examples/jsm/loaders/HDRLoader.js +7 -30
  95. package/examples/jsm/loaders/KMZLoader.js +5 -5
  96. package/examples/jsm/loaders/KTX2Loader.js +58 -17
  97. package/examples/jsm/loaders/LDrawLoader.js +49 -58
  98. package/examples/jsm/loaders/LUT3dlLoader.js +2 -2
  99. package/examples/jsm/loaders/LUTCubeLoader.js +2 -2
  100. package/examples/jsm/loaders/LWOLoader.js +11 -39
  101. package/examples/jsm/loaders/LottieLoader.js +1 -1
  102. package/examples/jsm/loaders/MaterialXLoader.js +31 -9
  103. package/examples/jsm/loaders/NRRDLoader.js +5 -5
  104. package/examples/jsm/loaders/PCDLoader.js +11 -9
  105. package/examples/jsm/loaders/PLYLoader.js +218 -55
  106. package/examples/jsm/loaders/SVGLoader.js +549 -497
  107. package/examples/jsm/loaders/TDSLoader.js +0 -2
  108. package/examples/jsm/loaders/TGALoader.js +0 -2
  109. package/examples/jsm/loaders/TTFLoader.js +1 -1
  110. package/examples/jsm/loaders/USDLoader.js +127 -43
  111. package/examples/jsm/loaders/UltraHDRLoader.js +285 -160
  112. package/examples/jsm/loaders/VOXLoader.js +660 -117
  113. package/examples/jsm/loaders/VRMLLoader.js +80 -3
  114. package/examples/jsm/loaders/VTKLoader.js +42 -25
  115. package/examples/jsm/loaders/collada/ColladaComposer.js +3044 -0
  116. package/examples/jsm/loaders/collada/ColladaParser.js +1977 -0
  117. package/examples/jsm/loaders/usd/USDAParser.js +504 -344
  118. package/examples/jsm/loaders/usd/USDCParser.js +1867 -6
  119. package/examples/jsm/loaders/usd/USDComposer.js +4627 -0
  120. package/examples/jsm/materials/LDrawConditionalLineNodeMaterial.js +2 -2
  121. package/examples/jsm/materials/WoodNodeMaterial.js +11 -11
  122. package/examples/jsm/math/Octree.js +131 -1
  123. package/examples/jsm/misc/GPUComputationRenderer.js +2 -0
  124. package/examples/jsm/misc/RollerCoaster.js +42 -4
  125. package/examples/jsm/misc/TileCreasedNormalsPlugin.js +270 -0
  126. package/examples/jsm/misc/Volume.js +2 -3
  127. package/examples/jsm/misc/VolumeSlice.js +0 -1
  128. package/examples/jsm/modifiers/TessellateModifier.js +1 -1
  129. package/examples/jsm/objects/GroundedSkybox.js +1 -1
  130. package/examples/jsm/objects/LensflareMesh.js +1 -1
  131. package/examples/jsm/objects/Reflector.js +72 -25
  132. package/examples/jsm/objects/Sky.js +90 -6
  133. package/examples/jsm/objects/SkyMesh.js +150 -16
  134. package/examples/jsm/objects/Water.js +4 -3
  135. package/examples/jsm/objects/Water2.js +5 -3
  136. package/examples/jsm/objects/Water2Mesh.js +1 -1
  137. package/examples/jsm/objects/WaterMesh.js +5 -7
  138. package/examples/jsm/physics/AmmoPhysics.js +27 -15
  139. package/examples/jsm/physics/JoltPhysics.js +10 -6
  140. package/examples/jsm/physics/RapierPhysics.js +36 -7
  141. package/examples/jsm/postprocessing/EffectComposer.js +7 -5
  142. package/examples/jsm/postprocessing/OutputPass.js +9 -0
  143. package/examples/jsm/postprocessing/RenderPass.js +10 -0
  144. package/examples/jsm/postprocessing/RenderTransitionPass.js +1 -1
  145. package/examples/jsm/postprocessing/UnrealBloomPass.js +48 -18
  146. package/examples/jsm/renderers/CSS3DRenderer.js +1 -1
  147. package/examples/jsm/renderers/Projector.js +246 -28
  148. package/examples/jsm/renderers/SVGRenderer.js +174 -60
  149. package/examples/jsm/shaders/GTAOShader.js +19 -6
  150. package/examples/jsm/shaders/HalftoneShader.js +12 -1
  151. package/examples/jsm/shaders/PoissonDenoiseShader.js +6 -2
  152. package/examples/jsm/shaders/SAOShader.js +17 -4
  153. package/examples/jsm/shaders/SSAOShader.js +11 -1
  154. package/examples/jsm/shaders/SSRShader.js +6 -5
  155. package/examples/jsm/shaders/UnpackDepthRGBAShader.js +2 -4
  156. package/examples/jsm/shaders/VignetteShader.js +1 -1
  157. package/examples/jsm/shaders/VolumeShader.js +31 -44
  158. package/examples/jsm/transpiler/AST.js +44 -0
  159. package/examples/jsm/transpiler/GLSLDecoder.js +65 -8
  160. package/examples/jsm/transpiler/Linker.js +1 -1
  161. package/examples/jsm/transpiler/ShaderToyDecoder.js +2 -0
  162. package/examples/jsm/transpiler/TSLEncoder.js +46 -3
  163. package/examples/jsm/transpiler/TranspilerUtils.js +3 -3
  164. package/examples/jsm/transpiler/WGSLEncoder.js +27 -0
  165. package/examples/jsm/tsl/WebGLNodesHandler.js +605 -0
  166. package/examples/jsm/tsl/display/AfterImageNode.js +11 -1
  167. package/examples/jsm/tsl/display/AnaglyphPassNode.js +458 -16
  168. package/examples/jsm/tsl/display/BilateralBlurNode.js +374 -0
  169. package/examples/jsm/tsl/display/BloomNode.js +75 -25
  170. package/examples/jsm/tsl/display/CRT.js +150 -0
  171. package/examples/jsm/tsl/display/ChromaticAberrationNode.js +3 -36
  172. package/examples/jsm/tsl/display/DenoiseNode.js +1 -1
  173. package/examples/jsm/tsl/display/DepthOfFieldNode.js +3 -3
  174. package/examples/jsm/tsl/display/DotScreenNode.js +1 -1
  175. package/examples/jsm/tsl/display/FSR1Node.js +477 -0
  176. package/examples/jsm/tsl/display/FXAANode.js +13 -14
  177. package/examples/jsm/tsl/display/GTAONode.js +40 -17
  178. package/examples/jsm/tsl/display/GaussianBlurNode.js +21 -2
  179. package/examples/jsm/tsl/display/GodraysNode.js +615 -0
  180. package/examples/jsm/tsl/display/ImportanceSampledEnvironment.js +560 -0
  181. package/examples/jsm/tsl/display/LensflareNode.js +1 -1
  182. package/examples/jsm/tsl/display/Lut3DNode.js +1 -1
  183. package/examples/jsm/tsl/display/OutlineNode.js +69 -19
  184. package/examples/jsm/tsl/display/ParallaxBarrierPassNode.js +2 -2
  185. package/examples/jsm/tsl/display/PixelationPassNode.js +9 -8
  186. package/examples/jsm/tsl/display/RGBShiftNode.js +2 -2
  187. package/examples/jsm/tsl/display/RecurrentDenoiseNode.js +912 -0
  188. package/examples/jsm/tsl/display/RetroPassNode.js +263 -0
  189. package/examples/jsm/tsl/display/SMAANode.js +2 -2
  190. package/examples/jsm/tsl/display/SSAAPassNode.js +15 -27
  191. package/examples/jsm/tsl/display/SSGINode.js +96 -62
  192. package/examples/jsm/tsl/display/SSRNode.js +831 -134
  193. package/examples/jsm/tsl/display/SSSNode.js +8 -6
  194. package/examples/jsm/tsl/display/Shape.js +29 -0
  195. package/examples/jsm/tsl/display/SharpenNode.js +283 -0
  196. package/examples/jsm/tsl/display/SobelOperatorNode.js +2 -2
  197. package/examples/jsm/tsl/display/StereoCompositePassNode.js +8 -1
  198. package/examples/jsm/tsl/display/StereoPassNode.js +1 -2
  199. package/examples/jsm/tsl/display/TAAUNode.js +835 -0
  200. package/examples/jsm/tsl/display/TRAANode.js +315 -126
  201. package/examples/jsm/tsl/display/TemporalReprojectNode.js +1023 -0
  202. package/examples/jsm/tsl/display/TransitionNode.js +1 -1
  203. package/examples/jsm/tsl/display/depthAwareBlend.js +80 -0
  204. package/examples/jsm/tsl/display/radialBlur.js +68 -0
  205. package/examples/jsm/tsl/lighting/ClusteredLightsNode.js +622 -0
  206. package/examples/jsm/tsl/lighting/DynamicLightsNode.js +300 -0
  207. package/examples/jsm/tsl/lighting/data/AmbientLightDataNode.js +61 -0
  208. package/examples/jsm/tsl/lighting/data/DirectionalLightDataNode.js +111 -0
  209. package/examples/jsm/tsl/lighting/data/HemisphereLightDataNode.js +99 -0
  210. package/examples/jsm/tsl/lighting/data/PointLightDataNode.js +134 -0
  211. package/examples/jsm/tsl/lighting/data/SpotLightDataNode.js +161 -0
  212. package/examples/jsm/tsl/math/Bayer.js +53 -3
  213. package/examples/jsm/tsl/math/curlNoise.js +107 -0
  214. package/examples/jsm/tsl/shadows/TileShadowNode.js +1 -1
  215. package/examples/jsm/tsl/shadows/TileShadowNodeHelper.js +3 -3
  216. package/examples/jsm/tsl/utils/GroundedSkybox.js +62 -0
  217. package/examples/jsm/tsl/utils/RNoise.js +51 -0
  218. package/examples/jsm/tsl/utils/SpecularHelpers.js +325 -0
  219. package/examples/jsm/utils/BufferGeometryUtils.js +128 -62
  220. package/examples/jsm/utils/ColorUtils.js +76 -0
  221. package/examples/jsm/utils/GeometryCompressionUtils.js +1 -1
  222. package/examples/jsm/utils/LDrawUtils.js +1 -1
  223. package/examples/jsm/utils/SceneOptimizer.js +1 -1
  224. package/examples/jsm/utils/ShadowMapViewer.js +24 -10
  225. package/examples/jsm/utils/ShadowMapViewerGPU.js +1 -1
  226. package/examples/jsm/utils/SkeletonUtils.js +14 -8
  227. package/examples/jsm/utils/WebGPUTextureUtils.js +1 -1
  228. package/examples/jsm/webxr/ARButton.js +1 -1
  229. package/examples/jsm/webxr/WebGLXRFallback.js +89 -0
  230. package/examples/jsm/webxr/XRControllerModelFactory.js +2 -2
  231. package/examples/jsm/webxr/XRHandMeshModel.js +36 -10
  232. package/examples/jsm/webxr/XRHandModelFactory.js +2 -1
  233. package/package.json +28 -34
  234. package/src/Three.Core.js +3 -1
  235. package/src/Three.TSL.js +35 -14
  236. package/src/Three.WebGPU.Nodes.js +5 -0
  237. package/src/Three.WebGPU.js +13 -0
  238. package/src/Three.js +1 -0
  239. package/src/animation/AnimationAction.js +18 -4
  240. package/src/animation/AnimationClip.js +0 -139
  241. package/src/animation/AnimationMixer.js +6 -0
  242. package/src/animation/AnimationUtils.js +1 -12
  243. package/src/animation/KeyframeTrack.js +47 -8
  244. package/src/animation/PropertyBinding.js +2 -2
  245. package/src/animation/PropertyMixer.js +4 -4
  246. package/src/animation/tracks/BooleanKeyframeTrack.js +1 -1
  247. package/src/animation/tracks/ColorKeyframeTrack.js +1 -1
  248. package/src/animation/tracks/NumberKeyframeTrack.js +1 -1
  249. package/src/animation/tracks/QuaternionKeyframeTrack.js +1 -1
  250. package/src/animation/tracks/StringKeyframeTrack.js +1 -1
  251. package/src/animation/tracks/VectorKeyframeTrack.js +1 -1
  252. package/src/audio/Audio.js +1 -1
  253. package/src/audio/AudioContext.js +2 -2
  254. package/src/audio/AudioListener.js +5 -3
  255. package/src/cameras/Camera.js +34 -4
  256. package/src/cameras/CubeCamera.js +20 -0
  257. package/src/cameras/StereoCamera.js +5 -2
  258. package/src/constants.js +90 -5
  259. package/src/core/BufferAttribute.js +13 -1
  260. package/src/core/BufferGeometry.js +43 -9
  261. package/src/core/Clock.js +7 -0
  262. package/src/core/Object3D.js +69 -11
  263. package/src/core/Raycaster.js +3 -3
  264. package/src/core/RenderTarget.js +19 -6
  265. package/src/extras/PMREMGenerator.js +13 -22
  266. package/src/extras/TextureUtils.js +6 -2
  267. package/src/extras/core/ShapePath.js +149 -160
  268. package/src/extras/curves/CatmullRomCurve3.js +3 -2
  269. package/src/geometries/ExtrudeGeometry.js +2 -2
  270. package/src/geometries/PolyhedronGeometry.js +1 -1
  271. package/src/geometries/SphereGeometry.js +8 -3
  272. package/src/geometries/TorusGeometry.js +8 -3
  273. package/src/helpers/CameraHelper.js +3 -0
  274. package/src/helpers/DirectionalLightHelper.js +6 -1
  275. package/src/helpers/HemisphereLightHelper.js +5 -0
  276. package/src/helpers/PointLightHelper.js +3 -25
  277. package/src/helpers/SpotLightHelper.js +4 -1
  278. package/src/lights/DirectionalLight.js +13 -0
  279. package/src/lights/HemisphereLight.js +10 -0
  280. package/src/lights/Light.js +1 -11
  281. package/src/lights/LightProbe.js +0 -15
  282. package/src/lights/LightShadow.js +15 -6
  283. package/src/lights/PointLight.js +15 -0
  284. package/src/lights/PointLightShadow.js +0 -86
  285. package/src/lights/SpotLight.js +22 -1
  286. package/src/lights/webgpu/IESSpotLight.js +2 -1
  287. package/src/loaders/AudioLoader.js +11 -1
  288. package/src/loaders/Cache.js +28 -0
  289. package/src/loaders/DataTextureLoader.js +75 -42
  290. package/src/loaders/FileLoader.js +2 -3
  291. package/src/loaders/ImageBitmapLoader.js +12 -9
  292. package/src/loaders/Loader.js +6 -0
  293. package/src/loaders/LoadingManager.js +5 -0
  294. package/src/loaders/MaterialLoader.js +37 -266
  295. package/src/loaders/ObjectLoader.js +48 -6
  296. package/src/loaders/nodes/NodeLoader.js +2 -2
  297. package/src/loaders/nodes/NodeObjectLoader.js +18 -0
  298. package/src/materials/LineBasicMaterial.js +4 -0
  299. package/src/materials/Material.js +198 -1
  300. package/src/materials/MeshBasicMaterial.js +24 -0
  301. package/src/materials/MeshDepthMaterial.js +10 -0
  302. package/src/materials/MeshDistanceMaterial.js +10 -0
  303. package/src/materials/MeshLambertMaterial.js +49 -1
  304. package/src/materials/MeshMatcapMaterial.js +25 -1
  305. package/src/materials/MeshNormalMaterial.js +9 -1
  306. package/src/materials/MeshPhongMaterial.js +49 -1
  307. package/src/materials/MeshPhysicalMaterial.js +38 -0
  308. package/src/materials/MeshStandardMaterial.js +42 -1
  309. package/src/materials/MeshToonMaterial.js +35 -2
  310. package/src/materials/PointsMaterial.js +7 -0
  311. package/src/materials/ShaderMaterial.js +106 -1
  312. package/src/materials/SpriteMaterial.js +7 -0
  313. package/src/materials/nodes/Line2NodeMaterial.js +380 -297
  314. package/src/materials/nodes/MeshBasicNodeMaterial.js +2 -2
  315. package/src/materials/nodes/MeshNormalNodeMaterial.js +2 -2
  316. package/src/materials/nodes/MeshPhongNodeMaterial.js +0 -9
  317. package/src/materials/nodes/MeshPhysicalNodeMaterial.js +3 -30
  318. package/src/materials/nodes/MeshSSSNodeMaterial.js +0 -13
  319. package/src/materials/nodes/MeshStandardNodeMaterial.js +5 -15
  320. package/src/materials/nodes/NodeMaterial.js +153 -89
  321. package/src/materials/nodes/SpriteNodeMaterial.js +0 -10
  322. package/src/materials/nodes/manager/NodeMaterialObserver.js +234 -100
  323. package/src/math/Box3.js +5 -0
  324. package/src/math/FrustumArray.js +103 -133
  325. package/src/math/Interpolant.js +1 -1
  326. package/src/math/Line3.js +6 -5
  327. package/src/math/MathUtils.js +12 -12
  328. package/src/math/Matrix2.js +13 -9
  329. package/src/math/Matrix3.js +24 -9
  330. package/src/math/Matrix4.js +112 -74
  331. package/src/math/Plane.js +4 -3
  332. package/src/math/Quaternion.js +3 -29
  333. package/src/math/Sphere.js +1 -1
  334. package/src/math/Triangle.js +1 -1
  335. package/src/math/Vector2.js +13 -9
  336. package/src/math/Vector3.js +17 -15
  337. package/src/math/Vector4.js +15 -11
  338. package/src/math/interpolants/BezierInterpolant.js +106 -0
  339. package/src/nodes/Nodes.js +86 -71
  340. package/src/nodes/TSL.js +15 -13
  341. package/src/nodes/accessors/Arrays.js +5 -5
  342. package/src/nodes/accessors/Batch.js +108 -0
  343. package/src/nodes/accessors/Bitangent.js +7 -7
  344. package/src/nodes/accessors/BufferAttributeNode.js +120 -17
  345. package/src/nodes/accessors/BufferNode.js +29 -2
  346. package/src/nodes/accessors/Camera.js +149 -28
  347. package/src/nodes/accessors/ClippingNode.js +5 -5
  348. package/src/nodes/accessors/CubeTextureNode.js +27 -2
  349. package/src/nodes/accessors/Instance.js +264 -0
  350. package/src/nodes/accessors/MaterialNode.js +27 -3
  351. package/src/nodes/accessors/MaterialProperties.js +6 -8
  352. package/src/nodes/accessors/MaterialReferenceNode.js +1 -2
  353. package/src/nodes/accessors/ModelNode.js +1 -1
  354. package/src/nodes/accessors/{MorphNode.js → Morph.js} +99 -112
  355. package/src/nodes/accessors/Normal.js +24 -24
  356. package/src/nodes/accessors/Object3DNode.js +1 -1
  357. package/src/nodes/accessors/Position.js +39 -3
  358. package/src/nodes/accessors/ReferenceBaseNode.js +6 -6
  359. package/src/nodes/accessors/ReferenceNode.js +9 -8
  360. package/src/nodes/accessors/ReflectVector.js +3 -3
  361. package/src/nodes/accessors/RendererReferenceNode.js +1 -2
  362. package/src/nodes/accessors/SceneProperties.js +47 -0
  363. package/src/nodes/accessors/Skinning.js +263 -0
  364. package/src/nodes/accessors/StorageBufferNode.js +16 -27
  365. package/src/nodes/accessors/StorageTexture3DNode.js +100 -0
  366. package/src/nodes/accessors/StorageTextureNode.js +74 -11
  367. package/src/nodes/accessors/Tangent.js +8 -18
  368. package/src/nodes/accessors/Texture3DNode.js +32 -35
  369. package/src/nodes/accessors/TextureNode.js +124 -25
  370. package/src/nodes/accessors/UniformArrayNode.js +6 -4
  371. package/src/nodes/accessors/UserDataNode.js +1 -2
  372. package/src/nodes/accessors/VertexColorNode.js +1 -2
  373. package/src/nodes/code/FunctionCallNode.js +1 -1
  374. package/src/nodes/code/FunctionNode.js +4 -19
  375. package/src/nodes/core/ArrayNode.js +21 -2
  376. package/src/nodes/core/AssignNode.js +3 -3
  377. package/src/nodes/core/AttributeNode.js +3 -3
  378. package/src/nodes/core/BypassNode.js +1 -1
  379. package/src/nodes/core/ContextNode.js +104 -5
  380. package/src/nodes/core/IndexNode.js +2 -1
  381. package/src/nodes/core/InputNode.js +1 -1
  382. package/src/nodes/core/InspectorNode.js +1 -1
  383. package/src/nodes/core/IsolateNode.js +1 -1
  384. package/src/nodes/core/MRTNode.js +55 -4
  385. package/src/nodes/core/Node.js +151 -17
  386. package/src/nodes/core/NodeBuilder.js +479 -101
  387. package/src/nodes/core/NodeError.js +28 -0
  388. package/src/nodes/core/NodeFrame.js +12 -4
  389. package/src/nodes/core/NodeUtils.js +20 -18
  390. package/src/nodes/core/OutputStructNode.js +13 -11
  391. package/src/nodes/core/OverrideContextNode.js +153 -0
  392. package/src/nodes/core/ParameterNode.js +4 -4
  393. package/src/nodes/core/PropertyNode.js +66 -4
  394. package/src/nodes/core/StackNode.js +91 -20
  395. package/src/nodes/core/StackTrace.js +139 -0
  396. package/src/nodes/core/StructNode.js +20 -8
  397. package/src/nodes/core/StructTypeNode.js +17 -23
  398. package/src/nodes/core/SubBuildNode.js +2 -2
  399. package/src/nodes/core/UniformGroupNode.js +36 -6
  400. package/src/nodes/core/UniformNode.js +21 -5
  401. package/src/nodes/core/VarNode.js +56 -23
  402. package/src/nodes/core/VaryingNode.js +14 -21
  403. package/src/nodes/display/BlendModes.js +1 -105
  404. package/src/nodes/display/BumpMapNode.js +6 -1
  405. package/src/nodes/display/ColorAdjustment.js +27 -9
  406. package/src/nodes/display/ColorSpaceNode.js +3 -3
  407. package/src/nodes/display/FrontFacingNode.js +38 -9
  408. package/src/nodes/display/NormalMapNode.js +41 -6
  409. package/src/nodes/display/PassNode.js +157 -56
  410. package/src/nodes/display/PremultiplyAlphaFunctions.js +39 -0
  411. package/src/nodes/display/RenderOutputNode.js +19 -10
  412. package/src/nodes/display/ScreenNode.js +4 -2
  413. package/src/nodes/display/ToneMappingNode.js +1 -1
  414. package/src/nodes/display/ToonOutlinePassNode.js +2 -2
  415. package/src/nodes/display/ViewportDepthNode.js +52 -4
  416. package/src/nodes/display/ViewportDepthTextureNode.js +11 -15
  417. package/src/nodes/display/ViewportTextureNode.js +39 -11
  418. package/src/nodes/fog/Fog.js +18 -35
  419. package/src/nodes/functions/BSDF/BRDF_GGX_Multiscatter.js +3 -3
  420. package/src/nodes/functions/BSDF/DFGLUT.js +56 -0
  421. package/src/nodes/functions/BSDF/EnvironmentBRDF.js +2 -2
  422. package/src/nodes/functions/BSDF/V_GGX_SmithCorrelated_Anisotropic.js +2 -2
  423. package/src/nodes/functions/PhysicalLightingModel.js +126 -45
  424. package/src/nodes/functions/VolumetricLightingModel.js +40 -7
  425. package/src/nodes/geometry/RangeNode.js +5 -3
  426. package/src/nodes/gpgpu/AtomicFunctionNode.js +1 -1
  427. package/src/nodes/gpgpu/BarrierNode.js +9 -0
  428. package/src/nodes/gpgpu/ComputeBuiltinNode.js +2 -3
  429. package/src/nodes/gpgpu/ComputeNode.js +74 -48
  430. package/src/nodes/gpgpu/SubgroupFunctionNode.js +2 -2
  431. package/src/nodes/gpgpu/WorkgroupInfoNode.js +5 -5
  432. package/src/nodes/lighting/AnalyticLightNode.js +53 -0
  433. package/src/nodes/lighting/EnvironmentNode.js +30 -5
  434. package/src/nodes/lighting/IESSpotLightNode.js +40 -2
  435. package/src/nodes/lighting/LightingContextNode.js +10 -2
  436. package/src/nodes/lighting/LightsNode.js +97 -65
  437. package/src/nodes/lighting/PointShadowNode.js +166 -148
  438. package/src/nodes/lighting/ShadowFilterNode.js +74 -117
  439. package/src/nodes/lighting/ShadowNode.js +149 -51
  440. package/src/nodes/materialx/lib/mx_noise.js +2 -2
  441. package/src/nodes/math/BitcastNode.js +1 -1
  442. package/src/nodes/math/BitcountNode.js +433 -0
  443. package/src/nodes/math/ConditionalNode.js +6 -6
  444. package/src/nodes/math/MathNode.js +115 -52
  445. package/src/nodes/math/OperatorNode.js +24 -23
  446. package/src/nodes/math/PackFloatNode.js +98 -0
  447. package/src/nodes/math/UnpackFloatNode.js +96 -0
  448. package/src/nodes/parsers/GLSLNodeFunction.js +1 -1
  449. package/src/nodes/pmrem/PMREMNode.js +34 -3
  450. package/src/nodes/pmrem/PMREMUtils.js +9 -15
  451. package/src/nodes/tsl/TSLBase.js +1 -1
  452. package/src/nodes/tsl/TSLCore.js +99 -33
  453. package/src/nodes/utils/ArrayElementNode.js +14 -1
  454. package/src/nodes/utils/ConvertNode.js +1 -1
  455. package/src/nodes/utils/DebugNode.js +12 -12
  456. package/src/nodes/utils/EquirectUV.js +30 -5
  457. package/src/nodes/utils/EventNode.js +31 -2
  458. package/src/nodes/utils/FlipNode.js +1 -1
  459. package/src/nodes/utils/FunctionOverloadingNode.js +2 -2
  460. package/src/nodes/utils/JoinNode.js +3 -3
  461. package/src/nodes/utils/LoopNode.js +1 -1
  462. package/src/nodes/utils/MemberNode.js +2 -2
  463. package/src/nodes/utils/Packing.js +48 -5
  464. package/src/nodes/utils/PostProcessingUtils.js +33 -1
  465. package/src/nodes/utils/RTTNode.js +41 -25
  466. package/src/nodes/utils/ReflectorNode.js +4 -4
  467. package/src/nodes/utils/Remap.js +48 -0
  468. package/src/nodes/utils/RotateNode.js +1 -1
  469. package/src/nodes/utils/SampleNode.js +1 -1
  470. package/src/nodes/utils/SetNode.js +1 -1
  471. package/src/nodes/utils/SplitNode.js +1 -1
  472. package/src/nodes/utils/SpriteSheetUV.js +35 -0
  473. package/src/nodes/utils/StorageArrayElementNode.js +1 -1
  474. package/src/nodes/utils/UVUtils.js +28 -0
  475. package/src/objects/BatchedMesh.js +66 -30
  476. package/src/objects/InstancedMesh.js +19 -3
  477. package/src/objects/Line.js +1 -1
  478. package/src/objects/Mesh.js +1 -1
  479. package/src/objects/Points.js +1 -1
  480. package/src/objects/SkinnedMesh.js +26 -9
  481. package/src/renderers/WebGLRenderer.js +344 -156
  482. package/src/renderers/common/Animation.js +3 -3
  483. package/src/renderers/common/Attributes.js +15 -1
  484. package/src/renderers/common/Backend.js +78 -13
  485. package/src/renderers/common/Background.js +26 -13
  486. package/src/renderers/common/BindGroup.js +1 -16
  487. package/src/renderers/common/Binding.js +11 -0
  488. package/src/renderers/common/Bindings.js +141 -57
  489. package/src/renderers/common/BlendMode.js +143 -0
  490. package/src/renderers/common/Buffer.js +49 -0
  491. package/src/renderers/common/BundleGroup.js +1 -1
  492. package/src/renderers/common/ChainMap.js +30 -6
  493. package/src/renderers/common/ClippingContext.js +10 -2
  494. package/src/renderers/common/ComputePipeline.js +1 -1
  495. package/src/renderers/common/CubeRenderTarget.js +51 -7
  496. package/src/renderers/common/Geometries.js +29 -3
  497. package/src/renderers/common/Info.js +374 -4
  498. package/src/renderers/common/InspectorBase.js +6 -1
  499. package/src/renderers/common/Lighting.js +51 -19
  500. package/src/renderers/common/Pipelines.js +40 -7
  501. package/src/renderers/common/PostProcessing.js +8 -206
  502. package/src/renderers/common/ReadbackBuffer.js +78 -0
  503. package/src/renderers/common/RenderBundle.js +3 -1
  504. package/src/renderers/common/RenderBundles.js +7 -3
  505. package/src/renderers/common/RenderContext.js +16 -0
  506. package/src/renderers/common/RenderContexts.js +33 -49
  507. package/src/renderers/common/RenderList.js +41 -4
  508. package/src/renderers/common/RenderLists.js +2 -1
  509. package/src/renderers/common/RenderObject.js +88 -16
  510. package/src/renderers/common/RenderObjectPipeline.js +40 -0
  511. package/src/renderers/common/RenderObjects.js +21 -5
  512. package/src/renderers/common/RenderPipeline.js +232 -17
  513. package/src/renderers/common/Renderer.js +700 -163
  514. package/src/renderers/common/Sampler.js +16 -48
  515. package/src/renderers/common/StorageBuffer.js +13 -1
  516. package/src/renderers/common/Textures.js +121 -9
  517. package/src/renderers/common/TimestampQueryPool.js +6 -4
  518. package/src/renderers/common/Uniform.js +8 -0
  519. package/src/renderers/common/UniformsGroup.js +84 -1
  520. package/src/renderers/common/XRManager.js +377 -51
  521. package/src/renderers/common/extras/PMREMGenerator.js +40 -61
  522. package/src/renderers/common/nodes/NodeBuilderState.js +10 -2
  523. package/src/renderers/common/nodes/NodeLibrary.js +4 -4
  524. package/src/renderers/common/nodes/{Nodes.js → NodeManager.js} +298 -106
  525. package/src/renderers/common/nodes/NodeStorageBuffer.js +13 -2
  526. package/src/renderers/common/nodes/NodeUniformBuffer.js +65 -0
  527. package/src/renderers/shaders/DFGLUTData.js +19 -34
  528. package/src/renderers/shaders/ShaderChunk/batching_pars_vertex.glsl.js +2 -2
  529. package/src/renderers/shaders/ShaderChunk/color_fragment.glsl.js +1 -5
  530. package/src/renderers/shaders/ShaderChunk/color_pars_fragment.glsl.js +1 -5
  531. package/src/renderers/shaders/ShaderChunk/color_pars_vertex.glsl.js +1 -5
  532. package/src/renderers/shaders/ShaderChunk/color_vertex.glsl.js +8 -10
  533. package/src/renderers/shaders/ShaderChunk/common.glsl.js +13 -4
  534. package/src/renderers/shaders/ShaderChunk/defaultnormal_vertex.glsl.js +0 -6
  535. package/src/renderers/shaders/ShaderChunk/envmap_common_pars_fragment.glsl.js +0 -1
  536. package/src/renderers/shaders/ShaderChunk/envmap_fragment.glsl.js +9 -13
  537. package/src/renderers/shaders/ShaderChunk/envmap_physical_pars_fragment.glsl.js +2 -2
  538. package/src/renderers/shaders/ShaderChunk/envmap_vertex.glsl.js +1 -1
  539. package/src/renderers/shaders/ShaderChunk/lightprobes_pars_fragment.glsl.js +80 -0
  540. package/src/renderers/shaders/ShaderChunk/lights_fragment_begin.glsl.js +13 -2
  541. package/src/renderers/shaders/ShaderChunk/lights_fragment_end.glsl.js +6 -0
  542. package/src/renderers/shaders/ShaderChunk/lights_fragment_maps.glsl.js +6 -2
  543. package/src/renderers/shaders/ShaderChunk/lights_pars_begin.glsl.js +3 -1
  544. package/src/renderers/shaders/ShaderChunk/lights_physical_fragment.glsl.js +8 -4
  545. package/src/renderers/shaders/ShaderChunk/lights_physical_pars_fragment.glsl.js +112 -53
  546. package/src/renderers/shaders/ShaderChunk/normal_fragment_begin.glsl.js +2 -2
  547. package/src/renderers/shaders/ShaderChunk/normal_fragment_maps.glsl.js +7 -0
  548. package/src/renderers/shaders/ShaderChunk/normal_vertex.glsl.js +6 -0
  549. package/src/renderers/shaders/ShaderChunk/packing.glsl.js +20 -4
  550. package/src/renderers/shaders/ShaderChunk/premultiplied_alpha_fragment.glsl.js +0 -1
  551. package/src/renderers/shaders/ShaderChunk/shadowmap_pars_fragment.glsl.js +225 -186
  552. package/src/renderers/shaders/ShaderChunk/shadowmap_vertex.glsl.js +12 -2
  553. package/src/renderers/shaders/ShaderChunk/shadowmask_pars_fragment.glsl.js +1 -1
  554. package/src/renderers/shaders/ShaderChunk/transmission_fragment.glsl.js +2 -2
  555. package/src/renderers/shaders/ShaderChunk.js +5 -3
  556. package/src/renderers/shaders/ShaderLib/backgroundCube.glsl.js +1 -2
  557. package/src/renderers/shaders/ShaderLib/depth.glsl.js +3 -0
  558. package/src/renderers/shaders/ShaderLib/{distanceRGBA.glsl.js → distance.glsl.js} +2 -3
  559. package/src/renderers/shaders/ShaderLib/meshlambert.glsl.js +2 -1
  560. package/src/renderers/shaders/ShaderLib/meshnormal.glsl.js +1 -2
  561. package/src/renderers/shaders/ShaderLib/meshphong.glsl.js +2 -1
  562. package/src/renderers/shaders/ShaderLib/meshphysical.glsl.js +4 -9
  563. package/src/renderers/shaders/ShaderLib/meshtoon.glsl.js +0 -1
  564. package/src/renderers/shaders/ShaderLib/shadow.glsl.js +1 -1
  565. package/src/renderers/shaders/ShaderLib/vsm.glsl.js +4 -6
  566. package/src/renderers/shaders/ShaderLib.js +7 -6
  567. package/src/renderers/shaders/UniformsLib.js +7 -5
  568. package/src/renderers/shaders/UniformsUtils.js +27 -5
  569. package/src/renderers/webgl/WebGLAnimation.js +2 -1
  570. package/src/renderers/webgl/WebGLBackground.js +15 -15
  571. package/src/renderers/webgl/WebGLBindingStates.js +99 -27
  572. package/src/renderers/webgl/WebGLBufferRenderer.js +0 -32
  573. package/src/renderers/webgl/WebGLCapabilities.js +9 -4
  574. package/src/renderers/webgl/WebGLEnvironments.js +228 -0
  575. package/src/renderers/webgl/WebGLGeometries.js +10 -7
  576. package/src/renderers/webgl/WebGLIndexedBufferRenderer.js +0 -32
  577. package/src/renderers/webgl/WebGLLights.js +18 -1
  578. package/src/renderers/webgl/WebGLMaterials.js +24 -13
  579. package/src/renderers/webgl/WebGLObjects.js +3 -1
  580. package/src/renderers/webgl/WebGLOutput.js +271 -0
  581. package/src/renderers/webgl/WebGLProgram.js +54 -113
  582. package/src/renderers/webgl/WebGLPrograms.js +74 -55
  583. package/src/renderers/webgl/WebGLRenderLists.js +24 -1
  584. package/src/renderers/webgl/WebGLRenderStates.js +13 -2
  585. package/src/renderers/webgl/WebGLShaderCache.js +5 -11
  586. package/src/renderers/webgl/WebGLShadowMap.js +188 -24
  587. package/src/renderers/webgl/WebGLState.js +75 -37
  588. package/src/renderers/webgl/WebGLTextures.js +230 -56
  589. package/src/renderers/webgl/WebGLUniforms.js +40 -3
  590. package/src/renderers/webgl/WebGLUniformsGroups.js +82 -35
  591. package/src/renderers/webgl/WebGLUtils.js +6 -2
  592. package/src/renderers/webgl-fallback/WebGLBackend.js +322 -92
  593. package/src/renderers/webgl-fallback/WebGLBufferRenderer.js +0 -41
  594. package/src/renderers/webgl-fallback/nodes/GLSLNodeBuilder.js +295 -66
  595. package/src/renderers/webgl-fallback/utils/WebGLAttributeUtils.js +53 -19
  596. package/src/renderers/webgl-fallback/utils/WebGLCapabilities.js +25 -0
  597. package/src/renderers/webgl-fallback/utils/WebGLState.js +223 -6
  598. package/src/renderers/webgl-fallback/utils/WebGLTextureUtils.js +118 -73
  599. package/src/renderers/webgl-fallback/utils/WebGLTimestampQueryPool.js +10 -10
  600. package/src/renderers/webgl-fallback/utils/WebGLUtils.js +9 -3
  601. package/src/renderers/webgpu/WebGPUBackend.js +733 -302
  602. package/src/renderers/webgpu/WebGPURenderer.js +2 -1
  603. package/src/renderers/webgpu/descriptors/GPUBindGroupDescriptor.js +48 -0
  604. package/src/renderers/webgpu/descriptors/GPUBufferDescriptor.js +57 -0
  605. package/src/renderers/webgpu/descriptors/GPUCommandEncoderDescriptor.js +30 -0
  606. package/src/renderers/webgpu/descriptors/GPUComputePassDescriptor.js +38 -0
  607. package/src/renderers/webgpu/descriptors/GPUComputePipelineDescriptor.js +48 -0
  608. package/src/renderers/webgpu/descriptors/GPUCopyExternalImageDestInfo.js +47 -0
  609. package/src/renderers/webgpu/descriptors/GPUCopyExternalImageSourceInfo.js +50 -0
  610. package/src/renderers/webgpu/descriptors/GPUExtent3D.js +51 -0
  611. package/src/renderers/webgpu/descriptors/GPUPipelineLayoutDescriptor.js +39 -0
  612. package/src/renderers/webgpu/descriptors/GPUQuerySetDescriptor.js +47 -0
  613. package/src/renderers/webgpu/descriptors/GPURenderBundleEncoderDescriptor.js +74 -0
  614. package/src/renderers/webgpu/descriptors/GPURenderPassColorAttachment.js +72 -0
  615. package/src/renderers/webgpu/descriptors/GPURenderPassDepthStencilAttachment.js +99 -0
  616. package/src/renderers/webgpu/descriptors/GPURenderPassDescriptor.js +72 -0
  617. package/src/renderers/webgpu/descriptors/GPURenderPassTimestampWrites.js +49 -0
  618. package/src/renderers/webgpu/descriptors/GPURenderPipelineDescriptor.js +130 -0
  619. package/src/renderers/webgpu/descriptors/GPUSamplerDescriptor.js +119 -0
  620. package/src/renderers/webgpu/descriptors/GPUShaderModuleDescriptor.js +46 -0
  621. package/src/renderers/webgpu/descriptors/GPUTexelCopyBufferInfo.js +57 -0
  622. package/src/renderers/webgpu/descriptors/GPUTexelCopyBufferLayout.js +48 -0
  623. package/src/renderers/webgpu/descriptors/GPUTexelCopyTextureInfo.js +61 -0
  624. package/src/renderers/webgpu/descriptors/GPUTextureDescriptor.js +99 -0
  625. package/src/renderers/webgpu/descriptors/GPUTextureViewDescriptor.js +108 -0
  626. package/src/renderers/webgpu/nodes/StandardNodeLibrary.js +0 -1
  627. package/src/renderers/webgpu/nodes/WGSLNodeBuilder.js +526 -93
  628. package/src/renderers/webgpu/nodes/WGSLNodeFunction.js +1 -1
  629. package/src/renderers/webgpu/utils/WebGPUAttributeUtils.js +194 -61
  630. package/src/renderers/webgpu/utils/WebGPUBindingUtils.js +395 -234
  631. package/src/renderers/webgpu/utils/WebGPUCapabilities.js +48 -0
  632. package/src/renderers/webgpu/utils/WebGPUConstants.js +10 -0
  633. package/src/renderers/webgpu/utils/WebGPUPipelineUtils.js +224 -91
  634. package/src/renderers/webgpu/utils/WebGPUTexturePassUtils.js +228 -213
  635. package/src/renderers/webgpu/utils/WebGPUTextureUtils.js +428 -175
  636. package/src/renderers/webgpu/utils/WebGPUTimestampQueryPool.js +40 -25
  637. package/src/renderers/webgpu/utils/WebGPUUtils.js +70 -13
  638. package/src/renderers/webxr/WebXRController.js +12 -0
  639. package/src/renderers/webxr/WebXRManager.js +4 -2
  640. package/src/textures/CubeDepthTexture.js +76 -0
  641. package/src/textures/DepthTexture.js +1 -1
  642. package/src/textures/ExternalTexture.js +0 -3
  643. package/src/textures/HTMLTexture.js +74 -0
  644. package/src/textures/Source.js +2 -2
  645. package/src/textures/Texture.js +16 -5
  646. package/src/utils.js +280 -3
  647. package/examples/fonts/LICENSE +0 -13
  648. package/examples/fonts/MPLUSRounded1c/MPLUSRounded1c-Regular.typeface.json.zip +0 -0
  649. package/examples/fonts/MPLUSRounded1c/OFL.txt +0 -91
  650. package/examples/fonts/README.md +0 -11
  651. package/examples/fonts/droid/NOTICE +0 -190
  652. package/examples/fonts/droid/README.txt +0 -18
  653. package/examples/fonts/droid/droid_sans_bold.typeface.json +0 -1
  654. package/examples/fonts/droid/droid_sans_mono_regular.typeface.json +0 -1
  655. package/examples/fonts/droid/droid_sans_regular.typeface.json +0 -1
  656. package/examples/fonts/droid/droid_serif_bold.typeface.json +0 -1
  657. package/examples/fonts/droid/droid_serif_regular.typeface.json +0 -1
  658. package/examples/fonts/gentilis_bold.typeface.json +0 -1
  659. package/examples/fonts/gentilis_regular.typeface.json +0 -1
  660. package/examples/fonts/helvetiker_bold.typeface.json +0 -1
  661. package/examples/fonts/helvetiker_regular.typeface.json +0 -1
  662. package/examples/fonts/optimer_bold.typeface.json +0 -1
  663. package/examples/fonts/optimer_regular.typeface.json +0 -1
  664. package/examples/fonts/ttf/README.md +0 -9
  665. package/examples/fonts/ttf/kenpixel.ttf +0 -0
  666. package/examples/jsm/libs/ammo.wasm.js +0 -822
  667. package/examples/jsm/libs/ammo.wasm.wasm +0 -0
  668. package/examples/jsm/libs/draco/draco_encoder.js +0 -33
  669. package/examples/jsm/libs/draco/gltf/draco_encoder.js +0 -33
  670. package/examples/jsm/libs/lottie_canvas.module.js +0 -14849
  671. package/examples/jsm/libs/opentype.module.js +0 -14506
  672. package/examples/jsm/libs/rhino3dm/rhino3dm.js +0 -21
  673. package/examples/jsm/libs/rhino3dm/rhino3dm.module.js +0 -16
  674. package/examples/jsm/libs/rhino3dm/rhino3dm.wasm +0 -0
  675. package/examples/jsm/lighting/TiledLighting.js +0 -42
  676. package/examples/jsm/materials/MeshGouraudMaterial.js +0 -434
  677. package/examples/jsm/materials/MeshPostProcessingMaterial.js +0 -167
  678. package/examples/jsm/shaders/GodRaysShader.js +0 -333
  679. package/examples/jsm/tsl/display/AnamorphicNode.js +0 -282
  680. package/examples/jsm/tsl/lighting/TiledLightsNode.js +0 -442
  681. package/src/nodes/accessors/BatchNode.js +0 -163
  682. package/src/nodes/accessors/InstanceNode.js +0 -244
  683. package/src/nodes/accessors/InstancedMeshNode.js +0 -50
  684. package/src/nodes/accessors/SceneNode.js +0 -145
  685. package/src/nodes/accessors/SkinningNode.js +0 -327
  686. package/src/nodes/code/ScriptableNode.js +0 -726
  687. package/src/nodes/code/ScriptableValueNode.js +0 -253
  688. package/src/nodes/display/PosterizeNode.js +0 -65
  689. package/src/nodes/functions/BSDF/DFGApprox.js +0 -71
  690. package/src/nodes/utils/RemapNode.js +0 -125
  691. package/src/nodes/utils/SpriteSheetUVNode.js +0 -90
  692. package/src/renderers/webgl/WebGLCubeMaps.js +0 -99
  693. package/src/renderers/webgl/WebGLCubeUVMaps.js +0 -134
@@ -0,0 +1,1696 @@
1
+ import { Tab } from '../ui/Tab.js';
2
+ import { Graph } from '../ui/Graph.js';
3
+ import { getItem, setItem } from '../Inspector.js';
4
+ import { info } from '../ui/utils.js';
5
+ import {
6
+ ByteType,
7
+ FloatType,
8
+ HalfFloatType,
9
+ IntType,
10
+ ShortType,
11
+ UnsignedByteType,
12
+ UnsignedInt101111Type,
13
+ UnsignedInt248Type,
14
+ UnsignedInt5999Type,
15
+ UnsignedIntType,
16
+ UnsignedShort4444Type,
17
+ UnsignedShort5551Type,
18
+ UnsignedShortType,
19
+ AlphaFormat,
20
+ RGBFormat,
21
+ RGBAFormat,
22
+ DepthFormat,
23
+ DepthStencilFormat,
24
+ RedFormat,
25
+ RedIntegerFormat,
26
+ RGFormat,
27
+ RGIntegerFormat,
28
+ RGBIntegerFormat,
29
+ RGBAIntegerFormat
30
+ } from 'three';
31
+
32
+ const LIMIT = 500;
33
+ const TRIANGLES_GRAPH_LIMIT = 60;
34
+
35
+ class Timeline extends Tab {
36
+
37
+ constructor( options = {} ) {
38
+
39
+ super( 'Timeline', options );
40
+
41
+ this.content.style.overflow = 'hidden';
42
+ this.isRecording = false;
43
+ this.frames = []; // Array of { id: number, calls: [] }
44
+
45
+ this.baseTriangles = 0;
46
+ this.currentFrame = null;
47
+ this.isHierarchicalView = true;
48
+ this.callBlocks = new WeakMap();
49
+ this.fallbackBlocks = [];
50
+ this.originalBackend = null;
51
+ this.originalMethods = new Map();
52
+ this.renderer = null;
53
+
54
+ this.graph = new Graph( LIMIT ); // Accommodate standard graph points
55
+ // Make lines in timeline graph
56
+ this.graph.addLine( 'fps', 'var( --color-fps )' );
57
+ this.graph.addLine( 'calls', 'var( --color-call )' );
58
+ this.graph.addLine( 'triangles', 'var( --color-red )' );
59
+
60
+ this.buildHeader();
61
+ this.buildUI();
62
+
63
+ // Bind window resize to update graph bounds
64
+ window.addEventListener( 'resize', () => {
65
+
66
+ if ( this.isActive && ! this.isRecording && this.frames.length > 0 ) {
67
+
68
+ this.renderSlider();
69
+
70
+ }
71
+
72
+ } );
73
+
74
+ }
75
+
76
+ init( inspector ) {
77
+
78
+ super.init( inspector );
79
+
80
+ this.profiler.addEventListener( 'resize', () => {
81
+
82
+ if ( this.isActive && ! this.isRecording && this.frames.length > 0 ) {
83
+
84
+ this.renderSlider();
85
+
86
+ }
87
+
88
+ } );
89
+
90
+ }
91
+
92
+ setActive( isActive ) {
93
+
94
+ super.setActive( isActive );
95
+
96
+ if ( isActive && ! this.isRecording && this.frames.length > 0 ) {
97
+
98
+ this.renderSlider();
99
+
100
+ }
101
+
102
+ }
103
+
104
+ buildHeader() {
105
+
106
+ const header = document.createElement( 'div' );
107
+ header.className = 'toolbar';
108
+
109
+ this.recordButton = document.createElement( 'button' );
110
+ this.recordButton.className = 'console-copy-button'; // Reusing style
111
+ this.recordButton.title = 'Record';
112
+ this.recordButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><circle cx="12" cy="12" r="4" fill="currentColor"></circle></svg>';
113
+ this.recordButton.style.padding = '0 10px';
114
+ this.recordButton.style.lineHeight = '24px'; // Match other buttons height
115
+ this.recordButton.style.display = 'flex';
116
+ this.recordButton.style.alignItems = 'center';
117
+ this.recordButton.addEventListener( 'click', () => this.toggleRecording() );
118
+
119
+ const clearButton = document.createElement( 'button' );
120
+ clearButton.className = 'console-copy-button';
121
+ clearButton.title = 'Clear';
122
+ clearButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"></polyline><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6m3 0V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"></path><line x1="10" y1="11" x2="10" y2="17"></line><line x1="14" y1="11" x2="14" y2="17"></line></svg>';
123
+ clearButton.style.padding = '0 10px';
124
+ clearButton.style.lineHeight = '24px';
125
+ clearButton.style.display = 'flex';
126
+ clearButton.style.alignItems = 'center';
127
+ clearButton.addEventListener( 'click', () => this.clear() );
128
+
129
+ this.viewModeSelect = document.createElement( 'select' );
130
+ this.viewModeSelect.className = 'select';
131
+ this.viewModeSelect.style.width = '120px';
132
+ this.viewModeSelect.style.marginRight = '10px';
133
+
134
+ const hierarchyOption = document.createElement( 'option' );
135
+ hierarchyOption.value = 'hierarchy';
136
+ hierarchyOption.textContent = 'Hierarchy';
137
+ this.viewModeSelect.appendChild( hierarchyOption );
138
+
139
+ const countsOption = document.createElement( 'option' );
140
+ countsOption.value = 'counts';
141
+ countsOption.textContent = 'Count';
142
+ this.viewModeSelect.appendChild( countsOption );
143
+
144
+ this.viewModeSelect.value = this.isHierarchicalView ? 'hierarchy' : 'counts';
145
+
146
+ this.viewModeSelect.addEventListener( 'change', () => {
147
+
148
+ this.isHierarchicalView = this.viewModeSelect.value === 'hierarchy';
149
+
150
+ if ( this.selectedFrameIndex !== undefined && this.selectedFrameIndex !== - 1 ) {
151
+
152
+ this.selectFrame( this.selectedFrameIndex );
153
+
154
+ }
155
+
156
+ } );
157
+
158
+ this.recordRefreshButton = document.createElement( 'button' );
159
+ this.recordRefreshButton.className = 'console-copy-button'; // Reusing style
160
+ this.recordRefreshButton.title = 'Refresh & Record';
161
+ this.recordRefreshButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 12a9 9 0 1 1-9-9c2.52 0 4.93 1 6.74 2.74L21 8"></path><path d="M21 3v5h-5"></path><circle cx="12" cy="12" r="3" fill="currentColor"></circle></svg>';
162
+ this.recordRefreshButton.style.padding = '0 10px';
163
+ this.recordRefreshButton.style.lineHeight = '24px';
164
+ this.recordRefreshButton.style.display = 'flex';
165
+ this.recordRefreshButton.style.alignItems = 'center';
166
+ this.recordRefreshButton.addEventListener( 'click', () => {
167
+
168
+ const timelineSettings = getItem( 'timeline' );
169
+ timelineSettings.recording = true;
170
+ setItem( 'timeline', timelineSettings );
171
+
172
+ window.location.reload();
173
+
174
+ } );
175
+
176
+ this.exportButton = document.createElement( 'button' );
177
+ this.exportButton.className = 'console-copy-button';
178
+ this.exportButton.title = 'Export';
179
+ this.exportButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"></path><polyline points="7 10 12 15 17 10"></polyline><line x1="12" y1="15" x2="12" y2="3"></line></svg>';
180
+ this.exportButton.style.padding = '0 10px';
181
+ this.exportButton.style.lineHeight = '24px';
182
+ this.exportButton.style.display = 'flex';
183
+ this.exportButton.style.alignItems = 'center';
184
+ this.exportButton.addEventListener( 'click', () => this.exportData() );
185
+
186
+ const buttonsGroup = document.createElement( 'div' );
187
+ buttonsGroup.className = 'console-buttons-group';
188
+ buttonsGroup.appendChild( this.recordButton );
189
+ buttonsGroup.appendChild( this.recordRefreshButton );
190
+ buttonsGroup.appendChild( this.exportButton );
191
+ buttonsGroup.appendChild( clearButton );
192
+
193
+ const titleElement = document.createElement( 'div' );
194
+ titleElement.style.display = 'flex';
195
+ titleElement.style.alignItems = 'center';
196
+ titleElement.style.color = 'var(--text-primary)';
197
+ titleElement.style.alignSelf = 'center';
198
+
199
+ this.frameInfo = document.createElement( 'span' );
200
+ this.frameInfo.style.display = 'inline-flex';
201
+ this.frameInfo.style.alignItems = 'center';
202
+ this.frameInfo.style.marginLeft = '5px';
203
+ this.frameInfo.style.fontFamily = 'monospace';
204
+ this.frameInfo.style.color = 'var(--text-secondary)';
205
+ this.frameInfo.style.fontSize = '12px';
206
+
207
+ titleElement.appendChild( this.viewModeSelect );
208
+ titleElement.appendChild( this.frameInfo );
209
+
210
+ header.appendChild( titleElement );
211
+ header.appendChild( buttonsGroup );
212
+ this.content.appendChild( header );
213
+
214
+ }
215
+
216
+ buildUI() {
217
+
218
+ const container = document.createElement( 'div' );
219
+ container.style.display = 'flex';
220
+ container.style.flexDirection = 'column';
221
+ container.style.flex = '1';
222
+ container.style.minHeight = '0';
223
+ container.style.marginTop = '10px';
224
+ container.style.width = '100%';
225
+
226
+ // Top Player/Graph Slider using Graph.js SVG
227
+ const graphContainer = document.createElement( 'div' );
228
+ graphContainer.style.height = '60px';
229
+ graphContainer.style.minHeight = '60px';
230
+ graphContainer.style.borderBottom = '1px solid var(--border-color)';
231
+ graphContainer.style.backgroundColor = 'var(--background-color)';
232
+
233
+ this.graphSlider = document.createElement( 'div' );
234
+ this.graphSlider.style.height = '100%';
235
+ this.graphSlider.style.margin = '0 10px';
236
+ this.graphSlider.style.position = 'relative';
237
+ this.graphSlider.style.cursor = 'crosshair';
238
+ this.graphSlider.style.touchAction = 'none';
239
+
240
+ graphContainer.appendChild( this.graphSlider );
241
+
242
+ // Setup SVG from Graph
243
+ this.graph.domElement.style.width = '0';
244
+ this.graph.domElement.style.minWidth = '100%';
245
+ this.graph.domElement.style.height = '100%';
246
+ this.graphSlider.appendChild( this.graph.domElement );
247
+
248
+ // Hover indicator
249
+ this.hoverIndicator = document.createElement( 'div' );
250
+ this.hoverIndicator.style.position = 'absolute';
251
+ this.hoverIndicator.style.top = '0';
252
+ this.hoverIndicator.style.bottom = '0';
253
+ this.hoverIndicator.style.width = '1px';
254
+ this.hoverIndicator.style.backgroundColor = 'rgba(255, 255, 255, 0.3)';
255
+ this.hoverIndicator.style.pointerEvents = 'none';
256
+ this.hoverIndicator.style.display = 'none';
257
+ this.hoverIndicator.style.zIndex = '9';
258
+ this.hoverIndicator.style.transform = 'translateX(-50%)';
259
+ this.graphSlider.appendChild( this.hoverIndicator );
260
+
261
+ // Playhead indicator (vertical line)
262
+ this.playhead = document.createElement( 'div' );
263
+ this.playhead.style.position = 'absolute';
264
+ this.playhead.style.top = '0';
265
+ this.playhead.style.bottom = '0';
266
+ this.playhead.style.width = '2px';
267
+ this.playhead.style.backgroundColor = 'var(--color-red)';
268
+ this.playhead.style.boxShadow = '0 0 4px rgba(255,0,0,0.5)';
269
+ this.playhead.style.pointerEvents = 'none';
270
+ this.playhead.style.display = 'none';
271
+ this.playhead.style.zIndex = '10';
272
+ this.playhead.style.transform = 'translateX(-50%)';
273
+ this.graphSlider.appendChild( this.playhead );
274
+
275
+ // Playhead handle (triangle/pointer)
276
+ const playheadHandle = document.createElement( 'div' );
277
+ playheadHandle.style.position = 'absolute';
278
+ playheadHandle.style.top = '0';
279
+ playheadHandle.style.left = '50%';
280
+ playheadHandle.style.transform = 'translate(-50%, 0)';
281
+ playheadHandle.style.width = '0';
282
+ playheadHandle.style.height = '0';
283
+ playheadHandle.style.borderLeft = '6px solid transparent';
284
+ playheadHandle.style.borderRight = '6px solid transparent';
285
+ playheadHandle.style.borderTop = '8px solid var(--color-red)';
286
+ this.playhead.appendChild( playheadHandle );
287
+
288
+ // Make it focusable to accept keyboard events
289
+ this.graphSlider.tabIndex = 0;
290
+ this.graphSlider.style.outline = 'none';
291
+
292
+ // Pointer interactivity on the graph
293
+ let isDragging = false;
294
+
295
+ const updatePlayheadFromEvent = ( e ) => {
296
+
297
+ if ( this.isRecording || this.frames.length === 0 ) return;
298
+
299
+ const rect = this.graphSlider.getBoundingClientRect();
300
+ let x = e.clientX - rect.left;
301
+
302
+ // Clamp
303
+ x = Math.max( 0, Math.min( x, rect.width ) );
304
+
305
+ this.fixedScreenX = x;
306
+
307
+ // The graph stretches its points across the width
308
+ // Find closest frame index based on exact point coordinates
309
+ const pointCount = this.graph.lines[ 'calls' ].points.length;
310
+ if ( pointCount === 0 ) return;
311
+
312
+ const pointStep = rect.width / ( this.graph.maxPoints - 1 );
313
+ const offset = rect.width - ( ( pointCount - 1 ) * pointStep );
314
+
315
+ let localFrameIndex = Math.round( ( x - offset ) / pointStep );
316
+ localFrameIndex = Math.max( 0, Math.min( localFrameIndex, pointCount - 1 ) );
317
+
318
+ if ( localFrameIndex >= pointCount - 2 ) {
319
+
320
+ this.isTrackingLatest = true;
321
+
322
+ } else {
323
+
324
+ this.isTrackingLatest = false;
325
+
326
+ }
327
+
328
+ let frameIndex = localFrameIndex;
329
+
330
+ if ( this.frames.length > pointCount ) {
331
+
332
+ frameIndex += this.frames.length - pointCount;
333
+
334
+ }
335
+
336
+ this.playhead.style.display = 'block';
337
+ this.selectFrame( frameIndex );
338
+
339
+ };
340
+
341
+ this.graphSlider.addEventListener( 'pointerdown', ( e ) => {
342
+
343
+ if ( this.isRecording ) return;
344
+
345
+ isDragging = true;
346
+ this.isManualScrubbing = true;
347
+ this.graphSlider.focus();
348
+ updatePlayheadFromEvent( e );
349
+
350
+ } );
351
+
352
+ this.graphSlider.addEventListener( 'pointerenter', () => {
353
+
354
+ if ( this.frames.length > 0 && ! this.isRecording ) {
355
+
356
+ this.hoverIndicator.style.display = 'block';
357
+
358
+ }
359
+
360
+ } );
361
+
362
+ this.graphSlider.addEventListener( 'pointerleave', () => {
363
+
364
+ this.hoverIndicator.style.display = 'none';
365
+
366
+ } );
367
+
368
+ this.graphSlider.addEventListener( 'pointermove', ( e ) => {
369
+
370
+ if ( this.frames.length === 0 || this.isRecording ) return;
371
+
372
+ const rect = this.graphSlider.getBoundingClientRect();
373
+ let x = e.clientX - rect.left;
374
+ x = Math.max( 0, Math.min( x, rect.width ) );
375
+
376
+ const pointCount = this.graph.lines[ 'calls' ].points.length;
377
+ if ( pointCount > 0 ) {
378
+
379
+ const pointStep = rect.width / ( this.graph.maxPoints - 1 );
380
+ const offset = rect.width - ( ( pointCount - 1 ) * pointStep );
381
+
382
+ let localFrameIndex = Math.round( ( x - offset ) / pointStep );
383
+ localFrameIndex = Math.max( 0, Math.min( localFrameIndex, pointCount - 1 ) );
384
+
385
+ let snappedX = offset + localFrameIndex * pointStep;
386
+ snappedX = Math.max( 1, Math.min( snappedX, rect.width - 1 ) );
387
+ this.hoverIndicator.style.left = snappedX + 'px';
388
+
389
+ } else {
390
+
391
+ const clampedX = Math.max( 1, Math.min( x, rect.width - 1 ) );
392
+ this.hoverIndicator.style.left = clampedX + 'px';
393
+
394
+ }
395
+
396
+ } );
397
+
398
+ this.graphSlider.addEventListener( 'keydown', ( e ) => {
399
+
400
+ if ( this.frames.length === 0 || this.isRecording ) return;
401
+
402
+ let newIndex = this.selectedFrameIndex;
403
+
404
+ if ( e.key === 'ArrowLeft' ) {
405
+
406
+ newIndex = Math.max( 0, this.selectedFrameIndex - 1 );
407
+ e.preventDefault();
408
+
409
+ } else if ( e.key === 'ArrowRight' ) {
410
+
411
+ newIndex = Math.min( this.frames.length - 1, this.selectedFrameIndex + 1 );
412
+ e.preventDefault();
413
+
414
+ }
415
+
416
+ if ( newIndex !== this.selectedFrameIndex ) {
417
+
418
+ this.selectFrame( newIndex );
419
+
420
+ // Update playhead tracking state
421
+ const pointCount = this.graph.lines[ 'calls' ].points.length;
422
+ if ( pointCount > 0 ) {
423
+
424
+ let localIndex = newIndex;
425
+ if ( this.frames.length > pointCount ) {
426
+
427
+ localIndex = newIndex - ( this.frames.length - pointCount );
428
+
429
+ }
430
+
431
+ if ( localIndex >= pointCount - 2 ) {
432
+
433
+ this.isTrackingLatest = true;
434
+
435
+ } else {
436
+
437
+ this.isTrackingLatest = false;
438
+
439
+ }
440
+
441
+ const rect = this.graphSlider.getBoundingClientRect();
442
+ const pointStep = rect.width / ( this.graph.maxPoints - 1 );
443
+ const offset = rect.width - ( ( pointCount - 1 ) * pointStep );
444
+ this.fixedScreenX = offset + localIndex * pointStep;
445
+
446
+ }
447
+
448
+ }
449
+
450
+ } );
451
+
452
+ window.addEventListener( 'pointermove', ( e ) => {
453
+
454
+ if ( isDragging ) {
455
+
456
+ updatePlayheadFromEvent( e );
457
+
458
+ // Also move hover indicator to match playback
459
+ const rect = this.graphSlider.getBoundingClientRect();
460
+ let x = e.clientX - rect.left;
461
+ x = Math.max( 0, Math.min( x, rect.width ) );
462
+
463
+ const pointCount = this.graph.lines[ 'calls' ].points.length;
464
+ if ( pointCount > 0 ) {
465
+
466
+ const pointStep = rect.width / ( this.graph.maxPoints - 1 );
467
+ const offset = rect.width - ( ( pointCount - 1 ) * pointStep );
468
+
469
+ let localFrameIndex = Math.round( ( x - offset ) / pointStep );
470
+ localFrameIndex = Math.max( 0, Math.min( localFrameIndex, pointCount - 1 ) );
471
+
472
+ let snappedX = offset + localFrameIndex * pointStep;
473
+ snappedX = Math.max( 1, Math.min( snappedX, rect.width - 1 ) );
474
+ this.hoverIndicator.style.left = snappedX + 'px';
475
+
476
+ } else {
477
+
478
+ const clampedX = Math.max( 1, Math.min( x, rect.width - 1 ) );
479
+ this.hoverIndicator.style.left = clampedX + 'px';
480
+
481
+ }
482
+
483
+ }
484
+
485
+ } );
486
+
487
+ window.addEventListener( 'pointerup', () => {
488
+
489
+ isDragging = false;
490
+ this.isManualScrubbing = false;
491
+
492
+ } );
493
+
494
+ container.appendChild( graphContainer );
495
+
496
+ // Bottom Main Area (Timeline Sequence)
497
+ const mainArea = document.createElement( 'div' );
498
+ mainArea.style.flex = '1';
499
+ mainArea.style.display = 'flex';
500
+ mainArea.style.flexDirection = 'column';
501
+ mainArea.style.overflow = 'hidden';
502
+
503
+ // Timeline Track
504
+ this.timelineTrack = document.createElement( 'div' );
505
+ this.timelineTrack.style.flex = '1';
506
+ this.timelineTrack.style.overflowY = 'auto';
507
+ this.timelineTrack.style.margin = '10px';
508
+ this.timelineTrack.style.marginTop = '8px';
509
+ this.timelineTrack.style.backgroundColor = 'var(--background-color)';
510
+ mainArea.appendChild( this.timelineTrack );
511
+
512
+ container.appendChild( mainArea );
513
+ this.content.appendChild( container );
514
+
515
+ }
516
+
517
+ setRenderer( renderer ) {
518
+
519
+ this.renderer = renderer;
520
+
521
+ const timelineSettings = getItem( 'timeline' );
522
+
523
+ if ( timelineSettings.recording ) {
524
+
525
+ timelineSettings.recording = false;
526
+ setItem( 'timeline', timelineSettings );
527
+
528
+ this.toggleRecording();
529
+
530
+ }
531
+
532
+ }
533
+
534
+ toggleRecording() {
535
+
536
+ if ( ! this.renderer ) {
537
+
538
+ console.warn( 'Timeline: No renderer defined.' );
539
+ return;
540
+
541
+ }
542
+
543
+ this.isRecording = ! this.isRecording;
544
+
545
+ if ( this.isRecording ) {
546
+
547
+ this.recordButton.title = 'Stop';
548
+ this.recordButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="3" y="3" width="18" height="18" rx="2" ry="2"></rect></svg>';
549
+ this.recordButton.style.color = 'var(--color-red)';
550
+ this.startRecording();
551
+
552
+ } else {
553
+
554
+ this.recordButton.title = 'Record';
555
+ this.recordButton.innerHTML = '<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"></circle><circle cx="12" cy="12" r="4" fill="currentColor"></circle></svg>';
556
+ this.recordButton.style.color = '';
557
+ this.stopRecording();
558
+ this.renderSlider();
559
+
560
+ }
561
+
562
+ }
563
+
564
+ startRecording() {
565
+
566
+ this.frames = [];
567
+ this.currentFrame = null;
568
+ this.selectedFrameIndex = - 1;
569
+ this.fixedScreenX = 0;
570
+ this.isTrackingLatest = true;
571
+ this.isManualScrubbing = false;
572
+ this.clear();
573
+ this.frameInfo.textContent = 'Recording...';
574
+
575
+ const backend = this.renderer.backend;
576
+ const methods = Object.getOwnPropertyNames( Object.getPrototypeOf( backend ) ).filter( prop => prop !== 'constructor' );
577
+
578
+ for ( const prop of methods ) {
579
+
580
+ const descriptor = Object.getOwnPropertyDescriptor( Object.getPrototypeOf( backend ), prop );
581
+
582
+ if ( descriptor && ( descriptor.get || descriptor.set ) ) continue;
583
+
584
+ const originalFunc = backend[ prop ];
585
+
586
+ if ( typeof originalFunc === 'function' && typeof prop === 'string' ) {
587
+
588
+ this.originalMethods.set( prop, originalFunc );
589
+
590
+ backend[ prop ] = ( ...args ) => {
591
+
592
+ if ( prop.toLowerCase().includes( 'timestamp' ) || prop.startsWith( 'get' ) || prop.startsWith( 'set' ) || prop.startsWith( 'has' ) || prop.startsWith( '_' ) || prop.startsWith( 'needs' ) ) {
593
+
594
+ return originalFunc.apply( backend, args );
595
+
596
+ }
597
+
598
+ // Check for frame change
599
+ const frameNumber = this.renderer.info.frame;
600
+
601
+ if ( ! this.currentFrame || this.currentFrame.id !== frameNumber ) {
602
+
603
+ if ( this.currentFrame ) {
604
+
605
+ this.currentFrame.fps = this.renderer.inspector ? this.renderer.inspector.fps : 0;
606
+
607
+ if ( ! isFinite( this.currentFrame.fps ) ) {
608
+
609
+ this.currentFrame.fps = 0;
610
+
611
+ }
612
+
613
+ const t = this.currentFrame.triangles || 0;
614
+
615
+ if ( t > this.baseTriangles ) {
616
+
617
+ const oldBase = this.baseTriangles;
618
+ this.baseTriangles = t;
619
+
620
+ if ( oldBase > 0 ) {
621
+
622
+ const ratio = oldBase / this.baseTriangles;
623
+ const points = this.graph.lines[ 'triangles' ].points;
624
+
625
+ for ( let i = 0; i < points.length; i ++ ) {
626
+
627
+ points[ i ] *= ratio;
628
+
629
+ }
630
+
631
+ }
632
+
633
+ }
634
+
635
+ const normalizedTriangles = this.baseTriangles > 0 ? ( t / this.baseTriangles ) * TRIANGLES_GRAPH_LIMIT : 0;
636
+
637
+ this.graph.addPoint( 'calls', this.currentFrame.calls.length );
638
+ this.graph.addPoint( 'fps', this.currentFrame.fps );
639
+ this.graph.addPoint( 'triangles', normalizedTriangles );
640
+ this.graph.update();
641
+
642
+ }
643
+
644
+ this.currentFrame = { id: frameNumber, calls: [], fps: 0, triangles: 0 };
645
+ this.frames.push( this.currentFrame );
646
+
647
+ if ( this.frames.length > LIMIT ) {
648
+
649
+ this.frames.shift();
650
+
651
+ }
652
+
653
+
654
+
655
+ }
656
+
657
+ const call = { method: prop, target: args[ 0 ] };
658
+ const details = this.getCallDetail( prop, args );
659
+
660
+ if ( details ) {
661
+
662
+ call.details = details;
663
+
664
+ if ( details.triangles !== undefined ) {
665
+
666
+ this.currentFrame.triangles += details.triangles;
667
+
668
+ }
669
+
670
+ }
671
+
672
+ this.currentFrame.calls.push( call );
673
+
674
+ return originalFunc.apply( backend, args );
675
+
676
+ };
677
+
678
+ }
679
+
680
+ }
681
+
682
+ }
683
+
684
+ stopRecording() {
685
+
686
+ if ( this.originalMethods.size > 0 ) {
687
+
688
+ const backend = this.renderer.backend;
689
+
690
+ for ( const [ prop, originalFunc ] of this.originalMethods.entries() ) {
691
+
692
+ backend[ prop ] = originalFunc;
693
+
694
+ }
695
+
696
+ this.originalMethods.clear();
697
+
698
+ if ( this.currentFrame ) {
699
+
700
+ this.currentFrame.fps = this.renderer.inspector ? this.renderer.inspector.fps : 0;
701
+
702
+ }
703
+
704
+ }
705
+
706
+ }
707
+
708
+ clear() {
709
+
710
+ this.frames = [];
711
+ this.timelineTrack.innerHTML = '';
712
+ this.playhead.style.display = 'none';
713
+ this.frameInfo.textContent = '';
714
+ this.baseTriangles = 0;
715
+ this.graph.lines[ 'calls' ].points = [];
716
+ this.graph.lines[ 'fps' ].points = [];
717
+ this.graph.lines[ 'triangles' ].points = [];
718
+ this.graph.resetLimit();
719
+ this.graph.update();
720
+
721
+ }
722
+
723
+ exportData() {
724
+
725
+ if ( this.frames.length === 0 ) return;
726
+
727
+ const data = JSON.stringify( this.frames, null, '\t' );
728
+ const blob = new Blob( [ data ], { type: 'application/json' } );
729
+ const url = URL.createObjectURL( blob );
730
+ const a = document.createElement( 'a' );
731
+ a.href = url;
732
+ a.download = 'threejs-timeline.json';
733
+ a.click();
734
+ URL.revokeObjectURL( url );
735
+
736
+ }
737
+
738
+ getRenderTargetDetails( renderTarget ) {
739
+
740
+ const textures = renderTarget.textures;
741
+ const attachments = [];
742
+
743
+ const getBPC = ( texture ) => {
744
+
745
+ switch ( texture.type ) {
746
+
747
+ case ByteType:
748
+ case UnsignedByteType:
749
+ return '8';
750
+ case ShortType:
751
+ case UnsignedShortType:
752
+ case HalfFloatType:
753
+ case UnsignedShort4444Type:
754
+ case UnsignedShort5551Type:
755
+ return '16';
756
+ case IntType:
757
+ case UnsignedIntType:
758
+ case FloatType:
759
+ case UnsignedInt248Type:
760
+ case UnsignedInt5999Type:
761
+ case UnsignedInt101111Type:
762
+ return '32';
763
+ default:
764
+ return '?';
765
+
766
+ }
767
+
768
+ };
769
+
770
+ const getFormat = ( texture ) => {
771
+
772
+ switch ( texture.format ) {
773
+
774
+ case AlphaFormat:
775
+ return 'a';
776
+ case RedFormat:
777
+ case RedIntegerFormat:
778
+ return 'r';
779
+ case RGFormat:
780
+ case RGIntegerFormat:
781
+ return 'rg';
782
+ case RGBFormat:
783
+ case RGBIntegerFormat:
784
+ return 'rgb';
785
+ case DepthFormat:
786
+ return 'depth';
787
+ case DepthStencilFormat:
788
+ return 'depth-stencil';
789
+ case RGBAFormat:
790
+ case RGBAIntegerFormat:
791
+ default:
792
+ return 'rgba';
793
+
794
+ }
795
+
796
+ };
797
+
798
+ for ( let i = 0; i < textures.length; i ++ ) {
799
+
800
+ const texture = textures[ i ];
801
+
802
+ const bpc = getBPC( texture );
803
+ const format = getFormat( texture );
804
+
805
+ let description = `[${ i }]`;
806
+
807
+ if ( texture.name && ! ( texture.isDepthTexture && texture.name === 'depth' ) ) {
808
+
809
+ description += ` ${ texture.name }`;
810
+
811
+ }
812
+
813
+ description += ` ${ format } ${ bpc } bpc`;
814
+
815
+ attachments.push( description );
816
+
817
+ }
818
+
819
+ const details = {
820
+ target: renderTarget.name || 'RenderTarget',
821
+ [ `attachments(${ textures.length })` ]: '\n' + attachments.join( '\n' )
822
+ };
823
+
824
+ if ( renderTarget.depthTexture ) {
825
+
826
+ details.depth = `${ getBPC( renderTarget.depthTexture ) } bpc`;
827
+
828
+ }
829
+
830
+ return details;
831
+
832
+ }
833
+
834
+ getCallDetail( method, args ) {
835
+
836
+ switch ( method ) {
837
+
838
+ case 'draw': {
839
+
840
+ const renderObject = args[ 0 ];
841
+
842
+ const details = {
843
+ object: renderObject.object.name || renderObject.object.type,
844
+ material: renderObject.material.name || renderObject.material.type,
845
+ geometry: renderObject.geometry.name || renderObject.geometry.type
846
+ };
847
+
848
+ if ( renderObject.getDrawParameters ) {
849
+
850
+ const drawParams = renderObject.getDrawParameters();
851
+
852
+ if ( drawParams ) {
853
+
854
+ if ( renderObject.object.isMesh || renderObject.object.isSprite ) {
855
+
856
+ details.triangles = drawParams.vertexCount / 3;
857
+
858
+ if ( renderObject.object.count > 1 ) {
859
+
860
+ details.instance = renderObject.object.count;
861
+
862
+ details[ 'triangles per instance' ] = details.triangles;
863
+ details.triangles *= details.instance;
864
+
865
+ }
866
+
867
+ }
868
+
869
+ }
870
+
871
+ }
872
+
873
+ return details;
874
+
875
+ }
876
+
877
+ case 'beginRender': {
878
+
879
+ const renderContext = args[ 0 ];
880
+
881
+ const details = {
882
+ scene: this.renderer.inspector.currentRender.name || 'unknown',
883
+ camera: renderContext.camera.name || renderContext.camera.type
884
+ };
885
+
886
+ if ( renderContext.renderTarget && ! renderContext.renderTarget.isPostProcessingRenderTarget ) {
887
+
888
+ Object.assign( details, this.getRenderTargetDetails( renderContext.renderTarget ) );
889
+
890
+ } else {
891
+
892
+ details.target = 'CanvasTarget';
893
+
894
+ }
895
+
896
+ return details;
897
+
898
+ }
899
+
900
+ case 'beginCompute': {
901
+
902
+ const details = {
903
+ compute: this.renderer.inspector.currentCompute.name || 'unknown'
904
+ };
905
+
906
+ return details;
907
+
908
+ }
909
+
910
+ case 'compute': {
911
+
912
+ const computeNode = args[ 1 ];
913
+ const bindings = args[ 2 ];
914
+ const dispatchSize = args[ 4 ] || computeNode.dispatchSize || computeNode.count;
915
+
916
+ const node = computeNode.name || computeNode.type || 'unknown';
917
+
918
+ // bindings
919
+
920
+ let bindingsCount = 0;
921
+
922
+ if ( bindings ) {
923
+
924
+ bindingsCount = bindings.length;
925
+
926
+ }
927
+
928
+ // dispatch
929
+
930
+ let dispatch;
931
+
932
+ if ( dispatchSize.isIndirectStorageBufferAttribute ) {
933
+
934
+ dispatch = 'indirect';
935
+
936
+ } else if ( Array.isArray( dispatchSize ) ) {
937
+
938
+ dispatch = dispatchSize.join( ', ' );
939
+
940
+ } else {
941
+
942
+ dispatch = dispatchSize;
943
+
944
+ }
945
+
946
+ // details
947
+
948
+ return {
949
+ node,
950
+ bindings: bindingsCount,
951
+ dispatch
952
+ };
953
+
954
+ }
955
+
956
+ case 'updateBinding': {
957
+
958
+ const binding = args[ 0 ];
959
+
960
+ return { group: binding.name || 'unknown' };
961
+
962
+ }
963
+
964
+ case 'clear': {
965
+
966
+ const renderContext = args[ 3 ];
967
+
968
+ const details = {
969
+ color: args[ 0 ],
970
+ depth: args[ 1 ],
971
+ stencil: args[ 2 ]
972
+ };
973
+
974
+ if ( renderContext.renderTarget && ! renderContext.renderTarget.isPostProcessingRenderTarget ) {
975
+
976
+ const renderTargetDetails = this.getRenderTargetDetails( renderContext.renderTarget );
977
+
978
+ if ( renderTargetDetails.depth ) {
979
+
980
+ renderTargetDetails[ 'depth texture' ] = renderTargetDetails.depth;
981
+
982
+ delete renderTargetDetails.depth;
983
+
984
+ }
985
+
986
+ Object.assign( details, renderTargetDetails );
987
+
988
+ } else {
989
+
990
+ details.target = 'CanvasTarget';
991
+
992
+ }
993
+
994
+ return details;
995
+
996
+ }
997
+
998
+ case 'updateViewport': {
999
+
1000
+ const renderContext = args[ 0 ];
1001
+ const { x, y, width, height } = renderContext.viewportValue;
1002
+
1003
+ return { x, y, width, height };
1004
+
1005
+ }
1006
+
1007
+ case 'updateScissor': {
1008
+
1009
+ const renderContext = args[ 0 ];
1010
+ const { x, y, width, height } = renderContext.scissorValue;
1011
+
1012
+ return { x, y, width, height };
1013
+
1014
+ }
1015
+
1016
+ case 'createProgram':
1017
+ case 'destroyProgram': {
1018
+
1019
+ const program = args[ 0 ];
1020
+ return { stage: program.stage, name: program.name || 'unknown' };
1021
+
1022
+ }
1023
+
1024
+ case 'createRenderPipeline': {
1025
+
1026
+ const renderObject = args[ 0 ];
1027
+ const details = {
1028
+ object: renderObject.object ? ( renderObject.object.name || renderObject.object.type || 'unknown' ) : 'unknown',
1029
+ material: renderObject.material ? ( renderObject.material.name || renderObject.material.type || 'unknown' ) : 'unknown'
1030
+ };
1031
+
1032
+ return details;
1033
+
1034
+ }
1035
+
1036
+ case 'createComputePipeline':
1037
+ case 'destroyComputePipeline': {
1038
+
1039
+ const pipeline = args[ 0 ];
1040
+ return { name: pipeline.name || 'unknown' };
1041
+
1042
+ }
1043
+
1044
+ case 'createBindings':
1045
+ case 'updateBindings': {
1046
+
1047
+ const bindGroup = args[ 0 ];
1048
+
1049
+ const details = {
1050
+ group: bindGroup.name || 'unknown',
1051
+ count: bindGroup.bindings.length
1052
+ };
1053
+
1054
+ return details;
1055
+
1056
+ }
1057
+
1058
+ case 'createUniformBuffer':
1059
+ case 'destroyUniformBuffer': {
1060
+
1061
+ const binding = args[ 0 ];
1062
+
1063
+ const details = {
1064
+ group: binding.groupNode.name || 'unknown',
1065
+ size: binding.byteLength + ' bytes'
1066
+ };
1067
+
1068
+ if ( binding.name !== details.group ) {
1069
+
1070
+ details.name = binding.name;
1071
+
1072
+ }
1073
+
1074
+ return details;
1075
+
1076
+ }
1077
+
1078
+ case 'createNodeBuilder': {
1079
+
1080
+ const object = args[ 0 ];
1081
+ const details = { object: object.name || object.type || 'unknown' };
1082
+
1083
+ if ( object.material ) {
1084
+
1085
+ details.material = object.material.name || object.material.type || 'unknown';
1086
+
1087
+ }
1088
+
1089
+ return details;
1090
+
1091
+ }
1092
+
1093
+ case 'createAttribute':
1094
+ case 'createIndexAttribute':
1095
+ case 'createStorageAttribute':
1096
+ case 'destroyAttribute':
1097
+ case 'destroyIndexAttribute':
1098
+ case 'destroyStorageAttribute': {
1099
+
1100
+ const attribute = args[ 0 ];
1101
+ const details = {};
1102
+
1103
+ if ( attribute.name ) details.name = attribute.name;
1104
+ if ( attribute.count !== undefined ) details.count = attribute.count;
1105
+ if ( attribute.itemSize !== undefined ) details.itemSize = attribute.itemSize;
1106
+
1107
+ return details;
1108
+
1109
+ }
1110
+
1111
+ case 'copyFramebufferToTexture': {
1112
+
1113
+ const target = args[ 0 ];
1114
+ const rectangle = args[ 2 ];
1115
+
1116
+ const details = {
1117
+ target: this.getTextureName( target ),
1118
+ width: rectangle.z,
1119
+ height: rectangle.w
1120
+ };
1121
+
1122
+ return details;
1123
+
1124
+ }
1125
+
1126
+ case 'copyTextureToTexture': {
1127
+
1128
+ const srcTexture = args[ 0 ];
1129
+ const dstTexture = args[ 1 ];
1130
+
1131
+ const details = {
1132
+ source: this.getTextureName( srcTexture ),
1133
+ destination: this.getTextureName( dstTexture )
1134
+ };
1135
+
1136
+ return details;
1137
+
1138
+ }
1139
+
1140
+ case 'updateSampler': {
1141
+
1142
+ const texture = args[ 0 ];
1143
+
1144
+ const details = {
1145
+ magFilter: this.getTextureFilterName( texture.magFilter ),
1146
+ minFilter: this.getTextureFilterName( texture.minFilter ),
1147
+ wrapS: this.getTextureWrapName( texture.wrapS ),
1148
+ wrapT: this.getTextureWrapName( texture.wrapT ),
1149
+ anisotropy: texture.anisotropy
1150
+ };
1151
+
1152
+ return details;
1153
+
1154
+ }
1155
+
1156
+ case 'updateTexture':
1157
+ case 'generateMipmaps':
1158
+ case 'createTexture':
1159
+ case 'destroyTexture': {
1160
+
1161
+ const texture = args[ 0 ];
1162
+ const name = this.getTextureName( texture );
1163
+ const details = { texture: name };
1164
+
1165
+ if ( texture.image ) {
1166
+
1167
+ if ( texture.image.width !== undefined ) details.width = texture.image.width;
1168
+ if ( texture.image.height !== undefined ) details.height = texture.image.height;
1169
+
1170
+ }
1171
+
1172
+ return details;
1173
+
1174
+ }
1175
+
1176
+ }
1177
+
1178
+ return null;
1179
+
1180
+ }
1181
+
1182
+ getTextureName( texture ) {
1183
+
1184
+ if ( texture.name ) return texture.name;
1185
+
1186
+ const types = [
1187
+ 'isFramebufferTexture', 'isDepthTexture', 'isDataArrayTexture',
1188
+ 'isData3DTexture', 'isDataTexture', 'isCompressedArrayTexture',
1189
+ 'isCompressedTexture', 'isCubeTexture', 'isVideoTexture',
1190
+ 'isCanvasTexture', 'isTexture'
1191
+ ];
1192
+
1193
+ for ( const type of types ) {
1194
+
1195
+ if ( texture[ type ] ) return type.replace( 'is', '' );
1196
+
1197
+ }
1198
+
1199
+ return 'Texture';
1200
+
1201
+ }
1202
+
1203
+ getTextureFilterName( filter ) {
1204
+
1205
+ const filters = {
1206
+ 1003: 'Nearest',
1207
+ 1004: 'NearestMipmapNearest',
1208
+ 1005: 'NearestMipmapLinear',
1209
+ 1006: 'Linear',
1210
+ 1007: 'LinearMipmapNearest',
1211
+ 1008: 'LinearMipmapLinear'
1212
+ };
1213
+
1214
+ return filters[ filter ] || filter;
1215
+
1216
+ }
1217
+
1218
+ getTextureWrapName( wrap ) {
1219
+
1220
+ const wrappings = {
1221
+ 1000: 'Repeat',
1222
+ 1001: 'ClampToEdge',
1223
+ 1002: 'MirroredRepeat'
1224
+ };
1225
+
1226
+ return wrappings[ wrap ] || wrap;
1227
+
1228
+ }
1229
+
1230
+ formatDetails( details ) {
1231
+
1232
+ const parts = [];
1233
+
1234
+ for ( const key in details ) {
1235
+
1236
+ if ( details[ key ] !== undefined ) {
1237
+
1238
+ parts.push( `<span style="opacity: 0.5">${key}:</span> <span style="color: var(--text-secondary); opacity: 1">${details[ key ]}</span>` );
1239
+
1240
+ }
1241
+
1242
+ }
1243
+
1244
+ if ( parts.length === 0 ) return '';
1245
+
1246
+ return `<span style="font-size: 11px; margin-left: 8px; color: var(--text-secondary); opacity: 1;">{ ${parts.join( '<span style="opacity: 0.5">, </span>' )} }</span>`;
1247
+
1248
+ }
1249
+
1250
+ renderSlider() {
1251
+
1252
+ if ( this.frames.length === 0 ) {
1253
+
1254
+ this.playhead.style.display = 'none';
1255
+ this.frameInfo.textContent = '';
1256
+ return;
1257
+
1258
+ }
1259
+
1260
+ // Reset graph safely to fit recorded frames exactly up to maxPoints
1261
+ this.graph.lines[ 'calls' ].points = [];
1262
+ this.graph.lines[ 'fps' ].points = [];
1263
+ this.graph.lines[ 'triangles' ].points = [];
1264
+ this.graph.resetLimit();
1265
+
1266
+ // If recorded frames exceed SVG Graph maxPoints, we sample/slice it
1267
+ // (Graph.js inherently handles shifting for real-time,
1268
+ // but statically we want to visualize as much up to max bounds)
1269
+ let framesToRender = this.frames;
1270
+ if ( framesToRender.length > this.graph.maxPoints ) {
1271
+
1272
+ framesToRender = framesToRender.slice( - this.graph.maxPoints );
1273
+ this.frames = framesToRender; // Adjust our internal array to match what's visible
1274
+
1275
+ }
1276
+
1277
+ let maxTriangles = 0;
1278
+
1279
+ for ( let i = 0; i < framesToRender.length; i ++ ) {
1280
+
1281
+ const t = framesToRender[ i ].triangles || 0;
1282
+ if ( t > maxTriangles ) {
1283
+
1284
+ maxTriangles = t;
1285
+
1286
+ }
1287
+
1288
+ }
1289
+
1290
+ for ( let i = 0; i < framesToRender.length; i ++ ) {
1291
+
1292
+ const t = framesToRender[ i ].triangles || 0;
1293
+ const normalizedTriangles = maxTriangles > 0 ? ( t / maxTriangles ) * TRIANGLES_GRAPH_LIMIT : 0;
1294
+
1295
+ // Adding calls length to the Graph SVG to visualize workload geometry
1296
+ this.graph.addPoint( 'calls', framesToRender[ i ].calls.length );
1297
+ this.graph.addPoint( 'fps', framesToRender[ i ].fps || 0 );
1298
+ this.graph.addPoint( 'triangles', normalizedTriangles );
1299
+
1300
+ }
1301
+
1302
+ this.graph.update();
1303
+
1304
+ this.playhead.style.display = 'block';
1305
+
1306
+ // Select the previously selected frame, or the last one if tracking, or 0
1307
+ let targetFrame = 0;
1308
+ if ( this.selectedFrameIndex !== - 1 && this.selectedFrameIndex < this.frames.length ) {
1309
+
1310
+ targetFrame = this.selectedFrameIndex;
1311
+
1312
+ } else if ( this.frames.length > 0 ) {
1313
+
1314
+ targetFrame = this.frames.length - 1;
1315
+
1316
+ }
1317
+
1318
+ this.selectFrame( targetFrame );
1319
+
1320
+ }
1321
+
1322
+ selectFrame( index ) {
1323
+
1324
+ if ( this.isRecording ) return;
1325
+
1326
+ if ( index < 0 || index >= this.frames.length ) return;
1327
+
1328
+ this.selectedFrameIndex = index;
1329
+
1330
+ const frame = this.frames[ index ];
1331
+ this.renderTimelineTrack( frame );
1332
+
1333
+ // Update UI texts
1334
+ const isCompact = this.profiler.panel.offsetWidth < 800;
1335
+ const frameLabel = isCompact ? '' : 'Frame: ';
1336
+ const fpsSuffix = isCompact ? '' : ' FPS';
1337
+ const callsSuffix = isCompact ? '' : ' calls';
1338
+ const trianglesSuffix = isCompact ? '' : ' triangles';
1339
+
1340
+ const group = ( c, text ) => `<span style="display:inline-flex;align-items:center;margin-left:12px;flex-shrink:0;"><span style="width:6px;height:6px;border-radius:50%;background-color:${c};margin-right:6px;flex-shrink:0;"></span>${text}</span>`;
1341
+ const maxTriangles = Math.max( this.baseTriangles, frame.triangles || 0 );
1342
+ const trianglesText = isCompact ? ( frame.triangles || 0 ) : ( frame.triangles || 0 ) + ' / ' + maxTriangles + trianglesSuffix;
1343
+ this.frameInfo.innerHTML = frameLabel + frame.id + group( 'var(--color-fps)', ( frame.fps || 0 ).toFixed( 1 ) + fpsSuffix ) + group( 'var(--color-call)', frame.calls.length + callsSuffix ) + group( 'var(--color-red)', trianglesText );
1344
+
1345
+ // Update playhead position
1346
+ const rect = this.graphSlider.getBoundingClientRect();
1347
+ const pointCount = this.graph.lines[ 'calls' ].points.length;
1348
+
1349
+ if ( pointCount > 0 ) {
1350
+
1351
+ // Calculate point width step
1352
+ const pointStep = rect.width / ( this.graph.maxPoints - 1 );
1353
+
1354
+ let localIndex = index;
1355
+
1356
+ if ( this.frames.length > pointCount ) {
1357
+
1358
+ localIndex = index - ( this.frames.length - pointCount );
1359
+
1360
+ }
1361
+
1362
+ // x offset calculation from SVG update logic
1363
+ // The graph translates (slides) back if points length < maxPoints
1364
+ // which means point 0 is at offset
1365
+ const offset = rect.width - ( ( pointCount - 1 ) * pointStep );
1366
+ let xPos = offset + ( localIndex * pointStep );
1367
+ xPos = Math.max( 1, Math.min( xPos, rect.width - 1 ) );
1368
+
1369
+ this.playhead.style.left = xPos + 'px';
1370
+ this.playhead.style.display = 'block';
1371
+
1372
+ }
1373
+
1374
+ }
1375
+
1376
+ getCallBlock( call, fallbackIndex, instanceIndex = 0 ) {
1377
+
1378
+ const target = call.target;
1379
+ let block;
1380
+
1381
+ if ( target && typeof target === 'object' ) {
1382
+
1383
+ let blocks = this.callBlocks.get( target );
1384
+
1385
+ if ( ! blocks ) {
1386
+
1387
+ blocks = [];
1388
+ this.callBlocks.set( target, blocks );
1389
+
1390
+ }
1391
+
1392
+ block = blocks[ instanceIndex ];
1393
+
1394
+ } else {
1395
+
1396
+ block = this.fallbackBlocks[ fallbackIndex ];
1397
+
1398
+ }
1399
+
1400
+ if ( ! block ) {
1401
+
1402
+ block = document.createElement( 'div' );
1403
+ block.style.display = 'flex';
1404
+ block.style.alignItems = 'center';
1405
+ block.style.padding = '4px 8px';
1406
+ block.style.margin = '2px 0';
1407
+ block.style.backgroundColor = 'rgba(255, 255, 255, 0.03)';
1408
+ block.style.fontFamily = 'monospace';
1409
+ block.style.fontSize = '12px';
1410
+ block.style.color = 'var(--text-primary)';
1411
+ block.style.overflow = 'hidden';
1412
+
1413
+ block.arrow = document.createElement( 'span' );
1414
+ block.arrow.style.fontSize = '10px';
1415
+ block.arrow.style.marginRight = '8px';
1416
+ block.arrow.style.cursor = 'pointer';
1417
+ block.arrow.style.width = '35px';
1418
+ block.arrow.style.textAlign = 'center';
1419
+ block.arrow.style.flexShrink = '0';
1420
+ block.arrow.style.whiteSpace = 'nowrap';
1421
+ block.appendChild( block.arrow );
1422
+
1423
+ block.titleSpan = document.createElement( 'span' );
1424
+ block.titleSpan.style.flex = '1';
1425
+ block.titleSpan.style.minWidth = '0';
1426
+ block.titleSpan.style.overflow = 'hidden';
1427
+ block.titleSpan.style.textOverflow = 'ellipsis';
1428
+ block.titleSpan.style.whiteSpace = 'nowrap';
1429
+ block.appendChild( block.titleSpan );
1430
+
1431
+ block.addEventListener( 'click', ( e ) => {
1432
+
1433
+ if ( ! block._groupId ) return;
1434
+
1435
+ e.stopPropagation();
1436
+
1437
+ if ( this.collapsedGroups.has( block._groupId ) ) {
1438
+
1439
+ this.collapsedGroups.delete( block._groupId );
1440
+
1441
+ } else {
1442
+
1443
+ this.collapsedGroups.add( block._groupId );
1444
+
1445
+ }
1446
+
1447
+ this.renderTimelineTrack( this.frames[ this.selectedFrameIndex ] );
1448
+
1449
+ } );
1450
+
1451
+ if ( target && typeof target === 'object' ) {
1452
+
1453
+ this.callBlocks.get( target )[ instanceIndex ] = block;
1454
+
1455
+ } else {
1456
+
1457
+ this.fallbackBlocks[ fallbackIndex ] = block;
1458
+
1459
+ }
1460
+
1461
+ }
1462
+
1463
+ block.style.cursor = 'default';
1464
+ block._groupId = null;
1465
+ block.arrow.style.display = 'none';
1466
+
1467
+ return block;
1468
+
1469
+ }
1470
+
1471
+ renderTimelineTrack( frame ) {
1472
+
1473
+ if ( this.isRecording ) return;
1474
+
1475
+ if ( ! frame || frame.calls.length === 0 ) {
1476
+
1477
+ this.timelineTrack.innerHTML = '';
1478
+ return;
1479
+
1480
+ }
1481
+
1482
+ // Track collapsed states
1483
+ if ( ! this.collapsedGroups ) {
1484
+
1485
+ this.collapsedGroups = new Set();
1486
+
1487
+ }
1488
+
1489
+ let blockIndex = 0;
1490
+ const trackChildren = this.timelineTrack.children;
1491
+ let childIndex = 0;
1492
+ const instanceCounts = new WeakMap();
1493
+
1494
+ if ( this.isHierarchicalView ) {
1495
+
1496
+ const groupedCalls = [];
1497
+ let currentGroup = null;
1498
+
1499
+ for ( let i = 0; i < frame.calls.length; i ++ ) {
1500
+
1501
+ const call = frame.calls[ i ];
1502
+ const isStructural = call.method.startsWith( 'begin' ) || call.method.startsWith( 'finish' );
1503
+ const formatedDetails = call.details ? this.formatDetails( call.details ) : '';
1504
+
1505
+ if ( currentGroup && currentGroup.method === call.method && currentGroup.formatedDetails === formatedDetails && ! isStructural ) {
1506
+
1507
+ currentGroup.count ++;
1508
+
1509
+ } else {
1510
+
1511
+ currentGroup = { method: call.method, count: 1, formatedDetails, target: call.target, details: call.details };
1512
+ groupedCalls.push( currentGroup );
1513
+
1514
+ }
1515
+
1516
+ }
1517
+
1518
+ let currentIndent = 0;
1519
+ const indentSize = 24;
1520
+
1521
+ // Stack to keep track of parent elements and their collapsed state
1522
+ const elementStack = [ { element: this.timelineTrack, isCollapsed: false, id: '', beginCount: 0 } ];
1523
+
1524
+ for ( let i = 0; i < groupedCalls.length; i ++ ) {
1525
+
1526
+ const call = groupedCalls[ i ];
1527
+
1528
+ let instanceIndex = 0;
1529
+
1530
+ if ( call.target && typeof call.target === 'object' ) {
1531
+
1532
+ instanceIndex = instanceCounts.get( call.target ) || 0;
1533
+ instanceCounts.set( call.target, instanceIndex + 1 );
1534
+
1535
+ }
1536
+
1537
+ const block = this.getCallBlock( call, blockIndex ++, instanceIndex );
1538
+ block.style.marginLeft = ( currentIndent * indentSize ) + 'px';
1539
+ block.style.borderLeft = '4px solid ' + this.getColorForMethod( call.method );
1540
+
1541
+ // Clean up any old info-icon directly under block
1542
+ const directInfoIcon = block.querySelector( ':scope > .info-icon' );
1543
+ if ( directInfoIcon ) {
1544
+
1545
+ directInfoIcon.remove();
1546
+
1547
+ }
1548
+
1549
+ // Build titleSpan content
1550
+ block.titleSpan.textContent = '';
1551
+
1552
+ const methodSpan = document.createElement( 'span' );
1553
+ methodSpan.textContent = call.method;
1554
+ block.titleSpan.appendChild( methodSpan );
1555
+
1556
+ if ( call.details ) {
1557
+
1558
+ let tooltipText = `### ${call.method}\n`;
1559
+ for ( const key in call.details ) {
1560
+
1561
+ if ( call.details[ key ] !== undefined ) {
1562
+
1563
+ tooltipText += `**${key}**: ${call.details[ key ]}\n`;
1564
+
1565
+ }
1566
+
1567
+ }
1568
+
1569
+ const infoIcon = info( block.titleSpan, tooltipText );
1570
+ infoIcon.style.flexShrink = '0';
1571
+ infoIcon.style.marginLeft = '6px';
1572
+ infoIcon.style.display = 'inline-flex';
1573
+ infoIcon.style.verticalAlign = 'middle';
1574
+
1575
+ }
1576
+
1577
+ const detailsAndCountSpan = document.createElement( 'span' );
1578
+ let detailsAndCountHTML = ( call.formatedDetails ? call.formatedDetails : '' );
1579
+ if ( call.count > 1 ) {
1580
+
1581
+ detailsAndCountHTML += ` <span style="opacity: 0.5">( ${call.count} )</span>`;
1582
+
1583
+ }
1584
+
1585
+ if ( detailsAndCountHTML ) {
1586
+
1587
+ detailsAndCountSpan.innerHTML = detailsAndCountHTML;
1588
+ block.titleSpan.appendChild( detailsAndCountSpan );
1589
+
1590
+ }
1591
+
1592
+ const currentParent = elementStack[ elementStack.length - 1 ];
1593
+
1594
+ // Only add to DOM if parent is not collapsed
1595
+ if ( ! currentParent.isCollapsed ) {
1596
+
1597
+ if ( trackChildren[ childIndex ] !== block ) {
1598
+
1599
+ this.timelineTrack.insertBefore( block, trackChildren[ childIndex ] );
1600
+
1601
+ }
1602
+
1603
+ childIndex ++;
1604
+
1605
+ }
1606
+
1607
+ if ( call.method.startsWith( 'begin' ) ) {
1608
+
1609
+ const beginIndex = currentParent.beginCount ++;
1610
+ const groupId = currentParent.id + '/' + call.method + '-' + beginIndex;
1611
+ const isCollapsed = this.collapsedGroups.has( groupId );
1612
+
1613
+ block._groupId = groupId;
1614
+ block.style.cursor = 'pointer';
1615
+
1616
+ block.arrow.style.display = 'inline-block';
1617
+ block.arrow.textContent = isCollapsed ? '[ + ]' : '[ - ]';
1618
+
1619
+ currentIndent ++;
1620
+ elementStack.push( { element: block, isCollapsed: currentParent.isCollapsed || isCollapsed, id: groupId, beginCount: 0 } );
1621
+
1622
+ } else if ( call.method.startsWith( 'finish' ) ) {
1623
+
1624
+ currentIndent = Math.max( 0, currentIndent - 1 );
1625
+ elementStack.pop();
1626
+
1627
+ }
1628
+
1629
+ }
1630
+
1631
+ } else {
1632
+
1633
+ const callCounts = {};
1634
+
1635
+ for ( let i = 0; i < frame.calls.length; i ++ ) {
1636
+
1637
+ const method = frame.calls[ i ].method;
1638
+
1639
+ if ( method.startsWith( 'finish' ) ) continue;
1640
+
1641
+ callCounts[ method ] = ( callCounts[ method ] || 0 ) + 1;
1642
+
1643
+ }
1644
+
1645
+ const sortedCalls = Object.keys( callCounts ).map( method => ( { method, count: callCounts[ method ] } ) );
1646
+ sortedCalls.sort( ( a, b ) => b.count - a.count );
1647
+
1648
+ for ( let i = 0; i < sortedCalls.length; i ++ ) {
1649
+
1650
+ const call = sortedCalls[ i ];
1651
+
1652
+ const block = this.getCallBlock( call, blockIndex ++ );
1653
+ block.style.marginLeft = '0px';
1654
+ block.style.borderLeft = '4px solid ' + this.getColorForMethod( call.method );
1655
+
1656
+ const infoIcon = block.querySelector( '.info-icon' );
1657
+ if ( infoIcon ) {
1658
+
1659
+ infoIcon.remove();
1660
+
1661
+ }
1662
+
1663
+ block.titleSpan.innerHTML = call.method + ( call.count > 1 ? ` <span style="opacity: 0.5">( ${call.count} )</span>` : '' );
1664
+
1665
+ if ( trackChildren[ childIndex ] !== block ) {
1666
+
1667
+ this.timelineTrack.insertBefore( block, trackChildren[ childIndex ] );
1668
+
1669
+ }
1670
+
1671
+ childIndex ++;
1672
+
1673
+ }
1674
+
1675
+ }
1676
+
1677
+ while ( this.timelineTrack.children.length > childIndex ) {
1678
+
1679
+ this.timelineTrack.removeChild( this.timelineTrack.lastChild );
1680
+
1681
+ }
1682
+
1683
+ }
1684
+
1685
+ getColorForMethod( method ) {
1686
+
1687
+ if ( method.startsWith( 'begin' ) ) return 'var(--color-green)';
1688
+ if ( method.startsWith( 'finish' ) || method.startsWith( 'destroy' ) ) return 'var(--color-red)';
1689
+ if ( method.startsWith( 'draw' ) || method.startsWith( 'compute' ) || method.startsWith( 'create' ) || method.startsWith( 'generate' ) ) return 'var(--color-yellow)';
1690
+ return 'var(--text-secondary)';
1691
+
1692
+ }
1693
+
1694
+ }
1695
+
1696
+ export { Timeline };