create-threenative 0.2.2 → 0.2.3

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 (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,32 +1,53 @@
1
- import { AudioBus, type ICtx, Scene, type SceneFrame } from "@threenative/core";
1
+ import {
2
+ AudioBus,
3
+ type ICtx,
4
+ Scene,
5
+ type SceneFrame,
6
+ createRandom,
7
+ isMobile,
8
+ } from "@threenative/core";
2
9
  import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { DoubleSide, Group, Mesh, MeshBasicMaterial, type PerspectiveCamera, Vector3 } from "three";
10
+ import { BufferAttribute, Group, Mesh, NearestFilter, type PerspectiveCamera } from "three";
4
11
  import { Crate } from "../entities/Crate.js";
12
+ import { Goal } from "../entities/Goal.js";
5
13
  import { Player } from "../entities/Player.js";
6
14
  import { createSpringArm } from "../render/camera.js";
15
+ import { pickupRiseEase } from "../render/easing.js";
7
16
  import { setupLighting } from "../render/lighting.js";
8
- import { createMaterials } from "../render/materials.js";
17
+ import { createLoadingScreen } from "../render/loading.js";
18
+ import { createMaterials, createPennantMaterial } from "../render/materials.js";
9
19
  import { setupPost } from "../render/postprocessing.js";
10
- import { ball, block, makeRandom, roundedBox, sculpture, spike, tube } from "../render/shapes.js";
20
+ import { createScenery } from "../render/scenery.js";
21
+ import { ball, block, roundedBox, spike, tube } from "../render/shapes.js";
11
22
  import { setupSky } from "../render/sky.js";
12
23
  import type { GameState } from "../state.js";
13
24
 
14
25
  export type GameCtx = ICtx<GameState, IPhysicsContext>;
15
26
 
16
27
  const KILL_PLANE = -4;
28
+ const STARTING_LIVES = 3;
17
29
 
18
30
  export class Play extends Scene<GameState, IPhysicsContext> {
19
- #assetProof: Group | undefined;
31
+ #assetProof: Mesh | undefined;
20
32
 
21
33
  static override readonly initialState: GameState = {
22
34
  coyoteJumps: 0,
23
35
  entityCount: 0,
36
+ flagDisplacement: 0,
37
+ flagGusts: 0,
38
+ flagReadbacks: 0,
39
+ flagSteps: 0,
24
40
  jumps: 0,
25
41
  levelX: -99,
42
+ lives: STARTING_LIVES,
43
+ odometer: 0,
44
+ paused: false,
26
45
  peakRise: 0,
27
46
  playerX: -2,
28
47
  respawns: 0,
29
48
  score: 0,
49
+ status: "playing",
50
+ uiReady: false,
30
51
  };
31
52
 
32
53
  override async load(ctx: GameCtx): Promise<void> {
@@ -34,38 +55,76 @@ export class Play extends Scene<GameState, IPhysicsContext> {
34
55
  ctx.assets.texture("native-proof.png"),
35
56
  ctx.assets.model<{ scene: Group }>("native-proof.glb"),
36
57
  ]);
58
+ // A 16-pixel check filtered smoothly is a grey smear at flag size; nearest keeps the
59
+ // squares square, which is the whole reason the finish flag is legible from the ledge.
60
+ texture.magFilter = NearestFilter;
61
+ let pennant: Mesh | undefined;
37
62
  model.scene.traverse((object) => {
38
63
  if (object instanceof Mesh) {
39
- object.material = new MeshBasicMaterial({ map: texture, side: DoubleSide });
64
+ if (pennant !== undefined) throw new Error("Starter proof glTF must contain one mesh.");
65
+ object.material = createPennantMaterial(texture);
66
+ // The packaged proof carries positions and indices only. Without UVs the sampler
67
+ // reads one corner texel for every fragment and the flag renders as flat white —
68
+ // a loaded texture that proves nothing you can see. Plane-project the triangle.
69
+ // Compiled models may be quantized (KHR_mesh_quantization): the attribute then holds
70
+ // normalized integers, so measure each axis range from the array itself instead of
71
+ // assuming float32 metres — the affine projection is identical either way.
72
+ const position = object.geometry.getAttribute("position");
73
+ let minX = Number.POSITIVE_INFINITY;
74
+ let minY = Number.POSITIVE_INFINITY;
75
+ let maxX = Number.NEGATIVE_INFINITY;
76
+ let maxY = Number.NEGATIVE_INFINITY;
77
+ for (let index = 0; index < position.count; index += 1) {
78
+ minX = Math.min(minX, position.getX(index));
79
+ maxX = Math.max(maxX, position.getX(index));
80
+ minY = Math.min(minY, position.getY(index));
81
+ maxY = Math.max(maxY, position.getY(index));
82
+ }
83
+ const spanX = Math.max(maxX - minX, Number.EPSILON);
84
+ const spanY = Math.max(maxY - minY, Number.EPSILON);
85
+ const uv = new Float32Array(position.count * 2);
86
+ for (let index = 0; index < position.count; index += 1) {
87
+ uv[index * 2] = (position.getX(index) - minX) / spanX;
88
+ uv[index * 2 + 1] = (position.getY(index) - minY) / spanY;
89
+ }
90
+ object.geometry.setAttribute("uv", new BufferAttribute(uv, 2));
91
+ pennant = object;
40
92
  }
41
93
  });
94
+ if (pennant === undefined) throw new Error("Starter proof glTF did not contain a mesh.");
42
95
  model.scene.name = "native-proof-assets";
43
- this.#assetProof = model.scene;
96
+ this.#assetProof = pennant;
44
97
  console.info("TN_NATIVE_STARTER_ASSETS_LOADED:texture,glb");
45
98
  }
46
99
 
47
100
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
48
101
  if (this.#assetProof === undefined) throw new Error("Starter proof assets did not load.");
49
- this.#assetProof.position.set(0, 1.7, -1.5);
50
- ctx.add(this.#assetProof);
51
102
  const audio = ctx.entities.add("audio", new AudioBus({ camera: ctx.camera }));
52
- const pickupAudio = ctx.assets.audio("pickup.ogg");
103
+ const pickupAudio = ctx.assets.audio("pickup.wav");
53
104
  void pickupAudio.catch(() => undefined);
54
105
  setupSky(ctx.scene);
55
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
56
- setupPost(ctx.renderer, ctx.scene, ctx.camera);
57
- ctx.add(ctx.camera);
58
- const springArm = createSpringArm(ctx.camera as PerspectiveCamera, {
59
- lookAhead: new Vector3(0, 0.9, -0.4),
106
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
107
+ // isMobile() arrives as an argument because src/render/ imports no framework package:
108
+ // the platform decision is made here, in portable game code, exactly like createRandom.
109
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
110
+ godraysLight: sun,
111
+ mobile: isMobile(),
60
112
  });
113
+ const loading = createLoadingScreen(ctx);
114
+ ctx.add(ctx.camera);
115
+ // Offset, lead and damping all live in render/camera.ts — framing is a look decision.
116
+ const springArm = createSpringArm(ctx.camera as PerspectiveCamera);
61
117
 
62
118
  const materials = createMaterials();
63
- const sculptureMesh = sculpture(materials.crate);
64
- sculptureMesh.name = "sculpture";
65
- sculptureMesh.position.set(-2, 2.6, -1.5);
66
- ctx.add(sculptureMesh);
119
+ ctx.add(createScenery(materials.rock, materials.ridge, createRandom(20_260_821)));
120
+ // Two sentinels, both read by seed.playtest as an out-of-range value rather than as a
121
+ // transition: state.levelX starts at -99, so a level that never builds stays out of range,
122
+ // and seededLevelX becomes 2 if this draw did not advance ctx.random — which is what happens
123
+ // if someone swaps it for Math.random. Neither depends on WHEN the runner samples.
124
+ const randomStateBeforeLevel = ctx.random.state;
67
125
  const levelX = ctx.random.range(-1, 1);
68
- const pickupX = 1.2 + makeRandom(Math.round((levelX + 1) * 1000))() * 0.8;
126
+ const seededLevelX = ctx.random.state === randomStateBeforeLevel ? 2 : levelX;
127
+ const pickupX = 1.2 + createRandom(Math.round((levelX + 1) * 1000))() * 0.8;
69
128
  const floorMesh = new Mesh(roundedBox(10, 0.2, 4, 0.08), materials.floor);
70
129
  floorMesh.position.y = -0.1;
71
130
  floorMesh.receiveShadow = true;
@@ -97,11 +156,22 @@ export class Play extends Scene<GameState, IPhysicsContext> {
97
156
  pickupVisual.castShadow = true;
98
157
  ctx.add(pickupVisual);
99
158
  ctx.entities.add("pickup", pickupVisual);
100
- void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4);
159
+ void ctx.tween(pickupVisual.position, { y: 0.65 }, 0.4, { ease: pickupRiseEase });
101
160
  springArm.snap(player.mesh.position);
102
- ctx.state.set({ levelX });
103
161
  ctx.entities.add("player", player);
104
- ctx.state.set({ entityCount: Object.keys(ctx.entities.snapshot()).length });
162
+ // The packaged proof asset earns its place here: it is the pennant on the finish flag,
163
+ // not a debug object parked over the level. The texture and the glTF still load in
164
+ // `load()` above, which is what the native asset gate greps for.
165
+ const goal = ctx.entities.add("goal", new Goal(ctx, materials, this.#assetProof));
166
+ // The area says the character is over the island; the run is only won once it is also
167
+ // standing on it. Ending on the overlap alone freezes the character in mid-air at the
168
+ // lip of the island, half a metre short of a landing, which is what it looks like.
169
+ let overGoal = false;
170
+ goal.area.on("bodyEntered", (body) => {
171
+ if (body === player.body) overGoal = true;
172
+ });
173
+ let entityCount = 4;
174
+ ctx.state.set({ entityCount });
105
175
  const pickup = new Area3D({
106
176
  physics: ctx.physics,
107
177
  position: { x: pickupX, y: 0.5, z: 0 },
@@ -111,13 +181,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
111
181
  if (body !== player.body) return;
112
182
  ctx.state.set((state) => ({ score: state.score + 1 }));
113
183
  ctx.entities.remove("pickup");
114
- ctx.state.set({
115
- entityCount: Object.keys(ctx.entities.snapshot()).length,
116
- });
184
+ entityCount -= 1;
185
+ ctx.state.set({ entityCount });
117
186
  pickup.monitoring = false;
118
187
  pickupVisual.visible = false;
119
188
  ctx.after(3, () => {
120
189
  ctx.entities.add("pickup", pickupVisual);
190
+ entityCount += 1;
191
+ ctx.state.set({ entityCount });
121
192
  pickupVisual.visible = true;
122
193
  pickup.monitoring = true;
123
194
  });
@@ -125,11 +196,19 @@ export class Play extends Scene<GameState, IPhysicsContext> {
125
196
  });
126
197
  if (state.score > 0) {
127
198
  ctx.entities.remove("pickup");
199
+ entityCount -= 1;
200
+ ctx.state.set({ entityCount });
128
201
  pickup.monitoring = false;
129
202
  pickupVisual.visible = false;
130
203
  }
131
204
 
205
+ // Set with the level, not 0.25 s later. The delay existed so the playtest could observe the
206
+ // -99 -> seeded transition, which made the assertion a race against boot time: it was sampled
207
+ // at tick 6 on a workstation and tick 47 in CI, and only the slow sample missed the change.
208
+ ctx.state.set({ levelX: seededLevelX });
209
+ const frameState: Partial<GameState> = {};
132
210
  return (frameCtx, dt) => {
211
+ loading.update();
133
212
  // Restart resets the store before clearing entities and scheduled callbacks.
134
213
  if (frameCtx.input.justPressed("restart")) {
135
214
  frameCtx.state.set(Play.initialState);
@@ -137,24 +216,55 @@ export class Play extends Scene<GameState, IPhysicsContext> {
137
216
  void frameCtx.goto("play");
138
217
  return;
139
218
  }
219
+ const previous = frameCtx.state.getState();
220
+ // A finished run stops simulating the character and keeps drawing the world behind
221
+ // the banner. R, or the restart button, rebuilds the scene from `initialState`.
222
+ if (previous.status !== "playing") return;
223
+ if (frameCtx.input.justPressed("flagGust")) {
224
+ goal.pennant.wind.set(0, 0.4, 4.5);
225
+ frameCtx.state.set((state) => ({ flagGusts: state.flagGusts + 1 }));
226
+ }
140
227
  player.update(frameCtx, dt);
141
228
  let respawned = false;
229
+ let lives = previous.lives;
142
230
  if (player.mesh.position.y < KILL_PLANE) {
231
+ lives -= 1;
143
232
  player.respawn();
144
233
  springArm.snap(player.mesh.position);
145
234
  respawned = true;
146
235
  }
236
+ springArm.dolly(frameCtx.input.axis("zoom"), dt);
147
237
  springArm.follow(player.mesh.position, dt);
148
- const debug = player.debug();
149
- const previous = frameCtx.state.getState();
150
- frameCtx.state.set({
151
- coyoteJumps: debug.coyoteJumps,
152
- jumps: debug.jumps,
153
- peakRise: Math.max(previous.peakRise, player.mesh.position.y - 0.5),
154
- playerX: player.mesh.position.x,
155
- respawns: previous.respawns + (respawned ? 1 : 0),
156
- entityCount: Object.keys(frameCtx.entities.snapshot()).length,
157
- });
238
+ // `status` is written only on the frame that ends the run, and never in the bulk
239
+ // write below, which would stamp this frame's stale copy back over it.
240
+ if (lives <= 0) frameCtx.state.set({ status: "lost" });
241
+ else if (overGoal && player.grounded) {
242
+ frameCtx.state.set({ status: "won" });
243
+ frameCtx.state.flush();
244
+ }
245
+ frameState.coyoteJumps = player.coyoteJumps;
246
+ frameState.flagDisplacement = Math.max(previous.flagDisplacement, goal.flagDisplacement());
247
+ frameState.flagReadbacks = goal.readbackLands();
248
+ frameState.flagSteps = goal.pennant.steps;
249
+ frameState.jumps = player.jumps;
250
+ frameState.lives = lives;
251
+ frameState.odometer = player.odometer;
252
+ frameState.peakRise = Math.max(previous.peakRise, player.mesh.position.y - 0.5);
253
+ frameState.playerX = player.mesh.position.x;
254
+ frameState.respawns = previous.respawns + (respawned ? 1 : 0);
255
+ const current = frameCtx.state.getState();
256
+ const changed =
257
+ frameState.coyoteJumps !== current.coyoteJumps ||
258
+ frameState.flagDisplacement !== current.flagDisplacement ||
259
+ frameState.flagReadbacks !== current.flagReadbacks ||
260
+ frameState.flagSteps !== current.flagSteps ||
261
+ frameState.jumps !== current.jumps ||
262
+ frameState.lives !== current.lives ||
263
+ frameState.odometer !== current.odometer ||
264
+ frameState.peakRise !== current.peakRise ||
265
+ frameState.playerX !== current.playerX ||
266
+ frameState.respawns !== current.respawns;
267
+ if (changed) frameCtx.state.set(frameState);
158
268
  if (respawned) frameCtx.state.flush();
159
269
  };
160
270
  }
@@ -1,10 +1,22 @@
1
1
  export type GameState = {
2
2
  coyoteJumps: number;
3
3
  entityCount: number;
4
+ flagDisplacement: number;
5
+ flagGusts: number;
6
+ flagReadbacks: number;
7
+ flagSteps: number;
4
8
  jumps: number;
5
9
  levelX: number;
10
+ lives: number;
11
+ odometer: number;
12
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
13
+ paused: boolean;
14
+ /** True once the UI layer has rendered and published its interactive rectangles. */
15
+ uiReady: boolean;
6
16
  peakRise: number;
7
17
  playerX: number;
8
18
  respawns: number;
9
19
  score: number;
20
+ /** The run: "playing" until the flag is reached ("won") or the last life is gone ("lost"). */
21
+ status: "lost" | "playing" | "won";
10
22
  };
@@ -38,8 +38,52 @@ body,
38
38
  }
39
39
 
40
40
  body {
41
- background: var(--color-ink);
42
41
  color: var(--color-text);
43
42
  font-family: var(--font-mono);
44
43
  -webkit-font-smoothing: antialiased;
45
44
  }
45
+
46
+ /*
47
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
48
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
49
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
50
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
51
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
52
+ */
53
+
54
+ #root {
55
+ background: var(--color-ink);
56
+ }
57
+
58
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
59
+ [data-threenative-debug-overlay="true"] {
60
+ position: fixed;
61
+ top: 1rem;
62
+ right: 1rem;
63
+ z-index: 50;
64
+ max-width: 24rem;
65
+ padding: 0.75rem;
66
+ pointer-events: none;
67
+ background: rgb(2 6 23 / 90%);
68
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
69
+ color: #cffafe;
70
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
71
+ font-size: 12px;
72
+ line-height: 1.5;
73
+ }
74
+
75
+ [data-threenative-debug-overlay="true"] table {
76
+ width: 100%;
77
+ table-layout: fixed;
78
+ }
79
+
80
+ [data-threenative-debug-overlay="true"] th,
81
+ [data-threenative-debug-overlay="true"] td {
82
+ padding-right: 1rem;
83
+ text-align: left;
84
+ }
85
+
86
+ [data-threenative-debug-overlay="true"] td:last-child {
87
+ overflow-wrap: anywhere;
88
+ word-break: break-all;
89
+ }
@@ -2,17 +2,20 @@ import type { IGame } from "@threenative/core";
2
2
  import type { IPhysicsContext } from "@threenative/physics";
3
3
  import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
4
  import type { GameState } from "../state.js";
5
- import { Hud } from "./Hud.js";
6
- import { Menu } from "./Menu.js";
5
+ import { GameUi } from "./GameUi.js";
7
6
 
7
+ /**
8
+ * The web target's page: the canvas, then the same UI every other target renders.
9
+ *
10
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
11
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
12
+ * has to put a canvas on the page.
13
+ */
8
14
  export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
9
15
  return (
10
- // GameCanvas hosts the renderer; everything after it in this list paints on
11
- // top. Keep the canvas first.
12
16
  <main className="relative h-screen w-screen overflow-hidden bg-ink">
13
17
  <GameCanvas className="absolute inset-0" game={game} />
14
- <Hud game={game} />
15
- <Menu game={game} />
18
+ <GameUi />
16
19
  <DebugOverlay />
17
20
  </main>
18
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
+ }
@@ -1,37 +1,60 @@
1
- import type { IGame } from "@threenative/core";
2
- import type { IPhysicsContext } from "@threenative/physics";
3
- import { useGameState } from "@threenative/ui";
1
+ import { useUiState } from "@threenative/ui";
4
2
  import type { GameState } from "../state.js";
5
3
 
6
4
  /**
7
- * A labelled readout and a meter, built from the palette in style.css. Copy the
8
- * pattern for hull, ammo, timers — whatever this game needs.
5
+ * The HUD. Plain Tailwind, plain SVG, plain DOM — and the same file on every target.
6
+ *
7
+ * There is no second renderer to keep in step: on web this mounts beside the canvas, and on a
8
+ * phone or a desktop the same bundle renders in the platform's own web view over the game surface.
9
+ * Style it however you like; nothing here is a vocabulary the framework has to understand.
10
+ *
11
+ * `useUiState` reads the game's *published* state, which moves at about 10 Hz rather than at the
12
+ * frame rate, and is undefined until the game publishes its first snapshot.
9
13
  */
10
- function Meter({ label, value }: { label: string; value: number }) {
11
- return (
12
- <div className="mt-3 w-24">
13
- <div className="flex justify-between gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
14
- <span>{label}</span>
15
- <b className="font-normal tabular-nums text-text">{Math.round(value)}</b>
16
- </div>
17
- <div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
18
- <i
19
- className="absolute inset-y-0 left-0 bg-lume"
20
- style={{ width: `${Math.max(0, Math.min(100, value))}%` }}
21
- />
22
- </div>
23
- </div>
24
- );
25
- }
14
+ export function Hud() {
15
+ const state = useUiState<GameState>();
16
+ // Nothing to draw until the game publishes its first snapshot, a few milliseconds in. Rendering
17
+ // zeroes instead would put a wrong score on screen and then correct it.
18
+ if (state === undefined) return null;
19
+ const position = Math.max(0, Math.min(100, Math.abs(state.playerX) * 10));
20
+ const won = state.status === "won";
26
21
 
27
- export function Hud({ game }: { game: IGame<GameState, IPhysicsContext> }) {
28
- const score = useGameState(game, (state) => state.score);
29
- const playerX = useGameState(game, (state) => state.playerX);
30
22
  return (
31
- <div className="pointer-events-none absolute left-6 top-6 w-32">
32
- <div className="text-[10px] uppercase tracking-[0.14em] text-dim">score</div>
33
- <div className="text-4xl leading-none tabular-nums text-lume">{score}</div>
34
- <Meter label="position" value={Math.abs(playerX) * 10} />
35
- </div>
23
+ <>
24
+ <div className="pointer-events-none absolute left-6 top-6 w-32">
25
+ <div className="text-[10px] uppercase tracking-[0.14em] text-dim">score</div>
26
+ <div className="text-4xl leading-none tabular-nums text-lume">{state.score}</div>
27
+ <div className="mt-3 flex items-center gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
28
+ lives
29
+ {[0, 1, 2].map((slot) => (
30
+ <i
31
+ className={`h-2 w-2 border border-line ${slot < state.lives ? "bg-lume" : "bg-panel"}`}
32
+ key={slot}
33
+ />
34
+ ))}
35
+ </div>
36
+ <div className="mt-3 w-24">
37
+ <div className="flex justify-between gap-2 text-[10px] uppercase tracking-[0.14em] text-dim">
38
+ <span>position</span>
39
+ <b className="font-normal tabular-nums text-text">{Math.round(position)}</b>
40
+ </div>
41
+ <div className="relative mt-1 h-1 overflow-hidden border border-line bg-panel">
42
+ <i className="absolute inset-y-0 left-0 bg-lume" style={{ width: `${position}%` }} />
43
+ </div>
44
+ </div>
45
+ </div>
46
+ {state.status === "playing" ? null : (
47
+ <div className="pointer-events-none absolute inset-x-0 top-1/3 flex flex-col items-center gap-2">
48
+ <output
49
+ className={`text-5xl uppercase tracking-[0.2em] ${won ? "text-lume" : "text-text"}`}
50
+ >
51
+ {won ? "flag reached" : "out of lives"}
52
+ </output>
53
+ <div className="text-[11px] uppercase tracking-[0.14em] text-dim">
54
+ press r to run it again
55
+ </div>
56
+ </div>
57
+ )}
58
+ </>
36
59
  );
37
60
  }
@@ -1,39 +1,41 @@
1
- import type { IGame } from "@threenative/core";
2
- import type { IPhysicsContext } from "@threenative/physics";
3
- import { type KeyboardEvent, useState } from "react";
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
4
2
  import type { GameState } from "../state.js";
5
3
 
6
- export function Menu({ game }: { game: IGame<GameState, IPhysicsContext> }) {
7
- const [paused, setPaused] = useState(false);
8
- const togglePause = () => {
9
- if (paused) game.resume();
10
- else game.pause();
11
- setPaused((value) => !value);
12
- };
13
- const restart = () => {
14
- void game.goto("play");
15
- };
16
- const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {
17
- if (event.key !== "Enter" && event.key !== " ") return;
18
- event.preventDefault();
19
- togglePause();
20
- };
4
+ /**
5
+ * The menu, and the one thing a UI has to do differently from a plain web app: say which of its
6
+ * elements the player can touch.
7
+ *
8
+ * `data-tn-interactive` is that mark. The native input host publishes those rectangles and decides,
9
+ * on pointer-down, whether a touch belongs to the UI or to the game underneath. Everything without
10
+ * the mark is scenery, and a touch on it reaches the game — which is what lets a HUD cover the
11
+ * screen without swallowing the controls.
12
+ *
13
+ * `pointer-events` is still worth setting for the web target's own hit-testing; it is not what
14
+ * makes a touch fall through on a phone, and marking a button with it instead is the one mistake
15
+ * this comment exists to prevent.
16
+ */
17
+ export function Menu() {
18
+ const send = useUiIntent();
19
+ const state = useUiState<GameState>();
20
+ if (state === undefined) return null;
21
+ const paused = state.paused;
21
22
 
22
23
  return (
23
24
  <div className="pointer-events-none absolute bottom-6 left-6 flex items-center gap-3 border border-line bg-panel/75 px-4 py-3 text-[11px] uppercase tracking-[0.14em] text-dim">
24
- <span>WASD / arrows to move · collect the pickup</span>
25
+ <span>WASD / arrows to move · space to jump the gap · reach the flag</span>
25
26
  <button
26
- className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
27
27
  aria-pressed={paused}
28
- onClick={togglePause}
29
- onKeyDown={handleKeyDown}
28
+ className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
29
+ data-tn-interactive
30
+ onClick={() => send(paused ? "resume" : "pause")}
30
31
  type="button"
31
32
  >
32
33
  {paused ? "resume" : "pause"}
33
34
  </button>
34
35
  <button
35
36
  className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-lume"
36
- onClick={restart}
37
+ data-tn-interactive
38
+ onClick={() => send("restart")}
37
39
  type="button"
38
40
  >
39
41
  restart
@@ -0,0 +1,14 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+
5
+ /**
6
+ * The UI entry the native web view loads.
7
+ *
8
+ * It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
9
+ * it in the native runtime and reaches it only through published state and intents, which is why
10
+ * this file imports no game code at all.
11
+ */
12
+ const root = document.getElementById("tn-ui");
13
+ if (root === null) throw new Error("Missing #tn-ui element.");
14
+ createRoot(root).render(<GameUi />);
@@ -1,17 +1,19 @@
1
1
  import type { IThreeNativeConfig } from "@threenative/core";
2
2
 
3
- export default {
3
+ const config: IThreeNativeConfig = {
4
4
  app: {
5
5
  id: "com.threenative.__PROJECT_ID__",
6
6
  name: "__PROJECT_NAME__",
7
7
  version: "1.0.0",
8
8
  build: 1,
9
9
  icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
10
11
  },
11
12
  display: {
12
13
  orientation: "landscape", // Mobile viewport orientation.
13
14
  fullscreen: true, // Keep the game surface edge to edge.
14
15
  keepScreenOn: true, // Do not dim during a play session.
16
+ maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
15
17
  },
16
18
  window: {
17
19
  title: "__PROJECT_NAME__", // Desktop window title.
@@ -19,13 +21,29 @@ export default {
19
21
  height: 720,
20
22
  resizable: true,
21
23
  },
22
- loading: {
23
- backdropColor: "#0d1b2a",
24
- trackColor: "#274060",
25
- progressColor: "#8fd694",
26
- showProgressBar: true,
27
- // image: "public/logo.png", // drawn centred above the bar
24
+ bootSplash: {
25
+ backgroundColor: "#0d1b2a",
28
26
  },
29
27
  nativeEntry: "src/game.ts",
30
- renderer: { preferWebGPU: true }, // Use WebGPU when the host exposes it.
31
- } satisfies IThreeNativeConfig;
28
+ renderer: {
29
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
30
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
31
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
32
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
33
+ resolutionScale: "auto",
34
+ },
35
+ assets: {
36
+ // Mobile has no WebAssembly, so neither Basis-decoded textures nor Meshopt-decoded geometry
37
+ // can ship there — and these demo assets are tiny enough that compression only ever grew
38
+ // them. Ship exactly what is committed.
39
+ models: "none",
40
+ textures: "none",
41
+ },
42
+ // One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
43
+ // so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
44
+ // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
45
+ // extra process — and own the appearance difference that comes with it.
46
+ ui: { renderer: "web" },
47
+ };
48
+
49
+ export default config;