@woosh/meep-engine 3.51.0 → 3.53.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 (433) hide show
  1. package/package.json +1 -1
  2. package/src/engine/ecs/animation/Animation.d.ts +4 -25
  3. package/src/engine/ecs/animation/Animation.d.ts.map +1 -1
  4. package/src/engine/ecs/animation/Animation.js +9 -41
  5. package/src/engine/ecs/ik/IKGoalSystem.d.ts +4 -5
  6. package/src/engine/ecs/ik/IKGoalSystem.d.ts.map +1 -1
  7. package/src/engine/ecs/ik/IKGoalSystem.js +4 -6
  8. package/src/engine/graphics/ecs/mesh/assetTypeByPath.js +1 -1
  9. package/src/engine/graphics3/AnimationGraphSystem.d.ts +9 -22
  10. package/src/engine/graphics3/AnimationGraphSystem.d.ts.map +1 -1
  11. package/src/engine/graphics3/AnimationGraphSystem.js +58 -203
  12. package/src/engine/graphics3/AnimationSystem.d.ts +7 -18
  13. package/src/engine/graphics3/AnimationSystem.d.ts.map +1 -1
  14. package/src/engine/graphics3/AnimationSystem.js +62 -243
  15. package/src/engine/graphics3/FoliageWindSystem.d.ts +67 -0
  16. package/src/engine/graphics3/FoliageWindSystem.d.ts.map +1 -0
  17. package/src/engine/graphics3/FoliageWindSystem.js +257 -0
  18. package/src/engine/graphics3/GPUFluidSystem.d.ts +7 -0
  19. package/src/engine/graphics3/GPUFluidSystem.d.ts.map +1 -1
  20. package/src/engine/graphics3/GPUFluidSystem.js +39 -1
  21. package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts +0 -1
  22. package/src/engine/graphics3/GPUParticleEmitterSystem.d.ts.map +1 -1
  23. package/src/engine/graphics3/GPUParticleEmitterSystem.js +19 -5
  24. package/src/engine/graphics3/animation/AnimationClips.d.ts +107 -13
  25. package/src/engine/graphics3/animation/AnimationClips.d.ts.map +1 -1
  26. package/src/engine/graphics3/animation/AnimationClips.js +207 -10
  27. package/src/engine/graphics3/animation/AnimationClipsSink.d.ts +89 -0
  28. package/src/engine/graphics3/animation/AnimationClipsSink.d.ts.map +1 -0
  29. package/src/engine/graphics3/animation/AnimationClipsSink.js +205 -0
  30. package/src/engine/graphics3/animation/FoliageWindRigs.d.ts +43 -0
  31. package/src/engine/graphics3/animation/FoliageWindRigs.d.ts.map +1 -0
  32. package/src/engine/graphics3/animation/FoliageWindRigs.js +69 -0
  33. package/src/engine/graphics3/animation/write_clip_playback.d.ts +17 -11
  34. package/src/engine/graphics3/animation/write_clip_playback.d.ts.map +1 -1
  35. package/src/engine/graphics3/animation/write_clip_playback.js +36 -27
  36. package/src/engine/graphics3/decal/GPUDecalRenderer.d.ts.map +1 -1
  37. package/src/engine/graphics3/decal/GPUDecalRenderer.js +8 -6
  38. package/src/engine/graphics3/decal/shader_decal_composite.d.ts.map +1 -1
  39. package/src/engine/graphics3/decal/shader_decal_composite.js +11 -5
  40. package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts +7 -7
  41. package/src/engine/graphics3/pose/collect_entity_playbacks.d.ts.map +1 -1
  42. package/src/engine/graphics3/pose/collect_entity_playbacks.js +14 -15
  43. package/src/engine/graphics3/prefab/Prefab.d.ts +6 -0
  44. package/src/engine/graphics3/prefab/Prefab.d.ts.map +1 -1
  45. package/src/engine/graphics3/prefab/Prefab.js +169 -162
  46. package/src/engine/graphics3/prefab/prefab_compile.d.ts.map +1 -1
  47. package/src/engine/graphics3/prefab/prefab_compile.js +369 -334
  48. package/src/engine/graphics3/prefab/prefab_instantiate.d.ts.map +1 -1
  49. package/src/engine/graphics3/prefab/prefab_instantiate.js +43 -2
  50. package/src/engine/graphics3/terrain/chunk_terrain_material_surface.js +2 -2
  51. package/src/engine/physics/ecs/ContactProbeSystem.d.ts +2 -3
  52. package/src/engine/physics/ecs/ContactProbeSystem.d.ts.map +1 -1
  53. package/src/engine/physics/ecs/ContactProbeSystem.js +2 -4
  54. package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts +4 -4
  55. package/src/engine/sound/simulation/PROBE_PLACEMENT.md +4 -4
  56. package/src/engine/sound/simulation/README.md +1 -1
  57. package/src/engine/sound/simulation/probe/bakeProbeField.d.ts +22 -8
  58. package/src/engine/sound/simulation/probe/bakeProbeField.d.ts.map +1 -1
  59. package/src/engine/sound/simulation/probe/bakeProbeField.js +60 -15
  60. package/src/engine/sound/simulation/probe/bakeProbeReflectors.d.ts.map +1 -1
  61. package/src/engine/sound/simulation/probe/bakeProbeReflectors.js +19 -23
  62. package/src/engine/sound/simulation/probe/probe_sdf_grid.d.ts +63 -17
  63. package/src/engine/sound/simulation/probe/probe_sdf_grid.d.ts.map +1 -1
  64. package/src/engine/sound/simulation/probe/probe_sdf_grid.js +67 -17
  65. package/src/generation/foliage/FOLIAGE_DESIGN.md +318 -0
  66. package/src/generation/foliage/FOLIAGE_PLAN.md +198 -0
  67. package/src/generation/foliage/animation/build_tree_wind_rig.d.ts +20 -0
  68. package/src/generation/foliage/animation/build_tree_wind_rig.d.ts.map +1 -0
  69. package/src/generation/foliage/animation/build_tree_wind_rig.js +108 -0
  70. package/src/generation/foliage/asset/TreeAsset.d.ts +86 -0
  71. package/src/generation/foliage/asset/TreeAsset.d.ts.map +1 -0
  72. package/src/generation/foliage/asset/TreeAsset.js +111 -0
  73. package/src/generation/foliage/asset/TreeLODAsset.d.ts +115 -0
  74. package/src/generation/foliage/asset/TreeLODAsset.d.ts.map +1 -0
  75. package/src/generation/foliage/asset/TreeLODAsset.js +346 -0
  76. package/src/generation/foliage/asset/generate_tree.d.ts +15 -0
  77. package/src/generation/foliage/asset/generate_tree.d.ts.map +1 -0
  78. package/src/generation/foliage/asset/generate_tree.js +93 -0
  79. package/src/generation/foliage/asset/place_tree.d.ts +82 -0
  80. package/src/generation/foliage/asset/place_tree.d.ts.map +1 -0
  81. package/src/generation/foliage/asset/place_tree.js +194 -0
  82. package/src/generation/foliage/config/BarkMaterialConfig.d.ts +120 -0
  83. package/src/generation/foliage/config/BarkMaterialConfig.d.ts.map +1 -0
  84. package/src/generation/foliage/config/BarkMaterialConfig.js +250 -0
  85. package/src/generation/foliage/config/BranchLevelConfig.d.ts +288 -0
  86. package/src/generation/foliage/config/BranchLevelConfig.d.ts.map +1 -0
  87. package/src/generation/foliage/config/BranchLevelConfig.js +536 -0
  88. package/src/generation/foliage/config/CrownConfig.d.ts +100 -0
  89. package/src/generation/foliage/config/CrownConfig.d.ts.map +1 -0
  90. package/src/generation/foliage/config/CrownConfig.js +186 -0
  91. package/src/generation/foliage/config/CrownEnvelopeType.d.ts +16 -0
  92. package/src/generation/foliage/config/CrownEnvelopeType.d.ts.map +1 -0
  93. package/src/generation/foliage/config/CrownEnvelopeType.js +17 -0
  94. package/src/generation/foliage/config/FoliageCardType.d.ts +12 -0
  95. package/src/generation/foliage/config/FoliageCardType.d.ts.map +1 -0
  96. package/src/generation/foliage/config/FoliageCardType.js +18 -0
  97. package/src/generation/foliage/config/FoliageConfig.d.ts +151 -0
  98. package/src/generation/foliage/config/FoliageConfig.d.ts.map +1 -0
  99. package/src/generation/foliage/config/FoliageConfig.js +283 -0
  100. package/src/generation/foliage/config/FoliageMaterialConfig.d.ts +90 -0
  101. package/src/generation/foliage/config/FoliageMaterialConfig.d.ts.map +1 -0
  102. package/src/generation/foliage/config/FoliageMaterialConfig.js +181 -0
  103. package/src/generation/foliage/config/PhyllotaxisMode.d.ts +13 -0
  104. package/src/generation/foliage/config/PhyllotaxisMode.d.ts.map +1 -0
  105. package/src/generation/foliage/config/PhyllotaxisMode.js +20 -0
  106. package/src/generation/foliage/config/TreeLODConfig.d.ts +87 -0
  107. package/src/generation/foliage/config/TreeLODConfig.d.ts.map +1 -0
  108. package/src/generation/foliage/config/TreeLODConfig.js +211 -0
  109. package/src/generation/foliage/config/TreePreset.d.ts +16 -0
  110. package/src/generation/foliage/config/TreePreset.d.ts.map +1 -0
  111. package/src/generation/foliage/config/TreePreset.js +17 -0
  112. package/src/generation/foliage/config/TreeSpeciesConfig.d.ts +109 -0
  113. package/src/generation/foliage/config/TreeSpeciesConfig.d.ts.map +1 -0
  114. package/src/generation/foliage/config/TreeSpeciesConfig.js +400 -0
  115. package/src/generation/foliage/config/TreeWindConfig.d.ts +84 -0
  116. package/src/generation/foliage/config/TreeWindConfig.d.ts.map +1 -0
  117. package/src/generation/foliage/config/TreeWindConfig.js +157 -0
  118. package/src/generation/foliage/index.d.ts +38 -0
  119. package/src/generation/foliage/index.d.ts.map +1 -0
  120. package/src/generation/foliage/index.js +43 -0
  121. package/src/generation/foliage/material/make_bark_material.d.ts +37 -0
  122. package/src/generation/foliage/material/make_bark_material.d.ts.map +1 -0
  123. package/src/generation/foliage/material/make_bark_material.js +802 -0
  124. package/src/generation/foliage/material/make_foliage_material.d.ts +14 -0
  125. package/src/generation/foliage/material/make_foliage_material.d.ts.map +1 -0
  126. package/src/generation/foliage/material/make_foliage_material.js +359 -0
  127. package/src/generation/foliage/mesh/branch_collar_project.d.ts +42 -0
  128. package/src/generation/foliage/mesh/branch_collar_project.d.ts.map +1 -0
  129. package/src/generation/foliage/mesh/branch_collar_project.js +203 -0
  130. package/src/generation/foliage/mesh/branch_ring_triangulate.d.ts +35 -0
  131. package/src/generation/foliage/mesh/branch_ring_triangulate.d.ts.map +1 -0
  132. package/src/generation/foliage/mesh/branch_ring_triangulate.js +72 -0
  133. package/src/generation/foliage/mesh/foliage_collect_attachments.d.ts +80 -0
  134. package/src/generation/foliage/mesh/foliage_collect_attachments.d.ts.map +1 -0
  135. package/src/generation/foliage/mesh/foliage_collect_attachments.js +502 -0
  136. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.d.ts +19 -0
  137. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.d.ts.map +1 -0
  138. package/src/generation/foliage/mesh/tree_mesh_apply_canopy_ao.js +150 -0
  139. package/src/generation/foliage/mesh/tree_mesh_build_bark.d.ts +55 -0
  140. package/src/generation/foliage/mesh/tree_mesh_build_bark.d.ts.map +1 -0
  141. package/src/generation/foliage/mesh/tree_mesh_build_bark.js +1047 -0
  142. package/src/generation/foliage/mesh/tree_mesh_build_foliage.d.ts +21 -0
  143. package/src/generation/foliage/mesh/tree_mesh_build_foliage.d.ts.map +1 -0
  144. package/src/generation/foliage/mesh/tree_mesh_build_foliage.js +415 -0
  145. package/src/generation/foliage/presets/make_tree_species_preset.d.ts +13 -0
  146. package/src/generation/foliage/presets/make_tree_species_preset.d.ts.map +1 -0
  147. package/src/generation/foliage/presets/make_tree_species_preset.js +837 -0
  148. package/src/generation/foliage/skeleton/TreeSkeleton.d.ts +443 -0
  149. package/src/generation/foliage/skeleton/TreeSkeleton.d.ts.map +1 -0
  150. package/src/generation/foliage/skeleton/TreeSkeleton.js +1100 -0
  151. package/src/generation/foliage/skeleton/crown_envelope_evaluate.d.ts +27 -0
  152. package/src/generation/foliage/skeleton/crown_envelope_evaluate.d.ts.map +1 -0
  153. package/src/generation/foliage/skeleton/crown_envelope_evaluate.js +121 -0
  154. package/src/generation/foliage/skeleton/spine_frame_double_reflection.d.ts +32 -0
  155. package/src/generation/foliage/skeleton/spine_frame_double_reflection.d.ts.map +1 -0
  156. package/src/generation/foliage/skeleton/spine_frame_double_reflection.js +87 -0
  157. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.d.ts +33 -0
  158. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.d.ts.map +1 -0
  159. package/src/generation/foliage/skeleton/tree_skeleton_assign_skin_joints.js +205 -0
  160. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.d.ts +14 -0
  161. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.d.ts.map +1 -0
  162. package/src/generation/foliage/skeleton/tree_skeleton_compute_pipe_radii.js +179 -0
  163. package/src/generation/foliage/skeleton/tree_skeleton_grow.d.ts +18 -0
  164. package/src/generation/foliage/skeleton/tree_skeleton_grow.d.ts.map +1 -0
  165. package/src/generation/foliage/skeleton/tree_skeleton_grow.js +1104 -0
  166. package/src/shade/playground/additive_blending/index.html +197 -0
  167. package/src/shade/playground/additive_blending/main.d.ts +2 -0
  168. package/src/shade/playground/additive_blending/main.d.ts.map +1 -0
  169. package/src/shade/playground/additive_blending/main.js +529 -0
  170. package/src/shade/playground/foliage_wind/README.md +18 -0
  171. package/src/shade/playground/foliage_wind/foliage_world.d.ts +127 -0
  172. package/src/shade/playground/foliage_wind/foliage_world.d.ts.map +1 -0
  173. package/src/shade/playground/foliage_wind/foliage_world.js +593 -0
  174. package/src/shade/playground/foliage_wind/index.html +254 -0
  175. package/src/shade/playground/foliage_wind/main.d.ts +2 -0
  176. package/src/shade/playground/foliage_wind/main.d.ts.map +1 -0
  177. package/src/shade/playground/foliage_wind/main.js +263 -0
  178. package/src/shade/playground/tonemap_sdr/README.md +5 -3
  179. package/src/shade/renderer/Renderer.d.ts +1 -1
  180. package/src/shade/renderer/Renderer.d.ts.map +1 -1
  181. package/src/shade/renderer/Renderer.js +88 -31
  182. package/src/shade/renderer/ShadeToneMappingMode.d.ts +3 -2
  183. package/src/shade/renderer/ShadeToneMappingMode.js +15 -4
  184. package/src/shade/renderer/animation/ADDITIVE_BLENDING_PLAN.md +145 -0
  185. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.d.ts +9 -1
  186. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.d.ts.map +1 -1
  187. package/src/shade/renderer/animation/ANIMATION_DATABASE_SPEC.js +53 -1
  188. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.d.ts +8 -0
  189. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.d.ts.map +1 -0
  190. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_JOINT_STRUCT.js +71 -0
  191. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.d.ts +11 -0
  192. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.d.ts.map +1 -0
  193. package/src/shade/renderer/animation/ANIMATION_FOLIAGE_RIG_STRUCT.js +32 -0
  194. package/src/shade/renderer/animation/GPUAnimationManager.d.ts +30 -3
  195. package/src/shade/renderer/animation/GPUAnimationManager.d.ts.map +1 -1
  196. package/src/shade/renderer/animation/GPUAnimationManager.js +532 -79
  197. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.d.ts +19 -12
  198. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.d.ts.map +1 -1
  199. package/src/shade/renderer/animation/POSE_ACCUMULATOR_LAYOUT.js +20 -13
  200. package/src/shade/renderer/animation/ShadeAnimationClip.d.ts +35 -8
  201. package/src/shade/renderer/animation/ShadeAnimationClip.d.ts.map +1 -1
  202. package/src/shade/renderer/animation/ShadeAnimationClip.js +433 -2
  203. package/src/shade/renderer/animation/chunk_pose_accumulator.d.ts.map +1 -1
  204. package/src/shade/renderer/animation/chunk_pose_accumulator.js +40 -32
  205. package/src/shade/renderer/animation/foliage/FoliageWindJoint.d.ts +97 -0
  206. package/src/shade/renderer/animation/foliage/FoliageWindJoint.d.ts.map +1 -0
  207. package/src/shade/renderer/animation/foliage/FoliageWindJoint.js +161 -0
  208. package/src/shade/renderer/animation/foliage/FoliageWindRig.d.ts +65 -0
  209. package/src/shade/renderer/animation/foliage/FoliageWindRig.d.ts.map +1 -0
  210. package/src/shade/renderer/animation/foliage/FoliageWindRig.js +89 -0
  211. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.d.ts +19 -0
  212. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.d.ts.map +1 -0
  213. package/src/shade/renderer/animation/foliage/chunk_foliage_wind_step.js +143 -0
  214. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.d.ts +14 -0
  215. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.d.ts.map +1 -0
  216. package/src/shade/renderer/animation/foliage/shader_foliage_wind_apply.js +116 -0
  217. package/src/shade/renderer/animation/pose/pose_evaluate_local.d.ts.map +1 -1
  218. package/src/shade/renderer/animation/pose/pose_evaluate_local.js +39 -29
  219. package/src/shade/renderer/animation/shader_animation_pose_resolve.js +37 -37
  220. package/src/shade/renderer/animation/skinning/GPUMeshSkinningContext.js +2 -2
  221. package/src/shade/renderer/deferred/tonemap/TonemapAces2Tables.d.ts +38 -0
  222. package/src/shade/renderer/deferred/tonemap/TonemapAces2Tables.d.ts.map +1 -0
  223. package/src/shade/renderer/deferred/tonemap/TonemapAces2Tables.js +97 -0
  224. package/src/shade/renderer/deferred/{TonemapDisplaySettings.d.ts → tonemap/TonemapDisplaySettings.d.ts} +1 -1
  225. package/src/shade/renderer/deferred/tonemap/TonemapDisplaySettings.d.ts.map +1 -0
  226. package/src/shade/renderer/deferred/{TonemapDisplaySettings.js → tonemap/TonemapDisplaySettings.js} +5 -5
  227. package/src/shade/renderer/deferred/{shader_tonemap_HDR.d.ts → tonemap/shader_tonemap_HDR.d.ts} +1 -1
  228. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR.d.ts.map +1 -0
  229. package/src/shade/renderer/deferred/{shader_tonemap_HDR.js → tonemap/shader_tonemap_HDR.js} +9 -9
  230. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR_aces.d.ts +17 -0
  231. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR_aces.d.ts.map +1 -0
  232. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR_aces.js +101 -0
  233. package/src/shade/renderer/deferred/{shader_tonemap_HDR_none.d.ts → tonemap/shader_tonemap_HDR_none.d.ts} +1 -1
  234. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR_none.d.ts.map +1 -0
  235. package/src/shade/renderer/deferred/{shader_tonemap_HDR_none.js → tonemap/shader_tonemap_HDR_none.js} +6 -6
  236. package/src/shade/renderer/deferred/{shader_tonemap_HDR_pbr_neutral.d.ts → tonemap/shader_tonemap_HDR_pbr_neutral.d.ts} +1 -1
  237. package/src/shade/renderer/deferred/tonemap/shader_tonemap_HDR_pbr_neutral.d.ts.map +1 -0
  238. package/src/shade/renderer/deferred/{shader_tonemap_HDR_pbr_neutral.js → tonemap/shader_tonemap_HDR_pbr_neutral.js} +8 -8
  239. package/src/shade/renderer/deferred/{shader_tonemap_LDR.d.ts → tonemap/shader_tonemap_LDR.d.ts} +1 -1
  240. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR.d.ts.map +1 -0
  241. package/src/shade/renderer/deferred/{shader_tonemap_LDR.js → tonemap/shader_tonemap_LDR.js} +10 -10
  242. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR_aces.d.ts +10 -0
  243. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR_aces.d.ts.map +1 -0
  244. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR_aces.js +77 -0
  245. package/src/shade/renderer/deferred/{shader_tonemap_LDR_none.d.ts → tonemap/shader_tonemap_LDR_none.d.ts} +1 -1
  246. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR_none.d.ts.map +1 -0
  247. package/src/shade/renderer/deferred/{shader_tonemap_LDR_none.js → tonemap/shader_tonemap_LDR_none.js} +7 -7
  248. package/src/shade/renderer/deferred/{shader_tonemap_LDR_pbr_neutral.d.ts → tonemap/shader_tonemap_LDR_pbr_neutral.d.ts} +1 -1
  249. package/src/shade/renderer/deferred/tonemap/shader_tonemap_LDR_pbr_neutral.d.ts.map +1 -0
  250. package/src/shade/renderer/deferred/{shader_tonemap_LDR_pbr_neutral.js → tonemap/shader_tonemap_LDR_pbr_neutral.js} +8 -8
  251. package/src/shade/renderer/extension/RenderExtension.d.ts +7 -0
  252. package/src/shade/renderer/extension/RenderExtension.d.ts.map +1 -1
  253. package/src/shade/renderer/extension/RenderExtension.js +9 -0
  254. package/src/shade/renderer/extension/RenderExtensionRegistry.d.ts +6 -0
  255. package/src/shade/renderer/extension/RenderExtensionRegistry.d.ts.map +1 -1
  256. package/src/shade/renderer/extension/RenderExtensionRegistry.js +15 -0
  257. package/src/shade/renderer/fluid/GPUFluidCascade.d.ts +10 -3
  258. package/src/shade/renderer/fluid/GPUFluidCascade.d.ts.map +1 -1
  259. package/src/shade/renderer/fluid/GPUFluidCascade.js +15 -0
  260. package/src/shade/renderer/fluid/GPUFluidCascadeStack.d.ts +8 -1
  261. package/src/shade/renderer/fluid/GPUFluidCascadeStack.d.ts.map +1 -1
  262. package/src/shade/renderer/fluid/GPUFluidCascadeStack.js +11 -0
  263. package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.d.ts.map +1 -1
  264. package/src/shade/renderer/fluid/coupling/chunk_fluid_cascade_parent.js +51 -48
  265. package/src/shade/renderer/fluid/forcing/GPUFluidForcing.d.ts +6 -6
  266. package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts +6 -0
  267. package/src/shade/renderer/fluid/mac/FluidMacPasses.d.ts.map +1 -1
  268. package/src/shade/renderer/fluid/mac/FluidMacPasses.js +16 -0
  269. package/src/shade/renderer/fluid/mac/chunk_fluid_mac_seams.d.ts.map +1 -1
  270. package/src/shade/renderer/fluid/mac/chunk_fluid_mac_seams.js +15 -3
  271. package/src/shade/renderer/fluid/mac/chunk_v3_mac_lattice_corners.d.ts.map +1 -1
  272. package/src/shade/renderer/fluid/mac/chunk_v3_mac_lattice_corners.js +102 -96
  273. package/src/shade/renderer/fluid/mac/shader_fluid_mac_advect_correct.js +12 -12
  274. package/src/shade/renderer/fluid/mac/shader_fluid_mac_advect_predict.js +12 -12
  275. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.d.ts +8 -1
  276. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.d.ts.map +1 -1
  277. package/src/shade/renderer/fluid/pressure/GPUFluidPressureSolve.js +16 -0
  278. package/src/shade/renderer/fluid/publish/FluidWindPublish.d.ts +7 -0
  279. package/src/shade/renderer/fluid/publish/FluidWindPublish.d.ts.map +1 -1
  280. package/src/shade/renderer/fluid/publish/FluidWindPublish.js +10 -0
  281. package/src/shade/renderer/fluid/query/GPUFluidQueries.d.ts +1 -1
  282. package/src/shade/renderer/geometry/bvh/GPUBLASRefitBatch.js +2 -2
  283. package/src/shade/renderer/loader/SceneBundle.d.ts +7 -0
  284. package/src/shade/renderer/loader/SceneBundle.d.ts.map +1 -1
  285. package/src/shade/renderer/loader/SceneBundle.js +119 -111
  286. package/src/shade/renderer/loader/gltf/tiny-gltf.d.ts +1 -1
  287. package/src/shade/renderer/material/standard/fragment_gbuffer.d.ts +4 -0
  288. package/src/shade/renderer/material/standard/fragment_gbuffer.d.ts.map +1 -1
  289. package/src/shade/renderer/material/standard/fragment_gbuffer.js +6 -5
  290. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.d.ts +8 -7
  291. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.d.ts.map +1 -1
  292. package/src/shade/renderer/object_property/chunk_write_object_property_node3d.js +9 -8
  293. package/src/shade/renderer/particles/GPUParticleSystem.d.ts.map +1 -1
  294. package/src/shade/renderer/particles/GPUParticleSystem.js +3 -1
  295. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.d.ts.map +1 -1
  296. package/src/shade/renderer/particles/shaders/shader_particle_avboit_draw.js +9 -4
  297. package/src/shade/renderer/postprocess/nss/NSS.d.ts +1 -1
  298. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader.d.ts.map +1 -1
  299. package/src/shade/renderer/postprocess/ssr/resolve/ssr_resolve_shader.js +9 -7
  300. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment.d.ts.map +1 -1
  301. package/src/shade/renderer/rasterize/forward/chunk_forward_shade_standard_fragment.js +15 -7
  302. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.d.ts.map +1 -1
  303. package/src/shade/renderer/rasterize/native/avboit/avboit_draw_fragment_body.js +6 -4
  304. package/src/shade/renderer/rasterize/native/oit/oit_resolve_fragment_body.js +3 -3
  305. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.d.ts.map +1 -1
  306. package/src/shade/renderer/rasterize/native/oit/shader_oit_generate_moments.js +8 -5
  307. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.d.ts.map +1 -1
  308. package/src/shade/renderer/rasterize/native/viz/viz_rasterization_alpha_tested_pass_descriptor.js +4 -3
  309. package/src/shade/renderer/shader/chunk/color/tonemap/ACES_TONE_MAPPING_BRIEF_2026_10_17.md +160 -0
  310. package/src/shade/renderer/shader/chunk/color/tonemap/HDR_TONE_MAPPING_FORMS_BRIEF_2026_10_16.md +5 -1
  311. package/src/shade/renderer/shader/chunk/color/tonemap/SDR_TONE_MAPPING_BRIEF_2026_10_16.md +15 -5
  312. package/src/shade/renderer/shader/chunk/color/tonemap/aces/aces2_transform_block.d.ts +41 -0
  313. package/src/shade/renderer/shader/chunk/color/tonemap/aces/aces2_transform_block.d.ts.map +1 -0
  314. package/src/shade/renderer/shader/chunk/color/tonemap/aces/aces2_transform_block.js +692 -0
  315. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces2_output_transform.d.ts +25 -0
  316. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces2_output_transform.d.ts.map +1 -0
  317. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces2_output_transform.js +446 -0
  318. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces_ue_matrices.d.ts +22 -0
  319. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces_ue_matrices.d.ts.map +1 -0
  320. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_aces_ue_matrices.js +68 -0
  321. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_tonemap_ue_filmic.d.ts +32 -0
  322. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_tonemap_ue_filmic.d.ts.map +1 -0
  323. package/src/shade/renderer/shader/chunk/color/tonemap/aces/chunk_tonemap_ue_filmic.js +163 -0
  324. package/src/shade/renderer/shader/chunk/color/tonemap/chunk_PAPER_WHITE_NITS.d.ts +10 -3
  325. package/src/shade/renderer/shader/chunk/color/tonemap/chunk_PAPER_WHITE_NITS.d.ts.map +1 -1
  326. package/src/shade/renderer/shader/chunk/color/tonemap/chunk_PAPER_WHITE_NITS.js +12 -4
  327. package/src/shade/renderer/shadow/map/GPUSceneShadowmapContext.js +1 -1
  328. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts +9 -0
  329. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.d.ts.map +1 -0
  330. package/src/shade/renderer/texture/SAMPLER_ANISOTROPIC_CLAMP.js +17 -0
  331. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts +8 -0
  332. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.d.ts.map +1 -1
  333. package/src/shade/renderer/texture/SAMPLER_LINEAR_UPSCALE.js +28 -20
  334. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.d.ts +8 -0
  335. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.d.ts.map +1 -0
  336. package/src/shade/renderer/texture/SAMPLER_TRILINEAR_CLAMP.js +15 -0
  337. package/src/shade/renderer/view/chunk_view_mip_bias.d.ts +21 -0
  338. package/src/shade/renderer/view/chunk_view_mip_bias.d.ts.map +1 -0
  339. package/src/shade/renderer/view/chunk_view_mip_bias.js +44 -0
  340. package/src/shade/wgsl/emulator/WGSLJavaScriptCompiler.js +1 -1
  341. package/src/shade/wgsl/emulator/WGSLLanguageCore.d.ts.map +1 -1
  342. package/src/shade/wgsl/emulator/WGSLLanguageCore.js +105 -26
  343. package/src/engine/graphics/composit/CompositingStages.d.ts +0 -6
  344. package/src/engine/graphics/composit/CompositingStages.d.ts.map +0 -1
  345. package/src/engine/graphics/composit/CompositingStages.js +0 -8
  346. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.d.ts +0 -7
  347. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.d.ts.map +0 -1
  348. package/src/engine/graphics/geometry/buffered/computeBufferAttributeHash.js +0 -24
  349. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.d.ts +0 -8
  350. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.d.ts.map +0 -1
  351. package/src/engine/graphics/geometry/buffered/computeGeometryBoundingSphereMiniball.js +0 -17
  352. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.d.ts +0 -8
  353. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.d.ts.map +0 -1
  354. package/src/engine/graphics/geometry/buffered/computeGeometryEquality.js +0 -60
  355. package/src/engine/graphics/geometry/buffered/computeGeometryHash.d.ts +0 -7
  356. package/src/engine/graphics/geometry/buffered/computeGeometryHash.d.ts.map +0 -1
  357. package/src/engine/graphics/geometry/buffered/computeGeometryHash.js +0 -26
  358. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.d.ts +0 -7
  359. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.d.ts.map +0 -1
  360. package/src/engine/graphics/geometry/buffered/compute_buffer_geometry_byte_size.js +0 -23
  361. package/src/engine/graphics/geometry/instancing/geometry_copy.d.ts +0 -7
  362. package/src/engine/graphics/geometry/instancing/geometry_copy.d.ts.map +0 -1
  363. package/src/engine/graphics/geometry/instancing/geometry_copy.js +0 -15
  364. package/src/engine/graphics/geometry/instancing/rewriteMaterial.d.ts +0 -2
  365. package/src/engine/graphics/geometry/instancing/rewriteMaterial.d.ts.map +0 -1
  366. package/src/engine/graphics/geometry/instancing/rewriteMaterial.js +0 -57
  367. package/src/engine/graphics/geometry/ribbon/Quad.d.ts +0 -96
  368. package/src/engine/graphics/geometry/ribbon/Quad.d.ts.map +0 -1
  369. package/src/engine/graphics/geometry/ribbon/Quad.js +0 -213
  370. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.d.ts +0 -9
  371. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.d.ts.map +0 -1
  372. package/src/engine/graphics/geometry/ribbon/copyAttributeV3.js +0 -12
  373. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.d.ts +0 -10
  374. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.d.ts.map +0 -1
  375. package/src/engine/graphics/geometry/ribbon/copyAttributeValue.js +0 -17
  376. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.d.ts +0 -10
  377. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.d.ts.map +0 -1
  378. package/src/engine/graphics/geometry/ribbon/equalAttributeV3.js +0 -13
  379. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.d.ts +0 -11
  380. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.d.ts.map +0 -1
  381. package/src/engine/graphics/geometry/ribbon/equalAttributeValue.js +0 -24
  382. package/src/engine/graphics/geometry/ribbon/rotateRibbon.d.ts +0 -6
  383. package/src/engine/graphics/geometry/ribbon/rotateRibbon.d.ts.map +0 -1
  384. package/src/engine/graphics/geometry/ribbon/rotateRibbon.js +0 -37
  385. package/src/engine/graphics/geometry/ribbon/updateTipPosition.d.ts +0 -9
  386. package/src/engine/graphics/geometry/ribbon/updateTipPosition.d.ts.map +0 -1
  387. package/src/engine/graphics/geometry/ribbon/updateTipPosition.js +0 -52
  388. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.d.ts +0 -8
  389. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.d.ts.map +0 -1
  390. package/src/engine/graphics/geometry/skining/computeSkinnedMeshVertices.js +0 -54
  391. package/src/engine/graphics/render/RenderPassType.d.ts +0 -6
  392. package/src/engine/graphics/render/RenderPassType.d.ts.map +0 -1
  393. package/src/engine/graphics/render/RenderPassType.js +0 -8
  394. package/src/engine/graphics/render/layers/RenderLayer.d.ts +0 -78
  395. package/src/engine/graphics/render/layers/RenderLayer.d.ts.map +0 -1
  396. package/src/engine/graphics/render/layers/RenderLayer.js +0 -95
  397. package/src/engine/graphics/render/layers/RenderLayerManager.d.ts +0 -72
  398. package/src/engine/graphics/render/layers/RenderLayerManager.d.ts.map +0 -1
  399. package/src/engine/graphics/render/layers/RenderLayerManager.js +0 -160
  400. package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts +0 -18
  401. package/src/engine/graphics/render/layers/RenderLayerManagerState.d.ts.map +0 -1
  402. package/src/engine/graphics/render/layers/RenderLayerManagerState.js +0 -48
  403. package/src/engine/graphics/render/layers/RenderLayerState.d.ts +0 -18
  404. package/src/engine/graphics/render/layers/RenderLayerState.d.ts.map +0 -1
  405. package/src/engine/graphics/render/layers/RenderLayerState.js +0 -27
  406. package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts +0 -8
  407. package/src/engine/graphics/render/layers/RenderLayerUtils.d.ts.map +0 -1
  408. package/src/engine/graphics/render/layers/RenderLayerUtils.js +0 -103
  409. package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts +0 -10
  410. package/src/engine/graphics/render/make_bvh_visibility_builder.d.ts.map +0 -1
  411. package/src/engine/graphics/render/make_bvh_visibility_builder.js +0 -64
  412. package/src/engine/graphics/render/view/CameraViewFlags.d.ts +0 -7
  413. package/src/engine/graphics/render/view/CameraViewFlags.d.ts.map +0 -1
  414. package/src/engine/graphics/render/view/CameraViewFlags.js +0 -9
  415. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.d.ts +0 -143
  416. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.d.ts.map +0 -1
  417. package/src/engine/graphics/render/visibility/IncrementalDeltaSet.js +0 -328
  418. package/src/engine/graphics/render/visibility/VisibilityComputer.d.ts +0 -39
  419. package/src/engine/graphics/render/visibility/VisibilityComputer.d.ts.map +0 -1
  420. package/src/engine/graphics/render/visibility/VisibilityComputer.js +0 -80
  421. package/src/engine/graphics/render/visibility/VisibilityFilter.d.ts +0 -29
  422. package/src/engine/graphics/render/visibility/VisibilityFilter.d.ts.map +0 -1
  423. package/src/engine/graphics/render/visibility/VisibilityFilter.js +0 -37
  424. package/src/engine/graphics3/animation/write_graph_playback.d.ts +0 -24
  425. package/src/engine/graphics3/animation/write_graph_playback.d.ts.map +0 -1
  426. package/src/engine/graphics3/animation/write_graph_playback.js +0 -48
  427. package/src/shade/renderer/deferred/TonemapDisplaySettings.d.ts.map +0 -1
  428. package/src/shade/renderer/deferred/shader_tonemap_HDR.d.ts.map +0 -1
  429. package/src/shade/renderer/deferred/shader_tonemap_HDR_none.d.ts.map +0 -1
  430. package/src/shade/renderer/deferred/shader_tonemap_HDR_pbr_neutral.d.ts.map +0 -1
  431. package/src/shade/renderer/deferred/shader_tonemap_LDR.d.ts.map +0 -1
  432. package/src/shade/renderer/deferred/shader_tonemap_LDR_none.d.ts.map +0 -1
  433. package/src/shade/renderer/deferred/shader_tonemap_LDR_pbr_neutral.d.ts.map +0 -1
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Procedural foliage cluster PBR material & silhouette synthesis configuration.
3
+ */
4
+ export class FoliageMaterialConfig {
5
+ /**
6
+ * @param {Partial<FoliageMaterialConfig>} [options]
7
+ * @returns {FoliageMaterialConfig}
8
+ */
9
+ static from(options?: Partial<FoliageMaterialConfig>): FoliageMaterialConfig;
10
+ /**
11
+ * Procedural texture resolution (pixels, power of two).
12
+ * @type {number}
13
+ */
14
+ resolution: number;
15
+ /**
16
+ * Sun-facing leaf lamina color (sRGB).
17
+ * @type {Color}
18
+ */
19
+ primary_color: Color;
20
+ /**
21
+ * Vein / young tip / secondary leaf color (sRGB).
22
+ * @type {Color}
23
+ */
24
+ secondary_color: Color;
25
+ /**
26
+ * Autumn / golden-red shift factor [0, 1].
27
+ * @type {number}
28
+ */
29
+ autumn_tint: number;
30
+ /**
31
+ * Leaf cluster silhouette style: `"ovate" | "lobed" | "serrated" | "palmate" | "needle" | "frond"`.
32
+ * @type {string}
33
+ */
34
+ leaf_shape: string;
35
+ /**
36
+ * Number of leaflets arranged on the twig cluster card.
37
+ * @type {number}
38
+ */
39
+ leaflets_per_cluster: number;
40
+ /**
41
+ * Base PBR roughness [0, 1].
42
+ * @type {number}
43
+ */
44
+ roughness: number;
45
+ /**
46
+ * Venation normal-map relief strength [0, 1].
47
+ * @type {number}
48
+ */
49
+ vein_strength: number;
50
+ /**
51
+ * Horizontal UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
52
+ * @type {number}
53
+ */
54
+ stem_anchor_u: number;
55
+ /**
56
+ * Vertical UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
57
+ * @type {number}
58
+ */
59
+ stem_anchor_v: number;
60
+ /**
61
+ * @param {Partial<FoliageMaterialConfig>} [overrides]
62
+ * @returns {this}
63
+ */
64
+ applyOverrides(overrides?: Partial<FoliageMaterialConfig>): this;
65
+ /**
66
+ * @param {FoliageMaterialConfig} other
67
+ * @returns {this}
68
+ */
69
+ copy(other: FoliageMaterialConfig): this;
70
+ /**
71
+ * @returns {FoliageMaterialConfig}
72
+ */
73
+ clone(): FoliageMaterialConfig;
74
+ /**
75
+ * @param {FoliageMaterialConfig} other
76
+ * @returns {boolean}
77
+ */
78
+ equals(other: FoliageMaterialConfig): boolean;
79
+ /**
80
+ * @returns {number}
81
+ */
82
+ hash(): number;
83
+ /**
84
+ * @readonly
85
+ * @type {boolean}
86
+ */
87
+ readonly isFoliageMaterialConfig: boolean;
88
+ }
89
+ import { Color } from "../../../core/color/Color.js";
90
+ //# sourceMappingURL=FoliageMaterialConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"FoliageMaterialConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/FoliageMaterialConfig.js"],"names":[],"mappings":"AAMA;;GAEG;AACH;IA6DI;;;OAGG;IACH,sBAHW,QAAQ,qBAAqB,CAAC,GAC5B,qBAAqB,CAMjC;IApED;;;OAGG;IACH,YAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,KAAK,CAEkC;IAEjD;;;OAGG;IACH,iBAFU,KAAK,CAEoC;IAEnD;;;OAGG;IACH,aAFU,MAAM,CAEE;IAElB;;;OAGG;IACH,YAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,sBAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,WAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAEpB;;;OAGG;IACH,eAFU,MAAM,CAEI;IAYpB;;;OAGG;IACH,2BAHW,QAAQ,qBAAqB,CAAC,GAC5B,IAAI,CA6BhB;IAED;;;OAGG;IACH,YAHW,qBAAqB,GACnB,IAAI,CAehB;IAED;;OAEG;IACH,SAFa,qBAAqB,CAMjC;IAED;;;OAGG;IACH,cAHW,qBAAqB,GACnB,OAAO,CAenB;IAED;;OAEG;IACH,QAFa,MAAM,CAYlB;IAGL;;;OAGG;IACH,kCAFU,OAAO,CAEsC;CANtD;sBA7KqB,8BAA8B"}
@@ -0,0 +1,181 @@
1
+ import { assert } from "../../../core/assert.js";
2
+ import { Color } from "../../../core/color/Color.js";
3
+ import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
4
+ import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
5
+ import { computeStringHash } from "../../../core/primitives/strings/computeStringHash.js";
6
+
7
+ /**
8
+ * Procedural foliage cluster PBR material & silhouette synthesis configuration.
9
+ */
10
+ export class FoliageMaterialConfig {
11
+ /**
12
+ * Procedural texture resolution (pixels, power of two).
13
+ * @type {number}
14
+ */
15
+ resolution = 128;
16
+
17
+ /**
18
+ * Sun-facing leaf lamina color (sRGB).
19
+ * @type {Color}
20
+ */
21
+ primary_color = new Color(0.26, 0.48, 0.16, 1.0);
22
+
23
+ /**
24
+ * Vein / young tip / secondary leaf color (sRGB).
25
+ * @type {Color}
26
+ */
27
+ secondary_color = new Color(0.38, 0.58, 0.22, 1.0);
28
+
29
+ /**
30
+ * Autumn / golden-red shift factor [0, 1].
31
+ * @type {number}
32
+ */
33
+ autumn_tint = 0.0;
34
+
35
+ /**
36
+ * Leaf cluster silhouette style: `"ovate" | "lobed" | "serrated" | "palmate" | "needle" | "frond"`.
37
+ * @type {string}
38
+ */
39
+ leaf_shape = "lobed";
40
+
41
+ /**
42
+ * Number of leaflets arranged on the twig cluster card.
43
+ * @type {number}
44
+ */
45
+ leaflets_per_cluster = 5;
46
+
47
+ /**
48
+ * Base PBR roughness [0, 1].
49
+ * @type {number}
50
+ */
51
+ roughness = 0.56;
52
+
53
+ /**
54
+ * Venation normal-map relief strength [0, 1].
55
+ * @type {number}
56
+ */
57
+ vein_strength = 0.5;
58
+
59
+ /**
60
+ * Horizontal UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
61
+ * @type {number}
62
+ */
63
+ stem_anchor_u = 0.5;
64
+
65
+ /**
66
+ * Vertical UV coordinate [0, 1] on the foliage card where the drawn woody stem/petiole attaches to the branch.
67
+ * @type {number}
68
+ */
69
+ stem_anchor_v = 0.0;
70
+
71
+ /**
72
+ * @param {Partial<FoliageMaterialConfig>} [options]
73
+ * @returns {FoliageMaterialConfig}
74
+ */
75
+ static from(options = {}) {
76
+ const r = new FoliageMaterialConfig();
77
+ r.applyOverrides(options);
78
+ return r;
79
+ }
80
+
81
+ /**
82
+ * @param {Partial<FoliageMaterialConfig>} [overrides]
83
+ * @returns {this}
84
+ */
85
+ applyOverrides(overrides = {}) {
86
+ if (overrides === null || overrides === undefined) {
87
+ return this;
88
+ }
89
+ if (overrides.resolution !== undefined) this.resolution = Math.max(16, overrides.resolution | 0);
90
+ if (overrides.primary_color !== undefined) {
91
+ if (Array.isArray(overrides.primary_color)) {
92
+ this.primary_color.setRGB(overrides.primary_color[0], overrides.primary_color[1], overrides.primary_color[2]);
93
+ } else {
94
+ this.primary_color.copy(overrides.primary_color);
95
+ }
96
+ }
97
+ if (overrides.secondary_color !== undefined) {
98
+ if (Array.isArray(overrides.secondary_color)) {
99
+ this.secondary_color.setRGB(overrides.secondary_color[0], overrides.secondary_color[1], overrides.secondary_color[2]);
100
+ } else {
101
+ this.secondary_color.copy(overrides.secondary_color);
102
+ }
103
+ }
104
+ if (overrides.autumn_tint !== undefined) this.autumn_tint = overrides.autumn_tint;
105
+ if (overrides.leaf_shape !== undefined) this.leaf_shape = overrides.leaf_shape;
106
+ if (overrides.leaflets_per_cluster !== undefined) this.leaflets_per_cluster = Math.max(1, overrides.leaflets_per_cluster | 0);
107
+ if (overrides.roughness !== undefined) this.roughness = overrides.roughness;
108
+ if (overrides.vein_strength !== undefined) this.vein_strength = overrides.vein_strength;
109
+ if (overrides.stem_anchor_u !== undefined) this.stem_anchor_u = overrides.stem_anchor_u;
110
+ if (overrides.stem_anchor_v !== undefined) this.stem_anchor_v = overrides.stem_anchor_v;
111
+ return this;
112
+ }
113
+
114
+ /**
115
+ * @param {FoliageMaterialConfig} other
116
+ * @returns {this}
117
+ */
118
+ copy(other) {
119
+ assert.defined(other, 'other');
120
+ this.resolution = other.resolution;
121
+ this.primary_color.copy(other.primary_color);
122
+ this.secondary_color.copy(other.secondary_color);
123
+ this.autumn_tint = other.autumn_tint;
124
+ this.leaf_shape = other.leaf_shape;
125
+ this.leaflets_per_cluster = other.leaflets_per_cluster;
126
+ this.roughness = other.roughness;
127
+ this.vein_strength = other.vein_strength;
128
+ this.stem_anchor_u = other.stem_anchor_u;
129
+ this.stem_anchor_v = other.stem_anchor_v;
130
+ return this;
131
+ }
132
+
133
+ /**
134
+ * @returns {FoliageMaterialConfig}
135
+ */
136
+ clone() {
137
+ const r = new FoliageMaterialConfig();
138
+ r.copy(this);
139
+ return r;
140
+ }
141
+
142
+ /**
143
+ * @param {FoliageMaterialConfig} other
144
+ * @returns {boolean}
145
+ */
146
+ equals(other) {
147
+ if (this === other) return true;
148
+ if (!other || !other.isFoliageMaterialConfig) return false;
149
+ return this.resolution === other.resolution
150
+ && this.primary_color.equals(other.primary_color)
151
+ && this.secondary_color.equals(other.secondary_color)
152
+ && this.autumn_tint === other.autumn_tint
153
+ && this.leaf_shape === other.leaf_shape
154
+ && this.leaflets_per_cluster === other.leaflets_per_cluster
155
+ && this.roughness === other.roughness
156
+ && this.vein_strength === other.vein_strength
157
+ && this.stem_anchor_u === other.stem_anchor_u
158
+ && this.stem_anchor_v === other.stem_anchor_v;
159
+ }
160
+
161
+ /**
162
+ * @returns {number}
163
+ */
164
+ hash() {
165
+ let h = hash_mix2(this.resolution, this.primary_color.hash());
166
+ h = hash_mix2(h, this.secondary_color.hash());
167
+ h = hash_mix2(h, computeHashFloat(this.autumn_tint));
168
+ h = hash_mix2(h, computeStringHash(this.leaf_shape));
169
+ h = hash_mix2(h, this.leaflets_per_cluster);
170
+ h = hash_mix2(h, computeHashFloat(this.roughness));
171
+ h = hash_mix2(h, computeHashFloat(this.stem_anchor_u));
172
+ h = hash_mix2(h, computeHashFloat(this.stem_anchor_v));
173
+ return h;
174
+ }
175
+ }
176
+
177
+ /**
178
+ * @readonly
179
+ * @type {boolean}
180
+ */
181
+ FoliageMaterialConfig.prototype.isFoliageMaterialConfig = true;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Botanical phyllotaxis arrangement modes for axillary buds, lateral branches, and leaf clusters.
3
+ */
4
+ export type PhyllotaxisMode = number;
5
+ export namespace PhyllotaxisMode {
6
+ let SpiralGolden: number;
7
+ let AlternateDistichous: number;
8
+ let Tristichous: number;
9
+ let Opposite: number;
10
+ let OppositeDecussate: number;
11
+ let Whorled: number;
12
+ }
13
+ //# sourceMappingURL=PhyllotaxisMode.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PhyllotaxisMode.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/PhyllotaxisMode.js"],"names":[],"mappings":";;;8BAIU,MAAM"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Botanical phyllotaxis arrangement modes for axillary buds, lateral branches, and leaf clusters.
3
+ *
4
+ * @readonly
5
+ * @enum {number}
6
+ */
7
+ export const PhyllotaxisMode = {
8
+ /** Fibonacci golden angle (~137.507764 degrees), 1 organ per node */
9
+ SpiralGolden: 0,
10
+ /** Alternate 2-ranked (180 degrees), 1 organ per node */
11
+ AlternateDistichous: 1,
12
+ /** 3-ranked (120 degrees), 1 organ per node */
13
+ Tristichous: 2,
14
+ /** Superposed opposite pairs (0, 180 degrees), 2 organs per node */
15
+ Opposite: 3,
16
+ /** Alternating opposite pairs (rotates 90 degrees each node), 2 organs per node */
17
+ OppositeDecussate: 4,
18
+ /** M-verticillate ring around node with half-step alternation, M >= 3 organs per node */
19
+ Whorled: 5,
20
+ };
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Level-of-Detail (LOD) decimation and area-compensation configuration.
3
+ */
4
+ export class TreeLODConfig {
5
+ /**
6
+ * @param {Partial<TreeLODConfig>} [options]
7
+ * @returns {TreeLODConfig}
8
+ */
9
+ static from(options?: Partial<TreeLODConfig>): TreeLODConfig;
10
+ /**
11
+ * Creates a default sequence of progressive LOD configurations.
12
+ * @param {number} [lod_count=3]
13
+ * @returns {TreeLODConfig[]}
14
+ */
15
+ static createDefaultChain(lod_count?: number): TreeLODConfig[];
16
+ /**
17
+ * LOD index (0 = highest detail).
18
+ * @type {number}
19
+ */
20
+ level: number;
21
+ /**
22
+ * Multiplier in (0, 1] applied to radial ring segment counts (clamped >= 3).
23
+ * @type {number}
24
+ */
25
+ radial_scale: number;
26
+ /**
27
+ * Multiplier in (0, 1] applied to longitudinal Hermite spine subdivisions (clamped >= 1).
28
+ * @type {number}
29
+ */
30
+ longitudinal_scale: number;
31
+ /**
32
+ * Maximum branch recursion level retained in this LOD.
33
+ * @type {number}
34
+ */
35
+ max_branch_level: number;
36
+ /**
37
+ * Minimum branch base radius (meters) retained in this LOD.
38
+ * @type {number}
39
+ */
40
+ min_branch_radius: number;
41
+ /**
42
+ * Fraction in [0, 1] of foliage attachments retained via golden-ratio low-discrepancy rank.
43
+ * @type {number}
44
+ */
45
+ foliage_keep_ratio: number;
46
+ /**
47
+ * Area-compensation exponent eta in [0, 0.5]: remaining cards scale by `keep_ratio^(-eta)`
48
+ * so optical canopy density stays invariant across LOD transitions.
49
+ * @type {number}
50
+ */
51
+ foliage_area_compensation_exponent: number;
52
+ /**
53
+ * If true, complex cards (`TriStarCluster`, `RibbedFrond`, `OctagonalCutoutHull`) collapse
54
+ * to simpler low-triangle `FoldedVCard` or single quad representations.
55
+ * @type {boolean}
56
+ */
57
+ simplify_cards: boolean;
58
+ /**
59
+ * @param {Partial<TreeLODConfig>} [overrides]
60
+ * @returns {this}
61
+ */
62
+ applyOverrides(overrides?: Partial<TreeLODConfig>): this;
63
+ /**
64
+ * @param {TreeLODConfig} other
65
+ * @returns {this}
66
+ */
67
+ copy(other: TreeLODConfig): this;
68
+ /**
69
+ * @returns {TreeLODConfig}
70
+ */
71
+ clone(): TreeLODConfig;
72
+ /**
73
+ * @param {TreeLODConfig} other
74
+ * @returns {boolean}
75
+ */
76
+ equals(other: TreeLODConfig): boolean;
77
+ /**
78
+ * @returns {number}
79
+ */
80
+ hash(): number;
81
+ /**
82
+ * @readonly
83
+ * @type {boolean}
84
+ */
85
+ readonly isTreeLODConfig: boolean;
86
+ }
87
+ //# sourceMappingURL=TreeLODConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TreeLODConfig.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/TreeLODConfig.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IAmDI;;;OAGG;IACH,sBAHW,QAAQ,aAAa,CAAC,GACpB,aAAa,CAMzB;IAED;;;;OAIG;IACH,sCAHW,MAAM,GACJ,aAAa,EAAE,CAuD3B;IAtHD;;;OAGG;IACH,OAFU,MAAM,CAEN;IAEV;;;OAGG;IACH,cAFU,MAAM,CAEG;IAEnB;;;OAGG;IACH,oBAFU,MAAM,CAES;IAEzB;;;OAGG;IACH,kBAFU,MAAM,CAEK;IAErB;;;OAGG;IACH,mBAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,oBAFU,MAAM,CAES;IAEzB;;;;OAIG;IACH,oCAFU,MAAM,CAE0B;IAE1C;;;;OAIG;IACH,gBAFU,OAAO,CAEM;IAwEvB;;;OAGG;IACH,2BAHW,QAAQ,aAAa,CAAC,GACpB,IAAI,CAiBhB;IAED;;;OAGG;IACH,YAHW,aAAa,GACX,IAAI,CAahB;IAED;;OAEG;IACH,SAFa,aAAa,CAMzB;IAED;;;OAGG;IACH,cAHW,aAAa,GACX,OAAO,CAanB;IAED;;OAEG;IACH,QAFa,MAAM,CAUlB;IAGL;;;OAGG;IACH,0BAFU,OAAO,CAEsB;CANtC"}
@@ -0,0 +1,211 @@
1
+ import { assert } from "../../../core/assert.js";
2
+ import { hash_mix2 } from "../../../core/math/hash/hash_mix2.js";
3
+ import { computeHashFloat } from "../../../core/primitives/numbers/computeHashFloat.js";
4
+
5
+ /**
6
+ * Level-of-Detail (LOD) decimation and area-compensation configuration.
7
+ */
8
+ export class TreeLODConfig {
9
+ /**
10
+ * LOD index (0 = highest detail).
11
+ * @type {number}
12
+ */
13
+ level = 0;
14
+
15
+ /**
16
+ * Multiplier in (0, 1] applied to radial ring segment counts (clamped >= 3).
17
+ * @type {number}
18
+ */
19
+ radial_scale = 1.0;
20
+
21
+ /**
22
+ * Multiplier in (0, 1] applied to longitudinal Hermite spine subdivisions (clamped >= 1).
23
+ * @type {number}
24
+ */
25
+ longitudinal_scale = 1.0;
26
+
27
+ /**
28
+ * Maximum branch recursion level retained in this LOD.
29
+ * @type {number}
30
+ */
31
+ max_branch_level = 3;
32
+
33
+ /**
34
+ * Minimum branch base radius (meters) retained in this LOD.
35
+ * @type {number}
36
+ */
37
+ min_branch_radius = 0.0;
38
+
39
+ /**
40
+ * Fraction in [0, 1] of foliage attachments retained via golden-ratio low-discrepancy rank.
41
+ * @type {number}
42
+ */
43
+ foliage_keep_ratio = 1.0;
44
+
45
+ /**
46
+ * Area-compensation exponent eta in [0, 0.5]: remaining cards scale by `keep_ratio^(-eta)`
47
+ * so optical canopy density stays invariant across LOD transitions.
48
+ * @type {number}
49
+ */
50
+ foliage_area_compensation_exponent = 0.42;
51
+
52
+ /**
53
+ * If true, complex cards (`TriStarCluster`, `RibbedFrond`, `OctagonalCutoutHull`) collapse
54
+ * to simpler low-triangle `FoldedVCard` or single quad representations.
55
+ * @type {boolean}
56
+ */
57
+ simplify_cards = false;
58
+
59
+ /**
60
+ * @param {Partial<TreeLODConfig>} [options]
61
+ * @returns {TreeLODConfig}
62
+ */
63
+ static from(options = {}) {
64
+ const r = new TreeLODConfig();
65
+ r.applyOverrides(options);
66
+ return r;
67
+ }
68
+
69
+ /**
70
+ * Creates a default sequence of progressive LOD configurations.
71
+ * @param {number} [lod_count=3]
72
+ * @returns {TreeLODConfig[]}
73
+ */
74
+ static createDefaultChain(lod_count = 3) {
75
+ const count = Math.max(1, lod_count | 0);
76
+ const presets = [
77
+ {
78
+ level: 0,
79
+ radial_scale: 1.0,
80
+ longitudinal_scale: 1.0,
81
+ max_branch_level: 3,
82
+ min_branch_radius: 0.0,
83
+ foliage_keep_ratio: 1.0,
84
+ foliage_area_compensation_exponent: 0.42,
85
+ simplify_cards: false
86
+ },
87
+ {
88
+ level: 1,
89
+ radial_scale: 0.65,
90
+ longitudinal_scale: 0.7,
91
+ max_branch_level: 2,
92
+ min_branch_radius: 0.015,
93
+ foliage_keep_ratio: 0.55,
94
+ foliage_area_compensation_exponent: 0.42,
95
+ simplify_cards: false
96
+ },
97
+ {
98
+ level: 2,
99
+ radial_scale: 0.45,
100
+ longitudinal_scale: 0.5,
101
+ max_branch_level: 1,
102
+ min_branch_radius: 0.035,
103
+ foliage_keep_ratio: 0.28,
104
+ foliage_area_compensation_exponent: 0.44,
105
+ simplify_cards: true
106
+ },
107
+ {
108
+ level: 3,
109
+ radial_scale: 0.35,
110
+ longitudinal_scale: 0.35,
111
+ max_branch_level: 1,
112
+ min_branch_radius: 0.06,
113
+ foliage_keep_ratio: 0.15,
114
+ foliage_area_compensation_exponent: 0.46,
115
+ simplify_cards: true
116
+ }
117
+ ];
118
+
119
+ const result = [];
120
+ for (let i = 0; i < count; i++) {
121
+ const template = presets[Math.min(i, presets.length - 1)];
122
+ const cfg = TreeLODConfig.from(template);
123
+ cfg.level = i;
124
+ result.push(cfg);
125
+ }
126
+ return result;
127
+ }
128
+
129
+ /**
130
+ * @param {Partial<TreeLODConfig>} [overrides]
131
+ * @returns {this}
132
+ */
133
+ applyOverrides(overrides = {}) {
134
+ if (overrides === null || overrides === undefined) {
135
+ return this;
136
+ }
137
+ if (overrides.level !== undefined) this.level = overrides.level | 0;
138
+ if (overrides.radial_scale !== undefined) this.radial_scale = overrides.radial_scale;
139
+ if (overrides.longitudinal_scale !== undefined) this.longitudinal_scale = overrides.longitudinal_scale;
140
+ if (overrides.max_branch_level !== undefined) this.max_branch_level = overrides.max_branch_level | 0;
141
+ if (overrides.min_branch_radius !== undefined) this.min_branch_radius = overrides.min_branch_radius;
142
+ if (overrides.foliage_keep_ratio !== undefined) this.foliage_keep_ratio = overrides.foliage_keep_ratio;
143
+ if (overrides.foliage_area_compensation_exponent !== undefined) {
144
+ this.foliage_area_compensation_exponent = overrides.foliage_area_compensation_exponent;
145
+ }
146
+ if (overrides.simplify_cards !== undefined) this.simplify_cards = Boolean(overrides.simplify_cards);
147
+ return this;
148
+ }
149
+
150
+ /**
151
+ * @param {TreeLODConfig} other
152
+ * @returns {this}
153
+ */
154
+ copy(other) {
155
+ assert.defined(other, 'other');
156
+ this.level = other.level;
157
+ this.radial_scale = other.radial_scale;
158
+ this.longitudinal_scale = other.longitudinal_scale;
159
+ this.max_branch_level = other.max_branch_level;
160
+ this.min_branch_radius = other.min_branch_radius;
161
+ this.foliage_keep_ratio = other.foliage_keep_ratio;
162
+ this.foliage_area_compensation_exponent = other.foliage_area_compensation_exponent;
163
+ this.simplify_cards = other.simplify_cards;
164
+ return this;
165
+ }
166
+
167
+ /**
168
+ * @returns {TreeLODConfig}
169
+ */
170
+ clone() {
171
+ const r = new TreeLODConfig();
172
+ r.copy(this);
173
+ return r;
174
+ }
175
+
176
+ /**
177
+ * @param {TreeLODConfig} other
178
+ * @returns {boolean}
179
+ */
180
+ equals(other) {
181
+ if (this === other) return true;
182
+ if (!other || !other.isTreeLODConfig) return false;
183
+ return this.level === other.level
184
+ && this.radial_scale === other.radial_scale
185
+ && this.longitudinal_scale === other.longitudinal_scale
186
+ && this.max_branch_level === other.max_branch_level
187
+ && this.min_branch_radius === other.min_branch_radius
188
+ && this.foliage_keep_ratio === other.foliage_keep_ratio
189
+ && this.foliage_area_compensation_exponent === other.foliage_area_compensation_exponent
190
+ && this.simplify_cards === other.simplify_cards;
191
+ }
192
+
193
+ /**
194
+ * @returns {number}
195
+ */
196
+ hash() {
197
+ let h = hash_mix2(this.level, this.max_branch_level);
198
+ h = hash_mix2(h, computeHashFloat(this.radial_scale));
199
+ h = hash_mix2(h, computeHashFloat(this.longitudinal_scale));
200
+ h = hash_mix2(h, computeHashFloat(this.min_branch_radius));
201
+ h = hash_mix2(h, computeHashFloat(this.foliage_keep_ratio));
202
+ h = hash_mix2(h, this.simplify_cards ? 1 : 0);
203
+ return h;
204
+ }
205
+ }
206
+
207
+ /**
208
+ * @readonly
209
+ * @type {boolean}
210
+ */
211
+ TreeLODConfig.prototype.isTreeLODConfig = true;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Built-in turn-key tree & foliage species presets.
3
+ */
4
+ export type TreePreset = string;
5
+ export namespace TreePreset {
6
+ let Oak: string;
7
+ let Pine: string;
8
+ let Birch: string;
9
+ let Willow: string;
10
+ let Maple: string;
11
+ let Spruce: string;
12
+ let Palm: string;
13
+ let Shrub: string;
14
+ let Fern: string;
15
+ }
16
+ //# sourceMappingURL=TreePreset.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TreePreset.d.ts","sourceRoot":"","sources":["../../../../../src/generation/foliage/config/TreePreset.js"],"names":[],"mappings":";;;yBAIU,MAAM"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Built-in turn-key tree & foliage species presets.
3
+ *
4
+ * @readonly
5
+ * @enum {string}
6
+ */
7
+ export const TreePreset = {
8
+ Oak: "oak",
9
+ Pine: "pine",
10
+ Birch: "birch",
11
+ Willow: "willow",
12
+ Maple: "maple",
13
+ Spruce: "spruce",
14
+ Palm: "palm",
15
+ Shrub: "shrub",
16
+ Fern: "fern",
17
+ };