create-threenative 0.2.6 → 0.2.8

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 (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,387 @@
1
+ // Bakes the reference study's `StormAudio` into the committed clips `src/audio/storm.ts` plays.
2
+ //
3
+ // node tools/make-storm-audio.mjs # write assets/*.wav and self-check them
4
+ // node tools/make-storm-audio.mjs --verify <file> # also prove the constants match that source
5
+ //
6
+ // The bake is deterministic: one seeded generator, no clock, no environment, no arguments. Two
7
+ // runs produce byte-identical files, and the self-check below is what makes that a fact rather
8
+ // than a hope — it re-runs the whole bake and compares hashes.
9
+ //
10
+ // `--verify` takes a copy of the reference study. It re-reads the constants out of that file and
11
+ // refuses to run if any of them has drifted from the transcription in `storm-dsp.mjs`, so this
12
+ // file cannot quietly stop being the source. It is optional only because the reference is not
13
+ // vendored into this repository.
14
+
15
+ import { createHash } from "node:crypto";
16
+ import { readFileSync, writeFileSync } from "node:fs";
17
+ import path from "node:path";
18
+ import { fileURLToPath } from "node:url";
19
+ import {
20
+ LOOPS,
21
+ LOOP_SECONDS,
22
+ STORM_SEED,
23
+ THUNDER_SECONDS,
24
+ biquad,
25
+ filterLoop,
26
+ loopBody,
27
+ mulberry32,
28
+ thunderBody,
29
+ } from "./storm-dsp.mjs";
30
+
31
+ /** Committed at 44.1 kHz stereo, float32 — see `encodeWav` for why not 16-bit. */
32
+ const SAMPLE_RATE = 44100;
33
+ const CHANNELS = 2;
34
+ const BITS = 32;
35
+ const BYTES_PER_SAMPLE = BITS / 8;
36
+ const BLOCK_ALIGN = CHANNELS * BYTES_PER_SAMPLE;
37
+ const WAVE_FORMAT_IEEE_FLOAT = 3;
38
+
39
+ const ASSETS = {
40
+ rain: { file: "rain-loop.wav", label: "rain hiss" },
41
+ wind: { file: "wind-loop.wav", label: "wind bed" },
42
+ thunder: { file: "thunder.wav", label: "thunder" },
43
+ };
44
+
45
+ const here = path.dirname(fileURLToPath(import.meta.url));
46
+ const assetsDir = path.resolve(here, "..", "assets");
47
+
48
+ function usage() {
49
+ console.log("usage: node tools/make-storm-audio.mjs [--verify <tempest.html>]");
50
+ process.exit(2);
51
+ }
52
+
53
+ /**
54
+ * Minimal float32 RIFF/WAVE writer: `fmt ` then `data`, which is what `THREE.AudioLoader` parses
55
+ * and what the asset compiler re-conditions on cook. No LIST or timestamp chunk, so the bytes
56
+ * depend on the samples and nothing else.
57
+ *
58
+ * **Float32, not 16-bit PCM.** The source ran these bodies in a `Float32Array` AudioBuffer and
59
+ * mixed them through gain nodes afterwards, so a loop is allowed to peak above full scale: wind is
60
+ * `pink * 4`, and after its 35..350 Hz band the committed loop still peaks at 1.05, which the
61
+ * source's own `.02 + wind * .18 *` node then brought down to at most .2. A 16-bit file cannot hold
62
+ * that — 0.012% of its samples were pinned to ±1.0 and the loudest transient of the loop was
63
+ * flattened into a clipped plateau. Every consumer of these files reads the format rather than
64
+ * guessing it: `@threenative/assets`' decoder takes `format 3` at 32 bits as `readFloatLE`, the
65
+ * native host's `SDL_LoadWAV_IO` path takes the `SDL_AUDIO_F32` branch, and `decodeAudioData`
66
+ * scales only integer PCM.
67
+ */
68
+ function encodeWav(channels) {
69
+ const frames = channels[0].length;
70
+ const dataBytes = frames * BLOCK_ALIGN;
71
+ const buffer = Buffer.alloc(44 + dataBytes);
72
+ buffer.write("RIFF", 0, "ascii");
73
+ buffer.writeUInt32LE(36 + dataBytes, 4);
74
+ buffer.write("WAVE", 8, "ascii");
75
+ buffer.write("fmt ", 12, "ascii");
76
+ buffer.writeUInt32LE(16, 16);
77
+ buffer.writeUInt16LE(WAVE_FORMAT_IEEE_FLOAT, 20);
78
+ buffer.writeUInt16LE(CHANNELS, 22);
79
+ buffer.writeUInt32LE(SAMPLE_RATE, 24);
80
+ buffer.writeUInt32LE(SAMPLE_RATE * BLOCK_ALIGN, 28);
81
+ buffer.writeUInt16LE(BLOCK_ALIGN, 32);
82
+ buffer.writeUInt16LE(BITS, 34);
83
+ buffer.write("data", 36, "ascii");
84
+ buffer.writeUInt32LE(dataBytes, 40);
85
+ let offset = 44;
86
+ for (let i = 0; i < frames; i += 1) {
87
+ for (let c = 0; c < CHANNELS; c += 1) {
88
+ buffer.writeFloatLE(channels[c][i], offset);
89
+ offset += 4;
90
+ }
91
+ }
92
+ return buffer;
93
+ }
94
+
95
+ /** One seeded draw, so the three clips come out of one stream exactly as the source did. */
96
+ function bake() {
97
+ const rng = mulberry32(STORM_SEED);
98
+ const rain = loopBody({ band: LOOPS.rain, sampleRate: SAMPLE_RATE, rng });
99
+ const wind = loopBody({ band: LOOPS.wind, sampleRate: SAMPLE_RATE, rng });
100
+ const thunder = thunderBody({ sampleRate: SAMPLE_RATE, rng });
101
+ // The source filtered live; the filter has to live in the file now. Same two biquads, same
102
+ // frequencies, same Q.
103
+ for (const [band, channels] of [
104
+ [LOOPS.rain, rain],
105
+ [LOOPS.wind, wind],
106
+ ]) {
107
+ const highpass = biquad("highpass", band.highpassHz, SAMPLE_RATE);
108
+ const lowpass = biquad("lowpass", band.lowpassHz, SAMPLE_RATE);
109
+ for (let c = 0; c < CHANNELS; c += 1)
110
+ channels[c] = filterLoop(filterLoop(channels[c], highpass), lowpass);
111
+ }
112
+ return {
113
+ rain: { bytes: encodeWav(rain), samples: rain },
114
+ thunder: { bytes: encodeWav(thunder), samples: thunder },
115
+ wind: { bytes: encodeWav(wind), samples: wind },
116
+ };
117
+ }
118
+
119
+ // --- the checks -----------------------------------------------------------------------------
120
+
121
+ function fail(what) {
122
+ throw new Error(`TN_STORM_AUDIO_INVALID: ${what}`);
123
+ }
124
+
125
+ function assert(what, condition) {
126
+ if (!condition) fail(what);
127
+ }
128
+
129
+ /** Peak and RMS of one decoded channel, plus the NaN/infinity count. */
130
+ function measure(samples) {
131
+ let peak = 0;
132
+ let sum = 0;
133
+ let bad = 0;
134
+ for (const value of samples) {
135
+ if (!Number.isFinite(value)) bad += 1;
136
+ else if (Math.abs(value) > peak) peak = Math.abs(value);
137
+ sum += value * value;
138
+ }
139
+ return { bad, peak, rms: Math.sqrt(sum / samples.length) };
140
+ }
141
+
142
+ /**
143
+ * Normalised autocorrelation at one lag — the check that the baked filters are the source's bands
144
+ * and not a name on a white-noise file.
145
+ *
146
+ * A signal with energy concentrated near `fs / lag` is correlated with itself there; white noise
147
+ * is not. Wind is band-limited to 35..350 Hz, so at the 350 Hz period it correlates hard. Rain is
148
+ * high-passed at 1800 Hz, so at the same lag it does not correlate at all.
149
+ */
150
+ function autocorrelation(samples, lag) {
151
+ let mean = 0;
152
+ for (const value of samples) mean += value;
153
+ mean /= samples.length;
154
+ let num = 0;
155
+ let den = 0;
156
+ for (let i = 0; i + lag < samples.length; i += 1) {
157
+ const a = samples[i] - mean;
158
+ const b = samples[i + lag] - mean;
159
+ num += a * b;
160
+ den += a * a;
161
+ }
162
+ return num / den;
163
+ }
164
+
165
+ /**
166
+ * The wrap step of a loop against the largest ordinary step in its own neighbourhood — the ratio
167
+ * `packages/assets/src/passes/audio.ts` fails a build on. `filterLoop` runs the steady-state
168
+ * response of a periodic input, so this has to come out clean; if it does not, the bake is not
169
+ * the source's filter and the loop clicks once per three seconds.
170
+ */
171
+ function seamRatio(samples) {
172
+ const wrap = Math.abs(samples[0] - samples[samples.length - 1]);
173
+ const steps = [];
174
+ for (let i = 1; i < samples.length; i += 1) steps.push(Math.abs(samples[i] - samples[i - 1]));
175
+ steps.sort((a, b) => a - b);
176
+ const near = steps[Math.floor(steps.length * 0.99)];
177
+ return near <= 0 ? (wrap <= 0 ? 0 : Number.POSITIVE_INFINITY) : wrap / near;
178
+ }
179
+
180
+ /**
181
+ * How much of the generated signal a float32 file is allowed to lose.
182
+ *
183
+ * Below half a ULP at 1.0, so a container that clamped or requantised the samples cannot pass it
184
+ * by rounding: 16-bit would move a sample by up to 1.5e-5, and it fails here by two orders of
185
+ * magnitude. It is a round-trip check, which is the strongest statement available about amplitude
186
+ * — "no sample was altered" rather than "few samples were altered".
187
+ */
188
+ const FLOAT32_TOLERANCE = 1e-7;
189
+
190
+ /**
191
+ * The header the runtime's loader, the asset compiler and the native decoder all read, asserted
192
+ * before the samples. The format tag is the check that matters: it is what a 16-bit re-encode
193
+ * would silently change, and what the three decoders above branch on.
194
+ */
195
+ function assertWavHeader(buffer) {
196
+ assert("RIFF header", buffer.toString("ascii", 0, 4) === "RIFF");
197
+ assert("WAVE header", buffer.toString("ascii", 8, 12) === "WAVE");
198
+ assert("IEEE float format tag", buffer.readUInt16LE(20) === WAVE_FORMAT_IEEE_FLOAT);
199
+ assert("channel count", buffer.readUInt16LE(22) === CHANNELS);
200
+ assert("sample rate", buffer.readUInt32LE(24) === SAMPLE_RATE);
201
+ assert("bit depth", buffer.readUInt16LE(34) === BITS);
202
+ }
203
+
204
+ /** One clip's own claims: right length, finite, unaltered, audible, and — for a loop — seamless. */
205
+ function checkClip(key, label, channels, source) {
206
+ const seconds = channels[0].length / SAMPLE_RATE;
207
+ const expected = key === "thunder" ? THUNDER_SECONDS : LOOP_SECONDS;
208
+ assert(
209
+ `${label}: duration is ${expected}s, got ${seconds.toFixed(4)}s`,
210
+ Math.abs(seconds - expected) < 1e-9,
211
+ );
212
+ const rows = [];
213
+ for (let c = 0; c < CHANNELS; c += 1) {
214
+ const m = measure(channels[c]);
215
+ assert(`${label} ch${c}: ${m.bad} non-finite samples`, m.bad === 0);
216
+ assert(
217
+ `${label} ch${c}: not silent (peak ${m.peak.toFixed(4)}, rms ${m.rms.toFixed(5)})`,
218
+ m.rms > 0.001 && m.peak > 0.05,
219
+ );
220
+ let moved = 0;
221
+ for (let i = 0; i < channels[c].length; i += 1)
222
+ moved = Math.max(moved, Math.abs(channels[c][i] - source[c][i]));
223
+ assert(
224
+ `${label} ch${c}: the file moved a sample by ${moved.toExponential(2)}`,
225
+ moved <= FLOAT32_TOLERANCE,
226
+ );
227
+ rows.push({ key, channel: c, peak: m.peak, rms: m.rms });
228
+ }
229
+ // The clip the 16-bit file could not hold. Wind's body is `pink * 4` and peaks above full scale,
230
+ // because the source's own gain node is what brought the loop down to at most .2 — so a peak over
231
+ // 1.0 in this file is the amplitude surviving, and a peak at or under it is a clip that lost the
232
+ // top of its transient to a container.
233
+ if (key === "wind") {
234
+ const peak = measure(channels[0]).peak;
235
+ assert(`${label}: the file holds its ${peak.toFixed(3)} peak, above full scale`, peak > 1);
236
+ }
237
+ if (key !== "thunder") {
238
+ const wrap = seamRatio(channels[0]);
239
+ assert(
240
+ `${label}: loop seam ${wrap.toFixed(3)}x exceeds 1.5x the neighbourhood step`,
241
+ wrap <= 1.5,
242
+ );
243
+ rows.push({ key, seam: wrap });
244
+ }
245
+ return rows;
246
+ }
247
+
248
+ /** Reads the written bytes back and checks the claims the runtime will rest on. */
249
+ function selfCheck(baked) {
250
+ const decode = (bytes) => {
251
+ assertWavHeader(bytes);
252
+ const frames = bytes.readUInt32LE(40) / BLOCK_ALIGN;
253
+ const channels = [];
254
+ for (let c = 0; c < CHANNELS; c += 1) channels.push(new Float64Array(frames));
255
+ for (let i = 0; i < frames; i += 1)
256
+ for (let c = 0; c < CHANNELS; c += 1)
257
+ channels[c][i] = bytes.readFloatLE(44 + (i * CHANNELS + c) * BYTES_PER_SAMPLE);
258
+ return channels;
259
+ };
260
+
261
+ const results = [];
262
+ const decoded = {};
263
+ for (const [key, { label }] of Object.entries(ASSETS)) {
264
+ const channels = decode(baked[key].bytes);
265
+ decoded[key] = channels;
266
+ results.push(...checkClip(key, label, channels, baked[key].samples));
267
+ }
268
+
269
+ // The filters, as heard: wind is correlated over its own band, rain is not correlated below its
270
+ // high-pass corner. One lag, taken from a source constant — the period of rain's 1800 Hz corner.
271
+ const lag = Math.round(SAMPLE_RATE / LOOPS.rain.highpassHz);
272
+ const windAcf = autocorrelation(decoded.wind[0], lag);
273
+ const rainAcf = autocorrelation(decoded.rain[0], lag);
274
+ assert(
275
+ `wind correlates over its 35..350 Hz band at lag ${lag} (${windAcf.toFixed(3)})`,
276
+ windAcf > 0.5,
277
+ );
278
+ assert(
279
+ `rain does not correlate below its ${LOOPS.rain.highpassHz} Hz corner at lag ${lag} (${rainAcf.toFixed(3)})`,
280
+ Math.abs(rainAcf) < 0.1,
281
+ );
282
+
283
+ // The thunder envelope: a crack in the first tenth of a second and a decay of real dynamic range.
284
+ const strike = decoded.thunder[0];
285
+ const crackWindow = Math.floor(0.1 * SAMPLE_RATE);
286
+ const tailWindow = Math.floor(0.5 * SAMPLE_RATE);
287
+ let crackPeak = 0;
288
+ for (let i = 0; i < crackWindow; i += 1) crackPeak = Math.max(crackPeak, Math.abs(strike[i]));
289
+ let tail = 0;
290
+ for (let i = strike.length - tailWindow; i < strike.length; i += 1) tail += strike[i] * strike[i];
291
+ const tailRms = Math.sqrt(tail / tailWindow);
292
+ const decayDb = 20 * Math.log10(crackPeak / Math.max(tailRms, 1e-9));
293
+ assert(
294
+ `thunder attack is inside the first 100 ms (peak ${crackPeak.toFixed(3)})`,
295
+ crackPeak > 0.2,
296
+ );
297
+ assert(`thunder decays ${decayDb.toFixed(1)} dB into its tail`, decayDb > 20);
298
+ // The 9 Hz tremolo is the only term that decorrelates the channels, so a near-identical pair
299
+ // would mean it was dropped somewhere between the source and here.
300
+ let cross = 0;
301
+ let energy = 0;
302
+ for (let i = 0; i < strike.length; i += 1) {
303
+ cross += decoded.thunder[0][i] * decoded.thunder[1][i];
304
+ energy += decoded.thunder[0][i] * decoded.thunder[0][i];
305
+ }
306
+ const stereo = cross / energy;
307
+ assert(
308
+ `thunder channels are decorrelated by the tremolo phase (r=${stereo.toFixed(3)})`,
309
+ stereo < 0.2,
310
+ );
311
+
312
+ return { results, windAcf, rainAcf, decayDb, stereo, lag };
313
+ }
314
+
315
+ /**
316
+ * Re-reads the reference study and refuses to bake if the transcription has drifted. Every check
317
+ * is a literal that has to appear in the source; a missing file, an unreadable file or a renamed
318
+ * constant all throw rather than quietly passing.
319
+ */
320
+ function verifySource(file) {
321
+ const source = readFileSync(file, "utf8");
322
+ const required = [
323
+ ["STORM_SEED", `rng(${STORM_SEED})`],
324
+ ["LOOPS.rain.highpassHz", `makeLoop(${LOOPS.rain.highpassHz},${LOOPS.rain.lowpassHz},.09)`],
325
+ ["LOOPS.wind.highpassHz", `makeLoop(${LOOPS.wind.highpassHz},${LOOPS.wind.lowpassHz},.05)`],
326
+ ["LOOP_SECONDS", `createBuffer(2,ctx.sampleRate*${LOOP_SECONDS},ctx.sampleRate)`],
327
+ ["THUNDER_SECONDS", `duration=${THUNDER_SECONDS}`],
328
+ ["pink", "pink=.96*pink+.04*w"],
329
+ ["white scale", "d[i]=low<100?pink*4:w*.6"],
330
+ ["brown", "low=.985*low+n*.015"],
331
+ ["crack", "Math.exp(-t*22)*n*.8"],
332
+ ["rumble", "low*7*(1.-Math.exp(-t*4))*Math.exp(-t*.66)"],
333
+ ["tremolo", "( .68+.32*Math.sin(t*9+c))"],
334
+ ["rain gain", "this.rainGain.gain.setTargetAtTime(weather.rain*.20"],
335
+ ["wind gain", ".02+weather.wind*.18*(.78+.22*Math.sin(time*.37))"],
336
+ ["master", "this.master.gain.setTargetAtTime(.42,this.ctx.currentTime,.12)"],
337
+ ["distance lowpass", "filter.frequency.value=clamp(4500-distance*5,280,4500)"],
338
+ ["distance gain", "gain.gain.value=clamp(1.05-distance*.0009,.18,.95)"],
339
+ ];
340
+ for (const [name, literal] of required)
341
+ if (!source.includes(literal)) fail(`source '${file}' no longer contains ${name} (${literal})`);
342
+ return required.length;
343
+ }
344
+
345
+ // --- run -------------------------------------------------------------------------------------
346
+
347
+ const args = process.argv.slice(2);
348
+ if (args.some((a) => a === "--help" || a === "-h")) usage();
349
+ const verifyAt = args.indexOf("--verify");
350
+ if (verifyAt !== -1 && args[verifyAt + 1] === undefined) usage();
351
+ const verified = verifyAt === -1 ? null : verifySource(args[verifyAt + 1]);
352
+
353
+ const first = bake();
354
+ const second = bake();
355
+ for (const key of Object.keys(ASSETS)) {
356
+ const a = createHash("sha256").update(first[key].bytes).digest("hex");
357
+ const b = createHash("sha256").update(second[key].bytes).digest("hex");
358
+ assert(`${ASSETS[key].label} is not reproducible across two bakes (${a} vs ${b})`, a === b);
359
+ }
360
+ const check = selfCheck(first);
361
+
362
+ for (const [key, { file, label }] of Object.entries(ASSETS)) {
363
+ const bytes = first[key].bytes;
364
+ writeFileSync(path.join(assetsDir, file), bytes);
365
+ const hash = createHash("sha256").update(bytes).digest("hex").slice(0, 16);
366
+ console.log(
367
+ `${file} ${label} ${(bytes.length / 1024).toFixed(0)} KiB float32 sha256:${hash}`,
368
+ );
369
+ }
370
+ for (const row of check.results) {
371
+ if (row.seam !== undefined)
372
+ console.log(
373
+ ` ${ASSETS[row.key].label}: loop seam ${row.seam.toFixed(3)}x the neighbourhood step`,
374
+ );
375
+ else
376
+ console.log(
377
+ ` ${ASSETS[row.key].label} ch${row.channel}: peak ${row.peak.toFixed(3)} rms ${row.rms.toFixed(4)}`,
378
+ );
379
+ }
380
+ console.log(
381
+ `self-check ok: wind acf@${check.lag} ${check.windAcf.toFixed(3)} (correlated), rain ${check.rainAcf.toFixed(3)} (not), thunder ${check.decayDb.toFixed(1)} dB decay at r=${check.stereo.toFixed(3)}, two bakes byte-identical`,
382
+ );
383
+ console.log(
384
+ verified === null
385
+ ? "note: constants unverified against the reference (pass --verify <tempest.html> to check)"
386
+ : `verified ${verified} source literals against the reference`,
387
+ );
@@ -0,0 +1,177 @@
1
+ // The reference study's audio maths, transcribed out of `/home/joao/Downloads/tempest.html`
2
+ // (`class StormAudio`, lines 551-583) so `make-storm-audio.mjs` can bake it offline.
3
+ //
4
+ // Every constant below is the source's, character for character, and every line of the two
5
+ // generators is the source's arithmetic rearranged to fill a typed array instead of an
6
+ // AudioBuffer. Nothing here is a redesign: the source runs this DSP on the audio thread against
7
+ // live Web Audio nodes, and the native host has no AudioContext at all, so the same numbers are
8
+ // computed once here and committed as PCM. The runtime constants that the source applied to *nodes*
9
+ // (the master gain, the biquads, the compressor, the distance delay) are named in
10
+ // `src/audio/storm.ts`, where the engine's own equivalents are applied instead.
11
+
12
+ /** `this.rng = rng(544)` — the same mulberry32 the rest of the study seeds with. */
13
+ export const STORM_SEED = 544;
14
+
15
+ /** `ctx.createBuffer(2, ctx.sampleRate * 3, ctx.sampleRate)` — both loops are three seconds. */
16
+ export const LOOP_SECONDS = 3;
17
+
18
+ /** `const duration = 7` — the thunder buffer. */
19
+ export const THUNDER_SECONDS = 7;
20
+
21
+ /**
22
+ * `makeLoop(low, high, volume)` as the source calls it:
23
+ * `this.rainGain = this.makeLoop(1800, 11000, .09)` and
24
+ * `this.windGain = this.makeLoop(35, 350, .05)`.
25
+ *
26
+ * `volume` is recorded because the source passes it to the gain node and then overwrites that
27
+ * node every frame in `update()`; the levels that are ever heard are the `update()` ones in
28
+ * `src/audio/storm.ts`, so this generator does not apply them.
29
+ */
30
+ export const LOOPS = {
31
+ rain: { highpassHz: 1800, lowpassHz: 11000, nodeGain: 0.09 },
32
+ wind: { highpassHz: 35, lowpassHz: 350, nodeGain: 0.05 },
33
+ };
34
+
35
+ /** The pink integrator: `pink = .96 * pink + .04 * w`, and the `low < 100 ? pink * 4 : w * .6` pick. */
36
+ const PINK_POLE = 0.96;
37
+ const PINK_FEED = 0.04;
38
+ const PINK_SCALE = 4;
39
+ /** `w = rng() * 2 - 1`, used at full scale for the loop bodies. */
40
+ const WHITE_SCALE = 0.6;
41
+
42
+ /** Thunder's brown integrator: `low = .985 * low + n * .015`, and the `low * 7` it is scaled by. */
43
+ const BROWN_POLE = 0.985;
44
+ const BROWN_FEED = 0.015;
45
+ const BROWN_SCALE = 7;
46
+
47
+ /** `Math.exp(-t * 22) * n * .8` — the crack, and the only part of the buffer that is not brown. */
48
+ const CRACK_DECAY = 22;
49
+ const CRACK_LEVEL = 0.8;
50
+ /** `low * 7 * (1 - Math.exp(-t * 4)) * Math.exp(-t * .66)` — the rumble's attack and release. */
51
+ const RUMBLE_ATTACK = 4;
52
+ const RUMBLE_DECAY = 0.66;
53
+ /** `(.68 + .32 * Math.sin(t * 9 + c))` — the tremolo, and the one-radian offset between channels. */
54
+ const TREMOLO_RATE = 9;
55
+ const TREMOLO_DEPTH = 0.32;
56
+ const TREMOLO_FLOOR = 0.68;
57
+
58
+ /** `function rng(seed = 1)` verbatim, so a given seed is the same stream the source drew. */
59
+ export function mulberry32(seed) {
60
+ let a = seed | 0;
61
+ return () => {
62
+ a += 0x6d2b79f5;
63
+ let t = a;
64
+ t = Math.imul(t ^ (t >>> 15), t | 1);
65
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
66
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
67
+ };
68
+ }
69
+
70
+ /**
71
+ * The RBJ biquad `BiquadFilterNode` computes, for the two types the source uses and at Q = 1,
72
+ * which is the spec default: `highpass` and `lowpass` share the same denominator.
73
+ *
74
+ * Returns `[b0, b1, b2, a1, a2]` already divided by a0, so the recursion is
75
+ * `y = b0 x + b1 x1 + b2 x2 - a1 y1 - a2 y2`.
76
+ */
77
+ export function biquad(type, hz, sampleRate, q = 1) {
78
+ const w0 = (2 * Math.PI * hz) / sampleRate;
79
+ const cos = Math.cos(w0);
80
+ const alpha = Math.sin(w0) / (2 * q);
81
+ const b =
82
+ type === "highpass"
83
+ ? [(1 + cos) / 2, -(1 + cos), (1 + cos) / 2]
84
+ : [(1 - cos) / 2, 1 - cos, (1 - cos) / 2];
85
+ const a0 = 1 + alpha;
86
+ return [b[0] / a0, b[1] / a0, b[2] / a0, (-2 * cos) / a0, (1 - alpha) / a0];
87
+ }
88
+
89
+ /**
90
+ * Runs a biquad over `input` as a *periodic* signal and returns exactly one period.
91
+ *
92
+ * The source filtered a looping buffer with a live node, so the filter state was continuous
93
+ * across every wrap forever. Filtering a finite buffer instead leaves the filter's state at the
94
+ * end of the file, and the join back to the start is a step — an audible click on a loop that
95
+ * repeats forever, which is the defect `packages/assets/src/passes/audio.ts` is built to reject.
96
+ * Running the recursion over the input repeated twice and keeping the second period is the
97
+ * steady-state response of a periodic input, so the wrap lands exactly where the join is.
98
+ */
99
+ export function filterLoop(input, coefficients) {
100
+ const [b0, b1, b2, a1, a2] = coefficients;
101
+ const n = input.length;
102
+ const out = new Float64Array(n);
103
+ let x1 = 0;
104
+ let x2 = 0;
105
+ let y1 = 0;
106
+ let y2 = 0;
107
+ for (let k = 0; k < n * 2; k += 1) {
108
+ const x = input[k % n];
109
+ const y = b0 * x + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2;
110
+ x2 = x1;
111
+ x1 = x;
112
+ y2 = y1;
113
+ y1 = y;
114
+ if (k >= n) out[k - n] = y;
115
+ }
116
+ return out;
117
+ }
118
+
119
+ /**
120
+ * `makeLoop`'s buffer body, one channel at a time, before the source's filters.
121
+ *
122
+ * Channel-major, because that is the order the source drew from its one generator: it filled
123
+ * channel 0 from `length` draws and then channel 1 from the next `length`. The pink state is
124
+ * per channel — `let pink = 0` is inside the channel loop — so the two channels share no state.
125
+ */
126
+ export function loopBody({ band, sampleRate, rng }) {
127
+ const n = Math.round(LOOP_SECONDS * sampleRate);
128
+ const channels = [];
129
+ const pink = band.highpassHz < 100;
130
+ for (let c = 0; c < 2; c += 1) {
131
+ const data = new Float64Array(n);
132
+ let state = 0;
133
+ for (let i = 0; i < n; i += 1) {
134
+ const w = rng() * 2 - 1;
135
+ if (!pink) {
136
+ data[i] = w * WHITE_SCALE;
137
+ continue;
138
+ }
139
+ state = PINK_POLE * state + PINK_FEED * w;
140
+ data[i] = state * PINK_SCALE;
141
+ }
142
+ channels.push(data);
143
+ }
144
+ return channels;
145
+ }
146
+
147
+ /**
148
+ * `thunder()`'s buffer body: `a[i] = clamp(crack + rumble, -1, 1)`, stereo, seven seconds.
149
+ *
150
+ * `let low = 0` resets per channel and the generator is shared across both, so the left channel
151
+ * ends its stream exactly where the right channel starts it. The tremolo's `+ c` term is what
152
+ * decorrelates the channels here; nothing else in the buffer does.
153
+ */
154
+ export function thunderBody({ sampleRate, rng }) {
155
+ const n = Math.floor(THUNDER_SECONDS * sampleRate);
156
+ const channels = [];
157
+ for (let c = 0; c < 2; c += 1) {
158
+ const data = new Float64Array(n);
159
+ let low = 0;
160
+ for (let i = 0; i < n; i += 1) {
161
+ const t = i / sampleRate;
162
+ const white = rng() * 2 - 1;
163
+ low = BROWN_POLE * low + BROWN_FEED * white;
164
+ const crack = Math.exp(-t * CRACK_DECAY) * white * CRACK_LEVEL;
165
+ const rumble =
166
+ low *
167
+ BROWN_SCALE *
168
+ (1 - Math.exp(-t * RUMBLE_ATTACK)) *
169
+ Math.exp(-t * RUMBLE_DECAY) *
170
+ (TREMOLO_FLOOR + TREMOLO_DEPTH * Math.sin(t * TREMOLO_RATE + c));
171
+ const mixed = crack + rumble;
172
+ data[i] = mixed > 1 ? 1 : mixed < -1 ? -1 : mixed;
173
+ }
174
+ channels.push(data);
175
+ }
176
+ return channels;
177
+ }
@@ -0,0 +1,10 @@
1
+ // The source of truth for src/render/bloom-shader.ts, transcribed from the Tempest single-file
2
+ // demo's `BLOOM` constant (const BLOOM, just after the lightning bolt fragment shader).
3
+ //
4
+ // A 5x5 gaussian at twice the input texel size, masked by a soft-knee luminance threshold and
5
+ // normalised by the weight it actually accumulated — not by 25, so the corners of the frame, where
6
+ // the kernel hangs off the target, cannot dim. Rendered at quarter resolution; see
7
+ // src/render/postprocessing.ts.
8
+ precision highp float;
9
+ in vec2 vUv;out vec4 fragColor;uniform sampler2D uScene;uniform vec2 uRes;
10
+ void main(){vec3 c=vec3(0.);float w=0.;for(int y=-2;y<=2;y++)for(int x=-2;x<=2;x++){float wt=exp(-float(x*x+y*y)*.32);vec3 s=texture(uScene,vUv+vec2(float(x),float(y))/uRes*2.).rgb;float l=max(s.r,max(s.g,s.b));c+=s*smoothstep(.70,1.6,l)*wt;w+=wt;}fragColor=vec4(c/w,1.);}
@@ -0,0 +1,86 @@
1
+ // The GLSL this template's cloud volume shader is generated from, copied out of the Tempest
2
+ // single-file demo (its COMMON + CLOUDS fragment shaders) so the generator is reproducible without
3
+ // the original file. Edits here change the generated
4
+ // templates/rain/src/render/clouds-shader.ts; edit the generator, not its output.
5
+ //
6
+ // Two things below are rewritten, both to keep the port mechanical rather than hand-written. The
7
+ // `density` early return becomes one value assigned under a guard, and `main`'s degenerate-slab
8
+ // return becomes the value it starts with — the reason is on `density`. The five-tap sunlight loop
9
+ // counts with `i` rather than `j` so the transpiler emits a loop whose counter it already names the
10
+ // way `LoopNode` expects; the counter's name is not part of what the loop computes.
11
+ precision highp float;
12
+ precision highp sampler3D;
13
+ uniform float uTime, uRain, uCloud, uWind, uFog, uWet, uFlash, uAspect, uTan;
14
+ uniform vec3 uCam, uForward, uRight, uUp, uStrike;
15
+ // The look, owned by src/render/{sky,lighting}.ts and set from there every run.
16
+ uniform vec3 uSunDir, uSkyLow, uSkyHigh;
17
+ uniform vec2 uRes;
18
+ in vec2 vUv;
19
+ out vec4 fragColor;
20
+ float hash12(vec2 p){vec3 p3=fract(vec3(p.xyx)*.1031);p3+=dot(p3,p3.yzx+33.33);return fract((p3.x+p3.y)*p3.z);}
21
+ float hash13(vec3 p){p=fract(p*.1031);p+=dot(p,p.zyx+31.32);return fract((p.x+p.y)*p.z);}
22
+ float noise2(vec2 p){vec2 i=floor(p),f=fract(p);f=f*f*(3.-2.*f);return mix(mix(hash12(i),hash12(i+vec2(1,0)),f.x),mix(hash12(i+vec2(0,1)),hash12(i+1.),f.x),f.y);}
23
+ float fbm2(vec2 p){float v=.5*noise2(p);p=mat2(.8,-.6,.6,.8)*p*2.03+19.1;v+=.25*noise2(p);p=p*2.02+9.3;v+=.125*noise2(p);return v+.0625*noise2(p*2.01+17.);}
24
+ vec3 ray(vec2 uv){vec2 q=uv*2.-1.;return normalize(uForward+uRight*q.x*uAspect*uTan+uUp*q.y*uTan);}
25
+ vec4 project(vec3 p){vec3 v=p-uCam;float d=dot(v,uForward);return vec4(dot(v,uRight)/(uAspect*uTan),dot(v,uUp)/uTan,1.00012*d-.300018,d);}
26
+ uniform sampler3D uNoise;
27
+ uniform int uSteps;
28
+ float density(vec3 p){
29
+ // One value, one return, for the reason given in the coast's `baseColor`: the transpiler turns a
30
+ // GLSL early return into a JavaScript return that only leaves the `If` callback the node graph is
31
+ // being built inside, so the branch would never be assigned. The guard is kept as a guard, so a
32
+ // clear sky still costs one comparison and no noise fetches.
33
+ float res=0.;
34
+ if(uCloud>=.005){
35
+ vec3 drift=vec3(uTime*(2.+uWind*13.),0.,uTime*1.2);
36
+ vec3 q=(p+drift)*.00105; q.y*=1.4;
37
+ vec4 n=texture(uNoise,q);
38
+ float broad=n.r*.76+texture(uNoise,q*2.07+vec3(.1,.3,.7)).r*.24;
39
+ // Flattened condensation base with turbulent billows above it.
40
+ float h=(p.y-145.)/670.;
41
+ float base=smoothstep(0.,.09,h)*(1.-smoothstep(.68,1.,h));
42
+ float shape=broad+uCloud*.30-.72;
43
+ float edge=(texture(uNoise,q*3.81).b-.5)*.12;
44
+ res=clamp((shape-edge)*5.1,0.,1.)*base;
45
+ }
46
+ return res;
47
+ }
48
+ float lightAt(vec3 p,vec3 l){float sum=0.,stepLen=28.;for(int i=0;i<5;i++){p+=l*stepLen;sum+=density(p)*stepLen;stepLen*=1.7;}return exp(-sum*.015);}
49
+ void main(){
50
+ vec3 rd=ray(vUv);rd.y=abs(rd.y);rd=normalize(rd);
51
+ vec3 sunDir=uSunDir;float mu=dot(rd,sunDir);
52
+ vec3 sky=mix(uSkyLow,uSkyHigh,pow(clamp(rd.y,0.,1.),.62));
53
+ sky+=vec3(.31,.27,.205)*pow(max(mu,0.),14.);
54
+ sky+=vec3(.7,.57,.37)*pow(max(mu,0.),140.);
55
+ sky+=uFlash*vec3(.14,.22,.36);
56
+ float t0=max(0.,(145.-uCam.y)/max(rd.y,.008));
57
+ float t1=min(10500.,(815.-uCam.y)/max(rd.y,.008));
58
+ vec4 col=vec4(sky,1.);
59
+ if(t0<t1){
60
+ float dt=(t1-t0)/float(uSteps);
61
+ float jitter=hash12(gl_FragCoord.xy)*.75+.12;
62
+ vec3 light=vec3(0.);float trans=1.;
63
+ float phase=.45+.65*pow(max(mu,0.),5.);
64
+ for(int i=0;i<96;i++){
65
+ if(i>=uSteps||trans<.008)break;
66
+ float t=t0+(float(i)+jitter)*dt;vec3 p=uCam+rd*t;
67
+ float d=density(p);
68
+ if(d>.002){
69
+ float sun=lightAt(p,sunDir);
70
+ float height=clamp((p.y-145.)/670.,0.,1.);
71
+ vec3 ambient=mix(vec3(.035,.061,.079),vec3(.19,.25,.28),height);
72
+ // A small multiple-scattering/powder approximation prevents crushed cloud cores.
73
+ vec3 c=ambient*(.7+.45*(1.-exp(-d*3.)))+vec3(.97,.94,.85)*sun*phase*.70;
74
+ float glow=exp(-length((p-uStrike)*vec3(1.,.5,1.))*.0022);
75
+ c+=vec3(.85,1.18,1.9)*uFlash*glow*1.2;
76
+ float absorb=1.-exp(-d*dt*.020);
77
+ light+=trans*absorb*c;trans*=1.-absorb;
78
+ }
79
+ }
80
+ vec3 marched=light+trans*sky;
81
+ float atmospheric=1.-exp(-t0*.000075);
82
+ marched=mix(marched,sky,atmospheric*.66);
83
+ col=vec4(marched,1.-trans);
84
+ }
85
+ return col;
86
+ }