create-threenative 0.2.6 → 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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  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 +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  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/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,47 +1,32 @@
1
- export type GamePhase = "playing" | "dead" | "won" | "lost";
1
+ /** One soldier's dot on the minimap; `id` is that soldier's slot, so React can keep the node. */
2
+ export type Blip = { id: number; x: number; z: number; alive: boolean };
2
3
 
3
4
  export type GameState = {
4
- /** Set from the UI\'s pause and resume intents, and read back by the menu. */
5
- paused: boolean;
6
- /** True once the UI layer has rendered and published its interactive rectangles. */
7
- uiReady: boolean;
8
- aimedShots: number;
9
- aiming: number;
10
- /** Rounds in the magazine, and in reserve. The HUD reads both; a scenario asserts them. */
5
+ aiming: boolean;
11
6
  ammo: number;
12
- reserve: number;
13
- reloading: number;
14
- armor: number;
15
- cameraShakes: number;
16
- deaths: number;
17
- demoDamage: number;
18
- demoTargetAlive: number;
19
- friendlyPassed: number;
20
- gameOver: number;
21
- gameWon: number;
7
+ distanceMoved: number;
22
8
  health: number;
23
- hitDistanceTenths: number;
24
- hitNormalXPercent: number;
25
- hitNormalYPercent: number;
26
- hitNormalZPercent: number;
27
- lives: number;
28
- nameplateFacingCamera: number;
29
- pickupFrame: number;
30
- pickupFrameChanges: number;
31
- pickups: number;
32
- pitchDegrees: number;
33
- radiusInsideDeaths: number;
34
- radiusMidAlive: number;
35
- radiusNearAlive: number;
36
- radiusOutsideAlive: number;
37
- respawns: number;
38
- scanCount: number;
9
+ hitFlash: number;
10
+ /**
11
+ * Red damage vignette, 1 on the frame a round lands and decaying to 0 over about a third of a
12
+ * second. Published as a scalar rather than derived from `health` so "am I being shot" and "am
13
+ * I nearly dead" are two different facts, and the player gets the first one.
14
+ */
15
+ hurtFlash: number;
16
+ phase: "playing" | "complete" | "failed";
17
+ reloads: number;
18
+ reserve: number;
39
19
  score: number;
40
- shotsFired: number;
41
- targetsRemaining: number;
42
- wave: number;
43
- wavesCleared: number;
44
- wallBlocked: number;
45
- yawDegrees: number;
46
- phase: GamePhase;
20
+ shots: number;
21
+ targetsHit: number;
22
+ timeRemaining: number;
23
+ /** Player ground position and facing, for the minimap. */
24
+ playerX: number;
25
+ playerZ: number;
26
+ playerYaw: number;
27
+ /** Enemy positions for the minimap, one entry per soldier. */
28
+ blips: Blip[];
47
29
  };
30
+
31
+ /** Shared objective contract for the scene and the HUD. */
32
+ export const TARGET_GOAL = 12;
@@ -1,31 +1,209 @@
1
+ @import "tailwindcss";
2
+
3
+ /*
4
+ * Sources declared explicitly rather than left to automatic detection. When
5
+ * Tailwind finds no sources it still builds successfully — it emits the @theme
6
+ * variables and zero utilities, so every class name in src/ui/ becomes an inert
7
+ * string with no error anywhere to explain it. Being explicit makes that
8
+ * failure impossible rather than merely unlikely.
9
+ */
10
+ @source "../index.html";
11
+ @source "./";
12
+
13
+ /*
14
+ * Your palette. Every name here becomes a real Tailwind utility — `bg-ink`,
15
+ * `text-lume`, `border-line` — so the HUD reads in game terms instead of
16
+ * `bg-slate-950`. Rename them, add to them, or delete the block and use
17
+ * Tailwind's defaults. Nothing in @threenative/* reads this.
18
+ */
19
+ @theme {
20
+ --color-ink: #04080d;
21
+ --color-panel: #0d1c26;
22
+ --color-line: #14313f;
23
+ --color-lume: #6fe8ff;
24
+ --color-warn: #ffd27a;
25
+ --color-text: #a8ccd8;
26
+ --color-dim: #4e7686;
27
+
28
+ --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
29
+ }
30
+
31
+ /*
32
+ * `100dvh`, not `100%`.
33
+ *
34
+ * `height: 100%` resolves against the initial containing block, which on mobile Chrome is the
35
+ * *large* viewport — the one that counts the space behind the retractable URL bar. Measured on a
36
+ * Pixel 8: the canvas came out 411x840 while only 784 px of it was ever on the glass. Two things
37
+ * broke because of it. The canvas rendered 56 rows of pixels nobody could see, and every
38
+ * `bottom-*` anchored HUD element — the ammo counter among them — sat below the fold.
39
+ *
40
+ * `100dvh` is the viewport as it is right now, so the canvas matches the glass, the crosshair sits
41
+ * at the centre of what you can see, and the bottom cluster is on screen. `overflow: hidden` keeps
42
+ * the page unscrollable, so the URL bar does not retract and this does not thrash the resize.
43
+ */
1
44
  html,
2
45
  body,
3
46
  #root {
4
47
  width: 100%;
5
48
  height: 100%;
49
+ height: 100dvh;
6
50
  margin: 0;
7
51
  overflow: hidden;
8
52
  }
9
53
 
54
+ /*
55
+ * The backdrop belongs to the web document's own mount point, never to `body`: `src/ui/main.tsx`
56
+ * imports this stylesheet, and on native that file is what the transparent web view loads over the
57
+ * game, where a `body` background is an opaque sheet over the frame just rendered.
58
+ */
59
+ #root {
60
+ background: var(--color-ink);
61
+ }
62
+
10
63
  body {
11
- color: #dce5e8;
12
- font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
64
+ color: var(--color-text);
65
+ font-family: var(--font-mono);
13
66
  -webkit-font-smoothing: antialiased;
14
67
  }
15
68
 
16
69
  /*
17
- * The page's backdrop belongs to the web document's own mount point, never to `body`.
18
- * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
19
- * transparent web view loads over the game: a `body` background there paints an opaque sheet over
20
- * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
21
- * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
70
+ * No mouse cursor over the game. Pointer lock hides it while it is engaged, but the cursor is
71
+ * visible before the first click and every time the player presses Escape — an arrow sitting on
72
+ * top of a crosshair in a first-person shooter reads as an unfinished game.
22
73
  */
74
+ html,
75
+ body,
76
+ canvas {
77
+ cursor: none;
78
+ }
23
79
 
24
- #root {
25
- background: #263449;
80
+ /*
81
+ * Thumb controls, and the desktop legend they replace.
82
+ *
83
+ * Gated on `pointer: coarse` rather than on a width breakpoint: a narrow desktop window is still a
84
+ * mouse, and a tablet in landscape is still a thumb. Width would get both of those wrong.
85
+ */
86
+ .touch-only,
87
+ .touch-show {
88
+ display: none;
89
+ }
90
+
91
+ @media (pointer: coarse) {
92
+ .touch-only {
93
+ display: block;
94
+ /*
95
+ * The root is already `100dvh`; the remaining job is the gesture bar, which overlays the
96
+ * bottom of the viewport and would otherwise swallow the fire button's lower edge.
97
+ */
98
+ height: calc(100% - env(safe-area-inset-bottom, 0px));
99
+ bottom: auto;
100
+ }
101
+ /*
102
+ * `.touch-only` carries the full-surface sizing the thumb overlay needs. `.touch-show` is just
103
+ * the visibility half of it, for controls that live inside somebody else's layout — a button in
104
+ * a centred flex column must not also be told it is 100% tall.
105
+ */
106
+ .touch-show {
107
+ display: block;
108
+ }
109
+ .desktop-only {
110
+ display: none;
111
+ }
112
+
113
+ /*
114
+ * The HUD was laid out against a 1280x720 desktop window. On a 411 px phone the same pixel
115
+ * sizes are roughly three times the share of the screen they were designed to take: the 180 px
116
+ * minimap covered 44% of the width and sat on top of the roster, the clock and the objective
117
+ * line, and in landscape it covered the left thumb's stick band entirely.
118
+ *
119
+ * Scaled rather than re-laid-out, because the composition is right — it is only ever asked to
120
+ * be too big. Each cluster scales about the corner it is anchored to, so nothing drifts off an
121
+ * edge, and the touch controls are deliberately NOT scaled: their sizes are thumb dimensions,
122
+ * not layout dimensions, and a thumb is the same size on every phone.
123
+ */
124
+ .hud-minimap {
125
+ height: 108px;
126
+ width: 108px;
127
+ }
128
+ /*
129
+ * `scale` alone, with no translate of its own. Tailwind 4 centres these with the standalone
130
+ * `translate` property, not with `transform`, and the two compose — an extra `translateX(-50%)`
131
+ * here shifted the whole roster half its own width off the left edge of the screen.
132
+ */
133
+ .hud-top {
134
+ transform: scale(0.78);
135
+ transform-origin: top center;
136
+ }
137
+ .hud-bottom {
138
+ transform: scale(0.74);
139
+ transform-origin: bottom center;
140
+ }
141
+ .hud-corner {
142
+ transform: scale(0.8);
143
+ transform-origin: bottom left;
144
+ }
26
145
  }
27
146
 
28
- /* Boot failures are a page state, so the generated game owns their presentation. */
147
+ /*
148
+ * A phone in portrait is 411 px wide, and three things want the same corners.
149
+ *
150
+ * The roster row spans almost the full width even scaled, so the immersive button sat on top of
151
+ * the fifth chip; it drops below the row instead. And the bottom cluster is centred, which on a
152
+ * surface this narrow puts the ammo readout underneath the fire button — a number you cannot read
153
+ * because your thumb is on it. Nudging the cluster left of the fire circle is enough; it clears
154
+ * the move ring vertically, so nothing else has to move.
155
+ */
156
+ @media (pointer: coarse) and (max-width: 520px) {
157
+ .hud-immersive {
158
+ top: 46px;
159
+ }
160
+ .hud-bottom {
161
+ transform: translateX(-25%) scale(0.66);
162
+ }
163
+ /*
164
+ * The money chip goes. It is a hardcoded `$10000` placeholder with no gameplay behind it, and on
165
+ * a 411 px surface it lands underneath the armour badge — two numbers overlapping, one of them
166
+ * fiction. The key legend in the same corner is already hidden here, so this empties the block.
167
+ */
168
+ .hud-corner {
169
+ display: none;
170
+ }
171
+ }
172
+
173
+ /*
174
+ * A phone held in landscape gives the game 303 px of height in Chrome, and the game-over card,
175
+ * the credits and the objective line all shared that space with the fight. Below 420 px the
176
+ * overlay drops to a single tight column.
177
+ */
178
+ @media (pointer: coarse) and (max-height: 420px) {
179
+ .hud-top {
180
+ transform: scale(0.62);
181
+ }
182
+ .hud-bottom {
183
+ transform: scale(0.62);
184
+ }
185
+ .hud-minimap {
186
+ height: 92px;
187
+ width: 92px;
188
+ }
189
+ /*
190
+ * The stick hint is 148 px across, which is half the height of a phone held sideways in Chrome.
191
+ * At that size it collided with the minimap in the top-left and read as clutter rather than as
192
+ * a resting place. The stick itself still floats to wherever the thumb lands, so shrinking the
193
+ * ring costs no reach — only the drawn hint gets smaller.
194
+ */
195
+ .stick-hint {
196
+ bottom: 56px !important;
197
+ height: 104px !important;
198
+ width: 104px !important;
199
+ }
200
+ }
201
+
202
+ /*
203
+ * The boot-failure surface. The engine sets this attribute on the canvas when the
204
+ * renderer cannot start at all, and the message it carries is the only thing on screen.
205
+ * Generated source: restyle it freely, delete it if your game never fails to boot.
206
+ */
29
207
  [data-threenative-canvas-error="true"] {
30
208
  position: fixed;
31
209
  inset: 0;
@@ -36,7 +214,7 @@ body {
36
214
  padding: clamp(1.5rem, 8vw, 6rem);
37
215
  overflow: auto;
38
216
  background: #fff7ed;
39
- color: #263449;
217
+ color: var(--color-ink);
40
218
  font-family: inherit;
41
219
  font-size: clamp(1rem, 2vw, 1.5rem);
42
220
  line-height: 1.5;
@@ -44,3 +222,21 @@ body {
44
222
  white-space: pre-wrap;
45
223
  overflow-wrap: anywhere;
46
224
  }
225
+
226
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
227
+ [data-threenative-debug-overlay="true"] {
228
+ position: fixed;
229
+ top: 1rem;
230
+ right: 1rem;
231
+ z-index: 50;
232
+ max-width: 24rem;
233
+ padding: 0.75rem;
234
+ pointer-events: none;
235
+ background: rgb(4 8 13 / 90%);
236
+ color: #6fe8ff;
237
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
238
+ font-size: 0.75rem;
239
+ line-height: 1.4;
240
+ white-space: pre-wrap;
241
+ overflow-wrap: anywhere;
242
+ }
@@ -0,0 +1,131 @@
1
+ import type { Material, Mesh, Object3D } from "three";
2
+
3
+ /**
4
+ * One impact-surface vocabulary for every consumer of a bullet hit: the audio
5
+ * team picks its impact voice with it, the VFX team styles its burst with it,
6
+ * and decals will read it later. The values are game content and live only
7
+ * here.
8
+ *
9
+ * The flow is one tag, resolved once: the world builder stamps every hittable
10
+ * mesh with `userData.surface` at construction (`tagSurfaces`), and any
11
+ * consumer calls `resolveSurface(hit.object)` instead of re-deriving
12
+ * name tables of its own. Nothing downstream walks mesh names any more.
13
+ */
14
+ export type ImpactSurface = "plaster" | "wood" | "steel" | "stone";
15
+
16
+ /** Every legal value, so a stale or foreign tag is checked before trusted. */
17
+ const SURFACES: readonly ImpactSurface[] = ["plaster", "wood", "steel", "stone"];
18
+
19
+ /**
20
+ * What an untagged mesh answers: whitewash plaster — the dominant wall in the
21
+ * town and the honest default. The plaster/brick building shells are
22
+ * world-projected per-mesh materials, so they cannot be tabled by identity;
23
+ * they land here rather than in a table row.
24
+ */
25
+ export const DEFAULT_SURFACE: ImpactSurface = "plaster";
26
+
27
+ /**
28
+ * Mesh-name rules. Fallback ONLY, for meshes nobody tagged at construction —
29
+ * dynamic props or proxies dropped into a scene by code that never heard of
30
+ * surfaces. Every mesh the world builder makes is tagged before play starts
31
+ * and never consults these.
32
+ */
33
+ const NAME_RULES: readonly (readonly [RegExp, ImpactSurface])[] = [
34
+ [/crate|deck|pier|rail|stair/, "wood"],
35
+ [/barrel|bollard|post|mast|tank|roller|shutter/, "steel"],
36
+ [/quay|plaza|ground/, "stone"],
37
+ ];
38
+
39
+ /**
40
+ * Town-material member → what a bullet hears when it lands there. Used once,
41
+ * at construction, to stamp the tag onto every mesh wearing the material —
42
+ * shared palette materials mean one row covers hundreds of meshes. Members
43
+ * left out (water, shallows, fronds) have no honest cue of their own and fall
44
+ * through to the default.
45
+ */
46
+ const PALETTE_SURFACES: Readonly<Record<string, ImpactSurface>> = {
47
+ ground: "stone",
48
+ dadoBand: "plaster",
49
+ plasterTrim: "plaster",
50
+ brickTrim: "plaster",
51
+ doorBlue: "wood",
52
+ shutter: "wood",
53
+ rollerSteel: "steel",
54
+ awningCanvas: "plaster",
55
+ awningStripe: "plaster",
56
+ crate: "wood",
57
+ deckWood: "wood",
58
+ barrel: "steel",
59
+ palmTrunk: "wood",
60
+ siteMark: "stone",
61
+ plateFace: "steel",
62
+ plateHit: "steel",
63
+ plateFrame: "steel",
64
+ steel: "steel",
65
+ steelPost: "steel",
66
+ steelMast: "steel",
67
+ tankDark: "steel",
68
+ quay: "stone",
69
+ plazaWarm: "stone",
70
+ plazaCool: "stone",
71
+ plazaPale: "stone",
72
+ };
73
+
74
+ /** The name-rule half of the derivation, shared by both paths below. */
75
+ const surfaceFromName = (name: string): ImpactSurface | undefined => {
76
+ for (const [pattern, surface] of NAME_RULES) {
77
+ if (pattern.test(name)) return surface;
78
+ }
79
+ return undefined;
80
+ };
81
+
82
+ /**
83
+ * What a struck object answers as: its construction-time tag if it has one,
84
+ * else the name rules, else the default. The only surface lookup consumers
85
+ * should ever perform.
86
+ */
87
+ export const resolveSurface = (object: Object3D): ImpactSurface => {
88
+ const tagged: unknown = object.userData?.surface;
89
+ if (SURFACES.includes(tagged as ImpactSurface)) return tagged as ImpactSurface;
90
+ return surfaceFromName(object.name) ?? DEFAULT_SURFACE;
91
+ };
92
+
93
+ /** Stamp the tag one mesh will answer bullets as. Builders call this. */
94
+ export const tagSurface = (object: Object3D, surface: ImpactSurface): void => {
95
+ object.userData.surface = surface;
96
+ };
97
+
98
+ /**
99
+ * Tag every hittable mesh with the surface it answers as. Called once by the
100
+ * world builder after the last merge, when every mesh exists carrying its
101
+ * final material — the merged facade batches included.
102
+ *
103
+ * Per mesh the priority is the one the old per-shot resolver used, so tags
104
+ * match what hits resolved to before tagging existed: a name rule first (a
105
+ * mesh called "crate" is wood whatever it wears), then palette identity off
106
+ * the mesh's first material, then the default.
107
+ */
108
+ export const tagSurfaces = (meshes: readonly Mesh[], palette: object): void => {
109
+ const byMaterial = new Map<Material, ImpactSurface>();
110
+ const members = palette as Record<string, unknown>;
111
+ for (const [key, surface] of Object.entries(PALETTE_SURFACES)) {
112
+ const value = members[key];
113
+ if (
114
+ typeof value === "object" &&
115
+ value !== null &&
116
+ (value as { isMaterial?: boolean }).isMaterial === true
117
+ ) {
118
+ byMaterial.set(value as Material, surface);
119
+ }
120
+ }
121
+ for (const mesh of meshes) {
122
+ // Only meshes carry a material; every hittable here is one.
123
+ const meshMaterial = mesh.material;
124
+ const first = Array.isArray(meshMaterial) ? meshMaterial[0] : meshMaterial;
125
+ const surface =
126
+ surfaceFromName(mesh.name) ??
127
+ (first === undefined ? undefined : byMaterial.get(first)) ??
128
+ DEFAULT_SURFACE;
129
+ tagSurface(mesh, surface);
130
+ }
131
+ };
@@ -1,21 +1,20 @@
1
1
  import type { IGame } from "@threenative/core";
2
2
  import type { IPhysicsContext } from "@threenative/physics";
3
3
  import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
- import { shooterUi } from "../render/ui.js";
5
4
  import type { GameState } from "../state.js";
6
5
  import { GameUi } from "./GameUi.js";
7
6
 
8
- /**
9
- * The web target's page: the canvas, then the same UI every other target renders.
10
- *
11
- * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
12
- * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
13
- * has to put a canvas on the page.
14
- */
15
7
  export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
16
8
  return (
17
- <main className={shooterUi.app.root}>
18
- <GameCanvas className={shooterUi.app.canvas} game={game} />
9
+ // GameCanvas hosts the renderer; everything after it in this list paints on
10
+ // top. Keep the canvas first.
11
+ // `h-full`, not `h-screen`: `100vh` on mobile Chrome is the tall viewport behind the URL bar,
12
+ // which sized the canvas 56 px taller than the glass on a Pixel 8 — pixels rendered for nobody,
13
+ // and a crosshair 28 px below the centre of what the player can see. `#root` is `100dvh`.
14
+ <main className="relative h-full w-full overflow-hidden bg-ink">
15
+ <GameCanvas className="absolute inset-0" game={game} />
16
+ {/* The same tree the web view loads on native, so the browser is not a second UI to keep
17
+ in step — it is the same one, reached through the same bridge. */}
19
18
  <GameUi />
20
19
  <DebugOverlay />
21
20
  </main>
@@ -1,25 +1,32 @@
1
- import { useUiState } from "@threenative/ui";
2
- import { shooterUi } from "../render/ui.js";
3
- import type { GameState } from "../state.js";
1
+ import type { ComponentType, ReactNode } from "react";
2
+
3
+ export type CrosshairPart = "root" | "vertical" | "horizontal";
4
+
5
+ export interface ICrosshairPrimitiveProps {
6
+ readonly children?: ReactNode;
7
+ readonly hidden: boolean;
8
+ readonly hitFlash: number;
9
+ readonly part: CrosshairPart;
10
+ }
11
+
12
+ export interface ICrosshairProps {
13
+ readonly aiming: boolean;
14
+ readonly hitFlash: number;
15
+ readonly Primitive: ComponentType<ICrosshairPrimitiveProps>;
16
+ }
4
17
 
5
18
  /**
6
- * The reticle.
7
- *
8
- * Two bars with a gap, not a dot: the gap is where the round goes, and it is the only part of a
9
- * first-person HUD the player actually looks at. It disappears down the sights, because the optic
10
- * on the weapon is the sight at that point and two reticles read as a bug.
19
+ * The gameplay crosshair shared by the DOM and CanvasLayer React renderers.
11
20
  *
12
- * It is DOM rather than a mesh because it must sit at the exact centre of the *window*, which is
13
- * where a viewport-space element already is. A world-space quad in front of the camera moves with
14
- * the field of view and drifts off centre the moment ADS changes it.
21
+ * The component owns when the reticle exists and its two-bar structure. Each renderer supplies
22
+ * only the platform primitive that paints a root or bar, because DOM classes cannot execute on the
23
+ * native host and CanvasLayer styles are not CSS.
15
24
  */
16
- export function Crosshair() {
17
- const state = useUiState<GameState>();
18
- if (state === undefined || state.phase !== "playing") return null;
25
+ export function Crosshair({ aiming, hitFlash, Primitive }: ICrosshairProps) {
19
26
  return (
20
- <div className={state.aiming === 1 ? shooterUi.crosshair.rootAiming : shooterUi.crosshair.root}>
21
- <i className={shooterUi.crosshair.vertical} />
22
- <i className={shooterUi.crosshair.horizontal} />
23
- </div>
27
+ <Primitive hidden={aiming} hitFlash={hitFlash} part="root">
28
+ <Primitive hidden={aiming} hitFlash={hitFlash} part="vertical" />
29
+ <Primitive hidden={aiming} hitFlash={hitFlash} part="horizontal" />
30
+ </Primitive>
24
31
  );
25
32
  }
@@ -1,22 +1,19 @@
1
1
  import { UiLayer } from "@threenative/ui";
2
- import { Crosshair } from "./Crosshair.js";
3
2
  import { Hud } from "./Hud.js";
4
- import { Menu } from "./Menu.js";
5
3
 
6
4
  /**
7
- * Everything the player sees that is not the scene.
5
+ * Everything the player sees that is not the rendered frame.
8
6
  *
9
- * One component, mounted twice by two entries that differ only in what else is on the page:
10
- * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
11
- * page the native web view loads. Keeping both entries pointed at this file is what makes "the
12
- * same UI on every target" a fact rather than an intention.
7
+ * `UiLayer` is what connects this tree to the game: it opens the bridge, mirrors published state,
8
+ * and publishes the rectangles of every `data-tn-interactive` element so the host knows which
9
+ * presses belong to the UI and which fall through to the game. There is no `game` prop anywhere
10
+ * below it — on native this whole tree runs in the platform's web view, in a different process
11
+ * from the scene, and reaches the game only through state and intents.
13
12
  */
14
13
  export function GameUi() {
15
14
  return (
16
15
  <UiLayer>
17
- <Crosshair />
18
16
  <Hud />
19
- <Menu />
20
17
  </UiLayer>
21
18
  );
22
19
  }