vite-plus 0.1.13 → 0.1.14-alpha.1

package/skills/vite-plus/docs/guide/run.md

@@ -0,0 +1,292 @@
+# Run
+
+`vp run` runs `package.json` scripts and tasks defined in `vite.config.ts`. It works like `pnpm run`, with caching, dependency ordering, and workspace-aware execution built in.
+
+## Overview
+
+Use `vp run` with existing `package.json` scripts:
+
+```json [package.json]
+{
+  "scripts": {
+    "build": "node compile-legacy-app.js",
+    "test": "jest"
+  }
+}
+```
+
+`vp run build` executes the associated build script:
+
+```
+$ node compile-legacy-app.js
+
+building legacy app for production...
+
+✓ built in 69s
+```
+
+Use `vp run` without a task name to use the interactive task runner:
+
+```
+Select a task (↑/↓, Enter to run, Esc to clear):
+
+  › build: node compile-legacy-app.js
+    test: jest
+```
+
+## Caching
+
+`package.json` scripts are not cached by default. Use `--cache` to enable caching:
+
+```bash
+vp run --cache build
+```
+
+```
+$ node compile-legacy-app.js
+✓ built in 69s
+```
+
+If nothing changes, the output is replayed from the cache on the next run:
+
+```
+$ node compile-legacy-app.js ✓ cache hit, replaying
+✓ built in 69s
+
+---
+vp run: cache hit, 69s saved.
+```
+
+If an input changes, the task runs again:
+
+```
+$ node compile-legacy-app.js ✗ cache miss: 'legacy/index.js' modified, executing
+```
+
+## Task Definitions
+
+Vite Task automatically tracks which files your command uses. You can define tasks directly in `vite.config.ts` to enable caching by default or control which files and environment variables affect cache behavior.
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  run: {
+    tasks: {
+      build: {
+        command: 'vp build',
+        dependsOn: ['lint'],
+        env: ['NODE_ENV'],
+      },
+      deploy: {
+        command: 'deploy-script --prod',
+        cache: false,
+        dependsOn: ['build', 'test'],
+      },
+    },
+  },
+});
+```
+
+If you want to run an existing `package.json` script as-is, use `vp run <script>`. If you want task-level caching, dependencies, or environment/input controls, define a task with an explicit `command`. A task name can come from `vite.config.ts` or `package.json`, but not both.
+
+::: info
+Tasks defined in `vite.config.ts` are cached by default. `package.json` scripts are not. See [When Is Caching Enabled?](/guide/cache#when-is-caching-enabled) for the full resolution order.
+:::
+
+See [Run Config](/config/run) for the full `run` block reference.
+
+## Task Dependencies
+
+Use [`dependsOn`](#depends-on) to run tasks in the right order. Running `vp run deploy` with the config above runs `build` and `test` first. Dependencies can also target other packages in the same project with the `package#task` notation:
+
+```ts
+dependsOn: ['@my/core#build', '@my/utils#lint'];
+```
+
+## Running in a Workspace
+
+With no package-selection flags, `vp run` runs the task in the package in your current working directory:
+
+```bash
+cd packages/app
+vp run build
+```
+
+You can also target a package explicitly from anywhere:
+
+```bash
+vp run @my/app#build
+```
+
+Workspace package ordering is based on the normal monorepo dependency graph declared in each package's `package.json`. In other words, when Vite+ talks about package dependencies, it means the regular `dependencies` relationships between workspace packages, not a separate task-runner-specific graph.
+
+### Recursive (`-r`)
+
+Run the task in every workspace package, in dependency order:
+
+```bash
+vp run -r build
+```
+
+That dependency order comes from the workspace packages referenced through `package.json` dependencies.
+
+### Transitive (`-t`)
+
+Run the task in one package and all of its dependencies:
+
+```bash
+vp run -t @my/app#build
+```
+
+If `@my/app` depends on `@my/utils`, which depends on `@my/core`, this runs all three in order. Vite+ resolves that chain from the normal workspace package dependencies declared in `package.json`.
+
+### Filter (`--filter`)
+
+Select packages by name, directory, or glob pattern. The syntax matches pnpm's `--filter`:
+
+```bash
+# By name
+vp run --filter @my/app build
+
+# By glob
+vp run --filter "@my/*" build
+
+# By directory
+vp run --filter ./packages/app build
+
+# Include dependencies
+vp run --filter "@my/app..." build
+
+# Include dependents
+vp run --filter "...@my/core" build
+
+# Exclude packages
+vp run --filter "@my/*" --filter "!@my/utils" build
+```
+
+Multiple `--filter` flags are combined as a union. Exclusion filters are applied after all inclusions.
+
+### Workspace Root (`-w`)
+
+Explicitly run the task in the workspace root package:
+
+```bash
+vp run -w build
+```
+
+## Compound Commands
+
+Commands joined with `&&` are split into independent sub-tasks. Each sub-task is cached separately when [caching is enabled](/guide/cache#when-is-caching-enabled). This works for both `vite.config.ts` tasks and `package.json` scripts:
+
+```json [package.json]
+{
+  "scripts": {
+    "check": "vp lint && vp build"
+  }
+}
+```
+
+Now, run `vp run --cache check`:
+
+```
+$ vp lint
+Found 0 warnings and 0 errors.
+
+$ vp build
+✓ built in 28ms
+
+---
+vp run: 0/2 cache hit (0%).
+```
+
+Each sub-task has its own cache entry. If only `.ts` files changed but lint still passes, only `vp build` runs again the next time `vp run --cache check` is called:
+
+```
+$ vp lint ✓ cache hit, replaying
+$ vp build ✗ cache miss: 'src/index.ts' modified, executing
+✓ built in 30ms
+
+---
+vp run: 1/2 cache hit (50%), 120ms saved.
+```
+
+### Nested `vp run`
+
+When a command contains `vp run`, Vite Task inlines it as separate tasks instead of spawning a nested process. Each sub-task is cached independently and output stays flat:
+
+```json [package.json]
+{
+  "scripts": {
+    "ci": "vp run lint && vp run test && vp run build"
+  }
+}
+```
+
+Running `vp run ci` expands into three tasks:
+
+```mermaid
+graph LR
+  lint --> test --> build
+```
+
+Flags also work inside nested scripts. For example, `vp run -r build` inside a script expands into individual build tasks for every package.
+
+::: info
+A common monorepo pattern is a root script that runs a task recursively:
+
+```json [package.json (root)]
+{
+  "scripts": {
+    "build": "vp run -r build"
+  }
+}
+```
+
+This creates a potential recursion: root's `build` -> `vp run -r build` -> includes root's `build` -> ...
+
+Vite Task detects this and prunes the self-reference automatically, so other packages build normally.
+:::
+
+## Execution Summary
+
+Use `-v` to show a detailed execution summary:
+
+```bash
+vp run -r -v build
+```
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    Vite+ Task Runner • Execution Summary
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Statistics:   3 tasks • 3 cache hits • 0 cache misses
+Performance:  100% cache hit rate, 468ms saved in total
+
+Task Details:
+────────────────────────────────────────────────
+  [1] @my/core#build: ~/packages/core$ vp build ✓
+      → Cache hit - output replayed - 200ms saved
+  ·······················································
+  [2] @my/utils#build: ~/packages/utils$ vp build ✓
+      → Cache hit - output replayed - 150ms saved
+  ·······················································
+  [3] @my/app#build: ~/packages/app$ vp build ✓
+      → Cache hit - output replayed - 118ms saved
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Use `--last-details` to show the summary from the last run without running tasks again:
+
+```bash
+vp run --last-details
+```
+
+## Additional Arguments
+
+Arguments after the task name are passed through to the task command:
+
+```bash
+vp run test --reporter verbose
+```

package/skills/vite-plus/docs/guide/test.md

@@ -0,0 +1,35 @@
+# Test
+
+`vp test` runs tests with [Vitest](https://vitest.dev).
+
+## Overview
+
+`vp test` is built on [Vitest](https://vitest.dev/), so you get a Vite-native test runner that reuses your Vite config and plugins, supports Jest-style expectations, snapshots, and coverage, and handles modern ESM, TypeScript, and JSX projects cleanly.
+
+## Usage
+
+```bash
+vp test
+vp test watch
+vp test run --coverage
+```
+
+::: info
+Unlike Vitest on its own, `vp test` does not stay in watch mode by default. Use `vp test` when you want a normal test run, and use `vp test watch` when you want to jump into watch mode.
+:::
+
+## Configuration
+
+Put test configuration directly in the `test` block in `vite.config.ts` so all your configuration stays in one place. We do not recommend using `vitest.config.ts` with Vite+.
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+  },
+});
+```
+
+For the full Vitest configuration reference, see the [Vitest config docs](https://vitest.dev/config/).

package/skills/vite-plus/docs/guide/troubleshooting.md

@@ -0,0 +1,71 @@
+# Troubleshooting
+
+Use this page when something in Vite+ is not behaving the way you expect.
+
+::: warning
+Vite+ is still in alpha. We are making frequent changes, adding features quickly, and we want feedback to help make it great.
+:::
+
+## Supported Tool Versions
+
+Vite+ expects modern upstream tool versions.
+
+- Vite 8 or newer
+- Vitest 4.1 or newer
+
+If you are migrating an existing project and it still depends on older Vite or Vitest versions, upgrade those first before adopting Vite+.
+
+## `vp check` does not run type-aware lint rules or type checks
+
+- Confirm that `lint.options.typeAware` and `lint.options.typeCheck` are enabled in `vite.config.ts`
+- Check whether your `tsconfig.json` uses `compilerOptions.baseUrl`
+
+The Oxlint type checker path powered by `tsgolint` does not support `baseUrl`, so Vite+ skips `typeAware` and `typeCheck` when that setting is present.
+
+## `vp build` does not run my build script
+
+Unlike package managers, built-in commands cannot be overwritten. If you are trying to run a `package.json` script use `vp run build` instead.
+
+For example:
+
+- `vp build` always runs the built-in Vite build
+- `vp test` always runs the built-in Vitest command
+- `vp run build` and `vp run test` run `package.json` scripts instead
+
+::: info
+You can also run custom tasks defined in `vite.config.ts` and migrate away from `package.json` scripts entirely.
+:::
+
+## Staged Checks and Commit Hooks
+
+If `vp staged` fails or your pre-commit hook does not run:
+
+- make sure `vite.config.ts` contains a `staged` block
+- run `vp config` to install hooks
+- check whether hook installation was skipped intentionally through `VITE_GIT_HOOKS=0`
+
+A minimal staged config looks like this:
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  staged: {
+    '*': 'vp check --fix',
+  },
+});
+```
+
+## Asking for Help
+
+If you are stuck, please reach out:
+
+- [Discord](https://discord.gg/cAnsqHh5PX) for real-time discussion and troubleshooting help
+- [GitHub](https://github.com/voidzero-dev/vite-plus) for issues, discussions, and bug reports
+
+When reporting a problem, please include:
+
+- The full output of `vp env current` and `vp --version`
+- The package manager used by the project
+- The exact steps needed to reproduce the problem and your `vite.config.ts`
+- A minimal reproduction repository or runnable sandbox

package/skills/vite-plus/docs/guide/upgrade.md

@@ -0,0 +1,28 @@
+# Upgrading Vite+
+
+Use `vp upgrade` to update the global `vp` binary, and use Vite+'s package management commands to update the local `vite-plus` package in a project.
+
+## Overview
+
+There are two parts to upgrading Vite+:
+
+- The global `vp` command installed on your machine
+- The local `vite-plus` package used by an individual project
+
+You can upgrade both of them independently.
+
+## Global `vp`
+
+```bash
+vp upgrade
+```
+
+## Local `vite-plus`
+
+Update the project dependency with the package manager commands in Vite+:
+
+```bash
+vp update vite-plus
+```
+
+You can also use `vp add vite-plus@latest` if you want to move the dependency explicitly to the latest version.

package/skills/vite-plus/docs/guide/vpx.md

@@ -0,0 +1,66 @@
+# Running Binaries
+
+Use `vpx`, `vp exec`, and `vp dlx` to run binaries without switching between local installs, downloaded packages, and project-specific tools.
+
+## Overview
+
+`vpx` executes a command from a local or remote npm package. It can run a package that is already available locally, download a package on demand, or target an explicit package version.
+
+Use the other binary commands when you need stricter control:
+
+- `vpx` resolves a package binary locally first and can download it when needed
+- `vp exec` runs a binary from the current project's `node_modules/.bin`
+- `vp dlx` runs a package binary without adding it as a dependency
+
+## `vpx`
+
+Use `vpx` for running any local or remote binary:
+
+```bash
+vpx <pkg[@version]> [args...]
+```
+
+### Options
+
+- `-p, --package <name>` installs one or more packages before running the command
+- `-c, --shell-mode` executes the command inside a shell
+- `-s, --silent` suppresses Vite+ output and only shows the command output
+
+### Examples
+
+```bash
+vpx eslint .
+vpx create-vue my-app
+vpx typescript@5.5.4 tsc --version
+vpx -p cowsay -c 'echo "hi" | cowsay'
+```
+
+## `vp exec`
+
+Use `vp exec` when the binary must come from the current project, for example a binary from a dependency installed in `node_modules/.bin`.
+
+```bash
+vp exec <command> [args...]
+```
+
+Examples:
+
+```bash
+vp exec eslint .
+vp exec tsc --noEmit
+```
+
+## `vp dlx`
+
+Use `vp dlx` for one-off package execution without adding the package to your project dependencies.
+
+```bash
+vp dlx <package> [args...]
+```
+
+Examples:
+
+```bash
+vp dlx create-vite
+vp dlx typescript tsc --version
+```

package/skills/vite-plus/docs/guide/why.md

@@ -0,0 +1,39 @@
+# Why Vite+?
+
+Working in the JavaScript ecosystem today, developers need a runtime such as Node.js, a package manager like pnpm, a dev server, a linter, a formatter, a test runner, a bundler, a task runner, and a growing number of config files.
+
+Vite showed that frontend tooling could become dramatically faster by rethinking the architecture instead of accepting the status quo. Vite+ applies that same idea to the rest of the local development workflow, and unifies them all into a single package that speeds up and simplifies development.
+
+## The Problem Vite+ is Solving
+
+The JavaScript tooling ecosystem has seen its fair share of fragmentation and churn. Web apps keep getting larger, and as a result tooling performance, complexity, and inconsistencies have become real bottlenecks as projects grow.
+
+These bottlenecks are amplified in organizations with multiple teams, each using a different tooling stack. Dependency management, build infrastructure, and code quality become fragmented responsibilities, handled team by team and often not owned as a priority by anyone. As a result, dependencies drift out of sync, builds get slower, and code quality declines. Fixing those problems later requires significantly more effort, slows everyone down, and pulls teams away from shipping product.
+
+## What's Included in Vite+
+
+Vite+ brings the tools needed for modern web development together into a single, integrated toolchain. Instead of assembling and maintaining a custom toolchain, Vite+ provides a consistent entry point that manages the runtime, dependencies, development server, code quality checks, testing, and builds in one place.
+
+- **[Vite](https://vite.dev/)** and **[Rolldown](https://rolldown.rs/)** for development and application builds
+- **[Vitest](https://vitest.dev/)** for testing
+- **[Oxlint](https://oxc.rs/docs/guide/usage/linter.html)** and **[Oxfmt](https://oxc.rs/docs/guide/usage/formatter.html)** for linting and formatting
+- **[tsdown](https://tsdown.dev/)** for library builds or standalone executables
+- **[Vite Task](https://github.com/voidzero-dev/vite-task)** for task orchestration
+
+In practice, this means developers interact with one consistent workflow: `vp dev`, `vp check`, `vp test`, and `vp build`.
+
+This unified toolchain reduces configuration overhead, improves performance, and makes it easier for teams to maintain consistent tooling across projects.
+
+## Fast and Scalable by Default
+
+Vite+ is built on top of modern tooling such as Vite, Rolldown, Oxc, Vitest, and Vite Task to keep your projects fast and scalable as your codebase grows. By using Rust, we can speed up common tasks by [10× or sometimes even by 100×](https://voidzero.dev/posts/announcing-vite-plus-alpha#performance-scale). However, many Rust-based toolchains are incompatible with existing tools, or aren't extensible using JavaScript.
+
+Vite+ bridges Rust to JavaScript via [NAPI-RS](https://napi.rs/) which allows it to provide a familiar, easy-to-configure, and extensible interface in JavaScript with a great ecosystem-compatible developer experience.
+
+Unifying the toolchain has performance benefits beyond just using faster tools on their own. For example, many developers set up their linter with "type aware" tools, requiring a full-typecheck to be run during the linting stage. With `vp check` you can format, lint, and type-check your code all in a single pass, speeding up static checks by 2× compared to running type-aware lint rules and type-checks separately.
+
+## Fully Open Source
+
+Vite+ is fully open source and not a new framework or locked-down platform. Vite+ integrates with the existing Vite ecosystem and the frameworks built on top of it, including React, Vue, Svelte, and others. It can use pnpm, npm, or Yarn, and manages the Node.js runtime for you.
+
+We always welcome contributions from the community. See our [Contributing Guidelines](https://github.com/voidzero-dev/vite-plus/blob/main/CONTRIBUTING.md) to get involved.

package/dist/global/wrap-ansi-DAqB-SZm.js

@@ -1,3 +0,0 @@
-import "./strip-ansi-DbamwI77.js";
-import { t as wrapAnsi } from "./wrap-ansi-CnYUWev2.js";
-export { wrapAnsi as default };

package/dist/oxfmt-config.d.ts

@@ -1 +0,0 @@
-export type { FormatOptions, SortImportsOptions, TailwindcssOptions } from 'oxfmt';