config-vp 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) Orimay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,331 @@
+# config-vp
+
+One shared [vite-plus](https://viteplus.dev) config for all your packages. Pick a project type and get linting, formatting, testing, building, and ready-to-run tasks — with zero boilerplate per package.
+
+## What you get
+
+- **Linting** — a strict [oxlint](https://oxc.rs) ruleset (TypeScript, unicorn, import, jsdoc, promise) with stylistic and import-sorting rules.
+- **Formatting** — an [oxfmt](https://oxc.rs) profile (single quotes, semicolons, trailing commas, Tailwind class sorting, import sorting).
+- **Tasks** — `check`, `test`, `build`, `dev`, `release`, and more, tailored to your project type and runnable with `vp run <task>`.
+- **Pre-commit checks** — staged files are checked and auto-fixed.
+- **VSCode setup** — a one-command task to wire up the oxc extension at your workspace root.
+
+Everything is opinionated and works out of the box. You can still override or extend any piece (see [Customizing](#customizing)).
+
+## Prerequisites
+
+This package is driven by [vite-plus](https://viteplus.dev) — the `vp` CLI that runs your whole dev lifecycle (install, dev server, lint, format, test, build). Install it once, globally:
+
+**Linux / macOS**
+
+```sh
+curl -fsSL https://vite.plus | bash
+```
+
+**Windows**
+
+```powershell
+irm https://viteplus.dev/install.ps1 | iex
+```
+
+Check it's available:
+
+```sh
+vp --version
+```
+
+## Quick start
+
+**1. Add the config to your package:**
+
+```sh
+vp add -D config-vp
+```
+
+This also pulls in everything the config needs (`oxlint`, `oxfmt`, and the lint plugins). If a compatible `vite-plus` is already in your workspace, that one is reused.
+
+**2. Create `vite.config.ts`:**
+
+```ts
+import { defineConfig } from 'config-vp';
+
+const config = defineConfig({ type: 'lib' });
+export default config;
+```
+
+> **Important:** Assign to a `const` and export it — don't write `export default defineConfig(...)` inline. `vp` reads your default export statically to discover tasks; a direct call hides them and `vp run` reports "Task not found". See [Troubleshooting](#troubleshooting).
+
+**3. Run something:**
+
+```sh
+vp run check     # lint + format, with autofix
+vp run test      # run tests
+vp run build     # build (vp pack / vite build / nuxt build, per type)
+```
+
+That's it. Pick the `type` that matches your package below for the right build/dev tasks.
+
+## Project types
+
+Set `type` to match what you're building. It drives Vue lint rules, library packaging, and the `build`/`dev`/`release` tasks.
+
+| `type`          | For                                  | `build`         | `dev`             |
+| --------------- | ------------------------------------ | --------------- | ----------------- |
+| `lib`           | A TypeScript library                 | `vp pack`       | `vp pack --watch` |
+| `lib:vue`       | A Vue component library              | `vp pack`       | `vp pack --watch` |
+| `lib:nuxt`      | A Nuxt-targeted library              | `vp pack`       | `vp pack --watch` |
+| `vue`           | A Vue (Vite) application             | `vite build`    | `vite dev`        |
+| `nuxt:spa`      | A Nuxt app, statically generated     | `nuxt generate` | `nuxt dev`        |
+| `nuxt:ssr`      | A Nuxt app, server-side rendered     | `nuxt build`    | `nuxt dev`        |
+| no `type` field | Shared root / non-buildable packages | _none_          | _none_            |
+
+### Recipes
+
+**Library** — dual ESM + CJS output:
+
+```ts
+import { defineConfig } from 'config-vp';
+
+const config = defineConfig({
+  type: 'lib',
+  overrides: {
+    pack: {
+      entry: ['src/index.ts'],
+      format: ['esm', 'cjs'],
+    },
+  },
+});
+export default config;
+```
+
+**Vue library** — same, with `type: 'lib:vue'` for SFC/template lint rules.
+
+```ts
+import { defineConfig } from 'config-vp';
+
+const config = defineConfig({
+  type: 'lib:vue',
+  overrides: {
+    pack: {
+      entry: ['src/index.ts'],
+      format: ['esm', 'cjs'],
+    },
+  },
+});
+export default config;
+```
+
+**Nuxt app.** Nuxt doesn't read `vite.config.ts` — its Vite settings live under the `vite` key of `nuxt.config.ts`. Build the config in a small `nuxt.config.vite.ts` and wire it in:
+
+```ts
+// nuxt.config.vite.ts
+import type { NuxtConfig } from 'nuxt/schema';
+import { defineConfig } from 'config-vp';
+
+export const vite = defineConfig({
+  type: 'nuxt:spa', // or 'nuxt:ssr'
+  overrides: {
+    // any Vite/vite-plus options the app needs, e.g. plugins, define, test, …
+  },
+}) as NuxtConfig['vite'];
+```
+
+```ts
+// nuxt.config.ts
+import { defineNuxtConfig } from 'nuxt/config';
+import { vite } from './nuxt.config.vite';
+
+export default defineNuxtConfig({ vite });
+```
+
+The `export const vite = …` form is itself a const export, so `vp` discovers any `run.tasks` you add through `overrides.run`.
+
+**Plain package** — lint + format + tests only, no build/dev (e.g. a config or scripts-only package). Just call `defineConfig()` with no `type`:
+
+```ts
+import { defineConfig } from 'config-vp';
+
+const config = defineConfig();
+export default config;
+```
+
+## Tasks
+
+Run any task with `vp run <task>`. Tasks are cached and run in dependency order across your workspace.
+
+**Always available:**
+
+| Task            | Command                                | Purpose                          |
+| --------------- | -------------------------------------- | -------------------------------- |
+| `check`         | `vp check --fix`                       | Lint + format, with autofix      |
+| `test`          | `vp test --run --passWithNoTests`      | Run the test suite once          |
+| `test:watch`    | `vp test --passWithNoTests`            | Run tests in watch mode          |
+| `test:coverage` | `vp test --coverage --passWithNoTests` | Run tests with a coverage report |
+
+> `--passWithNoTests` means a package with no test files passes instead of failing — so `test`/`release` don't break in packages that don't have tests yet.
+
+**Added by `type`:**
+
+| Task | When | Command |
+| --- | --- | --- |
+| `build` | any `type` | see [Project types](#project-types) |
+| `dev` | any `type` | see [Project types](#project-types) |
+| `release` | `lib*` types | `vp check --fix && vp test --run --passWithNoTests && vp pack && vpx bumpp && pnpm publish` |
+
+**Workspace root only:**
+
+| Task           | Command           |
+| -------------- | ----------------- |
+| `setup:vscode` | `vp-setup-vscode` |
+
+`setup:vscode` is added automatically to **workspace roots** (any package with a `pnpm-workspace.yaml` or a `workspaces` field, plus standalone projects). Nested sub-workspaces each get their own. It:
+
+1. Merges oxc settings into `.vscode/settings.json` (preserving your comments).
+2. Adds the `VoidZero.vite-plus-extension-pack` recommendation to `.vscode/extensions.json`.
+3. Installs the extension via the `code` CLI if available.
+
+> For a whole-workspace lint/format, use the built-in `vp check`. To build every package, use `vp run -r build`.
+
+## Customizing
+
+Two knobs, same shape — they differ only in how they merge:
+
+- **`overrides`** — _replace_ semantics. Your values overwrite the defaults. Applied first.
+- **`extends`** — _additive_ semantics. Arrays concatenate, objects deep-merge. Applied last, so it's never clobbered by an override.
+
+```ts
+const config = defineConfig({
+  type: 'lib',
+  overrides: {
+    // Replace the pack entry point entirely
+    pack: {
+      entry: ['src/index.ts'],
+      format: ['esm', 'cjs'],
+    },
+  },
+  extends: {
+    // Add to the lint config without losing built-ins
+    lint: {
+      rules: { 'no-console': 'error' },
+    },
+  },
+});
+export default config;
+```
+
+> `lint` is **always** deep-merged (never fully replaced), even under `overrides` — so you can't accidentally wipe the base ruleset.
+
+### Your existing Vite config goes here
+
+`overrides` and `extends` accept **any** vite-plus `UserConfig` field, not just config-vp's own keys. So a whole normal Vite config — `plugins`, `resolve`, `define`, `server`, `optimizeDeps`, `worker`, `test`, `build`, `run.tasks`, … — drops straight into `extends` (additive) or `overrides` (replacing). There's nothing config-vp-specific to learn: keep writing Vite config, just nest it.
+
+```ts
+const config = defineConfig({
+  type: 'nuxt:spa',
+  extends: {
+    plugins: [tailwindcss()],
+    define: { 'import.meta.env.VITE_RELEASE': JSON.stringify(release) },
+    optimizeDeps: { exclude: ['some-wasm-dep'] },
+    server: { fs: { allow: ['../..'] } },
+    test, // your vitest config
+    run: {
+      tasks: {
+        preview: { command: 'nuxt preview', cache: false },
+        deploy: { command: 'vpx tsx scripts/deploy.ts' },
+      },
+    },
+  },
+});
+export default config;
+```
+
+Your entire app-specific Vite setup lives in `extends`, on top of config-vp's `nuxt:spa` defaults.
+
+### Ignore patterns (lint + format)
+
+A top-level `ignorePatterns` is forwarded to **both** the linter and the formatter:
+
+```ts
+defineConfig({
+  type: 'lib',
+  // Replace the built-in ignore list:
+  overrides: { ignorePatterns: ['only-this/**'] },
+  // …or add to it, keeping the defaults:
+  extends: { ignorePatterns: ['generated/**', 'vendor/**'] },
+});
+```
+
+### Disable packaging
+
+A `lib*` type includes packaging by default. Turn it off with `pack: false`:
+
+```ts
+defineConfig({
+  type: 'lib',
+  overrides: { pack: false },
+});
+```
+
+## Options
+
+| Option | Type | Description |
+| --- | --- | --- |
+| `type` | `ProjectType` | `'lib' \| 'lib:vue' \| 'lib:nuxt' \| 'vue' \| 'nuxt:spa' \| 'nuxt:ssr'`. Omit for shared/root packages. |
+| `overrides` | object | Replace-semantics customizations. Accepts `ignorePatterns` and `pack: false`. |
+| `extends` | object | Additive customizations, applied after `overrides`. Same shape. |
+
+### Merge reference
+
+Order: `base → overrides (replace) → extends (additive)`.
+
+| Key             | Under `overrides`                     | Under `extends`      |
+| --------------- | ------------------------------------- | -------------------- |
+| `lint`          | arrays concat, rules deep-merge       | same                 |
+| `fmt`           | shallow-merge                         | recursive deep-merge |
+| `pack`          | shallow-merge (or `false` to disable) | recursive deep-merge |
+| `staged`        | shallow-merge                         | recursive deep-merge |
+| `run`           | shallow-merge, tasks combined         | recursive deep-merge |
+| arrays (others) | replace                               | concatenate          |
+
+## Default ignore patterns
+
+The base list applied to both linting and formatting (override or extend it via the [ignore-patterns shortcut](#ignore-patterns-lint--format)):
+
+```
+*.log*               **/.output          **/.vp-tsconfig
+**/.nuxt-storybook    **/node_modules     **/.vp-tmp-vite
+**/.nuxt              **/dist             .env
+**/.nitro            **/.vue-types        package-lock.json
+**/.cache                                 pnpm-lock.yaml
+```
+
+## API
+
+The package exports a single function, `defineConfig`, along with its `ProjectType` and `ConfigOptions` types for annotation.
+
+## Troubleshooting
+
+### `vp run <task>` says "Task not found" (but `vp pack` works)
+
+Your config almost certainly uses an inline default export. `vp` discovers tasks by statically reading the default export, and a direct call expression hides them. Use the `const` form:
+
+```ts
+// ❌ tasks are invisible to `vp run`
+export default defineConfig({ type: 'lib' });
+
+// ✅ assign, then export
+const config = defineConfig({ type: 'lib' });
+export default config;
+```
+
+### Tasks show up duplicated or ambiguous across the workspace
+
+Every workspace package needs a unique `name` in its `package.json`. An unnamed package (commonly the repo root) registers its tasks without a namespace, colliding with others. Give the root a name, e.g. `"name": "my-workspace-root"`.
+
+### `vp` crashes with `Cannot convert undefined or null to object`
+
+The globally-installed `vp` and your workspace's `vite-plus` are different versions. Match the workspace `vite-plus` (in `package.json` and any `pnpm.overrides`) to `vp --version`, then run `vp install`.
+
+## License
+
+MIT

package/bin/vp-setup-vscode.mjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/* eslint-disable typescript-eslint/no-unsafe-assignment, typescript-eslint/no-unsafe-argument, typescript-eslint/no-unsafe-member-access, typescript-eslint/no-unsafe-call, typescript-eslint/no-unsafe-return */
+
+import { applyEdits, modify, parse } from 'jsonc-parser';
+import { execSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+const EXTENSION_ID = 'VoidZero.vite-plus-extension-pack';
+
+/** Walk up from cwd until a directory containing .vscode/ is found, or return cwd. */
+function findVscodeRoot() {
+  let dir = process.cwd();
+  while (true) {
+    if (existsSync(join(dir, '.vscode'))) break;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return dir;
+}
+
+const vscodeDir = join(findVscodeRoot(), '.vscode');
+
+const OXC_SETTINGS = {
+  'editor.defaultFormatter': 'oxc.oxc-vscode',
+  'editor.formatOnSave': true,
+  'editor.formatOnSaveMode': 'file',
+  'editor.codeActionsOnSave': {
+    'source.fixAll.oxc': 'explicit',
+  },
+  'oxc.enable': true,
+  'oxc.typeAware': true,
+};
+
+const FORMAT_OPTIONS = { tabSize: 2, insertSpaces: true };
+
+/** Apply key-value pairs to a JSONC file in-place, preserving comments. */
+function mergeJsonc(filePath, entries) {
+  let text = existsSync(filePath) ? readFileSync(filePath, 'utf8') : '{}';
+  for (const [path, value] of entries) {
+    const edits = modify(text, path, value, { formattingOptions: FORMAT_OPTIONS });
+    text = applyEdits(text, edits);
+  }
+  writeFileSync(filePath, text);
+}
+
+// 1. Ensure .vscode dir exists
+if (!existsSync(vscodeDir)) mkdirSync(vscodeDir);
+
+// 2. Update .vscode/settings.json with oxc settings
+const settingsEntries = Object.entries(OXC_SETTINGS).flatMap(([key, value]) => {
+  if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+    return Object.entries(value).map(([subKey, subValue]) => [[key, subKey], subValue]);
+  }
+  return [[[key], value]];
+});
+mergeJsonc(join(vscodeDir, 'settings.json'), settingsEntries);
+console.log('VSCode settings updated with oxc configuration.');
+
+// 3. Add extension to .vscode/extensions.json recommendations
+const extensionsPath = join(vscodeDir, 'extensions.json');
+let extText = existsSync(extensionsPath)
+  ? readFileSync(extensionsPath, 'utf8')
+  : '{"recommendations":[]}';
+const extJson = parse(extText);
+const recs = extJson.recommendations ?? [];
+if (!recs.includes(EXTENSION_ID)) {
+  const edits = modify(extText, ['recommendations', recs.length], EXTENSION_ID, {
+    formattingOptions: FORMAT_OPTIONS,
+    isArrayInsertion: true,
+  });
+  extText = applyEdits(extText, edits);
+  writeFileSync(extensionsPath, extText);
+  console.log(`Added ${EXTENSION_ID} to extensions.json recommendations.`);
+} else {
+  console.log(`${EXTENSION_ID} already in extensions.json recommendations.`);
+}
+
+// 4. Install extension if `code` CLI is available
+try {
+  execSync(`code --install-extension ${EXTENSION_ID} --force`, { stdio: 'inherit' });
+} catch {
+  console.log(`Could not install extension automatically. Install it manually: ${EXTENSION_ID}`);
+}

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+import { UserConfig } from "vite-plus";
+
+//#region src/index.d.ts
+type ProjectType = 'lib' | 'lib:nuxt' | 'lib:vue' | 'nuxt:spa' | 'nuxt:ssr' | 'vue';
+type DeepPartial<T> = T extends ((...args: never[]) => unknown) ? T : T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? { [K in keyof T]?: DeepPartial<T[K]> } : T;
+interface ConfigOptions {
+  /** Project type — drives vue lint, pack inclusion, and dev/build/release tasks. */
+  type?: ProjectType;
+  /** Replace semantics: values replace defaults, objects shallow-merge at known keys. Exception: lint is always additive (deep-merged). Pass `pack: false` to suppress pack inclusion. */
+  overrides?: DeepPartial<UserConfig> & {
+    ignorePatterns?: string[];
+    pack?: unknown;
+  };
+  /** Additive semantics: arrays concatenate, objects deep-merge. Applied AFTER overrides. Pass `pack: false` to suppress pack inclusion. */
+  extends?: DeepPartial<UserConfig> & {
+    ignorePatterns?: string[];
+    pack?: unknown;
+  };
+}
+declare function defineConfig(options?: ConfigOptions): UserConfig;
+//#endregion
+export { ConfigOptions, ProjectType, defineConfig };

package/dist/index.mjs

@@ -0,0 +1,761 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/ignore.ts
+const ignorePatterns = [
+	"*.log*",
+	"**/.nuxt-storybook",
+	"**/.nuxt",
+	"**/.nitro",
+	"**/.cache",
+	"**/.output",
+	"**/node_modules",
+	"**/dist",
+	"**/.vue-types",
+	"**/.vp-tsconfig",
+	"**/.vp-tmp-vite",
+	".env",
+	"package-lock.json",
+	"pnpm-lock.yaml"
+];
+//#endregion
+//#region src/fmt.ts
+const fmt = {
+	ignorePatterns,
+	tabWidth: 2,
+	useTabs: false,
+	singleQuote: true,
+	semi: true,
+	proseWrap: "always",
+	arrowParens: "avoid",
+	bracketSameLine: false,
+	bracketSpacing: true,
+	vueIndentScriptAndStyle: true,
+	printWidth: 100,
+	endOfLine: "lf",
+	trailingComma: "all",
+	singleAttributePerLine: true,
+	experimentalTailwindcss: { attributes: [
+		"class",
+		"appear-from-class",
+		"appear-active-class",
+		"appear-to-class",
+		"enter-from-class",
+		"enter-active-class",
+		"enter-to-class",
+		"leave-from-class",
+		"leave-active-class",
+		"leave-to-class"
+	] },
+	experimentalSortImports: {
+		groups: [
+			"type-import",
+			["value-builtin", "value-external"],
+			"type-internal",
+			"value-internal",
+			[
+				"type-parent",
+				"type-sibling",
+				"type-index"
+			],
+			[
+				"value-parent",
+				"value-sibling",
+				"value-index"
+			],
+			"unknown"
+		],
+		ignoreCase: false,
+		newlinesBetween: false
+	},
+	embeddedLanguageFormatting: "auto",
+	insertFinalNewline: true,
+	objectWrap: "preserve",
+	quoteProps: "consistent",
+	sortPackageJson: true,
+	overrides: [{
+		files: ["*.md"],
+		options: { proseWrap: "never" }
+	}]
+};
+//#endregion
+//#region src/lint.ts
+const lint = {
+	plugins: [
+		"typescript",
+		"unicorn",
+		"oxc",
+		"eslint",
+		"import",
+		"jsdoc",
+		"node",
+		"promise"
+	],
+	jsPlugins: ["@stylistic/eslint-plugin", "eslint-plugin-perfectionist"],
+	categories: { correctness: "off" },
+	env: { builtin: true },
+	ignorePatterns,
+	options: {
+		typeCheck: true,
+		typeAware: true,
+		reportUnusedDisableDirectives: "deny",
+		denyWarnings: true,
+		maxWarnings: 0
+	},
+	rules: {
+		"constructor-super": "error",
+		"for-direction": "error",
+		"no-async-promise-executor": "error",
+		"no-case-declarations": "error",
+		"no-class-assign": "error",
+		"no-compare-neg-zero": "error",
+		"no-cond-assign": "error",
+		"no-const-assign": "error",
+		"no-constant-binary-expression": "error",
+		"no-constant-condition": "error",
+		"no-control-regex": "error",
+		"no-debugger": "error",
+		"no-delete-var": "error",
+		"no-dupe-class-members": "error",
+		"no-dupe-else-if": "error",
+		"no-dupe-keys": "error",
+		"no-duplicate-case": "error",
+		"no-empty": "error",
+		"no-empty-character-class": "error",
+		"no-empty-pattern": "error",
+		"no-empty-static-block": "error",
+		"no-ex-assign": "error",
+		"no-extra-boolean-cast": "error",
+		"no-fallthrough": "error",
+		"no-func-assign": "error",
+		"no-global-assign": "error",
+		"no-import-assign": "error",
+		"no-invalid-regexp": "error",
+		"no-irregular-whitespace": "error",
+		"no-loss-of-precision": "error",
+		"no-misleading-character-class": "error",
+		"no-new-native-nonconstructor": "error",
+		"no-nonoctal-decimal-escape": "error",
+		"no-obj-calls": "error",
+		"no-prototype-builtins": "error",
+		"no-redeclare": "error",
+		"no-regex-spaces": "error",
+		"no-self-assign": "error",
+		"no-setter-return": "error",
+		"no-shadow-restricted-names": "error",
+		"no-sparse-arrays": "error",
+		"no-this-before-super": "error",
+		"no-unexpected-multiline": "error",
+		"no-unsafe-finally": "error",
+		"no-unsafe-negation": "error",
+		"no-unsafe-optional-chaining": "error",
+		"no-unused-labels": "error",
+		"no-unused-private-class-members": "error",
+		"no-unused-vars": ["error", {
+			args: "all",
+			argsIgnorePattern: "^_",
+			caughtErrors: "all",
+			caughtErrorsIgnorePattern: "^_",
+			destructuredArrayIgnorePattern: "^_",
+			ignoreRestSiblings: true,
+			varsIgnorePattern: "^_"
+		}],
+		"no-useless-backreference": "error",
+		"no-useless-catch": "error",
+		"no-useless-escape": "error",
+		"no-with": "error",
+		"require-yield": "error",
+		"use-isnan": "error",
+		"valid-typeof": "error",
+		"@stylistic/array-bracket-spacing": ["error", "never"],
+		"@stylistic/arrow-parens": ["error", "as-needed"],
+		"@stylistic/arrow-spacing": ["error", {
+			after: true,
+			before: true
+		}],
+		"@stylistic/block-spacing": ["error", "always"],
+		"@stylistic/brace-style": ["error", "1tbs"],
+		"@stylistic/comma-dangle": ["error", "always-multiline"],
+		"@stylistic/comma-spacing": ["error", {
+			after: true,
+			before: false
+		}],
+		"@stylistic/comma-style": ["error", "last"],
+		"@stylistic/computed-property-spacing": [
+			"error",
+			"never",
+			{ enforceForClassMembers: true }
+		],
+		"@stylistic/dot-location": ["error", "property"],
+		"@stylistic/eol-last": "error",
+		"@stylistic/generator-star-spacing": ["error", {
+			after: true,
+			before: false
+		}],
+		"@stylistic/key-spacing": ["error", {
+			afterColon: true,
+			beforeColon: false
+		}],
+		"@stylistic/keyword-spacing": ["error", {
+			after: true,
+			before: true
+		}],
+		"@stylistic/lines-between-class-members": [
+			"error",
+			"always",
+			{ exceptAfterSingleLine: true }
+		],
+		"@stylistic/max-statements-per-line": ["error", { max: 1 }],
+		"@stylistic/multiline-ternary": ["error", "always-multiline"],
+		"@stylistic/new-parens": "error",
+		"@stylistic/no-extra-parens": ["error", "functions"],
+		"@stylistic/no-floating-decimal": "error",
+		"@stylistic/no-mixed-spaces-and-tabs": "error",
+		"@stylistic/no-multi-spaces": "error",
+		"@stylistic/no-multiple-empty-lines": ["error", {
+			max: 1,
+			maxBOF: 0,
+			maxEOF: 0
+		}],
+		"@stylistic/no-tabs": "error",
+		"@stylistic/no-trailing-spaces": "error",
+		"@stylistic/no-whitespace-before-property": "error",
+		"@stylistic/object-curly-spacing": ["error", "always"],
+		"@stylistic/operator-linebreak": [
+			"error",
+			"after",
+			{ overrides: {
+				":": "before",
+				"?": "before",
+				"|": "before",
+				"&": "before"
+			} }
+		],
+		"@stylistic/padded-blocks": ["error", {
+			blocks: "never",
+			classes: "never",
+			switches: "never"
+		}],
+		"@stylistic/quote-props": ["error", "consistent-as-needed"],
+		"@stylistic/quotes": [
+			"error",
+			"single",
+			{ avoidEscape: true }
+		],
+		"@stylistic/rest-spread-spacing": ["error", "never"],
+		"@stylistic/semi": ["error", "always"],
+		"@stylistic/semi-spacing": ["error", {
+			after: true,
+			before: false
+		}],
+		"@stylistic/space-before-blocks": ["error", "always"],
+		"@stylistic/space-before-function-paren": ["error", {
+			anonymous: "always",
+			asyncArrow: "always",
+			named: "never"
+		}],
+		"@stylistic/space-in-parens": ["error", "never"],
+		"@stylistic/space-infix-ops": "error",
+		"@stylistic/space-unary-ops": ["error", {
+			nonwords: false,
+			words: true
+		}],
+		"@stylistic/spaced-comment": [
+			"error",
+			"always",
+			{
+				block: {
+					balanced: true,
+					exceptions: ["*"],
+					markers: ["!"]
+				},
+				line: {
+					exceptions: ["/", "#"],
+					markers: ["/"]
+				}
+			}
+		],
+		"@stylistic/template-curly-spacing": "error",
+		"@stylistic/template-tag-spacing": ["error", "never"],
+		"@stylistic/type-annotation-spacing": ["error", {}],
+		"@stylistic/type-generic-spacing": "error",
+		"@stylistic/type-named-tuple-spacing": "error",
+		"@stylistic/wrap-iife": [
+			"error",
+			"any",
+			{ functionPrototypeMethods: true }
+		],
+		"@stylistic/yield-star-spacing": ["error", {
+			after: true,
+			before: false
+		}],
+		"@stylistic/jsx-closing-bracket-location": "error",
+		"@stylistic/jsx-closing-tag-location": "error",
+		"@stylistic/jsx-curly-brace-presence": ["error", { propElementValues: "always" }],
+		"@stylistic/jsx-curly-newline": "error",
+		"@stylistic/jsx-curly-spacing": ["error", "never"],
+		"@stylistic/jsx-equals-spacing": "error",
+		"@stylistic/jsx-first-prop-new-line": "error",
+		"@stylistic/jsx-function-call-newline": ["error", "multiline"],
+		"@stylistic/jsx-indent-props": ["error", 2],
+		"@stylistic/jsx-max-props-per-line": ["error", {
+			maximum: 1,
+			when: "multiline"
+		}],
+		"@stylistic/jsx-one-expression-per-line": ["error", { allow: "single-child" }],
+		"@stylistic/jsx-quotes": "error",
+		"@stylistic/jsx-tag-spacing": ["error", {
+			afterOpening: "never",
+			beforeClosing: "never",
+			beforeSelfClosing: "always",
+			closingSlash: "never"
+		}],
+		"@stylistic/jsx-wrap-multilines": ["error", {
+			arrow: "parens-new-line",
+			assignment: "parens-new-line",
+			condition: "parens-new-line",
+			declaration: "parens-new-line",
+			logical: "parens-new-line",
+			prop: "parens-new-line",
+			propertyValue: "parens-new-line",
+			return: "parens-new-line"
+		}],
+		"@typescript-eslint/await-thenable": "error",
+		"@typescript-eslint/ban-ts-comment": ["error", { minimumDescriptionLength: 10 }],
+		"no-array-constructor": "error",
+		"@typescript-eslint/no-array-delete": "error",
+		"@typescript-eslint/no-base-to-string": "error",
+		"@typescript-eslint/no-confusing-void-expression": "error",
+		"@typescript-eslint/no-deprecated": "error",
+		"@typescript-eslint/no-duplicate-enum-values": "error",
+		"@typescript-eslint/no-duplicate-type-constituents": "error",
+		"@typescript-eslint/no-dynamic-delete": "error",
+		"@typescript-eslint/no-empty-object-type": ["error", {
+			allowInterfaces: "with-single-extends",
+			allowObjectTypes: "never"
+		}],
+		"@typescript-eslint/no-explicit-any": "error",
+		"@typescript-eslint/no-extra-non-null-assertion": "error",
+		"@typescript-eslint/no-extraneous-class": "error",
+		"@typescript-eslint/no-floating-promises": "error",
+		"@typescript-eslint/no-for-in-array": "error",
+		"@typescript-eslint/no-implied-eval": "error",
+		"@typescript-eslint/no-invalid-void-type": ["error", { allowAsThisParameter: true }],
+		"@typescript-eslint/no-meaningless-void-operator": "error",
+		"@typescript-eslint/no-misused-new": "error",
+		"@typescript-eslint/no-misused-promises": "error",
+		"@typescript-eslint/no-misused-spread": "error",
+		"@typescript-eslint/no-mixed-enums": "error",
+		"@typescript-eslint/no-namespace": "error",
+		"@typescript-eslint/no-non-null-asserted-nullish-coalescing": "error",
+		"@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+		"@typescript-eslint/no-redundant-type-constituents": "error",
+		"@typescript-eslint/no-require-imports": "error",
+		"@typescript-eslint/no-this-alias": "error",
+		"@typescript-eslint/no-unnecessary-boolean-literal-compare": "error",
+		"@typescript-eslint/no-unnecessary-template-expression": "error",
+		"@typescript-eslint/no-unnecessary-type-arguments": "error",
+		"@typescript-eslint/no-unnecessary-type-assertion": "error",
+		"@typescript-eslint/no-unnecessary-type-constraint": "error",
+		"@typescript-eslint/no-unsafe-argument": "error",
+		"@typescript-eslint/no-unsafe-assignment": "error",
+		"@typescript-eslint/no-unsafe-call": "error",
+		"@typescript-eslint/no-unsafe-declaration-merging": "error",
+		"@typescript-eslint/no-unsafe-enum-comparison": "error",
+		"@typescript-eslint/no-unsafe-function-type": "error",
+		"@typescript-eslint/no-unsafe-member-access": "error",
+		"@typescript-eslint/no-unsafe-return": "error",
+		"@typescript-eslint/no-unsafe-unary-minus": "error",
+		"no-unused-expressions": ["error", {
+			allowShortCircuit: true,
+			allowTernary: true,
+			allowTaggedTemplates: true
+		}],
+		"no-useless-constructor": "error",
+		"@typescript-eslint/no-wrapper-object-types": "error",
+		"@typescript-eslint/only-throw-error": "error",
+		"@typescript-eslint/prefer-as-const": "error",
+		"@typescript-eslint/prefer-literal-enum-member": "error",
+		"@typescript-eslint/prefer-namespace-keyword": "error",
+		"@typescript-eslint/prefer-promise-reject-errors": "error",
+		"@typescript-eslint/prefer-reduce-type-parameter": "error",
+		"@typescript-eslint/prefer-return-this-type": "error",
+		"@typescript-eslint/related-getter-setter-pairs": "error",
+		"@typescript-eslint/require-await": "error",
+		"@typescript-eslint/restrict-plus-operands": ["error", {
+			allowAny: false,
+			allowBoolean: false,
+			allowNullish: false,
+			allowNumberAndString: false,
+			allowRegExp: false
+		}],
+		"@typescript-eslint/return-await": ["error", "error-handling-correctness-only"],
+		"@typescript-eslint/triple-slash-reference": "error",
+		"@typescript-eslint/unbound-method": ["error", { ignoreStatic: true }],
+		"@typescript-eslint/use-unknown-in-catch-callback-variable": "error",
+		"@typescript-eslint/adjacent-overload-signatures": "error",
+		"@typescript-eslint/array-type": "error",
+		"@typescript-eslint/ban-tslint-comment": "error",
+		"@typescript-eslint/class-literal-property-style": "error",
+		"@typescript-eslint/consistent-generic-constructors": "error",
+		"@typescript-eslint/consistent-indexed-object-style": "error",
+		"@typescript-eslint/consistent-type-assertions": "error",
+		"@typescript-eslint/consistent-type-definitions": "error",
+		"@typescript-eslint/no-confusing-non-null-assertion": "error",
+		"no-empty-function": "error",
+		"@typescript-eslint/no-inferrable-types": "error",
+		"@typescript-eslint/non-nullable-type-assertion-style": "error",
+		"@typescript-eslint/prefer-for-of": "error",
+		"@typescript-eslint/prefer-function-type": "error",
+		"@typescript-eslint/prefer-includes": "error",
+		"@typescript-eslint/prefer-nullish-coalescing": ["error", { ignoreTernaryTests: true }],
+		"perfectionist/sort-variable-declarations": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-intersection-types": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-heritage-clauses": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-array-includes": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-named-imports": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-named-exports": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-union-types": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-switch-case": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-decorators": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-jsx-props": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-exports": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-enums": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-sets": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"perfectionist/sort-maps": ["error", {
+			type: "natural",
+			order: "asc"
+		}],
+		"@typescript-eslint/consistent-type-imports": ["error", { fixStyle: "separate-type-imports" }],
+		"prefer-const": ["error", {
+			destructuring: "all",
+			ignoreReadBeforeAssign: false
+		}]
+	},
+	overrides: [{
+		files: [
+			"**/*.ts",
+			"**/*.tsx",
+			"**/*.mts",
+			"**/*.cts"
+		],
+		rules: {
+			"constructor-super": "off",
+			"no-class-assign": "off",
+			"no-const-assign": "off",
+			"no-dupe-class-members": "off",
+			"no-dupe-keys": "off",
+			"no-func-assign": "off",
+			"no-import-assign": "off",
+			"no-new-native-nonconstructor": "off",
+			"no-obj-calls": "off",
+			"no-redeclare": "off",
+			"no-setter-return": "off",
+			"no-this-before-super": "off",
+			"no-unsafe-negation": "off",
+			"no-var": "error",
+			"no-with": "off",
+			"prefer-rest-params": "error",
+			"prefer-spread": "error"
+		}
+	}]
+};
+//#endregion
+//#region src/pack.ts
+const pack = {
+	dts: true,
+	format: ["esm"],
+	sourcemap: false
+};
+//#endregion
+//#region src/run.ts
+function hasWorkspaceMarker(dir) {
+	if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "pnpm-workspace.yml"))) return true;
+	try {
+		const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+		return Array.isArray(pkg.workspaces);
+	} catch {
+		return false;
+	}
+}
+/**
+* Directory of the vite config that called us. process.cwd() is unreliable — vp
+* evaluates every package's config from the invocation cwd — so we recover the
+* caller's location from the stack instead. vp bundles each config to
+* `<pkg>/node_modules/.vite-temp/...`; the package dir is the part before that.
+*/
+function callerPackageDir() {
+	const stack = (/* @__PURE__ */ new Error()).stack ?? "";
+	for (const line of stack.split("\n")) {
+		const temp = line.match(/(\/.+?)\/node_modules\/\.vite-temp\//);
+		if (temp) return temp[1];
+		const direct = line.match(/(\/.+?)\/[^/]*\.config\.[^/\s:)]+/);
+		if (direct && !direct[1].includes("/node_modules/")) return direct[1];
+	}
+}
+/** True when the calling config's package is the workspace root (or a standalone project). */
+function isProjectRoot() {
+	const dir = callerPackageDir() ?? process.cwd();
+	if (hasWorkspaceMarker(dir)) return true;
+	let parent = dirname(dir);
+	while (parent !== dirname(parent)) {
+		if (hasWorkspaceMarker(parent)) return false;
+		parent = dirname(parent);
+	}
+	return true;
+}
+function buildRunConfig(options = {}) {
+	const tasks = {
+		"check": { command: "vp check --fix" },
+		"test": { command: "vp test --run --passWithNoTests" },
+		"test:watch": {
+			command: "vp test --passWithNoTests",
+			cache: false
+		},
+		"test:coverage": { command: "vp test --coverage --passWithNoTests" }
+	};
+	switch (true) {
+		case options.lib:
+			tasks.build = { command: "vp pack" };
+			tasks.dev = {
+				command: "vp pack --watch",
+				cache: false
+			};
+			tasks.release = {
+				command: "vp check --fix && vp test --run --passWithNoTests && vp pack && vpx bumpp && pnpm publish",
+				cache: false
+			};
+			break;
+		case options.nuxt === "spa":
+			tasks.build = { command: "nuxt generate" };
+			tasks.dev = {
+				command: "nuxt dev",
+				cache: false
+			};
+			break;
+		case options.nuxt === "ssr":
+			tasks.build = { command: "nuxt build" };
+			tasks.dev = {
+				command: "nuxt dev",
+				cache: false
+			};
+			break;
+		case options.vueApp:
+			tasks.build = { command: "vite build" };
+			tasks.dev = {
+				command: "vite dev",
+				cache: false
+			};
+			break;
+	}
+	if (isProjectRoot()) tasks["setup:vscode"] = {
+		command: "vp-setup-vscode",
+		cache: false
+	};
+	return { tasks };
+}
+//#endregion
+//#region src/staged.ts
+const staged = { "*.{js,ts,tsx,vue}": "vp check --fix" };
+//#endregion
+//#region src/vue-lint.ts
+const vueLint = {
+	plugins: ["vue"],
+	overrides: [{
+		files: ["**/*.vue"],
+		rules: { "@stylistic/no-multiple-empty-lines": ["error", {
+			max: 1,
+			maxBOF: 1,
+			maxEOF: 0
+		}] }
+	}, {
+		files: ["**/*.stories.ts", "**/*.stories.tsx"],
+		rules: {
+			"@typescript-eslint/no-unsafe-assignment": "off",
+			"@typescript-eslint/no-unsafe-argument": "off",
+			"@typescript-eslint/no-unsafe-call": "off",
+			"@typescript-eslint/no-unsafe-member-access": "off",
+			"@typescript-eslint/no-unsafe-return": "off"
+		}
+	}],
+	rules: {
+		"vue/define-emits-declaration": ["error", "type-based"],
+		"vue/define-props-declaration": ["error", "type-based"],
+		"vue/define-props-destructuring": "allow",
+		"vue/no-export-in-script-setup": "error",
+		"vue/no-import-compiler-macros": "error",
+		"vue/no-lifecycle-after-await": "error",
+		"vue/no-multiple-slot-args": "error",
+		"vue/no-required-prop-with-default": "error",
+		"vue/no-this-in-before-route-enter": "error",
+		"vue/prefer-import-from-vue": "error",
+		"vue/require-default-export": "error",
+		"vue/require-typed-ref": "error",
+		"vue/valid-define-emits": "error",
+		"vue/valid-define-props": "error"
+	}
+};
+//#endregion
+//#region src/index.ts
+const DEEP_MERGE_KEYS = new Set([
+	"fmt",
+	"pack",
+	"staged"
+]);
+function deepExtend(target, source) {
+	if (source === void 0) return target;
+	if (Array.isArray(target) && Array.isArray(source)) return [...target, ...source];
+	if (target !== null && typeof target === "object" && !Array.isArray(target) && source !== null && typeof source === "object" && !Array.isArray(source)) {
+		const result = { ...target };
+		for (const [key, value] of Object.entries(source)) result[key] = key in result ? deepExtend(result[key], value) : value;
+		return result;
+	}
+	return source;
+}
+function mergeLayers(base, ...layers) {
+	const result = { ...base };
+	for (const layer of layers) {
+		if (layer.lint) {
+			const { extends: layerExtends, ...layerLintRest } = layer.lint;
+			const baseArr = result.lint ? [result.lint] : [];
+			const combined = layerExtends !== void 0 ? [...baseArr, ...Array.isArray(layerExtends) ? layerExtends : [layerExtends]] : baseArr;
+			result.lint = combined.length > 0 ? {
+				extends: combined,
+				...layerLintRest
+			} : { ...layerLintRest };
+		}
+		if (layer.run) result.run = {
+			...result.run,
+			...layer.run,
+			tasks: {
+				...result.run?.tasks,
+				...layer.run.tasks
+			}
+		};
+		for (const [key, value] of Object.entries(layer)) {
+			if (key === "lint" || key === "run") continue;
+			if (DEEP_MERGE_KEYS.has(key)) result[key] = {
+				...result[key],
+				...value
+			};
+			else result[key] = value;
+		}
+	}
+	return result;
+}
+function mergeLintConfigs(...configs) {
+	if (configs.length === 0) return {};
+	if (configs.length === 1) return { ...configs[0] };
+	return configs.reduce((acc, config) => {
+		const merged = { ...acc };
+		for (const [key, value] of Object.entries(config)) {
+			const existing = merged[key];
+			if (Array.isArray(existing) && Array.isArray(value)) merged[key] = [...existing, ...value];
+			else if (existing && typeof existing === "object" && !Array.isArray(existing) && value && typeof value === "object" && !Array.isArray(value)) merged[key] = {
+				...existing,
+				...value
+			};
+			else merged[key] = value;
+		}
+		return merged;
+	});
+}
+function defineConfig(options = {}) {
+	const t = options.type;
+	const isVue = t === "lib:vue" || t === "lib:nuxt" || t === "vue" || t === "nuxt:spa" || t === "nuxt:ssr";
+	const isLib = t === "lib" || t === "lib:vue" || t === "lib:nuxt";
+	const overridesPack = options.overrides?.pack;
+	const extendsPack = options.extends?.pack;
+	const isPack = (isLib || !!overridesPack || !!extendsPack) && overridesPack !== false && extendsPack !== false;
+	const lintLayers = [lint];
+	if (isVue) lintLayers.push(vueLint);
+	if (options.overrides?.lint) lintLayers.push(options.overrides.lint);
+	if (options.extends?.lint) lintLayers.push(options.extends.lint);
+	let mergedLint = mergeLintConfigs(...lintLayers);
+	if (options.overrides?.ignorePatterns) mergedLint = {
+		...mergedLint,
+		ignorePatterns: options.overrides.ignorePatterns
+	};
+	if (options.extends?.ignorePatterns) mergedLint = {
+		...mergedLint,
+		ignorePatterns: [...mergedLint.ignorePatterns ?? [], ...options.extends.ignorePatterns]
+	};
+	let mergedFmt = fmt;
+	if (options.overrides?.ignorePatterns) mergedFmt = {
+		...mergedFmt,
+		ignorePatterns: options.overrides.ignorePatterns
+	};
+	if (options.extends?.ignorePatterns) mergedFmt = {
+		...mergedFmt,
+		ignorePatterns: [...mergedFmt?.ignorePatterns ?? [], ...options.extends.ignorePatterns]
+	};
+	const run = buildRunConfig({
+		lib: isLib,
+		nuxt: t === "nuxt:spa" ? "spa" : t === "nuxt:ssr" ? "ssr" : void 0,
+		vueApp: t === "vue"
+	});
+	let result = {
+		lint: mergedLint,
+		fmt: mergedFmt,
+		staged,
+		run,
+		...isPack && { pack }
+	};
+	if (options.overrides) {
+		const { lint: _l, ignorePatterns: _ip, pack: _p, ...rest } = options.overrides;
+		const layer = overridesPack !== void 0 && overridesPack !== false ? {
+			...rest,
+			pack: overridesPack
+		} : rest;
+		if (Object.keys(layer).length > 0) result = mergeLayers(result, layer);
+	}
+	if (options.extends) {
+		const { lint: _l, ignorePatterns: _ip, pack: _p, ...rest } = options.extends;
+		const layer = extendsPack !== void 0 && extendsPack !== false ? {
+			...rest,
+			pack: extendsPack
+		} : rest;
+		if (Object.keys(layer).length > 0) result = deepExtend(result, layer);
+	}
+	return result;
+}
+//#endregion
+export { defineConfig };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "config-vp",
+  "version": "1.0.0",
+  "description": "Shared vite-plus configuration — opinionated defaults for linting, formatting, task running, staged checks, and VSCode setup. Optional Vue and pack layers with deep-merge overrides.",
+  "keywords": [
+    "config",
+    "eslint",
+    "formatter",
+    "linter",
+    "monorepo",
+    "oxfmt",
+    "oxlint",
+    "perfectionist",
+    "stylistic",
+    "typescript",
+    "vite-plus",
+    "vscode",
+    "vue"
+  ],
+  "homepage": "https://github.com/orimay/config-vp#readme",
+  "bugs": {
+    "url": "https://github.com/orimay/config-vp/issues"
+  },
+  "license": "MIT",
+  "author": "Dmitrii Baranov <dmitrii.a.baranov@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orimay/config-vp.git"
+  },
+  "bin": {
+    "vp-setup-vscode": "./bin/vp-setup-vscode.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "eslint-plugin-perfectionist": "^5.8.0",
+    "jsonc-parser": "^3.3.1",
+    "oxfmt": "^0.45.0",
+    "oxlint": "^1.60.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "vite-plus": ">=0.1.24"
+  }
+}