@st1ggy/linter-config 7.4.0 → 9.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/README.md +101 -28
  2. package/data/linter-config-inventory.json +294 -128
  3. package/data/oxlint-config-inventory.json +913 -735
  4. package/data/oxlint-rule-map.json +4684 -1743
  5. package/data/oxlint-source-inventory.json +10529 -8546
  6. package/docs/OXLINT_RULE_MAPPING.md +197 -88
  7. package/docs/RULE_MAPPING.md +2 -2
  8. package/package.json +122 -18
  9. package/scripts/README.md +12 -5
  10. package/scripts/init-angular-ox.sh +4 -0
  11. package/scripts/init-nuxt-ox.sh +4 -0
  12. package/scripts/init-vue-ox.sh +4 -0
  13. package/scripts/linter-init-core.mjs +75 -20
  14. package/scripts/linter-init.mjs +5 -3
  15. package/src/eslint/configs/config.import.js +1 -1
  16. package/src/eslint/configs/config.react.js +17 -24
  17. package/src/eslint/configs/import-plugin.js +48 -0
  18. package/src/eslint/configs/svelte-stack.js +4 -11
  19. package/src/eslint/eslint.config.angular-ox.js +26 -0
  20. package/src/eslint/eslint.config.astro-ox.js +3 -0
  21. package/src/eslint/eslint.config.nuxt-ox.js +4 -0
  22. package/src/eslint/eslint.config.svelte-ox.js +4 -0
  23. package/src/eslint/eslint.config.vue-ox.js +17 -0
  24. package/src/eslint/ox-supplement.d.ts +39 -0
  25. package/src/oxfmt/index.d.ts +32 -0
  26. package/src/oxfmt/oxfmt.config.angular.js +3 -0
  27. package/src/oxfmt/oxfmt.config.astro.js +3 -0
  28. package/src/oxfmt/oxfmt.config.common.js +16 -0
  29. package/src/oxfmt/oxfmt.config.svelte.js +3 -0
  30. package/src/oxlint/configs/config.astro.js +89 -42
  31. package/src/oxlint/configs/config.common.js +73 -28
  32. package/src/oxlint/configs/config.next.js +330 -173
  33. package/src/oxlint/configs/config.react.js +330 -173
  34. package/src/oxlint/configs/config.solid.js +105 -47
  35. package/src/oxlint/configs/config.svelte.js +85 -61
  36. package/src/oxlint/create-config.js +1 -1
  37. package/src/oxlint/framework-rules.js +79 -0
  38. package/src/oxlint/index.d.ts +24 -0
  39. package/src/oxlint/oxlint.config.angular.js +14 -0
  40. package/src/oxlint/oxlint.config.nuxt.js +24 -0
  41. package/src/oxlint/oxlint.config.vue.js +8 -0
  42. package/src/oxlint/plugins/angular.js +1 -0
  43. package/src/oxlint/plugins/import-x.js +1 -1
  44. package/src/oxlint/plugins/nuxt.js +1 -0
  45. package/src/oxlint/plugins/react.js +1 -1
  46. package/src/oxlint/stacks.js +30 -5
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # st1ggy/linter-config
2
2
 
3
- Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Config sources live under [`src/`](src/) (ESLint, Oxlint, Prettier, Stylelint).
3
+ Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Config sources live under [`src/`](src/) (ESLint, Oxlint, Oxfmt, Prettier, Stylelint).
4
4
 
5
5
  Install once:
6
6
 
@@ -8,11 +8,11 @@ Install once:
8
8
  npm i -D @st1ggy/linter-config
9
9
  ```
10
10
 
11
- Oxlint engines and framework-specific plugins are optional peers. The wizard installs the selected stack's engines and integration plugins as dev dependencies.
11
+ Oxlint/Oxfmt engines and framework-specific plugins are optional peers. The wizard installs the selected stack's engines and integration plugins as dev dependencies.
12
12
 
13
13
  ### Generate local wrapper configs
14
14
 
15
- The published CLI is invoked as **`@st1ggy/linter-config`** (see [`package.json`](package.json) `bin`). Each run writes **`eslint.config.js`** for an ESLint stack or **`oxlint.config.ts`** for an Oxlint stack, plus **`prettier.config.js`** and **`stylelint.config.js`** as re-exports for the selected stack.
15
+ The published CLI is invoked as **`@st1ggy/linter-config`** (see [`package.json`](package.json) `bin`). ESLint stacks write **`eslint.config.js`**, **`prettier.config.js`** and **`stylelint.config.js`**. All nine Ox stacks write **`oxlint.config.ts`**, **`oxfmt.config.ts`** and **`stylelint.config.js`**. Svelte, Astro, Angular, Vue and Nuxt additionally write **`eslint.config.js`** for framework/template checks that Oxlint cannot replace.
16
16
 
17
17
  Unless **`--skip-install`** is passed: if **`package.json`** exists in the target directory, the CLI runs the detected package manager (**npm** / **pnpm** / **yarn** / **bun** from the nearest lockfile) to install **`@st1ggy/linter-config`** and only the selected stack's integration plugins. When all selected packages are already declared but missing from `node_modules`, it runs a regular install instead.
18
18
 
@@ -22,6 +22,8 @@ Pick **at most one** stack flag (default **`--common`** if omitted):
22
22
 
23
23
  **`--common-ox` · `--react-ox` · `--solid-ox` · `--next-ox` · `--svelte-ox` · `--astro-ox`**
24
24
 
25
+ **`--angular-ox` · `--vue-ox` · `--nuxt-ox`**
26
+
25
27
  **After** `npm i -D @st1ggy/linter-config`:
26
28
 
27
29
  ```bash
@@ -49,9 +51,9 @@ The CLI is interactive in a terminal. Command and stack flags preselect their va
49
51
  Older **`--eslint`** on the command line is still accepted for compatibility; **`--eslint`** is optional.
50
52
 
51
53
  - **`init` / `create`** — create only missing files (skip existing).
52
- - **`migrate` / `reinit`** — optionally remove selected legacy configs, then overwrite the selected stack's three wrapper configs.
54
+ - **`migrate` / `reinit`** — optionally remove selected legacy configs, then overwrite the selected stack's three or four wrapper configs.
53
55
 
54
- **Legacy filenames** (`.eslintrc.*`, `.oxlintrc.*`, `prettier.config.cjs`, extra copies, …) are presented one by one by `migrate`; no file is deleted without confirmation. Changing engines offers the other engine's config for removal during migration. [`scripts/remove-current.sh`](scripts/remove-current.sh) remains available as a standalone cleanup helper.
56
+ **Legacy filenames** (`.eslintrc.*`, `.oxlintrc.*`, `.oxfmtrc.*`, `prettier.config.cjs`, extra copies, …) are presented one by one by `migrate`; no file is deleted without confirmation. Changing engines offers the other linter and formatter configs for removal during migration. [`scripts/remove-current.sh`](scripts/remove-current.sh) remains available as a standalone cleanup helper.
55
57
 
56
58
  Your project should use **`"type": "module"`** (or `.mjs` config filenames) so the generated ESM re-exports load.
57
59
 
@@ -93,20 +95,25 @@ If you previously used Stylelint 16 with this preset, upgrade the consumer to **
93
95
 
94
96
  ## Oxlint variants
95
97
 
96
- Each existing stack has an Oxlint counterpart. The new configs are objects typed as `OxlintConfig`; the existing ESLint configs remain flat-config arrays.
98
+ Each existing stack has an Oxlint counterpart. Angular, Vue and Nuxt have additional Ox presets. Oxlint configs are objects typed as `OxlintConfig`; ESLint companions are flat-config arrays. Stylelint remains the style-rule tool for every stack.
99
+
100
+ All imports below are subpaths of `@st1ggy/linter-config`.
97
101
 
98
- | Stack flag | Config import | Prettier | Stylelint |
99
- | ------------- | --------------------------------- | ----------------- | ---------------- |
100
- | `--common-ox` | `@st1ggy/linter-config/common-ox` | `prettier-common` | `stylelint-scss` |
101
- | `--react-ox` | `@st1ggy/linter-config/react-ox` | `prettier-common` | `stylelint-scss` |
102
- | `--solid-ox` | `@st1ggy/linter-config/solid-ox` | `prettier-common` | `stylelint-scss` |
103
- | `--next-ox` | `@st1ggy/linter-config/next-ox` | `prettier-common` | `stylelint-scss` |
104
- | `--svelte-ox` | `@st1ggy/linter-config/svelte-ox` | `prettier-svelte` | `stylelint-scss` |
105
- | `--astro-ox` | `@st1ggy/linter-config/astro-ox` | `prettier-astro` | `stylelint-scss` |
102
+ | Stack flag | Oxlint preset | Formatter | ESLint companion |
103
+ | -------------- | ------------- | --------------- | ------------------- |
104
+ | `--common-ox` | `common-ox` | `oxfmt-common` | — |
105
+ | `--react-ox` | `react-ox` | `oxfmt-common` | — |
106
+ | `--solid-ox` | `solid-ox` | `oxfmt-common` | — |
107
+ | `--next-ox` | `next-ox` | `oxfmt-common` | — |
108
+ | `--svelte-ox` | `svelte-ox` | `oxfmt-svelte` | `eslint-svelte-ox` |
109
+ | `--astro-ox` | `astro-ox` | `oxfmt-astro` | `eslint-astro-ox` |
110
+ | `--angular-ox` | `angular-ox` | `oxfmt-angular` | `eslint-angular-ox` |
111
+ | `--vue-ox` | `vue-ox` | `oxfmt-common` | `eslint-vue-ox` |
112
+ | `--nuxt-ox` | `nuxt-ox` | `oxfmt-common` | `eslint-nuxt-ox` |
106
113
 
107
114
  ### Install and run
108
115
 
109
- The checked engine versions are **Oxlint 1.86.0** and **oxlint-tsgolint 7.0.2003**, with native TypeScript 7 typed analysis. Use **Node.js 24.16.0+**. JS-plugin compatibility and the rule inventory are checked against these versions; the CLI installs the engines with exact versions.
116
+ The checked engine versions are **Oxlint 1.90.0**, **oxlint-tsgolint 7.0.2005**, and **Oxfmt 0.75.0**. The project compiler remains **TypeScript 6.0.3** (the latest stable 6.x); no TypeScript 7 compiler is installed. Use a supported **Node.js LTS** release, minimum **24.16.0**. The CLI installs engines with exact versions and only the selected framework integrations. Companion stacks also install **ESLint 10.14.0** directly so `pnpm exec eslint` works without relying on hoisting. Svelte Ox formatting requires **Svelte 5**; Svelte 4 projects need an explicitly compatible older lint/format toolchain or an intentional runtime upgrade. This Ox stack does not upgrade an installed Svelte 4 runtime for you. Astro formatting additionally needs **`@astrojs/compiler-rs@^0.5.2`**, installed by the wizard.
110
117
 
111
118
  ```bash
112
119
  npx @st1ggy/linter-config init --solid-ox
@@ -116,7 +123,7 @@ For manual Solid installation:
116
123
 
117
124
  ```bash
118
125
  npm i -D @st1ggy/linter-config eslint-plugin-solid
119
- npm i -D --save-exact oxlint@1.86.0 oxlint-tsgolint@7.0.2003
126
+ npm i -D --save-exact oxlint@1.90.0 oxlint-tsgolint@7.0.2005 oxfmt@0.75.0
120
127
  ```
121
128
 
122
129
  ```ts
@@ -124,15 +131,22 @@ npm i -D --save-exact oxlint@1.86.0 oxlint-tsgolint@7.0.2003
124
131
  export { default } from '@st1ggy/linter-config/solid-ox'
125
132
  ```
126
133
 
134
+ ```ts
135
+ // oxfmt.config.ts
136
+ export { default } from '@st1ggy/linter-config/oxfmt-common'
137
+ ```
138
+
127
139
  ```bash
128
140
  npx oxlint .
141
+ npx oxfmt --check .
129
142
  # Also report TypeScript errors:
130
143
  npx oxlint --type-aware --type-check .
131
- # Fix supported lint violations:
144
+ # Fix supported lint violations, then format:
132
145
  npx oxlint --fix .
146
+ npx oxfmt --write .
133
147
  ```
134
148
 
135
- Oxlint auto-discovers `oxlint.config.ts` and the applicable `tsconfig.json`. Remove options deleted in TypeScript 7, including `baseUrl`; make `paths` relative to the config instead. For Solid JSX, use `"jsx": "preserve"` and `"jsxImportSource": "solid-js"`. The wizard writes wrappers and installs integrations; it does not edit your tsconfig or package scripts.
149
+ Oxlint auto-discovers `oxlint.config.ts` and the applicable `tsconfig.json`. The project stays on TypeScript 6; do not migrate it to TypeScript 7 for this preset. Oxlint's bundled native typed-lint engine has its own configuration constraints: for example, it does not support `baseUrl`. If your TS6 project relies on such options, evaluate a separate Oxlint tsconfig or keep ESLint typed linting rather than changing the project's compiler. For Solid JSX, use `"jsx": "preserve"` and `"jsxImportSource": "solid-js"`. The wizard writes wrappers and installs integrations; it does not edit your tsconfig or package scripts.
136
150
 
137
151
  When composing configs, specify `typeAware` at the **consumer root**; root-only options are not inherited through `extends`:
138
152
 
@@ -147,21 +161,76 @@ export default defineConfig({
147
161
  })
148
162
  ```
149
163
 
150
- Prettier and Stylelint remain the format/style tools, with the existing framework plugins for Svelte and Astro. Oxlint also executes the compatible Prettier JS rule for ordinary JS/TS files. Re-run formatting if overlapping lint fixes leave formatting diagnostics.
164
+ ### Oxfmt formatting
165
+
166
+ Every Ox stack uses Oxfmt for formatting. Oxlint and companion ESLint configs do not run `prettier/prettier`; run the formatter check alongside linting in CI. The generated `oxfmt.config.ts` imports the stack's formatter preset and is discovered automatically. Svelte/Astro explicitly enable their formatter integrations; Angular associates all `*.html` files with `angular-html`, including templates without a `.component.html` suffix. Vue/Nuxt files are recognized automatically.
167
+
168
+ The shared config preserves the common style: 120-column width, two-space indentation, single quotes, no semicolons, trailing commas, LF and a final newline. **Import sorting and package.json sorting are explicitly disabled**; the current import lint rules retain control of import order. `.gitignore` and `.prettierignore` are respected during directory traversal. Oxfmt can format an explicitly named gitignored file; for deliberate exclusions, use `.prettierignore` or `ignorePatterns`.
169
+
170
+ Override options by spreading the shared object:
171
+
172
+ ```ts
173
+ import config from '@st1ggy/linter-config/oxfmt-common'
174
+ import { defineConfig } from 'oxfmt'
175
+
176
+ export default defineConfig({
177
+ ...config,
178
+ ignorePatterns: [...(config.ignorePatterns ?? []), 'dist/**'],
179
+ })
180
+ ```
181
+
182
+ `init` preserves existing configs, including custom ESLint companions and old Prettier wrappers. Use `migrate` to overwrite wrappers and offer the old formatter config for removal. The wizard does not update consumer package scripts.
183
+
184
+ For common/React/Solid/Next, use `"lint": "oxlint ."` and `"format:check": "oxfmt --check ."`. For Svelte/Astro/Angular/Vue/Nuxt, **run all three commands**:
185
+
186
+ ```bash
187
+ npx oxlint .
188
+ npx eslint .
189
+ npx oxfmt --check .
190
+ ```
191
+
192
+ For example, `"lint": "oxlint . && eslint ."` and `"format:check": "oxfmt --check ."`. Run both linters' fixes before `oxfmt --write .`. Omitting the ESLint command loses template checks. Oxfmt delegates framework formatting to bundled Prettier integrations; it is not an entirely Rust-native template formatter. The original ESLint stacks retain their Prettier configs and plugins. Prettier also remains a package dependency for Stylelint and legacy/development checks.
193
+
194
+ ### Framework coverage
195
+
196
+ - **Svelte:** Oxlint checks extracted scripts and supported rune/module rules; the ESLint companion retains framework/template rules with the Svelte parser. Include `.svelte` files in the consumer tsconfig. SvelteKit aliases from the existing Svelte preset are retained.
197
+ - **Astro:** Oxlint checks frontmatter and browser scripts, including the existing six frontmatter adapters. The ESLint companion uses the actual Astro parser/processor for template directives. Some script checks intentionally overlap because extracted scripts cannot distinguish every frontmatter/browser context.
198
+ - **Vue 3:** the common Ox preset supplies JS/TS checks and 36 native Vue rules from the upstream recommended intersection. The ESLint companion supplies the remaining Vue recommended/template checks using `vue-eslint-parser` and the TS parser. Rules already enabled natively are disabled in the companion. Bindings used only in templates are not treated as unused by script-only checks.
199
+ - **Nuxt:** builds on Vue and adds the four `@nuxt/eslint-plugin` rules through Oxlint's JS-plugin API. `.nuxt` and `.output` are ignored. This is a standalone preset, not the project-aware `@nuxt/eslint` module: generate Nuxt's types/config (`nuxt prepare`) before typed linting and use the application's tsconfig. It does not discover arbitrary auto-import globals from a Nuxt build.
200
+ - **Angular:** the common Ox preset supplies JS/TS checks; 12 `angular-eslint` 22 recommended script rules run as a JS plugin. ESLint handles HTML templates and inline `@Component` templates, including recommended and accessibility rules. The wizard does not install or upgrade the application's Angular runtime. New framework integrations are tested independently of the six source-derived migration inventories.
151
201
 
152
202
  ### Rule coverage
153
203
 
154
- The presets carry over native rule equivalents and compatible JS plugins, including custom severity, options, JSX style, import ordering and syntax restrictions. All default Oxlint categories are disabled; only migrated rules are enabled. Type-aware checks run through **tsgolint/TS7**. TS6 remains a library dependency for existing ESLint presets and some JS plugins; the new consumer command does not launch ESLint or create a TS6 type-checking Program.
204
+ The source-derived presets carry over native rule equivalents and compatible JS plugins, including custom severity, options, JSX style, import ordering and syntax restrictions. All default Oxlint categories are disabled; presets explicitly select rules. Type-aware Oxlint checks run through **tsgolint**, which embeds a native TypeScript-derived engine independently of the project's **TypeScript 6** compiler. Its 7.x package version does not upgrade the project compiler. The separate ESLint companions use their framework parsers and may use TS6 parser services; Oxlint itself does not provide these services to JS plugins.
155
205
 
156
206
  These are **maximum-feasible migrations, with documented gaps**, rather than fully equivalent replacements:
157
207
 
158
- - **Svelte/Astro:** Oxlint checks extracted scripts, not templates. Template-only checks and TS parser-service-dependent JS rules are unavailable. Checks that would misreport template-used variables are omitted for those scopes. Svelte script/module rules and aliases are retained where supported.
159
- - **Astro:** six frontmatter-only script checks are preserved via an adapter (deprecated Astro APIs, deprecated `getEntryBySlug`, component exports and prerender location). Template directives are not checked. The plugin API cannot distinguish frontmatter from a browser script containing identical text; that ambiguity is recorded as partial coverage.
208
+ - **Svelte/Astro/Vue/Nuxt:** Oxlint checks extracted scripts, not templates. The ESLint companions retain framework/template checks, but do not restore every unsupported general-purpose TS-aware rule from the original common ESLint preset. Checks that would misreport template-used variables are omitted from script-only analysis.
209
+ - **Astro:** the Oxlint plugin API cannot distinguish frontmatter from a browser script containing identical text; that ambiguity remains recorded as partial coverage even with a precise ESLint companion.
160
210
  - Some native implementations have narrower behavior or lack source options. The original JS rule is used where compatible; remaining differences are recorded individually.
161
211
  - Compiler configuration-dependent guards are kept, but default-configuration control fixtures do not count as positive violation evidence.
162
212
  - Existing `eslint-disable` directives do not automatically retain their meaning after rule namespaces change. Use Oxlint directives with the migrated IDs and check `--report-unused-disable-directives` when migrating.
163
213
 
164
- See [the generated rule mapping](docs/OXLINT_RULE_MAPPING.md) for counts and every partial/unsupported mapping. The full source scopes, rule options and evidence references are in `data/oxlint-*.json`; development tests keep paired source/target fixtures outside the published tarball.
214
+ See [the generated rule mapping](docs/OXLINT_RULE_MAPPING.md) for the six source-derived presets' counts and partial/unsupported mappings. Angular/Vue/Nuxt compose the common preset and add separately tested integrations; they are not claimed to have full source/target rule parity. The migrated formatting check is accounted for with status `formatter`, not silently disabled. The full source scopes, rule options and evidence references are in `data/oxlint-*.json`; development tests keep paired source/target fixtures outside the published tarball.
215
+
216
+ ### Migration to the all-Ox formatter workflow
217
+
218
+ All Ox stacks use Oxfmt instead of a separate Prettier command. To upgrade an existing consumer:
219
+
220
+ 1. Run the wizard with `migrate --<stack>-ox`; review config replacements and select the old formatter config for removal. It installs the checked engine pins and selected integrations. Use the stack-specific formatter import from the table above when configuring manually.
221
+ 2. Add `oxfmt --check .` alongside `oxlint .` in CI; replace the old `prettier --check .` command for that stack.
222
+ 3. For Svelte/Astro/Angular/Vue/Nuxt, keep the generated `eslint.config.js` and run `eslint .` alongside Oxlint for framework/template checks.
223
+ 4. Run `oxlint --fix .`, the companion `eslint --fix .` where applicable, then `oxfmt --write .`; review consumer-specific formatter overrides.
224
+
225
+ The original non-Ox ESLint stacks retain their Prettier workflow. An old custom ESLint wrapper is preserved by `init`; migrate explicitly if you want the new companion instead of the full legacy preset.
226
+
227
+ ### React and Next rule migration (v8)
228
+
229
+ React/Next presets now use `@eslint-react/eslint-plugin` instead of `eslint-plugin-react`, including their Oxlint adapters. The modern recommended preset adds React 19 migration, server-function, DOM safety and effect-cleanup checks. The official `eslint-plugin-react-hooks` remains responsible for hooks; overlapping modern-plugin aliases are disabled to avoid duplicate diagnostics.
230
+
231
+ Retained custom checks include button types, `useState` destructuring/naming, unstable context values, useless fragments, and component display names. Self-closing JSX moves to `@stylistic/jsx-self-closing-comp`. Similar modern rules are not guaranteed to report exactly the same cases or severities as their legacy counterparts; the generated [rule mapping](docs/OXLINT_RULE_MAPPING.md) records the active configuration.
232
+
233
+ The legacy checks for `propTypes`/`defaultProps`, boolean-prop naming, prop destructuring, arrow-only component definitions, boolean-value and fragment shorthand, handler naming, and one-component-per-file are no longer enforced. Legacy `jsx-no-leaked-render` is also removed: the modern type-checked conditional-rendering check is not enabled by the selected recommended preset. Legacy JSX undefined-name, duplicate-prop, unescaped-entity, target-blank and deprecated-API diagnostics are not retained as an identical rule set; use TypeScript and explicitly configured project rules where needed. This is a deliberate rule-set change, not a compatibility-preserving plugin rename.
165
234
 
166
235
  ### Migration (v7)
167
236
 
@@ -173,7 +242,9 @@ See [the generated rule mapping](docs/OXLINT_RULE_MAPPING.md) for counts and eve
173
242
 
174
243
  ### Development of this package
175
244
 
176
- `npm install` uses [`.npmrc`](.npmrc) `legacy-peer-deps=true` (see earlier notes on `eslint-import-resolver-custom-alias`).
245
+ Installs use [`.npmrc`](.npmrc) `strict-peer-deps=true`; no legacy peer-resolution bypass is required. Import aliases use the TypeScript resolver and do not require the old `eslint-import-resolver-custom-alias` or `eslint-plugin-import`. Astro's optional accessibility integration uses `eslint-plugin-jsx-a11y-x`, which declares ESLint 10 support.
246
+
247
+ Security audit is not yet clean: [GHSA-g3hv-75wg-m249](https://github.com/advisories/GHSA-g3hv-75wg-m249) affects the transitive `minimatch` v3/v10 releases required by ESLint, TypeScript ESLint, import/accessibility/Sonar plugins, and `doiuse → multimatch`. These ranges do not admit the fixed v11 release. Updating pnpm removes the previous high-severity findings, but eliminating the remaining moderate findings requires upstream-compatible fixes or separately reviewed backports. A blanket major-version override is intentionally not used; root overrides would not protect consumers of the published config either.
177
248
 
178
249
  **Publishing:** this repo’s **root** `package.json` is the published `@st1ggy/linter-config`:
179
250
 
@@ -187,7 +258,7 @@ Releases are started manually from `Actions` → `Release` → `Run workflow`. I
187
258
 
188
259
  ## Toolchain (this repo)
189
260
 
190
- The `CI` GitHub Actions workflow runs linting, the original Solid tests, Oxlint tests, explicit TS6 and native TS7 checks, inventory/generated-config checks, and packed-package smoke tests on pushes to `main` and pull requests. It checks Node.js `24.16.0` and `latest`, and installs tarballs with npm and isolated pnpm. The `Release` workflow runs these checks before publishing as well.
261
+ The `CI` GitHub Actions workflow runs linting, the original Solid tests, Oxlint/Oxfmt tests, TypeScript 6 compiler/declaration checks, inventory/generated-config checks, and packed-package smoke tests on pushes to `main` and pull requests. It checks Node.js `24.16.0` and `lts/*` (latest LTS, not Current), and installs tarballs with npm and isolated pnpm. A separate `format:ox:check` validates formatting with Oxfmt. The `Release` workflow uses the latest Node.js LTS and runs these checks before publishing as well.
191
262
 
192
263
  There is **one** published package at the **repository root** (no `packages/` workspace layout).
193
264
 
@@ -204,12 +275,14 @@ npm run lint
204
275
  | `npm run lint:eslint` | ESLint only |
205
276
  | `npm run lint:stylelint` | Stylelint only |
206
277
  | `npm run lint:prettier` | Prettier `--check` only |
278
+ | `npm run format:ox:check` | Check repository formatting with the shared Oxfmt options |
279
+ | `npm run format:ox:compare` | Compare Oxfmt and Prettier on sources and rule fixtures without rewriting files |
207
280
  | `npm run lint:fix` | Auto-fix ESLint, Stylelint, Prettier |
208
281
  | `npm run inventory` | Regenerate [`data/linter-config-inventory.json`](data/linter-config-inventory.json) |
209
282
  | `node --test scripts/solid-config.test.mjs` | Check Solid JSX/TSX linting and wrapper generation |
210
- | `node scripts/package-smoke.mjs` | Check all six packed Oxlint stacks, their CLI/TS7 checks and legacy imports |
283
+ | `node scripts/package-smoke.mjs` | Check all nine packed Oxlint stacks, their CLI/typed lint checks and legacy imports |
211
284
  | `node scripts/package-smoke.mjs --pm pnpm` | Check the tarball using isolated pnpm dependencies |
212
- | `npm run typecheck:ox` | Explicit native TypeScript 7 compiler check |
285
+ | `npm run typecheck` | TypeScript 6 compiler check |
213
286
  | `npm run test:ox` | Oxlint integration, rule parity and coverage guardrail tests |
214
287
  | `npm run generate:ox` / `generate:ox:check` | Generate/verify the six Oxlint configurations and rule map |
215
288
  | `npm run inventory:ox` / `inventory:ox:check` | Generate/verify source scopes, evidence and coverage reports |
@@ -221,4 +294,4 @@ npm run lint
221
294
 
222
295
  ## Optional ESLint add-ons
223
296
 
224
- You can add **eslint-plugin-n**, **eslint-plugin-jsx-a11y**, **eslint-plugin-perfectionist**, or stricter **typescript-eslint** in your own config if needed.
297
+ You can add **eslint-plugin-n**, **eslint-plugin-jsx-a11y-x**, **eslint-plugin-perfectionist**, or stricter **typescript-eslint** in your own config if needed. Check each integration's ESLint peer range.