create-threenative 0.2.3 → 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 (447) hide show
  1. package/README.md +53 -2
  2. package/agent-docs/references/assertion-reference.md +173 -6
  3. package/agent-docs/references/capability-reference.md +1303 -99
  4. package/agent-docs/references/capture-the-frame.md +7 -0
  5. package/agent-docs/references/creating-creatures.md +215 -0
  6. package/agent-docs/references/ctx-cookbook.md +69 -0
  7. package/agent-docs/references/debug-surface.md +8 -3
  8. package/agent-docs/references/dream-loop.md +150 -0
  9. package/agent-docs/references/finding-assets.md +70 -2
  10. package/agent-docs/references/sculpt-from-a-reference.md +3 -2
  11. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  12. package/agent-docs/references/visual-baseline.md +41 -0
  13. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  14. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  15. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  16. package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
  17. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  18. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  19. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  20. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  21. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  22. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
  23. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  24. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  25. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  26. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  27. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  28. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  29. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  30. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  31. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  32. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  33. package/agent-files/scripts/reference.mjs +705 -0
  34. package/agent-files/scripts/visual-loop.mjs +382 -0
  35. package/capabilities.json +1881 -131
  36. package/dist/index.d.ts +39 -6
  37. package/dist/index.js +297 -32
  38. package/dist/threenative.js +822 -105
  39. package/package.json +30 -5
  40. package/template-assets/loading.ts +12 -2
  41. package/template-assets/patches/three@0.185.1.patch +249 -14
  42. package/template-assets/worldEnvironment.ts +758 -0
  43. package/templates/action-rpg/.codex/config.toml +4 -0
  44. package/templates/action-rpg/.cursor/mcp.json +32 -0
  45. package/templates/action-rpg/.gemini/settings.json +32 -0
  46. package/templates/action-rpg/.mcp.json +15 -3
  47. package/templates/action-rpg/.vscode/mcp.json +36 -0
  48. package/templates/action-rpg/.zed/settings.json +36 -0
  49. package/templates/action-rpg/AGENTS.md +69 -378
  50. package/templates/action-rpg/CLAUDE.md +69 -378
  51. package/templates/action-rpg/opencode.json +41 -0
  52. package/templates/action-rpg/package.json +7 -7
  53. package/templates/action-rpg/playtests/combat.playtest.json +9 -0
  54. package/templates/action-rpg/playtests/performance.playtest.json +24 -7
  55. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  56. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  57. package/templates/action-rpg/src/conventions.ts +35 -0
  58. package/templates/action-rpg/src/entities/Enemy.ts +2 -3
  59. package/templates/action-rpg/src/entities/Player.ts +20 -3
  60. package/templates/action-rpg/src/render/camera.ts +7 -2
  61. package/templates/action-rpg/src/render/lighting.ts +5 -3
  62. package/templates/action-rpg/src/render/loading.ts +12 -2
  63. package/templates/action-rpg/src/render/materials.ts +11 -0
  64. package/templates/action-rpg/src/render/palette.ts +10 -3
  65. package/templates/action-rpg/src/render/postprocessing.ts +21 -58
  66. package/templates/action-rpg/src/render/quality.ts +170 -0
  67. package/templates/action-rpg/src/render/shapes.ts +185 -26
  68. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  69. package/templates/action-rpg/src/render/vfx.ts +257 -0
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
  71. package/templates/action-rpg/src/scenes/Play.ts +43 -6
  72. package/templates/action-rpg/src/style.css +20 -0
  73. package/templates/action-rpg/threenative.config.ts +7 -0
  74. package/templates/defense/.codex/config.toml +4 -0
  75. package/templates/defense/.cursor/mcp.json +32 -0
  76. package/templates/defense/.gemini/settings.json +32 -0
  77. package/templates/defense/.mcp.json +15 -3
  78. package/templates/defense/.vscode/mcp.json +36 -0
  79. package/templates/defense/.zed/settings.json +36 -0
  80. package/templates/defense/AGENTS.md +62 -385
  81. package/templates/defense/CLAUDE.md +62 -385
  82. package/templates/defense/opencode.json +41 -0
  83. package/templates/defense/package.json +7 -7
  84. package/templates/defense/playtests/performance.playtest.json +24 -7
  85. package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
  86. package/templates/defense/playtests/scan.playtest.json +1 -1
  87. package/templates/defense/playtests/survive.playtest.json +14 -0
  88. package/templates/defense/src/attackers/Attacker.ts +4 -4
  89. package/templates/defense/src/board/Route.ts +22 -8
  90. package/templates/defense/src/conventions.ts +18 -0
  91. package/templates/defense/src/entities/Player.ts +11 -3
  92. package/templates/defense/src/game.ts +2 -3
  93. package/templates/defense/src/physics.ts +9 -39
  94. package/templates/defense/src/placement/Buildable.ts +4 -4
  95. package/templates/defense/src/render/camera.ts +9 -3
  96. package/templates/defense/src/render/loading.ts +12 -2
  97. package/templates/defense/src/render/materials.ts +9 -0
  98. package/templates/defense/src/render/palette.ts +12 -5
  99. package/templates/defense/src/render/postprocessing.ts +21 -58
  100. package/templates/defense/src/render/quality.ts +170 -0
  101. package/templates/defense/src/render/shapes.ts +142 -23
  102. package/templates/defense/src/render/sky.ts +2 -2
  103. package/templates/defense/src/render/worldEnvironment.ts +208 -33
  104. package/templates/defense/src/scenes/Boot.ts +2 -2
  105. package/templates/defense/src/scenes/Defense.ts +13 -6
  106. package/templates/defense/src/style.css +20 -0
  107. package/templates/defense/src/towers/Tower.ts +11 -12
  108. package/templates/defense/src/towers/targeting.ts +1 -1
  109. package/templates/defense/src/ui/App.tsx +2 -2
  110. package/templates/defense/threenative.config.ts +7 -0
  111. package/templates/minimal/.codex/config.toml +4 -0
  112. package/templates/minimal/.cursor/mcp.json +32 -0
  113. package/templates/minimal/.gemini/settings.json +32 -0
  114. package/templates/minimal/.mcp.json +15 -3
  115. package/templates/minimal/.vscode/mcp.json +36 -0
  116. package/templates/minimal/.zed/settings.json +36 -0
  117. package/templates/minimal/AGENTS.md +76 -485
  118. package/templates/minimal/CLAUDE.md +76 -485
  119. package/templates/minimal/opencode.json +41 -0
  120. package/templates/minimal/package.json +6 -6
  121. package/templates/minimal/playtests/play.playtest.json +2 -1
  122. package/templates/minimal/playtests/survives.playtest.json +48 -4
  123. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  124. package/templates/minimal/src/conventions.ts +18 -0
  125. package/templates/minimal/src/entities/Player.ts +39 -6
  126. package/templates/minimal/src/main.ts +14 -4
  127. package/templates/minimal/src/render/materials.ts +7 -0
  128. package/templates/minimal/src/render/palette.ts +3 -3
  129. package/templates/minimal/src/render/postprocessing.ts +17 -56
  130. package/templates/minimal/src/render/quality.ts +162 -0
  131. package/templates/minimal/src/render/sky.ts +23 -9
  132. package/templates/minimal/src/render/touch-controls.ts +165 -0
  133. package/templates/minimal/src/render/worldEnvironment.ts +208 -33
  134. package/templates/minimal/src/scenes/Play.ts +47 -11
  135. package/templates/minimal/src/style.css +20 -0
  136. package/templates/minimal/threenative.config.ts +7 -0
  137. package/templates/platformer/.codex/config.toml +4 -0
  138. package/templates/platformer/.cursor/mcp.json +32 -0
  139. package/templates/platformer/.gemini/settings.json +32 -0
  140. package/templates/platformer/.mcp.json +15 -3
  141. package/templates/platformer/.vscode/mcp.json +36 -0
  142. package/templates/platformer/.zed/settings.json +36 -0
  143. package/templates/platformer/AGENTS.md +70 -430
  144. package/templates/platformer/CLAUDE.md +70 -430
  145. package/templates/platformer/opencode.json +41 -0
  146. package/templates/platformer/package.json +7 -7
  147. package/templates/platformer/playtests/oneway.playtest.json +29 -2
  148. package/templates/platformer/playtests/performance.playtest.json +2 -1
  149. package/templates/platformer/playtests/survives.playtest.json +31 -0
  150. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
  151. package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
  152. package/templates/platformer/src/conventions.ts +18 -0
  153. package/templates/platformer/src/entities/Character.ts +63 -1
  154. package/templates/platformer/src/game.ts +3 -1
  155. package/templates/platformer/src/level/Platform.ts +13 -1
  156. package/templates/platformer/src/render/lighting.ts +7 -4
  157. package/templates/platformer/src/render/loading.ts +12 -2
  158. package/templates/platformer/src/render/palette.ts +4 -1
  159. package/templates/platformer/src/render/postprocessing.ts +32 -57
  160. package/templates/platformer/src/render/quality.ts +170 -0
  161. package/templates/platformer/src/render/worldEnvironment.ts +208 -33
  162. package/templates/platformer/src/scenes/Level.ts +52 -12
  163. package/templates/platformer/src/style.css +20 -0
  164. package/templates/platformer/threenative.config.ts +7 -0
  165. package/templates/puzzle/.codex/config.toml +19 -0
  166. package/templates/puzzle/.cursor/mcp.json +32 -0
  167. package/templates/puzzle/.gemini/settings.json +32 -0
  168. package/templates/puzzle/.mcp.json +32 -0
  169. package/templates/puzzle/.vscode/mcp.json +36 -0
  170. package/templates/puzzle/.zed/settings.json +36 -0
  171. package/templates/puzzle/AGENTS.md +96 -0
  172. package/templates/puzzle/CLAUDE.md +98 -0
  173. package/templates/puzzle/README.md +43 -0
  174. package/templates/puzzle/index.html +12 -0
  175. package/templates/puzzle/kit.json +7 -0
  176. package/templates/puzzle/opencode.json +41 -0
  177. package/templates/puzzle/package.json +50 -0
  178. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  179. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  180. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  181. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  182. package/templates/puzzle/public/favicon.svg +5 -0
  183. package/templates/puzzle/src/conventions.ts +25 -0
  184. package/templates/puzzle/src/entities/Ball.ts +70 -0
  185. package/templates/puzzle/src/entities/Crate.ts +76 -0
  186. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  187. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  188. package/templates/puzzle/src/game.ts +48 -0
  189. package/templates/puzzle/src/main.ts +15 -0
  190. package/templates/puzzle/src/physics.ts +19 -0
  191. package/templates/puzzle/src/render/camera.ts +37 -0
  192. package/templates/puzzle/src/render/lighting.ts +55 -0
  193. package/templates/puzzle/src/render/loading.ts +325 -0
  194. package/templates/puzzle/src/render/materials.ts +28 -0
  195. package/templates/puzzle/src/render/palette.ts +31 -0
  196. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  197. package/templates/puzzle/src/render/quality.ts +170 -0
  198. package/templates/puzzle/src/render/shapes.ts +134 -0
  199. package/templates/puzzle/src/render/sky.ts +16 -0
  200. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  201. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  202. package/templates/puzzle/src/room.ts +83 -0
  203. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  204. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  205. package/templates/puzzle/src/state.ts +30 -0
  206. package/templates/puzzle/src/style.css +96 -0
  207. package/templates/puzzle/src/ui/App.tsx +22 -0
  208. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  209. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  210. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  211. package/templates/puzzle/src/ui/main.tsx +14 -0
  212. package/templates/puzzle/tailwind.config.ts +1 -0
  213. package/templates/puzzle/threenative.config.ts +49 -0
  214. package/templates/puzzle/tsconfig.json +17 -0
  215. package/templates/puzzle/vite.config.ts +38 -0
  216. package/templates/racing/.codex/config.toml +4 -0
  217. package/templates/racing/.cursor/mcp.json +32 -0
  218. package/templates/racing/.gemini/settings.json +32 -0
  219. package/templates/racing/.mcp.json +15 -3
  220. package/templates/racing/.vscode/mcp.json +36 -0
  221. package/templates/racing/.zed/settings.json +36 -0
  222. package/templates/racing/AGENTS.md +63 -379
  223. package/templates/racing/CLAUDE.md +63 -379
  224. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  225. package/templates/racing/opencode.json +41 -0
  226. package/templates/racing/package.json +8 -7
  227. package/templates/racing/playtests/performance.playtest.json +24 -7
  228. package/templates/racing/playtests/survives.playtest.json +36 -4
  229. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  230. package/templates/racing/src/conventions.ts +6 -0
  231. package/templates/racing/src/entities/RacingCar.ts +16 -4
  232. package/templates/racing/src/entities/Rival.ts +5 -2
  233. package/templates/racing/src/render/camera.ts +7 -4
  234. package/templates/racing/src/render/lighting.ts +22 -13
  235. package/templates/racing/src/render/loading.ts +12 -2
  236. package/templates/racing/src/render/materials.ts +54 -4
  237. package/templates/racing/src/render/palette.ts +23 -6
  238. package/templates/racing/src/render/postprocessing.ts +21 -58
  239. package/templates/racing/src/render/quality.ts +170 -0
  240. package/templates/racing/src/render/shapes.ts +537 -26
  241. package/templates/racing/src/render/sky.ts +5 -2
  242. package/templates/racing/src/render/touch-controls.ts +185 -0
  243. package/templates/racing/src/render/worldEnvironment.ts +208 -33
  244. package/templates/racing/src/scenes/Race.ts +17 -2
  245. package/templates/racing/src/style.css +20 -0
  246. package/templates/racing/src/track/Track.ts +270 -31
  247. package/templates/racing/threenative.config.ts +7 -0
  248. package/templates/runner/.codex/config.toml +19 -0
  249. package/templates/runner/.cursor/mcp.json +32 -0
  250. package/templates/runner/.gemini/settings.json +32 -0
  251. package/templates/runner/.mcp.json +32 -0
  252. package/templates/runner/.vscode/mcp.json +36 -0
  253. package/templates/runner/.zed/settings.json +36 -0
  254. package/templates/runner/AGENTS.md +96 -0
  255. package/templates/runner/CLAUDE.md +98 -0
  256. package/templates/runner/README.md +43 -0
  257. package/templates/runner/index.html +12 -0
  258. package/templates/runner/kit.json +7 -0
  259. package/templates/runner/opencode.json +41 -0
  260. package/templates/runner/package.json +50 -0
  261. package/templates/runner/playtests/performance.playtest.json +23 -0
  262. package/templates/runner/playtests/streams.playtest.json +38 -0
  263. package/templates/runner/playtests/survives.playtest.json +51 -0
  264. package/templates/runner/public/favicon.svg +5 -0
  265. package/templates/runner/src/conventions.ts +24 -0
  266. package/templates/runner/src/entities/Runner.ts +135 -0
  267. package/templates/runner/src/game.ts +50 -0
  268. package/templates/runner/src/main.ts +15 -0
  269. package/templates/runner/src/physics.ts +13 -0
  270. package/templates/runner/src/render/camera.ts +39 -0
  271. package/templates/runner/src/render/dust.ts +131 -0
  272. package/templates/runner/src/render/lighting.ts +57 -0
  273. package/templates/runner/src/render/loading.ts +325 -0
  274. package/templates/runner/src/render/materials.ts +27 -0
  275. package/templates/runner/src/render/palette.ts +30 -0
  276. package/templates/runner/src/render/postprocessing.ts +34 -0
  277. package/templates/runner/src/render/quality.ts +170 -0
  278. package/templates/runner/src/render/shapes.ts +68 -0
  279. package/templates/runner/src/render/sky.ts +51 -0
  280. package/templates/runner/src/render/touch-controls.ts +185 -0
  281. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  282. package/templates/runner/src/scenes/Boot.ts +12 -0
  283. package/templates/runner/src/scenes/Run.ts +142 -0
  284. package/templates/runner/src/state.ts +29 -0
  285. package/templates/runner/src/style.css +96 -0
  286. package/templates/runner/src/track.ts +176 -0
  287. package/templates/runner/src/ui/App.tsx +22 -0
  288. package/templates/runner/src/ui/GameUi.tsx +20 -0
  289. package/templates/runner/src/ui/Hud.tsx +55 -0
  290. package/templates/runner/src/ui/Menu.tsx +7 -0
  291. package/templates/runner/src/ui/main.tsx +14 -0
  292. package/templates/runner/tailwind.config.ts +1 -0
  293. package/templates/runner/threenative.config.ts +49 -0
  294. package/templates/runner/tsconfig.json +17 -0
  295. package/templates/runner/vite.config.ts +38 -0
  296. package/templates/sailing/.codex/config.toml +4 -0
  297. package/templates/sailing/.cursor/mcp.json +32 -0
  298. package/templates/sailing/.gemini/settings.json +32 -0
  299. package/templates/sailing/.mcp.json +15 -3
  300. package/templates/sailing/.vscode/mcp.json +36 -0
  301. package/templates/sailing/.zed/settings.json +36 -0
  302. package/templates/sailing/AGENTS.md +62 -355
  303. package/templates/sailing/CLAUDE.md +62 -355
  304. package/templates/sailing/README.md +12 -9
  305. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  306. package/templates/sailing/native-playtests/survives.playtest.json +20 -3
  307. package/templates/sailing/opencode.json +41 -0
  308. package/templates/sailing/package.json +8 -8
  309. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  310. package/templates/sailing/playtests/float.playtest.json +59 -0
  311. package/templates/sailing/playtests/performance.playtest.json +21 -6
  312. package/templates/sailing/playtests/survives.playtest.json +8 -0
  313. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  314. package/templates/sailing/src/conventions.ts +8 -0
  315. package/templates/sailing/src/entities/Ship.ts +150 -13
  316. package/templates/sailing/src/render/camera.ts +15 -8
  317. package/templates/sailing/src/render/lighting.ts +10 -5
  318. package/templates/sailing/src/render/loading.ts +12 -2
  319. package/templates/sailing/src/render/materials.ts +24 -8
  320. package/templates/sailing/src/render/ocean.ts +179 -0
  321. package/templates/sailing/src/render/palette.ts +14 -21
  322. package/templates/sailing/src/render/postprocessing.ts +23 -22
  323. package/templates/sailing/src/render/props.ts +584 -34
  324. package/templates/sailing/src/render/quality.ts +140 -0
  325. package/templates/sailing/src/render/sky.ts +8 -3
  326. package/templates/sailing/src/render/touch-controls.ts +142 -0
  327. package/templates/sailing/src/render/worldEnvironment.ts +206 -38
  328. package/templates/sailing/src/scenes/Sailing.ts +43 -16
  329. package/templates/sailing/src/style.css +20 -0
  330. package/templates/sailing/threenative.config.ts +7 -1
  331. package/templates/shooter/.codex/config.toml +4 -0
  332. package/templates/shooter/.cursor/mcp.json +32 -0
  333. package/templates/shooter/.gemini/settings.json +32 -0
  334. package/templates/shooter/.mcp.json +15 -3
  335. package/templates/shooter/.vscode/mcp.json +36 -0
  336. package/templates/shooter/.zed/settings.json +36 -0
  337. package/templates/shooter/AGENTS.md +76 -415
  338. package/templates/shooter/CLAUDE.md +76 -415
  339. package/templates/shooter/kit.json +2 -2
  340. package/templates/shooter/opencode.json +41 -0
  341. package/templates/shooter/package.json +7 -7
  342. package/templates/shooter/playtests/combat.playtest.json +48 -0
  343. package/templates/shooter/playtests/input-control.playtest.json +165 -35
  344. package/templates/shooter/playtests/per-item.playtest.json +3 -3
  345. package/templates/shooter/playtests/performance.playtest.json +24 -7
  346. package/templates/shooter/playtests/shooter.playtest.json +13 -7
  347. package/templates/shooter/playtests/survives.playtest.json +27 -0
  348. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  349. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  350. package/templates/shooter/src/combat/damage.ts +1 -2
  351. package/templates/shooter/src/conventions.ts +51 -0
  352. package/templates/shooter/src/entities/Player.ts +235 -18
  353. package/templates/shooter/src/entities/Target.ts +2 -2
  354. package/templates/shooter/src/game.ts +13 -4
  355. package/templates/shooter/src/render/camera.ts +49 -39
  356. package/templates/shooter/src/render/decals.ts +211 -0
  357. package/templates/shooter/src/render/lighting.ts +7 -3
  358. package/templates/shooter/src/render/loading.ts +12 -2
  359. package/templates/shooter/src/render/materials.ts +56 -3
  360. package/templates/shooter/src/render/palette.ts +6 -3
  361. package/templates/shooter/src/render/postprocessing.ts +21 -58
  362. package/templates/shooter/src/render/quality.ts +170 -0
  363. package/templates/shooter/src/render/scale.ts +22 -0
  364. package/templates/shooter/src/render/shapes.ts +343 -62
  365. package/templates/shooter/src/render/sky.ts +5 -1
  366. package/templates/shooter/src/render/touch-controls.ts +305 -0
  367. package/templates/shooter/src/render/ui.css +85 -0
  368. package/templates/shooter/src/render/ui.ts +19 -3
  369. package/templates/shooter/src/render/vfx.ts +215 -0
  370. package/templates/shooter/src/render/worldEnvironment.ts +208 -33
  371. package/templates/shooter/src/scenes/Play.ts +171 -56
  372. package/templates/shooter/src/state.ts +5 -0
  373. package/templates/shooter/src/style.css +20 -0
  374. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  375. package/templates/shooter/src/ui/GameUi.tsx +2 -0
  376. package/templates/shooter/src/ui/Hud.tsx +7 -1
  377. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  378. package/templates/shooter/src/weapons/Projectile.ts +8 -3
  379. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  380. package/templates/shooter/threenative.config.ts +7 -0
  381. package/templates/starter/.codex/config.toml +4 -0
  382. package/templates/starter/.cursor/mcp.json +32 -0
  383. package/templates/starter/.gemini/settings.json +32 -0
  384. package/templates/starter/.mcp.json +15 -3
  385. package/templates/starter/.vscode/mcp.json +36 -0
  386. package/templates/starter/.zed/settings.json +36 -0
  387. package/templates/starter/AGENTS.md +70 -527
  388. package/templates/starter/CLAUDE.md +70 -527
  389. package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
  390. package/templates/starter/opencode.json +41 -0
  391. package/templates/starter/package.json +7 -7
  392. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  393. package/templates/starter/playtests/look.playtest.json +110 -6
  394. package/templates/starter/playtests/play.playtest.json +3 -2
  395. package/templates/starter/playtests/survives.playtest.json +21 -0
  396. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  397. package/templates/starter/src/conventions.ts +18 -0
  398. package/templates/starter/src/entities/Goal.ts +18 -3
  399. package/templates/starter/src/entities/Player.ts +72 -9
  400. package/templates/starter/src/game.ts +2 -0
  401. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  402. package/templates/starter/src/render/camera.ts +1 -1
  403. package/templates/starter/src/render/coast.ts +199 -0
  404. package/templates/starter/src/render/hero.ts +88 -0
  405. package/templates/starter/src/render/implicitSurface.ts +199 -0
  406. package/templates/starter/src/render/kuwahara.ts +174 -0
  407. package/templates/starter/src/render/lighting.ts +4 -4
  408. package/templates/starter/src/render/loading.ts +12 -2
  409. package/templates/starter/src/render/materials.ts +25 -6
  410. package/templates/starter/src/render/outline.ts +141 -0
  411. package/templates/starter/src/render/painterly.ts +86 -0
  412. package/templates/starter/src/render/palette.ts +15 -6
  413. package/templates/starter/src/render/postprocessing.ts +87 -36
  414. package/templates/starter/src/render/quality.ts +185 -0
  415. package/templates/starter/src/render/rockRidge.ts +198 -0
  416. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  417. package/templates/starter/src/render/scenery.ts +16 -59
  418. package/templates/starter/src/render/textureLifetime.ts +53 -0
  419. package/templates/starter/src/render/touch-controls.ts +165 -0
  420. package/templates/starter/src/render/water.ts +38 -0
  421. package/templates/starter/src/render/watercolor.ts +85 -0
  422. package/templates/starter/src/render/worldEnvironment.ts +208 -33
  423. package/templates/starter/src/scenes/Play.ts +103 -16
  424. package/templates/starter/src/style.css +27 -7
  425. package/templates/starter/threenative.config.ts +7 -7
  426. package/agent-docs/asset-mcp-loop.md +0 -33
  427. package/agent-docs/ctx-surface.md +0 -69
  428. package/agent-docs/engine-capabilities.md +0 -4
  429. package/agent-docs/framework-blocks-you.md +0 -60
  430. package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
  431. package/agent-docs/performance-default.md +0 -42
  432. package/agent-docs/pixel-budget.md +0 -20
  433. package/agent-docs/playtest-fail-closed.md +0 -23
  434. package/agent-docs/sculpt-loop.md +0 -16
  435. package/templates/action-rpg/src/physics.ts +0 -40
  436. package/templates/defense/public/icon.png +0 -0
  437. package/templates/minimal/public/icon.png +0 -0
  438. package/templates/platformer/public/icon.png +0 -0
  439. package/templates/racing/public/icon.png +0 -0
  440. package/templates/sailing/public/icon.png +0 -0
  441. package/templates/sailing/src/render/water-material.ts +0 -14
  442. package/templates/sailing/src/render/water-shaders.ts +0 -12
  443. package/templates/sailing/src/render/wave-nodes.ts +0 -10
  444. package/templates/shooter/public/icon.png +0 -0
  445. package/templates/shooter/src/physics.ts +0 -49
  446. package/templates/starter/public/icon.png +0 -0
  447. /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
@@ -0,0 +1,48 @@
1
+ {
2
+ "name": "shooter-vfx-combat",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 12,
7
+ "subject": "player",
8
+ "steps": [
9
+ { "kind": "wait", "label": "warm", "waitTicks": 8, "release": true },
10
+ { "kind": "input", "label": "fire", "press": "KeyF", "holdTicks": 1, "release": true },
11
+ { "kind": "wait", "label": "fire-visible", "waitTicks": 4, "release": true },
12
+ { "kind": "input", "label": "projectile", "press": "KeyG", "holdTicks": 1, "release": true },
13
+ { "kind": "wait", "label": "projectile-visible", "waitTicks": 8, "release": true },
14
+ { "kind": "input", "label": "blast", "press": "KeyE", "holdTicks": 1, "release": true },
15
+ { "kind": "wait", "label": "blast-visible", "waitTicks": 4, "release": true }
16
+ ],
17
+ "assert": {
18
+ "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
19
+ "resources": [
20
+ { "id": "state", "path": "shotsFired", "atSteps": [{ "label": "fire", "equals": 1 }] },
21
+ {
22
+ "id": "state",
23
+ "path": "radiusInsideDeaths",
24
+ "atSteps": [{ "label": "blast", "equals": 2 }]
25
+ }
26
+ ],
27
+ "signals": [
28
+ { "name": "fired", "entity": "player", "minCount": 1, "atStep": "fire" },
29
+ { "name": "hit", "entity": "player", "minCount": 1, "atStep": "fire" },
30
+ { "name": "vfx-muzzle", "entity": "player", "minCount": 2 },
31
+ { "name": "vfx-impact", "entity": "player", "minCount": 1, "atStep": "fire" },
32
+ { "name": "vfx-blast", "entity": "player", "minCount": 1, "atStep": "blast" }
33
+ ],
34
+ "visual": [
35
+ { "frameDiff": { "minChangedPixelRatio": 0.0001 } },
36
+ {
37
+ "region": { "x": 0, "y": 0, "width": 1280, "height": 720, "minNonblankPixelRatio": 0.0001 }
38
+ }
39
+ ],
40
+ "visibility": [
41
+ {
42
+ "allowTrivial": "The player's own capsule is invisible in first person; the viewmodel is what the player sees of themselves, so this row measures the weapon in frame.",
43
+ "entity": "viewmodel",
44
+ "minProjectedPixels": 400
45
+ }
46
+ ]
47
+ }
48
+ }
@@ -2,40 +2,75 @@
2
2
  "name": "input-control",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "parity": { "targets": ["web", "desktop"] },
6
- "viewport": { "width": 1280, "height": 720 },
5
+ "parity": {
6
+ "targets": ["web", "desktop"]
7
+ },
8
+ "viewport": {
9
+ "width": 1280,
10
+ "height": 720
11
+ },
7
12
  "warmupFrames": 60,
8
13
  "subject": "player",
9
14
  "steps": [
10
- { "kind": "wait", "label": "no-input-control", "waitTicks": 5, "release": true },
15
+ {
16
+ "kind": "wait",
17
+ "label": "no-input-control",
18
+ "waitTicks": 5,
19
+ "release": true
20
+ },
11
21
  {
12
22
  "kind": "input",
13
23
  "label": "wake-pointer",
14
- "pointerPosition": { "x": 0.5, "y": 0.5 },
24
+ "pointerPosition": {
25
+ "x": 0.5,
26
+ "y": 0.5
27
+ },
15
28
  "holdTicks": 2,
16
29
  "release": true
17
30
  },
18
- { "kind": "wait", "label": "wake-settle", "waitTicks": 4, "release": true },
31
+ {
32
+ "kind": "wait",
33
+ "label": "wake-settle",
34
+ "waitTicks": 4,
35
+ "release": true
36
+ },
19
37
  {
20
38
  "kind": "input",
21
39
  "label": "reset-heading",
22
- "press": "KeyR",
40
+ "press": "Enter",
23
41
  "holdTicks": 2,
24
42
  "release": true
25
43
  },
26
- { "kind": "wait", "label": "reset-settle", "waitTicks": 20, "release": true },
44
+ {
45
+ "kind": "wait",
46
+ "label": "reset-settle",
47
+ "waitTicks": 20,
48
+ "release": true
49
+ },
27
50
  {
28
51
  "kind": "input",
29
52
  "label": "aim-down",
30
- "pointerPosition": { "x": 0.5, "y": 0.5, "buttons": 2 },
53
+ "pointerPosition": {
54
+ "x": 0.5,
55
+ "y": 0.5,
56
+ "buttons": 2
57
+ },
31
58
  "holdTicks": 2,
32
59
  "release": false
33
60
  },
34
- { "kind": "wait", "label": "aim-settle", "waitTicks": 6, "release": true },
61
+ {
62
+ "kind": "wait",
63
+ "label": "aim-settle",
64
+ "waitTicks": 6,
65
+ "release": true
66
+ },
35
67
  {
36
68
  "kind": "input",
37
69
  "label": "look-right",
38
- "pointerPosition": { "x": 0.75, "y": 0.5 },
70
+ "pointerPosition": {
71
+ "x": 0.75,
72
+ "y": 0.5
73
+ },
39
74
  "holdTicks": 2,
40
75
  "release": false
41
76
  },
@@ -49,27 +84,66 @@
49
84
  {
50
85
  "kind": "input",
51
86
  "label": "look-back",
52
- "pointerPosition": { "x": 0.5, "y": 0.5 },
87
+ "pointerPosition": {
88
+ "x": 0.5,
89
+ "y": 0.5
90
+ },
53
91
  "holdTicks": 2,
54
92
  "release": false
55
93
  },
56
- { "kind": "wait", "label": "look-back-settle", "waitTicks": 8, "release": true },
94
+ {
95
+ "kind": "wait",
96
+ "label": "look-back-settle",
97
+ "waitTicks": 8,
98
+ "release": true
99
+ },
57
100
  {
58
101
  "kind": "input",
59
- "label": "fire-while-aiming",
60
- "pointerPosition": { "x": 0.5, "y": 0.5, "buttons": 3 },
102
+ "label": "release-buttons",
103
+ "pointerPosition": {
104
+ "x": 0.5,
105
+ "y": 0.5,
106
+ "buttons": 0
107
+ },
108
+ "holdTicks": 2,
109
+ "release": true
110
+ },
111
+ {
112
+ "kind": "wait",
113
+ "label": "release-settle",
114
+ "waitTicks": 8,
115
+ "release": true
116
+ },
117
+ {
118
+ "kind": "input",
119
+ "label": "aim-key",
120
+ "press": "KeyQ",
61
121
  "holdTicks": 2,
62
122
  "release": false
63
123
  },
64
- { "kind": "wait", "label": "fire-settle", "waitTicks": 8, "release": true },
124
+ {
125
+ "kind": "wait",
126
+ "label": "aim-key-settle",
127
+ "waitTicks": 6,
128
+ "release": false
129
+ },
65
130
  {
66
131
  "kind": "input",
67
- "label": "release-buttons",
68
- "pointerPosition": { "x": 0.5, "y": 0.5, "buttons": 0 },
132
+ "label": "fire-while-aiming",
133
+ "pointerPosition": {
134
+ "x": 0.5,
135
+ "y": 0.5,
136
+ "buttons": 1
137
+ },
69
138
  "holdTicks": 2,
70
139
  "release": true
71
140
  },
72
- { "kind": "wait", "label": "release-settle", "waitTicks": 8, "release": true }
141
+ {
142
+ "kind": "wait",
143
+ "label": "fire-settle",
144
+ "waitTicks": 8,
145
+ "release": true
146
+ }
73
147
  ],
74
148
  "assert": {
75
149
  "diagnostics": {
@@ -85,46 +159,102 @@
85
159
  {
86
160
  "id": "state",
87
161
  "path": "shotsFired",
88
- "atSteps": [{ "label": "fire-settle", "equals": 1 }]
162
+ "atSteps": [
163
+ {
164
+ "label": "fire-settle",
165
+ "equals": 1
166
+ }
167
+ ]
89
168
  },
90
169
  {
91
170
  "id": "state",
92
171
  "path": "aimedShots",
93
- "atSteps": [{ "label": "fire-settle", "equals": 1 }]
172
+ "atSteps": [
173
+ {
174
+ "label": "fire-settle",
175
+ "equals": 1
176
+ }
177
+ ]
94
178
  },
95
179
  {
96
180
  "allowTrivial": "The released leg expects the initial unaimed value; the engaged leg at aim-settle is the input-driven half of this row.",
97
181
  "id": "state",
98
182
  "path": "aiming",
99
183
  "atSteps": [
100
- { "label": "aim-settle", "equals": 1 },
101
- { "label": "release-settle", "equals": 0 }
184
+ {
185
+ "label": "aim-settle",
186
+ "equals": 1
187
+ },
188
+ {
189
+ "label": "release-settle",
190
+ "equals": 0
191
+ },
192
+ {
193
+ "label": "aim-key-settle",
194
+ "equals": 1
195
+ }
102
196
  ]
103
197
  },
104
198
  {
105
- "allowTrivial": "The returned leg expects the initial heading after the equal-and-opposite look pair; the look-right leg carries the rotation proof.",
199
+ "allowTrivial": "The returned leg expects the initial heading after the equal-and-opposite look pair; the look-right leg carries the rotation proof, halved because the right button is held \u2014 aiming down the sights covers half the angle for the same hand movement.",
106
200
  "id": "state",
107
201
  "path": "yawDegrees",
108
202
  "atSteps": [
109
- { "label": "look-right-settle", "equals": 92 },
110
- { "label": "look-back-settle", "equals": 0 }
203
+ {
204
+ "label": "look-right-settle",
205
+ "equals": 46
206
+ },
207
+ {
208
+ "label": "look-back-settle",
209
+ "equals": 0
210
+ }
111
211
  ]
112
212
  },
113
- { "id": "state", "path": "demoTargetAlive", "equals": 0, "changed": true },
114
- { "id": "state", "path": "demoDamage", "equals": 40, "changed": true }
213
+ {
214
+ "id": "state",
215
+ "path": "demoTargetAlive",
216
+ "equals": 0,
217
+ "changed": true
218
+ },
219
+ {
220
+ "id": "state",
221
+ "path": "demoDamage",
222
+ "equals": 40,
223
+ "changed": true
224
+ }
115
225
  ],
116
226
  "signals": [
117
- { "name": "aim-engaged", "entity": "player", "minCount": 1 },
118
- { "name": "fired", "entity": "player", "minCount": 1 },
119
- { "name": "hit", "entity": "player", "minCount": 1 },
120
- { "name": "defeated", "entity": "target", "minCount": 1 },
121
- { "name": "aim-released", "entity": "player", "minCount": 1 }
227
+ {
228
+ "name": "aim-engaged",
229
+ "entity": "player",
230
+ "minCount": 1
231
+ },
232
+ {
233
+ "name": "fired",
234
+ "entity": "player",
235
+ "minCount": 1
236
+ },
237
+ {
238
+ "name": "hit",
239
+ "entity": "player",
240
+ "minCount": 1
241
+ },
242
+ {
243
+ "name": "defeated",
244
+ "entity": "target",
245
+ "minCount": 1
246
+ },
247
+ {
248
+ "name": "aim-released",
249
+ "entity": "player",
250
+ "minCount": 1
251
+ }
122
252
  ],
123
253
  "visibility": [
124
254
  {
125
- "allowTrivial": "The shooter scene begins with the player visible and in frame; this held visibility row accompanies the input assertions.",
126
- "entity": "player",
127
- "minProjectedPixels": 20
255
+ "allowTrivial": "The player's own capsule is invisible in first person; the viewmodel is what the player sees of themselves, so this row measures the weapon in frame.",
256
+ "entity": "viewmodel",
257
+ "minProjectedPixels": 400
128
258
  }
129
259
  ]
130
260
  }
@@ -45,9 +45,9 @@
45
45
  "signals": [{ "name": "hit", "entity": "player", "minCount": 1, "atStep": "hit" }],
46
46
  "visibility": [
47
47
  {
48
- "allowTrivial": "The shooter scene begins with the player visible and in frame; the hit and animation assertions prove the new mechanisms also ran.",
49
- "entity": "player",
50
- "minProjectedPixels": 20
48
+ "allowTrivial": "The player's own capsule is invisible in first person; the viewmodel is what the player sees of themselves, so this row measures the weapon in frame.",
49
+ "entity": "viewmodel",
50
+ "minProjectedPixels": 400
51
51
  }
52
52
  ],
53
53
  "movement": {
@@ -1,22 +1,39 @@
1
1
  {
2
2
  "acceptanceId": "prd-194-performance-shooter",
3
- "artifacts": { "screenshots": false },
3
+ "artifacts": {
4
+ "screenshots": false
5
+ },
4
6
  "assert": {
5
7
  "performance": {
6
- "maxDrawCalls": 295,
8
+ "maxDrawCalls": 420,
7
9
  "maxFrameMsP95": 33,
8
- "maxTriangles": 2500
10
+ "maxTriangles": 7200,
11
+ "minFps": 30
9
12
  },
10
- "renderChain": { "tier": "high" }
13
+ "renderChain": {
14
+ "tier": "high"
15
+ }
11
16
  },
12
17
  "name": "production-performance",
13
18
  "schemaVersion": 1,
14
19
  "steps": [
15
- { "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
16
- { "kind": "wait", "waitTicks": 600, "release": true }
20
+ {
21
+ "kind": "input",
22
+ "press": "ArrowRight",
23
+ "holdTicks": 60,
24
+ "release": true
25
+ },
26
+ {
27
+ "kind": "wait",
28
+ "waitTicks": 600,
29
+ "release": true
30
+ }
17
31
  ],
18
32
  "subject": "player",
19
33
  "target": "web",
20
- "viewport": { "height": 1080, "width": 1920 },
34
+ "viewport": {
35
+ "height": 1080,
36
+ "width": 1920
37
+ },
21
38
  "warmupFrames": 60
22
39
  }
@@ -16,7 +16,7 @@
16
16
  {
17
17
  "kind": "input",
18
18
  "label": "wall-layer-filter",
19
- "press": "KeyC",
19
+ "press": "KeyV",
20
20
  "holdTicks": 1,
21
21
  "release": true
22
22
  },
@@ -25,8 +25,14 @@
25
25
  { "kind": "input", "label": "damage", "press": "KeyH", "holdTicks": 1, "release": true },
26
26
  { "kind": "input", "label": "death", "press": "KeyX", "holdTicks": 1, "release": true },
27
27
  { "kind": "wait", "label": "respawn", "waitTicks": 35, "release": true },
28
- { "kind": "input", "label": "pickup", "press": "KeyA", "holdTicks": 8, "release": true },
29
- { "kind": "input", "label": "pickup-return", "press": "KeyD", "holdTicks": 8, "release": true },
28
+ { "kind": "input", "label": "pickup", "press": "KeyA", "holdTicks": 30, "release": true },
29
+ {
30
+ "kind": "input",
31
+ "label": "pickup-return",
32
+ "press": "KeyD",
33
+ "holdTicks": 30,
34
+ "release": true
35
+ },
30
36
  { "kind": "input", "label": "wave-1-shot", "press": "KeyF", "holdTicks": 1, "release": true },
31
37
  { "kind": "wait", "label": "wave-2-ready", "waitTicks": 45, "release": true },
32
38
  { "kind": "input", "label": "wave-2-shot", "press": "KeyF", "holdTicks": 1, "release": true },
@@ -46,7 +52,7 @@
46
52
  "runtimeReady": true
47
53
  },
48
54
  "resources": [
49
- { "id": "state", "path": "hitDistanceTenths", "equals": 78, "changed": true },
55
+ { "id": "state", "path": "hitDistanceTenths", "equals": 85, "changed": true },
50
56
  { "id": "state", "path": "hitNormalXPercent", "equals": 22, "changed": true },
51
57
  { "id": "state", "path": "hitNormalYPercent", "equals": 0, "changed": true },
52
58
  { "id": "state", "path": "hitNormalZPercent", "equals": 98, "changed": true },
@@ -83,9 +89,9 @@
83
89
  ],
84
90
  "visibility": [
85
91
  {
86
- "allowTrivial": "The shooter scene begins with the player visible and in frame; this held visibility row accompanies the combat assertions.",
87
- "entity": "player",
88
- "minProjectedPixels": 20
92
+ "allowTrivial": "The player's own capsule is invisible in first person; the viewmodel is what the player sees of themselves, so this row measures the weapon in frame.",
93
+ "entity": "viewmodel",
94
+ "minProjectedPixels": 400
89
95
  },
90
96
  { "entity": "demo-target", "present": false }
91
97
  ]
@@ -16,7 +16,34 @@
16
16
  "noRuntimeDiagnostics": true,
17
17
  "runtimeReady": true
18
18
  },
19
+ "components": [
20
+ {
21
+ "allowTrivial": "GroundSnap settles the player before this movement observation; the finite near-zero clearance is the generated call-site proof.",
22
+ "component": "groundClearance",
23
+ "entity": "player",
24
+ "lte": 0.01
25
+ },
26
+ {
27
+ "allowTrivial": "The shooter rifle has an authored non-unit size; this retained factor proves normaliseToMetres ran in the generated player.",
28
+ "component": "normaliseFactor",
29
+ "entity": "player",
30
+ "gte": 1.01
31
+ },
32
+ {
33
+ "allowTrivial": "Weapon attachment is construction-time; the resolved RightHand parent proves attachToBone ran in the generated player.",
34
+ "component": "weaponBone",
35
+ "entity": "player",
36
+ "equals": "RightHand"
37
+ }
38
+ ],
19
39
  "movement": { "entity": "player", "minDistance": 0.5 },
40
+ "visibility": [
41
+ {
42
+ "entity": "touch-controls",
43
+ "present": false,
44
+ "allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
45
+ }
46
+ ],
20
47
  "visual": [
21
48
  {
22
49
  "region": {
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "shooter-touch-controls",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 10,
7
+ "subject": "player",
8
+ "steps": [
9
+ {
10
+ "kind": "input",
11
+ "label": "movement-anchor",
12
+ "pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
13
+ "holdTicks": 2,
14
+ "release": false
15
+ },
16
+ {
17
+ "kind": "input",
18
+ "label": "move-and-fire",
19
+ "pointers": [{ "id": 7, "x": 0.32, "y": 0.75 }, { "id": 3, "x": 0.927, "y": 0.869 }],
20
+ "holdTicks": 45,
21
+ "release": true
22
+ },
23
+ { "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
24
+ ],
25
+ "assert": {
26
+ "diagnostics": {
27
+ "noConsoleErrors": true,
28
+ "noNetworkErrors": true,
29
+ "noRuntimeDiagnostics": true,
30
+ "runtimeReady": true
31
+ },
32
+ "movement": { "entity": "player", "minDistance": 0.1 },
33
+ "resources": [{ "id": "state", "path": "shotsFired", "gte": 1, "changed": true }],
34
+ "visibility": [
35
+ {
36
+ "entity": "touch-controls",
37
+ "present": true,
38
+ "allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
39
+ }
40
+ ]
41
+ }
42
+ }