create-threenative 0.2.2 → 0.2.3

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 (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,4 @@
1
+ # Generated by @threenative/assets from the sources in assets/. Hand-owned static files
2
+ # (favicon, launcher icons) stay in public/ and are committed; these outputs never are.
3
+ public/assets.manifest.json
4
+ public/*.[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f].*
@@ -3,7 +3,6 @@
3
3
  <head>
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <link rel="icon" href="/favicon.svg" />
7
6
  <title>__PROJECT_NAME__</title>
8
7
  </head>
9
8
  <body>
@@ -0,0 +1,20 @@
1
+ {
2
+ "name": "native-react-hud",
3
+ "target": "desktop",
4
+ "schemaVersion": 1,
5
+ "warmupFrames": 0,
6
+ "steps": [
7
+ { "label": "ui-ready", "waitTicks": 180 },
8
+ { "kind": "input", "label": "move-under-live-hud", "press": "ArrowRight", "holdTicks": 20 }
9
+ ],
10
+ "assert": {
11
+ "resources": [
12
+ {
13
+ "id": "state",
14
+ "path": "uiReady",
15
+ "atSteps": [{ "label": "ui-ready", "equals": true }]
16
+ },
17
+ { "id": "state", "path": "playerX", "changed": true }
18
+ ]
19
+ }
20
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "name": "native-render-chain",
3
+ "target": "desktop",
4
+ "schemaVersion": 1,
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 2,
7
+ "steps": [{ "label": "chain-settled", "waitTicks": 12 }],
8
+ "artifacts": { "screenshots": "after" },
9
+ "assert": {
10
+ "renderChain": { "tier": "high" }
11
+ }
12
+ }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "__PROJECT_NAME__",
3
3
  "private": true,
4
+ "license": "MIT",
4
5
  "type": "module",
5
6
  "scripts": {
6
7
  "dev": "vite",
@@ -12,38 +13,41 @@
12
13
  "build:ios": "threenative build --target ios",
13
14
  "test:native": "pnpm build:desktop && node node_modules/@threenative/runtime-native/scripts/verify-starter-desktop.mjs",
14
15
  "pretest": "playwright install chromium",
15
- "test": "vite build && threenative-playtest --scenario playtests/survives.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/play.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/monitoring.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/restart.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/coyote.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/buffer.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/look.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/pause.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/respawn.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\" && threenative-playtest --scenario playtests/seed.playtest.json --url http://127.0.0.1:4173 --server-command \"pnpm dev --host 127.0.0.1 --port 4173 --strictPort\"",
16
+ "test": "vite build && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm dev --host 127.0.0.1 --port $PORT --strictPort\"",
16
17
  "typecheck": "tsc --noEmit -p tsconfig.json"
17
18
  },
18
19
  "dependencies": {
19
- "@threenative/core": "0.2.0",
20
- "@threenative/physics": "0.2.1",
21
- "@threenative/ui": "0.2.1",
20
+ "@threenative/core": "0.3.0",
21
+ "@threenative/physics": "0.3.0",
22
+ "@threenative/ui": "0.3.0",
22
23
  "react": "19.2.0",
23
24
  "react-dom": "19.2.0",
25
+ "react-reconciler": "0.33.0",
24
26
  "three": "0.185.1"
25
27
  },
26
28
  "devDependencies": {
27
29
  "@tailwindcss/vite": "4.3.3",
28
- "@threenative/playtest": "0.2.0",
29
- "@threenative/studio": "0.2.0",
30
+ "@threenative/assets": "0.3.0",
31
+ "@threenative/playtest": "0.3.0",
30
32
  "@types/react": "19.2.0",
31
33
  "@types/react-dom": "19.2.0",
32
34
  "@types/three": "0.185.3",
33
35
  "@vitejs/plugin-react": "6.0.5",
34
- "create-threenative": "0.2.2",
36
+ "create-threenative": "0.2.3",
35
37
  "esbuild": "0.27.0",
36
38
  "playwright": "1.62.1",
37
39
  "tailwindcss": "4.3.3",
38
- "threenative-asset-mcp": "0.4.0",
39
- "threenative-sculpt-mcp": "0.1.0",
40
40
  "typescript": "5.9.3",
41
- "vite": "8.2.0"
41
+ "vite": "8.2.0",
42
+ "@gltf-transform/cli": "4.4.2"
42
43
  },
43
44
  "optionalDependencies": {
44
- "@threenative/runtime-native": "0.2.0"
45
+ "@threenative/runtime-native": "0.3.0"
45
46
  },
46
47
  "pnpm": {
47
- "onlyBuiltDependencies": ["@threenative/runtime-native"]
48
+ "onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
49
+ "patchedDependencies": {
50
+ "three@0.185.1": "patches/three@0.185.1.patch"
51
+ }
48
52
  }
49
53
  }
@@ -0,0 +1,65 @@
1
+ {
2
+ "name": "starter-assets",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 10,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 600,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "run-toward-the-flag",
21
+ "press": "ArrowRight",
22
+ "holdTicks": 205,
23
+ "release": false
24
+ },
25
+ {
26
+ "kind": "input",
27
+ "label": "jump-the-gap",
28
+ "press": "Space",
29
+ "holdTicks": 2,
30
+ "release": true
31
+ },
32
+ {
33
+ "kind": "wait",
34
+ "label": "land-beside-the-pennant",
35
+ "waitTicks": 120,
36
+ "release": true
37
+ }
38
+ ],
39
+ "assert": {
40
+ "diagnostics": {
41
+ "noConsoleErrors": true,
42
+ "noNetworkErrors": true,
43
+ "runtimeReady": true
44
+ },
45
+ "movement": {
46
+ "entity": "player",
47
+ "minDistance": 0.5
48
+ },
49
+ "resources": [
50
+ {
51
+ "id": "state",
52
+ "path": "status",
53
+ "equals": "won",
54
+ "changed": true
55
+ }
56
+ ],
57
+ "visibility": [
58
+ {
59
+ "allowTrivial": "The pennant is authored in frame from the first tick so the player can see where to jump; this row proves the compiled model still draws when the run reaches it.",
60
+ "entity": "goal",
61
+ "minProjectedPixels": 20
62
+ }
63
+ ]
64
+ }
65
+ }
@@ -2,12 +2,32 @@
2
2
  "name": "starter-jump-buffer",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
6
9
  "warmupFrames": 10,
7
10
  "subject": "player",
8
11
  "steps": [
9
- { "kind": "input", "label": "first-jump", "press": "Space", "holdTicks": 2, "release": true },
10
- { "kind": "wait", "label": "near-landing", "waitTicks": 55, "release": true },
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 240,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "first-jump",
21
+ "press": "Space",
22
+ "holdTicks": 2,
23
+ "release": true
24
+ },
25
+ {
26
+ "kind": "wait",
27
+ "label": "near-landing",
28
+ "waitTicks": 55,
29
+ "release": true
30
+ },
11
31
  {
12
32
  "kind": "input",
13
33
  "label": "buffered-jump",
@@ -15,15 +35,45 @@
15
35
  "holdTicks": 2,
16
36
  "release": true
17
37
  },
18
- { "kind": "wait", "label": "buffered-arc", "waitTicks": 20, "release": true }
38
+ {
39
+ "kind": "wait",
40
+ "label": "buffered-arc",
41
+ "waitTicks": 20,
42
+ "release": true
43
+ }
19
44
  ],
20
45
  "assert": {
21
- "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
46
+ "diagnostics": {
47
+ "noConsoleErrors": true,
48
+ "noNetworkErrors": true,
49
+ "runtimeReady": true
50
+ },
22
51
  "resources": [
23
- { "id": "GameState", "path": "jumps", "equals": 2, "changed": true },
24
- { "id": "GameState", "path": "coyoteJumps", "equals": 0, "allowTrivial": true },
25
- { "id": "GameState", "path": "peakRise", "gte": 0.5, "changed": true }
52
+ {
53
+ "id": "state",
54
+ "path": "jumps",
55
+ "equals": 2,
56
+ "changed": true
57
+ },
58
+ {
59
+ "id": "state",
60
+ "path": "coyoteJumps",
61
+ "equals": 0,
62
+ "allowTrivial": "This buffer scenario exercises a jump without consuming coyote time; coyoteJumps staying at zero is the intentional held invariant."
63
+ },
64
+ {
65
+ "id": "state",
66
+ "path": "peakRise",
67
+ "gte": 0.5,
68
+ "changed": true
69
+ }
26
70
  ],
27
- "visibility": [{ "entity": "player", "minProjectedPixels": 20 }]
71
+ "visibility": [
72
+ {
73
+ "allowTrivial": "The starter scene begins with the player visible and in frame; this held visibility row accompanies the buffer assertion.",
74
+ "entity": "player",
75
+ "minProjectedPixels": 20
76
+ }
77
+ ]
28
78
  }
29
79
  }
@@ -0,0 +1,113 @@
1
+ {
2
+ "name": "starter-cloth-flag",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 30,
10
+ "subject": "goal",
11
+ "artifacts": {
12
+ "screenshots": "before-after"
13
+ },
14
+ "steps": [
15
+ {
16
+ "kind": "wait",
17
+ "label": "play-scene-loads",
18
+ "waitTicks": 90,
19
+ "release": true
20
+ },
21
+ {
22
+ "kind": "input",
23
+ "label": "gust",
24
+ "press": "KeyG",
25
+ "holdTicks": 1,
26
+ "release": true
27
+ },
28
+ {
29
+ "kind": "wait",
30
+ "label": "flag-settles",
31
+ "waitTicks": 30,
32
+ "release": true
33
+ },
34
+ {
35
+ "kind": "click",
36
+ "at": {
37
+ "x": 0,
38
+ "y": 0
39
+ },
40
+ "label": "gpu-readback-settle",
41
+ "release": true,
42
+ "waitFrames": 60
43
+ },
44
+ {
45
+ "kind": "wait",
46
+ "label": "request-post-gust-readback",
47
+ "waitTicks": 1,
48
+ "release": true
49
+ },
50
+ {
51
+ "kind": "click",
52
+ "at": {
53
+ "x": 0,
54
+ "y": 0
55
+ },
56
+ "label": "post-gust-readback-settle",
57
+ "release": true,
58
+ "waitFrames": 60
59
+ },
60
+ {
61
+ "kind": "wait",
62
+ "label": "observe-readback",
63
+ "waitTicks": 1,
64
+ "release": true
65
+ }
66
+ ],
67
+ "assert": {
68
+ "diagnostics": {
69
+ "noConsoleErrors": true,
70
+ "noNetworkErrors": true,
71
+ "runtimeReady": true
72
+ },
73
+ "resources": [
74
+ {
75
+ "id": "state",
76
+ "path": "flagGusts",
77
+ "equals": 1,
78
+ "changed": true
79
+ },
80
+ {
81
+ "id": "state",
82
+ "path": "flagDisplacement",
83
+ "gte": 0.005,
84
+ "changed": true
85
+ },
86
+ {
87
+ "id": "state",
88
+ "path": "flagReadbacks",
89
+ "changed": true
90
+ },
91
+ {
92
+ "id": "state",
93
+ "path": "flagSteps",
94
+ "gte": 70,
95
+ "changed": true
96
+ }
97
+ ],
98
+ "visibility": [
99
+ {
100
+ "allowTrivial": "The finish flag is authored in frame from the first tick; deformation and compute progress are asserted through state.",
101
+ "entity": "goal",
102
+ "minProjectedPixels": 20
103
+ }
104
+ ],
105
+ "visual": [
106
+ {
107
+ "frameDiff": {
108
+ "minChangedPixelRatio": 0.0001
109
+ }
110
+ }
111
+ ]
112
+ }
113
+ }
@@ -2,10 +2,19 @@
2
2
  "name": "starter-coyote-and-buffer",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
6
9
  "warmupFrames": 10,
7
10
  "subject": "player",
8
11
  "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 600,
16
+ "release": true
17
+ },
9
18
  {
10
19
  "kind": "input",
11
20
  "label": "leave-ledge",
@@ -20,16 +29,59 @@
20
29
  "holdTicks": 3,
21
30
  "release": false
22
31
  },
23
- { "kind": "input", "label": "late-jump", "press": "Space", "holdTicks": 2, "release": true },
24
- { "kind": "wait", "label": "jump-arc", "waitTicks": 18, "release": true }
32
+ {
33
+ "kind": "input",
34
+ "label": "airborne",
35
+ "press": "ArrowLeft",
36
+ "holdTicks": 5,
37
+ "release": false
38
+ },
39
+ {
40
+ "kind": "input",
41
+ "label": "late-jump",
42
+ "press": "Space",
43
+ "holdTicks": 2,
44
+ "release": true
45
+ },
46
+ {
47
+ "kind": "wait",
48
+ "label": "jump-arc",
49
+ "waitTicks": 18,
50
+ "release": true
51
+ }
25
52
  ],
26
53
  "assert": {
27
- "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
54
+ "diagnostics": {
55
+ "noConsoleErrors": true,
56
+ "noNetworkErrors": true,
57
+ "runtimeReady": true
58
+ },
28
59
  "resources": [
29
- { "id": "GameState", "path": "jumps", "equals": 1, "changed": true },
30
- { "id": "GameState", "path": "coyoteJumps", "equals": 1, "changed": true },
31
- { "id": "GameState", "path": "peakRise", "gte": 0.5, "changed": true }
60
+ {
61
+ "id": "state",
62
+ "path": "jumps",
63
+ "equals": 1,
64
+ "changed": true
65
+ },
66
+ {
67
+ "id": "state",
68
+ "path": "coyoteJumps",
69
+ "equals": 1,
70
+ "changed": true
71
+ },
72
+ {
73
+ "id": "state",
74
+ "path": "peakRise",
75
+ "gte": 0.5,
76
+ "changed": true
77
+ }
32
78
  ],
33
- "visibility": [{ "entity": "player", "minProjectedPixels": 20 }]
79
+ "visibility": [
80
+ {
81
+ "allowTrivial": "The starter scene begins with the player visible and in frame; this held visibility row accompanies the coyote assertion.",
82
+ "entity": "player",
83
+ "minProjectedPixels": 20
84
+ }
85
+ ]
34
86
  }
35
87
  }
@@ -2,14 +2,39 @@
2
2
  "name": "starter-forward",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
6
9
  "warmupFrames": 10,
7
10
  "subject": "player",
8
11
  "steps": [
9
- { "kind": "input", "label": "forward", "press": "ArrowUp", "holdTicks": 60, "release": true }
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 240,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "forward",
21
+ "press": "ArrowUp",
22
+ "holdTicks": 60,
23
+ "release": true
24
+ }
10
25
  ],
11
26
  "assert": {
12
- "diagnostics": { "noConsoleErrors": true, "noNetworkErrors": true, "runtimeReady": true },
13
- "movement": { "entity": "player", "minAxisDelta": { "axis": "-z", "min": 0.5 } }
27
+ "diagnostics": {
28
+ "noConsoleErrors": true,
29
+ "noNetworkErrors": true,
30
+ "runtimeReady": true
31
+ },
32
+ "movement": {
33
+ "entity": "player",
34
+ "minAxisDelta": {
35
+ "axis": "-z",
36
+ "min": 0.5
37
+ }
38
+ }
14
39
  }
15
40
  }
@@ -0,0 +1,66 @@
1
+ {
2
+ "name": "starter-game-over",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 10,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 600,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "walk-off-three-times",
21
+ "press": "ArrowDown",
22
+ "holdTicks": 420,
23
+ "release": true
24
+ },
25
+ {
26
+ "kind": "wait",
27
+ "label": "game-over",
28
+ "waitTicks": 60,
29
+ "release": true
30
+ }
31
+ ],
32
+ "assert": {
33
+ "diagnostics": {
34
+ "noConsoleErrors": true,
35
+ "noNetworkErrors": true,
36
+ "runtimeReady": true
37
+ },
38
+ "resources": [
39
+ {
40
+ "id": "state",
41
+ "path": "lives",
42
+ "equals": 0,
43
+ "changed": true
44
+ },
45
+ {
46
+ "id": "state",
47
+ "path": "status",
48
+ "equals": "lost",
49
+ "changed": true
50
+ },
51
+ {
52
+ "id": "state",
53
+ "path": "respawns",
54
+ "gte": 3,
55
+ "changed": true
56
+ }
57
+ ],
58
+ "visibility": [
59
+ {
60
+ "allowTrivial": "The player is visible from the first tick and is returned to the spawn pad on the last life, so this row holds while the resource rows carry the game-over proof.",
61
+ "entity": "player",
62
+ "minProjectedPixels": 20
63
+ }
64
+ ]
65
+ }
66
+ }
@@ -0,0 +1,67 @@
1
+ {
2
+ "name": "starter-goal",
3
+ "target": "web",
4
+ "schemaVersion": 1,
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
9
+ "warmupFrames": 10,
10
+ "subject": "player",
11
+ "steps": [
12
+ {
13
+ "kind": "wait",
14
+ "label": "play-scene-loads",
15
+ "waitTicks": 600,
16
+ "release": true
17
+ },
18
+ {
19
+ "kind": "input",
20
+ "label": "run-up",
21
+ "press": "ArrowRight",
22
+ "holdTicks": 205,
23
+ "release": false
24
+ },
25
+ {
26
+ "kind": "input",
27
+ "label": "jump-the-gap",
28
+ "press": "Space",
29
+ "holdTicks": 2,
30
+ "release": true
31
+ },
32
+ {
33
+ "kind": "wait",
34
+ "label": "land-on-the-island",
35
+ "waitTicks": 120,
36
+ "release": true
37
+ }
38
+ ],
39
+ "assert": {
40
+ "diagnostics": {
41
+ "noConsoleErrors": true,
42
+ "noNetworkErrors": true,
43
+ "runtimeReady": true
44
+ },
45
+ "resources": [
46
+ {
47
+ "id": "state",
48
+ "path": "status",
49
+ "equals": "won",
50
+ "changed": true
51
+ },
52
+ {
53
+ "id": "state",
54
+ "path": "playerX",
55
+ "gte": 6.4,
56
+ "changed": true
57
+ }
58
+ ],
59
+ "visibility": [
60
+ {
61
+ "allowTrivial": "The goal flag is authored in frame from the first tick so the player can see where to jump; this row proves it is still drawn when the run ends.",
62
+ "entity": "goal",
63
+ "minProjectedPixels": 20
64
+ }
65
+ ]
66
+ }
67
+ }