feat: adopt load-oxfmt-config v0.5 API and add cli parity mode

Author: ntnyq

README.md

@@ -71,6 +71,20 @@ export default [
 ]
 ```
 
+For CLI-like ignore/config behavior, use `cliParity`:
+
+```js
+// eslint.config.mjs
+import pluginOxfmt from 'eslint-plugin-oxfmt'
+
+export default [
+  {
+    ...pluginOxfmt.configs.cliParity,
+    files: ['**/*.{js,ts,mjs,cjs,jsx,tsx,json,jsonc,yaml,yml}'],
+  },
+]
+```
+
 ### Custom Configuration
 
 You can customize the formatting options by configuring the rule:
@@ -157,10 +171,14 @@ All options are optional and default to sensible values.
 
 ### Plugin Options
 
-| Option       | Type      | Default | Description                                                                                                                                                               |
-| ------------ | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `useConfig`  | `boolean` | `true`  | Load `.oxfmtrc.json`, `.oxfmtrc.jsonc`, or `oxfmt.config.ts` via `load-oxfmt-config` (with `.editorconfig` merge support). Set to `false` to rely only on inline options. |
-| `configPath` | `string`  | —       | Custom path to an oxfmt config file. Resolved from ESLint `cwd` when set.                                                                                                 |
+| Option                       | Type                 | Default | Description                                                                                                                         |
+| ---------------------------- | -------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `useConfig`                  | `boolean`            | `true`  | Load `.oxfmtrc.json`, `.oxfmtrc.jsonc`, or `oxfmt.config.*` via `load-oxfmt-config`. Set to `false` to rely only on inline options. |
+| `configPath`                 | `string`             | —       | Custom path to an oxfmt config file. Resolved from ESLint `cwd` when set.                                                           |
+| `ignorePath`                 | `string \| string[]` | —       | Ignore file path(s) for CLI-style ignore resolution (same role as CLI `--ignore-path`).                                             |
+| `withNodeModules`            | `boolean`            | `false` | Include files under `node_modules` during ignore checks.                                                                            |
+| `disableNestedConfig`        | `boolean`            | `false` | Disable nested config discovery and resolve config from `cwd` / `configPath` only.                                                  |
+| `respectOxfmtDefaultIgnores` | `boolean`            | `true`  | Respect oxfmt default ignores (`.gitignore`, `.prettierignore`, default ignored directories, default ignored lockfiles).            |
 
 > Note: `cwd` is taken from ESLint automatically; you usually do not need to set it manually.
 > `.editorconfig` merge behavior follows oxfmt's documented strategy: https://oxc.rs/docs/guide/usage/formatter/config#editorconfig
@@ -173,8 +191,7 @@ When `useConfig` is `true`, the plugin loads config using `load-oxfmt-config`.
 - `.editorconfig` support: nearest `.editorconfig` (including section overrides) is merged into the final options
 - `configPath` overrides discovery and directly targets the specified config file
 - ESLint rule options generally take highest priority because inline rule options are merged after loaded config.
-- When `useConfig` is `true`, rule-level `overrides` are ignored. Only `overrides` loaded from the resolved oxfmt config file are applied.
-- Rule-level `ignorePatterns` still override config-derived `ignorePatterns` when provided.
+- Rule-level `ignorePatterns` are resolved relative to ESLint `cwd`; config-level `ignorePatterns` are resolved relative to the resolved config file directory.
 
 For detailed behavior, see:
 
@@ -381,12 +398,31 @@ This plugin provides a single rule that formats your code using oxfmt.
 - Fixable: Yes (automatically applies formatting)
 - Type: Layout
 
+## CLI parity mode
+
+`oxfmt/cli-parity` tries to match `oxfmt` CLI behavior for files processed by ESLint.
+
+It respects:
+
+- `.oxfmtrc.json`
+- `.oxfmtrc.jsonc`
+- `oxfmt.config.*`
+- `.editorconfig`
+- `ignorePatterns`
+- `.gitignore`
+- `.prettierignore`
+- default ignored directories
+- default ignored lockfiles
+
+Note: ESLint still controls file discovery. Files excluded by ESLint will never reach this rule.
+
 ## Integration
 
 ### Parser Compatibility
 
 - `recommended`: forces `eslint-parser-plain` for matched files
 - `recommendedWithoutParser`: parser-agnostic (safe to compose with language-specific parsers)
+- `cliParity`: parser-agnostic preset tuned for CLI-like config/ignore behavior
 
 When composing shareable configs, prefer `recommendedWithoutParser` if parser ownership belongs to another preset.
 

dts/rule-options.d.ts

@@ -134,8 +134,16 @@ export type OxfmtOxfmt = []|[{
 
   configPath?: string
 
+  disableNestedConfig?: boolean
+  
+  ignorePath?: (string | string[])
+  
+  respectOxfmtDefaultIgnores?: boolean
+  
   useConfig?: boolean
 
+  withNodeModules?: boolean
+  
   overrides?: {
 
     excludeFiles?: string[]

package.json

@@ -2,7 +2,7 @@
   "name": "eslint-plugin-oxfmt",
   "type": "module",
   "version": "0.5.1",
-  "packageManager": "pnpm@10.33.2",
+  "packageManager": "pnpm@10.33.4",
   "description": "An ESLint plugin for formatting code with oxfmt.",
   "keywords": [
     "eslint",
@@ -65,17 +65,17 @@
   },
   "dependencies": {
     "generate-differences": "^0.1.1",
-    "load-oxfmt-config": "^0.4.1",
+    "load-oxfmt-config": "^0.5.0",
     "picomatch": "^4.0.4",
     "synckit": "^0.11.12"
   },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^6.1.1",
+    "@ntnyq/eslint-config": "^6.1.3",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260429.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260506.1",
     "bumpp": "^11.0.1",
-    "eslint": "^10.2.1",
+    "eslint": "^10.3.0",
     "eslint-parser-plain": "^0.1.1",
     "eslint-plugin-oxfmt": "workspace:*",
     "eslint-typegen": "^2.3.1",
@@ -84,7 +84,7 @@
     "jsonc-eslint-parser": "^3.1.0",
     "nano-staged": "^1.0.2",
     "npm-run-all2": "^8.0.4",
-    "oxfmt": "^0.47.0",
+    "oxfmt": "^0.48.0",
     "show-invisibles": "^0.0.2",
     "tinyglobby": "^0.2.16",
     "tsdown": "^0.21.10",