create-threenative 0.2.10 → 0.2.13

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 (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -1,6 +1,10 @@
1
1
  import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { type CSSProperties, type ReactNode, useRef, useState } from "react";
3
+ import { STARTS } from "../sim/terrain.js";
2
4
  import { type EntityType, TYPES } from "../sim/types.js";
3
5
  import type { GameState } from "../state.js";
6
+ import { Icon, TrooperPortrait } from "./icons.js";
7
+ import { selectionDamage, selectionDamageIsHealing, selectionStatus } from "./labels.js";
4
8
 
5
9
  /** Read a `"<type>:<progress 0..1>"` pair back apart. */
6
10
  function readQueueItem(entry: string): { progress: number; type: EntityType } | undefined {
@@ -17,149 +21,640 @@ function clock(seconds: number): string {
17
21
  }
18
22
 
19
23
  /**
20
- * The top bar and the selection panel: what is banked, what is selected, what it is doing.
24
+ * The published snapshot, renewed only when what a panel shows changed. Every publish is a fresh
25
+ * copy and the game publishes each frame, so a panel reading the whole state re-rendered 20 times a
26
+ * second standing still (the 20 Hz sim clock) and 50 while panning (the camera fields it never
27
+ * shows). `shown` lists the values the panel draws, already rounded the way it draws them.
28
+ */
29
+ export function useUiStateShown(shown: (state: GameState) => unknown): GameState | undefined {
30
+ const last = useRef<{ key: string; state: GameState } | undefined>(undefined);
31
+ return useUiState<GameState, GameState>((state) => {
32
+ const key = JSON.stringify(shown(state));
33
+ if (last.current?.key !== key) last.current = { key, state };
34
+ return last.current.state;
35
+ });
36
+ }
37
+
38
+ /**
39
+ * Everything around the battlefield except the three bottom panels: the top bar, the objective
40
+ * and rival panels, the toast and order banner, the quick bar, the footer, the rubber band and the
41
+ * end screen. Each piece reads its own slice, so a resource tick repaints the top bar only.
21
42
  *
22
- * Plain Tailwind, plain DOM, and the same file on every target. The unit's *name*, role and cost
23
- * are not published by the game — they come out of the same rules table the pathfinder reads, so a
24
- * rebalance cannot leave this panel quoting last season's numbers.
43
+ * The unit's *name*, role and cost are not published by the game — they come out of the same rules
44
+ * table the pathfinder reads, so a rebalance cannot leave this HUD quoting last season's numbers.
25
45
  */
26
46
  export function Hud() {
27
- const state = useUiState<GameState>();
47
+ return (
48
+ <>
49
+ <TopBar />
50
+ <Mission />
51
+ <Rivals />
52
+ <Toast />
53
+ <ModeBanner />
54
+ <QuickBar />
55
+ <div className="statusbar">
56
+ <span>
57
+ <span className="live-dot" /> ASTRA EXPEDITIONARY CORPS
58
+ </span>
59
+ <span>
60
+ DRAG SELECT <i>·</i> RIGHT-CLICK ORDER <i>·</i> ARROWS / EDGE PAN <i>·</i> SCROLL ZOOM
61
+ </span>
62
+ <span>{"THREENATIVE // LIVE"}</span>
63
+ </div>
64
+ <DragBox />
65
+ <Result />
66
+ </>
67
+ );
68
+ }
69
+
70
+ function TopBar() {
71
+ const state = useUiStateShown((s) => [
72
+ s.ore,
73
+ s.gas,
74
+ s.supplyUsed,
75
+ s.supplyCap,
76
+ Math.floor(s.simTime / 20),
77
+ s.paused,
78
+ s.edgeScroll,
79
+ ]);
28
80
  const send = useUiIntent();
81
+ const [help, setHelp] = useState(false);
29
82
  // Nothing to draw until the game publishes its first snapshot. Rendering zeros instead would put
30
83
  // a wrong supply figure on screen and then correct it.
31
84
  if (state === undefined) return null;
32
- const card = state.primaryType === "" ? undefined : TYPES[state.primaryType as EntityType];
33
- const queue = state.queue
34
- .map(readQueueItem)
35
- .filter((item): item is { progress: number; type: EntityType } => item !== undefined);
36
- const supplyBlocked = state.supplyUsed >= state.supplyCap;
37
-
85
+ const closeHelp = () => {
86
+ setHelp(false);
87
+ send("resume");
88
+ };
38
89
  return (
39
90
  <>
40
- <header className="pointer-events-none absolute inset-x-0 top-0 flex items-start justify-between gap-4 p-4">
41
- <div className="flex items-center gap-5 bg-panel/80 px-4 py-2 text-lume">
42
- <Stat label="ore" value={state.ore.toLocaleString()} id="ore" />
43
- <Stat label="gas" value={state.gas.toLocaleString()} id="gas" />
44
- <Stat
45
- label="supply"
46
- value={`${state.supplyUsed} / ${state.supplyCap}`}
47
- id="supply"
48
- warn={supplyBlocked}
49
- />
50
- <Stat label="clock" value={clock(state.simTime / 20)} id="clock" />
91
+ <header className="topbar" data-tn-interactive>
92
+ <div className="brand">
93
+ <svg aria-hidden="true" viewBox="0 0 40 40">
94
+ <path
95
+ d="M20 3 37 34H28L20 18 12 34H3Z"
96
+ fill="none"
97
+ stroke="currentColor"
98
+ strokeWidth="2"
99
+ />
100
+ <path d="M14 29H26M20 4V12" stroke="currentColor" strokeWidth="2" />
101
+ </svg>
102
+ <div>
103
+ <strong>
104
+ ASTRA<span>CRAFT</span>
105
+ </strong>
106
+ <small>AIRBORNE FRONT · 3.0</small>
107
+ </div>
51
108
  </div>
52
- {state.notice === "" ? null : (
53
- <output className="max-w-sm bg-panel/80 px-3 py-2 text-xs uppercase tracking-[0.14em] text-warn">
54
- {state.notice}
55
- </output>
56
- )}
57
- </header>
58
-
59
- <section className="pointer-events-none absolute bottom-4 left-4 w-72 bg-panel/80 p-3">
60
- <div className="flex items-baseline justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
61
- <span>{state.selection === 0 ? "no selection" : "strike group"}</span>
62
- <span id="selection-count">{state.selection} selected</span>
109
+ <div className="top-location">
110
+ <span className="live-dot" /> KEPLER–09 <i>/</i> 3-WAY SKIRMISH{" "}
111
+ <span className="clock" id="clock">
112
+ {clock(state.simTime / 20)}
113
+ </span>
114
+ </div>
115
+ <div className="resources">
116
+ <Resource className="mineral" icon="ore" id="ore" label="MINERALS">
117
+ {state.ore.toLocaleString()}
118
+ </Resource>
119
+ <Resource className="vespene" icon="gas" id="gas" label="GAS">
120
+ {state.gas.toLocaleString()}
121
+ </Resource>
122
+ <Resource
123
+ className={`supply ${state.supplyUsed >= state.supplyCap ? "blocked" : ""}`}
124
+ icon="supply"
125
+ id="supply"
126
+ label="SUPPLY"
127
+ >
128
+ {state.supplyUsed} <em>/ {state.supplyCap}</em>
129
+ </Resource>
63
130
  </div>
64
- <h2 className="mt-1 text-xl leading-none text-text">{card?.name ?? "Awaiting orders"}</h2>
65
- <p className="mt-1 text-xs text-dim">{card?.role ?? "Select a unit or a structure."}</p>
66
- <div className="relative mt-2 h-1.5 overflow-hidden border border-line bg-ink">
67
- <i
68
- className="absolute inset-y-0 left-0 bg-lume"
69
- style={{
70
- width: `${state.primaryMaxHp > 0 ? (state.primaryHp / state.primaryMaxHp) * 100 : 0}%`,
131
+ <div className="top-actions">
132
+ <button
133
+ aria-label={state.edgeScroll ? "Disable edge scrolling" : "Enable edge scrolling"}
134
+ aria-pressed={state.edgeScroll}
135
+ className={`tiny-button text-button ${state.edgeScroll ? "active" : ""}`}
136
+ data-tn-interactive
137
+ data-testid="edge-scroll"
138
+ onClick={() => send("edge")}
139
+ title="Toggle edge scrolling"
140
+ type="button"
141
+ >
142
+ ↔
143
+ </button>
144
+ <button
145
+ aria-label="Open the field manual"
146
+ className="tiny-button"
147
+ data-tn-interactive
148
+ data-testid="help"
149
+ onClick={() => {
150
+ setHelp(true);
151
+ send("pause");
71
152
  }}
72
- />
153
+ title="Field manual"
154
+ type="button"
155
+ >
156
+ ?
157
+ </button>
158
+ <button
159
+ aria-label={state.paused ? "Resume game" : "Pause game"}
160
+ className={`tiny-button ${state.paused ? "active" : ""}`}
161
+ data-tn-interactive
162
+ data-testid="pause-toggle"
163
+ onClick={() => send(state.paused ? "resume" : "pause")}
164
+ title={state.paused ? "Resume" : "Pause"}
165
+ type="button"
166
+ >
167
+ {state.paused ? "▷" : "Ⅱ"}
168
+ </button>
73
169
  </div>
74
- <div className="mt-1 flex justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
75
- <span id="health">
76
- {state.primaryMaxHp} / {state.primaryMaxHp}
77
- </span>
78
- <span id="selection-position">
79
- {state.selectionX.toFixed(0)} · {state.selectionZ.toFixed(0)}
80
- </span>
170
+ </header>
171
+ {help ? (
172
+ <div className="modal-backdrop" data-tn-interactive>
173
+ <section className="modal panel">
174
+ <div className="eyebrow">{"ASTRA EXPEDITIONARY CORPS // FIELD MANUAL"}</div>
175
+ <h2>Welcome, commander.</h2>
176
+ <p>
177
+ Build an economy, raise a strike force and destroy both rival{" "}
178
+ <strong>command networks</strong>: orange Dominion and purple Eclipse. They also fight
179
+ each other.
180
+ </p>
181
+ <div className="manual-grid">
182
+ <div>
183
+ <h3>COMMAND YOUR FORCES</h3>
184
+ <p>
185
+ <kbd>Left drag</kbd> Select units
186
+ <br />
187
+ <kbd>Shift</kbd> Add to selection
188
+ <br />
189
+ <kbd>Right click</kbd> Move, attack, harvest, repair
190
+ <br />
191
+ <kbd>A</kbd> Attack-move · <kbd>M</kbd> Move
192
+ <br />
193
+ <kbd>H</kbd> Hold · <kbd>S</kbd> Stop
194
+ <br />
195
+ <kbd>F2</kbd> Select all combat units
196
+ </p>
197
+ </div>
198
+ <div>
199
+ <h3>BUILD YOUR FRONTIER</h3>
200
+ <p>
201
+ <kbd>Construct</kbd> Pick a structure, then click the ground
202
+ <br />
203
+ <kbd>Esc</kbd> Cancel a pending order
204
+ <br />
205
+ <kbd>Arrows</kbd> Pan · <kbd>Scroll</kbd> Zoom
206
+ <br />
207
+ <kbd>Space</kbd> Return to your base
208
+ </p>
209
+ </div>
210
+ </div>
211
+ <div className="modal-buttons">
212
+ <button className="primary" data-tn-interactive onClick={closeHelp} type="button">
213
+ RESUME OPERATION <span>→</span>
214
+ </button>
215
+ </div>
216
+ </section>
81
217
  </div>
82
- {state.primaryType === "" || state.primaryBuilt ? null : (
83
- <p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-lume">
84
- site {Math.round(state.primaryProgress * 100)}%
85
- </p>
86
- )}
87
- {queue.length === 0 ? null : (
88
- <ul className="mt-2 flex flex-wrap gap-1">
89
- {queue.map((item, index) => (
90
- <li
91
- className="relative h-6 w-12 overflow-hidden border border-line bg-ink text-[9px] uppercase tracking-[0.1em] text-text"
92
- key={`${item.type}-${index}`}
93
- >
94
- <i
95
- className="absolute inset-y-0 left-0 bg-panel"
96
- style={{ width: `${item.progress * 100}%` }}
97
- />
98
- <span className="relative">{TYPES[item.type].name}</span>
99
- </li>
100
- ))}
101
- </ul>
102
- )}
103
- {state.selectionOrder === "" ? null : (
104
- <p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-dim" id="selection-order">
105
- {state.selectionOrder}
106
- </p>
107
- )}
108
- </section>
109
-
110
- {state.dragBox === null ? null : (
111
- <div
112
- className="pointer-events-none absolute border border-lume/80 bg-lume/10"
113
- style={{
114
- left: `${state.dragBox[0]}px`,
115
- top: `${state.dragBox[1]}px`,
116
- width: `${state.dragBox[2]}px`,
117
- height: `${state.dragBox[3]}px`,
118
- }}
119
- />
120
- )}
121
- <p className="sr-only" id="selection-live">
122
- {`${state.selection} selected, orders ${state.selectionOrder}`}
123
- </p>
124
- <div className="pointer-events-none absolute right-4 bottom-4 flex flex-col items-end gap-1">
125
- {state.result === "" ? null : (
126
- <span className="bg-panel/80 px-3 py-1 text-xs uppercase tracking-[0.2em] text-warn">
127
- {state.result}
128
- </span>
129
- )}
130
- <button
131
- className="pointer-events-auto border border-line bg-panel/80 px-3 py-1 text-[10px] uppercase tracking-[0.14em] text-text"
132
- data-tn-interactive
133
- onClick={() => send(state.paused ? "resume" : "pause")}
134
- type="button"
135
- >
136
- {state.paused ? "resume" : "pause"}
137
- </button>
138
- </div>
218
+ ) : null}
139
219
  </>
140
220
  );
141
221
  }
142
222
 
143
- function Stat({
223
+ function Resource({
224
+ children,
225
+ className,
226
+ icon,
144
227
  id,
145
228
  label,
146
- value,
147
- warn = false,
148
229
  }: {
230
+ readonly children: ReactNode;
231
+ readonly className: string;
232
+ readonly icon: string;
149
233
  readonly id: string;
150
234
  readonly label: string;
151
- readonly value: string;
152
- readonly warn?: boolean;
153
235
  }) {
154
236
  return (
155
- <div>
156
- <div className="text-[9px] uppercase tracking-[0.18em] text-dim">{label}</div>
157
- <div
158
- className={`text-lg leading-none tabular-nums ${warn ? "text-warn" : "text-text"}`}
159
- id={id}
237
+ <div className={`resource ${className}`}>
238
+ <Icon name={icon} />
239
+ <div>
240
+ <b id={id}>{children}</b>
241
+ <small>{label}</small>
242
+ </div>
243
+ </div>
244
+ );
245
+ }
246
+
247
+ function Mission() {
248
+ const state = useUiStateShown((s) => [s.skyport, s.airWing >= 2, s.defeated]);
249
+ if (state === undefined) return null;
250
+ return (
251
+ <section className="mission">
252
+ <div className="eyebrow">
253
+ <span>03</span> OPERATION: AIRBORNE FRONT
254
+ </div>
255
+ <h1>Own the ground. Rule the sky.</h1>
256
+ <p>Eliminate both rival command networks.</p>
257
+ <Objective done={state.skyport}>Construct a Skyport</Objective>
258
+ <Objective done={state.airWing >= 2}>Field a wing of 2 aircraft</Objective>
259
+ <div className={`objective final ${state.defeated === 2 ? "complete" : ""}`}>
260
+ <span className="objective-box" />
261
+ <span id="cores-progress">Commanders defeated: {state.defeated} / 2</span>
262
+ </div>
263
+ <div className="mission-coordinates">
264
+ SHATTERED REACH <span>224 × 224 M</span>
265
+ </div>
266
+ </section>
267
+ );
268
+ }
269
+
270
+ function Objective({ children, done }: { readonly children: string; readonly done: boolean }) {
271
+ return (
272
+ <div className={`objective ${done ? "complete" : ""}`}>
273
+ <span className="objective-box" />
274
+ {children}
275
+ </div>
276
+ );
277
+ }
278
+
279
+ const RIVALS = [
280
+ { css: STARTS[1]?.css ?? "#ff9568", name: "DOMINION", tag: "ARMORED LEGION" },
281
+ { css: STARTS[2]?.css ?? "#bb95ff", name: "ECLIPSE", tag: "STRIKE COLLECTIVE" },
282
+ ];
283
+
284
+ function Rivals() {
285
+ const state = useUiStateShown((s) => [s.rivals, s.kills]);
286
+ if (state === undefined) return null;
287
+ return (
288
+ <aside className="threat">
289
+ <div className="eyebrow">
290
+ <span className="enemy-dot" /> RIVAL COMMANDERS
291
+ </div>
292
+ {RIVALS.map((rival, index) => (
293
+ <div
294
+ className="commander"
295
+ key={rival.name}
296
+ style={{ "--faction": rival.css } as CSSProperties}
297
+ >
298
+ <span>
299
+ <i /> {rival.name} <small>{rival.tag}</small>
300
+ </span>
301
+ <b>{state.rivals[index] ?? "NO CONTACT"}</b>
302
+ </div>
303
+ ))}
304
+ <div className="threat-meta">
305
+ <span>THREE-WAY WAR</span>
306
+ <span id="kills">{state.kills} ELIMINATED</span>
307
+ </div>
308
+ </aside>
309
+ );
310
+ }
311
+
312
+ /**
313
+ * The last report, faded out by CSS after four seconds; `key` restarts the fade for a new one.
314
+ *
315
+ * A refusal is a different sentence from a confirmation and reads in the warning style, as it does
316
+ * in AstraCraft: "Those units cannot attack that target" in the same calm colour as "Barracks
317
+ * online." is a toast the player learns to ignore.
318
+ */
319
+ function Toast() {
320
+ const state = useUiStateShown((s) => (s.notice === "" ? "" : [s.notice, s.noticeError]));
321
+ if (state === undefined || state.notice === "") return null;
322
+ return (
323
+ <output className={`toast show ${state.noticeError ? "error" : ""}`} key={state.notice}>
324
+ {state.notice}
325
+ </output>
326
+ );
327
+ }
328
+
329
+ const MODE_LABELS: Record<string, string> = {
330
+ attack: "ATTACK-MOVE · CLICK THE BATTLEFIELD",
331
+ garrison: "GARRISON · CLICK A FRIENDLY BUNKER · VANGUARDS ONLY",
332
+ move: "MOVE ORDER · CLICK TO CONFIRM",
333
+ rally: "SET RALLY POINT · CLICK TO CONFIRM",
334
+ repair: "REPAIR · CLICK A DAMAGED FRIENDLY STRUCTURE",
335
+ follow: "SUPPORT · CLICK A FRIENDLY GROUND UNIT",
336
+ };
337
+
338
+ function ModeBanner() {
339
+ const state = useUiStateShown((s) => s.mode);
340
+ if (state === undefined || state.mode === "") return null;
341
+ const building = state.mode.startsWith("build:")
342
+ ? TYPES[state.mode.slice(6) as EntityType]
343
+ : undefined;
344
+ const label =
345
+ building === undefined
346
+ ? (MODE_LABELS[state.mode] ?? "ISSUE AN ORDER")
347
+ : `BUILD ${building.name.toUpperCase()} · SURVEYOR MUST REMAIN ON SITE`;
348
+ return <div className="mode-banner">{label} · ESC TO CANCEL</div>;
349
+ }
350
+
351
+ function QuickBar() {
352
+ const state = useUiStateShown((s) => [s.speed, s.idleWorkers, s.groups]);
353
+ const send = useUiIntent();
354
+ if (state === undefined) return null;
355
+ return (
356
+ <div className="quickbar">
357
+ <button
358
+ data-action="army"
359
+ data-tn-interactive
360
+ data-testid="order-army"
361
+ onClick={() => send("army")}
362
+ title="Select your combat army [F2]"
363
+ type="button"
364
+ >
365
+ <Icon name="army" />
366
+ <span>ALL ARMY</span>
367
+ <kbd>F2</kbd>
368
+ </button>
369
+ <button
370
+ data-tn-interactive
371
+ data-testid="order-base"
372
+ onClick={() => send("base")}
373
+ title="Center on the Command Core [Space]"
374
+ type="button"
160
375
  >
161
- {value}
376
+ <Icon name="core" />
377
+ <span>BASE</span>
378
+ <kbd>SPACE</kbd>
379
+ </button>
380
+ <button
381
+ data-tn-interactive
382
+ data-testid="speed"
383
+ onClick={() => send("speed")}
384
+ title="Cycle game speed"
385
+ type="button"
386
+ >
387
+ {state.speed}×
388
+ </button>
389
+ <button
390
+ data-tn-interactive
391
+ data-testid="idle"
392
+ onClick={() => send("idle")}
393
+ title="Select idle Surveyors [F4]"
394
+ type="button"
395
+ >
396
+ IDLE <span id="idle-count">{state.idleWorkers}</span>
397
+ </button>
398
+ <button
399
+ data-action="retreat"
400
+ data-tn-interactive
401
+ data-testid="order-retreat"
402
+ onClick={() => send("retreat")}
403
+ title="Retreat the selection to base [V]"
404
+ type="button"
405
+ >
406
+ RETREAT <kbd>V</kbd>
407
+ </button>
408
+ <div className="groups">
409
+ {state.groups.map((count, index) => {
410
+ const group = index + 1;
411
+ return (
412
+ <button
413
+ className={count > 0 ? "assigned" : ""}
414
+ data-tn-interactive
415
+ data-testid={`group-${group}`}
416
+ // biome-ignore lint/suspicious/noArrayIndexKey: the five slots are fixed positions.
417
+ key={index}
418
+ onClick={(event) =>
419
+ send("group", event.ctrlKey || event.shiftKey ? `set:${group}` : String(group))
420
+ }
421
+ title={`Group ${group} · click to recall, Ctrl + click to assign`}
422
+ type="button"
423
+ >
424
+ {group}
425
+ {count > 0 ? <span>{count}</span> : null}
426
+ </button>
427
+ );
428
+ })}
429
+ </div>
430
+ </div>
431
+ );
432
+ }
433
+
434
+ /** The selection card: what is selected, how healthy it is, what it does, and its roster. */
435
+ export function Selection() {
436
+ const state = useUiStateShown((s) => [
437
+ s.selection,
438
+ s.selectionTypes,
439
+ s.primaryType,
440
+ s.primaryTeam,
441
+ s.primaryBuilt,
442
+ Math.round(s.primaryProgress * 100),
443
+ s.primaryGarrison,
444
+ s.groupHp,
445
+ s.groupMaxHp,
446
+ s.airborne,
447
+ s.roster,
448
+ s.queue,
449
+ s.selectionOrder,
450
+ ]);
451
+ const send = useUiIntent();
452
+ if (state === undefined) return null;
453
+ const cardType = state.primaryType === "" ? undefined : (state.primaryType as EntityType);
454
+ const card = cardType === undefined ? undefined : TYPES[cardType];
455
+ const count = state.selection;
456
+ const queue = state.queue
457
+ .map(readQueueItem)
458
+ .filter((item): item is { progress: number; type: EntityType } => item !== undefined);
459
+ const status = selectionStatus(state.primaryType === "" ? undefined : cardType, {
460
+ built: state.primaryBuilt,
461
+ garrison: state.primaryGarrison,
462
+ orders: state.selectionOrder.split(","),
463
+ progress: state.primaryProgress,
464
+ queue: queue.map((item) => item.progress),
465
+ });
466
+ const damage = selectionDamage(
467
+ state.primaryType === "" ? undefined : cardType,
468
+ state.primaryGarrison,
469
+ );
470
+ const caption =
471
+ card !== undefined && state.primaryTeam > 0
472
+ ? "HOSTILE INTELLIGENCE"
473
+ : card?.building === true
474
+ ? "BASE OPERATIONS"
475
+ : count > 1
476
+ ? "STRIKE GROUP"
477
+ : "UNIT TELEMETRY";
478
+ const name =
479
+ count > 1 && state.selectionTypes.length > 1
480
+ ? "Combined arms"
481
+ : (card?.name ?? "Awaiting orders");
482
+ const code =
483
+ card === undefined
484
+ ? "AWAITING ORDERS"
485
+ : `${(state.primaryTeam > 0 ? (STARTS[state.primaryTeam]?.name ?? "") : card.name).toUpperCase()} // ${
486
+ card.building === true ? "BASE" : card.air === true ? "AIR" : "GROUND"
487
+ }`;
488
+ const role =
489
+ count > 1
490
+ ? `${count} units · ${state.airborne} airborne / ${count - state.airborne} ground`
491
+ : (card?.role ?? "Select a unit or structure to begin.");
492
+ const health = state.groupMaxHp > 0 ? (state.groupHp / state.groupMaxHp) * 100 : 0;
493
+
494
+ return (
495
+ <section className="selection-panel panel" data-tn-interactive>
496
+ <div className="panel-label">
497
+ <span>{caption}</span>
498
+ <span id="selection-count">
499
+ {count > 0 ? `${String(count).padStart(2, "0")} SELECTED` : "NO SELECTION"}
500
+ </span>
501
+ </div>
502
+ <div className="selection-content">
503
+ <div className="portrait">
504
+ <div className="portrait-grid" />
505
+ {state.primaryType === "ranger" ? (
506
+ <TrooperPortrait />
507
+ ) : (
508
+ <Icon className="portrait-art schematic" name={state.primaryType || "core"} />
509
+ )}
510
+ <div className="portrait-code">{code}</div>
511
+ <div className="portrait-led" />
512
+ </div>
513
+ <div className="unit-info">
514
+ <div className="unit-heading">
515
+ <div>
516
+ <h2 id="unit-name">{name}</h2>
517
+ <p id="unit-role">{role}</p>
518
+ </div>
519
+ <span className="unit-rank">ⅠⅠⅠ</span>
520
+ </div>
521
+ <div className="health-track">
522
+ <span style={{ width: `${health}%` }} />
523
+ </div>
524
+ <div className="health-meta">
525
+ <span data-value={state.groupHp} id="health">
526
+ {state.groupMaxHp > 0 ? `${state.groupHp} / ${state.groupMaxHp}` : "—"}
527
+ </span>
528
+ <span id="unit-status">{status}</span>
529
+ </div>
530
+ <div className="unit-stats">
531
+ {card === undefined ? null : (
532
+ <>
533
+ <span>
534
+ <Icon name={card.heal ? "medic" : "attack"} />
535
+ <b>{damage ?? "—"}</b>{" "}
536
+ {selectionDamageIsHealing(cardType) ? "HP / SEC" : "DAMAGE"}
537
+ </span>
538
+ <span>
539
+ <Icon name="supply" />
540
+ <b>{card.healRange ?? card.range ?? "—"}</b> RANGE
541
+ </span>
542
+ <span>
543
+ <Icon name={card.air === true ? "fighter" : "move"} />
544
+ <b>{card.speed ?? "—"}</b> {card.air === true ? "FLIGHT" : "SPEED"}
545
+ </span>
546
+ </>
547
+ )}
548
+ </div>
549
+ <div className="unit-roster">
550
+ {state.roster.map((entry) => {
551
+ const [id = "", type = "", tenths = "0"] = entry.split(":");
552
+ return (
553
+ <button
554
+ className="roster-unit"
555
+ data-tn-interactive
556
+ key={id}
557
+ onClick={() => send("select", id)}
558
+ title={TYPES[type as EntityType]?.name}
559
+ type="button"
560
+ >
561
+ <Icon name={type} />
562
+ <i style={{ width: `${Number(tenths) * 10}%` }} />
563
+ </button>
564
+ );
565
+ })}
566
+ {count > 16 ? <span className="roster-more">+{count - 16}</span> : null}
567
+ </div>
568
+ {queue.length === 0 ? null : (
569
+ <div className="production">
570
+ <span>IN PRODUCTION</span>
571
+ {queue.map((item, index) => (
572
+ <button
573
+ data-tn-interactive
574
+ // biome-ignore lint/suspicious/noArrayIndexKey: a queue slot is its position.
575
+ key={`${item.type}-${index}`}
576
+ onClick={() => send("cancelTrain", item.type)}
577
+ title={`Cancel ${TYPES[item.type].name}; full refund`}
578
+ type="button"
579
+ >
580
+ <Icon name={item.type} />
581
+ <i style={{ width: `${item.progress * 100}%` }} />
582
+ </button>
583
+ ))}
584
+ </div>
585
+ )}
586
+ </div>
162
587
  </div>
588
+ <p className="sr-only" id="selection-live">
589
+ {`${count} selected, orders ${state.selectionOrder}`}
590
+ </p>
591
+ </section>
592
+ );
593
+ }
594
+
595
+ /**
596
+ * The rubber band and the count it stands for.
597
+ *
598
+ * AstraCraft paints the band's badge with `#drag-box:after { content: attr(data-count) }` and the
599
+ * `data-count` attribute is what puts text in it: set nothing and the padded, bordered `:after`
600
+ * still renders as an empty little square hanging over the corner of the band. So the badge is
601
+ * part of the element's contract, never an ornament bolted on with CSS.
602
+ */
603
+ function DragBox() {
604
+ const state = useUiStateShown((s) => (s.dragBox === null ? null : [s.dragBox, s.dragCount]));
605
+ if (state?.dragBox == null) return null;
606
+ const [left, top, width, height] = state.dragBox;
607
+ return (
608
+ <div
609
+ data-count={`${state.dragCount} UNITS`}
610
+ id="drag-box"
611
+ style={{ height: `${height}px`, left: `${left}px`, top: `${top}px`, width: `${width}px` }}
612
+ />
613
+ );
614
+ }
615
+
616
+ /** The match result is the screen, not a tag in the corner. */
617
+ function Result() {
618
+ const state = useUiStateShown((s) =>
619
+ s.result === "" ? "" : [s.result, s.kills, s.gathered, Math.floor(s.simTime / 20)],
620
+ );
621
+ const send = useUiIntent();
622
+ if (state === undefined || state.result === "") return null;
623
+ const win = state.result === "victory";
624
+ return (
625
+ <div className="modal-backdrop" data-tn-interactive>
626
+ <section className="modal panel">
627
+ <div className="eyebrow">{win ? "FRONTIER SECURED" : "COMMAND SIGNAL LOST"}</div>
628
+ <h2 id="result">{win ? "Victory, commander." : "The frontier has fallen."}</h2>
629
+ <p>
630
+ {win
631
+ ? "Both rival command networks have fallen. Shattered Reach is yours."
632
+ : "Your Command Core has been destroyed. Regroup and redeploy."}
633
+ </p>
634
+ <div className="end-stats">
635
+ <div>
636
+ <b>{clock(state.simTime / 20)}</b>
637
+ <span>MISSION TIME</span>
638
+ </div>
639
+ <div>
640
+ <b>{state.kills}</b>
641
+ <span>ELIMINATED</span>
642
+ </div>
643
+ <div>
644
+ <b>{state.gathered}</b>
645
+ <span>HARVESTED</span>
646
+ </div>
647
+ </div>
648
+ <button
649
+ className="primary"
650
+ data-tn-interactive
651
+ data-testid="restart"
652
+ onClick={() => send("restart")}
653
+ type="button"
654
+ >
655
+ DEPLOY AGAIN →
656
+ </button>
657
+ </section>
163
658
  </div>
164
659
  );
165
660
  }