create-threenative 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -3
- package/agent-docs/references/assertion-reference.md +40 -1
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +1382 -65
- package/agent-docs/references/finding-assets.md +8 -1
- package/agent-docs/references/performance-basics.md +117 -0
- package/agent-docs/references/rigging-characters.md +51 -0
- 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-docs/references/webview-ui.md +3 -2
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
- 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/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
- package/agent-files/.claude/settings.json +38 -0
- package/agent-files/.codex/hooks.json +40 -0
- package/capabilities.json +1891 -101
- package/dist/index.d.ts +39 -1
- package/dist/index.js +480 -56
- package/dist/threenative.js +1247 -177
- 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 +2228 -105
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +43 -43
- package/templates/action-rpg/CLAUDE.md +43 -43
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +14 -8
- 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 +12 -12
- package/templates/minimal/CLAUDE.md +12 -12
- package/templates/minimal/package.json +13 -7
- 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 +15 -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 +14 -10
- 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 +21 -22
- package/templates/puzzle/CLAUDE.md +21 -22
- 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 +14 -8
- 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 +20 -21
- package/templates/racing/CLAUDE.md +20 -21
- package/templates/racing/package.json +14 -8
- 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 +14 -8
- 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 +8 -12
- package/templates/runner/CLAUDE.md +8 -12
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +14 -8
- 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 +14 -14
- package/templates/sailing/CLAUDE.md +14 -14
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +14 -8
- 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 +29 -44
- package/templates/shooter/CLAUDE.md +29 -44
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +14 -8
- 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 +20 -20
- package/templates/starter/CLAUDE.md +20 -20
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +15 -9
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
- 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/src/ui/Hud.tsx +2 -2
- package/templates/starter/src/ui/Menu.tsx +5 -1
- 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 +16 -14
- package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
- 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/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
- 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/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.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);
|
|
@@ -391,6 +391,11 @@ function serverEntryPath(server) {
|
|
|
391
391
|
}
|
|
392
392
|
return entry;
|
|
393
393
|
}
|
|
394
|
+
var DECODER_LOADER_ID = /[/\\]examples[/\\]jsm[/\\]loaders[/\\](?:KTX2Loader|DRACOLoader)\.js$/u;
|
|
395
|
+
var DECODER_LIB_ASSET_URL = /new URL\(\s*(['"])\.\.\/libs\/([^'"]+)\1\s*,\s*import\.meta\.url\s*\)(?:\.toString\s*\(\s*\)|\.href\s*)?/gu;
|
|
396
|
+
function rewriteDecoderAssetUrls(code) {
|
|
397
|
+
return code.replace(DECODER_LIB_ASSET_URL, '"../libs/$2"');
|
|
398
|
+
}
|
|
394
399
|
var MARKER_RELATIVE = path5.join("node_modules", ".vite", "threenative-engine-build.json");
|
|
395
400
|
function hashTree(hash, directory) {
|
|
396
401
|
const entries = readdirSync(directory, { withFileTypes: true }).sort(
|
|
@@ -475,6 +480,11 @@ function createEngineFreshnessPlugin() {
|
|
|
475
480
|
}
|
|
476
481
|
return { resolve, optimizeDeps: { force: true } };
|
|
477
482
|
},
|
|
483
|
+
transform(code, id) {
|
|
484
|
+
if (!DECODER_LOADER_ID.test(id)) return null;
|
|
485
|
+
const rewritten = rewriteDecoderAssetUrls(code);
|
|
486
|
+
return rewritten === code ? null : { code: rewritten, map: null };
|
|
487
|
+
},
|
|
478
488
|
configureServer(server) {
|
|
479
489
|
const root = rootOf(server.config);
|
|
480
490
|
const file = markerPath(root);
|
|
@@ -1059,7 +1069,7 @@ var UI_RENDERERS = ["native", "web"];
|
|
|
1059
1069
|
function validateUi(raw) {
|
|
1060
1070
|
const ui = assertRecord(raw, "ui");
|
|
1061
1071
|
assertKeys(ui, "ui", ["renderer"]);
|
|
1062
|
-
const renderer = ui.renderer === void 0 ? "
|
|
1072
|
+
const renderer = ui.renderer === void 0 ? "web" : ui.renderer;
|
|
1063
1073
|
if (typeof renderer !== "string" || !UI_RENDERERS.includes(renderer)) {
|
|
1064
1074
|
fail("TN_CONFIG_UI_RENDERER_INVALID", "ui.renderer must be web or native.");
|
|
1065
1075
|
}
|
|
@@ -1072,6 +1082,9 @@ function validateRenderer(raw) {
|
|
|
1072
1082
|
"resolutionScale",
|
|
1073
1083
|
"antialias",
|
|
1074
1084
|
"alphaAntialiasing",
|
|
1085
|
+
"projection",
|
|
1086
|
+
"minimumProjectedPixels",
|
|
1087
|
+
"matrixWorld",
|
|
1075
1088
|
"android"
|
|
1076
1089
|
]);
|
|
1077
1090
|
const android = assertRecord(renderer.android, "renderer.android");
|
|
@@ -1100,6 +1113,15 @@ function validateRenderer(raw) {
|
|
|
1100
1113
|
android.alphaAntialiasing,
|
|
1101
1114
|
"renderer.android.alphaAntialiasing"
|
|
1102
1115
|
);
|
|
1116
|
+
const projection = booleanOrUndefined(renderer.projection, "renderer.projection");
|
|
1117
|
+
const minimumProjectedPixels = numberOrFalse(
|
|
1118
|
+
renderer.minimumProjectedPixels,
|
|
1119
|
+
"renderer.minimumProjectedPixels"
|
|
1120
|
+
);
|
|
1121
|
+
const matrixWorld = renderer.matrixWorld;
|
|
1122
|
+
if (matrixWorld !== void 0 && matrixWorld !== "visible" && matrixWorld !== "all") {
|
|
1123
|
+
fail("TN_CONFIG_RENDERER_INVALID", 'renderer.matrixWorld must be "visible" or "all".');
|
|
1124
|
+
}
|
|
1103
1125
|
const androidOverrides = {
|
|
1104
1126
|
...androidResolutionScale === void 0 ? {} : { resolutionScale: androidResolutionScale },
|
|
1105
1127
|
...androidAntialias === void 0 ? {} : { antialias: androidAntialias },
|
|
@@ -1114,6 +1136,9 @@ function validateRenderer(raw) {
|
|
|
1114
1136
|
),
|
|
1115
1137
|
...antialias === void 0 ? {} : { antialias },
|
|
1116
1138
|
...alphaAntialiasing === void 0 ? {} : { alphaAntialiasing },
|
|
1139
|
+
...projection === void 0 ? {} : { projection },
|
|
1140
|
+
...minimumProjectedPixels === void 0 ? {} : { minimumProjectedPixels },
|
|
1141
|
+
...matrixWorld === void 0 ? {} : { matrixWorld },
|
|
1117
1142
|
...resolutionScale === void 0 ? {} : { resolutionScale },
|
|
1118
1143
|
...Object.keys(androidOverrides).length === 0 ? {} : { android: androidOverrides }
|
|
1119
1144
|
};
|
|
@@ -1123,6 +1148,13 @@ function booleanOrUndefined(value, name) {
|
|
|
1123
1148
|
if (typeof value !== "boolean") fail("TN_CONFIG_RENDERER_INVALID", `${name} must be a boolean.`);
|
|
1124
1149
|
return value;
|
|
1125
1150
|
}
|
|
1151
|
+
function numberOrFalse(value, name) {
|
|
1152
|
+
if (value === void 0 || value === false) return value;
|
|
1153
|
+
if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
|
|
1154
|
+
fail("TN_CONFIG_RENDERER_INVALID", `${name} must be false or a positive finite number.`);
|
|
1155
|
+
}
|
|
1156
|
+
return value;
|
|
1157
|
+
}
|
|
1126
1158
|
var ASSET_TARGET_KEYS = [
|
|
1127
1159
|
"maxMaterials",
|
|
1128
1160
|
"maxTriangles",
|
|
@@ -1240,6 +1272,7 @@ function validateModels(raw) {
|
|
|
1240
1272
|
if (raw === "none") return "none";
|
|
1241
1273
|
const models = assertRecord(raw, "assets.models");
|
|
1242
1274
|
assertKeys(models, "assets.models", [
|
|
1275
|
+
"compact",
|
|
1243
1276
|
"lightmap",
|
|
1244
1277
|
"passes",
|
|
1245
1278
|
"quantize",
|
|
@@ -1303,6 +1336,7 @@ function validateModels(raw) {
|
|
|
1303
1336
|
}
|
|
1304
1337
|
const simplify = models.simplify;
|
|
1305
1338
|
const textures = models.textures;
|
|
1339
|
+
const compact = models.compact;
|
|
1306
1340
|
let virtual;
|
|
1307
1341
|
if (models.virtual === "none") {
|
|
1308
1342
|
virtual = "none";
|
|
@@ -1332,6 +1366,7 @@ function validateModels(raw) {
|
|
|
1332
1366
|
virtual = bake;
|
|
1333
1367
|
}
|
|
1334
1368
|
return {
|
|
1369
|
+
...compact === void 0 ? {} : { compact },
|
|
1335
1370
|
...lightmap === void 0 ? {} : { lightmap },
|
|
1336
1371
|
...passes === void 0 || Object.keys(passes).length === 0 ? {} : { passes },
|
|
1337
1372
|
...quantize === void 0 || Object.keys(quantize).length === 0 ? {} : { quantize },
|
|
@@ -1341,6 +1376,156 @@ function validateModels(raw) {
|
|
|
1341
1376
|
...virtual === void 0 ? {} : { virtual }
|
|
1342
1377
|
};
|
|
1343
1378
|
}
|
|
1379
|
+
var LOD_PRESETS = ["aggressive", "balanced", "quality"];
|
|
1380
|
+
var LOD_MIN_TRIANGLES_SCOPES = ["primitive", "asset"];
|
|
1381
|
+
var LOD_KEYS = ["enabled", "generation", "overrides", "preset", "runtime"];
|
|
1382
|
+
var LOD_GENERATION_KEYS = [
|
|
1383
|
+
"errorTargets",
|
|
1384
|
+
"join",
|
|
1385
|
+
"maxLevels",
|
|
1386
|
+
"minSaving",
|
|
1387
|
+
"minTriangles",
|
|
1388
|
+
"minTrianglesScope"
|
|
1389
|
+
];
|
|
1390
|
+
var LOD_RUNTIME_KEYS = ["hysteresis", "maxPixelError"];
|
|
1391
|
+
var LOD_OVERRIDE_KEYS = ["enabled", "generation", "preset", "runtime"];
|
|
1392
|
+
function lodGeneration(raw, label) {
|
|
1393
|
+
const value = assertRecord(raw, label);
|
|
1394
|
+
assertKeys(value, label, LOD_GENERATION_KEYS);
|
|
1395
|
+
const generation = {};
|
|
1396
|
+
if (value.join !== void 0) {
|
|
1397
|
+
if (typeof value.join !== "boolean") {
|
|
1398
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.join must be a boolean.`);
|
|
1399
|
+
}
|
|
1400
|
+
generation.join = value.join;
|
|
1401
|
+
}
|
|
1402
|
+
if (value.maxLevels !== void 0) {
|
|
1403
|
+
if (!Number.isSafeInteger(value.maxLevels) || value.maxLevels < 1 || value.maxLevels > 8) {
|
|
1404
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.maxLevels must be an integer between 1 and 8.`);
|
|
1405
|
+
}
|
|
1406
|
+
generation.maxLevels = value.maxLevels;
|
|
1407
|
+
}
|
|
1408
|
+
if (value.minTriangles !== void 0) {
|
|
1409
|
+
generation.minTriangles = positiveInteger(
|
|
1410
|
+
value.minTriangles,
|
|
1411
|
+
1,
|
|
1412
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1413
|
+
`${label}.minTriangles`
|
|
1414
|
+
);
|
|
1415
|
+
}
|
|
1416
|
+
if (value.minTrianglesScope !== void 0) {
|
|
1417
|
+
if (typeof value.minTrianglesScope !== "string" || !LOD_MIN_TRIANGLES_SCOPES.includes(value.minTrianglesScope)) {
|
|
1418
|
+
fail(
|
|
1419
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1420
|
+
`${label}.minTrianglesScope must be one of ${LOD_MIN_TRIANGLES_SCOPES.join(", ")}.`
|
|
1421
|
+
);
|
|
1422
|
+
}
|
|
1423
|
+
generation.minTrianglesScope = value.minTrianglesScope;
|
|
1424
|
+
}
|
|
1425
|
+
if (value.minSaving !== void 0) {
|
|
1426
|
+
if (typeof value.minSaving !== "number" || !Number.isFinite(value.minSaving) || value.minSaving < 0 || value.minSaving >= 1) {
|
|
1427
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.minSaving must be a finite number in [0, 1).`);
|
|
1428
|
+
}
|
|
1429
|
+
generation.minSaving = value.minSaving;
|
|
1430
|
+
}
|
|
1431
|
+
if (value.errorTargets !== void 0) {
|
|
1432
|
+
const targets = value.errorTargets;
|
|
1433
|
+
if (!Array.isArray(targets) || targets.length === 0 || targets.length > 16) {
|
|
1434
|
+
fail(
|
|
1435
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1436
|
+
`${label}.errorTargets must be 1 to 16 geometric-error targets.`
|
|
1437
|
+
);
|
|
1438
|
+
}
|
|
1439
|
+
let previous = -1;
|
|
1440
|
+
for (const target of targets) {
|
|
1441
|
+
if (typeof target !== "number" || !Number.isFinite(target) || target <= 0) {
|
|
1442
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.errorTargets must be positive finite numbers.`);
|
|
1443
|
+
}
|
|
1444
|
+
if (target <= previous) {
|
|
1445
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.errorTargets must increase strictly.`);
|
|
1446
|
+
}
|
|
1447
|
+
previous = target;
|
|
1448
|
+
}
|
|
1449
|
+
generation.errorTargets = [...targets];
|
|
1450
|
+
}
|
|
1451
|
+
return generation;
|
|
1452
|
+
}
|
|
1453
|
+
function lodRuntime(raw, label) {
|
|
1454
|
+
const value = assertRecord(raw, label);
|
|
1455
|
+
assertKeys(value, label, LOD_RUNTIME_KEYS);
|
|
1456
|
+
const runtime = {};
|
|
1457
|
+
if (value.maxPixelError !== void 0) {
|
|
1458
|
+
if (typeof value.maxPixelError !== "number" || !Number.isFinite(value.maxPixelError) || value.maxPixelError <= 0) {
|
|
1459
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.maxPixelError must be a positive finite number.`);
|
|
1460
|
+
}
|
|
1461
|
+
runtime.maxPixelError = value.maxPixelError;
|
|
1462
|
+
}
|
|
1463
|
+
if (value.hysteresis !== void 0) {
|
|
1464
|
+
if (typeof value.hysteresis !== "number" || !Number.isFinite(value.hysteresis) || value.hysteresis < 0 || value.hysteresis >= 0.5) {
|
|
1465
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label}.hysteresis must be a finite number in [0, 0.5).`);
|
|
1466
|
+
}
|
|
1467
|
+
runtime.hysteresis = value.hysteresis;
|
|
1468
|
+
}
|
|
1469
|
+
return runtime;
|
|
1470
|
+
}
|
|
1471
|
+
function lodPreset(raw, label) {
|
|
1472
|
+
if (typeof raw !== "string" || !LOD_PRESETS.includes(raw)) {
|
|
1473
|
+
fail("TN_CONFIG_ASSETS_INVALID", `${label} must be one of ${LOD_PRESETS.join(", ")}.`);
|
|
1474
|
+
}
|
|
1475
|
+
return raw;
|
|
1476
|
+
}
|
|
1477
|
+
function lodOverride(raw, label) {
|
|
1478
|
+
if (typeof raw === "boolean") return raw;
|
|
1479
|
+
const value = assertRecord(raw, label);
|
|
1480
|
+
assertKeys(value, label, LOD_OVERRIDE_KEYS);
|
|
1481
|
+
return {
|
|
1482
|
+
...value.enabled === void 0 ? {} : {
|
|
1483
|
+
enabled: booleanValue(
|
|
1484
|
+
value.enabled,
|
|
1485
|
+
true,
|
|
1486
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1487
|
+
`${label}.enabled`
|
|
1488
|
+
)
|
|
1489
|
+
},
|
|
1490
|
+
...value.generation === void 0 ? {} : { generation: lodGeneration(value.generation, `${label}.generation`) },
|
|
1491
|
+
...value.preset === void 0 ? {} : { preset: lodPreset(value.preset, `${label}.preset`) },
|
|
1492
|
+
...value.runtime === void 0 ? {} : { runtime: lodRuntime(value.runtime, `${label}.runtime`) }
|
|
1493
|
+
};
|
|
1494
|
+
}
|
|
1495
|
+
function validateLod(raw) {
|
|
1496
|
+
if (typeof raw === "boolean") return raw;
|
|
1497
|
+
const value = assertRecord(raw, "assets.lod");
|
|
1498
|
+
assertKeys(value, "assets.lod", LOD_KEYS);
|
|
1499
|
+
const overrides = {};
|
|
1500
|
+
if (value.overrides !== void 0) {
|
|
1501
|
+
if (!isRecord(value.overrides)) {
|
|
1502
|
+
fail("TN_CONFIG_ASSETS_INVALID", "assets.lod.overrides must be an object.");
|
|
1503
|
+
}
|
|
1504
|
+
for (const [key, entry] of Object.entries(value.overrides)) {
|
|
1505
|
+
if (key.trim() === "") {
|
|
1506
|
+
fail(
|
|
1507
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1508
|
+
"assets.lod.overrides keys must be non-empty source asset paths."
|
|
1509
|
+
);
|
|
1510
|
+
}
|
|
1511
|
+
overrides[key] = lodOverride(entry, `assets.lod.overrides['${key}']`);
|
|
1512
|
+
}
|
|
1513
|
+
}
|
|
1514
|
+
return {
|
|
1515
|
+
...value.enabled === void 0 ? {} : {
|
|
1516
|
+
enabled: booleanValue(
|
|
1517
|
+
value.enabled,
|
|
1518
|
+
true,
|
|
1519
|
+
"TN_CONFIG_ASSETS_INVALID",
|
|
1520
|
+
"assets.lod.enabled"
|
|
1521
|
+
)
|
|
1522
|
+
},
|
|
1523
|
+
...value.generation === void 0 ? {} : { generation: lodGeneration(value.generation, "assets.lod.generation") },
|
|
1524
|
+
...Object.keys(overrides).length === 0 ? {} : { overrides },
|
|
1525
|
+
...value.preset === void 0 ? {} : { preset: lodPreset(value.preset, "assets.lod.preset") },
|
|
1526
|
+
...value.runtime === void 0 ? {} : { runtime: lodRuntime(value.runtime, "assets.lod.runtime") }
|
|
1527
|
+
};
|
|
1528
|
+
}
|
|
1344
1529
|
function validateBudget(raw) {
|
|
1345
1530
|
const limit = (value) => value === "none" || typeof value === "number" && Number.isSafeInteger(value) && value > 0;
|
|
1346
1531
|
if (limit(raw)) return raw;
|
|
@@ -1369,6 +1554,7 @@ function validateAssets(raw) {
|
|
|
1369
1554
|
"budget",
|
|
1370
1555
|
"exclude",
|
|
1371
1556
|
"concurrency",
|
|
1557
|
+
"lod",
|
|
1372
1558
|
"models",
|
|
1373
1559
|
"source",
|
|
1374
1560
|
"output",
|
|
@@ -1376,6 +1562,7 @@ function validateAssets(raw) {
|
|
|
1376
1562
|
"textures"
|
|
1377
1563
|
]);
|
|
1378
1564
|
const targets = assets.targets === void 0 ? void 0 : validateAssetTargets(assets.targets);
|
|
1565
|
+
const lod = assets.lod === void 0 ? void 0 : validateLod(assets.lod);
|
|
1379
1566
|
const models = assets.models === void 0 ? void 0 : validateModels(assets.models);
|
|
1380
1567
|
const textures = assets.textures === void 0 ? void 0 : validateTextures(assets.textures);
|
|
1381
1568
|
if (assets.exclude !== void 0 && (!Array.isArray(assets.exclude) || assets.exclude.some((glob) => typeof glob !== "string" || glob.trim() === ""))) {
|
|
@@ -1399,11 +1586,215 @@ function validateAssets(raw) {
|
|
|
1399
1586
|
...assets.source === void 0 ? {} : { source: nonEmptyString(assets.source, "TN_CONFIG_ASSETS_INVALID", "assets.source") },
|
|
1400
1587
|
...assets.output === void 0 ? {} : { output: nonEmptyString(assets.output, "TN_CONFIG_ASSETS_INVALID", "assets.output") },
|
|
1401
1588
|
...targets === void 0 ? {} : { targets },
|
|
1589
|
+
...lod === void 0 ? {} : { lod },
|
|
1402
1590
|
...models === void 0 ? {} : { models },
|
|
1403
1591
|
...textures === void 0 ? {} : { textures }
|
|
1404
1592
|
};
|
|
1405
1593
|
}
|
|
1406
|
-
|
|
1594
|
+
var PROFILE_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/u;
|
|
1595
|
+
var PROFILE_ASSET_KEYS = [
|
|
1596
|
+
"audio",
|
|
1597
|
+
"budget",
|
|
1598
|
+
"lod",
|
|
1599
|
+
"models",
|
|
1600
|
+
"targets",
|
|
1601
|
+
"textures"
|
|
1602
|
+
];
|
|
1603
|
+
var PROFILE_TARGETS = ["android", "desktop", "ios", "web"];
|
|
1604
|
+
var ARTIFACT_BUDGET_KEYS = ["artifactBytes", "packagedAssetBytes"];
|
|
1605
|
+
var ARTIFACT_BUDGET_SEVERITIES = ["error", "warn"];
|
|
1606
|
+
var PERFORMANCE_BUDGET_KEYS = [
|
|
1607
|
+
"maxDrawCalls",
|
|
1608
|
+
"maxFrameMsP95",
|
|
1609
|
+
"maxPassDrawCalls",
|
|
1610
|
+
"maxPassTriangles",
|
|
1611
|
+
"maxPhaseMsP95",
|
|
1612
|
+
"maxTriangles",
|
|
1613
|
+
"minFps"
|
|
1614
|
+
];
|
|
1615
|
+
var PERFORMANCE_BUDGET_PHASES = [
|
|
1616
|
+
"hostGap",
|
|
1617
|
+
"overlay",
|
|
1618
|
+
"render",
|
|
1619
|
+
"residual",
|
|
1620
|
+
"update"
|
|
1621
|
+
];
|
|
1622
|
+
var PERFORMANCE_BUDGET_PASSES = ["main", "shadow", "reflection", "nested"];
|
|
1623
|
+
function validatePerformanceBudgetMap(raw, label, names, unit) {
|
|
1624
|
+
const map = assertRecord(raw, label);
|
|
1625
|
+
const entries = Object.entries(map);
|
|
1626
|
+
if (entries.length === 0)
|
|
1627
|
+
fail("TN_CONFIG_PROFILE_INVALID", `${label} must name at least one entry.`);
|
|
1628
|
+
const budget = {};
|
|
1629
|
+
for (const [name, ceiling] of entries) {
|
|
1630
|
+
if (!names.includes(name)) {
|
|
1631
|
+
fail(
|
|
1632
|
+
"TN_CONFIG_PROFILE_INVALID",
|
|
1633
|
+
`${label}.${name} is not recognised. Expected one of: ${names.join(", ")}.`
|
|
1634
|
+
);
|
|
1635
|
+
}
|
|
1636
|
+
if (typeof ceiling !== "number" || !Number.isFinite(ceiling) || ceiling < 0) {
|
|
1637
|
+
fail(
|
|
1638
|
+
"TN_CONFIG_PROFILE_INVALID",
|
|
1639
|
+
`${label}.${name} must be a non-negative number of ${unit}.`
|
|
1640
|
+
);
|
|
1641
|
+
}
|
|
1642
|
+
budget[name] = ceiling;
|
|
1643
|
+
}
|
|
1644
|
+
return budget;
|
|
1645
|
+
}
|
|
1646
|
+
function validatePerformanceBudget(raw, label) {
|
|
1647
|
+
const budget = assertRecord(raw, `${label}.performanceBudget`);
|
|
1648
|
+
assertKeys(budget, `${label}.performanceBudget`, PERFORMANCE_BUDGET_KEYS);
|
|
1649
|
+
if (Object.keys(budget).length === 0) {
|
|
1650
|
+
fail(
|
|
1651
|
+
"TN_CONFIG_PROFILE_INVALID",
|
|
1652
|
+
`${label}.performanceBudget must declare at least one ceiling; an empty budget bounds nothing.`
|
|
1653
|
+
);
|
|
1654
|
+
}
|
|
1655
|
+
const out = {};
|
|
1656
|
+
for (const key of ["maxDrawCalls", "maxFrameMsP95", "maxTriangles", "minFps"]) {
|
|
1657
|
+
const value = budget[key];
|
|
1658
|
+
if (value === void 0) continue;
|
|
1659
|
+
if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
|
|
1660
|
+
fail(
|
|
1661
|
+
"TN_CONFIG_PROFILE_INVALID",
|
|
1662
|
+
`${label}.performanceBudget.${key} must be a non-negative number.`
|
|
1663
|
+
);
|
|
1664
|
+
}
|
|
1665
|
+
out[key] = value;
|
|
1666
|
+
}
|
|
1667
|
+
for (const [key, names, unit] of [
|
|
1668
|
+
["maxPassDrawCalls", PERFORMANCE_BUDGET_PASSES, "draw calls"],
|
|
1669
|
+
["maxPassTriangles", PERFORMANCE_BUDGET_PASSES, "triangles"],
|
|
1670
|
+
["maxPhaseMsP95", PERFORMANCE_BUDGET_PHASES, "milliseconds"]
|
|
1671
|
+
]) {
|
|
1672
|
+
if (budget[key] === void 0) continue;
|
|
1673
|
+
out[key] = validatePerformanceBudgetMap(
|
|
1674
|
+
budget[key],
|
|
1675
|
+
`${label}.performanceBudget.${key}`,
|
|
1676
|
+
names,
|
|
1677
|
+
unit
|
|
1678
|
+
);
|
|
1679
|
+
}
|
|
1680
|
+
return out;
|
|
1681
|
+
}
|
|
1682
|
+
function artifactBudgetLimit(raw, label) {
|
|
1683
|
+
const limit = assertRecord(raw, label);
|
|
1684
|
+
assertKeys(limit, label, ["limit", "severity"]);
|
|
1685
|
+
const bytes = positiveInteger(limit.limit, 1, "TN_CONFIG_PROFILE_INVALID", `${label}.limit`);
|
|
1686
|
+
if (typeof limit.severity !== "string" || !ARTIFACT_BUDGET_SEVERITIES.includes(limit.severity)) {
|
|
1687
|
+
fail(
|
|
1688
|
+
"TN_CONFIG_PROFILE_INVALID",
|
|
1689
|
+
`${label}.severity must be one of ${ARTIFACT_BUDGET_SEVERITIES.join(", ")}.`
|
|
1690
|
+
);
|
|
1691
|
+
}
|
|
1692
|
+
return { limit: bytes, severity: limit.severity };
|
|
1693
|
+
}
|
|
1694
|
+
function validateArtifactBudget(raw, label) {
|
|
1695
|
+
const budget = assertRecord(raw, `${label}.artifactBudget`);
|
|
1696
|
+
assertKeys(budget, `${label}.artifactBudget`, ARTIFACT_BUDGET_KEYS);
|
|
1697
|
+
const artifactBytes = budget.artifactBytes === void 0 ? void 0 : artifactBudgetLimit(budget.artifactBytes, `${label}.artifactBudget.artifactBytes`);
|
|
1698
|
+
const packagedAssetBytes = budget.packagedAssetBytes === void 0 ? void 0 : artifactBudgetLimit(
|
|
1699
|
+
budget.packagedAssetBytes,
|
|
1700
|
+
`${label}.artifactBudget.packagedAssetBytes`
|
|
1701
|
+
);
|
|
1702
|
+
return {
|
|
1703
|
+
...artifactBytes === void 0 ? {} : { artifactBytes },
|
|
1704
|
+
...packagedAssetBytes === void 0 ? {} : { packagedAssetBytes }
|
|
1705
|
+
};
|
|
1706
|
+
}
|
|
1707
|
+
function resolveBuildProfile(raw, selection) {
|
|
1708
|
+
if (raw === void 0) {
|
|
1709
|
+
return void 0;
|
|
1710
|
+
}
|
|
1711
|
+
const group = assertRecord(raw, "buildProfiles");
|
|
1712
|
+
assertKeys(group, "buildProfiles", ["defaults", "profiles"]);
|
|
1713
|
+
const defaults = assertRecord(group.defaults, "buildProfiles.defaults");
|
|
1714
|
+
assertKeys(defaults, "buildProfiles.defaults", PROFILE_TARGETS);
|
|
1715
|
+
for (const [target, name2] of Object.entries(defaults)) {
|
|
1716
|
+
if (typeof name2 !== "string" || name2.length === 0) {
|
|
1717
|
+
fail("TN_CONFIG_PROFILE_INVALID", `buildProfiles.defaults.${target} must name a profile.`);
|
|
1718
|
+
}
|
|
1719
|
+
}
|
|
1720
|
+
const profiles = assertRecord(group.profiles, "buildProfiles.profiles");
|
|
1721
|
+
const declared = Object.keys(profiles);
|
|
1722
|
+
if (declared.length === 0) {
|
|
1723
|
+
fail("TN_CONFIG_GROUP_INVALID", "buildProfiles.profiles must declare at least one profile.");
|
|
1724
|
+
}
|
|
1725
|
+
for (const name2 of declared) {
|
|
1726
|
+
const label = `buildProfiles.profiles['${name2}']`;
|
|
1727
|
+
if (!PROFILE_NAME.test(name2)) {
|
|
1728
|
+
fail(
|
|
1729
|
+
"TN_CONFIG_PROFILE_NAME_INVALID",
|
|
1730
|
+
`${label} is not a usable profile name ('${name2}'): names are one lower-case path segment matching /^[a-z0-9][a-z0-9_-]{0,63}$/, so no name can traverse out of the build directory or collide by case.`
|
|
1731
|
+
);
|
|
1732
|
+
}
|
|
1733
|
+
const profile2 = assertRecord(profiles[name2], label);
|
|
1734
|
+
assertKeys(profile2, label, ["artifactBudget", "assets", "performanceBudget"]);
|
|
1735
|
+
assertKeys(
|
|
1736
|
+
assertRecord(profile2.assets, `${label}.assets`),
|
|
1737
|
+
`${label}.assets`,
|
|
1738
|
+
PROFILE_ASSET_KEYS
|
|
1739
|
+
);
|
|
1740
|
+
if (profile2.artifactBudget !== void 0) {
|
|
1741
|
+
validateArtifactBudget(profile2.artifactBudget, label);
|
|
1742
|
+
}
|
|
1743
|
+
if (profile2.performanceBudget !== void 0) {
|
|
1744
|
+
validatePerformanceBudget(profile2.performanceBudget, label);
|
|
1745
|
+
}
|
|
1746
|
+
}
|
|
1747
|
+
for (const [target, name2] of Object.entries(defaults)) {
|
|
1748
|
+
if (typeof name2 === "string" && !Object.hasOwn(profiles, name2)) {
|
|
1749
|
+
fail(
|
|
1750
|
+
"TN_CONFIG_PROFILE_UNKNOWN",
|
|
1751
|
+
`buildProfiles.defaults.${target} names '${name2}', which is not declared. Declared profiles: ${declared.join(", ")}.`
|
|
1752
|
+
);
|
|
1753
|
+
}
|
|
1754
|
+
}
|
|
1755
|
+
return void 0;
|
|
1756
|
+
}
|
|
1757
|
+
function mergeProfileOverlay(base, overlay) {
|
|
1758
|
+
if (!isRecord(base)) return overlay;
|
|
1759
|
+
const merged = { ...base };
|
|
1760
|
+
for (const [key, value] of Object.entries(overlay)) {
|
|
1761
|
+
const current = merged[key];
|
|
1762
|
+
merged[key] = isRecord(current) && isRecord(value) ? mergeProfileOverlay(current, value) : value;
|
|
1763
|
+
}
|
|
1764
|
+
return merged;
|
|
1765
|
+
}
|
|
1766
|
+
function assertProfileCapReachable(assets, overlay, name) {
|
|
1767
|
+
const overlayTextures = overlay.textures;
|
|
1768
|
+
const overlayModels = overlay.models;
|
|
1769
|
+
const caps = isRecord(overlayTextures) && overlayTextures.maxSize !== void 0 || isRecord(overlayModels) && isRecord(overlayModels.textures) && overlayModels.textures.maxSize !== void 0;
|
|
1770
|
+
if (!caps) return;
|
|
1771
|
+
const conflicts = [];
|
|
1772
|
+
if (assets.textures !== void 0 && assets.textures !== "none") {
|
|
1773
|
+
for (const override of assets.textures.overrides ?? []) {
|
|
1774
|
+
if (override.codec === "none") {
|
|
1775
|
+
conflicts.push(`assets.textures.overrides glob '${override.glob}' declares codec "none"`);
|
|
1776
|
+
}
|
|
1777
|
+
}
|
|
1778
|
+
}
|
|
1779
|
+
const models = assets.models;
|
|
1780
|
+
const modelTextures = models === void 0 || models === "none" ? void 0 : models.textures;
|
|
1781
|
+
if (modelTextures !== void 0 && modelTextures !== "none") {
|
|
1782
|
+
for (const override of modelTextures.overrides ?? []) {
|
|
1783
|
+
if (override.codec === "none") {
|
|
1784
|
+
conflicts.push(
|
|
1785
|
+
`assets.models.textures.overrides slot '${override.slot}' declares codec "none"`
|
|
1786
|
+
);
|
|
1787
|
+
}
|
|
1788
|
+
}
|
|
1789
|
+
}
|
|
1790
|
+
if (conflicts.length > 0) {
|
|
1791
|
+
fail(
|
|
1792
|
+
"TN_CONFIG_PROFILE_CONFLICT",
|
|
1793
|
+
`profile '${name}' caps texture size, and ${conflicts.join("; ")}, which returns the authored bytes before resizing. Drop the override, or take the cap out of the profile.`
|
|
1794
|
+
);
|
|
1795
|
+
}
|
|
1796
|
+
}
|
|
1797
|
+
async function loadConfigInternal(root, selection) {
|
|
1407
1798
|
const packagePath = path5.join(root, "package.json");
|
|
1408
1799
|
const sourcePath = path5.join(root, CONFIG_FILE);
|
|
1409
1800
|
const manifest = await withConfigContext(
|
|
@@ -1436,7 +1827,8 @@ async function loadConfigInternal(root) {
|
|
|
1436
1827
|
"nativeEntry",
|
|
1437
1828
|
"renderer",
|
|
1438
1829
|
"ui",
|
|
1439
|
-
"assets"
|
|
1830
|
+
"assets",
|
|
1831
|
+
"buildProfiles"
|
|
1440
1832
|
]);
|
|
1441
1833
|
}
|
|
1442
1834
|
const configuredEntry = raw?.nativeEntry;
|
|
@@ -1448,7 +1840,12 @@ async function loadConfigInternal(root) {
|
|
|
1448
1840
|
}
|
|
1449
1841
|
const app = await validateApp(raw?.app, name, root);
|
|
1450
1842
|
const bootSplash = await validateBootSplash(raw?.bootSplash, root);
|
|
1451
|
-
const
|
|
1843
|
+
const profile = resolveBuildProfile(raw?.buildProfiles, selection);
|
|
1844
|
+
const rawAssets = profile === void 0 ? raw?.assets : mergeProfileOverlay(raw?.assets, profile.assets);
|
|
1845
|
+
const assets = rawAssets === void 0 ? void 0 : validateAssets(rawAssets);
|
|
1846
|
+
if (assets !== void 0 && profile !== void 0) {
|
|
1847
|
+
assertProfileCapReachable(assets, profile.assets, profile.name);
|
|
1848
|
+
}
|
|
1452
1849
|
return {
|
|
1453
1850
|
app,
|
|
1454
1851
|
display: validateDisplay(raw?.display),
|
|
@@ -1457,17 +1854,26 @@ async function loadConfigInternal(root) {
|
|
|
1457
1854
|
renderer: validateRenderer(raw?.renderer),
|
|
1458
1855
|
ui: validateUi(raw?.ui),
|
|
1459
1856
|
...bootSplash === void 0 ? {} : { bootSplash },
|
|
1460
|
-
...assets === void 0 ? {} : { assets }
|
|
1857
|
+
...assets === void 0 ? {} : { assets },
|
|
1858
|
+
...profile === void 0 ? {} : {
|
|
1859
|
+
buildProfile: {
|
|
1860
|
+
name: profile.name,
|
|
1861
|
+
source: profile.source,
|
|
1862
|
+
target: profile.target,
|
|
1863
|
+
...profile.artifactBudget === void 0 ? {} : { artifactBudget: profile.artifactBudget },
|
|
1864
|
+
...profile.performanceBudget === void 0 ? {} : { performanceBudget: profile.performanceBudget }
|
|
1865
|
+
}
|
|
1866
|
+
}
|
|
1461
1867
|
};
|
|
1462
1868
|
}
|
|
1463
1869
|
);
|
|
1464
1870
|
}
|
|
1465
|
-
async function loadConfig(cwd) {
|
|
1871
|
+
async function loadConfig(cwd, selection) {
|
|
1466
1872
|
const root = path5.resolve(cwd);
|
|
1467
1873
|
return withConfigContext(
|
|
1468
1874
|
validationContext(root, [path5.join(root, CONFIG_FILE), path5.join(root, "package.json")]),
|
|
1469
1875
|
"TN_CONFIG_VALIDATION_FAILED",
|
|
1470
|
-
() => loadConfigInternal(root)
|
|
1876
|
+
() => loadConfigInternal(root, selection)
|
|
1471
1877
|
);
|
|
1472
1878
|
}
|
|
1473
1879
|
|
|
@@ -1680,6 +2086,26 @@ async function copyTemplateIcon(target, templateRootDirectory) {
|
|
|
1680
2086
|
await mkdir(path5.dirname(destination), { recursive: true });
|
|
1681
2087
|
await cp(source, destination, { errorOnExist: true, force: false });
|
|
1682
2088
|
}
|
|
2089
|
+
async function copySharedAssets(target, templateRootDirectory) {
|
|
2090
|
+
const shared = path5.join(path5.dirname(templateRootDirectory), "template-assets", "assets");
|
|
2091
|
+
if (!existsSync(shared)) return;
|
|
2092
|
+
const source = path5.join(target, "src");
|
|
2093
|
+
const texts = [];
|
|
2094
|
+
const walk = async (directory) => {
|
|
2095
|
+
for (const entry of await readdir(directory, { withFileTypes: true })) {
|
|
2096
|
+
const file = path5.join(directory, entry.name);
|
|
2097
|
+
if (entry.isDirectory()) await walk(file);
|
|
2098
|
+
else if (/\.(?:ts|tsx)$/u.test(entry.name)) texts.push(await readFile(file, "utf8"));
|
|
2099
|
+
}
|
|
2100
|
+
};
|
|
2101
|
+
if (existsSync(source)) await walk(source);
|
|
2102
|
+
for (const name of readdirSync(shared)) {
|
|
2103
|
+
if (!texts.some((text) => text.includes(`"${name}"`))) continue;
|
|
2104
|
+
const destination = path5.join(target, "assets", name);
|
|
2105
|
+
await mkdir(path5.dirname(destination), { recursive: true });
|
|
2106
|
+
await cp(path5.join(shared, name), destination, { errorOnExist: true, force: false });
|
|
2107
|
+
}
|
|
2108
|
+
}
|
|
1683
2109
|
function invalidManifest(file, reason) {
|
|
1684
2110
|
throw new Error(`TN_KIT_MANIFEST_INVALID: ${file}: ${reason}`);
|
|
1685
2111
|
}
|
|
@@ -1809,7 +2235,7 @@ async function renderTemplate(directory, replacements) {
|
|
|
1809
2235
|
await writeFile(source, rendered);
|
|
1810
2236
|
}
|
|
1811
2237
|
}
|
|
1812
|
-
var
|
|
2238
|
+
var REFERENCE_BUNDLE_PREFIX = "node_modules/create-threenative/agent-docs/references/";
|
|
1813
2239
|
var REFERENCE_FILE_NAME = /^[a-z0-9][a-z0-9-]*\.md$/u;
|
|
1814
2240
|
var AGENT_FILES_DIRECTORY = "agent-files";
|
|
1815
2241
|
var AUTHORING_GITIGNORE_RULES = [
|
|
@@ -1820,27 +2246,28 @@ var AUTHORING_GITIGNORE_RULES = [
|
|
|
1820
2246
|
".env.*",
|
|
1821
2247
|
"!.env.example"
|
|
1822
2248
|
];
|
|
1823
|
-
var REFERENCE_TOKEN_PATTERN =
|
|
1824
|
-
|
|
1825
|
-
|
|
1826
|
-
|
|
1827
|
-
|
|
1828
|
-
|
|
1829
|
-
);
|
|
1830
|
-
|
|
1831
|
-
const
|
|
1832
|
-
await mkdir(
|
|
1833
|
-
for (const entry of await readdir(
|
|
1834
|
-
if (!entry.
|
|
1835
|
-
|
|
1836
|
-
|
|
1837
|
-
|
|
1838
|
-
|
|
1839
|
-
|
|
1840
|
-
|
|
1841
|
-
|
|
2249
|
+
var REFERENCE_TOKEN_PATTERN = new RegExp(
|
|
2250
|
+
`\`${REFERENCE_BUNDLE_PREFIX}([a-z0-9][a-z0-9./-]*\\.md)\`|\\[[^\\]]*\\]\\(${REFERENCE_BUNDLE_PREFIX}([^)#]+\\.md)\\)`,
|
|
2251
|
+
"gu"
|
|
2252
|
+
);
|
|
2253
|
+
async function linkClaudeSkills(target) {
|
|
2254
|
+
const stored = path5.join(target, ".agents", "skills");
|
|
2255
|
+
if (!existsSync(stored)) return;
|
|
2256
|
+
const hostSkills = path5.join(target, ".claude", "skills");
|
|
2257
|
+
const subagents = path5.join(target, ".claude", "agents");
|
|
2258
|
+
await mkdir(hostSkills, { recursive: true });
|
|
2259
|
+
for (const entry of await readdir(stored, { withFileTypes: true })) {
|
|
2260
|
+
if (!entry.isDirectory()) continue;
|
|
2261
|
+
if (existsSync(path5.join(subagents, `${entry.name}.md`))) continue;
|
|
2262
|
+
const link = path5.join(hostSkills, entry.name);
|
|
2263
|
+
const relative = path5.relative(hostSkills, path5.join(stored, entry.name));
|
|
2264
|
+
try {
|
|
2265
|
+
await symlink(relative, link, "dir");
|
|
2266
|
+
} catch (error) {
|
|
2267
|
+
const code = error.code;
|
|
2268
|
+
if (code !== "EPERM" && code !== "EACCES") throw error;
|
|
2269
|
+
await cp(path5.join(stored, entry.name), link, { recursive: true });
|
|
1842
2270
|
}
|
|
1843
|
-
await writeFile(destinationPath, content);
|
|
1844
2271
|
}
|
|
1845
2272
|
}
|
|
1846
2273
|
async function copyAgentFiles(target, templateRootDirectory) {
|
|
@@ -1851,6 +2278,7 @@ async function copyAgentFiles(target, templateRootDirectory) {
|
|
|
1851
2278
|
);
|
|
1852
2279
|
}
|
|
1853
2280
|
await cp(source, target, { recursive: true });
|
|
2281
|
+
await linkClaudeSkills(target);
|
|
1854
2282
|
}
|
|
1855
2283
|
async function installAuthoringGitignore(target) {
|
|
1856
2284
|
const file = path5.join(target, ".gitignore");
|
|
@@ -1866,7 +2294,12 @@ async function installAuthoringGitignore(target) {
|
|
|
1866
2294
|
`
|
|
1867
2295
|
);
|
|
1868
2296
|
}
|
|
1869
|
-
async function assertReferenceBundle(target) {
|
|
2297
|
+
async function assertReferenceBundle(target, templateRootDirectory) {
|
|
2298
|
+
const bundleDirectory = path5.join(
|
|
2299
|
+
path5.dirname(templateRootDirectory),
|
|
2300
|
+
"agent-docs",
|
|
2301
|
+
"references"
|
|
2302
|
+
);
|
|
1870
2303
|
for (const file of [
|
|
1871
2304
|
"AGENTS.md",
|
|
1872
2305
|
"CLAUDE.md",
|
|
@@ -1876,10 +2309,10 @@ async function assertReferenceBundle(target) {
|
|
|
1876
2309
|
".claude/skills/threenative-assets/SKILL.md"
|
|
1877
2310
|
]) {
|
|
1878
2311
|
const filePath = path5.join(target, file);
|
|
1879
|
-
if (existsSync(filePath)) await assertReferenceTargets(
|
|
2312
|
+
if (existsSync(filePath)) await assertReferenceTargets(file, filePath, bundleDirectory);
|
|
1880
2313
|
}
|
|
1881
2314
|
}
|
|
1882
|
-
async function assertReferenceTargets(
|
|
2315
|
+
async function assertReferenceTargets(from, filePath, bundleDirectory) {
|
|
1883
2316
|
const content = await readFile(filePath, "utf8");
|
|
1884
2317
|
for (const match of content.matchAll(REFERENCE_TOKEN_PATTERN)) {
|
|
1885
2318
|
const referenced = match[1] ?? match[2];
|
|
@@ -1889,10 +2322,9 @@ async function assertReferenceTargets(target, from, filePath) {
|
|
|
1889
2322
|
`RED observed: referenced recipe missing: '${from}' names '${referenced}', which is not a shipped reference page.`
|
|
1890
2323
|
);
|
|
1891
2324
|
}
|
|
1892
|
-
|
|
1893
|
-
if (!existsSync(resolved)) {
|
|
2325
|
+
if (!existsSync(path5.join(bundleDirectory, referenced))) {
|
|
1894
2326
|
throw new Error(
|
|
1895
|
-
`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.`
|
|
1896
2328
|
);
|
|
1897
2329
|
}
|
|
1898
2330
|
}
|
|
@@ -1925,27 +2357,20 @@ async function applyPackageSources(target, packageSources) {
|
|
|
1925
2357
|
await writeFile(packagePath, `${JSON.stringify(packageJson, null, 2)}
|
|
1926
2358
|
`);
|
|
1927
2359
|
}
|
|
1928
|
-
async function copyCapabilityManifest(target, templateRootDirectory) {
|
|
1929
|
-
const source = path5.join(path5.dirname(templateRootDirectory), "capabilities.json");
|
|
1930
|
-
if (!existsSync(source)) {
|
|
1931
|
-
throw new Error(
|
|
1932
|
-
`TN_KIT_CAPABILITIES_MISSING: '${source}' is not in the package; the generated project needs the capability manifest for its agent tooling.`
|
|
1933
|
-
);
|
|
1934
|
-
}
|
|
1935
|
-
await cp(source, path5.join(target, "capabilities.json"));
|
|
1936
|
-
}
|
|
1937
2360
|
var FRAMEWORK_PATCH_DIRECTORY = "patches";
|
|
1938
2361
|
var THREE_PATCH_NAME = "three@0.185.1.patch";
|
|
1939
2362
|
async function copyFrameworkPatches(target, templateRootDirectory) {
|
|
1940
|
-
const
|
|
1941
|
-
|
|
1942
|
-
"template-assets",
|
|
1943
|
-
FRAMEWORK_PATCH_DIRECTORY,
|
|
1944
|
-
THREE_PATCH_NAME
|
|
2363
|
+
const packageRoot = path5.dirname(templateRoot());
|
|
2364
|
+
const candidates = [.../* @__PURE__ */ new Set([path5.dirname(templateRootDirectory), packageRoot])].map(
|
|
2365
|
+
(root) => path5.join(root, "template-assets", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
|
|
1945
2366
|
);
|
|
1946
|
-
|
|
2367
|
+
candidates.push(
|
|
2368
|
+
path5.join(packageRoot, "..", "core", FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME)
|
|
2369
|
+
);
|
|
2370
|
+
const source = candidates.find((candidate) => existsSync(candidate));
|
|
2371
|
+
if (source === void 0) {
|
|
1947
2372
|
throw new Error(
|
|
1948
|
-
`TN_FRAMEWORK_PATCH_MISSING: '${
|
|
2373
|
+
`TN_FRAMEWORK_PATCH_MISSING: none of ${candidates.map((candidate) => `'${candidate}'`).join(", ")} exists; the generated project needs the Three.js velocity patch for batched temporal history.`
|
|
1949
2374
|
);
|
|
1950
2375
|
}
|
|
1951
2376
|
const destination = path5.join(target, FRAMEWORK_PATCH_DIRECTORY, THREE_PATCH_NAME);
|
|
@@ -2041,6 +2466,7 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
|
|
|
2041
2466
|
const source = path5.join(root, template);
|
|
2042
2467
|
await cp(source, target, { recursive: true, errorOnExist: true });
|
|
2043
2468
|
await copyTemplateIcon(target, root);
|
|
2469
|
+
await copySharedAssets(target, root);
|
|
2044
2470
|
if (existsSync(path5.join(target, "gitignore"))) {
|
|
2045
2471
|
await rename(path5.join(target, "gitignore"), path5.join(target, ".gitignore"));
|
|
2046
2472
|
}
|
|
@@ -2055,12 +2481,10 @@ async function createProject(options, cwd = process.cwd(), root = templateRoot()
|
|
|
2055
2481
|
await stampTemplateLoading(target, source, root);
|
|
2056
2482
|
await copyAgentFiles(target, root);
|
|
2057
2483
|
await renderTemplate(target, replacements);
|
|
2058
|
-
await copyReferenceBundle(target, root, replacements);
|
|
2059
|
-
await copyCapabilityManifest(target, root);
|
|
2060
2484
|
await copyFrameworkPatches(target, root);
|
|
2061
2485
|
await applyPackageSources(target, options.packageSources);
|
|
2062
2486
|
await assertMcpConfig(target);
|
|
2063
|
-
await assertReferenceBundle(target);
|
|
2487
|
+
await assertReferenceBundle(target, root);
|
|
2064
2488
|
const installed = options.install ?? true;
|
|
2065
2489
|
if (installed) await runInstall(target);
|
|
2066
2490
|
return { installed, target, template };
|