create-threenative 0.2.7 → 0.2.9
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 +3 -1
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1306 -62
- package/agent-docs/references/debug-surface.md +6 -0
- package/agent-docs/references/finding-assets.md +46 -10
- package/agent-docs/references/performance-basics.md +5 -4
- package/agent-docs/references/terrain-authoring.md +140 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
- package/capabilities.json +1505 -79
- package/dist/index.d.ts +28 -3
- package/dist/index.js +402 -167
- package/dist/threenative.js +989 -237
- package/dist/web-engine-buffer-geometry-utils.js +281 -0
- package/dist/web-engine-decal-geometry.js +184 -0
- package/dist/web-engine-gltf-loader.js +196 -0
- package/dist/web-engine-hdr-loader.js +190 -0
- package/dist/web-engine-lut-cube-loader.js +122 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
- package/dist/web-engine-mesh-bvh.js +32 -0
- package/dist/web-engine-post-effects.js +168 -0
- package/dist/web-engine-runtime.js +42506 -0
- package/package.json +11 -8
- package/template-assets/autoExposure.ts +225 -0
- package/template-assets/exposure.ts +111 -0
- package/template-assets/exposureGraph.ts +178 -0
- package/template-assets/exposureReadback.ts +79 -0
- package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
- package/template-assets/patches/three@0.185.1.patch +6594 -700
- package/template-assets/patches/vite@8.2.0.patch +422 -0
- package/template-assets/worldEnvironment.ts +433 -30
- package/templates/action-rpg/AGENTS.md +11 -10
- package/templates/action-rpg/CLAUDE.md +11 -10
- package/templates/action-rpg/package.json +11 -9
- package/templates/action-rpg/playtests/performance.playtest.json +7 -1
- package/templates/action-rpg/src/progress.ts +0 -4
- package/templates/action-rpg/src/render/autoExposure.ts +225 -0
- package/templates/action-rpg/src/render/backlightControls.ts +66 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
- package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
- package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
- package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
- package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
- package/templates/action-rpg/src/render/exposure.ts +111 -0
- package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
- package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
- package/templates/action-rpg/src/render/heightFog.ts +118 -0
- package/templates/action-rpg/src/render/lighting.ts +26 -1
- package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
- package/templates/action-rpg/src/render/materialLighting.ts +155 -0
- package/templates/action-rpg/src/render/postprocessing.ts +17 -2
- package/templates/action-rpg/src/render/quality.ts +61 -2
- package/templates/action-rpg/src/render/sky.ts +21 -1
- package/templates/action-rpg/src/render/vfx.ts +133 -58
- package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
- package/templates/action-rpg/src/scenes/Play.ts +81 -16
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/action-rpg/vite.config.ts +10 -2
- package/templates/minimal/AGENTS.md +9 -10
- package/templates/minimal/CLAUDE.md +9 -10
- package/templates/minimal/package.json +9 -8
- package/templates/minimal/playtests/play.playtest.json +7 -1
- package/templates/minimal/playtests/sky.playtest.json +10 -1
- package/templates/minimal/src/render/autoExposure.ts +225 -0
- package/templates/minimal/src/render/backlightControls.ts +66 -0
- package/templates/minimal/src/render/backlightMaterial.ts +147 -0
- package/templates/minimal/src/render/environmentContribution.ts +188 -0
- package/templates/minimal/src/render/environmentRadiance.ts +36 -0
- package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
- package/templates/minimal/src/render/environmentSampling.ts +193 -0
- package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
- package/templates/minimal/src/render/exposure.ts +111 -0
- package/templates/minimal/src/render/exposureGraph.ts +178 -0
- package/templates/minimal/src/render/exposureReadback.ts +79 -0
- package/templates/minimal/src/render/heightFog.ts +118 -0
- package/templates/minimal/src/render/lighting.ts +25 -1
- package/templates/minimal/src/render/materialAssignments.ts +102 -0
- package/templates/minimal/src/render/materialLighting.ts +146 -0
- package/templates/minimal/src/render/postprocessing.ts +16 -2
- package/templates/minimal/src/render/quality.ts +60 -2
- package/templates/minimal/src/render/sky.ts +21 -1
- package/templates/minimal/src/render/worldEnvironment.ts +433 -30
- package/templates/minimal/src/scenes/Play.ts +50 -1
- package/templates/minimal/vite.config.ts +10 -2
- package/templates/platformer/AGENTS.md +7 -5
- package/templates/platformer/CLAUDE.md +7 -5
- package/templates/platformer/package.json +11 -9
- package/templates/platformer/playtests/performance.playtest.json +7 -1
- package/templates/platformer/src/render/autoExposure.ts +225 -0
- package/templates/platformer/src/render/backlightControls.ts +66 -0
- package/templates/platformer/src/render/backlightMaterial.ts +147 -0
- package/templates/platformer/src/render/environmentContribution.ts +188 -0
- package/templates/platformer/src/render/environmentRadiance.ts +36 -0
- package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
- package/templates/platformer/src/render/environmentSampling.ts +193 -0
- package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
- package/templates/platformer/src/render/exposure.ts +111 -0
- package/templates/platformer/src/render/exposureGraph.ts +178 -0
- package/templates/platformer/src/render/exposureReadback.ts +79 -0
- package/templates/platformer/src/render/heightFog.ts +118 -0
- package/templates/platformer/src/render/lighting.ts +26 -1
- package/templates/platformer/src/render/materialAssignments.ts +160 -0
- package/templates/platformer/src/render/materialLighting.ts +155 -0
- package/templates/platformer/src/render/materials.ts +7 -2
- package/templates/platformer/src/render/palette.ts +3 -3
- package/templates/platformer/src/render/postprocessing.ts +17 -2
- package/templates/platformer/src/render/quality.ts +61 -2
- package/templates/platformer/src/render/sky.ts +72 -23
- package/templates/platformer/src/render/skyEnvironment.ts +50 -0
- package/templates/platformer/src/render/worldEnvironment.ts +433 -30
- package/templates/platformer/src/scenes/Play.ts +70 -6
- package/templates/platformer/vite.config.ts +10 -2
- package/templates/puzzle/AGENTS.md +10 -9
- package/templates/puzzle/CLAUDE.md +10 -9
- package/templates/puzzle/package.json +11 -9
- package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
- package/templates/puzzle/playtests/lit.playtest.json +7 -1
- package/templates/puzzle/playtests/performance.playtest.json +7 -1
- package/templates/puzzle/src/render/autoExposure.ts +225 -0
- package/templates/puzzle/src/render/backlightControls.ts +66 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
- package/templates/puzzle/src/render/environmentContribution.ts +188 -0
- package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
- package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
- package/templates/puzzle/src/render/environmentSampling.ts +193 -0
- package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
- package/templates/puzzle/src/render/exposure.ts +111 -0
- package/templates/puzzle/src/render/exposureGraph.ts +178 -0
- package/templates/puzzle/src/render/exposureReadback.ts +79 -0
- package/templates/puzzle/src/render/heightFog.ts +118 -0
- package/templates/puzzle/src/render/lighting.ts +33 -1
- package/templates/puzzle/src/render/materialAssignments.ts +160 -0
- package/templates/puzzle/src/render/materialLighting.ts +155 -0
- package/templates/puzzle/src/render/materials.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +8 -2
- package/templates/puzzle/src/render/quality.ts +62 -1
- package/templates/puzzle/src/render/sky.ts +20 -1
- package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
- package/templates/puzzle/src/scenes/Play.ts +51 -2
- package/templates/puzzle/vite.config.ts +10 -2
- package/templates/racing/AGENTS.md +8 -7
- package/templates/racing/CLAUDE.md +8 -7
- package/templates/racing/package.json +11 -9
- package/templates/racing/playtests/performance.playtest.json +7 -1
- package/templates/racing/playtests/survives.playtest.json +6 -0
- package/templates/racing/src/render/autoExposure.ts +225 -0
- package/templates/racing/src/render/backlightControls.ts +66 -0
- package/templates/racing/src/render/backlightMaterial.ts +147 -0
- package/templates/racing/src/render/environmentContribution.ts +188 -0
- package/templates/racing/src/render/environmentRadiance.ts +36 -0
- package/templates/racing/src/render/environmentSampleCache.ts +43 -0
- package/templates/racing/src/render/environmentSampling.ts +193 -0
- package/templates/racing/src/render/environmentSnapshot.ts +53 -0
- package/templates/racing/src/render/exposure.ts +111 -0
- package/templates/racing/src/render/exposureGraph.ts +178 -0
- package/templates/racing/src/render/exposureReadback.ts +79 -0
- package/templates/racing/src/render/heightFog.ts +118 -0
- package/templates/racing/src/render/lighting.ts +29 -1
- package/templates/racing/src/render/materialAssignments.ts +160 -0
- package/templates/racing/src/render/materialLighting.ts +155 -0
- package/templates/racing/src/render/palette.ts +1 -10
- package/templates/racing/src/render/postprocessing.ts +17 -2
- package/templates/racing/src/render/quality.ts +61 -2
- package/templates/racing/src/render/shapes.ts +0 -25
- package/templates/racing/src/render/sky.ts +21 -1
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +91 -3
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +95 -0
- package/templates/rain/CLAUDE.md +97 -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 +23 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +59 -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 +32 -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 +194 -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 +81 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/autoExposure.ts +225 -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/exposure.ts +111 -0
- package/templates/rain/src/render/exposureGraph.ts +178 -0
- package/templates/rain/src/render/exposureReadback.ts +79 -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 +229 -0
- package/templates/rain/src/render/quality.ts +161 -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/rain/src/render/worldEnvironment.ts +1212 -0
- package/templates/rain/src/scenes/Boot.ts +348 -0
- package/templates/rain/src/state.ts +261 -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 +45 -0
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +10 -8
- package/templates/rts/playtests/performance.playtest.json +7 -1
- package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-build.playtest.json +10 -1
- package/templates/rts/playtests/rts-orders.playtest.json +7 -1
- package/templates/rts/playtests/rts-train.playtest.json +10 -1
- package/templates/rts/src/render/army.ts +10 -2
- package/templates/rts/src/render/autoExposure.ts +225 -0
- package/templates/rts/src/render/backlightControls.ts +66 -0
- package/templates/rts/src/render/backlightMaterial.ts +147 -0
- package/templates/rts/src/render/environmentContribution.ts +188 -0
- package/templates/rts/src/render/environmentRadiance.ts +36 -0
- package/templates/rts/src/render/environmentSampleCache.ts +43 -0
- package/templates/rts/src/render/environmentSampling.ts +193 -0
- package/templates/rts/src/render/environmentSnapshot.ts +53 -0
- package/templates/rts/src/render/exposure.ts +111 -0
- package/templates/rts/src/render/exposureGraph.ts +178 -0
- package/templates/rts/src/render/exposureReadback.ts +79 -0
- package/templates/rts/src/render/heightFog.ts +118 -0
- package/templates/rts/src/render/lighting.ts +26 -1
- package/templates/rts/src/render/materialAssignments.ts +160 -0
- package/templates/rts/src/render/materialLighting.ts +155 -0
- package/templates/rts/src/render/postprocessing.ts +8 -2
- package/templates/rts/src/render/quality.ts +61 -2
- package/templates/rts/src/render/sky.ts +21 -1
- package/templates/rts/src/render/worldEnvironment.ts +433 -30
- package/templates/rts/src/scenes/Play.ts +54 -3
- package/templates/rts/src/sim/ai.ts +0 -1
- package/templates/rts/src/sim/terrain.ts +0 -4
- package/templates/rts/vite.config.ts +10 -2
- package/templates/runner/AGENTS.md +10 -8
- package/templates/runner/CLAUDE.md +10 -8
- package/templates/runner/package.json +11 -9
- package/templates/runner/playtests/performance.playtest.json +10 -1
- package/templates/runner/src/physics.ts +0 -1
- package/templates/runner/src/render/autoExposure.ts +225 -0
- package/templates/runner/src/render/backlightControls.ts +66 -0
- package/templates/runner/src/render/backlightMaterial.ts +147 -0
- package/templates/runner/src/render/environmentContribution.ts +188 -0
- package/templates/runner/src/render/environmentRadiance.ts +36 -0
- package/templates/runner/src/render/environmentSampleCache.ts +43 -0
- package/templates/runner/src/render/environmentSampling.ts +193 -0
- package/templates/runner/src/render/environmentSnapshot.ts +53 -0
- package/templates/runner/src/render/exposure.ts +111 -0
- package/templates/runner/src/render/exposureGraph.ts +178 -0
- package/templates/runner/src/render/exposureReadback.ts +79 -0
- package/templates/runner/src/render/heightFog.ts +118 -0
- package/templates/runner/src/render/lighting.ts +26 -1
- package/templates/runner/src/render/materialAssignments.ts +160 -0
- package/templates/runner/src/render/materialLighting.ts +155 -0
- package/templates/runner/src/render/postprocessing.ts +17 -2
- package/templates/runner/src/render/quality.ts +61 -2
- package/templates/runner/src/render/sky.ts +21 -1
- package/templates/runner/src/render/worldEnvironment.ts +433 -30
- package/templates/runner/src/scenes/Run.ts +67 -2
- package/templates/runner/threenative.config.ts +3 -0
- package/templates/runner/vite.config.ts +10 -2
- package/templates/sailing/AGENTS.md +14 -13
- package/templates/sailing/CLAUDE.md +14 -13
- package/templates/sailing/native-playtests/survives.playtest.json +7 -0
- package/templates/sailing/package.json +11 -9
- package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
- package/templates/sailing/src/entities/Ship.ts +38 -18
- package/templates/sailing/src/render/autoExposure.ts +225 -0
- package/templates/sailing/src/render/backlightControls.ts +66 -0
- package/templates/sailing/src/render/backlightMaterial.ts +147 -0
- package/templates/sailing/src/render/camera.ts +12 -4
- package/templates/sailing/src/render/environmentContribution.ts +188 -0
- package/templates/sailing/src/render/environmentRadiance.ts +36 -0
- package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
- package/templates/sailing/src/render/environmentSampling.ts +193 -0
- package/templates/sailing/src/render/environmentSetup.ts +24 -0
- package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
- package/templates/sailing/src/render/exposure.ts +111 -0
- package/templates/sailing/src/render/exposureGraph.ts +178 -0
- package/templates/sailing/src/render/exposureReadback.ts +79 -0
- package/templates/sailing/src/render/heightFog.ts +118 -0
- package/templates/sailing/src/render/lighting.ts +26 -1
- package/templates/sailing/src/render/materialAssignments.ts +160 -0
- package/templates/sailing/src/render/materialLighting.ts +155 -0
- package/templates/sailing/src/render/ocean.ts +71 -53
- package/templates/sailing/src/render/postprocessing.ts +16 -2
- package/templates/sailing/src/render/props.ts +0 -45
- package/templates/sailing/src/render/quality.ts +61 -1
- package/templates/sailing/src/render/sky.ts +21 -1
- package/templates/sailing/src/render/worldEnvironment.ts +433 -30
- package/templates/sailing/src/scenes/Boot.ts +12 -1
- package/templates/sailing/src/scenes/Sailing.ts +87 -2
- package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
- package/templates/sailing/threenative.config.ts +3 -0
- package/templates/sailing/vite.config.ts +10 -2
- package/templates/shooter/AGENTS.md +8 -6
- package/templates/shooter/CLAUDE.md +8 -6
- package/templates/shooter/package.json +11 -9
- package/templates/shooter/playtests/performance.playtest.json +7 -1
- package/templates/shooter/src/entities/Enemy.ts +0 -15
- package/templates/shooter/src/entities/Rifle.ts +38 -1
- package/templates/shooter/src/render/autoExposure.ts +225 -0
- package/templates/shooter/src/render/backlightControls.ts +66 -0
- package/templates/shooter/src/render/backlightMaterial.ts +147 -0
- package/templates/shooter/src/render/camera.ts +1 -12
- package/templates/shooter/src/render/decals.ts +299 -5
- package/templates/shooter/src/render/environmentContribution.ts +188 -0
- package/templates/shooter/src/render/environmentRadiance.ts +36 -0
- package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
- package/templates/shooter/src/render/environmentSampling.ts +193 -0
- package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
- package/templates/shooter/src/render/exposure.ts +111 -0
- package/templates/shooter/src/render/exposureGraph.ts +178 -0
- package/templates/shooter/src/render/exposureReadback.ts +79 -0
- package/templates/shooter/src/render/gunfx.ts +0 -1
- package/templates/shooter/src/render/heightFog.ts +118 -0
- package/templates/shooter/src/render/lighting.ts +26 -1
- package/templates/shooter/src/render/materialAssignments.ts +160 -0
- package/templates/shooter/src/render/materialLighting.ts +155 -0
- package/templates/shooter/src/render/postprocessing.ts +17 -2
- package/templates/shooter/src/render/quality.ts +61 -2
- package/templates/shooter/src/render/scale.ts +2 -93
- package/templates/shooter/src/render/sky.ts +21 -1
- package/templates/shooter/src/render/vehicles.ts +0 -17
- package/templates/shooter/src/render/worldEnvironment.ts +433 -30
- package/templates/shooter/src/scenes/Play.ts +64 -2
- package/templates/shooter/vite.config.ts +10 -2
- 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 +90 -0
- package/templates/snow/CLAUDE.md +92 -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 +60 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- 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/autoExposure.ts +225 -0
- package/templates/snow/src/render/backlightControls.ts +66 -0
- package/templates/snow/src/render/backlightMaterial.ts +147 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/environmentContribution.ts +188 -0
- package/templates/snow/src/render/environmentRadiance.ts +36 -0
- package/templates/snow/src/render/environmentSampleCache.ts +43 -0
- package/templates/snow/src/render/environmentSampling.ts +193 -0
- package/templates/snow/src/render/environmentSnapshot.ts +53 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/exposure.ts +111 -0
- package/templates/snow/src/render/exposureGraph.ts +178 -0
- package/templates/snow/src/render/exposureReadback.ts +79 -0
- package/templates/snow/src/render/heightFog.ts +118 -0
- package/templates/snow/src/render/lighting.ts +82 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +58 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +193 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +76 -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 +1212 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +663 -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 +54 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +45 -0
- package/templates/starter/AGENTS.md +11 -16
- package/templates/starter/CLAUDE.md +11 -16
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
- package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
- package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
- package/templates/starter/package.json +11 -9
- package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
- package/templates/starter/playtests/movement.playtest.json +192 -0
- package/templates/starter/playtests/play.playtest.json +18 -2
- package/templates/starter/playtests/production-readiness.playtest.json +1 -1
- package/templates/starter/public/grade.cube +735 -0
- package/templates/starter/src/entities/Crate.ts +4 -0
- package/templates/starter/src/entities/Player.ts +79 -18
- package/templates/starter/src/game.ts +1 -0
- package/templates/starter/src/render/adaptiveQuality.ts +28 -41
- package/templates/starter/src/render/autoExposure.ts +225 -0
- package/templates/starter/src/render/backlightControls.ts +66 -0
- package/templates/starter/src/render/backlightMaterial.ts +147 -0
- package/templates/starter/src/render/environmentContribution.ts +188 -0
- package/templates/starter/src/render/environmentRadiance.ts +36 -0
- package/templates/starter/src/render/environmentSampleCache.ts +43 -0
- package/templates/starter/src/render/environmentSampling.ts +193 -0
- package/templates/starter/src/render/environmentSnapshot.ts +53 -0
- package/templates/starter/src/render/exposure.ts +111 -0
- package/templates/starter/src/render/exposureGraph.ts +178 -0
- package/templates/starter/src/render/exposureReadback.ts +79 -0
- package/templates/starter/src/render/grade.ts +157 -0
- package/templates/starter/src/render/heightFog.ts +118 -0
- package/templates/starter/src/render/lighting.ts +26 -1
- package/templates/starter/src/render/materialAssignments.ts +160 -0
- package/templates/starter/src/render/materialLighting.ts +155 -0
- package/templates/starter/src/render/postprocessing.ts +84 -4
- package/templates/starter/src/render/quality.ts +80 -8
- package/templates/starter/src/render/qualityPolicy.ts +54 -0
- package/templates/starter/src/render/rendererGate.ts +36 -0
- package/templates/starter/src/render/sky.ts +23 -1
- package/templates/starter/src/render/temporalAA.ts +197 -0
- package/templates/starter/src/render/temporalAAFrame.ts +179 -0
- package/templates/starter/src/render/temporalAAHooks.ts +101 -0
- package/templates/starter/src/render/temporalAAInput.ts +56 -0
- package/templates/starter/src/render/temporalAAResolve.ts +65 -0
- package/templates/starter/src/render/temporalAAStage.ts +76 -0
- package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
- package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
- package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
- package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
- package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
- package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
- package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
- package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
- package/templates/starter/src/render/temporalResolve.ts +139 -0
- package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
- package/templates/starter/src/render/temporalResolveMath.ts +196 -0
- package/templates/starter/src/render/volumetricFog.ts +124 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
- package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
- package/templates/starter/src/render/worldEnvironment.ts +433 -30
- package/templates/starter/src/scenes/Play.ts +110 -1
- package/templates/starter/src/state.ts +1 -0
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/ui/Menu.tsx +1 -1
- package/templates/starter/tools/make-grade-lut.mjs +101 -0
- package/templates/starter/vite.config.ts +10 -2
- package/templates/tower-defense/AGENTS.md +10 -9
- package/templates/tower-defense/CLAUDE.md +10 -9
- package/templates/tower-defense/package.json +11 -9
- package/templates/tower-defense/playtests/performance.playtest.json +7 -1
- package/templates/tower-defense/src/render/autoExposure.ts +225 -0
- package/templates/tower-defense/src/render/backlightControls.ts +66 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
- package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
- package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
- package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
- package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
- package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
- package/templates/tower-defense/src/render/exposure.ts +111 -0
- package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
- package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
- package/templates/tower-defense/src/render/lighting.ts +33 -1
- package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
- package/templates/tower-defense/src/render/materialLighting.ts +155 -0
- package/templates/tower-defense/src/render/postprocessing.ts +8 -2
- package/templates/tower-defense/src/render/quality.ts +61 -2
- package/templates/tower-defense/src/render/shapes.ts +0 -3
- package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
- package/templates/tower-defense/src/scenes/Battle.ts +65 -2
- package/templates/tower-defense/vite.config.ts +10 -2
- package/templates/minimal/src/scenes/Boot.ts +0 -5
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
export type CameraView = "follow" | "surface" | "overhead";
|
|
2
|
+
|
|
3
|
+
export type GameState = {
|
|
4
|
+
uiReady: boolean;
|
|
5
|
+
paused: boolean;
|
|
6
|
+
/** The explorer walks the glade on its own until a movement key or the stick takes over. */
|
|
7
|
+
autoExplore: boolean;
|
|
8
|
+
blizzard: boolean;
|
|
9
|
+
/** 0 clear .. 1 full blizzard, eased, so the HUD and the weather agree mid-transition. */
|
|
10
|
+
storm: number;
|
|
11
|
+
/** Flake density, 0..1. */
|
|
12
|
+
snowfall: number;
|
|
13
|
+
/** Powder depth in metres. */
|
|
14
|
+
depth: number;
|
|
15
|
+
/** Falling speed of a flake in still air, m/s. */
|
|
16
|
+
fallSpeed: number;
|
|
17
|
+
/** 0..1 snow hardness. */
|
|
18
|
+
hardness: number;
|
|
19
|
+
/** Base wind in m/s before gusts and the storm. */
|
|
20
|
+
wind: number;
|
|
21
|
+
/** The wind actually blowing this frame, m/s. */
|
|
22
|
+
windNow: number;
|
|
23
|
+
/** How many times faster than real time fresh snow refills tracks. */
|
|
24
|
+
recovery: number;
|
|
25
|
+
compaction: boolean;
|
|
26
|
+
muted: boolean;
|
|
27
|
+
view: CameraView;
|
|
28
|
+
/** Contacts the field has taken since the last reset — footsteps and bodies together. */
|
|
29
|
+
contacts: number;
|
|
30
|
+
/** The last footfall's penetration, metres. */
|
|
31
|
+
lastSink: number;
|
|
32
|
+
speed: number;
|
|
33
|
+
/** Indentation under the last footfall, `PROBE_COLUMNS` x `PROBE_ROWS`, row-major, metres. */
|
|
34
|
+
probe: number[];
|
|
35
|
+
/** How far the ball's underside sits above (positive) or in (negative) the snow, metres. */
|
|
36
|
+
ballGap: number;
|
|
37
|
+
/** Indentation under the ball, metres. */
|
|
38
|
+
ballSink: number;
|
|
39
|
+
/** Load the ball's solved contacts pressed into the snow last step, newtons. */
|
|
40
|
+
ballLoad: number;
|
|
41
|
+
toast: string;
|
|
42
|
+
toastId: number;
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
export const PROBE_COLUMNS = 15;
|
|
46
|
+
export const PROBE_ROWS = 20;
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
@import "tailwindcss";
|
|
2
|
+
|
|
3
|
+
@theme {
|
|
4
|
+
--font-sans: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
5
|
+
--color-ink: #0c1c28;
|
|
6
|
+
--color-panel: rgb(18 36 47 / 0.8);
|
|
7
|
+
--color-text: #eef5f7;
|
|
8
|
+
--color-muted: #a7bac4;
|
|
9
|
+
--color-line: rgb(210 230 240 / 0.18);
|
|
10
|
+
--color-aqua: #b6eadd;
|
|
11
|
+
--color-aqua-ink: #163a37;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
:root,
|
|
15
|
+
body,
|
|
16
|
+
#root {
|
|
17
|
+
height: 100%;
|
|
18
|
+
margin: 0;
|
|
19
|
+
overflow: hidden;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
body {
|
|
23
|
+
color: var(--color-text);
|
|
24
|
+
font-family: var(--font-sans);
|
|
25
|
+
-webkit-font-smoothing: antialiased;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
#root {
|
|
29
|
+
background: #aabfcf;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/* Every control shows where keyboard focus is. */
|
|
33
|
+
:where(button, input, select, summary, [tabindex]):focus-visible {
|
|
34
|
+
outline: 2px solid var(--color-aqua);
|
|
35
|
+
outline-offset: 3px;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/* A slider whose filled part is the accent: `--fill` is set from the value. */
|
|
39
|
+
.snow-range {
|
|
40
|
+
-webkit-appearance: none;
|
|
41
|
+
appearance: none;
|
|
42
|
+
width: 100%;
|
|
43
|
+
height: 24px;
|
|
44
|
+
background: transparent;
|
|
45
|
+
cursor: pointer;
|
|
46
|
+
}
|
|
47
|
+
.snow-range::-webkit-slider-runnable-track {
|
|
48
|
+
height: 3px;
|
|
49
|
+
border-radius: 99px;
|
|
50
|
+
background: linear-gradient(
|
|
51
|
+
to right,
|
|
52
|
+
var(--color-aqua) var(--fill, 50%),
|
|
53
|
+
rgb(177 205 218 / 0.18) var(--fill, 50%)
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
.snow-range::-moz-range-track {
|
|
57
|
+
height: 3px;
|
|
58
|
+
border-radius: 99px;
|
|
59
|
+
background: rgb(177 205 218 / 0.18);
|
|
60
|
+
}
|
|
61
|
+
.snow-range::-moz-range-progress {
|
|
62
|
+
height: 3px;
|
|
63
|
+
border-radius: 99px;
|
|
64
|
+
background: var(--color-aqua);
|
|
65
|
+
}
|
|
66
|
+
.snow-range::-webkit-slider-thumb {
|
|
67
|
+
-webkit-appearance: none;
|
|
68
|
+
width: 14px;
|
|
69
|
+
height: 14px;
|
|
70
|
+
margin-top: -5.5px;
|
|
71
|
+
border-radius: 50%;
|
|
72
|
+
border: 2px solid #12303a;
|
|
73
|
+
background: var(--color-aqua);
|
|
74
|
+
}
|
|
75
|
+
.snow-range::-moz-range-thumb {
|
|
76
|
+
width: 12px;
|
|
77
|
+
height: 12px;
|
|
78
|
+
border-radius: 50%;
|
|
79
|
+
border: 2px solid #12303a;
|
|
80
|
+
background: var(--color-aqua);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
@media (prefers-reduced-motion: reduce) {
|
|
84
|
+
*,
|
|
85
|
+
*::before,
|
|
86
|
+
*::after {
|
|
87
|
+
transition-duration: 0s !important;
|
|
88
|
+
animation-duration: 0s !important;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/* Boot failures are a page state, so the generated game owns their presentation. */
|
|
93
|
+
[data-threenative-canvas-error="true"] {
|
|
94
|
+
position: fixed;
|
|
95
|
+
inset: 0;
|
|
96
|
+
z-index: 1000;
|
|
97
|
+
display: grid;
|
|
98
|
+
place-items: center;
|
|
99
|
+
box-sizing: border-box;
|
|
100
|
+
padding: clamp(1.5rem, 8vw, 6rem);
|
|
101
|
+
overflow: auto;
|
|
102
|
+
background: #0c1c28;
|
|
103
|
+
color: #eef5f7;
|
|
104
|
+
font-family: inherit;
|
|
105
|
+
font-size: clamp(1rem, 2vw, 1.5rem);
|
|
106
|
+
line-height: 1.5;
|
|
107
|
+
text-align: center;
|
|
108
|
+
white-space: pre-wrap;
|
|
109
|
+
overflow-wrap: anywhere;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
113
|
+
[data-threenative-debug-overlay="true"] {
|
|
114
|
+
position: fixed;
|
|
115
|
+
top: 1rem;
|
|
116
|
+
right: 1rem;
|
|
117
|
+
z-index: 50;
|
|
118
|
+
max-width: 24rem;
|
|
119
|
+
padding: 0.75rem;
|
|
120
|
+
pointer-events: none;
|
|
121
|
+
background: rgb(2 6 23 / 90%);
|
|
122
|
+
box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
|
|
123
|
+
color: #cffafe;
|
|
124
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
125
|
+
font-size: 12px;
|
|
126
|
+
line-height: 1.5;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
[data-threenative-debug-overlay="true"] table {
|
|
130
|
+
width: 100%;
|
|
131
|
+
table-layout: fixed;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
[data-threenative-debug-overlay="true"] th,
|
|
135
|
+
[data-threenative-debug-overlay="true"] td {
|
|
136
|
+
padding-right: 1rem;
|
|
137
|
+
text-align: left;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
[data-threenative-debug-overlay="true"] td:last-child {
|
|
141
|
+
overflow-wrap: anywhere;
|
|
142
|
+
word-break: break-all;
|
|
143
|
+
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { Heightfield, SnowField } from "@threenative/core/world";
|
|
2
|
+
|
|
3
|
+
/** The playable snowfield is a square this many metres across, centred on the origin. */
|
|
4
|
+
export const FIELD_SIZE = 24;
|
|
5
|
+
/**
|
|
6
|
+
* Samples along each side. 401 puts one every 6 cm, fine enough for a boot's heel and toe and
|
|
7
|
+
* the gap between two prints to read. The same samples are the drawn mesh and the collider, so
|
|
8
|
+
* raising it costs triangles and collider rebuilds as well.
|
|
9
|
+
*/
|
|
10
|
+
export const FIELD_SAMPLES = 401;
|
|
11
|
+
/**
|
|
12
|
+
* What the explorer's capsule stands on: the ground plus fresh snow, one sample every 24 cm.
|
|
13
|
+
* Rapier sweeps a character's capsule against every collider triangle under it, so on the 6 cm
|
|
14
|
+
* snow collider each step cost ~0.9 ms (measured); here it is a tenth of that. The body's drawn
|
|
15
|
+
* height and its boots already come from the canonical snow, so nothing visible changes.
|
|
16
|
+
*/
|
|
17
|
+
export const WALK_SAMPLES = 101;
|
|
18
|
+
/** Collision layers: the deforming snow, the explorer's walk surface, and the explorer. */
|
|
19
|
+
export const SNOW_LAYER = 0b10;
|
|
20
|
+
export const WALK_LAYER = 0b100;
|
|
21
|
+
export const EXPLORER_LAYER = 0b1000;
|
|
22
|
+
|
|
23
|
+
function smoothstep(edge0: number, edge1: number, value: number): number {
|
|
24
|
+
const t = Math.max(0, Math.min(1, (value - edge0) / (edge1 - edge0)));
|
|
25
|
+
return t * t * (3 - 2 * t);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/** Rolling ground under the snow: gentle swells in the glade, hills beyond it. */
|
|
29
|
+
export function terrainHeight(x: number, z: number): number {
|
|
30
|
+
const radius = Math.hypot(x, z);
|
|
31
|
+
const hills =
|
|
32
|
+
smoothstep(14, 42, radius) * (0.8 + 0.85 * Math.sin(x * 0.085 + 1) * Math.cos(z * 0.075));
|
|
33
|
+
return (
|
|
34
|
+
0.2 * Math.sin(x * 0.16) * Math.cos(z * 0.12) +
|
|
35
|
+
0.09 * Math.sin(x * 0.39 + z * 0.21) +
|
|
36
|
+
0.07 * Math.cos(z * 0.53 - x * 0.24) +
|
|
37
|
+
hills
|
|
38
|
+
);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** The ground plus `depth` of fresh snow at `WALK_SAMPLES`, in collider order. */
|
|
42
|
+
export function walkSurface(depth: number): Heightfield {
|
|
43
|
+
return Heightfield.fromSampler({
|
|
44
|
+
columns: WALK_SAMPLES,
|
|
45
|
+
depth: FIELD_SIZE,
|
|
46
|
+
origin: { x: 0, z: 0 },
|
|
47
|
+
rows: WALK_SAMPLES,
|
|
48
|
+
sampleHeight: (x, z) => terrainHeight(x, z) + depth,
|
|
49
|
+
width: FIELD_SIZE,
|
|
50
|
+
});
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** The canonical terrain and the deformable snow on it. Response coefficients are the study's. */
|
|
54
|
+
export function createSnowfield(depth: number, hardness: number): SnowField {
|
|
55
|
+
const field = Heightfield.fromSampler({
|
|
56
|
+
columns: FIELD_SAMPLES,
|
|
57
|
+
depth: FIELD_SIZE,
|
|
58
|
+
origin: { x: 0, z: 0 },
|
|
59
|
+
rows: FIELD_SAMPLES,
|
|
60
|
+
sampleHeight: terrainHeight,
|
|
61
|
+
width: FIELD_SIZE,
|
|
62
|
+
});
|
|
63
|
+
return new SnowField({ depth, field, hardness });
|
|
64
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { IGame } from "@threenative/core";
|
|
2
|
+
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
|
+
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
4
|
+
import type { GameState } from "../state.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
6
|
+
|
|
7
|
+
export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
8
|
+
return (
|
|
9
|
+
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
10
|
+
<GameCanvas className="absolute inset-0" game={game} />
|
|
11
|
+
<GameUi />
|
|
12
|
+
<DebugOverlay />
|
|
13
|
+
</main>
|
|
14
|
+
);
|
|
15
|
+
}
|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
import type { useUiIntent } from "@threenative/ui";
|
|
2
|
+
import { type ReactNode, useEffect, useState } from "react";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
import { Icon } from "./icons.js";
|
|
5
|
+
|
|
6
|
+
type Send = ReturnType<typeof useUiIntent>;
|
|
7
|
+
|
|
8
|
+
interface IRangeProps {
|
|
9
|
+
readonly id: keyof GameState & string;
|
|
10
|
+
readonly label: string;
|
|
11
|
+
readonly value: number;
|
|
12
|
+
readonly min: number;
|
|
13
|
+
readonly max: number;
|
|
14
|
+
readonly step: number;
|
|
15
|
+
readonly format: (value: number) => string;
|
|
16
|
+
readonly send: Send;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* A labelled slider. It keeps its own value while dragged — the game's state comes back on a
|
|
21
|
+
* ~100 ms bridge, and a slider bound straight to it would jump under the thumb.
|
|
22
|
+
*/
|
|
23
|
+
function Range({ id, label, value, min, max, step, format, send }: IRangeProps) {
|
|
24
|
+
const [local, setLocal] = useState(value);
|
|
25
|
+
const [dragging, setDragging] = useState(false);
|
|
26
|
+
useEffect(() => {
|
|
27
|
+
if (!dragging) setLocal(value);
|
|
28
|
+
}, [dragging, value]);
|
|
29
|
+
const fill = `${((local - min) / (max - min)) * 100}%`;
|
|
30
|
+
return (
|
|
31
|
+
<div className="my-4 first:mt-0 [@media(max-height:800px)]:my-2">
|
|
32
|
+
<label className="flex items-baseline justify-between text-[11px] text-text" htmlFor={id}>
|
|
33
|
+
<span>{label}</span>
|
|
34
|
+
<output className="text-[10px] tabular-nums text-muted" htmlFor={id}>
|
|
35
|
+
{format(local)}
|
|
36
|
+
</output>
|
|
37
|
+
</label>
|
|
38
|
+
<input
|
|
39
|
+
className="snow-range mt-1.5 max-[850px]:h-11"
|
|
40
|
+
data-tn-interactive
|
|
41
|
+
id={id}
|
|
42
|
+
max={max}
|
|
43
|
+
min={min}
|
|
44
|
+
onBlur={() => setDragging(false)}
|
|
45
|
+
onChange={(event) => {
|
|
46
|
+
const next = Number(event.currentTarget.value);
|
|
47
|
+
setLocal(next);
|
|
48
|
+
send("set", { key: id, value: next });
|
|
49
|
+
}}
|
|
50
|
+
onPointerDown={() => setDragging(true)}
|
|
51
|
+
onPointerUp={() => setDragging(false)}
|
|
52
|
+
step={step}
|
|
53
|
+
style={{ "--fill": fill } as React.CSSProperties}
|
|
54
|
+
type="range"
|
|
55
|
+
value={local}
|
|
56
|
+
/>
|
|
57
|
+
</div>
|
|
58
|
+
);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function Toggle({
|
|
62
|
+
label,
|
|
63
|
+
pressed,
|
|
64
|
+
onToggle,
|
|
65
|
+
}: {
|
|
66
|
+
readonly label: string;
|
|
67
|
+
readonly pressed: boolean;
|
|
68
|
+
readonly onToggle: () => void;
|
|
69
|
+
}) {
|
|
70
|
+
return (
|
|
71
|
+
<div className="flex min-h-11 items-center justify-between text-[11px] text-text">
|
|
72
|
+
<span id="compaction-label">{label}</span>
|
|
73
|
+
{/* The 44 px button is the hit area; the switch drawn inside it stays small. */}
|
|
74
|
+
<button
|
|
75
|
+
aria-labelledby="compaction-label"
|
|
76
|
+
aria-pressed={pressed}
|
|
77
|
+
className="-mr-2 grid h-11 w-14 place-items-center"
|
|
78
|
+
data-tn-interactive
|
|
79
|
+
onClick={onToggle}
|
|
80
|
+
type="button"
|
|
81
|
+
>
|
|
82
|
+
<span
|
|
83
|
+
className={`relative block h-[22px] w-[38px] rounded-full border transition-colors ${
|
|
84
|
+
pressed ? "border-aqua bg-aqua/80" : "border-line bg-black/20"
|
|
85
|
+
}`}
|
|
86
|
+
>
|
|
87
|
+
<span
|
|
88
|
+
className={`absolute top-[3px] left-0 h-[14px] w-[14px] rounded-full bg-text transition-transform ${
|
|
89
|
+
pressed ? "translate-x-[19px]" : "translate-x-[3px]"
|
|
90
|
+
}`}
|
|
91
|
+
/>
|
|
92
|
+
</span>
|
|
93
|
+
</button>
|
|
94
|
+
</div>
|
|
95
|
+
);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function ActionButton({
|
|
99
|
+
children,
|
|
100
|
+
grow = false,
|
|
101
|
+
label,
|
|
102
|
+
onClick,
|
|
103
|
+
primary = false,
|
|
104
|
+
pressed,
|
|
105
|
+
title,
|
|
106
|
+
}: {
|
|
107
|
+
readonly children: ReactNode;
|
|
108
|
+
/** Take the row's spare width, so a row of buttons spans its panel. */
|
|
109
|
+
readonly grow?: boolean;
|
|
110
|
+
readonly label?: string;
|
|
111
|
+
readonly onClick: () => void;
|
|
112
|
+
readonly primary?: boolean;
|
|
113
|
+
readonly pressed?: boolean;
|
|
114
|
+
readonly title?: string;
|
|
115
|
+
}) {
|
|
116
|
+
return (
|
|
117
|
+
<button
|
|
118
|
+
aria-label={label}
|
|
119
|
+
aria-pressed={pressed}
|
|
120
|
+
className={`flex min-h-11 items-center justify-center gap-2 rounded-[9px] border px-3 text-[11px] backdrop-blur-md transition hover:brightness-110 ${grow ? "flex-1" : ""} ${
|
|
121
|
+
primary
|
|
122
|
+
? "border-[rgb(212_251_236/0.7)] bg-aqua/90 text-aqua-ink"
|
|
123
|
+
: "border-line bg-[rgb(20_39_50/0.7)] text-text"
|
|
124
|
+
}`}
|
|
125
|
+
data-tn-interactive
|
|
126
|
+
onClick={onClick}
|
|
127
|
+
title={title}
|
|
128
|
+
type="button"
|
|
129
|
+
>
|
|
130
|
+
{children}
|
|
131
|
+
</button>
|
|
132
|
+
);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/** Drop the ball in front of the explorer, or push it away. */
|
|
136
|
+
export function BallActions({ send }: { readonly send: Send }) {
|
|
137
|
+
return (
|
|
138
|
+
<div className="grid grid-cols-2 gap-2">
|
|
139
|
+
<ActionButton
|
|
140
|
+
label="Drop the ball in front of you"
|
|
141
|
+
onClick={() => send("drop")}
|
|
142
|
+
title="Drop the ball in front of you (F)"
|
|
143
|
+
>
|
|
144
|
+
<Icon name="drop" />
|
|
145
|
+
<span className="whitespace-nowrap">Drop</span>
|
|
146
|
+
</ActionButton>
|
|
147
|
+
<ActionButton
|
|
148
|
+
label="Push the ball away from you"
|
|
149
|
+
onClick={() => send("kick")}
|
|
150
|
+
title="Push the ball away from you (G)"
|
|
151
|
+
>
|
|
152
|
+
<Icon name="push" />
|
|
153
|
+
<span className="whitespace-nowrap">Push</span>
|
|
154
|
+
</ActionButton>
|
|
155
|
+
</div>
|
|
156
|
+
);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** Weather, snow and session controls: the panel on the left, or the sheet on a phone. */
|
|
160
|
+
export function Controls({ state, send }: { readonly state: GameState; readonly send: Send }) {
|
|
161
|
+
const percent = (value: number) => `${Math.round(value * 100)}%`;
|
|
162
|
+
return (
|
|
163
|
+
<div className="flex flex-col gap-3">
|
|
164
|
+
<section
|
|
165
|
+
aria-label="Weather and snow"
|
|
166
|
+
className="rounded-[15px] border border-line bg-panel px-5 pb-2 pt-5 [@media(max-height:800px)]:pt-4 shadow-[0_12px_45px_rgb(13_31_43/0.08)] backdrop-blur-xl"
|
|
167
|
+
>
|
|
168
|
+
<div className="flex items-center justify-between text-[10px] uppercase tracking-[0.2em] text-muted">
|
|
169
|
+
<span>Weather</span>
|
|
170
|
+
<kbd className="rounded border border-line px-1.5 font-sans text-[10px] tracking-normal">
|
|
171
|
+
B
|
|
172
|
+
</kbd>
|
|
173
|
+
</div>
|
|
174
|
+
<fieldset className="m-0 mb-5 mt-3 grid min-w-0 grid-cols-2 border-0 [@media(max-height:800px)]:mb-3 gap-1 rounded-[9px] bg-[rgb(5_18_26/0.37)] p-1">
|
|
175
|
+
<legend className="sr-only">Weather</legend>
|
|
176
|
+
{([false, true] as const).map((blizzard) => (
|
|
177
|
+
<button
|
|
178
|
+
aria-pressed={state.blizzard === blizzard}
|
|
179
|
+
className={`flex min-h-10 items-center justify-center gap-2 rounded-md px-1 text-[11px] transition-colors max-[850px]:min-h-11 ${
|
|
180
|
+
state.blizzard === blizzard ? "bg-aqua text-aqua-ink" : "text-muted hover:text-text"
|
|
181
|
+
}`}
|
|
182
|
+
data-tn-interactive
|
|
183
|
+
key={String(blizzard)}
|
|
184
|
+
onClick={() => {
|
|
185
|
+
if (state.blizzard !== blizzard) send("blizzard");
|
|
186
|
+
}}
|
|
187
|
+
type="button"
|
|
188
|
+
>
|
|
189
|
+
<Icon name={blizzard ? "blizzard" : "snow"} />
|
|
190
|
+
{blizzard ? "Blizzard" : "Soft snowfall"}
|
|
191
|
+
</button>
|
|
192
|
+
))}
|
|
193
|
+
</fieldset>
|
|
194
|
+
<Range
|
|
195
|
+
format={percent}
|
|
196
|
+
id="snowfall"
|
|
197
|
+
label="Snowfall intensity"
|
|
198
|
+
max={1}
|
|
199
|
+
min={0}
|
|
200
|
+
send={send}
|
|
201
|
+
step={0.01}
|
|
202
|
+
value={state.snowfall}
|
|
203
|
+
/>
|
|
204
|
+
<Range
|
|
205
|
+
format={(value) => `${Math.round(value * 100)} cm`}
|
|
206
|
+
id="depth"
|
|
207
|
+
label="Powder depth"
|
|
208
|
+
max={0.55}
|
|
209
|
+
min={0.06}
|
|
210
|
+
send={send}
|
|
211
|
+
step={0.01}
|
|
212
|
+
value={state.depth}
|
|
213
|
+
/>
|
|
214
|
+
<Range
|
|
215
|
+
format={(value) => `${value.toFixed(2)} m/s`}
|
|
216
|
+
id="fallSpeed"
|
|
217
|
+
label="Flake fall speed"
|
|
218
|
+
max={1.6}
|
|
219
|
+
min={0.2}
|
|
220
|
+
send={send}
|
|
221
|
+
step={0.05}
|
|
222
|
+
value={state.fallSpeed}
|
|
223
|
+
/>
|
|
224
|
+
<details className="group mt-1 border-t border-line pt-1">
|
|
225
|
+
<summary
|
|
226
|
+
className="flex min-h-11 cursor-pointer list-none items-center justify-between text-[11px] text-text"
|
|
227
|
+
data-tn-interactive
|
|
228
|
+
>
|
|
229
|
+
Snow physics
|
|
230
|
+
<span
|
|
231
|
+
aria-hidden="true"
|
|
232
|
+
className="text-[16px] text-muted transition-transform group-open:rotate-45"
|
|
233
|
+
>
|
|
234
|
+
+
|
|
235
|
+
</span>
|
|
236
|
+
</summary>
|
|
237
|
+
<Range
|
|
238
|
+
format={percent}
|
|
239
|
+
id="hardness"
|
|
240
|
+
label="Snow hardness"
|
|
241
|
+
max={0.95}
|
|
242
|
+
min={0.05}
|
|
243
|
+
send={send}
|
|
244
|
+
step={0.01}
|
|
245
|
+
value={state.hardness}
|
|
246
|
+
/>
|
|
247
|
+
<Range
|
|
248
|
+
format={(value) => `${value.toFixed(1)} m/s`}
|
|
249
|
+
id="wind"
|
|
250
|
+
label="Base wind"
|
|
251
|
+
max={12}
|
|
252
|
+
min={0}
|
|
253
|
+
send={send}
|
|
254
|
+
step={0.1}
|
|
255
|
+
value={state.wind}
|
|
256
|
+
/>
|
|
257
|
+
<Range
|
|
258
|
+
format={(value) => `${value}×`}
|
|
259
|
+
id="recovery"
|
|
260
|
+
label="Deposition time scale"
|
|
261
|
+
max={1200}
|
|
262
|
+
min={0}
|
|
263
|
+
send={send}
|
|
264
|
+
step={30}
|
|
265
|
+
value={state.recovery}
|
|
266
|
+
/>
|
|
267
|
+
<Toggle
|
|
268
|
+
label="Show compaction"
|
|
269
|
+
onToggle={() => send("set", { key: "compaction", value: !state.compaction })}
|
|
270
|
+
pressed={state.compaction}
|
|
271
|
+
/>
|
|
272
|
+
{state.compaction ? (
|
|
273
|
+
<p className="mt-1 flex items-center gap-3 text-[10px] text-muted" aria-live="polite">
|
|
274
|
+
<span className="flex items-center gap-1.5">
|
|
275
|
+
<i className="h-2.5 w-2.5 rounded-sm bg-[#f2783a]" /> packed
|
|
276
|
+
</span>
|
|
277
|
+
<span className="flex items-center gap-1.5">
|
|
278
|
+
<i className="h-2.5 w-2.5 rounded-sm bg-[#3882ab]" /> fresh powder
|
|
279
|
+
</span>
|
|
280
|
+
</p>
|
|
281
|
+
) : null}
|
|
282
|
+
<p className="mb-3 mt-1 text-[10px] leading-relaxed text-muted">
|
|
283
|
+
Fresh snow fills tracks over time. The time scale speeds up deposition, never walking or
|
|
284
|
+
falling flakes.
|
|
285
|
+
</p>
|
|
286
|
+
</details>
|
|
287
|
+
</section>
|
|
288
|
+
<div className="flex gap-2">
|
|
289
|
+
<ActionButton
|
|
290
|
+
grow
|
|
291
|
+
label={state.autoExplore ? "Turn auto-explore off" : "Turn auto-explore on"}
|
|
292
|
+
onClick={() => send("auto")}
|
|
293
|
+
pressed={state.autoExplore}
|
|
294
|
+
primary={state.autoExplore}
|
|
295
|
+
>
|
|
296
|
+
<Icon className="h-[14px] w-[14px]" name="play" />
|
|
297
|
+
<span className="min-w-[92px] text-left">
|
|
298
|
+
{state.autoExplore ? "Auto-explore on" : "Auto-explore off"}
|
|
299
|
+
</span>
|
|
300
|
+
</ActionButton>
|
|
301
|
+
<ActionButton
|
|
302
|
+
label={state.paused ? "Resume simulation" : "Pause simulation"}
|
|
303
|
+
onClick={() => send(state.paused ? "resume" : "pause")}
|
|
304
|
+
pressed={state.paused}
|
|
305
|
+
title="Pause simulation"
|
|
306
|
+
>
|
|
307
|
+
<Icon name={state.paused ? "play" : "pause"} />
|
|
308
|
+
</ActionButton>
|
|
309
|
+
<ActionButton
|
|
310
|
+
label="Clear all footprints"
|
|
311
|
+
onClick={() => send("reset")}
|
|
312
|
+
title="Clear all footprints (R)"
|
|
313
|
+
>
|
|
314
|
+
<Icon name="reset" />
|
|
315
|
+
</ActionButton>
|
|
316
|
+
</div>
|
|
317
|
+
<div className="min-[851px]:hidden">
|
|
318
|
+
<BallActions send={send} />
|
|
319
|
+
</div>
|
|
320
|
+
</div>
|
|
321
|
+
);
|
|
322
|
+
}
|