create-threenative 0.2.6 → 0.2.7

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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  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 +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  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/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /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 = [
@@ -2005,27 +2246,28 @@ var AUTHORING_GITIGNORE_RULES = [
2005
2246
  ".env.*",
2006
2247
  "!.env.example"
2007
2248
  ];
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}'.`);
2249
+ var REFERENCE_TOKEN_PATTERN = new RegExp(
2250
+ `\`${REFERENCE_BUNDLE_PREFIX}([a-z0-9][a-z0-9./-]*\\.md)\`|\\[[^\\]]*\\]\\(${REFERENCE_BUNDLE_PREFIX}([^)#]+\\.md)\\)`,
2251
+ "gu"
2252
+ );
2253
+ async function linkClaudeSkills(target) {
2254
+ const stored = path5.join(target, ".agents", "skills");
2255
+ if (!existsSync(stored)) return;
2256
+ const hostSkills = path5.join(target, ".claude", "skills");
2257
+ const subagents = path5.join(target, ".claude", "agents");
2258
+ await mkdir(hostSkills, { recursive: true });
2259
+ for (const entry of await readdir(stored, { withFileTypes: true })) {
2260
+ if (!entry.isDirectory()) continue;
2261
+ if (existsSync(path5.join(subagents, `${entry.name}.md`))) continue;
2262
+ const link = path5.join(hostSkills, entry.name);
2263
+ const relative = path5.relative(hostSkills, path5.join(stored, entry.name));
2264
+ try {
2265
+ await symlink(relative, link, "dir");
2266
+ } catch (error) {
2267
+ const code = error.code;
2268
+ if (code !== "EPERM" && code !== "EACCES") throw error;
2269
+ await cp(path5.join(stored, entry.name), link, { recursive: true });
2027
2270
  }
2028
- await writeFile(destinationPath, content);
2029
2271
  }
2030
2272
  }
2031
2273
  async function copyAgentFiles(target, templateRootDirectory) {
@@ -2036,6 +2278,7 @@ async function copyAgentFiles(target, templateRootDirectory) {
2036
2278
  );
2037
2279
  }
2038
2280
  await cp(source, target, { recursive: true });
2281
+ await linkClaudeSkills(target);
2039
2282
  }
2040
2283
  async function installAuthoringGitignore(target) {
2041
2284
  const file = path5.join(target, ".gitignore");
@@ -2051,7 +2294,12 @@ async function installAuthoringGitignore(target) {
2051
2294
  `
2052
2295
  );
2053
2296
  }
2054
- async function assertReferenceBundle(target) {
2297
+ async function assertReferenceBundle(target, templateRootDirectory) {
2298
+ const bundleDirectory = path5.join(
2299
+ path5.dirname(templateRootDirectory),
2300
+ "agent-docs",
2301
+ "references"
2302
+ );
2055
2303
  for (const file of [
2056
2304
  "AGENTS.md",
2057
2305
  "CLAUDE.md",
@@ -2061,10 +2309,10 @@ async function assertReferenceBundle(target) {
2061
2309
  ".claude/skills/threenative-assets/SKILL.md"
2062
2310
  ]) {
2063
2311
  const filePath = path5.join(target, file);
2064
- if (existsSync(filePath)) await assertReferenceTargets(target, file, filePath);
2312
+ if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
2065
2313
  }
2066
2314
  }
2067
- async function assertReferenceTargets(target, from, filePath) {
2315
+ async function assertReferenceTargets(from, filePath, bundleDirectory) {
2068
2316
  const content = await readFile(filePath, "utf8");
2069
2317
  for (const match of content.matchAll(REFERENCE_TOKEN_PATTERN)) {
2070
2318
  const referenced = match[1] ?? match[2];
@@ -2074,10 +2322,9 @@ async function assertReferenceTargets(target, from, filePath) {
2074
2322
  `RED observed: referenced recipe missing: '${from}' names '${referenced}', which is not a shipped reference page.`
2075
2323
  );
2076
2324
  }
2077
- const resolved = path5.join(target, REFERENCE_BUNDLE_DIRECTORY, referenced);
2078
- if (!existsSync(resolved)) {
2325
+ if (!existsSync(path5.join(bundleDirectory, referenced))) {
2079
2326
  throw new Error(
2080
- `RED observed: referenced recipe missing: '${from}' links 'agent-docs/${referenced}', which the scaffold did not copy.`
2327
+ `RED observed: referenced recipe missing: '${from}' links '${REFERENCE_BUNDLE_PREFIX}${referenced}', which the package does not ship.`
2081
2328
  );
2082
2329
  }
2083
2330
  }
@@ -2110,27 +2357,20 @@ async function applyPackageSources(target, packageSources) {
2110
2357
  await writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}
2111
2358
  `);
2112
2359
  }
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
2360
  var FRAMEWORK_PATCH_DIRECTORY = "patches";
2123
2361
  var THREE_PATCH_NAME = "three@0.185.1.patch";
2124
2362
  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
2363
+ const packageRoot = path5.dirname(templateRoot());
2364
+ const candidates = [.../* @__PURE__ */ new Set([path5.dirname(templateRootDirectory), packageRoot])].map(
2365
+ (root) => path5.join(root, "template-assets", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
2130
2366
  );
2131
- if (!existsSync(source)) {
2367
+ candidates.push(
2368
+ path5.join(packageRoot, "..", "core", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
2369
+ );
2370
+ const source = candidates.find((candidate) => existsSync(candidate));
2371
+ if (source === void 0) {
2132
2372
  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.`
2373
+ `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
2374
  );
2135
2375
  }
2136
2376
  const destination = path5.join(target, FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME);
@@ -2226,6 +2466,7 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2226
2466
  const source = path5.join(root, template);
2227
2467
  await cp(source, target, { recursive: true, errorOnExist: true });
2228
2468
  await copyTemplateIcon(target, root);
2469
+ await copySharedAssets(target, root);
2229
2470
  if (existsSync(path5.join(target, "gitignore"))) {
2230
2471
  await rename(path5.join(target, "gitignore"), path5.join(target, ".gitignore"));
2231
2472
  }
@@ -2240,12 +2481,10 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2240
2481
  await stampTemplateLoading(target, source, root);
2241
2482
  await copyAgentFiles(target, root);
2242
2483
  await renderTemplate(target, replacements);
2243
- await copyReferenceBundle(target, root, replacements);
2244
- await copyCapabilityManifest(target, root);
2245
2484
  await copyFrameworkPatches(target, root);
2246
2485
  await applyPackageSources(target, options.packageSources);
2247
2486
  await assertMcpConfig(target);
2248
- await assertReferenceBundle(target);
2487
+ await assertReferenceBundle(target, root);
2249
2488
  const installed = options.install ?? true;
2250
2489
  if (installed) await runInstall(target);
2251
2490
  return { installed, target, template };