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
@@ -11,7 +11,7 @@ function refused(name, diagnostic) {
11
11
  }, {
12
12
  apply: fail,
13
13
  construct: fail,
14
- get: fail,
14
+ get: (target, key) => key === "prototype" ? target.prototype : fail(),
15
15
  set: fail,
16
16
  has: fail,
17
17
  ownKeys: fail,
@@ -25,6 +25,17 @@ function unsupportedExport(name) {
25
25
  return refused(name, `TN_NATIVE_UNSUPPORTED_${name.toUpperCase()}`);
26
26
  }
27
27
 
28
+ // ../three-native/src/gpu-stages.ts
29
+ var GPU_STAGES = ["SSGI"];
30
+ function gpuStageId(name) {
31
+ const index = GPU_STAGES.indexOf(name);
32
+ if (index < 0)
33
+ throw new TypeError(
34
+ `TN_GPU_STAGE: unknown stage ${String(name)}; the engine times ${GPU_STAGES.join(", ")}`
35
+ );
36
+ return index + 1;
37
+ }
38
+
28
39
  // ../three-native/src/addons/post-effects.ts
29
40
  function uniforms(node, names) {
30
41
  for (const name of names)
@@ -41,8 +52,104 @@ function uniforms(node, names) {
41
52
  });
42
53
  return node;
43
54
  }
55
+ function scaled(node) {
56
+ return Object.defineProperty(node, "resolutionScale", {
57
+ configurable: true,
58
+ get: () => node.__effect("resolutionScale"),
59
+ set: (value) => {
60
+ node.__effect("resolutionScale", value);
61
+ }
62
+ });
63
+ }
64
+ function stageLabel(node) {
65
+ return Object.defineProperty(node, "gpuStage", {
66
+ configurable: true,
67
+ get: () => GPU_STAGES[node.__effect("stage") - 1],
68
+ set: (name) => {
69
+ node.__effect("stage", gpuStageId(name));
70
+ }
71
+ });
72
+ }
73
+ var SSR_REFUSED_DEFAULTS = {
74
+ stochastic: false,
75
+ envImportanceSampling: false,
76
+ environmentNode: null,
77
+ diffuseNode: null
78
+ };
79
+ function validateSsrOptions(options) {
80
+ if (options === null || typeof options !== "object")
81
+ throw new TypeError("TN_NATIVE_SSR_OPTIONS: expected an options object");
82
+ for (const [name, value] of Object.entries(options)) {
83
+ if (["camera", "metalnessNode", "roughnessNode"].includes(name)) continue;
84
+ if (["reflectNonMetals", "binaryRefine"].includes(name)) {
85
+ if (typeof value !== "boolean")
86
+ throw new TypeError(`TN_NATIVE_SSR_OPTIONS: ${name} must be boolean`);
87
+ continue;
88
+ }
89
+ if (Object.hasOwn(SSR_REFUSED_DEFAULTS, name) && value === SSR_REFUSED_DEFAULTS[name]) continue;
90
+ throw new Error(`TN_NATIVE_SSR_UNSUPPORTED: ${name}`);
91
+ }
92
+ }
44
93
  function definePostEffects(tsl) {
45
94
  return {
95
+ ssr(color, depth, normal, options = {}) {
96
+ validateSsrOptions(options);
97
+ const camera = options.camera ?? color?.passNode?.camera;
98
+ if (camera == null) throw new Error("TN_NATIVE_SSR_CAMERA: ssr() requires a camera");
99
+ const node = uniforms(
100
+ tsl.ssr(color, depth, normal, options.metalnessNode ?? null, options.roughnessNode ?? null),
101
+ [
102
+ "maxDistance",
103
+ "thickness",
104
+ "opacity",
105
+ "quality",
106
+ "maxSteps",
107
+ "intensity",
108
+ "maxLuminance",
109
+ "blurQuality"
110
+ ]
111
+ );
112
+ const blurQuality = Object.getOwnPropertyDescriptor(node, "blurQuality")?.value;
113
+ Object.defineProperty(node, "blurQuality", {
114
+ configurable: true,
115
+ get: () => blurQuality,
116
+ set: (value) => node.__effect("blurQuality", value)
117
+ });
118
+ for (const name of ["reflectNonMetals", "binaryRefine"]) {
119
+ node.__effect(name, Number(options[name] ?? false));
120
+ Object.defineProperty(node, name, {
121
+ configurable: true,
122
+ get: () => node.__effect(name) !== 0,
123
+ set: (value) => node.__effect(name, Number(value))
124
+ });
125
+ }
126
+ Object.defineProperty(node, "resolutionScale", {
127
+ configurable: true,
128
+ get: () => node.__effect("resolutionScale"),
129
+ set: (value) => node.__effect("resolutionScale", value)
130
+ });
131
+ for (const [name, value] of Object.entries({
132
+ ...SSR_REFUSED_DEFAULTS,
133
+ historyTexture: null,
134
+ velocityTexture: null,
135
+ screenEdgeFadeBlack: false
136
+ }))
137
+ Object.defineProperty(node, name, {
138
+ configurable: true,
139
+ get: () => value,
140
+ set: () => {
141
+ throw new Error(`TN_NATIVE_SSR_UNSUPPORTED: ${name}`);
142
+ }
143
+ });
144
+ for (const name of ["setHistory", "setEnvMap"])
145
+ Object.defineProperty(node, name, {
146
+ value: () => {
147
+ throw new Error(`TN_NATIVE_SSR_UNSUPPORTED: ${name}`);
148
+ }
149
+ });
150
+ node.getTextureNode = () => node;
151
+ return node;
152
+ },
46
153
  film: (input, intensity, uv) => tsl.film(input, intensity, uv),
47
154
  lut3D: (input, lut, size, intensity) => uniforms(tsl.lut3D(input, lut, size, intensity), ["size"]),
48
155
  traa(input, depth, velocity, camera) {
@@ -120,31 +227,30 @@ function definePostEffects(tsl) {
120
227
  ao(depthNode, normalNode, camera) {
121
228
  const node = uniforms(tsl.ao(depthNode, normalNode ?? null, camera), [
122
229
  "radius",
230
+ "reachPx",
123
231
  "thickness",
124
232
  "distanceExponent",
125
233
  "distanceFallOff",
126
234
  "scale",
127
235
  "samples"
128
236
  ]);
129
- Object.defineProperty(node, "resolutionScale", {
130
- configurable: true,
131
- get() {
132
- return node.__effect("resolutionScale");
133
- },
134
- set(value) {
135
- node.__effect("resolutionScale", value);
136
- }
137
- });
237
+ scaled(node);
138
238
  node.getTextureNode = () => node;
139
239
  return node;
140
240
  },
141
- denoise: (node, depthNode, normalNode, camera) => uniforms(tsl.denoise(node, depthNode, normalNode ?? null, camera), [
142
- "lumaPhi",
143
- "depthPhi",
144
- "normalPhi",
145
- "radius",
146
- "index"
147
- ]),
241
+ // The filter pass's target size, as on ao(): Unreal filters GTAO at the AO resolution
242
+ // (UE 5.8.3: Engine/Shaders/Private/PostProcessAmbientOcclusion.usf:1600-1602).
243
+ denoise: (node, depthNode, normalNode, camera) => scaled(
244
+ stageLabel(
245
+ uniforms(tsl.denoise(node, depthNode, normalNode ?? null, camera), [
246
+ "lumaPhi",
247
+ "depthPhi",
248
+ "normalPhi",
249
+ "radius",
250
+ "index"
251
+ ])
252
+ )
253
+ ),
148
254
  smaa: (node) => tsl.smaa(node),
149
255
  bloom: (node, strength, radius, threshold) => uniforms(tsl.bloom(node, strength, radius, threshold), [
150
256
  "strength",
@@ -155,14 +261,534 @@ function definePostEffects(tsl) {
155
261
  };
156
262
  }
157
263
 
264
+ // ../three-native/src/addons/screen-space.ts
265
+ var HALF_FLOAT_TYPE = 1016;
266
+ var GI_STAGE = "SSGI";
267
+ var STEPS = 48;
268
+ var REFINEMENTS = 5;
269
+ var MAX_LUMINANCE = 10;
270
+ function defineCameraMapping(tsl, camera, owner) {
271
+ const { float, uniform, vec2, vec3 } = tsl;
272
+ if (camera?.projectionMatrix === void 0)
273
+ throw new TypeError(
274
+ `TN_NATIVE_${owner.toUpperCase()}_CAMERA: ${owner} needs options.camera, the camera the scene pass draws with`
275
+ );
276
+ const live = (read) => uniform(read()).onRenderUpdate(read);
277
+ const term = (index) => live(() => camera.projectionMatrix.elements[index] ?? 0);
278
+ const cameraNear = live(() => camera.near);
279
+ const column0 = { x: term(0) };
280
+ const column1 = { y: term(5) };
281
+ const column2 = { x: term(8), y: term(9), z: term(10) };
282
+ const column3 = { z: term(14) };
283
+ const viewZ = (depth) => column3.z.negate().div(depth.add(column2.z));
284
+ const viewPosition = (coordinate, depth) => {
285
+ const z = viewZ(depth);
286
+ const ndcX = coordinate.x.mul(2).sub(1);
287
+ const ndcY = float(1).sub(coordinate.y).mul(2).sub(1);
288
+ return vec3(
289
+ z.negate().mul(ndcX.add(column2.x)).div(column0.x),
290
+ z.negate().mul(ndcY.add(column2.y)).div(column1.y),
291
+ z
292
+ );
293
+ };
294
+ const project = (position) => {
295
+ const w = position.z.negate();
296
+ const ndcX = position.x.mul(column0.x).add(position.z.mul(column2.x)).div(w);
297
+ const ndcY = position.y.mul(column1.y).add(position.z.mul(column2.y)).div(w);
298
+ return vec2(ndcX.mul(0.5).add(0.5), float(0.5).sub(ndcY.mul(0.5)));
299
+ };
300
+ return { cameraNear, viewZ, viewPosition, project };
301
+ }
302
+ function defineScreenSpaceReflections(tsl) {
303
+ return function ssr2(colorNode, depthNode, normalNode, options) {
304
+ const { Break, Fn, If, Loop, clamp, dot, float, int } = tsl;
305
+ const { max, min, mix, normalize, reflect, rtt, smoothstep, uniform, uv, vec2, vec3, vec4 } = tsl;
306
+ const maxDistance = uniform(1);
307
+ const thickness = uniform(0.1);
308
+ const intensity = uniform(1);
309
+ const screenEdgeFade = uniform(0.2);
310
+ const maxSteps = uniform(STEPS);
311
+ const maxRoughness = uniform(1);
312
+ const roughness = options.roughnessNode ?? float(0);
313
+ const metalness = options.metalnessNode ?? float(0);
314
+ const { cameraNear, viewZ, viewPosition, project } = defineCameraMapping(
315
+ tsl,
316
+ options.camera,
317
+ "ssr"
318
+ );
319
+ const graph = Fn(() => {
320
+ const coordinate = uv();
321
+ const result = vec4(0, 0, 0, 0).toVar();
322
+ const centreDepth = depthNode.sample(coordinate).r;
323
+ If(centreDepth.lessThan(1).and(roughness.lessThan(maxRoughness)), () => {
324
+ const position = viewPosition(coordinate, centreDepth);
325
+ const normal = normalize(normalNode.sample(coordinate).xyz);
326
+ const incident = normalize(position);
327
+ const direction = normalize(reflect(incident, normal));
328
+ const origin = position.add(normal.mul(max(0.01, position.z.negate().mul(4e-3))));
329
+ const hitCoordinate = vec2(0, 0).toVar();
330
+ const hitDistance = float(-1).toVar();
331
+ const previous = float(0).toVar();
332
+ const previousBehind = float(-1).toVar();
333
+ const previousSceneZ = position.z.toVar();
334
+ Loop({ start: int(0), end: int(STEPS), type: "int", condition: "<" }, ({ i }) => {
335
+ If(float(i).greaterThanEqual(maxSteps), () => {
336
+ Break();
337
+ });
338
+ const fraction = float(i).add(1).div(min(maxSteps, STEPS));
339
+ const travelled = maxDistance.mul(fraction.mul(fraction));
340
+ const point = origin.add(direction.mul(travelled));
341
+ If(point.z.greaterThan(cameraNear.negate()), () => {
342
+ Break();
343
+ });
344
+ const screen = project(point);
345
+ If(
346
+ screen.x.lessThan(0).or(screen.x.greaterThan(1)).or(screen.y.lessThan(0)).or(screen.y.greaterThan(1)),
347
+ () => {
348
+ Break();
349
+ }
350
+ );
351
+ const sceneDepth = depthNode.sample(screen).r;
352
+ const sceneZ = viewZ(sceneDepth);
353
+ const behind = sceneZ.sub(point.z);
354
+ const slice = travelled.sub(previous);
355
+ const drop = sceneZ.sub(previousSceneZ).abs();
356
+ const slack = drop.lessThan(sceneZ.abs().mul(0.15)).select(drop, float(0));
357
+ If(
358
+ sceneDepth.lessThan(1).and(behind.greaterThan(0)).and(previousBehind.lessThanEqual(0)).and(behind.lessThan(thickness.add(slice.mul(direction.z.abs())).add(slack))),
359
+ () => {
360
+ const low = previous.toVar();
361
+ const high = travelled.toVar();
362
+ Loop({ start: int(0), end: int(REFINEMENTS), type: "int", condition: "<" }, () => {
363
+ const middle = low.add(high).mul(0.5);
364
+ const middleScreen = project(origin.add(direction.mul(middle)));
365
+ const middleDepth = viewZ(depthNode.sample(middleScreen).r).sub(
366
+ origin.add(direction.mul(middle)).z
367
+ );
368
+ If(middleDepth.greaterThan(0), () => {
369
+ high.assign(middle);
370
+ }).Else(() => {
371
+ low.assign(middle);
372
+ });
373
+ });
374
+ hitDistance.assign(high);
375
+ hitCoordinate.assign(project(origin.add(direction.mul(high))));
376
+ Break();
377
+ }
378
+ );
379
+ previous.assign(travelled);
380
+ previousBehind.assign(behind);
381
+ previousSceneZ.assign(sceneZ);
382
+ });
383
+ If(hitDistance.greaterThanEqual(0), () => {
384
+ const reach = roughness.mul(0.03);
385
+ const tap = (offset) => colorNode.sample(hitCoordinate.add(offset)).rgb;
386
+ const hit = tap(vec2(0, 0)).add(tap(vec2(reach, 0))).add(tap(vec2(reach.negate(), 0))).add(tap(vec2(0, reach))).add(tap(vec2(0, reach.negate()))).mul(0.2).min(vec3(MAX_LUMINANCE, MAX_LUMINANCE, MAX_LUMINANCE));
387
+ const hitNormal = normalize(normalNode.sample(hitCoordinate).xyz);
388
+ const facing = smoothstep(0.25, -0.05, dot(hitNormal, direction));
389
+ const edge = min(
390
+ min(
391
+ smoothstep(0, screenEdgeFade, hitCoordinate.x),
392
+ smoothstep(0, screenEdgeFade, float(1).sub(hitCoordinate.x))
393
+ ),
394
+ min(
395
+ smoothstep(0, screenEdgeFade, hitCoordinate.y),
396
+ smoothstep(0, screenEdgeFade, float(1).sub(hitCoordinate.y))
397
+ )
398
+ );
399
+ const reach01 = hitDistance.div(maxDistance);
400
+ const distance = float(1).sub(smoothstep(0.5, 1, reach01));
401
+ const weight = facing.mul(edge).mul(distance).mul(intensity);
402
+ const facingView = clamp(dot(normal, incident.negate()), 0, 1);
403
+ const fresnel = float(0.04).add(float(0.96).mul(float(1).sub(facingView).pow(5)));
404
+ const base = colorNode.sample(coordinate).rgb;
405
+ const dielectric = hit.mul(fresnel).mul(options.reflectNonMetals === true ? 1 : 0);
406
+ const delta = mix(dielectric, hit.sub(base), clamp(metalness, 0, 1));
407
+ result.assign(vec4(delta.mul(weight), 0));
408
+ });
409
+ });
410
+ return result;
411
+ })();
412
+ const node = rtt(graph, null, null, { type: HALF_FLOAT_TYPE });
413
+ return Object.defineProperties(node, {
414
+ maxDistance: { value: maxDistance },
415
+ thickness: { value: thickness },
416
+ intensity: { value: intensity },
417
+ screenEdgeFade: { value: screenEdgeFade },
418
+ maxSteps: { value: maxSteps },
419
+ maxRoughness: { value: maxRoughness },
420
+ resolutionScale: {
421
+ get: () => node.getResolutionScale(),
422
+ set: (value) => node.setResolutionScale(value)
423
+ }
424
+ });
425
+ };
426
+ }
427
+ function defineGiTrace(tsl, scene) {
428
+ const { Break, If, Loop, float, int, max, min, smoothstep, vec2, vec3 } = tsl;
429
+ const { colorNode, depthNode, normalNode } = scene;
430
+ const { cameraNear, viewZ, project } = scene.mapping;
431
+ const { radius, screenEdgeFade, stepCount, thickness } = scene.uniforms;
432
+ const march = (origin, direction, startZ) => {
433
+ const hitCoordinate = vec2(0, 0).toVar();
434
+ const hitDistance = float(-1).toVar();
435
+ const previous = float(0).toVar();
436
+ const previousBehind = float(-1).toVar();
437
+ const previousSceneZ = startZ.toVar();
438
+ Loop({ start: int(0), end: int(GI_MAX_STEPS), type: "int", condition: "<" }, ({ i: step }) => {
439
+ If(float(step).greaterThanEqual(stepCount), () => {
440
+ Break();
441
+ });
442
+ const fraction = float(step).add(1).div(stepCount);
443
+ const travelled = radius.mul(fraction.mul(fraction));
444
+ const point = origin.add(direction.mul(travelled));
445
+ If(point.z.greaterThan(cameraNear.negate()), () => {
446
+ Break();
447
+ });
448
+ const screen = project(point);
449
+ If(
450
+ screen.x.lessThan(0).or(screen.x.greaterThan(1)).or(screen.y.lessThan(0)).or(screen.y.greaterThan(1)),
451
+ () => {
452
+ Break();
453
+ }
454
+ );
455
+ const sceneDepth = depthNode.sample(screen).r;
456
+ const sceneZ = viewZ(sceneDepth);
457
+ const behind = sceneZ.sub(point.z);
458
+ const slice = travelled.sub(previous);
459
+ const drop = sceneZ.sub(previousSceneZ).abs();
460
+ const slack = drop.lessThan(sceneZ.abs().mul(0.15)).select(drop, float(0));
461
+ const reach = sceneZ.abs().mul(thickness).add(slice.mul(direction.z.abs())).add(slack);
462
+ If(
463
+ sceneDepth.lessThan(1).and(behind.greaterThan(0)).and(previousBehind.lessThanEqual(0)).and(behind.lessThan(reach)),
464
+ () => {
465
+ hitCoordinate.assign(screen);
466
+ hitDistance.assign(travelled);
467
+ Break();
468
+ }
469
+ );
470
+ previous.assign(travelled);
471
+ previousBehind.assign(behind);
472
+ previousSceneZ.assign(sceneZ);
473
+ });
474
+ return { hitCoordinate, hitDistance };
475
+ };
476
+ const shade = (hitCoordinate, hitDistance, direction) => {
477
+ const hitNormal = normalNode.sample(hitCoordinate).xyz;
478
+ const hitLength = hitNormal.dot(hitNormal).sqrt();
479
+ const facing = hitLength.greaterThan(0.5).select(
480
+ smoothstep(0.25, -0.05, hitNormal.dot(direction).div(max(hitLength, float(1e-4)))),
481
+ float(1)
482
+ );
483
+ const edge = min(
484
+ min(
485
+ smoothstep(0, screenEdgeFade, hitCoordinate.x),
486
+ smoothstep(0, screenEdgeFade, float(1).sub(hitCoordinate.x))
487
+ ),
488
+ min(
489
+ smoothstep(0, screenEdgeFade, hitCoordinate.y),
490
+ smoothstep(0, screenEdgeFade, float(1).sub(hitCoordinate.y))
491
+ )
492
+ );
493
+ const reachFade = float(1).sub(smoothstep(0.5, 1, hitDistance.div(radius)));
494
+ const weight = facing.mul(edge).mul(reachFade);
495
+ const radiance = colorNode.sample(hitCoordinate).rgb.min(vec3(GI_MAX_LUMINANCE, GI_MAX_LUMINANCE, GI_MAX_LUMINANCE));
496
+ return { radiance, weight };
497
+ };
498
+ return { march, shade };
499
+ }
500
+ var SCREEN_PROBE_PASSES = ["trace", "filter", "gather"];
501
+ var IRRADIANCE_SIDE = 6;
502
+ var RAYS_PER_SLICE = 4;
503
+ var GI_MAX_STEPS = 24;
504
+ var GI_MAX_LUMINANCE = 40;
505
+ function defineScreenSpaceGi(tsl) {
506
+ return function ssgi2(colorNode, depthNode, normalNode, cameraOrOptions) {
507
+ const { Break, Fn, If, Loop, float, int, max, min, normalize, rtt, smoothstep, uniform, uv } = tsl;
508
+ const { vec2, vec3, vec4 } = tsl;
509
+ const options = "camera" in cameraOrOptions ? cameraOrOptions : { camera: cameraOrOptions };
510
+ const mapping = defineCameraMapping(tsl, options.camera, "ssgi");
511
+ const { viewPosition } = mapping;
512
+ const radius = uniform(12);
513
+ const thickness = uniform(0.02);
514
+ const sliceCount = uniform(2);
515
+ const stepCount = uniform(12);
516
+ const intensity = uniform(1);
517
+ const screenEdgeFade = uniform(0.1);
518
+ const probeJitter = uniform(1);
519
+ const probeDebug = uniform(0);
520
+ const { march, shade } = defineGiTrace(tsl, {
521
+ colorNode,
522
+ depthNode,
523
+ mapping,
524
+ normalNode,
525
+ uniforms: { radius, screenEdgeFade, stepCount, thickness }
526
+ });
527
+ if (options.probes !== void 0) {
528
+ const node2 = defineScreenProbes(tsl, {
529
+ depthNode,
530
+ mapping,
531
+ march,
532
+ normalNode,
533
+ options,
534
+ probes: options.probes,
535
+ shade,
536
+ uniform: { intensity, jitter: probeJitter, debug: probeDebug }
537
+ });
538
+ return Object.defineProperties(node2, {
539
+ ...Object.fromEntries(
540
+ Object.entries({
541
+ radius,
542
+ thickness,
543
+ sliceCount,
544
+ stepCount,
545
+ intensity,
546
+ screenEdgeFade,
547
+ probeJitter,
548
+ probeDebug
549
+ }).map(([name, value]) => [name, { value }])
550
+ ),
551
+ getGINode: { value: () => node2 },
552
+ getAONode: { value: () => tsl.vec4(1, 1, 1, 1) },
553
+ resolutionScale: {
554
+ get: () => node2.getResolutionScale(),
555
+ set: (value) => node2.setResolutionScale(value)
556
+ }
557
+ });
558
+ }
559
+ const graph = Fn(() => {
560
+ const coordinate = uv();
561
+ const result = vec4(0, 0, 0, 0).toVar();
562
+ const centreDepth = depthNode.sample(coordinate).r;
563
+ const centreNormal = normalNode.sample(coordinate).xyz;
564
+ If(centreDepth.lessThan(1).and(centreNormal.dot(centreNormal).greaterThan(0.25)), () => {
565
+ const position = viewPosition(coordinate, centreDepth);
566
+ const normal = normalize(centreNormal);
567
+ const fallback = options.fallback?.(position, normal) ?? vec3(0, 0, 0);
568
+ const helper = normal.y.abs().lessThan(0.99).select(vec3(0, 1, 0), vec3(1, 0, 0));
569
+ const tangent = normalize(helper.cross(normal));
570
+ const bitangent = normal.cross(tangent);
571
+ const cell = coordinate.mul(2048).floor();
572
+ const noiseA = cell.x.mul(0.06711056).add(cell.y.mul(583715e-8)).fract().mul(52.9829189).fract();
573
+ const noiseB = noiseA.mul(7.31).add(cell.x.mul(0.0123)).fract();
574
+ const origin = position.add(normal.mul(max(0.01, position.z.negate().mul(4e-3))));
575
+ const rays = sliceCount.mul(RAYS_PER_SLICE);
576
+ const gathered = vec3(0, 0, 0).toVar();
577
+ const hits = float(0).toVar();
578
+ Loop(
579
+ { start: int(0), end: int(RAYS_PER_SLICE * 8), type: "int", condition: "<" },
580
+ ({ i }) => {
581
+ If(float(i).greaterThanEqual(rays), () => {
582
+ Break();
583
+ });
584
+ const u1 = float(i).add(noiseA).div(rays);
585
+ const u2 = noiseB.add(float(i).mul(0.61803398875)).fract();
586
+ const spread = u1.sqrt();
587
+ const angle = u2.mul(6.28318530718);
588
+ const direction = normalize(
589
+ tangent.mul(spread.mul(angle.cos())).add(bitangent.mul(spread.mul(angle.sin()))).add(normal.mul(float(1).sub(u1).sqrt()))
590
+ );
591
+ const trace = march(origin, direction, position.z);
592
+ If(trace.hitDistance.greaterThanEqual(0), () => {
593
+ const hit = shade(trace.hitCoordinate, trace.hitDistance, direction);
594
+ gathered.assign(gathered.add(hit.radiance.sub(fallback).mul(hit.weight)));
595
+ hits.assign(hits.add(hit.weight));
596
+ });
597
+ }
598
+ );
599
+ result.assign(vec4(gathered.div(rays).mul(intensity), hits.div(rays)));
600
+ });
601
+ return result;
602
+ })();
603
+ const node = rtt(graph, null, null, { type: HALF_FLOAT_TYPE, gpuStage: GI_STAGE });
604
+ const uniformObjects = { radius, thickness, sliceCount, stepCount, intensity, screenEdgeFade };
605
+ return Object.defineProperties(node, {
606
+ ...Object.fromEntries(
607
+ Object.entries(uniformObjects).map(([name, value]) => [name, { value }])
608
+ ),
609
+ getGINode: { value: () => node },
610
+ getAONode: { value: () => vec4(1, 1, 1, 1) },
611
+ resolutionScale: {
612
+ get: () => node.getResolutionScale(),
613
+ set: (value) => node.setResolutionScale(value)
614
+ }
615
+ });
616
+ };
617
+ }
618
+ function octahedronDecode(tsl, square) {
619
+ const { float, normalize, vec2, vec3 } = tsl;
620
+ const f = square.mul(2).sub(1);
621
+ const z = float(1).sub(f.x.abs()).sub(f.y.abs());
622
+ const fold = vec2(float(1).sub(f.y.abs()), float(1).sub(f.x.abs())).mul(
623
+ vec2(
624
+ f.x.greaterThanEqual(0).select(float(1), float(-1)),
625
+ f.y.greaterThanEqual(0).select(float(1), float(-1))
626
+ )
627
+ );
628
+ const xy = z.lessThan(0).select(fold, f);
629
+ return normalize(vec3(xy.x, xy.y, z));
630
+ }
631
+ function octahedronEncode(tsl, direction) {
632
+ const { float, vec2 } = tsl;
633
+ const p = vec2(direction.x, direction.y).div(
634
+ direction.x.abs().add(direction.y.abs()).add(direction.z.abs())
635
+ );
636
+ const fold = vec2(float(1).sub(p.y.abs()), float(1).sub(p.x.abs())).mul(
637
+ vec2(
638
+ p.x.greaterThanEqual(0).select(float(1), float(-1)),
639
+ p.y.greaterThanEqual(0).select(float(1), float(-1))
640
+ )
641
+ );
642
+ return direction.z.lessThan(0).select(fold, p).mul(0.5).add(0.5);
643
+ }
644
+ function defineScreenProbes(tsl, input) {
645
+ const { Fn, If, Loop, float, int, max, min, normalize, rtt, smoothstep, uv, vec2, vec3, vec4 } = tsl;
646
+ const { depthNode, normalNode, march, shade, options, probes } = input;
647
+ const { viewPosition } = input.mapping;
648
+ const factor = probes.downsampleFactor;
649
+ const side = probes.tracingOctahedronResolution ?? 8;
650
+ if (!(factor >= 1) || !(side >= 2) || !(probes.viewport.width > 0) || !(probes.viewport.height > 0) || probes.timedPass != null && !SCREEN_PROBE_PASSES.includes(probes.timedPass))
651
+ throw new TypeError(
652
+ `TN_NATIVE_SCREEN_PROBES: downsampleFactor ${factor}, tracingOctahedronResolution ${side}, viewport ${probes.viewport.width}x${probes.viewport.height}, timedPass ${String(probes.timedPass)}`
653
+ );
654
+ const stage = (pass) => probes.timedPass === void 0 || probes.timedPass === pass ? GI_STAGE : void 0;
655
+ const tilesX = Math.ceil(probes.viewport.width / factor);
656
+ const tilesY = Math.ceil(probes.viewport.height / factor);
657
+ const tiles = vec2(tilesX, tilesY);
658
+ const traceSize = vec2(tilesX * side, tilesY * side);
659
+ const irradianceSize = vec2(tilesX * IRRADIANCE_SIDE, tilesY * IRRADIANCE_SIDE);
660
+ const valid = (depth, normal) => (
661
+ // A draw the normal pass skips (an unlit material) leaves a zero normal: it takes no gathered light.
662
+ depth.lessThan(1).and(normal.dot(normal).greaterThan(0.25))
663
+ );
664
+ const rayDirection = (tile, cell) => {
665
+ const index = tile.x.add(tile.y.mul(tilesX));
666
+ const offset = index.mul(vec2(0.7548776662, 0.569840291)).fract().sub(0.5).mul(input.uniform.jitter).add(0.5);
667
+ return octahedronDecode(tsl, cell.add(offset).div(side));
668
+ };
669
+ const traceGraph = Fn(() => {
670
+ const texel = uv().mul(traceSize).floor();
671
+ const tile = texel.div(side).floor();
672
+ const cell = texel.sub(tile.mul(side));
673
+ const probeUv = tile.add(0.5).div(tiles).min(vec2(1, 1));
674
+ const result = vec4(0, 0, 0, 0).toVar();
675
+ const depth = depthNode.sample(probeUv).r;
676
+ const rawNormal = normalNode.sample(probeUv).xyz;
677
+ If(valid(depth, rawNormal), () => {
678
+ const position = viewPosition(probeUv, depth);
679
+ const normal = normalize(rawNormal);
680
+ const direction = rayDirection(tile, cell);
681
+ const origin = position.add(normal.mul(max(0.01, position.z.negate().mul(4e-3))));
682
+ const trace = march(origin, direction, position.z);
683
+ If(trace.hitDistance.greaterThanEqual(0), () => {
684
+ const hit = shade(trace.hitCoordinate, trace.hitDistance, direction);
685
+ result.assign(vec4(hit.radiance.mul(hit.weight), hit.weight));
686
+ });
687
+ });
688
+ return result;
689
+ })();
690
+ const traced = rtt(traceGraph, tilesX * side, tilesY * side, {
691
+ type: HALF_FLOAT_TYPE,
692
+ minFilter: 1003,
693
+ magFilter: 1003,
694
+ gpuStage: stage("trace")
695
+ });
696
+ const filterGraph = Fn(() => {
697
+ const texel = uv().mul(irradianceSize).floor();
698
+ const tile = texel.div(IRRADIANCE_SIDE).floor();
699
+ const cell = texel.sub(tile.mul(IRRADIANCE_SIDE));
700
+ const normal = octahedronDecode(tsl, cell.add(0.5).div(IRRADIANCE_SIDE));
701
+ const sum = vec4(0, 0, 0, 0).toVar();
702
+ const weights = float(0).toVar();
703
+ Loop({ start: int(0), end: int(side * side), type: "int", condition: "<" }, ({ i }) => {
704
+ const row = float(i).div(side).floor();
705
+ const ray = vec2(float(i).sub(row.mul(side)), row);
706
+ const direction = rayDirection(tile, ray);
707
+ const weight = max(direction.dot(normal), float(0));
708
+ const found = traced.sample(tile.mul(side).add(ray).add(0.5).div(traceSize));
709
+ sum.assign(sum.add(found.mul(weight)));
710
+ weights.assign(weights.add(weight));
711
+ });
712
+ const probeUv = tile.add(0.5).div(tiles).min(vec2(1, 1));
713
+ const depth = depthNode.sample(probeUv).r;
714
+ const rawNormal = normalNode.sample(probeUv).xyz;
715
+ const believed = valid(depth, rawNormal).select(
716
+ options.fallback?.(viewPosition(probeUv, depth), normal) ?? vec3(0, 0, 0),
717
+ vec3(0, 0, 0)
718
+ );
719
+ const total = max(weights, float(1e-4));
720
+ return vec4(sum.rgb.sub(believed.mul(sum.a)).div(total), sum.a.div(total));
721
+ })();
722
+ const filtered = rtt(filterGraph, tilesX * IRRADIANCE_SIDE, tilesY * IRRADIANCE_SIDE, {
723
+ type: HALF_FLOAT_TYPE,
724
+ gpuStage: stage("filter")
725
+ });
726
+ const gatherGraph = Fn(() => {
727
+ const coordinate = uv();
728
+ const result = vec4(0, 0, 0, 0).toVar();
729
+ const centreDepth = depthNode.sample(coordinate).r;
730
+ const centreNormal = normalNode.sample(coordinate).xyz;
731
+ If(valid(centreDepth, centreNormal), () => {
732
+ const position = viewPosition(coordinate, centreDepth);
733
+ const normal = normalize(centreNormal);
734
+ const grid = coordinate.mul(tiles).sub(0.5);
735
+ const base = grid.floor();
736
+ const fraction = grid.sub(base);
737
+ const lookup = octahedronEncode(tsl, normal).mul(IRRADIANCE_SIDE - 1).add(0.5);
738
+ const sum = vec4(0, 0, 0, 0).toVar();
739
+ const weights = float(0).toVar();
740
+ for (const [dx, dy] of [
741
+ [0, 0],
742
+ [1, 0],
743
+ [0, 1],
744
+ [1, 1]
745
+ ]) {
746
+ const tile = base.add(vec2(dx, dy)).max(vec2(0, 0)).min(tiles.sub(1));
747
+ const probeUv = tile.add(0.5).div(tiles);
748
+ const probeDepth = depthNode.sample(probeUv).r;
749
+ const probeNormal = normalNode.sample(probeUv).xyz;
750
+ const probePosition = viewPosition(probeUv, probeDepth);
751
+ const bilinear = (dx === 1 ? fraction.x : float(1).sub(fraction.x)).mul(
752
+ dy === 1 ? fraction.y : float(1).sub(fraction.y)
753
+ );
754
+ const offPlane = normal.dot(probePosition.sub(position)).abs().div(max(position.z.abs(), float(1e-3)));
755
+ const planeWeight = float(1).sub(smoothstep(0, 0.05, offPlane));
756
+ const agree = max(normal.dot(normalize(probeNormal)), float(0));
757
+ const normalWeight = agree.mul(agree).mul(agree.mul(agree));
758
+ const weight = valid(probeDepth, probeNormal).select(
759
+ bilinear.mul(planeWeight).mul(normalWeight),
760
+ float(0)
761
+ );
762
+ const irradiance = filtered.sample(
763
+ tile.mul(IRRADIANCE_SIDE).add(lookup).div(irradianceSize)
764
+ );
765
+ sum.assign(sum.add(irradiance.mul(weight)));
766
+ weights.assign(weights.add(weight));
767
+ }
768
+ const trust = smoothstep(0.02, 0.25, weights);
769
+ const mean = sum.div(max(weights, float(1e-4))).mul(trust);
770
+ const shown = vec4(mean.rgb.mul(input.uniform.intensity), mean.a);
771
+ const luminance = mean.r.add(mean.g).add(mean.b).mul(0.3333);
772
+ result.assign(
773
+ input.uniform.debug.equal(1).select(
774
+ vec4(trust, weights.min(1), 0, 0),
775
+ input.uniform.debug.equal(2).select(vec4(luminance.max(0).mul(8), 0, luminance.negate().max(0).mul(8), 0), shown)
776
+ )
777
+ );
778
+ });
779
+ return result;
780
+ })();
781
+ return rtt(gatherGraph, null, null, { type: HALF_FLOAT_TYPE, gpuStage: stage("gather") });
782
+ }
783
+
158
784
  // ../three-native/src/addons/post-effects-web.ts
159
785
  var { ao, denoise, smaa, bloom, traa, film, lut3D } = definePostEffects(
160
786
  __tnTsl
161
787
  );
788
+ var ssr = defineScreenSpaceReflections(__tnTsl);
789
+ var ssgi = defineScreenSpaceGi(__tnTsl);
162
790
  var fxaa = unsupportedExport("fxaa");
163
791
  var godrays = unsupportedExport("godrays");
164
- var ssgi = unsupportedExport("ssgi");
165
- var ssr = unsupportedExport("ssr");
166
792
  var sharpen = unsupportedExport("sharpen");
167
793
 
168
794
  export { ao, bloom, denoise, film, fxaa, godrays, lut3D, sharpen, smaa, ssgi, ssr, traa };