create-threenative 0.2.7 → 0.2.9

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 (541) hide show
  1. package/README.md +3 -1
  2. package/agent-docs/references/assertion-reference.md +87 -35
  3. package/agent-docs/references/auto-exposure.md +57 -0
  4. package/agent-docs/references/capability-reference.md +1306 -62
  5. package/agent-docs/references/debug-surface.md +6 -0
  6. package/agent-docs/references/finding-assets.md +46 -10
  7. package/agent-docs/references/performance-basics.md +5 -4
  8. package/agent-docs/references/terrain-authoring.md +140 -0
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
  10. package/capabilities.json +1505 -79
  11. package/dist/index.d.ts +28 -3
  12. package/dist/index.js +402 -167
  13. package/dist/threenative.js +989 -237
  14. package/dist/web-engine-buffer-geometry-utils.js +281 -0
  15. package/dist/web-engine-decal-geometry.js +184 -0
  16. package/dist/web-engine-gltf-loader.js +196 -0
  17. package/dist/web-engine-hdr-loader.js +190 -0
  18. package/dist/web-engine-lut-cube-loader.js +122 -0
  19. package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
  20. package/dist/web-engine-mesh-bvh.js +32 -0
  21. package/dist/web-engine-post-effects.js +168 -0
  22. package/dist/web-engine-runtime.js +42506 -0
  23. package/package.json +11 -8
  24. package/template-assets/autoExposure.ts +225 -0
  25. package/template-assets/exposure.ts +111 -0
  26. package/template-assets/exposureGraph.ts +178 -0
  27. package/template-assets/exposureReadback.ts +79 -0
  28. package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
  29. package/template-assets/patches/three@0.185.1.patch +6594 -700
  30. package/template-assets/patches/vite@8.2.0.patch +422 -0
  31. package/template-assets/worldEnvironment.ts +433 -30
  32. package/templates/action-rpg/AGENTS.md +11 -10
  33. package/templates/action-rpg/CLAUDE.md +11 -10
  34. package/templates/action-rpg/package.json +11 -9
  35. package/templates/action-rpg/playtests/performance.playtest.json +7 -1
  36. package/templates/action-rpg/src/progress.ts +0 -4
  37. package/templates/action-rpg/src/render/autoExposure.ts +225 -0
  38. package/templates/action-rpg/src/render/backlightControls.ts +66 -0
  39. package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
  40. package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
  41. package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
  42. package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
  43. package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
  44. package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
  45. package/templates/action-rpg/src/render/exposure.ts +111 -0
  46. package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
  47. package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
  48. package/templates/action-rpg/src/render/heightFog.ts +118 -0
  49. package/templates/action-rpg/src/render/lighting.ts +26 -1
  50. package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
  51. package/templates/action-rpg/src/render/materialLighting.ts +155 -0
  52. package/templates/action-rpg/src/render/postprocessing.ts +17 -2
  53. package/templates/action-rpg/src/render/quality.ts +61 -2
  54. package/templates/action-rpg/src/render/sky.ts +21 -1
  55. package/templates/action-rpg/src/render/vfx.ts +133 -58
  56. package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
  57. package/templates/action-rpg/src/scenes/Play.ts +81 -16
  58. package/templates/action-rpg/threenative.config.ts +3 -0
  59. package/templates/action-rpg/vite.config.ts +10 -2
  60. package/templates/minimal/AGENTS.md +9 -10
  61. package/templates/minimal/CLAUDE.md +9 -10
  62. package/templates/minimal/package.json +9 -8
  63. package/templates/minimal/playtests/play.playtest.json +7 -1
  64. package/templates/minimal/playtests/sky.playtest.json +10 -1
  65. package/templates/minimal/src/render/autoExposure.ts +225 -0
  66. package/templates/minimal/src/render/backlightControls.ts +66 -0
  67. package/templates/minimal/src/render/backlightMaterial.ts +147 -0
  68. package/templates/minimal/src/render/environmentContribution.ts +188 -0
  69. package/templates/minimal/src/render/environmentRadiance.ts +36 -0
  70. package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
  71. package/templates/minimal/src/render/environmentSampling.ts +193 -0
  72. package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
  73. package/templates/minimal/src/render/exposure.ts +111 -0
  74. package/templates/minimal/src/render/exposureGraph.ts +178 -0
  75. package/templates/minimal/src/render/exposureReadback.ts +79 -0
  76. package/templates/minimal/src/render/heightFog.ts +118 -0
  77. package/templates/minimal/src/render/lighting.ts +25 -1
  78. package/templates/minimal/src/render/materialAssignments.ts +102 -0
  79. package/templates/minimal/src/render/materialLighting.ts +146 -0
  80. package/templates/minimal/src/render/postprocessing.ts +16 -2
  81. package/templates/minimal/src/render/quality.ts +60 -2
  82. package/templates/minimal/src/render/sky.ts +21 -1
  83. package/templates/minimal/src/render/worldEnvironment.ts +433 -30
  84. package/templates/minimal/src/scenes/Play.ts +50 -1
  85. package/templates/minimal/vite.config.ts +10 -2
  86. package/templates/platformer/AGENTS.md +7 -5
  87. package/templates/platformer/CLAUDE.md +7 -5
  88. package/templates/platformer/package.json +11 -9
  89. package/templates/platformer/playtests/performance.playtest.json +7 -1
  90. package/templates/platformer/src/render/autoExposure.ts +225 -0
  91. package/templates/platformer/src/render/backlightControls.ts +66 -0
  92. package/templates/platformer/src/render/backlightMaterial.ts +147 -0
  93. package/templates/platformer/src/render/environmentContribution.ts +188 -0
  94. package/templates/platformer/src/render/environmentRadiance.ts +36 -0
  95. package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
  96. package/templates/platformer/src/render/environmentSampling.ts +193 -0
  97. package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
  98. package/templates/platformer/src/render/exposure.ts +111 -0
  99. package/templates/platformer/src/render/exposureGraph.ts +178 -0
  100. package/templates/platformer/src/render/exposureReadback.ts +79 -0
  101. package/templates/platformer/src/render/heightFog.ts +118 -0
  102. package/templates/platformer/src/render/lighting.ts +26 -1
  103. package/templates/platformer/src/render/materialAssignments.ts +160 -0
  104. package/templates/platformer/src/render/materialLighting.ts +155 -0
  105. package/templates/platformer/src/render/materials.ts +7 -2
  106. package/templates/platformer/src/render/palette.ts +3 -3
  107. package/templates/platformer/src/render/postprocessing.ts +17 -2
  108. package/templates/platformer/src/render/quality.ts +61 -2
  109. package/templates/platformer/src/render/sky.ts +72 -23
  110. package/templates/platformer/src/render/skyEnvironment.ts +50 -0
  111. package/templates/platformer/src/render/worldEnvironment.ts +433 -30
  112. package/templates/platformer/src/scenes/Play.ts +70 -6
  113. package/templates/platformer/vite.config.ts +10 -2
  114. package/templates/puzzle/AGENTS.md +10 -9
  115. package/templates/puzzle/CLAUDE.md +10 -9
  116. package/templates/puzzle/package.json +11 -9
  117. package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
  118. package/templates/puzzle/playtests/lit.playtest.json +7 -1
  119. package/templates/puzzle/playtests/performance.playtest.json +7 -1
  120. package/templates/puzzle/src/render/autoExposure.ts +225 -0
  121. package/templates/puzzle/src/render/backlightControls.ts +66 -0
  122. package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
  123. package/templates/puzzle/src/render/environmentContribution.ts +188 -0
  124. package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
  125. package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
  126. package/templates/puzzle/src/render/environmentSampling.ts +193 -0
  127. package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
  128. package/templates/puzzle/src/render/exposure.ts +111 -0
  129. package/templates/puzzle/src/render/exposureGraph.ts +178 -0
  130. package/templates/puzzle/src/render/exposureReadback.ts +79 -0
  131. package/templates/puzzle/src/render/heightFog.ts +118 -0
  132. package/templates/puzzle/src/render/lighting.ts +33 -1
  133. package/templates/puzzle/src/render/materialAssignments.ts +160 -0
  134. package/templates/puzzle/src/render/materialLighting.ts +155 -0
  135. package/templates/puzzle/src/render/materials.ts +1 -1
  136. package/templates/puzzle/src/render/postprocessing.ts +8 -2
  137. package/templates/puzzle/src/render/quality.ts +62 -1
  138. package/templates/puzzle/src/render/sky.ts +20 -1
  139. package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
  140. package/templates/puzzle/src/scenes/Play.ts +51 -2
  141. package/templates/puzzle/vite.config.ts +10 -2
  142. package/templates/racing/AGENTS.md +8 -7
  143. package/templates/racing/CLAUDE.md +8 -7
  144. package/templates/racing/package.json +11 -9
  145. package/templates/racing/playtests/performance.playtest.json +7 -1
  146. package/templates/racing/playtests/survives.playtest.json +6 -0
  147. package/templates/racing/src/render/autoExposure.ts +225 -0
  148. package/templates/racing/src/render/backlightControls.ts +66 -0
  149. package/templates/racing/src/render/backlightMaterial.ts +147 -0
  150. package/templates/racing/src/render/environmentContribution.ts +188 -0
  151. package/templates/racing/src/render/environmentRadiance.ts +36 -0
  152. package/templates/racing/src/render/environmentSampleCache.ts +43 -0
  153. package/templates/racing/src/render/environmentSampling.ts +193 -0
  154. package/templates/racing/src/render/environmentSnapshot.ts +53 -0
  155. package/templates/racing/src/render/exposure.ts +111 -0
  156. package/templates/racing/src/render/exposureGraph.ts +178 -0
  157. package/templates/racing/src/render/exposureReadback.ts +79 -0
  158. package/templates/racing/src/render/heightFog.ts +118 -0
  159. package/templates/racing/src/render/lighting.ts +29 -1
  160. package/templates/racing/src/render/materialAssignments.ts +160 -0
  161. package/templates/racing/src/render/materialLighting.ts +155 -0
  162. package/templates/racing/src/render/palette.ts +1 -10
  163. package/templates/racing/src/render/postprocessing.ts +17 -2
  164. package/templates/racing/src/render/quality.ts +61 -2
  165. package/templates/racing/src/render/shapes.ts +0 -25
  166. package/templates/racing/src/render/sky.ts +21 -1
  167. package/templates/racing/src/render/worldEnvironment.ts +433 -30
  168. package/templates/racing/src/scenes/Race.ts +91 -3
  169. package/templates/racing/src/track/circuit.ts +0 -9
  170. package/templates/racing/vite.config.ts +10 -2
  171. package/templates/rain/.codex/config.toml +19 -0
  172. package/templates/rain/.cursor/mcp.json +32 -0
  173. package/templates/rain/.gemini/settings.json +32 -0
  174. package/templates/rain/.mcp.json +32 -0
  175. package/templates/rain/.vscode/mcp.json +36 -0
  176. package/templates/rain/.zed/settings.json +36 -0
  177. package/templates/rain/AGENTS.md +95 -0
  178. package/templates/rain/CLAUDE.md +97 -0
  179. package/templates/rain/assets/rain-loop.wav +0 -0
  180. package/templates/rain/assets/thunder.wav +0 -0
  181. package/templates/rain/assets/wind-loop.wav +0 -0
  182. package/templates/rain/index.html +18 -0
  183. package/templates/rain/kit.json +7 -0
  184. package/templates/rain/native-playtests/boot.playtest.json +23 -0
  185. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  186. package/templates/rain/opencode.json +41 -0
  187. package/templates/rain/package.json +59 -0
  188. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  189. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  190. package/templates/rain/playtests/automation.playtest.json +133 -0
  191. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  192. package/templates/rain/playtests/flash.playtest.json +27 -0
  193. package/templates/rain/playtests/fly.playtest.json +54 -0
  194. package/templates/rain/playtests/lightning.playtest.json +220 -0
  195. package/templates/rain/playtests/loading.playtest.json +57 -0
  196. package/templates/rain/playtests/paused.playtest.json +59 -0
  197. package/templates/rain/playtests/performance.playtest.json +32 -0
  198. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  199. package/templates/rain/playtests/simulation.playtest.json +20 -0
  200. package/templates/rain/playtests/storm.playtest.json +150 -0
  201. package/templates/rain/playtests/survives.playtest.json +58 -0
  202. package/templates/rain/playtests/tiers.playtest.json +194 -0
  203. package/templates/rain/playtests/weather.playtest.json +77 -0
  204. package/templates/rain/public/favicon.svg +5 -0
  205. package/templates/rain/src/audio/storm.ts +314 -0
  206. package/templates/rain/src/game.ts +81 -0
  207. package/templates/rain/src/main.ts +15 -0
  208. package/templates/rain/src/render/autoExposure.ts +225 -0
  209. package/templates/rain/src/render/bloom-shader.ts +65 -0
  210. package/templates/rain/src/render/camera.ts +160 -0
  211. package/templates/rain/src/render/clouds-shader.ts +242 -0
  212. package/templates/rain/src/render/clouds.ts +142 -0
  213. package/templates/rain/src/render/exposure.ts +111 -0
  214. package/templates/rain/src/render/exposureGraph.ts +178 -0
  215. package/templates/rain/src/render/exposureReadback.ts +79 -0
  216. package/templates/rain/src/render/lighting.ts +39 -0
  217. package/templates/rain/src/render/lightning.ts +360 -0
  218. package/templates/rain/src/render/loading.ts +327 -0
  219. package/templates/rain/src/render/materials.ts +19 -0
  220. package/templates/rain/src/render/noise-volume.ts +159 -0
  221. package/templates/rain/src/render/palette.ts +18 -0
  222. package/templates/rain/src/render/post-shader.ts +178 -0
  223. package/templates/rain/src/render/postprocessing.ts +229 -0
  224. package/templates/rain/src/render/quality.ts +161 -0
  225. package/templates/rain/src/render/rain.ts +299 -0
  226. package/templates/rain/src/render/sky.ts +28 -0
  227. package/templates/rain/src/render/world-shader.ts +680 -0
  228. package/templates/rain/src/render/world.ts +146 -0
  229. package/templates/rain/src/render/worldEnvironment.ts +1212 -0
  230. package/templates/rain/src/scenes/Boot.ts +348 -0
  231. package/templates/rain/src/state.ts +261 -0
  232. package/templates/rain/src/style.css +1160 -0
  233. package/templates/rain/src/ui/App.tsx +29 -0
  234. package/templates/rain/src/ui/GameUi.tsx +187 -0
  235. package/templates/rain/src/ui/Hud.tsx +327 -0
  236. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  237. package/templates/rain/src/ui/Menu.tsx +370 -0
  238. package/templates/rain/src/ui/automation.ts +60 -0
  239. package/templates/rain/src/ui/main.tsx +7 -0
  240. package/templates/rain/src/ui/tempest.ts +149 -0
  241. package/templates/rain/tailwind.config.ts +2 -0
  242. package/templates/rain/threenative.config.ts +66 -0
  243. package/templates/rain/tools/generate-shaders.mjs +656 -0
  244. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  245. package/templates/rain/tools/storm-dsp.mjs +177 -0
  246. package/templates/rain/tools/tempest-bloom.frag +10 -0
  247. package/templates/rain/tools/tempest-clouds.frag +86 -0
  248. package/templates/rain/tools/tempest-post.frag +47 -0
  249. package/templates/rain/tools/tempest-world.frag +210 -0
  250. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  251. package/templates/rain/tsconfig.json +17 -0
  252. package/templates/rain/vite.config.ts +45 -0
  253. package/templates/rts/AGENTS.md +10 -11
  254. package/templates/rts/CLAUDE.md +10 -11
  255. package/templates/rts/package.json +10 -8
  256. package/templates/rts/playtests/performance.playtest.json +7 -1
  257. package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
  258. package/templates/rts/playtests/rts-attack.playtest.json +10 -1
  259. package/templates/rts/playtests/rts-build.playtest.json +10 -1
  260. package/templates/rts/playtests/rts-orders.playtest.json +7 -1
  261. package/templates/rts/playtests/rts-train.playtest.json +10 -1
  262. package/templates/rts/src/render/army.ts +10 -2
  263. package/templates/rts/src/render/autoExposure.ts +225 -0
  264. package/templates/rts/src/render/backlightControls.ts +66 -0
  265. package/templates/rts/src/render/backlightMaterial.ts +147 -0
  266. package/templates/rts/src/render/environmentContribution.ts +188 -0
  267. package/templates/rts/src/render/environmentRadiance.ts +36 -0
  268. package/templates/rts/src/render/environmentSampleCache.ts +43 -0
  269. package/templates/rts/src/render/environmentSampling.ts +193 -0
  270. package/templates/rts/src/render/environmentSnapshot.ts +53 -0
  271. package/templates/rts/src/render/exposure.ts +111 -0
  272. package/templates/rts/src/render/exposureGraph.ts +178 -0
  273. package/templates/rts/src/render/exposureReadback.ts +79 -0
  274. package/templates/rts/src/render/heightFog.ts +118 -0
  275. package/templates/rts/src/render/lighting.ts +26 -1
  276. package/templates/rts/src/render/materialAssignments.ts +160 -0
  277. package/templates/rts/src/render/materialLighting.ts +155 -0
  278. package/templates/rts/src/render/postprocessing.ts +8 -2
  279. package/templates/rts/src/render/quality.ts +61 -2
  280. package/templates/rts/src/render/sky.ts +21 -1
  281. package/templates/rts/src/render/worldEnvironment.ts +433 -30
  282. package/templates/rts/src/scenes/Play.ts +54 -3
  283. package/templates/rts/src/sim/ai.ts +0 -1
  284. package/templates/rts/src/sim/terrain.ts +0 -4
  285. package/templates/rts/vite.config.ts +10 -2
  286. package/templates/runner/AGENTS.md +10 -8
  287. package/templates/runner/CLAUDE.md +10 -8
  288. package/templates/runner/package.json +11 -9
  289. package/templates/runner/playtests/performance.playtest.json +10 -1
  290. package/templates/runner/src/physics.ts +0 -1
  291. package/templates/runner/src/render/autoExposure.ts +225 -0
  292. package/templates/runner/src/render/backlightControls.ts +66 -0
  293. package/templates/runner/src/render/backlightMaterial.ts +147 -0
  294. package/templates/runner/src/render/environmentContribution.ts +188 -0
  295. package/templates/runner/src/render/environmentRadiance.ts +36 -0
  296. package/templates/runner/src/render/environmentSampleCache.ts +43 -0
  297. package/templates/runner/src/render/environmentSampling.ts +193 -0
  298. package/templates/runner/src/render/environmentSnapshot.ts +53 -0
  299. package/templates/runner/src/render/exposure.ts +111 -0
  300. package/templates/runner/src/render/exposureGraph.ts +178 -0
  301. package/templates/runner/src/render/exposureReadback.ts +79 -0
  302. package/templates/runner/src/render/heightFog.ts +118 -0
  303. package/templates/runner/src/render/lighting.ts +26 -1
  304. package/templates/runner/src/render/materialAssignments.ts +160 -0
  305. package/templates/runner/src/render/materialLighting.ts +155 -0
  306. package/templates/runner/src/render/postprocessing.ts +17 -2
  307. package/templates/runner/src/render/quality.ts +61 -2
  308. package/templates/runner/src/render/sky.ts +21 -1
  309. package/templates/runner/src/render/worldEnvironment.ts +433 -30
  310. package/templates/runner/src/scenes/Run.ts +67 -2
  311. package/templates/runner/threenative.config.ts +3 -0
  312. package/templates/runner/vite.config.ts +10 -2
  313. package/templates/sailing/AGENTS.md +14 -13
  314. package/templates/sailing/CLAUDE.md +14 -13
  315. package/templates/sailing/native-playtests/survives.playtest.json +7 -0
  316. package/templates/sailing/package.json +11 -9
  317. package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
  318. package/templates/sailing/src/entities/Ship.ts +38 -18
  319. package/templates/sailing/src/render/autoExposure.ts +225 -0
  320. package/templates/sailing/src/render/backlightControls.ts +66 -0
  321. package/templates/sailing/src/render/backlightMaterial.ts +147 -0
  322. package/templates/sailing/src/render/camera.ts +12 -4
  323. package/templates/sailing/src/render/environmentContribution.ts +188 -0
  324. package/templates/sailing/src/render/environmentRadiance.ts +36 -0
  325. package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
  326. package/templates/sailing/src/render/environmentSampling.ts +193 -0
  327. package/templates/sailing/src/render/environmentSetup.ts +24 -0
  328. package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
  329. package/templates/sailing/src/render/exposure.ts +111 -0
  330. package/templates/sailing/src/render/exposureGraph.ts +178 -0
  331. package/templates/sailing/src/render/exposureReadback.ts +79 -0
  332. package/templates/sailing/src/render/heightFog.ts +118 -0
  333. package/templates/sailing/src/render/lighting.ts +26 -1
  334. package/templates/sailing/src/render/materialAssignments.ts +160 -0
  335. package/templates/sailing/src/render/materialLighting.ts +155 -0
  336. package/templates/sailing/src/render/ocean.ts +71 -53
  337. package/templates/sailing/src/render/postprocessing.ts +16 -2
  338. package/templates/sailing/src/render/props.ts +0 -45
  339. package/templates/sailing/src/render/quality.ts +61 -1
  340. package/templates/sailing/src/render/sky.ts +21 -1
  341. package/templates/sailing/src/render/worldEnvironment.ts +433 -30
  342. package/templates/sailing/src/scenes/Boot.ts +12 -1
  343. package/templates/sailing/src/scenes/Sailing.ts +87 -2
  344. package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
  345. package/templates/sailing/threenative.config.ts +3 -0
  346. package/templates/sailing/vite.config.ts +10 -2
  347. package/templates/shooter/AGENTS.md +8 -6
  348. package/templates/shooter/CLAUDE.md +8 -6
  349. package/templates/shooter/package.json +11 -9
  350. package/templates/shooter/playtests/performance.playtest.json +7 -1
  351. package/templates/shooter/src/entities/Enemy.ts +0 -15
  352. package/templates/shooter/src/entities/Rifle.ts +38 -1
  353. package/templates/shooter/src/render/autoExposure.ts +225 -0
  354. package/templates/shooter/src/render/backlightControls.ts +66 -0
  355. package/templates/shooter/src/render/backlightMaterial.ts +147 -0
  356. package/templates/shooter/src/render/camera.ts +1 -12
  357. package/templates/shooter/src/render/decals.ts +299 -5
  358. package/templates/shooter/src/render/environmentContribution.ts +188 -0
  359. package/templates/shooter/src/render/environmentRadiance.ts +36 -0
  360. package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
  361. package/templates/shooter/src/render/environmentSampling.ts +193 -0
  362. package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
  363. package/templates/shooter/src/render/exposure.ts +111 -0
  364. package/templates/shooter/src/render/exposureGraph.ts +178 -0
  365. package/templates/shooter/src/render/exposureReadback.ts +79 -0
  366. package/templates/shooter/src/render/gunfx.ts +0 -1
  367. package/templates/shooter/src/render/heightFog.ts +118 -0
  368. package/templates/shooter/src/render/lighting.ts +26 -1
  369. package/templates/shooter/src/render/materialAssignments.ts +160 -0
  370. package/templates/shooter/src/render/materialLighting.ts +155 -0
  371. package/templates/shooter/src/render/postprocessing.ts +17 -2
  372. package/templates/shooter/src/render/quality.ts +61 -2
  373. package/templates/shooter/src/render/scale.ts +2 -93
  374. package/templates/shooter/src/render/sky.ts +21 -1
  375. package/templates/shooter/src/render/vehicles.ts +0 -17
  376. package/templates/shooter/src/render/worldEnvironment.ts +433 -30
  377. package/templates/shooter/src/scenes/Play.ts +64 -2
  378. package/templates/shooter/vite.config.ts +10 -2
  379. package/templates/snow/.codex/config.toml +19 -0
  380. package/templates/snow/.cursor/mcp.json +32 -0
  381. package/templates/snow/.gemini/settings.json +32 -0
  382. package/templates/snow/.mcp.json +32 -0
  383. package/templates/snow/.vscode/mcp.json +36 -0
  384. package/templates/snow/.zed/settings.json +36 -0
  385. package/templates/snow/AGENTS.md +90 -0
  386. package/templates/snow/CLAUDE.md +92 -0
  387. package/templates/snow/README.md +26 -0
  388. package/templates/snow/assets/crunch.wav +0 -0
  389. package/templates/snow/assets/wind.wav +0 -0
  390. package/templates/snow/index.html +12 -0
  391. package/templates/snow/kit.json +7 -0
  392. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  393. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  394. package/templates/snow/opencode.json +41 -0
  395. package/templates/snow/package.json +60 -0
  396. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  397. package/templates/snow/playtests/performance.playtest.json +36 -0
  398. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  399. package/templates/snow/playtests/survives.playtest.json +56 -0
  400. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  401. package/templates/snow/playtests/weather.playtest.json +119 -0
  402. package/templates/snow/public/favicon.svg +5 -0
  403. package/templates/snow/src/audio.ts +58 -0
  404. package/templates/snow/src/commands.ts +8 -0
  405. package/templates/snow/src/entities/Explorer.ts +279 -0
  406. package/templates/snow/src/game.ts +69 -0
  407. package/templates/snow/src/main.ts +15 -0
  408. package/templates/snow/src/render/autoExposure.ts +225 -0
  409. package/templates/snow/src/render/backlightControls.ts +66 -0
  410. package/templates/snow/src/render/backlightMaterial.ts +147 -0
  411. package/templates/snow/src/render/bootPrint.ts +50 -0
  412. package/templates/snow/src/render/camera.ts +84 -0
  413. package/templates/snow/src/render/environmentContribution.ts +188 -0
  414. package/templates/snow/src/render/environmentRadiance.ts +36 -0
  415. package/templates/snow/src/render/environmentSampleCache.ts +43 -0
  416. package/templates/snow/src/render/environmentSampling.ts +193 -0
  417. package/templates/snow/src/render/environmentSnapshot.ts +53 -0
  418. package/templates/snow/src/render/explorer.ts +321 -0
  419. package/templates/snow/src/render/exposure.ts +111 -0
  420. package/templates/snow/src/render/exposureGraph.ts +178 -0
  421. package/templates/snow/src/render/exposureReadback.ts +79 -0
  422. package/templates/snow/src/render/heightFog.ts +118 -0
  423. package/templates/snow/src/render/lighting.ts +82 -0
  424. package/templates/snow/src/render/loading.ts +325 -0
  425. package/templates/snow/src/render/materialAssignments.ts +160 -0
  426. package/templates/snow/src/render/materialLighting.ts +155 -0
  427. package/templates/snow/src/render/materials.ts +36 -0
  428. package/templates/snow/src/render/palette.ts +17 -0
  429. package/templates/snow/src/render/postprocessing.ts +58 -0
  430. package/templates/snow/src/render/props.ts +42 -0
  431. package/templates/snow/src/render/quality.ts +193 -0
  432. package/templates/snow/src/render/scenery.ts +244 -0
  433. package/templates/snow/src/render/sky.ts +76 -0
  434. package/templates/snow/src/render/snowSurface.ts +259 -0
  435. package/templates/snow/src/render/touch-controls.ts +143 -0
  436. package/templates/snow/src/render/weather.ts +279 -0
  437. package/templates/snow/src/render/worldEnvironment.ts +1212 -0
  438. package/templates/snow/src/scenes/Boot.ts +12 -0
  439. package/templates/snow/src/scenes/Snow.ts +663 -0
  440. package/templates/snow/src/state.ts +46 -0
  441. package/templates/snow/src/style.css +143 -0
  442. package/templates/snow/src/terrain.ts +64 -0
  443. package/templates/snow/src/ui/App.tsx +15 -0
  444. package/templates/snow/src/ui/Controls.tsx +322 -0
  445. package/templates/snow/src/ui/GameUi.tsx +354 -0
  446. package/templates/snow/src/ui/icons.tsx +54 -0
  447. package/templates/snow/src/ui/main.tsx +7 -0
  448. package/templates/snow/tailwind.config.ts +2 -0
  449. package/templates/snow/threenative.config.ts +54 -0
  450. package/templates/snow/tsconfig.json +17 -0
  451. package/templates/snow/vite.config.ts +45 -0
  452. package/templates/starter/AGENTS.md +11 -16
  453. package/templates/starter/CLAUDE.md +11 -16
  454. package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
  455. package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
  456. package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
  457. package/templates/starter/package.json +11 -9
  458. package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
  459. package/templates/starter/playtests/movement.playtest.json +192 -0
  460. package/templates/starter/playtests/play.playtest.json +18 -2
  461. package/templates/starter/playtests/production-readiness.playtest.json +1 -1
  462. package/templates/starter/public/grade.cube +735 -0
  463. package/templates/starter/src/entities/Crate.ts +4 -0
  464. package/templates/starter/src/entities/Player.ts +79 -18
  465. package/templates/starter/src/game.ts +1 -0
  466. package/templates/starter/src/render/adaptiveQuality.ts +28 -41
  467. package/templates/starter/src/render/autoExposure.ts +225 -0
  468. package/templates/starter/src/render/backlightControls.ts +66 -0
  469. package/templates/starter/src/render/backlightMaterial.ts +147 -0
  470. package/templates/starter/src/render/environmentContribution.ts +188 -0
  471. package/templates/starter/src/render/environmentRadiance.ts +36 -0
  472. package/templates/starter/src/render/environmentSampleCache.ts +43 -0
  473. package/templates/starter/src/render/environmentSampling.ts +193 -0
  474. package/templates/starter/src/render/environmentSnapshot.ts +53 -0
  475. package/templates/starter/src/render/exposure.ts +111 -0
  476. package/templates/starter/src/render/exposureGraph.ts +178 -0
  477. package/templates/starter/src/render/exposureReadback.ts +79 -0
  478. package/templates/starter/src/render/grade.ts +157 -0
  479. package/templates/starter/src/render/heightFog.ts +118 -0
  480. package/templates/starter/src/render/lighting.ts +26 -1
  481. package/templates/starter/src/render/materialAssignments.ts +160 -0
  482. package/templates/starter/src/render/materialLighting.ts +155 -0
  483. package/templates/starter/src/render/postprocessing.ts +84 -4
  484. package/templates/starter/src/render/quality.ts +80 -8
  485. package/templates/starter/src/render/qualityPolicy.ts +54 -0
  486. package/templates/starter/src/render/rendererGate.ts +36 -0
  487. package/templates/starter/src/render/sky.ts +23 -1
  488. package/templates/starter/src/render/temporalAA.ts +197 -0
  489. package/templates/starter/src/render/temporalAAFrame.ts +179 -0
  490. package/templates/starter/src/render/temporalAAHooks.ts +101 -0
  491. package/templates/starter/src/render/temporalAAInput.ts +56 -0
  492. package/templates/starter/src/render/temporalAAResolve.ts +65 -0
  493. package/templates/starter/src/render/temporalAAStage.ts +76 -0
  494. package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
  495. package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
  496. package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
  497. package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
  498. package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
  499. package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
  500. package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
  501. package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
  502. package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
  503. package/templates/starter/src/render/temporalResolve.ts +139 -0
  504. package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
  505. package/templates/starter/src/render/temporalResolveMath.ts +196 -0
  506. package/templates/starter/src/render/volumetricFog.ts +124 -0
  507. package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
  508. package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
  509. package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
  510. package/templates/starter/src/render/worldEnvironment.ts +433 -30
  511. package/templates/starter/src/scenes/Play.ts +110 -1
  512. package/templates/starter/src/state.ts +1 -0
  513. package/templates/starter/src/ui/Hud.tsx +1 -1
  514. package/templates/starter/src/ui/Menu.tsx +1 -1
  515. package/templates/starter/tools/make-grade-lut.mjs +101 -0
  516. package/templates/starter/vite.config.ts +10 -2
  517. package/templates/tower-defense/AGENTS.md +10 -9
  518. package/templates/tower-defense/CLAUDE.md +10 -9
  519. package/templates/tower-defense/package.json +11 -9
  520. package/templates/tower-defense/playtests/performance.playtest.json +7 -1
  521. package/templates/tower-defense/src/render/autoExposure.ts +225 -0
  522. package/templates/tower-defense/src/render/backlightControls.ts +66 -0
  523. package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
  524. package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
  525. package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
  526. package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
  527. package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
  528. package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
  529. package/templates/tower-defense/src/render/exposure.ts +111 -0
  530. package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
  531. package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
  532. package/templates/tower-defense/src/render/lighting.ts +33 -1
  533. package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
  534. package/templates/tower-defense/src/render/materialLighting.ts +155 -0
  535. package/templates/tower-defense/src/render/postprocessing.ts +8 -2
  536. package/templates/tower-defense/src/render/quality.ts +61 -2
  537. package/templates/tower-defense/src/render/shapes.ts +0 -3
  538. package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
  539. package/templates/tower-defense/src/scenes/Battle.ts +65 -2
  540. package/templates/tower-defense/vite.config.ts +10 -2
  541. package/templates/minimal/src/scenes/Boot.ts +0 -5
@@ -0,0 +1,46 @@
1
+ export type CameraView = "follow" | "surface" | "overhead";
2
+
3
+ export type GameState = {
4
+ uiReady: boolean;
5
+ paused: boolean;
6
+ /** The explorer walks the glade on its own until a movement key or the stick takes over. */
7
+ autoExplore: boolean;
8
+ blizzard: boolean;
9
+ /** 0 clear .. 1 full blizzard, eased, so the HUD and the weather agree mid-transition. */
10
+ storm: number;
11
+ /** Flake density, 0..1. */
12
+ snowfall: number;
13
+ /** Powder depth in metres. */
14
+ depth: number;
15
+ /** Falling speed of a flake in still air, m/s. */
16
+ fallSpeed: number;
17
+ /** 0..1 snow hardness. */
18
+ hardness: number;
19
+ /** Base wind in m/s before gusts and the storm. */
20
+ wind: number;
21
+ /** The wind actually blowing this frame, m/s. */
22
+ windNow: number;
23
+ /** How many times faster than real time fresh snow refills tracks. */
24
+ recovery: number;
25
+ compaction: boolean;
26
+ muted: boolean;
27
+ view: CameraView;
28
+ /** Contacts the field has taken since the last reset — footsteps and bodies together. */
29
+ contacts: number;
30
+ /** The last footfall's penetration, metres. */
31
+ lastSink: number;
32
+ speed: number;
33
+ /** Indentation under the last footfall, `PROBE_COLUMNS` x `PROBE_ROWS`, row-major, metres. */
34
+ probe: number[];
35
+ /** How far the ball's underside sits above (positive) or in (negative) the snow, metres. */
36
+ ballGap: number;
37
+ /** Indentation under the ball, metres. */
38
+ ballSink: number;
39
+ /** Load the ball's solved contacts pressed into the snow last step, newtons. */
40
+ ballLoad: number;
41
+ toast: string;
42
+ toastId: number;
43
+ };
44
+
45
+ export const PROBE_COLUMNS = 15;
46
+ export const PROBE_ROWS = 20;
@@ -0,0 +1,143 @@
1
+ @import "tailwindcss";
2
+
3
+ @theme {
4
+ --font-sans: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
5
+ --color-ink: #0c1c28;
6
+ --color-panel: rgb(18 36 47 / 0.8);
7
+ --color-text: #eef5f7;
8
+ --color-muted: #a7bac4;
9
+ --color-line: rgb(210 230 240 / 0.18);
10
+ --color-aqua: #b6eadd;
11
+ --color-aqua-ink: #163a37;
12
+ }
13
+
14
+ :root,
15
+ body,
16
+ #root {
17
+ height: 100%;
18
+ margin: 0;
19
+ overflow: hidden;
20
+ }
21
+
22
+ body {
23
+ color: var(--color-text);
24
+ font-family: var(--font-sans);
25
+ -webkit-font-smoothing: antialiased;
26
+ }
27
+
28
+ #root {
29
+ background: #aabfcf;
30
+ }
31
+
32
+ /* Every control shows where keyboard focus is. */
33
+ :where(button, input, select, summary, [tabindex]):focus-visible {
34
+ outline: 2px solid var(--color-aqua);
35
+ outline-offset: 3px;
36
+ }
37
+
38
+ /* A slider whose filled part is the accent: `--fill` is set from the value. */
39
+ .snow-range {
40
+ -webkit-appearance: none;
41
+ appearance: none;
42
+ width: 100%;
43
+ height: 24px;
44
+ background: transparent;
45
+ cursor: pointer;
46
+ }
47
+ .snow-range::-webkit-slider-runnable-track {
48
+ height: 3px;
49
+ border-radius: 99px;
50
+ background: linear-gradient(
51
+ to right,
52
+ var(--color-aqua) var(--fill, 50%),
53
+ rgb(177 205 218 / 0.18) var(--fill, 50%)
54
+ );
55
+ }
56
+ .snow-range::-moz-range-track {
57
+ height: 3px;
58
+ border-radius: 99px;
59
+ background: rgb(177 205 218 / 0.18);
60
+ }
61
+ .snow-range::-moz-range-progress {
62
+ height: 3px;
63
+ border-radius: 99px;
64
+ background: var(--color-aqua);
65
+ }
66
+ .snow-range::-webkit-slider-thumb {
67
+ -webkit-appearance: none;
68
+ width: 14px;
69
+ height: 14px;
70
+ margin-top: -5.5px;
71
+ border-radius: 50%;
72
+ border: 2px solid #12303a;
73
+ background: var(--color-aqua);
74
+ }
75
+ .snow-range::-moz-range-thumb {
76
+ width: 12px;
77
+ height: 12px;
78
+ border-radius: 50%;
79
+ border: 2px solid #12303a;
80
+ background: var(--color-aqua);
81
+ }
82
+
83
+ @media (prefers-reduced-motion: reduce) {
84
+ *,
85
+ *::before,
86
+ *::after {
87
+ transition-duration: 0s !important;
88
+ animation-duration: 0s !important;
89
+ }
90
+ }
91
+
92
+ /* Boot failures are a page state, so the generated game owns their presentation. */
93
+ [data-threenative-canvas-error="true"] {
94
+ position: fixed;
95
+ inset: 0;
96
+ z-index: 1000;
97
+ display: grid;
98
+ place-items: center;
99
+ box-sizing: border-box;
100
+ padding: clamp(1.5rem, 8vw, 6rem);
101
+ overflow: auto;
102
+ background: #0c1c28;
103
+ color: #eef5f7;
104
+ font-family: inherit;
105
+ font-size: clamp(1rem, 2vw, 1.5rem);
106
+ line-height: 1.5;
107
+ text-align: center;
108
+ white-space: pre-wrap;
109
+ overflow-wrap: anywhere;
110
+ }
111
+
112
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
113
+ [data-threenative-debug-overlay="true"] {
114
+ position: fixed;
115
+ top: 1rem;
116
+ right: 1rem;
117
+ z-index: 50;
118
+ max-width: 24rem;
119
+ padding: 0.75rem;
120
+ pointer-events: none;
121
+ background: rgb(2 6 23 / 90%);
122
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
123
+ color: #cffafe;
124
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
125
+ font-size: 12px;
126
+ line-height: 1.5;
127
+ }
128
+
129
+ [data-threenative-debug-overlay="true"] table {
130
+ width: 100%;
131
+ table-layout: fixed;
132
+ }
133
+
134
+ [data-threenative-debug-overlay="true"] th,
135
+ [data-threenative-debug-overlay="true"] td {
136
+ padding-right: 1rem;
137
+ text-align: left;
138
+ }
139
+
140
+ [data-threenative-debug-overlay="true"] td:last-child {
141
+ overflow-wrap: anywhere;
142
+ word-break: break-all;
143
+ }
@@ -0,0 +1,64 @@
1
+ import { Heightfield, SnowField } from "@threenative/core/world";
2
+
3
+ /** The playable snowfield is a square this many metres across, centred on the origin. */
4
+ export const FIELD_SIZE = 24;
5
+ /**
6
+ * Samples along each side. 401 puts one every 6 cm, fine enough for a boot's heel and toe and
7
+ * the gap between two prints to read. The same samples are the drawn mesh and the collider, so
8
+ * raising it costs triangles and collider rebuilds as well.
9
+ */
10
+ export const FIELD_SAMPLES = 401;
11
+ /**
12
+ * What the explorer's capsule stands on: the ground plus fresh snow, one sample every 24 cm.
13
+ * Rapier sweeps a character's capsule against every collider triangle under it, so on the 6 cm
14
+ * snow collider each step cost ~0.9 ms (measured); here it is a tenth of that. The body's drawn
15
+ * height and its boots already come from the canonical snow, so nothing visible changes.
16
+ */
17
+ export const WALK_SAMPLES = 101;
18
+ /** Collision layers: the deforming snow, the explorer's walk surface, and the explorer. */
19
+ export const SNOW_LAYER = 0b10;
20
+ export const WALK_LAYER = 0b100;
21
+ export const EXPLORER_LAYER = 0b1000;
22
+
23
+ function smoothstep(edge0: number, edge1: number, value: number): number {
24
+ const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
25
+ return t * t * (3 - 2 * t);
26
+ }
27
+
28
+ /** Rolling ground under the snow: gentle swells in the glade, hills beyond it. */
29
+ export function terrainHeight(x: number, z: number): number {
30
+ const radius = Math.hypot(x, z);
31
+ const hills =
32
+ smoothstep(14, 42, radius) * (0.8 + 0.85 * Math.sin(x * 0.085 + 1) * Math.cos(z * 0.075));
33
+ return (
34
+ 0.2 * Math.sin(x * 0.16) * Math.cos(z * 0.12) +
35
+ 0.09 * Math.sin(x * 0.39 + z * 0.21) +
36
+ 0.07 * Math.cos(z * 0.53 - x * 0.24) +
37
+ hills
38
+ );
39
+ }
40
+
41
+ /** The ground plus `depth` of fresh snow at `WALK_SAMPLES`, in collider order. */
42
+ export function walkSurface(depth: number): Heightfield {
43
+ return Heightfield.fromSampler({
44
+ columns: WALK_SAMPLES,
45
+ depth: FIELD_SIZE,
46
+ origin: { x: 0, z: 0 },
47
+ rows: WALK_SAMPLES,
48
+ sampleHeight: (x, z) => terrainHeight(x, z) + depth,
49
+ width: FIELD_SIZE,
50
+ });
51
+ }
52
+
53
+ /** The canonical terrain and the deformable snow on it. Response coefficients are the study's. */
54
+ export function createSnowfield(depth: number, hardness: number): SnowField {
55
+ const field = Heightfield.fromSampler({
56
+ columns: FIELD_SAMPLES,
57
+ depth: FIELD_SIZE,
58
+ origin: { x: 0, z: 0 },
59
+ rows: FIELD_SAMPLES,
60
+ sampleHeight: terrainHeight,
61
+ width: FIELD_SIZE,
62
+ });
63
+ return new SnowField({ depth, field, hardness });
64
+ }
@@ -0,0 +1,15 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
+ import type { GameState } from "../state.js";
5
+ import { GameUi } from "./GameUi.js";
6
+
7
+ export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
8
+ return (
9
+ <main className="relative h-screen w-screen overflow-hidden bg-ink">
10
+ <GameCanvas className="absolute inset-0" game={game} />
11
+ <GameUi />
12
+ <DebugOverlay />
13
+ </main>
14
+ );
15
+ }
@@ -0,0 +1,322 @@
1
+ import type { useUiIntent } from "@threenative/ui";
2
+ import { type ReactNode, useEffect, useState } from "react";
3
+ import type { GameState } from "../state.js";
4
+ import { Icon } from "./icons.js";
5
+
6
+ type Send = ReturnType<typeof useUiIntent>;
7
+
8
+ interface IRangeProps {
9
+ readonly id: keyof GameState & string;
10
+ readonly label: string;
11
+ readonly value: number;
12
+ readonly min: number;
13
+ readonly max: number;
14
+ readonly step: number;
15
+ readonly format: (value: number) => string;
16
+ readonly send: Send;
17
+ }
18
+
19
+ /**
20
+ * A labelled slider. It keeps its own value while dragged — the game's state comes back on a
21
+ * ~100 ms bridge, and a slider bound straight to it would jump under the thumb.
22
+ */
23
+ function Range({ id, label, value, min, max, step, format, send }: IRangeProps) {
24
+ const [local, setLocal] = useState(value);
25
+ const [dragging, setDragging] = useState(false);
26
+ useEffect(() => {
27
+ if (!dragging) setLocal(value);
28
+ }, [dragging, value]);
29
+ const fill = `${((local - min) / (max - min)) * 100}%`;
30
+ return (
31
+ <div className="my-4 first:mt-0 [@media(max-height:800px)]:my-2">
32
+ <label className="flex items-baseline justify-between text-[11px] text-text" htmlFor={id}>
33
+ <span>{label}</span>
34
+ <output className="text-[10px] tabular-nums text-muted" htmlFor={id}>
35
+ {format(local)}
36
+ </output>
37
+ </label>
38
+ <input
39
+ className="snow-range mt-1.5 max-[850px]:h-11"
40
+ data-tn-interactive
41
+ id={id}
42
+ max={max}
43
+ min={min}
44
+ onBlur={() => setDragging(false)}
45
+ onChange={(event) => {
46
+ const next = Number(event.currentTarget.value);
47
+ setLocal(next);
48
+ send("set", { key: id, value: next });
49
+ }}
50
+ onPointerDown={() => setDragging(true)}
51
+ onPointerUp={() => setDragging(false)}
52
+ step={step}
53
+ style={{ "--fill": fill } as React.CSSProperties}
54
+ type="range"
55
+ value={local}
56
+ />
57
+ </div>
58
+ );
59
+ }
60
+
61
+ function Toggle({
62
+ label,
63
+ pressed,
64
+ onToggle,
65
+ }: {
66
+ readonly label: string;
67
+ readonly pressed: boolean;
68
+ readonly onToggle: () => void;
69
+ }) {
70
+ return (
71
+ <div className="flex min-h-11 items-center justify-between text-[11px] text-text">
72
+ <span id="compaction-label">{label}</span>
73
+ {/* The 44 px button is the hit area; the switch drawn inside it stays small. */}
74
+ <button
75
+ aria-labelledby="compaction-label"
76
+ aria-pressed={pressed}
77
+ className="-mr-2 grid h-11 w-14 place-items-center"
78
+ data-tn-interactive
79
+ onClick={onToggle}
80
+ type="button"
81
+ >
82
+ <span
83
+ className={`relative block h-[22px] w-[38px] rounded-full border transition-colors ${
84
+ pressed ? "border-aqua bg-aqua/80" : "border-line bg-black/20"
85
+ }`}
86
+ >
87
+ <span
88
+ className={`absolute top-[3px] left-0 h-[14px] w-[14px] rounded-full bg-text transition-transform ${
89
+ pressed ? "translate-x-[19px]" : "translate-x-[3px]"
90
+ }`}
91
+ />
92
+ </span>
93
+ </button>
94
+ </div>
95
+ );
96
+ }
97
+
98
+ function ActionButton({
99
+ children,
100
+ grow = false,
101
+ label,
102
+ onClick,
103
+ primary = false,
104
+ pressed,
105
+ title,
106
+ }: {
107
+ readonly children: ReactNode;
108
+ /** Take the row's spare width, so a row of buttons spans its panel. */
109
+ readonly grow?: boolean;
110
+ readonly label?: string;
111
+ readonly onClick: () => void;
112
+ readonly primary?: boolean;
113
+ readonly pressed?: boolean;
114
+ readonly title?: string;
115
+ }) {
116
+ return (
117
+ <button
118
+ aria-label={label}
119
+ aria-pressed={pressed}
120
+ className={`flex min-h-11 items-center justify-center gap-2 rounded-[9px] border px-3 text-[11px] backdrop-blur-md transition hover:brightness-110 ${grow ? "flex-1" : ""} ${
121
+ primary
122
+ ? "border-[rgb(212_251_236/0.7)] bg-aqua/90 text-aqua-ink"
123
+ : "border-line bg-[rgb(20_39_50/0.7)] text-text"
124
+ }`}
125
+ data-tn-interactive
126
+ onClick={onClick}
127
+ title={title}
128
+ type="button"
129
+ >
130
+ {children}
131
+ </button>
132
+ );
133
+ }
134
+
135
+ /** Drop the ball in front of the explorer, or push it away. */
136
+ export function BallActions({ send }: { readonly send: Send }) {
137
+ return (
138
+ <div className="grid grid-cols-2 gap-2">
139
+ <ActionButton
140
+ label="Drop the ball in front of you"
141
+ onClick={() => send("drop")}
142
+ title="Drop the ball in front of you (F)"
143
+ >
144
+ <Icon name="drop" />
145
+ <span className="whitespace-nowrap">Drop</span>
146
+ </ActionButton>
147
+ <ActionButton
148
+ label="Push the ball away from you"
149
+ onClick={() => send("kick")}
150
+ title="Push the ball away from you (G)"
151
+ >
152
+ <Icon name="push" />
153
+ <span className="whitespace-nowrap">Push</span>
154
+ </ActionButton>
155
+ </div>
156
+ );
157
+ }
158
+
159
+ /** Weather, snow and session controls: the panel on the left, or the sheet on a phone. */
160
+ export function Controls({ state, send }: { readonly state: GameState; readonly send: Send }) {
161
+ const percent = (value: number) => `${Math.round(value * 100)}%`;
162
+ return (
163
+ <div className="flex flex-col gap-3">
164
+ <section
165
+ aria-label="Weather and snow"
166
+ className="rounded-[15px] border border-line bg-panel px-5 pb-2 pt-5 [@media(max-height:800px)]:pt-4 shadow-[0_12px_45px_rgb(13_31_43/0.08)] backdrop-blur-xl"
167
+ >
168
+ <div className="flex items-center justify-between text-[10px] uppercase tracking-[0.2em] text-muted">
169
+ <span>Weather</span>
170
+ <kbd className="rounded border border-line px-1.5 font-sans text-[10px] tracking-normal">
171
+ B
172
+ </kbd>
173
+ </div>
174
+ <fieldset className="m-0 mb-5 mt-3 grid min-w-0 grid-cols-2 border-0 [@media(max-height:800px)]:mb-3 gap-1 rounded-[9px] bg-[rgb(5_18_26/0.37)] p-1">
175
+ <legend className="sr-only">Weather</legend>
176
+ {([false, true] as const).map((blizzard) => (
177
+ <button
178
+ aria-pressed={state.blizzard === blizzard}
179
+ className={`flex min-h-10 items-center justify-center gap-2 rounded-md px-1 text-[11px] transition-colors max-[850px]:min-h-11 ${
180
+ state.blizzard === blizzard ? "bg-aqua text-aqua-ink" : "text-muted hover:text-text"
181
+ }`}
182
+ data-tn-interactive
183
+ key={String(blizzard)}
184
+ onClick={() => {
185
+ if (state.blizzard !== blizzard) send("blizzard");
186
+ }}
187
+ type="button"
188
+ >
189
+ <Icon name={blizzard ? "blizzard" : "snow"} />
190
+ {blizzard ? "Blizzard" : "Soft snowfall"}
191
+ </button>
192
+ ))}
193
+ </fieldset>
194
+ <Range
195
+ format={percent}
196
+ id="snowfall"
197
+ label="Snowfall intensity"
198
+ max={1}
199
+ min={0}
200
+ send={send}
201
+ step={0.01}
202
+ value={state.snowfall}
203
+ />
204
+ <Range
205
+ format={(value) => `${Math.round(value * 100)} cm`}
206
+ id="depth"
207
+ label="Powder depth"
208
+ max={0.55}
209
+ min={0.06}
210
+ send={send}
211
+ step={0.01}
212
+ value={state.depth}
213
+ />
214
+ <Range
215
+ format={(value) => `${value.toFixed(2)} m/s`}
216
+ id="fallSpeed"
217
+ label="Flake fall speed"
218
+ max={1.6}
219
+ min={0.2}
220
+ send={send}
221
+ step={0.05}
222
+ value={state.fallSpeed}
223
+ />
224
+ <details className="group mt-1 border-t border-line pt-1">
225
+ <summary
226
+ className="flex min-h-11 cursor-pointer list-none items-center justify-between text-[11px] text-text"
227
+ data-tn-interactive
228
+ >
229
+ Snow physics
230
+ <span
231
+ aria-hidden="true"
232
+ className="text-[16px] text-muted transition-transform group-open:rotate-45"
233
+ >
234
+ +
235
+ </span>
236
+ </summary>
237
+ <Range
238
+ format={percent}
239
+ id="hardness"
240
+ label="Snow hardness"
241
+ max={0.95}
242
+ min={0.05}
243
+ send={send}
244
+ step={0.01}
245
+ value={state.hardness}
246
+ />
247
+ <Range
248
+ format={(value) => `${value.toFixed(1)} m/s`}
249
+ id="wind"
250
+ label="Base wind"
251
+ max={12}
252
+ min={0}
253
+ send={send}
254
+ step={0.1}
255
+ value={state.wind}
256
+ />
257
+ <Range
258
+ format={(value) => `${value}×`}
259
+ id="recovery"
260
+ label="Deposition time scale"
261
+ max={1200}
262
+ min={0}
263
+ send={send}
264
+ step={30}
265
+ value={state.recovery}
266
+ />
267
+ <Toggle
268
+ label="Show compaction"
269
+ onToggle={() => send("set", { key: "compaction", value: !state.compaction })}
270
+ pressed={state.compaction}
271
+ />
272
+ {state.compaction ? (
273
+ <p className="mt-1 flex items-center gap-3 text-[10px] text-muted" aria-live="polite">
274
+ <span className="flex items-center gap-1.5">
275
+ <i className="h-2.5 w-2.5 rounded-sm bg-[#f2783a]" /> packed
276
+ </span>
277
+ <span className="flex items-center gap-1.5">
278
+ <i className="h-2.5 w-2.5 rounded-sm bg-[#3882ab]" /> fresh powder
279
+ </span>
280
+ </p>
281
+ ) : null}
282
+ <p className="mb-3 mt-1 text-[10px] leading-relaxed text-muted">
283
+ Fresh snow fills tracks over time. The time scale speeds up deposition, never walking or
284
+ falling flakes.
285
+ </p>
286
+ </details>
287
+ </section>
288
+ <div className="flex gap-2">
289
+ <ActionButton
290
+ grow
291
+ label={state.autoExplore ? "Turn auto-explore off" : "Turn auto-explore on"}
292
+ onClick={() => send("auto")}
293
+ pressed={state.autoExplore}
294
+ primary={state.autoExplore}
295
+ >
296
+ <Icon className="h-[14px] w-[14px]" name="play" />
297
+ <span className="min-w-[92px] text-left">
298
+ {state.autoExplore ? "Auto-explore on" : "Auto-explore off"}
299
+ </span>
300
+ </ActionButton>
301
+ <ActionButton
302
+ label={state.paused ? "Resume simulation" : "Pause simulation"}
303
+ onClick={() => send(state.paused ? "resume" : "pause")}
304
+ pressed={state.paused}
305
+ title="Pause simulation"
306
+ >
307
+ <Icon name={state.paused ? "play" : "pause"} />
308
+ </ActionButton>
309
+ <ActionButton
310
+ label="Clear all footprints"
311
+ onClick={() => send("reset")}
312
+ title="Clear all footprints (R)"
313
+ >
314
+ <Icon name="reset" />
315
+ </ActionButton>
316
+ </div>
317
+ <div className="min-[851px]:hidden">
318
+ <BallActions send={send} />
319
+ </div>
320
+ </div>
321
+ );
322
+ }