create-threenative 0.2.5 → 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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
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);
@@ -391,6 +391,11 @@ function serverEntryPath(server) {
391
391
  }
392
392
  return entry;
393
393
  }
394
+ var DECODER_LOADER_ID = /[/\\]examples[/\\]jsm[/\\]loaders[/\\](?:KTX2Loader|DRACOLoader)\.js$/u;
395
+ var DECODER_LIB_ASSET_URL = /new URL\(\s*(['"])\.\.\/libs\/([^'"]+)\1\s*,\s*import\.meta\.url\s*\)(?:\.toString\s*\(\s*\)|\.href\s*)?/gu;
396
+ function rewriteDecoderAssetUrls(code) {
397
+ return code.replace(DECODER_LIB_ASSET_URL, '"../libs/$2"');
398
+ }
394
399
  var MARKER_RELATIVE = path5.join("node_modules", ".vite", "threenative-engine-build.json");
395
400
  function hashTree(hash, directory) {
396
401
  const entries = readdirSync(directory, { withFileTypes: true }).sort(
@@ -475,6 +480,11 @@ function createEngineFreshnessPlugin() {
475
480
  }
476
481
  return { resolve, optimizeDeps: { force: true } };
477
482
  },
483
+ transform(code, id) {
484
+ if (!DECODER_LOADER_ID.test(id)) return null;
485
+ const rewritten = rewriteDecoderAssetUrls(code);
486
+ return rewritten === code ? null : { code: rewritten, map: null };
487
+ },
478
488
  configureServer(server) {
479
489
  const root = rootOf(server.config);
480
490
  const file = markerPath(root);
@@ -1059,7 +1069,7 @@ var UI_RENDERERS = ["native", "web"];
1059
1069
  function validateUi(raw) {
1060
1070
  const ui = assertRecord(raw, "ui");
1061
1071
  assertKeys(ui, "ui", ["renderer"]);
1062
- const renderer = ui.renderer === void 0 ? "native" : ui.renderer;
1072
+ const renderer = ui.renderer === void 0 ? "web" : ui.renderer;
1063
1073
  if (typeof renderer !== "string" || !UI_RENDERERS.includes(renderer)) {
1064
1074
  fail("TN_CONFIG_UI_RENDERER_INVALID", "ui.renderer must be web or native.");
1065
1075
  }
@@ -1072,6 +1082,9 @@ function validateRenderer(raw) {
1072
1082
  "resolutionScale",
1073
1083
  "antialias",
1074
1084
  "alphaAntialiasing",
1085
+ "projection",
1086
+ "minimumProjectedPixels",
1087
+ "matrixWorld",
1075
1088
  "android"
1076
1089
  ]);
1077
1090
  const android = assertRecord(renderer.android, "renderer.android");
@@ -1100,6 +1113,15 @@ function validateRenderer(raw) {
1100
1113
  android.alphaAntialiasing,
1101
1114
  "renderer.android.alphaAntialiasing"
1102
1115
  );
1116
+ const projection = booleanOrUndefined(renderer.projection, "renderer.projection");
1117
+ const minimumProjectedPixels = numberOrFalse(
1118
+ renderer.minimumProjectedPixels,
1119
+ "renderer.minimumProjectedPixels"
1120
+ );
1121
+ const matrixWorld = renderer.matrixWorld;
1122
+ if (matrixWorld !== void 0 && matrixWorld !== "visible" && matrixWorld !== "all") {
1123
+ fail("TN_CONFIG_RENDERER_INVALID", 'renderer.matrixWorld must be "visible" or "all".');
1124
+ }
1103
1125
  const androidOverrides = {
1104
1126
  ...androidResolutionScale === void 0 ? {} : { resolutionScale: androidResolutionScale },
1105
1127
  ...androidAntialias === void 0 ? {} : { antialias: androidAntialias },
@@ -1114,6 +1136,9 @@ function validateRenderer(raw) {
1114
1136
  ),
1115
1137
  ...antialias === void 0 ? {} : { antialias },
1116
1138
  ...alphaAntialiasing === void 0 ? {} : { alphaAntialiasing },
1139
+ ...projection === void 0 ? {} : { projection },
1140
+ ...minimumProjectedPixels === void 0 ? {} : { minimumProjectedPixels },
1141
+ ...matrixWorld === void 0 ? {} : { matrixWorld },
1117
1142
  ...resolutionScale === void 0 ? {} : { resolutionScale },
1118
1143
  ...Object.keys(androidOverrides).length === 0 ? {} : { android: androidOverrides }
1119
1144
  };
@@ -1123,6 +1148,13 @@ function booleanOrUndefined(value, name) {
1123
1148
  if (typeof value !== "boolean") fail("TN_CONFIG_RENDERER_INVALID", `${name} must be a boolean.`);
1124
1149
  return value;
1125
1150
  }
1151
+ function numberOrFalse(value, name) {
1152
+ if (value === void 0 || value === false) return value;
1153
+ if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
1154
+ fail("TN_CONFIG_RENDERER_INVALID", `${name} must be false or a positive finite number.`);
1155
+ }
1156
+ return value;
1157
+ }
1126
1158
  var ASSET_TARGET_KEYS = [
1127
1159
  "maxMaterials",
1128
1160
  "maxTriangles",
@@ -1240,6 +1272,7 @@ function validateModels(raw) {
1240
1272
  if (raw === "none") return "none";
1241
1273
  const models = assertRecord(raw, "assets.models");
1242
1274
  assertKeys(models, "assets.models", [
1275
+ "compact",
1243
1276
  "lightmap",
1244
1277
  "passes",
1245
1278
  "quantize",
@@ -1303,6 +1336,7 @@ function validateModels(raw) {
1303
1336
  }
1304
1337
  const simplify = models.simplify;
1305
1338
  const textures = models.textures;
1339
+ const compact = models.compact;
1306
1340
  let virtual;
1307
1341
  if (models.virtual === "none") {
1308
1342
  virtual = "none";
@@ -1332,6 +1366,7 @@ function validateModels(raw) {
1332
1366
  virtual = bake;
1333
1367
  }
1334
1368
  return {
1369
+ ...compact === void 0 ? {} : { compact },
1335
1370
  ...lightmap === void 0 ? {} : { lightmap },
1336
1371
  ...passes === void 0 || Object.keys(passes).length === 0 ? {} : { passes },
1337
1372
  ...quantize === void 0 || Object.keys(quantize).length === 0 ? {} : { quantize },
@@ -1341,6 +1376,156 @@ function validateModels(raw) {
1341
1376
  ...virtual === void 0 ? {} : { virtual }
1342
1377
  };
1343
1378
  }
1379
+ var LOD_PRESETS = ["aggressive", "balanced", "quality"];
1380
+ var LOD_MIN_TRIANGLES_SCOPES = ["primitive", "asset"];
1381
+ var LOD_KEYS = ["enabled", "generation", "overrides", "preset", "runtime"];
1382
+ var LOD_GENERATION_KEYS = [
1383
+ "errorTargets",
1384
+ "join",
1385
+ "maxLevels",
1386
+ "minSaving",
1387
+ "minTriangles",
1388
+ "minTrianglesScope"
1389
+ ];
1390
+ var LOD_RUNTIME_KEYS = ["hysteresis", "maxPixelError"];
1391
+ var LOD_OVERRIDE_KEYS = ["enabled", "generation", "preset", "runtime"];
1392
+ function lodGeneration(raw, label) {
1393
+ const value = assertRecord(raw, label);
1394
+ assertKeys(value, label, LOD_GENERATION_KEYS);
1395
+ const generation = {};
1396
+ if (value.join !== void 0) {
1397
+ if (typeof value.join !== "boolean") {
1398
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.join must be a boolean.`);
1399
+ }
1400
+ generation.join = value.join;
1401
+ }
1402
+ if (value.maxLevels !== void 0) {
1403
+ if (!Number.isSafeInteger(value.maxLevels) || value.maxLevels < 1 || value.maxLevels > 8) {
1404
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.maxLevels must be an integer between 1 and 8.`);
1405
+ }
1406
+ generation.maxLevels = value.maxLevels;
1407
+ }
1408
+ if (value.minTriangles !== void 0) {
1409
+ generation.minTriangles = positiveInteger(
1410
+ value.minTriangles,
1411
+ 1,
1412
+ "TN_CONFIG_ASSETS_INVALID",
1413
+ `${label}.minTriangles`
1414
+ );
1415
+ }
1416
+ if (value.minTrianglesScope !== void 0) {
1417
+ if (typeof value.minTrianglesScope !== "string" || !LOD_MIN_TRIANGLES_SCOPES.includes(value.minTrianglesScope)) {
1418
+ fail(
1419
+ "TN_CONFIG_ASSETS_INVALID",
1420
+ `${label}.minTrianglesScope must be one of ${LOD_MIN_TRIANGLES_SCOPES.join(", ")}.`
1421
+ );
1422
+ }
1423
+ generation.minTrianglesScope = value.minTrianglesScope;
1424
+ }
1425
+ if (value.minSaving !== void 0) {
1426
+ if (typeof value.minSaving !== "number" || !Number.isFinite(value.minSaving) || value.minSaving < 0 || value.minSaving >= 1) {
1427
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.minSaving must be a finite number in [0, 1).`);
1428
+ }
1429
+ generation.minSaving = value.minSaving;
1430
+ }
1431
+ if (value.errorTargets !== void 0) {
1432
+ const targets = value.errorTargets;
1433
+ if (!Array.isArray(targets) || targets.length === 0 || targets.length > 16) {
1434
+ fail(
1435
+ "TN_CONFIG_ASSETS_INVALID",
1436
+ `${label}.errorTargets must be 1 to 16 geometric-error targets.`
1437
+ );
1438
+ }
1439
+ let previous = -1;
1440
+ for (const target of targets) {
1441
+ if (typeof target !== "number" || !Number.isFinite(target) || target <= 0) {
1442
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.errorTargets must be positive finite numbers.`);
1443
+ }
1444
+ if (target <= previous) {
1445
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.errorTargets must increase strictly.`);
1446
+ }
1447
+ previous = target;
1448
+ }
1449
+ generation.errorTargets = [...targets];
1450
+ }
1451
+ return generation;
1452
+ }
1453
+ function lodRuntime(raw, label) {
1454
+ const value = assertRecord(raw, label);
1455
+ assertKeys(value, label, LOD_RUNTIME_KEYS);
1456
+ const runtime = {};
1457
+ if (value.maxPixelError !== void 0) {
1458
+ if (typeof value.maxPixelError !== "number" || !Number.isFinite(value.maxPixelError) || value.maxPixelError <= 0) {
1459
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.maxPixelError must be a positive finite number.`);
1460
+ }
1461
+ runtime.maxPixelError = value.maxPixelError;
1462
+ }
1463
+ if (value.hysteresis !== void 0) {
1464
+ if (typeof value.hysteresis !== "number" || !Number.isFinite(value.hysteresis) || value.hysteresis < 0 || value.hysteresis >= 0.5) {
1465
+ fail("TN_CONFIG_ASSETS_INVALID", `${label}.hysteresis must be a finite number in [0, 0.5).`);
1466
+ }
1467
+ runtime.hysteresis = value.hysteresis;
1468
+ }
1469
+ return runtime;
1470
+ }
1471
+ function lodPreset(raw, label) {
1472
+ if (typeof raw !== "string" || !LOD_PRESETS.includes(raw)) {
1473
+ fail("TN_CONFIG_ASSETS_INVALID", `${label} must be one of ${LOD_PRESETS.join(", ")}.`);
1474
+ }
1475
+ return raw;
1476
+ }
1477
+ function lodOverride(raw, label) {
1478
+ if (typeof raw === "boolean") return raw;
1479
+ const value = assertRecord(raw, label);
1480
+ assertKeys(value, label, LOD_OVERRIDE_KEYS);
1481
+ return {
1482
+ ...value.enabled === void 0 ? {} : {
1483
+ enabled: booleanValue(
1484
+ value.enabled,
1485
+ true,
1486
+ "TN_CONFIG_ASSETS_INVALID",
1487
+ `${label}.enabled`
1488
+ )
1489
+ },
1490
+ ...value.generation === void 0 ? {} : { generation: lodGeneration(value.generation, `${label}.generation`) },
1491
+ ...value.preset === void 0 ? {} : { preset: lodPreset(value.preset, `${label}.preset`) },
1492
+ ...value.runtime === void 0 ? {} : { runtime: lodRuntime(value.runtime, `${label}.runtime`) }
1493
+ };
1494
+ }
1495
+ function validateLod(raw) {
1496
+ if (typeof raw === "boolean") return raw;
1497
+ const value = assertRecord(raw, "assets.lod");
1498
+ assertKeys(value, "assets.lod", LOD_KEYS);
1499
+ const overrides = {};
1500
+ if (value.overrides !== void 0) {
1501
+ if (!isRecord(value.overrides)) {
1502
+ fail("TN_CONFIG_ASSETS_INVALID", "assets.lod.overrides must be an object.");
1503
+ }
1504
+ for (const [key, entry] of Object.entries(value.overrides)) {
1505
+ if (key.trim() === "") {
1506
+ fail(
1507
+ "TN_CONFIG_ASSETS_INVALID",
1508
+ "assets.lod.overrides keys must be non-empty source asset paths."
1509
+ );
1510
+ }
1511
+ overrides[key] = lodOverride(entry, `assets.lod.overrides['${key}']`);
1512
+ }
1513
+ }
1514
+ return {
1515
+ ...value.enabled === void 0 ? {} : {
1516
+ enabled: booleanValue(
1517
+ value.enabled,
1518
+ true,
1519
+ "TN_CONFIG_ASSETS_INVALID",
1520
+ "assets.lod.enabled"
1521
+ )
1522
+ },
1523
+ ...value.generation === void 0 ? {} : { generation: lodGeneration(value.generation, "assets.lod.generation") },
1524
+ ...Object.keys(overrides).length === 0 ? {} : { overrides },
1525
+ ...value.preset === void 0 ? {} : { preset: lodPreset(value.preset, "assets.lod.preset") },
1526
+ ...value.runtime === void 0 ? {} : { runtime: lodRuntime(value.runtime, "assets.lod.runtime") }
1527
+ };
1528
+ }
1344
1529
  function validateBudget(raw) {
1345
1530
  const limit = (value) => value === "none" || typeof value === "number" && Number.isSafeInteger(value) && value > 0;
1346
1531
  if (limit(raw)) return raw;
@@ -1369,6 +1554,7 @@ function validateAssets(raw) {
1369
1554
  "budget",
1370
1555
  "exclude",
1371
1556
  "concurrency",
1557
+ "lod",
1372
1558
  "models",
1373
1559
  "source",
1374
1560
  "output",
@@ -1376,6 +1562,7 @@ function validateAssets(raw) {
1376
1562
  "textures"
1377
1563
  ]);
1378
1564
  const targets = assets.targets === void 0 ? void 0 : validateAssetTargets(assets.targets);
1565
+ const lod = assets.lod === void 0 ? void 0 : validateLod(assets.lod);
1379
1566
  const models = assets.models === void 0 ? void 0 : validateModels(assets.models);
1380
1567
  const textures = assets.textures === void 0 ? void 0 : validateTextures(assets.textures);
1381
1568
  if (assets.exclude !== void 0 && (!Array.isArray(assets.exclude) || assets.exclude.some((glob) => typeof glob !== "string" || glob.trim() === ""))) {
@@ -1399,11 +1586,215 @@ function validateAssets(raw) {
1399
1586
  ...assets.source === void 0 ? {} : { source: nonEmptyString(assets.source, "TN_CONFIG_ASSETS_INVALID", "assets.source") },
1400
1587
  ...assets.output === void 0 ? {} : { output: nonEmptyString(assets.output, "TN_CONFIG_ASSETS_INVALID", "assets.output") },
1401
1588
  ...targets === void 0 ? {} : { targets },
1589
+ ...lod === void 0 ? {} : { lod },
1402
1590
  ...models === void 0 ? {} : { models },
1403
1591
  ...textures === void 0 ? {} : { textures }
1404
1592
  };
1405
1593
  }
1406
- 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) {
1407
1798
  const packagePath = path5.join(root, "package.json");
1408
1799
  const sourcePath = path5.join(root, CONFIG_FILE);
1409
1800
  const manifest = await withConfigContext(
@@ -1436,7 +1827,8 @@ async function loadConfigInternal(root) {
1436
1827
  "nativeEntry",
1437
1828
  "renderer",
1438
1829
  "ui",
1439
- "assets"
1830
+ "assets",
1831
+ "buildProfiles"
1440
1832
  ]);
1441
1833
  }
1442
1834
  const configuredEntry = raw?.nativeEntry;
@@ -1448,7 +1840,12 @@ async function loadConfigInternal(root) {
1448
1840
  }
1449
1841
  const app = await validateApp(raw?.app, name, root);
1450
1842
  const bootSplash = await validateBootSplash(raw?.bootSplash, root);
1451
- 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
+ }
1452
1849
  return {
1453
1850
  app,
1454
1851
  display: validateDisplay(raw?.display),
@@ -1457,17 +1854,26 @@ async function loadConfigInternal(root) {
1457
1854
  renderer: validateRenderer(raw?.renderer),
1458
1855
  ui: validateUi(raw?.ui),
1459
1856
  ...bootSplash === void 0 ? {} : { bootSplash },
1460
- ...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
+ }
1461
1867
  };
1462
1868
  }
1463
1869
  );
1464
1870
  }
1465
- async function loadConfig(cwd) {
1871
+ async function loadConfig(cwd, selection) {
1466
1872
  const root = path5.resolve(cwd);
1467
1873
  return withConfigContext(
1468
1874
  validationContext(root, [path5.join(root, CONFIG_FILE), path5.join(root, "package.json")]),
1469
1875
  "TN_CONFIG_VALIDATION_FAILED",
1470
- () => loadConfigInternal(root)
1876
+ () => loadConfigInternal(root, selection)
1471
1877
  );
1472
1878
  }
1473
1879
 
@@ -1680,6 +2086,26 @@ async function copyTemplateIcon(target, templateRootDirectory) {
1680
2086
  await mkdir(path5.dirname(destination), { recursive: true });
1681
2087
  await cp(source, destination, { errorOnExist: true, force: false });
1682
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
+ }
1683
2109
  function invalidManifest(file, reason) {
1684
2110
  throw new Error(`TN_KIT_MANIFEST_INVALID: ${file}: ${reason}`);
1685
2111
  }
@@ -1809,7 +2235,7 @@ async function renderTemplate(directory, replacements) {
1809
2235
  await writeFile(source, rendered);
1810
2236
  }
1811
2237
  }
1812
- var REFERENCE_BUNDLE_DIRECTORY = "agent-docs";
2238
+ var REFERENCE_BUNDLE_PREFIX = "node_modules/create-threenative/agent-docs/references/";
1813
2239
  var REFERENCE_FILE_NAME = /^[a-z0-9][a-z0-9-]*\.md$/u;
1814
2240
  var AGENT_FILES_DIRECTORY = "agent-files";
1815
2241
  var AUTHORING_GITIGNORE_RULES = [
@@ -1820,27 +2246,28 @@ var AUTHORING_GITIGNORE_RULES = [
1820
2246
  ".env.*",
1821
2247
  "!.env.example"
1822
2248
  ];
1823
- var REFERENCE_TOKEN_PATTERN = /`agent-docs\/([a-z0-9][a-z0-9./-]*\.md)`|\[[^\]]*\]\(agent-docs\/([^)#]+\.md)\)/gu;
1824
- async function copyReferenceBundle(target, templateRootDirectory, replacements) {
1825
- const bundle = path5.join(
1826
- path5.dirname(templateRootDirectory),
1827
- REFERENCE_BUNDLE_DIRECTORY,
1828
- "references"
1829
- );
1830
- if (!existsSync(bundle)) return;
1831
- const destination = path5.join(target, REFERENCE_BUNDLE_DIRECTORY);
1832
- await mkdir(destination, { recursive: true });
1833
- for (const entry of await readdir(bundle, { withFileTypes: true })) {
1834
- if (!entry.isFile() || !REFERENCE_FILE_NAME.test(entry.name)) continue;
1835
- const content = substituteTemplateVariables(
1836
- await readFile(path5.join(bundle, entry.name), "utf8"),
1837
- replacements
1838
- );
1839
- const destinationPath = path5.join(destination, entry.name);
1840
- if (path5.relative(target, destinationPath).startsWith("..")) {
1841
- 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 });
1842
2270
  }
1843
- await writeFile(destinationPath, content);
1844
2271
  }
1845
2272
  }
1846
2273
  async function copyAgentFiles(target, templateRootDirectory) {
@@ -1851,6 +2278,7 @@ async function copyAgentFiles(target, templateRootDirectory) {
1851
2278
  );
1852
2279
  }
1853
2280
  await cp(source, target, { recursive: true });
2281
+ await linkClaudeSkills(target);
1854
2282
  }
1855
2283
  async function installAuthoringGitignore(target) {
1856
2284
  const file = path5.join(target, ".gitignore");
@@ -1866,7 +2294,12 @@ async function installAuthoringGitignore(target) {
1866
2294
  `
1867
2295
  );
1868
2296
  }
1869
- 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
+ );
1870
2303
  for (const file of [
1871
2304
  "AGENTS.md",
1872
2305
  "CLAUDE.md",
@@ -1876,10 +2309,10 @@ async function assertReferenceBundle(target) {
1876
2309
  ".claude/skills/threenative-assets/SKILL.md"
1877
2310
  ]) {
1878
2311
  const filePath = path5.join(target, file);
1879
- if (existsSync(filePath)) await assertReferenceTargets(target, file, filePath);
2312
+ if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
1880
2313
  }
1881
2314
  }
1882
- async function assertReferenceTargets(target, from, filePath) {
2315
+ async function assertReferenceTargets(from, filePath, bundleDirectory) {
1883
2316
  const content = await readFile(filePath, "utf8");
1884
2317
  for (const match of content.matchAll(REFERENCE_TOKEN_PATTERN)) {
1885
2318
  const referenced = match[1] ?? match[2];
@@ -1889,10 +2322,9 @@ async function assertReferenceTargets(target, from, filePath) {
1889
2322
  `RED observed: referenced recipe missing: '${from}' names '${referenced}', which is not a shipped reference page.`
1890
2323
  );
1891
2324
  }
1892
- const resolved = path5.join(target, REFERENCE_BUNDLE_DIRECTORY, referenced);
1893
- if (!existsSync(resolved)) {
2325
+ if (!existsSync(path5.join(bundleDirectory, referenced))) {
1894
2326
  throw new Error(
1895
- `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.`
1896
2328
  );
1897
2329
  }
1898
2330
  }
@@ -1925,27 +2357,20 @@ async function applyPackageSources(target, packageSources) {
1925
2357
  await writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}
1926
2358
  `);
1927
2359
  }
1928
- async function copyCapabilityManifest(target, templateRootDirectory) {
1929
- const source = path5.join(path5.dirname(templateRootDirectory), "capabilities.json");
1930
- if (!existsSync(source)) {
1931
- throw new Error(
1932
- `TN_KIT_CAPABILITIES_MISSING: '${source}' is not in the package; the generated project needs the capability manifest for its agent tooling.`
1933
- );
1934
- }
1935
- await cp(source, path5.join(target, "capabilities.json"));
1936
- }
1937
2360
  var FRAMEWORK_PATCH_DIRECTORY = "patches";
1938
2361
  var THREE_PATCH_NAME = "three@0.185.1.patch";
1939
2362
  async function copyFrameworkPatches(target, templateRootDirectory) {
1940
- const source = path5.join(
1941
- path5.dirname(templateRootDirectory),
1942
- "template-assets",
1943
- FRAMEWORK_PATCH_DIRECTORY,
1944
- 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)
1945
2366
  );
1946
- 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) {
1947
2372
  throw new Error(
1948
- `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.`
1949
2374
  );
1950
2375
  }
1951
2376
  const destination = path5.join(target, FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME);
@@ -2041,6 +2466,7 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2041
2466
  const source = path5.join(root, template);
2042
2467
  await cp(source, target, { recursive: true, errorOnExist: true });
2043
2468
  await copyTemplateIcon(target, root);
2469
+ await copySharedAssets(target, root);
2044
2470
  if (existsSync(path5.join(target, "gitignore"))) {
2045
2471
  await rename(path5.join(target, "gitignore"), path5.join(target, ".gitignore"));
2046
2472
  }
@@ -2055,12 +2481,10 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
2055
2481
  await stampTemplateLoading(target, source, root);
2056
2482
  await copyAgentFiles(target, root);
2057
2483
  await renderTemplate(target, replacements);
2058
- await copyReferenceBundle(target, root, replacements);
2059
- await copyCapabilityManifest(target, root);
2060
2484
  await copyFrameworkPatches(target, root);
2061
2485
  await applyPackageSources(target, options.packageSources);
2062
2486
  await assertMcpConfig(target);
2063
- await assertReferenceBundle(target);
2487
+ await assertReferenceBundle(target, root);
2064
2488
  const installed = options.install ?? true;
2065
2489
  if (installed) await runInstall(target);
2066
2490
  return { installed, target, template };