create-threenative 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,270 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { TARGET_MODES, TOTAL_WAVES, TOWERS, TOWER_KINDS, type TowerKind } from "../balance.js";
3
+ import type { GameState } from "../state.js";
4
+ import { TowerIcon } from "./icons.js";
5
+
6
+ const KIND_TEXT: Record<TowerKind, string> = {
7
+ arc: "text-arc",
8
+ cryo: "text-cryo",
9
+ mortar: "text-mortar",
10
+ sentry: "text-sentry",
11
+ };
12
+
13
+ const KIND_RING: Record<TowerKind, string> = {
14
+ arc: "border-arc/70 bg-arc/10",
15
+ cryo: "border-cryo/70 bg-cryo/10",
16
+ mortar: "border-mortar/70 bg-mortar/10",
17
+ sentry: "border-sentry/70 bg-sentry/10",
18
+ };
19
+
20
+ const PANEL =
21
+ "rounded-xl border border-line bg-panel/85 backdrop-blur-md shadow-xl shadow-black/30";
22
+ const BUTTON =
23
+ "pointer-events-auto rounded-lg border border-line bg-white/5 px-3 py-1.5 text-[12px] font-medium text-text transition hover:bg-white/10 active:scale-95 disabled:opacity-40 disabled:hover:bg-white/5";
24
+
25
+ function Stat({
26
+ id,
27
+ label,
28
+ value,
29
+ tone = "text-text",
30
+ }: { id: string; label: string; value: string; tone?: string }) {
31
+ return (
32
+ <div className={`${PANEL} px-4 py-2`}>
33
+ <div className="text-[10px] font-semibold uppercase tracking-[0.18em] text-muted">
34
+ {label}
35
+ </div>
36
+ <div className={`text-[22px] font-semibold leading-tight tabular-nums ${tone}`} id={id}>
37
+ {value}
38
+ </div>
39
+ </div>
40
+ );
41
+ }
42
+
43
+ function WaveBar({ state }: { state: GameState }) {
44
+ const send = useUiIntent();
45
+ const building = state.phase === "build";
46
+ const finished = state.wave >= TOTAL_WAVES && building;
47
+ return (
48
+ <div
49
+ className={`${PANEL} pointer-events-auto flex items-center gap-4 px-4 py-2`}
50
+ data-tn-interactive
51
+ >
52
+ <div className="min-w-[150px]">
53
+ <div className="text-[10px] font-semibold uppercase tracking-[0.18em] text-muted">
54
+ {building ? "Build phase" : "Combat"}
55
+ </div>
56
+ <div className="text-[13px] text-text">
57
+ {building
58
+ ? "Place towers, then launch"
59
+ : `${state.hostiles} hostiles ${state.hostiles === 1 ? "remaining" : "remaining"}`}
60
+ </div>
61
+ </div>
62
+ <div className="flex gap-1" aria-label={`Wave ${state.wave} of ${TOTAL_WAVES}`}>
63
+ {Array.from({ length: TOTAL_WAVES }, (_, index) => index + 1).map((number) => (
64
+ <span
65
+ className={`h-2 w-3 rounded-sm ${number <= state.wave ? "bg-accent" : "bg-white/12"} ${number === state.wave && !building ? "animate-pulse" : ""}`}
66
+ key={number}
67
+ />
68
+ ))}
69
+ </div>
70
+ <button
71
+ className={`${BUTTON} ${building && !finished ? "ready border-accent/60 bg-accent/15 text-accent" : ""} min-w-[128px]`}
72
+ data-tn-interactive
73
+ disabled={!building || finished}
74
+ onClick={() => send("launch")}
75
+ type="button"
76
+ >
77
+ {finished ? "Complete" : building ? `Launch wave ${state.wave + 1}` : "In progress"}
78
+ </button>
79
+ <button className={BUTTON} data-tn-interactive onClick={() => send("speed")} type="button">
80
+ {state.speed}×
81
+ </button>
82
+ <button
83
+ className={BUTTON}
84
+ data-tn-interactive
85
+ onClick={() => send(state.paused ? "resume" : "pause")}
86
+ type="button"
87
+ >
88
+ {state.paused ? "Resume" : "Pause"}
89
+ </button>
90
+ <button
91
+ className={`${BUTTON} ${state.autoSend ? "border-accent/60 text-accent" : ""}`}
92
+ data-tn-interactive
93
+ onClick={() => send("autosend")}
94
+ type="button"
95
+ >
96
+ Auto {state.autoSend ? "on" : "off"}
97
+ </button>
98
+ </div>
99
+ );
100
+ }
101
+
102
+ function Armory({ state }: { state: GameState }) {
103
+ const send = useUiIntent();
104
+ return (
105
+ <div className={`${PANEL} p-3`}>
106
+ <div className="mb-2 flex items-baseline justify-between px-1">
107
+ <div className="text-[10px] font-semibold uppercase tracking-[0.18em] text-muted">
108
+ Armory
109
+ </div>
110
+ <div className="text-[10px] text-muted">click a pad to build</div>
111
+ </div>
112
+ <div className="flex flex-col gap-1.5">
113
+ {TOWER_KINDS.map((kind, index) => {
114
+ const tower = TOWERS[kind];
115
+ const armed = state.armed === kind;
116
+ const poor = state.credits < tower.cost;
117
+ return (
118
+ <button
119
+ className={`pointer-events-auto flex items-center gap-3 rounded-lg border px-2.5 py-2 text-left transition hover:bg-white/8 active:scale-[0.98] ${armed ? KIND_RING[kind] : "border-line bg-white/4"} ${poor && !armed ? "opacity-55" : ""}`}
120
+ data-tn-interactive
121
+ key={kind}
122
+ onClick={() => send("arm", kind)}
123
+ type="button"
124
+ >
125
+ <TowerIcon kind={kind} />
126
+ <span className="min-w-0 flex-1">
127
+ <span className={`block text-[13px] font-semibold ${KIND_TEXT[kind]}`}>
128
+ {tower.name}
129
+ </span>
130
+ <span className="block truncate text-[11px] text-muted">{tower.role}</span>
131
+ </span>
132
+ <span className="text-right">
133
+ <span className="block text-[13px] font-semibold tabular-nums text-gold">
134
+ {tower.cost}
135
+ </span>
136
+ <span className="block text-[10px] text-muted">[{index + 1}]</span>
137
+ </span>
138
+ </button>
139
+ );
140
+ })}
141
+ </div>
142
+ </div>
143
+ );
144
+ }
145
+
146
+ function Selection({ state }: { state: GameState }) {
147
+ const send = useUiIntent();
148
+ if (!state.selected || state.selKind === "") return null;
149
+ const kind = state.selKind;
150
+ const maxed = state.selUpgrade === 0;
151
+ return (
152
+ <div className={`${PANEL} p-3`}>
153
+ <div className="mb-2 flex items-center gap-3 px-1">
154
+ <TowerIcon kind={kind} size={30} />
155
+ <div className="flex-1">
156
+ <div className={`text-[14px] font-semibold ${KIND_TEXT[kind]}`}>{TOWERS[kind].name}</div>
157
+ <div className="text-[11px] text-muted">
158
+ MK.{"I".repeat(state.selLevel)} · {state.selDamage} dmg · {state.selRange} m
159
+ </div>
160
+ </div>
161
+ </div>
162
+ <div className="mb-2 grid grid-cols-3 gap-1">
163
+ {TARGET_MODES.map((mode) => (
164
+ <button
165
+ className={`${BUTTON} px-1 capitalize ${state.selMode === mode ? "border-accent/60 bg-accent/15 text-accent" : ""}`}
166
+ data-tn-interactive
167
+ key={mode}
168
+ onClick={() => send("target", mode)}
169
+ type="button"
170
+ >
171
+ {mode}
172
+ </button>
173
+ ))}
174
+ </div>
175
+ <div className="grid grid-cols-2 gap-1.5">
176
+ <button
177
+ className={`${BUTTON} ${!maxed && state.credits >= state.selUpgrade ? "border-gold/60 text-gold" : ""}`}
178
+ data-tn-interactive
179
+ disabled={maxed}
180
+ onClick={() => send("upgrade")}
181
+ type="button"
182
+ >
183
+ {maxed ? "Max level" : `Upgrade ${state.selUpgrade}`}
184
+ </button>
185
+ <button
186
+ className={BUTTON}
187
+ data-tn-interactive
188
+ onClick={() => send("recycle")}
189
+ type="button"
190
+ >
191
+ Recycle +{state.selSell}
192
+ </button>
193
+ </div>
194
+ </div>
195
+ );
196
+ }
197
+
198
+ function Strike({ state }: { state: GameState }) {
199
+ const send = useUiIntent();
200
+ const ready = state.strikeCooldown === 0 && state.phase === "combat";
201
+ return (
202
+ <button
203
+ className={`${PANEL} pointer-events-auto flex items-center gap-3 px-4 py-2.5 text-left transition hover:bg-white/8 active:scale-[0.98] ${state.strikeArmed ? "border-gold/80 bg-gold/15" : ""}`}
204
+ data-tn-interactive
205
+ onClick={() => send("strike")}
206
+ type="button"
207
+ >
208
+ <span
209
+ className={`grid h-8 w-8 place-items-center rounded-lg text-[15px] ${ready ? "bg-gold/20 text-gold" : "bg-white/6 text-muted"}`}
210
+ >
211
+ ✦
212
+ </span>
213
+ <span>
214
+ <span className="block text-[13px] font-semibold text-text">Orbital strike</span>
215
+ <span className="block text-[11px] text-muted">
216
+ {state.strikeArmed
217
+ ? "click the board to fire"
218
+ : state.strikeCooldown > 0
219
+ ? `recharging ${state.strikeCooldown}s`
220
+ : state.phase === "combat"
221
+ ? "ready · F"
222
+ : "needs a wave · F"}
223
+ </span>
224
+ </span>
225
+ </button>
226
+ );
227
+ }
228
+
229
+ export function Hud() {
230
+ const state = useUiState<GameState>();
231
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
232
+ // Rendering zeroes instead would put wrong numbers on screen and then correct them.
233
+ if (state === undefined) return null;
234
+ const danger = state.lives <= 8;
235
+ return (
236
+ <div className="pointer-events-none absolute inset-0 select-none p-4 text-text">
237
+ <div className="flex items-start justify-between gap-3">
238
+ <div className="flex gap-2">
239
+ <Stat id="balance" label="Credits" tone="text-gold" value={String(state.credits)} />
240
+ <Stat
241
+ id="lives"
242
+ label="Reactor"
243
+ tone={danger ? "text-danger" : "text-text"}
244
+ value={`${state.lives}/25`}
245
+ />
246
+ <Stat
247
+ id="wave"
248
+ label="Wave"
249
+ value={`${String(state.wave).padStart(2, "0")}/${TOTAL_WAVES}`}
250
+ />
251
+ </div>
252
+ <WaveBar state={state} />
253
+ </div>
254
+ <div className="absolute right-4 top-[92px] flex w-[256px] flex-col gap-2">
255
+ <Armory state={state} />
256
+ <Selection state={state} />
257
+ </div>
258
+ <div className="absolute bottom-4 left-4">
259
+ <Strike state={state} />
260
+ </div>
261
+ {state.toast !== "" && (
262
+ <div className="absolute bottom-16 left-1/2 -translate-x-1/2" key={state.toastSeq}>
263
+ <div className={`${PANEL} toast px-5 py-2 text-[13px] font-medium text-text`}>
264
+ {state.toast}
265
+ </div>
266
+ </div>
267
+ )}
268
+ </div>
269
+ );
270
+ }
@@ -0,0 +1,134 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { TOWERS, TOWER_KINDS } from "../balance.js";
3
+ import type { GameState } from "../state.js";
4
+ import { TowerIcon } from "./icons.js";
5
+
6
+ const PANEL =
7
+ "rounded-2xl border border-line bg-panel/95 backdrop-blur-md shadow-2xl shadow-black/50";
8
+ const BUTTON =
9
+ "pointer-events-auto rounded-lg border border-line bg-white/5 px-4 py-2 text-[13px] font-medium text-text transition hover:bg-white/10 active:scale-95";
10
+
11
+ const CONTROLS: readonly (readonly [string, string])[] = [
12
+ ["1 – 4", "arm a tower, then click a pad"],
13
+ ["Space", "launch the next wave"],
14
+ ["U / X", "upgrade / recycle the selected tower"],
15
+ ["F", "orbital strike, then click the board"],
16
+ ["P", "tactical pause"],
17
+ ["Right-drag · wheel · Q E", "orbit and zoom the board"],
18
+ ["Shift-click", "keep building the same tower"],
19
+ ];
20
+
21
+ function Help() {
22
+ const send = useUiIntent();
23
+ return (
24
+ <div
25
+ className="pointer-events-auto absolute inset-0 grid place-items-center bg-black/55"
26
+ data-tn-interactive
27
+ >
28
+ <div className={`${PANEL} w-[560px] max-w-[92vw] p-6`}>
29
+ <div className="text-[10px] font-semibold uppercase tracking-[0.2em] text-accent">
30
+ Field briefing
31
+ </div>
32
+ <div className="mt-1 text-[22px] font-semibold text-text">
33
+ A little firepower. A lot of good positioning.
34
+ </div>
35
+ <div className="mt-4 grid grid-cols-2 gap-2">
36
+ {TOWER_KINDS.map((kind) => (
37
+ <div
38
+ className="flex items-center gap-3 rounded-lg border border-line bg-white/4 p-2.5"
39
+ key={kind}
40
+ >
41
+ <TowerIcon kind={kind} />
42
+ <div className="text-[12px]">
43
+ <div className="font-semibold text-text">{TOWERS[kind].name}</div>
44
+ <div className="text-muted">{TOWERS[kind].role}</div>
45
+ </div>
46
+ </div>
47
+ ))}
48
+ </div>
49
+ <div className="mt-4 divide-y divide-line text-[12px]">
50
+ {CONTROLS.map(([keys, action]) => (
51
+ <div className="flex justify-between py-1.5" key={keys}>
52
+ <span className="font-medium text-accent">{keys}</span>
53
+ <span className="text-muted">{action}</span>
54
+ </div>
55
+ ))}
56
+ </div>
57
+ <div className="mt-5 flex justify-end">
58
+ <button className={BUTTON} data-tn-interactive onClick={() => send("help")} type="button">
59
+ Back to the board
60
+ </button>
61
+ </div>
62
+ </div>
63
+ </div>
64
+ );
65
+ }
66
+
67
+ function Result({ state }: { state: GameState }) {
68
+ const send = useUiIntent();
69
+ const won = state.status === "WON";
70
+ return (
71
+ <div
72
+ className="pointer-events-auto absolute inset-0 grid place-items-center bg-black/55"
73
+ data-tn-interactive
74
+ >
75
+ <div className={`${PANEL} w-[420px] max-w-[92vw] p-7 text-center`}>
76
+ <div
77
+ className={`text-[10px] font-semibold uppercase tracking-[0.24em] ${won ? "text-win" : "text-danger"}`}
78
+ >
79
+ {won ? "Reactor secured" : "Reactor lost"}
80
+ </div>
81
+ <div className="mt-1 text-[28px] font-semibold text-text" id="status">
82
+ {won ? "The line held" : "The line broke"}
83
+ </div>
84
+ <div className="mt-5 grid grid-cols-3 gap-2 text-[12px]">
85
+ {(
86
+ [
87
+ ["Wave", `${state.wave}/12`],
88
+ ["Kills", String(state.kills)],
89
+ ["Score", String(state.score)],
90
+ ] as const
91
+ ).map(([label, value]) => (
92
+ <div className="rounded-lg border border-line bg-white/4 py-2" key={label}>
93
+ <div className="text-[10px] uppercase tracking-[0.16em] text-muted">{label}</div>
94
+ <div className="text-[18px] font-semibold tabular-nums text-text">{value}</div>
95
+ </div>
96
+ ))}
97
+ </div>
98
+ <button
99
+ className={`${BUTTON} mt-6 border-accent/60 bg-accent/15 text-accent`}
100
+ data-tn-interactive
101
+ onClick={() => send("restart")}
102
+ type="button"
103
+ >
104
+ Defend again · R
105
+ </button>
106
+ </div>
107
+ </div>
108
+ );
109
+ }
110
+
111
+ export function Menu() {
112
+ const state = useUiState<GameState>();
113
+ const send = useUiIntent();
114
+ if (state === undefined) return null;
115
+ if (state.status !== "PLAYING") return <Result state={state} />;
116
+ if (state.helpOpen) return <Help />;
117
+ return (
118
+ <>
119
+ {state.paused && (
120
+ <div className="pointer-events-none absolute left-1/2 top-24 -translate-x-1/2 rounded-full border border-line bg-panel/90 px-5 py-1.5 text-[11px] font-semibold uppercase tracking-[0.3em] text-accent">
121
+ Tactical pause
122
+ </div>
123
+ )}
124
+ <button
125
+ className={`${BUTTON} absolute bottom-4 right-4 py-1.5 text-[12px] text-muted`}
126
+ data-tn-interactive
127
+ onClick={() => send("help")}
128
+ type="button"
129
+ >
130
+ Help · H
131
+ </button>
132
+ </>
133
+ );
134
+ }
@@ -0,0 +1,54 @@
1
+ import type { TowerKind } from "../balance.js";
2
+
3
+ const COLOR: Record<TowerKind, string> = {
4
+ arc: "#b1a0ef",
5
+ cryo: "#7acddb",
6
+ mortar: "#f18c6d",
7
+ sentry: "#e9c46a",
8
+ };
9
+
10
+ /** A tower's badge: the same silhouette the 3D model has, drawn in its own colour. */
11
+ export function TowerIcon({ kind, size = 34 }: { kind: TowerKind; size?: number }) {
12
+ const c = COLOR[kind];
13
+ return (
14
+ <svg width={size} height={size} viewBox="0 0 34 34" aria-hidden="true">
15
+ <rect x="2" y="2" width="30" height="30" rx="8" fill="#0f1a16" />
16
+ <ellipse cx="17" cy="26" rx="10" ry="3.6" fill="#293e3c" />
17
+ {kind === "sentry" && (
18
+ <>
19
+ <rect x="9" y="14" width="16" height="8" rx="2" fill={c} />
20
+ <rect x="11" y="8" width="3" height="8" fill="#52645e" />
21
+ <rect x="20" y="8" width="3" height="8" fill="#52645e" />
22
+ </>
23
+ )}
24
+ {kind === "mortar" && (
25
+ <>
26
+ <rect x="9" y="17" width="16" height="6" rx="2" fill={c} />
27
+ <rect
28
+ x="13"
29
+ y="6"
30
+ width="7"
31
+ height="14"
32
+ rx="2.5"
33
+ fill="#52645e"
34
+ transform="rotate(24 17 14)"
35
+ />
36
+ </>
37
+ )}
38
+ {kind === "arc" && (
39
+ <>
40
+ <ellipse cx="17" cy="21" rx="8" ry="2.6" fill="none" stroke={c} strokeWidth="2" />
41
+ <ellipse cx="17" cy="16" rx="6" ry="2.2" fill="none" stroke={c} strokeWidth="2" />
42
+ <circle cx="17" cy="9.5" r="3.6" fill={c} />
43
+ </>
44
+ )}
45
+ {kind === "cryo" && (
46
+ <>
47
+ <rect x="9" y="9" width="6" height="14" rx="3" fill={c} />
48
+ <rect x="19" y="9" width="6" height="14" rx="3" fill={c} />
49
+ <rect x="11" y="6" width="12" height="3" rx="1.5" fill="#52645e" />
50
+ </>
51
+ )}
52
+ </svg>
53
+ );
54
+ }
@@ -0,0 +1,14 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+
5
+ /**
6
+ * The UI entry the native web view loads.
7
+ *
8
+ * It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
9
+ * it in the native runtime and reaches it only through published state and intents, which is why
10
+ * this file imports no game code at all.
11
+ */
12
+ const root = document.getElementById("tn-ui");
13
+ if (root === null) throw new Error("Missing #tn-ui element.");
14
+ createRoot(root).render(<GameUi />);
@@ -0,0 +1,90 @@
1
+ import { AUTO_SEND_DELAY, type ISpawn, TOTAL_WAVES, buildWave } from "./balance.js";
2
+
3
+ export type WavePhase = "build" | "combat";
4
+
5
+ /**
6
+ * Launches waves and knows when one is over. Pure game-time bookkeeping: it is told how many
7
+ * enemies and shells are still alive and never looks at a scene, so it runs the same in a spec.
8
+ */
9
+ export class WaveDirector {
10
+ autoSend = false;
11
+ #wave = 0;
12
+ #phase: WavePhase = "build";
13
+ #queue: ISpawn[] = [];
14
+ #cursor = 0;
15
+ #timer = 0;
16
+ #leaked = false;
17
+ #idle = 0;
18
+ #won = false;
19
+ readonly #onSpawn: (spawn: ISpawn, wave: number) => void;
20
+ readonly #onCleared: (wave: number, leaked: boolean) => void;
21
+
22
+ constructor(options: {
23
+ readonly onSpawn: (spawn: ISpawn, wave: number) => void;
24
+ readonly onCleared: (wave: number, leaked: boolean) => void;
25
+ }) {
26
+ this.#onSpawn = options.onSpawn;
27
+ this.#onCleared = options.onCleared;
28
+ }
29
+
30
+ get wave(): number {
31
+ return this.#wave;
32
+ }
33
+
34
+ get phase(): WavePhase {
35
+ return this.#phase;
36
+ }
37
+
38
+ get won(): boolean {
39
+ return this.#won;
40
+ }
41
+
42
+ /** Enemies still to be released in the wave that is running. */
43
+ get queued(): number {
44
+ return this.#queue.length - this.#cursor;
45
+ }
46
+
47
+ /** Starts the next wave. Only from the build phase, and never past the last wave. */
48
+ launch(): boolean {
49
+ if (this.#phase !== "build" || this.#wave >= TOTAL_WAVES) return false;
50
+ this.#wave += 1;
51
+ this.#queue = buildWave(this.#wave);
52
+ this.#cursor = 0;
53
+ this.#timer = this.#queue[0]?.delay ?? 0;
54
+ this.#leaked = false;
55
+ this.#idle = 0;
56
+ this.#phase = "combat";
57
+ return true;
58
+ }
59
+
60
+ markLeak(): void {
61
+ this.#leaked = true;
62
+ }
63
+
64
+ update(dt: number, alive: number, inFlight = 0): void {
65
+ if (!Number.isFinite(dt) || dt < 0) throw new Error("WaveDirector delta must be finite.");
66
+ if (this.#phase === "build") {
67
+ if (this.autoSend && !this.#won && this.#wave < TOTAL_WAVES) {
68
+ this.#idle += dt;
69
+ if (this.#idle >= AUTO_SEND_DELAY) this.launch();
70
+ }
71
+ return;
72
+ }
73
+ this.#timer -= dt;
74
+ // `alive` was counted before this call, so an enemy released now is not in it yet.
75
+ let released = 0;
76
+ while (this.#cursor < this.#queue.length && this.#timer <= 0) {
77
+ const spawn = this.#queue[this.#cursor];
78
+ if (spawn === undefined) break;
79
+ this.#cursor += 1;
80
+ released += 1;
81
+ this.#onSpawn(spawn, this.#wave);
82
+ this.#timer += this.#queue[this.#cursor]?.delay ?? 0;
83
+ }
84
+ if (this.#cursor < this.#queue.length || alive + released > 0 || inFlight > 0) return;
85
+ this.#phase = "build";
86
+ this.#idle = 0;
87
+ if (this.#wave >= TOTAL_WAVES) this.#won = true;
88
+ this.#onCleared(this.#wave, this.#leaked);
89
+ }
90
+ }
@@ -13,7 +13,9 @@ const config: IThreeNativeConfig = {
13
13
  orientation: "landscape",
14
14
  fullscreen: true,
15
15
  keepScreenOn: true,
16
- maxFps: 60,
16
+ // No `maxFps`: the engine targets the display's own refresh rate, capped at 120 on desktop
17
+ // and web and 60 on mobile, and reports the resolved value in every `TN_FRAME_BUDGET` window.
18
+ // Set a number to override it, or 0 to remove the ceiling.
17
19
  },
18
20
  window: {
19
21
  title: "__PROJECT_NAME__",
@@ -44,6 +46,17 @@ const config: IThreeNativeConfig = {
44
46
  // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
45
47
  // extra process — and own the appearance difference that comes with it.
46
48
  ui: { renderer: "web" },
49
+ // One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
50
+ // threenative build --target android # cooks defaults.android; --profile <name> beats it
51
+ // buildProfiles: {
52
+ // defaults: { android: "compact" },
53
+ // profiles: {
54
+ // compact: {
55
+ // assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
56
+ // } },
57
+ // },
58
+ // Contract, byte definitions, the build report:
59
+ // node_modules/create-threenative/agent-docs/references/build-profiles.md
47
60
  };
48
61
 
49
62
  export default config;
@@ -0,0 +1,41 @@
1
+ import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
3
+ import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
5
+ import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
8
+
9
+ /**
10
+ * Recompiles assets/ into public/ while the dev server runs, so editing a texture does not
11
+ * need a rebuild. Serve-only by declaration: builds compile through `threenative build`.
12
+ */
13
+ function assetsWatchPlugin(): Plugin {
14
+ return {
15
+ name: "threenative-assets-watch",
16
+ apply: "serve",
17
+ async configureServer(server) {
18
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
19
+ server.httpServer?.once("close", () => handle.close());
20
+ // Nothing is served before the first cook settles: until it does, `public/` has no
21
+ // `assets.manifest.json` and every asset answers from its source fallback.
22
+ await handle.ready;
23
+ },
24
+ };
25
+ }
26
+
27
+ export default defineConfig({
28
+ plugins: [
29
+ createEngineFreshnessPlugin(),
30
+ createWebBrandPlugin(),
31
+ react(),
32
+ tailwindcss(),
33
+ assetsWatchPlugin(),
34
+ ],
35
+ server: {
36
+ watch: {
37
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
38
+ usePolling: true,
39
+ },
40
+ },
41
+ });