create-pixi-vn 2.0.11 → 2.0.13

package/template-react-vite-muijoy-ink/src/assets/index.ts

@@ -1,7 +1,5 @@
 import generatedManifestJson from "@/assets/manifest.gen.json";
 import { AUDIO_BUNDLE_NAME } from "@/constants";
-import { secondPart } from "@/content/labels/second.label";
-import { startLabel } from "@/content/labels/start.label";
 import type { FileRouteTypes } from "@/routeTree.gen";
 import type { AssetsManifest } from "@drincs/pixi-vn";
 
@@ -37,7 +35,7 @@ export const manifest: AssetsManifest = {
         },
         // labels
         {
-            name: startLabel.id,
+            name: "start",
             assets: [
                 {
                     alias: "bg01-hallway",
@@ -46,7 +44,7 @@ export const manifest: AssetsManifest = {
             ],
         },
         {
-            name: secondPart.id,
+            name: "second_part",
             assets: [
                 {
                     alias: "bg02-dorm",

package/template-react-vite-muijoy-ink/src/assets/ink-manifest.gen.json

@@ -1 +1,4 @@
-[]
+[
+  "/ink-json/second_part.gen.json",
+  "/ink-json/start.gen.json"
+]

package/template-react-vite-muijoy-ink/src/content/ink/hashtag-commands.ts

@@ -0,0 +1,38 @@
+import { RegisteredCharacters } from "@drincs/pixi-vn";
+import { HashtagCommands } from "@drincs/pixi-vn-ink";
+import zod from "zod";
+
+HashtagCommands.add(
+    async (script, { navigate }) => {
+        await navigate({ to: script[1] });
+        return true;
+    },
+    {
+        name: "navigate",
+        description: `Navigates to a specified route within the game.
+
+\`\`\`ink
+# navigate <route>
+\`\`\``,
+        validation: zod.tuple([zod.literal("navigate"), zod.string()]),
+    },
+);
+
+HashtagCommands.add(
+    async (script) => {
+        const character = RegisteredCharacters.get(script[1]);
+        if (character) {
+            character.name = script[2];
+        }
+        return true;
+    },
+    {
+        name: "character rename",
+        description: `Renames a character in the game.
+
+\`\`\`ink
+# rename <characterId> <newName>
+\`\`\``,
+        validation: zod.tuple([zod.literal("rename"), zod.string(), zod.string()]),
+    },
+);

package/template-react-vite-muijoy-ink/src/content/ink/text-replaces.ts

@@ -0,0 +1,19 @@
+import { RegisteredCharacters } from "@drincs/pixi-vn";
+import { TextReplaces } from "@drincs/pixi-vn-ink";
+
+TextReplaces.add((key) => RegisteredCharacters.get(key)?.name, {
+    name: "character name",
+    validation: "characterId",
+    type: "after-translation",
+    i18nInterpolation: true,
+    description: "Replaces a character ID with the character's name in the game.",
+});
+
+TextReplaces.add(() => "Stephanie", {
+    name: "steph_fullname",
+    validation: /steph_fullname/,
+    type: "after-translation",
+    i18nInterpolation: true,
+    description:
+        "Replaces the placeholder 'steph_fullname' with the full name of the character Stephanie.",
+});

package/template-react-vite-muijoy-ink/src/lib/hooks/ink-hooks.tsx

@@ -0,0 +1,12 @@
+import { onInkTranslate } from "@drincs/pixi-vn-ink";
+import { useEffect } from "react";
+import { useTranslation } from "react-i18next";
+
+export default function useInkInitialization() {
+    const { t } = useTranslation(["narration"]);
+    useEffect(() => {
+        onInkTranslate(t);
+    }, [t]);
+
+    return null;
+}

package/template-react-vite-muijoy-ink/src/lib/i18n.ts

@@ -1,3 +1,4 @@
+import { generateJsonInkTranslation } from "@drincs/pixi-vn-ink";
 import i18n, { type ReadCallback } from "i18next";
 import LanguageDetector from "i18next-browser-languagedetector";
 import ChainedBackend from "i18next-chained-backend";
@@ -44,9 +45,29 @@ function getLocalesResource(lng: string): Promise<Record<string, Record<string,
     return import(`./../locales/${lng}.json`);
 }
 
+async function generateResourceToTranslate(lng: string): Promise<any> {
+    let res = await getLocalesResource(lng);
+    res = { ...res };
+    if (!res) {
+        res = {};
+    }
+    if (!res.narration) {
+        res.narration = {};
+    }
+    if (res.default) {
+        delete res.default;
+    }
+    const manifest = await import("@/assets/ink-manifest.gen.json");
+    for (const path of manifest.default) {
+        const element = await fetch(path).then((r) => r.json());
+        element && (await generateJsonInkTranslation(element, res.narration));
+    }
+    return res;
+}
+
 export async function downloadResourceToTranslate() {
     const lng = i18n.options.fallbackLng?.toString() || "en";
-    const data = await getLocalesResource(lng);
+    const data = await generateResourceToTranslate(lng);
     const jsonString = JSON.stringify(data);
     // download the save data as a JSON file
     const blob = new Blob([jsonString], { type: "application/json" });

package/template-react-vite-muijoy-ink/src/pixi-vn-keys.gen.d.ts

@@ -15,6 +15,8 @@ declare module "@drincs/pixi-vn/narration" {
         "animation_01": never;
         "second_part": never;
         "start": never;
+        "start_|_c-0": never;
+        "start_|_c-1": never;
     }
 }
 export {};

package/template-react-vite-muijoy-ink/src/routes/__root.tsx

@@ -3,6 +3,7 @@ import { SettingsDialogue } from "@/components/menus/settings";
 import { OfflineAllert } from "@/components/modals/error-allerts";
 import { RootProvider } from "@/components/providers/root-provider";
 import { INTERFACE_DATA_USE_QUERY_KEY } from "@/constants";
+import useInkInitialization from "@/lib/hooks/ink-hooks";
 import { useConfirmBackNavigation } from "@/lib/hooks/navigation-hooks";
 import { useAutoSaveOnPageClose } from "@/lib/hooks/save-hooks";
 import { useI18n } from "@/lib/i18n";
@@ -11,6 +12,7 @@ import { defineAssets } from "@/lib/utils/assets-utility";
 import { initializeIndexedDB } from "@/lib/utils/db-utility";
 import { loadRefreshSave } from "@/lib/utils/save-utility";
 import type { RouterContext } from "@/router";
+import { setupInkHmrListener } from "@drincs/pixi-vn-ink/vite-listener";
 import { setupPixivnViteData } from "@drincs/pixi-vn/vite-listener";
 import { TanStackDevtools } from "@tanstack/react-devtools";
 import { hotkeysDevtoolsPlugin } from "@tanstack/react-hotkeys-devtools";
@@ -26,6 +28,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
         // Game.onNavigate(async (to) => redirect({ to }));
         await Promise.all([import("@/content"), initializeIndexedDB(), defineAssets(), useI18n()]);
         await setupPixivnViteData();
+        await setupInkHmrListener();
         if (location.pathname !== "/") {
             const isRefreshSaveExist = await loadRefreshSave();
             if (isRefreshSaveExist) {
@@ -43,6 +46,7 @@ export const Route = createRootRouteWithContext<RouterContext>()({
 });
 
 function RootComponent() {
+    useInkInitialization();
     useAutoSaveOnPageClose();
     useConfirmBackNavigation();
 

package/template-react-vite-muijoy-ink/vite.config.ts

@@ -1,4 +1,5 @@
 import { AssetPack } from "@assetpack/core";
+import { vitePluginInk } from "@drincs/pixi-vn-ink/vite";
 import { vitePluginPixivn } from "@drincs/pixi-vn/vite";
 import tailwindcss from "@tailwindcss/vite";
 import { devtools } from "@tanstack/devtools-vite";
@@ -37,6 +38,11 @@ export default defineConfig(({ mode }) => ({
             labels: "./src/content/labels/*.label.ts",
             typeFilePath: "./src/pixi-vn-keys.gen.d.ts",
         }),
+        vitePluginInk({
+            inkGlob: "./ink/**/*.ink",
+            inkJsonOutputPattern: "./public/ink-json/[path][name].gen.json",
+            inkJsonManifestPath: "./src/assets/ink-manifest.gen.json",
+        }),
         VitePWA({
             // generate icons with: npm run icon
             includeAssets: ["favicon.ico", "apple-touch-icon-180x180.png"],

package/template-react-vite-muijoy-ink-tauri/.assetpack.ts

@@ -1,6 +1,9 @@
 import type { AssetPackConfig } from "@assetpack/core";
 import { pixiPipes } from "@assetpack/core/pixi";
 
+// TAURI_ENV_TARGET_TRIPLE is set by `tauri build` before running beforeBuildCommand
+const isTauri = !!process.env.TAURI_ENV_TARGET_TRIPLE;
+
 const config: AssetPackConfig = {
     entry: "./src/assets",
     output: "./public/assets",
@@ -11,6 +14,12 @@ const config: AssetPackConfig = {
                 output: "src/assets/manifest.gen.json",
                 createShortcuts: true,
             },
+            // For Tauri: skip @0.5x mipmaps (unused on desktop, WebView handles DPR)
+            resolutions: isTauri ? { default: 1 } : undefined,
+            // For Tauri: raise WebP quality — files are local so bandwidth is not a concern
+            compression: isTauri
+                ? { png: true, jpg: true, webp: { quality: 88, alphaQuality: 88 } }
+                : undefined,
         }),
     ],
 };

package/template-react-vite-muijoy-ink-tauri/.vscode/extensions.json

@@ -3,6 +3,10 @@
     "ms-vscode.vscode-typescript-next",
     "anseki.vscode-color",
     "pflannery.vscode-versionlens",
-    "biomejs.biome"
+    "biomejs.biome",
+    "drincs-productions.pixi-vn-ink-vscode",
+    "tauri-apps.tauri-vscode",
+    "rust-lang.rust-analyzer",
+    "vadimcn.vscode-lldb"
   ]
 }

package/template-react-vite-muijoy-ink-tauri/.vscode/launch.json

@@ -17,6 +17,17 @@
       "webRoot": "${workspaceFolder}",
       "preLaunchTask": "Restart Vite Dev Server"
     },
+    {
+      "type": "lldb",
+      "request": "launch",
+      "name": "Run as Desktop App (Dev)",
+      "program": "${workspaceFolder}/src-tauri/target/debug/my-app-package-name",
+      "args": [],
+      "cwd": "${workspaceFolder}",
+      "terminal": "console",
+      "preLaunchTask": "Cargo Build (Desktop Dev)",
+      "postDebugTask": "Stop Vite Desktop Server"
+    },
     {
       "name": "Debug Game Preview",
       "request": "launch",

package/template-react-vite-muijoy-ink-tauri/.vscode/settings.json

@@ -55,5 +55,10 @@
   // does fetch when he does Pull
   "git.fetchOnPull": true,
   // move file
-  "js/ts.updateImportsOnFileMove.enabled": "always"
+  "js/ts.updateImportsOnFileMove.enabled": "always",
+  // ink
+  "ink.mainFile": "start.ink",
+  "ink.rootFolder": "ink",
+  "ink.markup": "Markdown",
+  "ink.engine": "pixi-vn"
 }

package/template-react-vite-muijoy-ink-tauri/.vscode/tasks.json

@@ -5,6 +5,9 @@
       "label": "Install Dependencies",
       "type": "shell",
       "command": "[ -d node_modules ] || npm i",
+      "windows": {
+        "command": "if (!(Test-Path node_modules)) { npm i }"
+      },
       "runOptions": {
         "runOn": "folderOpen"
       },
@@ -18,8 +21,11 @@
     {
       "label": "Start Vite Dev Server",
       "type": "shell",
-      "command": "echo $$ > /tmp/vite-watcher.pid; kill -- -$(cat /tmp/vite-dev.pid 2>/dev/null) 2>/dev/null; rm -f /tmp/vite-dev.log /tmp/vite-dev.pid; FORCE_COLOR=1 setsid npm run dev >/tmp/vite-dev.log 2>&1 & echo $! > /tmp/vite-dev.pid; tail -f /tmp/vite-dev.log",
+      "command": "npm run dev",
       "isBackground": true,
+      "runOptions": {
+        "runOn": "folderOpen"
+      },
       "dependsOn": ["Install Dependencies"],
       "dependsOrder": "sequence",
       "problemMatcher": {
@@ -41,9 +47,12 @@
       }
     },
     {
-      "label": "Kill Vite Watcher",
+      "label": "Stop Vite Dev Server",
       "type": "shell",
-      "command": "kill $(cat /tmp/vite-watcher.pid 2>/dev/null) 2>/dev/null; rm -f /tmp/vite-watcher.pid; exit 0",
+      "command": "kill $(lsof -ti:5173 -sTCP:LISTEN 2>/dev/null) 2>/dev/null; sleep 0.5; true",
+      "windows": {
+        "command": "$p = Get-NetTCPConnection -LocalPort 5173 -ErrorAction SilentlyContinue | Select-Object -ExpandProperty OwningProcess -Unique; $p | ForEach-Object { Stop-Process -Id $_ -Force -ErrorAction SilentlyContinue }; Start-Sleep -Milliseconds 500"
+      },
       "presentation": {
         "reveal": "never",
         "panel": "dedicated",
@@ -52,13 +61,41 @@
     },
     {
       "label": "Restart Vite Dev Server",
-      "dependsOn": ["Kill Vite Watcher", "Start Vite Dev Server"],
+      "dependsOn": ["Stop Vite Dev Server", "Start Vite Dev Server"],
       "dependsOrder": "sequence"
     },
     {
-      "label": "Stop Vite Dev Server",
+      "label": "Start Vite Preview Server",
       "type": "shell",
-      "command": "kill -- -$(cat /tmp/vite-dev.pid 2>/dev/null) 2>/dev/null; kill $(cat /tmp/vite-watcher.pid 2>/dev/null) 2>/dev/null; rm -f /tmp/vite-dev.pid /tmp/vite-dev.log /tmp/vite-watcher.pid; exit 0",
+      "command": "npm run preview",
+      "isBackground": true,
+      "dependsOn": ["Install Dependencies"],
+      "dependsOrder": "sequence",
+      "problemMatcher": {
+        "owner": "vite",
+        "pattern": {
+          "regexp": "^(?!x)x"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": ".",
+          "endsPattern": "Local:\\s+http://localhost:4173/"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": false,
+        "close": true
+      }
+    },
+    {
+      "label": "Stop Vite Preview Server",
+      "type": "shell",
+      "command": "kill $(lsof -ti:4173 -sTCP:LISTEN 2>/dev/null) 2>/dev/null; true",
+      "windows": {
+        "command": "$p = Get-NetTCPConnection -LocalPort 4173 -ErrorAction SilentlyContinue | Select-Object -ExpandProperty OwningProcess -Unique; $p | ForEach-Object { Stop-Process -Id $_ -Force -ErrorAction SilentlyContinue }"
+      },
       "presentation": {
         "reveal": "never",
         "panel": "dedicated",
@@ -66,9 +103,22 @@
       }
     },
     {
-      "label": "Start Vite Preview Server",
+      "label": "Cargo Build (Desktop Dev)",
       "type": "shell",
-      "command": "npm run preview",
+      "command": "cargo build --manifest-path=./src-tauri/Cargo.toml --no-default-features",
+      "dependsOn": ["Start Vite Desktop Server"],
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": true,
+        "close": true
+      },
+      "problemMatcher": ["$rustc"]
+    },
+    {
+      "label": "Start Vite Desktop Server",
+      "type": "shell",
+      "command": "npm run dev",
       "isBackground": true,
       "dependsOn": ["Install Dependencies"],
       "problemMatcher": {
@@ -79,7 +129,7 @@
         "background": {
           "activeOnStart": true,
           "beginsPattern": ".",
-          "endsPattern": "Local:\\s+http://localhost:4173/"
+          "endsPattern": "localhost:5173"
         }
       },
       "presentation": {
@@ -90,9 +140,9 @@
       }
     },
     {
-      "label": "Stop Vite Preview Server",
+      "label": "Stop Vite Desktop Server",
       "type": "shell",
-      "command": "pkill -f 'vite' 2>/dev/null; pkill -f 'npm run preview' 2>/dev/null; exit 0",
+      "command": "pkill -f 'vite' 2>/dev/null; pkill -f 'npm run dev' 2>/dev/null; exit 0",
       "presentation": {
         "reveal": "never",
         "panel": "dedicated",

package/template-react-vite-muijoy-ink-tauri/README.md

@@ -1,3 +1,3 @@
-# my-app-project-name
-
-my-app-description
+# my-app-project-name
+
+my-app-description

package/template-react-vite-muijoy-ink-tauri/_github/workflows/desktop.yml

@@ -0,0 +1,188 @@
+name: 'Build & Publish Desktop App'
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  # ── Create the release exactly once before the matrix starts ────────────────
+  create-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      release_tag: ${{ github.ref_name }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: create release
+        run: |
+          gh release view "${{ github.ref_name }}" 2>/dev/null || \
+          gh release create "${{ github.ref_name }}" \
+            --title "App v$(jq -r '.version' src-tauri/tauri.conf.json)" \
+            --notes "See the assets to download this version and install." \
+            2>/dev/null || \
+          gh release view "${{ github.ref_name }}" > /dev/null
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # ── Build and upload per platform ───────────────────────────────────────────
+  publish-tauri:
+    needs: create-release
+    permissions:
+      contents: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: 'macos-latest'
+            args: '--target aarch64-apple-darwin'
+            target: 'aarch64-apple-darwin'
+            arch: 'aarch64'
+          - platform: 'macos-latest'
+            args: '--target x86_64-apple-darwin'
+            target: 'x86_64-apple-darwin'
+            arch: 'x86_64'
+          - platform: 'ubuntu-22.04'
+            args: ''
+            target: ''
+            arch: 'x64'
+          - platform: 'windows-latest'
+            args: ''
+            target: ''
+            arch: 'x64'
+
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: setup node
+        uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+
+      - name: install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.platform == 'macos-latest' && 'aarch64-apple-darwin,x86_64-apple-darwin' || '' }}
+
+      - name: install dependencies (ubuntu only)
+        if: matrix.platform == 'ubuntu-22.04'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
+
+      - name: install frontend dependencies
+        run: npm i
+
+      - name: build app
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          args: ${{ matrix.args }}
+
+      # ── Linux: .deb + .AppImage (AppImage is already portable) ─────────────
+      - name: upload artifacts (Linux)
+        if: matrix.platform == 'ubuntu-22.04'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ needs.create-release.outputs.release_tag }}
+        run: |
+          upload_file() {
+            local file="$1"
+            local limit=$((1900 * 1024 * 1024))
+            local size; size=$(stat -c%s "$file")
+            if [ "$size" -gt "$limit" ]; then
+              echo "Splitting $(basename "$file") (${size} bytes) into 1.9 GB parts..."
+              split -b 1900m "$file" "${file}.part"
+              for part in "${file}.part"*; do
+                gh release upload "$TAG" "$part" --clobber
+              done
+            else
+              gh release upload "$TAG" "$file" --clobber
+            fi
+          }
+          find src-tauri/target/release/bundle -type f \
+            \( -name "*.deb" -o -name "*.AppImage" -o -name "*.rpm" \) |
+          while IFS= read -r f; do upload_file "$f"; done
+
+      # ── macOS: .dmg installer + portable .app.tar.gz ───────────────────────
+      - name: upload artifacts (macOS)
+        if: matrix.platform == 'macos-latest'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ needs.create-release.outputs.release_tag }}
+        run: |
+          BIN_NAME=$(grep '^name = ' src-tauri/Cargo.toml | head -1 | cut -d'"' -f2)
+          VERSION=$(jq -r '.version' src-tauri/tauri.conf.json)
+          ARCH="${{ matrix.arch }}"
+          BUNDLE_DIR="src-tauri/target/${{ matrix.target }}/release/bundle"
+
+          upload_file() {
+            local file="$1"
+            local limit=$((1900 * 1024 * 1024))
+            local size; size=$(stat -f%z "$file")
+            if [ "$size" -gt "$limit" ]; then
+              echo "Splitting $(basename "$file") (${size} bytes) into 1.9 GB parts..."
+              split -b 1900m "$file" "${file}.part"
+              for part in "${file}.part"*; do
+                gh release upload "$TAG" "$part" --clobber
+              done
+            else
+              gh release upload "$TAG" "$file" --clobber
+            fi
+          }
+
+          # DMG installer
+          find "$BUNDLE_DIR/dmg" -name "*.dmg" |
+          while IFS= read -r f; do upload_file "$f"; done
+
+          # Portable: bundle .app into a tar.gz
+          APP_PATH=$(find "$BUNDLE_DIR/macos" -maxdepth 1 -name "*.app" | head -1)
+          PORTABLE="${BIN_NAME}_${VERSION}_macos_${ARCH}-portable.tar.gz"
+          tar -czf "$PORTABLE" -C "$(dirname "$APP_PATH")" "$(basename "$APP_PATH")"
+          upload_file "$PORTABLE"
+
+      # ── Windows: NSIS/.msi installers + portable .zip ──────────────────────
+      - name: upload artifacts (Windows)
+        if: matrix.platform == 'windows-latest'
+        shell: pwsh
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          $tag  = "${{ needs.create-release.outputs.release_tag }}"
+          $ver  = (Get-Content src-tauri/tauri.conf.json | ConvertFrom-Json).version
+          $name = (Select-String -Path src-tauri/Cargo.toml `
+                    -Pattern '^name = "(.+)"').Matches[0].Groups[1].Value
+
+          function Upload-File($Path, $Tag) {
+            $limitBytes = 1900 * 1MB
+            $item = Get-Item $Path
+            if ($item.Length -gt $limitBytes) {
+              Write-Host "Splitting $($item.Name) ($($item.Length) bytes) into 1.9 GB parts..."
+              $stream = [System.IO.File]::OpenRead($Path)
+              $buf    = New-Object byte[] $limitBytes
+              $i      = 0
+              while (($n = $stream.Read($buf, 0, $buf.Length)) -gt 0) {
+                $part = "$Path.part$($i.ToString('D3'))"
+                $data = if ($n -eq $buf.Length) { $buf } else { $buf[0..($n - 1)] }
+                [System.IO.File]::WriteAllBytes($part, $data)
+                gh release upload $Tag $part --clobber
+                $i++
+              }
+              $stream.Dispose()
+            } else {
+              gh release upload $Tag $Path --clobber
+            }
+          }
+
+          # NSIS and MSI installers
+          Get-ChildItem -Recurse src-tauri/target/release/bundle -Include "*.exe","*.msi" |
+            ForEach-Object { Upload-File $_.FullName $tag }
+
+          # Portable ZIP (single EXE, no installer)
+          $zip = "${name}_${ver}_windows_x64-portable.zip"
+          Compress-Archive -Path "src-tauri/target/release/$name.exe" -DestinationPath $zip
+          Upload-File $zip $tag