load-oxfmt-config 0.8.0 → 0.9.0

package/README.md

@@ -5,12 +5,12 @@
 [![NPM DOWNLOADS](https://img.shields.io/npm/dy/load-oxfmt-config.svg)](https://www.npmjs.com/package/load-oxfmt-config)
 [![LICENSE](https://img.shields.io/github/license/ntnyq/load-oxfmt-config.svg)](https://github.com/ntnyq/load-oxfmt-config/blob/main/LICENSE)
 
-> Load and resolve oxfmt configuration files and merge supported `.editorconfig` settings for [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html).
+> Load and resolve oxfmt configuration files, including explicit JS/TS config paths, and merge supported `.editorconfig` settings for [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html).
 
 ## Features
 
 - 🔍 **Auto-discovery** - Automatically searches for config files in current and parent directories
-- 📦 **Multiple formats** - Supports `.oxfmtrc.json`, `.oxfmtrc.jsonc`, and `oxfmt.config.ts`
+- 📦 **Multiple formats** - Auto-discovers `.oxfmtrc.json`, `.oxfmtrc.jsonc`, and `oxfmt.config.ts`, and also supports explicit `.js` / `.mjs` / `.cjs` / `.mts` / `.cts` config paths
 - 🧩 **EditorConfig fallback** - Merges supported `.editorconfig` fields into the returned oxfmt config result
 - 🚫 **Ignore resolution** - Resolves ignore status with oxfmt CLI-like global + config-scoped semantics
 - ⚡ **Built-in caching** - Caches both file resolution and parsed configs for optimal performance
@@ -31,6 +31,8 @@ yarn add load-oxfmt-config
 pnpm add load-oxfmt-config
 ```
 
+> `oxfmt` is a peer dependency and should be installed alongside this package.
+
 ## Usage
 
 ### Basic Usage
@@ -189,7 +191,16 @@ Option fields:
 - **Type:** `string`
 - **Default:** `process.cwd()`
 
-Current working directory to start searching for config files. The loader will walk up from this directory to find a config file.
+Current working directory for config resolution.
+By default config discovery starts here, unless `filepath` is provided.
+
+#### `filepath`
+
+- **Type:** `string`
+- **Default:** `undefined`
+
+Target file path for nested config resolution.
+When provided (and `configPath` is not set), config discovery starts from `dirname(filepath)` and walks upward to match oxfmt per-file semantics.
 
 #### `configPath`
 
@@ -202,6 +213,14 @@ Explicit path to the config file:
 - **Absolute path:** Used as-is
 - **When provided:** Skips auto-discovery and uses this path directly
 
+#### `disableNestedConfig`
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Disable nested config lookup.
+When `true`, config discovery is anchored to `cwd` (or explicit `configPath`) instead of `filepath`.
+
 #### `useCache`
 
 - **Type:** `boolean`
@@ -222,7 +241,9 @@ Set to `false` to force reload from disk on every call.
 
 Control how `.editorconfig` files are read and merged:
 
-- **`true`** — Read and merge the nearest `.editorconfig`, walking up from the config file's directory (or `cwd` when no config path is given).
+- **`true`** — Read and merge the nearest `.editorconfig`, walking up from the config-discovery start directory:
+  - `dirname(filepath)` when nested lookup is enabled and `filepath` is provided
+  - otherwise `cwd`
 - **`false`** — Disable `.editorconfig` reading entirely.
 - **`EditorconfigOption`** — Enable with additional settings:
 
@@ -343,7 +364,7 @@ When `false`, `isOxfmtIgnored()` only applies global ignore and skips config loa
 
 When `configPath` is not provided, the loader automatically searches for config files:
 
-1. **Search order:** Starts from `cwd` and walks up to parent directories
+1. **Search order:** Starts from `dirname(filepath)` when `filepath` is provided **and nested lookup is enabled**; otherwise starts from `cwd`, then walks up to parent directories
 2. **Supported filenames:**
    - `.oxfmtrc.json`
    - `.oxfmtrc.jsonc`
@@ -351,7 +372,7 @@ When `configPath` is not provided, the loader automatically searches for config
 3. **Stops when:**
    - A valid config file is found
    - Reaches the filesystem root
-4. **EditorConfig:** The nearest `.editorconfig` is also resolved and merged into the returned result
+4. **EditorConfig:** The nearest `.editorconfig` is resolved from the same start directory and merged into the returned result
 5. **Returns:** Empty object `{}` if no config file is found
 
 ## Supported Config Formats
@@ -443,6 +464,7 @@ Notes:
   - default: nearest config from target file directory upward
   - `disableNestedConfig: true`: resolve from `cwd` only
   - `configPath`: also disables nested lookup (same intent as CLI `-c`)
+  - invalid nested config only fails files that resolve to that config (no project-wide pre-scan)
 
 ## Precedence
 
@@ -468,7 +490,7 @@ try {
   const result = await loadOxfmtConfig()
   console.log(result.config)
 } catch (error) {
-  // Thrown when config file exists but contains invalid JSON/JSONC
+  // Thrown when a resolved config file cannot be parsed or loaded
   console.error('Failed to parse oxfmt config:', error.message)
 }
 ```
@@ -483,6 +505,7 @@ The caching system maintains two separate caches:
 **Cache keys are based on:**
 
 - `cwd` + `configPath` for path resolution
+- or `dirname(filepath)` + `configPath` when `filepath` is provided and nested lookup is enabled
 - Resolved oxfmt path and resolved `.editorconfig` path for config content
 
 **Cache invalidation:**

package/dist/index.d.mts

@@ -48,6 +48,19 @@ interface LoadOxfmtConfigOptions {
    * Current working directory
    */
   cwd?: string;
+  /**
+   * File path being formatted. When provided (and `configPath` is not set),
+   * config discovery starts from this file's directory to match oxfmt nested
+   * config behavior.
+   */
+  filepath?: string;
+  /**
+   * Disable nested config lookup.
+   * When true, config discovery is anchored to `cwd` (or explicit `configPath`).
+   *
+   * @default false
+   */
+  disableNestedConfig?: boolean;
   /**
    * Whether to use cache
    */

package/dist/index.mjs

@@ -399,15 +399,17 @@ const configCache = /* @__PURE__ */ new Map();
 async function loadOxfmtConfig(options = {}) {
 	const useCache = options.useCache !== false;
 	const cwd = resolve(options.cwd || process.cwd());
+	const filepath = options.filepath ? resolve(cwd, options.filepath) : void 0;
+	const configLookupCwd = options.configPath || options.disableNestedConfig || !filepath ? cwd : dirname(filepath);
 	const editorconfig = options.editorconfig ?? true;
 	const useEditorconfig = editorconfig !== false;
 	const isEditorconfigOptionsObject = useEditorconfig && isObject(editorconfig);
 	const onlyCwd = isEditorconfigOptionsObject ? editorconfig.onlyCwd ?? false : false;
 	const editorconfigCwd = isEditorconfigOptionsObject && editorconfig.cwd ? resolve(editorconfig.cwd) : void 0;
-	const resolveKey = getResolveCacheKey(cwd, options.configPath);
-	const editorconfigSearchDir = editorconfigCwd || getEditorconfigSearchDir(cwd, options.configPath);
+	const resolveKey = getResolveCacheKey(configLookupCwd, options.configPath);
+	const editorconfigSearchDir = editorconfigCwd || getEditorconfigSearchDir(configLookupCwd, options.configPath);
 	const editorconfigResolveKey = editorconfigCwd ? getEditorconfigResolveCacheKey(`${editorconfigCwd}::${options.configPath || ""}`) : getEditorconfigResolveCacheKey(resolveKey);
-	const resolvedPath = useCache ? await cachePromise(resolveCache, resolveKey, () => resolveOxfmtrcPath(cwd, options.configPath)) : await resolveOxfmtrcPath(cwd, options.configPath);
+	const resolvedPath = useCache ? await cachePromise(resolveCache, resolveKey, () => resolveOxfmtrcPath(configLookupCwd, options.configPath)) : await resolveOxfmtrcPath(configLookupCwd, options.configPath);
 	const editorconfigPath = useEditorconfig ? await (useCache ? cachePromise(resolveCache, editorconfigResolveKey, () => resolveEditorconfigPath(editorconfigSearchDir, onlyCwd)) : resolveEditorconfigPath(editorconfigSearchDir, onlyCwd)) : void 0;
 	const anchorDir = dirname(resolvedPath || editorconfigPath || cwd);
 	const loadTask = async () => {
@@ -647,7 +649,9 @@ async function isOxfmtIgnored(options) {
 	}
 	if (!loadConfigForIgnorePatterns) return { ignored: false };
 	const configResult = await loadOxfmtConfig({
-		cwd: options.configPath || options.disableNestedConfig ? cwd : dirname(filepath),
+		cwd,
+		filepath,
+		...options.disableNestedConfig === true ? { disableNestedConfig: true } : {},
 		...options.configPath ? { configPath: options.configPath } : {},
 		editorconfig: false,
 		useCache

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "load-oxfmt-config",
-  "version": "0.8.0",
-  "description": "Load oxfmt config files and merge supported .editorconfig options.",
+  "version": "0.9.0",
+  "description": "Load and resolve oxfmt configuration files, including explicit JS/TS config paths, and merge supported `.editorconfig` settings for Oxfmt.",
   "keywords": [
     "editorconfig",
     "jsonc-parser",
@@ -48,20 +48,20 @@
   },
   "devDependencies": {
     "@ntnyq/tsconfig": "^3.1.0",
-    "@types/node": "^25.7.0",
+    "@types/node": "^25.8.0",
     "@types/picomatch": "^4.0.3",
-    "@typescript/native-preview": "^7.0.0-dev.20260511.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260517.1",
     "bumpp": "^11.1.0",
     "husky": "^9.1.7",
     "nano-staged": "^1.0.2",
     "npm-run-all2": "^8.0.4",
-    "oxfmt": "^0.49.0",
-    "oxlint": "^1.64.0",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.65.0",
     "tsdown": "^0.22.0",
     "vitest": "^4.1.6"
   },
   "peerDependencies": {
-    "oxfmt": ">=0.49.0"
+    "oxfmt": ">=0.50.0"
   },
   "nano-staged": {
     "*.{js,ts,mjs,tsx}": "oxlint --fix",