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.
- package/README.md +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /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,
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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 =
|
|
2009
|
-
|
|
2010
|
-
|
|
2011
|
-
|
|
2012
|
-
|
|
2013
|
-
|
|
2014
|
-
);
|
|
2015
|
-
|
|
2016
|
-
const
|
|
2017
|
-
await mkdir(
|
|
2018
|
-
for (const entry of await readdir(
|
|
2019
|
-
if (!entry.
|
|
2020
|
-
|
|
2021
|
-
|
|
2022
|
-
|
|
2023
|
-
|
|
2024
|
-
|
|
2025
|
-
|
|
2026
|
-
|
|
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(
|
|
2312
|
+
if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
|
|
2065
2313
|
}
|
|
2066
2314
|
}
|
|
2067
|
-
async function assertReferenceTargets(
|
|
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
|
-
|
|
2078
|
-
if (!existsSync(resolved)) {
|
|
2325
|
+
if (!existsSync(path5.join(bundleDirectory, referenced))) {
|
|
2079
2326
|
throw new Error(
|
|
2080
|
-
`RED observed: referenced recipe missing: '${from}' links '
|
|
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
|
|
2126
|
-
|
|
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
|
-
|
|
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: '${
|
|
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 };
|