@st1ggy/linter-config 7.4.0 → 8.0.0

package/README.md

@@ -1,6 +1,6 @@
 # st1ggy/linter-config
 
-Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Config sources live under [`src/`](src/) (ESLint, Oxlint, Prettier, Stylelint).
+Single npm package **`@st1ggy/linter-config`** with **subpath exports**. Config sources live under [`src/`](src/) (ESLint, Oxlint, Oxfmt, Prettier, Stylelint).
 
 Install once:
 
@@ -8,11 +8,11 @@ Install once:
 npm i -D @st1ggy/linter-config
 ```
 
-Oxlint engines and framework-specific plugins are optional peers. The wizard installs the selected stack's engines and integration plugins as dev dependencies.
+Oxlint/Oxfmt engines and framework-specific plugins are optional peers. The wizard installs the selected stack's engines and integration plugins as dev dependencies.
 
 ### Generate local wrapper configs
 
-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.
+The published CLI is invoked as **`@st1ggy/linter-config`** (see [`package.json`](package.json) `bin`). Each run writes a linter config, a formatter config and **`stylelint.config.js`** as re-exports for the selected stack. ESLint stacks use **`eslint.config.js`** and **`prettier.config.js`**. Common/React/Solid/Next Oxlint stacks use **`oxlint.config.ts`** and **`oxfmt.config.ts`**; Svelte/Astro Oxlint stacks use **`oxlint.config.ts`** and **`prettier.config.js`**.
 
 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.
 
@@ -51,7 +51,7 @@ Older **`--eslint`** on the command line is still accepted for compatibility; **
 - **`init` / `create`** — create only missing files (skip existing).
 - **`migrate` / `reinit`** — optionally remove selected legacy configs, then overwrite the selected stack's three wrapper configs.
 
-**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.
+**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.
 
 Your project should use **`"type": "module"`** (or `.mjs` config filenames) so the generated ESM re-exports load.
 
@@ -95,18 +95,18 @@ If you previously used Stylelint 16 with this preset, upgrade the consumer to **
 
 Each existing stack has an Oxlint counterpart. The new configs are objects typed as `OxlintConfig`; the existing ESLint configs remain flat-config arrays.
 
-| Stack flag    | Config import                     | Prettier          | Stylelint        |
+| Stack flag    | Config import                     | Formatter         | Stylelint        |
 | ------------- | --------------------------------- | ----------------- | ---------------- |
-| `--common-ox` | `@st1ggy/linter-config/common-ox` | `prettier-common` | `stylelint-scss` |
-| `--react-ox`  | `@st1ggy/linter-config/react-ox`  | `prettier-common` | `stylelint-scss` |
-| `--solid-ox`  | `@st1ggy/linter-config/solid-ox`  | `prettier-common` | `stylelint-scss` |
-| `--next-ox`   | `@st1ggy/linter-config/next-ox`   | `prettier-common` | `stylelint-scss` |
+| `--common-ox` | `@st1ggy/linter-config/common-ox` | `oxfmt-common`    | `stylelint-scss` |
+| `--react-ox`  | `@st1ggy/linter-config/react-ox`  | `oxfmt-common`    | `stylelint-scss` |
+| `--solid-ox`  | `@st1ggy/linter-config/solid-ox`  | `oxfmt-common`    | `stylelint-scss` |
+| `--next-ox`   | `@st1ggy/linter-config/next-ox`   | `oxfmt-common`    | `stylelint-scss` |
 | `--svelte-ox` | `@st1ggy/linter-config/svelte-ox` | `prettier-svelte` | `stylelint-scss` |
 | `--astro-ox`  | `@st1ggy/linter-config/astro-ox`  | `prettier-astro`  | `stylelint-scss` |
 
 ### Install and run
 
-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.
+The checked engine versions are **Oxlint 1.86.0**, **oxlint-tsgolint 7.0.2003**, and **Oxfmt 0.71.0**, 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 selected engines with exact versions.
 
 ```bash
 npx @st1ggy/linter-config init --solid-ox
@@ -116,7 +116,7 @@ For manual Solid installation:
 
 ```bash
 npm i -D @st1ggy/linter-config eslint-plugin-solid
-npm i -D --save-exact oxlint@1.86.0 oxlint-tsgolint@7.0.2003
+npm i -D --save-exact oxlint@1.86.0 oxlint-tsgolint@7.0.2003 oxfmt@0.71.0
 ```
 
 ```ts
@@ -124,12 +124,19 @@ npm i -D --save-exact oxlint@1.86.0 oxlint-tsgolint@7.0.2003
 export { default } from '@st1ggy/linter-config/solid-ox'
 ```
 
+```ts
+// oxfmt.config.ts
+export { default } from '@st1ggy/linter-config/oxfmt-common'
+```
+
 ```bash
 npx oxlint .
+npx oxfmt --check .
 # Also report TypeScript errors:
 npx oxlint --type-aware --type-check .
-# Fix supported lint violations:
+# Fix supported lint violations, then format:
 npx oxlint --fix .
+npx oxfmt --write .
 ```
 
 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.
@@ -147,7 +154,27 @@ export default defineConfig({
 })
 ```
 
-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.
+### Oxfmt formatting
+
+`common-ox`, `react-ox`, `solid-ox` and `next-ox` use Oxfmt for formatting. Their lint configs do not load `eslint-plugin-prettier` or execute `prettier/prettier`; run the formatter check alongside linting in CI. The generated `oxfmt.config.ts` imports `@st1ggy/linter-config/oxfmt-common` and is discovered automatically.
+
+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`.
+
+Override options by spreading the shared object:
+
+```ts
+import config from '@st1ggy/linter-config/oxfmt-common'
+import { defineConfig } from 'oxfmt'
+
+export default defineConfig({
+  ...config,
+  ignorePatterns: [...(config.ignorePatterns ?? []), 'dist/**'],
+})
+```
+
+`init` keeps an existing `prettier.config.js`; use `migrate` to offer it for removal when switching to Oxfmt. The wizard does not update consumer package scripts. A typical script pair is `"lint": "oxlint ."` and `"format:check": "oxfmt --check ."`.
+
+Svelte/Astro and the original ESLint stacks keep their existing Prettier configs and plugins. Stylelint remains the style-rule tool for every stack. Prettier also remains a dependency for those integrations and this repository's generation/legacy checks.
 
 ### Rule coverage
 
@@ -161,7 +188,17 @@ These are **maximum-feasible migrations, with documented gaps**, rather than ful
 - Compiler configuration-dependent guards are kept, but default-configuration control fixtures do not count as positive violation evidence.
 - 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.
 
-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.
+See [the generated rule mapping](docs/OXLINT_RULE_MAPPING.md) for counts and every partial/unsupported mapping. 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.
+
+### Migration (v8: native formatter)
+
+`common-ox`, `react-ox`, `solid-ox` and `next-ox` use Oxfmt instead of Prettier. Their Oxlint command no longer checks formatting. To upgrade a consumer from v7:
+
+1. Run the wizard with `migrate --<stack>-ox` and select the old formatter config for removal, or install `oxfmt@0.71.0` and create `oxfmt.config.ts` importing `@st1ggy/linter-config/oxfmt-common` manually.
+2. Add `oxfmt --check .` alongside `oxlint .` in CI; replace the old `prettier --check .` command for that stack.
+3. Run `oxlint --fix .` followed by `oxfmt --write .` when applying fixes, and review consumer-specific formatter overrides.
+
+Svelte/Astro Oxlint stacks and the original ESLint stacks retain their Prettier workflow.
 
 ### Migration (v7)
 
@@ -187,7 +224,7 @@ Releases are started manually from `Actions` → `Release` → `Run workflow`. I
 
 ## Toolchain (this repo)
 
-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.
+The `CI` GitHub Actions workflow runs linting, the original Solid tests, Oxlint/Oxfmt 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. A separate `format:ox:check` validates formatting with Oxfmt. The `Release` workflow runs these checks before publishing as well.
 
 There is **one** published package at the **repository root** (no `packages/` workspace layout).
 
@@ -204,6 +241,8 @@ npm run lint
 | `npm run lint:eslint` | ESLint only |
 | `npm run lint:stylelint` | Stylelint only |
 | `npm run lint:prettier` | Prettier `--check` only |
+| `npm run format:ox:check` | Check repository formatting with the shared Oxfmt options |
+| `npm run format:ox:compare` | Compare Oxfmt and Prettier on sources and rule fixtures without rewriting files |
 | `npm run lint:fix` | Auto-fix ESLint, Stylelint, Prettier |
 | `npm run inventory` | Regenerate [`data/linter-config-inventory.json`](data/linter-config-inventory.json) |
 | `node --test scripts/solid-config.test.mjs` | Check Solid JSX/TSX linting and wrapper generation |