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
@@ -0,0 +1,10 @@
1
+ ## MCP servers
2
+
3
+ `.mcp.json` wires six servers, and a session started in this folder loads them. Their tools can show as deferred: load them with `ToolSearch` `select:` plus the exact names, for example `select:mcp__threenative-engine__engine_search_capabilities,mcp__threenative-engine__engine_capability_detail,mcp__threenative-engine__engine_search_references,mcp__threenative-engine__engine_reference_detail,mcp__threenative-engine__engine_watch_reference`. A session started outside this folder runs `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`; `call.mjs <server>` lists that server's tools.
4
+
5
+ - `threenative-engine`: before any new mechanic, helper or render stage, and on a slow frame or a wrong image. `engine_search_capabilities`, `engine_capability_detail`, `engine_search_references`, `engine_reference_detail`, `engine_watch_reference`.
6
+ - `threenative-assets`: a texture, HDRI, sound or model. `asset_search_sources`, `asset_download_file`, `audio_search_assets`, `mesh_optimize`.
7
+ - `threenative-sculpt`: a bespoke mesh or character from a reference image. `sculpt_plan`, `sculpt_spec_gate`, `sculpt_compare`, `sculpt_pass_gate`.
8
+ - `threenative-animation`: a rigged GLB with a held prop, foot slide or loop seam. `animation_inspect`, `animation_attach`, `animation_verify`.
9
+ - `threenative-terrain`: any terrain, from words. `terrain_generate`.
10
+ - `threenative-devtools`: after `npx @threenative/playtest trace` names no cause. `performance_start_trace`, `performance_analyze_insight`.
@@ -0,0 +1,14 @@
1
+ ## Authoring flow
2
+
3
+ Detail for each step: `threenative-capabilities` skill. Do the steps in order. A step with no result records `none: <reason>`. A blank step blocks the next. A hook blocks the first new file under `src/` until step 3 ran for the current prompt (`TN_DISCOVERY_GATE=off` opts out; Codex needs `/hooks` trust).
4
+
5
+ 1. **Kit** (new game only): `engine_search_capabilities {situation: "<the whole request>", scope: "request"}` returns the matching starter kit first. This folder is already a kit.
6
+ 2. **Mechanics**: per mechanic, `engine_search_references {situation}`, then `engine_reference_detail` on each hit for pinned constants and feel. To see a mechanic move, `engine_watch_reference {query: "<game> <mechanic>"}` returns a contact sheet of real gameplay. Borrow mechanics only: no code, level layouts, character names or art. Cite `file:line`.
7
+ 3. **Built-ins**: per mechanic, system or symptom, `engine_search_capabilities {situation, scope: "mechanic"}`; rows answer; `engine_capability_detail` only for omitted symbols. Constraints are binding. `verdict: "none"` means the game writes it in `src/`.
8
+ 4. **Plan** (new game, or a change to several systems): `prd-creator` with the kit, references and built-ins. With a user, wait for explicit approval, then implement. With no user (`claude -p`, a script), record the plan and assumptions, then continue.
9
+ 5. **Assets**: `asset_search_sources`, the source's search tool, then `asset_download_file`; record source and licence in `CREDITS.md`. Nothing fits: `sculpt_plan`. A rigged GLB: `animation_inspect` (`threenative-assets` skill).
10
+ 6. **Build**: gameplay in `src/`, look in `src/render/` (`threenative-context` and `threenative-ui` skills). For parallel work, give each subagent one area and its files, then integrate.
11
+ 7. **Prove**: one fail-closed playtest per mechanic, then `pnpm test` (`threenative-playtest` skill). A fresh judge compares a `--browser-recipe webgpu --headed` capture to the reference image (`threenative-visuals` skill; `node_modules/create-threenative/agent-docs/references/dream-loop.md`).
12
+ 8. **Report**: the `pnpm dev` URL, `TN_FRAME_BUDGET`, `TN_SCENE_WARNING`, `TN_RENDER_PROJECTION`, and each skipped step with its reason.
13
+
14
+ A change to an existing game repeats steps 2-3 for that change, then steps 5-8.
@@ -0,0 +1,7 @@
1
+ ## When the framework blocks you, write plain Three.js
2
+
3
+ When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you** (API, expectation, result, replacement); do not stall the game.
4
+
5
+ ## Stuck
6
+
7
+ `npx threenative doctor`, then `npx @threenative/playtest doctor`; a missing observation is not zero. A confirmed engine bug: `file-engine-bug` skill. Smallest correct change: `ponytail` skill. Slow frame: `threenative-performance` skill.
@@ -12,7 +12,7 @@ trivially fails `TN_PLAYTEST_SCENARIO_ASSERTS_NOTHING`.
12
12
 
13
13
  Bounds display-referred luminance from a captured PNG frame, using a shared 256-bin histogram. **Use when** that is the thing the scenario must prove.
14
14
 
15
- - **Supported on:** web, desktop, bevy · **Requires:** browser.screenshot
15
+ - **Supported on:** browser, android, desktop, ios · **Requires:** browser.screenshot
16
16
 
17
17
  | Field | Type | Required |
18
18
  | --- | --- | --- |
@@ -48,7 +48,7 @@ Bounds display-referred luminance from a captured PNG frame, using a shared 256-
48
48
 
49
49
  Reports the device's thermal, power and battery state around the run and judges whether the run is comparable with a cool one. **Use when** that is the thing the scenario must prove.
50
50
 
51
- - **Supported on:** web, desktop, bevy · **Requires:** device.metrics
51
+ - **Supported on:** android · **Requires:** device.metrics
52
52
 
53
53
  | Field | Type | Required |
54
54
  | --- | --- | --- |
@@ -70,7 +70,7 @@ Reports the device's thermal, power and battery state around the run and judges
70
70
 
71
71
  Samples the framebuffer on every render frame inside a labeled loading window and requires every coarse-grid RGB sample to match the declared backdrop. **Use when** that is the thing the scenario must prove.
72
72
 
73
- - **Supported on:** web, desktop, bevy · **Requires:** browser.screenshot
73
+ - **Supported on:** browser, android · **Requires:** browser.screenshot
74
74
 
75
75
  | Field | Type | Required |
76
76
  | --- | --- | --- |
@@ -101,35 +101,11 @@ Samples the framebuffer on every render frame inside a labeled loading window an
101
101
  }
102
102
  ```
103
103
 
104
- ### `reachability`
105
-
106
- Checks every consecutive platform against a measured static movement-envelope fit; it does not simulate traversal, walls, ceilings, run-up, or air control. **Use when** that is the thing the scenario must prove.
107
-
108
- - **Supported on:** web, desktop, bevy · **Requires:** entity.observe
109
-
110
- | Field | Type | Required |
111
- | --- | --- | --- |
112
- | `artifact` | string | yes |
113
- | `entities` | string[] (minimum 2) | yes |
114
-
115
-
116
- ```json
117
- {
118
- "reachability": {
119
- "artifact": "artifacts/character-envelope/player.json",
120
- "entities": [
121
- "platform.a",
122
- "platform.b"
123
- ]
124
- }
125
- }
126
- ```
127
-
128
104
  ### `aerodynamics`
129
105
 
130
106
  Proves aerodynamic force telemetry and signed control-surface delivery for a flight entity. **Use when** that is the thing the scenario must prove.
131
107
 
132
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.fixedStep, runtime.physics
108
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.fixedStep, runtime.physics
133
109
 
134
110
  | Field | Type | Required |
135
111
  | --- | --- | --- |
@@ -160,7 +136,7 @@ Proves aerodynamic force telemetry and signed control-surface delivery for a fli
160
136
 
161
137
  Proves screenshot change, populated coordinate or DOM element-bound regions, dark-pixel bounds, and sustained projected entity visibility. **Use when** that is the thing the scenario must prove.
162
138
 
163
- - **Supported on:** web · **Requires:** browser.screenshot
139
+ - **Supported on:** browser · **Requires:** browser.screenshot
164
140
 
165
141
  | Field | Type | Required |
166
142
  | --- | --- | --- |
@@ -197,7 +173,7 @@ Proves screenshot change, populated coordinate or DOM element-bound regions, dar
197
173
 
198
174
  Proves the subject moved, reached a minimum velocity, or changed rotation during held input. **Use when** that is the thing the scenario must prove.
199
175
 
200
- - **Supported on:** web, desktop, bevy · **Requires:** entity.observe
176
+ - **Supported on:** browser, android, desktop, ios · **Requires:** entity.observe
201
177
 
202
178
  | Field | Type | Required |
203
179
  | --- | --- | --- |
@@ -233,7 +209,7 @@ Proves the subject moved, reached a minimum velocity, or changed rotation during
233
209
 
234
210
  Proves a camera follows an entity or keeps a target in view. **Use when** that is the thing the scenario must prove.
235
211
 
236
- - **Supported on:** web, desktop, bevy · **Requires:** camera.observe, entity.observe
212
+ - **Supported on:** browser, android, desktop, ios · **Requires:** camera.observe, entity.observe
237
213
 
238
214
  | Field | Type | Required |
239
215
  | --- | --- | --- |
@@ -258,7 +234,7 @@ Proves a camera follows an entity or keeps a target in view. **Use when** that i
258
234
 
259
235
  Proves a live entity component value after the scenario or at named steps. **Use when** that is the thing the scenario must prove.
260
236
 
261
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.components
237
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.components
262
238
 
263
239
  | Field | Type | Required |
264
240
  | --- | --- | --- |
@@ -291,7 +267,7 @@ Proves a live entity component value after the scenario or at named steps. **Use
291
267
 
292
268
  Proves resource state after the scenario through equals, gte, lte, textIncludes, or changed checks. **Use when** that is the thing the scenario must prove.
293
269
 
294
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.resources
270
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.resources
295
271
 
296
272
  | Field | Type | Required |
297
273
  | --- | --- | --- |
@@ -325,7 +301,7 @@ Proves resource state after the scenario through equals, gte, lte, textIncludes,
325
301
 
326
302
  Proves the final count of entities carrying a bounded runtime tag. **Use when** that is the thing the scenario must prove.
327
303
 
328
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.tags
304
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.tags
329
305
 
330
306
  | Field | Type | Required |
331
307
  | --- | --- | --- |
@@ -351,7 +327,7 @@ Proves the final count of entities carrying a bounded runtime tag. **Use when**
351
327
 
352
328
  Proves a named Godot signal was emitted by the application during the run or at a labeled step. **Use when** that is the thing the scenario must prove.
353
329
 
354
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.events
330
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.events
355
331
 
356
332
  | Field | Type | Required |
357
333
  | --- | --- | --- |
@@ -379,7 +355,7 @@ Proves a named Godot signal was emitted by the application during the run or at
379
355
 
380
356
  Proves an observed entity's final runtime-owned state-machine state. **Use when** that is the thing the scenario must prove.
381
357
 
382
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.state
358
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.state
383
359
 
384
360
  | Field | Type | Required |
385
361
  | --- | --- | --- |
@@ -402,7 +378,7 @@ Proves an observed entity's final runtime-owned state-machine state. **Use when*
402
378
 
403
379
  Proves retained UI/HUD text or values after the scenario. **Use when** that is the thing the scenario must prove.
404
380
 
405
- - **Supported on:** web · **Requires:** browser.dom
381
+ - **Supported on:** browser · **Requires:** browser.dom
406
382
 
407
383
  | Field | Type | Required |
408
384
  | --- | --- | --- |
@@ -428,41 +404,11 @@ Proves retained UI/HUD text or values after the scenario. **Use when** that is t
428
404
  }
429
405
  ```
430
406
 
431
- ### `overlayNodes`
432
-
433
- Proves DOM state inside a same-origin webview overlay iframe. **Use when** that is the thing the scenario must prove.
434
-
435
- - **Supported on:** web · **Requires:** browser.dom
436
-
437
- | Field | Type | Required |
438
- | --- | --- | --- |
439
- | `overlayId` | string | yes |
440
- | `selector` | string | yes |
441
- | `attribute` | string | no |
442
- | `equals` | json | no |
443
- | `textIncludes` | string | no |
444
- | `visible` | boolean | no |
445
-
446
-
447
- ```json
448
- {
449
- "overlayNodes": [
450
- {
451
- "attribute": "data-aiming",
452
- "equals": "true",
453
- "overlayId": "game-ui",
454
- "selector": "[data-testid=fps-crosshair]",
455
- "visible": false
456
- }
457
- ]
458
- }
459
- ```
460
-
461
407
  ### `diagnostics`
462
408
 
463
409
  Proves console, network, runtime, and readiness diagnostics stayed clean. **Use when** that is the thing the scenario must prove.
464
410
 
465
- - **Supported on:** web, desktop · **Requires:** browser.console, browser.network, runtime.diagnostics
411
+ - **Supported on:** browser, android, desktop, ios · **Requires:** browser.console, browser.network, runtime.diagnostics
466
412
 
467
413
  | Field | Type | Required |
468
414
  | --- | --- | --- |
@@ -490,7 +436,7 @@ Proves console, network, runtime, and readiness diagnostics stayed clean. **Use
490
436
 
491
437
  Proves a live render sample exists and optionally bounds frame time, an fps floor, per-phase frame budget, whole-frame or per-pass draw calls and triangles. **Use when** that is the thing the scenario must prove.
492
438
 
493
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.performance
439
+ - **Supported on:** browser, desktop · **Requires:** runtime.performance
494
440
 
495
441
  | Field | Type | Required |
496
442
  | --- | --- | --- |
@@ -522,7 +468,7 @@ Proves a live render sample exists and optionally bounds frame time, an fps floo
522
468
 
523
469
  PRD-222 Tier 2: proves the fps ratio of a parity pair — the same scene on the same device, once in the browser and once native. Lives in the second run and names the first run's saved report; refuses a pair whose halves ran on different devices, a thermally confounded half, or a missing series on either side. **Use when** that is the thing the scenario must prove.
524
470
 
525
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.performance
471
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.performance
526
472
 
527
473
  | Field | Type | Required |
528
474
  | --- | --- | --- |
@@ -547,7 +493,7 @@ PRD-222 Tier 2: proves the fps ratio of a parity pair — the same scene on the
547
493
 
548
494
  Proves projected entity visibility in the viewport. **Use when** that is the thing the scenario must prove.
549
495
 
550
- - **Supported on:** web · **Requires:** entity.bounds
496
+ - **Supported on:** browser, android, desktop, ios · **Requires:** entity.bounds
551
497
 
552
498
  | Field | Type | Required |
553
499
  | --- | --- | --- |
@@ -574,7 +520,7 @@ Proves projected entity visibility in the viewport. **Use when** that is the thi
574
520
 
575
521
  Proves which labelled audio cues the game actually played, and how often. **Use when** that is the thing the scenario must prove.
576
522
 
577
- - **Supported on:** web, desktop · **Requires:** runtime.audio
523
+ - **Supported on:** browser, desktop · **Requires:** runtime.audio
578
524
 
579
525
  | Field | Type | Required |
580
526
  | --- | --- | --- |
@@ -599,7 +545,7 @@ Proves which labelled audio cues the game actually played, and how often. **Use
599
545
 
600
546
  Proves runtime world metadata exposed by the application bridge. **Use when** that is the thing the scenario must prove.
601
547
 
602
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.world
548
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.world
603
549
 
604
550
  | Field | Type | Required |
605
551
  | --- | --- | --- |
@@ -619,7 +565,7 @@ Proves runtime world metadata exposed by the application bridge. **Use when** th
619
565
 
620
566
  Proves contact or trigger evidence appeared in the effect log. **Use when** that is the thing the scenario must prove.
621
567
 
622
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.contacts
568
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.contacts
623
569
 
624
570
  | Field | Type | Required |
625
571
  | --- | --- | --- |
@@ -649,7 +595,7 @@ Proves contact or trigger evidence appeared in the effect log. **Use when** that
649
595
 
650
596
  Proves an observed cohort of matching physics bodies is asleep in a retained physics-debug sample. **Use when** that is the thing the scenario must prove.
651
597
 
652
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.physics
598
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.physics
653
599
 
654
600
  | Field | Type | Required |
655
601
  | --- | --- | --- |
@@ -673,35 +619,11 @@ Proves an observed cohort of matching physics bodies is asleep in a retained phy
673
619
  }
674
620
  ```
675
621
 
676
- ### `occluded`
677
-
678
- Proves rendered scene geometry occludes the segment between an origin entity and target. **Use when** that is the thing the scenario must prove.
679
-
680
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.physics
681
-
682
- | Field | Type | Required |
683
- | --- | --- | --- |
684
- | `entity` | string | no |
685
- | `target` | string | no |
686
- | `allowTrivial` | triviality reason | no |
687
-
688
-
689
- ```json
690
- {
691
- "occluded": [
692
- {
693
- "entity": "listener",
694
- "target": "emitter"
695
- }
696
- ]
697
- }
698
- ```
699
-
700
622
  ### `animation`
701
623
 
702
624
  Proves animation evidence appeared in the effect log or runtime observation. **Use when** that is the thing the scenario must prove.
703
625
 
704
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.animation
626
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.animation
705
627
 
706
628
  | Field | Type | Required |
707
629
  | --- | --- | --- |
@@ -734,7 +656,7 @@ Proves animation evidence appeared in the effect log or runtime observation. **U
734
656
 
735
657
  Bounds the room the game is played in — the lights, materials, fog and camera framing the renderer was handed. Fails closed on a bridge that does not report the scene. **Use when** that is the thing the scenario must prove.
736
658
 
737
- - **Supported on:** web, desktop, bevy · **Requires:** scene.observe
659
+ - **Supported on:** browser, android, desktop, ios · **Requires:** scene.observe
738
660
 
739
661
  | Field | Type | Required |
740
662
  | --- | --- | --- |
@@ -758,7 +680,7 @@ Bounds the room the game is played in — the lights, materials, fog and camera
758
680
 
759
681
  Bounds on named nodes of the scene graph — where an object is, whether it is on screen, whether its textures loaded. **Use when** that is the thing the scenario must prove.
760
682
 
761
- - **Supported on:** web, desktop, bevy · **Requires:** scene.nodes
683
+ - **Supported on:** browser, android, desktop, ios · **Requires:** scene.nodes
762
684
 
763
685
  | Field | Type | Required |
764
686
  | --- | --- | --- |
@@ -791,7 +713,7 @@ Bounds on named nodes of the scene graph — where an object is, whether it is o
791
713
 
792
714
  Bounds how far a planted foot slides while the subject moves, measured every tick from named foot nodes' world positions, so it holds a procedural rig to the feet-meet-the-floor convention as well as a clip. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
793
715
 
794
- - **Supported on:** web · **Requires:** entity.observe, scene.nodes
716
+ - **Supported on:** browser · **Requires:** entity.observe, scene.nodes
795
717
 
796
718
  | Field | Type | Required |
797
719
  | --- | --- | --- |
@@ -822,7 +744,7 @@ Bounds how far a planted foot slides while the subject moves, measured every tic
822
744
 
823
745
  Bounds the share of the run in which solid geometry stood between the camera and the subject's world bounds centre, so a camera that clips through a pillar or a wall that eats the framing fails. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
824
746
 
825
- - **Supported on:** web · **Requires:** camera.observe, entity.observe
747
+ - **Supported on:** browser · **Requires:** camera.observe, entity.observe
826
748
 
827
749
  | Field | Type | Required |
828
750
  | --- | --- | --- |
@@ -842,7 +764,7 @@ Bounds the share of the run in which solid geometry stood between the camera and
842
764
 
843
765
  Bounds the engine's own work counters, read off each TN_FRAME_BUDGET window's counters.engine (and counters.bridgeCrossings): JS-to-Wasm crossings, children reads, scene-walk visits, hierarchy moves, matrix composes, handle shares, content classification, GPU allocations, physics crossings and any counter an engine module adds to globalThis.__tnEngineCost. Each window must hold every bound; a run with fewer windows than minWindows, or a window missing a bounded counter, fails closed. A failure names the counter, the window and the top caller of the TN_BRIDGE_CENSUS before it. **Use when** that is the thing the scenario must prove.
844
766
 
845
- - **Supported on:** web · **Requires:** browser.console
767
+ - **Supported on:** browser · **Requires:** browser.console
846
768
 
847
769
  | Field | Type | Required |
848
770
  | --- | --- | --- |
@@ -872,7 +794,7 @@ Bounds the engine's own work counters, read off each TN_FRAME_BUDGET window's co
872
794
 
873
795
  Audits the text the page draws for the player: developer left-overs such as debug, TODO, placeholder or an unresolved undefined, and text whose colour is too close to its backing colour. Browser target only; another target fails it as unobserved. **Use when** that is the thing the scenario must prove.
874
796
 
875
- - **Supported on:** web · **Requires:** browser.dom
797
+ - **Supported on:** browser · **Requires:** browser.dom
876
798
 
877
799
  | Field | Type | Required |
878
800
  | --- | --- | --- |
@@ -893,7 +815,7 @@ Audits the text the page draws for the player: developer left-overs such as debu
893
815
 
894
816
  Relates a tick-stamped effect to the tick-stamped cause that must precede it — the 'because' a terminal state needs. **Use when** that is the thing the scenario must prove.
895
817
 
896
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.transitions
818
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.transitions
897
819
 
898
820
  | Field | Type | Required |
899
821
  | --- | --- | --- |
@@ -929,7 +851,7 @@ Relates a tick-stamped effect to the tick-stamped cause that must precede it —
929
851
 
930
852
  Bounds when the application's startup milestones happened: the world entered, first-use compilation settled, readiness reached — in milliseconds since navigation, from the runtime's own startup timeline. **Use when** that is the thing the scenario must prove.
931
853
 
932
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.startup
854
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.startup
933
855
 
934
856
  | Field | Type | Required |
935
857
  | --- | --- | --- |
@@ -953,7 +875,7 @@ Bounds when the application's startup milestones happened: the world entered, fi
953
875
 
954
876
  Bounds node-builder state builds and render-pipeline creations after a complete runtime capture proves that explicit shader warm-up settled; a named streamed scope must also prove its target-bound first visible world frame, and missing, incomplete, or malformed census evidence fails closed. **Use when** that is the thing the scenario must prove.
955
877
 
956
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.pipelineCensus
878
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.pipelineCensus
957
879
 
958
880
  | Field | Type | Required |
959
881
  | --- | --- | --- |
@@ -977,7 +899,7 @@ Bounds node-builder state builds and render-pipeline creations after a complete
977
899
 
978
900
  Proves the render chain reports its quality tier, authored stage ids/order, graph-output changes for named stages, and, when asserted, a bounded temporal-history rejection fraction. **Use when** that is the thing the scenario must prove.
979
901
 
980
- - **Supported on:** web, desktop, bevy · **Requires:** runtime.renderChain
902
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.renderChain
981
903
 
982
904
  | Field | Type | Required |
983
905
  | --- | --- | --- |
@@ -1014,3 +936,25 @@ Proves the render chain reports its quality tier, authored stage ids/order, grap
1014
936
  }
1015
937
  }
1016
938
  ```
939
+
940
+ ### `geometry`
941
+
942
+ Arms a per-object geometry capture (triangles, draws, projected size) and requires the bridge to report a captured frame; the request carries no bounds of its own. **Use when** that is the thing the scenario must prove.
943
+
944
+ - **Supported on:** browser, android, desktop, ios · **Requires:** runtime.geometry
945
+
946
+ | Field | Type | Required |
947
+ | --- | --- | --- |
948
+ | `limit` | number | no |
949
+ | `sort` | string | no |
950
+ | `timeoutMs` | positive number | no |
951
+
952
+
953
+ ```json
954
+ {
955
+ "geometry": {
956
+ "limit": 20,
957
+ "sort": "triangles"
958
+ }
959
+ }
960
+ ```