create-gametau 0.5.0-alpha.2 → 0.5.0

package/README.md

@@ -1,61 +1,64 @@
-# create-gametau
-
-Scaffold a Rust game project for the stable Web (WASM) + Tauri desktop path from one codebase.
-
-Electrobun is available as an experimental opt-in track and is documented separately: `docs/ELECTROBUN-EXPERIMENTAL.md`.
-
-## Quick Start
-
-```bash
-bunx create-gametau my-game
-cd my-game
-bun install
-bun run dev
-```
-
-For a step-by-step scaffold-to-playable tutorial (browser and Tauri), see:
-[`docs/GETTING-STARTED.md`](../../docs/GETTING-STARTED.md)
-
-For the experimental Electrobun trial flow, see:
-[`docs/ELECTROBUN-EXPERIMENTAL.md`](../../docs/ELECTROBUN-EXPERIMENTAL.md)
-
-## Templates
-
-- `three` (default) - Three.js rendering starter
-- `pixi` - PixiJS rendering starter
-- `vanilla` - Canvas 2D starter
-
-```bash
-bunx create-gametau my-game --template pixi
-bunx create-gametau my-game --template vanilla
-```
-
-## CLI Options
-
-- `--template`, `-t` - Choose scaffold template (`three`, `pixi`, `vanilla`)
-- `--help`, `-h` - Show help output
-- `--version`, `-v` - Print CLI version
-
-## What gets scaffolded
-
-- `src-tauri/core` - pure Rust game logic
-- `src-tauri/commands` - shared command definitions for desktop + web
-- `src-tauri/app` - Tauri desktop shell (stable default desktop runtime)
-- `src-tauri/wasm` - WASM entry crate
-- `src` - frontend app wired to `webtau` and `webtau-vite`
-- `src/services` - production-ready service seams for backend invoke calls, persistence/settings, mission session snapshots, and event-driven comms
-
-## Service Layer Contract
-
-The scaffolded base template now ships a small service architecture instead of a single command wrapper:
-
-- `src/services/backend.ts` - typed `invoke()` wrappers for gameplay commands
-- `src/services/settings.ts` - runtime settings persistence via `webtau/path` + `webtau/fs`
-- `src/services/session.ts` - mission/session snapshot persistence via `webtau/path` + `webtau/fs`
-- `src/services/comms.ts` - typed alert/comms channel over `webtau/event`
-- `src/services/contracts.ts` - interfaces/types for settings, session snapshots, and alerts
-
-This keeps the generated project lightweight while giving contributors clear extension points for production features.
-
-For full docs and package details, see the main repository:
-<https://github.com/devallibus/gametau>
+# create-gametau
+
+Scaffold a Rust game project for the stable Web (WASM) + Tauri desktop path from one codebase.
+
+Electrobun is available as an experimental opt-in track — see [active milestones](https://github.com/devallibus/gametau/milestones).
+
+> Repository note: `docs/` is intentionally local-only and not published in remote history.
+
+## Quick Start
+
+```bash
+bunx create-gametau my-game
+cd my-game
+bun install
+bun run dev
+```
+
+For project status and rollout context, see [active milestones](https://github.com/devallibus/gametau/milestones).
+
+## Templates
+
+- `three` (default) - Three.js rendering starter
+- `pixi` - PixiJS rendering starter
+- `vanilla` - Canvas 2D starter
+
+```bash
+bunx create-gametau my-game --template pixi
+bunx create-gametau my-game --template vanilla
+```
+
+## CLI Options
+
+- `--template`, `-t` - Choose scaffold template (`three`, `pixi`, `vanilla`)
+- `--help`, `-h` - Show help output
+- `--version`, `-v` - Print CLI version
+
+## What gets scaffolded
+
+- `src-tauri/core` - pure Rust game logic
+- `src-tauri/commands` - shared command definitions for desktop + web
+- `src-tauri/app` - Tauri desktop shell (stable default desktop runtime)
+- `src-tauri/wasm` - WASM entry crate
+- `src` - frontend app wired to `webtau` and `webtau-vite`
+- `src/services` - production-ready service seams for backend invoke calls, persistence/settings, mission session snapshots, and event-driven comms
+
+## Service Layer Contract
+
+The scaffolded base template now ships a small service architecture instead of a single command wrapper:
+
+- `src/services/backend.ts` - typed `invoke()` wrappers for gameplay commands plus long-running task lifecycle seams (`startWorldProcessing`, `pollWorldTask`, `cancelWorldTask`)
+- `src/services/settings.ts` - runtime settings persistence via `webtau/path` + `webtau/fs`
+- `src/services/session.ts` - mission/session snapshot persistence via `webtau/path` + `webtau/fs`
+- `src/services/comms.ts` - typed alert/comms channel over `webtau/event`
+- `src/services/contracts.ts` - interfaces/types for settings, session snapshots, and alerts
+
+Runtime bootstrap is explicit in scaffolded `src/index.ts`:
+
+- Tauri path: `bootstrapTauri()` from `webtau/adapters/tauri`
+- Web path: `configure({ loadWasm })` from `webtau`
+
+This keeps the generated project lightweight while giving contributors clear extension points for production features.
+
+For full docs and package details, see the main repository:
+<https://github.com/devallibus/gametau>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gametau",
-  "version": "0.5.0-alpha.2",
+  "version": "0.5.0",
   "description": "Scaffold a Tauri game that deploys to web + desktop",
   "license": "Apache-2.0",
   "repository": {

package/templates/base/package.json

@@ -11,12 +11,12 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "webtau": "^0.5.0-alpha.2"
+    "webtau": "^0.5.0"
   },
   "devDependencies": {
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.5.0-alpha.2",
+    "webtau-vite": "^0.5.0",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }

package/templates/base/src/index.ts

@@ -1,4 +1,5 @@
 import { configure, isTauri } from "webtau";
+import { bootstrapTauri } from "webtau/adapters/tauri";
 import { startGameLoop } from "./game/loop";
 import { createSnapshotQueue } from "./game/snapshot-queue";
 import { initScene, updateScene } from "./game/scene";
@@ -25,8 +26,10 @@ function updateHud(view: WorldView, settings: RuntimeSettings): void {
 }
 
 async function main() {
-  // Configure webtau for web mode (no-op in Tauri)
-  if (!isTauri()) {
+  // Bootstrap runtime: Tauri (desktop) or WASM (web).
+  if (isTauri()) {
+    await bootstrapTauri();
+  } else {
     configure({
       loadWasm: async () => {
         const wasm = await import("./wasm/{{PROJECT_NAME}}_wasm");

package/templates/base/src/services/backend.ts

@@ -1,4 +1,6 @@
 import { invoke } from "webtau";
+import { startTask, pollTask, cancelTask } from "webtau/task";
+import type { TaskState } from "webtau/task";
 
 export interface WorldView {
   score: number;
@@ -9,6 +11,10 @@ export interface TickResult {
   score_delta: number;
 }
 
+export interface ProcessResult {
+  processed: number;
+}
+
 export async function getWorldView(): Promise<WorldView> {
   return invoke<WorldView>("get_world_view");
 }
@@ -16,3 +22,19 @@ export async function getWorldView(): Promise<WorldView> {
 export async function tickWorld(): Promise<TickResult> {
   return invoke<TickResult>("tick_world");
 }
+
+// ── Long-running task seam ──────────────────────────────────────────────────
+// Reference flow proving non-blocking start/poll/cancel behavior for heavy
+// backend operations across web (WASM) and desktop (Tauri) runtimes.
+
+export async function startWorldProcessing(args: { batchSize: number }): Promise<string> {
+  return startTask<ProcessResult>("process_world_batch", args);
+}
+
+export async function pollWorldTask(taskId: string): Promise<TaskState<ProcessResult>> {
+  return pollTask<ProcessResult>(taskId);
+}
+
+export async function cancelWorldTask(taskId: string): Promise<void> {
+  return cancelTask(taskId);
+}

package/templates/base/src-tauri/commands/Cargo.toml

@@ -5,7 +5,7 @@ edition.workspace = true
 
 [dependencies]
 {{PROJECT_NAME}}-core = { path = "../core" }
-webtau = "0.5.0-alpha.2"
+webtau = "0.5.0"
 
 [target.'cfg(not(target_arch = "wasm32"))'.dependencies]
 tauri = { version = "2", features = [] }

package/templates/base/src-tauri/wasm/Cargo.toml

@@ -11,7 +11,7 @@ wasm-bindgen = "0.2"
 serde = { version = "1", features = ["derive"] }
 serde-wasm-bindgen = "0.6"
 getrandom = { version = "0.2", features = ["js"] }
-webtau = "0.4.0"
+webtau = "0.5.0"
 {{PROJECT_NAME}}-core = { path = "../core" }
 {{PROJECT_NAME}}-commands = { path = "../commands" }
 

package/templates/pixi/package.json

@@ -12,12 +12,12 @@
   },
   "dependencies": {
     "pixi.js": "^8.0.0",
-    "webtau": "^0.4.0"
+    "webtau": "^0.5.0"
   },
   "devDependencies": {
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.4.0",
+    "webtau-vite": "^0.5.0",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }

package/templates/three/package.json

@@ -12,13 +12,13 @@
   },
   "dependencies": {
     "three": "^0.172.0",
-    "webtau": "^0.4.0"
+    "webtau": "^0.5.0"
   },
   "devDependencies": {
     "@types/three": "^0.172.0",
     "typescript": "^5.8.0",
     "vite": "^6.0.0",
-    "webtau-vite": "^0.4.0",
+    "webtau-vite": "^0.5.0",
     "@tauri-apps/cli": "^2.0.0",
     "@tauri-apps/api": "^2.0.0"
   }