create-threenative 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,141 @@
1
+ // Generated source. This stage is ordinary Three.js TSL; the engine only orders and measures it.
2
+
3
+ import {
4
+ cameraFar,
5
+ cameraNear,
6
+ color,
7
+ luminance,
8
+ mix,
9
+ perspectiveDepthToViewZ,
10
+ screenSize,
11
+ screenUV,
12
+ texture,
13
+ vec2,
14
+ vec4,
15
+ } from "three/tsl";
16
+ import type { Node } from "three/webgpu";
17
+ import { createTextureScope } from "./textureLifetime.js";
18
+
19
+ export interface IOutlineStageOptions {
20
+ /** The depth attachment written by the scene pass. */
21
+ readonly depthNode: Node;
22
+ /** Ink colour and thresholds are this game's look decisions. */
23
+ readonly inkColor?: number;
24
+ readonly strength?: number;
25
+ readonly threshold?: number;
26
+ readonly softness?: number;
27
+ readonly depthWeight?: number;
28
+ }
29
+
30
+ export interface IOutlineStage {
31
+ readonly after: "bloom";
32
+ readonly build: (input: unknown) => unknown;
33
+ readonly dispose: () => void;
34
+ readonly name: "outline";
35
+ }
36
+
37
+ /**
38
+ * Eight-tap Sobel edge ink, normalised to the physical framebuffer pixel size.
39
+ *
40
+ * Colour edges catch the painted prop boundaries while linearised depth catches silhouettes
41
+ * whose two sides happen to have similar colours. The stage samples the original chain input
42
+ * and never owns a material, palette or renderer fallback.
43
+ */
44
+ export function createOutlineStage(options: IOutlineStageOptions): IOutlineStage {
45
+ if (!isNode(options.depthNode)) throw new Error("outline depth source is missing");
46
+ const strength = finiteNonNegative(options.strength ?? 0.8, "outline strength");
47
+ const threshold = finiteNonNegative(options.threshold ?? 0.12, "outline threshold");
48
+ const softness = finitePositive(options.softness ?? 0.16, "outline softness");
49
+ const depthWeight = finiteUnit(options.depthWeight ?? 0.65, "outline depthWeight");
50
+ const colourWeight = 1 - depthWeight;
51
+ const ink = color(options.inkColor ?? 0x142331);
52
+ const textureScope = createTextureScope();
53
+
54
+ return {
55
+ after: "bloom",
56
+ build: (input) => {
57
+ textureScope.dispose();
58
+ if (!isNode(input)) throw new Error("outline input is missing");
59
+ if (strength === 0) return input;
60
+ const source = textureScope.texture(input) as unknown as ITextureNode;
61
+ const depthSource = texture(options.depthNode as never);
62
+ const texel = screenSize.reciprocal();
63
+ const sampleUv = (x: number, y: number): Node<"vec2"> =>
64
+ screenUV.add(texel.mul(vec2(x, y))).clamp(0, 1) as Node<"vec2">;
65
+ const sampleColour = (x: number, y: number): Node<"float"> =>
66
+ luminance(source.sample(sampleUv(x, y)).rgb);
67
+ const sampleDepth = (x: number, y: number): Node<"float"> =>
68
+ perspectiveDepthToViewZ(depthSource.sample(sampleUv(x, y)).r, cameraNear, cameraFar);
69
+
70
+ // Sobel's eight neighbours use physical-pixel offsets, so a resize does not change the
71
+ // apparent line width. This is the same eight-tap neighbourhood for colour and depth.
72
+ const colourX = sampleColour(-1, -1)
73
+ .negate()
74
+ .add(sampleColour(-1, 0).mul(-2))
75
+ .add(sampleColour(-1, 1).negate())
76
+ .add(sampleColour(1, -1))
77
+ .add(sampleColour(1, 0).mul(2))
78
+ .add(sampleColour(1, 1));
79
+ const colourY = sampleColour(-1, -1)
80
+ .negate()
81
+ .add(sampleColour(0, -1).mul(-2))
82
+ .add(sampleColour(1, -1).negate())
83
+ .add(sampleColour(-1, 1))
84
+ .add(sampleColour(0, 1).mul(2))
85
+ .add(sampleColour(1, 1));
86
+ const depthX = sampleDepth(-1, -1)
87
+ .negate()
88
+ .add(sampleDepth(-1, 0).mul(-2))
89
+ .add(sampleDepth(-1, 1).negate())
90
+ .add(sampleDepth(1, -1))
91
+ .add(sampleDepth(1, 0).mul(2))
92
+ .add(sampleDepth(1, 1));
93
+ const depthY = sampleDepth(-1, -1)
94
+ .negate()
95
+ .add(sampleDepth(0, -1).mul(-2))
96
+ .add(sampleDepth(1, -1).negate())
97
+ .add(sampleDepth(-1, 1))
98
+ .add(sampleDepth(0, 1).mul(2))
99
+ .add(sampleDepth(1, 1));
100
+ const centreDepth = sampleDepth(0, 0).abs().max(1);
101
+ const colourEdge = colourX.mul(colourX).add(colourY.mul(colourY)).sqrt();
102
+ const depthEdge = depthX.mul(depthX).add(depthY.mul(depthY)).sqrt().div(centreDepth);
103
+ const edge = colourEdge.mul(colourWeight).add(depthEdge.mul(depthWeight));
104
+ const mask = edge
105
+ .smoothstep(threshold, threshold + softness)
106
+ .mul(strength)
107
+ .clamp(0, 1);
108
+ const base = source.sample(screenUV);
109
+ return mix(base, vec4(ink, base.a), mask);
110
+ },
111
+ dispose: textureScope.dispose,
112
+ name: "outline",
113
+ };
114
+ }
115
+
116
+ interface ITextureNode extends Node<"vec4"> {
117
+ sample(uv: Node<"vec2">): Node<"vec4">;
118
+ }
119
+
120
+ function isNode(value: unknown): value is Node {
121
+ return (
122
+ typeof value === "object" && value !== null && (value as { isNode?: boolean }).isNode === true
123
+ );
124
+ }
125
+
126
+ function finiteNonNegative(value: number, name: string): number {
127
+ if (!Number.isFinite(value) || value < 0)
128
+ throw new Error(`${name} must be finite and non-negative`);
129
+ return value;
130
+ }
131
+
132
+ function finitePositive(value: number, name: string): number {
133
+ if (!Number.isFinite(value) || value <= 0) throw new Error(`${name} must be finite and positive`);
134
+ return value;
135
+ }
136
+
137
+ function finiteUnit(value: number, name: string): number {
138
+ if (!Number.isFinite(value) || value < 0 || value > 1)
139
+ throw new Error(`${name} must be finite and between 0 and 1`);
140
+ return value;
141
+ }
@@ -0,0 +1,86 @@
1
+ // The starter's painterly look: an ink outline, a Kuwahara smear, and a watercolour wash.
2
+ //
3
+ // This file exists because `worldEnvironment.ts` may not contain it. That file is the render-chain
4
+ // plumbing every kit copies verbatim, and `shared-render-sources.spec.ts` fails when one kit's copy
5
+ // stops matching the others — which is exactly what happens when a kit's own art direction is
6
+ // written into it. Bloom and vignette live in there because they are grading primitives every kit
7
+ // wants; kuwahara, outline and watercolour are one kit's aesthetic, and an aesthetic shipped into
8
+ // ten kits so that one can use it is the preset system the charter closed with evidence.
9
+ //
10
+ // So the plumbing exposes a seam — `authoredStageNames` and `authoredStages` — and this is what the
11
+ // starter passes through it.
12
+
13
+ import { createKuwaharaStage } from "./kuwahara.js";
14
+ import { createOutlineStage } from "./outline.js";
15
+ import { createWatercolorStage } from "./watercolor.js";
16
+ import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
17
+
18
+ /** The knobs the quality presets set. Every one is this kit's, not the framework's. */
19
+ export interface IPainterlyOptions {
20
+ readonly outlineEnabled?: boolean;
21
+ readonly outlineInkColor?: number;
22
+ readonly outlineStrength?: number;
23
+ readonly outlineThreshold?: number;
24
+ readonly outlineSoftness?: number;
25
+ readonly outlineDepthWeight?: number;
26
+ readonly kuwaharaEnabled?: boolean;
27
+ readonly kuwaharaRadius?: number;
28
+ readonly kuwaharaResolutionScale?: number;
29
+ readonly kuwaharaAnisotropy?: number;
30
+ readonly kuwaharaStrength?: number;
31
+ readonly watercolorEnabled?: boolean;
32
+ readonly watercolorLevels?: number;
33
+ readonly watercolorPaperStrength?: number;
34
+ readonly watercolorShadowStrength?: number;
35
+ readonly watercolorShadowTint?: number;
36
+ readonly watercolorStrength?: number;
37
+ }
38
+
39
+ /**
40
+ * Which stages run, in chain order.
41
+ *
42
+ * The chain reads this before the scene pass exists — with nothing requested it sets an exposure
43
+ * and never builds a pass at all — so it has to be answerable from the options alone.
44
+ */
45
+ export function painterlyStageNames(options: IPainterlyOptions): readonly string[] {
46
+ const names: string[] = [];
47
+ if (options.outlineEnabled === true) names.push("outline");
48
+ if (options.kuwaharaEnabled === true) names.push("kuwahara");
49
+ if (options.watercolorEnabled === true) names.push("watercolor");
50
+ return names;
51
+ }
52
+
53
+ /**
54
+ * The complete authored graph, dormant stages included.
55
+ *
56
+ * All three are always defined even when only one is requested, because `watercolor after
57
+ * kuwahara` and `kuwahara after outline` are anchors that must keep naming a stage that exists —
58
+ * otherwise enabling one stage on its own resolves against a name the chain never heard of.
59
+ */
60
+ export function painterlyStages(
61
+ options: IPainterlyOptions,
62
+ ): (context: IWorldEnvironmentStageContext) => readonly ChainStage[] {
63
+ return ({ depthNode }) => [
64
+ createOutlineStage({
65
+ depthNode,
66
+ depthWeight: options.outlineDepthWeight ?? 0.65,
67
+ inkColor: options.outlineInkColor ?? 0x142331,
68
+ softness: options.outlineSoftness ?? 0.16,
69
+ strength: options.outlineStrength ?? 0.8,
70
+ threshold: options.outlineThreshold ?? 0.12,
71
+ }),
72
+ createKuwaharaStage({
73
+ anisotropy: options.kuwaharaAnisotropy ?? 0.72,
74
+ radius: options.kuwaharaRadius ?? 5,
75
+ resolutionScale: options.kuwaharaResolutionScale ?? 0.5,
76
+ strength: options.kuwaharaStrength ?? 0.82,
77
+ }),
78
+ createWatercolorStage({
79
+ levels: options.watercolorLevels ?? 8,
80
+ paperStrength: options.watercolorPaperStrength ?? 0.2,
81
+ shadowStrength: options.watercolorShadowStrength ?? 0.16,
82
+ shadowTint: options.watercolorShadowTint ?? 0x6d5a52,
83
+ strength: options.watercolorStrength ?? 0.72,
84
+ }),
85
+ ];
86
+ }
@@ -1,9 +1,18 @@
1
1
  // Generated for you. Keep the six palette roles coherent when you change the look.
2
2
  export const palette = {
3
- skyHigh: 0x12324a,
4
- skyLow: 0x071018,
5
- floor: 0x12384a,
6
- player: 0x6fe8ff,
7
- crate: 0xffb86b,
8
- accent: 0xffd27a,
3
+ skyHigh: 0x8fd5cf,
4
+ skyLow: 0x28556a,
5
+ floor: 0x67c878,
6
+ player: 0xfff0b0,
7
+ crate: 0xd86f55,
8
+ accent: 0xe6c58d,
9
9
  } as const;
10
+
11
+ export const COAST_WAVES = [
12
+ { amplitude: 0.12, direction: [1, 0.2] as const, speed: 0.52, wavelength: 7.2 },
13
+ { amplitude: 0.055, detail: true, direction: [-0.35, 1] as const, speed: 0.3, wavelength: 3.3 },
14
+ ] as const;
15
+
16
+ export const COAST_DOMAIN_WARP = [
17
+ { amplitude: 0.12, direction: [0.65, -0.35] as const, speed: 0.18, wavelength: 11 },
18
+ ] as const;
@@ -0,0 +1,54 @@
1
+ // Generated for you. This is ordinary Three.js geometry — edit or delete it freely.
2
+ import { BufferGeometry, Float32BufferAttribute, Vector2, Vector3 } from "three";
3
+
4
+ const DIVISIONS = 8;
5
+
6
+ /** Preserve an authored triangle's silhouette and UVs while giving cloth enough vertices to bend. */
7
+ export function tessellatePennant(source: BufferGeometry): BufferGeometry {
8
+ const position = source.getAttribute("position");
9
+ const uv = source.getAttribute("uv");
10
+ if (position === undefined || position.count !== 3)
11
+ throw new Error("Starter pennant must be one authored triangle.");
12
+ if (uv === undefined || uv.count !== 3) throw new Error("Starter pennant must have three UVs.");
13
+ const corners = [0, 1, 2].map(
14
+ (index) => new Vector3(position.getX(index), position.getY(index), position.getZ(index)),
15
+ );
16
+ const texels = [0, 1, 2].map((index) => new Vector2(uv.getX(index), uv.getY(index)));
17
+ const positions: number[] = [];
18
+ const uvs: number[] = [];
19
+ const emit = (row: number, column: number): void => {
20
+ const alongB = row / DIVISIONS;
21
+ const alongC = column / DIVISIONS;
22
+ const alongA = 1 - alongB - alongC;
23
+ const a = corners[0] as Vector3;
24
+ const b = corners[1] as Vector3;
25
+ const c = corners[2] as Vector3;
26
+ const uvA = texels[0] as Vector2;
27
+ const uvB = texels[1] as Vector2;
28
+ const uvC = texels[2] as Vector2;
29
+ positions.push(
30
+ a.x * alongA + b.x * alongB + c.x * alongC,
31
+ a.y * alongA + b.y * alongB + c.y * alongC,
32
+ a.z * alongA + b.z * alongB + c.z * alongC,
33
+ );
34
+ uvs.push(
35
+ uvA.x * alongA + uvB.x * alongB + uvC.x * alongC,
36
+ uvA.y * alongA + uvB.y * alongB + uvC.y * alongC,
37
+ );
38
+ };
39
+ for (let row = 0; row < DIVISIONS; row += 1) {
40
+ for (let column = 0; column < DIVISIONS - row; column += 1) {
41
+ emit(row, column);
42
+ emit(row + 1, column);
43
+ emit(row, column + 1);
44
+ if (row + column >= DIVISIONS - 1) continue;
45
+ emit(row + 1, column);
46
+ emit(row + 1, column + 1);
47
+ emit(row, column + 1);
48
+ }
49
+ }
50
+ const geometry = new BufferGeometry();
51
+ geometry.setAttribute("position", new Float32BufferAttribute(positions, 3));
52
+ geometry.setAttribute("uv", new Float32BufferAttribute(uvs, 2));
53
+ return geometry;
54
+ }
@@ -1,18 +1,100 @@
1
1
  // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
- import { ACESFilmicToneMapping, type Camera, type Scene } from "three";
3
- import { bloom } from "three/addons/tsl/display/BloomNode.js";
4
- import { pass } from "three/tsl";
5
- type OutputRenderer = {
6
- kind: string;
7
- raw: unknown;
8
- setOutputNode(node: unknown): void;
9
- };
2
+ //
3
+ // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
+ // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
+ // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
+ // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
+ // one you turned off.
8
+ //
9
+ // To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
10
+ // run — a desktop that is dropping frames, a capture you want to compare — pass it:
11
+ // `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
12
+ // `TN_QUALITY_TIER` names the tier that ran either way.
13
+ import type { Camera, DirectionalLight, Scene } from "three";
14
+ import {
15
+ type IAdaptiveQualityOptions,
16
+ type IQualityWindow,
17
+ createAdaptiveQuality,
18
+ formatQualityAdaptation,
19
+ } from "./adaptiveQuality.js";
20
+ import { painterlyStageNames, painterlyStages } from "./painterly.js";
21
+ import { type QualityTier, qualityPreset } from "./quality.js";
22
+ import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
10
23
 
11
- export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
12
- const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
13
- raw.toneMapping = ACESFilmicToneMapping;
14
- raw.toneMappingExposure = 1.15;
15
- if (renderer.kind !== "webgpu") return;
16
- const colour = pass(scene, camera).getTextureNode();
17
- renderer.setOutputNode(colour.add(bloom(colour, 0.7, 0.5, 0.2)));
24
+ interface IPostController {
25
+ debug(): Record<string, unknown>;
26
+ observe(window: IQualityWindow): void;
27
+ dispose(): void;
28
+ }
29
+
30
+ let active: IPostController | undefined;
31
+
32
+ /** The starter's game.ts connects its existing completed frame-window callback here. */
33
+ export function observeQualityWindow(window: IQualityWindow): void {
34
+ active?.observe(window);
35
+ }
36
+
37
+ export function setupPost(
38
+ renderer: OutputRenderer,
39
+ scene: Scene,
40
+ camera: Camera,
41
+ environment: IAdaptiveQualityOptions & {
42
+ godraysLight?: DirectionalLight;
43
+ mobile?: boolean;
44
+ /** Forces a tier while keeping its costs observed. Unknown names throw. */
45
+ tier?: QualityTier;
46
+ } = {},
47
+ ): IPostController {
48
+ const policy = createAdaptiveQuality(environment, environment);
49
+ active?.dispose();
50
+ let disposed = false;
51
+ let disposeGraph: (() => void) | undefined;
52
+ let observation: Record<string, unknown> = {
53
+ tier: policy.tier,
54
+ source: policy.pinned ? "pinned" : "auto",
55
+ };
56
+ function apply(): void {
57
+ // Replacement is serialized: no old graph or subscription remains alive beside the new one.
58
+ disposeGraph?.();
59
+ const settings = qualityPreset(policy.tier);
60
+ const world = new WorldEnvironment({
61
+ ...settings,
62
+ authoredStageNames: painterlyStageNames(settings),
63
+ authoredStages: painterlyStages(settings),
64
+ });
65
+ const applied = world.apply(renderer, scene, camera, {
66
+ godraysLight: environment.godraysLight,
67
+ });
68
+ disposeGraph = applied.dispose;
69
+ observation = { ...observation, stages: applied.stages, dropped: applied.dropped };
70
+ }
71
+ apply();
72
+ const source = environment.tier === undefined ? "platform" : "override";
73
+ console.info(
74
+ `TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} source=${source}`,
75
+ );
76
+ const controller = {
77
+ debug: () => observation,
78
+ observe(window: IQualityWindow): void {
79
+ if (disposed) return;
80
+ const decision = policy.observe(window);
81
+ if (decision.changed) apply();
82
+ observation = {
83
+ stages: observation.stages,
84
+ dropped: observation.dropped,
85
+ ...decision,
86
+ ...(Number.isInteger(window.window) ? { window: window.window } : {}),
87
+ };
88
+ console.info(formatQualityAdaptation(decision));
89
+ },
90
+ dispose(): void {
91
+ if (disposed) return;
92
+ disposed = true;
93
+ disposeGraph?.();
94
+ disposeGraph = undefined;
95
+ if (active === controller) active = undefined;
96
+ },
97
+ };
98
+ active = controller;
99
+ return controller;
18
100
  }
@@ -0,0 +1,185 @@
1
+ // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
+ // it freely — the tiers below are a starting point, not a framework look.
3
+ //
4
+ // This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
5
+ // `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
6
+ // file to edit rather than a hunt through anonymous literals.
7
+ //
8
+ // **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
9
+ // ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
10
+ // on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
11
+ // scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
12
+ // with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
13
+ // removes the denoise passes the later stages sample — so read each as *what turning this one off
14
+ // gave back*, not as a share of a partition. A stage nobody has ablated on its own says
15
+ // `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
16
+ // back after you change a tier.
17
+ //
18
+ // One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
19
+ // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
+ // in `sky.ts`, not in this file.
21
+ //
22
+ import type { IPainterlyOptions } from "./painterly.js";
23
+ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
24
+
25
+ /**
26
+ * A preset is the framework's chain options plus this kit's own painterly knobs. The two are
27
+ * separate types because they belong to different layers: `worldEnvironment.ts` is shared with
28
+ * every other kit and must not know what a watercolour is.
29
+ */
30
+ type QualitySettings = IWorldEnvironmentOptions & IPainterlyOptions;
31
+
32
+ /**
33
+ * The three names this game's look comes in.
34
+ *
35
+ * `low` is what a phone gets and `high` what a desktop gets — those two are this template's
36
+ * shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
37
+ * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
38
+ * what any of them mean.
39
+ */
40
+ export type QualityTier = "low" | "medium" | "high";
41
+
42
+ const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
43
+
44
+ /**
45
+ * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
46
+ * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
47
+ */
48
+ function isQualityTier(value: string): value is QualityTier {
49
+ return (QUALITY_TIERS as readonly string[]).includes(value);
50
+ }
51
+
52
+ /**
53
+ * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
54
+ *
55
+ * Fails closed. An unrecognised tier name throws with the value it was handed rather than
56
+ * quietly rendering the default, because a silent fallback here looks exactly like a tier that
57
+ * turned out to have no effect.
58
+ */
59
+ export function resolveQualityTier(
60
+ request: { readonly mobile?: boolean; readonly tier?: string } = {},
61
+ ): QualityTier {
62
+ const requested = request.tier;
63
+ if (requested !== undefined) {
64
+ if (!isQualityTier(requested)) {
65
+ throw new Error(
66
+ `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
67
+ );
68
+ }
69
+ return requested;
70
+ }
71
+ return request.mobile === true ? "low" : "high";
72
+ }
73
+
74
+ /**
75
+ * What a desktop gets: a clean coastal look with restrained painterly treatment. The expensive
76
+ * screen-space gathers are deliberately off here: on a small water scene they muddy the grass and
77
+ * turn the water glint into a halo instead of adding useful depth.
78
+ */
79
+ const high: QualitySettings = {
80
+ // Bloom cost: unmeasured for this authored scene; the low strength keeps water glints alive
81
+ // without washing the scene in orange.
82
+ bloomEnabled: true,
83
+ bloomRadius: 0.34,
84
+ bloomStrength: 0.26,
85
+ bloomThreshold: 0.64,
86
+ denoiseEnabled: false,
87
+ exposure: 1.04,
88
+ ssgiEnabled: false,
89
+ ssrEnabled: false,
90
+ sharpenEnabled: false,
91
+ // Outline cost: unmeasured; it is intentionally a soft blue-green edge, not a black
92
+ // comic-book stroke.
93
+ outlineEnabled: true,
94
+ outlineDepthWeight: 0.32,
95
+ outlineInkColor: 0x173c4a,
96
+ outlineSoftness: 0.08,
97
+ outlineStrength: 0.3,
98
+ outlineThreshold: 0.2,
99
+ // Kuwahara cost: unmeasured; the half-resolution scratch and restrained strength preserve
100
+ // readable grass silhouettes.
101
+ kuwaharaEnabled: true,
102
+ kuwaharaRadius: 5,
103
+ kuwaharaResolutionScale: 0.5,
104
+ kuwaharaStrength: 0.2,
105
+ // Watercolour cost: unmeasured; the low mix keeps the paper grouping from flattening the coast.
106
+ watercolorEnabled: true,
107
+ watercolorPaperStrength: 0.05,
108
+ watercolorShadowStrength: 0.04,
109
+ watercolorShadowTint: 0x7d6b62,
110
+ watercolorStrength: 0.26,
111
+ renderChainTier: "high",
112
+ tonemapMode: "aces",
113
+ };
114
+
115
+ /**
116
+ * Medium keeps the same readable coast, with a smaller paint radius and a little less colour
117
+ * grouping for machines that need a cheaper frame.
118
+ */
119
+ const medium: QualitySettings = {
120
+ // Bloom cost: unmeasured for this authored scene; keep only a small highlight lift.
121
+ bloomEnabled: true,
122
+ bloomRadius: 0.3,
123
+ bloomStrength: 0.22,
124
+ bloomThreshold: 0.68,
125
+ denoiseEnabled: false,
126
+ exposure: 1.03,
127
+ ssgiEnabled: false,
128
+ ssrEnabled: false,
129
+ sharpenEnabled: false,
130
+ // Outline cost: unmeasured; keep its edge narrow on the cheaper tier.
131
+ outlineEnabled: true,
132
+ outlineDepthWeight: 0.28,
133
+ outlineInkColor: 0x173c4a,
134
+ outlineSoftness: 0.08,
135
+ outlineStrength: 0.26,
136
+ outlineThreshold: 0.22,
137
+ // Kuwahara cost: unmeasured; radius three keeps the water and grass readable.
138
+ kuwaharaEnabled: true,
139
+ kuwaharaRadius: 3,
140
+ kuwaharaResolutionScale: 0.5,
141
+ kuwaharaStrength: 0.16,
142
+ // Watercolour cost: unmeasured; fewer bands and a low mix preserve the coast's value steps.
143
+ watercolorEnabled: true,
144
+ watercolorLevels: 6,
145
+ watercolorPaperStrength: 0.04,
146
+ watercolorShadowStrength: 0.03,
147
+ watercolorShadowTint: 0x7d6b62,
148
+ watercolorStrength: 0.22,
149
+ renderChainTier: "medium",
150
+ tonemapMode: "aces",
151
+ };
152
+
153
+ /**
154
+ * What a phone gets: the cleanest version of the coastal look. Authored paint is omitted to keep
155
+ * the water mesh and touch controls responsive.
156
+ */
157
+ const low: QualitySettings = {
158
+ // Bloom cost: unmeasured for this authored scene; this is the phone-safe highlight lift.
159
+ bloomEnabled: true,
160
+ bloomRadius: 0.28,
161
+ bloomStrength: 0.18,
162
+ bloomThreshold: 0.72,
163
+ exposure: 1.02,
164
+ sharpenEnabled: false,
165
+ // The low tier omits authored paint by name: no outline, scratch target, or paper graph is
166
+ // built on the phone path.
167
+ outlineEnabled: false,
168
+ kuwaharaEnabled: false,
169
+ watercolorEnabled: false,
170
+ renderChainTier: "low",
171
+ tonemapMode: "aces",
172
+ };
173
+
174
+ const QUALITY_PRESETS: Record<QualityTier, QualitySettings> = { high, low, medium };
175
+
176
+ /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
177
+ export function qualityPreset(tier: string): QualitySettings {
178
+ const preset = QUALITY_PRESETS[tier as QualityTier];
179
+ if (preset === undefined) {
180
+ throw new Error(
181
+ `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
182
+ );
183
+ }
184
+ return preset;
185
+ }