vite-plus 0.1.13 → 0.1.14-alpha.1

package/dist/resolve-vite-config.d.ts

@@ -1,5 +1,13 @@
+/**
+ * Find a vite config file by walking up from `startDir` to `stopDir`.
+ * Returns the absolute path of the first config file found, or undefined.
+ */
+export declare function findViteConfigUp(startDir: string, stopDir: string): string | undefined;
+export interface ResolveViteConfigOptions {
+    traverseUp?: boolean;
+}
 /**
  * Resolve vite.config.ts and return the config object.
  */
-export declare function resolveViteConfig(cwd: string): Promise<import("@voidzero-dev/vite-plus-core").ResolvedConfig>;
+export declare function resolveViteConfig(cwd: string, options?: ResolveViteConfigOptions): Promise<import("@voidzero-dev/vite-plus-core").ResolvedConfig>;
 export declare function resolveUniversalViteConfig(err: null | Error, viteConfigCwd: string): Promise<string>;

package/dist/resolve-vite-config.js

@@ -1,8 +1,85 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const VITE_CONFIG_FILES = [
+    'vite.config.ts',
+    'vite.config.js',
+    'vite.config.mjs',
+    'vite.config.mts',
+    'vite.config.cjs',
+    'vite.config.cts',
+];
+/**
+ * Find a vite config file by walking up from `startDir` to `stopDir`.
+ * Returns the absolute path of the first config file found, or undefined.
+ */
+export function findViteConfigUp(startDir, stopDir) {
+    let dir = path.resolve(startDir);
+    const stop = path.resolve(stopDir);
+    while (true) {
+        for (const filename of VITE_CONFIG_FILES) {
+            const filePath = path.join(dir, filename);
+            if (fs.existsSync(filePath)) {
+                return filePath;
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir || !parent.startsWith(stop)) {
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
+function hasViteConfig(dir) {
+    return VITE_CONFIG_FILES.some((f) => fs.existsSync(path.join(dir, f)));
+}
+/**
+ * Find the workspace root by walking up from `startDir` looking for
+ * monorepo indicators (pnpm-workspace.yaml, workspaces in package.json, lerna.json).
+ */
+function findWorkspaceRoot(startDir) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        if (fs.existsSync(path.join(dir, 'pnpm-workspace.yaml'))) {
+            return dir;
+        }
+        const pkgPath = path.join(dir, 'package.json');
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+                if (pkg.workspaces) {
+                    return dir;
+                }
+            }
+            catch {
+                // Skip malformed package.json and continue searching parent directories
+            }
+        }
+        if (fs.existsSync(path.join(dir, 'lerna.json'))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    return undefined;
+}
 /**
  * Resolve vite.config.ts and return the config object.
  */
-export async function resolveViteConfig(cwd) {
+export async function resolveViteConfig(cwd, options) {
     const { resolveConfig } = await import('./index.js');
+    if (options?.traverseUp && !hasViteConfig(cwd)) {
+        const workspaceRoot = findWorkspaceRoot(cwd);
+        if (workspaceRoot) {
+            const configFile = findViteConfigUp(path.dirname(cwd), workspaceRoot);
+            if (configFile) {
+                return resolveConfig({ root: cwd, configFile }, 'build');
+            }
+        }
+    }
     return resolveConfig({ root: cwd }, 'build');
 }
 export async function resolveUniversalViteConfig(err, viteConfigCwd) {

package/dist/test/optional-runtime-types.js.d.ts

@@ -0,0 +1,2 @@
+import '@voidzero-dev/vite-plus-test/optional-runtime-types.js';
+export * from '@voidzero-dev/vite-plus-test/optional-runtime-types.js';

package/dist/utils/constants.d.ts

@@ -1,6 +1,12 @@
 export declare const VITE_PLUS_NAME = "vite-plus";
 export declare const VITE_PLUS_VERSION: string;
 export declare const VITE_PLUS_OVERRIDE_PACKAGES: Record<string, string>;
+/**
+ * When VITE_PLUS_FORCE_MIGRATE is set, force full dependency rewriting
+ * even for projects already using vite-plus. Used by ecosystem CI to
+ * override dependencies with locally built tgz packages.
+ */
+export declare function isForceOverrideMode(): boolean;
 export declare function resolve(path: string): string;
 export declare const BASEURL_TSCONFIG_WARNING: string;
 export declare const DEFAULT_ENVS: {

package/dist/utils/constants.js

@@ -8,6 +8,14 @@ export const VITE_PLUS_OVERRIDE_PACKAGES = process.env
         vite: 'npm:@voidzero-dev/vite-plus-core@latest',
         vitest: 'npm:@voidzero-dev/vite-plus-test@latest',
     };
+/**
+ * When VITE_PLUS_FORCE_MIGRATE is set, force full dependency rewriting
+ * even for projects already using vite-plus. Used by ecosystem CI to
+ * override dependencies with locally built tgz packages.
+ */
+export function isForceOverrideMode() {
+    return process.env.VITE_PLUS_FORCE_MIGRATE === '1';
+}
 const require = createRequire(import.meta.url);
 export function resolve(path) {
     return require.resolve(path, {

package/dist/utils/editor.js

@@ -117,7 +117,7 @@ const ZED_SETTINGS = {
             prettier: { allowed: false },
             formatter: [{ language_server: { name: 'oxfmt' } }],
         },
-        Vue: {
+        'Vue.js': {
             format_on_save: 'on',
             prettier: { allowed: false },
             formatter: [{ language_server: { name: 'oxfmt' } }],

package/dist/utils/package.d.ts

@@ -15,4 +15,10 @@ export declare function hasVitePlusDependency(pkg?: {
     dependencies?: Record<string, string>;
     devDependencies?: Record<string, string>;
 } | null): boolean;
+/**
+ * Check if an npm package exists in the public registry.
+ * Returns true if the package exists or if the check could not be performed (network error, timeout).
+ * Returns false only if the registry definitively responds with 404.
+ */
+export declare function checkNpmPackageExists(packageName: string): Promise<boolean>;
 export {};

package/dist/utils/package.js

@@ -45,3 +45,22 @@ export function readNearestPackageJson(currentDir) {
 export function hasVitePlusDependency(pkg) {
     return Boolean(pkg?.dependencies?.[VITE_PLUS_NAME] || pkg?.devDependencies?.[VITE_PLUS_NAME]);
 }
+/**
+ * Check if an npm package exists in the public registry.
+ * Returns true if the package exists or if the check could not be performed (network error, timeout).
+ * Returns false only if the registry definitively responds with 404.
+ */
+export async function checkNpmPackageExists(packageName) {
+    const atIndex = packageName.indexOf('@', 2);
+    const name = atIndex === -1 ? packageName : packageName.slice(0, atIndex);
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${name}`, {
+            method: 'HEAD',
+            signal: AbortSignal.timeout(3000),
+        });
+        return response.status !== 404;
+    }
+    catch {
+        return true; // Network error or timeout - let the package manager handle it
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plus",
-  "version": "0.1.13",
+  "version": "0.1.14-alpha.1",
   "description": "The Unified Toolchain for the Web",
   "homepage": "https://viteplus.dev/guide",
   "bugs": {
@@ -93,6 +93,9 @@
     "./test/optional-types.js": {
       "types": "./dist/test/optional-types.js.d.ts"
     },
+    "./test/optional-runtime-types.js": {
+      "types": "./dist/test/optional-runtime-types.js.d.ts"
+    },
     "./test/globals": {
       "types": "./dist/test/globals.d.ts"
     },
@@ -307,15 +310,15 @@
     }
   },
   "dependencies": {
-    "@oxc-project/types": "=0.120.0",
+    "@oxc-project/types": "=0.122.0",
     "cac": "^7.0.0",
     "cross-spawn": "^7.0.5",
     "oxfmt": "=0.41.0",
     "oxlint": "=1.56.0",
-    "oxlint-tsgolint": "=0.17.1",
+    "oxlint-tsgolint": "=0.17.2",
     "picocolors": "^1.1.1",
-    "@voidzero-dev/vite-plus-core": "0.1.13",
-    "@voidzero-dev/vite-plus-test": "0.1.13"
+    "@voidzero-dev/vite-plus-core": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-test": "0.1.14-alpha.1"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.4.1",
@@ -337,9 +340,9 @@
     "tsdown": "^0.21.4",
     "validate-npm-package-name": "^7.0.2",
     "yaml": "^2.8.1",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.1.13",
-    "rolldown": "1.0.0-rc.10",
-    "@voidzero-dev/vite-plus-prompts": "0.0.0"
+    "@voidzero-dev/vite-plus-prompts": "0.0.0",
+    "rolldown": "1.0.0-rc.11",
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.1.14-alpha.1"
   },
   "napi": {
     "binaryName": "vite-plus",
@@ -348,7 +351,9 @@
       "aarch64-apple-darwin",
       "x86_64-apple-darwin",
       "aarch64-unknown-linux-gnu",
+      "aarch64-unknown-linux-musl",
       "x86_64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
       "x86_64-pc-windows-msvc",
       "aarch64-pc-windows-msvc"
     ]
@@ -357,12 +362,14 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "optionalDependencies": {
-    "@voidzero-dev/vite-plus-darwin-arm64": "0.1.13",
-    "@voidzero-dev/vite-plus-darwin-x64": "0.1.13",
-    "@voidzero-dev/vite-plus-linux-arm64-gnu": "0.1.13",
-    "@voidzero-dev/vite-plus-linux-x64-gnu": "0.1.13",
-    "@voidzero-dev/vite-plus-win32-x64-msvc": "0.1.13",
-    "@voidzero-dev/vite-plus-win32-arm64-msvc": "0.1.13"
+    "@voidzero-dev/vite-plus-darwin-arm64": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-darwin-x64": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-linux-arm64-gnu": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-linux-arm64-musl": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-linux-x64-gnu": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-linux-x64-musl": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-win32-x64-msvc": "0.1.14-alpha.1",
+    "@voidzero-dev/vite-plus-win32-arm64-msvc": "0.1.14-alpha.1"
   },
   "scripts": {
     "build": "oxnode -C dev ./build.ts",

package/skills/vite-plus/docs/config/build.md

@@ -0,0 +1,21 @@
+# Build Config
+
+`vp dev`, `vp build`, and `vp preview` use the standard [Vite configuration](https://vite.dev/config/), including [plugins](https://vite.dev/guide/using-plugins), [aliases](https://vite.dev/config/shared-options#resolve-alias), [`server`](https://vite.dev/config/server-options), [`build`](https://vite.dev/config/build-options) and [`preview`](https://vite.dev/config/preview-options) fields.
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  server: {
+    port: 3000,
+  },
+  build: {
+    sourcemap: true,
+  },
+  preview: {
+    port: 4173,
+  },
+});
+```

package/skills/vite-plus/docs/config/fmt.md

@@ -0,0 +1,18 @@
+# Format Config
+
+`vp fmt` and `vp check` read Oxfmt settings from the `fmt` block in `vite.config.ts`. See [Oxfmt's configuration](https://oxc.rs/docs/guide/usage/formatter/config.html) for details.
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  fmt: {
+    ignorePatterns: ['dist/**'],
+    singleQuote: true,
+    semi: true,
+    sortPackageJson: true,
+  },
+});
+```

package/skills/vite-plus/docs/config/index.md

@@ -0,0 +1,31 @@
+# Configuring Vite+
+
+Vite+ keeps project configuration in one place: `vite.config.ts`, allowing you to consolidate many top-level configuration files in a single file. You can keep using your Vite configuration such as `server` or `build`, and add Vite+ blocks for the rest of your workflow:
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  server: {},
+  build: {},
+  preview: {},
+
+  test: {},
+  lint: {},
+  fmt: {},
+  run: {},
+  pack: {},
+  staged: {},
+});
+```
+
+## Vite+ Specific Configuration
+
+Vite+ extends the basic Vite configuration with these additions:
+
+- [`lint`](/config/lint) for Oxlint
+- [`fmt`](/config/fmt) for Oxfmt
+- [`test`](/config/test) for Vitest
+- [`run`](/config/run) for Vite Task
+- [`pack`](/config/pack) for tsdown
+- [`staged`](/config/staged) for staged-file checks

package/skills/vite-plus/docs/config/lint.md

@@ -0,0 +1,24 @@
+# Lint Config
+
+`vp lint` and `vp check` read Oxlint settings from the `lint` block in `vite.config.ts`. See [Oxlint's configuration](https://oxc.rs/docs/guide/usage/linter/config.html) for details.
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  lint: {
+    ignorePatterns: ['dist/**'],
+    options: {
+      typeAware: true,
+      typeCheck: true,
+    },
+    rules: {
+      'no-console': ['error', { allow: ['error'] }],
+    },
+  },
+});
+```
+
+We recommend enabling both `options.typeAware` and `options.typeCheck` so `vp lint` and `vp check` can use the full type-aware path.

package/skills/vite-plus/docs/config/pack.md

@@ -0,0 +1,17 @@
+# Pack Config
+
+`vp pack` reads tsdown settings from the `pack` block in `vite.config.ts`. See [tsdown's configuration](https://tsdown.dev/options/config-file) for details.
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  pack: {
+    dts: true,
+    format: ['esm', 'cjs'],
+    sourcemap: true,
+  },
+});
+```

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

@@ -0,0 +1,231 @@
+# Run Config
+
+You can configure Vite Task under the `run` field in `vite.config.ts`. Check out [`vp run`](/guide/run) to learn more about running scripts and tasks with Vite+.
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  run: {
+    enablePrePostScripts: true,
+    cache: {
+      /* ... */
+    },
+    tasks: {
+      /* ... */
+    },
+  },
+});
+```
+
+## `run.enablePrePostScripts`
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Whether to automatically run `preX`/`postX` package.json scripts as lifecycle hooks when script `X` is executed.
+
+When enabled (the default), running a script like `test` will automatically run `pretest` before it and `posttest` after it, if they exist in `package.json`.
+
+```ts
+export default defineConfig({
+  run: {
+    enablePrePostScripts: false, // Disable pre/post lifecycle hooks
+  },
+});
+```
+
+::: warning
+This option can only be set in the workspace root's `vite.config.ts`. Setting it in a package's config will result in an error.
+:::
+
+## `run.cache`
+
+- **Type:** `boolean | { scripts?: boolean, tasks?: boolean }`
+- **Default:** `{ scripts: false, tasks: true }`
+
+Controls whether task results are cached and replayed on subsequent runs.
+
+```ts
+export default defineConfig({
+  run: {
+    cache: {
+      scripts: true, // Cache package.json scripts (default: false)
+      tasks: true, // Cache task definitions (default: true)
+    },
+  },
+});
+```
+
+`cache: true` enables both task and script caching, `cache: false` disables both.
+
+## `run.tasks`
+
+- **Type:** `Record<string, TaskConfig>`
+
+Defines tasks that can be run with `vp run <task>`.
+
+### `command`
+
+- **Type:** `string`
+
+Defines the shell command to run for the task.
+
+```ts
+tasks: {
+  build: {
+    command: 'vp build',
+  },
+}
+```
+
+Each task defined in `vite.config.ts` must include its own `command`. You cannot define a task in both `vite.config.ts` and `package.json` with the same task name.
+
+Commands joined with `&&` are automatically split into independently cached sub-tasks. See [Compound Commands](/guide/run#compound-commands).
+
+### `dependsOn`
+
+- **Type:** `string[]`
+- **Default:** `[]`
+
+Tasks that must complete successfully before this one starts.
+
+```ts
+tasks: {
+  deploy: {
+    command: 'deploy-script --prod',
+    dependsOn: ['build', 'test'],
+  },
+}
+```
+
+Dependencies can reference tasks in other packages using the `package#task` format:
+
+```ts
+dependsOn: ['@my/core#build', '@my/utils#lint'];
+```
+
+See [Task Dependencies](/guide/run#task-dependencies) for details on how explicit and topological dependencies interact.
+
+### `cache`
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Whether to cache this task's output. Set to `false` for tasks that should never be cached, like dev servers:
+
+```ts
+tasks: {
+  dev: {
+    command: 'vp dev',
+    cache: false,
+  },
+}
+```
+
+### `env`
+
+- **Type:** `string[]`
+- **Default:** `[]`
+
+Environment variables included in the cache fingerprint. When any listed variable's value changes, the cache is invalidated.
+
+```ts
+tasks: {
+  build: {
+    command: 'vp build',
+    env: ['NODE_ENV'],
+  },
+}
+```
+
+Wildcard patterns are supported: `VITE_*` matches all variables starting with `VITE_`.
+
+```bash
+$ NODE_ENV=development vp run build    # first run
+$ NODE_ENV=production vp run build     # cache miss: variable changed
+```
+
+### `untrackedEnv`
+
+- **Type:** `string[]`
+- **Default:** see below
+
+Environment variables passed to the task process but **not** included in the cache fingerprint. Changing these values won't invalidate the cache.
+
+```ts
+tasks: {
+  build: {
+    command: 'vp build',
+    untrackedEnv: ['CI', 'GITHUB_ACTIONS'],
+  },
+}
+```
+
+A set of common environment variables are automatically passed through to all tasks:
+
+- **System:** `HOME`, `USER`, `PATH`, `SHELL`, `LANG`, `TZ`
+- **Node.js:** `NODE_OPTIONS`, `COREPACK_HOME`, `PNPM_HOME`
+- **CI/CD:** `CI`, `VERCEL_*`, `NEXT_*`
+- **Terminal:** `TERM`, `COLORTERM`, `FORCE_COLOR`, `NO_COLOR`
+
+### `input`
+
+- **Type:** `Array<string | { auto: boolean }>`
+- **Default:** `[{ auto: true }]` (auto-inferred)
+
+Vite Task automatically detects which files are used by a command (see [Automatic File Tracking](/guide/cache#automatic-file-tracking)). The `input` option can be used to explicitly include or exclude certain files.
+
+**Exclude files** from automatic tracking:
+
+```ts
+tasks: {
+  build: {
+    command: 'vp build',
+    // Use `{ auto: true }` to use automatic fingerprinting (default).
+    input: [{ auto: true }, '!**/*.tsbuildinfo', '!dist/**'],
+  },
+}
+```
+
+**Specify explicit files** only without automatic tracking:
+
+```ts
+tasks: {
+  build: {
+    command: 'vp build',
+    input: ['src/**/*.ts', 'vite.config.ts'],
+  },
+}
+```
+
+**Disable file tracking** entirely and cache only on command/env changes:
+
+```ts
+tasks: {
+  greet: {
+    command: 'node greet.mjs',
+    input: [],
+  },
+}
+```
+
+::: tip
+Glob patterns are resolved relative to the package directory, not the task's `cwd`.
+:::
+
+### `cwd`
+
+- **Type:** `string`
+- **Default:** package root
+
+Working directory for the task, relative to the package root.
+
+```ts
+tasks: {
+  'test-e2e': {
+    command: 'vp test',
+    cwd: 'tests/e2e',
+  },
+}
+```

package/skills/vite-plus/docs/config/staged.md

@@ -0,0 +1,15 @@
+# Staged Config
+
+`vp staged` and `vp config` read staged-file rules from the `staged` block in `vite.config.ts`. See the [Commit hooks guide](/guide/commit-hooks).
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  staged: {
+    '*.{js,ts,tsx,vue,svelte}': 'vp check --fix',
+  },
+});
+```

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

@@ -0,0 +1,18 @@
+# Test Config
+
+`vp test` reads Vitest settings from the `test` block in `vite.config.ts`. See [Vitest's configuration](https://vitest.dev/config/) for details.
+
+## Example
+
+```ts
+import { defineConfig } from 'vite-plus';
+
+export default defineConfig({
+  test: {
+    include: ['src/**/*.test.ts'],
+    coverage: {
+      reporter: ['text', 'html'],
+    },
+  },
+});
+```

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

@@ -0,0 +1,40 @@
+# Build
+
+`vp build` builds Vite applications for production.
+
+## Overview
+
+`vp build` runs the standard Vite production build through Vite+. Since it is directly based on Vite, the build pipeline and configuration model are the same as Vite. For more information about how Vite production builds work, see the [Vite guide](https://vite.dev/guide/build). Note that Vite+ uses Vite 8 and [Rolldown](https://rolldown.rs/) for builds.
+
+::: info
+`vp build` always runs the built-in Vite production build. If your project also has a `build` script in `package.json`, run `vp run build` when you want to run that script instead.
+:::
+
+## Usage
+
+```bash
+vp build
+vp build --watch
+vp build --sourcemap
+```
+
+## Configuration
+
+Use standard Vite configuration in `vite.config.ts`. For the full configuration reference, see the [Vite config docs](https://vite.dev/config/).
+
+Use it for:
+
+- [plugins](https://vite.dev/guide/using-plugins)
+- [aliases](https://vite.dev/config/shared-options#resolve-alias)
+- [`build`](https://vite.dev/config/build-options)
+- [`preview`](https://vite.dev/config/preview-options)
+- [environment modes](https://vite.dev/guide/env-and-mode)
+
+## Preview
+
+Use `vp preview` to serve the production build locally after `vp build`.
+
+```bash
+vp build
+vp preview
+```