load-oxfmt-config 0.7.2 → 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
@@ -38,19 +40,19 @@ pnpm add load-oxfmt-config
 Load config from current directory or parent directories:
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Automatically searches for oxfmt config files and the nearest .editorconfig
-const result = await loadOxfmtConfigResult()
+const result = await loadOxfmtConfig()
 console.log(result.config) // { printWidth: 80, ... }
 ```
 
 ### Merge With `.editorconfig`
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
-const result = await loadOxfmtConfigResult({ cwd: '/path/to/project' })
+const result = await loadOxfmtConfig({ cwd: '/path/to/project' })
 
 // Returns one merged static config object
 console.log(result.config)
@@ -66,9 +68,9 @@ console.log(result.config)
 ### Specify Working Directory
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   cwd: '/path/to/project',
 })
 ```
@@ -76,9 +78,9 @@ const result = await loadOxfmtConfigResult({
 ### Get Config Metadata
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
-const result = await loadOxfmtConfigResult({ cwd: '/path/to/project' })
+const result = await loadOxfmtConfig({ cwd: '/path/to/project' })
 
 console.log(result.config) // merged oxfmt options
 console.log(result.filepath) // /path/to/project/.oxfmtrc.json (or undefined)
@@ -102,16 +104,16 @@ console.log(result)
 ### Explicit Config Path
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Relative path (resolved relative to cwd)
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   configPath: 'configs/.oxfmtrc.json',
   cwd: '/path/to/project',
 })
 
 // Absolute path
-const absoluteResult = await loadOxfmtConfigResult({
+const absoluteResult = await loadOxfmtConfig({
   configPath: '/absolute/path/to/.oxfmtrc.json',
 })
 ```
@@ -119,10 +121,10 @@ const absoluteResult = await loadOxfmtConfigResult({
 ### Disable `.editorconfig`
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Skip .editorconfig reading entirely
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   editorconfig: false,
 })
 ```
@@ -130,10 +132,10 @@ const result = await loadOxfmtConfigResult({
 ### Limit `.editorconfig` to `cwd`
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Only look in the cwd directory itself, no upward traversal
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   editorconfig: { onlyCwd: true },
 })
 ```
@@ -141,10 +143,10 @@ const result = await loadOxfmtConfigResult({
 ### Override `.editorconfig` Search Directory
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Search .editorconfig from a custom directory instead of the config file's directory
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   editorconfig: {
     cwd: '/path/to/editorconfig-dir',
   },
@@ -154,23 +156,14 @@ const result = await loadOxfmtConfigResult({
 ### Disable Caching
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 // Force reload from disk, bypassing cache
-const result = await loadOxfmtConfigResult({
+const result = await loadOxfmtConfig({
   useCache: false,
 })
 ```
 
-### Legacy API (Deprecated)
-
-```ts
-import { loadOxfmtConfig } from 'load-oxfmt-config'
-
-// Deprecated: prefer loadOxfmtConfigResult
-const config = await loadOxfmtConfig({ cwd: '/path/to/project' })
-```
-
 ### Path Resolution Only
 
 ```ts
@@ -185,9 +178,7 @@ console.log(configPath) // '/path/to/.oxfmtrc.json' or undefined
 
 ### `loadOxfmtConfig(options?)`
 
-> Deprecated. Prefer `loadOxfmtConfigResult(options?)`.
-
-Load and parse oxfmt configuration files, then merge supported `.editorconfig` fields into the returned result.
+Load and parse oxfmt configuration files, merge supported `.editorconfig` fields, and return metadata for the resolved config file.
 
 **Parameters:**
 
@@ -200,66 +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.
 
-#### `configPath`
+#### `filepath`
 
 - **Type:** `string`
 - **Default:** `undefined`
 
-Explicit path to the config file:
-
-- **Relative path:** Resolved relative to `cwd`
-- **Absolute path:** Used as-is
-- **When provided:** Skips auto-discovery and uses this path directly
-
-#### `useCache`
-
-- **Type:** `boolean`
-- **Default:** `true`
-
-Enable in-memory caching for both path resolution and parsed config contents. When enabled:
-
-- Config file paths are cached to avoid repeated filesystem lookups
-- Parsed config objects are cached to avoid re-parsing
-- Subsequent calls with the same parameters return cached results instantly
-
-Set to `false` to force reload from disk on every call.
-
-#### `editorconfig`
-
-- **Type:** `boolean | EditorconfigOption`
-- **Default:** `true`
-
-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).
-- **`false`** — Disable `.editorconfig` reading entirely.
-- **`EditorconfigOption`** — Enable with additional settings:
-
-| Property  | Type      | Default     | Description                                                                                                           |
-| --------- | --------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
-| `onlyCwd` | `boolean` | `false`     | When `true`, only look for `.editorconfig` in `cwd` itself — no upward traversal.                                     |
-| `cwd`     | `string`  | `undefined` | Override the directory from which `.editorconfig` resolution starts, instead of the config file's directory or `cwd`. |
-
-**Returns:** `Promise<OxfmtOptions>` - Parsed and merged oxfmt configuration object. Returns empty object `{}` if no supported config file is found.
-
-### `loadOxfmtConfigResult(options?)`
-
-Load and parse oxfmt configuration files, merge supported `.editorconfig` fields, and return metadata for the resolved config file.
-
-**Parameters:**
-
-- `options` - Optional configuration object (`LoadOxfmtConfigOptions`)
-
-Option fields:
-
-#### `cwd`
-
-- **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.
+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`
 
@@ -272,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`
@@ -292,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:
 
@@ -336,7 +287,7 @@ Option fields:
 - **Default:** `process.cwd()`
 
 Current working directory.
-Also the base directory for default `.gitignore`/`.prettierignore` lookup.
+Also the base directory for default `.prettierignore` lookup.
 
 #### `filepath`
 
@@ -358,7 +309,7 @@ When provided, nested config lookup is disabled (same as oxfmt CLI `-c`).
 - **Type:** `string | string[]`
 - **Default:** `undefined`
 
-Ignore files to use instead of cwd `.gitignore`/`.prettierignore`.
+Ignore files to use instead of default `.gitignore` hierarchy + cwd `.prettierignore`.
 Can be passed multiple times in CLI style.
 
 #### `withNodeModules`
@@ -404,6 +355,7 @@ When `false`, `isOxfmtIgnored()` only applies global ignore and skips config loa
   - `default-dir`
   - `lockfile`
   - `gitignore`
+  - `git-info-exclude`
   - `prettierignore`
   - `ignore-path`
   - `config-ignore-patterns`
@@ -412,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`
@@ -420,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
@@ -495,16 +447,15 @@ Global ignore includes:
 - Default lockfiles: `package-lock.json`, `npm-shrinkwrap.json`, `pnpm-lock.yaml`, `yarn.lock`, `bun.lock`, `bun.lockb`
 - Ignore files:
   - If `ignorePath` is provided: use those files only (multiple supported)
-  - If `ignorePath` is not provided: use `.gitignore` and `.prettierignore` from `cwd`
+  - If `ignorePath` is not provided:
+    - Read `.gitignore` from the file's directory upward until the git repo boundary
+    - Read `<repo>/.git/info/exclude` when inside a git repo
+    - Read `.prettierignore` from `cwd`
 
 Notes:
 
 - `node_modules` can be included by passing `withNodeModules: true`.
 
-Type compatibility note:
-
-- `Options` is still exported as a deprecated alias of `LoadOxfmtConfigOptions`.
-- This package does not read parent `.gitignore` files or global gitignore settings.
 - The default lockfile list mirrors oxfmt documentation intent (`package-lock.json`, `pnpm-lock.yaml`, etc.) and common ecosystem lockfiles. It is not guaranteed to be a complete internal oxfmt list.
 - `ignorePatterns` are always interpreted relative to the resolved oxfmt config directory.
 - `includeConfigIgnorePatterns` defaults to `true` to preserve current behavior.
@@ -513,6 +464,7 @@ Type compatibility note:
   - 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
 
@@ -527,18 +479,18 @@ This means explicit oxfmt config values always win over `.editorconfig` fallback
 
 ## Limitations
 
-`loadOxfmtConfigResult()` (and the deprecated `loadOxfmtConfig()`) returns a static merged `OxfmtOptions` shape. That means `.editorconfig` support is represented as merged root + overrides config data, not as per-file runtime evaluation. In practice this works well for common root settings and section-based overrides, but it is not a full replacement for oxfmt's own file-by-file config resolution.
+`loadOxfmtConfig()` returns a static merged `OxfmtOptions` shape. That means `.editorconfig` support is represented as merged root + overrides config data, not as per-file runtime evaluation. In practice this works well for common root settings and section-based overrides, but it is not a full replacement for oxfmt's own file-by-file config resolution.
 
 ## Error Handling
 
 ```ts
-import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+import { loadOxfmtConfig } from 'load-oxfmt-config'
 
 try {
-  const result = await loadOxfmtConfigResult()
+  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)
 }
 ```
@@ -553,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
    */
@@ -100,7 +113,7 @@ interface LoadOxfmtConfigResult {
 interface IsOxfmtIgnoredOptions {
   /**
    * Current working directory.
-   * Also the base directory for default .gitignore/.prettierignore lookup.
+   * Also the base directory for default `.prettierignore` lookup.
    */
   cwd?: string;
   /**
@@ -113,7 +126,7 @@ interface IsOxfmtIgnoredOptions {
    */
   configPath?: string;
   /**
-   * Ignore files to use instead of cwd .gitignore/.prettierignore.
+   * Ignore files to use instead of default `.gitignore` hierarchy + cwd `.prettierignore`.
    * Can be passed multiple times in CLI style.
    */
   ignorePath?: string | string[];
@@ -155,16 +168,8 @@ interface IsOxfmtIgnoredResult {
   /**
    * Matched ignore source.
    */
-  reason?: 'default-dir' | 'lockfile' | 'gitignore' | 'prettierignore' | 'ignore-path' | 'config-ignore-patterns';
+  reason?: 'default-dir' | 'lockfile' | 'gitignore' | 'git-info-exclude' | 'prettierignore' | 'ignore-path' | 'config-ignore-patterns';
 }
-/**
- * @deprecated Use `OxfmtConfigOverride` instead
- */
-type FormatOptionOverride = OxfmtConfigOverride;
-/**
- * @deprecated Use `LoadOxfmtConfigOptions` instead.
- */
-type Options = LoadOxfmtConfigOptions;
 //#endregion
 //#region src/config-file.d.ts
 /**
@@ -196,13 +201,13 @@ declare function resolveOxfmtrcPath(cwd: string, configPath?: string): Promise<s
  *
  * @example
  * ```ts
- * import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+ * import { loadOxfmtConfig } from 'load-oxfmt-config'
  *
- * const result = await loadOxfmtConfigResult({ cwd: process.cwd() })
+ * const result = await loadOxfmtConfig({ cwd: process.cwd() })
  * console.log(result.config)
  * ```
  */
-declare function loadOxfmtConfigResult(options?: LoadOxfmtConfigOptions): Promise<LoadOxfmtConfigResult>;
+declare function loadOxfmtConfig(options?: LoadOxfmtConfigOptions): Promise<LoadOxfmtConfigResult>;
 //#endregion
 //#region src/ignore.d.ts
 /**
@@ -223,25 +228,4 @@ declare function loadOxfmtConfigResult(options?: LoadOxfmtConfigOptions): Promis
  */
 declare function isOxfmtIgnored(options: IsOxfmtIgnoredOptions): Promise<IsOxfmtIgnoredResult>;
 //#endregion
-//#region src/legacy.d.ts
-/**
- * Legacy API that returns only the merged config object.
- *
- * Prefer using `loadOxfmtConfigResult` when you also need resolved config metadata.
- *
- * @deprecated Prefer `loadOxfmtConfigResult`.
- *
- * @param options - Loader options.
- * @returns Parsed and merged oxfmt options.
- *
- * @example
- * ```ts
- * import { loadOxfmtConfig } from 'load-oxfmt-config'
- *
- * // Deprecated: prefer loadOxfmtConfigResult.
- * const config = await loadOxfmtConfig({ cwd: process.cwd() })
- * ```
- */
-declare function loadOxfmtConfig(options?: LoadOxfmtConfigOptions): Promise<OxfmtOptions>;
-//#endregion
-export { EditorconfigOption, FormatOptionOverride, IsOxfmtIgnoredOptions, IsOxfmtIgnoredResult, LoadOxfmtConfigOptions, LoadOxfmtConfigResult, Options, OxfmtConfigOverride, OxfmtOptions, isOxfmtIgnored, loadOxfmtConfig, loadOxfmtConfigResult, resolveOxfmtrcPath };
+export { EditorconfigOption, IsOxfmtIgnoredOptions, IsOxfmtIgnoredResult, LoadOxfmtConfigOptions, LoadOxfmtConfigResult, OxfmtConfigOverride, OxfmtOptions, isOxfmtIgnored, loadOxfmtConfig, resolveOxfmtrcPath };

package/dist/index.mjs

@@ -53,10 +53,6 @@ const DEFAULT_IGNORED_LOCKFILES = [
 	"bun.lockb"
 ];
 /**
-* Default ignore files loaded from cwd when --ignore-path is not provided.
-*/
-const DEFAULT_IGNORE_FILES = [".gitignore", ".prettierignore"];
-/**
 * Supported EditorConfig filename.
 */
 const EDITORCONFIG_FILE = ".editorconfig";
@@ -394,24 +390,26 @@ const configCache = /* @__PURE__ */ new Map();
 *
 * @example
 * ```ts
-* import { loadOxfmtConfigResult } from 'load-oxfmt-config'
+* import { loadOxfmtConfig } from 'load-oxfmt-config'
 *
-* const result = await loadOxfmtConfigResult({ cwd: process.cwd() })
+* const result = await loadOxfmtConfig({ cwd: process.cwd() })
 * console.log(result.config)
 * ```
 */
-async function loadOxfmtConfigResult(options = {}) {
+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 () => {
@@ -500,12 +498,13 @@ function relativeSafe(from, to) {
 * @param filepath - Absolute file path.
 * @param ignoreFilePath - Ignore file path.
 * @param useCache - Whether to use matcher cache.
+* @param baseDir - Base directory for relative path calculation, defaults to ignore file directory.
 * @returns True when ignored by this file.
 */
-async function matchIgnoreFile(filepath, ignoreFilePath, useCache) {
+async function matchIgnoreFile(filepath, ignoreFilePath, useCache, baseDir) {
 	const matcher = await loadIgnoreMatcher(ignoreFilePath, useCache);
 	if (!matcher) return false;
-	const relativeToIgnore = relativeSafe(dirname(ignoreFilePath), filepath);
+	const relativeToIgnore = relativeSafe(baseDir ?? dirname(ignoreFilePath), filepath);
 	if (relativeToIgnore === ".." || relativeToIgnore.startsWith("../")) return false;
 	return matcher.ignores(relativeToIgnore);
 }
@@ -520,6 +519,62 @@ function resolveIgnoreFilePath(path, cwd) {
 	return isAbsolute(path) ? path : resolve(cwd, path);
 }
 /**
+* Check whether a directory looks like a git repo root.
+*
+* A `.git` entry can be either a directory (regular repo) or a file (worktree/submodule).
+*
+* @param dir - Directory to inspect.
+* @returns True when `.git` exists under the directory.
+*/
+async function hasGitEntry(dir) {
+	try {
+		await stat(join(dir, ".git"));
+		return true;
+	} catch (error) {
+		const code = error.code;
+		if (code === "ENOENT" || code === "ENOTDIR") return false;
+		throw error;
+	}
+}
+/**
+* Find the nearest git repo root by walking up from a start directory.
+*
+* @param fromDir - Directory to start from.
+* @returns Repo root directory, or undefined when no git boundary is found.
+*/
+async function findGitRepoRoot(fromDir) {
+	let current = fromDir;
+	while (true) {
+		if (await hasGitEntry(current)) return current;
+		const parent = dirname(current);
+		if (parent === current) return;
+		current = parent;
+	}
+}
+/**
+* Collect `.gitignore` files from file directory up to git repo boundary.
+*
+* @param filepath - Absolute file path to test.
+* @returns Collected ignore files and repo root when found.
+*/
+async function collectGitignorePaths(filepath) {
+	const fileDir = dirname(filepath);
+	const repoRoot = await findGitRepoRoot(fileDir);
+	const paths = [];
+	let current = fileDir;
+	while (true) {
+		paths.push(join(current, ".gitignore"));
+		if (repoRoot && current === repoRoot) break;
+		const parent = dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return {
+		paths,
+		repoRoot
+	};
+}
+/**
 * Match `ignorePatterns` from config with support for negated patterns.
 *
 * @param filepath - Absolute file path.
@@ -575,13 +630,28 @@ async function isOxfmtIgnored(options) {
 			ignored: true,
 			reason: "ignore-path"
 		};
-	} else for (const ignoreFile of DEFAULT_IGNORE_FILES) if (await matchIgnoreFile(filepath, resolve(cwd, ignoreFile), useCache)) return {
-		ignored: true,
-		reason: ignoreFile === ".gitignore" ? "gitignore" : "prettierignore"
-	};
+	} else {
+		const { paths: gitignorePaths, repoRoot } = await collectGitignorePaths(filepath);
+		for (const ignorePath of gitignorePaths) if (await matchIgnoreFile(filepath, ignorePath, useCache)) return {
+			ignored: true,
+			reason: "gitignore"
+		};
+		if (repoRoot) {
+			if (await matchIgnoreFile(filepath, join(repoRoot, ".git", "info", "exclude"), useCache, repoRoot)) return {
+				ignored: true,
+				reason: "git-info-exclude"
+			};
+		}
+		if (await matchIgnoreFile(filepath, resolve(cwd, ".prettierignore"), useCache)) return {
+			ignored: true,
+			reason: "prettierignore"
+		};
+	}
 	if (!loadConfigForIgnorePatterns) return { ignored: false };
-	const configResult = await loadOxfmtConfigResult({
-		cwd: options.configPath || options.disableNestedConfig ? cwd : dirname(filepath),
+	const configResult = await loadOxfmtConfig({
+		cwd,
+		filepath,
+		...options.disableNestedConfig === true ? { disableNestedConfig: true } : {},
 		...options.configPath ? { configPath: options.configPath } : {},
 		editorconfig: false,
 		useCache
@@ -593,27 +663,4 @@ async function isOxfmtIgnored(options) {
 	return { ignored: false };
 }
 //#endregion
-//#region src/legacy.ts
-/**
-* Legacy API that returns only the merged config object.
-*
-* Prefer using `loadOxfmtConfigResult` when you also need resolved config metadata.
-*
-* @deprecated Prefer `loadOxfmtConfigResult`.
-*
-* @param options - Loader options.
-* @returns Parsed and merged oxfmt options.
-*
-* @example
-* ```ts
-* import { loadOxfmtConfig } from 'load-oxfmt-config'
-*
-* // Deprecated: prefer loadOxfmtConfigResult.
-* const config = await loadOxfmtConfig({ cwd: process.cwd() })
-* ```
-*/
-async function loadOxfmtConfig(options = {}) {
-	return (await loadOxfmtConfigResult(options)).config;
-}
-//#endregion
-export { isOxfmtIgnored, loadOxfmtConfig, loadOxfmtConfigResult, resolveOxfmtrcPath };
+export { isOxfmtIgnored, loadOxfmtConfig, resolveOxfmtrcPath };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "load-oxfmt-config",
-  "version": "0.7.2",
-  "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.6.2",
+    "@types/node": "^25.8.0",
     "@types/picomatch": "^4.0.3",
-    "@typescript/native-preview": "^7.0.0-dev.20260508.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.48.0",
-    "oxlint": "^1.63.0",
+    "oxfmt": "^0.50.0",
+    "oxlint": "^1.65.0",
     "tsdown": "^0.22.0",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.6"
   },
   "peerDependencies": {
-    "oxfmt": ">=0.41.0"
+    "oxfmt": ">=0.50.0"
   },
   "nano-staged": {
     "*.{js,ts,mjs,tsx}": "oxlint --fix",