@downdraft/cli 0.0.0 → 0.1.1

package/src/usage.ts

@@ -0,0 +1,256 @@
+// ============================================================================
+// usage.ts — per-command usage strings + schema registry
+// ============================================================================
+//
+// Single source of truth for every `draft` subcommand's synopsis, flags, and
+// positionals. `index.ts` generates the top-level help from this registry;
+// each command module imports its schema + usage string for `--help` output.
+//
+
+import type { CommandSchema } from "./args";
+
+export interface CommandEntry {
+  /** Command name as typed on the CLI (e.g. `"new"`). */
+  name: string;
+  /** One-line synopsis shown after `Usage:`. */
+  usage: string;
+  /** Short description for the top-level command list. */
+  summary: string;
+  /** Argument schema (flags + positionals). */
+  schema: CommandSchema;
+}
+
+// ---------------------------------------------------------------------------
+// Desktop target vocabulary (normalized): win | linux | mac | all
+// Mobile target vocabulary: android | ios | all
+// ---------------------------------------------------------------------------
+
+const DESKTOP_TARGETS = ["win", "linux", "mac", "all"] as const;
+const BUILD_TARGETS = ["current", "win", "linux", "mac"] as const;
+const RELEASE_TARGETS = ["win", "linux", "mac", "android", "all"] as const;
+const RELEASE_STAGES = ["build", "package", "release"] as const;
+const RENDERER_TARGETS = ["gpu", "cpu"] as const;
+const BUILD_MODES = ["dev", "debug", "prod"] as const;
+
+// ---------------------------------------------------------------------------
+// Command registry
+// ---------------------------------------------------------------------------
+
+export const COMMANDS: CommandEntry[] = [
+  {
+    name: "release",
+    usage: "draft release [options]",
+    summary: "Native build + package pipeline — compiles the game to a standalone binary via scripts/package-native.mjs",
+    schema: {
+      flags: [
+        { name: "game", alias: "g", type: "string", description: "Game to release (games/<game>). For multiple games, use --games. If omitted, infers from the current directory, or defaults to the only game in games/." },
+        { name: "games", type: "string", description: "Comma-separated game names (e.g. sandjongg,to-the-ocean)" },
+        { name: "target", alias: "t", type: "string", default: "all", enum: [...RELEASE_TARGETS], description: "Target platform(s): win, linux, mac, android, or all (android can't mix with desktop targets)" },
+        { name: "format", type: "string", description: "Package format(s), comma-separated: dir, deb, appimage, flatpak (linux only; default: build.linux.target in package.json, else dir)" },
+        { name: "runtime", type: "string", enum: ["bun", "node", "deno", "all"], description: "JS runtime embedded in the package: bun (compiled binary), node, deno, or all (default: build.runtime in package.json, else bun). node/deno are linux-only today" },
+        { name: "stage", type: "string", default: "release", enum: [...RELEASE_STAGES], description: "Stage: build, package, or release (all compile the native binary)" },
+        { name: "mode", type: "string", default: "prod", enum: [...BUILD_MODES], description: "Build mode" },
+        { name: "abi", type: "string", default: "arm64-v8a", description: "Android ABI(s): arm64-v8a, x86_64, or all (android target only)" },
+        { name: "min-sdk", type: "string", description: "Android minimum SDK (default 30; android target only)" },
+        { name: "node-flavor", type: "string", description: "Embedded Node build flavor: full (default) or lite — lite drops intl/inspector/sqlite/amaro (android target only)" },
+        { name: "libs", type: "string", description: "Force-include optional engine cdylibs, comma-separated (android target only)" },
+        { name: "exclude-libs", type: "string", description: "Exclude optional engine cdylibs, comma-separated (android target only)" },
+        { name: "no-strip", type: "boolean", description: "Keep debug info/symtab in packaged .so's for native debugging (android target only)" },
+        { name: "out", type: "string", default: "release", description: "Artifact output directory" },
+        { name: "skip-build", type: "boolean", description: "Alias for --stage=package" },
+        { name: "build-only", type: "boolean", description: "Alias for --stage=build" },
+        { name: "mcp", type: "boolean", description: "Retain the MCP automation endpoint in the packaged binary" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "new",
+    usage: "draft new [path] [options]",
+    summary: "Scaffold a new game project",
+    schema: {
+      positionals: [{ name: "path", description: "Target directory (default: current dir)" }],
+      flags: [
+        { name: "template", type: "string", default: "minimal", description: "Project template (minimal | physics | full | gamemodule)" },
+        { name: "name", type: "string", description: "Project name (defaults to directory basename)" },
+        { name: "description", type: "string", description: "Project description" },
+        { name: "author", type: "string", description: "Author name (written as { name } in package.json)" },
+        { name: "version", type: "string", default: "0.1.0", description: "Initial version" },
+        { name: "ai-companion", type: "boolean", description: "Scaffold .devin/ config + engine-prompt.md" },
+        { name: "force", type: "boolean", description: "Scaffold into a non-empty directory" },
+        { name: "list-templates", type: "boolean", description: "List available templates and exit" },
+      ],
+    },
+  },
+  {
+    name: "dev",
+    usage: "draft dev [options]",
+    summary: "Start the game on the native runtime (winit + wgpu; Bun, Node, or Deno host — see --runtime). Run from a game directory (cwd inference).",
+    schema: {
+      flags: [
+        { name: "entry", type: "string", description: "Game entrypoint file (defaults to src/native-entry.ts)" },
+        { name: "port", type: "number", description: "MCP HTTP port (default: auto-assign)" },
+        { name: "runtime", type: "string", enum: ["bun", "node", "deno"], description: "JS runtime hosting the dev shell (default: bun → node → deno auto-detect)" },
+        { name: "watch", type: "boolean", description: "Back-compat no-op — the HMR dev shell always watches" },
+        { name: "no-hmr", type: "boolean", description: "Disable HMR — spawn the entry directly (bun run), no dev shell" },
+        { name: "native", type: "boolean", description: "Back-compat alias — native is the default runtime" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "debug",
+    usage: "draft debug [path] [options]",
+    summary: "Run the engine in debug mode with profiling/visualization",
+    schema: {
+      positionals: [{ name: "path", description: "Project path (default: current dir)" }],
+      flags: [
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+        { name: "no-devtools", type: "boolean", description: "Disable the devtools overlay (sets DOWNDRAFT_DISABLE_DEVTOOLS=1)" },
+        { name: "inspector", type: "boolean", description: "Enable the Node inspector (chrome://inspect)" },
+      ],
+    },
+  },
+  {
+    name: "build",
+    usage: "draft build [path] [options]",
+    summary: "Build a game for a target platform",
+    schema: {
+      positionals: [{ name: "path", description: "Project path (default: current dir)" }],
+      flags: [
+        { name: "game", alias: "g", type: "string", description: "Game to build (resolves games/<game>; overrides path)" },
+        { name: "target", type: "string", default: "current", enum: [...BUILD_TARGETS], description: "Target platform" },
+        { name: "mode", type: "string", default: "prod", enum: [...BUILD_MODES], description: "Build mode" },
+        { name: "out", type: "string", default: "dist", description: "Output directory" },
+        { name: "no-minify", type: "boolean", description: "Disable minification" },
+        { name: "sourcemap", type: "boolean", description: "Generate source maps (on by default in non-prod modes)" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "build-games",
+    usage: "draft build-games --games=<csv> --platforms=<csv>",
+    summary: "Deprecated alias for `draft release --games=<csv>` (VSCode task)",
+    schema: {
+      flags: [
+        { name: "games", type: "string", required: true, description: "Comma-separated game directory names (e.g. sandjongg)" },
+        { name: "platforms", type: "string", required: true, description: "Comma-separated desktop targets (win | linux | mac; legacy :format suffixes are ignored)" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "dist",
+    usage: "draft dist [options]",
+    summary: "Package a game for distribution (deprecated alias for `draft release`)",
+    schema: {
+      flags: [
+        { name: "game", alias: "g", type: "string", required: true, description: "Game to package (games/<game>)" },
+        { name: "target", alias: "t", type: "string", default: "all", enum: [...DESKTOP_TARGETS], description: "Target platform" },
+        { name: "config", alias: "c", type: "string", description: "Explicit path to a build.config.ts / config file" },
+        { name: "project-dir", type: "string", description: "Override the project directory (default: repo root)" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "export",
+    usage: "draft export [path] [options]",
+    summary: "Package a built game for distribution (per-platform launchers)",
+    schema: {
+      positionals: [{ name: "path", description: "Project path (default: current dir)" }],
+      flags: [
+        { name: "target", type: "string", default: "all", enum: [...DESKTOP_TARGETS], description: "Target platform" },
+        { name: "out", type: "string", default: "export", description: "Output directory" },
+        { name: "no-compress", type: "boolean", description: "Disable compression" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "assets",
+    usage: "draft assets <command> [project] [options]",
+    summary: "Manage remote asset packs (pull, push, list, init, add, add-store)",
+    schema: {
+      positionals: [
+        { name: "command", required: true, description: "init | add-store | add | pull | push | list" },
+        { name: "project", description: "Project path (default: current dir)" },
+      ],
+      flags: [
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "mcp",
+    usage: "draft mcp <action> [args] [options]",
+    summary: "Call MCP automation tools on a running game (instances | tools | call | screenshot | stdio | run)",
+    schema: {
+      positionals: [
+        { name: "action", required: true, description: "instances | tools | call | screenshot | stdio | run" },
+        { name: "args", variadic: true, description: "Action args: <tool> [json] | <file.png> | <script> [script-args]" },
+      ],
+      flags: [
+        { name: "app", type: "string", description: "Select instance by appId" },
+        { name: "pid", type: "number", description: "Select instance by PID" },
+        { name: "url", type: "string", description: "Explicit MCP HTTP URL (skips PID-file discovery)" },
+        { name: "token", type: "string", description: "Bearer token (auto-read from <pid>.token otherwise)" },
+        { name: "json", type: "boolean", description: "Print the raw result envelope (image data elided to {bytes} unless --out)" },
+        { name: "out", type: "string", description: "Write image/binary result blocks to file(s)" },
+        { name: "max-bytes", type: "number", description: "Cap printed output in bytes (default 262144)" },
+        { name: "schema", type: "string", description: "tools action: print one tool's inputSchema JSON" },
+        { name: "game", alias: "g", type: "string", description: "run action: game name (games/<name>)" },
+        { name: "entry", type: "string", description: "run action: explicit native entry file" },
+        { name: "headed", type: "boolean", description: "run action: show the game window" },
+        { name: "gpu", type: "string", enum: ["auto", "hardware", "swiftshader"], description: "run action: WebGPU backend (default: swiftshader)" },
+        { name: "deterministic", type: "boolean", description: "run action: DOWNDRAFT_DETERMINISTIC=1 (fixed seed, paused render loop)" },
+        { name: "port", alias: "p", type: "number", description: "run action: pin the MCP port (default: auto)" },
+        { name: "timeout", type: "number", description: "Per-request timeout ms; readiness budget for run" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+  {
+    name: "test",
+    usage: "draft test [options]",
+    summary: "Run e2e tests via bun:test (SwiftShader + deterministic by default; default specs use the in-game MCP RPC harness)",
+    schema: {
+      flags: [
+        { name: "game", alias: "g", type: "string", required: true, description: "Game to test (games/<game>)" },
+        { name: "spec", alias: "s", type: "string", description: "Spec file to run (default: tests/e2e/<game>-smoke.spec.ts)" },
+        { name: "port", alias: "p", type: "number", default: 0, description: "MCP port (0 = auto-assign a free port)" },
+        { name: "renderer", alias: "r", type: "string", default: "cpu", enum: [...RENDERER_TARGETS], description: "WebGPU backend: cpu=SwiftShader, gpu=hardware" },
+        { name: "no-deterministic", type: "boolean", description: "Disable fixed seed / render loop pause" },
+        { name: "headed", type: "boolean", description: "Show the window instead of running headless" },
+        { name: "verbose", alias: "v", type: "boolean", description: "Verbose logging" },
+      ],
+    },
+  },
+];
+
+/** Look up a command entry by name. */
+export function getCommand(name: string): CommandEntry | undefined {
+  return COMMANDS.find((c) => c.name === name);
+}
+
+/** Render the top-level `draft` help string from the registry. */
+export function renderTopLevelHelp(version: string): string {
+  const lines: string[] = [];
+  lines.push(`DownDraft Engine CLI v${version}`);
+  lines.push("");
+  lines.push("Usage: draft <command> [options]");
+  lines.push("");
+  lines.push("Commands:");
+  const maxName = Math.max(...COMMANDS.map((c) => c.name.length));
+  COMMANDS.forEach((c) => {
+    lines.push(`  ${c.name.padEnd(maxName + 2)} ${c.summary}`);
+  });
+  lines.push("");
+  lines.push("Global options:");
+  lines.push("  -h, --help     Show help for a command (draft <cmd> --help)");
+  lines.push("  -V, --version  Print the CLI version and exit");
+  lines.push("");
+  lines.push("Run `draft help <command>` for command-specific details.");
+  return lines.join("\n");
+}

package/templates/_shared/ai-companion/devin-config.eta

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "downdraft": {
+      "command": "bun",
+      "args": ["run", "src/main.ts"],
+      "env": {
+        "DOWNDRAFT_MCP": "1"
+      }
+    }
+  }
+}

package/templates/_shared/ai-companion/engine-prompt.eta

@@ -0,0 +1,155 @@
+# DownDraft Engine — API Reference for AI Companions
+
+## Architecture
+
+DownDraft is a TypeScript-first game engine built on winit + wgpu (a single native process, hosted under Bun, Node, or Deno — Bun is the default) + WebGPU, with an MCP server enabling AI agents to design, build, debug, and manage games via natural language.
+
+**Execution contexts:**
+1. **Native host (main thread)** — Game module, renderer, render loop, engine orchestrator, MCP server, asset manager
+2. **Sim worker** — ECS world, game systems, physics, AI, modules (SharedArrayBuffer channels for frame sync)
+3. **DB worker** — Persistence layer with schema versioning
+
+## ECS (Entity Component System)
+
+- **Entity**: `{ index: u32, generation: u32 }` — generational indices prevent stale-handle corruption
+- **Component**: Plain data class implementing `Component` interface, registered with `ComponentId`
+- **Archetype**: Set of component types, SoA column storage for cache-friendly iteration
+- **Query**: Declares read/write access to component types, returns matching archetypes
+- **System**: Function `(query, resources, commands) => void`
+- **Schedule**: Single-threaded by default, dependency-ordered. Multi-threading via module/SAB.
+- **Events**: Double-buffered channels (written this tick, readable next tick)
+- **Commands**: Deferred operations (spawn/despawn, add/remove component) applied at stage boundaries
+
+### Hierarchy
+- Parent/child tree stored in side table (not archetype columns) — avoids archetype moves on reparenting
+- Dirty-flag propagation: parent Transform change marks children dirty (O(depth))
+- Lazy world matrix: computed on read when dirty
+
+### Change Detection
+- Per-component `lastChanged` tick counter — O(1) check for consumers
+- Cross-thread: `Atomics` on SAB headers for frame sync
+
+## Core API
+
+```typescript
+import { World, Camera, MeshBuilder, Component, system, createLogger } from "@downdraft/engine";
+
+// Define components
+const Health = Component.register<{ current: number; max: number }>("Health", { current: 100, max: 100 });
+
+// Define a system
+const damageSystem = system(
+  (w: World, dt: number) => {
+    const view = w.view([Health]);
+    for (const ent of view) {
+      const health = w.getComponent(ent, Health);
+      if (health && health.data.current <= 0) {
+        w.despawn(ent);
+      }
+    }
+  }
+);
+
+// Setup
+const world = new World();
+const camera = new Camera();
+camera.setAspect(16, 9);
+world.setResource("camera", camera);
+
+// Spawn entities
+const entity = world.spawn();
+world.addComponent(entity, Health.create({ current: 50, max: 100 }));
+
+// Procedural meshes
+const cube = MeshBuilder.cube(1);
+const sphere = MeshBuilder.sphere(0.5, 16, 16);
+```
+
+## Module System
+
+Modules are loadable packages that register systems, components, resources, and assets.
+
+```typescript
+import { Module } from "@downdraft/engine";
+
+const myModule: Module = {
+  name: "my-module",
+  register(ctx: ModuleContext) {
+    // Register components, systems, resources
+  },
+};
+
+world.registerModule(myModule);
+```
+
+### Engine Libraries (`@downdraft/engine/libraries/*`)
+- `@downdraft/engine/libraries/water` — Gerstner waves, refraction, reflection
+- `@downdraft/engine/libraries/physics-rapier` — Rapier physics backend
+- `@downdraft/engine/libraries/physics-native` — Pure-TS physics backend
+- `@downdraft/engine/libraries/marching-cubes` — Volumetric deformable terrain
+- `@downdraft/engine/libraries/surface-nets` — Surface nets mesh extraction
+- `@downdraft/engine/libraries/models` — GLTF/GLB/PLY/3DS model loading
+- `@downdraft/engine/libraries/audio-kira` — Kira audio backend
+- `@downdraft/engine/libraries/entities` — Generic model renderer
+- `@downdraft/engine/libraries/lighting` — Lighting system
+- `@downdraft/engine/libraries/weather` — Weather simulation
+- `@downdraft/engine/libraries/weatherfx` — Cloud particle effects
+- `@downdraft/engine/libraries/navmesh` — Navigation meshes
+- `@downdraft/engine/libraries/persistence` — Save system (OPFS, File, IndexedDB)
+- `@downdraft/engine/libraries/networking` — Multiplayer networking
+- `@downdraft/engine/libraries/gaussian-splats` — Gaussian splat rendering
+- `@downdraft/engine/libraries/sand` — Falling-sand simulation
+- `@downdraft/engine/libraries/stickman` — Stickman skeleton rendering
+
+### Engine Modules (`@downdraft/engine/modules/*`)
+- `@downdraft/engine/modules/devtools` — DevTools panel, scene inspector, GPU debugging
+- `@downdraft/engine/modules/camera-controls` — Camera input handling
+- `@downdraft/engine/modules/terrain` — Terrain composition (marching-cubes + LOD)
+- `@downdraft/engine/modules/movement-3d` — 3D player movement
+- `@downdraft/engine/modules/movement-2d` — 2D grid-based movement
+- `@downdraft/engine/modules/sailing` — Sailing mechanics (wind, buoyancy, steering)
+- `@downdraft/engine/modules/mcp` — MCP automation server
+- `@downdraft/engine/modules/xr` — WebXR support
+
+### Game Modules (to-the-ocean example: `@to-the-ocean/module-*`)
+- `@to-the-ocean/module-crafting` — Crafting recipes and system
+- `@to-the-ocean/module-inventory` — Inventory system
+- `@to-the-ocean/module-wildlife` — Wildlife AI (fish, sharks, eels, etc.)
+- `@to-the-ocean/module-buoyancy` — Water buoyancy physics
+- `@to-the-ocean/module-collision` — Entity collision detection
+
+### Game Libraries (to-the-ocean example: `@to-the-ocean/library-*`)
+- `@to-the-ocean/library-items` — Item definitions and management
+- `@to-the-ocean/library-fishing` — Fishing mechanics
+- `@to-the-ocean/library-economy` — Market/trading system
+- `@to-the-ocean/library-survival` — Survival stats (hunger, thirst, oxygen)
+- `@to-the-ocean/library-boats` — Boat building and piloting
+
+## Builder Modes
+
+| Mode | Use case |
+|---|---|
+| **dev** | Full DevTools, hot-reload, telemetry. Fastest iteration. |
+| **debug** | Local verification on the production native runtime. |
+| **prod** | Optimized production build. No devtools/debug overhead. |
+
+## CLI Commands
+
+```
+draft new [path] [options]      Scaffold a new game project
+draft dev [options]             Start dev server with HMR
+draft debug [options]           Run engine in debug mode
+draft release [options]         Unified build + package + sign pipeline
+                                (--stage=build|package|release, --target=win|linux|mac|all)
+draft assets <cmd>              Manage remote asset packs
+```
+
+## MCP Tools (for AI agents)
+
+The MCP server exposes tools for scene management, entity operations, component manipulation, material/shader editing, mesh import, animation, lighting, camera, physics, audio, scripting, asset management, debugging, checkpoints, and build/export.
+
+## Conventions
+
+- **Logging**: No manual `[module]` prefixes — automatic source attribution
+- **Loops**: Prefer indexed `for` loops over `for..of`
+- **Package manager**: Bun (workspace protocol for internal deps)

package/templates/_shared/ai-companion/logging-rule.eta

@@ -0,0 +1,3 @@
+# Logging Convention
+
+Logs are automatically sourced to the line from which they are printed. Do NOT manually add `[module]` prefixes to log messages — the logging system handles source attribution automatically.

package/templates/_shared/ai-companion/loops-rule.eta

@@ -0,0 +1,3 @@
+# Loop Convention
+
+Always prefer indexed `for` loops (`for (let i = 0; i < arr.length; i++)`) over `for..of` loops.

package/templates/_shared/partials/config-json-fields.eta

@@ -0,0 +1,3 @@
+  "name": "<%= it.name %>",
+  "version": "<%= it.version %>",
+  "engine": "downdraft"

package/templates/_shared/partials/dev-deps.eta

@@ -0,0 +1,8 @@
+  "devDependencies": {
+    "@downdraft/cli": "^0.1.0",
+    "@types/node": "^22.10.0",
+    "@webgpu/types": "^0.1.71",
+    "oxlint": "^1.4.0",
+    "typescript": "^5.9.3",
+    "vite": "^6.0.0"
+  }

package/templates/_shared/partials/package-json-fields.eta

@@ -0,0 +1,12 @@
+  "version": "<%= it.version %>",<% if (it.description) { %>
+  "description": "<%= it.description %>",<% } %><% if (it.author) { %>
+  "author": { "name": "<%= it.author %>" },<% } %>
+  "type": "module",
+  "scripts": {
+    "dev": "draft dev",
+    "build": "draft release --stage=build",
+    "release": "draft release",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint",
+    "test": "npm test"
+  },

package/templates/_shared/partials/tsconfig.eta

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "types": ["@webgpu/types", "node", "vite/client"],
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src"]
+}

package/templates/_shared/partials/vscode-extensions.eta

@@ -0,0 +1,11 @@
+{
+  "recommendations": [
+    "antaalt.shader-validator",
+    "PKief.material-icon-theme",
+    "actboy168.tasks",
+    "Gruntfuggly.todo-tree",
+    "augustocdias.tasks-shell-input",
+    "oxc.oxc-vscode",
+    "wgsl-analyzer.wgsl-analyzer"
+  ]
+}

package/templates/_shared/partials/vscode-settings.eta

@@ -0,0 +1,29 @@
+{
+  "explorer.fileNesting.enabled": true,
+  "explorer.fileNesting.expand": false,
+  "explorer.fileNesting.patterns": {
+    "*.ts": "${capture}.js, ${capture}.spec.ts, ${capture}.*.spec.ts, ${capture}.test.ts",
+    "*.tsx": "${capture}.spec.ts, ${capture}.*.spec.ts, ${capture}.test.ts",
+    "*.js": "${capture}.js.map, ${capture}.min.js, ${capture}.d.ts, ${capture}.wasm, ${capture}.wasm.map",
+    "tsconfig.json": "tsconfig.*.json",
+    "package.json": "package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lock"
+  },
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "explicit"
+  },
+  "files.associations": {
+    "*.wgsl": "wgsl"
+  },
+  "files.watcherExclude": {
+    "**/node_modules/**": true,
+    "**/dist/**": true,
+    "**/export/**": true,
+    "**/tmp/**": true
+  },
+  "search.exclude": {
+    "**/node_modules/**": true,
+    "**/dist/**": true,
+    "**/export/**": true,
+    "**/tmp/**": true
+  }
+}

package/templates/_shared/partials/vscode-tasks.eta

@@ -0,0 +1,93 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Dev",
+      "detail": "Start the game in dev mode with hot reload",
+      "type": "shell",
+      "command": "draft dev",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "isBackground": true,
+      "problemMatcher": [],
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      }
+    },
+    {
+      "label": "Release",
+      "detail": "Build + package for a desktop target",
+      "type": "shell",
+      "command": "draft release --target=${input:releaseTarget} --mode=${input:buildMode}",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "presentation": {
+        "echo": true,
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": true,
+        "showReuseMessage": false
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Build Only",
+      "detail": "Bundle the game with Vite (no packaging)",
+      "type": "shell",
+      "command": "draft release --stage=build --mode=${input:buildMode}",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Typecheck",
+      "detail": "Run tsc --noEmit",
+      "type": "shell",
+      "command": "npm run typecheck",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "problemMatcher": ["$tsc"]
+    },
+    {
+      "label": "Lint",
+      "detail": "Run oxlint",
+      "type": "shell",
+      "command": "npm run lint",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Test",
+      "detail": "Run tests",
+      "type": "shell",
+      "command": "npm test",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "problemMatcher": []
+    }
+  ],
+  "inputs": [
+    {
+      "id": "releaseTarget",
+      "type": "pickString",
+      "options": ["all", "win", "linux", "mac"],
+      "default": "all",
+      "description": "Target platform(s)"
+    },
+    {
+      "id": "buildMode",
+      "type": "pickString",
+      "options": ["prod", "dev", "debug"],
+      "default": "prod",
+      "description": "Build mode"
+    }
+  ]
+}

package/templates/full/.gitignore.eta

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+export/
+*.log
+.DS_Store

package/templates/full/.vscode/extensions.json.eta

@@ -0,0 +1 @@
+<%~ include("_shared/partials/vscode-extensions", it) %>

package/templates/full/.vscode/settings.json.eta

@@ -0,0 +1 @@
+<%~ include("_shared/partials/vscode-settings", it) %>

package/templates/full/.vscode/tasks.json.eta

@@ -0,0 +1 @@
+<%~ include("_shared/partials/vscode-tasks", it) %>