create-threenative 0.2.6 → 0.2.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -3
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +607 -26
- 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 +801 -24
- package/dist/index.d.ts +30 -1
- package/dist/index.js +300 -56
- package/dist/threenative.js +717 -156
- 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/rain/AGENTS.md +96 -0
- package/templates/rain/CLAUDE.md +98 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +13 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/package.json +56 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +22 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +179 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +114 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +226 -0
- package/templates/rain/src/render/quality.ts +135 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
- package/templates/rain/src/scenes/Boot.ts +334 -0
- package/templates/rain/src/state.ts +257 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +37 -0
- package/templates/rts/.codex/config.toml +19 -0
- package/templates/rts/.cursor/mcp.json +32 -0
- package/templates/rts/.gemini/settings.json +32 -0
- package/templates/rts/.mcp.json +32 -0
- package/templates/rts/.vscode/mcp.json +36 -0
- package/templates/rts/.zed/settings.json +36 -0
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/rts/opencode.json +41 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/rts/playtests/performance.playtest.json +41 -0
- 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/main.ts +15 -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/rts/src/render/postprocessing.ts +46 -0
- 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/rts/src/render/worldEnvironment.ts +809 -0
- 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/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +88 -0
- package/templates/snow/CLAUDE.md +90 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +58 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/lighting.ts +50 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/{defense → snow}/src/render/quality.ts +37 -72
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +57 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +809 -0
- package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
- package/templates/snow/src/scenes/Snow.ts +635 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +51 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +37 -0
- 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/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/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- 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 → rain}/.codex/config.toml +0 -0
- /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rain}/.gemini/settings.json +0 -0
- /package/templates/{defense → rain}/.mcp.json +0 -0
- /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rain}/.zed/settings.json +0 -0
- /package/templates/{defense → rain}/opencode.json +0 -0
- /package/templates/{defense → rain}/src/main.ts +0 -0
- /package/templates/{defense → rts}/index.html +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 = [
|
|
@@ -2003,29 +2244,35 @@ var AUTHORING_GITIGNORE_RULES = [
|
|
|
2003
2244
|
"node_modules/",
|
|
2004
2245
|
".env",
|
|
2005
2246
|
".env.*",
|
|
2006
|
-
"!.env.example"
|
|
2247
|
+
"!.env.example",
|
|
2248
|
+
// The asset pipeline's compiled outputs: any project with an assets/ folder gets them in public/
|
|
2249
|
+
// on its first dev run or build. Hand-owned public files (favicon, icons) stay committed.
|
|
2250
|
+
"public/assets.manifest.json",
|
|
2251
|
+
"public/bake.receipt.json",
|
|
2252
|
+
"public/*.[0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f][0-9a-f].*"
|
|
2007
2253
|
];
|
|
2008
|
-
var REFERENCE_TOKEN_PATTERN =
|
|
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
|
-
|
|
2254
|
+
var REFERENCE_TOKEN_PATTERN = new RegExp(
|
|
2255
|
+
`\`${REFERENCE_BUNDLE_PREFIX}([a-z0-9][a-z0-9./-]*\\.md)\`|\\[[^\\]]*\\]\\(${REFERENCE_BUNDLE_PREFIX}([^)#]+\\.md)\\)`,
|
|
2256
|
+
"gu"
|
|
2257
|
+
);
|
|
2258
|
+
async function linkClaudeSkills(target) {
|
|
2259
|
+
const stored = path5.join(target, ".agents", "skills");
|
|
2260
|
+
if (!existsSync(stored)) return;
|
|
2261
|
+
const hostSkills = path5.join(target, ".claude", "skills");
|
|
2262
|
+
const subagents = path5.join(target, ".claude", "agents");
|
|
2263
|
+
await mkdir(hostSkills, { recursive: true });
|
|
2264
|
+
for (const entry of await readdir(stored, { withFileTypes: true })) {
|
|
2265
|
+
if (!entry.isDirectory()) continue;
|
|
2266
|
+
if (existsSync(path5.join(subagents, `${entry.name}.md`))) continue;
|
|
2267
|
+
const link = path5.join(hostSkills, entry.name);
|
|
2268
|
+
const relative = path5.relative(hostSkills, path5.join(stored, entry.name));
|
|
2269
|
+
try {
|
|
2270
|
+
await symlink(relative, link, "dir");
|
|
2271
|
+
} catch (error) {
|
|
2272
|
+
const code = error.code;
|
|
2273
|
+
if (code !== "EPERM" && code !== "EACCES") throw error;
|
|
2274
|
+
await cp(path5.join(stored, entry.name), link, { recursive: true });
|
|
2027
2275
|
}
|
|
2028
|
-
await writeFile(destinationPath, content);
|
|
2029
2276
|
}
|
|
2030
2277
|
}
|
|
2031
2278
|
async function copyAgentFiles(target, templateRootDirectory) {
|
|
@@ -2036,6 +2283,7 @@ async function copyAgentFiles(target, templateRootDirectory) {
|
|
|
2036
2283
|
);
|
|
2037
2284
|
}
|
|
2038
2285
|
await cp(source, target, { recursive: true });
|
|
2286
|
+
await linkClaudeSkills(target);
|
|
2039
2287
|
}
|
|
2040
2288
|
async function installAuthoringGitignore(target) {
|
|
2041
2289
|
const file = path5.join(target, ".gitignore");
|
|
@@ -2051,7 +2299,12 @@ async function installAuthoringGitignore(target) {
|
|
|
2051
2299
|
`
|
|
2052
2300
|
);
|
|
2053
2301
|
}
|
|
2054
|
-
async function assertReferenceBundle(target) {
|
|
2302
|
+
async function assertReferenceBundle(target, templateRootDirectory) {
|
|
2303
|
+
const bundleDirectory = path5.join(
|
|
2304
|
+
path5.dirname(templateRootDirectory),
|
|
2305
|
+
"agent-docs",
|
|
2306
|
+
"references"
|
|
2307
|
+
);
|
|
2055
2308
|
for (const file of [
|
|
2056
2309
|
"AGENTS.md",
|
|
2057
2310
|
"CLAUDE.md",
|
|
@@ -2061,10 +2314,10 @@ async function assertReferenceBundle(target) {
|
|
|
2061
2314
|
".claude/skills/threenative-assets/SKILL.md"
|
|
2062
2315
|
]) {
|
|
2063
2316
|
const filePath = path5.join(target, file);
|
|
2064
|
-
if (existsSync(filePath)) await assertReferenceTargets(
|
|
2317
|
+
if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
|
|
2065
2318
|
}
|
|
2066
2319
|
}
|
|
2067
|
-
async function assertReferenceTargets(
|
|
2320
|
+
async function assertReferenceTargets(from, filePath, bundleDirectory) {
|
|
2068
2321
|
const content = await readFile(filePath, "utf8");
|
|
2069
2322
|
for (const match of content.matchAll(REFERENCE_TOKEN_PATTERN)) {
|
|
2070
2323
|
const referenced = match[1] ?? match[2];
|
|
@@ -2074,10 +2327,9 @@ async function assertReferenceTargets(target, from, filePath) {
|
|
|
2074
2327
|
`RED observed: referenced recipe missing: '${from}' names '${referenced}', which is not a shipped reference page.`
|
|
2075
2328
|
);
|
|
2076
2329
|
}
|
|
2077
|
-
|
|
2078
|
-
if (!existsSync(resolved)) {
|
|
2330
|
+
if (!existsSync(path5.join(bundleDirectory, referenced))) {
|
|
2079
2331
|
throw new Error(
|
|
2080
|
-
`RED observed: referenced recipe missing: '${from}' links '
|
|
2332
|
+
`RED observed: referenced recipe missing: '${from}' links '${REFERENCE_BUNDLE_PREFIX}${referenced}', which the package does not ship.`
|
|
2081
2333
|
);
|
|
2082
2334
|
}
|
|
2083
2335
|
}
|
|
@@ -2110,27 +2362,20 @@ async function applyPackageSources(target, packageSources) {
|
|
|
2110
2362
|
await writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}
|
|
2111
2363
|
`);
|
|
2112
2364
|
}
|
|
2113
|
-
async function copyCapabilityManifest(target, templateRootDirectory) {
|
|
2114
|
-
const source = path5.join(path5.dirname(templateRootDirectory), "capabilities.json");
|
|
2115
|
-
if (!existsSync(source)) {
|
|
2116
|
-
throw new Error(
|
|
2117
|
-
`TN_KIT_CAPABILITIES_MISSING: '${source}' is not in the package; the generated project needs the capability manifest for its agent tooling.`
|
|
2118
|
-
);
|
|
2119
|
-
}
|
|
2120
|
-
await cp(source, path5.join(target, "capabilities.json"));
|
|
2121
|
-
}
|
|
2122
2365
|
var FRAMEWORK_PATCH_DIRECTORY = "patches";
|
|
2123
2366
|
var THREE_PATCH_NAME = "three@0.185.1.patch";
|
|
2124
2367
|
async function copyFrameworkPatches(target, templateRootDirectory) {
|
|
2125
|
-
const
|
|
2126
|
-
|
|
2127
|
-
"template-assets",
|
|
2128
|
-
FRAMEWORK_PATCH_DIRECTORY,
|
|
2129
|
-
THREE_PATCH_NAME
|
|
2368
|
+
const packageRoot = path5.dirname(templateRoot());
|
|
2369
|
+
const candidates = [.../* @__PURE__ */ new Set([path5.dirname(templateRootDirectory), packageRoot])].map(
|
|
2370
|
+
(root) => path5.join(root, "template-assets", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
|
|
2130
2371
|
);
|
|
2131
|
-
|
|
2372
|
+
candidates.push(
|
|
2373
|
+
path5.join(packageRoot, "..", "core", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
|
|
2374
|
+
);
|
|
2375
|
+
const source = candidates.find((candidate) => existsSync(candidate));
|
|
2376
|
+
if (source === void 0) {
|
|
2132
2377
|
throw new Error(
|
|
2133
|
-
`TN_FRAMEWORK_PATCH_MISSING: '${
|
|
2378
|
+
`TN_FRAMEWORK_PATCH_MISSING: none of ${candidates.map((candidate) => `'${candidate}'`).join(", ")} exists; the generated project needs the Three.js velocity patch for batched temporal history.`
|
|
2134
2379
|
);
|
|
2135
2380
|
}
|
|
2136
2381
|
const destination = path5.join(target, FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME);
|
|
@@ -2226,6 +2471,7 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
|
|
|
2226
2471
|
const source = path5.join(root, template);
|
|
2227
2472
|
await cp(source, target, { recursive: true, errorOnExist: true });
|
|
2228
2473
|
await copyTemplateIcon(target, root);
|
|
2474
|
+
await copySharedAssets(target, root);
|
|
2229
2475
|
if (existsSync(path5.join(target, "gitignore"))) {
|
|
2230
2476
|
await rename(path5.join(target, "gitignore"), path5.join(target, ".gitignore"));
|
|
2231
2477
|
}
|
|
@@ -2240,12 +2486,10 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
|
|
|
2240
2486
|
await stampTemplateLoading(target, source, root);
|
|
2241
2487
|
await copyAgentFiles(target, root);
|
|
2242
2488
|
await renderTemplate(target, replacements);
|
|
2243
|
-
await copyReferenceBundle(target, root, replacements);
|
|
2244
|
-
await copyCapabilityManifest(target, root);
|
|
2245
2489
|
await copyFrameworkPatches(target, root);
|
|
2246
2490
|
await applyPackageSources(target, options.packageSources);
|
|
2247
2491
|
await assertMcpConfig(target);
|
|
2248
|
-
await assertReferenceBundle(target);
|
|
2492
|
+
await assertReferenceBundle(target, root);
|
|
2249
2493
|
const installed = options.install ?? true;
|
|
2250
2494
|
if (installed) await runInstall(target);
|
|
2251
2495
|
return { installed, target, template };
|