c12 1.1.2 → 1.3.0

package/README.md

@@ -1,19 +1,21 @@
-# c12
+# ⚙️ c12
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![Github Actions][github-actions-src]][github-actions-href]
 [![Codecov][codecov-src]][codecov-href]
+[![License][license-src]][license-href]
 
-> Smart Configuration Loader
+Smart Configuration Loader.
 
 ## Features
 
-- JSON, CJS, Typescript and ESM config loader with [unjs/jiti](https://github.com/unjs/jiti)
+- JSON, CJS, Typescript, and ESM config loader with [unjs/jiti](https://github.com/unjs/jiti)
 - RC config support with [unjs/rc9](https://github.com/unjs/rc9)
 - Multiple sources merged with [unjs/defu](https://github.com/unjs/defu)
 - `.env` support with [dotenv](https://www.npmjs.com/package/dotenv)
-- Support extending nested configurations from multiple local or git sources
+- Reads config from the nearest `package.json` file
+- [Extends configurations](https://github.com/unjs/c12#extending-configuration) from multiple local or git sources
+- Overwrite with [environment-specific configuration](#environment-specific-configuration)
 
 ## Usage
 
@@ -34,48 +36,49 @@ Import:
 
 ```js
 // ESM
-import { loadConfig } from 'c12'
+import { loadConfig } from "c12";
 
 // CommonJS
-const { loadConfig } = require('c12')
+const { loadConfig } = require("c12");
 ```
 
 Load configuration:
 
 ```js
 // Get loaded config
-const { config } = await loadConfig({})
+const { config } = await loadConfig({});
 
 // Get resolved config and extended layers
-const { config, configFile, layers } = await loadConfig({})
+const { config, configFile, layers } = await loadConfig({});
 ```
 
 ## Loading priority
 
 c12 merged config sources with [unjs/defu](https://github.com/unjs/defu) by below order:
 
-1. config overrides passed by options
-2. config file in CWD
+1. Config overrides passed by options
+2. Config file in CWD
 3. RC file in CWD
-4. global RC file in user's home directory
-5. default config passed by options
-6. Extended config layers
+4. Global RC file in user's home directory
+5. Config from `package.json`
+6. Default config passed by options
+7. Extended config layers
 
 ## Options
 
 ### `cwd`
 
-Resolve configuration from this working directory. Default is `process.cwd()`
+Resolve configuration from this working directory. The default is `process.cwd()`
 
 ### `name`
 
-Configuration base name. Default is `config`.
+Configuration base name. The default is `config`.
 
 ### `configName`
 
-Configuration file name without extension . Default is generated from `name` (name=foo => `foo.config`).
+Configuration file name without extension. Default is generated from `name` (name=foo => `foo.config`).
 
-Set to `false` to avoid loading config file.
+Set to `false` to avoid loading the config file.
 
 ### `rcFile`
 
@@ -85,12 +88,20 @@ Set to `false` to disable loading RC config.
 
 ### `globalRC`
 
-Load RC config from the workspace directory and user's home directory. Only enabled when `rcFile` is provided. Set to `false` to disable this functionality.
+Load RC config from the workspace directory and the user's home directory. Only enabled when `rcFile` is provided. Set to `false` to disable this functionality.
 
 ### `dotenv`
 
 Loads `.env` file if enabled. It is disabled by default.
 
+### `packageJson`
+
+Loads config from nearest `package.json` file. It is disabled by default.
+
+If `true` value is passed, c12 uses `name` field from `package.json`.
+
+You can also pass either a string or an array of strings as a value to use those fields.
+
 ### `defaults`
 
 Specify default configuration. It has the **lowest** priority and is applied **after extending** config.
@@ -99,7 +110,7 @@ Specify default configuration. It has the **lowest** priority and is applied **a
 
 Specify default configuration. It is applied **before** extending config.
 
-### `overides`
+### `overrides`
 
 Specify override configuration. It has the **highest** priority and is applied **before extending** config.
 
@@ -111,16 +122,22 @@ Custom [unjs/jiti](https://github.com/unjs/jiti) instance used to import configu
 
 Custom [unjs/jiti](https://github.com/unjs/jiti) options to import configuration files.
 
+### `envName`
+
+Environment name used for [environment specific configuration](#environment-specific-configuration).
+
+The default is `process.env.NODE_ENV`. You can set `envName` to `false` or an empty string to disable the feature.
+
 ## Extending configuration
 
-If resolved config contains a `extends` key, it will be used to extend configuration.
+If resolved config contains a `extends` key, it will be used to extend the configuration.
 
 Extending can be nested and each layer can extend from one base or more.
 
-Final config is merged result of extended options and user options with [unjs/defu](https://github.com/unjs/defu).
+The final config is merged result of extended options and user options with [unjs/defu](https://github.com/unjs/defu).
 
-Each item in extends, is a string that can be either an absolute or relative path to current config file pointing to a config file for extending or directory containing config file.
-If it starts with either of `github:`, `gitlab:`, `bitbucket:` or `https:`, c12 autmatically clones it.
+Each item in extends is a string that can be either an absolute or relative path to the current config file pointing to a config file for extending or the directory containing the config file.
+If it starts with either `github:`, `gitlab:`, `bitbucket:`, or `https:`, c12 automatically clones it.
 
 For custom merging strategies, you can directly access each layer with `layers` property.
 
@@ -130,31 +147,28 @@ For custom merging strategies, you can directly access each layer with `layers`
 // config.ts
 export default {
   colors: {
-    primary: 'user_primary'
+    primary: "user_primary",
   },
-  extends: [
-    './theme',
-    './config.dev.ts'
-  ]
-}
+  extends: ["./theme"],
+};
 ```
 
 ```js
 // config.dev.ts
 export default {
-  dev: true
-}
+  dev: true,
+};
 ```
 
 ```js
 // theme/config.ts
 export default {
-  extends: '../base',
+  extends: "../base",
   colors: {
-    primary: 'theme_primary',
-    secondary: 'theme_secondary'
-  }
-}
+    primary: "theme_primary",
+    secondary: "theme_secondary",
+  },
+};
 ```
 
 ```js
@@ -167,7 +181,7 @@ export default {
 }
 ```
 
-Loaded configuration would look like this:
+The loaded configuration would look like this:
 
 ```js
 {
@@ -190,6 +204,36 @@ Layers:
 ]
 ```
 
+## Environment-specific configuration
+
+Users can define environment-specific configuration using these config keys:
+
+- `$test: {...}`
+- `$development: {...}`
+- `$production: {...}`
+- `$env: { [env]: {...} }`
+
+c12 tries to match [`envName`](#envname) and override environment config if specified.
+
+**Note:** Environment will be applied when extending each configuration layer. This way layers can provide environment-specific configuration.
+
+**Example:**
+
+```js
+{
+  // Default configuration
+  logLevel: 'info',
+
+  // Environment overrides
+  $test: { logLevel: 'silent' },
+  $development: { logLevel: 'warning' },
+  $production: { logLevel: 'error' },
+  $env: {
+    staging: { logLevel: 'debug' }
+  }
+}
+```
+
 ## 💻 Development
 
 - Clone this repository
@@ -202,14 +246,12 @@ Layers:
 Made with 💛 Published under [MIT License](./LICENSE).
 
 <!-- Badges -->
-[npm-version-src]: https://img.shields.io/npm/v/c12?style=flat-square
-[npm-version-href]: https://npmjs.com/package/c12
 
-[npm-downloads-src]: https://img.shields.io/npm/dm/c12?style=flat-square
+[npm-version-src]: https://img.shields.io/npm/v/c12?style=flat&colorA=18181B&colorB=F0DB4F
+[npm-version-href]: https://npmjs.com/package/c12
+[npm-downloads-src]: https://img.shields.io/npm/dm/c12?style=flat&colorA=18181B&colorB=F0DB4F
 [npm-downloads-href]: https://npmjs.com/package/c12
-
-[github-actions-src]: https://img.shields.io/github/workflow/status/unjs/c12/ci/main?style=flat-square
-[github-actions-href]: https://github.com/unjs/c12/actions?query=workflow%3Aci
-
-[codecov-src]: https://img.shields.io/codecov/c/gh/unjs/c12/main?style=flat-square
+[codecov-src]: https://img.shields.io/codecov/c/gh/unjs/c12/main?style=flat&colorA=18181B&colorB=F0DB4F
 [codecov-href]: https://codecov.io/gh/unjs/c12
+[license-src]: https://img.shields.io/github/license/unjs/c12.svg?style=flat&colorA=18181B&colorB=F0DB4F
+[license-href]: https://github.com/unjs/c12/blob/main/LICENSE

package/dist/index.cjs

@@ -10,7 +10,10 @@ const rc9 = require('rc9');
 const defu = require('defu');
 const pkgTypes = require('pkg-types');
 
-function _interopNamespaceDefault(e) {
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
   const n = Object.create(null);
   if (e) {
     for (const k in e) {
@@ -21,8 +24,9 @@ function _interopNamespaceDefault(e) {
   return n;
 }
 
-const dotenv__namespace = /*#__PURE__*/_interopNamespaceDefault(dotenv);
-const rc9__namespace = /*#__PURE__*/_interopNamespaceDefault(rc9);
+const dotenv__namespace = /*#__PURE__*/_interopNamespaceCompat(dotenv);
+const createJiti__default = /*#__PURE__*/_interopDefaultCompat(createJiti);
+const rc9__namespace = /*#__PURE__*/_interopNamespaceCompat(rc9);
 
 async function setupDotenv(options) {
   const targetEnvironment = options.env ?? process.env;
@@ -46,7 +50,7 @@ async function loadDotenv(options) {
     const parsed = dotenv__namespace.parse(await node_fs.promises.readFile(dotenvFile, "utf8"));
     Object.assign(environment, parsed);
   }
-  if (!options.env._applied) {
+  if (!options.env?._applied) {
     Object.assign(environment, options.env);
     environment._applied = true;
   }
@@ -67,15 +71,15 @@ function interpolate(target, source = {}, parse = (v) => v) {
     return parse(
       // eslint-disable-next-line unicorn/no-array-reduce
       matches.reduce((newValue, match) => {
-        const parts = /(.?)\${?([\w:]+)?}?/g.exec(match);
+        const parts = /(.?)\${?([\w:]+)?}?/g.exec(match) || [];
         const prefix = parts[1];
         let value2, replacePart;
         if (prefix === "\\") {
-          replacePart = parts[0];
+          replacePart = parts[0] || "";
           value2 = replacePart.replace("\\$", "$");
         } else {
           const key = parts[2];
-          replacePart = parts[0].slice(prefix.length);
+          replacePart = (parts[0] || "").slice(prefix.length);
           if (parents.includes(key)) {
             console.warn(
               `Please avoid recursive environment variables ( loop: ${parents.join(
@@ -99,6 +103,7 @@ function interpolate(target, source = {}, parse = (v) => v) {
 async function loadConfig(options) {
   options.cwd = pathe.resolve(process.cwd(), options.cwd || ".");
   options.name = options.name || "config";
+  options.envName = options.envName ?? process.env.NODE_ENV;
   options.configFile = options.configFile ?? (options.name !== "config" ? `${options.name}.config` : "config");
   options.rcFile = options.rcFile ?? `.${options.name}rc`;
   if (options.extend !== false) {
@@ -107,7 +112,7 @@ async function loadConfig(options) {
       ...options.extend
     };
   }
-  options.jiti = options.jiti || createJiti(void 0, {
+  options.jiti = options.jiti || createJiti__default(void 0, {
     interopDefault: true,
     requireCache: false,
     esmResolve: true,
@@ -150,10 +155,21 @@ async function loadConfig(options) {
       rc9__namespace.read({ name: options.rcFile, dir: options.cwd })
     );
   }
+  const pkgJson = {};
+  if (options.packageJson) {
+    const keys = (Array.isArray(options.packageJson) ? options.packageJson : [
+      typeof options.packageJson === "string" ? options.packageJson : options.name
+    ]).filter((t) => t && typeof t === "string");
+    const pkgJsonFile = await pkgTypes.readPackageJSON(options.cwd).catch(() => {
+    });
+    const values = keys.map((key) => pkgJsonFile?.[key]);
+    Object.assign(pkgJson, defu.defu({}, ...values));
+  }
   r.config = defu.defu(
     options.overrides,
     config,
     configRC,
+    pkgJson,
     options.defaultConfig
   );
   if (options.extend) {
@@ -169,7 +185,8 @@ async function loadConfig(options) {
       cwd: void 0
     },
     { config, configFile: options.configFile, cwd: options.cwd },
-    options.rcFile && { config: configRC, configFile: options.rcFile }
+    options.rcFile && { config: configRC, configFile: options.rcFile },
+    options.packageJson && { config: pkgJson, configFile: "package.json" }
   ].filter((l) => l && l.config);
   r.layers = [...baseLayers, ...r.layers];
   if (options.defaults) {
@@ -195,16 +212,26 @@ async function extendConfig(config, options) {
     );
     delete config[key];
   }
-  for (const extendSource of extendSources) {
+  for (let extendSource of extendSources) {
+    const originalExtendSource = extendSource;
+    let sourceOptions = {};
+    if (extendSource.source) {
+      sourceOptions = extendSource.options || {};
+      extendSource = extendSource.source;
+    }
+    if (Array.isArray(extendSource)) {
+      sourceOptions = extendSource[1] || {};
+      extendSource = extendSource[0];
+    }
     if (typeof extendSource !== "string") {
       console.warn(
         `Cannot extend config from \`${JSON.stringify(
-          extendSource
-        )}\` (which should be a string) in ${options.cwd}`
+          originalExtendSource
+        )}\` in ${options.cwd}`
       );
       continue;
     }
-    const _config = await resolveConfig(extendSource, options);
+    const _config = await resolveConfig(extendSource, options, sourceOptions);
     if (!_config.config) {
       console.warn(
         `Cannot extend config from \`${extendSource}\` in ${options.cwd}`
@@ -220,8 +247,8 @@ async function extendConfig(config, options) {
   }
 }
 const GIT_PREFIXES = ["github:", "gitlab:", "bitbucket:", "https://"];
-const NPM_PACKAGE_RE = /^(@[\da-z~-][\d._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*$/;
-async function resolveConfig(source, options) {
+const NPM_PACKAGE_RE = /^(@[\da-z~-][\d._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*($|\/.*)/;
+async function resolveConfig(source, options, sourceOptions = {}) {
   if (options.resolve) {
     const res2 = await options.resolve(source, options);
     if (res2) {
@@ -235,10 +262,10 @@ async function resolveConfig(source, options) {
     const name = gitRepo.replace(/[#/:@\\]/g, "_");
     const tmpDir = process.env.XDG_CACHE_HOME ? pathe.resolve(process.env.XDG_CACHE_HOME, "c12", name) : pathe.resolve(node_os.homedir(), ".cache/c12", name);
     if (node_fs.existsSync(tmpDir)) {
-      await promises.rmdir(tmpDir, { recursive: true });
+      await promises.rm(tmpDir, { recursive: true });
     }
-    const clonned = await downloadTemplate(source, { dir: tmpDir });
-    source = clonned.dir;
+    const cloned = await downloadTemplate(source, { dir: tmpDir });
+    source = cloned.dir;
   }
   if (NPM_PACKAGE_RE.test(source)) {
     try {
@@ -251,7 +278,12 @@ async function resolveConfig(source, options) {
   if (isDir) {
     source = options.configFile;
   }
-  const res = { config: void 0, cwd };
+  const res = {
+    config: void 0,
+    cwd,
+    source,
+    sourceOptions
+  };
   try {
     res.configFile = options.jiti.resolve(pathe.resolve(cwd, source), {
       paths: [cwd]
@@ -262,12 +294,31 @@ async function resolveConfig(source, options) {
     return res;
   }
   res.config = options.jiti(res.configFile);
-  if (typeof res.config === "function") {
+  if (res.config instanceof Function) {
     res.config = await res.config();
   }
+  if (options.envName) {
+    const envConfig = {
+      ...res.config["$" + options.envName],
+      ...res.config.$env?.[options.envName]
+    };
+    if (Object.keys(envConfig).length > 0) {
+      res.config = defu.defu(envConfig, res.config);
+    }
+  }
+  res.meta = defu.defu(res.sourceOptions.meta, res.config.$meta);
+  delete res.config.$meta;
+  if (res.sourceOptions.overrides) {
+    res.config = defu.defu(res.sourceOptions.overrides, res.config);
+  }
   return res;
 }
 
+function createDefineConfig() {
+  return (input) => input;
+}
+
+exports.createDefineConfig = createDefineConfig;
 exports.loadConfig = loadConfig;
 exports.loadDotenv = loadDotenv;
 exports.setupDotenv = setupDotenv;

package/dist/index.d.ts

@@ -37,37 +37,58 @@ declare function setupDotenv(options: DotenvOptions): Promise<Env>;
 /** Load environment variables into an object. */
 declare function loadDotenv(options: DotenvOptions): Promise<Env>;
 
-interface InputConfig extends Record<string, any> {
+interface ConfigLayerMeta {
+    name?: string;
+    [key: string]: any;
+}
+type UserInputConfig = Record<string, any>;
+interface C12InputConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> {
+    $test?: T;
+    $development?: T;
+    $production?: T;
+    $env?: Record<string, T>;
+    $meta?: MT;
+}
+type InputConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> = C12InputConfig<T, MT> & T;
+interface SourceOptions<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> {
+    meta?: MT;
+    overrides?: T;
+    [key: string]: any;
 }
-interface ConfigLayer<T extends InputConfig = InputConfig> {
+interface ConfigLayer<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> {
     config: T | null;
+    source?: string;
+    sourceOptions?: SourceOptions<T, MT>;
+    meta?: MT;
     cwd?: string;
     configFile?: string;
 }
-interface ResolvedConfig<T extends InputConfig = InputConfig> extends ConfigLayer<T> {
-    layers?: ConfigLayer<T>[];
+interface ResolvedConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> extends ConfigLayer<T, MT> {
+    layers?: ConfigLayer<T, MT>[];
     cwd?: string;
 }
-interface ResolveConfigOptions {
-    cwd: string;
-}
-interface LoadConfigOptions<T extends InputConfig = InputConfig> {
+interface LoadConfigOptions<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> {
     name?: string;
     cwd?: string;
     configFile?: string;
     rcFile?: false | string;
     globalRc?: boolean;
     dotenv?: boolean | DotenvOptions;
+    envName?: string | false;
+    packageJson?: boolean | string | string[];
     defaults?: T;
     defaultConfig?: T;
     overrides?: T;
-    resolve?: (id: string, options: LoadConfigOptions) => null | ResolvedConfig | Promise<ResolvedConfig | null>;
+    resolve?: (id: string, options: LoadConfigOptions<T, MT>) => null | undefined | ResolvedConfig<T, MT> | Promise<ResolvedConfig<T, MT> | undefined | null>;
     jiti?: JITI;
     jitiOptions?: JITIOptions;
     extend?: false | {
         extendKey?: string | string[];
     };
 }
-declare function loadConfig<T extends InputConfig = InputConfig>(options: LoadConfigOptions<T>): Promise<ResolvedConfig<T>>;
+type DefineConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta> = (input: InputConfig<T, MT>) => InputConfig<T, MT>;
+declare function createDefineConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta>(): DefineConfig<T, MT>;
+
+declare function loadConfig<T extends UserInputConfig = UserInputConfig, MT extends ConfigLayerMeta = ConfigLayerMeta>(options: LoadConfigOptions<T, MT>): Promise<ResolvedConfig<T, MT>>;
 
-export { ConfigLayer, DotenvOptions, Env, InputConfig, LoadConfigOptions, ResolveConfigOptions, ResolvedConfig, loadConfig, loadDotenv, setupDotenv };
+export { C12InputConfig, ConfigLayer, ConfigLayerMeta, DefineConfig, DotenvOptions, Env, InputConfig, LoadConfigOptions, ResolvedConfig, SourceOptions, UserInputConfig, createDefineConfig, loadConfig, loadDotenv, setupDotenv };

package/dist/index.mjs

@@ -1,12 +1,12 @@
 import { existsSync, promises } from 'node:fs';
 import { resolve, extname, dirname } from 'pathe';
 import * as dotenv from 'dotenv';
-import { rmdir } from 'node:fs/promises';
+import { rm } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import createJiti from 'jiti';
 import * as rc9 from 'rc9';
 import { defu } from 'defu';
-import { findWorkspaceDir } from 'pkg-types';
+import { findWorkspaceDir, readPackageJSON } from 'pkg-types';
 
 async function setupDotenv(options) {
   const targetEnvironment = options.env ?? process.env;
@@ -30,7 +30,7 @@ async function loadDotenv(options) {
     const parsed = dotenv.parse(await promises.readFile(dotenvFile, "utf8"));
     Object.assign(environment, parsed);
   }
-  if (!options.env._applied) {
+  if (!options.env?._applied) {
     Object.assign(environment, options.env);
     environment._applied = true;
   }
@@ -51,15 +51,15 @@ function interpolate(target, source = {}, parse = (v) => v) {
     return parse(
       // eslint-disable-next-line unicorn/no-array-reduce
       matches.reduce((newValue, match) => {
-        const parts = /(.?)\${?([\w:]+)?}?/g.exec(match);
+        const parts = /(.?)\${?([\w:]+)?}?/g.exec(match) || [];
         const prefix = parts[1];
         let value2, replacePart;
         if (prefix === "\\") {
-          replacePart = parts[0];
+          replacePart = parts[0] || "";
           value2 = replacePart.replace("\\$", "$");
         } else {
           const key = parts[2];
-          replacePart = parts[0].slice(prefix.length);
+          replacePart = (parts[0] || "").slice(prefix.length);
           if (parents.includes(key)) {
             console.warn(
               `Please avoid recursive environment variables ( loop: ${parents.join(
@@ -83,6 +83,7 @@ function interpolate(target, source = {}, parse = (v) => v) {
 async function loadConfig(options) {
   options.cwd = resolve(process.cwd(), options.cwd || ".");
   options.name = options.name || "config";
+  options.envName = options.envName ?? process.env.NODE_ENV;
   options.configFile = options.configFile ?? (options.name !== "config" ? `${options.name}.config` : "config");
   options.rcFile = options.rcFile ?? `.${options.name}rc`;
   if (options.extend !== false) {
@@ -134,10 +135,21 @@ async function loadConfig(options) {
       rc9.read({ name: options.rcFile, dir: options.cwd })
     );
   }
+  const pkgJson = {};
+  if (options.packageJson) {
+    const keys = (Array.isArray(options.packageJson) ? options.packageJson : [
+      typeof options.packageJson === "string" ? options.packageJson : options.name
+    ]).filter((t) => t && typeof t === "string");
+    const pkgJsonFile = await readPackageJSON(options.cwd).catch(() => {
+    });
+    const values = keys.map((key) => pkgJsonFile?.[key]);
+    Object.assign(pkgJson, defu({}, ...values));
+  }
   r.config = defu(
     options.overrides,
     config,
     configRC,
+    pkgJson,
     options.defaultConfig
   );
   if (options.extend) {
@@ -153,7 +165,8 @@ async function loadConfig(options) {
       cwd: void 0
     },
     { config, configFile: options.configFile, cwd: options.cwd },
-    options.rcFile && { config: configRC, configFile: options.rcFile }
+    options.rcFile && { config: configRC, configFile: options.rcFile },
+    options.packageJson && { config: pkgJson, configFile: "package.json" }
   ].filter((l) => l && l.config);
   r.layers = [...baseLayers, ...r.layers];
   if (options.defaults) {
@@ -179,16 +192,26 @@ async function extendConfig(config, options) {
     );
     delete config[key];
   }
-  for (const extendSource of extendSources) {
+  for (let extendSource of extendSources) {
+    const originalExtendSource = extendSource;
+    let sourceOptions = {};
+    if (extendSource.source) {
+      sourceOptions = extendSource.options || {};
+      extendSource = extendSource.source;
+    }
+    if (Array.isArray(extendSource)) {
+      sourceOptions = extendSource[1] || {};
+      extendSource = extendSource[0];
+    }
     if (typeof extendSource !== "string") {
       console.warn(
         `Cannot extend config from \`${JSON.stringify(
-          extendSource
-        )}\` (which should be a string) in ${options.cwd}`
+          originalExtendSource
+        )}\` in ${options.cwd}`
       );
       continue;
     }
-    const _config = await resolveConfig(extendSource, options);
+    const _config = await resolveConfig(extendSource, options, sourceOptions);
     if (!_config.config) {
       console.warn(
         `Cannot extend config from \`${extendSource}\` in ${options.cwd}`
@@ -204,8 +227,8 @@ async function extendConfig(config, options) {
   }
 }
 const GIT_PREFIXES = ["github:", "gitlab:", "bitbucket:", "https://"];
-const NPM_PACKAGE_RE = /^(@[\da-z~-][\d._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*$/;
-async function resolveConfig(source, options) {
+const NPM_PACKAGE_RE = /^(@[\da-z~-][\d._a-z~-]*\/)?[\da-z~-][\d._a-z~-]*($|\/.*)/;
+async function resolveConfig(source, options, sourceOptions = {}) {
   if (options.resolve) {
     const res2 = await options.resolve(source, options);
     if (res2) {
@@ -219,10 +242,10 @@ async function resolveConfig(source, options) {
     const name = gitRepo.replace(/[#/:@\\]/g, "_");
     const tmpDir = process.env.XDG_CACHE_HOME ? resolve(process.env.XDG_CACHE_HOME, "c12", name) : resolve(homedir(), ".cache/c12", name);
     if (existsSync(tmpDir)) {
-      await rmdir(tmpDir, { recursive: true });
+      await rm(tmpDir, { recursive: true });
     }
-    const clonned = await downloadTemplate(source, { dir: tmpDir });
-    source = clonned.dir;
+    const cloned = await downloadTemplate(source, { dir: tmpDir });
+    source = cloned.dir;
   }
   if (NPM_PACKAGE_RE.test(source)) {
     try {
@@ -235,7 +258,12 @@ async function resolveConfig(source, options) {
   if (isDir) {
     source = options.configFile;
   }
-  const res = { config: void 0, cwd };
+  const res = {
+    config: void 0,
+    cwd,
+    source,
+    sourceOptions
+  };
   try {
     res.configFile = options.jiti.resolve(resolve(cwd, source), {
       paths: [cwd]
@@ -246,10 +274,28 @@ async function resolveConfig(source, options) {
     return res;
   }
   res.config = options.jiti(res.configFile);
-  if (typeof res.config === "function") {
+  if (res.config instanceof Function) {
     res.config = await res.config();
   }
+  if (options.envName) {
+    const envConfig = {
+      ...res.config["$" + options.envName],
+      ...res.config.$env?.[options.envName]
+    };
+    if (Object.keys(envConfig).length > 0) {
+      res.config = defu(envConfig, res.config);
+    }
+  }
+  res.meta = defu(res.sourceOptions.meta, res.config.$meta);
+  delete res.config.$meta;
+  if (res.sourceOptions.overrides) {
+    res.config = defu(res.sourceOptions.overrides, res.config);
+  }
   return res;
 }
 
-export { loadConfig, loadDotenv, setupDotenv };
+function createDefineConfig() {
+  return (input) => input;
+}
+
+export { createDefineConfig, loadConfig, loadDotenv, setupDotenv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "c12",
-  "version": "1.1.2",
+  "version": "1.3.0",
   "description": "Smart Config Loader",
   "repository": "unjs/c12",
   "license": "MIT",
@@ -26,27 +26,29 @@
     "lint:fix": "eslint --ext .ts,.js,.mjs,.cjs . --fix && prettier -w src test",
     "prepack": "unbuild",
     "release": "changelogen --release && npm publish && git push --follow-tags",
-    "test": "vitest run --coverage"
+    "test": "vitest run --coverage && pnpm test:types",
+    "test:types": "tsc --noEmit"
   },
   "dependencies": {
     "defu": "^6.1.2",
     "dotenv": "^16.0.3",
-    "giget": "^1.1.0",
-    "jiti": "^1.17.1",
-    "mlly": "^1.1.1",
+    "giget": "^1.1.2",
+    "jiti": "^1.18.2",
+    "mlly": "^1.2.0",
     "pathe": "^1.1.0",
     "pkg-types": "^1.0.2",
-    "rc9": "^2.0.1"
+    "rc9": "^2.1.0"
   },
   "devDependencies": {
-    "@vitest/coverage-c8": "^0.28.5",
-    "changelogen": "^0.4.1",
-    "eslint": "^8.34.0",
+    "@vitest/coverage-c8": "^0.30.1",
+    "changelogen": "^0.5.3",
+    "eslint": "^8.38.0",
     "eslint-config-unjs": "^0.1.0",
-    "prettier": "^2.8.4",
-    "typescript": "^4.9.5",
-    "unbuild": "^1.1.1",
-    "vitest": "^0.28.5"
+    "expect-type": "^0.15.0",
+    "prettier": "^2.8.7",
+    "typescript": "^5.0.4",
+    "unbuild": "^1.2.1",
+    "vitest": "^0.30.1"
   },
-  "packageManager": "pnpm@7.27.0"
-}
+  "packageManager": "pnpm@8.2.0"
+}