create-threenative 0.2.5 → 0.2.7

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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,278 @@
1
+ // Generated for you: the complete water appearance is editable here, not hidden in core.
2
+ import {
3
+ DataTexture,
4
+ DataUtils,
5
+ HalfFloatType,
6
+ LinearFilter,
7
+ Mesh,
8
+ PlaneGeometry,
9
+ RGBAFormat,
10
+ Vector2,
11
+ Vector3,
12
+ } from "three";
13
+ import {
14
+ cameraPosition,
15
+ cameraProjectionMatrixInverse,
16
+ cameraWorldMatrix,
17
+ clamp,
18
+ dFdx,
19
+ dFdy,
20
+ float,
21
+ getViewPosition,
22
+ mix,
23
+ positionLocal,
24
+ positionWorld,
25
+ screenUV,
26
+ select,
27
+ texture,
28
+ transformNormalToView,
29
+ uniform,
30
+ vec2,
31
+ vec3,
32
+ vec4,
33
+ viewportDepthTexture,
34
+ } from "three/tsl";
35
+ import { MeshBasicNodeMaterial } from "three/webgpu";
36
+ import type { Node, StorageBufferNode } from "three/webgpu";
37
+ import { DisposalScope } from "../clearwaterLifetime.js";
38
+ import { createClearwaterCaustics } from "./clearwaterCaustics.js";
39
+ import { beerLambert, dielectricFresnel } from "./clearwaterOptics.js";
40
+ import type { IResolvedClearwaterOptions } from "./clearwaterOptions.js";
41
+
42
+ /** Structural inputs keep generated render code independent of framework imports. */
43
+ export interface IClearwaterOceanSource {
44
+ readonly resolution: number;
45
+ readonly cascades: readonly { readonly patchSize: number }[];
46
+ cascadePatchSize(index: number): number;
47
+ cascadeDisplacement(index: number): StorageBufferNode<"vec4">;
48
+ }
49
+ export interface IClearwaterRippleSource {
50
+ readonly resolution: number;
51
+ readonly size: number;
52
+ readonly dx: number;
53
+ readonly centerX: number;
54
+ readonly centerZ: number;
55
+ readonly version: number;
56
+ readonly height: Float32Array;
57
+ }
58
+ export interface IClearwaterSurfaceSource {
59
+ reflectionAt(offset?: Node<"vec2">): Node<"vec3">;
60
+ refractionAt(offset?: Node<"vec2">): Node<"vec3">;
61
+ thicknessAt(offset?: Node<"vec2">): Node<"float">;
62
+ }
63
+
64
+ export function createClearwaterAppearance(
65
+ ocean: IClearwaterOceanSource,
66
+ ripples: IClearwaterRippleSource,
67
+ surface: IClearwaterSurfaceSource,
68
+ options: IResolvedClearwaterOptions,
69
+ ) {
70
+ const scope = new DisposalScope();
71
+ try {
72
+ const level = uniform(options.level);
73
+ const sunDirection = uniform(new Vector3(...options.sunDirection));
74
+ const rippleCenter = uniform(new Vector2(ripples.centerX, ripples.centerZ));
75
+ const pixels = new Uint16Array(ripples.resolution * ripples.resolution * 4);
76
+ const rippleTexture = new DataTexture(
77
+ pixels,
78
+ ripples.resolution,
79
+ ripples.resolution,
80
+ RGBAFormat,
81
+ HalfFloatType,
82
+ );
83
+ rippleTexture.minFilter = LinearFilter;
84
+ rippleTexture.magFilter = LinearFilter;
85
+ rippleTexture.generateMipmaps = false;
86
+ rippleTexture.needsUpdate = true;
87
+ scope.defer(() => rippleTexture.dispose());
88
+ const rippleImage = texture(rippleTexture);
89
+ let uploadedVersion = -1;
90
+
91
+ function rippleAt(xz: Node<"vec2">): Node<"vec4"> {
92
+ const uv = xz.sub(rippleCenter).div(ripples.size).add(0.5);
93
+ const edge = uv.min(uv.oneMinus());
94
+ const inside = edge.x.min(edge.y).smoothstep(0, 2 / ripples.resolution);
95
+ // Core stores endpoint samples, not texel-centre samples. Match its CPU heightAt convention.
96
+ const sampleUV = uv
97
+ .mul((ripples.resolution - 1) / ripples.resolution)
98
+ .add(0.5 / ripples.resolution);
99
+ return rippleImage.sample(sampleUV.clamp(0, 1)).level(float(0)).mul(inside);
100
+ }
101
+ function waveHeight(xz: Node<"vec2">): Node<"float"> {
102
+ let height: Node<"float"> = float(0);
103
+ const grid = float(ocean.resolution);
104
+ for (let index = 0; index < ocean.cascades.length; index += 1) {
105
+ const p = xz.div(ocean.cascadePatchSize(index)).mul(grid);
106
+ const base = p.floor();
107
+ const f = p.sub(base);
108
+ const buffer = ocean.cascadeDisplacement(index);
109
+ const wrap = (v: Node<"float">) => v.mod(grid).add(grid).mod(grid);
110
+ const read = (x: Node<"float">, z: Node<"float">) =>
111
+ buffer.element(wrap(z).mul(grid).add(wrap(x)).toUint()).y;
112
+ const near = mix(read(base.x, base.y), read(base.x.add(1), base.y), f.x);
113
+ const far = mix(read(base.x, base.y.add(1)), read(base.x.add(1), base.y.add(1)), f.x);
114
+ height = height.add(mix(near, far, f.y));
115
+ }
116
+ return height;
117
+ }
118
+ const step = Math.min(...ocean.cascades.map((cascade) => cascade.patchSize)) / ocean.resolution;
119
+ const field = {
120
+ heightAt(xz: Node<"vec2">): Node<"float"> {
121
+ return waveHeight(xz).add(rippleAt(xz).x);
122
+ },
123
+ normalAt(xz: Node<"vec2">): Node<"vec3"> {
124
+ const ripple = rippleAt(xz);
125
+ const dx = waveHeight(xz.add(vec2(step, 0)))
126
+ .sub(waveHeight(xz.sub(vec2(step, 0))))
127
+ .div(2 * step)
128
+ .add(ripple.y);
129
+ const dz = waveHeight(xz.add(vec2(0, step)))
130
+ .sub(waveHeight(xz.sub(vec2(0, step))))
131
+ .div(2 * step)
132
+ .add(ripple.z);
133
+ return vec3(dx.negate(), 1, dz.negate()).normalize();
134
+ },
135
+ };
136
+ const caustics = options.caustics
137
+ ? createClearwaterCaustics(field, level, sunDirection, options)
138
+ : undefined;
139
+ if (caustics !== undefined) scope.defer(() => caustics.dispose());
140
+ const geometry = new PlaneGeometry(
141
+ options.size,
142
+ options.size,
143
+ options.segments,
144
+ options.segments,
145
+ );
146
+ geometry.rotateX(-Math.PI / 2);
147
+ geometry.translate(options.center[0], 0, options.center[1]);
148
+ scope.defer(() => geometry.dispose());
149
+ // Transparent is required for the opaque colour/depth snapshot, despite final alpha being one.
150
+ const material = new MeshBasicNodeMaterial({
151
+ transparent: true,
152
+ depthWrite: false,
153
+ opacity: 1,
154
+ });
155
+ scope.defer(() => material.dispose());
156
+ material.positionNode = vec3(
157
+ positionLocal.x,
158
+ level.add(field.heightAt(positionLocal.xz)),
159
+ positionLocal.z,
160
+ );
161
+ const normal = field.normalAt(positionWorld.xz);
162
+ const view = cameraPosition.sub(positionWorld).normalize();
163
+ const normalView = transformNormalToView(normal);
164
+ const proposedOffset = normalView.xy.mul(options.distortion);
165
+ const offset = select(
166
+ surface.thicknessAt(proposedOffset).greaterThan(0),
167
+ proposedOffset,
168
+ vec2(0),
169
+ );
170
+ const uv = clamp(screenUV.add(offset), vec2(0), vec2(1));
171
+ const behind = getViewPosition(uv, viewportDepthTexture(uv), cameraProjectionMatrixInverse);
172
+ const receiver = cameraWorldMatrix.mul(vec4(behind, 1)).xyz;
173
+ const verticalDepth = level.sub(receiver.y).max(0);
174
+ // View-space depth difference alone under-attenuates at oblique angles. Use reconstructed metres.
175
+ const pathLength = receiver
176
+ .sub(positionWorld)
177
+ .length()
178
+ .min(options.depth * 12);
179
+ const extinction = options.absorption.map((a, index) => a + (options.scattering[index] ?? 0));
180
+ const transmittance = vec3(
181
+ beerLambert(pathLength, extinction[0] ?? 0),
182
+ beerLambert(pathLength, extinction[1] ?? 0),
183
+ beerLambert(pathLength, extinction[2] ?? 0),
184
+ );
185
+ let floorLight: Node<"vec3"> = surface.refractionAt(offset);
186
+ if (caustics !== undefined) {
187
+ // The ray grid is focused at one depth. Fade its approximation away from that receiver plane.
188
+ const depthConfidence = float(1)
189
+ .sub(verticalDepth.sub(options.depth).abs().div(options.depth))
190
+ .clamp(0, 1);
191
+ floorLight = floorLight.mul(
192
+ mix(vec3(1), caustics.at(receiver.xz), depthConfidence.mul(options.causticsStrength)),
193
+ );
194
+ }
195
+ const singleScatter = vec3(
196
+ options.scattering[0] / Math.max(extinction[0] ?? 0, 1e-6),
197
+ options.scattering[1] / Math.max(extinction[1] ?? 0, 1e-6),
198
+ options.scattering[2] / Math.max(extinction[2] ?? 0, 1e-6),
199
+ )
200
+ .mul(transmittance.oneMinus())
201
+ .mul(vec3(...options.sunColor))
202
+ .mul(0.08);
203
+ const under = floorLight.mul(transmittance).add(singleScatter);
204
+ const facing = normal.dot(view).max(0.001);
205
+ const fresnel = dielectricFresnel(facing, options.ior);
206
+ // Reflection-off is an explicit performance/appearance choice, not a fake sky texture.
207
+ const reflected = options.reflection
208
+ ? surface.reflectionAt(normalView.xy.mul(options.distortion))
209
+ : vec3(0.11, 0.27, 0.62);
210
+ const half = view.add(sunDirection).normalize();
211
+ const nh = normal.dot(half).clamp(0.001, 1);
212
+ const nl = normal.dot(sunDirection).max(0);
213
+ // Screen derivatives widen glints at distance rather than aliasing into single-pixel fireflies.
214
+ const variance = dFdx(normal).length().pow(2).add(dFdy(normal).length().pow(2));
215
+ const a2 = variance.mul(1.2).add(0.00012).min(1);
216
+ const cos2 = nh.mul(nh);
217
+ const tan2 = cos2.oneMinus().div(cos2);
218
+ const distribution = tan2
219
+ .negate()
220
+ .div(a2)
221
+ .exp()
222
+ .div(a2.mul(Math.PI).mul(cos2.mul(cos2)));
223
+ const visibility = float(0.5).div(
224
+ nl
225
+ .mul(facing.mul(facing).mul(a2.oneMinus()).add(a2).sqrt())
226
+ .add(facing.mul(nl.mul(nl).mul(a2.oneMinus()).add(a2).sqrt()))
227
+ .add(0.00001),
228
+ );
229
+ const specular = distribution
230
+ .mul(visibility)
231
+ .mul(dielectricFresnel(half.dot(view), options.ior))
232
+ .mul(nl)
233
+ .min(12000);
234
+ material.colorNode = mix(under, reflected, fresnel).add(
235
+ vec3(...options.sunColor).mul(specular),
236
+ );
237
+ const mesh = new Mesh(geometry, material);
238
+ mesh.name = "clearwater-surface";
239
+ mesh.frustumCulled = false;
240
+ mesh.renderOrder = 1;
241
+ return {
242
+ mesh,
243
+ material,
244
+ level,
245
+ sunDirection,
246
+ caustics,
247
+ uploadRipples(): void {
248
+ if (scope.disposed) return;
249
+ rippleCenter.value.set(ripples.centerX, ripples.centerZ);
250
+ if (uploadedVersion === ripples.version) return;
251
+ const n = ripples.resolution;
252
+ for (let z = 0; z < n; z += 1)
253
+ for (let x = 0; x < n; x += 1) {
254
+ const i = z * n + x;
255
+ const west = ripples.height[z * n + Math.max(0, x - 1)] ?? 0;
256
+ const east = ripples.height[z * n + Math.min(n - 1, x + 1)] ?? 0;
257
+ const north = ripples.height[Math.min(n - 1, z + 1) * n + x] ?? 0;
258
+ const south = ripples.height[Math.max(0, z - 1) * n + x] ?? 0;
259
+ pixels[i * 4] = DataUtils.toHalfFloat(ripples.height[i] ?? 0);
260
+ pixels[i * 4 + 1] = DataUtils.toHalfFloat((east - west) / (2 * ripples.dx));
261
+ pixels[i * 4 + 2] = DataUtils.toHalfFloat((north - south) / (2 * ripples.dx));
262
+ }
263
+ rippleTexture.needsUpdate = true;
264
+ uploadedVersion = ripples.version;
265
+ },
266
+ dispose(): void {
267
+ scope.dispose();
268
+ },
269
+ };
270
+ } catch (error) {
271
+ try {
272
+ scope.dispose();
273
+ } catch {
274
+ /* Preserve the construction error. */
275
+ }
276
+ throw error;
277
+ }
278
+ }
@@ -0,0 +1,138 @@
1
+ // Refracted-grid caustics adapted from Clearwater, MIT (Lumaris 2026).
2
+ // See CLEARWATER-LICENSE.txt. No WebGL handles, DOM, extra animation loop or asset fetches.
3
+ import {
4
+ AdditiveBlending,
5
+ Color,
6
+ DoubleSide,
7
+ HalfFloatType,
8
+ LinearFilter,
9
+ Mesh,
10
+ OrthographicCamera,
11
+ PlaneGeometry,
12
+ RenderTarget,
13
+ Scene,
14
+ } from "three";
15
+ import {
16
+ attribute,
17
+ dFdx,
18
+ dFdy,
19
+ float,
20
+ mix,
21
+ refract,
22
+ texture,
23
+ varying,
24
+ vec2,
25
+ vec3,
26
+ vec4,
27
+ } from "three/tsl";
28
+ import { MeshBasicNodeMaterial } from "three/webgpu";
29
+ import type { Node, WebGPURenderer } from "three/webgpu";
30
+ import { DisposalScope } from "../clearwaterLifetime.js";
31
+ import type { IResolvedClearwaterOptions } from "./clearwaterOptions.js";
32
+ import { withClearwaterTarget } from "./clearwaterPass.js";
33
+
34
+ export interface IClearwaterHeightSource {
35
+ heightAt(xz: Node<"vec2">): Node<"float">;
36
+ normalAt(xz: Node<"vec2">): Node<"vec3">;
37
+ }
38
+
39
+ /** A finite ray grid: caustics are transported from the same waves/ripples as the surface. */
40
+ export function createClearwaterCaustics(
41
+ field: IClearwaterHeightSource,
42
+ level: Node<"float">,
43
+ sun: Node<"vec3">,
44
+ options: IResolvedClearwaterOptions,
45
+ ) {
46
+ const scope = new DisposalScope();
47
+ try {
48
+ const target = new RenderTarget(options.causticsResolution, options.causticsResolution, {
49
+ type: HalfFloatType,
50
+ minFilter: LinearFilter,
51
+ magFilter: LinearFilter,
52
+ depthBuffer: false,
53
+ stencilBuffer: false,
54
+ generateMipmaps: false,
55
+ });
56
+ target.texture.name = "clearwater-caustic-flux";
57
+ scope.defer(() => target.dispose());
58
+ const geometry = new PlaneGeometry(
59
+ options.size,
60
+ options.size,
61
+ options.causticsSegments,
62
+ options.causticsSegments,
63
+ );
64
+ scope.defer(() => geometry.dispose());
65
+ const scene = new Scene();
66
+ // WebGPURenderer still requires a projection-capable camera even though vertexNode emits clip space.
67
+ const camera = new OrthographicCamera(-1, 1, 1, -1, 0, 1);
68
+ const center = vec2(options.center[0], options.center[1]);
69
+ const sourceXZ = attribute<"vec3">("position", "vec3").xy.add(center);
70
+ const sourcePosition = vec3(sourceXZ.x, level.add(field.heightAt(sourceXZ)), sourceXZ.y);
71
+ const normal = field.normalAt(sourceXZ);
72
+ const rayOrigin = varying(sourceXZ);
73
+ const dx = dFdx(rayOrigin);
74
+ const dy = dFdy(rayOrigin);
75
+ // The inverse mapping's Jacobian measures incoming area per receiving pixel.
76
+ // A flat, unperturbed surface is exactly one, independent of texture or grid resolution.
77
+ const flux = dx.x
78
+ .mul(dy.y)
79
+ .sub(dx.y.mul(dy.x))
80
+ .abs()
81
+ .mul((options.causticsResolution / options.size) ** 2)
82
+ .min(40);
83
+ const masks = [vec3(1, 0, 0), vec3(0, 1, 0), vec3(0, 0, 1)];
84
+ const dispersion = [-0.002, 0, 0.003];
85
+ for (let channel = 0; channel < 3; channel += 1) {
86
+ const material = new MeshBasicNodeMaterial({
87
+ transparent: true,
88
+ blending: AdditiveBlending,
89
+ side: DoubleSide,
90
+ depthTest: false,
91
+ depthWrite: false,
92
+ toneMapped: false,
93
+ fog: false,
94
+ });
95
+ scope.defer(() => material.dispose());
96
+ const ior = Math.max(1.0001, options.ior + (dispersion[channel] ?? 0));
97
+ const ray = refract(sun.negate(), normal, float(1 / ior));
98
+ const distance = level.sub(options.depth).sub(sourcePosition.y).div(ray.y.min(-0.001)).max(0);
99
+ const focus = sourcePosition.add(ray.mul(distance)).xz.sub(center).div(options.size);
100
+ material.vertexNode = vec4(focus.mul(2), 0.5, 1);
101
+ material.fragmentNode = vec4((masks[channel] ?? masks[0] ?? vec3(1, 0, 0)).mul(flux), 1);
102
+ const mesh = new Mesh(geometry, material);
103
+ mesh.frustumCulled = false;
104
+ scene.add(mesh);
105
+ }
106
+ const image = texture(target.texture);
107
+ const black = new Color(0);
108
+ const previousColor = new Color();
109
+ return {
110
+ texture: target.texture,
111
+ scene,
112
+ camera,
113
+ at(xz: Node<"vec2">): Node<"vec3"> {
114
+ const uv = xz.sub(center).div(options.size).add(0.5);
115
+ const edge = uv.min(uv.oneMinus());
116
+ const inside = edge.x.min(edge.y).smoothstep(0, 0.025);
117
+ // A finite receiver is not RepeatWrapping: local interaction must not tile across the sea.
118
+ return mix(vec3(1), image.sample(uv.clamp(0, 1)).rgb, inside);
119
+ },
120
+ render(renderer: WebGPURenderer): void {
121
+ if (scope.disposed) return;
122
+ withClearwaterTarget(renderer, target, black, previousColor, () =>
123
+ renderer.render(scene, camera),
124
+ );
125
+ },
126
+ dispose(): void {
127
+ scope.dispose();
128
+ },
129
+ };
130
+ } catch (error) {
131
+ try {
132
+ scope.dispose();
133
+ } catch {
134
+ /* Keep the construction failure as the primary error. */
135
+ }
136
+ throw error;
137
+ }
138
+ }
@@ -0,0 +1,65 @@
1
+ import {
2
+ BoxGeometry,
3
+ type Camera,
4
+ Color,
5
+ DirectionalLight,
6
+ HemisphereLight,
7
+ Mesh,
8
+ MeshStandardMaterial,
9
+ PlaneGeometry,
10
+ type Scene,
11
+ } from "three";
12
+ import { DisposalScope } from "../clearwaterLifetime.js";
13
+
14
+ /** Real opaque receivers: their colour/depth is what the water refracts, not a baked demo texture. */
15
+ export function setupClearwaterDemo(scene: Scene, camera: Camera): () => void {
16
+ const scope = new DisposalScope();
17
+ const previousBackground = scene.background;
18
+ scene.background = new Color(0x9bbacc);
19
+ scope.defer(() => {
20
+ scene.background = previousBackground;
21
+ });
22
+ camera.position.set(5, 4, 7);
23
+ camera.lookAt(0, -0.5, 0);
24
+ const sunlight = new DirectionalLight(0xffe4c0, 3);
25
+ sunlight.position.set(4.5, 8.2, 3);
26
+ const sky = new HemisphereLight(0xcfe4f5, 0x696050, 1.4);
27
+ scene.add(sunlight, sky);
28
+ scope.defer(() => {
29
+ sunlight.removeFromParent();
30
+ sunlight.dispose();
31
+ sky.removeFromParent();
32
+ sky.dispose();
33
+ });
34
+ const sand = new MeshStandardMaterial({ color: 0x958671, roughness: 0.95 });
35
+ const stone = new MeshStandardMaterial({ color: 0x494d50, roughness: 0.65 });
36
+ scope.defer(() => {
37
+ sand.dispose();
38
+ stone.dispose();
39
+ });
40
+ const bed = new PlaneGeometry(24, 24);
41
+ bed.rotateX(-Math.PI / 2);
42
+ const floor = new Mesh(bed, sand);
43
+ floor.position.y = -2;
44
+ scene.add(floor);
45
+ scope.defer(() => {
46
+ floor.removeFromParent();
47
+ bed.dispose();
48
+ });
49
+ for (const [x, height, z] of [
50
+ [-2, 3.2, -1],
51
+ [2, 0.9, 2],
52
+ [-3, 1.3, 3],
53
+ ] as const) {
54
+ const geometry = new BoxGeometry(0.8, height, 0.8);
55
+ const rock = new Mesh(geometry, stone);
56
+ rock.position.set(x, -2 + height / 2, z);
57
+ rock.rotation.y = x * 0.21;
58
+ scene.add(rock);
59
+ scope.defer(() => {
60
+ rock.removeFromParent();
61
+ geometry.dispose();
62
+ });
63
+ }
64
+ return () => scope.dispose();
65
+ }
@@ -0,0 +1,33 @@
1
+ // Fresnel/extinction equations adapted from Aureliengmz/clearwater (MIT, Lumaris 2026).
2
+ // See CLEARWATER-LICENSE.txt. The same expressions run on TSL scalars and in numeric tests.
3
+ export interface IOpticalScalar<T> {
4
+ add(value: number | T): T;
5
+ sub(value: number | T): T;
6
+ mul(value: number | T): T;
7
+ div(value: number | T): T;
8
+ max(value: number): T;
9
+ clamp(min: number, max: number): T;
10
+ sqrt(): T;
11
+ exp(): T;
12
+ oneMinus(): T;
13
+ }
14
+
15
+ /** Exact unpolarized air-to-water dielectric Fresnel; ior > 1 is validated at construction. */
16
+ export function dielectricFresnel<T extends IOpticalScalar<T>>(cosine: T, ior: number): T {
17
+ const ci = cosine.clamp(0, 1);
18
+ const ct = ci
19
+ .mul(ci)
20
+ .oneMinus()
21
+ .div(ior * ior)
22
+ .oneMinus()
23
+ .max(0)
24
+ .sqrt();
25
+ const rs = ci.sub(ct.mul(ior)).div(ci.add(ct.mul(ior)));
26
+ const rp = ci.mul(ior).sub(ct).div(ci.mul(ior).add(ct));
27
+ return rs.mul(rs).add(rp.mul(rp)).mul(0.5);
28
+ }
29
+
30
+ /** coefficient is inverse metres; a zero/negative thickness must never amplify light. */
31
+ export function beerLambert<T extends IOpticalScalar<T>>(metres: T, coefficient: number): T {
32
+ return metres.max(0).mul(-coefficient).exp();
33
+ }
@@ -0,0 +1,177 @@
1
+ // Generated for you. These are this game's shallow-water appearance and cost choices.
2
+ export type WaterRgb = readonly [number, number, number];
3
+ export interface IClearwaterOptions {
4
+ /** Width and length of the finite, horizontal surface, in metres. */
5
+ readonly size?: number;
6
+ readonly level?: number;
7
+ /** Representative receiver depth for the planar caustic solve, in metres. */
8
+ readonly depth?: number;
9
+ readonly center?: readonly [number, number];
10
+ /** FFT samples per cascade. 32, 64, 128 or 256. */
11
+ readonly resolution?: number;
12
+ readonly segments?: number;
13
+ readonly waveAmplitude?: number;
14
+ readonly windSpeed?: number;
15
+ readonly seed?: number;
16
+ readonly rippleResolution?: number;
17
+ readonly rippleSize?: number;
18
+ readonly ior?: number;
19
+ /** RGB coefficients in inverse metres, not sRGB colours. */
20
+ readonly absorption?: WaterRgb;
21
+ readonly scattering?: WaterRgb;
22
+ /** Direction from the water toward the sun. It must be above the horizon. */
23
+ readonly sunDirection?: WaterRgb;
24
+ /** Linear HDR radiance, not hexadecimal/sRGB colour. */
25
+ readonly sunColor?: WaterRgb;
26
+ readonly distortion?: number;
27
+ readonly reflection?: boolean;
28
+ readonly reflectionScale?: number;
29
+ readonly reflectionLayers?: number;
30
+ readonly reflectionRefreshInterval?: number;
31
+ readonly caustics?: boolean;
32
+ readonly causticsResolution?: number;
33
+ readonly causticsSegments?: number;
34
+ readonly causticsStrength?: number;
35
+ }
36
+
37
+ export interface IResolvedClearwaterOptions
38
+ extends Required<Omit<IClearwaterOptions, "reflectionLayers">> {
39
+ readonly reflectionLayers?: number;
40
+ }
41
+
42
+ export function finiteWaterNumber(name: string, value: number): number {
43
+ if (!Number.isFinite(value)) throw new RangeError(`Clearwater.${name} must be finite.`);
44
+ return value;
45
+ }
46
+
47
+ function range(name: string, value: number, min: number, max: number): number {
48
+ finiteWaterNumber(name, value);
49
+ if (value < min || value > max)
50
+ throw new RangeError(`Clearwater.${name} must be in ${min}..${max}.`);
51
+ return value;
52
+ }
53
+
54
+ function integer(name: string, value: number, min: number, max: number): number {
55
+ range(name, value, min, max);
56
+ if (!Number.isInteger(value)) throw new RangeError(`Clearwater.${name} must be an integer.`);
57
+ return value;
58
+ }
59
+
60
+ function powerOfTwo(name: string, value: number, min: number, max: number): number {
61
+ integer(name, value, min, max);
62
+ if ((value & (value - 1)) !== 0)
63
+ throw new RangeError(`Clearwater.${name} must be a power of two.`);
64
+ return value;
65
+ }
66
+
67
+ function rgb(name: string, value: WaterRgb): WaterRgb {
68
+ if (!Array.isArray(value) || value.length !== 3)
69
+ throw new TypeError(`Clearwater.${name} needs three components.`);
70
+ return [
71
+ range(name, value[0], 0, 100),
72
+ range(name, value[1], 0, 100),
73
+ range(name, value[2], 0, 100),
74
+ ];
75
+ }
76
+
77
+ function booleanOption(
78
+ name: "reflection" | "caustics",
79
+ value: boolean | undefined,
80
+ fallback: boolean,
81
+ ): boolean {
82
+ if (value !== undefined && typeof value !== "boolean")
83
+ throw new TypeError(`Clearwater.${name} must be a boolean.`);
84
+ return value ?? fallback;
85
+ }
86
+
87
+ function optionalInteger(
88
+ name: string,
89
+ value: number | undefined,
90
+ min: number,
91
+ max: number,
92
+ ): number | undefined {
93
+ if (value !== undefined) integer(name, value, min, max);
94
+ return value;
95
+ }
96
+
97
+ export function waterSunDirection(value: WaterRgb): WaterRgb {
98
+ if (!Array.isArray(value) || value.length !== 3)
99
+ throw new TypeError("Clearwater.sunDirection needs three components.");
100
+ for (const v of value) finiteWaterNumber("sunDirection", v);
101
+ const length = Math.hypot(...value);
102
+ if (length === 0 || value[1] / length < 0.05)
103
+ throw new RangeError(
104
+ "Clearwater sun must be at least 0.05 above the horizon after normalization.",
105
+ );
106
+ return [value[0] / length, value[1] / length, value[2] / length];
107
+ }
108
+
109
+ function resolveSpatialOptions(input: IClearwaterOptions, center: readonly [number, number]) {
110
+ return {
111
+ size: range("size", input.size ?? 16, 0.1, 4096),
112
+ level: finiteWaterNumber("level", input.level ?? 0),
113
+ depth: range("depth", input.depth ?? 2, 0.01, 100),
114
+ center: [
115
+ finiteWaterNumber("center.x", center[0]),
116
+ finiteWaterNumber("center.z", center[1]),
117
+ ] as const,
118
+ resolution: powerOfTwo("resolution", input.resolution ?? 64, 32, 256),
119
+ segments: integer("segments", input.segments ?? 128, 8, 512),
120
+ waveAmplitude: range("waveAmplitude", input.waveAmplitude ?? 0.00012, 0, 0.01),
121
+ windSpeed: range("windSpeed", input.windSpeed ?? 1.8, 0.01, 30),
122
+ seed: integer("seed", input.seed ?? 20260924, 0, 0xffffffff),
123
+ rippleResolution: powerOfTwo("rippleResolution", input.rippleResolution ?? 64, 16, 256),
124
+ rippleSize: range("rippleSize", input.rippleSize ?? 7, 0.1, 512),
125
+ };
126
+ }
127
+
128
+ function resolveOpticalOptions(input: IClearwaterOptions) {
129
+ return {
130
+ ior: range("ior", input.ior ?? 1.3335, 1.0001, 2),
131
+ absorption: rgb("absorption", input.absorption ?? [0.4, 0.074, 0.088]),
132
+ scattering: rgb("scattering", input.scattering ?? [0.028, 0.052, 0.068]),
133
+ sunDirection: waterSunDirection(input.sunDirection ?? [0.45, 0.82, 0.3]),
134
+ sunColor: rgb("sunColor", input.sunColor ?? [6, 5.4, 4.44]),
135
+ distortion: range("distortion", input.distortion ?? 0.018, 0, 0.1),
136
+ };
137
+ }
138
+
139
+ function resolveReflectionOptions(input: IClearwaterOptions) {
140
+ return {
141
+ reflection: booleanOption("reflection", input.reflection, true),
142
+ reflectionScale: range("reflectionScale", input.reflectionScale ?? 0.5, 0.0625, 1),
143
+ reflectionLayers: optionalInteger("reflectionLayers", input.reflectionLayers, 0, 0xffffffff),
144
+ reflectionRefreshInterval: integer(
145
+ "reflectionRefreshInterval",
146
+ input.reflectionRefreshInterval ?? 1,
147
+ 1,
148
+ 60,
149
+ ),
150
+ };
151
+ }
152
+
153
+ function resolveCausticsOptions(input: IClearwaterOptions) {
154
+ return {
155
+ caustics: booleanOption("caustics", input.caustics, true),
156
+ causticsResolution: powerOfTwo("causticsResolution", input.causticsResolution ?? 512, 64, 1024),
157
+ causticsSegments: integer("causticsSegments", input.causticsSegments ?? 128, 8, 256),
158
+ causticsStrength: range("causticsStrength", input.causticsStrength ?? 0.65, 0, 1),
159
+ };
160
+ }
161
+
162
+ /** Validate before allocating any GPU resource. Returned arrays never alias caller/default arrays. */
163
+ export function resolveClearwaterOptions(
164
+ input: IClearwaterOptions = {},
165
+ ): IResolvedClearwaterOptions {
166
+ if (input === null || typeof input !== "object")
167
+ throw new TypeError("Clearwater options must be an object.");
168
+ const center = input.center ?? [0, 0];
169
+ if (!Array.isArray(center) || center.length !== 2)
170
+ throw new TypeError("Clearwater.center needs x and z.");
171
+ return {
172
+ ...resolveSpatialOptions(input, center),
173
+ ...resolveOpticalOptions(input),
174
+ ...resolveReflectionOptions(input),
175
+ ...resolveCausticsOptions(input),
176
+ };
177
+ }