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,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
- }