c12 3.2.0 → 3.3.0

package/README.md

@@ -14,7 +14,7 @@ c12 (pronounced as /siːtwelv/, like c-twelve) is a smart configuration loader.
 
 - `.js`, `.ts`, `.mjs`, `.cjs`, `.mts`, `.cts` `.json` config loader with [unjs/jiti](https://jiti.unjs.io)
 - `.jsonc`, `.json5`, `.yaml`, `.yml`, `.toml` config loader with [unjs/confbox](https://confbox.unjs.io)
-- `.config/` directory support following [config dir proposal](https://github.com/pi0/config-dir)
+- `.config/` directory support ([config dir proposal](https://github.com/pi0/config-dir))
 - `.rc` config support with [unjs/rc9](https://github.com/unjs/rc9)
 - `.env` support with [dotenv](https://www.npmjs.com/package/dotenv)
 - Multiple sources merged with [unjs/defu](https://github.com/unjs/defu)
@@ -26,15 +26,14 @@ c12 (pronounced as /siːtwelv/, like c-twelve) is a smart configuration loader.
 
 ## 🦴 Used by
 
-- [Nuxt](https://nuxt.com/)
-- [Nitro](https://nitro.build/)
-- [Unbuild](https://unbuild.unjs.io)
-- [Automd](https://automd.unjs.io)
-- [Changelogen](https://changelogen.unjs.io)
-- [RemixKit](https://github.com/jrestall/remix-kit)
 - [Hey API](https://github.com/hey-api/openapi-ts)
-- [kysely-ctl](https://github.com/kysely-org/kysely-ctl)
+- [Kysely](https://github.com/kysely-org/kysely-ctl)
+- [Nitro](https://nitro.build/)
+- [Nuxt](https://nuxt.com/)
 - [Prisma](https://github.com/prisma/prisma)
+- [Trigger.dev](https://github.com/triggerdotdev/trigger.dev)
+- [UnJS](https://github.com/unjs)
+- [WXT](https://github.com/wxt-dev/wxt)
 
 ## Usage
 
@@ -103,7 +102,42 @@ Load RC config from the workspace directory and the user's home directory. Only
 
 ### `dotenv`
 
-Loads `.env` file if enabled. It is disabled by default.
+Loads `.env` file when `true` or an options object is passed. It is disabled by default.
+
+Supports loading multiple files that extend eachother in left-to-right order when a `fileName`s array of relative/absolute paths is passed in the options object.
+
+**Example:**
+
+```ini
+# .env
+CONNECTION_POOL_MAX="10"
+DATABASE_URL="<...rds...>"
+```
+
+```ini
+# .env.local
+DATABASE_URL="<...localhost...>"
+```
+
+```js
+export default {
+  connectionPoolMax: process.env.CONNECTION_POOL_MAX,
+  databaseURL: process.env.DATABASE_URL,
+};
+```
+
+```ts
+import { loadConfig } from "c12";
+
+const config = await loadConfig({
+  dotenv: {
+    fileName: [".env", ".env.local"],
+  },
+});
+
+console.log(config.config.connectionPoolMax); // "10"
+console.log(config.config.databaseURL); // "<...localhost...>"
+```
 
 ### `packageJson`
 

package/dist/index.d.mts

@@ -6,8 +6,10 @@ import { diff } from 'ohash/utils';
 interface DotenvOptions {
     /**
      * The project root directory (either absolute or relative to the current working directory).
+     *
+     * Defaults to `options.cwd` in `loadConfig` context, or `process.cwd()` when used as standalone.
      */
-    cwd: string;
+    cwd?: string;
     /**
      * What file or files to look in for environment variables (either absolute or relative
      * to the current working directory). For example, `.env`.

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { l as loadConfig, S as SUPPORTED_EXTENSIONS } from './shared/c12.DDjD4HmS.mjs';
-export { a as loadDotenv, s as setupDotenv } from './shared/c12.DDjD4HmS.mjs';
+import { l as loadConfig, S as SUPPORTED_EXTENSIONS } from './shared/c12.Bzgyhsy6.mjs';
+export { a as loadDotenv, s as setupDotenv } from './shared/c12.Bzgyhsy6.mjs';
 import { debounce } from 'perfect-debounce';
 import { resolve } from 'pathe';
 import 'node:fs';

package/dist/shared/{c12.DDjD4HmS.mjs → c12.Bzgyhsy6.mjs}

@@ -31,12 +31,13 @@ async function setupDotenv(options) {
 }
 async function loadDotenv(options) {
   const environment = /* @__PURE__ */ Object.create(null);
+  const cwd = resolve(options.cwd || ".");
   const _fileName = options.fileName || ".env";
   const dotenvFiles = typeof _fileName === "string" ? [_fileName] : _fileName;
   const dotenvVars = getDotEnvVars(options.env || {});
   Object.assign(environment, options.env);
   for (const file of dotenvFiles) {
-    const dotenvFile = resolve(options.cwd, file);
+    const dotenvFile = resolve(cwd, file);
     if (!statSync(dotenvFile, { throwIfNoEntry: false })?.isFile()) {
       continue;
     }
@@ -201,18 +202,22 @@ async function loadConfig(options) {
     const value = rawConfigs[key];
     configs[key] = await (typeof value === "function" ? value({ configs, rawConfigs }) : value);
   }
-  r.config = _merger(
-    configs.overrides,
-    configs.main,
-    configs.rc,
-    configs.packageJson,
-    configs.defaultConfig
-  );
-  if (options.extend) {
-    await extendConfig(r.config, options);
-    r.layers = r.config._layers;
-    delete r.config._layers;
-    r.config = _merger(r.config, ...r.layers.map((e) => e.config));
+  if (Array.isArray(configs.main)) {
+    r.config = configs.main;
+  } else {
+    r.config = _merger(
+      configs.overrides,
+      configs.main,
+      configs.rc,
+      configs.packageJson,
+      configs.defaultConfig
+    );
+    if (options.extend) {
+      await extendConfig(r.config, options);
+      r.layers = r.config._layers;
+      delete r.config._layers;
+      r.config = _merger(r.config, ...r.layers.map((e) => e.config));
+    }
   }
   const baseLayers = [
     configs.overrides && {
@@ -305,6 +310,7 @@ const GIGET_PREFIXES = [
 ];
 const NPM_PACKAGE_RE = /^(@[\da-z~-][\d._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*($|\/.*)/;
 async function resolveConfig(source, options, sourceOptions = {}) {
+  const originalSource = source;
   if (options.resolve) {
     const res2 = await options.resolve(source, options);
     if (res2) {
@@ -362,7 +368,7 @@ async function resolveConfig(source, options, sourceOptions = {}) {
   res.configFile = tryResolve(resolve(cwd, source), options) || tryResolve(
     resolve(cwd, ".config", source.replace(/\.config$/, "")),
     options
-  ) || tryResolve(resolve(cwd, ".config", source), options) || source;
+  ) || tryResolve(resolve(cwd, ".config", source), options) || tryResolve(resolve(options.cwd || cwd, originalSource), options) || source;
   if (!existsSync(res.configFile)) {
     return res;
   }

package/dist/update.mjs

@@ -1,5 +1,5 @@
 import { resolveModulePath } from 'exsolve';
-import { S as SUPPORTED_EXTENSIONS } from './shared/c12.DDjD4HmS.mjs';
+import { S as SUPPORTED_EXTENSIONS } from './shared/c12.Bzgyhsy6.mjs';
 import { join, normalize } from 'pathe';
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
 import { dirname, extname } from 'node:path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c12",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Smart Config Loader",
   "repository": "unjs/c12",
   "license": "MIT",
@@ -34,28 +34,28 @@
     "chokidar": "^4.0.3",
     "confbox": "^0.2.2",
     "defu": "^6.1.4",
-    "dotenv": "^17.2.1",
+    "dotenv": "^17.2.2",
     "exsolve": "^1.0.7",
     "giget": "^2.0.0",
     "jiti": "^2.5.1",
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
-    "perfect-debounce": "^1.0.0",
-    "pkg-types": "^2.2.0",
+    "perfect-debounce": "^2.0.0",
+    "pkg-types": "^2.3.0",
     "rc9": "^2.1.2"
   },
   "devDependencies": {
-    "@types/node": "^24.1.0",
+    "@types/node": "^24.4.0",
     "@vitest/coverage-v8": "^3.2.4",
     "automd": "^0.4.0",
     "changelogen": "^0.6.2",
-    "eslint": "^9.32.0",
+    "eslint": "^9.35.0",
     "eslint-config-unjs": "^0.5.0",
     "expect-type": "^1.2.2",
     "magicast": "^0.3.5",
     "prettier": "^3.6.2",
-    "typescript": "^5.8.3",
-    "unbuild": "^3.6.0",
+    "typescript": "^5.9.2",
+    "unbuild": "^3.6.1",
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
@@ -66,5 +66,5 @@
       "optional": true
     }
   },
-  "packageManager": "pnpm@10.13.1"
+  "packageManager": "pnpm@10.16.1"
 }