create-threenative 0.2.1 → 0.2.3
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/LICENSE +21 -0
- package/README.md +10 -2
- package/agent-docs/asset-mcp-loop.md +33 -0
- package/agent-docs/ctx-surface.md +69 -0
- package/agent-docs/engine-capabilities.md +4 -0
- package/agent-docs/framework-blocks-you.md +60 -0
- package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
- package/agent-docs/performance-default.md +42 -0
- package/agent-docs/pixel-budget.md +20 -0
- package/agent-docs/playtest-fail-closed.md +23 -0
- package/agent-docs/references/assertion-reference.md +652 -0
- package/agent-docs/references/capability-reference.md +3279 -0
- package/agent-docs/references/capture-the-frame.md +53 -0
- package/agent-docs/references/ctx-cookbook.md +51 -0
- package/agent-docs/references/debug-surface.md +63 -0
- package/agent-docs/references/finding-assets.md +147 -0
- package/agent-docs/references/gameplay-recipes.md +54 -0
- package/agent-docs/references/menu-screens.md +69 -0
- package/agent-docs/references/mobile-memory-budget.md +87 -0
- package/agent-docs/references/sculpt-from-a-reference.md +39 -0
- package/agent-docs/references/visual-baseline.md +133 -0
- package/agent-docs/references/webview-ui.md +113 -0
- package/agent-docs/sculpt-loop.md +16 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -0
- package/agent-files/.threenative/agents/builder.md +32 -0
- package/agent-files/.threenative/agents/verifier.md +31 -0
- package/agent-files/AGENT-ROLES.md +26 -0
- package/capabilities.json +3542 -0
- package/dist/index.d.ts +191 -3
- package/dist/index.js +1707 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +1825 -148
- package/package.json +30 -6
- package/template-assets/loading.ts +315 -0
- package/template-assets/patches/three@0.185.1.patch +287 -0
- package/templates/action-rpg/.codex/config.toml +15 -0
- package/templates/action-rpg/.mcp.json +6 -2
- package/templates/action-rpg/AGENTS.md +370 -6
- package/templates/action-rpg/CLAUDE.md +370 -6
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +23 -9
- package/templates/action-rpg/playtests/fail.playtest.json +3 -3
- package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
- package/templates/action-rpg/playtests/performance.playtest.json +22 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- package/templates/action-rpg/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/public/icon.png +0 -0
- package/templates/action-rpg/src/entities/Enemy.ts +14 -4
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/lighting.ts +6 -1
- package/templates/action-rpg/src/render/loading.ts +267 -42
- package/templates/action-rpg/src/render/postprocessing.ts +68 -15
- package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
- package/templates/action-rpg/src/scenes/Play.ts +49 -19
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +45 -1
- package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
- package/templates/action-rpg/src/ui/App.tsx +9 -8
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
- package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
- package/templates/action-rpg/src/ui/Hud.tsx +10 -8
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
- package/templates/action-rpg/src/ui/main.tsx +14 -0
- package/templates/action-rpg/threenative.config.ts +21 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +15 -0
- package/templates/defense/.mcp.json +6 -2
- package/templates/defense/AGENTS.md +371 -8
- package/templates/defense/CLAUDE.md +371 -8
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +22 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
- package/templates/defense/playtests/scan.playtest.json +3 -3
- package/templates/defense/playtests/survive.playtest.json +11 -6
- package/templates/defense/public/icon.png +0 -0
- package/templates/defense/src/attackers/Attacker.ts +28 -12
- package/templates/defense/src/game.ts +24 -2
- package/templates/defense/src/render/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +263 -37
- package/templates/defense/src/render/postprocessing.ts +70 -13
- package/templates/defense/src/render/shapes.ts +38 -0
- package/templates/defense/src/render/worldEnvironment.ts +583 -0
- package/templates/defense/src/scenes/Defense.ts +109 -50
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +45 -1
- package/templates/defense/src/ui/App.tsx +9 -4
- package/templates/defense/src/ui/GameUi.tsx +20 -0
- package/templates/defense/src/ui/Hud.tsx +6 -5
- package/templates/defense/src/ui/main.tsx +14 -0
- package/templates/defense/threenative.config.ts +21 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +15 -0
- package/templates/minimal/.mcp.json +6 -2
- package/templates/minimal/AGENTS.md +360 -255
- package/templates/minimal/CLAUDE.md +360 -255
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +17 -5
- package/templates/minimal/public/icon.png +0 -0
- package/templates/minimal/src/game.ts +1 -0
- package/templates/minimal/src/render/camera.ts +1 -1
- package/templates/minimal/src/render/hud.ts +24 -8
- package/templates/minimal/src/render/lighting.ts +23 -2
- package/templates/minimal/src/render/loading.ts +23 -103
- package/templates/minimal/src/render/postprocessing.ts +92 -14
- package/templates/minimal/src/render/sky.ts +37 -32
- package/templates/minimal/src/render/worldEnvironment.ts +583 -0
- package/templates/minimal/src/scenes/Play.ts +91 -13
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/threenative.config.ts +15 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +15 -0
- package/templates/platformer/.mcp.json +6 -2
- package/templates/platformer/AGENTS.md +385 -130
- package/templates/platformer/CLAUDE.md +385 -130
- package/templates/platformer/index.html +0 -1
- package/templates/platformer/package.json +17 -14
- package/templates/platformer/playtests/avoidance.playtest.json +6 -1
- package/templates/platformer/playtests/branding.playtest.json +29 -0
- package/templates/platformer/playtests/buffer.playtest.json +1 -1
- package/templates/platformer/playtests/collect.playtest.json +1 -1
- package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
- package/templates/platformer/playtests/coyote.playtest.json +42 -8
- package/templates/platformer/playtests/damage.playtest.json +4 -1
- package/templates/platformer/playtests/dash.playtest.json +2 -2
- package/templates/platformer/playtests/jump.playtest.json +2 -3
- package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
- package/templates/platformer/playtests/oneway.playtest.json +1 -1
- package/templates/platformer/playtests/performance.playtest.json +6 -5
- package/templates/platformer/playtests/respawn.playtest.json +2 -2
- package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
- package/templates/platformer/playtests/stomp.playtest.json +11 -3
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/platformer/src/entities/Character.ts +16 -10
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +24 -1
- package/templates/platformer/src/render/lighting.ts +6 -1
- package/templates/platformer/src/render/loading.ts +270 -61
- package/templates/platformer/src/render/postprocessing.ts +68 -15
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +583 -0
- package/templates/platformer/src/scenes/Level.ts +47 -22
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +45 -1
- package/templates/platformer/src/ui/App.tsx +9 -4
- package/templates/platformer/src/ui/GameUi.tsx +20 -0
- package/templates/platformer/src/ui/Hud.tsx +6 -5
- package/templates/platformer/src/ui/main.tsx +14 -0
- package/templates/platformer/threenative.config.ts +20 -10
- package/templates/platformer/vite.config.ts +34 -1
- package/templates/racing/.codex/config.toml +15 -0
- package/templates/racing/.mcp.json +6 -2
- package/templates/racing/AGENTS.md +370 -6
- package/templates/racing/CLAUDE.md +370 -6
- package/templates/racing/index.html +0 -1
- package/templates/racing/package.json +16 -12
- package/templates/racing/playtests/boost.playtest.json +5 -5
- package/templates/racing/playtests/outcome.playtest.json +14 -4
- package/templates/racing/playtests/performance.playtest.json +22 -0
- package/templates/racing/playtests/ranking.playtest.json +2 -2
- package/templates/racing/playtests/rescue.playtest.json +12 -6
- package/templates/racing/playtests/reverse.playtest.json +3 -3
- package/templates/racing/playtests/shortcut.playtest.json +3 -3
- package/templates/racing/public/icon.png +0 -0
- package/templates/racing/src/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +10 -6
- package/templates/racing/src/render/lighting.ts +6 -1
- package/templates/racing/src/render/loading.ts +291 -34
- package/templates/racing/src/render/postprocessing.ts +70 -13
- package/templates/racing/src/render/worldEnvironment.ts +583 -0
- package/templates/racing/src/scenes/Race.ts +68 -36
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +45 -1
- package/templates/racing/src/track/Lap.ts +20 -9
- package/templates/racing/src/track/Ranking.ts +53 -14
- package/templates/racing/src/track/Track.ts +29 -16
- package/templates/racing/src/track/TrackSector.ts +14 -4
- package/templates/racing/src/ui/App.tsx +9 -4
- package/templates/racing/src/ui/GameUi.tsx +20 -0
- package/templates/racing/src/ui/Hud.tsx +6 -5
- package/templates/racing/src/ui/main.tsx +14 -0
- package/templates/racing/threenative.config.ts +21 -8
- package/templates/racing/vite.config.ts +34 -1
- package/templates/sailing/.codex/config.toml +15 -0
- package/templates/sailing/.mcp.json +20 -0
- package/templates/sailing/AGENTS.md +388 -0
- package/templates/sailing/CLAUDE.md +390 -0
- package/templates/sailing/README.md +25 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/survives.playtest.json +21 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -0
- package/templates/sailing/playtests/survives.playtest.json +38 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/entities/Ship.ts +96 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +21 -0
- package/templates/sailing/src/render/lighting.ts +36 -0
- package/templates/sailing/src/render/loading.ts +315 -0
- package/templates/sailing/src/render/materials.ts +28 -0
- package/templates/sailing/src/render/palette.ts +24 -0
- package/templates/sailing/src/render/postprocessing.ts +33 -0
- package/templates/sailing/src/render/props.ts +52 -0
- package/templates/sailing/src/render/sky.ts +32 -0
- package/templates/sailing/src/render/water-material.ts +14 -0
- package/templates/sailing/src/render/water-shaders.ts +12 -0
- package/templates/sailing/src/render/wave-nodes.ts +10 -0
- package/templates/sailing/src/render/worldEnvironment.ts +590 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +106 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +61 -0
- package/templates/sailing/src/ui/App.tsx +15 -0
- package/templates/sailing/src/ui/GameUi.tsx +12 -0
- package/templates/sailing/src/ui/Hud.tsx +55 -0
- package/templates/sailing/src/ui/Menu.tsx +30 -0
- package/templates/sailing/src/ui/main.tsx +7 -0
- package/templates/sailing/tailwind.config.ts +2 -0
- package/templates/sailing/threenative.config.ts +34 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +15 -0
- package/templates/shooter/.mcp.json +6 -2
- package/templates/shooter/AGENTS.md +373 -7
- package/templates/shooter/CLAUDE.md +373 -7
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +131 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +22 -0
- package/templates/shooter/playtests/shooter.playtest.json +22 -18
- package/templates/shooter/playtests/survives.playtest.json +1 -1
- package/templates/shooter/public/favicon.svg +1 -1
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/game.ts +24 -1
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +62 -12
- package/templates/shooter/src/render/lighting.ts +6 -1
- package/templates/shooter/src/render/loading.ts +262 -33
- package/templates/shooter/src/render/palette.ts +1 -1
- package/templates/shooter/src/render/postprocessing.ts +68 -16
- package/templates/shooter/src/render/shapes.ts +178 -0
- package/templates/shooter/src/render/ui.css +34 -1
- package/templates/shooter/src/render/worldEnvironment.ts +583 -0
- package/templates/shooter/src/scenes/Play.ts +246 -73
- package/templates/shooter/src/state.ts +13 -0
- package/templates/shooter/src/style.css +26 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/GameUi.tsx +20 -0
- package/templates/shooter/src/ui/Hud.tsx +8 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Projectile.ts +21 -10
- package/templates/shooter/threenative.config.ts +21 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +15 -0
- package/templates/starter/.mcp.json +6 -2
- package/templates/starter/AGENTS.md +429 -326
- package/templates/starter/CLAUDE.md +429 -326
- package/templates/starter/assets/pickup.wav +0 -0
- package/templates/starter/gitignore +4 -0
- package/templates/starter/index.html +0 -1
- package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -0
- package/templates/starter/playtests/buffer.playtest.json +59 -9
- package/templates/starter/playtests/cloth.playtest.json +113 -0
- package/templates/starter/playtests/coyote.playtest.json +60 -8
- package/templates/starter/playtests/forward.playtest.json +29 -4
- package/templates/starter/playtests/gameover.playtest.json +66 -0
- package/templates/starter/playtests/goal.playtest.json +67 -0
- package/templates/starter/playtests/hot-reload.playtest.json +48 -8
- package/templates/starter/playtests/look.playtest.json +34 -6
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +74 -0
- package/templates/starter/playtests/monitoring.playtest.json +38 -7
- package/templates/starter/playtests/odometer.playtest.json +54 -0
- package/templates/starter/playtests/pause.playtest.json +27 -4
- package/templates/starter/playtests/play.playtest.json +43 -7
- package/templates/starter/playtests/respawn.playtest.json +46 -6
- package/templates/starter/playtests/restart.playtest.json +65 -10
- package/templates/starter/playtests/seed.playtest.json +44 -8
- package/templates/starter/playtests/survives.playtest.json +27 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/src/entities/Goal.ts +122 -0
- package/templates/starter/src/entities/Player.ts +40 -2
- package/templates/starter/src/game.ts +25 -0
- package/templates/starter/src/render/camera.ts +31 -5
- package/templates/starter/src/render/easing.ts +5 -0
- package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
- package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
- package/templates/starter/src/render/effects/sparkle.ts +49 -0
- package/templates/starter/src/render/lighting.ts +6 -1
- package/templates/starter/src/render/loading.ts +315 -0
- package/templates/starter/src/render/materials.ts +17 -1
- package/templates/starter/src/render/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +46 -15
- package/templates/starter/src/render/scenery.ts +83 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- package/templates/starter/src/render/worldEnvironment.ts +583 -0
- package/templates/starter/src/scenes/Play.ts +146 -36
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +45 -1
- package/templates/starter/src/ui/App.tsx +9 -6
- package/templates/starter/src/ui/GameUi.tsx +20 -0
- package/templates/starter/src/ui/Hud.tsx +52 -29
- package/templates/starter/src/ui/Menu.tsx +25 -23
- package/templates/starter/src/ui/main.tsx +14 -0
- package/templates/starter/threenative.config.ts +27 -9
- package/templates/starter/tools/look.mjs +109 -0
- package/templates/starter/vite.config.ts +32 -2
- package/templates/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,182 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
import { IThreeNativeIconVariants, ThreeNativeOrientation, IThreeNativeBootSplash, ThreeNativeUiRenderer, IThreeNativeTexturesConfig } from '@threenative/core';
|
|
3
|
+
|
|
4
|
+
interface IEngineFreshnessVitePlugin {
|
|
5
|
+
readonly name: string;
|
|
6
|
+
readonly apply: "serve";
|
|
7
|
+
config(config: {
|
|
8
|
+
readonly root?: string;
|
|
9
|
+
}, env: {
|
|
10
|
+
readonly command: string;
|
|
11
|
+
}): {
|
|
12
|
+
optimizeDeps: {
|
|
13
|
+
force: boolean;
|
|
14
|
+
};
|
|
15
|
+
} | undefined;
|
|
16
|
+
configureServer(server: {
|
|
17
|
+
readonly config: {
|
|
18
|
+
readonly root?: string;
|
|
19
|
+
};
|
|
20
|
+
readonly httpServer?: {
|
|
21
|
+
once(event: string, listener: () => void): unknown;
|
|
22
|
+
address(): {
|
|
23
|
+
readonly port?: number;
|
|
24
|
+
} | string | null;
|
|
25
|
+
} | null;
|
|
26
|
+
}): void;
|
|
27
|
+
}
|
|
28
|
+
/** Content hash of every installed `@threenative/*` package's `dist/`, or null when none is installed. */
|
|
29
|
+
declare function hashEngineDist(projectRoot: string): string | undefined;
|
|
30
|
+
declare function createEngineFreshnessPlugin(): IEngineFreshnessVitePlugin;
|
|
31
|
+
|
|
32
|
+
interface IResolvedThreeNativeConfig {
|
|
33
|
+
readonly app: {
|
|
34
|
+
readonly id: string;
|
|
35
|
+
readonly name: string;
|
|
36
|
+
readonly version: string;
|
|
37
|
+
readonly build: number;
|
|
38
|
+
readonly icon?: string;
|
|
39
|
+
readonly icons?: IThreeNativeIconVariants;
|
|
40
|
+
};
|
|
41
|
+
readonly display: {
|
|
42
|
+
readonly orientation: ThreeNativeOrientation;
|
|
43
|
+
readonly fullscreen: boolean;
|
|
44
|
+
readonly keepScreenOn: boolean;
|
|
45
|
+
readonly maxFps: number;
|
|
46
|
+
};
|
|
47
|
+
readonly window: {
|
|
48
|
+
readonly title: string;
|
|
49
|
+
readonly width: number;
|
|
50
|
+
readonly height: number;
|
|
51
|
+
readonly resizable: boolean;
|
|
52
|
+
};
|
|
53
|
+
readonly bootSplash?: IThreeNativeBootSplash;
|
|
54
|
+
readonly nativeEntry: string;
|
|
55
|
+
readonly renderer: {
|
|
56
|
+
readonly preferWebGPU: boolean;
|
|
57
|
+
readonly resolutionScale?: number | "auto";
|
|
58
|
+
readonly antialias?: boolean;
|
|
59
|
+
readonly android?: {
|
|
60
|
+
readonly resolutionScale?: number | "auto";
|
|
61
|
+
readonly antialias?: boolean;
|
|
62
|
+
};
|
|
63
|
+
};
|
|
64
|
+
readonly ui: {
|
|
65
|
+
readonly renderer: ThreeNativeUiRenderer;
|
|
66
|
+
};
|
|
67
|
+
readonly assets?: {
|
|
68
|
+
readonly models?: "none" | IThreeNativeModelsConfig;
|
|
69
|
+
readonly output?: string;
|
|
70
|
+
readonly source?: string;
|
|
71
|
+
readonly targets?: {
|
|
72
|
+
readonly maxMaterials?: number;
|
|
73
|
+
readonly maxTriangles?: number;
|
|
74
|
+
readonly maxTextureDimension?: number;
|
|
75
|
+
};
|
|
76
|
+
/** Texture compression options, or `"none"` to ship every texture exactly as committed. */
|
|
77
|
+
readonly textures?: "none" | IThreeNativeTexturesConfig;
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
/** Model optimization sub-pass switches; absent means every pass runs. */
|
|
81
|
+
interface IThreeNativeModelPassesConfig {
|
|
82
|
+
readonly dedup?: boolean;
|
|
83
|
+
readonly meshopt?: boolean;
|
|
84
|
+
readonly prune?: boolean;
|
|
85
|
+
readonly quantize?: boolean;
|
|
86
|
+
readonly reorder?: boolean;
|
|
87
|
+
}
|
|
88
|
+
interface IThreeNativeModelsConfig {
|
|
89
|
+
readonly lightmap?: {
|
|
90
|
+
readonly atlasSize: number;
|
|
91
|
+
readonly padding: number;
|
|
92
|
+
};
|
|
93
|
+
readonly passes?: IThreeNativeModelPassesConfig;
|
|
94
|
+
readonly quantize?: {
|
|
95
|
+
/** Normal precision in bits, default 8. */
|
|
96
|
+
readonly normalBits?: number;
|
|
97
|
+
/** Position precision in bits, default 16. */
|
|
98
|
+
readonly positionBits?: number;
|
|
99
|
+
/** UV precision in bits, default 12. */
|
|
100
|
+
readonly uvBits?: number;
|
|
101
|
+
};
|
|
102
|
+
/**
|
|
103
|
+
* Embedded-texture compression for images carried inside a `.glb`.
|
|
104
|
+
*
|
|
105
|
+
* On by default in the compile step; `"none"` ships every embedded image exactly as
|
|
106
|
+
* authored. `maxSize` caps the longest edge, preserving aspect and snapping to whole 4x4
|
|
107
|
+
* blocks, and never upscales.
|
|
108
|
+
*/
|
|
109
|
+
readonly textures?: "none" | {
|
|
110
|
+
readonly maxSize?: number;
|
|
111
|
+
readonly quality?: number;
|
|
112
|
+
readonly overrides?: readonly {
|
|
113
|
+
readonly slot: string;
|
|
114
|
+
readonly codec: "etc1s" | "none" | "uastc";
|
|
115
|
+
}[];
|
|
116
|
+
};
|
|
117
|
+
/**
|
|
118
|
+
* Mesh simplification. Absent means none at all, which is the default.
|
|
119
|
+
*
|
|
120
|
+
* `ratio` is the fraction of triangles to keep. `error` is a quality guard rather than a
|
|
121
|
+
* target — the largest a vertex may move as a fraction of the mesh's extent — so a loose
|
|
122
|
+
* ratio with a tight error stops short, and the compile step reports the ratio it actually
|
|
123
|
+
* achieved next to the one that was asked for.
|
|
124
|
+
*/
|
|
125
|
+
readonly simplify?: {
|
|
126
|
+
readonly ratio: number;
|
|
127
|
+
readonly error?: number;
|
|
128
|
+
};
|
|
129
|
+
/**
|
|
130
|
+
* Cluster-DAG bake for virtual geometry: options, or `"none"` to ship every primitive as
|
|
131
|
+
* authored. **Absent means the bake runs with defaults**, exactly as `textures` does.
|
|
132
|
+
*
|
|
133
|
+
* Only primitives at or above `minSourceTriangles` (65,536 by default) are touched, so ordinary
|
|
134
|
+
* props compile byte-identically either way; a body dense enough to matter gets a cluster DAG and
|
|
135
|
+
* the engine draws only what the camera can resolve. The payload costs about 3-4x the primitive's
|
|
136
|
+
* compiled bytes, which is why the threshold is where it is. There is no runtime switch: a
|
|
137
|
+
* minutes-long bake cannot happen at run time.
|
|
138
|
+
*/
|
|
139
|
+
readonly virtual?: {
|
|
140
|
+
readonly groupSize?: number;
|
|
141
|
+
readonly maxTriangles?: number;
|
|
142
|
+
readonly minSourceTriangles?: number;
|
|
143
|
+
readonly minTriangles?: number;
|
|
144
|
+
readonly simplifyRatio?: number;
|
|
145
|
+
} | "none";
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
interface IWebBrandVitePlugin {
|
|
149
|
+
readonly name: string;
|
|
150
|
+
configResolved(config: {
|
|
151
|
+
readonly root: string;
|
|
152
|
+
}): Promise<void>;
|
|
153
|
+
transformIndexHtml(html: string): string;
|
|
154
|
+
generateBundle(this: {
|
|
155
|
+
emitFile(asset: {
|
|
156
|
+
fileName: string;
|
|
157
|
+
source: string;
|
|
158
|
+
type: "asset";
|
|
159
|
+
}): void;
|
|
160
|
+
}): void;
|
|
161
|
+
}
|
|
162
|
+
declare function renderWebManifest(root: string, config: IResolvedThreeNativeConfig): string;
|
|
163
|
+
declare function createWebBrandPlugin(): IWebBrandVitePlugin;
|
|
164
|
+
|
|
2
165
|
type ScaffoldTemplate = string;
|
|
166
|
+
declare const PACKAGE_SOURCE_FLAGS: {
|
|
167
|
+
readonly "@threenative/core": "--core-package";
|
|
168
|
+
readonly "@threenative/assets": "--assets-package";
|
|
169
|
+
readonly "@threenative/physics": "--physics-package";
|
|
170
|
+
readonly "@threenative/playtest": "--playtest-package";
|
|
171
|
+
readonly "@threenative/runtime-native": "--runtime-native-package";
|
|
172
|
+
readonly "@threenative/ui": "--ui-package";
|
|
173
|
+
readonly "threenative-engine-mcp": "--engine-mcp-package";
|
|
174
|
+
readonly "create-threenative": "--cli-package";
|
|
175
|
+
};
|
|
176
|
+
type PackageSourceName = keyof typeof PACKAGE_SOURCE_FLAGS;
|
|
177
|
+
type PackageSources = Partial<Record<PackageSourceName, string>> & {
|
|
178
|
+
readonly [packageName: string]: string | undefined;
|
|
179
|
+
};
|
|
3
180
|
interface IKitManifest {
|
|
4
181
|
readonly blurb: string;
|
|
5
182
|
readonly genre: string;
|
|
@@ -9,7 +186,7 @@ interface IKitManifest {
|
|
|
9
186
|
}
|
|
10
187
|
interface IScaffoldOptions {
|
|
11
188
|
install?: boolean;
|
|
12
|
-
packageSources?:
|
|
189
|
+
packageSources?: PackageSources;
|
|
13
190
|
target: string;
|
|
14
191
|
template?: ScaffoldTemplate;
|
|
15
192
|
}
|
|
@@ -19,12 +196,23 @@ interface IScaffoldResult {
|
|
|
19
196
|
template: ScaffoldTemplate;
|
|
20
197
|
}
|
|
21
198
|
declare function templateRoot(): string;
|
|
199
|
+
declare const FULL_LOADING_TEMPLATES: readonly ["action-rpg", "defense", "platformer", "racing", "sailing", "shooter", "starter"];
|
|
200
|
+
/** The canonical generated loading implementation ships beside, rather than inside, a kit. */
|
|
201
|
+
declare function canonicalLoadingPath(root?: string): string;
|
|
202
|
+
/** Replaces only the declared per-kit appearance block and preserves the canonical implementation. */
|
|
203
|
+
declare function stampLoadingSource(canonical: string, template: string): string;
|
|
204
|
+
/** Re-stamps every tracked full kit from the canonical source, preserving each kit's appearance. */
|
|
205
|
+
declare function restampTemplateLoadingCopies(root?: string): Promise<readonly string[]>;
|
|
22
206
|
/** Reads every template directory on each call so a new kit is live without a TypeScript edit. */
|
|
23
207
|
declare function discoverKitManifests(root?: string): readonly IKitManifest[];
|
|
24
208
|
declare function discoverTemplateNames(root?: string): readonly ScaffoldTemplate[];
|
|
25
209
|
declare function kitManifest(template: ScaffoldTemplate, root?: string): IKitManifest;
|
|
210
|
+
/** Resolve an exact public genre to its kit. Unknown genres deliberately start from minimal:
|
|
211
|
+
* genre words are authoring input, not an invitation to guess the closest preset. */
|
|
212
|
+
declare function templateForGenre(genre: string, root?: string): ScaffoldTemplate;
|
|
213
|
+
declare function scaffoldCompletionMessage(manifests: readonly IKitManifest[], defaultTemplate?: string): string;
|
|
26
214
|
declare function cliHelp(): string;
|
|
27
|
-
declare function createProject(options: IScaffoldOptions, cwd?: string): Promise<IScaffoldResult>;
|
|
215
|
+
declare function createProject(options: IScaffoldOptions, cwd?: string, root?: string): Promise<IScaffoldResult>;
|
|
28
216
|
declare function parseArgs(argv: readonly string[]): IScaffoldOptions;
|
|
29
217
|
|
|
30
|
-
export { type IKitManifest, type IScaffoldOptions, type IScaffoldResult, type ScaffoldTemplate, cliHelp, createProject, discoverKitManifests, discoverTemplateNames, kitManifest, parseArgs, templateRoot };
|
|
218
|
+
export { FULL_LOADING_TEMPLATES, type IKitManifest, type IScaffoldOptions, type IScaffoldResult, type ScaffoldTemplate, canonicalLoadingPath, cliHelp, createEngineFreshnessPlugin, createProject, createWebBrandPlugin, discoverKitManifests, discoverTemplateNames, hashEngineDist, kitManifest, parseArgs, renderWebManifest, restampTemplateLoadingCopies, scaffoldCompletionMessage, stampLoadingSource, templateForGenre, templateRoot };
|