create-threenative 0.2.2 → 0.2.4

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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,819 @@
1
+ <!-- Generated by scripts/generate-assertion-reference.ts from PLAYTEST_ASSERTION_REGISTRY — do not hand-edit. -->
2
+ <!-- Regenerate: pnpm --filter @threenative/playtest build && pnpm tsx scripts/generate-assertion-reference.ts -->
3
+
4
+ # Assertion reference
5
+
6
+ Every assertion kind the playtest validator accepts, generated from the registry the
7
+ validator itself reads, so this page cannot disagree with the runtime. Assertions fail
8
+ closed: a malformed assertion throws at load, and a scenario whose assertions all hold
9
+ trivially fails `TN_PLAYTEST_SCENARIO_ASSERTS_NOTHING`.
10
+
11
+ ### `deviceMetrics`
12
+
13
+ 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.
14
+
15
+ - **Supported on:** web, desktop, bevy · **Requires:** device.metrics
16
+
17
+ | Field | Type | Required |
18
+ | --- | --- | --- |
19
+ | `maxTemperatureRiseC` | finite non-negative number | no |
20
+ | `maxThermalStatus` | non-negative integer 0..6 | no |
21
+ | `notThermallyConfounded` | true | no |
22
+
23
+
24
+ ```json
25
+ {
26
+ "deviceMetrics": {
27
+ "maxTemperatureRiseC": 5,
28
+ "notThermallyConfounded": true
29
+ }
30
+ }
31
+ ```
32
+
33
+ ### `framebufferCoverage`
34
+
35
+ 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.
36
+
37
+ - **Supported on:** web, desktop, bevy · **Requires:** browser.screenshot
38
+
39
+ | Field | Type | Required |
40
+ | --- | --- | --- |
41
+ | `backdrop` | [integer 0..255, integer 0..255, integer 0..255] | yes |
42
+ | `grid` | { columns: positive integer <= 256, rows: positive integer <= 256 } | no |
43
+ | `tolerance` | integer 0..255 | yes |
44
+ | `window` | { startStep: string, endStep: string } | yes |
45
+
46
+
47
+ ```json
48
+ {
49
+ "framebufferCoverage": {
50
+ "backdrop": [
51
+ 5,
52
+ 7,
53
+ 11
54
+ ],
55
+ "grid": {
56
+ "columns": 32,
57
+ "rows": 18
58
+ },
59
+ "tolerance": 8,
60
+ "window": {
61
+ "endStep": "loading-end",
62
+ "startStep": "loading-start"
63
+ }
64
+ }
65
+ }
66
+ ```
67
+
68
+ ### `reachability`
69
+
70
+ 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.
71
+
72
+ - **Supported on:** web, desktop, bevy · **Requires:** entity.observe
73
+
74
+ | Field | Type | Required |
75
+ | --- | --- | --- |
76
+ | `artifact` | string | yes |
77
+ | `entities` | string[] (minimum 2) | yes |
78
+
79
+
80
+ ```json
81
+ {
82
+ "reachability": {
83
+ "artifact": "artifacts/character-envelope/player.json",
84
+ "entities": [
85
+ "platform.a",
86
+ "platform.b"
87
+ ]
88
+ }
89
+ }
90
+ ```
91
+
92
+ ### `aerodynamics`
93
+
94
+ Proves aerodynamic force telemetry and signed control-surface delivery for a flight entity. **Use when** that is the thing the scenario must prove.
95
+
96
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.fixedStep, runtime.physics
97
+
98
+ | Field | Type | Required |
99
+ | --- | --- | --- |
100
+ | `entity` | string | yes |
101
+ | `minForceSamples` | positive integer | no |
102
+ | `controls` | Array<{ surface: string, sign: 'negative' | 'positive', minAbs?: number }> | no |
103
+ | `torques` | Array<{ label: string, relativeToLabel?: string, axis: 'x' | 'y' | 'z', sign: 'negative' | 'positive', minAbs?: number }> | no |
104
+
105
+
106
+ ```json
107
+ {
108
+ "aerodynamics": [
109
+ {
110
+ "controls": [
111
+ {
112
+ "sign": "negative",
113
+ "surface": "elevator"
114
+ }
115
+ ],
116
+ "entity": "aircraft",
117
+ "minForceSamples": 4
118
+ }
119
+ ]
120
+ }
121
+ ```
122
+
123
+ ### `visual`
124
+
125
+ 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.
126
+
127
+ - **Supported on:** web · **Requires:** browser.screenshot
128
+
129
+ | Field | Type | Required |
130
+ | --- | --- | --- |
131
+ | `frameDiff` | { baselineImage?: project-relative PNG, minChangedPixelRatio?: number, maxChangedPixelRatio?: number } | no |
132
+ | `region` | static bounds { x: number, y: number, width: number, height: number, minNonblankPixelRatio?: number, maxDarkPixelRatio?: number, minDarkPixelRatio?: number, maxLuminance?: number } or element bounds { element: { id?: string, selector?: string }, minNonblankPixelRatio?: number, maxDarkPixelRatio?: number, minDarkPixelRatio?: number, maxLuminance?: number } | no |
133
+ | `entityVisible` | { entity: string, minProjectedPixels: number, throughoutFrames?: boolean } | no |
134
+
135
+
136
+ ```json
137
+ {
138
+ "visual": [
139
+ {
140
+ "frameDiff": {
141
+ "baselineImage": "artifacts/baseline.png",
142
+ "minChangedPixelRatio": 0.01
143
+ },
144
+ "entityVisible": {
145
+ "entity": "board.e4",
146
+ "minProjectedPixels": 20,
147
+ "throughoutFrames": true
148
+ },
149
+ "region": {
150
+ "element": {
151
+ "id": "error"
152
+ },
153
+ "minNonblankPixelRatio": 0.002
154
+ }
155
+ }
156
+ ]
157
+ }
158
+ ```
159
+
160
+ ### `movement`
161
+
162
+ Proves the subject moved, reached a minimum velocity, or changed rotation during held input. **Use when** that is the thing the scenario must prove.
163
+
164
+ - **Supported on:** web, desktop, bevy · **Requires:** entity.observe
165
+
166
+ | Field | Type | Required |
167
+ | --- | --- | --- |
168
+ | `entity` | string | no |
169
+ | `closesDistanceToPosition` | { position: [number, number, number], min: number } | no |
170
+ | `facesMovementWithinDegrees` | number | no |
171
+ | `axis` | string | no |
172
+ | `minAxisDelta` | { axis: string, min: number } | no |
173
+ | `minResolvedAxisDelta` | { axis: string, min: number } | no |
174
+ | `maxTiltDegrees` | number in [0, 180] | no |
175
+ | `minDistance` | number | no |
176
+ | `maxDistance` | number | no |
177
+ | `minVelocity` | number | no |
178
+ | `pathLength` | number | no |
179
+ | `notFacing` | { entity: string, minDegrees: number } | no |
180
+ | `notFacingPosition` | { position: [number, number, number], minDegrees: number } | no |
181
+ | `reachesPositionWithin` | { position: [number, number, number], maxDistance: number, atStep?: string } | no |
182
+ | `rotationChanged` | boolean | no |
183
+
184
+
185
+ ```json
186
+ {
187
+ "movement": {
188
+ "entity": "player",
189
+ "minDistance": 0.5,
190
+ "minVelocity": 0.01,
191
+ "rotationChanged": true
192
+ }
193
+ }
194
+ ```
195
+
196
+ ### `camera`
197
+
198
+ Proves a camera follows an entity or keeps a target in view. **Use when** that is the thing the scenario must prove.
199
+
200
+ - **Supported on:** web, desktop, bevy · **Requires:** camera.observe, entity.observe
201
+
202
+ | Field | Type | Required |
203
+ | --- | --- | --- |
204
+ | `entity` | string | no |
205
+ | `follows` | string | no |
206
+ | `within` | number | no |
207
+ | `targetInViewport` | boolean | no |
208
+
209
+
210
+ ```json
211
+ {
212
+ "camera": {
213
+ "entity": "camera.main",
214
+ "follows": "player",
215
+ "within": 10,
216
+ "targetInViewport": true
217
+ }
218
+ }
219
+ ```
220
+
221
+ ### `components`
222
+
223
+ Proves a live entity component value after the scenario or at named steps. **Use when** that is the thing the scenario must prove.
224
+
225
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.components
226
+
227
+ | Field | Type | Required |
228
+ | --- | --- | --- |
229
+ | `entity` | string | yes |
230
+ | `component` | string | yes |
231
+ | `path` | string | no |
232
+ | `equals` | json | no |
233
+ | `gte` | number | no |
234
+ | `lte` | number | no |
235
+ | `changed` | boolean | no |
236
+ | `atSteps` | Array<{ label: string, equals: json }> | no |
237
+ | `allowTrivial` | triviality reason | no |
238
+
239
+
240
+ ```json
241
+ {
242
+ "components": [
243
+ {
244
+ "component": "Camera",
245
+ "entity": "camera.main",
246
+ "path": "fovY",
247
+ "equals": 22,
248
+ "changed": true
249
+ }
250
+ ]
251
+ }
252
+ ```
253
+
254
+ ### `resources`
255
+
256
+ Proves resource state after the scenario through equals, gte, lte, textIncludes, or changed checks. **Use when** that is the thing the scenario must prove.
257
+
258
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.resources
259
+
260
+ | Field | Type | Required |
261
+ | --- | --- | --- |
262
+ | `id` | string | yes |
263
+ | `path` | string | no |
264
+ | `equals` | json | no |
265
+ | `gte` | number | no |
266
+ | `lte` | number | no |
267
+ | `textIncludes` | string | no |
268
+ | `changed` | boolean | no |
269
+ | `throughoutSteps` | boolean | no |
270
+ | `atSteps` | Array<{ label: string, equals?: json, textIncludes?: string }> | no |
271
+ | `allowTrivial` | triviality reason | no |
272
+ | `anyOf` | Array<{ path: string, equals?: json, gte?: number, lte?: number, textIncludes?: string, changed?: boolean }> | no |
273
+
274
+
275
+ ```json
276
+ {
277
+ "resources": [
278
+ {
279
+ "id": "GameState",
280
+ "path": "score",
281
+ "gte": 1,
282
+ "changed": true
283
+ }
284
+ ]
285
+ }
286
+ ```
287
+
288
+ ### `tags`
289
+
290
+ Proves the final count of entities carrying a bounded runtime tag. **Use when** that is the thing the scenario must prove.
291
+
292
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.tags
293
+
294
+ | Field | Type | Required |
295
+ | --- | --- | --- |
296
+ | `tag` | string | yes |
297
+ | `count` | non-negative integer | no |
298
+ | `gte` | non-negative integer | no |
299
+ | `lte` | non-negative integer | no |
300
+ | `allowTrivial` | triviality reason | no |
301
+
302
+
303
+ ```json
304
+ {
305
+ "tags": [
306
+ {
307
+ "tag": "coin",
308
+ "count": 10
309
+ }
310
+ ]
311
+ }
312
+ ```
313
+
314
+ ### `signals`
315
+
316
+ 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.
317
+
318
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.events
319
+
320
+ | Field | Type | Required |
321
+ | --- | --- | --- |
322
+ | `atStep` | string | no |
323
+ | `entity` | string | no |
324
+ | `maxCount` | non-negative integer | no |
325
+ | `minCount` | non-negative integer | no |
326
+ | `name` | string | yes |
327
+
328
+
329
+ ```json
330
+ {
331
+ "signals": [
332
+ {
333
+ "name": "collected",
334
+ "entity": "player",
335
+ "minCount": 3,
336
+ "atStep": "last-coin"
337
+ }
338
+ ]
339
+ }
340
+ ```
341
+
342
+ ### `states`
343
+
344
+ Proves an observed entity's final runtime-owned state-machine state. **Use when** that is the thing the scenario must prove.
345
+
346
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.state
347
+
348
+ | Field | Type | Required |
349
+ | --- | --- | --- |
350
+ | `entity` | string | no |
351
+ | `equals` | string | yes |
352
+ | `allowTrivial` | triviality reason | no |
353
+
354
+
355
+ ```json
356
+ {
357
+ "states": [
358
+ {
359
+ "equals": "completed"
360
+ }
361
+ ]
362
+ }
363
+ ```
364
+
365
+ ### `hud`
366
+
367
+ Proves retained UI/HUD text or values after the scenario. **Use when** that is the thing the scenario must prove.
368
+
369
+ - **Supported on:** web · **Requires:** browser.dom
370
+
371
+ | Field | Type | Required |
372
+ | --- | --- | --- |
373
+ | `id` | string | yes |
374
+ | `path` | string | no |
375
+ | `equals` | json | no |
376
+ | `gte` | number | no |
377
+ | `lte` | number | no |
378
+ | `textIncludes` | string | no |
379
+ | `changed` | boolean | no |
380
+ | `allowTrivial` | triviality reason | no |
381
+ | `visible` | boolean | no |
382
+
383
+
384
+ ```json
385
+ {
386
+ "hud": [
387
+ {
388
+ "id": "score-label",
389
+ "textIncludes": "Score"
390
+ }
391
+ ]
392
+ }
393
+ ```
394
+
395
+ ### `overlayNodes`
396
+
397
+ Proves DOM state inside a same-origin webview overlay iframe. **Use when** that is the thing the scenario must prove.
398
+
399
+ - **Supported on:** web · **Requires:** browser.dom
400
+
401
+ | Field | Type | Required |
402
+ | --- | --- | --- |
403
+ | `overlayId` | string | yes |
404
+ | `selector` | string | yes |
405
+ | `attribute` | string | no |
406
+ | `equals` | json | no |
407
+ | `textIncludes` | string | no |
408
+ | `visible` | boolean | no |
409
+
410
+
411
+ ```json
412
+ {
413
+ "overlayNodes": [
414
+ {
415
+ "attribute": "data-aiming",
416
+ "equals": "true",
417
+ "overlayId": "game-ui",
418
+ "selector": "[data-testid=fps-crosshair]",
419
+ "visible": false
420
+ }
421
+ ]
422
+ }
423
+ ```
424
+
425
+ ### `diagnostics`
426
+
427
+ Proves console, network, runtime, and readiness diagnostics stayed clean. **Use when** that is the thing the scenario must prove.
428
+
429
+ - **Supported on:** web · **Requires:** browser.console, browser.network, runtime.diagnostics
430
+
431
+ | Field | Type | Required |
432
+ | --- | --- | --- |
433
+ | `noConsoleErrors` | boolean | no |
434
+ | `noNetworkErrors` | boolean | no |
435
+ | `noRuntimeDiagnostics` | boolean | no |
436
+ | `consoleErrorsOptOutReason` | non-empty string | no |
437
+ | `networkErrorsOptOutReason` | non-empty string | no |
438
+ | `runtimeDiagnosticsOptOutReason` | non-empty string | no |
439
+ | `runtimeReady` | boolean | no |
440
+
441
+
442
+ ```json
443
+ {
444
+ "diagnostics": {
445
+ "noConsoleErrors": true,
446
+ "noNetworkErrors": true,
447
+ "noRuntimeDiagnostics": true,
448
+ "runtimeReady": true
449
+ }
450
+ }
451
+ ```
452
+
453
+ ### `performance`
454
+
455
+ Proves a live render sample exists and optionally bounds frame time, an fps floor, per-phase frame budget, draw calls, and triangles. **Use when** that is the thing the scenario must prove.
456
+
457
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.performance
458
+
459
+ | Field | Type | Required |
460
+ | --- | --- | --- |
461
+ | `maxFrameMsP95` | number | no |
462
+ | `minFps` | number | no |
463
+ | `maxPhaseMsP95` | { [phase]: number } | no |
464
+ | `maxDrawCalls` | number | no |
465
+ | `maxTriangles` | number | no |
466
+
467
+
468
+ ```json
469
+ {
470
+ "performance": {
471
+ "maxPhaseMsP95": {
472
+ "render": 12
473
+ },
474
+ "minFps": 30
475
+ }
476
+ }
477
+ ```
478
+
479
+ ### `parity`
480
+
481
+ 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.
482
+
483
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.performance
484
+
485
+ | Field | Type | Required |
486
+ | --- | --- | --- |
487
+ | `minFpsRatio` | positive number | no |
488
+ | `minRenderParity` | positive number | no |
489
+ | `referenceReport` | non-empty string | no |
490
+ | `referenceSide` | 'browser' or 'native' | no |
491
+ | `reference` | object | no |
492
+
493
+
494
+ ```json
495
+ {
496
+ "parity": {
497
+ "minFpsRatio": 0.85,
498
+ "referenceReport": "reports/native.json",
499
+ "referenceSide": "native"
500
+ }
501
+ }
502
+ ```
503
+
504
+ ### `visibility`
505
+
506
+ Proves projected entity visibility in the viewport. **Use when** that is the thing the scenario must prove.
507
+
508
+ - **Supported on:** web · **Requires:** entity.bounds
509
+
510
+ | Field | Type | Required |
511
+ | --- | --- | --- |
512
+ | `entity` | string | no |
513
+ | `minProjectedPixels` | number | no |
514
+ | `maxOffscreenRatio` | number | no |
515
+ | `present` | boolean | no |
516
+ | `allowTrivial` | triviality reason | no |
517
+
518
+
519
+ ```json
520
+ {
521
+ "visibility": [
522
+ {
523
+ "entity": "player",
524
+ "minProjectedPixels": 1200,
525
+ "maxOffscreenRatio": 0.05
526
+ }
527
+ ]
528
+ }
529
+ ```
530
+
531
+ ### `world`
532
+
533
+ Proves runtime world metadata exposed by the application bridge. **Use when** that is the thing the scenario must prove.
534
+
535
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.world
536
+
537
+ | Field | Type | Required |
538
+ | --- | --- | --- |
539
+ | `seed` | json | yes |
540
+ | `runtime` | object | no |
541
+
542
+
543
+ ```json
544
+ {
545
+ "world": {
546
+ "seed": 90210
547
+ }
548
+ }
549
+ ```
550
+
551
+ ### `contacts`
552
+
553
+ Proves contact or trigger evidence appeared in the effect log. **Use when** that is the thing the scenario must prove.
554
+
555
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.contacts
556
+
557
+ | Field | Type | Required |
558
+ | --- | --- | --- |
559
+ | `atStep` | string | no |
560
+ | `entity` | string | no |
561
+ | `with` | string | no |
562
+ | `kind` | string | no |
563
+ | `minCount` | number | no |
564
+ | `maxCount` | non-negative integer | no |
565
+ | `requiredOn` | Array<'web' | 'desktop' | 'bevy'> | no |
566
+
567
+
568
+ ```json
569
+ {
570
+ "contacts": [
571
+ {
572
+ "entity": "player",
573
+ "with": "pickup",
574
+ "kind": "trigger",
575
+ "minCount": 1
576
+ }
577
+ ]
578
+ }
579
+ ```
580
+
581
+ ### `settled`
582
+
583
+ 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.
584
+
585
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.physics
586
+
587
+ | Field | Type | Required |
588
+ | --- | --- | --- |
589
+ | `entity` | string | no |
590
+ | `atStep` | string | no |
591
+ | `minBodies` | positive integer | no |
592
+ | `compareToStep` | string | no |
593
+ | `minMeanPoseDistance` | positive number | no |
594
+ | `requiredOn` | Array<'web' | 'desktop' | 'bevy'> | no |
595
+ | `allowTrivial` | triviality reason | no |
596
+
597
+
598
+ ```json
599
+ {
600
+ "settled": [
601
+ {
602
+ "atStep": "fall-and-settle",
603
+ "minBodies": 15
604
+ }
605
+ ]
606
+ }
607
+ ```
608
+
609
+ ### `occluded`
610
+
611
+ Proves rendered scene geometry occludes the segment between an origin entity and target. **Use when** that is the thing the scenario must prove.
612
+
613
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.physics
614
+
615
+ | Field | Type | Required |
616
+ | --- | --- | --- |
617
+ | `entity` | string | no |
618
+ | `target` | string | no |
619
+ | `allowTrivial` | triviality reason | no |
620
+
621
+
622
+ ```json
623
+ {
624
+ "occluded": [
625
+ {
626
+ "entity": "listener",
627
+ "target": "emitter"
628
+ }
629
+ ]
630
+ }
631
+ ```
632
+
633
+ ### `animation`
634
+
635
+ Proves animation evidence appeared in the effect log or runtime observation. **Use when** that is the thing the scenario must prove.
636
+
637
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.animation
638
+
639
+ | Field | Type | Required |
640
+ | --- | --- | --- |
641
+ | `entity` | string | no |
642
+ | `clip` | string | no |
643
+ | `entered` | boolean | no |
644
+ | `advancedFrames` | number | no |
645
+ | `finished` | boolean | no |
646
+ | `maxFootSlide` | number | no |
647
+ | `strideSynced` | boolean | no |
648
+ | `allowTrivial` | triviality reason | no |
649
+
650
+
651
+ ```json
652
+ {
653
+ "animation": [
654
+ {
655
+ "entity": "player",
656
+ "clip": "run",
657
+ "entered": true,
658
+ "advancedFrames": 5,
659
+ "finished": false
660
+ }
661
+ ]
662
+ }
663
+ ```
664
+
665
+ ### `scene`
666
+
667
+ 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.
668
+
669
+ - **Supported on:** web, desktop, bevy · **Requires:** scene.observe
670
+
671
+ | Field | Type | Required |
672
+ | --- | --- | --- |
673
+ | `cameraClearsScene` | boolean | no |
674
+ | `fogClearsScene` | boolean | no |
675
+ | `litMaterialsAreLit` | boolean | no |
676
+ | `minVisibleLights` | number | no |
677
+ | `allowTrivial` | triviality reason | no |
678
+
679
+
680
+ ```json
681
+ {
682
+ "scene": {
683
+ "litMaterialsAreLit": true,
684
+ "minVisibleLights": 1
685
+ }
686
+ }
687
+ ```
688
+
689
+ ### `sceneNodes`
690
+
691
+ 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.
692
+
693
+ - **Supported on:** web, desktop, bevy · **Requires:** scene.nodes
694
+
695
+ | Field | Type | Required |
696
+ | --- | --- | --- |
697
+ | `select` | object | no |
698
+ | `visible` | boolean | no |
699
+ | `inFrustum` | boolean | no |
700
+ | `texturesLoaded` | boolean | no |
701
+ | `animated` | boolean | no |
702
+ | `minCount` | number | no |
703
+ | `maxCount` | number | no |
704
+ | `minTriangles` | number | no |
705
+
706
+
707
+ ```json
708
+ {
709
+ "sceneNodes": [
710
+ {
711
+ "inFrustum": true,
712
+ "select": {
713
+ "nameContains": "crate"
714
+ },
715
+ "texturesLoaded": true,
716
+ "visible": true
717
+ }
718
+ ]
719
+ }
720
+ ```
721
+
722
+ ### `causedBy`
723
+
724
+ 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.
725
+
726
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.transitions
727
+
728
+ | Field | Type | Required |
729
+ | --- | --- | --- |
730
+ | `cause` | object | no |
731
+ | `effect` | object | no |
732
+ | `neverBefore` | boolean | no |
733
+ | `withinTicks` | number | no |
734
+
735
+
736
+ ```json
737
+ {
738
+ "causedBy": [
739
+ {
740
+ "cause": {
741
+ "contact": {
742
+ "entity": "player",
743
+ "kind": "trigger",
744
+ "with": "seal"
745
+ }
746
+ },
747
+ "effect": {
748
+ "becomes": "won",
749
+ "path": "state.status"
750
+ },
751
+ "neverBefore": true,
752
+ "withinTicks": 4
753
+ }
754
+ ]
755
+ }
756
+ ```
757
+
758
+ ### `startup`
759
+
760
+ 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.
761
+
762
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.startup
763
+
764
+ | Field | Type | Required |
765
+ | --- | --- | --- |
766
+ | `maxEnteredMs` | number | no |
767
+ | `maxCompileSettledMs` | number | no |
768
+ | `maxReadyMs` | number | no |
769
+
770
+
771
+ ```json
772
+ {
773
+ "startup": {
774
+ "maxEnteredMs": 2500,
775
+ "maxReadyMs": 8000
776
+ }
777
+ }
778
+ ```
779
+
780
+ ### `renderChain`
781
+
782
+ 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.
783
+
784
+ - **Supported on:** web, desktop, bevy · **Requires:** runtime.renderChain
785
+
786
+ | Field | Type | Required |
787
+ | --- | --- | --- |
788
+ | `tier` | string | no |
789
+ | `stages` | object | no |
790
+ | `contributions` | object | no |
791
+ | `velocity` | object | no |
792
+
793
+
794
+ ```json
795
+ {
796
+ "renderChain": {
797
+ "tier": "high",
798
+ "stages": {
799
+ "includes": [
800
+ "outline",
801
+ "kuwahara",
802
+ "watercolor"
803
+ ],
804
+ "order": [
805
+ "outline",
806
+ "kuwahara",
807
+ "watercolor"
808
+ ]
809
+ },
810
+ "contributions": {
811
+ "graphOutputChanged": [
812
+ "outline",
813
+ "kuwahara",
814
+ "watercolor"
815
+ ]
816
+ }
817
+ }
818
+ }
819
+ ```