create-threenative 0.2.8 → 0.2.10

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 (431) hide show
  1. package/agent-docs/references/assertion-reference.md +87 -35
  2. package/agent-docs/references/auto-exposure.md +57 -0
  3. package/agent-docs/references/capability-reference.md +1097 -23
  4. package/agent-docs/references/debug-surface.md +6 -0
  5. package/agent-docs/references/finding-assets.md +46 -10
  6. package/agent-docs/references/performance-basics.md +5 -4
  7. package/agent-docs/references/terrain-authoring.md +140 -0
  8. package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
  9. package/capabilities.json +1210 -27
  10. package/dist/index.d.ts +28 -3
  11. package/dist/index.js +396 -166
  12. package/dist/threenative.js +986 -235
  13. package/dist/web-engine-buffer-geometry-utils.js +281 -0
  14. package/dist/web-engine-decal-geometry.js +184 -0
  15. package/dist/web-engine-gltf-loader.js +196 -0
  16. package/dist/web-engine-hdr-loader.js +190 -0
  17. package/dist/web-engine-lut-cube-loader.js +122 -0
  18. package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
  19. package/dist/web-engine-mesh-bvh.js +32 -0
  20. package/dist/web-engine-post-effects.js +168 -0
  21. package/dist/web-engine-runtime.js +42506 -0
  22. package/package.json +11 -8
  23. package/template-assets/autoExposure.ts +225 -0
  24. package/template-assets/exposure.ts +111 -0
  25. package/template-assets/exposureGraph.ts +178 -0
  26. package/template-assets/exposureReadback.ts +79 -0
  27. package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
  28. package/template-assets/patches/three@0.185.1.patch +6594 -700
  29. package/template-assets/patches/vite@8.2.0.patch +422 -0
  30. package/template-assets/worldEnvironment.ts +433 -30
  31. package/templates/action-rpg/AGENTS.md +11 -10
  32. package/templates/action-rpg/CLAUDE.md +11 -10
  33. package/templates/action-rpg/package.json +13 -10
  34. package/templates/action-rpg/playtests/performance.playtest.json +7 -1
  35. package/templates/action-rpg/src/progress.ts +0 -4
  36. package/templates/action-rpg/src/render/autoExposure.ts +225 -0
  37. package/templates/action-rpg/src/render/backlightControls.ts +66 -0
  38. package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
  39. package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
  40. package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
  41. package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
  42. package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
  43. package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
  44. package/templates/action-rpg/src/render/exposure.ts +111 -0
  45. package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
  46. package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
  47. package/templates/action-rpg/src/render/heightFog.ts +118 -0
  48. package/templates/action-rpg/src/render/lighting.ts +26 -1
  49. package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
  50. package/templates/action-rpg/src/render/materialLighting.ts +155 -0
  51. package/templates/action-rpg/src/render/postprocessing.ts +17 -2
  52. package/templates/action-rpg/src/render/quality.ts +61 -2
  53. package/templates/action-rpg/src/render/sky.ts +21 -1
  54. package/templates/action-rpg/src/render/vfx.ts +133 -58
  55. package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
  56. package/templates/action-rpg/src/scenes/Play.ts +81 -16
  57. package/templates/action-rpg/threenative.config.ts +3 -0
  58. package/templates/action-rpg/vite.config.ts +10 -2
  59. package/templates/minimal/AGENTS.md +9 -10
  60. package/templates/minimal/CLAUDE.md +9 -10
  61. package/templates/minimal/package.json +11 -9
  62. package/templates/minimal/playtests/play.playtest.json +7 -1
  63. package/templates/minimal/playtests/sky.playtest.json +10 -1
  64. package/templates/minimal/src/render/autoExposure.ts +225 -0
  65. package/templates/minimal/src/render/backlightControls.ts +66 -0
  66. package/templates/minimal/src/render/backlightMaterial.ts +147 -0
  67. package/templates/minimal/src/render/environmentContribution.ts +188 -0
  68. package/templates/minimal/src/render/environmentRadiance.ts +36 -0
  69. package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
  70. package/templates/minimal/src/render/environmentSampling.ts +193 -0
  71. package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
  72. package/templates/minimal/src/render/exposure.ts +111 -0
  73. package/templates/minimal/src/render/exposureGraph.ts +178 -0
  74. package/templates/minimal/src/render/exposureReadback.ts +79 -0
  75. package/templates/minimal/src/render/heightFog.ts +118 -0
  76. package/templates/minimal/src/render/lighting.ts +25 -1
  77. package/templates/minimal/src/render/materialAssignments.ts +102 -0
  78. package/templates/minimal/src/render/materialLighting.ts +146 -0
  79. package/templates/minimal/src/render/postprocessing.ts +16 -2
  80. package/templates/minimal/src/render/quality.ts +60 -2
  81. package/templates/minimal/src/render/sky.ts +21 -1
  82. package/templates/minimal/src/render/worldEnvironment.ts +433 -30
  83. package/templates/minimal/src/scenes/Play.ts +50 -1
  84. package/templates/minimal/vite.config.ts +10 -2
  85. package/templates/platformer/AGENTS.md +7 -5
  86. package/templates/platformer/CLAUDE.md +7 -5
  87. package/templates/platformer/package.json +13 -10
  88. package/templates/platformer/playtests/performance.playtest.json +7 -1
  89. package/templates/platformer/src/render/autoExposure.ts +225 -0
  90. package/templates/platformer/src/render/backlightControls.ts +66 -0
  91. package/templates/platformer/src/render/backlightMaterial.ts +147 -0
  92. package/templates/platformer/src/render/environmentContribution.ts +188 -0
  93. package/templates/platformer/src/render/environmentRadiance.ts +36 -0
  94. package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
  95. package/templates/platformer/src/render/environmentSampling.ts +193 -0
  96. package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
  97. package/templates/platformer/src/render/exposure.ts +111 -0
  98. package/templates/platformer/src/render/exposureGraph.ts +178 -0
  99. package/templates/platformer/src/render/exposureReadback.ts +79 -0
  100. package/templates/platformer/src/render/heightFog.ts +118 -0
  101. package/templates/platformer/src/render/lighting.ts +26 -1
  102. package/templates/platformer/src/render/materialAssignments.ts +160 -0
  103. package/templates/platformer/src/render/materialLighting.ts +155 -0
  104. package/templates/platformer/src/render/materials.ts +7 -2
  105. package/templates/platformer/src/render/palette.ts +3 -3
  106. package/templates/platformer/src/render/postprocessing.ts +17 -2
  107. package/templates/platformer/src/render/quality.ts +61 -2
  108. package/templates/platformer/src/render/sky.ts +72 -23
  109. package/templates/platformer/src/render/skyEnvironment.ts +50 -0
  110. package/templates/platformer/src/render/worldEnvironment.ts +433 -30
  111. package/templates/platformer/src/scenes/Play.ts +70 -6
  112. package/templates/platformer/vite.config.ts +10 -2
  113. package/templates/puzzle/AGENTS.md +10 -9
  114. package/templates/puzzle/CLAUDE.md +10 -9
  115. package/templates/puzzle/package.json +13 -10
  116. package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
  117. package/templates/puzzle/playtests/lit.playtest.json +7 -1
  118. package/templates/puzzle/playtests/performance.playtest.json +7 -1
  119. package/templates/puzzle/src/render/autoExposure.ts +225 -0
  120. package/templates/puzzle/src/render/backlightControls.ts +66 -0
  121. package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
  122. package/templates/puzzle/src/render/environmentContribution.ts +188 -0
  123. package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
  124. package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
  125. package/templates/puzzle/src/render/environmentSampling.ts +193 -0
  126. package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
  127. package/templates/puzzle/src/render/exposure.ts +111 -0
  128. package/templates/puzzle/src/render/exposureGraph.ts +178 -0
  129. package/templates/puzzle/src/render/exposureReadback.ts +79 -0
  130. package/templates/puzzle/src/render/heightFog.ts +118 -0
  131. package/templates/puzzle/src/render/lighting.ts +33 -1
  132. package/templates/puzzle/src/render/materialAssignments.ts +160 -0
  133. package/templates/puzzle/src/render/materialLighting.ts +155 -0
  134. package/templates/puzzle/src/render/materials.ts +1 -1
  135. package/templates/puzzle/src/render/postprocessing.ts +8 -2
  136. package/templates/puzzle/src/render/quality.ts +62 -1
  137. package/templates/puzzle/src/render/sky.ts +20 -1
  138. package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
  139. package/templates/puzzle/src/scenes/Play.ts +51 -2
  140. package/templates/puzzle/vite.config.ts +10 -2
  141. package/templates/racing/AGENTS.md +8 -7
  142. package/templates/racing/CLAUDE.md +8 -7
  143. package/templates/racing/package.json +13 -10
  144. package/templates/racing/playtests/performance.playtest.json +7 -1
  145. package/templates/racing/playtests/survives.playtest.json +6 -0
  146. package/templates/racing/src/render/autoExposure.ts +225 -0
  147. package/templates/racing/src/render/backlightControls.ts +66 -0
  148. package/templates/racing/src/render/backlightMaterial.ts +147 -0
  149. package/templates/racing/src/render/environmentContribution.ts +188 -0
  150. package/templates/racing/src/render/environmentRadiance.ts +36 -0
  151. package/templates/racing/src/render/environmentSampleCache.ts +43 -0
  152. package/templates/racing/src/render/environmentSampling.ts +193 -0
  153. package/templates/racing/src/render/environmentSnapshot.ts +53 -0
  154. package/templates/racing/src/render/exposure.ts +111 -0
  155. package/templates/racing/src/render/exposureGraph.ts +178 -0
  156. package/templates/racing/src/render/exposureReadback.ts +79 -0
  157. package/templates/racing/src/render/heightFog.ts +118 -0
  158. package/templates/racing/src/render/lighting.ts +29 -1
  159. package/templates/racing/src/render/materialAssignments.ts +160 -0
  160. package/templates/racing/src/render/materialLighting.ts +155 -0
  161. package/templates/racing/src/render/palette.ts +1 -10
  162. package/templates/racing/src/render/postprocessing.ts +17 -2
  163. package/templates/racing/src/render/quality.ts +61 -2
  164. package/templates/racing/src/render/shapes.ts +0 -25
  165. package/templates/racing/src/render/sky.ts +25 -5
  166. package/templates/racing/src/render/worldEnvironment.ts +433 -30
  167. package/templates/racing/src/scenes/Race.ts +110 -13
  168. package/templates/racing/src/track/circuit.ts +0 -9
  169. package/templates/racing/vite.config.ts +10 -2
  170. package/templates/rain/AGENTS.md +8 -9
  171. package/templates/rain/CLAUDE.md +8 -9
  172. package/templates/rain/native-playtests/boot.playtest.json +11 -1
  173. package/templates/rain/package.json +14 -10
  174. package/templates/rain/playtests/automation.playtest.json +1 -1
  175. package/templates/rain/playtests/performance.playtest.json +11 -1
  176. package/templates/rain/playtests/tiers.playtest.json +15 -0
  177. package/templates/rain/playtests/weather.playtest.json +1 -1
  178. package/templates/rain/src/game.ts +1 -34
  179. package/templates/rain/src/render/autoExposure.ts +225 -0
  180. package/templates/rain/src/render/exposure.ts +111 -0
  181. package/templates/rain/src/render/exposureGraph.ts +178 -0
  182. package/templates/rain/src/render/exposureReadback.ts +79 -0
  183. package/templates/rain/src/render/postprocessing.ts +3 -0
  184. package/templates/rain/src/render/quality.ts +27 -1
  185. package/templates/rain/src/render/worldEnvironment.ts +433 -30
  186. package/templates/rain/src/scenes/Boot.ts +14 -0
  187. package/templates/rain/src/state.ts +5 -1
  188. package/templates/rain/src/ui/GameUi.tsx +6 -6
  189. package/templates/rain/tools/generate-shaders.mjs +1 -1
  190. package/templates/rain/vite.config.ts +10 -2
  191. package/templates/rts/AGENTS.md +10 -11
  192. package/templates/rts/CLAUDE.md +10 -11
  193. package/templates/rts/package.json +12 -9
  194. package/templates/rts/playtests/performance.playtest.json +7 -1
  195. package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
  196. package/templates/rts/playtests/rts-attack.playtest.json +10 -1
  197. package/templates/rts/playtests/rts-build.playtest.json +10 -1
  198. package/templates/rts/playtests/rts-orders.playtest.json +7 -1
  199. package/templates/rts/playtests/rts-train.playtest.json +10 -1
  200. package/templates/rts/src/render/army.ts +10 -2
  201. package/templates/rts/src/render/autoExposure.ts +225 -0
  202. package/templates/rts/src/render/backlightControls.ts +66 -0
  203. package/templates/rts/src/render/backlightMaterial.ts +147 -0
  204. package/templates/rts/src/render/environmentContribution.ts +188 -0
  205. package/templates/rts/src/render/environmentRadiance.ts +36 -0
  206. package/templates/rts/src/render/environmentSampleCache.ts +43 -0
  207. package/templates/rts/src/render/environmentSampling.ts +193 -0
  208. package/templates/rts/src/render/environmentSnapshot.ts +53 -0
  209. package/templates/rts/src/render/exposure.ts +111 -0
  210. package/templates/rts/src/render/exposureGraph.ts +178 -0
  211. package/templates/rts/src/render/exposureReadback.ts +79 -0
  212. package/templates/rts/src/render/heightFog.ts +118 -0
  213. package/templates/rts/src/render/lighting.ts +26 -1
  214. package/templates/rts/src/render/materialAssignments.ts +160 -0
  215. package/templates/rts/src/render/materialLighting.ts +155 -0
  216. package/templates/rts/src/render/postprocessing.ts +8 -2
  217. package/templates/rts/src/render/quality.ts +61 -2
  218. package/templates/rts/src/render/sky.ts +21 -1
  219. package/templates/rts/src/render/worldEnvironment.ts +433 -30
  220. package/templates/rts/src/scenes/Play.ts +54 -3
  221. package/templates/rts/src/sim/ai.ts +0 -1
  222. package/templates/rts/src/sim/terrain.ts +0 -4
  223. package/templates/rts/vite.config.ts +10 -2
  224. package/templates/runner/AGENTS.md +10 -8
  225. package/templates/runner/CLAUDE.md +10 -8
  226. package/templates/runner/package.json +13 -10
  227. package/templates/runner/playtests/performance.playtest.json +10 -1
  228. package/templates/runner/src/physics.ts +0 -1
  229. package/templates/runner/src/render/autoExposure.ts +225 -0
  230. package/templates/runner/src/render/backlightControls.ts +66 -0
  231. package/templates/runner/src/render/backlightMaterial.ts +147 -0
  232. package/templates/runner/src/render/environmentContribution.ts +188 -0
  233. package/templates/runner/src/render/environmentRadiance.ts +36 -0
  234. package/templates/runner/src/render/environmentSampleCache.ts +43 -0
  235. package/templates/runner/src/render/environmentSampling.ts +193 -0
  236. package/templates/runner/src/render/environmentSnapshot.ts +53 -0
  237. package/templates/runner/src/render/exposure.ts +111 -0
  238. package/templates/runner/src/render/exposureGraph.ts +178 -0
  239. package/templates/runner/src/render/exposureReadback.ts +79 -0
  240. package/templates/runner/src/render/heightFog.ts +118 -0
  241. package/templates/runner/src/render/lighting.ts +26 -1
  242. package/templates/runner/src/render/materialAssignments.ts +160 -0
  243. package/templates/runner/src/render/materialLighting.ts +155 -0
  244. package/templates/runner/src/render/postprocessing.ts +17 -2
  245. package/templates/runner/src/render/quality.ts +61 -2
  246. package/templates/runner/src/render/sky.ts +21 -1
  247. package/templates/runner/src/render/worldEnvironment.ts +433 -30
  248. package/templates/runner/src/scenes/Run.ts +67 -2
  249. package/templates/runner/threenative.config.ts +3 -0
  250. package/templates/runner/vite.config.ts +10 -2
  251. package/templates/sailing/AGENTS.md +14 -13
  252. package/templates/sailing/CLAUDE.md +14 -13
  253. package/templates/sailing/native-playtests/survives.playtest.json +7 -0
  254. package/templates/sailing/package.json +13 -10
  255. package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
  256. package/templates/sailing/src/entities/Ship.ts +38 -18
  257. package/templates/sailing/src/render/autoExposure.ts +225 -0
  258. package/templates/sailing/src/render/backlightControls.ts +66 -0
  259. package/templates/sailing/src/render/backlightMaterial.ts +147 -0
  260. package/templates/sailing/src/render/camera.ts +12 -4
  261. package/templates/sailing/src/render/environmentContribution.ts +188 -0
  262. package/templates/sailing/src/render/environmentRadiance.ts +36 -0
  263. package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
  264. package/templates/sailing/src/render/environmentSampling.ts +193 -0
  265. package/templates/sailing/src/render/environmentSetup.ts +24 -0
  266. package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
  267. package/templates/sailing/src/render/exposure.ts +111 -0
  268. package/templates/sailing/src/render/exposureGraph.ts +178 -0
  269. package/templates/sailing/src/render/exposureReadback.ts +79 -0
  270. package/templates/sailing/src/render/heightFog.ts +118 -0
  271. package/templates/sailing/src/render/lighting.ts +26 -1
  272. package/templates/sailing/src/render/materialAssignments.ts +160 -0
  273. package/templates/sailing/src/render/materialLighting.ts +155 -0
  274. package/templates/sailing/src/render/ocean.ts +71 -53
  275. package/templates/sailing/src/render/postprocessing.ts +16 -2
  276. package/templates/sailing/src/render/props.ts +0 -45
  277. package/templates/sailing/src/render/quality.ts +61 -1
  278. package/templates/sailing/src/render/sky.ts +21 -1
  279. package/templates/sailing/src/render/worldEnvironment.ts +433 -30
  280. package/templates/sailing/src/scenes/Boot.ts +12 -1
  281. package/templates/sailing/src/scenes/Sailing.ts +87 -2
  282. package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
  283. package/templates/sailing/threenative.config.ts +3 -0
  284. package/templates/sailing/vite.config.ts +10 -2
  285. package/templates/shooter/AGENTS.md +8 -6
  286. package/templates/shooter/CLAUDE.md +8 -6
  287. package/templates/shooter/package.json +13 -10
  288. package/templates/shooter/playtests/performance.playtest.json +7 -1
  289. package/templates/shooter/src/entities/Enemy.ts +0 -15
  290. package/templates/shooter/src/entities/Rifle.ts +38 -1
  291. package/templates/shooter/src/render/autoExposure.ts +225 -0
  292. package/templates/shooter/src/render/backlightControls.ts +66 -0
  293. package/templates/shooter/src/render/backlightMaterial.ts +147 -0
  294. package/templates/shooter/src/render/camera.ts +1 -12
  295. package/templates/shooter/src/render/decals.ts +299 -5
  296. package/templates/shooter/src/render/environmentContribution.ts +188 -0
  297. package/templates/shooter/src/render/environmentRadiance.ts +36 -0
  298. package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
  299. package/templates/shooter/src/render/environmentSampling.ts +193 -0
  300. package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
  301. package/templates/shooter/src/render/exposure.ts +111 -0
  302. package/templates/shooter/src/render/exposureGraph.ts +178 -0
  303. package/templates/shooter/src/render/exposureReadback.ts +79 -0
  304. package/templates/shooter/src/render/gunfx.ts +0 -1
  305. package/templates/shooter/src/render/heightFog.ts +118 -0
  306. package/templates/shooter/src/render/lighting.ts +26 -1
  307. package/templates/shooter/src/render/materialAssignments.ts +160 -0
  308. package/templates/shooter/src/render/materialLighting.ts +155 -0
  309. package/templates/shooter/src/render/postprocessing.ts +17 -2
  310. package/templates/shooter/src/render/quality.ts +61 -2
  311. package/templates/shooter/src/render/scale.ts +2 -93
  312. package/templates/shooter/src/render/sky.ts +21 -1
  313. package/templates/shooter/src/render/vehicles.ts +0 -17
  314. package/templates/shooter/src/render/worldEnvironment.ts +433 -30
  315. package/templates/shooter/src/scenes/Play.ts +64 -2
  316. package/templates/shooter/vite.config.ts +10 -2
  317. package/templates/snow/AGENTS.md +8 -6
  318. package/templates/snow/CLAUDE.md +8 -6
  319. package/templates/snow/package.json +13 -10
  320. package/templates/snow/src/render/autoExposure.ts +225 -0
  321. package/templates/snow/src/render/backlightControls.ts +66 -0
  322. package/templates/snow/src/render/backlightMaterial.ts +147 -0
  323. package/templates/snow/src/render/environmentContribution.ts +188 -0
  324. package/templates/snow/src/render/environmentRadiance.ts +36 -0
  325. package/templates/snow/src/render/environmentSampleCache.ts +43 -0
  326. package/templates/snow/src/render/environmentSampling.ts +193 -0
  327. package/templates/snow/src/render/environmentSnapshot.ts +53 -0
  328. package/templates/snow/src/render/exposure.ts +111 -0
  329. package/templates/snow/src/render/exposureGraph.ts +178 -0
  330. package/templates/snow/src/render/exposureReadback.ts +79 -0
  331. package/templates/snow/src/render/heightFog.ts +118 -0
  332. package/templates/snow/src/render/lighting.ts +33 -1
  333. package/templates/snow/src/render/materialAssignments.ts +160 -0
  334. package/templates/snow/src/render/materialLighting.ts +155 -0
  335. package/templates/snow/src/render/postprocessing.ts +16 -2
  336. package/templates/snow/src/render/quality.ts +59 -1
  337. package/templates/snow/src/render/sky.ts +21 -2
  338. package/templates/snow/src/render/worldEnvironment.ts +433 -30
  339. package/templates/snow/src/scenes/Snow.ts +29 -1
  340. package/templates/snow/threenative.config.ts +3 -0
  341. package/templates/snow/vite.config.ts +10 -2
  342. package/templates/starter/AGENTS.md +11 -16
  343. package/templates/starter/CLAUDE.md +11 -16
  344. package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
  345. package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
  346. package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
  347. package/templates/starter/package.json +13 -10
  348. package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
  349. package/templates/starter/playtests/movement.playtest.json +192 -0
  350. package/templates/starter/playtests/play.playtest.json +18 -2
  351. package/templates/starter/playtests/production-readiness.playtest.json +43 -1
  352. package/templates/starter/public/grade.cube +735 -0
  353. package/templates/starter/src/entities/Crate.ts +4 -0
  354. package/templates/starter/src/entities/Player.ts +79 -18
  355. package/templates/starter/src/game.ts +1 -0
  356. package/templates/starter/src/render/adaptiveQuality.ts +28 -41
  357. package/templates/starter/src/render/autoExposure.ts +225 -0
  358. package/templates/starter/src/render/backlightControls.ts +66 -0
  359. package/templates/starter/src/render/backlightMaterial.ts +147 -0
  360. package/templates/starter/src/render/environmentContribution.ts +188 -0
  361. package/templates/starter/src/render/environmentRadiance.ts +36 -0
  362. package/templates/starter/src/render/environmentSampleCache.ts +43 -0
  363. package/templates/starter/src/render/environmentSampling.ts +193 -0
  364. package/templates/starter/src/render/environmentSnapshot.ts +53 -0
  365. package/templates/starter/src/render/exposure.ts +111 -0
  366. package/templates/starter/src/render/exposureGraph.ts +178 -0
  367. package/templates/starter/src/render/exposureReadback.ts +79 -0
  368. package/templates/starter/src/render/grade.ts +157 -0
  369. package/templates/starter/src/render/heightFog.ts +118 -0
  370. package/templates/starter/src/render/lighting.ts +26 -1
  371. package/templates/starter/src/render/materialAssignments.ts +160 -0
  372. package/templates/starter/src/render/materialLighting.ts +155 -0
  373. package/templates/starter/src/render/postprocessing.ts +90 -4
  374. package/templates/starter/src/render/quality.ts +80 -8
  375. package/templates/starter/src/render/qualityPolicy.ts +54 -0
  376. package/templates/starter/src/render/rendererGate.ts +36 -0
  377. package/templates/starter/src/render/sky.ts +23 -1
  378. package/templates/starter/src/render/temporalAA.ts +197 -0
  379. package/templates/starter/src/render/temporalAAFrame.ts +179 -0
  380. package/templates/starter/src/render/temporalAAHooks.ts +101 -0
  381. package/templates/starter/src/render/temporalAAInput.ts +56 -0
  382. package/templates/starter/src/render/temporalAAResolve.ts +65 -0
  383. package/templates/starter/src/render/temporalAAStage.ts +76 -0
  384. package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
  385. package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
  386. package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
  387. package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
  388. package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
  389. package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
  390. package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
  391. package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
  392. package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
  393. package/templates/starter/src/render/temporalResolve.ts +139 -0
  394. package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
  395. package/templates/starter/src/render/temporalResolveMath.ts +196 -0
  396. package/templates/starter/src/render/volumetricFog.ts +124 -0
  397. package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
  398. package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
  399. package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
  400. package/templates/starter/src/render/worldEnvironment.ts +433 -30
  401. package/templates/starter/src/scenes/Play.ts +110 -1
  402. package/templates/starter/src/state.ts +1 -0
  403. package/templates/starter/src/ui/Hud.tsx +1 -1
  404. package/templates/starter/src/ui/Menu.tsx +1 -1
  405. package/templates/starter/tools/make-grade-lut.mjs +101 -0
  406. package/templates/starter/vite.config.ts +10 -2
  407. package/templates/tower-defense/AGENTS.md +10 -9
  408. package/templates/tower-defense/CLAUDE.md +10 -9
  409. package/templates/tower-defense/package.json +13 -10
  410. package/templates/tower-defense/playtests/performance.playtest.json +7 -1
  411. package/templates/tower-defense/src/render/autoExposure.ts +225 -0
  412. package/templates/tower-defense/src/render/backlightControls.ts +66 -0
  413. package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
  414. package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
  415. package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
  416. package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
  417. package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
  418. package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
  419. package/templates/tower-defense/src/render/exposure.ts +111 -0
  420. package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
  421. package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
  422. package/templates/tower-defense/src/render/lighting.ts +33 -1
  423. package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
  424. package/templates/tower-defense/src/render/materialLighting.ts +155 -0
  425. package/templates/tower-defense/src/render/postprocessing.ts +8 -2
  426. package/templates/tower-defense/src/render/quality.ts +61 -2
  427. package/templates/tower-defense/src/render/shapes.ts +0 -3
  428. package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
  429. package/templates/tower-defense/src/scenes/Battle.ts +65 -2
  430. package/templates/tower-defense/vite.config.ts +10 -2
  431. package/templates/minimal/src/scenes/Boot.ts +0 -5
@@ -0,0 +1,225 @@
1
+ // Generated for you: ordinary Three.js GPU metering; exposure.ts owns the game's look.
2
+ import { type RenderTarget, Texture, Vector2 } from "three";
3
+ import { float, ivec2, nodeObject, texture, textureLoad, uniform, vec4 } from "three/tsl";
4
+ import {
5
+ type Node,
6
+ type NodeBuilder,
7
+ type NodeFrame,
8
+ NodeMaterial,
9
+ NodeUpdateType,
10
+ QuadMesh,
11
+ type Renderer,
12
+ RendererUtils,
13
+ TempNode,
14
+ } from "three/webgpu";
15
+ import {
16
+ type IExposureSettings,
17
+ exposureLuminance,
18
+ exposureMeter,
19
+ exposureReductionSizes,
20
+ validateExposureSettings,
21
+ } from "./exposure.js";
22
+
23
+ import {
24
+ type ColourTexture,
25
+ type Decode,
26
+ type Meter,
27
+ adaptExposure,
28
+ exposureBins,
29
+ exposureTarget,
30
+ exposureTiles,
31
+ histogramExposure,
32
+ histogramTiles,
33
+ reduceExposure,
34
+ } from "./exposureGraph.js";
35
+ import { ExposureReadback } from "./exposureReadback.js";
36
+
37
+ /** Scene-referred exposure changes light, never coverage/compositing alpha. */
38
+ export function applyExposure(colour: Node<"vec4">, exposure: Node<"float">): Node<"vec4"> {
39
+ return vec4(colour.rgb.mul(exposure), colour.a);
40
+ }
41
+
42
+ /** Owns scratch targets only. Never draws the world or installs another output transform. */
43
+ export class AutoExposureNode extends TempNode<"float"> {
44
+ static get type(): string {
45
+ return "AutoExposureNode";
46
+ }
47
+ readonly input: ColourTexture;
48
+ readonly settings: Readonly<IExposureSettings>;
49
+ readonly #constant: number;
50
+ readonly #size = new Vector2();
51
+ readonly #sourceSize = uniform(new Vector2(1, 1));
52
+ readonly #reduceSize = uniform(new Vector2(1, 1));
53
+ readonly #blockSize = uniform(new Vector2(1, 1));
54
+ readonly #delta = uniform(0);
55
+ readonly #resetMode = uniform(1); // 0 = history, 1 = seed, 2 = next measured target
56
+ readonly #seed = uniform(0);
57
+ readonly #enabled = uniform(false);
58
+ readonly #quad = new QuadMesh();
59
+ readonly #meterMaterial = new NodeMaterial();
60
+ readonly #reduceMaterial = new NodeMaterial();
61
+ readonly #tilesMaterial = new NodeMaterial();
62
+ readonly #histogramMaterial = new NodeMaterial();
63
+ readonly #adaptMaterial = new NodeMaterial();
64
+ readonly #tilesTarget = exposureTarget();
65
+ readonly #histogramTarget = exposureTarget();
66
+ #readTarget = exposureTarget();
67
+ #writeTarget = exposureTarget();
68
+ #levels: RenderTarget[] = [];
69
+ readonly #reduced = texture(new Texture());
70
+ readonly #blocks = texture(new Texture());
71
+ readonly #previous = texture(this.#readTarget.texture);
72
+ readonly #result = texture(this.#writeTarget.texture);
73
+ #disposed = false;
74
+ readonly #observation: ExposureReadback;
75
+ // Three's runtime accepts undefined on first use, but its declaration requires a state.
76
+ #rendererState: Parameters<typeof RendererUtils.resetRendererState>[1] | undefined;
77
+
78
+ constructor(
79
+ input: ColourTexture,
80
+ settings: IExposureSettings,
81
+ constantExposure: number,
82
+ meter: Meter = (colour, uv) => exposureMeter(colour, uv),
83
+ decode: Decode = (mean) => exposureLuminance(mean),
84
+ ) {
85
+ super("float");
86
+ validateExposureSettings(settings);
87
+ if (!Number.isFinite(Math.fround(constantExposure)) || Math.fround(constantExposure) <= 0)
88
+ throw new Error("Exposure constant must be finite and positive.");
89
+ this.input = input;
90
+ this.settings = Object.freeze({ ...settings });
91
+ const policy = this.settings;
92
+ this.#constant = constantExposure;
93
+ this.#seed.value = Math.log2(settings.initialExposure);
94
+ this.#enabled.value = settings.enabled;
95
+ this.#observation = new ExposureReadback(constantExposure, () => this.#enabled.value);
96
+ this.updateBeforeType = NodeUpdateType.FRAME;
97
+ this.#meterMaterial.fragmentNode = reduceExposure(input, this.#sourceSize, meter);
98
+ this.#reduceMaterial.fragmentNode = reduceExposure(this.#reduced, this.#reduceSize);
99
+ this.#tilesTarget.setSize(exposureBins, exposureTiles);
100
+ this.#histogramTarget.setSize(exposureBins, 1);
101
+ this.#tilesMaterial.fragmentNode = histogramTiles(this.#blocks, this.#blockSize, policy);
102
+ this.#histogramMaterial.fragmentNode = histogramExposure(texture(this.#tilesTarget.texture));
103
+ this.#adaptMaterial.fragmentNode = adaptExposure(
104
+ texture(this.#histogramTarget.texture),
105
+ this.#previous,
106
+ this.#resetMode,
107
+ this.#seed,
108
+ this.#delta,
109
+ policy,
110
+ decode,
111
+ );
112
+ }
113
+
114
+ override setup(builder: NodeBuilder): Node<"float"> {
115
+ // Force the existing pass dependency even in disabled mode; off never means unmeasured.
116
+ super.setup(builder);
117
+ return this.#enabled.select(
118
+ textureLoad(this.#result, ivec2(0)).r.exp2(),
119
+ float(this.#constant),
120
+ );
121
+ }
122
+
123
+ get exposureNode(): Node<"float"> {
124
+ return nodeObject(this);
125
+ }
126
+
127
+ reset(exposure?: number): void {
128
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
129
+ if (
130
+ exposure !== undefined &&
131
+ (!Number.isFinite(Math.fround(exposure)) || Math.fround(exposure) <= 0)
132
+ )
133
+ throw new Error("Exposure reset must be finite and positive.");
134
+ this.#resetMode.value = exposure === undefined ? 2 : 1;
135
+ if (exposure !== undefined) this.#seed.value = Math.log2(exposure);
136
+ this.#observation.invalidate();
137
+ }
138
+
139
+ setEnabled(enabled: boolean): void {
140
+ if (typeof enabled !== "boolean") throw new Error("Exposure enabled must be boolean.");
141
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
142
+ this.#enabled.value = enabled;
143
+ this.#observation.invalidate();
144
+ }
145
+
146
+ getObservation(): Record<string, unknown> {
147
+ return this.#observation.get();
148
+ }
149
+
150
+ override updateBefore(frame: NodeFrame): undefined {
151
+ if (this.#disposed) throw new Error("Exposure node is disposed.");
152
+ const renderer = frame.renderer;
153
+ if (renderer === null) throw new Error("Exposure requires a renderer.");
154
+ if (!Number.isFinite(frame.deltaTime) || frame.deltaTime < 0 || !Number.isFinite(frame.time))
155
+ throw new Error("Exposure frame time must be finite and nonnegative.");
156
+ renderer.getDrawingBufferSize(this.#size);
157
+ // Level 0 meters 4x4 pixels, level 1 averages 16x16. The histogram gathers level 1.
158
+ const sizes = exposureReductionSizes(this.#size.x, this.#size.y).slice(0, 2);
159
+ this.#sourceSize.value.copy(this.#size);
160
+ this.#delta.value = Math.min(frame.deltaTime, this.settings.maxDelta);
161
+ while (this.#levels.length > sizes.length) this.#levels.pop()?.dispose();
162
+ for (const [i, [width, height]] of sizes.entries()) {
163
+ const level = this.#levels[i] ?? exposureTarget();
164
+ this.#levels[i] = level;
165
+ level.setSize(width, height);
166
+ }
167
+ this.#rendererState ??= RendererUtils.saveRendererState(renderer);
168
+ this.#rendererState = RendererUtils.resetRendererState(renderer, this.#rendererState);
169
+ try {
170
+ for (const [i, level] of this.#levels.entries()) {
171
+ const previous = this.#levels[i - 1];
172
+ if (previous !== undefined) {
173
+ this.#reduced.value = previous.texture;
174
+ this.#reduceSize.value.set(previous.width, previous.height);
175
+ }
176
+ this.#quad.material = i === 0 ? this.#meterMaterial : this.#reduceMaterial;
177
+ renderer.setRenderTarget(level);
178
+ this.#quad.render(renderer);
179
+ }
180
+ const final = this.#levels.at(-1);
181
+ if (final === undefined) throw new Error("Exposure reduction is empty.");
182
+ this.#blocks.value = final.texture;
183
+ this.#blockSize.value.set(final.width, final.height);
184
+ this.#quad.material = this.#tilesMaterial;
185
+ renderer.setRenderTarget(this.#tilesTarget);
186
+ this.#quad.render(renderer);
187
+ this.#quad.material = this.#histogramMaterial;
188
+ renderer.setRenderTarget(this.#histogramTarget);
189
+ this.#quad.render(renderer);
190
+ const write = this.#writeTarget;
191
+ this.#previous.value = this.#readTarget.texture;
192
+ this.#quad.material = this.#adaptMaterial;
193
+ renderer.setRenderTarget(write);
194
+ this.#quad.render(renderer);
195
+ this.#result.value = write.texture;
196
+ this.#writeTarget = this.#readTarget;
197
+ this.#readTarget = write;
198
+ this.#resetMode.value = 0;
199
+ this.#observation.report(renderer, write, frame.time, this.settings.reportInterval);
200
+ } finally {
201
+ RendererUtils.restoreRendererState(renderer, this.#rendererState);
202
+ }
203
+ }
204
+
205
+ override dispose(): void {
206
+ if (this.#disposed) return;
207
+ this.#disposed = true;
208
+ this.#observation.dispose();
209
+ for (const level of [
210
+ ...this.#levels,
211
+ this.#tilesTarget,
212
+ this.#histogramTarget,
213
+ this.#readTarget,
214
+ this.#writeTarget,
215
+ ])
216
+ level.dispose();
217
+ this.#levels = [];
218
+ this.#meterMaterial.dispose();
219
+ this.#reduceMaterial.dispose();
220
+ this.#tilesMaterial.dispose();
221
+ this.#histogramMaterial.dispose();
222
+ this.#adaptMaterial.dispose();
223
+ super.dispose();
224
+ }
225
+ }
@@ -0,0 +1,66 @@
1
+ import type { Camera, Color, Object3D, Vector3 } from "three";
2
+ import type { IBacklightControls } from "./backlightMaterial.js";
3
+ function finiteColor(color: Color) {
4
+ return (
5
+ Number.isFinite(color.r) &&
6
+ color.r >= 0 &&
7
+ Number.isFinite(color.g) &&
8
+ color.g >= 0 &&
9
+ Number.isFinite(color.b) &&
10
+ color.b >= 0
11
+ );
12
+ }
13
+ export function validateControls(controls: IBacklightControls) {
14
+ if (
15
+ !Number.isFinite(controls.rimGain) ||
16
+ controls.rimGain < 0 ||
17
+ !Number.isFinite(controls.key.intensity) ||
18
+ controls.key.intensity < 0 ||
19
+ !finiteColor(controls.key.color) ||
20
+ !Number.isFinite(controls.fillGain) ||
21
+ controls.fillGain < 0 ||
22
+ !Number.isFinite(controls.fillAngularSize) ||
23
+ controls.fillAngularSize <= 0 ||
24
+ controls.fillAngularSize > 1.5 ||
25
+ !Number.isFinite(controls.fillDirection.lengthSq()) ||
26
+ controls.fillDirection.lengthSq() === 0 ||
27
+ !finiteColor(controls.fillColor)
28
+ )
29
+ throw new Error(
30
+ "Backlight controls require finite nonnegative gains, a direction and angular size in (0, 1.5].",
31
+ );
32
+ }
33
+ export function resolveKey(
34
+ controls: IBacklightControls,
35
+ direction: Vector3,
36
+ target: Vector3,
37
+ camera: Camera = controls.camera,
38
+ ) {
39
+ validateControls(controls);
40
+ // Read the renderer/game-updated matrices, as upstream Three light uniforms do.
41
+ // Targets outside the scene must be updated by their owner before rendering.
42
+ // Never mutate shared light/ancestor matrices inside a material render callback.
43
+ target.setFromMatrixPosition(controls.key.target.matrixWorld);
44
+ direction.setFromMatrixPosition(controls.key.matrixWorld).sub(target);
45
+ if (
46
+ !Number.isFinite(direction.x) ||
47
+ !Number.isFinite(direction.y) ||
48
+ !Number.isFinite(direction.z)
49
+ )
50
+ throw new Error("Key endpoints must be finite.");
51
+ const lengthSq = direction.lengthSq();
52
+ if (!Number.isFinite(lengthSq)) throw new Error("Key direction magnitude must be finite.");
53
+ if (lengthSq <= 1e-12) {
54
+ direction.set(0, 1, 0);
55
+ return 0;
56
+ }
57
+ direction.normalize();
58
+ if (!controls.key.layers.test(camera.layers)) return 0;
59
+ let current: Object3D | null = controls.key;
60
+ while (current !== null) {
61
+ if (!current.visible) return 0;
62
+ if (current === controls.scene) return controls.key.intensity;
63
+ current = current.parent;
64
+ }
65
+ return 0;
66
+ }
@@ -0,0 +1,147 @@
1
+ // Generated for you. Ordinary Three.js; controls belong to your game.
2
+ import {
3
+ type Camera,
4
+ type Color,
5
+ type DirectionalLight,
6
+ Material,
7
+ type MeshStandardMaterial,
8
+ type Object3D,
9
+ type Scene,
10
+ Vector3,
11
+ } from "three";
12
+ import {
13
+ cameraViewMatrix,
14
+ clamp,
15
+ dot,
16
+ float,
17
+ materialColor,
18
+ materialEmissive,
19
+ materialMetalness,
20
+ materialRoughness,
21
+ max,
22
+ mix,
23
+ normalView,
24
+ positionViewDirection,
25
+ pow,
26
+ reflect,
27
+ smoothstep,
28
+ uniform,
29
+ vec3,
30
+ } from "three/tsl";
31
+ import { MeshStandardNodeMaterial } from "three/webgpu";
32
+ import { resolveKey, validateControls } from "./backlightControls.js";
33
+
34
+ export interface IBacklightControls {
35
+ readonly key: DirectionalLight;
36
+ readonly scene: Scene;
37
+ readonly camera: Camera;
38
+ /** Mutable game-owned controls: zero disables the rim, independent of source reporting. */
39
+ rimGain: number;
40
+ fillGain: number;
41
+ readonly fillColor: Color;
42
+ readonly fillDirection: Vector3;
43
+ /** Angular radius of the authored fill disc, in radians. */
44
+ fillAngularSize: number;
45
+ /** Caller admits fill only after a measured-dark or missing environment is qualified. */
46
+ fillAdmitted: boolean;
47
+ }
48
+
49
+ const graphs = new WeakMap<IBacklightControls, ReturnType<typeof createGraph>>();
50
+
51
+ /**
52
+ * Preserve the upstream standard PBR/normal/skinning paths and original material emissive.
53
+ * This is an additive artistic convention, not a physical subsurface model or IBL replacement.
54
+ * Cache at the caller to preserve shared source-material relationships; dispose only conversions
55
+ * it owns, never maps/source materials borrowed from a loaded model.
56
+ */
57
+ export function backlightMaterial(source: MeshStandardMaterial, controls: IBacklightControls) {
58
+ if (
59
+ ("isMeshPhysicalMaterial" in source && source.isMeshPhysicalMaterial === true) ||
60
+ source.onBeforeCompile !== Material.prototype.onBeforeCompile
61
+ )
62
+ throw new Error(
63
+ "Physical/custom standard materials require separate qualification; conversion refused.",
64
+ );
65
+ validateControls(controls);
66
+ const material = new MeshStandardNodeMaterial().copy(source);
67
+ // NodeMaterial.copy skips Material.copy, and `alphaTest` lives in `_alphaTest`, which it never copies.
68
+ material.alphaTest = source.alphaTest;
69
+ let graph = graphs.get(controls);
70
+ if (!graph) {
71
+ graph = createGraph(controls);
72
+ graphs.set(controls, graph);
73
+ }
74
+ material.emissiveNode = graph;
75
+ return material;
76
+ }
77
+
78
+ function createGraph(controls: IBacklightControls) {
79
+ const rimGain = uniform(controls.rimGain).onRenderUpdate(() => {
80
+ validateControls(controls);
81
+ return controls.rimGain;
82
+ });
83
+ const fillGain = uniform(0).onRenderUpdate(() => {
84
+ validateControls(controls);
85
+ return controls.fillAdmitted ? controls.fillGain : 0;
86
+ });
87
+ const fillColor = uniform(controls.fillColor).onRenderUpdate(() => {
88
+ validateControls(controls);
89
+ return controls.fillColor;
90
+ });
91
+ const fillDirection = uniform(controls.fillDirection).onRenderUpdate(() => {
92
+ validateControls(controls);
93
+ return controls.fillDirection;
94
+ });
95
+ const fillAngularSize = uniform(controls.fillAngularSize).onRenderUpdate(() => {
96
+ validateControls(controls);
97
+ return controls.fillAngularSize;
98
+ });
99
+ const keyColor = uniform(controls.key.color).onRenderUpdate(() => {
100
+ validateControls(controls);
101
+ return controls.key.color;
102
+ });
103
+ const keyDirectionValue = new Vector3(0, 1, 0);
104
+ const keyTargetValue = new Vector3();
105
+ const keyDirection = uniform(keyDirectionValue).onRenderUpdate((frame) => {
106
+ resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera);
107
+ return keyDirectionValue;
108
+ });
109
+ // Removal/visibility/intensity are live. A removed sun cannot leave an invented rim behind.
110
+ const keyGain = uniform(0).onRenderUpdate((frame) =>
111
+ resolveKey(controls, keyDirectionValue, keyTargetValue, frame.camera ?? controls.camera),
112
+ );
113
+ const N = normalView.normalize();
114
+ const V = positionViewDirection.normalize();
115
+ const L = cameraViewMatrix.transformDirection(keyDirection);
116
+ const grazing = pow(float(1).sub(clamp(dot(N, V), 0, 1)), 3);
117
+ const behind = max(dot(L, V).negate(), 0);
118
+ // Suppress broad surfaces already facing the key; back-facing edges retain wrap.
119
+ // Tint by base reflectance so dark surfaces do not inherit a white emissive wash.
120
+ const surfaceBacklit = float(1).sub(smoothstep(-0.15, 0.15, dot(N, L)));
121
+ const rim = keyColor
122
+ .mul(keyGain)
123
+ .mul(rimGain)
124
+ .mul(grazing)
125
+ .mul(behind)
126
+ .mul(surfaceBacklit)
127
+ .mul(clamp(materialColor, 0, 1));
128
+
129
+ const F = cameraViewMatrix.transformDirection(fillDirection.normalize());
130
+ const cosRadius = fillAngularSize.cos();
131
+ // Broaden a rough surface's reflected disc with approximate solid-angle attenuation,
132
+ // not a proven energy-conserving BRDF. A positive transition avoids equal smoothstep bounds.
133
+ const spread = fillAngularSize.add(max(materialRoughness.mul(1.2), 0.005)).min(Math.PI / 2);
134
+ const reflectedDisc = smoothstep(spread.cos(), cosRadius, dot(reflect(V.negate(), N), F));
135
+ const energy = float(1)
136
+ .sub(cosRadius)
137
+ .div(max(float(1).sub(spread.cos()), 0.0001));
138
+ const reflectance = mix(vec3(0.04), materialColor, materialMetalness);
139
+ const specularFill = reflectance.mul(reflectedDisc).mul(energy);
140
+ const diffuseFill = materialColor
141
+ .mul(float(1).sub(materialMetalness))
142
+ .mul(max(dot(N, F), 0))
143
+ .mul(float(1).sub(cosRadius))
144
+ .mul(2);
145
+ const fill = diffuseFill.add(specularFill).mul(fillColor).mul(fillGain);
146
+ return materialEmissive.add(rim).add(fill);
147
+ }
@@ -10,7 +10,7 @@
10
10
  // puts the crosshair somewhere the body is not. The rule this file exists to
11
11
  // state is the opposite one: compose the camera from the body's *solved* pose,
12
12
  // every frame, with no interpolation of its own.
13
- import { MathUtils, type PerspectiveCamera, type Vector3Like } from "three";
13
+ import { MathUtils, type PerspectiveCamera } from "three";
14
14
 
15
15
  /** The numbers a first-person camera is built from, in one table. */
16
16
  export const FIRST_PERSON = {
@@ -80,14 +80,3 @@ export function firstPersonFov(current: number, aiming: boolean, dt: number): nu
80
80
  dt,
81
81
  );
82
82
  }
83
-
84
- /** Where a shot leaves from: the camera basis, never the body transform. */
85
- export function aimBasis(camera: PerspectiveCamera): {
86
- origin: Vector3Like;
87
- direction: Vector3Like;
88
- } {
89
- camera.updateMatrixWorld(true);
90
- const origin = camera.position;
91
- const direction = camera.getWorldDirection(camera.position.clone());
92
- return { origin, direction: direction.normalize() };
93
- }