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
@@ -1,199 +0,0 @@
1
- // Generated source. It extracts a closed field and owns no renderer or appearance choice.
2
- type Point = [number, number, number];
3
- type Triangle = [number, number, number];
4
- type SurfaceOptions = Readonly<{
5
- bounds: Record<"maxX" | "maxY" | "maxZ" | "minX" | "minY" | "minZ", number>;
6
- cellSize: number;
7
- latticeCap: number;
8
- sample: (x: number, y: number, z: number) => number;
9
- closed?: boolean;
10
- protectBoundary?: boolean;
11
- }>;
12
- function createSurfaceFunctions() {
13
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
14
- function failSurface(name: string, message: string): never {
15
- const error = new Error(`${name}: ${message}`);
16
- error.name = name;
17
- throw error;
18
- }
19
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
20
- function readPoint(array: ArrayLike<number>, vertex: number): Point {
21
- return [array[vertex * 3] as number, array[vertex * 3 + 1] as number, array[vertex * 3 + 2] as number];
22
- }
23
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
24
- function triangleMetrics(a: Point, b: Point, c: Point): [number, number] {
25
- const u: Point = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
26
- const v: Point = [c[0] - a[0], c[1] - a[1], c[2] - a[2]];
27
- const n: Point = [u[1] * v[2] - u[2] * v[1], u[2] * v[0] - u[0] * v[2], u[0] * v[1] - u[1] * v[0]];
28
- return [n[0] * n[0] + n[1] * n[1] + n[2] * n[2], a[0] * (b[1] * c[2] - b[2] * c[1]) + a[1] * (b[2] * c[0] - b[0] * c[2]) + a[2] * (b[0] * c[1] - b[1] * c[0])];
29
- }
30
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
31
- function touchSurfaceEdge(edges: Map<string, Point>, from: number, to: number): void {
32
- const key = from < to ? `${from}|${to}` : `${to}|${from}`;
33
- const edge = edges.get(key) ?? [0, 0, 0];
34
- edge[0] += 1; edge[1] += from < to ? 1 : -1; edges.set(key, edge);
35
- }
36
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
37
- function auditImplicitSurface(indices: Uint32Array, positions: Float32Array) {
38
- const edges = new Map<string, Point>();
39
- const counts = { boundaryEdges: 0, degenerateTriangles: 0, signedVolume: 0, windingConflicts: 0 };
40
- for (let index = 0; index < indices.length; index += 3) {
41
- const a = indices[index] as number; const b = indices[index + 1] as number; const c = indices[index + 2] as number;
42
- if (a >= positions.length / 3 || b >= positions.length / 3 || c >= positions.length / 3)
43
- failSurface("TN_IMPLICIT_SURFACE_INDEX_INVALID", `triangle ${index / 3} references a missing vertex.`);
44
- touchSurfaceEdge(edges, a, b); touchSurfaceEdge(edges, b, c); touchSurfaceEdge(edges, c, a);
45
- const [area, volume] = triangleMetrics(readPoint(positions, a), readPoint(positions, b), readPoint(positions, c));
46
- if (area < 1e-14) counts.degenerateTriangles += 1;
47
- counts.signedVolume += volume;
48
- }
49
- for (const [count, direction] of edges.values()) {
50
- if (count !== 2) counts.boundaryEdges += 1;
51
- if (count === 2 && direction !== 0) counts.windingConflicts += 1;
52
- }
53
- return { ...counts, signedVolume: counts.signedVolume / 6, triangles: indices.length / 3, vertices: positions.length / 3 };
54
- }
55
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
56
- function addSurfaceTriangle(output: number[], positions: number[], sample: SurfaceOptions["sample"], dx: number, dy: number, dz: number, vertices: Triangle): void {
57
- const [va, vb, vc] = vertices;
58
- const [a, b, c] = [readPoint(positions, va), readPoint(positions, vb), readPoint(positions, vc)] as [Point, Point, Point];
59
- const [area] = triangleMetrics(a, b, c);
60
- if (area < 1e-14) return;
61
- const center: Point = [(a[0] + b[0] + c[0]) / 3, (a[1] + b[1] + c[1]) / 3, (a[2] + b[2] + c[2]) / 3];
62
- const gradient: Point = [
63
- sample(center[0] + dx * 0.25, center[1], center[2]) - sample(center[0] - dx * 0.25, center[1], center[2]),
64
- sample(center[0], center[1] + dy * 0.25, center[2]) - sample(center[0], center[1] - dy * 0.25, center[2]),
65
- sample(center[0], center[1], center[2] + dz * 0.25) - sample(center[0], center[1], center[2] - dz * 0.25),
66
- ];
67
- const n: Point = [(b[1] - a[1]) * (c[2] - a[2]) - (b[2] - a[2]) * (c[1] - a[1]), (b[2] - a[2]) * (c[0] - a[0]) - (b[0] - a[0]) * (c[2] - a[2]), (b[0] - a[0]) * (c[1] - a[1]) - (b[1] - a[1]) * (c[0] - a[0])];
68
- if (n[0] * gradient[0] + n[1] * gradient[1] + n[2] * gradient[2] >= 0) output.push(va, vb, vc); else output.push(va, vc, vb);
69
- }
70
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
71
- // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the bounded adjacency walk orients the final closed mesh.
72
- function orientSurface(indices: Uint32Array): void {
73
- const links = new Map<string, Array<[number, number]>>();
74
- for (let triangle = 0; triangle < indices.length; triangle += 3) for (let edge = 0; edge < 3; edge++) {
75
- const from = indices[triangle + edge] as number; const to = indices[triangle + (edge + 1) % 3] as number;
76
- const key = from < to ? `${from}|${to}` : `${to}|${from}`;
77
- const linked = links.get(key) ?? []; linked.push([triangle, from < to ? 1 : -1]); links.set(key, linked);
78
- }
79
- const flips = new Map<number, boolean>();
80
- for (let start = 0; start < indices.length; start += 3) if (!flips.has(start)) {
81
- const queue = [start]; flips.set(start, false); while (queue.length > 0) {
82
- const triangle = queue.pop() as number; const flip = flips.get(triangle) as boolean;
83
- for (let edge = 0; edge < 3; edge++) {
84
- const from = indices[triangle + edge] as number; const to = indices[triangle + (edge + 1) % 3] as number;
85
- const key = from < to ? `${from}|${to}` : `${to}|${from}`;
86
- for (const [other, otherDirection] of links.get(key) ?? []) if (other !== triangle && !flips.has(other)) {
87
- flips.set(other, flip !== ((from < to ? 1 : -1) === otherDirection)); queue.push(other);
88
- }
89
- }
90
- }
91
- }
92
- for (const [triangle, flip] of flips) if (flip) {
93
- const swap = indices[triangle + 1] as number; indices[triangle + 1] = indices[triangle + 2] as number; indices[triangle + 2] = swap;
94
- }
95
- }
96
- // biome-ignore format: compact generated helper keeps the render source under its smell budget.
97
- // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: the bounded lattice traversal is the extractor.
98
- function buildImplicitSurface(options: SurfaceOptions) {
99
- const started = Date.now();
100
- const { bounds } = options;
101
- if ([bounds.minX, bounds.maxX, bounds.minY, bounds.maxY, bounds.minZ, bounds.maxZ].some((value) => !Number.isFinite(value)))
102
- failSurface("TN_IMPLICIT_SURFACE_BOUNDS_INVALID", "bounds must be finite.");
103
- if (bounds.maxX <= bounds.minX || bounds.maxY <= bounds.minY || bounds.maxZ <= bounds.minZ)
104
- failSurface("TN_IMPLICIT_SURFACE_BOUNDS_INVALID", "each maximum must exceed its minimum.");
105
- if (!Number.isFinite(options.cellSize) || options.cellSize <= 0)
106
- failSurface("TN_IMPLICIT_SURFACE_CELL_INVALID", "cellSize must be positive and finite.");
107
- if (!Number.isSafeInteger(options.latticeCap) || options.latticeCap <= 0)
108
- failSurface("TN_IMPLICIT_SURFACE_CAP_INVALID", "latticeCap must be a positive safe integer.");
109
- const nx = Math.max(1, Math.ceil((bounds.maxX - bounds.minX) / options.cellSize));
110
- const ny = Math.max(1, Math.ceil((bounds.maxY - bounds.minY) / options.cellSize));
111
- const nz = Math.max(1, Math.ceil((bounds.maxZ - bounds.minZ) / options.cellSize));
112
- const width = nx + 1;
113
- const height = ny + 1;
114
- const depth = nz + 1;
115
- const latticeLength = width * height * depth;
116
- if (!Number.isSafeInteger(latticeLength) || latticeLength > options.latticeCap)
117
- failSurface("TN_IMPLICIT_SURFACE_LATTICE_OVERFLOW", `lattice requires ${latticeLength} samples.`);
118
- const dx = (bounds.maxX - bounds.minX) / nx;
119
- const dy = (bounds.maxY - bounds.minY) / ny;
120
- const dz = (bounds.maxZ - bounds.minZ) / nz;
121
- const cell = Math.max(dx, dy, dz);
122
- const sample = (x: number, y: number, z: number): number => {
123
- const value = options.sample(x, y, z);
124
- if (!Number.isFinite(value)) failSurface("TN_IMPLICIT_SURFACE_SAMPLE_INVALID", `sample at ${x},${y},${z} is not finite.`);
125
- return value === 0 ? 1e-8 : value;
126
- };
127
- const indexOf = (x: number, y: number, z: number): number => x + width * (y + height * z);
128
- const values = new Float64Array(latticeLength);
129
- for (let z = 0; z < depth; z += 1) for (let y = 0; y < height; y += 1) for (let x = 0; x < width; x += 1) {
130
- let value = sample(bounds.minX + x * dx, bounds.minY + y * dy, bounds.minZ + z * dz);
131
- if (options.protectBoundary !== false && (x === 0 || y === 0 || z === 0 || x === nx || y === ny || z === nz)) value = Math.max(value, cell * 0.5);
132
- values[indexOf(x, y, z)] = value;
133
- }
134
- const corners = "000 100 110 010 001 101 111 011".split(" ").map((value) => [...value].map(Number)) as Array<[number, number, number]>;
135
- const tetrahedra = "0516 0126 0236 0376 0746 0456".split(" ").map((value) => [...value].map(Number)) as Array<[number, number, number, number]>;
136
- // biome-ignore format: compact generated lookup stays within the render-source smell budget.
137
- const tetraCases: number[][][][] = [[], [[[0, 1], [0, 2], [0, 3]]], [[[0, 1], [1, 2], [1, 3]]], [[[0, 2], [1, 2], [1, 3]], [[0, 2], [1, 3], [0, 3]]], [[[0, 2], [1, 2], [2, 3]]], [[[0, 1], [1, 2], [2, 3]], [[0, 1], [2, 3], [0, 3]]], [[[0, 1], [1, 3], [2, 3]], [[0, 1], [2, 3], [0, 2]]], [[[0, 3], [1, 3], [2, 3]]], [[[0, 3], [1, 3], [2, 3]]], [[[0, 1], [1, 3], [2, 3]], [[0, 1], [2, 3], [0, 2]]], [[[0, 1], [1, 2], [2, 3]], [[0, 1], [2, 3], [0, 3]]], [[[0, 2], [1, 2], [2, 3]]], [[[0, 2], [1, 2], [1, 3]], [[0, 2], [1, 3], [0, 3]]], [[[0, 1], [1, 2], [1, 3]]], [[[0, 1], [0, 2], [0, 3]]], []];
138
- const positions: number[] = [];
139
- const rawIndices: number[] = [];
140
- const edgeVertices = new Map<string, number>();
141
- const point = (index: number): Point => [bounds.minX + (index % width) * dx, bounds.minY + (Math.floor(index / width) % height) * dy, bounds.minZ + Math.floor(index / (width * height)) * dz];
142
- const edgePoint = (a: number, b: number): number => {
143
- const key = a < b ? `${a}|${b}` : `${b}|${a}`;
144
- const existing = edgeVertices.get(key);
145
- if (existing !== undefined) return existing;
146
- const fa = values[a] as number;
147
- const fb = values[b] as number;
148
- const t = Math.max(0.015, Math.min(0.985, fa / (fa - fb)));
149
- const pa = point(a);
150
- const pb = point(b);
151
- const vertex = positions.length / 3;
152
- positions.push(pa[0] + (pb[0] - pa[0]) * t, pa[1] + (pb[1] - pa[1]) * t, pa[2] + (pb[2] - pa[2]) * t);
153
- edgeVertices.set(key, vertex);
154
- return vertex;
155
- };
156
- for (let z = 0; z < nz; z += 1) for (let y = 0; y < ny; y += 1) for (let x = 0; x < nx; x += 1) {
157
- const indexes: number[] = [];
158
- const field: number[] = [];
159
- for (const corner of corners) {
160
- const index = indexOf(x + corner[0], y + corner[1], z + corner[2]);
161
- indexes.push(index); field.push(values[index] as number);
162
- }
163
- for (const tetrahedron of tetrahedra) {
164
- let code = 0;
165
- for (let corner = 0; corner < 4; corner += 1)
166
- if ((field[tetrahedron[corner] as number] as number) < 0) code |= 1 << corner;
167
- const tetVertex = (crossing: number[]): number =>
168
- edgePoint(indexes[tetrahedron[crossing[0] as number] as number] as number, indexes[tetrahedron[crossing[1] as number] as number] as number);
169
- for (const triangle of tetraCases[code] ?? [])
170
- addSurfaceTriangle(rawIndices, positions, sample, dx, dy, dz, [tetVertex(triangle[0] as number[]), tetVertex(triangle[1] as number[]), tetVertex(triangle[2] as number[])]);
171
- }
172
- }
173
- if (rawIndices.length === 0) failSurface("TN_IMPLICIT_SURFACE_EMPTY", "the field contains no triangles.");
174
- const outputPositions = Float32Array.from(positions);
175
- const outputIndices = Uint32Array.from(rawIndices);
176
- orientSurface(outputIndices);
177
- let report = auditImplicitSurface(outputIndices, outputPositions);
178
- if (report.signedVolume < 0) {
179
- for (let index = 0; index < outputIndices.length; index += 3) {
180
- const swap = outputIndices[index + 1] as number;
181
- outputIndices[index + 1] = outputIndices[index + 2] as number;
182
- outputIndices[index + 2] = swap;
183
- }
184
- report = auditImplicitSurface(outputIndices, outputPositions);
185
- }
186
- if (options.closed !== false && (report.boundaryEdges > 0 || report.degenerateTriangles > 0 || report.windingConflicts > 0))
187
- failSurface("TN_IMPLICIT_SURFACE_TOPOLOGY_INVALID", `boundary=${report.boundaryEdges}, degenerate=${report.degenerateTriangles}, winding=${report.windingConflicts}.`);
188
- if (options.closed !== false && report.signedVolume <= Math.max(cell ** 3 * 0.01, 1e-8))
189
- failSurface("TN_IMPLICIT_SURFACE_VOLUME_INVALID", `signed volume ${report.signedVolume} is not non-trivial.`);
190
- return { indices: outputIndices, positions: outputPositions, report: { ...report, buildMs: Math.max(0, Date.now() - started), cellSize: cell } };
191
- }
192
- return { auditImplicitSurface, buildImplicitSurface };
193
- }
194
- export const { auditImplicitSurface, buildImplicitSurface } = createSurfaceFunctions();
195
-
196
- export function createImplicitSurfaceWorkerSource(): string {
197
- // biome-ignore format: compact generated source list keeps this file under its smell budget.
198
- return `const { auditImplicitSurface, buildImplicitSurface } = (${createSurfaceFunctions.toString()})();`;
199
- }
@@ -1,174 +0,0 @@
1
- // Generated source: the starter owns this painterly algorithm and may replace it freely.
2
- import { HalfFloatType } from "three";
3
- import * as tsl from "three/tsl";
4
- import type { Node } from "three/webgpu";
5
- import { createTextureScope } from "./textureLifetime.js";
6
- export type KernelOffset = { readonly x: number; readonly y: number };
7
- export interface IKuwaharaStageOptions {
8
- readonly anisotropy?: number;
9
- readonly radius?: number;
10
- readonly resolutionScale?: number;
11
- readonly strength?: number;
12
- }
13
- export interface IKuwaharaStage {
14
- readonly after: "outline";
15
- readonly build: (input: unknown) => unknown;
16
- readonly dispose: () => void;
17
- readonly minimumTier: "medium";
18
- readonly name: "kuwahara";
19
- }
20
- function sectorSampleOffsets(radius: number): readonly KernelOffset[] {
21
- const bounded = boundedRadius(radius);
22
- const halfWidth = Math.floor(bounded / 2);
23
- const offsets: KernelOffset[] = [];
24
- for (let radial = 1; radial <= bounded; radial += 1)
25
- for (let tangent = -halfWidth; tangent <= halfWidth; tangent += 1)
26
- offsets.push({ x: radial, y: tangent });
27
- return offsets;
28
- }
29
- export function createKuwaharaStage(options: IKuwaharaStageOptions = {}): IKuwaharaStage {
30
- const anisotropy = finiteRange(options.anisotropy ?? 0.72, 0, 1, false, "kuwahara anisotropy");
31
- const radius = boundedRadius(options.radius ?? 5);
32
- const resolutionScale = finiteRange(
33
- options.resolutionScale ?? 0.5,
34
- 0,
35
- 1,
36
- true,
37
- "kuwahara resolutionScale",
38
- );
39
- const strength = finiteRange(options.strength ?? 0.82, 0, 1, false, "kuwahara strength");
40
- const textureScope = createTextureScope();
41
- const dispose = textureScope.dispose;
42
- return {
43
- after: "outline",
44
- build: (input) => {
45
- if (!isNode(input)) throw new Error("kuwahara input is missing");
46
- if (strength === 0) return input;
47
- dispose();
48
- const source = textureScope.texture(input) as unknown as ITextureNode;
49
- const texel = tsl.screenSize.reciprocal();
50
- const sampleUv = (x: Node<"float"> | number, y: Node<"float"> | number): Node<"vec2"> =>
51
- tsl.screenUV.add(texel.mul(tsl.vec2(x, y))).clamp(0, 1) as Node<"vec2">;
52
- const sampleColour = (x: number, y: number): Node<"float"> =>
53
- tsl.luminance(source.sample(sampleUv(x, y)).rgb);
54
- const gradientX = sampleColour(1, 0).sub(sampleColour(-1, 0)).mul(0.5);
55
- const gradientY = sampleColour(0, 1).sub(sampleColour(0, -1)).mul(0.5);
56
- const tensor = makeHalfFloatScratch(
57
- textureScope,
58
- tsl.vec4(gradientX.mul(gradientX), gradientX.mul(gradientY), gradientY.mul(gradientY), 1),
59
- resolutionScale,
60
- );
61
- const tensorSample = tensor.sample(tsl.screenUV);
62
- const orientation = tsl
63
- .atan(tensorSample.y.mul(2), tensorSample.x.sub(tensorSample.z))
64
- .mul(0.5);
65
- const axis = tsl.vec2(tsl.cos(orientation), tsl.sin(orientation));
66
- const sectorOffsets = sectorSampleOffsets(radius);
67
- const sector = (sectorIndex: number) => {
68
- let mean: Node<"vec3"> = tsl.vec3(0);
69
- let secondMoment: Node<"vec3"> = tsl.vec3(0);
70
- const angle = (sectorIndex / 8) * Math.PI * 2;
71
- const sectorAxis = tsl.vec2(
72
- axis.x.mul(Math.cos(angle)).sub(axis.y.mul(Math.sin(angle))),
73
- axis.y.mul(Math.cos(angle)).add(axis.x.mul(Math.sin(angle))),
74
- );
75
- for (const localOffset of sectorOffsets) {
76
- const offset = transformKernelOffsetNode(
77
- tsl.vec2(localOffset.x, localOffset.y),
78
- sectorAxis,
79
- anisotropy,
80
- );
81
- const colour = source.sample(sampleUv(offset.x, offset.y)).rgb;
82
- mean = mean.add(colour);
83
- secondMoment = secondMoment.add(colour.mul(colour));
84
- }
85
- const average = mean.div(sectorOffsets.length);
86
- const variance = secondMoment.div(sectorOffsets.length).sub(average.mul(average)).max(0);
87
- return { mean: average, score: tsl.luminance(variance) };
88
- };
89
- let best = sector(0);
90
- for (let sectorIndex = 1; sectorIndex < 8; sectorIndex += 1) {
91
- const candidate = sector(sectorIndex);
92
- const candidateWins = candidate.score.lessThan(best.score);
93
- best = {
94
- mean: tsl.select(candidateWins, candidate.mean, best.mean) as Node<"vec3">,
95
- score: tsl.select(candidateWins, candidate.score, best.score) as Node<"float">,
96
- };
97
- }
98
- const base = source.sample(tsl.screenUV);
99
- const paint = makeHalfFloatScratch(
100
- textureScope,
101
- tsl.vec4(best.mean, base.a),
102
- resolutionScale,
103
- );
104
- return mixColour(base, paint.sample(tsl.screenUV).rgb, strength);
105
- },
106
- dispose,
107
- minimumTier: "medium",
108
- name: "kuwahara",
109
- };
110
- }
111
- interface ITextureNode extends Node<"vec4"> {
112
- sample(uv: Node<"vec2">): Node<"vec4">;
113
- }
114
- function makeHalfFloatScratch(
115
- scope: ReturnType<typeof createTextureScope>,
116
- node: Node<"vec4">,
117
- resolutionScale: number,
118
- ): IRawScratch {
119
- let scratch: IRawScratch | undefined;
120
- try {
121
- scratch = scope.own(
122
- tsl.rtt(node, null, null, { type: HalfFloatType }) as unknown as IRawScratch,
123
- );
124
- scratch.setResolutionScale(resolutionScale);
125
- } catch (error) {
126
- scope.dispose();
127
- throw new Error(
128
- `kuwahara scratch allocation failed: ${error instanceof Error ? error.message : String(error)}`,
129
- );
130
- }
131
- if (scratch.renderTarget.texture.type !== HalfFloatType) {
132
- scope.dispose();
133
- throw new Error("kuwahara scratch format is not half-float");
134
- }
135
- return scratch;
136
- }
137
- interface IRawScratch extends ITextureNode {
138
- readonly renderTarget: { readonly texture: { readonly type: number }; dispose: () => void };
139
- setResolutionScale(scale: number): void;
140
- }
141
- function transformKernelOffsetNode(
142
- offset: Node<"vec2">,
143
- axis: Node<"vec2">,
144
- anisotropy: number,
145
- ): Node<"vec2"> {
146
- const scaled = tsl.vec2(offset.x.mul(1 + anisotropy), offset.y.mul(1 - anisotropy));
147
- return tsl.vec2(
148
- axis.x.mul(scaled.x).sub(axis.y.mul(scaled.y)),
149
- axis.y.mul(scaled.x).add(axis.x.mul(scaled.y)),
150
- );
151
- }
152
- function mixColour(base: Node<"vec4">, paint: Node<"vec3">, strength: number): Node<"vec4"> {
153
- return tsl.mix(base, tsl.vec4(paint, base.a), strength) as Node<"vec4">;
154
- }
155
- function boundedRadius(value: number): number {
156
- if (!Number.isInteger(value) || value < 1 || value > 9)
157
- throw new Error("kuwahara radius must be an integer from 1 through 9");
158
- return value;
159
- }
160
- function finiteRange(
161
- value: number,
162
- minimum: number,
163
- maximum: number,
164
- exclusiveMinimum: boolean,
165
- name: string,
166
- ): number {
167
- const lower = exclusiveMinimum ? value <= minimum : value < minimum;
168
- if (!Number.isFinite(value) || lower || value > maximum)
169
- throw new Error(`${name} must be finite and in range`);
170
- return value;
171
- }
172
- function isNode(value: unknown): value is Node {
173
- return !!value && typeof value === "object" && (value as { isNode?: boolean }).isNode === true;
174
- }
@@ -1,141 +0,0 @@
1
- // Generated source. This stage is ordinary Three.js TSL; the engine only orders and measures it.
2
-
3
- import {
4
- cameraFar,
5
- cameraNear,
6
- color,
7
- luminance,
8
- mix,
9
- perspectiveDepthToViewZ,
10
- screenSize,
11
- screenUV,
12
- texture,
13
- vec2,
14
- vec4,
15
- } from "three/tsl";
16
- import type { Node } from "three/webgpu";
17
- import { createTextureScope } from "./textureLifetime.js";
18
-
19
- export interface IOutlineStageOptions {
20
- /** The depth attachment written by the scene pass. */
21
- readonly depthNode: Node;
22
- /** Ink colour and thresholds are this game's look decisions. */
23
- readonly inkColor?: number;
24
- readonly strength?: number;
25
- readonly threshold?: number;
26
- readonly softness?: number;
27
- readonly depthWeight?: number;
28
- }
29
-
30
- export interface IOutlineStage {
31
- readonly after: "bloom";
32
- readonly build: (input: unknown) => unknown;
33
- readonly dispose: () => void;
34
- readonly name: "outline";
35
- }
36
-
37
- /**
38
- * Eight-tap Sobel edge ink, normalised to the physical framebuffer pixel size.
39
- *
40
- * Colour edges catch the painted prop boundaries while linearised depth catches silhouettes
41
- * whose two sides happen to have similar colours. The stage samples the original chain input
42
- * and never owns a material, palette or renderer fallback.
43
- */
44
- export function createOutlineStage(options: IOutlineStageOptions): IOutlineStage {
45
- if (!isNode(options.depthNode)) throw new Error("outline depth source is missing");
46
- const strength = finiteNonNegative(options.strength ?? 0.8, "outline strength");
47
- const threshold = finiteNonNegative(options.threshold ?? 0.12, "outline threshold");
48
- const softness = finitePositive(options.softness ?? 0.16, "outline softness");
49
- const depthWeight = finiteUnit(options.depthWeight ?? 0.65, "outline depthWeight");
50
- const colourWeight = 1 - depthWeight;
51
- const ink = color(options.inkColor ?? 0x142331);
52
- const textureScope = createTextureScope();
53
-
54
- return {
55
- after: "bloom",
56
- build: (input) => {
57
- textureScope.dispose();
58
- if (!isNode(input)) throw new Error("outline input is missing");
59
- if (strength === 0) return input;
60
- const source = textureScope.texture(input) as unknown as ITextureNode;
61
- const depthSource = texture(options.depthNode as never);
62
- const texel = screenSize.reciprocal();
63
- const sampleUv = (x: number, y: number): Node<"vec2"> =>
64
- screenUV.add(texel.mul(vec2(x, y))).clamp(0, 1) as Node<"vec2">;
65
- const sampleColour = (x: number, y: number): Node<"float"> =>
66
- luminance(source.sample(sampleUv(x, y)).rgb);
67
- const sampleDepth = (x: number, y: number): Node<"float"> =>
68
- perspectiveDepthToViewZ(depthSource.sample(sampleUv(x, y)).r, cameraNear, cameraFar);
69
-
70
- // Sobel's eight neighbours use physical-pixel offsets, so a resize does not change the
71
- // apparent line width. This is the same eight-tap neighbourhood for colour and depth.
72
- const colourX = sampleColour(-1, -1)
73
- .negate()
74
- .add(sampleColour(-1, 0).mul(-2))
75
- .add(sampleColour(-1, 1).negate())
76
- .add(sampleColour(1, -1))
77
- .add(sampleColour(1, 0).mul(2))
78
- .add(sampleColour(1, 1));
79
- const colourY = sampleColour(-1, -1)
80
- .negate()
81
- .add(sampleColour(0, -1).mul(-2))
82
- .add(sampleColour(1, -1).negate())
83
- .add(sampleColour(-1, 1))
84
- .add(sampleColour(0, 1).mul(2))
85
- .add(sampleColour(1, 1));
86
- const depthX = sampleDepth(-1, -1)
87
- .negate()
88
- .add(sampleDepth(-1, 0).mul(-2))
89
- .add(sampleDepth(-1, 1).negate())
90
- .add(sampleDepth(1, -1))
91
- .add(sampleDepth(1, 0).mul(2))
92
- .add(sampleDepth(1, 1));
93
- const depthY = sampleDepth(-1, -1)
94
- .negate()
95
- .add(sampleDepth(0, -1).mul(-2))
96
- .add(sampleDepth(1, -1).negate())
97
- .add(sampleDepth(-1, 1))
98
- .add(sampleDepth(0, 1).mul(2))
99
- .add(sampleDepth(1, 1));
100
- const centreDepth = sampleDepth(0, 0).abs().max(1);
101
- const colourEdge = colourX.mul(colourX).add(colourY.mul(colourY)).sqrt();
102
- const depthEdge = depthX.mul(depthX).add(depthY.mul(depthY)).sqrt().div(centreDepth);
103
- const edge = colourEdge.mul(colourWeight).add(depthEdge.mul(depthWeight));
104
- const mask = edge
105
- .smoothstep(threshold, threshold + softness)
106
- .mul(strength)
107
- .clamp(0, 1);
108
- const base = source.sample(screenUV);
109
- return mix(base, vec4(ink, base.a), mask);
110
- },
111
- dispose: textureScope.dispose,
112
- name: "outline",
113
- };
114
- }
115
-
116
- interface ITextureNode extends Node<"vec4"> {
117
- sample(uv: Node<"vec2">): Node<"vec4">;
118
- }
119
-
120
- function isNode(value: unknown): value is Node {
121
- return (
122
- typeof value === "object" && value !== null && (value as { isNode?: boolean }).isNode === true
123
- );
124
- }
125
-
126
- function finiteNonNegative(value: number, name: string): number {
127
- if (!Number.isFinite(value) || value < 0)
128
- throw new Error(`${name} must be finite and non-negative`);
129
- return value;
130
- }
131
-
132
- function finitePositive(value: number, name: string): number {
133
- if (!Number.isFinite(value) || value <= 0) throw new Error(`${name} must be finite and positive`);
134
- return value;
135
- }
136
-
137
- function finiteUnit(value: number, name: string): number {
138
- if (!Number.isFinite(value) || value < 0 || value > 1)
139
- throw new Error(`${name} must be finite and between 0 and 1`);
140
- return value;
141
- }
@@ -1,86 +0,0 @@
1
- // The starter's painterly look: an ink outline, a Kuwahara smear, and a watercolour wash.
2
- //
3
- // This file exists because `worldEnvironment.ts` may not contain it. That file is the render-chain
4
- // plumbing every kit copies verbatim, and `shared-render-sources.spec.ts` fails when one kit's copy
5
- // stops matching the others — which is exactly what happens when a kit's own art direction is
6
- // written into it. Bloom and vignette live in there because they are grading primitives every kit
7
- // wants; kuwahara, outline and watercolour are one kit's aesthetic, and an aesthetic shipped into
8
- // ten kits so that one can use it is the preset system the charter closed with evidence.
9
- //
10
- // So the plumbing exposes a seam — `authoredStageNames` and `authoredStages` — and this is what the
11
- // starter passes through it.
12
-
13
- import { createKuwaharaStage } from "./kuwahara.js";
14
- import { createOutlineStage } from "./outline.js";
15
- import { createWatercolorStage } from "./watercolor.js";
16
- import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
17
-
18
- /** The knobs the quality presets set. Every one is this kit's, not the framework's. */
19
- export interface IPainterlyOptions {
20
- readonly outlineEnabled?: boolean;
21
- readonly outlineInkColor?: number;
22
- readonly outlineStrength?: number;
23
- readonly outlineThreshold?: number;
24
- readonly outlineSoftness?: number;
25
- readonly outlineDepthWeight?: number;
26
- readonly kuwaharaEnabled?: boolean;
27
- readonly kuwaharaRadius?: number;
28
- readonly kuwaharaResolutionScale?: number;
29
- readonly kuwaharaAnisotropy?: number;
30
- readonly kuwaharaStrength?: number;
31
- readonly watercolorEnabled?: boolean;
32
- readonly watercolorLevels?: number;
33
- readonly watercolorPaperStrength?: number;
34
- readonly watercolorShadowStrength?: number;
35
- readonly watercolorShadowTint?: number;
36
- readonly watercolorStrength?: number;
37
- }
38
-
39
- /**
40
- * Which stages run, in chain order.
41
- *
42
- * The chain reads this before the scene pass exists — with nothing requested it sets an exposure
43
- * and never builds a pass at all — so it has to be answerable from the options alone.
44
- */
45
- export function painterlyStageNames(options: IPainterlyOptions): readonly string[] {
46
- const names: string[] = [];
47
- if (options.outlineEnabled === true) names.push("outline");
48
- if (options.kuwaharaEnabled === true) names.push("kuwahara");
49
- if (options.watercolorEnabled === true) names.push("watercolor");
50
- return names;
51
- }
52
-
53
- /**
54
- * The complete authored graph, dormant stages included.
55
- *
56
- * All three are always defined even when only one is requested, because `watercolor after
57
- * kuwahara` and `kuwahara after outline` are anchors that must keep naming a stage that exists —
58
- * otherwise enabling one stage on its own resolves against a name the chain never heard of.
59
- */
60
- export function painterlyStages(
61
- options: IPainterlyOptions,
62
- ): (context: IWorldEnvironmentStageContext) => readonly ChainStage[] {
63
- return ({ depthNode }) => [
64
- createOutlineStage({
65
- depthNode,
66
- depthWeight: options.outlineDepthWeight ?? 0.65,
67
- inkColor: options.outlineInkColor ?? 0x142331,
68
- softness: options.outlineSoftness ?? 0.16,
69
- strength: options.outlineStrength ?? 0.8,
70
- threshold: options.outlineThreshold ?? 0.12,
71
- }),
72
- createKuwaharaStage({
73
- anisotropy: options.kuwaharaAnisotropy ?? 0.72,
74
- radius: options.kuwaharaRadius ?? 5,
75
- resolutionScale: options.kuwaharaResolutionScale ?? 0.5,
76
- strength: options.kuwaharaStrength ?? 0.82,
77
- }),
78
- createWatercolorStage({
79
- levels: options.watercolorLevels ?? 8,
80
- paperStrength: options.watercolorPaperStrength ?? 0.2,
81
- shadowStrength: options.watercolorShadowStrength ?? 0.16,
82
- shadowTint: options.watercolorShadowTint ?? 0x6d5a52,
83
- strength: options.watercolorStrength ?? 0.72,
84
- }),
85
- ];
86
- }