create-threenative 0.2.7 → 0.2.9

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 (541) hide show
  1. package/README.md +3 -1
  2. package/agent-docs/references/assertion-reference.md +87 -35
  3. package/agent-docs/references/auto-exposure.md +57 -0
  4. package/agent-docs/references/capability-reference.md +1306 -62
  5. package/agent-docs/references/debug-surface.md +6 -0
  6. package/agent-docs/references/finding-assets.md +46 -10
  7. package/agent-docs/references/performance-basics.md +5 -4
  8. package/agent-docs/references/terrain-authoring.md +140 -0
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
  10. package/capabilities.json +1505 -79
  11. package/dist/index.d.ts +28 -3
  12. package/dist/index.js +402 -167
  13. package/dist/threenative.js +989 -237
  14. package/dist/web-engine-buffer-geometry-utils.js +281 -0
  15. package/dist/web-engine-decal-geometry.js +184 -0
  16. package/dist/web-engine-gltf-loader.js +196 -0
  17. package/dist/web-engine-hdr-loader.js +190 -0
  18. package/dist/web-engine-lut-cube-loader.js +122 -0
  19. package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
  20. package/dist/web-engine-mesh-bvh.js +32 -0
  21. package/dist/web-engine-post-effects.js +168 -0
  22. package/dist/web-engine-runtime.js +42506 -0
  23. package/package.json +11 -8
  24. package/template-assets/autoExposure.ts +225 -0
  25. package/template-assets/exposure.ts +111 -0
  26. package/template-assets/exposureGraph.ts +178 -0
  27. package/template-assets/exposureReadback.ts +79 -0
  28. package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
  29. package/template-assets/patches/three@0.185.1.patch +6594 -700
  30. package/template-assets/patches/vite@8.2.0.patch +422 -0
  31. package/template-assets/worldEnvironment.ts +433 -30
  32. package/templates/action-rpg/AGENTS.md +11 -10
  33. package/templates/action-rpg/CLAUDE.md +11 -10
  34. package/templates/action-rpg/package.json +11 -9
  35. package/templates/action-rpg/playtests/performance.playtest.json +7 -1
  36. package/templates/action-rpg/src/progress.ts +0 -4
  37. package/templates/action-rpg/src/render/autoExposure.ts +225 -0
  38. package/templates/action-rpg/src/render/backlightControls.ts +66 -0
  39. package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
  40. package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
  41. package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
  42. package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
  43. package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
  44. package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
  45. package/templates/action-rpg/src/render/exposure.ts +111 -0
  46. package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
  47. package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
  48. package/templates/action-rpg/src/render/heightFog.ts +118 -0
  49. package/templates/action-rpg/src/render/lighting.ts +26 -1
  50. package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
  51. package/templates/action-rpg/src/render/materialLighting.ts +155 -0
  52. package/templates/action-rpg/src/render/postprocessing.ts +17 -2
  53. package/templates/action-rpg/src/render/quality.ts +61 -2
  54. package/templates/action-rpg/src/render/sky.ts +21 -1
  55. package/templates/action-rpg/src/render/vfx.ts +133 -58
  56. package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
  57. package/templates/action-rpg/src/scenes/Play.ts +81 -16
  58. package/templates/action-rpg/threenative.config.ts +3 -0
  59. package/templates/action-rpg/vite.config.ts +10 -2
  60. package/templates/minimal/AGENTS.md +9 -10
  61. package/templates/minimal/CLAUDE.md +9 -10
  62. package/templates/minimal/package.json +9 -8
  63. package/templates/minimal/playtests/play.playtest.json +7 -1
  64. package/templates/minimal/playtests/sky.playtest.json +10 -1
  65. package/templates/minimal/src/render/autoExposure.ts +225 -0
  66. package/templates/minimal/src/render/backlightControls.ts +66 -0
  67. package/templates/minimal/src/render/backlightMaterial.ts +147 -0
  68. package/templates/minimal/src/render/environmentContribution.ts +188 -0
  69. package/templates/minimal/src/render/environmentRadiance.ts +36 -0
  70. package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
  71. package/templates/minimal/src/render/environmentSampling.ts +193 -0
  72. package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
  73. package/templates/minimal/src/render/exposure.ts +111 -0
  74. package/templates/minimal/src/render/exposureGraph.ts +178 -0
  75. package/templates/minimal/src/render/exposureReadback.ts +79 -0
  76. package/templates/minimal/src/render/heightFog.ts +118 -0
  77. package/templates/minimal/src/render/lighting.ts +25 -1
  78. package/templates/minimal/src/render/materialAssignments.ts +102 -0
  79. package/templates/minimal/src/render/materialLighting.ts +146 -0
  80. package/templates/minimal/src/render/postprocessing.ts +16 -2
  81. package/templates/minimal/src/render/quality.ts +60 -2
  82. package/templates/minimal/src/render/sky.ts +21 -1
  83. package/templates/minimal/src/render/worldEnvironment.ts +433 -30
  84. package/templates/minimal/src/scenes/Play.ts +50 -1
  85. package/templates/minimal/vite.config.ts +10 -2
  86. package/templates/platformer/AGENTS.md +7 -5
  87. package/templates/platformer/CLAUDE.md +7 -5
  88. package/templates/platformer/package.json +11 -9
  89. package/templates/platformer/playtests/performance.playtest.json +7 -1
  90. package/templates/platformer/src/render/autoExposure.ts +225 -0
  91. package/templates/platformer/src/render/backlightControls.ts +66 -0
  92. package/templates/platformer/src/render/backlightMaterial.ts +147 -0
  93. package/templates/platformer/src/render/environmentContribution.ts +188 -0
  94. package/templates/platformer/src/render/environmentRadiance.ts +36 -0
  95. package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
  96. package/templates/platformer/src/render/environmentSampling.ts +193 -0
  97. package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
  98. package/templates/platformer/src/render/exposure.ts +111 -0
  99. package/templates/platformer/src/render/exposureGraph.ts +178 -0
  100. package/templates/platformer/src/render/exposureReadback.ts +79 -0
  101. package/templates/platformer/src/render/heightFog.ts +118 -0
  102. package/templates/platformer/src/render/lighting.ts +26 -1
  103. package/templates/platformer/src/render/materialAssignments.ts +160 -0
  104. package/templates/platformer/src/render/materialLighting.ts +155 -0
  105. package/templates/platformer/src/render/materials.ts +7 -2
  106. package/templates/platformer/src/render/palette.ts +3 -3
  107. package/templates/platformer/src/render/postprocessing.ts +17 -2
  108. package/templates/platformer/src/render/quality.ts +61 -2
  109. package/templates/platformer/src/render/sky.ts +72 -23
  110. package/templates/platformer/src/render/skyEnvironment.ts +50 -0
  111. package/templates/platformer/src/render/worldEnvironment.ts +433 -30
  112. package/templates/platformer/src/scenes/Play.ts +70 -6
  113. package/templates/platformer/vite.config.ts +10 -2
  114. package/templates/puzzle/AGENTS.md +10 -9
  115. package/templates/puzzle/CLAUDE.md +10 -9
  116. package/templates/puzzle/package.json +11 -9
  117. package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
  118. package/templates/puzzle/playtests/lit.playtest.json +7 -1
  119. package/templates/puzzle/playtests/performance.playtest.json +7 -1
  120. package/templates/puzzle/src/render/autoExposure.ts +225 -0
  121. package/templates/puzzle/src/render/backlightControls.ts +66 -0
  122. package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
  123. package/templates/puzzle/src/render/environmentContribution.ts +188 -0
  124. package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
  125. package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
  126. package/templates/puzzle/src/render/environmentSampling.ts +193 -0
  127. package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
  128. package/templates/puzzle/src/render/exposure.ts +111 -0
  129. package/templates/puzzle/src/render/exposureGraph.ts +178 -0
  130. package/templates/puzzle/src/render/exposureReadback.ts +79 -0
  131. package/templates/puzzle/src/render/heightFog.ts +118 -0
  132. package/templates/puzzle/src/render/lighting.ts +33 -1
  133. package/templates/puzzle/src/render/materialAssignments.ts +160 -0
  134. package/templates/puzzle/src/render/materialLighting.ts +155 -0
  135. package/templates/puzzle/src/render/materials.ts +1 -1
  136. package/templates/puzzle/src/render/postprocessing.ts +8 -2
  137. package/templates/puzzle/src/render/quality.ts +62 -1
  138. package/templates/puzzle/src/render/sky.ts +20 -1
  139. package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
  140. package/templates/puzzle/src/scenes/Play.ts +51 -2
  141. package/templates/puzzle/vite.config.ts +10 -2
  142. package/templates/racing/AGENTS.md +8 -7
  143. package/templates/racing/CLAUDE.md +8 -7
  144. package/templates/racing/package.json +11 -9
  145. package/templates/racing/playtests/performance.playtest.json +7 -1
  146. package/templates/racing/playtests/survives.playtest.json +6 -0
  147. package/templates/racing/src/render/autoExposure.ts +225 -0
  148. package/templates/racing/src/render/backlightControls.ts +66 -0
  149. package/templates/racing/src/render/backlightMaterial.ts +147 -0
  150. package/templates/racing/src/render/environmentContribution.ts +188 -0
  151. package/templates/racing/src/render/environmentRadiance.ts +36 -0
  152. package/templates/racing/src/render/environmentSampleCache.ts +43 -0
  153. package/templates/racing/src/render/environmentSampling.ts +193 -0
  154. package/templates/racing/src/render/environmentSnapshot.ts +53 -0
  155. package/templates/racing/src/render/exposure.ts +111 -0
  156. package/templates/racing/src/render/exposureGraph.ts +178 -0
  157. package/templates/racing/src/render/exposureReadback.ts +79 -0
  158. package/templates/racing/src/render/heightFog.ts +118 -0
  159. package/templates/racing/src/render/lighting.ts +29 -1
  160. package/templates/racing/src/render/materialAssignments.ts +160 -0
  161. package/templates/racing/src/render/materialLighting.ts +155 -0
  162. package/templates/racing/src/render/palette.ts +1 -10
  163. package/templates/racing/src/render/postprocessing.ts +17 -2
  164. package/templates/racing/src/render/quality.ts +61 -2
  165. package/templates/racing/src/render/shapes.ts +0 -25
  166. package/templates/racing/src/render/sky.ts +21 -1
  167. package/templates/racing/src/render/worldEnvironment.ts +433 -30
  168. package/templates/racing/src/scenes/Race.ts +91 -3
  169. package/templates/racing/src/track/circuit.ts +0 -9
  170. package/templates/racing/vite.config.ts +10 -2
  171. package/templates/rain/.codex/config.toml +19 -0
  172. package/templates/rain/.cursor/mcp.json +32 -0
  173. package/templates/rain/.gemini/settings.json +32 -0
  174. package/templates/rain/.mcp.json +32 -0
  175. package/templates/rain/.vscode/mcp.json +36 -0
  176. package/templates/rain/.zed/settings.json +36 -0
  177. package/templates/rain/AGENTS.md +95 -0
  178. package/templates/rain/CLAUDE.md +97 -0
  179. package/templates/rain/assets/rain-loop.wav +0 -0
  180. package/templates/rain/assets/thunder.wav +0 -0
  181. package/templates/rain/assets/wind-loop.wav +0 -0
  182. package/templates/rain/index.html +18 -0
  183. package/templates/rain/kit.json +7 -0
  184. package/templates/rain/native-playtests/boot.playtest.json +23 -0
  185. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  186. package/templates/rain/opencode.json +41 -0
  187. package/templates/rain/package.json +59 -0
  188. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  189. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  190. package/templates/rain/playtests/automation.playtest.json +133 -0
  191. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  192. package/templates/rain/playtests/flash.playtest.json +27 -0
  193. package/templates/rain/playtests/fly.playtest.json +54 -0
  194. package/templates/rain/playtests/lightning.playtest.json +220 -0
  195. package/templates/rain/playtests/loading.playtest.json +57 -0
  196. package/templates/rain/playtests/paused.playtest.json +59 -0
  197. package/templates/rain/playtests/performance.playtest.json +32 -0
  198. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  199. package/templates/rain/playtests/simulation.playtest.json +20 -0
  200. package/templates/rain/playtests/storm.playtest.json +150 -0
  201. package/templates/rain/playtests/survives.playtest.json +58 -0
  202. package/templates/rain/playtests/tiers.playtest.json +194 -0
  203. package/templates/rain/playtests/weather.playtest.json +77 -0
  204. package/templates/rain/public/favicon.svg +5 -0
  205. package/templates/rain/src/audio/storm.ts +314 -0
  206. package/templates/rain/src/game.ts +81 -0
  207. package/templates/rain/src/main.ts +15 -0
  208. package/templates/rain/src/render/autoExposure.ts +225 -0
  209. package/templates/rain/src/render/bloom-shader.ts +65 -0
  210. package/templates/rain/src/render/camera.ts +160 -0
  211. package/templates/rain/src/render/clouds-shader.ts +242 -0
  212. package/templates/rain/src/render/clouds.ts +142 -0
  213. package/templates/rain/src/render/exposure.ts +111 -0
  214. package/templates/rain/src/render/exposureGraph.ts +178 -0
  215. package/templates/rain/src/render/exposureReadback.ts +79 -0
  216. package/templates/rain/src/render/lighting.ts +39 -0
  217. package/templates/rain/src/render/lightning.ts +360 -0
  218. package/templates/rain/src/render/loading.ts +327 -0
  219. package/templates/rain/src/render/materials.ts +19 -0
  220. package/templates/rain/src/render/noise-volume.ts +159 -0
  221. package/templates/rain/src/render/palette.ts +18 -0
  222. package/templates/rain/src/render/post-shader.ts +178 -0
  223. package/templates/rain/src/render/postprocessing.ts +229 -0
  224. package/templates/rain/src/render/quality.ts +161 -0
  225. package/templates/rain/src/render/rain.ts +299 -0
  226. package/templates/rain/src/render/sky.ts +28 -0
  227. package/templates/rain/src/render/world-shader.ts +680 -0
  228. package/templates/rain/src/render/world.ts +146 -0
  229. package/templates/rain/src/render/worldEnvironment.ts +1212 -0
  230. package/templates/rain/src/scenes/Boot.ts +348 -0
  231. package/templates/rain/src/state.ts +261 -0
  232. package/templates/rain/src/style.css +1160 -0
  233. package/templates/rain/src/ui/App.tsx +29 -0
  234. package/templates/rain/src/ui/GameUi.tsx +187 -0
  235. package/templates/rain/src/ui/Hud.tsx +327 -0
  236. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  237. package/templates/rain/src/ui/Menu.tsx +370 -0
  238. package/templates/rain/src/ui/automation.ts +60 -0
  239. package/templates/rain/src/ui/main.tsx +7 -0
  240. package/templates/rain/src/ui/tempest.ts +149 -0
  241. package/templates/rain/tailwind.config.ts +2 -0
  242. package/templates/rain/threenative.config.ts +66 -0
  243. package/templates/rain/tools/generate-shaders.mjs +656 -0
  244. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  245. package/templates/rain/tools/storm-dsp.mjs +177 -0
  246. package/templates/rain/tools/tempest-bloom.frag +10 -0
  247. package/templates/rain/tools/tempest-clouds.frag +86 -0
  248. package/templates/rain/tools/tempest-post.frag +47 -0
  249. package/templates/rain/tools/tempest-world.frag +210 -0
  250. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  251. package/templates/rain/tsconfig.json +17 -0
  252. package/templates/rain/vite.config.ts +45 -0
  253. package/templates/rts/AGENTS.md +10 -11
  254. package/templates/rts/CLAUDE.md +10 -11
  255. package/templates/rts/package.json +10 -8
  256. package/templates/rts/playtests/performance.playtest.json +7 -1
  257. package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
  258. package/templates/rts/playtests/rts-attack.playtest.json +10 -1
  259. package/templates/rts/playtests/rts-build.playtest.json +10 -1
  260. package/templates/rts/playtests/rts-orders.playtest.json +7 -1
  261. package/templates/rts/playtests/rts-train.playtest.json +10 -1
  262. package/templates/rts/src/render/army.ts +10 -2
  263. package/templates/rts/src/render/autoExposure.ts +225 -0
  264. package/templates/rts/src/render/backlightControls.ts +66 -0
  265. package/templates/rts/src/render/backlightMaterial.ts +147 -0
  266. package/templates/rts/src/render/environmentContribution.ts +188 -0
  267. package/templates/rts/src/render/environmentRadiance.ts +36 -0
  268. package/templates/rts/src/render/environmentSampleCache.ts +43 -0
  269. package/templates/rts/src/render/environmentSampling.ts +193 -0
  270. package/templates/rts/src/render/environmentSnapshot.ts +53 -0
  271. package/templates/rts/src/render/exposure.ts +111 -0
  272. package/templates/rts/src/render/exposureGraph.ts +178 -0
  273. package/templates/rts/src/render/exposureReadback.ts +79 -0
  274. package/templates/rts/src/render/heightFog.ts +118 -0
  275. package/templates/rts/src/render/lighting.ts +26 -1
  276. package/templates/rts/src/render/materialAssignments.ts +160 -0
  277. package/templates/rts/src/render/materialLighting.ts +155 -0
  278. package/templates/rts/src/render/postprocessing.ts +8 -2
  279. package/templates/rts/src/render/quality.ts +61 -2
  280. package/templates/rts/src/render/sky.ts +21 -1
  281. package/templates/rts/src/render/worldEnvironment.ts +433 -30
  282. package/templates/rts/src/scenes/Play.ts +54 -3
  283. package/templates/rts/src/sim/ai.ts +0 -1
  284. package/templates/rts/src/sim/terrain.ts +0 -4
  285. package/templates/rts/vite.config.ts +10 -2
  286. package/templates/runner/AGENTS.md +10 -8
  287. package/templates/runner/CLAUDE.md +10 -8
  288. package/templates/runner/package.json +11 -9
  289. package/templates/runner/playtests/performance.playtest.json +10 -1
  290. package/templates/runner/src/physics.ts +0 -1
  291. package/templates/runner/src/render/autoExposure.ts +225 -0
  292. package/templates/runner/src/render/backlightControls.ts +66 -0
  293. package/templates/runner/src/render/backlightMaterial.ts +147 -0
  294. package/templates/runner/src/render/environmentContribution.ts +188 -0
  295. package/templates/runner/src/render/environmentRadiance.ts +36 -0
  296. package/templates/runner/src/render/environmentSampleCache.ts +43 -0
  297. package/templates/runner/src/render/environmentSampling.ts +193 -0
  298. package/templates/runner/src/render/environmentSnapshot.ts +53 -0
  299. package/templates/runner/src/render/exposure.ts +111 -0
  300. package/templates/runner/src/render/exposureGraph.ts +178 -0
  301. package/templates/runner/src/render/exposureReadback.ts +79 -0
  302. package/templates/runner/src/render/heightFog.ts +118 -0
  303. package/templates/runner/src/render/lighting.ts +26 -1
  304. package/templates/runner/src/render/materialAssignments.ts +160 -0
  305. package/templates/runner/src/render/materialLighting.ts +155 -0
  306. package/templates/runner/src/render/postprocessing.ts +17 -2
  307. package/templates/runner/src/render/quality.ts +61 -2
  308. package/templates/runner/src/render/sky.ts +21 -1
  309. package/templates/runner/src/render/worldEnvironment.ts +433 -30
  310. package/templates/runner/src/scenes/Run.ts +67 -2
  311. package/templates/runner/threenative.config.ts +3 -0
  312. package/templates/runner/vite.config.ts +10 -2
  313. package/templates/sailing/AGENTS.md +14 -13
  314. package/templates/sailing/CLAUDE.md +14 -13
  315. package/templates/sailing/native-playtests/survives.playtest.json +7 -0
  316. package/templates/sailing/package.json +11 -9
  317. package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
  318. package/templates/sailing/src/entities/Ship.ts +38 -18
  319. package/templates/sailing/src/render/autoExposure.ts +225 -0
  320. package/templates/sailing/src/render/backlightControls.ts +66 -0
  321. package/templates/sailing/src/render/backlightMaterial.ts +147 -0
  322. package/templates/sailing/src/render/camera.ts +12 -4
  323. package/templates/sailing/src/render/environmentContribution.ts +188 -0
  324. package/templates/sailing/src/render/environmentRadiance.ts +36 -0
  325. package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
  326. package/templates/sailing/src/render/environmentSampling.ts +193 -0
  327. package/templates/sailing/src/render/environmentSetup.ts +24 -0
  328. package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
  329. package/templates/sailing/src/render/exposure.ts +111 -0
  330. package/templates/sailing/src/render/exposureGraph.ts +178 -0
  331. package/templates/sailing/src/render/exposureReadback.ts +79 -0
  332. package/templates/sailing/src/render/heightFog.ts +118 -0
  333. package/templates/sailing/src/render/lighting.ts +26 -1
  334. package/templates/sailing/src/render/materialAssignments.ts +160 -0
  335. package/templates/sailing/src/render/materialLighting.ts +155 -0
  336. package/templates/sailing/src/render/ocean.ts +71 -53
  337. package/templates/sailing/src/render/postprocessing.ts +16 -2
  338. package/templates/sailing/src/render/props.ts +0 -45
  339. package/templates/sailing/src/render/quality.ts +61 -1
  340. package/templates/sailing/src/render/sky.ts +21 -1
  341. package/templates/sailing/src/render/worldEnvironment.ts +433 -30
  342. package/templates/sailing/src/scenes/Boot.ts +12 -1
  343. package/templates/sailing/src/scenes/Sailing.ts +87 -2
  344. package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
  345. package/templates/sailing/threenative.config.ts +3 -0
  346. package/templates/sailing/vite.config.ts +10 -2
  347. package/templates/shooter/AGENTS.md +8 -6
  348. package/templates/shooter/CLAUDE.md +8 -6
  349. package/templates/shooter/package.json +11 -9
  350. package/templates/shooter/playtests/performance.playtest.json +7 -1
  351. package/templates/shooter/src/entities/Enemy.ts +0 -15
  352. package/templates/shooter/src/entities/Rifle.ts +38 -1
  353. package/templates/shooter/src/render/autoExposure.ts +225 -0
  354. package/templates/shooter/src/render/backlightControls.ts +66 -0
  355. package/templates/shooter/src/render/backlightMaterial.ts +147 -0
  356. package/templates/shooter/src/render/camera.ts +1 -12
  357. package/templates/shooter/src/render/decals.ts +299 -5
  358. package/templates/shooter/src/render/environmentContribution.ts +188 -0
  359. package/templates/shooter/src/render/environmentRadiance.ts +36 -0
  360. package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
  361. package/templates/shooter/src/render/environmentSampling.ts +193 -0
  362. package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
  363. package/templates/shooter/src/render/exposure.ts +111 -0
  364. package/templates/shooter/src/render/exposureGraph.ts +178 -0
  365. package/templates/shooter/src/render/exposureReadback.ts +79 -0
  366. package/templates/shooter/src/render/gunfx.ts +0 -1
  367. package/templates/shooter/src/render/heightFog.ts +118 -0
  368. package/templates/shooter/src/render/lighting.ts +26 -1
  369. package/templates/shooter/src/render/materialAssignments.ts +160 -0
  370. package/templates/shooter/src/render/materialLighting.ts +155 -0
  371. package/templates/shooter/src/render/postprocessing.ts +17 -2
  372. package/templates/shooter/src/render/quality.ts +61 -2
  373. package/templates/shooter/src/render/scale.ts +2 -93
  374. package/templates/shooter/src/render/sky.ts +21 -1
  375. package/templates/shooter/src/render/vehicles.ts +0 -17
  376. package/templates/shooter/src/render/worldEnvironment.ts +433 -30
  377. package/templates/shooter/src/scenes/Play.ts +64 -2
  378. package/templates/shooter/vite.config.ts +10 -2
  379. package/templates/snow/.codex/config.toml +19 -0
  380. package/templates/snow/.cursor/mcp.json +32 -0
  381. package/templates/snow/.gemini/settings.json +32 -0
  382. package/templates/snow/.mcp.json +32 -0
  383. package/templates/snow/.vscode/mcp.json +36 -0
  384. package/templates/snow/.zed/settings.json +36 -0
  385. package/templates/snow/AGENTS.md +90 -0
  386. package/templates/snow/CLAUDE.md +92 -0
  387. package/templates/snow/README.md +26 -0
  388. package/templates/snow/assets/crunch.wav +0 -0
  389. package/templates/snow/assets/wind.wav +0 -0
  390. package/templates/snow/index.html +12 -0
  391. package/templates/snow/kit.json +7 -0
  392. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  393. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  394. package/templates/snow/opencode.json +41 -0
  395. package/templates/snow/package.json +60 -0
  396. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  397. package/templates/snow/playtests/performance.playtest.json +36 -0
  398. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  399. package/templates/snow/playtests/survives.playtest.json +56 -0
  400. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  401. package/templates/snow/playtests/weather.playtest.json +119 -0
  402. package/templates/snow/public/favicon.svg +5 -0
  403. package/templates/snow/src/audio.ts +58 -0
  404. package/templates/snow/src/commands.ts +8 -0
  405. package/templates/snow/src/entities/Explorer.ts +279 -0
  406. package/templates/snow/src/game.ts +69 -0
  407. package/templates/snow/src/main.ts +15 -0
  408. package/templates/snow/src/render/autoExposure.ts +225 -0
  409. package/templates/snow/src/render/backlightControls.ts +66 -0
  410. package/templates/snow/src/render/backlightMaterial.ts +147 -0
  411. package/templates/snow/src/render/bootPrint.ts +50 -0
  412. package/templates/snow/src/render/camera.ts +84 -0
  413. package/templates/snow/src/render/environmentContribution.ts +188 -0
  414. package/templates/snow/src/render/environmentRadiance.ts +36 -0
  415. package/templates/snow/src/render/environmentSampleCache.ts +43 -0
  416. package/templates/snow/src/render/environmentSampling.ts +193 -0
  417. package/templates/snow/src/render/environmentSnapshot.ts +53 -0
  418. package/templates/snow/src/render/explorer.ts +321 -0
  419. package/templates/snow/src/render/exposure.ts +111 -0
  420. package/templates/snow/src/render/exposureGraph.ts +178 -0
  421. package/templates/snow/src/render/exposureReadback.ts +79 -0
  422. package/templates/snow/src/render/heightFog.ts +118 -0
  423. package/templates/snow/src/render/lighting.ts +82 -0
  424. package/templates/snow/src/render/loading.ts +325 -0
  425. package/templates/snow/src/render/materialAssignments.ts +160 -0
  426. package/templates/snow/src/render/materialLighting.ts +155 -0
  427. package/templates/snow/src/render/materials.ts +36 -0
  428. package/templates/snow/src/render/palette.ts +17 -0
  429. package/templates/snow/src/render/postprocessing.ts +58 -0
  430. package/templates/snow/src/render/props.ts +42 -0
  431. package/templates/snow/src/render/quality.ts +193 -0
  432. package/templates/snow/src/render/scenery.ts +244 -0
  433. package/templates/snow/src/render/sky.ts +76 -0
  434. package/templates/snow/src/render/snowSurface.ts +259 -0
  435. package/templates/snow/src/render/touch-controls.ts +143 -0
  436. package/templates/snow/src/render/weather.ts +279 -0
  437. package/templates/snow/src/render/worldEnvironment.ts +1212 -0
  438. package/templates/snow/src/scenes/Boot.ts +12 -0
  439. package/templates/snow/src/scenes/Snow.ts +663 -0
  440. package/templates/snow/src/state.ts +46 -0
  441. package/templates/snow/src/style.css +143 -0
  442. package/templates/snow/src/terrain.ts +64 -0
  443. package/templates/snow/src/ui/App.tsx +15 -0
  444. package/templates/snow/src/ui/Controls.tsx +322 -0
  445. package/templates/snow/src/ui/GameUi.tsx +354 -0
  446. package/templates/snow/src/ui/icons.tsx +54 -0
  447. package/templates/snow/src/ui/main.tsx +7 -0
  448. package/templates/snow/tailwind.config.ts +2 -0
  449. package/templates/snow/threenative.config.ts +54 -0
  450. package/templates/snow/tsconfig.json +17 -0
  451. package/templates/snow/vite.config.ts +45 -0
  452. package/templates/starter/AGENTS.md +11 -16
  453. package/templates/starter/CLAUDE.md +11 -16
  454. package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
  455. package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
  456. package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
  457. package/templates/starter/package.json +11 -9
  458. package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
  459. package/templates/starter/playtests/movement.playtest.json +192 -0
  460. package/templates/starter/playtests/play.playtest.json +18 -2
  461. package/templates/starter/playtests/production-readiness.playtest.json +1 -1
  462. package/templates/starter/public/grade.cube +735 -0
  463. package/templates/starter/src/entities/Crate.ts +4 -0
  464. package/templates/starter/src/entities/Player.ts +79 -18
  465. package/templates/starter/src/game.ts +1 -0
  466. package/templates/starter/src/render/adaptiveQuality.ts +28 -41
  467. package/templates/starter/src/render/autoExposure.ts +225 -0
  468. package/templates/starter/src/render/backlightControls.ts +66 -0
  469. package/templates/starter/src/render/backlightMaterial.ts +147 -0
  470. package/templates/starter/src/render/environmentContribution.ts +188 -0
  471. package/templates/starter/src/render/environmentRadiance.ts +36 -0
  472. package/templates/starter/src/render/environmentSampleCache.ts +43 -0
  473. package/templates/starter/src/render/environmentSampling.ts +193 -0
  474. package/templates/starter/src/render/environmentSnapshot.ts +53 -0
  475. package/templates/starter/src/render/exposure.ts +111 -0
  476. package/templates/starter/src/render/exposureGraph.ts +178 -0
  477. package/templates/starter/src/render/exposureReadback.ts +79 -0
  478. package/templates/starter/src/render/grade.ts +157 -0
  479. package/templates/starter/src/render/heightFog.ts +118 -0
  480. package/templates/starter/src/render/lighting.ts +26 -1
  481. package/templates/starter/src/render/materialAssignments.ts +160 -0
  482. package/templates/starter/src/render/materialLighting.ts +155 -0
  483. package/templates/starter/src/render/postprocessing.ts +84 -4
  484. package/templates/starter/src/render/quality.ts +80 -8
  485. package/templates/starter/src/render/qualityPolicy.ts +54 -0
  486. package/templates/starter/src/render/rendererGate.ts +36 -0
  487. package/templates/starter/src/render/sky.ts +23 -1
  488. package/templates/starter/src/render/temporalAA.ts +197 -0
  489. package/templates/starter/src/render/temporalAAFrame.ts +179 -0
  490. package/templates/starter/src/render/temporalAAHooks.ts +101 -0
  491. package/templates/starter/src/render/temporalAAInput.ts +56 -0
  492. package/templates/starter/src/render/temporalAAResolve.ts +65 -0
  493. package/templates/starter/src/render/temporalAAStage.ts +76 -0
  494. package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
  495. package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
  496. package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
  497. package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
  498. package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
  499. package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
  500. package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
  501. package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
  502. package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
  503. package/templates/starter/src/render/temporalResolve.ts +139 -0
  504. package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
  505. package/templates/starter/src/render/temporalResolveMath.ts +196 -0
  506. package/templates/starter/src/render/volumetricFog.ts +124 -0
  507. package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
  508. package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
  509. package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
  510. package/templates/starter/src/render/worldEnvironment.ts +433 -30
  511. package/templates/starter/src/scenes/Play.ts +110 -1
  512. package/templates/starter/src/state.ts +1 -0
  513. package/templates/starter/src/ui/Hud.tsx +1 -1
  514. package/templates/starter/src/ui/Menu.tsx +1 -1
  515. package/templates/starter/tools/make-grade-lut.mjs +101 -0
  516. package/templates/starter/vite.config.ts +10 -2
  517. package/templates/tower-defense/AGENTS.md +10 -9
  518. package/templates/tower-defense/CLAUDE.md +10 -9
  519. package/templates/tower-defense/package.json +11 -9
  520. package/templates/tower-defense/playtests/performance.playtest.json +7 -1
  521. package/templates/tower-defense/src/render/autoExposure.ts +225 -0
  522. package/templates/tower-defense/src/render/backlightControls.ts +66 -0
  523. package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
  524. package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
  525. package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
  526. package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
  527. package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
  528. package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
  529. package/templates/tower-defense/src/render/exposure.ts +111 -0
  530. package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
  531. package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
  532. package/templates/tower-defense/src/render/lighting.ts +33 -1
  533. package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
  534. package/templates/tower-defense/src/render/materialLighting.ts +155 -0
  535. package/templates/tower-defense/src/render/postprocessing.ts +8 -2
  536. package/templates/tower-defense/src/render/quality.ts +61 -2
  537. package/templates/tower-defense/src/render/shapes.ts +0 -3
  538. package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
  539. package/templates/tower-defense/src/scenes/Battle.ts +65 -2
  540. package/templates/tower-defense/vite.config.ts +10 -2
  541. package/templates/minimal/src/scenes/Boot.ts +0 -5
@@ -0,0 +1,76 @@
1
+ // Generated user source: this kit's `traa` stage. The chain owns stage order, velocity provisioning
2
+ // and the applied report; this file owns the effect, the camera it jitters and the history it
3
+ // disposes. The chain hands the stage the *sampled* velocity texture, while the accessor TRAANode
4
+ // needs for its unjittered projection reaches it separately through the graph context.
5
+ import type { OrthographicCamera, PerspectiveCamera } from "three";
6
+ import type { Node, PassNode, TextureNode } from "three/webgpu";
7
+ import { createTemporalAA } from "./temporalAA.js";
8
+ import type { ITemporalRejectionMeasurement } from "./temporalRejectionCounter.js";
9
+ import type { ChainStage, IWorldEnvironmentStageContext } from "./worldEnvironment.js";
10
+
11
+ export type TemporalResetReason =
12
+ | "initial"
13
+ | "camera-cut"
14
+ | "projection-change"
15
+ | "resize"
16
+ | "scene-reset"
17
+ | "device-loss";
18
+ export interface ITemporalAAReport {
19
+ readonly frame: number;
20
+ readonly historyValid: boolean;
21
+ readonly resetReason: TemporalResetReason | null;
22
+ readonly inputWidth: number;
23
+ readonly inputHeight: number;
24
+ readonly outputWidth: number;
25
+ readonly outputHeight: number;
26
+ /** Absent until a counted copy lands, never a number the provider did not measure. */
27
+ readonly rejection?: ITemporalRejectionMeasurement;
28
+ }
29
+
30
+ /** The live provider, published once the chain has built the stage. */
31
+ export type TemporalAAProvider = ReturnType<typeof createTemporalAA>;
32
+
33
+ /** Where the provider goes, so a scene can read its report or reset history on a teleport. */
34
+ export interface ITemporalAAStageSink {
35
+ onProvider?: (provider: TemporalAAProvider | undefined) => void;
36
+ }
37
+
38
+ /**
39
+ * The `traa` stage this kit can request: pass this factory as `authoredStages` and name `"traa"` in
40
+ * `authoredStageNames`. Nothing runs until it is named, which is why no shipped tier names it.
41
+ */
42
+ export function temporalAAStages(
43
+ context: IWorldEnvironmentStageContext,
44
+ sink: ITemporalAAStageSink = {},
45
+ currentPass?: PassNode,
46
+ ): readonly ChainStage[] {
47
+ const camera = context.camera as PerspectiveCamera | OrthographicCamera;
48
+ let provider: TemporalAAProvider | undefined;
49
+ return [
50
+ {
51
+ name: "traa",
52
+ build: (input, chain) => {
53
+ if (chain.velocityNode === undefined)
54
+ throw new Error(
55
+ "Temporal AA requires the scene pass velocity; it is provisioned per request.",
56
+ );
57
+ provider = createTemporalAA(
58
+ input as Node,
59
+ context.depthNode,
60
+ chain.velocityNode as TextureNode,
61
+ camera,
62
+ currentPass,
63
+ );
64
+ sink.onProvider?.(provider);
65
+ return provider.node;
66
+ },
67
+ // The chain publishes this as its velocity report; a stage that never built has no measurement.
68
+ rejectionMeasurement: () => provider?.rejectionMeasurement(),
69
+ dispose: () => {
70
+ sink.onProvider?.(undefined);
71
+ provider?.dispose();
72
+ provider = undefined;
73
+ },
74
+ },
75
+ ];
76
+ }
@@ -0,0 +1,31 @@
1
+ import { wgslFn } from "three/tsl";
2
+ import { CURRENT_SAMPLE_CELLS } from "./temporalCurrentFootprintMath.js";
3
+
4
+ // A clipped convex pentagon has at most nine vertices after four rectangle halfplanes; twelve
5
+ // slots leave explicit headroom. The same cells and halfplanes feed the independently tested CPU
6
+ // form. WGSL f32 rounding remains a GPU/native qualification obligation.
7
+ const cells = CURRENT_SAMPLE_CELLS.map(
8
+ (cell) => `array<vec2<f32>,5>(${cell.map(([x, y]) => `vec2<f32>(${x},${y})`).join(",")})`,
9
+ ).join(",");
10
+ export const currentSampleArea =
11
+ wgslFn(`fn currentSampleArea(sample: u32, minimum: vec2<f32>, maximum: vec2<f32>) -> f32 {
12
+ let cells = array<array<vec2<f32>,5>,4>(${cells});
13
+ var polygon: array<vec2<f32>,12>; var next: array<vec2<f32>,12>; var count = 5u;
14
+ for (var i = 0u; i < 5u; i++) { polygon[i] = cells[sample][i]; }
15
+ for (var edge = 0u; edge < 4u; edge++) {
16
+ let axis = edge / 2u;
17
+ let bound = select(minimum[axis], maximum[axis], (edge % 2u) == 1u);
18
+ let sign = select(-1.0, 1.0, (edge % 2u) == 1u);
19
+ var length = 0u;
20
+ for (var i = 0u; i < count; i++) {
21
+ let a = polygon[i]; let b = polygon[(i+1u)%count];
22
+ let da = sign*(a[axis]-bound); let db = sign*(b[axis]-bound);
23
+ if (da <= 0.0) { next[length] = a; length++; }
24
+ if ((da > 0.0) != (db > 0.0)) { next[length] = a + (da/(da-db))*(b-a); length++; }
25
+ }
26
+ count = length; polygon = next;
27
+ }
28
+ var area = 0.0;
29
+ for (var i = 0u; i < count; i++) { let a = polygon[i]; let b = polygon[(i+1u)%count]; area += a.x*b.y-a.y*b.x; }
30
+ return abs(area)*0.5;
31
+ }`);
@@ -0,0 +1,198 @@
1
+ import type { OrthographicCamera } from "three";
2
+ // Experimental finite raw4 estimator. The source pass owns all sample views; this allocates none.
3
+ import {
4
+ Fn,
5
+ If,
6
+ float,
7
+ getViewPosition,
8
+ int,
9
+ ivec2,
10
+ struct,
11
+ uint,
12
+ vec2,
13
+ vec4,
14
+ viewZToOrthographicDepth,
15
+ viewZToPerspectiveDepth,
16
+ } from "three/tsl";
17
+ import type { Node, TextureNode } from "three/webgpu";
18
+ import { currentSampleArea } from "./temporalCurrentArea.js";
19
+ import { CURRENT_SAMPLE_POSITIONS } from "./temporalCurrentFootprintMath.js";
20
+ import type { TemporalResolveNode } from "./temporalResolveDepth.js";
21
+ import { reconstructNeighbourhood } from "./temporalResolveMath.js";
22
+
23
+ const colourStruct = struct({ color: "vec4", mean: "vec4", variance: "vec4" });
24
+ const validityStruct = struct({ hasValidHistory: "float", historyUV: "vec2", offsetUV: "vec2" });
25
+ export interface ITemporalCurrentInputs {
26
+ readonly colour: TextureNode;
27
+ readonly motion: TextureNode;
28
+ readonly depth: TextureNode;
29
+ readonly previousDepth: TextureNode;
30
+ }
31
+ /** Raw sample sites are finite radiance observations, with exact coverage/depth ownership and
32
+ * selective sample-frequency alpha. Ordinary opaque RGB remains a spatial approximation. */
33
+ export function createTemporalCurrentFootprint(
34
+ inputs: ITemporalCurrentInputs,
35
+ node: TemporalResolveNode,
36
+ jitter: Node<"vec2">,
37
+ ) {
38
+ const inputSize = vec2(inputs.colour.size(int(0)) as Node<"uvec2">);
39
+ const offsets = [-1, 0, 1].flatMap((y) => [-1, 0, 1].map((x) => [x, y] as const));
40
+ const eligible = (centre: Node<"vec2">, outputSize: Node<"uvec2">) =>
41
+ centre
42
+ .greaterThanEqual(1)
43
+ .all()
44
+ .and(centre.lessThan(inputSize.sub(1)).all())
45
+ .and(inputSize.lessThanEqual(vec2(outputSize)).all())
46
+ .and(inputSize.lessThan(vec2(outputSize)).any());
47
+ const tapArea = (p: Node<"vec2">, half: Node<"vec2">, cell: Node<"vec2">, sample: number) =>
48
+ currentSampleArea(uint(sample), p.sub(half).sub(cell), p.add(half).sub(cell)) as Node<"float">;
49
+
50
+ function reconstruct(pixelUV: Node<"vec2">, outputSize: Node<"uvec2">) {
51
+ const baseline = reconstructNeighbourhood(
52
+ node.beautyNode,
53
+ pixelUV,
54
+ inputSize as unknown as Node<"uvec2">,
55
+ jitter,
56
+ outputSize,
57
+ );
58
+ const p = pixelUV.mul(inputSize).sub(jitter);
59
+ const centre = p.floor();
60
+ const half = inputSize.div(vec2(outputSize)).mul(0.5);
61
+ const color = (baseline.get("color") as Node<"vec4">).toVar();
62
+ const mean = (baseline.get("mean") as Node<"vec4">).toVar();
63
+ const variance = (baseline.get("variance") as Node<"vec4">).toVar();
64
+ If(eligible(centre, outputSize), () => {
65
+ const sum = vec4(0).toVar();
66
+ const squares = vec4(0).toVar();
67
+ const mass = float(0).toVar();
68
+ for (const [x, y] of offsets)
69
+ for (let sample = 0; sample < 4; sample++) {
70
+ const cell = centre.add(vec2(x, y));
71
+ const weight = tapArea(p, half, cell, sample).toVar();
72
+ If(weight.greaterThan(0), () => {
73
+ const value = inputs.colour.load(ivec2(cell)).level(int(sample)).max(0).toVar();
74
+ sum.addAssign(value.mul(weight));
75
+ squares.addAssign(value.pow2().mul(weight));
76
+ mass.addAssign(weight);
77
+ });
78
+ }
79
+ const average = sum.div(mass.max(1e-12));
80
+ color.assign(average);
81
+ mean.assign(average);
82
+ variance.assign(squares.div(mass.max(1e-12)).sub(average.pow2()).max(0).sqrt());
83
+ });
84
+ return colourStruct(color, mean, variance);
85
+ }
86
+
87
+ /** Each of four periodic sites has one nearest integer cell. Exact distance ties retain the
88
+ * former 3×3 row/cell/sample order, including a neighbouring cell winning. */
89
+ function previousDepth(historyPoint: Node<"vec2">) {
90
+ const p = historyPoint.mul(inputSize);
91
+ const centre = p.floor();
92
+ const bestDistance = float(1e6).toVar();
93
+ const bestRank = float(36).toVar();
94
+ const bestCell = centre.toVar();
95
+ const bestSite = vec2(0).toVar();
96
+ const bestIndex = int(0).toVar();
97
+ for (let sample = 0; sample < 4; sample++) {
98
+ const site = vec2(...(CURRENT_SAMPLE_POSITIONS[sample] as readonly [number, number]));
99
+ const cell = p.sub(site).sub(0.5).ceil();
100
+ const delta = p.sub(cell.add(site));
101
+ const distance = delta.dot(delta);
102
+ const relative = cell.sub(centre).add(1);
103
+ const rank = relative.y.mul(12).add(relative.x.mul(4)).add(sample);
104
+ If(
105
+ distance
106
+ .lessThan(bestDistance)
107
+ .or(distance.equal(bestDistance).and(rank.lessThan(bestRank))),
108
+ () => {
109
+ bestDistance.assign(distance);
110
+ bestRank.assign(rank);
111
+ bestCell.assign(cell);
112
+ bestSite.assign(site);
113
+ bestIndex.assign(int(sample));
114
+ },
115
+ );
116
+ }
117
+ const packet = inputs.previousDepth.load(ivec2(bestCell)).toVar();
118
+ const depth = bestIndex
119
+ .equal(0)
120
+ .select(
121
+ packet.r,
122
+ bestIndex.equal(1).select(packet.g, bestIndex.equal(2).select(packet.b, packet.a)),
123
+ ) as Node<"float">;
124
+ const position = getViewPosition(
125
+ bestCell.add(bestSite).div(inputSize),
126
+ depth,
127
+ node._previousCameraProjectionMatrixInverse,
128
+ );
129
+ const world = node._previousCameraWorldMatrix.mul(vec4(position, 1)).xyz;
130
+ const z = node._cameraWorldMatrixInverse.mul(vec4(world, 1)).z;
131
+ const transformed = (node.camera as OrthographicCamera).isOrthographicCamera
132
+ ? viewZToOrthographicDepth(z, node._cameraNearFar.x, node._cameraNearFar.y)
133
+ : viewZToPerspectiveDepth(z, node._cameraNearFar.x, node._cameraNearFar.y);
134
+ return {
135
+ transformed,
136
+ inBounds: bestCell.greaterThanEqual(0).all().and(bestCell.lessThan(inputSize).all()),
137
+ };
138
+ }
139
+
140
+ /** Retain BOTH original legacy vetoes, then add contributor rejection. A new matching sample
141
+ * can never revive a legacy rejection. Resolve and counter consume this one combined equation. */
142
+ function historyValidity(
143
+ pixelUV: Node<"vec2">,
144
+ outputSize: Node<"uvec2">,
145
+ legacy: { get(key: string): Node },
146
+ ) {
147
+ const legal = float(legacy.get("hasValidHistory") as Node<"float">).toVar();
148
+ const historyUV = vec2(legacy.get("historyUV") as Node<"vec2">).toVar();
149
+ const offsetUV = vec2(legacy.get("offsetUV") as Node<"vec2">).toVar();
150
+ const p = pixelUV.mul(inputSize).sub(jitter);
151
+ const centre = p.floor();
152
+ const half = inputSize.div(vec2(outputSize)).mul(0.5);
153
+ const nearest = float(2).toVar();
154
+ If(legal.greaterThan(0.5).and(eligible(centre, outputSize)), () => {
155
+ for (const [x, y] of offsets)
156
+ for (let sample = 0; sample < 4; sample++) {
157
+ const cell = centre.add(vec2(x, y));
158
+ const weight = tapArea(p, half, cell, sample);
159
+ If(weight.greaterThan(0), () => {
160
+ const depth = inputs.depth.load(ivec2(cell)).level(int(sample)).r.toVar();
161
+ const motion = inputs.motion
162
+ .load(ivec2(cell))
163
+ .level(int(sample))
164
+ .xy.mul(vec2(0.5, -0.5))
165
+ .toVar();
166
+ const site = vec2(...(CURRENT_SAMPLE_POSITIONS[sample] as readonly [number, number]));
167
+ const historyPoint = cell
168
+ .add(site)
169
+ .div(inputSize)
170
+ .add(node._currentJitterUV as Node<"vec2">)
171
+ .sub(motion)
172
+ .sub(node._previousJitterUV as Node<"vec2">);
173
+ const prior = previousDepth(historyPoint);
174
+ const donorUV = pixelUV.sub(motion);
175
+ const inBounds = prior.inBounds
176
+ .and(historyPoint.greaterThanEqual(0).all())
177
+ .and(historyPoint.lessThan(1).all())
178
+ .and(donorUV.greaterThanEqual(0).all())
179
+ .and(donorUV.lessThanEqual(1).all());
180
+ If(
181
+ inBounds.not().or(depth.sub(prior.transformed).greaterThan(node.depthThreshold)),
182
+ () => {
183
+ legal.assign(0);
184
+ },
185
+ );
186
+ If(depth.lessThan(nearest), () => {
187
+ nearest.assign(depth);
188
+ offsetUV.assign(motion);
189
+ historyUV.assign(donorUV);
190
+ });
191
+ });
192
+ }
193
+ });
194
+ return validityStruct(legal, historyUV, offsetUV);
195
+ }
196
+ return { reconstruct, historyValidity };
197
+ }
198
+ export type TemporalCurrentFootprint = ReturnType<typeof createTemporalCurrentFootprint>;
@@ -0,0 +1,41 @@
1
+ // Finite current estimator: piecewise constant radiance on the periodic raw4 Voronoi cells.
2
+ // Opaque PBR is still pixel-frequency radiance broadcast to covered sites: an explicit spatial
3
+ // approximation. These areas do not claim the exact continuous material integral.
4
+ export const CURRENT_SAMPLE_POSITIONS = [
5
+ [3 / 8, 1 / 8],
6
+ [7 / 8, 3 / 8],
7
+ [1 / 8, 5 / 8],
8
+ [5 / 8, 7 / 8],
9
+ ] as const;
10
+ type Point = readonly [number, number];
11
+
12
+ export const CURRENT_SAMPLE_CELLS: readonly (readonly Point[])[] = [
13
+ [
14
+ [1 / 6, 1 / 3],
15
+ [0, 0],
16
+ [1 / 3, -1 / 6],
17
+ [2 / 3, 1 / 6],
18
+ [1 / 2, 1 / 2],
19
+ ],
20
+ [
21
+ [5 / 6, 2 / 3],
22
+ [1 / 2, 1 / 2],
23
+ [2 / 3, 1 / 6],
24
+ [1, 0],
25
+ [7 / 6, 1 / 3],
26
+ ],
27
+ [
28
+ [0, 1],
29
+ [-1 / 6, 2 / 3],
30
+ [1 / 6, 1 / 3],
31
+ [1 / 2, 1 / 2],
32
+ [1 / 3, 5 / 6],
33
+ ],
34
+ [
35
+ [1 / 3, 5 / 6],
36
+ [1 / 2, 1 / 2],
37
+ [5 / 6, 2 / 3],
38
+ [1, 1],
39
+ [2 / 3, 7 / 6],
40
+ ],
41
+ ];
@@ -0,0 +1,161 @@
1
+ // Isolated opt-in raw4 producer. No quality tier or fixed raster selects it. The existing pass
2
+ // scale determines actual sizes; unsupported, native-size and custom inputs use the ordinary lane.
3
+ import { type Material, Scene, Vector2 } from "three";
4
+ import { context, velocity } from "three/tsl";
5
+ import { type Node, type PassNode, type Renderer, RendererUtils } from "three/webgpu";
6
+ import type { ITemporalCurrentInputs } from "./temporalCurrentFootprint.js";
7
+ import { createTemporalCurrentReplay } from "./temporalCurrentReplay.js";
8
+ import { type IRawPass, currentPassEligible } from "./temporalCurrentSelection.js";
9
+ const selectivePolicy = Object.freeze({
10
+ invariantPosition: true,
11
+ sampleInterpolation: (material: Material) => material.alphaTest > 0,
12
+ });
13
+
14
+ export function createTemporalCurrentProducer(
15
+ beauty: PassNode,
16
+ sharedMotion: Node<"vec2"> = velocity as unknown as Node<"vec2">,
17
+ ) {
18
+ if (!(beauty.scene instanceof Scene)) throw new Error("Current footprint requires a scene pass.");
19
+ const sourceScene = beauty.scene;
20
+ const sourceCamera = beauty.camera;
21
+ const sourceTarget = beauty.renderTarget;
22
+ const samples = beauty.renderTarget.samples;
23
+ const originalContext = beauty.contextNode;
24
+ const options = (beauty as IRawPass).options;
25
+ const originalSamplesOption = options.samples;
26
+ if (samples > 1 || beauty.overrideMaterial !== null)
27
+ throw new Error("Current footprint requires an ordinary owned scene pass.");
28
+ const replay = createTemporalCurrentReplay(beauty);
29
+ const originalDraw = beauty.updateBefore;
30
+ beauty.renderTarget.samples = 4;
31
+ const rawColour = (beauty as IRawPass).getRawTextureNode();
32
+ beauty.renderTarget.samples = samples;
33
+ const buffer = new Vector2();
34
+ let active = false;
35
+ let disposed = false;
36
+ let changed: ((renderer: Renderer, active: boolean) => void) | undefined;
37
+ let failed: (() => void) | undefined;
38
+ let ownedContext: typeof beauty.contextNode = null;
39
+
40
+ function restorePolicy() {
41
+ if (sourceTarget.samples === 4) {
42
+ sourceTarget.dispose();
43
+ sourceTarget.samples = samples;
44
+ }
45
+ if (options.samples === 4) {
46
+ if (originalSamplesOption === undefined) Reflect.deleteProperty(options, "samples");
47
+ else options.samples = originalSamplesOption;
48
+ }
49
+ if (beauty.contextNode === ownedContext) beauty.contextNode = originalContext;
50
+ beauty.needsUpdate = true;
51
+ }
52
+
53
+ function switchMode(renderer: Renderer, next: boolean) {
54
+ if (next === active) return;
55
+ if (next) {
56
+ beauty.renderTarget.dispose();
57
+ beauty.renderTarget.samples = 4;
58
+ options.samples = 4;
59
+ ownedContext = context(selectivePolicy);
60
+ beauty.contextNode = ownedContext;
61
+ beauty.needsUpdate = true;
62
+ } else restorePolicy();
63
+ active = next;
64
+ replay.setActive(next);
65
+ if (!next) replay.release();
66
+ changed?.(renderer, next);
67
+ }
68
+
69
+ const ownedDraw: typeof beauty.updateBefore = (frame) => {
70
+ if (disposed || frame.renderer === null)
71
+ throw new Error("Current footprint producer is disposed or has no renderer.");
72
+ const renderer = frame.renderer;
73
+ const scene = sourceScene;
74
+ renderer.getDrawingBufferSize(buffer);
75
+ const scale = beauty.getResolutionScale();
76
+ const width = Math.floor(buffer.x * scale);
77
+ const height = Math.floor(buffer.y * scale);
78
+ const sourceMotion = beauty.getMRT()?.get("velocity");
79
+ const policyOwned =
80
+ beauty.renderTarget === sourceTarget &&
81
+ (beauty as IRawPass).options === options &&
82
+ originalContext === null &&
83
+ beauty.contextNode === (active ? ownedContext : originalContext) &&
84
+ beauty.renderTarget.samples === (active ? 4 : samples) &&
85
+ options.samples === (active ? 4 : originalSamplesOption);
86
+ const eligible =
87
+ beauty.scene === sourceScene &&
88
+ beauty.camera === sourceCamera &&
89
+ beauty.overrideMaterial === null &&
90
+ policyOwned &&
91
+ currentPassEligible(beauty, renderer, buffer, width, height, sharedMotion);
92
+ switchMode(renderer, eligible);
93
+ if (!active) {
94
+ // Preserve every ordinary callback/scene mutation; the wrapper has changed no draw state.
95
+ try {
96
+ return originalDraw.call(beauty, frame);
97
+ } catch (error) {
98
+ failed?.();
99
+ throw error;
100
+ }
101
+ }
102
+ const saved = RendererUtils.saveRendererState(renderer);
103
+ const savedContext = renderer.contextNode;
104
+ const savedName = scene.name;
105
+ const savedOverride = scene.overrideMaterial;
106
+ const savedBackground = scene.background;
107
+ const savedLayers = beauty.camera.layers.mask;
108
+ const savedOpaque = renderer.opaque;
109
+ const savedTransparent = renderer.transparent;
110
+ try {
111
+ originalDraw.call(beauty, frame);
112
+ replay.draw(frame, width, height, scale, sourceMotion as Node<"vec2">);
113
+ } catch (error) {
114
+ // A scene/replay failure can precede the temporal node's own updateBefore. Its next successful
115
+ // frame must not reuse colour/depth from before the camera's motion bookkeeping advanced.
116
+ failed?.();
117
+ throw error;
118
+ } finally {
119
+ scene.background = savedBackground;
120
+ scene.name = savedName;
121
+ scene.overrideMaterial = savedOverride;
122
+ beauty.camera.layers.mask = savedLayers;
123
+ renderer.opaque = savedOpaque;
124
+ renderer.transparent = savedTransparent;
125
+ renderer.contextNode = savedContext;
126
+ RendererUtils.restoreRendererState(renderer, saved);
127
+ }
128
+ };
129
+ beauty.updateBefore = ownedDraw;
130
+
131
+ return {
132
+ depth: replay.depth,
133
+ motion: replay.motion,
134
+ inputs: { colour: rawColour, ...replay.inputs } satisfies ITemporalCurrentInputs,
135
+ active: () => active,
136
+ onModeChange: (callback: typeof changed) => {
137
+ changed = callback;
138
+ },
139
+ onFailure: (callback: typeof failed) => {
140
+ failed = callback;
141
+ },
142
+ /** Queue after BOTH resolve and counter readers; never copy a multisampled depth to a scalar. */
143
+ publishDepth: (renderer: Renderer) => {
144
+ if (!active) return;
145
+ replay.publishDepth(renderer);
146
+ },
147
+ /** Conservative candidate input/history168L plus proven-needed centre replay16L; display
148
+ * resolve/history16N are separate. Format/native allocator overhead is not included. */
149
+ storageBytes: () => (active ? beauty.renderTarget.width * beauty.renderTarget.height * 184 : 0),
150
+ dispose: () => {
151
+ if (disposed) return;
152
+ disposed = true;
153
+ if (beauty.updateBefore === ownedDraw) beauty.updateBefore = originalDraw;
154
+ if (active) restorePolicy();
155
+ replay.dispose();
156
+ changed = undefined;
157
+ failed = undefined;
158
+ },
159
+ };
160
+ }
161
+ export type TemporalCurrentProducer = ReturnType<typeof createTemporalCurrentProducer>;
@@ -0,0 +1,160 @@
1
+ // Owned private passes: matched sample visibility, centre replay and four-depth packet export.
2
+ import { Color, FloatType, type Material, NearestFilter, type Scene } from "three";
3
+ import { context, int, ivec2, pass, texture, uv, vec4 } from "three/tsl";
4
+ import {
5
+ MeshBasicNodeMaterial,
6
+ type Node,
7
+ type NodeFrame,
8
+ type PassNode,
9
+ QuadMesh,
10
+ RenderTarget,
11
+ type Renderer,
12
+ RendererUtils,
13
+ } from "three/webgpu";
14
+ import type { IRawPass } from "./temporalCurrentSelection.js";
15
+ import { currentVisibilityMaterial } from "./temporalCurrentVisibility.js";
16
+ export function createTemporalCurrentReplay(beauty: PassNode) {
17
+ const scene = beauty.scene as Scene;
18
+ const visibility = pass(beauty.scene, beauty.camera, { samples: 4 }) as IRawPass;
19
+ const centre = pass(beauty.scene, beauty.camera, { samples: 0 });
20
+ visibility.contextNode = context({ invariantPosition: true, sampleInterpolation: true });
21
+ centre.contextNode = context({ invariantPosition: true });
22
+ // The beauty wrapper schedules both private traversals, once after its frozen input draw.
23
+ // Their borrowed texture dependencies must not trigger independent traversals later in a quad.
24
+ const drawVisibility = visibility.updateBefore.bind(visibility);
25
+ const drawCentre = centre.updateBefore.bind(centre);
26
+ visibility.updateBefore = () => {};
27
+ centre.updateBefore = () => {};
28
+ const rawMotion = visibility.getRawTextureNode();
29
+ const rawDepth = visibility.getRawTextureNode("depth");
30
+ const centreDepth = texture(centre.getTexture("depth"));
31
+ const centreMotion = texture(centre.getTexture("output"));
32
+ const centreDepthOwner = centreDepth.value;
33
+ const centreMotionOwner = centreMotion.value;
34
+ centreDepth.value = beauty.getTextureNode("depth").value;
35
+ centreMotion.value = beauty.getTextureNode("velocity").value;
36
+ const previous = new RenderTarget(1, 1, {
37
+ type: FloatType,
38
+ minFilter: NearestFilter,
39
+ magFilter: NearestFilter,
40
+ depthBuffer: false,
41
+ });
42
+ previous.texture.name = "Temporal previous four-site depth";
43
+ const packetMaterial = new MeshBasicNodeMaterial();
44
+ const packetUV = ivec2(uv().mul(rawDepth.size(int(0)) as Node<"uvec2">));
45
+ // This is a depth packet, not opaque colour: preserve channel3 instead of forcing alpha=1.
46
+ packetMaterial.fragmentNode = vec4(
47
+ ...([0, 1, 2, 3].map((sample) => rawDepth.load(packetUV).level(int(sample)).r) as [
48
+ Node<"float">,
49
+ Node<"float">,
50
+ Node<"float">,
51
+ Node<"float">,
52
+ ]),
53
+ );
54
+ packetMaterial.fog = false;
55
+ const packetQuad = new QuadMesh(packetMaterial);
56
+ const materials = new Map<
57
+ Material,
58
+ {
59
+ material: ReturnType<typeof currentVisibilityMaterial>;
60
+ version: number;
61
+ motion: Node<"vec2">;
62
+ }
63
+ >();
64
+ function release() {
65
+ visibility.renderTarget.dispose();
66
+ centre.renderTarget.dispose();
67
+ previous.dispose();
68
+ for (const entry of materials.values()) entry.material.dispose();
69
+ materials.clear();
70
+ // Material disposal releases compiled draw bindings/pipelines and permits later reuse.
71
+ packetMaterial.dispose();
72
+ }
73
+ return {
74
+ depth: centreDepth,
75
+ motion: centreMotion,
76
+ inputs: { motion: rawMotion, depth: rawDepth, previousDepth: texture(previous.texture) },
77
+ setActive: (next: boolean) => {
78
+ centreDepth.value = next ? centreDepthOwner : beauty.getTextureNode("depth").value;
79
+ centreMotion.value = next ? centreMotionOwner : beauty.getTextureNode("velocity").value;
80
+ },
81
+ draw: (
82
+ frame: NodeFrame,
83
+ width: number,
84
+ height: number,
85
+ scale: number,
86
+ sourceMotion: Node<"vec2">,
87
+ ) => {
88
+ if (frame.renderer === null) throw new Error("Replay requires a renderer.");
89
+ const renderer = frame.renderer;
90
+ visibility.setResolutionScale(scale);
91
+ centre.setResolutionScale(scale);
92
+ const layers = beauty.getLayers();
93
+ visibility.setLayers(layers);
94
+ centre.setLayers(layers);
95
+ visibility.opaque = centre.opaque = beauty.opaque;
96
+ visibility.transparent = centre.transparent = beauty.transparent;
97
+ // Original list sorting uses original material IDs/order. Only the draw's material changes.
98
+ renderer.setRenderObjectFunction(
99
+ (object, drawScene, camera, geometry, source, group, lights, clipping, passId) => {
100
+ let entry = materials.get(source);
101
+ if (
102
+ entry === undefined ||
103
+ entry.version !== source.version ||
104
+ entry.motion !== sourceMotion
105
+ ) {
106
+ entry?.material.dispose();
107
+ entry = {
108
+ material: currentVisibilityMaterial(renderer, source, sourceMotion as Node<"vec2">),
109
+ version: source.version,
110
+ motion: sourceMotion as Node<"vec2">,
111
+ };
112
+ materials.set(source, entry);
113
+ } else {
114
+ // NodeLibrary performs this same material transfer. Numeric edits need not bump version.
115
+ for (const key in source)
116
+ if (!/^(?:id|uuid|version|type|_)|^(?:is[A-Z])/.test(key))
117
+ Reflect.set(entry.material, key, Reflect.get(source, key));
118
+ entry.material.alphaTest = source.alphaTest;
119
+ entry.material.fog = false;
120
+ }
121
+ renderer.renderObject(
122
+ object,
123
+ drawScene,
124
+ camera,
125
+ geometry,
126
+ entry.material,
127
+ group,
128
+ lights,
129
+ clipping,
130
+ passId,
131
+ );
132
+ },
133
+ );
134
+ scene.background = null;
135
+ renderer.setClearColor(new Color(0), 1);
136
+ drawVisibility(frame);
137
+ drawCentre(frame);
138
+ previous.setSize(width, height);
139
+ renderer.initRenderTarget(previous);
140
+ },
141
+ publishDepth: (renderer: Renderer) => {
142
+ const saved = RendererUtils.saveRendererState(renderer);
143
+ try {
144
+ renderer.setRenderTarget(previous);
145
+ packetQuad.render(renderer);
146
+ } finally {
147
+ RendererUtils.restoreRendererState(renderer, saved);
148
+ }
149
+ },
150
+ release,
151
+ dispose: () => {
152
+ visibility.dispose();
153
+ centre.dispose();
154
+ previous.dispose();
155
+ packetMaterial.dispose();
156
+ for (const entry of materials.values()) entry.material.dispose();
157
+ materials.clear();
158
+ },
159
+ };
160
+ }