feat: implement home-directory dotfile config discovery

Author: chrisbbreuer

packages/bunfig/src/config.ts

@@ -266,6 +266,30 @@ export async function loadConfig<T>({
     }
   }
 
+  // Also try dotfile configs in user's home directory root (e.g., ~/.<name>.config.*)
+  if (name) {
+    const homeDir = homedir()
+    const homeRootPatterns = [`.${name}.config`]
+
+    if (alias)
+      homeRootPatterns.push(`.${alias}.config`)
+
+    if (verbose)
+      log.info(`Checking user home directory for dotfile configs: ${homeDir}`)
+
+    for (const configPath of homeRootPatterns) {
+      for (const ext of extensions) {
+        const fullPath = resolve(homeDir, `${configPath}${ext}`)
+        const config = await tryLoadConfig(fullPath, configWithEnvVars, arrayStrategy)
+        if (config !== null) {
+          if (verbose)
+            log.success(`Configuration loaded from user home directory: ${fullPath}`)
+          return config
+        }
+      }
+    }
+  }
+
   // Then try package.json (for both name and alias)
   try {
     const pkgPath = resolve(baseDir, 'package.json')

packages/bunfig/test/home-config-integration.test.ts

@@ -33,6 +33,20 @@ describe('Home Config Directory Integration Tests', () => {
       rmSync(testHomeConfigDir, { recursive: true })
   }
 
+  // Helper to clean up root-level home dotfiles for a specific test name/alias
+  const _cleanupHomeDotfiles = (testName: string, alias?: string) => {
+    const home = homedir()
+    const files = [`.${testName}.config.ts`, `.${testName}.config.js`, `.${testName}.config.mjs`, `.${testName}.config.cjs`, `.${testName}.config.json`]
+    if (alias) {
+      files.push(`.${alias}.config.ts`, `.${alias}.config.js`, `.${alias}.config.mjs`, `.${alias}.config.cjs`, `.${alias}.config.json`)
+    }
+    for (const f of files) {
+      const p = resolve(home, f)
+      if (existsSync(p))
+        rmSync(p)
+    }
+  }
+
   describe('Real home config loading', () => {
     it('should load config from real ~/.config/$name/config.ts', async () => {
       const testName = generateTestName()
@@ -62,7 +76,7 @@ describe('Home Config Directory Integration Tests', () => {
         })
       }
       finally {
-        cleanupHomeConfig(testName)
+        _cleanupHomeDotfiles(testName)
       }
     })