create-threenative 0.2.9 → 0.2.12

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 +229 -36
  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 +17 -11
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  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 +16 -10
  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 +16 -10
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  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 +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -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 +53 -34
  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 +17 -11
  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
@@ -0,0 +1,53 @@
1
+ import type { RacePhase } from "./track/Race.js";
2
+
3
+ export interface IResult {
4
+ readonly place: number;
5
+ readonly name: string;
6
+ /** Race time in seconds; 0 while that driver is still racing. */
7
+ readonly time: number;
8
+ readonly player: boolean;
9
+ }
10
+
11
+ export interface IMapDot {
12
+ readonly x: number;
13
+ readonly y: number;
14
+ readonly colour: string;
15
+ readonly player: boolean;
16
+ }
17
+
18
+ export type GameState = {
19
+ /** True once startup is ready and the loading cover lifts; the HUD stays hidden until then. */
20
+ loaded?: boolean;
21
+ phase: RacePhase;
22
+ /** 3, 2, 1 while the lamps light, 0 for the second of GO, −1 after. */
23
+ countdown: number;
24
+ /** The player's lap on the HUD, 1-based, and the race's lap count. */
25
+ lap: number;
26
+ laps: number;
27
+ place: number;
28
+ racers: number;
29
+ /** Race seconds since GO. */
30
+ time: number;
31
+ /** The player's completed lap times, seconds. */
32
+ lapTimes: number[];
33
+ /** The item in hand, `rolling` while the roulette spins, `""` for none. */
34
+ item: string;
35
+ /** Speed as the HUD shows it, km/h. */
36
+ speed: number;
37
+ /** Mini-turbo stage of the player's drift, 0 to 3. */
38
+ driftStage: number;
39
+ toast: string;
40
+ wrongWay: boolean;
41
+ /** The minimap: the course as one SVG path in a 100 × 100 box, and a dot per kart. */
42
+ mapPath: string;
43
+ mapDots: IMapDot[];
44
+ /** Everyone's place once the player finishes, then as the CPUs cross the line. */
45
+ results: IResult[];
46
+ finishedCount: number;
47
+ /** True while the player's kart drives itself (P toggles it; it takes over at the finish). */
48
+ autopilot: boolean;
49
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
50
+ paused: boolean;
51
+ /** True once the UI layer has rendered and published its interactive rectangles. */
52
+ uiReady: boolean;
53
+ };
@@ -0,0 +1,106 @@
1
+ @import "tailwindcss";
2
+
3
+ @source "../index.html";
4
+ @source "./";
5
+
6
+ @theme {
7
+ --color-ink: #1d3a5c;
8
+ /* The loading cover's colour (`palette.skyLow`), so the page and the cover paint as one. */
9
+ --color-cover: #63a6e8;
10
+ --color-panel: #2a1a0e;
11
+ --color-line: #ffffff40;
12
+ --color-lume: #ffb35c;
13
+ --color-warn: #f2b01e;
14
+ --color-heart: #e5484d;
15
+ --color-text: #fff4dc;
16
+ --color-dim: #e9c98a;
17
+ --font-mono: ui-rounded, "Nunito", "Trebuchet MS", system-ui, sans-serif;
18
+ /* The controls hint reads once, then gets out of the view. */
19
+ --animate-hint-fade: hint-fade 1s ease-in 10s forwards;
20
+
21
+ @keyframes hint-fade {
22
+ to {
23
+ opacity: 0;
24
+ }
25
+ }
26
+ }
27
+
28
+ html,
29
+ body,
30
+ #root {
31
+ width: 100%;
32
+ height: 100%;
33
+ margin: 0;
34
+ overflow: hidden;
35
+ }
36
+
37
+ body {
38
+ color: var(--color-text);
39
+ font-family: var(--font-mono);
40
+ -webkit-font-smoothing: antialiased;
41
+ }
42
+
43
+ /*
44
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
45
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
46
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
47
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
48
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
49
+ */
50
+
51
+ #root {
52
+ background: var(--color-cover);
53
+ }
54
+
55
+ /* Boot failures are a page state, so the generated game owns their presentation. */
56
+ [data-threenative-canvas-error="true"] {
57
+ position: fixed;
58
+ inset: 0;
59
+ z-index: 1000;
60
+ display: grid;
61
+ place-items: center;
62
+ box-sizing: border-box;
63
+ padding: clamp(1.5rem, 8vw, 6rem);
64
+ overflow: auto;
65
+ background: #fff7ed;
66
+ color: var(--color-ink);
67
+ font-family: inherit;
68
+ font-size: clamp(1rem, 2vw, 1.5rem);
69
+ line-height: 1.5;
70
+ text-align: center;
71
+ white-space: pre-wrap;
72
+ overflow-wrap: anywhere;
73
+ }
74
+
75
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
76
+ [data-threenative-debug-overlay="true"] {
77
+ position: fixed;
78
+ top: 1rem;
79
+ right: 1rem;
80
+ z-index: 50;
81
+ max-width: 24rem;
82
+ padding: 0.75rem;
83
+ pointer-events: none;
84
+ background: rgb(2 6 23 / 90%);
85
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
86
+ color: #cffafe;
87
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
88
+ font-size: 12px;
89
+ line-height: 1.5;
90
+ }
91
+
92
+ [data-threenative-debug-overlay="true"] table {
93
+ width: 100%;
94
+ table-layout: fixed;
95
+ }
96
+
97
+ [data-threenative-debug-overlay="true"] th,
98
+ [data-threenative-debug-overlay="true"] td {
99
+ padding-right: 1rem;
100
+ text-align: left;
101
+ }
102
+
103
+ [data-threenative-debug-overlay="true"] td:last-child {
104
+ overflow-wrap: anywhere;
105
+ word-break: break-all;
106
+ }
@@ -0,0 +1,276 @@
1
+ /**
2
+ * Clover Loop in track space: a closed centre line sampled every metre, and the road, kerb, grass
3
+ * and wall lines measured sideways from it. This is how the reference keeps a kart on its course
4
+ * (MK64 path points plus a surface under each wheel), so a kart needs no physics collider: where
5
+ * it is along the line and how far off it says what it stands on and whether it hit a wall.
6
+ *
7
+ * The line is a figure-8. At its crossing one branch is a bridge 7 m up and the other an underpass,
8
+ * so a kart may only search a few metres around where it was (`track`), never the whole line — a
9
+ * whole-line search would put a kart on the bridge into the underpass below it.
10
+ */
11
+
12
+ /** Metres between samples of the centre line. */
13
+ export const STEP = 1;
14
+
15
+ /** The lateral profile, in metres from the centre line. */
16
+ export const PROFILE = {
17
+ /** Half the asphalt's width: 13 m of road, about 7 karts abreast. */
18
+ road: 6.5,
19
+ /** The red-and-white kerb strip outside the asphalt; it drives like road. */
20
+ kerb: 0.8,
21
+ /** Where the wall stands, measured from the centre, on ordinary ground. */
22
+ wall: 11,
23
+ /** Where the bridge's rails stand: the deck has no grass. */
24
+ rail: 7.6,
25
+ } as const;
26
+
27
+ /** What a kart's wheels are on, and the drag it adds (MK64's surface table, medium weight). */
28
+ export type Surface = "road" | "grass" | "water";
29
+ export const SURFACE_DRAG: Record<Surface, number> = { grass: 0.3, road: 0, water: 0.15 };
30
+
31
+ export interface ITrackPoint {
32
+ /** Sample index along the line; the start line is index 0. */
33
+ readonly index: number;
34
+ /** Signed sideways offset in metres: positive is the right of the direction of travel. */
35
+ readonly lateral: number;
36
+ }
37
+
38
+ /** Design of the course in fractions of a lap, so the layout survives a change of length. */
39
+ export const LAYOUT = {
40
+ /** Metres from the bridge's centre to the start line: past the bridge's down ramp, so the grid
41
+ * stands on the flat and the bridge closes the lap. */
42
+ start: 90,
43
+ /** The crossing's upper branch: level for `flat` metres each side of the crossing (where the two
44
+ * roads overlap in plan), then a `ramp` down. The lower branch sinks `cut` metres under it. */
45
+ bridge: { flat: 26, ramp: 42, height: 6.5, cut: 1.5 },
46
+ /** The jump: a kicker, a lip, then a creek dip the kart flies over. */
47
+ jump: { at: 0.42, kick: 10, rise: 1.4, drop: 3, depth: 2.2, floor: 9, climb: 7 },
48
+ /** Boost pads: lap fraction and lateral offset of each, a 4 m x 3 m chevron. */
49
+ pads: [
50
+ { at: 0.04, lateral: -2.5 },
51
+ // On the back straight, so a kart reaches the jump on a boost; its 3 m plate ends inside the
52
+ // edge line.
53
+ { at: 0.385, lateral: -4.2 },
54
+ { at: 0.7, lateral: 0 },
55
+ { at: 0.86, lateral: -2 },
56
+ ],
57
+ /** Item box rows: lap fraction of each row of four. */
58
+ boxes: [0.19, 0.51, 0.74],
59
+ /** Ordered checkpoints a lap must pass before the line counts (the line itself is the fourth). */
60
+ checkpoints: [0.25, 0.5, 0.75],
61
+ } as const;
62
+
63
+ /** 1 within `flat` metres of `at`, easing to 0 over the next `ramp` metres, round a loop of `length`. */
64
+ function plateau(s: number, at: number, length: number, flat: number, ramp: number): number {
65
+ let d = Math.abs(s - at) % length;
66
+ d = Math.min(d, length - d);
67
+ return 1 - smooth(flat, flat + ramp, d);
68
+ }
69
+
70
+ function smooth(edge0: number, edge1: number, x: number): number {
71
+ const t = Math.min(1, Math.max(0, (x - edge0) / (edge1 - edge0)));
72
+ return t * t * (3 - 2 * t);
73
+ }
74
+
75
+ export interface ICourse {
76
+ /** Centre-line length in metres. */
77
+ readonly length: number;
78
+ readonly count: number;
79
+ readonly x: Float32Array;
80
+ readonly y: Float32Array;
81
+ readonly z: Float32Array;
82
+ /** Unit tangent along the direction of travel, on the ground plane. */
83
+ readonly tx: Float32Array;
84
+ readonly tz: Float32Array;
85
+ /** Road slope dy/ds, for the kart's pitch. */
86
+ readonly slope: Float32Array;
87
+ /** Wall distance from the centre at each sample (the rail on the bridge). */
88
+ readonly wall: Float32Array;
89
+ /** 1 on the bridge deck, 0 on the ground. */
90
+ readonly deck: Float32Array;
91
+ /** Index of each checkpoint, in lap order; the start line (index 0) closes the lap. */
92
+ readonly checkpoints: readonly number[];
93
+ readonly pads: readonly { readonly index: number; readonly lateral: number }[];
94
+ readonly boxes: readonly number[];
95
+ /** First and last sample of the creek dip, whose floor is water. */
96
+ readonly creek: readonly [number, number];
97
+ /** Wraps any integer onto the line. */
98
+ wrap(index: number): number;
99
+ /** Finds a kart again near where it was, MK64's −3..+6 window (`path_utils.inc.c:300`). */
100
+ track(from: number, x: number, z: number, out?: { index: number; lateral: number }): ITrackPoint;
101
+ surface(point: ITrackPoint): Surface;
102
+ /** Road height under x/z near sample `index`, interpolated between samples so a fast kart
103
+ * does not feel the 1 m steps as bumps. */
104
+ heightAt(index: number, x: number, z: number): number;
105
+ /** Road slope dy/ds under x/z near sample `index`, interpolated between samples so a fast kart's
106
+ * pitch does not step per metre. */
107
+ slopeAt(index: number, x: number, z: number): number;
108
+ /** World position of `lateral` metres off sample `index`, on the road surface. */
109
+ pointAt(index: number, lateral: number, out: { x: number; y: number; z: number }): void;
110
+ }
111
+
112
+ /**
113
+ * The figure-8's plan. `x = A·sin t`, `z = B·sin t·cos t + C·sin 3t`: two lobes that cross at the
114
+ * origin (t = 0 and t = π) at about 57°, a hairpin of about 15 m at each lobe's tip and a chicane
115
+ * from the `sin 3t` term, which is zero at both crossings, so the crossing stays a single point.
116
+ */
117
+ const PLAN = { A: 120, B: 75, C: 11 } as const;
118
+
119
+ /** Rolling relief along the line (lap fraction `u`), faded to zero at the crossing by `away`. */
120
+ function relief(u: number, away: number): number {
121
+ return away * (1.6 * Math.sin(u * Math.PI * 6 + 0.7) + 0.9 * Math.sin(u * Math.PI * 10 + 2.1));
122
+ }
123
+
124
+ /** The jump's height profile in metres along the line, relative to the relief. */
125
+ function jumpProfile(s: number, start: number): number {
126
+ const { kick, rise, drop, depth, floor, climb } = LAYOUT.jump;
127
+ const d = s - start;
128
+ if (d < 0) return 0;
129
+ if (d < kick) return rise * (d / kick) ** 1.6;
130
+ if (d < kick + drop) return rise - (rise + depth) * smooth(0, 1, (d - kick) / drop);
131
+ if (d < kick + drop + floor) return -depth;
132
+ if (d < kick + drop + floor + climb)
133
+ return -depth * (1 - smooth(0, 1, (d - kick - drop - floor) / climb));
134
+ return 0;
135
+ }
136
+
137
+ export function buildCourse(): ICourse {
138
+ // Dense parametric samples, then resampled every STEP metres of arc length.
139
+ const dense = 8000;
140
+ const px: number[] = [];
141
+ const pz: number[] = [];
142
+ const arc: number[] = [0];
143
+ for (let i = 0; i <= dense; i += 1) {
144
+ const t = (i / dense) * Math.PI * 2;
145
+ px.push(PLAN.A * Math.sin(t));
146
+ pz.push(PLAN.B * Math.sin(t) * Math.cos(t) + PLAN.C * Math.sin(3 * t));
147
+ if (i > 0)
148
+ arc.push(
149
+ (arc[i - 1] ?? 0) +
150
+ Math.hypot((px[i] ?? 0) - (px[i - 1] ?? 0), (pz[i] ?? 0) - (pz[i - 1] ?? 0)),
151
+ );
152
+ }
153
+ const total = arc[dense] ?? 0;
154
+ const count = Math.floor(total / STEP);
155
+ const length = count * STEP;
156
+ const x = new Float32Array(count);
157
+ const y = new Float32Array(count);
158
+ const z = new Float32Array(count);
159
+ const tx = new Float32Array(count);
160
+ const tz = new Float32Array(count);
161
+ const slope = new Float32Array(count);
162
+ const wall = new Float32Array(count);
163
+ const deck = new Float32Array(count);
164
+ // t = 0 is the crossing's upper branch. Sample index i is `start` metres further on, so the
165
+ // start line is index 0 and the bridge's centre is `count - start`.
166
+ const start = Math.round(LAYOUT.start / STEP);
167
+ let j = 0;
168
+ for (let k = 0; k < count; k += 1) {
169
+ const s = (k / count) * total;
170
+ while (j < dense - 1 && (arc[j + 1] ?? 0) < s) j += 1;
171
+ const f = (s - (arc[j] ?? 0)) / ((arc[j + 1] ?? 1) - (arc[j] ?? 0));
172
+ const i = (k - start + count) % count;
173
+ x[i] = (px[j] ?? 0) + ((px[j + 1] ?? 0) - (px[j] ?? 0)) * f;
174
+ z[i] = (pz[j] ?? 0) + ((pz[j + 1] ?? 0) - (pz[j] ?? 0)) * f;
175
+ }
176
+ const bridgeAt = (count - start) * STEP;
177
+ // The lower branch passes the crossing near the middle of the lap: its closest sample to it.
178
+ let underAt = 0;
179
+ let closest = Number.POSITIVE_INFINITY;
180
+ for (let i = 0; i < count; i += 1) {
181
+ let apart = Math.abs(i * STEP - bridgeAt);
182
+ apart = Math.min(apart, length - apart);
183
+ const d = Math.hypot(x[i] ?? 0, z[i] ?? 0);
184
+ if (apart > length / 4 && d < closest) {
185
+ closest = d;
186
+ underAt = i * STEP;
187
+ }
188
+ }
189
+ const jumpStart = LAYOUT.jump.at * length;
190
+ for (let i = 0; i < count; i += 1) {
191
+ const next = (i + 1) % count;
192
+ const prev = (i - 1 + count) % count;
193
+ const dx = (x[next] ?? 0) - (x[prev] ?? 0);
194
+ const dz = (z[next] ?? 0) - (z[prev] ?? 0);
195
+ const n = Math.hypot(dx, dz) || 1;
196
+ tx[i] = dx / n;
197
+ tz[i] = dz / n;
198
+ const s = i * STEP;
199
+ const { flat, ramp, height, cut } = LAYOUT.bridge;
200
+ const onBridge = plateau(s, bridgeAt, length, flat, ramp);
201
+ const inCut = plateau(s, underAt, length, flat, ramp);
202
+ const away =
203
+ 1 - plateau(s, bridgeAt, length, flat + ramp, 20) - plateau(s, underAt, length, flat, 30);
204
+ y[i] = height * onBridge - cut * inCut + relief(i / count, away) + jumpProfile(s, jumpStart);
205
+ // The deck is the stretch where the bridge stands clear of the ground under it.
206
+ deck[i] = onBridge > 0.3 ? 1 : 0;
207
+ wall[i] = deck[i] === 1 ? PROFILE.rail : PROFILE.wall;
208
+ }
209
+ for (let i = 0; i < count; i += 1) {
210
+ slope[i] = ((y[(i + 1) % count] ?? 0) - (y[(i - 1 + count) % count] ?? 0)) / (2 * STEP);
211
+ }
212
+ const index = (fraction: number) => Math.round(fraction * count) % count;
213
+ const creekFirst = Math.round((jumpStart + LAYOUT.jump.kick + LAYOUT.jump.drop) / STEP);
214
+ const wrap = (i: number) => ((i % count) + count) % count;
215
+ const lateralOf = (i: number, px0: number, pz0: number) =>
216
+ // Right of travel: the tangent turned 90° clockwise seen from above, (−tz, tx).
217
+ (px0 - (x[i] ?? 0)) * -(tz[i] ?? 0) + (pz0 - (z[i] ?? 0)) * (tx[i] ?? 0);
218
+ return {
219
+ boxes: LAYOUT.boxes.map(index),
220
+ checkpoints: LAYOUT.checkpoints.map(index),
221
+ count,
222
+ creek: [creekFirst, creekFirst + LAYOUT.jump.floor],
223
+ deck,
224
+ length,
225
+ heightAt(i, px0, pz0) {
226
+ const k = wrap(i);
227
+ const along = (px0 - (x[k] ?? 0)) * (tx[k] ?? 0) + (pz0 - (z[k] ?? 0)) * (tz[k] ?? 0);
228
+ const other = wrap(k + (along >= 0 ? 1 : -1));
229
+ const f = Math.min(1, Math.abs(along) / STEP);
230
+ return (y[k] ?? 0) + ((y[other] ?? 0) - (y[k] ?? 0)) * f;
231
+ },
232
+ slopeAt(i, px0, pz0) {
233
+ const k = wrap(i);
234
+ const along = (px0 - (x[k] ?? 0)) * (tx[k] ?? 0) + (pz0 - (z[k] ?? 0)) * (tz[k] ?? 0);
235
+ const other = wrap(k + (along >= 0 ? 1 : -1));
236
+ const f = Math.min(1, Math.abs(along) / STEP);
237
+ return (slope[k] ?? 0) + ((slope[other] ?? 0) - (slope[k] ?? 0)) * f;
238
+ },
239
+ pads: LAYOUT.pads.map(({ at, lateral }) => ({ index: index(at), lateral })),
240
+ pointAt(i, lateral, out) {
241
+ const k = wrap(Math.round(i));
242
+ out.x = (x[k] ?? 0) - (tz[k] ?? 0) * lateral;
243
+ out.y = y[k] ?? 0;
244
+ out.z = (z[k] ?? 0) + (tx[k] ?? 0) * lateral;
245
+ },
246
+ slope,
247
+ surface({ index: i, lateral }) {
248
+ const off = Math.abs(lateral);
249
+ if (i >= creekFirst && i <= creekFirst + LAYOUT.jump.floor && off < PROFILE.wall)
250
+ return "water";
251
+ return off <= PROFILE.road + PROFILE.kerb ? "road" : "grass";
252
+ },
253
+ track(from, px0, pz0, out = { index: 0, lateral: 0 }) {
254
+ let best = wrap(from);
255
+ let bestD = Number.POSITIVE_INFINITY;
256
+ for (let k = -3; k <= 6; k += 1) {
257
+ const i = wrap(from + k);
258
+ const d = (px0 - (x[i] ?? 0)) ** 2 + (pz0 - (z[i] ?? 0)) ** 2;
259
+ if (d < bestD) {
260
+ bestD = d;
261
+ best = i;
262
+ }
263
+ }
264
+ out.index = best;
265
+ out.lateral = lateralOf(best, px0, pz0);
266
+ return out;
267
+ },
268
+ tx,
269
+ tz,
270
+ wall,
271
+ wrap,
272
+ x,
273
+ y,
274
+ z,
275
+ };
276
+ }
@@ -0,0 +1,133 @@
1
+ import type { Kart } from "../entities/Kart.js";
2
+ import type { ICourse } from "./Course.js";
3
+
4
+ /** The race's rules, in seconds, laps and lap fractions. */
5
+ export const RACE = {
6
+ laps: 3,
7
+ /** "READY", then three lights a second apart, then GO. MK64's pre-roll is 8 s (Decisions). */
8
+ ready: 1,
9
+ light: 1,
10
+ lights: 3,
11
+ /** A fresh throttle press this close before GO is a rocket start (`mk64: src/update_objects.c:3055`). */
12
+ rocketWindow: 8 / 60,
13
+ /** Only crossings this near the line count as crossings (MK64's first or last 20 points). */
14
+ lineReach: 20,
15
+ /** Wrong way: heading 136°–225° off the line for 5 ticks (`cpu_vehicles_camera_path.c:673`). */
16
+ wrongWayCos: Math.cos((136 * Math.PI) / 180),
17
+ wrongWayTicks: 5,
18
+ /** The rubber band, in laps: a CPU this far behind the player catches up; one ahead by more
19
+ * than `ahead + aheadPerPlace·place` lifts off (`cpu_vehicles_camera_path.c:955`). */
20
+ behind: 0.03,
21
+ ahead: 0.06,
22
+ aheadPerPlace: 0.012,
23
+ } as const;
24
+
25
+ export type RacePhase = "countdown" | "race" | "finished";
26
+
27
+ /** One kart's place in the race: lap, checkpoints, progress and finish. */
28
+ export class Racer {
29
+ /** MK64 starts the counter at −1: the grid is behind the line, so its first crossing makes lap 0. */
30
+ lap = -1;
31
+ /** The checkpoint to pass next; all of them count as passed on the grid. */
32
+ next: number;
33
+ progress = 0;
34
+ rank = 0;
35
+ finished = false;
36
+ finishTime = 0;
37
+ /** Checkpoints passed in order this lap, for the HUD and the scenarios. */
38
+ passed = 0;
39
+ /** Laps lost by crossing the line backwards. */
40
+ backCrossings = 0;
41
+ /** Largest jump of the course index in one tick: the window allows −3..+6. */
42
+ maxJump = 0;
43
+ wrongWay = false;
44
+ #wrongTicks = 0;
45
+ #index: number;
46
+
47
+ constructor(
48
+ readonly name: string,
49
+ readonly kart: Kart,
50
+ readonly checkpoints: readonly number[],
51
+ ) {
52
+ this.next = checkpoints.length;
53
+ this.#index = kart.index;
54
+ }
55
+
56
+ /** Re-reads the kart's place after a scenario moved it, without counting a crossing. */
57
+ resync(): void {
58
+ this.#index = this.kart.index;
59
+ }
60
+
61
+ /** The lap shown on the HUD, 1-based and never past the last. */
62
+ get displayLap(): number {
63
+ return Math.max(1, Math.min(RACE.laps, this.lap + 1));
64
+ }
65
+
66
+ update(course: ICourse, time: number): void {
67
+ const before = this.#index;
68
+ const after = this.kart.index;
69
+ this.#index = after;
70
+ const count = course.count;
71
+ let jump = after - before;
72
+ if (jump > count / 2) jump -= count;
73
+ if (jump < -count / 2) jump += count;
74
+ this.maxJump = Math.max(this.maxJump, Math.abs(jump));
75
+ if (this.finished) return;
76
+
77
+ const near = RACE.lineReach;
78
+ if (before >= count - near && after < near) {
79
+ // Forward over the line: a lap only once every checkpoint was passed in order.
80
+ if (this.next === this.checkpoints.length) {
81
+ this.lap += 1;
82
+ this.next = 0;
83
+ this.passed = 0;
84
+ if (this.lap >= RACE.laps) {
85
+ this.finished = true;
86
+ this.finishTime = time;
87
+ }
88
+ }
89
+ } else if (before < near && after >= count - near) {
90
+ // Backwards over the line takes the lap back; crossing forward again returns it.
91
+ this.lap -= 1;
92
+ this.next = this.checkpoints.length;
93
+ this.backCrossings += 1;
94
+ } else {
95
+ const ahead = this.checkpoints[this.next];
96
+ if (ahead !== undefined && before < ahead && after >= ahead) {
97
+ this.next += 1;
98
+ this.passed += 1;
99
+ }
100
+ const behind = this.checkpoints[this.next - 1];
101
+ if (behind !== undefined && before >= behind && after < behind) {
102
+ this.next -= 1;
103
+ this.passed = Math.max(0, this.passed - 1);
104
+ }
105
+ }
106
+ this.progress = this.lap + after / count;
107
+
108
+ // Wrong way: the nose points back along the line.
109
+ const kart = this.kart;
110
+ const facing =
111
+ -Math.sin(kart.yaw) * (course.tx[after] ?? 0) - Math.cos(kart.yaw) * (course.tz[after] ?? 0);
112
+ this.#wrongTicks = facing < RACE.wrongWayCos && kart.speed > 1 ? this.#wrongTicks + 1 : 0;
113
+ this.wrongWay = this.#wrongTicks >= RACE.wrongWayTicks;
114
+ }
115
+ }
116
+
117
+ /** Sorts the field: finishers by finish time, then everyone else by progress (`cpu_vehicles_camera_path.c:1126`). */
118
+ export function rank(racers: readonly Racer[]): Racer[] {
119
+ const order = [...racers].sort((a, b) => {
120
+ if (a.finished && b.finished) return a.finishTime - b.finishTime;
121
+ if (a.finished !== b.finished) return a.finished ? -1 : 1;
122
+ return b.progress - a.progress;
123
+ });
124
+ order.forEach((racer, i) => {
125
+ racer.rank = i + 1;
126
+ });
127
+ return order;
128
+ }
129
+
130
+ export function ordinal(place: number): string {
131
+ const suffix = place === 1 ? "st" : place === 2 ? "nd" : place === 3 ? "rd" : "th";
132
+ return `${place}${suffix}`;
133
+ }
@@ -0,0 +1,21 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
3
+ import type { GameState } from "../state.js";
4
+ import { GameUi } from "./GameUi.js";
5
+
6
+ /**
7
+ * The web target's page: the canvas, then the same UI every other target renders.
8
+ *
9
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
10
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
11
+ * has to put a canvas on the page.
12
+ */
13
+ export function App({ game }: { game: IGame<GameState> }) {
14
+ return (
15
+ <main className="relative h-screen w-screen overflow-hidden bg-cover">
16
+ <GameCanvas className="absolute inset-0" game={game} />
17
+ <GameUi />
18
+ <DebugOverlay />
19
+ </main>
20
+ );
21
+ }
@@ -0,0 +1,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }