create-threenative 0.2.2 → 0.2.4

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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,4 +1,10 @@
1
- import { type ICtx, Scene, type SceneFrame } from "@threenative/core";
1
+ import {
2
+ type ICtx,
3
+ Scene,
4
+ type SceneFrame,
5
+ isMobile,
6
+ isTouchscreenAvailable,
7
+ } from "@threenative/core";
2
8
  import type { IPhysicsContext } from "@threenative/physics";
3
9
  import { type PerspectiveCamera, Vector3 } from "three";
4
10
  import { RACING_FEEL, RacingCar } from "../entities/RacingCar.js";
@@ -11,9 +17,10 @@ import { createMaterials } from "../render/materials.js";
11
17
  import { setupPost } from "../render/postprocessing.js";
12
18
  import { flag } from "../render/shapes.js";
13
19
  import { setupSky } from "../render/sky.js";
20
+ import { TouchControls } from "../render/touch-controls.js";
14
21
  import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
15
22
  import { Lap } from "../track/Lap.js";
16
- import { rankRacers } from "../track/Ranking.js";
23
+ import { type IRankedRacer, type IRankedRacerScratch, rankRacers } from "../track/Ranking.js";
17
24
  import { TOTAL_LAPS, buildTrack, intersectRay, roadRayProbe } from "../track/Track.js";
18
25
  import { TrackSector } from "../track/TrackSector.js";
19
26
 
@@ -22,8 +29,22 @@ export type GameCtx = ICtx<GameState, IPhysicsContext>;
22
29
  const SPAWN = new Vector3(2, 0.55, -18);
23
30
  const TIME_LIMIT = 90;
24
31
 
32
+ function playerRanking(ranked: readonly IRankedRacer[]): IRankedRacer | undefined {
33
+ for (let index = 0; index < ranked.length; index += 1) {
34
+ const racer = ranked[index];
35
+ if (racer?.id === "player") return racer;
36
+ }
37
+ return undefined;
38
+ }
39
+
40
+ function quantize(value: number, scale: number): number {
41
+ return Math.round(value * scale) / scale;
42
+ }
43
+
25
44
  export class Race extends Scene<GameState, IPhysicsContext> {
26
45
  static override readonly initialState: GameState = {
46
+ paused: false,
47
+ uiReady: false,
27
48
  boostActive: false,
28
49
  boostPeakSpeed: 0,
29
50
  boostUses: 0,
@@ -49,12 +70,18 @@ export class Race extends Scene<GameState, IPhysicsContext> {
49
70
 
50
71
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
51
72
  setupSky(ctx.scene);
52
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
53
- setupPost(ctx.renderer, ctx.scene, ctx.camera);
73
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
74
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
75
+ // platform decision is made here, in portable game code, exactly like createRandom.
76
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
54
77
  const loading = createLoadingScreen(ctx);
55
78
  const camera = ctx.camera as PerspectiveCamera;
56
79
  setupCamera(camera);
57
80
  ctx.add(camera);
81
+ const showTouchControls = isMobile() && isTouchscreenAvailable();
82
+ const touchControls = showTouchControls
83
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
84
+ : undefined;
58
85
  const track = buildTrack(ctx);
59
86
  const car = new RacingCar(ctx, SPAWN);
60
87
  const spawnDistance = track.route.project(SPAWN).distanceFromStart % track.route.totalLength;
@@ -77,13 +104,17 @@ export class Race extends Scene<GameState, IPhysicsContext> {
77
104
  TOTAL_LAPS,
78
105
  (completed) => emitPlaytestEvent({ entity: "player", lap: completed, name: "lap-completed" }),
79
106
  );
80
- const rankRace = () =>
81
- rankRacers(track.route, [
82
- { id: "player", lap: lap.completed, position: car.mesh.position },
83
- { id: "rival", lap: rival.lap, position: rival.mesh.position },
84
- ]);
107
+ const playerRankingInput = { id: "player", lap: lap.completed, position: car.mesh.position };
108
+ const rivalRankingInput = { id: "rival", lap: rival.lap, position: rival.mesh.position };
109
+ const rankingInputs = [playerRankingInput, rivalRankingInput];
110
+ const rankingBuffer: IRankedRacerScratch[] = [];
111
+ const rankRace = () => {
112
+ playerRankingInput.lap = lap.completed;
113
+ rivalRankingInput.lap = rival.lap;
114
+ return rankRacers(track.route, rankingInputs, undefined, rankingBuffer);
115
+ };
85
116
  const initialRanked = rankRace();
86
- const initialPlayer = initialRanked.find((entry) => entry.id === "player");
117
+ const initialPlayer = playerRanking(initialRanked);
87
118
  if (initialPlayer === undefined) throw new Error("Race ranking lost the player at spawn.");
88
119
  const fallbackProbe = roadRayProbe(track.roadMeshes);
89
120
  const sector = new TrackSector({
@@ -105,6 +136,9 @@ export class Race extends Scene<GameState, IPhysicsContext> {
105
136
  let speedAfterBoost = 0;
106
137
  let boostSettled = false;
107
138
  let sameDistanceRanking = initialRanked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
139
+ let place = initialPlayer.place;
140
+ let positionLabel = `P${place}`;
141
+ const lastOnRoad: [number, number, number] = [SPAWN.x, SPAWN.y, SPAWN.z];
108
142
  const observedPosition = SPAWN.clone();
109
143
  sector.update(SPAWN, car.forward, 0);
110
144
  chaseCamera(camera, car.mesh.position, car.forward, 1);
@@ -113,20 +147,27 @@ export class Race extends Scene<GameState, IPhysicsContext> {
113
147
  if (status !== "RACING") return;
114
148
  lap.observe(observedPosition, car.mesh.position);
115
149
  observedPosition.copy(car.mesh.position);
116
- car.update(frameCtx, dt);
150
+ car.update(
151
+ frameCtx,
152
+ dt,
153
+ touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
154
+ );
117
155
  rival.update(dt);
118
156
  sector.update(car.mesh.position, car.forward, dt);
119
157
  if (sector.rescue(car)) {
120
158
  rescues += 1;
121
- rescuePositionError = Number(
122
- car.mesh.position.distanceTo(sector.lastOnRoadPosition).toFixed(4),
159
+ rescuePositionError = quantize(
160
+ car.mesh.position.distanceTo(sector.lastOnRoadPosition),
161
+ 10_000,
123
162
  );
124
- rescueHeadingError = Number(car.forward.angleTo(sector.lastOnRoadHeading).toFixed(4));
163
+ rescueHeadingError = quantize(car.forward.angleTo(sector.lastOnRoadHeading), 10_000);
125
164
  emitPlaytestEvent({ entity: "player", name: "rescued" });
126
165
  }
127
166
  if (elapsed >= TIME_LIMIT || rescues >= 4) status = "DNF";
128
167
  };
129
168
 
169
+ const statePatch: Partial<GameState> = {};
170
+
130
171
  return (frameCtx, dt) => {
131
172
  loading.update();
132
173
  if (frameCtx.input.justPressed("restart")) {
@@ -145,34 +186,40 @@ export class Race extends Scene<GameState, IPhysicsContext> {
145
186
  }
146
187
  }
147
188
  const ranked = rankRace();
148
- const player = ranked.find((entry) => entry.id === "player");
189
+ const player = playerRanking(ranked);
149
190
  if (player === undefined) throw new Error("Race ranking lost the player.");
150
191
  sameDistanceRanking = ranked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
151
192
  status = resolveRaceStatus(status, lap.completed, TOTAL_LAPS, player.place);
193
+ if (player.place !== place) {
194
+ place = player.place;
195
+ positionLabel = `P${place}`;
196
+ }
152
197
  const previous = frameCtx.state.getState();
153
198
  const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.boost.active ? car.speed : 0);
154
- frameCtx.state.set({
155
- boostActive: car.boost.active,
156
- boostPeakSpeed,
157
- boostUses: car.boost.uses,
158
- completedLaps: lap.completed,
159
- elapsed,
160
- lastOnRoad: sector.lastOnRoadPosition.toArray() as [number, number, number],
161
- place: player.place,
162
- position: `P${player.place}`,
163
- raceStatus: status,
164
- rescueHeading: Math.atan2(sector.lastOnRoadHeading.z, sector.lastOnRoadHeading.x),
165
- rescueHeadingError,
166
- rescuePositionError,
167
- rescues,
168
- shortcutRejects: lap.shortcutRejects,
169
- speed: car.speed,
170
- speedAfterBoost,
171
- sameDistanceRanking,
172
- topSpeed: Math.max(previous.topSpeed, car.topSpeed),
173
- trackProgress: player.routeProgress,
174
- reverseRejects: lap.reverseRejects,
175
- });
199
+ lastOnRoad[0] = sector.lastOnRoadPosition.x;
200
+ lastOnRoad[1] = sector.lastOnRoadPosition.y;
201
+ lastOnRoad[2] = sector.lastOnRoadPosition.z;
202
+ statePatch.boostActive = car.boost.active;
203
+ statePatch.boostPeakSpeed = boostPeakSpeed;
204
+ statePatch.boostUses = car.boost.uses;
205
+ statePatch.completedLaps = lap.completed;
206
+ statePatch.elapsed = elapsed;
207
+ statePatch.lastOnRoad = lastOnRoad;
208
+ statePatch.place = player.place;
209
+ statePatch.position = positionLabel;
210
+ statePatch.raceStatus = status;
211
+ statePatch.rescueHeading = Math.atan2(sector.lastOnRoadHeading.z, sector.lastOnRoadHeading.x);
212
+ statePatch.rescueHeadingError = rescueHeadingError;
213
+ statePatch.rescuePositionError = rescuePositionError;
214
+ statePatch.rescues = rescues;
215
+ statePatch.shortcutRejects = lap.shortcutRejects;
216
+ statePatch.speed = car.speed;
217
+ statePatch.speedAfterBoost = speedAfterBoost;
218
+ statePatch.sameDistanceRanking = sameDistanceRanking;
219
+ statePatch.topSpeed = Math.max(previous.topSpeed, car.topSpeed);
220
+ statePatch.trackProgress = player.routeProgress;
221
+ statePatch.reverseRejects = lap.reverseRejects;
222
+ frameCtx.state.set(statePatch);
176
223
  chaseCamera(camera, car.mesh.position, car.forward, dt);
177
224
  cameraRoll(camera, car.forward);
178
225
  };
@@ -11,6 +11,10 @@ export function resolveRaceStatus(
11
11
  }
12
12
 
13
13
  export type GameState = {
14
+ /** Set from the UI\'s pause and resume intents, and read back by the menu. */
15
+ paused: boolean;
16
+ /** True once the UI layer has rendered and published its interactive rectangles. */
17
+ uiReady: boolean;
14
18
  boostActive: boolean;
15
19
  boostPeakSpeed: number;
16
20
  speedAfterBoost: number;
@@ -25,8 +25,72 @@ body,
25
25
  }
26
26
 
27
27
  body {
28
- background: var(--color-ink);
29
28
  color: var(--color-text);
30
29
  font-family: var(--font-mono);
31
30
  -webkit-font-smoothing: antialiased;
32
31
  }
32
+
33
+ /*
34
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
35
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
36
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
37
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
38
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
39
+ */
40
+
41
+ #root {
42
+ background: var(--color-ink);
43
+ }
44
+
45
+ /* Boot failures are a page state, so the generated game owns their presentation. */
46
+ [data-threenative-canvas-error="true"] {
47
+ position: fixed;
48
+ inset: 0;
49
+ z-index: 1000;
50
+ display: grid;
51
+ place-items: center;
52
+ box-sizing: border-box;
53
+ padding: clamp(1.5rem, 8vw, 6rem);
54
+ overflow: auto;
55
+ background: #fff7ed;
56
+ color: var(--color-ink);
57
+ font-family: inherit;
58
+ font-size: clamp(1rem, 2vw, 1.5rem);
59
+ line-height: 1.5;
60
+ text-align: center;
61
+ white-space: pre-wrap;
62
+ overflow-wrap: anywhere;
63
+ }
64
+
65
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
66
+ [data-threenative-debug-overlay="true"] {
67
+ position: fixed;
68
+ top: 1rem;
69
+ right: 1rem;
70
+ z-index: 50;
71
+ max-width: 24rem;
72
+ padding: 0.75rem;
73
+ pointer-events: none;
74
+ background: rgb(2 6 23 / 90%);
75
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
76
+ color: #cffafe;
77
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
78
+ font-size: 12px;
79
+ line-height: 1.5;
80
+ }
81
+
82
+ [data-threenative-debug-overlay="true"] table {
83
+ width: 100%;
84
+ table-layout: fixed;
85
+ }
86
+
87
+ [data-threenative-debug-overlay="true"] th,
88
+ [data-threenative-debug-overlay="true"] td {
89
+ padding-right: 1rem;
90
+ text-align: left;
91
+ }
92
+
93
+ [data-threenative-debug-overlay="true"] td:last-child {
94
+ overflow-wrap: anywhere;
95
+ word-break: break-all;
96
+ }
@@ -1,5 +1,5 @@
1
1
  import type { PhysicsBody3D } from "@threenative/physics";
2
- import type { Vector3 } from "three";
2
+ import { Vector3 } from "three";
3
3
  import type { Checkline } from "./Checkline.js";
4
4
 
5
5
  export interface ILapTarget {
@@ -15,8 +15,13 @@ export class Lap {
15
15
  reverseRejects = 0;
16
16
  #target: ILapTarget;
17
17
  #gates: readonly Checkline[];
18
+ #gateNormals: Vector3[] = [];
18
19
  #onLap: (lap: number) => void;
19
20
  #unsubscribe: (() => void)[] = [];
21
+ #targetDirection = new Vector3();
22
+ #gateDirection = new Vector3();
23
+ #before = new Vector3();
24
+ #after = new Vector3();
20
25
 
21
26
  constructor(
22
27
  target: ILapTarget,
@@ -31,8 +36,11 @@ export class Lap {
31
36
  this.#gates = gates;
32
37
  this.totalLaps = totalLaps;
33
38
  this.#onLap = onLap;
34
- for (const [index, gate] of gates.entries()) {
39
+ for (let index = 0; index < gates.length; index += 1) {
40
+ const gate = gates[index];
41
+ if (gate === undefined) throw new Error("Lap gate is missing.");
35
42
  const expected = gate.forward.clone().setY(0).normalize();
43
+ this.#gateNormals.push(expected);
36
44
  this.#unsubscribe.push(
37
45
  gate.area.on("bodyEntered", (body) => {
38
46
  if (body !== this.#target.body || this.completed >= this.totalLaps) return;
@@ -49,11 +57,11 @@ export class Lap {
49
57
  return false;
50
58
  }
51
59
  const direction = gateForward ?? gate.forward;
52
- const travel = this.#target.forward
53
- .clone()
60
+ const travel = this.#targetDirection
61
+ .copy(this.#target.forward)
54
62
  .setY(0)
55
63
  .normalize()
56
- .dot(direction.clone().setY(0).normalize());
64
+ .dot(this.#gateDirection.copy(direction).setY(0).normalize());
57
65
  if (travel <= 0.2) {
58
66
  this.reverseRejects += 1;
59
67
  return false;
@@ -72,10 +80,13 @@ export class Lap {
72
80
 
73
81
  /** Sweeps a car transform between frames so a fast body cannot skip a thin sensor. */
74
82
  observe(previous: Vector3, current: Vector3): void {
75
- for (const [index, gate] of this.#gates.entries()) {
76
- const normal = gate.forward.clone().setY(0).normalize();
77
- const before = previous.clone().sub(gate.at).dot(normal);
78
- const after = current.clone().sub(gate.at).dot(normal);
83
+ for (let index = 0; index < this.#gates.length; index += 1) {
84
+ const gate = this.#gates[index];
85
+ if (gate === undefined) throw new Error("Lap gate is missing.");
86
+ const normal = this.#gateNormals[index];
87
+ if (normal === undefined) throw new Error("Lap gate normal is missing.");
88
+ const before = this.#before.copy(previous).sub(gate.at).dot(normal);
89
+ const after = this.#after.copy(current).sub(gate.at).dot(normal);
79
90
  const crossedForward = before < 0 && after >= 0;
80
91
  const crossedReverse = before >= 0 && after < 0;
81
92
  if (crossedForward || crossedReverse) this.cross(index);
@@ -1,5 +1,5 @@
1
- import type { PathFollow3D } from "@threenative/core";
2
- import type { Vector3 } from "three";
1
+ import type { IPathFollow3DProjection, PathFollow3D } from "@threenative/core";
2
+ import { Vector3 } from "three";
3
3
 
4
4
  export interface IRacerProgress {
5
5
  readonly id: string;
@@ -12,24 +12,63 @@ export interface IRankedRacer extends IRacerProgress {
12
12
  readonly routeProgress: number;
13
13
  }
14
14
 
15
- export function routeProgress(route: PathFollow3D, position: Vector3, lap: number): number {
15
+ export interface IRankedRacerScratch {
16
+ id: string;
17
+ lap: number;
18
+ position: Vector3;
19
+ place: number;
20
+ routeProgress: number;
21
+ }
22
+
23
+ const projectionScratch: IPathFollow3DProjection = {
24
+ distanceFromStart: 0,
25
+ lateralDistance: 0,
26
+ point: new Vector3(0, 0, 0),
27
+ segment: 0,
28
+ tangent: new Vector3(0, 0, 1),
29
+ };
30
+
31
+ function compareRankedRacers(left: IRankedRacerScratch, right: IRankedRacerScratch): number {
32
+ return right.routeProgress - left.routeProgress || left.id.localeCompare(right.id);
33
+ }
34
+
35
+ export function routeProgress(
36
+ route: PathFollow3D,
37
+ position: Vector3,
38
+ lap: number,
39
+ target: IPathFollow3DProjection = projectionScratch,
40
+ ): number {
16
41
  if (!Number.isInteger(lap) || lap < 0)
17
42
  throw new Error("Racing route lap must be a non-negative integer.");
18
- return lap * route.totalLength + route.project(position).distanceFromStart;
43
+ return lap * route.totalLength + route.project(position, target).distanceFromStart;
19
44
  }
20
45
 
21
46
  export function rankRacers(
22
47
  route: PathFollow3D,
23
48
  racers: readonly IRacerProgress[],
49
+ target: IPathFollow3DProjection = projectionScratch,
50
+ buffer: IRankedRacerScratch[] = [],
24
51
  ): readonly IRankedRacer[] {
25
- const ranked = racers
26
- .map((racer) => ({
27
- ...racer,
28
- place: 0,
29
- routeProgress: routeProgress(route, racer.position, racer.lap),
30
- }))
31
- .sort(
32
- (left, right) => right.routeProgress - left.routeProgress || left.id.localeCompare(right.id),
33
- );
34
- return ranked.map((racer, index) => ({ ...racer, place: index + 1 }));
52
+ if (buffer.length > racers.length) buffer.length = racers.length;
53
+ for (let index = buffer.length; index < racers.length; index += 1) {
54
+ buffer.push({ id: "", lap: 0, position: projectionScratch.point, place: 0, routeProgress: 0 });
55
+ }
56
+ for (let index = 0; index < racers.length; index += 1) {
57
+ const racer = racers[index];
58
+ if (racer === undefined) throw new Error("Racing racer input is missing.");
59
+ const ranked = buffer[index];
60
+ if (ranked === undefined) throw new Error("Racing ranking buffer slot is missing.");
61
+ ranked.id = racer.id;
62
+ ranked.lap = racer.lap;
63
+ ranked.position = racer.position;
64
+ ranked.routeProgress = routeProgress(route, racer.position, racer.lap, target);
65
+ ranked.place = 0;
66
+ }
67
+ buffer.sort(compareRankedRacers);
68
+ for (let index = 0; index < buffer.length; index += 1) {
69
+ const racer = buffer[index];
70
+ if (racer === undefined) throw new Error("Racing ranked racer is missing.");
71
+ racer.place = index + 1;
72
+ }
73
+ return buffer;
35
74
  }