@st1ggy/linter-config 7.3.1 → 8.0.0

package/docs/RULE_MAPPING.md

@@ -33,6 +33,21 @@ Inventory rule counts (sample files in this repository):
 - `eslint-svelte`: effective rules on `src/examples/example.svelte`
 - `eslint-astro`: effective rules on `src/examples/example.astro`
 
+## Oxlint counterparts
+
+The package also exports `common-ox`, `react-ox`, `solid-ox`, `next-ox`, `svelte-ox` and `astro-ox`. Each is one `OxlintConfig` object, used through `oxlint.config.ts`, with `options.typeAware: true` and the native TS7 tsgolint engine. The original ESLint presets remain available.
+
+The new variants use explicit migrated rules plus compatible JS adapters. Common/React/Solid/Next pair with `oxfmt-common` and a separate `oxfmt --check`; their source `prettier/prettier` check is recorded as `formatter` in the audit instead of running a Prettier JS plugin. Svelte/Astro keep their existing Prettier selections. Every stack retains Stylelint. See [OXLINT_RULE_MAPPING.md](OXLINT_RULE_MAPPING.md) for source/target correspondence, per-scope counts, partial mappings and unsupported rules. Native script extraction does not provide Svelte/Astro template linting.
+
+Regenerate and verify the Oxlint inventory with:
+
+```bash
+npm run generate:ox
+npm run inventory:ox
+npm run generate:ox:check
+npm run inventory:ox:check
+```
+
 ## Stylelint (SCSS preset)
 
 | Layer | `@st1ggy/linter-config` | Notes |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@st1ggy/linter-config",
-  "version": "7.3.1",
-  "description": "ESLint, Prettier, and Stylelint shareable configs (sources under src/).",
+  "version": "8.0.0",
+  "description": "Shareable ESLint, Oxlint, Oxfmt, Prettier, and Stylelint configs.",
   "private": false,
   "repository": {
     "type": "git",
@@ -93,11 +93,46 @@
       "import": "./src/eslint/eslint.config.common.js",
       "default": "./src/eslint/eslint.config.common.js"
     },
+    "./common-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.common.js",
+      "default": "./src/oxlint/oxlint.config.common.js"
+    },
+    "./react-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.react.js",
+      "default": "./src/oxlint/oxlint.config.react.js"
+    },
+    "./solid-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.solid.js",
+      "default": "./src/oxlint/oxlint.config.solid.js"
+    },
+    "./next-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.next.js",
+      "default": "./src/oxlint/oxlint.config.next.js"
+    },
+    "./svelte-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.svelte.js",
+      "default": "./src/oxlint/oxlint.config.svelte.js"
+    },
+    "./astro-ox": {
+      "types": "./src/oxlint/index.d.ts",
+      "import": "./src/oxlint/oxlint.config.astro.js",
+      "default": "./src/oxlint/oxlint.config.astro.js"
+    },
     "./prettier-common": {
       "types": "./index.d.ts",
       "import": "./src/prettier/prettier.config.common.js",
       "default": "./src/prettier/prettier.config.common.js"
     },
+    "./oxfmt-common": {
+      "types": "./src/oxfmt/index.d.ts",
+      "import": "./src/oxfmt/oxfmt.config.common.js",
+      "default": "./src/oxfmt/oxfmt.config.common.js"
+    },
     "./prettier-svelte": {
       "types": "./index.d.ts",
       "import": "./src/prettier/prettier-svelte.config.js",
@@ -119,7 +154,12 @@
     "src",
     "scripts",
     "data",
-    "docs"
+    "docs",
+    "!scripts/fixtures",
+    "!scripts/*.test.mjs",
+    "!scripts/oxlint-*.mjs",
+    "!scripts/oxfmt-*.mjs",
+    "!scripts/package-smoke.mjs"
   ],
   "scripts": {
     "lint": "eslint . && stylelint \"src/**/*.{css,scss}\" --config ./src/stylelint/stylelint.config.scss.js --allow-empty-input && prettier --check .",
@@ -132,6 +172,14 @@
     "changelog:dry": "conventional-changelog -p conventionalcommits",
     "publish:npm": "npm publish --access public",
     "inventory": "node ./scripts/inventory.mjs",
+    "typecheck:ox": "node ./node_modules/@typescript/native/bin/tsc --noEmit",
+    "generate:ox": "node scripts/oxlint-generate.mjs",
+    "generate:ox:check": "node scripts/oxlint-generate.mjs --check",
+    "inventory:ox": "node scripts/oxlint-inventory.mjs --write",
+    "inventory:ox:check": "node scripts/oxlint-inventory.mjs --source-only --check && node scripts/oxlint-inventory.mjs --check",
+    "test:ox": "node --test --test-concurrency=2 scripts/oxlint-*.test.mjs",
+    "format:ox:compare": "node scripts/oxfmt-compare.mjs",
+    "format:ox:check": "oxfmt --config ./src/oxfmt/oxfmt.config.common.js --check .",
     "config:init": "node ./scripts/linter-init.mjs init --common --dir ./examples/init-smoke",
     "config:migrate": "node ./scripts/linter-init.mjs migrate --common --dir ./examples/init-smoke",
     "config:reinit": "node ./scripts/linter-init.mjs reinit --common --dir ./examples/init-smoke",
@@ -148,6 +196,9 @@
     "eslint-plugin-solid": "^0.18.0",
     "eslint-plugin-svelte": "^3.22.0",
     "next": "^16.3.0",
+    "oxlint": "1.86.0",
+    "oxfmt": "0.71.0",
+    "oxlint-tsgolint": "7.0.2003",
     "prettier": "^3.9.6",
     "prettier-plugin-astro": "^0.14.1",
     "prettier-plugin-svelte": "^4.1.1",
@@ -180,6 +231,15 @@
     "next": {
       "optional": true
     },
+    "oxlint": {
+      "optional": true
+    },
+    "oxfmt": {
+      "optional": true
+    },
+    "oxlint-tsgolint": {
+      "optional": true
+    },
     "astro": {
       "optional": true
     },
@@ -203,6 +263,8 @@
     }
   },
   "devDependencies": {
+    "@typescript/native": "npm:typescript@7.0.2",
+    "pnpm": "10.32.1",
     "@next/eslint-plugin-next": "^16.3.0",
     "@stylistic/eslint-plugin-migrate": "^4.4.1",
     "conventional-changelog": "^8.1.0",
@@ -213,6 +275,9 @@
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-solid": "^0.18.0",
     "eslint-plugin-svelte": "^3.22.0",
+    "oxlint": "1.86.0",
+    "oxfmt": "0.71.0",
+    "oxlint-tsgolint": "7.0.2003",
     "prettier-plugin-astro": "^0.14.1",
     "prettier-plugin-svelte": "^4.1.1",
     "solid-js": "^1.9.15",

package/scripts/README.md

@@ -41,10 +41,46 @@ npm exec @st1ggy/linter-config -- migrate --svelte
 npx --yes @st1ggy/linter-config init --astro
 ```
 
-- **Stack (optional, default common):** `--common` | `--react` | `--solid` | `--next` | `--svelte` | `--astro` (at most one).
+- **ESLint stacks:** `--common` | `--react` | `--solid` | `--next` | `--svelte` | `--astro`.
+- **Oxlint stacks:** `--common-ox` | `--react-ox` | `--solid-ox` | `--next-ox` | `--svelte-ox` | `--astro-ox`.
+- Select at most one stack; the default is `common`.
 - **`--skip-install`:** only write wrapper files; do not run npm/pnpm/yarn/bun.
 - Every CLI command opens an interactive wizard. `init` creates missing wrappers; `migrate` can remove selected legacy configs and replaces wrappers.
 
 Shell shortcuts in this folder (`init-common.sh`, etc.) call **`node …/linter-init.mjs`** (same script as the published **`@st1ggy/linter-config`** CLI) with the matching stack; pass **`--skip-install`** through when needed.
 
 For SolidJS, `init-solid.sh` selects `eslint-solid`, `prettier-common`, and `stylelint-scss`, and installs `eslint-plugin-solid` alongside `@st1ggy/linter-config`.
+
+## Oxlint wrappers
+
+The six `init-*-ox.sh` shortcuts select the corresponding `*-ox` stack. All write `oxlint.config.ts` and `stylelint.config.js`. Common/React/Solid/Next write `oxfmt.config.ts`; Svelte/Astro write `prettier.config.js`. The wizard pins `oxlint@1.86.0` and `oxlint-tsgolint@7.0.2003`, adds `oxfmt@0.71.0` to the four Oxfmt stacks, and installs only the selected framework integrations. Svelte projects provide their Svelte runtime; their formatter and ESLint-compatible script rules use it.
+
+```bash
+npx @st1ggy/linter-config init --react-ox
+npx @st1ggy/linter-config migrate --astro-ox
+node ./scripts/linter-init.mjs init --solid-ox --dir ./my-app --skip-install
+```
+
+`init` preserves existing wrappers, including the other linter/formatter config. `migrate` offers the opposite configs and old `.oxlintrc.*`/`.oxfmtrc.*` files for removal before generating the selected wrappers. It never deletes them without confirmation.
+
+For the four Oxfmt stacks, run `oxlint .` and `oxfmt --check .` separately. Their lint presets do not run Prettier's JS rule. `oxfmt --write .` formats after lint fixes; import and package.json sorting are disabled. The shared formatter options are available through `@st1ggy/linter-config/oxfmt-common`.
+
+Oxlint uses native TS7 for typed linting. The consumer tsconfig must be TS7-compatible; the generator does not modify it. Read the [usage guide](../README.md#oxlint-variants) and [coverage report](../docs/OXLINT_RULE_MAPPING.md) before switching a project with Svelte/Astro templates or TS parser-service-dependent JS rules.
+
+## Oxlint development checks
+
+```bash
+node scripts/oxlint-inventory.mjs --source-only
+npm run generate:ox
+npm run inventory:ox
+npm run generate:ox:check
+npm run inventory:ox:check
+npm run test:ox
+npm run format:ox:check
+npm run format:ox:compare
+npm run typecheck:ox
+node scripts/package-smoke.mjs
+node scripts/package-smoke.mjs --pm pnpm
+```
+
+The parity corpus asserts source and target diagnostics; guardrails reject missing mappings, option/severity drift, absent fixtures and unverified claims of complete SFC coverage. Inventory regeneration is deterministic and does not silently adopt new upstream rules: generated artifacts and fixtures must be reviewed together after dependency updates.

package/scripts/init-astro-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --astro-ox "$@"

package/scripts/init-common-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --common-ox "$@"

package/scripts/init-next-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --next-ox "$@"

package/scripts/init-react-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --react-ox "$@"

package/scripts/init-solid-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --solid-ox "$@"

package/scripts/init-svelte-ox.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --svelte-ox "$@"

package/scripts/linter-init-core.mjs

@@ -4,9 +4,13 @@ import { spawnSync } from 'node:child_process'
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import path from 'node:path'
 
+import { OXFMT_STACKS, OX_FRAMEWORK_PACKAGES, oxStackToolVersions } from '../src/oxlint/stacks.js'
+
 export const PACKAGE = '@st1ggy/linter-config'
 
-export const STACK_KEYS = ['common', 'react', 'solid', 'next', 'svelte', 'astro']
+const BASE_STACK_KEYS = ['common', 'react', 'solid', 'next', 'svelte', 'astro']
+
+export const STACK_KEYS = [...BASE_STACK_KEYS, ...BASE_STACK_KEYS.map((key) => `${key}-ox`)]
 
 export const STACKS = {
   common: {
@@ -74,6 +78,30 @@ export const STACK_CHOICES = [
   },
 ]
 
+for (const key of BASE_STACK_KEYS) {
+  const base = STACKS[key]
+
+  base.linterFile = 'eslint.config.js'
+  base.linterPreset = base.eslint
+  base.formatterFile = 'prettier.config.js'
+  base.formatterPreset = base.prettier
+  const hasOxfmt = OXFMT_STACKS.includes(key)
+
+  STACKS[`${key}-ox`] = {
+    linterFile: 'oxlint.config.ts',
+    linterPreset: `${key}-ox`,
+    prettier: base.prettier,
+    formatterFile: hasOxfmt ? 'oxfmt.config.ts' : 'prettier.config.js',
+    formatterPreset: hasOxfmt ? 'oxfmt-common' : base.prettier,
+    stylelint: base.stylelint,
+    packages: [...Object.keys(oxStackToolVersions(key)), ...OX_FRAMEWORK_PACKAGES[key]],
+  }
+  STACK_CHOICES.push({
+    value: `${key}-ox`,
+    name: `${key}-ox — Oxlint + native TypeScript 7 + ${hasOxfmt ? 'Oxfmt' : 'Prettier'}`,
+  })
+}
+
 export function readPackageJson(directory) {
   const filePath = path.join(directory, 'package.json')
 
@@ -103,7 +131,7 @@ export function isSelfPackageRoot(directory) {
   return packageJson?.name === PACKAGE
 }
 
-export function hasResolvablePackage(startDirectory, packageName = PACKAGE) {
+function packageManifestPath(startDirectory, packageName) {
   let currentDirectory = path.resolve(startDirectory)
   const packageParts = packageName.split('/')
 
@@ -111,7 +139,7 @@ export function hasResolvablePackage(startDirectory, packageName = PACKAGE) {
     const marker = path.join(currentDirectory, 'node_modules', ...packageParts, 'package.json')
 
     if (existsSync(marker)) {
-      return true
+      return marker
     }
 
     const parentDirectory = path.dirname(currentDirectory)
@@ -123,7 +151,25 @@ export function hasResolvablePackage(startDirectory, packageName = PACKAGE) {
     currentDirectory = parentDirectory
   }
 
-  return false
+  return null
+}
+
+export function hasResolvablePackage(startDirectory, packageName = PACKAGE) {
+  return packageManifestPath(startDirectory, packageName) !== null
+}
+
+function hasRequestedVersion(directory, packageName, spec) {
+  const marker = packageManifestPath(directory, packageName)
+
+  if (!marker) {
+    return false
+  }
+
+  try {
+    return JSON.parse(readFileSync(marker, 'utf8')).version === spec.split('@').at(-1)
+  } catch {
+    return false
+  }
 }
 
 export function detectPackageManager(startDirectory) {
@@ -170,7 +216,7 @@ export function runPmSync(command, args, cwd) {
 
 // skipInstall: skip npm install; options.quiet: suppress stderr warnings
 export function ensureDevDependencies(targetDirectory, packages, shouldSkipInstall, options = {}) {
-  const { quiet = false } = options
+  const { quiet = false, specs = {} } = options
 
   if (shouldSkipInstall) {
     return
@@ -197,7 +243,11 @@ export function ensureDevDependencies(targetDirectory, packages, shouldSkipInsta
   }
 
   const dependencies = mergedDependencies(packageJson)
-  const packagesToAdd = packages.filter((packageName) => !Object.hasOwn(dependencies, packageName))
+  const packagesToAdd = packages.filter(
+    (packageName) =>
+      !Object.hasOwn(dependencies, packageName) ||
+      (specs[packageName] && !hasRequestedVersion(directory, packageName, specs[packageName])),
+  )
   const hasUnresolvedPackage = packages.some((packageName) => !hasResolvablePackage(directory, packageName))
 
   if (!hasUnresolvedPackage && packagesToAdd.length === 0) {
@@ -223,15 +273,18 @@ export function ensureDevDependencies(targetDirectory, packages, shouldSkipInsta
     return
   }
 
+  const requested = packagesToAdd.map((name) => specs[name] ?? name)
+  const shouldPin = requested.some((name, index) => name !== packagesToAdd[index])
+
   if (!quiet) {
-    process.stdout.write(`install: ${pm} add -D ${packagesToAdd.join(' ')} (${directory})\n`)
+    process.stdout.write(`install: ${pm} add -D ${requested.join(' ')} (${directory})\n`)
   }
 
   const add = {
-    npm: () => runPmSync('npm', ['install', '-D', ...packagesToAdd], directory),
-    pnpm: () => runPmSync('pnpm', ['add', '-D', ...packagesToAdd], directory),
-    yarn: () => runPmSync('yarn', ['add', '-D', ...packagesToAdd], directory),
-    bun: () => runPmSync('bun', ['add', '-d', ...packagesToAdd], directory),
+    npm: () => runPmSync('npm', ['install', '-D', ...(shouldPin ? ['--save-exact'] : []), ...requested], directory),
+    pnpm: () => runPmSync('pnpm', ['add', '-D', ...(shouldPin ? ['--save-exact'] : []), ...requested], directory),
+    yarn: () => runPmSync('yarn', ['add', '-D', ...(shouldPin ? ['--exact'] : []), ...requested], directory),
+    bun: () => runPmSync('bun', ['add', '-d', ...(shouldPin ? ['--exact'] : []), ...requested], directory),
   }
 
   add[pm]()
@@ -251,6 +304,18 @@ export function stackPackages(stackKey) {
   return [PACKAGE, ...stack.packages]
 }
 
+export function stackPackageSpecs(stackKey) {
+  stackPackages(stackKey)
+
+  if (!stackKey.endsWith('-ox')) {
+    return {}
+  }
+
+  const versions = oxStackToolVersions(stackKey.slice(0, -3))
+
+  return Object.fromEntries(Object.entries(versions).map(([name, version]) => [name, `${name}@${version}`]))
+}
+
 export function printHelp() {
   process.stdout.write(`\
 ${PACKAGE} — generate local wrapper configs in a consumer project.
@@ -264,13 +329,16 @@ Commands:
   create   Alias for init.
 
 Writes (each command):
-  eslint.config.js, prettier.config.js, stylelint.config.js — re-exports for one stack.
+  ESLint stacks: eslint.config.js, prettier.config.js, stylelint.config.js.
+  common/react/solid/next-ox: oxlint.config.ts, oxfmt.config.ts, stylelint.config.js.
+  svelte/astro-ox: oxlint.config.ts, prettier.config.js, stylelint.config.js.
 
 Unless --skip-install: if package.json exists, runs the detected package manager to add or sync
 ${PACKAGE} and the selected stack's integration plugins.
 
 Stack (at most one; default: common):
   --common | --react | --solid | --next | --svelte | --astro
+  --common-ox | --react-ox | --solid-ox | --next-ox | --svelte-ox | --astro-ox
 
 Options:
   --dir, -d       Target directory (default: current working directory).
@@ -282,6 +350,7 @@ Examples (after: npm i -D ${PACKAGE}):
   npx ${PACKAGE} init
   npx ${PACKAGE} init --react
   npx ${PACKAGE} init --solid
+  npx ${PACKAGE} init --solid-ox
   npx ${PACKAGE} migrate --svelte --dir ./apps/web
   npx ${PACKAGE} init --astro
   npm exec ${PACKAGE} -- init --common
@@ -294,8 +363,8 @@ Repo (paths from root):
 `)
 }
 
-export function jsReExport(subpath) {
-  return `export { default } from '${PACKAGE}/${subpath}';\n`
+export function jsReExport(subpath, hasSemicolon = true) {
+  return `export { default } from '${PACKAGE}/${subpath}'${hasSemicolon ? ';' : ''}\n`
 }
 
 export function resolveTargetDirectory(raw) {
@@ -324,23 +393,28 @@ export function writeFile(targetDirectory, name, content, overwrite, options = {
   return true
 }
 
-export function wrapperFileNames() {
-  return ['eslint.config.js', 'prettier.config.js', 'stylelint.config.js']
+export function wrapperFileNames(stackKey = 'common') {
+  stackPackages(stackKey)
+
+  return [STACKS[stackKey].linterFile, STACKS[stackKey].formatterFile, 'stylelint.config.js']
 }
 
-export function existingWrapperFiles(targetDirectory) {
-  return wrapperFileNames().filter((name) => existsSync(path.join(targetDirectory, name)))
+export function existingWrapperFiles(targetDirectory, stackKey = 'common') {
+  return wrapperFileNames(stackKey).filter((name) => existsSync(path.join(targetDirectory, name)))
 }
 
-export function legacyConfigFiles(targetDirectory) {
+export function legacyConfigFiles(targetDirectory, stackKey = 'common') {
   if (!existsSync(targetDirectory)) {
     return []
   }
 
-  const wrappers = new Set(wrapperFileNames())
+  const wrappers = new Set(wrapperFileNames(stackKey))
 
   return readdirSync(targetDirectory, { withFileTypes: true })
-    .filter((entry) => entry.isFile() && /(?:eslint|prettier|stylelint)/i.test(entry.name) && !wrappers.has(entry.name))
+    .filter(
+      (entry) =>
+        entry.isFile() && /(?:eslint|oxlint|oxfmt|prettier|stylelint)/i.test(entry.name) && !wrappers.has(entry.name),
+    )
     .map((entry) => entry.name)
     .toSorted((left, right) => left.localeCompare(right))
 }
@@ -383,7 +457,13 @@ export function run(mode, targetDirectory, stackKey, options = {}) {
 
   const shouldOverwrite = mode === 'migrate' || mode === 'reinit'
 
-  writeFile(targetDirectory, 'eslint.config.js', jsReExport(stack.eslint), shouldOverwrite, { quiet })
-  writeFile(targetDirectory, 'prettier.config.js', jsReExport(stack.prettier), shouldOverwrite, { quiet })
-  writeFile(targetDirectory, 'stylelint.config.js', jsReExport(stack.stylelint), shouldOverwrite, { quiet })
+  const hasSemicolon = stack.formatterPreset !== 'oxfmt-common'
+
+  writeFile(targetDirectory, stack.linterFile, jsReExport(stack.linterPreset, hasSemicolon), shouldOverwrite, { quiet })
+  writeFile(targetDirectory, stack.formatterFile, jsReExport(stack.formatterPreset, hasSemicolon), shouldOverwrite, {
+    quiet,
+  })
+  writeFile(targetDirectory, 'stylelint.config.js', jsReExport(stack.stylelint, hasSemicolon), shouldOverwrite, {
+    quiet,
+  })
 }

package/scripts/linter-init.mjs

@@ -20,27 +20,15 @@ import {
   resolveStackKey,
   resolveTargetDirectory,
   run,
+  stackPackageSpecs,
   stackPackages,
+  wrapperFileNames,
 } from './linter-init-core.mjs'
 
 function parseArgv(argv) {
   return minimist(argv, {
     string: ['dir', 'd'],
-    boolean: [
-      'help',
-      'h',
-      'skip-install',
-      'eslint',
-      'biome',
-      'common',
-      'react',
-      'solid',
-      'next',
-      'svelte',
-      'astro',
-      'interactive',
-      'i',
-    ],
+    boolean: ['help', 'h', 'skip-install', 'eslint', 'biome', ...STACK_KEYS, 'interactive', 'i'],
     alias: {
       h: 'help',
       d: 'dir',
@@ -58,12 +46,7 @@ function argvToValues(argv) {
     'skip-install': Boolean(argv['skip-install']),
     eslint: Boolean(argv.eslint),
     biome: Boolean(argv.biome),
-    common: Boolean(argv.common),
-    react: Boolean(argv.react),
-    solid: Boolean(argv.solid),
-    next: Boolean(argv.next),
-    svelte: Boolean(argv.svelte),
-    astro: Boolean(argv.astro),
+    ...Object.fromEntries(STACK_KEYS.map((key) => [key, argv[key] === true])),
   }
 }
 
@@ -77,7 +60,7 @@ async function selectCommand(command) {
     choices: [
       {
         value: 'init',
-        name: 'init — create missing ESLint, Prettier and Stylelint wrappers',
+        name: 'init — create missing linter, formatter and Stylelint wrappers',
       },
       {
         value: 'migrate',
@@ -102,14 +85,14 @@ async function selectStack(values) {
   })
 }
 
-async function selectLegacyFiles(command, directory) {
+async function selectLegacyFiles(command, directory, stack) {
   if (command !== 'migrate') {
     return []
   }
 
   const selected = []
 
-  for (const file of legacyConfigFiles(directory)) {
+  for (const file of legacyConfigFiles(directory, stack)) {
     if (await confirm({ message: `Remove legacy config ${file}?`, default: false })) {
       selected.push(file)
     }
@@ -122,7 +105,7 @@ function printSummary(command, stack, directory, shouldSkipInstall, existing, fi
   const wrapperFiles =
     command === 'init' && existing.length > 0
       ? `create missing; keep ${existing.join(', ')}`
-      : 'write eslint.config.js, prettier.config.js, stylelint.config.js'
+      : `write ${wrapperFileNames(stack).join(', ')}`
 
   process.stdout.write('\n')
   process.stdout.write(`  Action:  ${command}\n`)
@@ -148,11 +131,20 @@ async function runInteractive(command, values) {
   }
 
   const shouldSkipInstall = values['skip-install'] === true
-  const existing = existingWrapperFiles(resolved)
-  const filesToRemove = await selectLegacyFiles(selectedCommand, resolved)
+  const existing = existingWrapperFiles(resolved, selectedStack)
+  const filesToRemove = await selectLegacyFiles(selectedCommand, resolved, selectedStack)
   const packages = stackPackages(selectedStack)
-
-  printSummary(selectedCommand, selectedStack, resolved, shouldSkipInstall, existing, filesToRemove, packages)
+  const specs = stackPackageSpecs(selectedStack)
+
+  printSummary(
+    selectedCommand,
+    selectedStack,
+    resolved,
+    shouldSkipInstall,
+    existing,
+    filesToRemove,
+    packages.map((name) => specs[name] ?? name),
+  )
 
   const shouldProceed = await confirm({
     message: 'Proceed?',
@@ -175,7 +167,7 @@ async function runInteractive(command, values) {
     }).start()
 
     try {
-      ensureDevDependencies(resolved, packages, false, { quiet: true })
+      ensureDevDependencies(resolved, packages, false, { quiet: true, specs })
       spinner.succeed(`${selectedStack} linting packages are available`)
     } catch (error) {
       spinner.fail('Dependency step failed')
@@ -185,7 +177,7 @@ async function runInteractive(command, values) {
 
   const writeSpinner = ora({
     color: 'green',
-    text: 'Writing eslint.config.js, prettier.config.js, stylelint.config.js…',
+    text: `Writing ${wrapperFileNames(selectedStack).join(', ')}…`,
   }).start()
 
   try {
@@ -213,7 +205,7 @@ function normalizeCommand(command) {
 function warnLegacyFlags(values) {
   if (values.biome === true) {
     process.stderr.write(
-      `warning: --biome is ignored; Biome presets were removed from ${PACKAGE}. Only ESLint, Prettier, and Stylelint wrappers are written.\n`,
+      `warning: --biome is ignored; Biome presets were removed from ${PACKAGE}. Select an ESLint or Oxlint stack.\n`,
     )
   }
 }

package/src/oxfmt/index.d.ts

@@ -0,0 +1,8 @@
+// Kept separate from the legacy declarations to make the formatter an optional peer.
+declare module '@st1ggy/linter-config/oxfmt-common' {
+  import type { OxfmtConfig } from 'oxfmt'
+
+  const config: OxfmtConfig
+
+  export default config
+}

package/src/oxfmt/oxfmt.config.common.js

@@ -0,0 +1,16 @@
+export default {
+  useTabs: false,
+  printWidth: 120,
+  tabWidth: 2,
+  semi: false,
+  singleQuote: true,
+  trailingComma: 'all',
+  bracketSpacing: true,
+  arrowParens: 'always',
+  proseWrap: 'never',
+  endOfLine: 'lf',
+  insertFinalNewline: true,
+  sortImports: false,
+  sortPackageJson: false,
+  ignorePatterns: ['**/node_modules/**', '**/.git/**'],
+}