create-threenative 0.2.15 → 0.2.18
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/agent-docs/kit-mcp.md +10 -0
- package/agent-docs/kit-router.md +14 -0
- package/agent-docs/kit-stuck.md +7 -0
- package/agent-docs/references/assertion-reference.md +54 -110
- package/agent-docs/references/capability-reference.md +1740 -254
- package/agent-docs/references/conventions.md +299 -0
- package/agent-docs/references/kit-action-rpg.md +40 -0
- package/agent-docs/references/kit-adventure.md +40 -0
- package/agent-docs/references/kit-collectathon.md +38 -0
- package/agent-docs/references/kit-kart.md +31 -0
- package/agent-docs/references/kit-minimal.md +29 -0
- package/agent-docs/references/kit-platformer.md +34 -0
- package/agent-docs/references/kit-puzzle.md +22 -0
- package/agent-docs/references/kit-racing.md +26 -0
- package/agent-docs/references/kit-rain.md +31 -0
- package/agent-docs/references/kit-rts.md +34 -0
- package/agent-docs/references/kit-runner.md +32 -0
- package/agent-docs/references/kit-sailing.md +41 -0
- package/agent-docs/references/kit-shooter.md +33 -0
- package/agent-docs/references/kit-snow.md +33 -0
- package/agent-docs/references/kit-starter.md +55 -0
- package/agent-docs/references/kit-tower-defense.md +27 -0
- package/agent-docs/references/performance-basics.md +8 -4
- package/agent-docs/references/terrain-authoring.md +2 -1
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +3 -2
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +84 -59
- package/agent-files/.claude/hooks/discovery-gate.mjs +125 -0
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/.claude/settings.json +25 -0
- package/agent-files/.codex/hooks.json +18 -1
- package/dist/index.d.ts +97 -6
- package/dist/index.js +899 -271
- package/dist/terrain-kit.d.ts +7 -0
- package/dist/terrain-kit.js +82 -0
- package/dist/threenative.js +114 -16
- package/dist/web-engine-ccd-ik-solver.js +127 -0
- package/dist/web-engine-gltf-loader.js +71 -20
- package/dist/web-engine-post-effects.js +39 -14
- package/dist/web-engine-runtime.js +10011 -4101
- package/package.json +15 -9
- package/template-assets/clearwater/README.md +1 -1
- package/template-assets/patches/manifest.json +18 -0
- package/template-assets/patches/three@0.187.0.patch +2004 -407
- package/template-assets/terrain/alpine/assets.json +12 -0
- package/template-assets/terrain/alpine/bake.mjs +6 -0
- package/template-assets/terrain/alpine/credits.json +164 -0
- package/template-assets/terrain/alpine/heightmap.r16 +0 -0
- package/template-assets/terrain/alpine/recipe.json +119 -0
- package/template-assets/terrain/alpine/surface.json +53 -0
- package/template-assets/terrain/coastal/assets.json +11 -0
- package/template-assets/terrain/coastal/bake.mjs +6 -0
- package/template-assets/terrain/coastal/credits.json +117 -0
- package/template-assets/terrain/coastal/heightmap.r16 +0 -0
- package/template-assets/terrain/coastal/recipe.json +113 -0
- package/template-assets/terrain/coastal/surface.json +41 -0
- package/template-assets/terrain/desert/assets.json +12 -0
- package/template-assets/terrain/desert/bake.mjs +6 -0
- package/template-assets/terrain/desert/credits.json +164 -0
- package/template-assets/terrain/desert/heightmap.r16 +0 -0
- package/template-assets/terrain/desert/recipe.json +108 -0
- package/template-assets/terrain/desert/surface.json +54 -0
- package/template-assets/terrain/forest/assets.json +65 -0
- package/template-assets/terrain/forest/bake.mjs +8 -0
- package/template-assets/terrain/forest/credits.json +225 -0
- package/template-assets/terrain/forest/heightmap.r16 +0 -0
- package/template-assets/terrain/forest/recipe.json +350 -0
- package/template-assets/terrain/forest/surface.json +79 -0
- package/template-assets/terrain/tundra/assets.json +12 -0
- package/template-assets/terrain/tundra/bake.mjs +6 -0
- package/template-assets/terrain/tundra/credits.json +164 -0
- package/template-assets/terrain/tundra/heightmap.r16 +0 -0
- package/template-assets/terrain/tundra/recipe.json +277 -0
- package/template-assets/terrain/tundra/surface.json +54 -0
- package/templates/action-rpg/AGENTS.md +103 -84
- package/templates/action-rpg/CLAUDE.md +103 -84
- package/templates/action-rpg/kit.json +1 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/spells.playtest.json +20 -0
- package/templates/action-rpg/src/game.ts +2 -1
- package/templates/action-rpg/src/render/atmosphere.ts +11 -16
- package/templates/action-rpg/src/render/backlightControls.ts +10 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +4 -4
- package/templates/action-rpg/src/render/clouds.ts +13 -0
- package/templates/action-rpg/src/render/gpuSky.ts +4 -7
- package/templates/action-rpg/src/render/materialLighting.ts +5 -5
- package/templates/action-rpg/src/render/quality.ts +10 -33
- package/templates/action-rpg/src/scenes/Play.ts +30 -1
- package/templates/action-rpg/src/style.css +4 -0
- package/templates/action-rpg/src/ui/AbilityBar.tsx +1 -1
- package/templates/action-rpg/threenative.config.ts +0 -3
- package/templates/action-rpg/vite.config.ts +2 -0
- package/templates/adventure/AGENTS.md +92 -44
- package/templates/adventure/CLAUDE.md +92 -44
- package/templates/adventure/kit.json +5 -1
- package/templates/adventure/package.json +7 -7
- package/templates/adventure/src/game.ts +1 -1
- package/templates/adventure/src/style.css +4 -0
- package/templates/adventure/tsconfig.json +1 -1
- package/templates/adventure/vite.config.ts +2 -0
- package/templates/collectathon/AGENTS.md +93 -42
- package/templates/collectathon/CLAUDE.md +93 -42
- package/templates/collectathon/package.json +7 -7
- package/templates/collectathon/src/game.ts +1 -1
- package/templates/collectathon/src/level/Course.ts +55 -9
- package/templates/collectathon/src/level/terrain.ts +27 -6
- package/templates/collectathon/src/main.ts +1 -0
- package/templates/collectathon/src/render/foliage.ts +359 -98
- package/templates/collectathon/src/render/sky.ts +76 -12
- package/templates/collectathon/src/render/water.ts +32 -10
- package/templates/collectathon/src/scenes/Play.ts +18 -5
- package/templates/collectathon/src/style.css +4 -0
- package/templates/collectathon/tsconfig.json +1 -1
- package/templates/collectathon/vite.config.ts +2 -0
- package/templates/kart/AGENTS.md +87 -42
- package/templates/kart/CLAUDE.md +87 -42
- package/templates/kart/package.json +6 -6
- package/templates/kart/src/game.ts +1 -1
- package/templates/kart/src/main.ts +1 -0
- package/templates/kart/src/style.css +4 -0
- package/templates/kart/tsconfig.json +1 -1
- package/templates/kart/vite.config.ts +2 -0
- package/templates/minimal/AGENTS.md +105 -84
- package/templates/minimal/CLAUDE.md +105 -84
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/stands-still.playtest.json +30 -0
- package/templates/minimal/src/game.ts +1 -1
- package/templates/minimal/src/render/atmosphere.ts +11 -16
- package/templates/minimal/src/render/backlightControls.ts +10 -0
- package/templates/minimal/src/render/backlightMaterial.ts +4 -4
- package/templates/minimal/src/render/camera.ts +13 -2
- package/templates/minimal/src/render/clouds.ts +13 -0
- package/templates/minimal/src/render/gpuSky.ts +4 -7
- package/templates/minimal/src/render/lighting.ts +4 -2
- package/templates/minimal/src/render/materialLighting.ts +5 -5
- package/templates/minimal/src/render/materials.ts +10 -0
- package/templates/minimal/src/render/quality.ts +7 -32
- package/templates/minimal/src/scenes/Play.ts +4 -1
- package/templates/minimal/vite.config.ts +7 -1
- package/templates/platformer/AGENTS.md +95 -46
- package/templates/platformer/CLAUDE.md +95 -46
- package/templates/platformer/index.html +1 -1
- package/templates/platformer/main.html +12 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/gamepad-idle.playtest.json +21 -0
- package/templates/platformer/playtests/gamepad.playtest.json +30 -0
- package/templates/platformer/src/entities/Fox.ts +21 -6
- package/templates/platformer/src/game.ts +1 -1
- package/templates/platformer/src/main.ts +1 -0
- package/templates/platformer/src/render/backlightControls.ts +10 -0
- package/templates/platformer/src/render/backlightMaterial.ts +4 -4
- package/templates/platformer/src/render/materialLighting.ts +5 -5
- package/templates/platformer/src/render/quality.ts +7 -32
- package/templates/platformer/src/scenes/Play.ts +2 -1
- package/templates/platformer/src/style.css +4 -0
- package/templates/platformer/src/worker-page.ts +29 -0
- package/templates/platformer/src/worker.ts +5 -0
- package/templates/platformer/tsconfig.json +1 -1
- package/templates/platformer/vite.config.ts +4 -0
- package/templates/puzzle/AGENTS.md +97 -80
- package/templates/puzzle/CLAUDE.md +97 -80
- package/templates/puzzle/package.json +7 -7
- package/templates/puzzle/src/game.ts +1 -1
- package/templates/puzzle/src/render/backlightControls.ts +10 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +4 -4
- package/templates/puzzle/src/render/materialLighting.ts +5 -5
- package/templates/puzzle/src/render/quality.ts +7 -32
- package/templates/puzzle/src/scenes/Play.ts +1 -1
- package/templates/puzzle/src/style.css +4 -0
- package/templates/puzzle/tsconfig.json +1 -1
- package/templates/puzzle/vite.config.ts +2 -0
- package/templates/racing/AGENTS.md +100 -82
- package/templates/racing/CLAUDE.md +100 -82
- package/templates/racing/package.json +7 -7
- package/templates/racing/src/game.ts +1 -1
- package/templates/racing/src/render/atmosphere.ts +11 -16
- package/templates/racing/src/render/backlightControls.ts +10 -0
- package/templates/racing/src/render/backlightMaterial.ts +4 -4
- package/templates/racing/src/render/clouds.ts +13 -0
- package/templates/racing/src/render/gpuSky.ts +4 -7
- package/templates/racing/src/render/materialLighting.ts +5 -5
- package/templates/racing/src/render/quality.ts +7 -32
- package/templates/racing/src/scenes/Race.ts +4 -1
- package/templates/racing/src/style.css +4 -0
- package/templates/racing/tsconfig.json +1 -1
- package/templates/racing/vite.config.ts +2 -0
- package/templates/rain/AGENTS.md +96 -84
- package/templates/rain/CLAUDE.md +96 -84
- package/templates/rain/native-playtests/lightning.playtest.json +85 -10
- package/templates/rain/package.json +6 -6
- package/templates/rain/playtests/reduced-motion.playtest.json +6 -0
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/scenes/Boot.ts +1 -0
- package/templates/rain/src/state.ts +7 -0
- package/templates/rain/src/ui/GameUi.tsx +7 -1
- package/templates/rain/vite.config.ts +6 -0
- package/templates/rts/AGENTS.md +100 -85
- package/templates/rts/CLAUDE.md +100 -85
- package/templates/rts/package.json +6 -6
- package/templates/rts/src/game.ts +1 -1
- package/templates/rts/src/render/backlightControls.ts +10 -0
- package/templates/rts/src/render/backlightMaterial.ts +4 -4
- package/templates/rts/src/render/materialLighting.ts +5 -5
- package/templates/rts/src/render/quality.ts +7 -31
- package/templates/rts/src/scenes/Play.ts +1 -1
- package/templates/rts/src/style.css +4 -0
- package/templates/rts/vite.config.ts +2 -0
- package/templates/runner/AGENTS.md +97 -80
- package/templates/runner/CLAUDE.md +97 -80
- package/templates/runner/package.json +7 -7
- package/templates/runner/playtests/performance.playtest.json +1 -1
- package/templates/runner/src/game.ts +1 -1
- package/templates/runner/src/render/atmosphere.ts +11 -16
- package/templates/runner/src/render/backlightControls.ts +10 -0
- package/templates/runner/src/render/backlightMaterial.ts +4 -4
- package/templates/runner/src/render/clouds.ts +13 -0
- package/templates/runner/src/render/gpuSky.ts +4 -7
- package/templates/runner/src/render/lighting.ts +53 -11
- package/templates/runner/src/render/materialLighting.ts +5 -5
- package/templates/runner/src/render/quality.ts +7 -32
- package/templates/runner/src/scenes/Run.ts +8 -4
- package/templates/runner/src/style.css +4 -0
- package/templates/runner/threenative.config.ts +0 -3
- package/templates/runner/tsconfig.json +1 -1
- package/templates/runner/vite.config.ts +2 -0
- package/templates/sailing/AGENTS.md +96 -79
- package/templates/sailing/CLAUDE.md +96 -79
- package/templates/sailing/package.json +7 -7
- package/templates/sailing/playtests/sails.playtest.json +1 -0
- package/templates/sailing/src/game.ts +1 -1
- package/templates/sailing/src/render/backlightControls.ts +10 -0
- package/templates/sailing/src/render/backlightMaterial.ts +4 -4
- package/templates/sailing/src/render/environmentSetup.ts +1 -1
- package/templates/sailing/src/render/materialLighting.ts +5 -5
- package/templates/sailing/src/render/quality.ts +7 -32
- package/templates/sailing/src/render/sky.ts +4 -0
- package/templates/sailing/src/style.css +5 -0
- package/templates/sailing/threenative.config.ts +0 -3
- package/templates/sailing/vite.config.ts +6 -0
- package/templates/shooter/AGENTS.md +97 -68
- package/templates/shooter/CLAUDE.md +97 -68
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/src/game.ts +3 -2
- package/templates/shooter/src/render/atmosphere.ts +11 -16
- package/templates/shooter/src/render/backlightControls.ts +10 -0
- package/templates/shooter/src/render/backlightMaterial.ts +4 -4
- package/templates/shooter/src/render/clouds.ts +13 -0
- package/templates/shooter/src/render/gpuSky.ts +4 -7
- package/templates/shooter/src/render/materialLighting.ts +5 -5
- package/templates/shooter/src/render/quality.ts +10 -33
- package/templates/shooter/src/scenes/Play.ts +4 -1
- package/templates/shooter/src/style.css +4 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/AGENTS.md +95 -76
- package/templates/snow/CLAUDE.md +95 -76
- package/templates/snow/package.json +7 -7
- package/templates/snow/src/game.ts +1 -1
- package/templates/snow/src/render/backlightControls.ts +10 -0
- package/templates/snow/src/render/backlightMaterial.ts +4 -4
- package/templates/snow/src/render/materialLighting.ts +5 -5
- package/templates/snow/src/render/quality.ts +7 -32
- package/templates/snow/src/style.css +5 -0
- package/templates/snow/threenative.config.ts +0 -3
- package/templates/snow/vite.config.ts +6 -0
- package/templates/starter/AGENTS.md +109 -88
- package/templates/starter/CLAUDE.md +109 -88
- package/templates/starter/native-playtests/render-chain.playtest.json +24 -24
- package/templates/starter/native-playtests/smooth-motion.playtest.json +3 -3
- package/templates/starter/package.json +7 -7
- package/templates/starter/src/entities/Crate.ts +5 -2
- package/templates/starter/src/entities/Player.ts +10 -22
- package/templates/starter/src/game.ts +4 -3
- package/templates/starter/src/render/adaptiveQuality.ts +17 -0
- package/templates/starter/src/render/atmosphere.ts +11 -16
- package/templates/starter/src/render/backlightControls.ts +10 -0
- package/templates/starter/src/render/backlightMaterial.ts +4 -4
- package/templates/starter/src/render/clouds.ts +13 -0
- package/templates/starter/src/render/contactShadow.ts +1 -1
- package/templates/starter/src/render/gpuSky.ts +4 -7
- package/templates/starter/src/render/lighting.ts +54 -4
- package/templates/starter/src/render/materialLighting.ts +5 -5
- package/templates/starter/src/render/postprocessing.ts +11 -10
- package/templates/starter/src/render/quality.ts +14 -1
- package/templates/starter/src/render/temporalAA.ts +8 -7
- package/templates/starter/src/render/temporalAAFrame.ts +30 -9
- package/templates/starter/src/render/temporalAAResolve.ts +15 -1
- package/templates/starter/src/render/temporalClampRelease.ts +183 -0
- package/templates/starter/src/render/temporalHistoryResolve.ts +90 -0
- package/templates/starter/src/render/temporalMoire.ts +190 -0
- package/templates/starter/src/render/temporalResolve.ts +75 -16
- package/templates/starter/src/render/temporalResolveDepth.ts +2 -0
- package/templates/starter/src/scenes/Play.ts +53 -32
- package/templates/starter/src/state.ts +2 -0
- package/templates/starter/src/style.css +4 -0
- package/templates/starter/src/ui/Menu.tsx +5 -1
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/AGENTS.md +97 -81
- package/templates/tower-defense/CLAUDE.md +97 -81
- package/templates/tower-defense/package.json +7 -7
- package/templates/tower-defense/src/game.ts +1 -1
- package/templates/tower-defense/src/render/backlightControls.ts +10 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +4 -4
- package/templates/tower-defense/src/render/materialLighting.ts +5 -5
- package/templates/tower-defense/src/render/quality.ts +7 -32
- package/templates/tower-defense/src/scenes/Battle.ts +1 -1
- package/templates/tower-defense/src/style.css +4 -0
- package/templates/tower-defense/tsconfig.json +1 -1
- package/templates/tower-defense/vite.config.ts +2 -0
- package/capabilities.json +0 -9197
- package/templates/AGENTS.md +0 -21
- package/templates/CLAUDE.md +0 -23
- package/templates/action-rpg/.codex/config.toml +0 -23
- package/templates/action-rpg/.cursor/mcp.json +0 -38
- package/templates/action-rpg/.gemini/settings.json +0 -38
- package/templates/action-rpg/.mcp.json +0 -38
- package/templates/action-rpg/.vscode/mcp.json +0 -43
- package/templates/action-rpg/.zed/settings.json +0 -43
- package/templates/action-rpg/opencode.json +0 -49
- package/templates/action-rpg/src/render/environmentContribution.ts +0 -188
- package/templates/action-rpg/src/render/environmentRadiance.ts +0 -36
- package/templates/action-rpg/src/render/environmentSampleCache.ts +0 -43
- package/templates/action-rpg/src/render/environmentSampling.ts +0 -193
- package/templates/action-rpg/src/render/environmentSnapshot.ts +0 -53
- package/templates/adventure/.codex/config.toml +0 -23
- package/templates/adventure/.cursor/mcp.json +0 -38
- package/templates/adventure/.gemini/settings.json +0 -38
- package/templates/adventure/.mcp.json +0 -38
- package/templates/adventure/.vscode/mcp.json +0 -43
- package/templates/adventure/.zed/settings.json +0 -43
- package/templates/adventure/opencode.json +0 -49
- package/templates/collectathon/.codex/config.toml +0 -23
- package/templates/collectathon/.cursor/mcp.json +0 -38
- package/templates/collectathon/.gemini/settings.json +0 -38
- package/templates/collectathon/.mcp.json +0 -38
- package/templates/collectathon/.vscode/mcp.json +0 -43
- package/templates/collectathon/.zed/settings.json +0 -43
- package/templates/collectathon/opencode.json +0 -49
- package/templates/kart/.codex/config.toml +0 -23
- package/templates/kart/.cursor/mcp.json +0 -38
- package/templates/kart/.gemini/settings.json +0 -38
- package/templates/kart/.mcp.json +0 -38
- package/templates/kart/.vscode/mcp.json +0 -43
- package/templates/kart/.zed/settings.json +0 -43
- package/templates/kart/opencode.json +0 -49
- package/templates/minimal/.codex/config.toml +0 -23
- package/templates/minimal/.cursor/mcp.json +0 -38
- package/templates/minimal/.gemini/settings.json +0 -38
- package/templates/minimal/.mcp.json +0 -38
- package/templates/minimal/.vscode/mcp.json +0 -43
- package/templates/minimal/.zed/settings.json +0 -43
- package/templates/minimal/opencode.json +0 -49
- package/templates/minimal/src/render/environmentContribution.ts +0 -188
- package/templates/minimal/src/render/environmentRadiance.ts +0 -36
- package/templates/minimal/src/render/environmentSampleCache.ts +0 -43
- package/templates/minimal/src/render/environmentSampling.ts +0 -193
- package/templates/minimal/src/render/environmentSnapshot.ts +0 -53
- package/templates/platformer/.codex/config.toml +0 -23
- package/templates/platformer/.cursor/mcp.json +0 -38
- package/templates/platformer/.gemini/settings.json +0 -38
- package/templates/platformer/.mcp.json +0 -38
- package/templates/platformer/.vscode/mcp.json +0 -43
- package/templates/platformer/.zed/settings.json +0 -43
- package/templates/platformer/opencode.json +0 -49
- package/templates/platformer/src/render/environmentContribution.ts +0 -188
- package/templates/platformer/src/render/environmentRadiance.ts +0 -36
- package/templates/platformer/src/render/environmentSampleCache.ts +0 -43
- package/templates/platformer/src/render/environmentSampling.ts +0 -193
- package/templates/platformer/src/render/environmentSnapshot.ts +0 -53
- package/templates/puzzle/.codex/config.toml +0 -23
- package/templates/puzzle/.cursor/mcp.json +0 -38
- package/templates/puzzle/.gemini/settings.json +0 -38
- package/templates/puzzle/.mcp.json +0 -38
- package/templates/puzzle/.vscode/mcp.json +0 -43
- package/templates/puzzle/.zed/settings.json +0 -43
- package/templates/puzzle/opencode.json +0 -49
- package/templates/puzzle/src/render/environmentContribution.ts +0 -188
- package/templates/puzzle/src/render/environmentRadiance.ts +0 -36
- package/templates/puzzle/src/render/environmentSampleCache.ts +0 -43
- package/templates/puzzle/src/render/environmentSampling.ts +0 -193
- package/templates/puzzle/src/render/environmentSnapshot.ts +0 -53
- package/templates/racing/.codex/config.toml +0 -23
- package/templates/racing/.cursor/mcp.json +0 -38
- package/templates/racing/.gemini/settings.json +0 -38
- package/templates/racing/.mcp.json +0 -38
- package/templates/racing/.vscode/mcp.json +0 -43
- package/templates/racing/.zed/settings.json +0 -43
- package/templates/racing/opencode.json +0 -49
- package/templates/racing/src/render/environmentContribution.ts +0 -188
- package/templates/racing/src/render/environmentRadiance.ts +0 -36
- package/templates/racing/src/render/environmentSampleCache.ts +0 -43
- package/templates/racing/src/render/environmentSampling.ts +0 -193
- package/templates/racing/src/render/environmentSnapshot.ts +0 -53
- package/templates/rain/.codex/config.toml +0 -23
- package/templates/rain/.cursor/mcp.json +0 -38
- package/templates/rain/.gemini/settings.json +0 -38
- package/templates/rain/.mcp.json +0 -38
- package/templates/rain/.vscode/mcp.json +0 -43
- package/templates/rain/.zed/settings.json +0 -43
- package/templates/rain/opencode.json +0 -49
- package/templates/rts/.codex/config.toml +0 -23
- package/templates/rts/.cursor/mcp.json +0 -38
- package/templates/rts/.gemini/settings.json +0 -38
- package/templates/rts/.mcp.json +0 -38
- package/templates/rts/.vscode/mcp.json +0 -43
- package/templates/rts/.zed/settings.json +0 -43
- package/templates/rts/opencode.json +0 -49
- package/templates/rts/src/render/environmentContribution.ts +0 -188
- package/templates/rts/src/render/environmentRadiance.ts +0 -36
- package/templates/rts/src/render/environmentSampleCache.ts +0 -43
- package/templates/rts/src/render/environmentSampling.ts +0 -193
- package/templates/rts/src/render/environmentSnapshot.ts +0 -53
- package/templates/runner/.codex/config.toml +0 -23
- package/templates/runner/.cursor/mcp.json +0 -38
- package/templates/runner/.gemini/settings.json +0 -38
- package/templates/runner/.mcp.json +0 -38
- package/templates/runner/.vscode/mcp.json +0 -43
- package/templates/runner/.zed/settings.json +0 -43
- package/templates/runner/README.md +0 -43
- package/templates/runner/opencode.json +0 -49
- package/templates/runner/src/render/environmentContribution.ts +0 -188
- package/templates/runner/src/render/environmentRadiance.ts +0 -36
- package/templates/runner/src/render/environmentSampleCache.ts +0 -43
- package/templates/runner/src/render/environmentSampling.ts +0 -193
- package/templates/runner/src/render/environmentSnapshot.ts +0 -53
- package/templates/sailing/.codex/config.toml +0 -23
- package/templates/sailing/.cursor/mcp.json +0 -38
- package/templates/sailing/.gemini/settings.json +0 -38
- package/templates/sailing/.mcp.json +0 -38
- package/templates/sailing/.vscode/mcp.json +0 -43
- package/templates/sailing/.zed/settings.json +0 -43
- package/templates/sailing/README.md +0 -28
- package/templates/sailing/opencode.json +0 -49
- package/templates/sailing/src/render/environmentContribution.ts +0 -188
- package/templates/sailing/src/render/environmentRadiance.ts +0 -36
- package/templates/sailing/src/render/environmentSampleCache.ts +0 -43
- package/templates/sailing/src/render/environmentSampling.ts +0 -193
- package/templates/sailing/src/render/environmentSnapshot.ts +0 -53
- package/templates/shooter/.codex/config.toml +0 -23
- package/templates/shooter/.cursor/mcp.json +0 -38
- package/templates/shooter/.gemini/settings.json +0 -38
- package/templates/shooter/.mcp.json +0 -38
- package/templates/shooter/.vscode/mcp.json +0 -43
- package/templates/shooter/.zed/settings.json +0 -43
- package/templates/shooter/opencode.json +0 -49
- package/templates/shooter/src/render/environmentContribution.ts +0 -188
- package/templates/shooter/src/render/environmentRadiance.ts +0 -36
- package/templates/shooter/src/render/environmentSampleCache.ts +0 -43
- package/templates/shooter/src/render/environmentSampling.ts +0 -193
- package/templates/shooter/src/render/environmentSnapshot.ts +0 -53
- package/templates/snow/.codex/config.toml +0 -23
- package/templates/snow/.cursor/mcp.json +0 -38
- package/templates/snow/.gemini/settings.json +0 -38
- package/templates/snow/.mcp.json +0 -38
- package/templates/snow/.vscode/mcp.json +0 -43
- package/templates/snow/.zed/settings.json +0 -43
- package/templates/snow/README.md +0 -26
- package/templates/snow/opencode.json +0 -49
- package/templates/snow/src/render/environmentContribution.ts +0 -188
- package/templates/snow/src/render/environmentRadiance.ts +0 -36
- package/templates/snow/src/render/environmentSampleCache.ts +0 -43
- package/templates/snow/src/render/environmentSampling.ts +0 -193
- package/templates/snow/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/.codex/config.toml +0 -23
- package/templates/starter/.cursor/mcp.json +0 -38
- package/templates/starter/.gemini/settings.json +0 -38
- package/templates/starter/.mcp.json +0 -38
- package/templates/starter/.vscode/mcp.json +0 -43
- package/templates/starter/.zed/settings.json +0 -43
- package/templates/starter/opencode.json +0 -49
- package/templates/starter/src/render/environmentContribution.ts +0 -188
- package/templates/starter/src/render/environmentRadiance.ts +0 -36
- package/templates/starter/src/render/environmentSampleCache.ts +0 -43
- package/templates/starter/src/render/environmentSampling.ts +0 -193
- package/templates/starter/src/render/environmentSnapshot.ts +0 -53
- package/templates/starter/src/render/rendererGate.ts +0 -36
- package/templates/tower-defense/.codex/config.toml +0 -23
- package/templates/tower-defense/.cursor/mcp.json +0 -38
- package/templates/tower-defense/.gemini/settings.json +0 -38
- package/templates/tower-defense/.mcp.json +0 -38
- package/templates/tower-defense/.vscode/mcp.json +0 -43
- package/templates/tower-defense/.zed/settings.json +0 -43
- package/templates/tower-defense/README.md +0 -16
- package/templates/tower-defense/opencode.json +0 -49
- package/templates/tower-defense/src/render/environmentContribution.ts +0 -188
- package/templates/tower-defense/src/render/environmentRadiance.ts +0 -36
- package/templates/tower-defense/src/render/environmentSampleCache.ts +0 -43
- package/templates/tower-defense/src/render/environmentSampling.ts +0 -193
- package/templates/tower-defense/src/render/environmentSnapshot.ts +0 -53
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
[mcp_servers.threenative-assets]
|
|
2
|
-
command = "node"
|
|
3
|
-
args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
|
|
4
|
-
|
|
5
|
-
[mcp_servers.threenative-assets.env]
|
|
6
|
-
ASSET_DOWNLOAD_DIR = "./public/assets"
|
|
7
|
-
AUDIO_DOWNLOAD_DIR = "./public/audio"
|
|
8
|
-
|
|
9
|
-
[mcp_servers.threenative-sculpt]
|
|
10
|
-
command = "node"
|
|
11
|
-
args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
12
|
-
|
|
13
|
-
[mcp_servers.threenative-engine]
|
|
14
|
-
command = "node"
|
|
15
|
-
args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
|
|
16
|
-
|
|
17
|
-
[mcp_servers.threenative-animation]
|
|
18
|
-
command = "node"
|
|
19
|
-
args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
|
|
20
|
-
|
|
21
|
-
[mcp_servers.threenative-devtools]
|
|
22
|
-
command = "node"
|
|
23
|
-
args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"mcpServers": {
|
|
3
|
-
"threenative-assets": {
|
|
4
|
-
"command": "node",
|
|
5
|
-
"args": [
|
|
6
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
7
|
-
],
|
|
8
|
-
"env": {
|
|
9
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
10
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
11
|
-
}
|
|
12
|
-
},
|
|
13
|
-
"threenative-sculpt": {
|
|
14
|
-
"command": "node",
|
|
15
|
-
"args": [
|
|
16
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
17
|
-
]
|
|
18
|
-
},
|
|
19
|
-
"threenative-engine": {
|
|
20
|
-
"command": "node",
|
|
21
|
-
"args": [
|
|
22
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
|
-
]
|
|
24
|
-
},
|
|
25
|
-
"threenative-animation": {
|
|
26
|
-
"command": "node",
|
|
27
|
-
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
-
]
|
|
30
|
-
},
|
|
31
|
-
"threenative-devtools": {
|
|
32
|
-
"command": "node",
|
|
33
|
-
"args": [
|
|
34
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
}
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"mcpServers": {
|
|
3
|
-
"threenative-assets": {
|
|
4
|
-
"command": "node",
|
|
5
|
-
"args": [
|
|
6
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
7
|
-
],
|
|
8
|
-
"env": {
|
|
9
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
10
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
11
|
-
}
|
|
12
|
-
},
|
|
13
|
-
"threenative-sculpt": {
|
|
14
|
-
"command": "node",
|
|
15
|
-
"args": [
|
|
16
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
17
|
-
]
|
|
18
|
-
},
|
|
19
|
-
"threenative-engine": {
|
|
20
|
-
"command": "node",
|
|
21
|
-
"args": [
|
|
22
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
|
-
]
|
|
24
|
-
},
|
|
25
|
-
"threenative-animation": {
|
|
26
|
-
"command": "node",
|
|
27
|
-
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
-
]
|
|
30
|
-
},
|
|
31
|
-
"threenative-devtools": {
|
|
32
|
-
"command": "node",
|
|
33
|
-
"args": [
|
|
34
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
}
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"mcpServers": {
|
|
3
|
-
"threenative-assets": {
|
|
4
|
-
"command": "node",
|
|
5
|
-
"args": [
|
|
6
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
7
|
-
],
|
|
8
|
-
"env": {
|
|
9
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
10
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
11
|
-
}
|
|
12
|
-
},
|
|
13
|
-
"threenative-sculpt": {
|
|
14
|
-
"command": "node",
|
|
15
|
-
"args": [
|
|
16
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
17
|
-
]
|
|
18
|
-
},
|
|
19
|
-
"threenative-engine": {
|
|
20
|
-
"command": "node",
|
|
21
|
-
"args": [
|
|
22
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
|
-
]
|
|
24
|
-
},
|
|
25
|
-
"threenative-animation": {
|
|
26
|
-
"command": "node",
|
|
27
|
-
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
-
]
|
|
30
|
-
},
|
|
31
|
-
"threenative-devtools": {
|
|
32
|
-
"command": "node",
|
|
33
|
-
"args": [
|
|
34
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
35
|
-
]
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
}
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"servers": {
|
|
3
|
-
"threenative-assets": {
|
|
4
|
-
"type": "stdio",
|
|
5
|
-
"command": "node",
|
|
6
|
-
"args": [
|
|
7
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
8
|
-
],
|
|
9
|
-
"env": {
|
|
10
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
11
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
12
|
-
}
|
|
13
|
-
},
|
|
14
|
-
"threenative-sculpt": {
|
|
15
|
-
"type": "stdio",
|
|
16
|
-
"command": "node",
|
|
17
|
-
"args": [
|
|
18
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
19
|
-
]
|
|
20
|
-
},
|
|
21
|
-
"threenative-engine": {
|
|
22
|
-
"type": "stdio",
|
|
23
|
-
"command": "node",
|
|
24
|
-
"args": [
|
|
25
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
|
-
]
|
|
27
|
-
},
|
|
28
|
-
"threenative-animation": {
|
|
29
|
-
"type": "stdio",
|
|
30
|
-
"command": "node",
|
|
31
|
-
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
-
]
|
|
34
|
-
},
|
|
35
|
-
"threenative-devtools": {
|
|
36
|
-
"type": "stdio",
|
|
37
|
-
"command": "node",
|
|
38
|
-
"args": [
|
|
39
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
40
|
-
]
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"context_servers": {
|
|
3
|
-
"threenative-assets": {
|
|
4
|
-
"source": "custom",
|
|
5
|
-
"command": "node",
|
|
6
|
-
"args": [
|
|
7
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
8
|
-
],
|
|
9
|
-
"env": {
|
|
10
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
11
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
12
|
-
}
|
|
13
|
-
},
|
|
14
|
-
"threenative-sculpt": {
|
|
15
|
-
"source": "custom",
|
|
16
|
-
"command": "node",
|
|
17
|
-
"args": [
|
|
18
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
19
|
-
]
|
|
20
|
-
},
|
|
21
|
-
"threenative-engine": {
|
|
22
|
-
"source": "custom",
|
|
23
|
-
"command": "node",
|
|
24
|
-
"args": [
|
|
25
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
|
-
]
|
|
27
|
-
},
|
|
28
|
-
"threenative-animation": {
|
|
29
|
-
"source": "custom",
|
|
30
|
-
"command": "node",
|
|
31
|
-
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
-
]
|
|
34
|
-
},
|
|
35
|
-
"threenative-devtools": {
|
|
36
|
-
"source": "custom",
|
|
37
|
-
"command": "node",
|
|
38
|
-
"args": [
|
|
39
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
40
|
-
]
|
|
41
|
-
}
|
|
42
|
-
}
|
|
43
|
-
}
|
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# Tower defense starter kit
|
|
2
|
-
|
|
3
|
-
A finished tower defense: build on sixteen pads, hold a winding road for twelve waves, and keep the
|
|
4
|
-
reactor alive. Four towers (Sentry, Mortar, Arc coil, Cryo) each have three levels and three targeting
|
|
5
|
-
modes; Titans arrive on waves six and twelve; one orbital strike recharges every thirty seconds.
|
|
6
|
-
|
|
7
|
-
Everything you see is procedural: no model, no texture beyond the photographed sky that lights the
|
|
8
|
-
board (`assets/sky.jpg`, Poly Haven, CC0). Every tower and enemy is built in `src/render/shapes.ts`.
|
|
9
|
-
|
|
10
|
-
It deliberately does not use `@threenative/physics/navigation`: the road is a `PathFollow3D` curve,
|
|
11
|
-
which runs on every target, and towers ask the physics world who is in range rather than tracking
|
|
12
|
-
enemies themselves.
|
|
13
|
-
|
|
14
|
-
Press `1`–`4` to arm a tower and click a pad, `B` to build on the best free pad, `Space` to launch a
|
|
15
|
-
wave, `U` / `X` to upgrade or recycle the selected tower, `F` for the strike, `P` to pause, `H` for
|
|
16
|
-
the field guide and `R` to restart. Right-drag, the wheel and `Q` / `E` move the camera.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://opencode.ai/config.json",
|
|
3
|
-
"mcp": {
|
|
4
|
-
"threenative-assets": {
|
|
5
|
-
"type": "local",
|
|
6
|
-
"command": [
|
|
7
|
-
"node",
|
|
8
|
-
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
9
|
-
],
|
|
10
|
-
"enabled": true,
|
|
11
|
-
"environment": {
|
|
12
|
-
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
13
|
-
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
14
|
-
}
|
|
15
|
-
},
|
|
16
|
-
"threenative-sculpt": {
|
|
17
|
-
"type": "local",
|
|
18
|
-
"command": [
|
|
19
|
-
"node",
|
|
20
|
-
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
21
|
-
],
|
|
22
|
-
"enabled": true
|
|
23
|
-
},
|
|
24
|
-
"threenative-engine": {
|
|
25
|
-
"type": "local",
|
|
26
|
-
"command": [
|
|
27
|
-
"node",
|
|
28
|
-
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
29
|
-
],
|
|
30
|
-
"enabled": true
|
|
31
|
-
},
|
|
32
|
-
"threenative-animation": {
|
|
33
|
-
"type": "local",
|
|
34
|
-
"command": [
|
|
35
|
-
"node",
|
|
36
|
-
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
37
|
-
],
|
|
38
|
-
"enabled": true
|
|
39
|
-
},
|
|
40
|
-
"threenative-devtools": {
|
|
41
|
-
"type": "local",
|
|
42
|
-
"command": [
|
|
43
|
-
"node",
|
|
44
|
-
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
45
|
-
],
|
|
46
|
-
"enabled": true
|
|
47
|
-
}
|
|
48
|
-
}
|
|
49
|
-
}
|
|
@@ -1,188 +0,0 @@
|
|
|
1
|
-
// Generated for you. Measure actual source radiance; unreadable environments stay unknown.
|
|
2
|
-
import {
|
|
3
|
-
type Color,
|
|
4
|
-
EquirectangularReflectionMapping,
|
|
5
|
-
FloatType,
|
|
6
|
-
LinearSRGBColorSpace,
|
|
7
|
-
NoColorSpace,
|
|
8
|
-
RGBAFormat,
|
|
9
|
-
SRGBColorSpace,
|
|
10
|
-
type Scene,
|
|
11
|
-
type Texture,
|
|
12
|
-
UnsignedByteType,
|
|
13
|
-
} from "three";
|
|
14
|
-
|
|
15
|
-
export interface IEnvironmentMeasurement {
|
|
16
|
-
readonly status: "measured" | "unknown";
|
|
17
|
-
readonly meanRadiance: number | null;
|
|
18
|
-
readonly meanRGB: readonly [number, number, number] | null;
|
|
19
|
-
readonly reason: string;
|
|
20
|
-
}
|
|
21
|
-
const unknown = (reason: string): IEnvironmentMeasurement => ({
|
|
22
|
-
status: "unknown",
|
|
23
|
-
meanRadiance: null,
|
|
24
|
-
meanRGB: null,
|
|
25
|
-
reason,
|
|
26
|
-
});
|
|
27
|
-
const linear = (value: number) =>
|
|
28
|
-
value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
|
|
29
|
-
|
|
30
|
-
function validSize(value: unknown): value is number {
|
|
31
|
-
return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
|
|
32
|
-
}
|
|
33
|
-
interface IReadableSource {
|
|
34
|
-
readonly status: "source";
|
|
35
|
-
readonly data: Uint8Array | Float32Array;
|
|
36
|
-
readonly width: number;
|
|
37
|
-
readonly height: number;
|
|
38
|
-
readonly bytes: boolean;
|
|
39
|
-
}
|
|
40
|
-
function readSource(
|
|
41
|
-
texture: Texture,
|
|
42
|
-
maxSourceTexels: number,
|
|
43
|
-
): IReadableSource | IEnvironmentMeasurement {
|
|
44
|
-
if (texture.mapping !== EquirectangularReflectionMapping)
|
|
45
|
-
return unknown("Only CPU-readable equirectangular source radiance is qualified.");
|
|
46
|
-
const image: unknown = texture.image;
|
|
47
|
-
if (
|
|
48
|
-
image === null ||
|
|
49
|
-
typeof image !== "object" ||
|
|
50
|
-
!("data" in image) ||
|
|
51
|
-
!("width" in image) ||
|
|
52
|
-
!("height" in image)
|
|
53
|
-
)
|
|
54
|
-
return unknown("Environment source pixels are not CPU-readable; no radiance was inferred.");
|
|
55
|
-
const { data, width, height } = image;
|
|
56
|
-
if (!validSize(width) || !validSize(height))
|
|
57
|
-
return unknown("Environment source dimensions are invalid.");
|
|
58
|
-
if (width * height > maxSourceTexels)
|
|
59
|
-
return unknown("Environment CPU sample budget exceeded; no radiance was inferred.");
|
|
60
|
-
if (texture.format !== RGBAFormat)
|
|
61
|
-
return unknown("Only explicit RGBA source samples are qualified.");
|
|
62
|
-
const bytes = texture.type === UnsignedByteType && data instanceof Uint8Array;
|
|
63
|
-
const floats = texture.type === FloatType && data instanceof Float32Array;
|
|
64
|
-
if (!bytes && !floats) return unknown("Environment source sample type is not qualified.");
|
|
65
|
-
if (data.length !== width * height * 4)
|
|
66
|
-
return unknown("Environment source samples do not match their dimensions.");
|
|
67
|
-
if (
|
|
68
|
-
!new Set<string>([NoColorSpace, LinearSRGBColorSpace, SRGBColorSpace]).has(texture.colorSpace)
|
|
69
|
-
)
|
|
70
|
-
return unknown("Environment source color-space conversion is not qualified.");
|
|
71
|
-
return { status: "source", data, width, height, bytes };
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
function accumulate(source: IReadableSource, srgb: boolean) {
|
|
75
|
-
const { data, width, height, bytes } = source;
|
|
76
|
-
const sums = [0, 0, 0];
|
|
77
|
-
const weights = Array.from(
|
|
78
|
-
{ length: height },
|
|
79
|
-
(_, y) => Math.cos((Math.PI * y) / height) - Math.cos((Math.PI * (y + 1)) / height),
|
|
80
|
-
);
|
|
81
|
-
for (let offset = 0; offset < data.length; offset += 4) {
|
|
82
|
-
const weight = weights[Math.floor(offset / (width * 4))] ?? 0;
|
|
83
|
-
for (let channel = 0; channel < 3; channel += 1) {
|
|
84
|
-
const sample = data[offset + channel];
|
|
85
|
-
if (sample === undefined || !Number.isFinite(sample) || sample < 0)
|
|
86
|
-
return unknown("Environment radiance samples must be finite and nonnegative.");
|
|
87
|
-
const value = bytes ? sample / 255 : sample;
|
|
88
|
-
sums[channel] = (sums[channel] ?? 0) + (srgb ? linear(value) : value) * weight;
|
|
89
|
-
}
|
|
90
|
-
}
|
|
91
|
-
return { sums, weightSum: weights.reduce((a, b) => a + b, 0) * width };
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* CPU-readable equirectangular source radiance only; no DOM/canvas or invented JPEG mean.
|
|
96
|
-
* Rows are weighted by their exact spherical solid angle, rather than overweighting the poles.
|
|
97
|
-
* Arbitrary GPU/compressed/HTML/cube sources remain explicitly unknown until separately proven.
|
|
98
|
-
*/
|
|
99
|
-
export function measureEnvironment(scene: Scene, maxSourceTexels: number): IEnvironmentMeasurement {
|
|
100
|
-
if (!Number.isSafeInteger(maxSourceTexels) || maxSourceTexels < 1)
|
|
101
|
-
throw new Error("Environment CPU sample budget must be a positive safe integer.");
|
|
102
|
-
const texture = scene.environment;
|
|
103
|
-
if (texture === null)
|
|
104
|
-
return {
|
|
105
|
-
status: "measured",
|
|
106
|
-
meanRadiance: 0,
|
|
107
|
-
meanRGB: [0, 0, 0],
|
|
108
|
-
reason: "No environment is bound.",
|
|
109
|
-
};
|
|
110
|
-
if (!Number.isFinite(scene.environmentIntensity) || scene.environmentIntensity < 0)
|
|
111
|
-
return unknown("Environment intensity must be finite and nonnegative.");
|
|
112
|
-
const source = readSource(texture, maxSourceTexels);
|
|
113
|
-
if (source.status !== "source") return source;
|
|
114
|
-
const accumulated = accumulate(source, texture.colorSpace === SRGBColorSpace);
|
|
115
|
-
if ("status" in accumulated) return accumulated;
|
|
116
|
-
const { sums, weightSum } = accumulated;
|
|
117
|
-
const meanRGB = sums.map((sum) => (sum / weightSum) * scene.environmentIntensity) as [
|
|
118
|
-
number,
|
|
119
|
-
number,
|
|
120
|
-
number,
|
|
121
|
-
];
|
|
122
|
-
const meanRadiance = meanRGB[0] * 0.2126 + meanRGB[1] * 0.7152 + meanRGB[2] * 0.0722;
|
|
123
|
-
if (!meanRGB.every(Number.isFinite) || !Number.isFinite(meanRadiance))
|
|
124
|
-
return unknown("Environment radiance accumulation overflowed.");
|
|
125
|
-
return {
|
|
126
|
-
status: "measured",
|
|
127
|
-
meanRadiance,
|
|
128
|
-
meanRGB,
|
|
129
|
-
reason: "Solid-angle-weighted linear source radiance, with active environment intensity.",
|
|
130
|
-
};
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
interface IContributionControls {
|
|
134
|
-
readonly darkThreshold: number;
|
|
135
|
-
readonly rimGain: number;
|
|
136
|
-
readonly fillGain: number;
|
|
137
|
-
readonly fillAdmitted: boolean;
|
|
138
|
-
readonly fillColor: Color;
|
|
139
|
-
readonly maxSourceTexels: number;
|
|
140
|
-
}
|
|
141
|
-
function fillReport(options: IContributionControls) {
|
|
142
|
-
const blackColorOverride = options.fillColor.toArray().every((value) => value === 0);
|
|
143
|
-
let reason = "analytic fill enabled by caller; contribution still needs pixel qualification";
|
|
144
|
-
if (!options.fillAdmitted) reason = "not admitted by this qualification";
|
|
145
|
-
else if (options.fillGain === 0) reason = "disabled by fillGain override";
|
|
146
|
-
else if (blackColorOverride) reason = "disabled by black fillColor override";
|
|
147
|
-
return {
|
|
148
|
-
requestedGain: options.fillGain,
|
|
149
|
-
admitted: options.fillAdmitted,
|
|
150
|
-
effectiveGain: options.fillAdmitted ? options.fillGain : 0,
|
|
151
|
-
color: options.fillColor.toArray(),
|
|
152
|
-
blackColorOverride,
|
|
153
|
-
reason,
|
|
154
|
-
};
|
|
155
|
-
}
|
|
156
|
-
/** Overrides change the look, never whether its source contribution is measured/reported. */
|
|
157
|
-
export function reportEnvironmentContribution(
|
|
158
|
-
scene: Scene,
|
|
159
|
-
options: IContributionControls,
|
|
160
|
-
measurement?: IEnvironmentMeasurement,
|
|
161
|
-
) {
|
|
162
|
-
if (
|
|
163
|
-
![
|
|
164
|
-
options.darkThreshold,
|
|
165
|
-
options.rimGain,
|
|
166
|
-
options.fillGain,
|
|
167
|
-
...options.fillColor.toArray(),
|
|
168
|
-
].every((value) => Number.isFinite(value) && value >= 0)
|
|
169
|
-
)
|
|
170
|
-
throw new Error("Backlight measurement controls must be finite and nonnegative.");
|
|
171
|
-
const measured = measurement ?? measureEnvironment(scene, options.maxSourceTexels);
|
|
172
|
-
const dark =
|
|
173
|
-
measured.meanRadiance === null ? null : measured.meanRadiance <= options.darkThreshold;
|
|
174
|
-
const environmentState =
|
|
175
|
-
scene.environment === null ? "missing" : dark === null ? "unknown" : dark ? "dark" : "bright";
|
|
176
|
-
const report = {
|
|
177
|
-
...measured,
|
|
178
|
-
scope: "scene environment source availability; not material-specific reflected contribution",
|
|
179
|
-
environmentState,
|
|
180
|
-
ibl: dark === null ? "unknown" : dark ? "non-contributing" : "contributing",
|
|
181
|
-
analyticFill: fillReport(options),
|
|
182
|
-
rimGain: options.rimGain,
|
|
183
|
-
fillGain: options.fillGain,
|
|
184
|
-
darkThreshold: options.darkThreshold,
|
|
185
|
-
};
|
|
186
|
-
console.info(`TN_ENVIRONMENT_CONTRIBUTION:${JSON.stringify(report)}`);
|
|
187
|
-
return report;
|
|
188
|
-
}
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
// Generated for you. Spherical accumulation of bounded linear source samples.
|
|
2
|
-
import type { IEnvironmentMeasurement } from "./environmentContribution.js";
|
|
3
|
-
const WIDTH = 64;
|
|
4
|
-
const HEIGHT = 32;
|
|
5
|
-
function unmeasured(reason: string): IEnvironmentMeasurement {
|
|
6
|
-
return { status: "unknown", meanRadiance: null, meanRGB: null, reason };
|
|
7
|
-
}
|
|
8
|
-
export function sampledRadiance(samples: unknown, intensity: number): IEnvironmentMeasurement {
|
|
9
|
-
if (!(samples instanceof Float32Array) || samples.length !== WIDTH * HEIGHT * 4)
|
|
10
|
-
return unmeasured("GPU readback did not provide the qualified float RGBA sample layout.");
|
|
11
|
-
const sums = [0, 0, 0];
|
|
12
|
-
const weights = Array.from(
|
|
13
|
-
{ length: HEIGHT },
|
|
14
|
-
(_, y) => Math.cos((Math.PI * y) / HEIGHT) - Math.cos((Math.PI * (y + 1)) / HEIGHT),
|
|
15
|
-
);
|
|
16
|
-
const totalWeight = weights.reduce((sum, weight) => sum + weight, 0) * WIDTH;
|
|
17
|
-
for (const [offset, value] of samples.entries()) {
|
|
18
|
-
const channel = offset % 4;
|
|
19
|
-
if (channel === 3) continue;
|
|
20
|
-
if (!Number.isFinite(value) || value < 0)
|
|
21
|
-
return unmeasured("GPU radiance samples must be finite and nonnegative.");
|
|
22
|
-
const weight = weights[Math.floor(offset / (WIDTH * 4))] ?? 0;
|
|
23
|
-
sums[channel] = (sums[channel] ?? 0) + value * weight;
|
|
24
|
-
}
|
|
25
|
-
const meanRGB = sums.map((sum) => (sum / totalWeight) * intensity) as [number, number, number];
|
|
26
|
-
const meanRadiance = meanRGB[0] * 0.2126 + meanRGB[1] * 0.7152 + meanRGB[2] * 0.0722;
|
|
27
|
-
if (!meanRGB.every(Number.isFinite) || !Number.isFinite(meanRadiance))
|
|
28
|
-
return unmeasured("GPU radiance accumulation overflowed.");
|
|
29
|
-
return {
|
|
30
|
-
status: "measured",
|
|
31
|
-
meanRGB,
|
|
32
|
-
meanRadiance,
|
|
33
|
-
reason:
|
|
34
|
-
"Estimated linear scene-environment source radiance from 64x32 GPU samples, spherical row weighting and active intensity; not material-specific BRDF contribution.",
|
|
35
|
-
};
|
|
36
|
-
}
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
// Generated for you. Weak ownership and full provenance guard successful source estimates.
|
|
2
|
-
import type { Scene, Texture } from "three";
|
|
3
|
-
import type { IEnvironmentSample } from "./environmentSampling.js";
|
|
4
|
-
import { environmentSnapshotCurrent } from "./environmentSnapshot.js";
|
|
5
|
-
const samples = new WeakMap<object, WeakMap<Texture, IEnvironmentSample>>();
|
|
6
|
-
export function cachedEnvironmentSample(
|
|
7
|
-
renderer: object,
|
|
8
|
-
scene: Scene,
|
|
9
|
-
): IEnvironmentSample | undefined {
|
|
10
|
-
if (scene.environment === null) return undefined;
|
|
11
|
-
const sample = samples.get(renderer)?.get(scene.environment);
|
|
12
|
-
return sample !== undefined && environmentSnapshotCurrent(scene, sample)
|
|
13
|
-
? copySample(sample)
|
|
14
|
-
: undefined;
|
|
15
|
-
}
|
|
16
|
-
export function cacheEnvironmentSample(
|
|
17
|
-
renderer: object,
|
|
18
|
-
scene: Scene,
|
|
19
|
-
sample: IEnvironmentSample,
|
|
20
|
-
): void {
|
|
21
|
-
if (
|
|
22
|
-
sample.source === null ||
|
|
23
|
-
sample.measurement.status !== "measured" ||
|
|
24
|
-
!environmentSnapshotCurrent(scene, sample)
|
|
25
|
-
)
|
|
26
|
-
return;
|
|
27
|
-
let byTexture = samples.get(renderer);
|
|
28
|
-
if (byTexture === undefined) {
|
|
29
|
-
byTexture = new WeakMap();
|
|
30
|
-
samples.set(renderer, byTexture);
|
|
31
|
-
}
|
|
32
|
-
byTexture.set(sample.source, copySample(sample));
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
function copySample(sample: IEnvironmentSample): IEnvironmentSample {
|
|
36
|
-
return {
|
|
37
|
-
...sample,
|
|
38
|
-
measurement: {
|
|
39
|
-
...sample.measurement,
|
|
40
|
-
meanRGB: sample.measurement.meanRGB === null ? null : [...sample.measurement.meanRGB],
|
|
41
|
-
},
|
|
42
|
-
};
|
|
43
|
-
}
|