create-threenative 0.2.15 → 0.2.18

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 (488) hide show
  1. package/agent-docs/kit-mcp.md +10 -0
  2. package/agent-docs/kit-router.md +14 -0
  3. package/agent-docs/kit-stuck.md +7 -0
  4. package/agent-docs/references/assertion-reference.md +54 -110
  5. package/agent-docs/references/capability-reference.md +1740 -254
  6. package/agent-docs/references/conventions.md +299 -0
  7. package/agent-docs/references/kit-action-rpg.md +40 -0
  8. package/agent-docs/references/kit-adventure.md +40 -0
  9. package/agent-docs/references/kit-collectathon.md +38 -0
  10. package/agent-docs/references/kit-kart.md +31 -0
  11. package/agent-docs/references/kit-minimal.md +29 -0
  12. package/agent-docs/references/kit-platformer.md +34 -0
  13. package/agent-docs/references/kit-puzzle.md +22 -0
  14. package/agent-docs/references/kit-racing.md +26 -0
  15. package/agent-docs/references/kit-rain.md +31 -0
  16. package/agent-docs/references/kit-rts.md +34 -0
  17. package/agent-docs/references/kit-runner.md +32 -0
  18. package/agent-docs/references/kit-sailing.md +41 -0
  19. package/agent-docs/references/kit-shooter.md +33 -0
  20. package/agent-docs/references/kit-snow.md +33 -0
  21. package/agent-docs/references/kit-starter.md +55 -0
  22. package/agent-docs/references/kit-tower-defense.md +27 -0
  23. package/agent-docs/references/performance-basics.md +8 -4
  24. package/agent-docs/references/terrain-authoring.md +2 -1
  25. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  26. package/agent-files/.agents/skills/prd-creator/SKILL.md +3 -2
  27. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +84 -59
  28. package/agent-files/.claude/hooks/discovery-gate.mjs +125 -0
  29. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  30. package/agent-files/.claude/settings.json +25 -0
  31. package/agent-files/.codex/hooks.json +18 -1
  32. package/dist/index.d.ts +97 -6
  33. package/dist/index.js +899 -271
  34. package/dist/terrain-kit.d.ts +7 -0
  35. package/dist/terrain-kit.js +82 -0
  36. package/dist/threenative.js +114 -16
  37. package/dist/web-engine-ccd-ik-solver.js +127 -0
  38. package/dist/web-engine-gltf-loader.js +71 -20
  39. package/dist/web-engine-post-effects.js +39 -14
  40. package/dist/web-engine-runtime.js +10011 -4101
  41. package/package.json +15 -9
  42. package/template-assets/clearwater/README.md +1 -1
  43. package/template-assets/patches/manifest.json +18 -0
  44. package/template-assets/patches/three@0.187.0.patch +2004 -407
  45. package/template-assets/terrain/alpine/assets.json +12 -0
  46. package/template-assets/terrain/alpine/bake.mjs +6 -0
  47. package/template-assets/terrain/alpine/credits.json +164 -0
  48. package/template-assets/terrain/alpine/heightmap.r16 +0 -0
  49. package/template-assets/terrain/alpine/recipe.json +119 -0
  50. package/template-assets/terrain/alpine/surface.json +53 -0
  51. package/template-assets/terrain/coastal/assets.json +11 -0
  52. package/template-assets/terrain/coastal/bake.mjs +6 -0
  53. package/template-assets/terrain/coastal/credits.json +117 -0
  54. package/template-assets/terrain/coastal/heightmap.r16 +0 -0
  55. package/template-assets/terrain/coastal/recipe.json +113 -0
  56. package/template-assets/terrain/coastal/surface.json +41 -0
  57. package/template-assets/terrain/desert/assets.json +12 -0
  58. package/template-assets/terrain/desert/bake.mjs +6 -0
  59. package/template-assets/terrain/desert/credits.json +164 -0
  60. package/template-assets/terrain/desert/heightmap.r16 +0 -0
  61. package/template-assets/terrain/desert/recipe.json +108 -0
  62. package/template-assets/terrain/desert/surface.json +54 -0
  63. package/template-assets/terrain/forest/assets.json +65 -0
  64. package/template-assets/terrain/forest/bake.mjs +8 -0
  65. package/template-assets/terrain/forest/credits.json +225 -0
  66. package/template-assets/terrain/forest/heightmap.r16 +0 -0
  67. package/template-assets/terrain/forest/recipe.json +350 -0
  68. package/template-assets/terrain/forest/surface.json +79 -0
  69. package/template-assets/terrain/tundra/assets.json +12 -0
  70. package/template-assets/terrain/tundra/bake.mjs +6 -0
  71. package/template-assets/terrain/tundra/credits.json +164 -0
  72. package/template-assets/terrain/tundra/heightmap.r16 +0 -0
  73. package/template-assets/terrain/tundra/recipe.json +277 -0
  74. package/template-assets/terrain/tundra/surface.json +54 -0
  75. package/templates/action-rpg/AGENTS.md +103 -84
  76. package/templates/action-rpg/CLAUDE.md +103 -84
  77. package/templates/action-rpg/kit.json +1 -0
  78. package/templates/action-rpg/package.json +7 -7
  79. package/templates/action-rpg/playtests/spells.playtest.json +20 -0
  80. package/templates/action-rpg/src/game.ts +2 -1
  81. package/templates/action-rpg/src/render/atmosphere.ts +11 -16
  82. package/templates/action-rpg/src/render/backlightControls.ts +10 -0
  83. package/templates/action-rpg/src/render/backlightMaterial.ts +4 -4
  84. package/templates/action-rpg/src/render/clouds.ts +13 -0
  85. package/templates/action-rpg/src/render/gpuSky.ts +4 -7
  86. package/templates/action-rpg/src/render/materialLighting.ts +5 -5
  87. package/templates/action-rpg/src/render/quality.ts +10 -33
  88. package/templates/action-rpg/src/scenes/Play.ts +30 -1
  89. package/templates/action-rpg/src/style.css +4 -0
  90. package/templates/action-rpg/src/ui/AbilityBar.tsx +1 -1
  91. package/templates/action-rpg/threenative.config.ts +0 -3
  92. package/templates/action-rpg/vite.config.ts +2 -0
  93. package/templates/adventure/AGENTS.md +92 -44
  94. package/templates/adventure/CLAUDE.md +92 -44
  95. package/templates/adventure/kit.json +5 -1
  96. package/templates/adventure/package.json +7 -7
  97. package/templates/adventure/src/game.ts +1 -1
  98. package/templates/adventure/src/style.css +4 -0
  99. package/templates/adventure/tsconfig.json +1 -1
  100. package/templates/adventure/vite.config.ts +2 -0
  101. package/templates/collectathon/AGENTS.md +93 -42
  102. package/templates/collectathon/CLAUDE.md +93 -42
  103. package/templates/collectathon/package.json +7 -7
  104. package/templates/collectathon/src/game.ts +1 -1
  105. package/templates/collectathon/src/level/Course.ts +55 -9
  106. package/templates/collectathon/src/level/terrain.ts +27 -6
  107. package/templates/collectathon/src/main.ts +1 -0
  108. package/templates/collectathon/src/render/foliage.ts +359 -98
  109. package/templates/collectathon/src/render/sky.ts +76 -12
  110. package/templates/collectathon/src/render/water.ts +32 -10
  111. package/templates/collectathon/src/scenes/Play.ts +18 -5
  112. package/templates/collectathon/src/style.css +4 -0
  113. package/templates/collectathon/tsconfig.json +1 -1
  114. package/templates/collectathon/vite.config.ts +2 -0
  115. package/templates/kart/AGENTS.md +87 -42
  116. package/templates/kart/CLAUDE.md +87 -42
  117. package/templates/kart/package.json +6 -6
  118. package/templates/kart/src/game.ts +1 -1
  119. package/templates/kart/src/main.ts +1 -0
  120. package/templates/kart/src/style.css +4 -0
  121. package/templates/kart/tsconfig.json +1 -1
  122. package/templates/kart/vite.config.ts +2 -0
  123. package/templates/minimal/AGENTS.md +105 -84
  124. package/templates/minimal/CLAUDE.md +105 -84
  125. package/templates/minimal/package.json +6 -6
  126. package/templates/minimal/playtests/stands-still.playtest.json +30 -0
  127. package/templates/minimal/src/game.ts +1 -1
  128. package/templates/minimal/src/render/atmosphere.ts +11 -16
  129. package/templates/minimal/src/render/backlightControls.ts +10 -0
  130. package/templates/minimal/src/render/backlightMaterial.ts +4 -4
  131. package/templates/minimal/src/render/camera.ts +13 -2
  132. package/templates/minimal/src/render/clouds.ts +13 -0
  133. package/templates/minimal/src/render/gpuSky.ts +4 -7
  134. package/templates/minimal/src/render/lighting.ts +4 -2
  135. package/templates/minimal/src/render/materialLighting.ts +5 -5
  136. package/templates/minimal/src/render/materials.ts +10 -0
  137. package/templates/minimal/src/render/quality.ts +7 -32
  138. package/templates/minimal/src/scenes/Play.ts +4 -1
  139. package/templates/minimal/vite.config.ts +7 -1
  140. package/templates/platformer/AGENTS.md +95 -46
  141. package/templates/platformer/CLAUDE.md +95 -46
  142. package/templates/platformer/index.html +1 -1
  143. package/templates/platformer/main.html +12 -0
  144. package/templates/platformer/package.json +7 -7
  145. package/templates/platformer/playtests/gamepad-idle.playtest.json +21 -0
  146. package/templates/platformer/playtests/gamepad.playtest.json +30 -0
  147. package/templates/platformer/src/entities/Fox.ts +21 -6
  148. package/templates/platformer/src/game.ts +1 -1
  149. package/templates/platformer/src/main.ts +1 -0
  150. package/templates/platformer/src/render/backlightControls.ts +10 -0
  151. package/templates/platformer/src/render/backlightMaterial.ts +4 -4
  152. package/templates/platformer/src/render/materialLighting.ts +5 -5
  153. package/templates/platformer/src/render/quality.ts +7 -32
  154. package/templates/platformer/src/scenes/Play.ts +2 -1
  155. package/templates/platformer/src/style.css +4 -0
  156. package/templates/platformer/src/worker-page.ts +29 -0
  157. package/templates/platformer/src/worker.ts +5 -0
  158. package/templates/platformer/tsconfig.json +1 -1
  159. package/templates/platformer/vite.config.ts +4 -0
  160. package/templates/puzzle/AGENTS.md +97 -80
  161. package/templates/puzzle/CLAUDE.md +97 -80
  162. package/templates/puzzle/package.json +7 -7
  163. package/templates/puzzle/src/game.ts +1 -1
  164. package/templates/puzzle/src/render/backlightControls.ts +10 -0
  165. package/templates/puzzle/src/render/backlightMaterial.ts +4 -4
  166. package/templates/puzzle/src/render/materialLighting.ts +5 -5
  167. package/templates/puzzle/src/render/quality.ts +7 -32
  168. package/templates/puzzle/src/scenes/Play.ts +1 -1
  169. package/templates/puzzle/src/style.css +4 -0
  170. package/templates/puzzle/tsconfig.json +1 -1
  171. package/templates/puzzle/vite.config.ts +2 -0
  172. package/templates/racing/AGENTS.md +100 -82
  173. package/templates/racing/CLAUDE.md +100 -82
  174. package/templates/racing/package.json +7 -7
  175. package/templates/racing/src/game.ts +1 -1
  176. package/templates/racing/src/render/atmosphere.ts +11 -16
  177. package/templates/racing/src/render/backlightControls.ts +10 -0
  178. package/templates/racing/src/render/backlightMaterial.ts +4 -4
  179. package/templates/racing/src/render/clouds.ts +13 -0
  180. package/templates/racing/src/render/gpuSky.ts +4 -7
  181. package/templates/racing/src/render/materialLighting.ts +5 -5
  182. package/templates/racing/src/render/quality.ts +7 -32
  183. package/templates/racing/src/scenes/Race.ts +4 -1
  184. package/templates/racing/src/style.css +4 -0
  185. package/templates/racing/tsconfig.json +1 -1
  186. package/templates/racing/vite.config.ts +2 -0
  187. package/templates/rain/AGENTS.md +96 -84
  188. package/templates/rain/CLAUDE.md +96 -84
  189. package/templates/rain/native-playtests/lightning.playtest.json +85 -10
  190. package/templates/rain/package.json +6 -6
  191. package/templates/rain/playtests/reduced-motion.playtest.json +6 -0
  192. package/templates/rain/src/game.ts +1 -1
  193. package/templates/rain/src/scenes/Boot.ts +1 -0
  194. package/templates/rain/src/state.ts +7 -0
  195. package/templates/rain/src/ui/GameUi.tsx +7 -1
  196. package/templates/rain/vite.config.ts +6 -0
  197. package/templates/rts/AGENTS.md +100 -85
  198. package/templates/rts/CLAUDE.md +100 -85
  199. package/templates/rts/package.json +6 -6
  200. package/templates/rts/src/game.ts +1 -1
  201. package/templates/rts/src/render/backlightControls.ts +10 -0
  202. package/templates/rts/src/render/backlightMaterial.ts +4 -4
  203. package/templates/rts/src/render/materialLighting.ts +5 -5
  204. package/templates/rts/src/render/quality.ts +7 -31
  205. package/templates/rts/src/scenes/Play.ts +1 -1
  206. package/templates/rts/src/style.css +4 -0
  207. package/templates/rts/vite.config.ts +2 -0
  208. package/templates/runner/AGENTS.md +97 -80
  209. package/templates/runner/CLAUDE.md +97 -80
  210. package/templates/runner/package.json +7 -7
  211. package/templates/runner/playtests/performance.playtest.json +1 -1
  212. package/templates/runner/src/game.ts +1 -1
  213. package/templates/runner/src/render/atmosphere.ts +11 -16
  214. package/templates/runner/src/render/backlightControls.ts +10 -0
  215. package/templates/runner/src/render/backlightMaterial.ts +4 -4
  216. package/templates/runner/src/render/clouds.ts +13 -0
  217. package/templates/runner/src/render/gpuSky.ts +4 -7
  218. package/templates/runner/src/render/lighting.ts +53 -11
  219. package/templates/runner/src/render/materialLighting.ts +5 -5
  220. package/templates/runner/src/render/quality.ts +7 -32
  221. package/templates/runner/src/scenes/Run.ts +8 -4
  222. package/templates/runner/src/style.css +4 -0
  223. package/templates/runner/threenative.config.ts +0 -3
  224. package/templates/runner/tsconfig.json +1 -1
  225. package/templates/runner/vite.config.ts +2 -0
  226. package/templates/sailing/AGENTS.md +96 -79
  227. package/templates/sailing/CLAUDE.md +96 -79
  228. package/templates/sailing/package.json +7 -7
  229. package/templates/sailing/playtests/sails.playtest.json +1 -0
  230. package/templates/sailing/src/game.ts +1 -1
  231. package/templates/sailing/src/render/backlightControls.ts +10 -0
  232. package/templates/sailing/src/render/backlightMaterial.ts +4 -4
  233. package/templates/sailing/src/render/environmentSetup.ts +1 -1
  234. package/templates/sailing/src/render/materialLighting.ts +5 -5
  235. package/templates/sailing/src/render/quality.ts +7 -32
  236. package/templates/sailing/src/render/sky.ts +4 -0
  237. package/templates/sailing/src/style.css +5 -0
  238. package/templates/sailing/threenative.config.ts +0 -3
  239. package/templates/sailing/vite.config.ts +6 -0
  240. package/templates/shooter/AGENTS.md +97 -68
  241. package/templates/shooter/CLAUDE.md +97 -68
  242. package/templates/shooter/package.json +7 -7
  243. package/templates/shooter/src/game.ts +3 -2
  244. package/templates/shooter/src/render/atmosphere.ts +11 -16
  245. package/templates/shooter/src/render/backlightControls.ts +10 -0
  246. package/templates/shooter/src/render/backlightMaterial.ts +4 -4
  247. package/templates/shooter/src/render/clouds.ts +13 -0
  248. package/templates/shooter/src/render/gpuSky.ts +4 -7
  249. package/templates/shooter/src/render/materialLighting.ts +5 -5
  250. package/templates/shooter/src/render/quality.ts +10 -33
  251. package/templates/shooter/src/scenes/Play.ts +4 -1
  252. package/templates/shooter/src/style.css +4 -0
  253. package/templates/shooter/vite.config.ts +2 -0
  254. package/templates/snow/AGENTS.md +95 -76
  255. package/templates/snow/CLAUDE.md +95 -76
  256. package/templates/snow/package.json +7 -7
  257. package/templates/snow/src/game.ts +1 -1
  258. package/templates/snow/src/render/backlightControls.ts +10 -0
  259. package/templates/snow/src/render/backlightMaterial.ts +4 -4
  260. package/templates/snow/src/render/materialLighting.ts +5 -5
  261. package/templates/snow/src/render/quality.ts +7 -32
  262. package/templates/snow/src/style.css +5 -0
  263. package/templates/snow/threenative.config.ts +0 -3
  264. package/templates/snow/vite.config.ts +6 -0
  265. package/templates/starter/AGENTS.md +109 -88
  266. package/templates/starter/CLAUDE.md +109 -88
  267. package/templates/starter/native-playtests/render-chain.playtest.json +24 -24
  268. package/templates/starter/native-playtests/smooth-motion.playtest.json +3 -3
  269. package/templates/starter/package.json +7 -7
  270. package/templates/starter/src/entities/Crate.ts +5 -2
  271. package/templates/starter/src/entities/Player.ts +10 -22
  272. package/templates/starter/src/game.ts +4 -3
  273. package/templates/starter/src/render/adaptiveQuality.ts +17 -0
  274. package/templates/starter/src/render/atmosphere.ts +11 -16
  275. package/templates/starter/src/render/backlightControls.ts +10 -0
  276. package/templates/starter/src/render/backlightMaterial.ts +4 -4
  277. package/templates/starter/src/render/clouds.ts +13 -0
  278. package/templates/starter/src/render/contactShadow.ts +1 -1
  279. package/templates/starter/src/render/gpuSky.ts +4 -7
  280. package/templates/starter/src/render/lighting.ts +54 -4
  281. package/templates/starter/src/render/materialLighting.ts +5 -5
  282. package/templates/starter/src/render/postprocessing.ts +11 -10
  283. package/templates/starter/src/render/quality.ts +14 -1
  284. package/templates/starter/src/render/temporalAA.ts +8 -7
  285. package/templates/starter/src/render/temporalAAFrame.ts +30 -9
  286. package/templates/starter/src/render/temporalAAResolve.ts +15 -1
  287. package/templates/starter/src/render/temporalClampRelease.ts +183 -0
  288. package/templates/starter/src/render/temporalHistoryResolve.ts +90 -0
  289. package/templates/starter/src/render/temporalMoire.ts +190 -0
  290. package/templates/starter/src/render/temporalResolve.ts +75 -16
  291. package/templates/starter/src/render/temporalResolveDepth.ts +2 -0
  292. package/templates/starter/src/scenes/Play.ts +53 -32
  293. package/templates/starter/src/state.ts +2 -0
  294. package/templates/starter/src/style.css +4 -0
  295. package/templates/starter/src/ui/Menu.tsx +5 -1
  296. package/templates/starter/vite.config.ts +2 -0
  297. package/templates/tower-defense/AGENTS.md +97 -81
  298. package/templates/tower-defense/CLAUDE.md +97 -81
  299. package/templates/tower-defense/package.json +7 -7
  300. package/templates/tower-defense/src/game.ts +1 -1
  301. package/templates/tower-defense/src/render/backlightControls.ts +10 -0
  302. package/templates/tower-defense/src/render/backlightMaterial.ts +4 -4
  303. package/templates/tower-defense/src/render/materialLighting.ts +5 -5
  304. package/templates/tower-defense/src/render/quality.ts +7 -32
  305. package/templates/tower-defense/src/scenes/Battle.ts +1 -1
  306. package/templates/tower-defense/src/style.css +4 -0
  307. package/templates/tower-defense/tsconfig.json +1 -1
  308. package/templates/tower-defense/vite.config.ts +2 -0
  309. package/capabilities.json +0 -9197
  310. package/templates/AGENTS.md +0 -21
  311. package/templates/CLAUDE.md +0 -23
  312. package/templates/action-rpg/.codex/config.toml +0 -23
  313. package/templates/action-rpg/.cursor/mcp.json +0 -38
  314. package/templates/action-rpg/.gemini/settings.json +0 -38
  315. package/templates/action-rpg/.mcp.json +0 -38
  316. package/templates/action-rpg/.vscode/mcp.json +0 -43
  317. package/templates/action-rpg/.zed/settings.json +0 -43
  318. package/templates/action-rpg/opencode.json +0 -49
  319. package/templates/action-rpg/src/render/environmentContribution.ts +0 -188
  320. package/templates/action-rpg/src/render/environmentRadiance.ts +0 -36
  321. package/templates/action-rpg/src/render/environmentSampleCache.ts +0 -43
  322. package/templates/action-rpg/src/render/environmentSampling.ts +0 -193
  323. package/templates/action-rpg/src/render/environmentSnapshot.ts +0 -53
  324. package/templates/adventure/.codex/config.toml +0 -23
  325. package/templates/adventure/.cursor/mcp.json +0 -38
  326. package/templates/adventure/.gemini/settings.json +0 -38
  327. package/templates/adventure/.mcp.json +0 -38
  328. package/templates/adventure/.vscode/mcp.json +0 -43
  329. package/templates/adventure/.zed/settings.json +0 -43
  330. package/templates/adventure/opencode.json +0 -49
  331. package/templates/collectathon/.codex/config.toml +0 -23
  332. package/templates/collectathon/.cursor/mcp.json +0 -38
  333. package/templates/collectathon/.gemini/settings.json +0 -38
  334. package/templates/collectathon/.mcp.json +0 -38
  335. package/templates/collectathon/.vscode/mcp.json +0 -43
  336. package/templates/collectathon/.zed/settings.json +0 -43
  337. package/templates/collectathon/opencode.json +0 -49
  338. package/templates/kart/.codex/config.toml +0 -23
  339. package/templates/kart/.cursor/mcp.json +0 -38
  340. package/templates/kart/.gemini/settings.json +0 -38
  341. package/templates/kart/.mcp.json +0 -38
  342. package/templates/kart/.vscode/mcp.json +0 -43
  343. package/templates/kart/.zed/settings.json +0 -43
  344. package/templates/kart/opencode.json +0 -49
  345. package/templates/minimal/.codex/config.toml +0 -23
  346. package/templates/minimal/.cursor/mcp.json +0 -38
  347. package/templates/minimal/.gemini/settings.json +0 -38
  348. package/templates/minimal/.mcp.json +0 -38
  349. package/templates/minimal/.vscode/mcp.json +0 -43
  350. package/templates/minimal/.zed/settings.json +0 -43
  351. package/templates/minimal/opencode.json +0 -49
  352. package/templates/minimal/src/render/environmentContribution.ts +0 -188
  353. package/templates/minimal/src/render/environmentRadiance.ts +0 -36
  354. package/templates/minimal/src/render/environmentSampleCache.ts +0 -43
  355. package/templates/minimal/src/render/environmentSampling.ts +0 -193
  356. package/templates/minimal/src/render/environmentSnapshot.ts +0 -53
  357. package/templates/platformer/.codex/config.toml +0 -23
  358. package/templates/platformer/.cursor/mcp.json +0 -38
  359. package/templates/platformer/.gemini/settings.json +0 -38
  360. package/templates/platformer/.mcp.json +0 -38
  361. package/templates/platformer/.vscode/mcp.json +0 -43
  362. package/templates/platformer/.zed/settings.json +0 -43
  363. package/templates/platformer/opencode.json +0 -49
  364. package/templates/platformer/src/render/environmentContribution.ts +0 -188
  365. package/templates/platformer/src/render/environmentRadiance.ts +0 -36
  366. package/templates/platformer/src/render/environmentSampleCache.ts +0 -43
  367. package/templates/platformer/src/render/environmentSampling.ts +0 -193
  368. package/templates/platformer/src/render/environmentSnapshot.ts +0 -53
  369. package/templates/puzzle/.codex/config.toml +0 -23
  370. package/templates/puzzle/.cursor/mcp.json +0 -38
  371. package/templates/puzzle/.gemini/settings.json +0 -38
  372. package/templates/puzzle/.mcp.json +0 -38
  373. package/templates/puzzle/.vscode/mcp.json +0 -43
  374. package/templates/puzzle/.zed/settings.json +0 -43
  375. package/templates/puzzle/opencode.json +0 -49
  376. package/templates/puzzle/src/render/environmentContribution.ts +0 -188
  377. package/templates/puzzle/src/render/environmentRadiance.ts +0 -36
  378. package/templates/puzzle/src/render/environmentSampleCache.ts +0 -43
  379. package/templates/puzzle/src/render/environmentSampling.ts +0 -193
  380. package/templates/puzzle/src/render/environmentSnapshot.ts +0 -53
  381. package/templates/racing/.codex/config.toml +0 -23
  382. package/templates/racing/.cursor/mcp.json +0 -38
  383. package/templates/racing/.gemini/settings.json +0 -38
  384. package/templates/racing/.mcp.json +0 -38
  385. package/templates/racing/.vscode/mcp.json +0 -43
  386. package/templates/racing/.zed/settings.json +0 -43
  387. package/templates/racing/opencode.json +0 -49
  388. package/templates/racing/src/render/environmentContribution.ts +0 -188
  389. package/templates/racing/src/render/environmentRadiance.ts +0 -36
  390. package/templates/racing/src/render/environmentSampleCache.ts +0 -43
  391. package/templates/racing/src/render/environmentSampling.ts +0 -193
  392. package/templates/racing/src/render/environmentSnapshot.ts +0 -53
  393. package/templates/rain/.codex/config.toml +0 -23
  394. package/templates/rain/.cursor/mcp.json +0 -38
  395. package/templates/rain/.gemini/settings.json +0 -38
  396. package/templates/rain/.mcp.json +0 -38
  397. package/templates/rain/.vscode/mcp.json +0 -43
  398. package/templates/rain/.zed/settings.json +0 -43
  399. package/templates/rain/opencode.json +0 -49
  400. package/templates/rts/.codex/config.toml +0 -23
  401. package/templates/rts/.cursor/mcp.json +0 -38
  402. package/templates/rts/.gemini/settings.json +0 -38
  403. package/templates/rts/.mcp.json +0 -38
  404. package/templates/rts/.vscode/mcp.json +0 -43
  405. package/templates/rts/.zed/settings.json +0 -43
  406. package/templates/rts/opencode.json +0 -49
  407. package/templates/rts/src/render/environmentContribution.ts +0 -188
  408. package/templates/rts/src/render/environmentRadiance.ts +0 -36
  409. package/templates/rts/src/render/environmentSampleCache.ts +0 -43
  410. package/templates/rts/src/render/environmentSampling.ts +0 -193
  411. package/templates/rts/src/render/environmentSnapshot.ts +0 -53
  412. package/templates/runner/.codex/config.toml +0 -23
  413. package/templates/runner/.cursor/mcp.json +0 -38
  414. package/templates/runner/.gemini/settings.json +0 -38
  415. package/templates/runner/.mcp.json +0 -38
  416. package/templates/runner/.vscode/mcp.json +0 -43
  417. package/templates/runner/.zed/settings.json +0 -43
  418. package/templates/runner/README.md +0 -43
  419. package/templates/runner/opencode.json +0 -49
  420. package/templates/runner/src/render/environmentContribution.ts +0 -188
  421. package/templates/runner/src/render/environmentRadiance.ts +0 -36
  422. package/templates/runner/src/render/environmentSampleCache.ts +0 -43
  423. package/templates/runner/src/render/environmentSampling.ts +0 -193
  424. package/templates/runner/src/render/environmentSnapshot.ts +0 -53
  425. package/templates/sailing/.codex/config.toml +0 -23
  426. package/templates/sailing/.cursor/mcp.json +0 -38
  427. package/templates/sailing/.gemini/settings.json +0 -38
  428. package/templates/sailing/.mcp.json +0 -38
  429. package/templates/sailing/.vscode/mcp.json +0 -43
  430. package/templates/sailing/.zed/settings.json +0 -43
  431. package/templates/sailing/README.md +0 -28
  432. package/templates/sailing/opencode.json +0 -49
  433. package/templates/sailing/src/render/environmentContribution.ts +0 -188
  434. package/templates/sailing/src/render/environmentRadiance.ts +0 -36
  435. package/templates/sailing/src/render/environmentSampleCache.ts +0 -43
  436. package/templates/sailing/src/render/environmentSampling.ts +0 -193
  437. package/templates/sailing/src/render/environmentSnapshot.ts +0 -53
  438. package/templates/shooter/.codex/config.toml +0 -23
  439. package/templates/shooter/.cursor/mcp.json +0 -38
  440. package/templates/shooter/.gemini/settings.json +0 -38
  441. package/templates/shooter/.mcp.json +0 -38
  442. package/templates/shooter/.vscode/mcp.json +0 -43
  443. package/templates/shooter/.zed/settings.json +0 -43
  444. package/templates/shooter/opencode.json +0 -49
  445. package/templates/shooter/src/render/environmentContribution.ts +0 -188
  446. package/templates/shooter/src/render/environmentRadiance.ts +0 -36
  447. package/templates/shooter/src/render/environmentSampleCache.ts +0 -43
  448. package/templates/shooter/src/render/environmentSampling.ts +0 -193
  449. package/templates/shooter/src/render/environmentSnapshot.ts +0 -53
  450. package/templates/snow/.codex/config.toml +0 -23
  451. package/templates/snow/.cursor/mcp.json +0 -38
  452. package/templates/snow/.gemini/settings.json +0 -38
  453. package/templates/snow/.mcp.json +0 -38
  454. package/templates/snow/.vscode/mcp.json +0 -43
  455. package/templates/snow/.zed/settings.json +0 -43
  456. package/templates/snow/README.md +0 -26
  457. package/templates/snow/opencode.json +0 -49
  458. package/templates/snow/src/render/environmentContribution.ts +0 -188
  459. package/templates/snow/src/render/environmentRadiance.ts +0 -36
  460. package/templates/snow/src/render/environmentSampleCache.ts +0 -43
  461. package/templates/snow/src/render/environmentSampling.ts +0 -193
  462. package/templates/snow/src/render/environmentSnapshot.ts +0 -53
  463. package/templates/starter/.codex/config.toml +0 -23
  464. package/templates/starter/.cursor/mcp.json +0 -38
  465. package/templates/starter/.gemini/settings.json +0 -38
  466. package/templates/starter/.mcp.json +0 -38
  467. package/templates/starter/.vscode/mcp.json +0 -43
  468. package/templates/starter/.zed/settings.json +0 -43
  469. package/templates/starter/opencode.json +0 -49
  470. package/templates/starter/src/render/environmentContribution.ts +0 -188
  471. package/templates/starter/src/render/environmentRadiance.ts +0 -36
  472. package/templates/starter/src/render/environmentSampleCache.ts +0 -43
  473. package/templates/starter/src/render/environmentSampling.ts +0 -193
  474. package/templates/starter/src/render/environmentSnapshot.ts +0 -53
  475. package/templates/starter/src/render/rendererGate.ts +0 -36
  476. package/templates/tower-defense/.codex/config.toml +0 -23
  477. package/templates/tower-defense/.cursor/mcp.json +0 -38
  478. package/templates/tower-defense/.gemini/settings.json +0 -38
  479. package/templates/tower-defense/.mcp.json +0 -38
  480. package/templates/tower-defense/.vscode/mcp.json +0 -43
  481. package/templates/tower-defense/.zed/settings.json +0 -43
  482. package/templates/tower-defense/README.md +0 -16
  483. package/templates/tower-defense/opencode.json +0 -49
  484. package/templates/tower-defense/src/render/environmentContribution.ts +0 -188
  485. package/templates/tower-defense/src/render/environmentRadiance.ts +0 -36
  486. package/templates/tower-defense/src/render/environmentSampleCache.ts +0 -43
  487. package/templates/tower-defense/src/render/environmentSampling.ts +0 -193
  488. package/templates/tower-defense/src/render/environmentSnapshot.ts +0 -53
@@ -1,21 +0,0 @@
1
- # Template rendering
2
-
3
- The shared Unreal 5.8.3 look comes from `@threenative/core`: `WorldEnvironment`,
4
- `qualityPreset` and `qualityTiers`. Keep scene lighting, materials and authored stages in
5
- `src/render/`. Each kit's `quality.ts` spreads the core preset and names any override with
6
- its reason. `tonemapMode: "aces"` and `autoExposureEnabled: false` with fixed `exposure`
7
- are explicit overrides, reported by the chain.
8
-
9
- The starter kits meter at 0 EV (key 0.18), not core's Unreal +1 EV: `template-assets/kitExposure.ts`
10
- is the one source, `pnpm stamp:template-render` copies it into each kit's `src/render/kitExposure.ts`,
11
- and `kit-exposure.spec.ts` names the kits that keep their own key (minimal, rain, shooter, snow).
12
-
13
- The tuning target is `scripts/unreal-look/scaffold/Reference.ts.in` at L9 and the
14
- `CalibrationScene.ts.in` scenes. Judge the kit's own game against two headed WebGPU runs
15
- per arm and the target frames. Each migration requires a fresh read-only judge's
16
- IMPROVEMENT, with gameplay subjects at least as readable. Adjust old look assertions only
17
- after that verdict. Keep frame budgets and timeouts fixed; a budget breach selects a lower
18
- `renderChainTier`, keeping the filmic curve and metered exposure.
19
-
20
- PRD-723 migrates the kits one at a time. Until a kit's visual judge approves migration,
21
- its `quality.ts` explicitly retains ACES and fixed exposure to preserve its baseline.
@@ -1,23 +0,0 @@
1
- <!-- Generated mirror of AGENTS.md. Do not edit; edit AGENTS.md. -->
2
-
3
- # Template rendering
4
-
5
- The shared Unreal 5.8.3 look comes from `@threenative/core`: `WorldEnvironment`,
6
- `qualityPreset` and `qualityTiers`. Keep scene lighting, materials and authored stages in
7
- `src/render/`. Each kit's `quality.ts` spreads the core preset and names any override with
8
- its reason. `tonemapMode: "aces"` and `autoExposureEnabled: false` with fixed `exposure`
9
- are explicit overrides, reported by the chain.
10
-
11
- The starter kits meter at 0 EV (key 0.18), not core's Unreal +1 EV: `template-assets/kitExposure.ts`
12
- is the one source, `pnpm stamp:template-render` copies it into each kit's `src/render/kitExposure.ts`,
13
- and `kit-exposure.spec.ts` names the kits that keep their own key (minimal, rain, shooter, snow).
14
-
15
- The tuning target is `scripts/unreal-look/scaffold/Reference.ts.in` at L9 and the
16
- `CalibrationScene.ts.in` scenes. Judge the kit's own game against two headed WebGPU runs
17
- per arm and the target frames. Each migration requires a fresh read-only judge's
18
- IMPROVEMENT, with gameplay subjects at least as readable. Adjust old look assertions only
19
- after that verdict. Keep frame budgets and timeouts fixed; a budget breach selects a lower
20
- `renderChainTier`, keeping the filmic curve and metered exposure.
21
-
22
- PRD-723 migrates the kits one at a time. Until a kit's visual judge approves migration,
23
- its `quality.ts` explicitly retains ACES and fixed exposure to preserve its baseline.
@@ -1,23 +0,0 @@
1
- [mcp_servers.threenative-assets]
2
- command = "node"
3
- args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
-
5
- [mcp_servers.threenative-assets.env]
6
- ASSET_DOWNLOAD_DIR = "./public/assets"
7
- AUDIO_DOWNLOAD_DIR = "./public/audio"
8
-
9
- [mcp_servers.threenative-sculpt]
10
- command = "node"
11
- args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
-
13
- [mcp_servers.threenative-engine]
14
- command = "node"
15
- args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
16
-
17
- [mcp_servers.threenative-animation]
18
- command = "node"
19
- args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
20
-
21
- [mcp_servers.threenative-devtools]
22
- command = "node"
23
- args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
@@ -1,38 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "threenative-assets": {
4
- "command": "node",
5
- "args": [
6
- "./node_modules/@threenative/core/mcp/assets.mjs"
7
- ],
8
- "env": {
9
- "ASSET_DOWNLOAD_DIR": "./public/assets",
10
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
- }
12
- },
13
- "threenative-sculpt": {
14
- "command": "node",
15
- "args": [
16
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
- ]
18
- },
19
- "threenative-engine": {
20
- "command": "node",
21
- "args": [
22
- "./node_modules/@threenative/core/mcp/engine.mjs"
23
- ]
24
- },
25
- "threenative-animation": {
26
- "command": "node",
27
- "args": [
28
- "./node_modules/@threenative/core/mcp/animation.mjs"
29
- ]
30
- },
31
- "threenative-devtools": {
32
- "command": "node",
33
- "args": [
34
- "./node_modules/@threenative/core/mcp/devtools.mjs"
35
- ]
36
- }
37
- }
38
- }
@@ -1,38 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "threenative-assets": {
4
- "command": "node",
5
- "args": [
6
- "./node_modules/@threenative/core/mcp/assets.mjs"
7
- ],
8
- "env": {
9
- "ASSET_DOWNLOAD_DIR": "./public/assets",
10
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
- }
12
- },
13
- "threenative-sculpt": {
14
- "command": "node",
15
- "args": [
16
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
- ]
18
- },
19
- "threenative-engine": {
20
- "command": "node",
21
- "args": [
22
- "./node_modules/@threenative/core/mcp/engine.mjs"
23
- ]
24
- },
25
- "threenative-animation": {
26
- "command": "node",
27
- "args": [
28
- "./node_modules/@threenative/core/mcp/animation.mjs"
29
- ]
30
- },
31
- "threenative-devtools": {
32
- "command": "node",
33
- "args": [
34
- "./node_modules/@threenative/core/mcp/devtools.mjs"
35
- ]
36
- }
37
- }
38
- }
@@ -1,38 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "threenative-assets": {
4
- "command": "node",
5
- "args": [
6
- "./node_modules/@threenative/core/mcp/assets.mjs"
7
- ],
8
- "env": {
9
- "ASSET_DOWNLOAD_DIR": "./public/assets",
10
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
11
- }
12
- },
13
- "threenative-sculpt": {
14
- "command": "node",
15
- "args": [
16
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
17
- ]
18
- },
19
- "threenative-engine": {
20
- "command": "node",
21
- "args": [
22
- "./node_modules/@threenative/core/mcp/engine.mjs"
23
- ]
24
- },
25
- "threenative-animation": {
26
- "command": "node",
27
- "args": [
28
- "./node_modules/@threenative/core/mcp/animation.mjs"
29
- ]
30
- },
31
- "threenative-devtools": {
32
- "command": "node",
33
- "args": [
34
- "./node_modules/@threenative/core/mcp/devtools.mjs"
35
- ]
36
- }
37
- }
38
- }
@@ -1,43 +0,0 @@
1
- {
2
- "servers": {
3
- "threenative-assets": {
4
- "type": "stdio",
5
- "command": "node",
6
- "args": [
7
- "./node_modules/@threenative/core/mcp/assets.mjs"
8
- ],
9
- "env": {
10
- "ASSET_DOWNLOAD_DIR": "./public/assets",
11
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
12
- }
13
- },
14
- "threenative-sculpt": {
15
- "type": "stdio",
16
- "command": "node",
17
- "args": [
18
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
19
- ]
20
- },
21
- "threenative-engine": {
22
- "type": "stdio",
23
- "command": "node",
24
- "args": [
25
- "./node_modules/@threenative/core/mcp/engine.mjs"
26
- ]
27
- },
28
- "threenative-animation": {
29
- "type": "stdio",
30
- "command": "node",
31
- "args": [
32
- "./node_modules/@threenative/core/mcp/animation.mjs"
33
- ]
34
- },
35
- "threenative-devtools": {
36
- "type": "stdio",
37
- "command": "node",
38
- "args": [
39
- "./node_modules/@threenative/core/mcp/devtools.mjs"
40
- ]
41
- }
42
- }
43
- }
@@ -1,43 +0,0 @@
1
- {
2
- "context_servers": {
3
- "threenative-assets": {
4
- "source": "custom",
5
- "command": "node",
6
- "args": [
7
- "./node_modules/@threenative/core/mcp/assets.mjs"
8
- ],
9
- "env": {
10
- "ASSET_DOWNLOAD_DIR": "./public/assets",
11
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
12
- }
13
- },
14
- "threenative-sculpt": {
15
- "source": "custom",
16
- "command": "node",
17
- "args": [
18
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
19
- ]
20
- },
21
- "threenative-engine": {
22
- "source": "custom",
23
- "command": "node",
24
- "args": [
25
- "./node_modules/@threenative/core/mcp/engine.mjs"
26
- ]
27
- },
28
- "threenative-animation": {
29
- "source": "custom",
30
- "command": "node",
31
- "args": [
32
- "./node_modules/@threenative/core/mcp/animation.mjs"
33
- ]
34
- },
35
- "threenative-devtools": {
36
- "source": "custom",
37
- "command": "node",
38
- "args": [
39
- "./node_modules/@threenative/core/mcp/devtools.mjs"
40
- ]
41
- }
42
- }
43
- }
@@ -1,49 +0,0 @@
1
- {
2
- "$schema": "https://opencode.ai/config.json",
3
- "mcp": {
4
- "threenative-assets": {
5
- "type": "local",
6
- "command": [
7
- "node",
8
- "./node_modules/@threenative/core/mcp/assets.mjs"
9
- ],
10
- "enabled": true,
11
- "environment": {
12
- "ASSET_DOWNLOAD_DIR": "./public/assets",
13
- "AUDIO_DOWNLOAD_DIR": "./public/audio"
14
- }
15
- },
16
- "threenative-sculpt": {
17
- "type": "local",
18
- "command": [
19
- "node",
20
- "./node_modules/@threenative/core/mcp/sculpt.mjs"
21
- ],
22
- "enabled": true
23
- },
24
- "threenative-engine": {
25
- "type": "local",
26
- "command": [
27
- "node",
28
- "./node_modules/@threenative/core/mcp/engine.mjs"
29
- ],
30
- "enabled": true
31
- },
32
- "threenative-animation": {
33
- "type": "local",
34
- "command": [
35
- "node",
36
- "./node_modules/@threenative/core/mcp/animation.mjs"
37
- ],
38
- "enabled": true
39
- },
40
- "threenative-devtools": {
41
- "type": "local",
42
- "command": [
43
- "node",
44
- "./node_modules/@threenative/core/mcp/devtools.mjs"
45
- ],
46
- "enabled": true
47
- }
48
- }
49
- }
@@ -1,188 +0,0 @@
1
- // Generated for you. Measure actual source radiance; unreadable environments stay unknown.
2
- import {
3
- type Color,
4
- EquirectangularReflectionMapping,
5
- FloatType,
6
- LinearSRGBColorSpace,
7
- NoColorSpace,
8
- RGBAFormat,
9
- SRGBColorSpace,
10
- type Scene,
11
- type Texture,
12
- UnsignedByteType,
13
- } from "three";
14
-
15
- export interface IEnvironmentMeasurement {
16
- readonly status: "measured" | "unknown";
17
- readonly meanRadiance: number | null;
18
- readonly meanRGB: readonly [number, number, number] | null;
19
- readonly reason: string;
20
- }
21
- const unknown = (reason: string): IEnvironmentMeasurement => ({
22
- status: "unknown",
23
- meanRadiance: null,
24
- meanRGB: null,
25
- reason,
26
- });
27
- const linear = (value: number) =>
28
- value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
29
-
30
- function validSize(value: unknown): value is number {
31
- return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
32
- }
33
- interface IReadableSource {
34
- readonly status: "source";
35
- readonly data: Uint8Array | Float32Array;
36
- readonly width: number;
37
- readonly height: number;
38
- readonly bytes: boolean;
39
- }
40
- function readSource(
41
- texture: Texture,
42
- maxSourceTexels: number,
43
- ): IReadableSource | IEnvironmentMeasurement {
44
- if (texture.mapping !== EquirectangularReflectionMapping)
45
- return unknown("Only CPU-readable equirectangular source radiance is qualified.");
46
- const image: unknown = texture.image;
47
- if (
48
- image === null ||
49
- typeof image !== "object" ||
50
- !("data" in image) ||
51
- !("width" in image) ||
52
- !("height" in image)
53
- )
54
- return unknown("Environment source pixels are not CPU-readable; no radiance was inferred.");
55
- const { data, width, height } = image;
56
- if (!validSize(width) || !validSize(height))
57
- return unknown("Environment source dimensions are invalid.");
58
- if (width * height > maxSourceTexels)
59
- return unknown("Environment CPU sample budget exceeded; no radiance was inferred.");
60
- if (texture.format !== RGBAFormat)
61
- return unknown("Only explicit RGBA source samples are qualified.");
62
- const bytes = texture.type === UnsignedByteType && data instanceof Uint8Array;
63
- const floats = texture.type === FloatType && data instanceof Float32Array;
64
- if (!bytes && !floats) return unknown("Environment source sample type is not qualified.");
65
- if (data.length !== width * height * 4)
66
- return unknown("Environment source samples do not match their dimensions.");
67
- if (
68
- !new Set<string>([NoColorSpace, LinearSRGBColorSpace, SRGBColorSpace]).has(texture.colorSpace)
69
- )
70
- return unknown("Environment source color-space conversion is not qualified.");
71
- return { status: "source", data, width, height, bytes };
72
- }
73
-
74
- function accumulate(source: IReadableSource, srgb: boolean) {
75
- const { data, width, height, bytes } = source;
76
- const sums = [0, 0, 0];
77
- const weights = Array.from(
78
- { length: height },
79
- (_, y) => Math.cos((Math.PI * y) / height) - Math.cos((Math.PI * (y + 1)) / height),
80
- );
81
- for (let offset = 0; offset < data.length; offset += 4) {
82
- const weight = weights[Math.floor(offset / (width * 4))] ?? 0;
83
- for (let channel = 0; channel < 3; channel += 1) {
84
- const sample = data[offset + channel];
85
- if (sample === undefined || !Number.isFinite(sample) || sample < 0)
86
- return unknown("Environment radiance samples must be finite and nonnegative.");
87
- const value = bytes ? sample / 255 : sample;
88
- sums[channel] = (sums[channel] ?? 0) + (srgb ? linear(value) : value) * weight;
89
- }
90
- }
91
- return { sums, weightSum: weights.reduce((a, b) => a + b, 0) * width };
92
- }
93
-
94
- /**
95
- * CPU-readable equirectangular source radiance only; no DOM/canvas or invented JPEG mean.
96
- * Rows are weighted by their exact spherical solid angle, rather than overweighting the poles.
97
- * Arbitrary GPU/compressed/HTML/cube sources remain explicitly unknown until separately proven.
98
- */
99
- export function measureEnvironment(scene: Scene, maxSourceTexels: number): IEnvironmentMeasurement {
100
- if (!Number.isSafeInteger(maxSourceTexels) || maxSourceTexels < 1)
101
- throw new Error("Environment CPU sample budget must be a positive safe integer.");
102
- const texture = scene.environment;
103
- if (texture === null)
104
- return {
105
- status: "measured",
106
- meanRadiance: 0,
107
- meanRGB: [0, 0, 0],
108
- reason: "No environment is bound.",
109
- };
110
- if (!Number.isFinite(scene.environmentIntensity) || scene.environmentIntensity < 0)
111
- return unknown("Environment intensity must be finite and nonnegative.");
112
- const source = readSource(texture, maxSourceTexels);
113
- if (source.status !== "source") return source;
114
- const accumulated = accumulate(source, texture.colorSpace === SRGBColorSpace);
115
- if ("status" in accumulated) return accumulated;
116
- const { sums, weightSum } = accumulated;
117
- const meanRGB = sums.map((sum) => (sum / weightSum) * scene.environmentIntensity) as [
118
- number,
119
- number,
120
- number,
121
- ];
122
- const meanRadiance = meanRGB[0] * 0.2126 + meanRGB[1] * 0.7152 + meanRGB[2] * 0.0722;
123
- if (!meanRGB.every(Number.isFinite) || !Number.isFinite(meanRadiance))
124
- return unknown("Environment radiance accumulation overflowed.");
125
- return {
126
- status: "measured",
127
- meanRadiance,
128
- meanRGB,
129
- reason: "Solid-angle-weighted linear source radiance, with active environment intensity.",
130
- };
131
- }
132
-
133
- interface IContributionControls {
134
- readonly darkThreshold: number;
135
- readonly rimGain: number;
136
- readonly fillGain: number;
137
- readonly fillAdmitted: boolean;
138
- readonly fillColor: Color;
139
- readonly maxSourceTexels: number;
140
- }
141
- function fillReport(options: IContributionControls) {
142
- const blackColorOverride = options.fillColor.toArray().every((value) => value === 0);
143
- let reason = "analytic fill enabled by caller; contribution still needs pixel qualification";
144
- if (!options.fillAdmitted) reason = "not admitted by this qualification";
145
- else if (options.fillGain === 0) reason = "disabled by fillGain override";
146
- else if (blackColorOverride) reason = "disabled by black fillColor override";
147
- return {
148
- requestedGain: options.fillGain,
149
- admitted: options.fillAdmitted,
150
- effectiveGain: options.fillAdmitted ? options.fillGain : 0,
151
- color: options.fillColor.toArray(),
152
- blackColorOverride,
153
- reason,
154
- };
155
- }
156
- /** Overrides change the look, never whether its source contribution is measured/reported. */
157
- export function reportEnvironmentContribution(
158
- scene: Scene,
159
- options: IContributionControls,
160
- measurement?: IEnvironmentMeasurement,
161
- ) {
162
- if (
163
- ![
164
- options.darkThreshold,
165
- options.rimGain,
166
- options.fillGain,
167
- ...options.fillColor.toArray(),
168
- ].every((value) => Number.isFinite(value) && value >= 0)
169
- )
170
- throw new Error("Backlight measurement controls must be finite and nonnegative.");
171
- const measured = measurement ?? measureEnvironment(scene, options.maxSourceTexels);
172
- const dark =
173
- measured.meanRadiance === null ? null : measured.meanRadiance <= options.darkThreshold;
174
- const environmentState =
175
- scene.environment === null ? "missing" : dark === null ? "unknown" : dark ? "dark" : "bright";
176
- const report = {
177
- ...measured,
178
- scope: "scene environment source availability; not material-specific reflected contribution",
179
- environmentState,
180
- ibl: dark === null ? "unknown" : dark ? "non-contributing" : "contributing",
181
- analyticFill: fillReport(options),
182
- rimGain: options.rimGain,
183
- fillGain: options.fillGain,
184
- darkThreshold: options.darkThreshold,
185
- };
186
- console.info(`TN_ENVIRONMENT_CONTRIBUTION:${JSON.stringify(report)}`);
187
- return report;
188
- }
@@ -1,36 +0,0 @@
1
- // Generated for you. Spherical accumulation of bounded linear source samples.
2
- import type { IEnvironmentMeasurement } from "./environmentContribution.js";
3
- const WIDTH = 64;
4
- const HEIGHT = 32;
5
- function unmeasured(reason: string): IEnvironmentMeasurement {
6
- return { status: "unknown", meanRadiance: null, meanRGB: null, reason };
7
- }
8
- export function sampledRadiance(samples: unknown, intensity: number): IEnvironmentMeasurement {
9
- if (!(samples instanceof Float32Array) || samples.length !== WIDTH * HEIGHT * 4)
10
- return unmeasured("GPU readback did not provide the qualified float RGBA sample layout.");
11
- const sums = [0, 0, 0];
12
- const weights = Array.from(
13
- { length: HEIGHT },
14
- (_, y) => Math.cos((Math.PI * y) / HEIGHT) - Math.cos((Math.PI * (y + 1)) / HEIGHT),
15
- );
16
- const totalWeight = weights.reduce((sum, weight) => sum + weight, 0) * WIDTH;
17
- for (const [offset, value] of samples.entries()) {
18
- const channel = offset % 4;
19
- if (channel === 3) continue;
20
- if (!Number.isFinite(value) || value < 0)
21
- return unmeasured("GPU radiance samples must be finite and nonnegative.");
22
- const weight = weights[Math.floor(offset / (WIDTH * 4))] ?? 0;
23
- sums[channel] = (sums[channel] ?? 0) + value * weight;
24
- }
25
- const meanRGB = sums.map((sum) => (sum / totalWeight) * intensity) as [number, number, number];
26
- const meanRadiance = meanRGB[0] * 0.2126 + meanRGB[1] * 0.7152 + meanRGB[2] * 0.0722;
27
- if (!meanRGB.every(Number.isFinite) || !Number.isFinite(meanRadiance))
28
- return unmeasured("GPU radiance accumulation overflowed.");
29
- return {
30
- status: "measured",
31
- meanRGB,
32
- meanRadiance,
33
- reason:
34
- "Estimated linear scene-environment source radiance from 64x32 GPU samples, spherical row weighting and active intensity; not material-specific BRDF contribution.",
35
- };
36
- }
@@ -1,43 +0,0 @@
1
- // Generated for you. Weak ownership and full provenance guard successful source estimates.
2
- import type { Scene, Texture } from "three";
3
- import type { IEnvironmentSample } from "./environmentSampling.js";
4
- import { environmentSnapshotCurrent } from "./environmentSnapshot.js";
5
- const samples = new WeakMap<object, WeakMap<Texture, IEnvironmentSample>>();
6
- export function cachedEnvironmentSample(
7
- renderer: object,
8
- scene: Scene,
9
- ): IEnvironmentSample | undefined {
10
- if (scene.environment === null) return undefined;
11
- const sample = samples.get(renderer)?.get(scene.environment);
12
- return sample !== undefined && environmentSnapshotCurrent(scene, sample)
13
- ? copySample(sample)
14
- : undefined;
15
- }
16
- export function cacheEnvironmentSample(
17
- renderer: object,
18
- scene: Scene,
19
- sample: IEnvironmentSample,
20
- ): void {
21
- if (
22
- sample.source === null ||
23
- sample.measurement.status !== "measured" ||
24
- !environmentSnapshotCurrent(scene, sample)
25
- )
26
- return;
27
- let byTexture = samples.get(renderer);
28
- if (byTexture === undefined) {
29
- byTexture = new WeakMap();
30
- samples.set(renderer, byTexture);
31
- }
32
- byTexture.set(sample.source, copySample(sample));
33
- }
34
-
35
- function copySample(sample: IEnvironmentSample): IEnvironmentSample {
36
- return {
37
- ...sample,
38
- measurement: {
39
- ...sample.measurement,
40
- meanRGB: sample.measurement.meanRGB === null ? null : [...sample.measurement.meanRGB],
41
- },
42
- };
43
- }