create-threenative 0.2.1 → 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,82 +1,289 @@
1
1
  import {
2
2
  type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
3
5
  Mesh,
4
6
  MeshBasicMaterial,
5
7
  type OrthographicCamera,
6
8
  PlaneGeometry,
7
9
  type Scene,
10
+ type Texture,
8
11
  } from "three";
9
12
  import { palette } from "./palette.js";
10
13
 
11
- /**
12
- * What the framework hands a loading screen. Structural on purpose: nothing under `src/render/`
13
- * imports the framework, and `ctx` already satisfies this shape.
14
- */
15
- export interface LoadingHost {
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** The five authoring points for this screen stay in this generated file. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: {
26
+ anchorX: 0.5,
27
+ anchorY: 0.72,
28
+ height: 12,
29
+ maxWidth: 1200,
30
+ minWidth: 2,
31
+ width: 0.62,
32
+ },
33
+ } as const;
34
+ /* END THREENATIVE LOADING APPEARANCE */
35
+
36
+ interface ILoadingHost {
37
+ readonly assets?: { texture(path: string): Promise<Texture> };
16
38
  readonly camera: Camera;
17
- readonly scene: Scene;
18
39
  readonly canvasLayer: {
19
40
  readonly camera: OrthographicCamera;
20
41
  readonly scene: Scene;
21
42
  opaque: boolean;
22
43
  };
23
44
  readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
45
+ readonly scene: Scene;
24
46
  readonly startup: { readonly progress: number; whenReady(): Promise<void> };
47
+ readonly viewport?: {
48
+ readonly safeArea: { height: number; width: number; x: number; y: number };
49
+ };
25
50
  }
26
51
 
27
- /**
28
- * Draws the loading screen in the framework's pixel-sized canvas layer. Colours, layout, and the
29
- * shape of the bar live here in generated source, so they remain the game's to change or delete.
30
- */
31
- export function createLoadingScreen(host: LoadingHost) {
32
- const layer = host.canvasLayer;
33
- const camera = layer.camera;
34
- const cover = (color: number, renderOrder: number) => {
35
- const mesh = new Mesh(
36
- new PlaneGeometry(1, 1),
37
- new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
38
- );
39
- mesh.frustumCulled = false;
40
- mesh.renderOrder = renderOrder;
41
- layer.scene.add(mesh);
42
- return mesh;
52
+ interface ILoadingController {
53
+ update(): void;
54
+ finish(): void;
55
+ }
56
+
57
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
58
+ layer.opaque = false;
59
+ return { finish: () => undefined, update: () => undefined };
60
+ }
61
+
62
+ function meshFor(
63
+ layer: ILoadingHost["canvasLayer"],
64
+ material: MeshBasicMaterial,
65
+ renderOrder: number,
66
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
67
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
68
+ mesh.frustumCulled = false;
69
+ mesh.renderOrder = renderOrder;
70
+ layer.scene.add(mesh);
71
+ return mesh;
72
+ }
73
+
74
+ function imageAspect(texture: Texture | null | undefined): number {
75
+ const image = texture?.image as { height?: number; width?: number } | undefined;
76
+ const width = image?.width ?? 1;
77
+ const height = image?.height ?? 1;
78
+ return width > 0 && height > 0 ? width / height : 1;
79
+ }
80
+
81
+ function configureTexture(texture: Texture): void {
82
+ texture.wrapS = ClampToEdgeWrapping;
83
+ texture.wrapT = ClampToEdgeWrapping;
84
+ texture.needsUpdate = true;
85
+ }
86
+
87
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
88
+ const uv = geometry.getAttribute("uv");
89
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
90
+ uv.needsUpdate = true;
91
+ }
92
+
93
+ function coverUv(
94
+ geometry: PlaneGeometry,
95
+ texture: Texture,
96
+ width: number,
97
+ height: number,
98
+ baseU: readonly number[],
99
+ baseV: readonly number[],
100
+ ): void {
101
+ const imageRatio = imageAspect(texture);
102
+ const boxRatio = width / Math.max(1, height);
103
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
104
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
105
+ const offsetU = (1 - visibleU) / 2;
106
+ const offsetV = (1 - visibleV) / 2;
107
+ const uv = geometry.getAttribute("uv");
108
+ for (let index = 0; index < uv.count; index += 1) {
109
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
110
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
111
+ }
112
+ uv.needsUpdate = true;
113
+ }
114
+
115
+ function statusMesh(
116
+ layer: ILoadingHost["canvasLayer"],
117
+ ):
118
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
119
+ | undefined {
120
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
121
+ const canvas = document.createElement("canvas");
122
+ canvas.width = 180;
123
+ canvas.height = 48;
124
+ const context = canvas.getContext("2d");
125
+ if (context === null) return undefined;
126
+ const texture = new CanvasTexture(canvas);
127
+ const mesh = meshFor(
128
+ layer,
129
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
130
+ 4,
131
+ );
132
+ const update = (value: number): void => {
133
+ context.clearRect(0, 0, canvas.width, canvas.height);
134
+ context.fillStyle = "#ffffff";
135
+ context.font = "700 20px monospace";
136
+ context.textAlign = "center";
137
+ context.textBaseline = "middle";
138
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
139
+ texture.needsUpdate = true;
43
140
  };
44
- const backdrop = cover(palette.skyLow, 0);
45
- const track = cover(palette.skyHigh, 1);
46
- const fill = cover(palette.accent, 2);
47
- const parts = [backdrop, track, fill];
48
- layer.opaque = true;
141
+ update(0);
142
+ return { mesh, texture, update };
143
+ }
49
144
 
50
- let width = 0;
51
- let height = 0;
52
- let lastProgress = 0;
145
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
146
+ const layer = host.canvasLayer;
147
+ if (!loading.enabled) return noOp(layer);
148
+ const camera = layer.camera;
149
+ const backdrop = meshFor(
150
+ layer,
151
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
152
+ 0,
153
+ );
154
+ const track = meshFor(
155
+ layer,
156
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
157
+ 1,
158
+ );
159
+ const fill = meshFor(
160
+ layer,
161
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
162
+ 2,
163
+ );
164
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
165
+ fill.geometry.getAttribute("uv").getX(index),
166
+ );
167
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
168
+ fill.geometry.getAttribute("uv").getY(index),
169
+ );
170
+ const logo =
171
+ loading.logoImage === undefined
172
+ ? undefined
173
+ : meshFor(
174
+ layer,
175
+ new MeshBasicMaterial({
176
+ color: 0xffffff,
177
+ depthTest: false,
178
+ depthWrite: false,
179
+ transparent: true,
180
+ }),
181
+ 3,
182
+ );
183
+ const status = statusMesh(layer);
184
+ const parts = [
185
+ backdrop,
186
+ track,
187
+ fill,
188
+ ...(logo === undefined ? [] : [logo]),
189
+ ...(status === undefined ? [] : [status.mesh]),
190
+ ];
191
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
192
+ let width = 1;
193
+ let height = 1;
194
+ let barWidth = 1;
195
+ let barHeight: number = loading.bar.height;
196
+ let barX = 0;
197
+ let barY = 0;
198
+ let progress = 0;
199
+ let done = false;
200
+ let backdropTexture: Texture | undefined;
53
201
 
54
202
  const layout = (): void => {
55
- const nextWidth = camera.right - camera.left;
56
- const nextHeight = camera.top - camera.bottom;
57
- width = Number.isFinite(nextWidth) && nextWidth > 0 ? nextWidth : 1;
58
- height = Number.isFinite(nextHeight) && nextHeight > 0 ? nextHeight : 1;
203
+ width = Math.max(1, camera.right - camera.left);
204
+ height = Math.max(1, camera.top - camera.bottom);
205
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
206
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
207
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
208
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
209
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
210
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
211
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
212
+ barX = safeX + safeWidth * loading.bar.anchorX;
213
+ barY = safeY + safeHeight * loading.bar.anchorY;
214
+ const worldX = (screenX: number): number => camera.left + screenX;
215
+ const worldY = (screenY: number): number => camera.top - screenY;
216
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
59
217
  backdrop.scale.set(width, height, 1);
60
- track.scale.set(width * 0.5, height * 0.012, 1);
61
- track.position.set(0, -height * 0.05, 0);
62
- fill.position.set(0, -height * 0.05, 0);
218
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
219
+ track.scale.set(barWidth, barHeight, 1);
220
+ track.position.set(worldX(barX), worldY(barY), 0);
221
+ fill.scale.set(visibleWidth, barHeight, 1);
222
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
223
+ if (logo?.visible) {
224
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
225
+ logo.scale.set(
226
+ logoWidth,
227
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
228
+ 1,
229
+ );
230
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
231
+ }
232
+ if (status !== undefined) {
233
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
234
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
235
+ }
236
+ if (backdropTexture !== undefined)
237
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
238
+ };
239
+
240
+ const updateProgress = (value: number): void => {
241
+ progress = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
242
+ setFillUv(fill.geometry, progress, fillBaseU);
243
+ status?.update(progress);
244
+ layout();
245
+ };
246
+
247
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
248
+ if (done) return;
249
+ configureTexture(texture);
250
+ mesh.material.map = texture;
251
+ mesh.material.color.set(0xffffff);
252
+ mesh.material.needsUpdate = true;
253
+ ownedTextures.add(texture);
254
+ if (mesh === backdrop) backdropTexture = texture;
255
+ layout();
256
+ updateProgress(progress);
63
257
  };
64
258
 
65
- const setProgress = (progress: number): void => {
66
- // `Math.max(0, Math.min(1, NaN))` is NaN, so non-finite progress means no progress.
67
- lastProgress = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : 0;
68
- const full = width * 0.5;
69
- const barWidth = Math.max(full * 0.002, full * lastProgress);
70
- fill.scale.set(barWidth, height * 0.012, 1);
71
- fill.position.x = -full / 2 + barWidth / 2;
259
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
260
+ if (source === undefined || host.assets === undefined) return;
261
+ void host.assets
262
+ .texture(source)
263
+ .then((texture) => attachTexture(mesh, texture))
264
+ .catch(() => undefined);
72
265
  };
266
+ load(loading.backgroundImage, backdrop);
267
+ load(loading.fillImage, fill);
268
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
269
+ void host.assets
270
+ .texture(loading.logoImage)
271
+ .then((texture) => {
272
+ if (done) return;
273
+ configureTexture(texture);
274
+ logo.material.map = texture;
275
+ logo.material.needsUpdate = true;
276
+ logo.visible = true;
277
+ ownedTextures.add(texture);
278
+ layout();
279
+ })
280
+ .catch(() => undefined);
281
+ }
73
282
 
74
- let laidOutWidth = camera.right - camera.left;
75
- let laidOutHeight = camera.top - camera.bottom;
283
+ layer.opaque = true;
76
284
  layout();
77
- setProgress(0);
285
+ updateProgress(0);
78
286
 
79
- let done = false;
80
287
  const finish = (): void => {
81
288
  if (done) return;
82
289
  done = true;
@@ -85,29 +292,31 @@ export function createLoadingScreen(host: LoadingHost) {
85
292
  mesh.geometry.dispose();
86
293
  mesh.material.dispose();
87
294
  }
295
+ for (const texture of ownedTextures) texture.dispose();
88
296
  layer.opaque = false;
89
297
  };
90
298
 
91
299
  void (async () => {
92
300
  await host.startup.whenReady();
93
- // Compile the collapsed world's pipelines while the opaque canvas layer still covers it.
94
- await host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
301
+ if (done) return;
302
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
303
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
304
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
305
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
306
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
307
+ // decides when the player sees the world.
308
+ try {
309
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
310
+ } catch {
311
+ // A renderer without compileAsync is not a reason to keep the world hidden.
312
+ }
95
313
  finish();
96
314
  })();
97
315
 
98
316
  return {
317
+ finish,
99
318
  update(): void {
100
- if (done) return;
101
- const nextWidth = camera.right - camera.left;
102
- const nextHeight = camera.top - camera.bottom;
103
- if (nextWidth !== laidOutWidth || nextHeight !== laidOutHeight) {
104
- laidOutWidth = nextWidth;
105
- laidOutHeight = nextHeight;
106
- layout();
107
- setProgress(lastProgress);
108
- }
109
- setProgress(host.startup.progress);
319
+ if (!done) updateProgress(host.startup.progress);
110
320
  },
111
- finish,
112
321
  };
113
322
  }
@@ -1,18 +1,71 @@
1
- import { ACESFilmicToneMapping, type Camera, type Scene } from "three";
2
- import { bloom } from "three/addons/tsl/display/BloomNode.js";
3
- import { pass } from "three/tsl";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // `WorldEnvironment`, in this folder, builds the lighting chain: which stages run, in what
5
+ // order, and an honest report of what happened. It prints `TN_WORLD_ENVIRONMENT` naming every
6
+ // stage as applied or refused **with a reason**, so a stage that silently no-op'd is never
7
+ // mistaken for one you turned off. It decides no colour and no strength — every value below is
8
+ // an argument, and they are yours.
9
+ //
10
+ // SSGI and SSR are the expensive pair, so they ship on for desktop and off for mobile. That
11
+ // split is the shipped default, not a ceiling: turn either on for mobile by adding it to
12
+ // `mobilePreset` and read the frame cost back out of `TN_FRAME_BUDGET`. What each stage costs,
13
+ // and the one-line enable for the ones that ship off everywhere (godrays, contact AO,
14
+ // vignette), is in `agent-docs/visual-baseline.md`.
15
+ import type { Camera, DirectionalLight, Scene } from "three";
16
+ import type { OutputRenderer } from "./worldEnvironment.js";
17
+ import { WorldEnvironment } from "./worldEnvironment.js";
4
18
 
5
- type OutputRenderer = {
6
- kind: string;
7
- raw: unknown;
8
- setOutputNode(node: unknown): void;
9
- };
19
+ // Scene-referred exposure: multiplied into the pass before the tone curve, so the gather, the
20
+ // reflections and the bloom threshold all see the same exposed image.
21
+ const exposure = 1.15;
10
22
 
11
- export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
12
- const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
13
- raw.toneMapping = ACESFilmicToneMapping;
14
- raw.toneMappingExposure = 1.15;
15
- if (renderer.kind !== "webgpu") return;
16
- const colour = pass(scene, camera).getTextureNode();
17
- renderer.setOutputNode(colour.add(bloom(colour, 0.45, 0.5, 0.2)));
23
+ // Unchanged from this template's previous chain — strength, radius and threshold are a look
24
+ // decision that was already tuned to this scene's palette.
25
+ const glow = {
26
+ bloomEnabled: true,
27
+ bloomRadius: 0.5,
28
+ bloomStrength: 0.45,
29
+ bloomThreshold: 0.2,
30
+ } as const;
31
+
32
+ const desktopPreset = {
33
+ ...glow,
34
+ denoiseEnabled: true,
35
+ exposure,
36
+ ssgiEnabled: true,
37
+ // Room scale, not contact scale: about two thirds of the 24-unit shadow extent
38
+ // `lighting.ts` lights — a bright outdoor route where GI mostly softens the shadow side of the blocks.
39
+ ssgiRadius: 16,
40
+ ssgiQuality: "medium",
41
+ ssrEnabled: true,
42
+ // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as
43
+ // "reflections are on and do nothing" — the ray dies a metre from where it started.
44
+ ssrMaxDistance: 40,
45
+ // A reflection carries almost no high-frequency detail, so half resolution costs a quarter
46
+ // of the rays and is very hard to see in the result.
47
+ ssrResolutionScale: 0.5,
48
+ // RCAS puts back the micro-detail the half-resolution reflection and the denoiser take out.
49
+ // The same cause everywhere, so the same value everywhere: **0 is maximum sharpening and 2
50
+ // is none** — it is a radius, not a gain.
51
+ sharpenEnabled: true,
52
+ sharpenStrength: 0.3,
53
+ tonemapMode: "aces",
54
+ } as const;
55
+
56
+ // No SSGI, no SSR, and therefore nothing for the sharpener to put back.
57
+ const mobilePreset = {
58
+ ...glow,
59
+ exposure,
60
+ tonemapMode: "aces",
61
+ } as const;
62
+
63
+ export function setupPost(
64
+ renderer: OutputRenderer,
65
+ scene: Scene,
66
+ camera: Camera,
67
+ environment: { godraysLight?: DirectionalLight; mobile?: boolean } = {},
68
+ ): void {
69
+ const world = new WorldEnvironment(environment.mobile === true ? mobilePreset : desktopPreset);
70
+ world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
18
71
  }
@@ -16,7 +16,6 @@ import {
16
16
  type ITouchPointer,
17
17
  type ITouchViewport,
18
18
  MOVE_RADIUS,
19
- stickDeflection,
20
19
  touchControlPoint,
21
20
  } from "./touch-layout.js";
22
21
 
@@ -43,12 +42,23 @@ function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
43
42
 
44
43
  export class TouchControls {
45
44
  readonly root = new Group();
45
+ readonly object = this.root;
46
46
  #camera: PerspectiveCamera;
47
- #input: ITouchInput = { dashPressed: false, jumpPressed: false, move: new Vector2() };
47
+ #input: { dashPressed: boolean; jumpPressed: boolean; move: Vector2 } = {
48
+ dashPressed: false,
49
+ jumpPressed: false,
50
+ move: new Vector2(),
51
+ };
48
52
  #wasDash = false;
49
53
  #wasJump = false;
50
54
  /** Where the current thumb landed. Undefined between touches. */
51
- #moveAnchor: Vector2 | undefined;
55
+ #moveAnchor = new Vector2();
56
+ #hasMoveAnchor = false;
57
+ #jumpCenter = new Vector2();
58
+ #dashCenter = new Vector2();
59
+ #resting = new Vector2();
60
+ #lastWidth = -1;
61
+ #lastHeight = -1;
52
62
  #moveBase: Mesh;
53
63
  #moveKnob: Mesh;
54
64
  #dash: Mesh;
@@ -70,34 +80,39 @@ export class TouchControls {
70
80
  }
71
81
 
72
82
  update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
73
- const jumpCenter = touchControlPoint(size, "jump");
74
- const dashCenter = touchControlPoint(size, "dash");
75
- const jump = this.#at(pointers, jumpCenter, BUTTON_RADIUS);
76
- const dash = this.#at(pointers, dashCenter, BUTTON_RADIUS);
77
- const left = [...pointers.values()].find((pointer) =>
78
- this.#isMovementPointer(pointer, size, dashCenter, jumpCenter),
79
- );
80
- const resting = touchControlPoint(size, "move");
83
+ this.#ensureLayout(size);
84
+ const jump = this.#at(pointers, this.#jumpCenter, BUTTON_RADIUS);
85
+ const dash = this.#at(pointers, this.#dashCenter, BUTTON_RADIUS);
86
+ let left: ITouchPointer | undefined;
87
+ for (const pointer of pointers.values()) {
88
+ if (this.#isMovementPointer(pointer, size)) {
89
+ left = pointer;
90
+ break;
91
+ }
92
+ }
81
93
  const move = this.#input.move;
82
94
  if (left === undefined) {
83
95
  // Thumb lifted: forget where it was, so the next touch anchors fresh.
84
- this.#moveAnchor = undefined;
96
+ this.#hasMoveAnchor = false;
85
97
  move.set(0, 0);
86
98
  } else {
87
- this.#moveAnchor ??= left.position.clone();
88
- move.copy(stickDeflection(this.#moveAnchor, left.position, MOVE_RADIUS));
99
+ if (!this.#hasMoveAnchor) {
100
+ this.#moveAnchor.copy(left.position);
101
+ this.#hasMoveAnchor = true;
102
+ }
103
+ move.set(
104
+ MathUtils.clamp((left.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
105
+ MathUtils.clamp((this.#moveAnchor.y - left.position.y) / MOVE_RADIUS, -1, 1),
106
+ );
89
107
  }
90
108
  // The ring follows the thumb to its anchor, so the player can see where the stick went
91
109
  // instead of watching a knob move against a circle their thumb is nowhere near.
92
- const center = this.#moveAnchor ?? resting;
110
+ const center = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
93
111
  place(this.#moveKnob, center.x + move.x * MOVE_RADIUS, center.y - move.y * MOVE_RADIUS);
94
112
  this.#jump.material = jump ? this.#activeMaterial : this.#idleMaterial;
95
113
  this.#dash.material = dash ? this.#activeMaterial : this.#idleMaterial;
96
- this.#input = {
97
- dashPressed: dash && !this.#wasDash,
98
- jumpPressed: jump && !this.#wasJump,
99
- move,
100
- };
114
+ this.#input.dashPressed = dash && !this.#wasDash;
115
+ this.#input.jumpPressed = jump && !this.#wasJump;
101
116
  this.#wasDash = dash;
102
117
  this.#wasJump = jump;
103
118
  this.#layout(size);
@@ -117,6 +132,15 @@ export class TouchControls {
117
132
  this.#activeMaterial.dispose();
118
133
  }
119
134
 
135
+ #ensureLayout(size: ITouchViewport): void {
136
+ if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
137
+ this.#lastWidth = size.width;
138
+ this.#lastHeight = size.height;
139
+ this.#resting.copy(touchControlPoint(size, "move"));
140
+ this.#dashCenter.copy(touchControlPoint(size, "dash"));
141
+ this.#jumpCenter.copy(touchControlPoint(size, "jump"));
142
+ }
143
+
120
144
  #layout(size: ITouchViewport): void {
121
145
  const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
122
146
  const pixels = worldHeight / Math.max(1, size.height);
@@ -124,34 +148,28 @@ export class TouchControls {
124
148
  this.root.position.set(-worldWidth / 2, worldHeight / 2, -1);
125
149
  this.root.scale.set(pixels, -pixels, 1);
126
150
  // The anchor wins while a thumb is down; this only re-homes the ring once it lifts.
127
- const move = this.#moveAnchor ?? touchControlPoint(size, "move");
128
- const dash = touchControlPoint(size, "dash");
129
- const jump = touchControlPoint(size, "jump");
151
+ const move = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
130
152
  place(this.#moveBase, move.x, move.y);
131
- place(this.#dash, dash.x, dash.y);
132
- place(this.#jump, jump.x, jump.y);
153
+ place(this.#dash, this.#dashCenter.x, this.#dashCenter.y);
154
+ place(this.#jump, this.#jumpCenter.x, this.#jumpCenter.y);
133
155
  }
134
156
 
135
- #isMovementPointer(
136
- pointer: ITouchPointer,
137
- size: ITouchViewport,
138
- dashCenter: Vector2,
139
- jumpCenter: Vector2,
140
- ): boolean {
157
+ #isMovementPointer(pointer: ITouchPointer, size: ITouchViewport): boolean {
141
158
  if (pointer.position.x >= size.width * 0.5 || pointer.position.y <= size.height * 0.5)
142
159
  return false;
143
160
  if (size.height <= size.width) return true;
144
161
  const radiusSquared = BUTTON_RADIUS * BUTTON_RADIUS;
145
162
  return (
146
- pointer.position.distanceToSquared(dashCenter) > radiusSquared &&
147
- pointer.position.distanceToSquared(jumpCenter) > radiusSquared
163
+ pointer.position.distanceToSquared(this.#dashCenter) > radiusSquared &&
164
+ pointer.position.distanceToSquared(this.#jumpCenter) > radiusSquared
148
165
  );
149
166
  }
150
167
 
151
168
  #at(pointers: ReadonlyMap<number, ITouchPointer>, center: Vector2, radius: number): boolean {
152
169
  const radiusSquared = radius * radius;
153
- return [...pointers.values()].some(
154
- (pointer) => pointer.position.distanceToSquared(center) <= radiusSquared,
155
- );
170
+ for (const pointer of pointers.values()) {
171
+ if (pointer.position.distanceToSquared(center) <= radiusSquared) return true;
172
+ }
173
+ return false;
156
174
  }
157
175
  }