@st1ggy/linter-config 6.3.2 → 7.2.2

package/docs/RULE_MAPPING.md

@@ -21,6 +21,7 @@ node scripts/inventory.mjs
 | React | `config.react.js` | React/JSX + hooks. |
 | Next.js | `config.next.js` | `@next/eslint-plugin-next`. |
 | Svelte | `svelte-stack.js` | `eslint-plugin-svelte` flat recommended + TS parser options. |
+| Astro | `astro-stack.js` | `eslint-plugin-astro` recommended. |
 
 Inventory rule counts (sample files in this repository):
 
@@ -28,6 +29,7 @@ Inventory rule counts (sample files in this repository):
 - `eslint-react`: includes React layer on the same sample
 - `eslint-next`: Next layer on the same sample
 - `eslint-svelte`: effective rules on `src/examples/example.svelte`
+- `eslint-astro`: effective rules on `src/examples/example.astro`
 
 ## Stylelint (SCSS preset)
 

package/index.d.ts

@@ -11,9 +11,11 @@ declare module '@st1ggy/linter-config' {
   export const eslintReact: Linter.Config[]
   export const eslintNext: Linter.Config[]
   export const eslintSvelte: Linter.Config[]
+  export const eslintAstro: Linter.Config[]
 
   export const prettierCommon: PrettierConfig
   export const prettierSvelte: PrettierConfig
+  export const prettierAstro: PrettierConfig
 
   export const stylelintScss: Stylelint.Config
 }
@@ -42,6 +44,14 @@ declare module '@st1ggy/linter-config/eslint-svelte' {
   export default config
 }
 
+declare module '@st1ggy/linter-config/eslint-astro' {
+  import type { Linter } from 'eslint'
+
+  const config: Linter.Config[]
+
+  export default config
+}
+
 declare module '@st1ggy/linter-config/eslint-common' {
   import type { Linter } from 'eslint'
 
@@ -66,6 +76,14 @@ declare module '@st1ggy/linter-config/prettier-svelte' {
   export default config
 }
 
+declare module '@st1ggy/linter-config/prettier-astro' {
+  import type { Config as PrettierConfig } from 'prettier'
+
+  const config: PrettierConfig
+
+  export default config
+}
+
 declare module '@st1ggy/linter-config/stylelint-scss' {
   import type * as Stylelint from 'stylelint'
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@st1ggy/linter-config",
-  "version": "6.3.2",
+  "version": "7.2.2",
   "description": "ESLint, Prettier, and Stylelint shareable configs (sources under src/).",
   "private": false,
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/st1ggy/linter-config.git"
+    "url": "https://github.com/St1ggy/linter-config.git"
   },
   "keywords": [
     "eslint",
@@ -22,41 +22,40 @@
     "@st1ggy/linter-config": "./scripts/linter-init.mjs"
   },
   "dependencies": {
-    "@eslint/compat": "^2.0.5",
+    "@eslint/compat": "^2.1.0",
+    "@eslint/config-helpers": "^0.7.0",
     "@eslint/js": "^10.0.1",
-    "@inquirer/core": "^10.3.2",
-    "@inquirer/prompts": "^7.10.1",
-    "@next/eslint-plugin-next": "^16.2.3",
+    "@inquirer/core": "^11.2.1",
+    "@inquirer/prompts": "^8.5.2",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "eslint": "^9.0.0 || ^10.0.0",
+    "eslint": "^10.8.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-custom-alias": "^1.3.2",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-import-x": "^4.16.2",
-    "eslint-plugin-prettier": "^5.5.5",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-sonarjs": "^4.0.2",
-    "eslint-plugin-svelte": "^3.17.0",
-    "eslint-plugin-unicorn": "^64.0.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-sonarjs": "^4.2.0",
+    "eslint-plugin-unicorn": "^73.0.0",
     "find-up-simple": "^1.0.1",
     "minimist": "^1.2.8",
-    "ora": "^8.2.0",
-    "prettier": "^3.0.0",
-    "prettier-plugin-svelte": "^3.5.1",
-    "stylelint": "^17.0.0",
-    "stylelint-config-clean-order": "^8.0.1",
+    "ora": "^9.4.1",
+    "prettier": "^3.9.6",
+    "stylelint": "^17.14.1",
+    "stylelint-config-clean-order": "^10.0.0",
     "stylelint-config-recommended": "^18.0.0",
     "stylelint-config-recommended-scss": "^17.0.1",
     "stylelint-config-sass-guidelines": "^13.0.0",
     "stylelint-no-unsupported-browser-features": "^8.1.1",
     "stylelint-order": "^8.1.1",
     "stylelint-prettier": "^5.0.3",
-    "typescript": "^6.0.2",
-    "typescript-eslint": "^8.58.1"
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.66.0"
   },
   "types": "./index.d.ts",
   "type": "module",
+  "engines": {
+    "node": ">=24.16.0"
+  },
   "sideEffects": false,
   "exports": {
     ".": {
@@ -79,6 +78,11 @@
       "import": "./src/eslint/eslint-svelte.config.js",
       "default": "./src/eslint/eslint-svelte.config.js"
     },
+    "./eslint-astro": {
+      "types": "./index.d.ts",
+      "import": "./src/eslint/eslint.config.astro.js",
+      "default": "./src/eslint/eslint.config.astro.js"
+    },
     "./eslint-common": {
       "types": "./index.d.ts",
       "import": "./src/eslint/eslint.config.common.js",
@@ -94,6 +98,11 @@
       "import": "./src/prettier/prettier-svelte.config.js",
       "default": "./src/prettier/prettier-svelte.config.js"
     },
+    "./prettier-astro": {
+      "types": "./index.d.ts",
+      "import": "./src/prettier/prettier-astro.config.js",
+      "default": "./src/prettier/prettier-astro.config.js"
+    },
     "./stylelint-scss": {
       "types": "./index.d.ts",
       "import": "./src/stylelint/stylelint.config.scss.js",
@@ -119,28 +128,61 @@
     "publish:npm": "npm publish --access public",
     "inventory": "node ./scripts/inventory.mjs",
     "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",
     "config:create": "node ./scripts/linter-init.mjs create --common --dir ./examples/init-smoke",
     "config:remove-current": "bash ./scripts/remove-current.sh"
   },
   "peerDependencies": {
-    "eslint": "^9.0.0 || ^10.0.0",
-    "next": "^16.0.0",
-    "prettier": "^3.0.0",
+    "astro": ">=4.0.0",
+    "eslint": "^10.8.0",
+    "eslint-plugin-astro": "^3.1.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-svelte": "^3.22.0",
+    "next": "^16.3.0",
+    "prettier": "^3.9.6",
+    "prettier-plugin-astro": "^0.14.1",
+    "prettier-plugin-svelte": "^4.1.1",
     "react": "^18.0.0 || ^19.0.0",
-    "stylelint": "^17.0.0",
+    "stylelint": "^17.14.1",
     "svelte": "^4.0.0 || ^5.0.0"
   },
   "peerDependenciesMeta": {
     "eslint": {
       "optional": true
     },
+    "eslint-plugin-astro": {
+      "optional": true
+    },
+    "eslint-plugin-jsx-a11y": {
+      "optional": true
+    },
+    "eslint-plugin-react": {
+      "optional": true
+    },
+    "eslint-plugin-react-hooks": {
+      "optional": true
+    },
+    "eslint-plugin-svelte": {
+      "optional": true
+    },
     "next": {
       "optional": true
     },
+    "astro": {
+      "optional": true
+    },
     "prettier": {
       "optional": true
     },
+    "prettier-plugin-astro": {
+      "optional": true
+    },
+    "prettier-plugin-svelte": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -152,8 +194,17 @@
     }
   },
   "devDependencies": {
+    "@next/eslint-plugin-next": "^16.3.0",
     "@stylistic/eslint-plugin-migrate": "^4.4.1",
-    "conventional-changelog-cli": "^5.0.0",
-    "conventional-changelog-conventionalcommits": "^9.0.0"
+    "conventional-changelog": "^8.1.0",
+    "conventional-changelog-conventionalcommits": "^10.2.1",
+    "eslint-plugin-astro": "^3.1.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-svelte": "^3.22.0",
+    "prettier-plugin-astro": "^0.14.1",
+    "prettier-plugin-svelte": "^4.1.1",
+    "svelte": "^5.56.8"
   }
 }

package/scripts/README.md

@@ -2,23 +2,25 @@
 
 From this repository root, use the npm scripts in the root [`package.json`](../package.json). They run **`node ./scripts/linter-init.mjs`** against **[`examples/init-smoke`](../examples/init-smoke)** so we never write consumer stubs into the **`@st1ggy/linter-config`** package root (the CLI blocks that).
 
-| Script                  | Effect                                                                                  |
-| ----------------------- | --------------------------------------------------------------------------------------- |
-| `npm run config:init`   | `init` — create missing `eslint.config.js`, `prettier.config.js`, `stylelint.config.js` |
-| `npm run config:reinit` | `reinit` — overwrite those three files                                                  |
-| `npm run config:create` | same as `config:init`                                                                   |
+| Script                   | Effect                                                                                  |
+| ------------------------ | --------------------------------------------------------------------------------------- |
+| `npm run config:init`    | `init` — create missing `eslint.config.js`, `prettier.config.js`, `stylelint.config.js` |
+| `npm run config:migrate` | `migrate` — optionally remove legacy configs, then overwrite the three wrappers         |
+| `npm run config:reinit`  | alias for `config:migrate`                                                              |
+| `npm run config:create`  | same as `config:init`                                                                   |
 
-Each run installs **`@st1ggy/linter-config`** into `examples/init-smoke` when needed (unless you add **`--skip-install`** to the underlying command in `package.json`).
+Each run installs **`@st1ggy/linter-config`** and only the selected stack's integration plugins into `examples/init-smoke` when needed (unless you add **`--skip-install`** to the underlying command in `package.json`).
 
 ### Legacy config cleanup (optional)
 
-**`reinit`** only overwrites `eslint.config.js`, `prettier.config.js`, and `stylelint.config.js`. It does **not** call [`remove-current.sh`](remove-current.sh): that script is **interactive** (prompts per file) and is meant for one-off migration when old filenames still sit next to the new wrappers. From the repo root: **`npm run config:remove-current`** (runs `bash ./scripts/remove-current.sh` in the current shell cwd — run from the directory you want to clean, or `cd` there first).
+**`migrate`** presents every legacy config file for confirmation before it overwrites `eslint.config.js`, `prettier.config.js`, and `stylelint.config.js`. [`remove-current.sh`](remove-current.sh) remains available as a standalone cleanup helper. From the repo root: **`npm run config:remove-current`**.
 
 Direct CLI (paths from repo root — same entry as published **`@st1ggy/linter-config`**):
 
 ```bash
 node ./scripts/linter-init.mjs init --react
-node ./scripts/linter-init.mjs reinit --svelte --dir ./my-app
+node ./scripts/linter-init.mjs migrate --svelte --dir ./my-app
+node ./scripts/linter-init.mjs init --astro
 ```
 
 ## Flags (published package)
@@ -28,16 +30,17 @@ The CLI is published under the name **`@st1ggy/linter-config`** (see [`package.j
 ```bash
 npx @st1ggy/linter-config init --common
 npx @st1ggy/linter-config init --next
-npm exec @st1ggy/linter-config -- reinit --svelte
+npm exec @st1ggy/linter-config -- migrate --svelte
 ```
 
 **Without** installing first:
 
 ```bash
-npx --yes @st1ggy/linter-config init --react
+npx --yes @st1ggy/linter-config init --astro
 ```
 
-- **Stack (optional, default common):** `--common` | `--react` | `--next` | `--svelte` (at most one).
+- **Stack (optional, default common):** `--common` | `--react` | `--next` | `--svelte` | `--astro` (at most one).
 - **`--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.

package/scripts/init-astro.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# See init-common.sh — same as npx @st1ggy/linter-config, stack --astro.
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --astro "$@"

package/scripts/inventory.mjs

@@ -3,7 +3,7 @@
 // Or set `LINTER_CONFIG_ROOT` to override the default (repository root).
 
 import { spawnSync } from 'node:child_process'
-import { mkdirSync, writeFileSync } from 'node:fs'
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import path from 'node:path'
 import process from 'node:process'
@@ -12,7 +12,8 @@ import { fileURLToPath } from 'node:url'
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const LINTER_ROOT = process.env.LINTER_CONFIG_ROOT ?? path.resolve(__dirname, '..')
 
-const SOURCE_LABEL = '@st1ggy/linter-config@6.3.2 (local tree)'
+const packageJson = JSON.parse(readFileSync(path.join(LINTER_ROOT, 'package.json'), 'utf8'))
+const SOURCE_LABEL = `${packageJson.name}@${packageJson.version} (local tree)`
 
 const flatConfigPresets = [
   {
@@ -35,6 +36,11 @@ const flatConfigPresets = [
     module: 'src/eslint/eslint-svelte.config.js',
     sampleFile: 'src/examples/example.svelte',
   },
+  {
+    id: 'eslint-astro',
+    module: 'src/eslint/eslint.config.astro.js',
+    sampleFile: 'src/examples/example.astro',
+  },
 ]
 
 function compareKeysAlphabetically(left, right) {
@@ -99,6 +105,7 @@ async function inventoryFlatConfigs() {
     const engine = new ESLint({
       cwd: LINTER_ROOT,
       overrideConfig: config,
+      overrideConfigFile: true,
     })
     const filePath = path.join(LINTER_ROOT, preset.sampleFile)
     const calculated = await engine.calculateConfigForFile(filePath)

package/scripts/linter-init-core.mjs

@@ -1,33 +1,43 @@
 // Shared logic for @st1ggy/linter-config CLI (no prompts).
 
 import { spawnSync } from 'node:child_process'
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import path from 'node:path'
 
 export const PACKAGE = '@st1ggy/linter-config'
 
-export const STACK_KEYS = ['common', 'react', 'next', 'svelte']
+export const STACK_KEYS = ['common', 'react', 'next', 'svelte', 'astro']
 
 export const STACKS = {
   common: {
     eslint: 'eslint-common',
     prettier: 'prettier-common',
     stylelint: 'stylelint-scss',
+    packages: [],
   },
   react: {
     eslint: 'eslint-react',
     prettier: 'prettier-common',
     stylelint: 'stylelint-scss',
+    packages: ['eslint-plugin-react', 'eslint-plugin-react-hooks'],
   },
   next: {
     eslint: 'eslint-next',
     prettier: 'prettier-common',
     stylelint: 'stylelint-scss',
+    packages: ['@next/eslint-plugin-next', 'eslint-plugin-react', 'eslint-plugin-react-hooks'],
   },
   svelte: {
     eslint: 'eslint-svelte',
     prettier: 'prettier-svelte',
     stylelint: 'stylelint-scss',
+    packages: ['eslint-plugin-svelte', 'prettier-plugin-svelte'],
+  },
+  astro: {
+    eslint: 'eslint-astro',
+    prettier: 'prettier-astro',
+    stylelint: 'stylelint-scss',
+    packages: ['eslint-plugin-astro', 'eslint-plugin-jsx-a11y', 'prettier-plugin-astro'],
   },
 }
 
@@ -48,6 +58,10 @@ export const STACK_CHOICES = [
     value: 'svelte',
     name: 'svelte — Svelte + Prettier plugin for Svelte',
   },
+  {
+    value: 'astro',
+    name: 'astro — Astro + Prettier plugin for Astro',
+  },
 ]
 
 export function readPackageJson(directory) {
@@ -64,7 +78,7 @@ export function readPackageJson(directory) {
   }
 }
 
-export function mergedDeps(packageJson) {
+export function mergedDependencies(packageJson) {
   return {
     ...packageJson.optionalDependencies,
     ...packageJson.peerDependencies,
@@ -79,11 +93,12 @@ export function isSelfPackageRoot(directory) {
   return packageJson?.name === PACKAGE
 }
 
-export function hasResolvablePackage(startDirectory) {
+export function hasResolvablePackage(startDirectory, packageName = PACKAGE) {
   let currentDirectory = path.resolve(startDirectory)
+  const packageParts = packageName.split('/')
 
   while (true) {
-    const marker = path.join(currentDirectory, 'node_modules', '@st1ggy', 'linter-config', 'package.json')
+    const marker = path.join(currentDirectory, 'node_modules', ...packageParts, 'package.json')
 
     if (existsSync(marker)) {
       return true
@@ -144,10 +159,10 @@ export function runPmSync(command, args, cwd) {
 }
 
 // skipInstall: skip npm install; options.quiet: suppress stderr warnings
-export function ensureDevDependency(targetDirectory, skipInstall, options = {}) {
+export function ensureDevDependencies(targetDirectory, packages, shouldSkipInstall, options = {}) {
   const { quiet = false } = options
 
-  if (skipInstall) {
+  if (shouldSkipInstall) {
     return
   }
 
@@ -158,29 +173,32 @@ export function ensureDevDependency(targetDirectory, skipInstall, options = {})
   if (!existsSync(packageJsonPath)) {
     if (!quiet) {
       process.stderr.write(
-        `warning: no package.json in ${directory}; add the dependency manually: npm i -D ${PACKAGE}\n`,
+        `warning: no package.json in ${directory}; add the packages manually: npm i -D ${packages.join(' ')}\n`,
       )
     }
 
     return
   }
 
-  if (hasResolvablePackage(directory)) {
+  const packageJson = readPackageJson(directory)
+
+  if (!packageJson) {
     return
   }
 
-  const packageJson = readPackageJson(directory)
+  const dependencies = mergedDependencies(packageJson)
+  const packagesToAdd = packages.filter((packageName) => !Object.hasOwn(dependencies, packageName))
+  const hasUnresolvedPackage = packages.some((packageName) => !hasResolvablePackage(directory, packageName))
 
-  if (!packageJson) {
+  if (!hasUnresolvedPackage && packagesToAdd.length === 0) {
     return
   }
 
   const pm = detectPackageManager(directory)
-  const listed = Boolean(mergedDeps(packageJson)[PACKAGE])
 
-  if (listed) {
+  if (packagesToAdd.length === 0) {
     if (!quiet) {
-      process.stdout.write(`install: ${pm} install (${directory}) — dependency already listed\n`)
+      process.stdout.write(`install: ${pm} install (${directory}) — selected packages already listed\n`)
     }
 
     const sync = {
@@ -196,53 +214,69 @@ export function ensureDevDependency(targetDirectory, skipInstall, options = {})
   }
 
   if (!quiet) {
-    process.stdout.write(`install: ${pm} add -D ${PACKAGE} (${directory})\n`)
+    process.stdout.write(`install: ${pm} add -D ${packagesToAdd.join(' ')} (${directory})\n`)
   }
 
   const add = {
-    npm: () => runPmSync('npm', ['install', '-D', PACKAGE], directory),
-    pnpm: () => runPmSync('pnpm', ['add', '-D', PACKAGE], directory),
-    yarn: () => runPmSync('yarn', ['add', '-D', PACKAGE], directory),
-    bun: () => runPmSync('bun', ['add', '-d', PACKAGE], directory),
+    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),
   }
 
   add[pm]()
 }
 
+export function ensureDevDependency(targetDirectory, shouldSkipInstall, options = {}) {
+  ensureDevDependencies(targetDirectory, [PACKAGE], shouldSkipInstall, options)
+}
+
+export function stackPackages(stackKey) {
+  const stack = STACKS[stackKey]
+
+  if (!stack) {
+    throw new Error(`Unknown stack "${stackKey}". Use: ${STACK_KEYS.join(', ')}`)
+  }
+
+  return [PACKAGE, ...stack.packages]
+}
+
 export function printHelp() {
   process.stdout.write(`\
 ${PACKAGE} — generate local wrapper configs in a consumer project.
 
-With no command in an interactive terminal, opens a guided menu (or pass -i / --interactive).
+Always opens a guided menu in an interactive terminal. Stack flags preselect a choice.
 
 Commands:
   init     Create missing files only (skip existing).
-  reinit   Overwrite selected files.
-  create   Same as init.
+  migrate  Optionally remove legacy configs, then overwrite wrapper files.
+  reinit   Alias for migrate.
+  create   Alias for init.
 
 Writes (each command):
   eslint.config.js, prettier.config.js, stylelint.config.js — re-exports for one stack.
 
-Unless --skip-install: if package.json exists and ${PACKAGE} is not yet resolvable from node_modules
-(walking up to the filesystem root), runs the detected package manager to add or sync the dependency.
+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 | --next | --svelte
+  --common | --react | --next | --svelte | --astro
 
 Options:
   --dir, -d       Target directory (default: current working directory).
   --skip-install  Do not run npm/pnpm/yarn/bun (only write wrapper files).
-  -i, --interactive  Open the menu even when a command is passed (experimental).
+  -i, --interactive  Accepted for compatibility; the menu is always interactive.
 
 Examples (after: npm i -D ${PACKAGE}):
   npx ${PACKAGE}
   npx ${PACKAGE} init
   npx ${PACKAGE} init --react
-  npx ${PACKAGE} reinit --svelte --dir ./apps/web
+  npx ${PACKAGE} migrate --svelte --dir ./apps/web
+  npx ${PACKAGE} init --astro
   npm exec ${PACKAGE} -- init --common
 
 Without prior install (downloads this package; then runs the same CLI):
-  npx --yes ${PACKAGE} init --common
+  npx --yes ${PACKAGE} init --astro
 
 Repo (paths from root):
   node scripts/linter-init.mjs init --common
@@ -279,6 +313,33 @@ 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 existingWrapperFiles(targetDirectory) {
+  return wrapperFileNames().filter((name) => existsSync(path.join(targetDirectory, name)))
+}
+
+export function legacyConfigFiles(targetDirectory) {
+  if (!existsSync(targetDirectory)) {
+    return []
+  }
+
+  const wrappers = new Set(wrapperFileNames())
+
+  return readdirSync(targetDirectory, { withFileTypes: true })
+    .filter((entry) => entry.isFile() && /(?:eslint|prettier|stylelint)/i.test(entry.name) && !wrappers.has(entry.name))
+    .map((entry) => entry.name)
+    .toSorted((left, right) => left.localeCompare(right))
+}
+
+export function removeFiles(targetDirectory, names) {
+  for (const name of names) {
+    rmSync(path.join(targetDirectory, name), { force: true })
+  }
+}
+
 export function resolveStackKey(values) {
   const chosen = []
 
@@ -309,9 +370,9 @@ export function run(mode, targetDirectory, stackKey, options = {}) {
     throw new Error(`Unknown stack "${stackKey}". Use: ${STACK_KEYS.join(', ')}`)
   }
 
-  const overwrite = mode === 'reinit'
+  const shouldOverwrite = mode === 'migrate' || mode === 'reinit'
 
-  writeFile(targetDirectory, 'eslint.config.js', jsReExport(stack.eslint), overwrite, { quiet })
-  writeFile(targetDirectory, 'prettier.config.js', jsReExport(stack.prettier), overwrite, { quiet })
-  writeFile(targetDirectory, 'stylelint.config.js', jsReExport(stack.stylelint), overwrite, { quiet })
+  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 })
 }