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
@@ -12,9 +12,9 @@
12
12
  "assert": {
13
13
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
14
14
  "resources": [
15
- { "id": "GameState", "path": "scanWindowFrames", "equals": 300, "changed": true },
16
- { "id": "GameState", "path": "scanWindowValid", "equals": true, "changed": true },
17
- { "id": "GameState", "path": "scanWindowScans", "gte": 10, "changed": true }
15
+ { "id": "state", "path": "scanWindowFrames", "equals": 300, "changed": true },
16
+ { "id": "state", "path": "scanWindowValid", "equals": true, "changed": true },
17
+ { "id": "state", "path": "scanWindowScans", "gte": 10, "changed": true }
18
18
  ]
19
19
  }
20
20
  }
@@ -15,12 +15,17 @@
15
15
  "assert": {
16
16
  "diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
17
17
  "resources": [
18
- { "id": "GameState", "path": "status", "equals": "WON", "changed": true },
19
- { "id": "GameState", "path": "wave", "equals": 10, "changed": true },
20
- { "id": "GameState", "path": "leaks", "equals": 0, "allowTrivial": true },
21
- { "id": "GameState", "path": "defeated", "gte": 10, "changed": true },
22
- { "id": "GameState", "path": "spent", "equals": 120, "changed": true },
23
- { "id": "GameState", "path": "shots", "gte": 1, "changed": true }
18
+ { "id": "state", "path": "status", "equals": "WON", "changed": true },
19
+ { "id": "state", "path": "wave", "equals": 10, "changed": true },
20
+ {
21
+ "id": "state",
22
+ "path": "leaks",
23
+ "equals": 0,
24
+ "allowTrivial": "The survival route reaches the win state without leaks; zero leaks is the intended held invariant while the other rows prove progression."
25
+ },
26
+ { "id": "state", "path": "defeated", "gte": 10, "changed": true },
27
+ { "id": "state", "path": "spent", "equals": 120, "changed": true },
28
+ { "id": "state", "path": "shots", "gte": 1, "changed": true }
24
29
  ]
25
30
  }
26
31
  }
@@ -1,4 +1,4 @@
1
- import { PathFollow3D } from "@threenative/core";
1
+ import { type IPathFollow3DSample, PathFollow3D } from "@threenative/core";
2
2
  import { CollisionShape3D } from "@threenative/physics";
3
3
  import { type Group, Vector3 } from "three";
4
4
  import { ATTACKER_LAYER, type DefensePhysics, createEntityBody } from "../physics.js";
@@ -9,12 +9,19 @@ export const ATTACKER_SPEED = 7;
9
9
  export const ATTACKER_HEALTH = 4;
10
10
 
11
11
  export class Attacker {
12
- readonly id: string;
13
- readonly lateralOffset: number;
12
+ readonly entityId: string;
13
+ id: string;
14
+ lateralOffset: number;
14
15
  readonly mesh: Group;
15
16
  readonly tags = ["attacker", "hostile"];
16
17
  readonly #body;
17
18
  readonly #path: PathFollow3D;
19
+ readonly #sample: IPathFollow3DSample = {
20
+ point: new Vector3(),
21
+ progress: 0,
22
+ tangent: new Vector3(0, 0, 1),
23
+ };
24
+ readonly #side = new Vector3();
18
25
  #health = ATTACKER_HEALTH;
19
26
  #dead = false;
20
27
  #escaped = false;
@@ -29,22 +36,23 @@ export class Attacker {
29
36
  readonly onDefeated: () => void;
30
37
  readonly onLeak: () => void;
31
38
  }) {
39
+ this.entityId = options.id;
32
40
  this.id = options.id;
33
41
  this.lateralOffset = options.lateralOffset;
34
42
  this.#onDefeated = options.onDefeated;
35
43
  this.#onLeak = options.onLeak;
36
44
  this.#path = new PathFollow3D({ points: options.pathPoints, speed: ATTACKER_SPEED });
37
45
  this.mesh = attackerMesh();
38
- this.#place(this.lateralOffset);
39
46
  this.#body = createEntityBody({
40
47
  collisionLayer: ATTACKER_LAYER,
41
48
  collisionMask: 0,
42
- entity: this.id,
49
+ entity: this.entityId,
43
50
  object: this.mesh,
44
51
  physics: options.physics,
45
52
  shape: CollisionShape3D.sphere(0.42),
46
53
  type: "kinematic",
47
54
  });
55
+ this.reset(options.id, options.lateralOffset);
48
56
  }
49
57
 
50
58
  get dead(): boolean {
@@ -55,6 +63,18 @@ export class Attacker {
55
63
  return this.#escaped;
56
64
  }
57
65
 
66
+ reset(id: string, lateralOffset: number): void {
67
+ this.id = id;
68
+ this.lateralOffset = lateralOffset;
69
+ this.#health = ATTACKER_HEALTH;
70
+ this.#dead = false;
71
+ this.#escaped = false;
72
+ this.#path.progressTo(0);
73
+ this.mesh.visible = true;
74
+ const sample = this.#path.sample(0, this.#sample);
75
+ this.#place(this.lateralOffset, sample.point, sample.tangent);
76
+ }
77
+
58
78
  takeDamage(amount: number): void {
59
79
  if (this.#dead || this.#escaped) return;
60
80
  if (!Number.isFinite(amount) || amount <= 0)
@@ -69,7 +89,7 @@ export class Attacker {
69
89
 
70
90
  update(dt: number): void {
71
91
  if (this.#dead || this.#escaped) return;
72
- const sample = this.#path.advance(dt);
92
+ const sample = this.#path.advance(dt, this.#sample);
73
93
  this.#place(this.lateralOffset, sample.point, sample.tangent);
74
94
  if (!this.#path.completed) return;
75
95
  this.#escaped = true;
@@ -92,12 +112,8 @@ export class Attacker {
92
112
  this.mesh.removeFromParent();
93
113
  }
94
114
 
95
- #place(
96
- lateralOffset: number,
97
- point = this.#path.sample().point,
98
- tangent = this.#path.sample().tangent,
99
- ): void {
100
- const side = new Vector3(-tangent.z, 0, tangent.x).normalize();
115
+ #place(lateralOffset: number, point: Vector3, tangent: Vector3): void {
116
+ const side = this.#side.set(-tangent.z, 0, tangent.x).normalize();
101
117
  this.mesh.position.copy(point).addScaledVector(side, lateralOffset).setY(0);
102
118
  this.mesh.rotation.y = Math.atan2(tangent.x, tangent.z);
103
119
  }
@@ -8,9 +8,8 @@ import { Boot } from "./scenes/Boot.js";
8
8
  import { Defense } from "./scenes/Defense.js";
9
9
  import type { GameState } from "./state.js";
10
10
 
11
- export default defineGame<GameState, DefensePhysics>({
11
+ const game = defineGame<GameState, DefensePhysics>({
12
12
  input: {
13
- build: { pointer: true },
14
13
  move: {
15
14
  down: ["ArrowDown", "KeyS"],
16
15
  left: ["ArrowLeft", "KeyA"],
@@ -23,8 +22,31 @@ export default defineGame<GameState, DefensePhysics>({
23
22
  safeBuild: { keys: ["KeyB"] },
24
23
  },
25
24
  plugins: [rapier({ gravity: { x: 0, y: -9.8, z: 0 } }), playtest({ events })],
25
+ display: config.display,
26
26
  render: config.renderer,
27
27
  scenes: { boot: Boot, defense: Defense },
28
28
  seed: 92092,
29
29
  start: "boot",
30
30
  });
31
+
32
+ export default game;
33
+
34
+ /**
35
+ * What the UI can ask the game to do.
36
+ *
37
+ * Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
38
+ * game decides what each means. Nothing comes back this way — the UI reads the game's published
39
+ * state instead, which keeps one source of truth on the side that owns the simulation.
40
+ */
41
+ game.ui.onIntent((intent) => {
42
+ if (intent === "restart") void game.goto("defense");
43
+ if (intent === "pause") game.pause();
44
+ if (intent === "resume") game.resume();
45
+ game.state.set({
46
+ // `game.ui.connected` is true only once the UI announced itself, which is what tells an
47
+ // overlay that never came up apart from a game whose HUD is simply empty.
48
+ uiReady: game.ui.connected,
49
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
50
+ });
51
+ game.state.flush();
52
+ });
@@ -9,7 +9,10 @@ import { palette } from "./palette.js";
9
9
 
10
10
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
11
 
12
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
12
+ // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
13
+ // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
14
+ // rendering a black pass.
15
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
13
16
  renderer.shadowMap.enabled = true;
14
17
  renderer.shadowMap.type = PCFSoftShadowMap;
15
18
  scene.add(new HemisphereLight(palette.skyLow, palette.shadow, 1.2));
@@ -29,4 +32,6 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
29
32
  rim.position.set(12, 8, -14);
30
33
  scene.add(rim);
31
34
  scene.add(new AmbientLight(palette.shadow, 0.25));
35
+
36
+ return key;
32
37
  }
@@ -1,14 +1,33 @@
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
- export interface ILoadingHost {
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** Defense look and composition; edit this generated source to change the screen. */
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: { anchorX: 0.5, anchorY: 0.76, height: 11, maxWidth: 520, minWidth: 1, width: 0.6 },
26
+ } as const;
27
+ /* END THREENATIVE LOADING APPEARANCE */
28
+
29
+ interface ILoadingHost {
30
+ readonly assets?: { texture(path: string): Promise<Texture> };
12
31
  readonly camera: Camera;
13
32
  readonly canvasLayer: {
14
33
  readonly camera: OrthographicCamera;
@@ -18,46 +37,246 @@ export interface ILoadingHost {
18
37
  readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
19
38
  readonly scene: Scene;
20
39
  readonly startup: { readonly progress: number; whenReady(): Promise<void> };
40
+ readonly viewport?: {
41
+ readonly safeArea: { height: number; width: number; x: number; y: number };
42
+ };
43
+ }
44
+
45
+ interface ILoadingController {
46
+ update(): void;
47
+ finish(): void;
48
+ }
49
+
50
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
51
+ layer.opaque = false;
52
+ return { finish: () => undefined, update: () => undefined };
21
53
  }
22
54
 
23
- export function createLoadingScreen(host: ILoadingHost) {
55
+ function meshFor(
56
+ layer: ILoadingHost["canvasLayer"],
57
+ material: MeshBasicMaterial,
58
+ renderOrder: number,
59
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
60
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
61
+ mesh.frustumCulled = false;
62
+ mesh.renderOrder = renderOrder;
63
+ layer.scene.add(mesh);
64
+ return mesh;
65
+ }
66
+
67
+ function imageAspect(texture: Texture | null | undefined): number {
68
+ const image = texture?.image as { height?: number; width?: number } | undefined;
69
+ const width = image?.width ?? 1;
70
+ const height = image?.height ?? 1;
71
+ return width > 0 && height > 0 ? width / height : 1;
72
+ }
73
+
74
+ function configureTexture(texture: Texture): void {
75
+ texture.wrapS = ClampToEdgeWrapping;
76
+ texture.wrapT = ClampToEdgeWrapping;
77
+ texture.needsUpdate = true;
78
+ }
79
+
80
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
81
+ const uv = geometry.getAttribute("uv");
82
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
83
+ uv.needsUpdate = true;
84
+ }
85
+
86
+ function coverUv(
87
+ geometry: PlaneGeometry,
88
+ texture: Texture,
89
+ width: number,
90
+ height: number,
91
+ baseU: readonly number[],
92
+ baseV: readonly number[],
93
+ ): void {
94
+ const imageRatio = imageAspect(texture);
95
+ const boxRatio = width / Math.max(1, height);
96
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
97
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
98
+ const offsetU = (1 - visibleU) / 2;
99
+ const offsetV = (1 - visibleV) / 2;
100
+ const uv = geometry.getAttribute("uv");
101
+ for (let index = 0; index < uv.count; index += 1) {
102
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
103
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
104
+ }
105
+ uv.needsUpdate = true;
106
+ }
107
+
108
+ function statusMesh(
109
+ layer: ILoadingHost["canvasLayer"],
110
+ ):
111
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
112
+ | undefined {
113
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
114
+ const canvas = document.createElement("canvas");
115
+ canvas.width = 180;
116
+ canvas.height = 48;
117
+ const context = canvas.getContext("2d");
118
+ if (context === null) return undefined;
119
+ const texture = new CanvasTexture(canvas);
120
+ const mesh = meshFor(
121
+ layer,
122
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
123
+ 4,
124
+ );
125
+ const update = (value: number): void => {
126
+ context.clearRect(0, 0, canvas.width, canvas.height);
127
+ context.fillStyle = "#ffffff";
128
+ context.font = "700 20px monospace";
129
+ context.textAlign = "center";
130
+ context.textBaseline = "middle";
131
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
132
+ texture.needsUpdate = true;
133
+ };
134
+ update(0);
135
+ return { mesh, texture, update };
136
+ }
137
+
138
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
24
139
  const layer = host.canvasLayer;
140
+ if (!loading.enabled) return noOp(layer);
25
141
  const camera = layer.camera;
26
- const cover = (color: number, order: number) => {
27
- const mesh = new Mesh(
28
- new PlaneGeometry(1, 1),
29
- new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
30
- );
31
- mesh.frustumCulled = false;
32
- mesh.renderOrder = order;
33
- layer.scene.add(mesh);
34
- return mesh;
35
- };
36
- const backdrop = cover(palette.skyHigh, 0);
37
- const track = cover(palette.route, 1);
38
- const fill = cover(palette.accent, 2);
39
- const parts = [backdrop, track, fill];
40
- layer.opaque = true;
142
+ const backdrop = meshFor(
143
+ layer,
144
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
145
+ 0,
146
+ );
147
+ const track = meshFor(
148
+ layer,
149
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
150
+ 1,
151
+ );
152
+ const fill = meshFor(
153
+ layer,
154
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
155
+ 2,
156
+ );
157
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
158
+ fill.geometry.getAttribute("uv").getX(index),
159
+ );
160
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
161
+ fill.geometry.getAttribute("uv").getY(index),
162
+ );
163
+ const logo =
164
+ loading.logoImage === undefined
165
+ ? undefined
166
+ : meshFor(
167
+ layer,
168
+ new MeshBasicMaterial({
169
+ color: 0xffffff,
170
+ depthTest: false,
171
+ depthWrite: false,
172
+ transparent: true,
173
+ }),
174
+ 3,
175
+ );
176
+ const status = statusMesh(layer);
177
+ const parts = [
178
+ backdrop,
179
+ track,
180
+ fill,
181
+ ...(logo === undefined ? [] : [logo]),
182
+ ...(status === undefined ? [] : [status.mesh]),
183
+ ];
184
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
41
185
  let width = 1;
42
186
  let height = 1;
43
- let lastProgress = 0;
187
+ let barWidth = 1;
188
+ let barHeight: number = loading.bar.height;
189
+ let barX = 0;
190
+ let barY = 0;
191
+ let progress = 0;
192
+ let done = false;
193
+ let backdropTexture: Texture | undefined;
194
+
44
195
  const layout = (): void => {
45
196
  width = Math.max(1, camera.right - camera.left);
46
197
  height = Math.max(1, camera.top - camera.bottom);
198
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
199
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
200
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
201
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
202
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
203
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
204
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
205
+ barX = safeX + safeWidth * loading.bar.anchorX;
206
+ barY = safeY + safeHeight * loading.bar.anchorY;
207
+ const worldX = (screenX: number): number => camera.left + screenX;
208
+ const worldY = (screenY: number): number => camera.top - screenY;
209
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
47
210
  backdrop.scale.set(width, height, 1);
48
- track.scale.set(width * 0.5, height * 0.012, 1);
49
- track.position.set(0, -height * 0.05, 0);
211
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
212
+ track.scale.set(barWidth, barHeight, 1);
213
+ track.position.set(worldX(barX), worldY(barY), 0);
214
+ fill.scale.set(visibleWidth, barHeight, 1);
215
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
216
+ if (logo?.visible) {
217
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
218
+ logo.scale.set(
219
+ logoWidth,
220
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
221
+ 1,
222
+ );
223
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
224
+ }
225
+ if (status !== undefined) {
226
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
227
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
228
+ }
229
+ if (backdropTexture !== undefined)
230
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
231
+ };
232
+
233
+ const updateProgress = (value: number): void => {
234
+ progress = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
235
+ setFillUv(fill.geometry, progress, fillBaseU);
236
+ status?.update(progress);
237
+ layout();
50
238
  };
51
- const setProgress = (progress: number): void => {
52
- lastProgress = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : 0;
53
- const full = width * 0.5;
54
- const barWidth = Math.max(full * 0.002, full * lastProgress);
55
- fill.scale.set(barWidth, height * 0.012, 1);
56
- fill.position.set(-full / 2 + barWidth / 2, -height * 0.05, 0);
239
+
240
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
241
+ if (done) return;
242
+ configureTexture(texture);
243
+ mesh.material.map = texture;
244
+ mesh.material.color.set(0xffffff);
245
+ mesh.material.needsUpdate = true;
246
+ ownedTextures.add(texture);
247
+ if (mesh === backdrop) backdropTexture = texture;
248
+ layout();
249
+ updateProgress(progress);
250
+ };
251
+
252
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
253
+ if (source === undefined || host.assets === undefined) return;
254
+ void host.assets
255
+ .texture(source)
256
+ .then((texture) => attachTexture(mesh, texture))
257
+ .catch(() => undefined);
57
258
  };
259
+ load(loading.backgroundImage, backdrop);
260
+ load(loading.fillImage, fill);
261
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
262
+ void host.assets
263
+ .texture(loading.logoImage)
264
+ .then((texture) => {
265
+ if (done) return;
266
+ configureTexture(texture);
267
+ logo.material.map = texture;
268
+ logo.material.needsUpdate = true;
269
+ logo.visible = true;
270
+ ownedTextures.add(texture);
271
+ layout();
272
+ })
273
+ .catch(() => undefined);
274
+ }
275
+
276
+ layer.opaque = true;
58
277
  layout();
59
- setProgress(0);
60
- let done = false;
278
+ updateProgress(0);
279
+
61
280
  const finish = (): void => {
62
281
  if (done) return;
63
282
  done = true;
@@ -66,24 +285,31 @@ export function createLoadingScreen(host: ILoadingHost) {
66
285
  mesh.geometry.dispose();
67
286
  mesh.material.dispose();
68
287
  }
288
+ for (const texture of ownedTextures) texture.dispose();
69
289
  layer.opaque = false;
70
290
  };
291
+
71
292
  void (async () => {
72
293
  await host.startup.whenReady();
73
- await host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
294
+ if (done) return;
295
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
296
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
297
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
298
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
299
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
300
+ // decides when the player sees the world.
301
+ try {
302
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
303
+ } catch {
304
+ // A renderer without compileAsync is not a reason to keep the world hidden.
305
+ }
74
306
  finish();
75
307
  })();
308
+
76
309
  return {
77
310
  finish,
78
311
  update(): void {
79
- if (done) return;
80
- const nextWidth = camera.right - camera.left;
81
- const nextHeight = camera.top - camera.bottom;
82
- if (nextWidth !== width || nextHeight !== height) {
83
- layout();
84
- setProgress(lastProgress);
85
- }
86
- setProgress(host.startup.progress);
312
+ if (!done) updateProgress(host.startup.progress);
87
313
  },
88
314
  };
89
315
  }
@@ -1,14 +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";
4
-
5
- type OutputRenderer = { kind: string; raw: unknown; setOutputNode(node: unknown): void };
6
-
7
- export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
8
- const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
9
- raw.toneMapping = ACESFilmicToneMapping;
10
- raw.toneMappingExposure = 1.15;
11
- if (renderer.kind !== "webgpu") return;
12
- const colour = pass(scene, camera).getTextureNode();
13
- renderer.setOutputNode(colour.add(bloom(colour, 0.42, 0.5, 0.2)));
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";
18
+
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;
22
+
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.42,
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 26-unit shadow extent
38
+ // `lighting.ts` lights — a lit board seen from above, where the bounce off the ground plane is most of the effect.
39
+ ssgiRadius: 18,
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: 44,
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 });
14
71
  }