create-pixi-vn 2.0.14 → 2.1.0

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

@@ -1,44 +1,41 @@
 {
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    // bash: https://docs.microsoft.com/it-it/windows/dev-environment/javascript/nodejs-on-wsl
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Launch Chrome localhost 1420",
-            "request": "launch",
-            "type": "chrome",
-            "url": "http://localhost:1420",
-            "webRoot": "${workspaceFolder}",
-        },
-        {
-            "type": "lldb",
-            "request": "launch",
-            "name": "Tauri Development Debug",
-            "cargo": {
-                "args": [
-                    "build",
-                    "--manifest-path=./src-tauri/Cargo.toml",
-                    "--no-default-features"
-                ]
-            },
-            // task for the `beforeDevCommand` if used, must be configured in `.vscode/tasks.json`
-            "preLaunchTask": "ui:dev"
-        },
-        {
-            "type": "lldb",
-            "request": "launch",
-            "name": "Tauri Production Debug",
-            "cargo": {
-                "args": [
-                    "build",
-                    "--release",
-                    "--manifest-path=./src-tauri/Cargo.toml"
-                ]
-            },
-            // task for the `beforeBuildCommand` if used, must be configured in `.vscode/tasks.json`
-            "preLaunchTask": "ui:build"
-        }
-    ]
-}
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug Game",
+      "request": "launch",
+      "type": "editor-browser",
+      "url": "http://localhost:5173",
+      "webRoot": "${workspaceFolder}",
+      "preLaunchTask": "Restart Vite Dev Server"
+    },
+    {
+      "name": "Debug Game (Chrome)",
+      "request": "launch",
+      "type": "chrome",
+      "url": "http://localhost:5173",
+      "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",
+      "type": "editor-browser",
+      "url": "http://localhost:4173",
+      "webRoot": "${workspaceFolder}",
+      "preLaunchTask": "Start Vite Preview Server",
+      "postDebugTask": "Stop Vite Preview Server"
+    }
+  ]
+}

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

@@ -1,64 +1,59 @@
 {
-    // Formatter
-    "[javascript]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode",
-        "editor.formatOnSave": true
-    },
-    "[javascriptreact]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode",
-        "editor.formatOnSave": true
-    },
-    "[typescript]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode",
-        "editor.formatOnSave": true
-    },
-    "[typescriptreact]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode",
-        "editor.formatOnSave": true
-    },
-    "[css]": {
-        "editor.defaultFormatter": "vscode.css-language-features",
-        "editor.formatOnSave": true
-    },
-    "[html]": {
-        "editor.defaultFormatter": "esbenp.prettier-vscode",
-        "editor.formatOnSave": true,
-        "prettier.tabWidth": 2,
-    },
-    "[json]": {
-        "editor.defaultFormatter": "vscode.json-language-features",
-        "editor.formatOnSave": true
-    },
-    "prettier.jsxSingleQuote": true,
-    "prettier.printWidth": 120,
-    "prettier.useTabs": false,
-    "prettier.singleAttributePerLine": false,
-    "prettier.tabWidth": 4,
-    // reorganise imports
-    "editor.codeActionsOnSave": {
-        "source.organizeImports": "explicit"
-    },
-    // references
-    "javascript.referencesCodeLens.enabled": true,
-    "javascript.referencesCodeLens.showOnAllFunctions": true,
-    "typescript.referencesCodeLens.enabled": true,
-    "typescript.referencesCodeLens.showOnAllFunctions": true,
-    // does fetch when he does Pull
-    "git.fetchOnPull": true,
-    // move file
-    "javascript.updateImportsOnFileMove.enabled": "always",
-    "typescript.updateImportsOnFileMove.enabled": "always",
-    // color
-    "vscode-color-picker.languages": [
-        "javascript",
-        "typescript",
-        "javascriptreact",
-        "typescriptreact",
-    ],
-    // olther
-    "extensions.ignoreRecommendations": false,
-    "workbench.editor.enablePreview": true,
-    "workbench.editorAssociations": {
-        "*.md": "vscode.markdown.preview.editor"
-    },
-}
+  "files.watcherExclude": {
+    "**/*.gen.*": true
+  },
+  "search.exclude": {
+    "**/*.gen.*": true
+  },
+  "files.readonlyInclude": {
+    "**/*.gen.*": true
+  },
+  "extensions.ignoreRecommendations": false,
+  // formatter
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[html]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  // reorganise imports
+  "editor.codeActionsOnSave": {
+    "source.organizeImports": "explicit",
+    "source.fixAll": "explicit"
+  },
+  "js/ts.preferences.importModuleSpecifier": "non-relative",
+  "js/ts.preferences.importModuleSpecifierEnding": "minimal",
+  // references
+  "js/ts.referencesCodeLens.enabled": true,
+  "js/ts.referencesCodeLens.showOnAllFunctions": true,
+  // does fetch when he does Pull
+  "git.fetchOnPull": true,
+  // move file
+  "js/ts.updateImportsOnFileMove.enabled": "always"
+}

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

@@ -1,29 +1,153 @@
 {
-    // See https://go.microsoft.com/fwlink/?LinkId=733558
-    // for the documentation about the tasks.json format
-    "version": "2.0.0",
-    "tasks": [
-        {
-            "label": "ui:dev",
-            "type": "shell",
-            // `dev` keeps running in the background
-            // ideally you should also configure a `problemMatcher`
-            // see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
-            "isBackground": true,
-            // change this to your `beforeDevCommand`:
-            "command": "yarn",
-            "args": [
-                "dev"
-            ]
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Install Dependencies",
+      "type": "shell",
+      "command": "[ -d node_modules ] || npm i",
+      "windows": {
+        "command": "if (!(Test-Path node_modules)) { npm i }"
+      },
+      "runOptions": {
+        "runOn": "folderOpen"
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": false,
+        "close": true
+      }
+    },
+    {
+      "label": "Start Vite Dev Server",
+      "type": "shell",
+      "command": "npm run dev",
+      "isBackground": true,
+      "runOptions": {
+        "runOn": "folderOpen"
+      },
+      "dependsOn": ["Install Dependencies"],
+      "dependsOrder": "sequence",
+      "problemMatcher": {
+        "owner": "vite",
+        "pattern": {
+          "regexp": "^(?!x)x"
         },
-        {
-            "label": "ui:build",
-            "type": "shell",
-            // change this to your `beforeBuildCommand`:
-            "command": "yarn",
-            "args": [
-                "build"
-            ]
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": ".",
+          "endsPattern": "Local:\\s+http://localhost:\\d+/"
         }
-    ]
-}
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": true,
+        "close": false
+      }
+    },
+    {
+      "label": "Stop Vite Dev Server",
+      "type": "shell",
+      "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",
+        "close": true
+      }
+    },
+    {
+      "label": "Restart Vite Dev Server",
+      "dependsOn": ["Stop Vite Dev Server", "Start Vite Dev Server"],
+      "dependsOrder": "sequence"
+    },
+    {
+      "label": "Start Vite Preview Server",
+      "type": "shell",
+      "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",
+        "close": true
+      }
+    },
+    {
+      "label": "Cargo Build (Desktop Dev)",
+      "type": "shell",
+      "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": {
+        "owner": "vite",
+        "pattern": {
+          "regexp": "^(?!x)x"
+        },
+        "background": {
+          "activeOnStart": true,
+          "beginsPattern": ".",
+          "endsPattern": "localhost:5173"
+        }
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "dedicated",
+        "clear": false,
+        "close": true
+      }
+    },
+    {
+      "label": "Stop Vite Desktop Server",
+      "type": "shell",
+      "command": "pkill -f 'vite' 2>/dev/null; pkill -f 'npm run dev' 2>/dev/null; exit 0",
+      "presentation": {
+        "reveal": "never",
+        "panel": "dedicated",
+        "close": true
+      }
+    }
+  ]
+}

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

@@ -1,167 +1,3 @@
-# Pixi’VN template (React + Vite + MUI joy)
+# my-app-project-name
 
-![pixi-vn-cover-react](https://github.com/user-attachments/assets/2abc8047-be07-487d-bf9b-de1c1f7c2ca2)
-
-This is a template for creating visual novels in React. It uses the Pixi’VN library and Vite as a build tool.
-This Template contains basic functionality inspired by the widespread Visual Noval engine Ren'Py.
-
-## Overview
-
-For testing purposes we will recreate the visual novel [Breakdown](https://joshpowlison.itch.io/breakdown) with Pixi’VN in this guide. Breakdown is a short story that has all the features that a visual novel should have. Josh Powlison, the creator of Breakdown, has given us permission to use his narration for educational purposes❤️.
-
-The first page that appears is the main menu. From there, you can start the game, load a saved game, or go to the settings.
-
-The game page is in `/narration` route. It contains the text box, character avatar, and canvas for the background image. The text box displays the text of the current dialogue. The character avatar displays the character speaking the dialogue. The background image is the background of the scene.
-When a choice has to be made, the choices are displayed at the top of the screen.
-
-When you are in the game page, you can access with many features through a list of buttons located at the bottom. In this list you can save the game, load a saved game, skip the dialogue, auto play the dialogue, access to the history modal, and access to the settings modal.
-
-The history modal is a list of all the dialogues and choices that have been displayed.
-
-The settings modal allows you to change the text speed, go to full screen, edit theme colors, and change go to main menu. The settings for the audio have not been added nor the libraries to manage it, but I recommend adding them.
-
-### Keyboard shortcuts (hotkeys)
-
-* `Space` or `Enter`: Continue the dialogue.
-* `Keep Space` or `Keep Enter`: Skip the dialogue.
-* `Alt` + `S`: Quick save the game.
-* `Alt` + `L`: Quick load the game.
-* `Alt` + `H`: Open the history modal.
-* `Esc`: Open the settings modal.
-* `Alt` + `V`: Hide the UI (Show only the canvas).
-
-### Used libraries
-
-This template uses the following libraries:
-
-Core libraries:
-
-* [Pixi’VN](https://www.npmjs.com/package/@drincs/pixi-vn): A visual novel library.
-* [Vite](https://vitejs.dev/): A build tool that aims to provide a faster and leaner development experience for modern web projects.
-* [Vite Checker](https://www.npmjs.com/package/vite-plugin-checker): A Vite plugin that checks TypeScript types and ESLint on each build.
-* [PWA Vite Plugin](https://vite-pwa-org.netlify.app): A Vite plugin that provides PWA support. This allows the possibility of installing the game as a Progressive Web App.
-* [Zustand](https://zustand-demo.pmnd.rs/): A small, fast, and scalable state management library.
-* [React Router](https://reactrouter.com/): A library that provides routing for React applications.
-* [Tanstack Query](https://tanstack.com/tanstack-query/): A library that provides a set of tools for getting, caching, and updating game data.
-  <img width="44" alt="image" src="https://github.com/user-attachments/assets/bf70dddc-68c0-48f4-9c41-74c22f54e3d1">
-  You can use the following button to show Tanstack Query interactions with the game. (the button will be automatically hidden when released)
-* [Tailwind CSS](https://tailwindcss.com/): A utility-first CSS framework for rapidly building custom designs.
-  * [Tailwind CSS Motion](https://rombo.co/tailwind/): A library that provides a set of utilities for creating animations with Tailwind CSS.
-  * [Tailwind CSS Typography](https://tailwindcss.com/docs/typography-plugin): A plugin that provides a set of utilities for styling text.
-
-UI libraries:
-
-* [Mui Joy](https://mui.com/joy-ui/getting-started/): A React UI framework that provides a set of components and styles for building a website.
-* [Motion](https://motion.dev/): A simple yet powerful motion library for React.
-* [Notistack](https://iamhosseindhv.com/notistack): A library that provides snackbar notifications for React.
-* [React Color Palette](https://www.npmjs.com/package/react-color-palette): A library that provides a color picker for React.
-
-Text libraries:
-
-* [i18next](https://www.i18next.com/): A library that gives the possibility to manage multiple translations in the application.
-* [React Markdown](https://www.npmjs.com/package/react-markdown): A library that allows you to render markdown in React components.
-  * [React Markdown Typewriter](hhttps://www.npmjs.com/package/react-markdown-typewriter): This library provides a new component, MarkdownTypewriter, that combines the Markdown component of react-markdown with the animation of typewriter. The animation was created entirely with motion.
-
-## How to use
-
-Before starting, you need to have Node.js installed on your computer. If you don't have it, you can download it [here](https://nodejs.org/).
-
-### Recommended Visual Studio Code extensions
-
-* [Tauri](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode): Provides Tauri commands and debugging support.
-* [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer): Provides Rust language support.
-* [CodeLLDB](https://marketplace.visualstudio.com/items?itemName=vadimcn.vscode-lldb): Provides LLDB debugging support.
-* [JavaScript and TypeScript Nightly](https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-typescript-next): Provides JavaScript and TypeScript nightlies.
-* [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint): Integrates ESLint into VS Code.
-* [vscode-color-picker](https://marketplace.visualstudio.com/items?itemName=antiantisepticeye.vscode-color-picker): A color picker for Visual Studio Code.
-* [Version Lens](https://marketplace.visualstudio.com/items?itemName=pflannery.vscode-versionlens): Shows the latest version for each package using code lens.
-
-### Change the icon
-
-You can change the icon of the game by replacing the images in the `public` folder.
-
-After that, you need to run the following command to change tauri icons.
-  
-```bash
-npm run tauri icon public/pwa-512x512.png
-```
-
-## Installation
-
-First, is necessary install the dependencies. To do this, open a terminal in the root folder of the project and run the following command:
-
-```bash
-npm install
-```
-
-## Start the web application
-
-To start the web application, run the following command:
-
-```bash
-npm start
-```
-
-This command will start the development server. Open [http://localhost:1420](http://localhost:1420) to view it in the browser.
-
-### Debugging the web application
-
-If you are using Visual Studio Code, you can use the debug configuration provided with the template. To do this, after launching `npm start`, go to the debug section and select the `Launch Chrome` configuration.
-
-## Start the Desktop Program (Tauri)
-
-**Prerequisites**: Before starting the Tauri application, you need read the [Tauri prerequisites](https://v2.tauri.app/start/prerequisites) and install [rust](https://v2.tauri.app/start/prerequisites/#rust). Restart your pc.
-
-To start the Tauri application, run the following command:
-
-```bash
-npm run tauri dev
-```
-
-This command will start the Tauri application. The application will open in a window on your computer.
-
-### Debugging the Desktop Program
-
-If you use Visual Studio Code, you can use the debug configuration that comes with the template. To do this, go to the debug section and select the `Tauri Development Debug` or `Tauri Production Debug` configuration.
-
-Read more about the possibilities of debugging in the [Tauri documentation](https://v2.tauri.app/develop/debug/vscode/).
-
-## Start the Android application (Tauri)
-
-**Prerequisites**: Before starting the Tauri application, you need read the [Tauri prerequisites](https://v2.tauri.app/start/prerequisites) and install [rust](https://v2.tauri.app/start/prerequisites/#rust). And you need to have the [Android SDK installed on your computer](https://v2.tauri.app/start/prerequisites/#android).
-
-To start the Tauri application, run the following command:
-
-```bash
-npm run tauri android dev
-```
-
-This command will start the Tauri application. The application will open in an emulator or on your Android device.
-
-## Start the iOS application (Tauri)
-
-**Prerequisites**: Before starting the Tauri application, you need read the [Tauri prerequisites](https://v2.tauri.app/start/prerequisites) and install [rust](https://v2.tauri.app/start/prerequisites/#rust). And you need to have the [Xcode installed on your computer](https://v2.tauri.app/start/prerequisites/#ios).
-
-To start the Tauri application, run the following command:
-
-```bash
-npm run tauri ios dev
-```
-
-## Distribution
-
-### Web application
-
-To build the project, run the following command:
-
-```bash
-npm run build
-```
-
-This command will create a `dist` folder with the files necessary to run the application. You can deploy this folder to a web server.
-
-You can read more about the possibilities of hosting in the [Pixi’VN documentation](https://pixi-vn.web.app/advanced/distribution.html#hosting).
-
-### Desktop application
-
-You can read more about the possibilities of distribution in the [Pixi’VN documentation](https://pixi-vn.web.app/advanced/distribution-desktop-mobile.html).
+my-app-description