create-pixi-vn 2.0.12 → 2.0.13

package/template-react-vite-muijoy-tauri/package-lock.json

@@ -26,6 +26,8 @@
         "@tanstack/react-store": "latest",
         "@tanstack/router-plugin": "latest",
         "@tanstack/store": "latest",
+        "@tauri-apps/api": "^2",
+        "@tauri-apps/plugin-opener": "^2",
         "@unpic/react": "^1.0.2",
         "class-variance-authority": "^0.7.1",
         "clsx": "^2.1.1",
@@ -59,6 +61,8 @@
         "@biomejs/biome": "latest",
         "@tailwindcss/typography": "^0.5.19",
         "@tanstack/devtools-vite": "latest",
+        "@tauri-apps/cli": "^2",
+        "@tauri-apps/plugin-process": "^2.3.1",
         "@types/node": "^25.9.1",
         "@types/react": "^19.2.15",
         "@types/react-dom": "^19.2.3",
@@ -6660,6 +6664,252 @@
         "url": "https://github.com/sponsors/tannerlinsley"
       }
     },
+    "node_modules/@tauri-apps/api": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/api/-/api-2.11.0.tgz",
+      "integrity": "sha512-7CinYODhky9lmO23xHnUFv0Xt43fbtWMyxZcLcRBlFkcgXKuEirBvHpmtJ89YMhyeGcq20Wuc47Fa4XjyniywA==",
+      "license": "Apache-2.0 OR MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/tauri"
+      }
+    },
+    "node_modules/@tauri-apps/cli": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli/-/cli-2.11.2.tgz",
+      "integrity": "sha512-bk3HemqvGRoy+5D/dVMUQHKMYLglD0jVnMm/0iGMH6ufZ+p8r14m6BpIixwij3PBvZdvORUp1YifTD8QxVZ1Nw==",
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "bin": {
+        "tauri": "tauri.js"
+      },
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/tauri"
+      },
+      "optionalDependencies": {
+        "@tauri-apps/cli-darwin-arm64": "2.11.2",
+        "@tauri-apps/cli-darwin-x64": "2.11.2",
+        "@tauri-apps/cli-linux-arm-gnueabihf": "2.11.2",
+        "@tauri-apps/cli-linux-arm64-gnu": "2.11.2",
+        "@tauri-apps/cli-linux-arm64-musl": "2.11.2",
+        "@tauri-apps/cli-linux-riscv64-gnu": "2.11.2",
+        "@tauri-apps/cli-linux-x64-gnu": "2.11.2",
+        "@tauri-apps/cli-linux-x64-musl": "2.11.2",
+        "@tauri-apps/cli-win32-arm64-msvc": "2.11.2",
+        "@tauri-apps/cli-win32-ia32-msvc": "2.11.2",
+        "@tauri-apps/cli-win32-x64-msvc": "2.11.2"
+      }
+    },
+    "node_modules/@tauri-apps/cli-darwin-arm64": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-darwin-arm64/-/cli-darwin-arm64-2.11.2.tgz",
+      "integrity": "sha512-+4UZzLt+eOAEQCwgd+TqKgyUJMrvx+BgdXLLaqJYmPqzP+nE6YZr/hY6CWLYGQb8jFn99jEkmC6uA3tNvamA1w==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-darwin-x64": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-darwin-x64/-/cli-darwin-x64-2.11.2.tgz",
+      "integrity": "sha512-VjYYtZUPqDMLutSfJEyxFE3Bz+DPi7c8wC3imckgvciLDZLq4qwKJxBicg0BXGhXjJsl8vKWgWRFNMPELQ+Xyg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm-gnueabihf": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm-gnueabihf/-/cli-linux-arm-gnueabihf-2.11.2.tgz",
+      "integrity": "sha512-yMemD6f4i95AQriS8EazyOFzbE34yjnP16i3IOzpHGQvBoy2DjypFMFBq0NtPuITURv/cOGguRtHR5d79/9CSA==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm64-gnu": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm64-gnu/-/cli-linux-arm64-gnu-2.11.2.tgz",
+      "integrity": "sha512-cgI91D2wL8GSgoWwZXDqt+DwnuZCP2/bz03QAE4TrhgAKIsrB4hX26W/H1EONPUUNkqrsgeCD0wU6pcNjV/5kw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-arm64-musl": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-arm64-musl/-/cli-linux-arm64-musl-2.11.2.tgz",
+      "integrity": "sha512-X1rm0BERqAAggtYTESSgXrS3sz4Sb/OiPiz54UqISlXW+GkR3vNIGnsy/lejNmoXGVqri3Q53BCfQiclOIyRPw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-riscv64-gnu": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-riscv64-gnu/-/cli-linux-riscv64-gnu-2.11.2.tgz",
+      "integrity": "sha512-usbMLJbT3KtkOrBMDVeGYNM35aTHXx38SJSzTMSqqjeUIOQ+iVPjb2yAGNAE+KqmBbAx4FOFIyMeKXx2M/JKGQ==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-x64-gnu": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-x64-gnu/-/cli-linux-x64-gnu-2.11.2.tgz",
+      "integrity": "sha512-Ru4gwJKPG0ctVGchRGpRup4Y4lW2SSfFnrbQcyHhCliKy4g8Qz97TrUgCur4CbWyAgKxvGh3SjrkA0LDYzDGiw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-linux-x64-musl": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-linux-x64-musl/-/cli-linux-x64-musl-2.11.2.tgz",
+      "integrity": "sha512-eUm7T6clN1MMmNSRQ9gaWsQdyehQx2Gmn5hht/QUlqZQI/qcP2OJK5dnaxqwFzCr2HdsEo9ydxaqcS1oJzMvUw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-arm64-msvc": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-arm64-msvc/-/cli-win32-arm64-msvc-2.11.2.tgz",
+      "integrity": "sha512-HeeZW80jU+gVTOEX4X/hC6NVSAdDVXajwP5fxIZ/3z9WvUC7qrudX2GMTilYq6Dg0e0sk0XgsAJD1hZ5wPBXUA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-ia32-msvc": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-ia32-msvc/-/cli-win32-ia32-msvc-2.11.2.tgz",
+      "integrity": "sha512-YhjQNZcXfbkCLyazSv1nPnJ9iRFE1wm6kc51FDbU10/Dk09io+6PAGMLjkxnX2GdM0qMnDmTjstY8mTDVvtKeA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/cli-win32-x64-msvc": {
+      "version": "2.11.2",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/cli-win32-x64-msvc/-/cli-win32-x64-msvc-2.11.2.tgz",
+      "integrity": "sha512-d2JchlFIpZevZVReyqhQOekJmb1UH3rhZ5VX6sH3ty9ETE0TKQavpihvoScUXfKKpW6HZC0MrFGRU0ZtD+w3gA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "Apache-2.0 OR MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@tauri-apps/plugin-opener": {
+      "version": "2.5.4",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/plugin-opener/-/plugin-opener-2.5.4.tgz",
+      "integrity": "sha512-1HnPkb+AmgO29HBazm4uPLKB+r7zzcTBW1d0fyYp1uP+jwtpoiNDGKMMzz58SFp49nOIrxdE3aUJtT57lfO9CQ==",
+      "license": "MIT OR Apache-2.0",
+      "dependencies": {
+        "@tauri-apps/api": "^2.11.0"
+      }
+    },
+    "node_modules/@tauri-apps/plugin-process": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/@tauri-apps/plugin-process/-/plugin-process-2.3.1.tgz",
+      "integrity": "sha512-nCa4fGVaDL/B9ai03VyPOjfAHRHSBz5v6F/ObsB73r/dA3MHHhZtldaDMIc0V/pnUw9ehzr2iEG+XkSEyC0JJA==",
+      "dev": true,
+      "license": "MIT OR Apache-2.0",
+      "dependencies": {
+        "@tauri-apps/api": "^2.8.0"
+      }
+    },
     "node_modules/@tokenizer/inflate": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/@tokenizer/inflate/-/inflate-0.4.1.tgz",

package/template-react-vite-muijoy-tauri/package.json

@@ -11,7 +11,12 @@
     "build": "tsc -b && vite build",
     "build:fast": "vite build",
     "prebuild": "npm run icon",
-    "icon": "pwa-assets-generator",
+    "icon": "pwa-assets-generator && tauri icon public/icon.png",
+    "tauri": "tauri",
+    "tauri:dev": "tauri dev",
+    "tauri:build": "tauri build",
+    "tauri:android:dev": "tauri android dev",
+    "tauri:ios:dev": "tauri ios dev",
     "lint": "biome lint",
     "check": "biome check",
     "format": "biome format --write",
@@ -35,6 +40,8 @@
     "@tanstack/react-store": "latest",
     "@tanstack/router-plugin": "latest",
     "@tanstack/store": "latest",
+    "@tauri-apps/api": "^2",
+    "@tauri-apps/plugin-opener": "^2",
     "@unpic/react": "^1.0.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -68,6 +75,8 @@
     "@biomejs/biome": "latest",
     "@tailwindcss/typography": "^0.5.19",
     "@tanstack/devtools-vite": "latest",
+    "@tauri-apps/cli": "^2",
+    "@tauri-apps/plugin-process": "^2.3.1",
     "@types/node": "^25.9.1",
     "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",

package/template-react-vite-muijoy-tauri/src/components/menus/main-menu.tsx

@@ -10,6 +10,7 @@ import {
 } from "@/constants";
 import { useSetSearchParamState } from "@/lib/hooks/navigation-hooks";
 import { useGameProps } from "@/lib/hooks/props-hooks";
+import { useQuit } from "@/lib/hooks/quit-hooks";
 import { useQueryLastSave } from "@/lib/query/save-query";
 import { InterfaceSettings } from "@/lib/stores/interface-settings-store";
 import { cn } from "@/lib/utils";
@@ -17,7 +18,7 @@ import { loadSave } from "@/lib/utils/save-utility";
 import { canvas, Game, ImageSprite } from "@drincs/pixi-vn";
 import { useHotkeys } from "@tanstack/react-hotkeys";
 import { useQueryClient } from "@tanstack/react-query";
-import { AlertCircle, CirclePlay, Play, Save, Settings } from "lucide-react";
+import { AlertCircle, CirclePlay, LogOut, Play, Save, Settings } from "lucide-react";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useTranslation } from "react-i18next";
 import { toast } from "sonner";
@@ -33,6 +34,7 @@ export function MainMenu() {
     const setSettingsTab = useSetSearchParamState<string>("settings_tab");
     const [loading, setLoading] = useState(false);
     const menuRef = useRef<HTMLDivElement>(null);
+    const { quit, canQuit } = useQuit();
 
     /** Returns all enabled menuitem buttons inside the menu container. */
     function getMenuItems(): HTMLButtonElement[] {
@@ -186,6 +188,19 @@ export function MainMenu() {
                         {t("settings")}
                     </Button>
 
+                    {canQuit && (
+                        <Button
+                            role="menuitem"
+                            onClick={quit}
+                            disabled={loading}
+                            variant="outline"
+                            className={menuButtonClass}
+                        >
+                            <LogOut className="size-4" />
+                            {t("quit")}
+                        </Button>
+                    )}
+
                     {loading ? (
                         <div
                             className="flex items-center justify-end pt-1 text-muted-foreground"

package/template-react-vite-muijoy-tauri/src/components/menus/settings/quick-menus.tsx

@@ -3,9 +3,10 @@ import { Button } from "@/components/ui/button";
 import { Kbd, KbdGroup } from "@/components/ui/kbd";
 import { Separator } from "@/components/ui/separator";
 import { useSetSearchParamState } from "@/lib/hooks/navigation-hooks";
+import { useQuit } from "@/lib/hooks/quit-hooks";
 import { Game } from "@drincs/pixi-vn";
 import { useLocation, useNavigate } from "@tanstack/react-router";
-import { Gamepad2Icon, HistoryIcon, LogOutIcon, SaveIcon } from "lucide-react";
+import { Gamepad2Icon, HistoryIcon, LogOutIcon, PowerIcon, SaveIcon } from "lucide-react";
 import { useTranslation } from "react-i18next";
 
 export function QuickMenus() {
@@ -21,6 +22,7 @@ export function QuickMenus() {
             </div>
             {isInGame && <Separator />}
             {isInGame && <ReturnMainMenuButton />}
+            <QuitButton />
         </div>
     );
 }
@@ -101,6 +103,20 @@ export function OpenHistorySettingButton() {
     );
 }
 
+export function QuitButton() {
+    const { t } = useTranslation(["ui"]);
+    const { quit, canQuit } = useQuit();
+
+    if (!canQuit) return null;
+
+    return (
+        <Button variant="destructive" onClick={quit}>
+            <PowerIcon />
+            {t("quit")}
+        </Button>
+    );
+}
+
 export function SaveLoadMenuButton() {
     const { t } = useTranslation(["ui"]);
     const setSettingsOpen = useSetSearchParamState<boolean>("settings");

package/template-react-vite-muijoy-tauri/src/components/menus/settings/system-controls.tsx

@@ -20,6 +20,8 @@ import {
 import { TextDisplaySettings } from "@/lib/stores/text-display-settings-store";
 import { useQueryClient } from "@tanstack/react-query";
 import { useSelector } from "@tanstack/react-store";
+import type * as app from "@tauri-apps/api";
+import { getCurrentWindow } from "@tauri-apps/api/window";
 import {
     DownloadIcon,
     FullscreenIcon,
@@ -31,6 +33,12 @@ import {
 import { useState } from "react";
 import { useTranslation } from "react-i18next";
 
+declare global {
+    interface Window {
+        __TAURI__: typeof app;
+    }
+}
+
 export function SystemControls() {
     return (
         <div className="flex flex-col gap-4">
@@ -154,7 +162,9 @@ export function FullScreenSettings() {
                 onClick={() => {
                     setLoading(true);
                     let promise: Promise<void>;
-                    if (isFullScreenMode) {
+                    if (window.__TAURI__) {
+                        promise = getCurrentWindow().setFullscreen(!isFullScreenMode);
+                    } else if (isFullScreenMode) {
                         promise = document.exitFullscreen();
                     } else {
                         promise = document.documentElement.requestFullscreen();

package/template-react-vite-muijoy-tauri/src/lib/hooks/quit-hooks.ts

@@ -0,0 +1,24 @@
+import { useAlertDialog } from "@/components/providers/alert-dialog-provider";
+import { exit } from "@tauri-apps/plugin-process";
+import { useCallback } from "react";
+import { useTranslation } from "react-i18next";
+
+export function useQuit() {
+    const { openAlertDialog } = useAlertDialog();
+    const { t } = useTranslation(["ui"]);
+
+    const canQuit = typeof window !== "undefined" && !!window.__TAURI__;
+
+    const quit = useCallback(() => {
+        openAlertDialog({
+            head: t("quit"),
+            content: t("quit_confirm"),
+            onConfirm: async () => {
+                await exit();
+                return true;
+            },
+        });
+    }, [openAlertDialog, t]);
+
+    return { quit, canQuit };
+}

package/template-react-vite-muijoy-tauri/src/lib/query/settings-query.ts

@@ -1,10 +1,16 @@
 import { useQuery } from "@tanstack/react-query";
+import { getCurrentWindow } from "@tauri-apps/api/window";
 
 export const IS_FULL_SCREEN_MODE_USE_QUERY_KEY = "is_full_screen_mode_use_query_key";
 
 export function useQueryIsFullModeScreen() {
     return useQuery({
         queryKey: [IS_FULL_SCREEN_MODE_USE_QUERY_KEY],
-        queryFn: async () => document.fullscreenElement !== null,
+        queryFn: async () => {
+            if (window.__TAURI__) {
+                return getCurrentWindow().isFullscreen();
+            }
+            return document.fullscreenElement !== null;
+        },
     });
 }

package/template-react-vite-muijoy-tauri/src/lib/steam.ts

@@ -0,0 +1,143 @@
+/**
+ * Steam utility — thin wrappers around Tauri commands exposed by the
+ * `steam` Cargo feature. All functions are safe to call even when:
+ *   - the app is running outside Tauri (web mode)
+ *   - Steam is not running
+ *   - the `steam` feature was not compiled in
+ * In all those cases the functions return sensible defaults (null / false / 0)
+ * without throwing.
+ *
+ * Enable Steam in Rust:
+ *   src-tauri/Cargo.toml → default = ["steam"]   (or pass --features steam)
+ *
+ * Typical usage:
+ *   import { steam } from "@/lib/steam";
+ *
+ *   const name = await steam.getPlayerName();          // "Alice" | null
+ *   await steam.unlockAchievement("ACH_COMPLETE_CH1"); // fire & forget
+ *   await steam.openOverlay("achievements");
+ */
+
+import { invoke } from "@tauri-apps/api/core";
+
+const isTauri = typeof window !== "undefined" && "__TAURI__" in window;
+
+/** Dialogs supported by the Steam overlay. */
+export type SteamOverlayDialog =
+    | "achievements"
+    | "community"
+    | "friends"
+    | "players"
+    | "settings"
+    | "officialgamegroup"
+    | "stats";
+
+async function call<T>(cmd: string, args?: Record<string, unknown>): Promise<T | null> {
+    if (!isTauri) return null;
+    try {
+        return await invoke<T>(cmd, args);
+    } catch {
+        return null;
+    }
+}
+
+// ── API ───────────────────────────────────────────────────────────────────────
+
+export namespace steam {
+    /** `true` when Steam was initialised successfully (Steam client running). */
+    export async function isAvailable(): Promise<boolean> {
+        return (await call<boolean>("steam_is_available")) ?? false;
+    }
+
+    /** Steam display name of the logged-in user. */
+    export async function getPlayerName(): Promise<string | null> {
+        return call<string>("steam_get_player_name");
+    }
+
+    /** Numeric App ID of the running application. */
+    export async function getAppId(): Promise<number | null> {
+        return call<number>("steam_get_app_id");
+    }
+
+    // ── Achievements ──────────────────────────────────────────────────────────
+
+    /**
+     * Unlock an achievement and immediately persist it.
+     * `id` must match the API Name in Steamworks Partner.
+     */
+    export async function unlockAchievement(id: string): Promise<void> {
+        await call("steam_unlock_achievement", { achievementId: id });
+    }
+
+    /**
+     * Returns `true` if the user has already unlocked the achievement.
+     * Reliable only after the first few seconds of launch (stats are fetched
+     * automatically at startup).
+     */
+    export async function isAchievementUnlocked(id: string): Promise<boolean> {
+        return (await call<boolean>("steam_is_achievement_unlocked", { achievementId: id })) ?? false;
+    }
+
+    /** Reset an achievement — intended for development / testing only. */
+    export async function clearAchievement(id: string): Promise<void> {
+        await call("steam_clear_achievement", { achievementId: id });
+    }
+
+    // ── Stats ─────────────────────────────────────────────────────────────────
+
+    /** Set an integer stat. Remember to call `storeStats()` afterwards. */
+    export async function setStatInt(name: string, value: number): Promise<void> {
+        await call("steam_set_stat_int", { name, value: Math.trunc(value) });
+    }
+
+    /** Read an integer stat (returns `0` on error). */
+    export async function getStatInt(name: string): Promise<number> {
+        return (await call<number>("steam_get_stat_int", { name })) ?? 0;
+    }
+
+    /** Set a float stat. Remember to call `storeStats()` afterwards. */
+    export async function setStatFloat(name: string, value: number): Promise<void> {
+        await call("steam_set_stat_float", { name, value });
+    }
+
+    /** Read a float stat (returns `0` on error). */
+    export async function getStatFloat(name: string): Promise<number> {
+        return (await call<number>("steam_get_stat_float", { name })) ?? 0;
+    }
+
+    /**
+     * Commit pending stat changes to Steam servers.
+     * `unlockAchievement` / `clearAchievement` already call this automatically;
+     * you only need this when using `setStatInt` / `setStatFloat` directly.
+     */
+    export async function storeStats(): Promise<void> {
+        await call("steam_store_stats");
+    }
+
+    // ── DLC ───────────────────────────────────────────────────────────────────
+
+    /** `true` if the user owns and has installed the DLC with the given App ID. */
+    export async function isDlcInstalled(appId: number): Promise<boolean> {
+        return (await call<boolean>("steam_is_dlc_installed", { appId })) ?? false;
+    }
+
+    // ── Overlay ───────────────────────────────────────────────────────────────
+
+    /**
+     * Open the Steam overlay to a specific dialog.
+     *
+     * Common values: "achievements", "friends", "community", "stats",
+     *                "settings", "officialgamegroup", "players"
+     */
+    export async function openOverlay(dialog: SteamOverlayDialog): Promise<void> {
+        await call("steam_open_overlay", { dialog });
+    }
+
+    /**
+     * Open the Steam store page for this game.
+     * Pass a different `appId` to open another game's page.
+     */
+    export async function openStore(appId?: number): Promise<void> {
+        await call("steam_open_store", { appId: appId ?? null });
+    }
+}

package/template-react-vite-muijoy-tauri/src-tauri/Cargo.toml

@@ -0,0 +1,50 @@
+[package]
+name = "my-app-package-name"
+version = "0.1.0"
+description = "my-app-description"
+authors = ["you"]
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+# ── Steam (optional) ─────────────────────────────────────────────────────────
+# To enable Steam support:
+#   1. Set your App ID in steam_appid.txt (root of the repo, use 480 for testing)
+#   2. Change `default = []` to `default = ["steam"]` below, or pass
+#      `--features steam` to cargo / tauri build.
+#   3. On Windows, ship steam_api64.dll next to the executable.
+#   4. On Linux,   ship libsteam_api.so next to the executable.
+#   5. On macOS,   ship libsteam_api.dylib next to the executable.
+#      (The steamworks-sys crate copies the library to the build output
+#       automatically; you only need to include it in the Tauri bundle.)
+# ─────────────────────────────────────────────────────────────────────────────
+[features]
+default = []
+steam = ["dep:steamworks"]
+
+[lib]
+# The `_lib` suffix may seem redundant but it is necessary
+# to make the lib name unique and wouldn't conflict with the bin name.
+# This seems to be only an issue on Windows, see https://github.com/rust-lang/cargo/issues/8519
+name = "my_app_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin-opener = "2"
+tauri-plugin-process = "2"
+tauri-plugin-window-state = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+steamworks = { version = "0.13", optional = true }
+
+[profile.release]
+opt-level = "z"     # max runtime performance
+lto = true          # link-time optimization — removes dead code across crates
+codegen-units = 1   # slower compile, smaller output
+panic = "abort"     # no stack unwinding machinery
+strip = true        # strip symbols from the binary
+