void 0.7.1 → 0.7.3

package/skills/void/docs/node_modules/void/node_modules/@void/md/node_modules/vite-plus/docs/guide/install.md

@@ -0,0 +1,147 @@
+# Installing Dependencies
+
+`vp install` installs dependencies using the current workspace's package manager.
+
+## Overview
+
+Use Vite+ to manage dependencies across pnpm, npm, Yarn, and Bun. Instead of switching between `pnpm install`, `npm install`, `yarn install`, and `bun install`, you can keep using `vp install`, `vp add`, `vp remove`, and the rest of the Vite+ package-management commands.
+
+Vite+ detects the package manager from the workspace root in this order:
+
+1. `packageManager` in `package.json`
+2. `pnpm-workspace.yaml`
+3. `pnpm-lock.yaml`
+4. `yarn.lock` or `.yarnrc.yml`
+5. `package-lock.json`
+6. `bun.lock` or `bun.lockb`
+7. `.pnpmfile.cjs` or `pnpmfile.cjs`
+8. `bunfig.toml`
+9. `yarn.config.cjs`
+
+If none of those files are present, `vp` falls back to `pnpm` by default. Vite+ automatically downloads the matching package manager and uses it for the command you ran.
+
+## Usage
+
+```bash
+vp install
+```
+
+Common install flows:
+
+```bash
+vp install
+vp install --frozen-lockfile
+vp install --lockfile-only
+vp install --filter web
+vp install -w
+```
+
+`vp install` maps to the correct underlying install behavior for the detected package manager, including the right lockfile flags for pnpm, npm, Yarn, and Bun.
+
+## Global Packages
+
+Use the `-g` flag for installing, updating or removing globally installed packages:
+
+- `vp install -g <pkg>` installs a package globally
+- `vp uninstall -g <pkg>` removes a global package
+- `vp update -g [pkg]` updates one global package or all of them
+- `vp list -g [pkg]` lists global packages
+
+## Managing Dependencies
+
+Vite+ provides all the familiar package management commands:
+
+- `vp install` installs the current dependency graph for the project
+- `vp add <pkg>` adds packages to `dependencies`, use `-D` for `devDependencies`
+- `vp remove <pkg>` removes packages
+- `vp update` updates dependencies
+- `vp dedupe` reduces duplicate dependency entries where the package manager supports it
+- `vp outdated` shows available updates
+- `vp list` shows installed packages
+- `vp why <pkg>` explains why a package is present
+- `vp info <pkg>` shows registry metadata for a package
+- `vp rebuild` rebuilds native modules (e.g. after switching Node.js versions)
+- `vp link` and `vp unlink` manage local package links
+- `vp dlx <pkg>` runs a package binary without adding it to the project
+- `vp pm <command>` forwards a raw package-manager-specific command when you need behavior outside the normalized `vp` command set
+
+### Command Guide
+
+#### Install
+
+Use `vp install` when you want to install exactly what the current `package.json` and lockfile describe.
+
+- `vp install` is the standard install command
+- `vp install --frozen-lockfile` fails if the lockfile would need changes
+- `vp install --no-frozen-lockfile` allows lockfile updates explicitly
+- `vp install --lockfile-only` updates the lockfile without performing a full install
+- `vp install --prefer-offline` and `vp install --offline` prefer or require cached packages
+- `vp install --ignore-scripts` skips lifecycle scripts
+- `vp install --filter <pattern>` scopes install work in monorepos
+- `vp install -w` installs in the workspace root
+
+#### Global Install
+
+Use these commands when you want package-manager-managed tools available outside a single project.
+
+- `vp install -g typescript`
+- `vp uninstall -g typescript`
+- `vp update -g`
+- `vp list -g`
+
+#### Add and Remove
+
+Use `vp add` and `vp remove` for day-to-day dependency edits instead of editing `package.json` by hand.
+
+- `vp add react`
+- `vp add -D typescript vitest`
+- `vp add -O fsevents`
+- `vp add --save-peer react`
+- `vp remove react`
+- `vp remove --filter web react`
+
+#### Update, Dedupe, and Outdated
+
+Use these commands to maintain the dependency graph over time.
+
+- `vp update` refreshes packages to newer versions
+- `vp outdated` shows which packages have newer versions available
+- `vp dedupe` asks the package manager to collapse duplicates where possible
+
+#### Inspect
+
+Use these when you need to understand the current state of dependencies.
+
+- `vp list` shows installed packages
+- `vp why react` explains why `react` is installed
+- `vp info react` shows registry metadata such as versions and dist-tags
+
+#### Rebuild
+
+Use `vp rebuild` when native modules need to be recompiled, for example after switching Node.js versions or when a C/C++ addon fails to load.
+
+- `vp rebuild` rebuilds all native modules
+- `vp rebuild -- <args>` passes extra arguments to the underlying package manager
+
+```bash
+vp rebuild
+vp rebuild -- --update-binary
+```
+
+`vp rebuild` is a shorthand for `vp pm rebuild`.
+
+#### Advanced
+
+Use these when you need lower-level package-manager behavior.
+
+- `vp link` and `vp unlink` manage local development links
+- `vp dlx create-vite` runs a package binary without saving it as a dependency
+- `vp pm <command>` forwards directly to the resolved package manager
+
+Examples:
+
+```bash
+vp pm config get registry
+vp pm cache clean --force
+vp pm exec tsc --version
+```

package/skills/void/docs/node_modules/void/node_modules/@void/md/node_modules/vite-plus/docs/guide/lint.md

@@ -0,0 +1,50 @@
+# Lint
+
+`vp lint` lints code with Oxlint.
+
+## Overview
+
+`vp lint` is built on [Oxlint](https://oxc.rs/docs/guide/usage/linter.html), the Oxc linter. Oxlint is designed as a fast replacement for ESLint for most frontend projects and ships with built-in support for core ESLint rules and many popular community rules.
+
+Use `vp lint` to lint your project, and `vp check` to format, lint and type-check all at once.
+
+## Usage
+
+```bash
+vp lint
+vp lint --fix
+vp lint --type-aware
+```
+
+## Configuration
+
+Put lint configuration directly in the `lint` block in `vite.config.ts` so all your configuration stays in one place. We do not recommend using `oxlint.config.ts` or `.oxlintrc.json` with Vite+.
+
+For the upstream rule set, options, and compatibility details, see the [Oxlint docs](https://oxc.rs/docs/guide/usage/linter.html).
+
+```ts [vite.config.ts]
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  lint: {
+    ignorePatterns: ['dist/**'],
+    options: {
+      typeAware: true,
+      typeCheck: true,
+    },
+  },
+});
+```
+
+## Type-Aware Linting
+
+We recommend enabling both `typeAware` and `typeCheck` in the `lint` block:
+
+- `typeAware: true` enables rules that require TypeScript type information
+- `typeCheck: true` enables full type checking during linting
+
+This path is powered by [tsgolint](https://github.com/oxc-project/tsgolint) on top of the TypeScript Go toolchain. It gives Oxlint access to type information and allows type checking directly via `vp lint` and `vp check`.
+
+## JS Plugins
+
+If you are migrating from ESLint and still depend on a few critical JavaScript-based ESLint plugins, Oxlint has [JS plugin support](https://oxc.rs/docs/guide/usage/linter/js-plugins) that can help you keep those plugins running while you complete the migration.

package/skills/void/docs/node_modules/void/node_modules/@void/md/node_modules/vite-plus/docs/guide/migrate.md

@@ -0,0 +1,173 @@
+# Migrate to Vite+
+
+`vp migrate` helps move existing projects onto Vite+.
+
+## Overview
+
+This command is the starting point for consolidating separate Vite, Vitest, Oxlint, Oxfmt, ESLint, and Prettier setups into Vite+.
+
+Use it when you want to take an existing project and move it onto the Vite+ defaults instead of wiring each tool by hand.
+
+## Usage
+
+```bash
+vp migrate
+vp migrate <path>
+vp migrate --no-interactive
+```
+
+## Target Path
+
+The positional `PATH` argument is optional.
+
+- If omitted, `vp migrate` migrates the current directory
+- If provided, it migrates that target directory instead
+
+```bash
+vp migrate
+vp migrate my-app
+```
+
+## Options
+
+- `--agent <name>` writes agent instructions into the project
+- `--no-agent` skips agent instruction setup
+- `--editor <name>` writes editor config files into the project
+- `--no-editor` skips editor config setup
+- `--hooks` sets up pre-commit hooks
+- `--no-hooks` skips hook setup
+- `--no-interactive` runs the migration without prompts
+
+## Migration Flow
+
+The `migrate` command is designed to move existing projects onto Vite+ quickly. Here is what the command does:
+
+- Updates project dependencies
+- Rewrites imports where needed
+- Merges tool-specific config into `vite.config.ts`
+- Updates scripts to the Vite+ command surface
+- Can set up commit hooks
+- Can write agent and editor configuration files
+
+Most projects will require further manual adjustments after running `vp migrate`.
+
+## Recommended Workflow
+
+Before running the migration:
+
+- Upgrade to Vite 8+ and Vitest 4.1+ first
+- Make sure you understand any existing lint, format, or test setup that should be preserved
+
+After running the migration:
+
+- Run `vp install`
+- Run `vp check`
+- Run `vp test`
+- Run `vp build`
+
+## Migration Prompt
+
+If you want to hand this work to a coding agent (or the reader is a coding agent!), use this migration prompt:
+
+```md
+Migrate this project to Vite+. Vite+ replaces the current split tooling around runtime management, package management, dev/build/test commands, linting, formatting, and packaging. Run `vp help` to understand Vite+ capabilities and `vp help migrate` before making changes. Use `vp migrate --no-interactive` in the workspace root. Make sure the project is using Vite 8+ and Vitest 4.1+ before migrating.
+
+After the migration:
+
+- Confirm `vite` imports were rewritten to `vite-plus` where needed
+- Confirm `vitest` imports were rewritten to `vite-plus/test` where needed
+- Remove old `vite` and `vitest` dependencies only after those rewrites are confirmed
+- Move remaining tool-specific config into the appropriate blocks in `vite.config.ts`
+
+Command mapping to keep in mind:
+
+- `vp run <script>` is the equivalent of `pnpm run <script>`
+- `vp test` runs the built-in test command, while `vp run test` runs the `test` script from `package.json`
+- `vp install`, `vp add`, and `vp remove` delegate through the package manager declared by `packageManager`
+- `vp dev`, `vp build`, `vp preview`, `vp lint`, `vp fmt`, `vp check`, and `vp pack` replace the corresponding standalone tools
+- Prefer `vp check` for validation loops
+
+Finally, verify the migration by running: `vp install`, `vp check`, `vp test`, and `vp build`
+
+Summarize the migration at the end and report any manual follow-up still required.
+```
+
+## Tool-Specific Migrations
+
+### Vitest
+
+Vitest is automatically migrated through `vp migrate`. If you are migrating manually, you have to update all the imports to `vite-plus/test` instead:
+
+```ts
+// before
+import { describe, expect, it, vi } from 'vitest';
+
+const { page } = await import('@vitest/browser/context');
+
+// after
+import { describe, expect, it, vi } from 'vite-plus/test';
+
+const { page } = await import('vite-plus/test/browser/context');
+```
+
+### tsdown
+
+If your project uses a `tsdown.config.ts`, move its options into the `pack` block in `vite.config.ts`:
+
+```ts [tsdown.config.ts] {4-6}
+import { defineConfig } from 'tsdown';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  dts: true,
+  format: ['esm', 'cjs'],
+});
+```
+
+```ts [vite.config.ts] {4-8}
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  pack: {
+    entry: ['src/index.ts'],
+    dts: true,
+    format: ['esm', 'cjs'],
+  },
+});
+```
+
+After merging, delete `tsdown.config.ts`. See the [Pack guide](/guide/pack) for the full configuration reference.
+
+### lint-staged
+
+Vite+ replaces lint-staged with its own `staged` block in `vite.config.ts`. Only the `staged` config format is supported. Standalone `.lintstagedrc` in non-JSON format and `lint-staged.config.*` are not migrated automatically.
+
+Move your lint-staged rules into the `staged` block:
+
+```ts [vite.config.ts]
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  staged: {
+    '*.{js,ts,tsx,vue,svelte}': 'vp check --fix',
+  },
+});
+```
+
+After migrating, remove lint-staged from your dependencies and delete any lint-staged config files. See the [Commit hooks guide](/guide/commit-hooks) and [Staged config reference](/config/staged) for details.
+
+## Examples
+
+```bash
+# Migrate the current project
+vp migrate
+
+# Migrate a specific directory
+vp migrate my-app
+
+# Run without prompts
+vp migrate --no-interactive
+
+# Write agent and editor setup during migration
+vp migrate --agent claude --editor zed
+```

package/skills/void/docs/node_modules/void/node_modules/@void/md/node_modules/vite-plus/docs/guide/pack.md

@@ -0,0 +1,61 @@
+# Pack
+
+`vp pack` builds libraries for production with [tsdown](https://tsdown.dev/guide/).
+
+## Overview
+
+`vp pack` builds libraries and standalone executables with tsdown. Use it for publishable packages and binary outputs. If you want to build a web application, use `vp build`. `vp pack` covers everything you need for building libraries out of the box, including declaration file generation, multiple output formats, source maps, and minification.
+
+For more information about how tsdown works, see the official [tsdown guide](https://tsdown.dev/guide/).
+
+## Usage
+
+```bash
+vp pack
+vp pack src/index.ts --dts
+vp pack --watch
+```
+
+## Configuration
+
+Put packaging configuration directly in the `pack` block in `vite.config.ts` so all your configuration stays in one place. We do not recommend using `tsdown.config.ts` with Vite+.
+
+See the [tsdown guide](https://tsdown.dev/guide/) and the [tsdown config file docs](https://tsdown.dev/options/config-file) to learn more about how to use and configure `vp pack`.
+
+Use it for:
+
+- [declaration files (`dts`)](https://tsdown.dev/options/dts)
+- [output formats](https://tsdown.dev/options/output-format)
+- [watch mode](https://tsdown.dev/options/watch-mode)
+- [standalone executables](https://tsdown.dev/options/exe#executable)
+
+```ts [vite.config.ts]
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  pack: {
+    dts: true,
+    format: ['esm', 'cjs'],
+    sourcemap: true,
+  },
+});
+```
+
+## Standalone Executables
+
+`vp pack` can also build standalone executables through tsdown's experimental [`exe` option](https://tsdown.dev/options/exe#executable).
+
+Use this when you want to ship a CLI or other Node-based tool as a native executable that runs without requiring Node.js to be installed separately.
+
+```ts [vite.config.ts]
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  pack: {
+    entry: ['src/cli.ts'],
+    exe: true,
+  },
+});
+```
+
+See the official [tsdown executable docs](https://tsdown.dev/options/exe#executable) for details about configuring custom file names, embedded assets, and cross-platform targets.