@st1ggy/linter-config 4.0.0 → 6.3.0

package/README.md

@@ -1,11 +1,6 @@
 # st1ggy/linter-config
 
-Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Sources live in two workspace folders:
-
-| Path | Contents |
-| --- | --- |
-| [`packages/eslint`](packages/eslint) | ESLint, Prettier, Stylelint configs |
-| [`packages/biome`](packages/biome) | Biome JSON presets and [`docs/README.md`](packages/biome/docs/README.md) |
+Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Config sources live under [`src/`](src/) (ESLint, Prettier, Stylelint).
 
 Install once:
 
@@ -13,66 +8,69 @@ Install once:
 npm i -D @st1ggy/linter-config
 ```
 
-Add **`@biomejs/biome`** when you use Biome presets. Add **`eslint`**, **`prettier`**, **`stylelint`**, and framework peers only for the stacks you use (see `peerDependencies` in [`package.json`](package.json)).
+Add **`eslint`**, **`prettier`**, **`stylelint`**, and framework peers only for the stacks you use (see `peerDependencies` in [`package.json`](package.json)).
 
 ### Generate local wrapper configs
 
-The package exposes the **`linter-config`** CLI (see [`package.json`](package.json) `bin`). After `npm i -D @st1ggy/linter-config`, run it via `npx linter-config` or `npm exec linter-config` (or `npx --yes --package @st1ggy/linter-config linter-config …` without a prior install).
-
-Pick **at least one** of:
+The published CLI is invoked as **`@st1ggy/linter-config`** (see [`package.json`](package.json) `bin`). Each run writes **`eslint.config.js`**, **`prettier.config.js`**, and **`stylelint.config.js`** as ESM re-exports for one stack.
 
-- **`--eslint`** — writes `eslint.config.js`, `prettier.config.js`, and `stylelint.config.js` (Prettier and Stylelint are part of this bundle).
-- **`--biome`** — writes `biome.json`.
+Unless **`--skip-install`** is passed: if **`package.json`** exists in the target directory and **`@st1ggy/linter-config`** is not yet resolvable from **`node_modules`** (search walks up to the filesystem root, for hoisted monorepos), the CLI runs the detected package manager (**npm** / **pnpm** / **yarn** / **bun** from the nearest lockfile) to **`add -D @st1ggy/linter-config`** or **`install`** when the dependency is already listed but `node_modules` is missing.
 
 Pick **at most one** stack flag (default **`--common`** if you omit all four):
 
 **`--common` · `--react` · `--next` · `--svelte`**
 
-The same stack key selects matching ESLint / Prettier / Stylelint / Biome subpaths from this package.
+**After** `npm i -D @st1ggy/linter-config`:
+
+```bash
+npx @st1ggy/linter-config init
+npx @st1ggy/linter-config init --react
+npx @st1ggy/linter-config reinit --svelte --dir ./apps/web
+npm exec @st1ggy/linter-config -- init --common
+```
+
+**Without** installing the dependency first (`npx` will fetch **`@st1ggy/linter-config`**):
 
 ```bash
-npx linter-config init --biome --svelte
-npx linter-config init --eslint --common
-npx linter-config init --eslint --biome --next
-npx linter-config reinit --eslint --react --dir ./apps/web
+npx --yes @st1ggy/linter-config init
+npx --yes @st1ggy/linter-config init --react
+npx --yes @st1ggy/linter-config reinit --svelte --dir ./apps/web
 ```
 
+Older **`--eslint`** on the command line is still accepted for compatibility; **`--eslint`** is optional.
+
 - **`init` / `create`** — create only missing files (skip existing).
-- **`reinit`** — overwrite only the files implied by your flags (for example `--eslint` refreshes the three JS configs; `--biome` refreshes `biome.json`).
+- **`reinit`** — overwrite the three wrapper configs (same names; nothing to delete first).
+
+**Legacy filenames** (`.eslintrc.*`, `prettier.config.cjs`, extra copies, …) are **not** removed by `init` / `reinit`. For an **interactive** cleanup in the project root, use [`scripts/remove-current.sh`](scripts/remove-current.sh) (published inside the package under `scripts/`). In this repo: `npm run config:remove-current`. Run it **before** `init` / `reinit` if you need to drop stray configs; it is intentionally **not** wired into `reinit` so CI stays non-interactive.
 
 Your project should use **`"type": "module"`** (or `.mjs` config filenames) so the generated ESM re-exports load.
 
-In this monorepo, `npm run config:init`, `config:reinit`, and `config:create` run **`--eslint --biome --common`** (see [`scripts/README.md`](scripts/README.md)).
+In this monorepo, `npm run config:init` / `config:reinit` / `config:create` run **`node ./scripts/linter-init.mjs … --dir ./examples/init-smoke`** (see [`scripts/README.md`](scripts/README.md)). The CLI **refuses** to write consumer stubs in the package root (`package.json` name `@st1ggy/linter-config`) so this repository’s dev configs are not overwritten.
 
 ## Subpath imports
 
-**ESLint / Prettier / Stylelint**
-
 ```js
 import eslintReact from '@st1ggy/linter-config/eslint-react'
 import prettierCommon from '@st1ggy/linter-config/prettier-common'
 import stylelintScss from '@st1ggy/linter-config/stylelint-scss'
 ```
 
-**Biome** (extend from your `biome.json`)
-
-Use package subpaths such as `@st1ggy/linter-config/biome-common`, `@st1ggy/linter-config/biome-react`, `@st1ggy/linter-config/biome-next`, `@st1ggy/linter-config/biome-svelte`, or the root Biome entry `@st1ggy/linter-config/biome`.
-
-The barrel export `@st1ggy/linter-config` re-exports ESLint/Prettier/Stylelint presets only (see [`packages/eslint/src/index.js`](packages/eslint/src/index.js)).
+The barrel export `@st1ggy/linter-config` re-exports ESLint/Prettier/Stylelint presets only (see [`src/index.js`](src/index.js)).
 
 ### Migration (Stylelint)
 
 If you previously used Stylelint 16 with this preset, upgrade the consumer to **Stylelint 17** before depending on the latest release.
 
-### Migration (`@st1ggy/biome-config` npm package)
+### Migration from Biome presets
 
-If you depended on the separate **`@st1ggy/biome-config`** package, switch to **`@st1ggy/linter-config`** with the same subpath names (`biome-common`, etc.).
+**v6** removes all **`@st1ggy/linter-config/biome`** and **`biome-*`** subpath exports. Use [Biome](https://biomejs.dev/) in your project directly with its own `biome.json`, or stay on ESLint + Prettier + Stylelint via this package.
 
 ### Development of this package
 
 `npm install` uses [`.npmrc`](.npmrc) `legacy-peer-deps=true` (see earlier notes on `eslint-import-resolver-custom-alias`).
 
-**Publishing:** this repo’s **root** `package.json` is the published `@st1ggy/linter-config`. From the repository root:
+**Publishing:** this repo’s **root** `package.json` is the published `@st1ggy/linter-config`:
 
 ```bash
 npm run publish:npm
@@ -82,7 +80,7 @@ npm run publish:npm
 
 ## Toolchain (this repo)
 
-There is **one** published package (`@st1ggy/linter-config` at the repo root). Folders `packages/eslint` and `packages/biome` are **npm workspaces** used only for development—they are not published on their own.
+There is **one** published package at the **repository root** (no `packages/` workspace layout).
 
 ```bash
 npm install
@@ -93,20 +91,16 @@ npm run lint
 
 | Command | What it runs |
 | --- | --- |
-| `npm run lint` | Full check: ESLint stack in `packages/eslint`, then Biome in `packages/biome` |
-| `npm run lint:eslint` | `packages/eslint`: ESLint + Stylelint + Prettier check |
-| `npm run lint:stylelint` | `packages/eslint`: Stylelint only |
-| `npm run lint:prettier` | `packages/eslint`: Prettier `--check` only |
-| `npm run lint:biome` | `packages/biome`: `biome ci` |
-| `npm run lint:fix` | Auto-fix ESLint/Stylelint/Prettier in `packages/eslint`, then Biome `--write` in `packages/biome` |
-| `npm run lint:fix:eslint` | Fix only the ESLint workspace |
-| `npm run lint:fix:biome` | Fix only the Biome workspace |
-| `npm run inventory` | Regenerate `packages/eslint/data/linter-config-inventory.json` |
-| `npm run config:init` | `linter-config init --eslint --biome --common` (skip existing); see [`scripts/README.md`](scripts/README.md) |
-| `npm run config:reinit` | `reinit` with the same flags (overwrite) |
-| `npm run config:create` | Same as `config:init` (alternate script name) |
-
-Inside a workspace you can also run the same scripts locally, e.g. `npm run lint --workspace=packages/eslint` or `cd packages/biome && npm run lint`.
+| `npm run lint` | ESLint + Stylelint (`src/**/*.scss` / `.css`) + Prettier check |
+| `npm run lint:eslint` | ESLint only |
+| `npm run lint:stylelint` | Stylelint only |
+| `npm run lint:prettier` | Prettier `--check` only |
+| `npm run lint:fix` | Auto-fix ESLint, Stylelint, Prettier |
+| `npm run inventory` | Regenerate [`data/linter-config-inventory.json`](data/linter-config-inventory.json) |
+| `npm run config:init` | `node ./scripts/linter-init.mjs init --common --dir ./examples/init-smoke` (skip existing); see [`scripts/README.md`](scripts/README.md) |
+| `npm run config:reinit` | same target, overwrite |
+| `npm run config:create` | same as `config:init` |
+| `npm run config:remove-current` | interactive: offer to delete `*eslint*` / `*stylelint*` / `*prettier*` files in cwd (see [scripts/remove-current.sh](scripts/remove-current.sh)) |
 
 ## Optional ESLint add-ons
 

package/{packages/eslint/data → data}/linter-config-inventory.json

@@ -1,7 +1,7 @@
 {
-  "generatedAt": "2026-04-10T19:07:41.124Z",
-  "source": "@st1ggy/linter-config@4.0.0 (local tree)",
-  "linterConfigRoot": "/Users/dnbragin/Projects/personal/linter-config/packages/eslint",
+  "generatedAt": "2026-04-10T20:01:50.950Z",
+  "source": "@st1ggy/linter-config@6.3.0 (local tree)",
+  "linterConfigRoot": "/Users/dnbragin/Projects/personal/linter-config",
   "flatConfigs": {
     "eslint-common": {
       "module": "src/eslint/eslint.config.common.js",

package/docs/RULE_MAPPING.md

@@ -0,0 +1,38 @@
+# Preset layers (`@st1ggy/linter-config`)
+
+This document is the **high-level matrix** of how flat-config and Stylelint presets are layered. The machine-readable inventory (every flat-config rule id and Stylelint rule name with effective severity for sample files) lives in [`../data/linter-config-inventory.json`](../data/linter-config-inventory.json). Regenerate it from a checkout of this repo with:
+
+```bash
+node scripts/inventory.mjs
+```
+
+(`LINTER_CONFIG_ROOT` overrides the default repository root.)
+
+## Flat-config layers
+
+| Layer | `@st1ggy/linter-config` preset | Notes |
+| --- | --- | --- |
+| Base + stylistic | `eslint-common` (`config.common.js`, `@eslint/js` recommended, `@stylistic` all + overrides) | Foundation for TS/JS. |
+| TypeScript | `config.typescript.js` | typescript-eslint integration. |
+| Imports | `config.import.js` (import-x) | Resolver and import ordering. |
+| Prettier-in-ESLint | `config.prettier.js` | eslint-plugin-prettier + config-prettier. |
+| Unicorn | `config.unicorn.js` | eslint-plugin-unicorn. |
+| SonarJS | `config.sonarjs.js` | eslint-plugin-sonarjs. |
+| 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. |
+
+Inventory rule counts (sample files in this repository):
+
+- `eslint-common`: effective rules on `src/examples/example.ts`
+- `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`
+
+## Stylelint (SCSS preset)
+
+| Layer | `@st1ggy/linter-config` | Notes |
+| --- | --- | --- |
+| SCSS stack | `stylelint.config.scss.js` (recommended + scss + sass-guidelines + clean-order + plugins) | Full Stylelint stack for SCSS. |
+
+Inventory: Stylelint rule entries after `extends` resolution on `src/examples/example.scss`.

package/index.d.ts

@@ -57,35 +57,3 @@ declare module '@st1ggy/linter-config/stylelint-scss' {
 
   export default config
 }
-
-type BiomeJsonConfig = Record<string, unknown>
-
-declare module '@st1ggy/linter-config/biome' {
-  const config: BiomeJsonConfig
-
-  export default config
-}
-
-declare module '@st1ggy/linter-config/biome-common' {
-  const config: BiomeJsonConfig
-
-  export default config
-}
-
-declare module '@st1ggy/linter-config/biome-react' {
-  const config: BiomeJsonConfig
-
-  export default config
-}
-
-declare module '@st1ggy/linter-config/biome-next' {
-  const config: BiomeJsonConfig
-
-  export default config
-}
-
-declare module '@st1ggy/linter-config/biome-svelte' {
-  const config: BiomeJsonConfig
-
-  export default config
-}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@st1ggy/linter-config",
-  "version": "4.0.0",
-  "description": "ESLint, Prettier, Stylelint, and Biome shareable configs (sources in packages/eslint and packages/biome).",
+  "version": "6.3.0",
+  "description": "ESLint, Prettier, and Stylelint shareable configs (sources under src/).",
   "private": false,
   "repository": {
     "type": "git",
@@ -10,8 +10,7 @@
   "keywords": [
     "eslint",
     "prettier",
-    "stylelint",
-    "biome"
+    "stylelint"
   ],
   "author": "Dmitrii Bragin (st1ggy)",
   "license": "Apache-2.0",
@@ -20,14 +19,16 @@
   },
   "homepage": "https://github.com/St1ggy/linter-config/tree/main#readme",
   "bin": {
-    "linter-config": "./packages/eslint/scripts/linter-init.mjs"
+    "@st1ggy/linter-config": "./scripts/linter-init.mjs"
   },
   "dependencies": {
-    "@next/eslint-plugin-next": "^16.2.3",
     "@eslint/compat": "^2.0.5",
     "@eslint/js": "^10.0.1",
+    "@inquirer/core": "^10.3.2",
+    "@inquirer/prompts": "^7.10.1",
+    "@next/eslint-plugin-next": "^16.2.3",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "eslint": "^10.2.0",
+    "eslint": "^9.0.0 || ^10.0.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-custom-alias": "^1.3.2",
     "eslint-import-resolver-typescript": "^4.4.4",
@@ -39,9 +40,11 @@
     "eslint-plugin-svelte": "^3.17.0",
     "eslint-plugin-unicorn": "^64.0.0",
     "find-up-simple": "^1.0.1",
-    "prettier": "^3.8.2",
+    "minimist": "^1.2.8",
+    "ora": "^8.2.0",
+    "prettier": "^3.0.0",
     "prettier-plugin-svelte": "^3.5.1",
-    "stylelint": "^17.6.0",
+    "stylelint": "^17.0.0",
     "stylelint-config-clean-order": "^8.0.1",
     "stylelint-config-recommended": "^18.0.0",
     "stylelint-config-recommended-scss": "^17.0.1",
@@ -58,105 +61,69 @@
   "exports": {
     ".": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/index.js",
-      "default": "./packages/eslint/src/index.js"
+      "import": "./src/index.js",
+      "default": "./src/index.js"
     },
     "./eslint-next": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/eslint/eslint.config.next.js",
-      "default": "./packages/eslint/src/eslint/eslint.config.next.js"
+      "import": "./src/eslint/eslint.config.next.js",
+      "default": "./src/eslint/eslint.config.next.js"
     },
     "./eslint-react": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/eslint/eslint.config.react.js",
-      "default": "./packages/eslint/src/eslint/eslint.config.react.js"
+      "import": "./src/eslint/eslint.config.react.js",
+      "default": "./src/eslint/eslint.config.react.js"
     },
     "./eslint-svelte": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/eslint/eslint-svelte.config.js",
-      "default": "./packages/eslint/src/eslint/eslint-svelte.config.js"
+      "import": "./src/eslint/eslint-svelte.config.js",
+      "default": "./src/eslint/eslint-svelte.config.js"
     },
     "./eslint-common": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/eslint/eslint.config.common.js",
-      "default": "./packages/eslint/src/eslint/eslint.config.common.js"
+      "import": "./src/eslint/eslint.config.common.js",
+      "default": "./src/eslint/eslint.config.common.js"
     },
     "./prettier-common": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/prettier/prettier.config.common.js",
-      "default": "./packages/eslint/src/prettier/prettier.config.common.js"
+      "import": "./src/prettier/prettier.config.common.js",
+      "default": "./src/prettier/prettier.config.common.js"
     },
     "./prettier-svelte": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/prettier/prettier-svelte.config.js",
-      "default": "./packages/eslint/src/prettier/prettier-svelte.config.js"
+      "import": "./src/prettier/prettier-svelte.config.js",
+      "default": "./src/prettier/prettier-svelte.config.js"
     },
     "./stylelint-scss": {
       "types": "./index.d.ts",
-      "import": "./packages/eslint/src/stylelint/stylelint.config.scss.js",
-      "default": "./packages/eslint/src/stylelint/stylelint.config.scss.js"
-    },
-    "./biome": {
-      "types": "./index.d.ts",
-      "import": "./packages/biome/biome.json",
-      "default": "./packages/biome/biome.json"
-    },
-    "./biome-common": {
-      "types": "./index.d.ts",
-      "import": "./packages/biome/configs/biome.common.json",
-      "default": "./packages/biome/configs/biome.common.json"
-    },
-    "./biome-react": {
-      "types": "./index.d.ts",
-      "import": "./packages/biome/configs/biome.react.json",
-      "default": "./packages/biome/configs/biome.react.json"
-    },
-    "./biome-next": {
-      "types": "./index.d.ts",
-      "import": "./packages/biome/configs/biome.next.json",
-      "default": "./packages/biome/configs/biome.next.json"
-    },
-    "./biome-svelte": {
-      "types": "./index.d.ts",
-      "import": "./packages/biome/configs/biome.svelte.json",
-      "default": "./packages/biome/configs/biome.svelte.json"
+      "import": "./src/stylelint/stylelint.config.scss.js",
+      "default": "./src/stylelint/stylelint.config.scss.js"
     }
   },
   "files": [
     "index.d.ts",
-    "packages/eslint/src",
-    "packages/eslint/scripts",
-    "packages/eslint/data",
-    "packages/eslint/docs",
-    "packages/biome/biome.json",
-    "packages/biome/configs",
-    "packages/biome/LICENSE",
-    "packages/biome/docs",
-    "scripts/README.md"
+    "src",
+    "scripts",
+    "data",
+    "docs"
   ],
   "scripts": {
-    "lint": "npm run lint --workspace=packages/eslint && npm run lint --workspace=packages/biome",
-    "lint:eslint": "npm run lint --workspace=packages/eslint",
-    "lint:stylelint": "npm run lint:stylelint --workspace=packages/eslint",
-    "lint:prettier": "npm run lint:prettier --workspace=packages/eslint",
-    "lint:biome": "npm run lint --workspace=packages/biome",
-    "lint:fix": "npm run lint:fix --workspace=packages/eslint && npm run lint:fix --workspace=packages/biome",
-    "lint:fix:eslint": "npm run lint:fix --workspace=packages/eslint",
-    "lint:fix:biome": "npm run lint:fix --workspace=packages/biome",
+    "lint": "eslint . && stylelint \"src/**/*.{css,scss}\" --config ./src/stylelint/stylelint.config.scss.js --allow-empty-input && prettier --check .",
+    "lint:eslint": "eslint .",
+    "lint:stylelint": "stylelint \"src/**/*.{css,scss}\" --config ./src/stylelint/stylelint.config.scss.js --allow-empty-input",
+    "lint:prettier": "prettier --check .",
+    "lint:fix": "eslint . --fix && stylelint \"src/**/*.{css,scss}\" --config ./src/stylelint/stylelint.config.scss.js --fix --allow-empty-input && prettier --write .",
+    "lint:fix:eslint": "npm run lint:fix",
     "changelog": "conventional-changelog -p conventionalcommits -i CHANGELOG.md -s",
     "changelog:dry": "conventional-changelog -p conventionalcommits",
     "publish:npm": "npm publish --access public",
-    "inventory": "npm run inventory --workspace=packages/eslint",
-    "config:init": "node ./packages/eslint/scripts/linter-init.mjs init --eslint --biome --common",
-    "config:reinit": "node ./packages/eslint/scripts/linter-init.mjs reinit --eslint --biome --common",
-    "config:create": "node ./packages/eslint/scripts/linter-init.mjs create --eslint --biome --common"
+    "inventory": "node ./scripts/inventory.mjs",
+    "config:init": "node ./scripts/linter-init.mjs init --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"
   },
-  "workspaces": [
-    "packages/eslint",
-    "packages/biome"
-  ],
   "peerDependencies": {
-    "@biomejs/biome": ">=2.4.0 <3.0.0",
     "eslint": "^9.0.0 || ^10.0.0",
     "next": "^16.0.0",
     "prettier": "^3.0.0",
@@ -165,9 +132,6 @@
     "svelte": "^4.0.0 || ^5.0.0"
   },
   "peerDependenciesMeta": {
-    "@biomejs/biome": {
-      "optional": true
-    },
     "eslint": {
       "optional": true
     },
@@ -188,7 +152,6 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.11",
     "@stylistic/eslint-plugin-migrate": "^4.4.1",
     "conventional-changelog-cli": "^5.0.0",
     "conventional-changelog-conventionalcommits": "^9.0.0"

package/scripts/README.md

@@ -1,38 +1,43 @@
 # Consumer config helpers (monorepo root)
 
-From this repository root, use the npm scripts in the root [`package.json`](../package.json). They run the CLI with **`--eslint --biome --common`** (full wrapper set for this repo’s default stack):
+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`, `biome.json` |
-| `npm run config:reinit` | `reinit` — overwrite those four 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:reinit` | `reinit` — overwrite those three files                                                  |
+| `npm run config:create` | same as `config:init`                                                                   |
 
-Direct CLI (paths from repo root):
+Each run installs **`@st1ggy/linter-config`** 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).
+
+Direct CLI (paths from repo root — same entry as published **`@st1ggy/linter-config`**):
 
 ```bash
-node packages/eslint/scripts/linter-init.mjs init --eslint --biome --react
-node packages/eslint/scripts/linter-init.mjs reinit --biome --svelte --dir ./my-app
+node ./scripts/linter-init.mjs init --react
+node ./scripts/linter-init.mjs reinit --svelte --dir ./my-app
 ```
 
 ## Flags (published package)
 
-The **`linter-config`** binary is declared in [`package.json`](../package.json) `bin`. In another project:
+The CLI is published under the name **`@st1ggy/linter-config`** (see [`package.json`](../package.json) `bin`). In another project **after** `npm i -D @st1ggy/linter-config`:
 
 ```bash
-npx linter-config init --eslint --common
-npx linter-config init --biome --next
-npm exec linter-config -- reinit --eslint --biome --svelte
+npx @st1ggy/linter-config init --common
+npx @st1ggy/linter-config init --next
+npm exec @st1ggy/linter-config -- reinit --svelte
 ```
 
-Without installing first:
+**Without** installing first:
 
 ```bash
-npx --yes --package @st1ggy/linter-config linter-config init --eslint --react
+npx --yes @st1ggy/linter-config init --react
 ```
 
-- **`--eslint`** — `eslint.config.js` + `prettier.config.js` + `stylelint.config.js` (one stack).
-- **`--biome`** — `biome.json`.
 - **Stack (optional, default common):** `--common` | `--react` | `--next` | `--svelte` (at most one).
+- **`--skip-install`:** only write wrapper files; do not run npm/pnpm/yarn/bun.
 
-Shell shortcuts in [`packages/eslint/scripts/`](../packages/eslint/scripts/) (`init-common.sh`, etc.) call **`init --eslint`** with the matching stack only (no Biome).
+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-common.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# Runs the same entry as `npx @st1ggy/linter-config` (see scripts/linter-init.mjs): writes wrappers and,
+# unless --skip-install is passed, ensures @st1ggy/linter-config is installed when package.json exists.
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec node "${SCRIPT_DIR}/linter-init.mjs" init --common "$@"

package/scripts/init-next.sh

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

package/scripts/init-react.sh

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

package/scripts/init-svelte.sh

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

package/{packages/eslint/scripts → scripts}/inventory.mjs

@@ -1,6 +1,6 @@
-// Collects effective flat-config rule lists and Stylelint rules from this workspace.
-// Run from repo root: `node packages/eslint/scripts/inventory.mjs`
-// Or set `LINTER_CONFIG_ROOT` to override the default (`packages/eslint`).
+// Collects effective flat-config rule lists and Stylelint rules from this repo.
+// Run from repo root: `node scripts/inventory.mjs`
+// Or set `LINTER_CONFIG_ROOT` to override the default (repository root).
 
 import { spawnSync } from 'node:child_process'
 import { mkdirSync, writeFileSync } from 'node:fs'
@@ -12,7 +12,7 @@ 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@4.0.0 (local tree)'
+const SOURCE_LABEL = '@st1ggy/linter-config@6.3.0 (local tree)'
 
 const flatConfigPresets = [
   {
@@ -171,7 +171,7 @@ async function main() {
   writeFileSync(outputPath, body, 'utf8')
 
   process.stdout.write(
-    `Wrote packages/eslint/data/linter-config-inventory.json (${SOURCE_LABEL}, flat presets: ${Object.keys(flatConfigs).length}, stylelint rules: ${stylelint.ruleCount})\n`,
+    `Wrote data/linter-config-inventory.json (${SOURCE_LABEL}, flat presets: ${Object.keys(flatConfigs).length}, stylelint rules: ${stylelint.ruleCount})\n`,
   )
 }