feat: adopt load-oxfmt-config latest API and add cli parity mode (#17)

Author: ntnyq

.github/copilot-instructions.md

@@ -12,3 +12,5 @@ lib-cov
 *.tsbuildinfo
 
 **/.vitepress/cache
+
+!tests/fixtures/**/node_modules/

.gitignore

@@ -0,0 +1,54 @@
+# AGENTS
+
+Guidance for AI coding agents working in this repository.
+
+## Project Snapshot
+
+- Package: ESLint flat-config plugin that formats files through oxfmt.
+- Runtime requirements: ESLint >= 9, Node ^20.19.0 or >=22.12.0.
+- Package manager: pnpm.
+
+See: [README.md](README.md)
+
+## Commands To Use
+
+- Install: `pnpm install`
+- Build: `pnpm build`
+- Test: `pnpm test`
+- Lint: `pnpm lint`
+- Typecheck: `pnpm typecheck`
+- Schema parity check: `pnpm check:schema`
+- Regenerate rule option types: `pnpm update:rule-options`
+- Full release gate: `pnpm release:check`
+
+Source of truth: [package.json](package.json)
+
+## High-Signal Constraints
+
+- Keep changes aligned with flat-config usage and exported presets in [src/configs.ts](src/configs.ts).
+- Do not hand-edit generated types in [dts/rule-options.d.ts](dts/rule-options.d.ts); regenerate via `pnpm update:rule-options`.
+- If schema or option enums change, update [src/schema.ts](src/schema.ts) and run `pnpm check:schema` (script: [scripts/checkSchemaParity.ts](scripts/checkSchemaParity.ts)).
+- Preserve virtual-file skip behavior in rule execution (processor-extracted files) covered by [tests/rules/error-reporting.test.ts](tests/rules/error-reporting.test.ts).
+- Keep config-loading semantics test-aligned, especially when `useConfig` is true (rule-level overrides are still merged), covered by [tests/eslint-plugin.test.ts](tests/eslint-plugin.test.ts).
+
+## Architecture Map
+
+- Plugin entry and exports: [src/index.ts](src/index.ts)
+- ESLint presets (`recommended`, `recommendedWithoutParser`, `cliParity`): [src/configs.ts](src/configs.ts)
+- Core rule implementation: [src/rules/oxfmt.ts](src/rules/oxfmt.ts)
+- Worker bridge and formatting execution: [workers/oxfmt.mjs](workers/oxfmt.mjs)
+- Diff/report generation: [src/reporter.ts](src/reporter.ts)
+- Rule/config types: [src/types.ts](src/types.ts)
+
+## Testing Strategy For Changes
+
+- Prefer targeted test runs first, then full suite before finalizing.
+- For preset or config behavior changes: run [tests/configs.test.ts](tests/configs.test.ts), [tests/cli-parity.test.ts](tests/cli-parity.test.ts), and [tests/eslint-plugin.test.ts](tests/eslint-plugin.test.ts).
+- For formatter/rule behavior changes: run [tests/rules/oxfmt.test.ts](tests/rules/oxfmt.test.ts) and [tests/rules/error-reporting.test.ts](tests/rules/error-reporting.test.ts).
+- For schema-related changes: run [tests/schema-parity.test.ts](tests/schema-parity.test.ts) and `pnpm check:schema`.
+
+## Link-First Docs
+
+- User-facing usage and options: [README.md](README.md)
+- Build and release scripts: [package.json](package.json)
+- Type generation implementation: [scripts/updateRuleOptions.ts](scripts/updateRuleOptions.ts)

AGENTS.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,9 @@ 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.
+- When `useConfig` is `true`, config `overrides` are applied first and rule-level `overrides` are appended after them (later entries win on conflicts).
+- When `useConfig` is `false`, config discovery and config `ignorePatterns` are skipped, while global ignores still apply when `respectOxfmtDefaultIgnores` is enabled.
 
 For detailed behavior, see:
 
@@ -381,12 +400,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.
 

README.md

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

dts/rule-options.d.ts

@@ -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.7.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",
-    "bumpp": "^11.0.1",
-    "eslint": "^10.2.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260507.1",
+    "bumpp": "^11.1.0",
+    "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",