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
|
@@ -0,0 +1,656 @@
|
|
|
1
|
+
// Regenerates src/render/*-shader.ts from the tempest-*.frag files.
|
|
2
|
+
//
|
|
3
|
+
// Two shaders come out of one pipeline: the raymarched coast and the cloud volume it stands under.
|
|
4
|
+
// Both are several hundred lines of GLSL from the Tempest single-file demo, so porting either by
|
|
5
|
+
// hand is a transcription exercise with no end state. The installed Three.js transpiler
|
|
6
|
+
// (`three/examples/jsm/transpiler`) does the port at authoring time and this file checks the
|
|
7
|
+
// result. Nothing is compiled or evaluated at runtime: the output is an ordinary `.ts` module that
|
|
8
|
+
// Vite and the native packager see like any other source file.
|
|
9
|
+
//
|
|
10
|
+
// Fails closed. A GLSL construct the upstream decoder does not understand, a uniform the emitted
|
|
11
|
+
// code reads but nothing binds, a local this file cannot materialise, a branch dropped at runtime,
|
|
12
|
+
// or any warning from the decoder stops the run instead of writing a file that quietly lost one.
|
|
13
|
+
//
|
|
14
|
+
// node tools/generate-shaders.mjs
|
|
15
|
+
import { execFileSync } from "node:child_process";
|
|
16
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
17
|
+
import { dirname, relative, resolve } from "node:path";
|
|
18
|
+
import { fileURLToPath } from "node:url";
|
|
19
|
+
import GLSLDecoder from "three/examples/jsm/transpiler/GLSLDecoder.js";
|
|
20
|
+
import TSLEncoder from "three/examples/jsm/transpiler/TSLEncoder.js";
|
|
21
|
+
import Transpiler from "three/examples/jsm/transpiler/Transpiler.js";
|
|
22
|
+
import ts from "typescript";
|
|
23
|
+
|
|
24
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
25
|
+
// The repository this template lives in, four levels up from `tools/`. A scaffolded project has no
|
|
26
|
+
// Biome of its own, which is why the formatting step below is optional and says so.
|
|
27
|
+
const repoRoot = resolve(here, "../../../../..");
|
|
28
|
+
// Biome refuses paths outside the directory it is run from, so it runs from the repository root,
|
|
29
|
+
// which is also where the configuration that formats the generated file lives. The unsafe fixes
|
|
30
|
+
// are asked for on purpose and were diffed: for this output they are the import sort and the
|
|
31
|
+
// split of multi-name `const` declarators, both of which leave the graph alone.
|
|
32
|
+
const biome = resolve(repoRoot, "node_modules/.bin/biome");
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* A sampler the decoder turns into a texture node, and how each is declared here. Both start as a
|
|
36
|
+
* 1-voxel placeholder that the owning module replaces by assigning `.value`, because a sampled node
|
|
37
|
+
* needs a texture before the graph is built.
|
|
38
|
+
*/
|
|
39
|
+
const SAMPLERS = {
|
|
40
|
+
sampler2D: { node: "texture", texture: "DataTexture", create: "1, 1" },
|
|
41
|
+
sampler3D: { node: "texture3D", texture: "Data3DTexture", create: "1, 1, 1" },
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
/** Uniform defaults, so nothing reads an unset value on the first frame. */
|
|
45
|
+
const DEFAULTS = {
|
|
46
|
+
float: "0",
|
|
47
|
+
int: "0",
|
|
48
|
+
vec2: "new Vector2()",
|
|
49
|
+
vec3: "new Vector3()",
|
|
50
|
+
vec4: "new Vector4()",
|
|
51
|
+
};
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Applied to every emitted module. GLSL's `mat2(a, b, c, d)` is column-major — `(a, b)` is the first
|
|
55
|
+
* column — but TSL's `mat2(a, b, c, d)` with constants builds a `Matrix2`, whose constructor takes
|
|
56
|
+
* row-major arguments. Passed through unchanged, fbm's octave rotation comes out transposed: a
|
|
57
|
+
* rotation the other way, so every octave after the first lands somewhere else and the terrain's
|
|
58
|
+
* ridges, the puddles and the cloud shapes all drift from the study's. Swapping the off-diagonal
|
|
59
|
+
* pair is the transpose back.
|
|
60
|
+
*/
|
|
61
|
+
const MAT2_COLUMN_MAJOR = {
|
|
62
|
+
what: "a constant mat2 in GLSL's column-major order",
|
|
63
|
+
find: /mat2\(\s*([^,()]+),\s*([^,()]+),\s*([^,()]+),\s*([^,()]+)\)/g,
|
|
64
|
+
replace: "mat2($1, $3, $2, $4)",
|
|
65
|
+
};
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* The shaders this generates. `rewrites` are edits to the GLSL text; each one is a rewrite with a
|
|
69
|
+
* named reason, and a rule that matches nothing stops the run. `entryOpen` turns the stage's
|
|
70
|
+
* `main` into the one function the module exports; `entryClose` covers what that function has to
|
|
71
|
+
* hand back.
|
|
72
|
+
*/
|
|
73
|
+
const SHADERS = [
|
|
74
|
+
{
|
|
75
|
+
name: "world",
|
|
76
|
+
marker: "TN_WORLD_SHADER",
|
|
77
|
+
source: "tempest-world.frag",
|
|
78
|
+
target: "../src/render/world-shader.ts",
|
|
79
|
+
entry: "tempestWorld",
|
|
80
|
+
/** The coast raymarches with a depth term, so it seeds one the way a GLSL global would. */
|
|
81
|
+
entryOpen: ["void main(){", "vec4 tempestWorld(vec2 vUv){float worldDepth=1.;"],
|
|
82
|
+
entryClose: [
|
|
83
|
+
{ what: "gl_FragDepth", find: "gl_FragDepth", replace: "worldDepth" },
|
|
84
|
+
{
|
|
85
|
+
what: "the fragment output",
|
|
86
|
+
find: "fragColor=vec4(max(color,vec3(0.)),1.);",
|
|
87
|
+
replace: "return vec4(max(color,vec3(0.)),worldDepth);",
|
|
88
|
+
},
|
|
89
|
+
],
|
|
90
|
+
samplers: ["sampler2D"],
|
|
91
|
+
/** The ripple loop is a nested pair, which the decoder names in a way `LoopNode` cannot read. */
|
|
92
|
+
nestedLoop: true,
|
|
93
|
+
/**
|
|
94
|
+
* Edits to the code the transpiler emitted, rather than to the GLSL it read. This one is the
|
|
95
|
+
* coast's alone: the decoder turns `roadCenter`'s `-1.6` into `-(1.6).add(x)`, which asks a
|
|
96
|
+
* JavaScript number for a TSL method and throws on the first frame. `float(-1.6)` is the same
|
|
97
|
+
* value. The cloud volume has no literal in that position, so it declares none.
|
|
98
|
+
*/
|
|
99
|
+
outputRewrites: [
|
|
100
|
+
MAT2_COLUMN_MAJOR,
|
|
101
|
+
{
|
|
102
|
+
what: "a negated literal with a TSL method call on it",
|
|
103
|
+
find: /- ?((?:\d+\.\d*|\.\d+|\d+))\.(?=[A-Za-z_$])/g,
|
|
104
|
+
replace: "float(-$1).",
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
// The one orientation rule this shader needs, and it is deliberately not a camera- or
|
|
108
|
+
// backend-name conditional. `vUv` is the screen quad's geometry uv: bottom-up, `y = 1` at
|
|
109
|
+
// the top of the frame. `uSky` is a `PassTextureNode` — a render target written by the
|
|
110
|
+
// cloud pass — and a render target's first row is the top of the image it holds, so its
|
|
111
|
+
// `y = 0` is the top of the frame. Sampling one with the other hands the coast the sky
|
|
112
|
+
// upside down: the deck's bright horizon band lands high in the frame, well above the
|
|
113
|
+
// world's own horizon, and the whole ceiling is mirrored. Normalising the coordinate at the
|
|
114
|
+
// fetch is the fix, and it is fetch-local: `ray(vUv)` still marches with the bottom-up uv
|
|
115
|
+
// the source was written against, so the cloud volume and every density in it are
|
|
116
|
+
// untouched. Both reads are rewritten, the direct sky sample and the reflected `suv`,
|
|
117
|
+
// because a flip on one and not the other would put the reflections somewhere the sky they
|
|
118
|
+
// mirror is not.
|
|
119
|
+
what: "the pass-texture sample coordinate",
|
|
120
|
+
find: /uSky\.sample\(\s*(\w+)\s*\)/g,
|
|
121
|
+
replace: "uSky.sample(vec2($1.x,$1.y.oneMinus()))",
|
|
122
|
+
imports: ["oneMinus"],
|
|
123
|
+
},
|
|
124
|
+
],
|
|
125
|
+
rewrites: [
|
|
126
|
+
{
|
|
127
|
+
// The upstream decoder only reads the first name of a comma-separated uniform list, so every
|
|
128
|
+
// uniform after the first in `uniform float a,b,c;` is dropped from the emitted module and
|
|
129
|
+
// would be a ReferenceError at runtime. `boundUniforms` below re-adds and checks them all.
|
|
130
|
+
what: "the ripple loop braces",
|
|
131
|
+
find: "for(int j=-1;j<=1;j++)",
|
|
132
|
+
replace: "for(int j=-1;j<=1;j++){",
|
|
133
|
+
},
|
|
134
|
+
{
|
|
135
|
+
what: "the ripple loop close",
|
|
136
|
+
find: " }return sum*uRain;",
|
|
137
|
+
replace: " }}return sum*uRain;",
|
|
138
|
+
},
|
|
139
|
+
],
|
|
140
|
+
header: `// The shader is the coast: terrain, road, sea, the rail and cabin on it, wet reflections and the
|
|
141
|
+
// fog that closes the distance. It is raymarched, so it is one full-screen quad and one function
|
|
142
|
+
// call — see src/render/world.ts for the uniforms and the camera basis it expects.`,
|
|
143
|
+
},
|
|
144
|
+
{
|
|
145
|
+
name: "clouds",
|
|
146
|
+
marker: "TN_CLOUDS_SHADER",
|
|
147
|
+
source: "tempest-clouds.frag",
|
|
148
|
+
target: "../src/render/clouds-shader.ts",
|
|
149
|
+
entry: "tempestClouds",
|
|
150
|
+
/** The cloud volume has no depth term; it is the colour the coast samples for its sky. */
|
|
151
|
+
entryOpen: ["void main(){", "vec4 tempestClouds(vec2 vUv){"],
|
|
152
|
+
entryClose: [],
|
|
153
|
+
samplers: ["sampler3D"],
|
|
154
|
+
nestedLoop: false,
|
|
155
|
+
outputRewrites: [
|
|
156
|
+
MAT2_COLUMN_MAJOR,
|
|
157
|
+
{
|
|
158
|
+
// The decoder's own `gl_FragCoord` polyfill reaches for `screenCoordinate.z`, which is not a
|
|
159
|
+
// member of a `vec2` screen coordinate: the fragment depth is its own node, and that is what
|
|
160
|
+
// `gl_FragCoord.z` is.
|
|
161
|
+
what: "the depth component of the decoded gl_FragCoord",
|
|
162
|
+
find: "screenCoordinate.z",
|
|
163
|
+
replace: "depth",
|
|
164
|
+
imports: ["depth"],
|
|
165
|
+
},
|
|
166
|
+
],
|
|
167
|
+
rewrites: [],
|
|
168
|
+
header: `// The shader is the storm ceiling: a raymarched volume between 145 and 815 metres, lit by a
|
|
169
|
+
// five-tap march toward the sun and filled from a procedural 64³ noise volume. It is one full-screen
|
|
170
|
+
// pass into a render target the coast samples — see src/render/clouds.ts.`,
|
|
171
|
+
},
|
|
172
|
+
];
|
|
173
|
+
|
|
174
|
+
/** Applied to every shader before it is parsed, because none of them is valid GLSL on its own. */
|
|
175
|
+
const COMMON_REWRITES = [
|
|
176
|
+
{
|
|
177
|
+
// `precision` is a GLSL-only qualifier with no TSL equivalent; TSL picks the precision itself.
|
|
178
|
+
what: "precision qualifiers",
|
|
179
|
+
find: /precision[^;]*;/g,
|
|
180
|
+
replace: "",
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
// The stage's own varyings become the generated function's parameters, not module state.
|
|
184
|
+
what: "stage declarations",
|
|
185
|
+
find: /\b(?:in|out)\s+\w+\s+\w+\s*;/g,
|
|
186
|
+
replace: "",
|
|
187
|
+
},
|
|
188
|
+
];
|
|
189
|
+
|
|
190
|
+
// The emitted code is JavaScript, so the structural fixes below are made on its syntax tree rather
|
|
191
|
+
// than on its text: the transpiler's own output decides where they apply, and a shape this file
|
|
192
|
+
// does not recognise stops the run rather than being rewritten by a pattern that happened to fit.
|
|
193
|
+
// TypeScript is the template's own devDependency, so a scaffolded project has it.
|
|
194
|
+
|
|
195
|
+
const parse = (text) =>
|
|
196
|
+
ts.createSourceFile("shader.ts", text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* The name a call's callee is written as. Both spellings appear in TSL: `Fn(...)` for the imported
|
|
200
|
+
* functions and `node.toVar()` for the methods, and a declaration initialised by a method call has
|
|
201
|
+
* to be recognised as already materialised, so a property access counts too.
|
|
202
|
+
*/
|
|
203
|
+
const callee = (node) => {
|
|
204
|
+
const { expression } = node;
|
|
205
|
+
if (ts.isIdentifier(expression)) return expression.text;
|
|
206
|
+
if (ts.isPropertyAccessExpression(expression)) return expression.name.text;
|
|
207
|
+
return null;
|
|
208
|
+
};
|
|
209
|
+
|
|
210
|
+
/** `true` for the arrow or function the transpiler wrote as an argument to `Fn(...)`. */
|
|
211
|
+
const isFnBody = (node) =>
|
|
212
|
+
(ts.isArrowFunction(node) || ts.isFunctionExpression(node)) &&
|
|
213
|
+
ts.isCallExpression(node.parent) &&
|
|
214
|
+
callee(node.parent) === "Fn";
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* `Fn(fn, { p: 'vec2', return: 'float' })` is the transpiler's shorthand for a function taking one
|
|
218
|
+
* vec2, and as a second argument it is not a layout anything reads. `Fn`'s builder path takes that
|
|
219
|
+
* second argument as a shader-node builder to hand the callback, so the emitted functions capture
|
|
220
|
+
* every uniform they read into a struct that is never bound: the first compile reports a missing
|
|
221
|
+
* uniform member, and the frame group resolves no member at all. Nothing is lost by dropping it,
|
|
222
|
+
* because no function is ever emitted as a real shader function — all of them are inlined, and the
|
|
223
|
+
* types the layout spelled out are already on the callback parameters as typed tuples. Removed by
|
|
224
|
+
* span, from every `Fn` call.
|
|
225
|
+
*/
|
|
226
|
+
function stripFnLayout(code) {
|
|
227
|
+
const file = parse(code);
|
|
228
|
+
const spans = [];
|
|
229
|
+
const walk = (node) => {
|
|
230
|
+
if (ts.isCallExpression(node) && callee(node) === "Fn") {
|
|
231
|
+
const [callback, layout] = node.arguments;
|
|
232
|
+
if (node.arguments.length === 1) {
|
|
233
|
+
if (!callback || !isFnBody(callback))
|
|
234
|
+
throw new Error("TN_TRANSPILER_FN_SHAPE: an Fn call lost its callback");
|
|
235
|
+
} else if (
|
|
236
|
+
node.arguments.length === 2 &&
|
|
237
|
+
callback &&
|
|
238
|
+
isFnBody(callback) &&
|
|
239
|
+
ts.isObjectLiteralExpression(layout)
|
|
240
|
+
) {
|
|
241
|
+
spans.push([callback.end, layout.end]);
|
|
242
|
+
} else {
|
|
243
|
+
throw new Error(
|
|
244
|
+
`TN_TRANSPILER_FN_SHAPE: Fn takes ${node.arguments.length} arguments and none is a layout to remove`,
|
|
245
|
+
);
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
ts.forEachChild(node, walk);
|
|
249
|
+
};
|
|
250
|
+
walk(file);
|
|
251
|
+
if (spans.length === 0)
|
|
252
|
+
throw new Error("TN_TRANSPILER_NO_FN_LAYOUT: no Fn call carried a layout argument");
|
|
253
|
+
let out = code;
|
|
254
|
+
for (const [from, to] of spans.reverse()) out = out.slice(0, from) + out.slice(to);
|
|
255
|
+
return out;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/**
|
|
259
|
+
* A local GLSL variable is a mutable TSL node, but the transpiler writes it as a plain JavaScript
|
|
260
|
+
* `const` holding the expression it was initialised with. Every later `+=` or `.assign` then
|
|
261
|
+
* mutates a temporary nothing reads back, so the shader compiles and runs holding the first value
|
|
262
|
+
* it ever saw: the march never advances and the scene stays the sky it started on. `toVar()` is
|
|
263
|
+
* what names a node — it materialises the value into a shader variable the rest of the function can
|
|
264
|
+
* reassign — and it is needed on every initialised local, not only on the ones a parameter was
|
|
265
|
+
* assigned to. Applied inside function bodies only, so the module-level declarations, which are
|
|
266
|
+
* uniforms and the `Fn` calls themselves, are left as the transpiler wrote them.
|
|
267
|
+
*/
|
|
268
|
+
function materializeLocals(code) {
|
|
269
|
+
const file = parse(code);
|
|
270
|
+
const inserts = [];
|
|
271
|
+
const destructured = [];
|
|
272
|
+
const walk = (node, inBody) => {
|
|
273
|
+
const body = inBody || isFnBody(node) || ts.isFunctionDeclaration(node);
|
|
274
|
+
if (body && ts.isVariableDeclaration(node) && node.initializer) {
|
|
275
|
+
if (ts.isIdentifier(node.name)) {
|
|
276
|
+
const { initializer } = node;
|
|
277
|
+
if (!(ts.isCallExpression(initializer) && callee(initializer) === "toVar")) {
|
|
278
|
+
inserts.push(initializer.end);
|
|
279
|
+
}
|
|
280
|
+
} else {
|
|
281
|
+
destructured.push(node.name.getText(file));
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
ts.forEachChild(node, (child) => walk(child, body));
|
|
285
|
+
};
|
|
286
|
+
walk(file, false);
|
|
287
|
+
if (destructured.length > 0) {
|
|
288
|
+
throw new Error(
|
|
289
|
+
`TN_TRANSPILER_DESTRUCTURED: ${destructured.join(", ")} destructures, so its value cannot be materialised`,
|
|
290
|
+
);
|
|
291
|
+
}
|
|
292
|
+
if (inserts.length === 0)
|
|
293
|
+
throw new Error("TN_TRANSPILER_NO_LOCALS: no local variable was found to materialise");
|
|
294
|
+
let out = code;
|
|
295
|
+
for (const at of inserts.reverse()) out = `${out.slice(0, at)}.toVar()${out.slice(at)}`;
|
|
296
|
+
return out;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* A `return` inside an `If` or `Loop` callback is not the GLSL early return it was written as. Those
|
|
301
|
+
* callbacks run while the node graph is being built, so the `return` only leaves the callback and
|
|
302
|
+
* the node it was building is never assigned anywhere: the branch is dropped and the function keeps
|
|
303
|
+
* whatever its last line said. That is how the coast's `baseColor` ended up returning a flat
|
|
304
|
+
* `vec3(.1)` for every material and its `reflected` returning the sky for every ray. The sources
|
|
305
|
+
* normalise a helper to one final return over `else if` and `Break` instead, so a return still
|
|
306
|
+
* shaped like an early one is a mistake to stop on rather than to compile.
|
|
307
|
+
*/
|
|
308
|
+
function assertNoNestedReturns(code) {
|
|
309
|
+
const file = parse(code);
|
|
310
|
+
const nested = [];
|
|
311
|
+
const walk = (node) => {
|
|
312
|
+
if (ts.isReturnStatement(node)) {
|
|
313
|
+
for (let parent = node.parent; parent; parent = parent.parent) {
|
|
314
|
+
if (isFnBody(parent)) break;
|
|
315
|
+
if (ts.isCallExpression(parent) && (callee(parent) === "If" || callee(parent) === "Loop")) {
|
|
316
|
+
nested.push(node.getText(file).split("\n")[0].trim());
|
|
317
|
+
break;
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
ts.forEachChild(node, walk);
|
|
322
|
+
};
|
|
323
|
+
walk(file);
|
|
324
|
+
if (nested.length > 0) {
|
|
325
|
+
throw new Error(
|
|
326
|
+
`TN_TRANSPILER_NESTED_RETURN: ${nested.length} return(s) inside If/Loop would be dropped at runtime: ${nested.join(" | ")}`,
|
|
327
|
+
);
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
/** Index of the `}` that closes the `{` at `open`, counting braces in the text between them. */
|
|
332
|
+
function closingBrace(text, open) {
|
|
333
|
+
let depth = 0;
|
|
334
|
+
for (let index = open; index < text.length; index += 1) {
|
|
335
|
+
if (text[index] === "{") {
|
|
336
|
+
depth += 1;
|
|
337
|
+
} else if (text[index] === "}") {
|
|
338
|
+
depth -= 1;
|
|
339
|
+
if (depth === 0) return index;
|
|
340
|
+
}
|
|
341
|
+
}
|
|
342
|
+
throw new Error("TN_TRANSPILER_UNCLOSED_BRACE");
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
const LOOP_BOUNDS = /Loop\(\s*\{[^{}]*?((?:start|end):\s*-?\d+(?:\.\d+)?)/g;
|
|
346
|
+
/**
|
|
347
|
+
* `Loop({ start: 0, end: 6 }, …)` leaves the counter's type to be inferred from a bare number, and
|
|
348
|
+
* nothing is left to infer it from. GLSL wrote `int i`, so the bounds are stated as `int` too.
|
|
349
|
+
*/
|
|
350
|
+
function typeLoopBounds(body, injected) {
|
|
351
|
+
const typed = body.replaceAll(LOOP_BOUNDS, (match, bound) =>
|
|
352
|
+
match.replace(bound, `${bound.replace(":", ": int(")})`),
|
|
353
|
+
);
|
|
354
|
+
if (typed === body) throw new Error("TN_TRANSPILER_LOOP_BOUNDS: no bare loop bound was found");
|
|
355
|
+
// The decoder leaves the import list out of it: it emitted a bare number, so it never reached for
|
|
356
|
+
// `int`, and nothing else in a shader with no `int` local would have imported it either.
|
|
357
|
+
injected.add("int");
|
|
358
|
+
return typed;
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
/**
|
|
362
|
+
* The decoder names a loop counter through `params.name`, which `LoopNode` reads and the published
|
|
363
|
+
* types do not declare — their own source leaves that field commented out with a TODO saying it
|
|
364
|
+
* should be typed. The nested pair is therefore written as `Loop`'s two-parameter form, which the
|
|
365
|
+
* types do describe and which `LoopNode` builds from the same two `for` loops, naming the counters
|
|
366
|
+
* `i` and `j`. The GLSL ran both counters over the same range, so the order cannot matter.
|
|
367
|
+
*/
|
|
368
|
+
function flattenNestedLoop(body) {
|
|
369
|
+
const pattern = /Loop\(\s*(\{[^{}]*name: 'j'[^{}]*\}),\s*\(\s*\{\s*j\s*\}\s*\)\s*=>\s*\{/;
|
|
370
|
+
const nested = body.match(pattern);
|
|
371
|
+
if (nested === null)
|
|
372
|
+
throw new Error("TN_TRANSPILER_NO_NESTED_LOOP: the ripple loop changed shape");
|
|
373
|
+
const outerOpen = body.indexOf("{", nested.index + nested[0].length - 1);
|
|
374
|
+
const outerClose = closingBrace(body, outerOpen);
|
|
375
|
+
const innerStart = body.indexOf("Loop(", outerOpen);
|
|
376
|
+
const innerBounds = closingBrace(body, body.indexOf("{", innerStart));
|
|
377
|
+
// The callback's own parameter list is destructured, so its braces come first; the body opens
|
|
378
|
+
// after the arrow, not after the bounds.
|
|
379
|
+
const innerOpen = body.indexOf("{", body.indexOf("=>", innerBounds));
|
|
380
|
+
const innerClose = closingBrace(body, innerOpen);
|
|
381
|
+
const innerParams = body.slice(body.indexOf("{", innerStart), innerBounds + 1);
|
|
382
|
+
const outerParams = nested[1].replace(/\s*name: 'j',?/, "");
|
|
383
|
+
return [
|
|
384
|
+
body.slice(0, nested.index),
|
|
385
|
+
`Loop(${outerParams}, ${innerParams}, ({ i, j }) => {`,
|
|
386
|
+
body.slice(innerOpen + 1, innerClose),
|
|
387
|
+
"});",
|
|
388
|
+
body.slice(body.indexOf(";", outerClose) + 1),
|
|
389
|
+
].join("");
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
/**
|
|
393
|
+
* `Fn(fn, { p: 'vec2', return: 'float' })` states the parameter types as strings, so TypeScript
|
|
394
|
+
* infers nothing from them and settles for `Fn`'s first overload — the one whose callback receives
|
|
395
|
+
* the node builder — and every parameter then arrives typed as a NodeBuilder. Annotating the
|
|
396
|
+
* parameter with the type the layout already names makes that callback incompatible with the
|
|
397
|
+
* builder overload, so the argument-taking overload is the one that matches. No suppression, and the
|
|
398
|
+
* return type still comes from the body rather than being asserted.
|
|
399
|
+
*/
|
|
400
|
+
const FN_SIGNATURE =
|
|
401
|
+
/(export const \w+ = \/\*@__PURE__\*\/ Fn\(\s*\(\s*)((?:\[[^\]]*\]|\w+))(\s*\)\s*=>\s*\{[\s\S]*?\n\}, \{)([^{}]*?)(\} \);)/g;
|
|
402
|
+
function typeCallbackParameters(body) {
|
|
403
|
+
let typed = 0;
|
|
404
|
+
const out = body.replace(FN_SIGNATURE, (match, head, parameters, middle, layout, tail) => {
|
|
405
|
+
const types = [...layout.matchAll(/(\w+)\s*:\s*'(\w+)'/g)]
|
|
406
|
+
.filter(([, name]) => name !== "return")
|
|
407
|
+
.map(([, , type]) => `Node<"${type}">`);
|
|
408
|
+
if (types.length === 0)
|
|
409
|
+
throw new Error("TN_TRANSPILER_NO_PARAMETERS: a function declares none");
|
|
410
|
+
if (types.length > 1 && !parameters.startsWith("[")) {
|
|
411
|
+
throw new Error(
|
|
412
|
+
`TN_TRANSPILER_PARAMETER_COUNT: ${parameters} has no ${types.length} parameters`,
|
|
413
|
+
);
|
|
414
|
+
}
|
|
415
|
+
typed += 1;
|
|
416
|
+
// The transpiler destructures every parameter from an array, so the annotation is a tuple
|
|
417
|
+
// whenever the code destructures and the bare node type when it does not.
|
|
418
|
+
const annotation = parameters.startsWith("[") ? `[ ${types.join(", ")} ]` : types[0];
|
|
419
|
+
return `${head}${parameters}: ${annotation}${middle}${layout}${tail}`;
|
|
420
|
+
});
|
|
421
|
+
if (typed === 0) throw new Error("TN_TRANSPILER_NO_FUNCTIONS: nothing to type");
|
|
422
|
+
return { body: out, typed };
|
|
423
|
+
}
|
|
424
|
+
|
|
425
|
+
function rewriteAll(text, rules, prefix) {
|
|
426
|
+
let out = text;
|
|
427
|
+
for (const rule of rules) {
|
|
428
|
+
const before = out;
|
|
429
|
+
out = out.replaceAll(rule.find, rule.replace);
|
|
430
|
+
if (out === before) throw new Error(`${prefix}_RULE_DEAD: ${rule.what} matched nothing`);
|
|
431
|
+
}
|
|
432
|
+
return out;
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
/** The decoder's own import list, plus whatever this file injected, as the double-quoted form. */
|
|
436
|
+
function mergeTslImport(importLine, injected) {
|
|
437
|
+
// `frameGroup` leads because every bound uniform below is set on it, and the decoder never emits
|
|
438
|
+
// it: it has no reason to, having written the uniforms itself.
|
|
439
|
+
const names = [
|
|
440
|
+
"frameGroup",
|
|
441
|
+
...importLine
|
|
442
|
+
.match(/\{([^}]*)\}/)[1]
|
|
443
|
+
.split(",")
|
|
444
|
+
.map((name) => name.trim())
|
|
445
|
+
.filter((name) => name.length > 0),
|
|
446
|
+
];
|
|
447
|
+
for (const name of injected) if (!names.includes(name)) names.push(name);
|
|
448
|
+
return `import { ${names.join(", ")} } from "three/tsl";`;
|
|
449
|
+
}
|
|
450
|
+
|
|
451
|
+
function generate(config) {
|
|
452
|
+
const target = resolve(here, config.target);
|
|
453
|
+
const raw = readFileSync(resolve(here, config.source), "utf8");
|
|
454
|
+
// The file opens with a provenance note in comment form; the transpiler copies comments through,
|
|
455
|
+
// so it is stripped before parsing rather than carried into the generated module.
|
|
456
|
+
const provenance = raw.match(/^(?:\/\/[^\n]*\n)+/);
|
|
457
|
+
if (provenance === null)
|
|
458
|
+
throw new Error(`${config.marker}_NO_PROVENANCE: the source has no header note`);
|
|
459
|
+
const normalized = rewriteAll(
|
|
460
|
+
raw.slice(provenance[0].length),
|
|
461
|
+
[
|
|
462
|
+
...COMMON_REWRITES,
|
|
463
|
+
{ what: "the GLSL entry point", find: config.entryOpen[0], replace: config.entryOpen[1] },
|
|
464
|
+
...config.entryClose,
|
|
465
|
+
...config.rewrites,
|
|
466
|
+
],
|
|
467
|
+
config.marker,
|
|
468
|
+
);
|
|
469
|
+
|
|
470
|
+
// Uniform types the decoder turns into a TSL node, read before anything is parsed so a name the
|
|
471
|
+
// decoder would drop is still known here.
|
|
472
|
+
const declared = new Map();
|
|
473
|
+
for (const match of normalized.matchAll(/\buniform\s+(\w+)\s+([^;]+);/g)) {
|
|
474
|
+
const [, type, names] = match;
|
|
475
|
+
for (const name of names.split(",")) declared.set(name.trim(), type);
|
|
476
|
+
}
|
|
477
|
+
if (declared.size === 0)
|
|
478
|
+
throw new Error(`${config.marker}_NO_UNIFORMS: the source declares none`);
|
|
479
|
+
|
|
480
|
+
const warnings = [];
|
|
481
|
+
const quiet = (action) => {
|
|
482
|
+
for (const level of ["warn", "error"]) {
|
|
483
|
+
const original = console[level];
|
|
484
|
+
console[level] = (...args) => warnings.push(`${level}: ${args.join(" ")}`);
|
|
485
|
+
try {
|
|
486
|
+
return action();
|
|
487
|
+
} finally {
|
|
488
|
+
console[level] = original;
|
|
489
|
+
}
|
|
490
|
+
}
|
|
491
|
+
};
|
|
492
|
+
const emitted = quiet(() =>
|
|
493
|
+
new Transpiler(new GLSLDecoder(), new TSLEncoder()).parse(normalized),
|
|
494
|
+
);
|
|
495
|
+
if (warnings.length > 0) {
|
|
496
|
+
throw new Error(`${config.marker}_WARNINGS:\n${warnings.join("\n")}`);
|
|
497
|
+
}
|
|
498
|
+
if (!emitted.includes(`export const ${config.entry}`)) {
|
|
499
|
+
throw new Error(`${config.marker}_NO_ENTRY: the entry point was not emitted`);
|
|
500
|
+
}
|
|
501
|
+
|
|
502
|
+
// The decoder writes every global uniform as its own single-line `const`, and puts the TSL import
|
|
503
|
+
// first. Take the import, drop the uniform lines, and re-emit the ones the code actually reads.
|
|
504
|
+
const tslImport = emitted.match(/^import \{[^}]*\} from 'three\/tsl';$/m);
|
|
505
|
+
if (tslImport === null) throw new Error(`${config.marker}_NO_IMPORT: the TSL import is missing`);
|
|
506
|
+
let body = rewriteAll(
|
|
507
|
+
emitted
|
|
508
|
+
.replace(tslImport[0], "")
|
|
509
|
+
.split("\n")
|
|
510
|
+
.filter((line) => !/^const u[A-Za-z0-9]+ = (?:uniform|texture\w*)\(/.test(line))
|
|
511
|
+
.join("\n"),
|
|
512
|
+
config.outputRewrites,
|
|
513
|
+
config.marker,
|
|
514
|
+
);
|
|
515
|
+
|
|
516
|
+
const injected = new Set();
|
|
517
|
+
// A rewrite that substitutes a different TSL call brings its own import with it.
|
|
518
|
+
for (const rule of config.outputRewrites)
|
|
519
|
+
for (const name of rule.imports ?? []) injected.add(name);
|
|
520
|
+
body = typeLoopBounds(body, injected);
|
|
521
|
+
if (config.nestedLoop) {
|
|
522
|
+
body = flattenNestedLoop(body);
|
|
523
|
+
if (/name:\s*'[a-z]'/.test(body)) {
|
|
524
|
+
throw new Error(`${config.marker}_LOOP_NAME: a named loop counter survived the rewrite`);
|
|
525
|
+
}
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
const read = /[^A-Za-z0-9_$]?([A-Za-z_$][A-Za-z0-9_$]*)[^A-Za-z0-9_$]?/g;
|
|
529
|
+
const used = new Set([...body.matchAll(read)].map((match) => match[1]));
|
|
530
|
+
|
|
531
|
+
const threeImports = new Set(["Vector2", "Vector3", "Vector4"]);
|
|
532
|
+
const bound = [];
|
|
533
|
+
const missing = [];
|
|
534
|
+
for (const [name, type] of declared) {
|
|
535
|
+
if (!used.has(name)) continue;
|
|
536
|
+
if (type in DEFAULTS) {
|
|
537
|
+
// `frameGroup`, not the default per-object group: a stack node — every `If`, `Loop` and `Fn`
|
|
538
|
+
// in these shaders — builds through a sub-builder, and a uniform first reached inside one is
|
|
539
|
+
// registered on that sub-builder's group, leaving the shader's uniform struct short of members
|
|
540
|
+
// and the WGSL invalid. One frame-wide buffer, read once per frame, is also what these values
|
|
541
|
+
// are: each shader is a single quad, and every one of them is set by the same call each frame.
|
|
542
|
+
bound.push(
|
|
543
|
+
`export const ${name} = uniform(${DEFAULTS[type]}, "${type}").setGroup(frameGroup);`,
|
|
544
|
+
);
|
|
545
|
+
} else if (config.samplers.includes(type)) {
|
|
546
|
+
const sampler = SAMPLERS[type];
|
|
547
|
+
threeImports.add(sampler.texture);
|
|
548
|
+
// The decoder can only emit a placeholder for a sampler, and a sampled node needs a texture
|
|
549
|
+
// before the graph is built, so the placeholder is a single voxel. It is also the wrong kind
|
|
550
|
+
// of binding for a render target: a pass that is only ever fed to `.value` is no longer in
|
|
551
|
+
// the graph the renderer walks, so it never gets a frame to render into. The binding is
|
|
552
|
+
// therefore a rebindable `let` and the owning module swaps the whole node through
|
|
553
|
+
// `setX(node)` before the entry function is called — the shader's own `Fn` callbacks read
|
|
554
|
+
// it when the graph is built, which is the moment a rebind has to have happened. The sampled
|
|
555
|
+
// UVs and colour space are the caller's, as in any TSL material.
|
|
556
|
+
const setter = `set${name.replace(/^u([A-Z])/, (_, first) => first.toUpperCase())}`;
|
|
557
|
+
bound.push(
|
|
558
|
+
`const ${name}Placeholder = new ${sampler.texture}(new Uint8Array([0, 0, 0, 255]), ${sampler.create});`,
|
|
559
|
+
`${name}Placeholder.needsUpdate = true;`,
|
|
560
|
+
`export let ${name}: TextureNode = ${sampler.node}(${name}Placeholder).setGroup(frameGroup);`,
|
|
561
|
+
`export function ${setter}(value: TextureNode): void {`,
|
|
562
|
+
` ${name} = value;`,
|
|
563
|
+
"}",
|
|
564
|
+
);
|
|
565
|
+
} else {
|
|
566
|
+
missing.push(`${name} (${type})`);
|
|
567
|
+
}
|
|
568
|
+
}
|
|
569
|
+
if (missing.length > 0) {
|
|
570
|
+
throw new Error(
|
|
571
|
+
`${config.marker}_UNBOUND: the shader reads ${missing.join(", ")} with no binding`,
|
|
572
|
+
);
|
|
573
|
+
}
|
|
574
|
+
if (bound.length === 0) throw new Error(`${config.marker}_NO_BOUND_UNIFORMS: nothing is bound`);
|
|
575
|
+
|
|
576
|
+
const { body: annotated, typed } = typeCallbackParameters(body);
|
|
577
|
+
const stripped = stripFnLayout(annotated);
|
|
578
|
+
const materialized = materializeLocals(stripped);
|
|
579
|
+
assertNoNestedReturns(materialized);
|
|
580
|
+
|
|
581
|
+
const mergedImport = mergeTslImport(tslImport[0], injected);
|
|
582
|
+
const header = `// GENERATED FILE — do not edit it. Every line below is the output of Three.js's own GLSL to
|
|
583
|
+
// TSL transpiler, run over tools/${config.source}. That .frag file
|
|
584
|
+
// is the source of truth; change it and the generator, never this file.
|
|
585
|
+
//
|
|
586
|
+
// node tools/generate-shaders.mjs
|
|
587
|
+
//
|
|
588
|
+
${config.header}`;
|
|
589
|
+
const output = [
|
|
590
|
+
header,
|
|
591
|
+
`import { ${[...threeImports].sort().join(", ")} } from "three";`,
|
|
592
|
+
mergedImport,
|
|
593
|
+
`import type { Node, TextureNode } from "three/webgpu";`,
|
|
594
|
+
"",
|
|
595
|
+
"// Uniforms the shader reads. Values are assigned by src/render/world.ts and src/render/clouds.ts,",
|
|
596
|
+
"// which own the camera basis and the weather; the generated module only holds the nodes.",
|
|
597
|
+
...bound,
|
|
598
|
+
"",
|
|
599
|
+
materialized.trim(),
|
|
600
|
+
"",
|
|
601
|
+
].join("\n");
|
|
602
|
+
|
|
603
|
+
// Every name the emitted code calls is either a `three/tsl` import, a uniform, or a function the
|
|
604
|
+
// transpiler itself emitted. Anything else would be a silent ReferenceError in the template, which
|
|
605
|
+
// is the failure this whole check exists to catch.
|
|
606
|
+
const imported = new Set(
|
|
607
|
+
mergedImport
|
|
608
|
+
.match(/\{([^}]*)\}/)[1]
|
|
609
|
+
.split(",")
|
|
610
|
+
.map((name) => name.trim()),
|
|
611
|
+
);
|
|
612
|
+
const called = (text) =>
|
|
613
|
+
new Set(
|
|
614
|
+
[
|
|
615
|
+
...text.replace(/\/\/[^\n]*/g, "").matchAll(/(?<![.\w$])([A-Za-z_$][A-Za-z0-9_$]*)\s*\(/g),
|
|
616
|
+
].map((match) => match[1]),
|
|
617
|
+
);
|
|
618
|
+
const local = new Set(
|
|
619
|
+
[...materialized.matchAll(/(?:const|function)\s+([A-Za-z_$][A-Za-z0-9_$]*)/g)].map((m) => m[1]),
|
|
620
|
+
);
|
|
621
|
+
const unimported = [...called(materialized)].filter(
|
|
622
|
+
(name) => !imported.has(name) && !declared.has(name) && !local.has(name),
|
|
623
|
+
);
|
|
624
|
+
if (unimported.length > 0) {
|
|
625
|
+
throw new Error(
|
|
626
|
+
`${config.marker}_UNIMPORTED: ${unimported.join(", ")} is called but never imported`,
|
|
627
|
+
);
|
|
628
|
+
}
|
|
629
|
+
|
|
630
|
+
mkdirSync(dirname(target), { recursive: true });
|
|
631
|
+
writeFileSync(target, output);
|
|
632
|
+
const formatted = existsSync(biome);
|
|
633
|
+
if (formatted) {
|
|
634
|
+
execFileSync(biome, ["check", "--fix", "--unsafe", relative(repoRoot, target)], {
|
|
635
|
+
cwd: repoRoot,
|
|
636
|
+
stdio: "inherit",
|
|
637
|
+
});
|
|
638
|
+
}
|
|
639
|
+
console.log(
|
|
640
|
+
`${config.marker}:${JSON.stringify({
|
|
641
|
+
declared: declared.size,
|
|
642
|
+
bound: bound.length,
|
|
643
|
+
bytes: output.length,
|
|
644
|
+
dropped: [...declared.keys()].filter(
|
|
645
|
+
(name) => !bound.some((line) => line.includes(` ${name} = `)),
|
|
646
|
+
),
|
|
647
|
+
formatted,
|
|
648
|
+
functions: typed,
|
|
649
|
+
layoutsStripped: typed,
|
|
650
|
+
localsMaterialized: (materialized.match(/\.toVar\(\)/g) ?? []).length,
|
|
651
|
+
warnings: 0,
|
|
652
|
+
})}`,
|
|
653
|
+
);
|
|
654
|
+
}
|
|
655
|
+
|
|
656
|
+
for (const config of SHADERS) generate(config);
|