create-threenative 0.2.9 → 0.2.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +229 -36
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +17 -11
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +16 -10
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +17 -11
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +17 -11
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +17 -11
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +76 -5
  420. package/templates/racing/src/scenes/Race.ts +53 -42
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +16 -10
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +16 -10
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +17 -11
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +17 -11
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +17 -11
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +17 -11
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +17 -11
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +56 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +53 -34
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +17 -11
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,481 @@
1
+ import {
2
+ GPUParticles3D,
3
+ Scene,
4
+ type SceneFrame,
5
+ afterPhysics,
6
+ isMobile,
7
+ isTouchscreenAvailable,
8
+ lodPixelScale,
9
+ } from "@threenative/core";
10
+ import {
11
+ CollisionShape3D,
12
+ type IPhysicsContext,
13
+ RigidBody3D,
14
+ buildStaticColliders,
15
+ } from "@threenative/physics";
16
+ import { type DataTexture, Euler, type PerspectiveCamera, Vector3 } from "three";
17
+ import { FOOT_OFFSET, type GameCtx, HERO_FEEL, Hero, WORLD_LAYER } from "../entities/Hero.js";
18
+ import { Pickup } from "../entities/Pickup.js";
19
+ import { Walker, type WalkerKind } from "../entities/Walker.js";
20
+ import { COURSE, type ICourse, buildCourse, makeRng } from "../level/Course.js";
21
+ import { emitPlaytestEvent } from "../playtest-events.js";
22
+ import { type WallProbe, createOrbitCamera } from "../render/camera.js";
23
+ import { BURSTS, EFFECTS } from "../render/effects.js";
24
+ import { setupLighting } from "../render/lighting.js";
25
+ import { createLoadingScreen } from "../render/loading.js";
26
+ import { postTier, setupPost } from "../render/postprocessing.js";
27
+ import { GRASS_SHARE } from "../render/quality.js";
28
+ import { setupSky, skyTexture } from "../render/sky.js";
29
+ import { loadSurfaces, updateSurfaceSampling } from "../render/surface.js";
30
+ import { TouchControls } from "../render/touch-controls.js";
31
+ import { type GameState, HUD_PILL } from "../state.js";
32
+
33
+ export type { GameCtx };
34
+
35
+ const WEDGES = 8;
36
+ /** All three Sunseeds: the summit, the eight red gems and the wall-kick shaft. */
37
+ const SEEDS = 3;
38
+ const JUMPS: ReadonlySet<string> = new Set([
39
+ "single",
40
+ "double",
41
+ "triple",
42
+ "backflip",
43
+ "sideflip",
44
+ "longJump",
45
+ ]);
46
+ /** Run puffs start above this ground speed (m/s): a slow walk raises no dust. */
47
+ const DUST_SPEED = 5;
48
+ /** The hero's capsule radius plus a walker's, for a touch, and how far a ground pound reaches. */
49
+ const HIT = { touch: Walker.radius + 0.35, pound: 2.5, stompDrop: -1 } as const;
50
+
51
+ export class Play extends Scene<GameState, IPhysicsContext> {
52
+ static override readonly initialState: GameState = {
53
+ action: "idle",
54
+ checkpoint: 0,
55
+ coins: 0,
56
+ defeated: 0,
57
+ gemTotal: 8,
58
+ gems: 0,
59
+ grounded: false,
60
+ hudFaded: false,
61
+ landings: 0,
62
+ paused: false,
63
+ respawns: 0,
64
+ seedTotal: SEEDS,
65
+ seeds: 0,
66
+ toast: "",
67
+ uiReady: false,
68
+ wallHits: 0,
69
+ wedges: WEDGES,
70
+ won: false,
71
+ };
72
+
73
+ #sky: DataTexture | undefined;
74
+ #fill: DataTexture | undefined;
75
+ #course: ICourse | undefined;
76
+ #hero: Hero | undefined;
77
+ #pickups: Pickup[] = [];
78
+ #walkers: Walker[] = [];
79
+ #post: ReturnType<typeof setupPost> | undefined;
80
+ #loading: ReturnType<typeof createLoadingScreen> | undefined;
81
+
82
+ /**
83
+ * Everything a scenario can place is built and registered here: `setup.place` is applied after
84
+ * `load()` and before `enter()`, so an entity that first appears in `enter()` cannot be placed.
85
+ * `enter()` then re-reads every placed transform.
86
+ */
87
+ override async load(ctx: GameCtx): Promise<void> {
88
+ // The cover first, before the surfaces and the course: the page shows its CSS cover until the
89
+ // canvas draws this one, so nothing else may reach the screen in between.
90
+ this.#loading = createLoadingScreen(ctx);
91
+ // The HUD is page UI the cover cannot hide, so it waits for the same readiness.
92
+ void ctx.startup.whenReady().then(() => ctx.state.set({ loaded: true }));
93
+ const surfaces = await loadSurfaces(ctx.assets);
94
+ this.#sky = skyTexture();
95
+ this.#fill = skyTexture(0.3, 128);
96
+ setupSky(ctx.scene, this.#sky, this.#fill);
97
+ const tier = postTier({
98
+ gpuClass: ctx.renderer.gpuClass?.class,
99
+ mobile: isMobile(),
100
+ software: ctx.renderer.softwareAdapter !== undefined,
101
+ });
102
+ const course = buildCourse(makeRng(6402), surfaces, GRASS_SHARE[tier]);
103
+ this.#course = course;
104
+ ctx.add(course.group);
105
+ ctx.entities.add("course", { debug: () => course.audit });
106
+ const hit = { normal: new Vector3(), position: new Vector3() };
107
+ this.#hero = ctx.entities.add(
108
+ "player",
109
+ new Hero(ctx, course.spawn, (from, to) => {
110
+ const found = ctx.physics.directSpaceState.intersectRay({
111
+ collisionMask: WORLD_LAYER,
112
+ from,
113
+ to,
114
+ });
115
+ // A ray that starts inside a box (the orbiting deck rising through an airborne hero) hits
116
+ // at distance 0 with a zero normal. That is no wall, and its normal would divide to NaN.
117
+ if (found === undefined) return undefined;
118
+ const n = found.normal;
119
+ if (n.x * n.x + n.y * n.y + n.z * n.z < 0.25) return undefined;
120
+ hit.position.set(found.position.x, found.position.y, found.position.z);
121
+ hit.normal.set(found.normal.x, found.normal.y, found.normal.z);
122
+ return hit;
123
+ }),
124
+ );
125
+ const add = (name: string, pickup: Pickup): void => {
126
+ ctx.add(pickup.mesh);
127
+ ctx.entities.add(name, pickup);
128
+ this.#pickups.push(pickup);
129
+ };
130
+ course.coins.forEach((at, i) => add(`coin.${i}`, new Pickup("coin", at)));
131
+ course.gems.forEach((at, i) => add(`gem.${i}`, new Pickup("gem", at)));
132
+ for (const [name, at] of Object.entries(course.seeds))
133
+ add(`seed.${name}`, new Pickup("seed", at, name));
134
+ // Bumblets keep the `walker.<i>` names the scenarios place; the others are `hopper.<i>`, `thornback.<i>`.
135
+ for (const [kind, homes] of Object.entries(course.walkers) as [
136
+ WalkerKind,
137
+ ICourse["walkers"][WalkerKind],
138
+ ][]) {
139
+ homes.forEach((at, i) => {
140
+ const walker = new Walker(kind, at, i * 1.7, course.ground);
141
+ ctx.add(walker.mesh);
142
+ ctx.entities.add(`${kind === "bumblet" ? "walker" : kind}.${i}`, walker);
143
+ this.#walkers.push(walker);
144
+ });
145
+ }
146
+ }
147
+
148
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
149
+ const course = this.#course;
150
+ const hero = this.#hero;
151
+ const loading = this.#loading;
152
+ if (
153
+ course === undefined ||
154
+ hero === undefined ||
155
+ this.#sky === undefined ||
156
+ loading === undefined
157
+ )
158
+ throw new Error("Play.enter ran before load() built the course.");
159
+ ctx.beforeRender(() => {
160
+ updateSurfaceSampling(
161
+ ctx.renderer.temporalUpscale?.() === true ? ctx.renderer.surface().resolutionScale : 1,
162
+ );
163
+ });
164
+ // `userData.solid` marks exactly the walkable meshes in `level/Course.ts`. The shaft's walls
165
+ // reach 16 m, so the default 4.5 m reachable ceiling is raised to keep their tops solid.
166
+ buildStaticColliders(ctx, course.group, {
167
+ collisionLayer: WORLD_LAYER,
168
+ predicate: (object) => object.userData.solid === true,
169
+ reachableCeiling: 40,
170
+ });
171
+ // A kinematic body follows its mesh; the engine carries a character standing on it.
172
+ new RigidBody3D({
173
+ collisionLayer: WORLD_LAYER,
174
+ object: course.platform,
175
+ physics: ctx.physics,
176
+ shape: CollisionShape3D.box(...COURSE.platform.size),
177
+ type: "kinematic",
178
+ });
179
+ setupSky(ctx.scene, this.#sky, this.#fill);
180
+ const lighting = setupLighting(
181
+ ctx.scene,
182
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
183
+ isMobile(),
184
+ );
185
+ this.#post = setupPost(ctx.renderer, ctx.scene, ctx.camera, {
186
+ godraysLight: lighting.key,
187
+ gpuClass: ctx.renderer.gpuClass?.class,
188
+ mobile: isMobile(),
189
+ software: ctx.renderer.softwareAdapter !== undefined,
190
+ });
191
+ const camera = ctx.camera as PerspectiveCamera;
192
+ ctx.add(camera);
193
+ const touchControls =
194
+ isMobile() && isTouchscreenAvailable()
195
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
196
+ : undefined;
197
+
198
+ // A scenario may have moved the hero and turned it: read both back, then stand it there, on
199
+ // the ground if the spot it named is under a hill.
200
+ const start = hero.mesh.position.clone();
201
+ start.y = Math.max(start.y, course.ground(start.x, start.z) + FOOT_OFFSET);
202
+ const startYaw = new Euler().setFromQuaternion(hero.mesh.quaternion, "YXZ").y;
203
+ hero.teleport(start, startYaw);
204
+ for (const pickup of this.#pickups) pickup.settle();
205
+ for (const walker of this.#walkers) walker.settle();
206
+
207
+ const along = new Vector3();
208
+ const probe: WallProbe = (from, to) => {
209
+ const length = along.subVectors(to, from).length();
210
+ if (length < 1e-4) return undefined;
211
+ return ctx.physics.directSpaceState.intersectRay({ collisionMask: WORLD_LAYER, from, to })
212
+ ?.distance;
213
+ };
214
+ const shadowForward = new Vector3();
215
+ const orbit = createOrbitCamera(camera);
216
+ orbit.snap(hero.mesh.position, hero.yaw, probe);
217
+ // Whether the camera sees the hero: a ray from the lens to the hero's waist hits no wall.
218
+ let rayClear = true;
219
+ ctx.entities.add("camera-rig", {
220
+ debug: () => ({ ...orbit.debug(), rayClear }),
221
+ });
222
+ afterPhysics(ctx, (dt) => {
223
+ // The mouse turns the camera only while the canvas holds the pointer lock a click took.
224
+ if (ctx.input.raw.pointer.captured) {
225
+ const look = ctx.input.vector("look");
226
+ orbit.look(look.x, look.y);
227
+ }
228
+ orbit.update(hero.mesh.position, hero.body.velocity, dt, probe);
229
+ rayClear = probe(camera.position, hero.mesh.position) === undefined;
230
+ lighting.follow(hero.mesh.position, camera.getWorldDirection(shadowForward));
231
+ course.meadow.update(camera.position);
232
+ });
233
+
234
+ // Effects: four pooled emitters, every look parameter in `render/effects.ts`.
235
+ const make = (name: keyof typeof EFFECTS): GPUParticles3D => {
236
+ const emitter = ctx.add(new GPUParticles3D(EFFECTS[name]()));
237
+ emitter.name = `effects-${name}`;
238
+ return emitter;
239
+ };
240
+ const emitters = {
241
+ dust: make("dust"),
242
+ flash: make("flash"),
243
+ pollen: make("pollen"),
244
+ sparkle: make("sparkle"),
245
+ };
246
+ const fired: Record<string, number> = Object.fromEntries(
247
+ Object.keys(BURSTS).map((kind) => [kind, 0]),
248
+ );
249
+ const burst = (kind: keyof typeof BURSTS, x: number, y: number, z: number): void => {
250
+ const { count, emitter, shape } = BURSTS[kind];
251
+ emitters[emitter].emitParticle({
252
+ count,
253
+ direction: { x: shape[0], y: shape[1], z: shape[2] },
254
+ origin: { x, y, z },
255
+ });
256
+ fired[kind] = (fired[kind] ?? 0) + 1;
257
+ };
258
+ ctx.entities.add("effects", {
259
+ debug: () => ({
260
+ dust: emitters.dust.stats.spawned,
261
+ fired: { ...fired },
262
+ flash: emitters.flash.stats.spawned,
263
+ pollen: emitters.pollen.stats.spawned,
264
+ sparkle: emitters.sparkle.stats.spawned,
265
+ }),
266
+ });
267
+ let previous = hero.action;
268
+ let wasGrounded = hero.grounded;
269
+ let dustClock = 0;
270
+ let airTicks = 0;
271
+
272
+ let coins = 0;
273
+ let gems = 0;
274
+ let seeds = 0;
275
+ let won = false;
276
+ let defeated = 0;
277
+ let wedges = WEDGES;
278
+ let checkpoint = 0;
279
+ let respawns = 0;
280
+ let elapsed = 0;
281
+ let toastUntil = 0;
282
+ let chainTaught = false;
283
+ const toast = (text: string, seconds = 1.6): void => {
284
+ ctx.state.set({ toast: text });
285
+ toastUntil = elapsed + seconds;
286
+ };
287
+ const respawn = (): void => {
288
+ const point = course.checkpoints[checkpoint] ?? course.spawn;
289
+ hero.teleport(new Vector3(point.x, point.y + FOOT_OFFSET + 0.05, point.z), hero.yaw);
290
+ respawns += 1;
291
+ emitPlaytestEvent({ entity: "player", name: "respawned" });
292
+ };
293
+ const defeat = (walker: Walker, how: string): void => {
294
+ const w = walker.mesh.position;
295
+ burst("poof", w.x, w.y + 0.4, w.z);
296
+ walker.kill();
297
+ defeated += 1;
298
+ emitPlaytestEvent({ entity: "player", name: how });
299
+ };
300
+ // Ticks a Sunseed sat under the HUD pill: each one fades the pill through `hudFaded`.
301
+ const hud = { under: 0 };
302
+ ctx.entities.add("hud", { debug: () => ({ ...hud }) });
303
+ const seedAt = new Vector3();
304
+ const seedUnderHud = (width: number, height: number): boolean => {
305
+ camera.updateMatrixWorld();
306
+ return this.#pickups.some((pickup) => {
307
+ if (pickup.kind !== "seed" || pickup.taken) return false;
308
+ const depth = -seedAt.copy(pickup.mesh.position).applyMatrix4(camera.matrixWorldInverse).z;
309
+ if (depth <= camera.near) return false;
310
+ // The seed and its halo reach about a metre from its centre.
311
+ const r = lodPixelScale(camera, height, depth);
312
+ seedAt.copy(pickup.mesh.position).project(camera);
313
+ const x = ((seedAt.x + 1) / 2) * width;
314
+ const y = ((1 - seedAt.y) / 2) * height;
315
+ return (
316
+ x + r > HUD_PILL.left &&
317
+ x - r < HUD_PILL.left + HUD_PILL.width &&
318
+ y + r > HUD_PILL.top &&
319
+ y - r < HUD_PILL.top + HUD_PILL.height
320
+ );
321
+ });
322
+ };
323
+ const statePatch: Partial<GameState> = {};
324
+
325
+ return (frameCtx, dt) => {
326
+ loading.update();
327
+ elapsed += dt;
328
+ course.platformAt(elapsed, course.platform.position);
329
+ hero.update(
330
+ frameCtx,
331
+ dt,
332
+ orbit.yaw,
333
+ touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
334
+ );
335
+ const at = hero.mesh.position;
336
+ const feet = at.y - FOOT_OFFSET;
337
+ const fx = -Math.sin(hero.yaw);
338
+ const fz = -Math.cos(hero.yaw);
339
+ const action = hero.action;
340
+ if (action !== previous) {
341
+ if (!wasGrounded && hero.grounded) {
342
+ if (action === "poundLand") {
343
+ burst("pound", at.x, feet + 0.05, at.z);
344
+ burst("poundRing", at.x, feet + 0.1, at.z);
345
+ burst("debris", at.x, feet + 0.1, at.z);
346
+ } else burst("landing", at.x, feet + 0.05, at.z);
347
+ } else if ((wasGrounded && JUMPS.has(action)) || action === "double")
348
+ burst("takeoff", at.x, feet + 0.05, at.z);
349
+ if (action === "skid") burst("skid", at.x + fx * 0.3, feet + 0.05, at.z + fz * 0.3);
350
+ // A wall kick faces away from the wall, so the contact is behind the hero.
351
+ if (action === "wallKick") {
352
+ burst("wallKick", at.x - fx * 0.45, at.y + 0.2, at.z - fz * 0.45);
353
+ burst("kickStars", at.x - fx * 0.45, at.y + 0.2, at.z - fz * 0.45);
354
+ }
355
+ if (action === "ledgeHang") burst("ledge", at.x + fx * 0.45, feet + 1.3, at.z + fz * 0.45);
356
+ // A single jump teaches the double (in the air or on landing) until the player has done one.
357
+ if (action === "single" && !chainTaught) toast("SPACE AGAIN: DOUBLE JUMP", 2.4);
358
+ if (action === "double") chainTaught = true;
359
+ previous = action;
360
+ airTicks = 0;
361
+ }
362
+ wasGrounded = hero.grounded;
363
+ airTicks += 1;
364
+ if (action === "run" && hero.speed > DUST_SPEED) {
365
+ dustClock += dt * (hero.speed / 9.6);
366
+ if (dustClock > 0.06) {
367
+ dustClock = 0;
368
+ burst("run", at.x - fx * 0.3, feet + 0.05, at.z - fz * 0.3);
369
+ }
370
+ }
371
+ if (action === "triple" && airTicks % 2 === 0) burst("trail", at.x, at.y, at.z);
372
+ if (action === "longJump") burst("streak", at.x, at.y, at.z);
373
+ // Pollen drifts in round the hero, a few motes every 0.15 s, so the air is never empty.
374
+ if (elapsed % 0.15 < dt) burst("pollen", at.x, feet + 0.4, at.z);
375
+
376
+ this.#pickups.forEach((pickup, i) => {
377
+ // A red gem glints every 1.4 s, staggered so the eight never flash together.
378
+ const p = pickup.mesh.position;
379
+ if (pickup.kind === "gem" && !pickup.taken && (elapsed + i * 0.37) % 1.4 < dt)
380
+ burst("glint", p.x, p.y, p.z);
381
+ });
382
+ for (const pickup of this.#pickups) {
383
+ pickup.update(dt, elapsed);
384
+ if (pickup.taken || pickup.mesh.position.distanceToSquared(at) >= pickup.reach ** 2)
385
+ continue;
386
+ const p = pickup.mesh.position;
387
+ burst(pickup.kind, p.x, p.y, p.z);
388
+ pickup.take();
389
+ emitPlaytestEvent({ entity: "player", name: "collected" });
390
+ if (pickup.kind === "coin") {
391
+ coins += 1;
392
+ wedges = Math.min(WEDGES, wedges + 1);
393
+ } else if (pickup.kind === "gem") {
394
+ gems += 1;
395
+ toast(`RED GEM ${gems}/8`);
396
+ if (gems === 8) {
397
+ seeds += 1;
398
+ toast("SUNSEED!", 2.4);
399
+ }
400
+ } else {
401
+ seeds += 1;
402
+ toast("SUNSEED!", 2.4);
403
+ }
404
+ }
405
+
406
+ // The course is clear the moment the third Sunseed is held: the HUD banner is the one win
407
+ // surface and the state carries it, so a scenario asserts the end instead of inferring it.
408
+ if (!won && seeds === SEEDS) {
409
+ won = true;
410
+ emitPlaytestEvent({ entity: "player", name: "won" });
411
+ }
412
+
413
+ for (const walker of this.#walkers) {
414
+ walker.update(dt, elapsed, at);
415
+ if (!walker.alive) continue;
416
+ const w = walker.mesh.position;
417
+ const reach = Math.hypot(w.x - at.x, w.z - at.z);
418
+ const dy = feet - w.y;
419
+ if (hero.action === "poundLand" && reach < HIT.pound && Math.abs(dy) < 1) {
420
+ defeat(walker, "pounded");
421
+ continue;
422
+ }
423
+ if (reach >= HIT.touch || dy <= -0.5 || dy >= Walker.height) continue;
424
+ const stomp = hero.body.velocity.y < HIT.stompDrop && dy > Walker.height * 0.4;
425
+ if (stomp && walker.stompable) {
426
+ defeat(walker, "stomped");
427
+ hero.bounce();
428
+ } else if (hero.action === "dive" || hero.action === "diveSlide") {
429
+ defeat(walker, "dived");
430
+ } else if (hero.hurtTimer === 0) {
431
+ wedges -= 1;
432
+ hero.knockBack(w);
433
+ // A stomp on a thornback lands on its spikes.
434
+ if (stomp) emitPlaytestEvent({ entity: "player", name: "spiked" });
435
+ emitPlaytestEvent({ entity: "player", name: "hurt" });
436
+ toast(stomp ? "SPIKES!" : "OUCH!", 0.9);
437
+ }
438
+ }
439
+
440
+ course.checkpoints.forEach((point, i) => {
441
+ if (Math.hypot(point.x - at.x, point.z - at.z) < 3 && Math.abs(point.y - feet) < 2)
442
+ checkpoint = i;
443
+ });
444
+ if (at.y < HERO_FEEL.killPlane) respawn();
445
+ if (wedges <= 0) {
446
+ wedges = WEDGES;
447
+ respawn();
448
+ toast("OUT OF WEDGES", 2.4);
449
+ }
450
+ if (toastUntil !== 0 && elapsed > toastUntil) {
451
+ toastUntil = 0;
452
+ frameCtx.state.set({ toast: "" });
453
+ }
454
+
455
+ const under = seedUnderHud(frameCtx.viewport.size.width, frameCtx.viewport.size.height);
456
+ statePatch.hudFaded = under;
457
+ hud.under += under ? 1 : 0;
458
+ statePatch.action = hero.action;
459
+ statePatch.checkpoint = checkpoint;
460
+ statePatch.coins = coins;
461
+ statePatch.defeated = defeated;
462
+ statePatch.gems = gems;
463
+ statePatch.grounded = hero.grounded;
464
+ statePatch.landings = hero.landings;
465
+ statePatch.respawns = respawns;
466
+ statePatch.seeds = seeds;
467
+ statePatch.wallHits = hero.wallHits;
468
+ statePatch.wedges = wedges;
469
+ statePatch.won = won;
470
+ frameCtx.state.set(statePatch);
471
+ };
472
+ }
473
+
474
+ override exit(ctx: GameCtx): void {
475
+ this.#post?.dispose();
476
+ this.#post = undefined;
477
+ this.#pickups = [];
478
+ this.#walkers = [];
479
+ super.exit(ctx);
480
+ }
481
+ }
@@ -0,0 +1,38 @@
1
+ export type GameState = {
2
+ /** True once startup is ready and the loading cover lifts; the HUD stays hidden until then. */
3
+ loaded?: boolean;
4
+ /** Which checkpoint the hero respawns at, as an index into the course's checkpoints. */
5
+ checkpoint: number;
6
+ coins: number;
7
+ /** Walkers defeated by a stomp, a ground pound or a dive. */
8
+ defeated: number;
9
+ /** Red gems collected; the eighth one awards a Sunseed. */
10
+ gems: number;
11
+ gemTotal: number;
12
+ grounded: boolean;
13
+ /** True while a Sunseed sits under the HUD pill: the pill fades so the goal shows through. */
14
+ hudFaded: boolean;
15
+ /** The hero's action, as `Hero.ts` names it: "run", "triple", "longJump", "ledgeHang"… */
16
+ action: string;
17
+ /** How many times the hero has landed, which a scenario waits on to press inside a window. */
18
+ landings: number;
19
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
20
+ paused: boolean;
21
+ respawns: number;
22
+ /** Sunseeds collected, out of three: the summit, the eight red gems, the wall-kick shaft. */
23
+ seeds: number;
24
+ seedTotal: number;
25
+ /** A short line under the HUD — "RED GEM 3/8", "SUNSEED!". */
26
+ toast: string;
27
+ /** True once the UI layer has rendered and published its interactive rectangles. */
28
+ uiReady: boolean;
29
+ /** Wall contacts that opened the wall-kick window, which a scenario waits on. */
30
+ wallHits: number;
31
+ /** The health meter, out of eight wedges. */
32
+ wedges: number;
33
+ /** True once all three Sunseeds are held: the course is clear and `Hud.tsx` says so. */
34
+ won: boolean;
35
+ };
36
+
37
+ /** The HUD pill's box in CSS pixels from the top-left: `Hud.tsx` draws it here and `Play.ts` fades it when a Sunseed projects inside. */
38
+ export const HUD_PILL = { left: 16, top: 16, width: 336, height: 44 } as const;
@@ -0,0 +1,106 @@
1
+ @import "tailwindcss";
2
+
3
+ @source "../index.html";
4
+ @source "./";
5
+
6
+ @theme {
7
+ --color-ink: #1d3a5c;
8
+ /* The loading cover's colour (`palette.skyLow`), so the page and the cover paint as one. */
9
+ --color-cover: #6aaaea;
10
+ --color-panel: #2a1a0e;
11
+ --color-line: #ffffff40;
12
+ --color-lume: #ffb35c;
13
+ --color-warn: #f2b01e;
14
+ --color-heart: #e5484d;
15
+ --color-text: #fff4dc;
16
+ --color-dim: #e9c98a;
17
+ --font-mono: ui-rounded, "Nunito", "Trebuchet MS", system-ui, sans-serif;
18
+ /* The controls hint reads once, then gets out of the view. */
19
+ --animate-hint-fade: hint-fade 1s ease-in 10s forwards;
20
+
21
+ @keyframes hint-fade {
22
+ to {
23
+ opacity: 0;
24
+ }
25
+ }
26
+ }
27
+
28
+ html,
29
+ body,
30
+ #root {
31
+ width: 100%;
32
+ height: 100%;
33
+ margin: 0;
34
+ overflow: hidden;
35
+ }
36
+
37
+ body {
38
+ color: var(--color-text);
39
+ font-family: var(--font-mono);
40
+ -webkit-font-smoothing: antialiased;
41
+ }
42
+
43
+ /*
44
+ * The page's backdrop belongs to the web document's own mount point, never to `body`.
45
+ * `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
46
+ * transparent web view loads over the game: a `body` background there paints an opaque sheet over
47
+ * the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
48
+ * in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
49
+ */
50
+
51
+ #root {
52
+ background: var(--color-cover);
53
+ }
54
+
55
+ /* Boot failures are a page state, so the generated game owns their presentation. */
56
+ [data-threenative-canvas-error="true"] {
57
+ position: fixed;
58
+ inset: 0;
59
+ z-index: 1000;
60
+ display: grid;
61
+ place-items: center;
62
+ box-sizing: border-box;
63
+ padding: clamp(1.5rem, 8vw, 6rem);
64
+ overflow: auto;
65
+ background: #fff7ed;
66
+ color: var(--color-ink);
67
+ font-family: inherit;
68
+ font-size: clamp(1rem, 2vw, 1.5rem);
69
+ line-height: 1.5;
70
+ text-align: center;
71
+ white-space: pre-wrap;
72
+ overflow-wrap: anywhere;
73
+ }
74
+
75
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
76
+ [data-threenative-debug-overlay="true"] {
77
+ position: fixed;
78
+ top: 1rem;
79
+ right: 1rem;
80
+ z-index: 50;
81
+ max-width: 24rem;
82
+ padding: 0.75rem;
83
+ pointer-events: none;
84
+ background: rgb(2 6 23 / 90%);
85
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
86
+ color: #cffafe;
87
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
88
+ font-size: 12px;
89
+ line-height: 1.5;
90
+ }
91
+
92
+ [data-threenative-debug-overlay="true"] table {
93
+ width: 100%;
94
+ table-layout: fixed;
95
+ }
96
+
97
+ [data-threenative-debug-overlay="true"] th,
98
+ [data-threenative-debug-overlay="true"] td {
99
+ padding-right: 1rem;
100
+ text-align: left;
101
+ }
102
+
103
+ [data-threenative-debug-overlay="true"] td:last-child {
104
+ overflow-wrap: anywhere;
105
+ word-break: break-all;
106
+ }
@@ -0,0 +1,22 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
+ import type { GameState } from "../state.js";
5
+ import { GameUi } from "./GameUi.js";
6
+
7
+ /**
8
+ * The web target's page: the canvas, then the same UI every other target renders.
9
+ *
10
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
11
+ * The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
12
+ * has to put a canvas on the page.
13
+ */
14
+ export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
15
+ return (
16
+ <main className="relative h-screen w-screen overflow-hidden bg-cover">
17
+ <GameCanvas className="absolute inset-0" game={game} />
18
+ <GameUi />
19
+ <DebugOverlay />
20
+ </main>
21
+ );
22
+ }
@@ -0,0 +1,20 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ /**
6
+ * Everything the player sees that is not the scene.
7
+ *
8
+ * One component, mounted twice by two entries that differ only in what else is on the page:
9
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
10
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
11
+ * same UI on every target" a fact rather than an intention.
12
+ */
13
+ export function GameUi() {
14
+ return (
15
+ <UiLayer>
16
+ <Hud />
17
+ <Menu />
18
+ </UiLayer>
19
+ );
20
+ }