create-threenative 0.2.6 → 0.2.8

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 (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { IThreeNativeIconVariants, ThreeNativeOrientation, IThreeNativeBootSplash, ThreeNativeUiRenderer, IThreeNativeAudioConfig, IThreeNativeConfig, IThreeNativeLodConfig, IThreeNativeTexturesConfig } from '@threenative/core';
2
+ import { IThreeNativeIconVariants, ThreeNativeOrientation, IThreeNativeBootSplash, IThreeNativeConfig, ThreeNativeUiRenderer, IThreeNativeAudioConfig, IThreeNativeLodConfig, IThreeNativeTexturesConfig } from '@threenative/core';
3
3
 
4
4
  interface IEngineFreshnessVitePlugin {
5
5
  readonly name: string;
@@ -35,6 +35,8 @@ interface IEngineFreshnessVitePlugin {
35
35
  declare function hashEngineDist(projectRoot: string): string | undefined;
36
36
  declare function createEngineFreshnessPlugin(): IEngineFreshnessVitePlugin;
37
37
 
38
+ type BuildTarget = "android" | "desktop" | "ios" | "web";
39
+
38
40
  interface IResolvedThreeNativeConfig {
39
41
  readonly app: {
40
42
  readonly id: string;
@@ -60,6 +62,16 @@ interface IResolvedThreeNativeConfig {
60
62
  };
61
63
  readonly bootSplash?: IThreeNativeBootSplash;
62
64
  readonly nativeEntry: string;
65
+ /** Which cook profile produced this configuration, and whether the flag or the default chose it. */
66
+ readonly buildProfile?: {
67
+ readonly name: string;
68
+ readonly source: "flag" | "default";
69
+ readonly target: BuildTarget;
70
+ /** The byte ceilings this build must measure against before publishing its artifact. */
71
+ readonly artifactBudget?: ArtifactBudget;
72
+ /** The runtime ceilings published into this build's report, for `threenative-playtest`. */
73
+ readonly performanceBudget?: PerformanceBudget;
74
+ };
63
75
  readonly renderer: {
64
76
  readonly preferWebGPU: boolean;
65
77
  readonly resolutionScale?: number | "auto";
@@ -107,6 +119,19 @@ interface IThreeNativeModelPassesConfig {
107
119
  readonly reorder?: boolean;
108
120
  }
109
121
  interface IThreeNativeModelsConfig {
122
+ /**
123
+ * Lossless scene-graph compaction (flatten, join, instance) against one protected-node set.
124
+ * `false` ships the scene graph as authored; absent means on with defaults.
125
+ */
126
+ readonly compact?: boolean | {
127
+ readonly flatten?: boolean;
128
+ readonly instance?: boolean | {
129
+ readonly min?: number;
130
+ };
131
+ readonly join?: boolean;
132
+ readonly protectedNames?: readonly string[];
133
+ readonly protectedPattern?: string;
134
+ };
110
135
  readonly lightmap?: {
111
136
  readonly atlasSize: number;
112
137
  readonly padding: number;
@@ -165,6 +190,10 @@ interface IThreeNativeModelsConfig {
165
190
  readonly simplifyRatio?: number;
166
191
  } | "none";
167
192
  }
193
+ /** The byte ceilings a profile declares on what a build produced. */
194
+ type ArtifactBudget = NonNullable<NonNullable<IThreeNativeConfig["buildProfiles"]>["profiles"][string]["artifactBudget"]>;
195
+ /** The runtime ceilings a profile declares on what its artifact does. */
196
+ type PerformanceBudget = NonNullable<NonNullable<IThreeNativeConfig["buildProfiles"]>["profiles"][string]["performanceBudget"]>;
168
197
 
169
198
  interface IWebBrandVitePlugin {
170
199
  readonly name: string;
package/dist/index.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import { createRequire } from 'node:module';
3
3
  import { spawn } from 'child_process';
4
4
  import { existsSync, realpathSync, readdirSync, readFileSync, rmSync, mkdirSync, writeFileSync } from 'fs';
5
- import { mkdir, cp, rename, readFile, readdir, writeFile, access, unlink, stat } from 'fs/promises';
5
+ import { mkdir, cp, rename, readFile, readdir, writeFile, symlink, access, unlink, stat } from 'fs/promises';
6
6
  import path5 from 'path';
7
7
  import { fileURLToPath, pathToFileURL } from 'url';
8
8
  import { LoadingManager, Box3, Vector3 } from 'three';
@@ -128,7 +128,7 @@ async function localResourceResolver(file, data) {
128
128
  return resourcePath === void 0 ? url : resources.get(resourcePath) ?? url;
129
129
  };
130
130
  }
131
- async function parseGltf(file, data) {
131
+ async function parseGltfAsset(file, data) {
132
132
  const restoreGlobals = installNodeGltfGlobals();
133
133
  try {
134
134
  const { GLTFLoader } = await import('three/addons/loaders/GLTFLoader.js');
@@ -243,7 +243,7 @@ async function inspectAsset(file) {
243
243
  throw inspectionFailure(file, error);
244
244
  }
245
245
  try {
246
- const parsed = await parseGltf(file, data);
246
+ const parsed = await parseGltfAsset(file, data);
247
247
  return inspectScene(file, parsed.scene, parsed.animations, parsed.resourceCounts);
248
248
  } catch (error) {
249
249
  throw inspectionFailure(file, error);
@@ -1272,6 +1272,7 @@ function validateModels(raw) {
1272
1272
  if (raw === "none") return "none";
1273
1273
  const models = assertRecord(raw, "assets.models");
1274
1274
  assertKeys(models, "assets.models", [
1275
+ "compact",
1275
1276
  "lightmap",
1276
1277
  "passes",
1277
1278
  "quantize",
@@ -1335,6 +1336,7 @@ function validateModels(raw) {
1335
1336
  }
1336
1337
  const simplify = models.simplify;
1337
1338
  const textures = models.textures;
1339
+ const compact = models.compact;
1338
1340
  let virtual;
1339
1341
  if (models.virtual === "none") {
1340
1342
  virtual = "none";
@@ -1364,6 +1366,7 @@ function validateModels(raw) {
1364
1366
  virtual = bake;
1365
1367
  }
1366
1368
  return {
1369
+ ...compact === void 0 ? {} : { compact },
1367
1370
  ...lightmap === void 0 ? {} : { lightmap },
1368
1371
  ...passes === void 0 || Object.keys(passes).length === 0 ? {} : { passes },
1369
1372
  ...quantize === void 0 || Object.keys(quantize).length === 0 ? {} : { quantize },
@@ -1588,7 +1591,210 @@ function validateAssets(raw) {
1588
1591
  ...textures === void 0 ? {} : { textures }
1589
1592
  };
1590
1593
  }
1591
- async function loadConfigInternal(root) {
1594
+ var PROFILE_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/u;
1595
+ var PROFILE_ASSET_KEYS = [
1596
+ "audio",
1597
+ "budget",
1598
+ "lod",
1599
+ "models",
1600
+ "targets",
1601
+ "textures"
1602
+ ];
1603
+ var PROFILE_TARGETS = ["android", "desktop", "ios", "web"];
1604
+ var ARTIFACT_BUDGET_KEYS = ["artifactBytes", "packagedAssetBytes"];
1605
+ var ARTIFACT_BUDGET_SEVERITIES = ["error", "warn"];
1606
+ var PERFORMANCE_BUDGET_KEYS = [
1607
+ "maxDrawCalls",
1608
+ "maxFrameMsP95",
1609
+ "maxPassDrawCalls",
1610
+ "maxPassTriangles",
1611
+ "maxPhaseMsP95",
1612
+ "maxTriangles",
1613
+ "minFps"
1614
+ ];
1615
+ var PERFORMANCE_BUDGET_PHASES = [
1616
+ "hostGap",
1617
+ "overlay",
1618
+ "render",
1619
+ "residual",
1620
+ "update"
1621
+ ];
1622
+ var PERFORMANCE_BUDGET_PASSES = ["main", "shadow", "reflection", "nested"];
1623
+ function validatePerformanceBudgetMap(raw, label, names, unit) {
1624
+ const map = assertRecord(raw, label);
1625
+ const entries = Object.entries(map);
1626
+ if (entries.length === 0)
1627
+ fail("TN_CONFIG_PROFILE_INVALID", `${label} must name at least one entry.`);
1628
+ const budget = {};
1629
+ for (const [name, ceiling] of entries) {
1630
+ if (!names.includes(name)) {
1631
+ fail(
1632
+ "TN_CONFIG_PROFILE_INVALID",
1633
+ `${label}.${name} is not recognised. Expected one of: ${names.join(", ")}.`
1634
+ );
1635
+ }
1636
+ if (typeof ceiling !== "number" || !Number.isFinite(ceiling) || ceiling < 0) {
1637
+ fail(
1638
+ "TN_CONFIG_PROFILE_INVALID",
1639
+ `${label}.${name} must be a non-negative number of ${unit}.`
1640
+ );
1641
+ }
1642
+ budget[name] = ceiling;
1643
+ }
1644
+ return budget;
1645
+ }
1646
+ function validatePerformanceBudget(raw, label) {
1647
+ const budget = assertRecord(raw, `${label}.performanceBudget`);
1648
+ assertKeys(budget, `${label}.performanceBudget`, PERFORMANCE_BUDGET_KEYS);
1649
+ if (Object.keys(budget).length === 0) {
1650
+ fail(
1651
+ "TN_CONFIG_PROFILE_INVALID",
1652
+ `${label}.performanceBudget must declare at least one ceiling; an empty budget bounds nothing.`
1653
+ );
1654
+ }
1655
+ const out = {};
1656
+ for (const key of ["maxDrawCalls", "maxFrameMsP95", "maxTriangles", "minFps"]) {
1657
+ const value = budget[key];
1658
+ if (value === void 0) continue;
1659
+ if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
1660
+ fail(
1661
+ "TN_CONFIG_PROFILE_INVALID",
1662
+ `${label}.performanceBudget.${key} must be a non-negative number.`
1663
+ );
1664
+ }
1665
+ out[key] = value;
1666
+ }
1667
+ for (const [key, names, unit] of [
1668
+ ["maxPassDrawCalls", PERFORMANCE_BUDGET_PASSES, "draw calls"],
1669
+ ["maxPassTriangles", PERFORMANCE_BUDGET_PASSES, "triangles"],
1670
+ ["maxPhaseMsP95", PERFORMANCE_BUDGET_PHASES, "milliseconds"]
1671
+ ]) {
1672
+ if (budget[key] === void 0) continue;
1673
+ out[key] = validatePerformanceBudgetMap(
1674
+ budget[key],
1675
+ `${label}.performanceBudget.${key}`,
1676
+ names,
1677
+ unit
1678
+ );
1679
+ }
1680
+ return out;
1681
+ }
1682
+ function artifactBudgetLimit(raw, label) {
1683
+ const limit = assertRecord(raw, label);
1684
+ assertKeys(limit, label, ["limit", "severity"]);
1685
+ const bytes = positiveInteger(limit.limit, 1, "TN_CONFIG_PROFILE_INVALID", `${label}.limit`);
1686
+ if (typeof limit.severity !== "string" || !ARTIFACT_BUDGET_SEVERITIES.includes(limit.severity)) {
1687
+ fail(
1688
+ "TN_CONFIG_PROFILE_INVALID",
1689
+ `${label}.severity must be one of ${ARTIFACT_BUDGET_SEVERITIES.join(", ")}.`
1690
+ );
1691
+ }
1692
+ return { limit: bytes, severity: limit.severity };
1693
+ }
1694
+ function validateArtifactBudget(raw, label) {
1695
+ const budget = assertRecord(raw, `${label}.artifactBudget`);
1696
+ assertKeys(budget, `${label}.artifactBudget`, ARTIFACT_BUDGET_KEYS);
1697
+ const artifactBytes = budget.artifactBytes === void 0 ? void 0 : artifactBudgetLimit(budget.artifactBytes, `${label}.artifactBudget.artifactBytes`);
1698
+ const packagedAssetBytes = budget.packagedAssetBytes === void 0 ? void 0 : artifactBudgetLimit(
1699
+ budget.packagedAssetBytes,
1700
+ `${label}.artifactBudget.packagedAssetBytes`
1701
+ );
1702
+ return {
1703
+ ...artifactBytes === void 0 ? {} : { artifactBytes },
1704
+ ...packagedAssetBytes === void 0 ? {} : { packagedAssetBytes }
1705
+ };
1706
+ }
1707
+ function resolveBuildProfile(raw, selection) {
1708
+ if (raw === void 0) {
1709
+ return void 0;
1710
+ }
1711
+ const group = assertRecord(raw, "buildProfiles");
1712
+ assertKeys(group, "buildProfiles", ["defaults", "profiles"]);
1713
+ const defaults = assertRecord(group.defaults, "buildProfiles.defaults");
1714
+ assertKeys(defaults, "buildProfiles.defaults", PROFILE_TARGETS);
1715
+ for (const [target, name2] of Object.entries(defaults)) {
1716
+ if (typeof name2 !== "string" || name2.length === 0) {
1717
+ fail("TN_CONFIG_PROFILE_INVALID", `buildProfiles.defaults.${target} must name a profile.`);
1718
+ }
1719
+ }
1720
+ const profiles = assertRecord(group.profiles, "buildProfiles.profiles");
1721
+ const declared = Object.keys(profiles);
1722
+ if (declared.length === 0) {
1723
+ fail("TN_CONFIG_GROUP_INVALID", "buildProfiles.profiles must declare at least one profile.");
1724
+ }
1725
+ for (const name2 of declared) {
1726
+ const label = `buildProfiles.profiles['${name2}']`;
1727
+ if (!PROFILE_NAME.test(name2)) {
1728
+ fail(
1729
+ "TN_CONFIG_PROFILE_NAME_INVALID",
1730
+ `${label} is not a usable profile name ('${name2}'): names are one lower-case path segment matching /^[a-z0-9][a-z0-9_-]{0,63}$/, so no name can traverse out of the build directory or collide by case.`
1731
+ );
1732
+ }
1733
+ const profile2 = assertRecord(profiles[name2], label);
1734
+ assertKeys(profile2, label, ["artifactBudget", "assets", "performanceBudget"]);
1735
+ assertKeys(
1736
+ assertRecord(profile2.assets, `${label}.assets`),
1737
+ `${label}.assets`,
1738
+ PROFILE_ASSET_KEYS
1739
+ );
1740
+ if (profile2.artifactBudget !== void 0) {
1741
+ validateArtifactBudget(profile2.artifactBudget, label);
1742
+ }
1743
+ if (profile2.performanceBudget !== void 0) {
1744
+ validatePerformanceBudget(profile2.performanceBudget, label);
1745
+ }
1746
+ }
1747
+ for (const [target, name2] of Object.entries(defaults)) {
1748
+ if (typeof name2 === "string" && !Object.hasOwn(profiles, name2)) {
1749
+ fail(
1750
+ "TN_CONFIG_PROFILE_UNKNOWN",
1751
+ `buildProfiles.defaults.${target} names '${name2}', which is not declared. Declared profiles: ${declared.join(", ")}.`
1752
+ );
1753
+ }
1754
+ }
1755
+ return void 0;
1756
+ }
1757
+ function mergeProfileOverlay(base, overlay) {
1758
+ if (!isRecord(base)) return overlay;
1759
+ const merged = { ...base };
1760
+ for (const [key, value] of Object.entries(overlay)) {
1761
+ const current = merged[key];
1762
+ merged[key] = isRecord(current) && isRecord(value) ? mergeProfileOverlay(current, value) : value;
1763
+ }
1764
+ return merged;
1765
+ }
1766
+ function assertProfileCapReachable(assets, overlay, name) {
1767
+ const overlayTextures = overlay.textures;
1768
+ const overlayModels = overlay.models;
1769
+ const caps = isRecord(overlayTextures) && overlayTextures.maxSize !== void 0 || isRecord(overlayModels) && isRecord(overlayModels.textures) && overlayModels.textures.maxSize !== void 0;
1770
+ if (!caps) return;
1771
+ const conflicts = [];
1772
+ if (assets.textures !== void 0 && assets.textures !== "none") {
1773
+ for (const override of assets.textures.overrides ?? []) {
1774
+ if (override.codec === "none") {
1775
+ conflicts.push(`assets.textures.overrides glob '${override.glob}' declares codec "none"`);
1776
+ }
1777
+ }
1778
+ }
1779
+ const models = assets.models;
1780
+ const modelTextures = models === void 0 || models === "none" ? void 0 : models.textures;
1781
+ if (modelTextures !== void 0 && modelTextures !== "none") {
1782
+ for (const override of modelTextures.overrides ?? []) {
1783
+ if (override.codec === "none") {
1784
+ conflicts.push(
1785
+ `assets.models.textures.overrides slot '${override.slot}' declares codec "none"`
1786
+ );
1787
+ }
1788
+ }
1789
+ }
1790
+ if (conflicts.length > 0) {
1791
+ fail(
1792
+ "TN_CONFIG_PROFILE_CONFLICT",
1793
+ `profile '${name}' caps texture size, and ${conflicts.join("; ")}, which returns the authored bytes before resizing. Drop the override, or take the cap out of the profile.`
1794
+ );
1795
+ }
1796
+ }
1797
+ async function loadConfigInternal(root, selection) {
1592
1798
  const packagePath = path5.join(root, "package.json");
1593
1799
  const sourcePath = path5.join(root, CONFIG_FILE);
1594
1800
  const manifest = await withConfigContext(
@@ -1621,7 +1827,8 @@ async function loadConfigInternal(root) {
1621
1827
  "nativeEntry",
1622
1828
  "renderer",
1623
1829
  "ui",
1624
- "assets"
1830
+ "assets",
1831
+ "buildProfiles"
1625
1832
  ]);
1626
1833
  }
1627
1834
  const configuredEntry = raw?.nativeEntry;
@@ -1633,7 +1840,12 @@ async function loadConfigInternal(root) {
1633
1840
  }
1634
1841
  const app = await validateApp(raw?.app, name, root);
1635
1842
  const bootSplash = await validateBootSplash(raw?.bootSplash, root);
1636
- const assets = raw?.assets === void 0 ? void 0 : validateAssets(raw.assets);
1843
+ const profile = resolveBuildProfile(raw?.buildProfiles, selection);
1844
+ const rawAssets = profile === void 0 ? raw?.assets : mergeProfileOverlay(raw?.assets, profile.assets);
1845
+ const assets = rawAssets === void 0 ? void 0 : validateAssets(rawAssets);
1846
+ if (assets !== void 0 && profile !== void 0) {
1847
+ assertProfileCapReachable(assets, profile.assets, profile.name);
1848
+ }
1637
1849
  return {
1638
1850
  app,
1639
1851
  display: validateDisplay(raw?.display),
@@ -1642,17 +1854,26 @@ async function loadConfigInternal(root) {
1642
1854
  renderer: validateRenderer(raw?.renderer),
1643
1855
  ui: validateUi(raw?.ui),
1644
1856
  ...bootSplash === void 0 ? {} : { bootSplash },
1645
- ...assets === void 0 ? {} : { assets }
1857
+ ...assets === void 0 ? {} : { assets },
1858
+ ...profile === void 0 ? {} : {
1859
+ buildProfile: {
1860
+ name: profile.name,
1861
+ source: profile.source,
1862
+ target: profile.target,
1863
+ ...profile.artifactBudget === void 0 ? {} : { artifactBudget: profile.artifactBudget },
1864
+ ...profile.performanceBudget === void 0 ? {} : { performanceBudget: profile.performanceBudget }
1865
+ }
1866
+ }
1646
1867
  };
1647
1868
  }
1648
1869
  );
1649
1870
  }
1650
- async function loadConfig(cwd) {
1871
+ async function loadConfig(cwd, selection) {
1651
1872
  const root = path5.resolve(cwd);
1652
1873
  return withConfigContext(
1653
1874
  validationContext(root, [path5.join(root, CONFIG_FILE), path5.join(root, "package.json")]),
1654
1875
  "TN_CONFIG_VALIDATION_FAILED",
1655
- () => loadConfigInternal(root)
1876
+ () => loadConfigInternal(root, selection)
1656
1877
  );
1657
1878
  }
1658
1879
 
@@ -1865,6 +2086,26 @@ async function copyTemplateIcon(target, templateRootDirectory) {
1865
2086
  await mkdir(path5.dirname(destination), { recursive: true });
1866
2087
  await cp(source, destination, { errorOnExist: true, force: false });
1867
2088
  }
2089
+ async function copySharedAssets(target, templateRootDirectory) {
2090
+ const shared = path5.join(path5.dirname(templateRootDirectory), "template-assets", "assets");
2091
+ if (!existsSync(shared)) return;
2092
+ const source = path5.join(target, "src");
2093
+ const texts = [];
2094
+ const walk = async (directory) => {
2095
+ for (const entry of await readdir(directory, { withFileTypes: true })) {
2096
+ const file = path5.join(directory, entry.name);
2097
+ if (entry.isDirectory()) await walk(file);
2098
+ else if (/\.(?:ts|tsx)$/u.test(entry.name)) texts.push(await readFile(file, "utf8"));
2099
+ }
2100
+ };
2101
+ if (existsSync(source)) await walk(source);
2102
+ for (const name of readdirSync(shared)) {
2103
+ if (!texts.some((text) => text.includes(`"${name}"`))) continue;
2104
+ const destination = path5.join(target, "assets", name);
2105
+ await mkdir(path5.dirname(destination), { recursive: true });
2106
+ await cp(path5.join(shared, name), destination, { errorOnExist: true, force: false });
2107
+ }
2108
+ }
1868
2109
  function invalidManifest(file, reason) {
1869
2110
  throw new Error(`TN_KIT_MANIFEST_INVALID: ${file}: ${reason}`);
1870
2111
  }
@@ -1994,7 +2235,7 @@ async function renderTemplate(directory, replacements) {
1994
2235
  await writeFile(source, rendered);
1995
2236
  }
1996
2237
  }
1997
- var REFERENCE_BUNDLE_DIRECTORY = "agent-docs";
2238
+ var REFERENCE_BUNDLE_PREFIX = "node_modules/create-threenative/agent-docs/references/";
1998
2239
  var REFERENCE_FILE_NAME = /^[a-z0-9][a-z0-9-]*\.md$/u;
1999
2240
  var AGENT_FILES_DIRECTORY = "agent-files";
2000
2241
  var AUTHORING_GITIGNORE_RULES = [
@@ -2003,29 +2244,35 @@ var AUTHORING_GITIGNORE_RULES = [
2003
2244
  "node_modules/",
2004
2245
  ".env",
2005
2246
  ".env.*",
2006
- "!.env.example"
2247
+ "!.env.example",
2248
+ // The asset pipeline's compiled outputs: any project with an assets/ folder gets them in public/
2249
+ // on its first dev run or build. Hand-owned public files (favicon, icons) stay committed.
2250
+ "public/assets.manifest.json",
2251
+ "public/bake.receipt.json",
2252
+ "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].*"
2007
2253
  ];
2008
- var REFERENCE_TOKEN_PATTERN = /`agent-docs\/([a-z0-9][a-z0-9./-]*\.md)`|\[[^\]]*\]\(agent-docs\/([^)#]+\.md)\)/gu;
2009
- async function copyReferenceBundle(target, templateRootDirectory, replacements) {
2010
- const bundle = path5.join(
2011
- path5.dirname(templateRootDirectory),
2012
- REFERENCE_BUNDLE_DIRECTORY,
2013
- "references"
2014
- );
2015
- if (!existsSync(bundle)) return;
2016
- const destination = path5.join(target, REFERENCE_BUNDLE_DIRECTORY);
2017
- await mkdir(destination, { recursive: true });
2018
- for (const entry of await readdir(bundle, { withFileTypes: true })) {
2019
- if (!entry.isFile() || !REFERENCE_FILE_NAME.test(entry.name)) continue;
2020
- const content = substituteTemplateVariables(
2021
- await readFile(path5.join(bundle, entry.name), "utf8"),
2022
- replacements
2023
- );
2024
- const destinationPath = path5.join(destination, entry.name);
2025
- if (path5.relative(target, destinationPath).startsWith("..")) {
2026
- throw new Error(`Reference page '${entry.name}' resolves outside '${target}'.`);
2254
+ var REFERENCE_TOKEN_PATTERN = new RegExp(
2255
+ `\`${REFERENCE_BUNDLE_PREFIX}([a-z0-9][a-z0-9./-]*\\.md)\`|\\[[^\\]]*\\]\\(${REFERENCE_BUNDLE_PREFIX}([^)#]+\\.md)\\)`,
2256
+ "gu"
2257
+ );
2258
+ async function linkClaudeSkills(target) {
2259
+ const stored = path5.join(target, ".agents", "skills");
2260
+ if (!existsSync(stored)) return;
2261
+ const hostSkills = path5.join(target, ".claude", "skills");
2262
+ const subagents = path5.join(target, ".claude", "agents");
2263
+ await mkdir(hostSkills, { recursive: true });
2264
+ for (const entry of await readdir(stored, { withFileTypes: true })) {
2265
+ if (!entry.isDirectory()) continue;
2266
+ if (existsSync(path5.join(subagents, `${entry.name}.md`))) continue;
2267
+ const link = path5.join(hostSkills, entry.name);
2268
+ const relative = path5.relative(hostSkills, path5.join(stored, entry.name));
2269
+ try {
2270
+ await symlink(relative, link, "dir");
2271
+ } catch (error) {
2272
+ const code = error.code;
2273
+ if (code !== "EPERM" && code !== "EACCES") throw error;
2274
+ await cp(path5.join(stored, entry.name), link, { recursive: true });
2027
2275
  }
2028
- await writeFile(destinationPath, content);
2029
2276
  }
2030
2277
  }
2031
2278
  async function copyAgentFiles(target, templateRootDirectory) {
@@ -2036,6 +2283,7 @@ async function copyAgentFiles(target, templateRootDirectory) {
2036
2283
  );
2037
2284
  }
2038
2285
  await cp(source, target, { recursive: true });
2286
+ await linkClaudeSkills(target);
2039
2287
  }
2040
2288
  async function installAuthoringGitignore(target) {
2041
2289
  const file = path5.join(target, ".gitignore");
@@ -2051,7 +2299,12 @@ async function installAuthoringGitignore(target) {
2051
2299
  `
2052
2300
  );
2053
2301
  }
2054
- async function assertReferenceBundle(target) {
2302
+ async function assertReferenceBundle(target, templateRootDirectory) {
2303
+ const bundleDirectory = path5.join(
2304
+ path5.dirname(templateRootDirectory),
2305
+ "agent-docs",
2306
+ "references"
2307
+ );
2055
2308
  for (const file of [
2056
2309
  "AGENTS.md",
2057
2310
  "CLAUDE.md",
@@ -2061,10 +2314,10 @@ async function assertReferenceBundle(target) {
2061
2314
  ".claude/skills/threenative-assets/SKILL.md"
2062
2315
  ]) {
2063
2316
  const filePath = path5.join(target, file);
2064
- if (existsSync(filePath)) await assertReferenceTargets(target, file, filePath);
2317
+ if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
2065
2318
  }
2066
2319
  }
2067
- async function assertReferenceTargets(target, from, filePath) {
2320
+ async function assertReferenceTargets(from, filePath, bundleDirectory) {
2068
2321
  const content = await readFile(filePath, "utf8");
2069
2322
  for (const match of content.matchAll(REFERENCE_TOKEN_PATTERN)) {
2070
2323
  const referenced = match[1] ?? match[2];
@@ -2074,10 +2327,9 @@ async function assertReferenceTargets(target, from, filePath) {
2074
2327
  `RED observed: referenced recipe missing: '${from}' names '${referenced}', which is not a shipped reference page.`
2075
2328
  );
2076
2329
  }
2077
- const resolved = path5.join(target, REFERENCE_BUNDLE_DIRECTORY, referenced);
2078
- if (!existsSync(resolved)) {
2330
+ if (!existsSync(path5.join(bundleDirectory, referenced))) {
2079
2331
  throw new Error(
2080
- `RED observed: referenced recipe missing: '${from}' links 'agent-docs/${referenced}', which the scaffold did not copy.`
2332
+ `RED observed: referenced recipe missing: '${from}' links '${REFERENCE_BUNDLE_PREFIX}${referenced}', which the package does not ship.`
2081
2333
  );
2082
2334
  }
2083
2335
  }
@@ -2110,27 +2362,20 @@ async function applyPackageSources(target, packageSources) {
2110
2362
  await writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}
2111
2363
  `);
2112
2364
  }
2113
- async function copyCapabilityManifest(target, templateRootDirectory) {
2114
- const source = path5.join(path5.dirname(templateRootDirectory), "capabilities.json");
2115
- if (!existsSync(source)) {
2116
- throw new Error(
2117
- `TN_KIT_CAPABILITIES_MISSING: '${source}' is not in the package; the generated project needs the capability manifest for its agent tooling.`
2118
- );
2119
- }
2120
- await cp(source, path5.join(target, "capabilities.json"));
2121
- }
2122
2365
  var FRAMEWORK_PATCH_DIRECTORY = "patches";
2123
2366
  var THREE_PATCH_NAME = "three@0.185.1.patch";
2124
2367
  async function copyFrameworkPatches(target, templateRootDirectory) {
2125
- const source = path5.join(
2126
- path5.dirname(templateRootDirectory),
2127
- "template-assets",
2128
- FRAMEWORK_PATCH_DIRECTORY,
2129
- THREE_PATCH_NAME
2368
+ const packageRoot = path5.dirname(templateRoot());
2369
+ const candidates = [.../* @__PURE__ */ new Set([path5.dirname(templateRootDirectory), packageRoot])].map(
2370
+ (root) => path5.join(root, "template-assets", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
2130
2371
  );
2131
- if (!existsSync(source)) {
2372
+ candidates.push(
2373
+ path5.join(packageRoot, "..", "core", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
2374
+ );
2375
+ const source = candidates.find((candidate) => existsSync(candidate));
2376
+ if (source === void 0) {
2132
2377
  throw new Error(
2133
- `TN_FRAMEWORK_PATCH_MISSING: '${source}' is not in the package; the generated project needs the Three.js velocity patch for batched temporal history.`
2378
+ `TN_FRAMEWORK_PATCH_MISSING: none of ${candidates.map((candidate) => `'${candidate}'`).join(", ")} exists; the generated project needs the Three.js velocity patch for batched temporal history.`
2134
2379
  );
2135
2380
  }
2136
2381
  const destination = path5.join(target, FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME);
@@ -2226,6 +2471,7 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2226
2471
  const source = path5.join(root, template);
2227
2472
  await cp(source, target, { recursive: true, errorOnExist: true });
2228
2473
  await copyTemplateIcon(target, root);
2474
+ await copySharedAssets(target, root);
2229
2475
  if (existsSync(path5.join(target, "gitignore"))) {
2230
2476
  await rename(path5.join(target, "gitignore"), path5.join(target, ".gitignore"));
2231
2477
  }
@@ -2240,12 +2486,10 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2240
2486
  await stampTemplateLoading(target, source, root);
2241
2487
  await copyAgentFiles(target, root);
2242
2488
  await renderTemplate(target, replacements);
2243
- await copyReferenceBundle(target, root, replacements);
2244
- await copyCapabilityManifest(target, root);
2245
2489
  await copyFrameworkPatches(target, root);
2246
2490
  await applyPackageSources(target, options.packageSources);
2247
2491
  await assertMcpConfig(target);
2248
- await assertReferenceBundle(target);
2492
+ await assertReferenceBundle(target, root);
2249
2493
  const installed = options.install ?? true;
2250
2494
  if (installed) await runInstall(target);
2251
2495
  return { installed, target, template };