kubb 5.0.0-alpha.39 → 5.0.0-alpha.40

package/dist/index.cjs

@@ -29,18 +29,16 @@ function applyDefaults(config) {
 		parsers: config.parsers?.length ? config.parsers : [_kubb_parser_ts.parserTs, _kubb_parser_ts.parserTsx]
 	};
 }
+function normalizeConfig(config) {
+	if (Array.isArray(config)) return config.map(applyDefaults);
+	return applyDefaults(config);
+}
 function defineConfig(config) {
 	if (typeof config === "function") return async (cli) => {
-		const resolved = await config(cli);
-		const result = (Array.isArray(resolved) ? resolved : [resolved]).map(applyDefaults);
-		return result.length === 1 ? result[0] : result;
+		return normalizeConfig(await config(cli));
 	};
-	if (isPromise(config)) return config.then((resolved) => {
-		const result = (Array.isArray(resolved) ? resolved : [resolved]).map(applyDefaults);
-		return result.length === 1 ? result[0] : result;
-	});
-	const result = (Array.isArray(config) ? config : [config]).map(applyDefaults);
-	return result.length === 1 ? result[0] : result;
+	if (isPromise(config)) return config.then((resolved) => normalizeConfig(resolved));
+	return normalizeConfig(config);
 }
 //#endregion
 exports.defineConfig = defineConfig;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["parserTs","parserTsx"],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a fulfilled `Promise.allSettled` result.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseFulfilledResult).map((r) => r.value)\n * ```\n */\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport type { CLIOptions } from '@kubb/core'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\nimport type { ConfigInput, UserConfig } from './types.ts'\n\n/**\n * Applies default adapter and parsers to a single user config when not set.\n *\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs, parserTsx]`\n */\nfunction applyDefaults(config: UserConfig): UserConfig {\n  return {\n    ...config,\n    adapter: config.adapter ?? adapterOas(),\n    parsers: config.parsers?.length ? config.parsers : [parserTs, parserTsx],\n  }\n}\n\n/**\n * Helper for defining a Kubb configuration with built-in defaults.\n *\n * When no `adapter` is provided, `adapterOas()` is used automatically.\n * When no `parsers` are provided, `[parserTsx]` is used automatically.\n *\n * Accepts either:\n * - A config object or array of configs\n * - A function returning the config(s), optionally async,\n *   receiving the CLI options as argument\n *\n * @example\n * export default defineConfig(({ logLevel }) => ({\n *   root: 'src',\n *   plugins: [myPlugin()],\n * }))\n */\nexport function defineConfig(config: (cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>): (cli: CLIOptions) => Promise<UserConfig | UserConfig[]>\nexport function defineConfig(config: Promise<UserConfig | UserConfig[]>): Promise<UserConfig | UserConfig[]>\nexport function defineConfig(config: UserConfig | UserConfig[]): UserConfig | UserConfig[]\nexport function defineConfig(config: ConfigInput): ConfigInput {\n  if (typeof config === 'function') {\n    return async (cli: CLIOptions) => {\n      const resolved = await config(cli)\n      const configs = Array.isArray(resolved) ? resolved : [resolved]\n      const result = configs.map(applyDefaults)\n\n      return result.length === 1 ? result[0]! : result\n    }\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => {\n      const configs = Array.isArray(resolved) ? resolved : [resolved]\n      const result = configs.map(applyDefaults)\n\n      return result.length === 1 ? result[0]! : result\n    })\n  }\n\n  const configs = Array.isArray(config) ? config : [config]\n  const result = configs.map(applyDefaults)\n\n  return result.length === 1 ? result[0]! : result\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,SAAgB,UAAa,QAAkD;AAC7E,QAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;;;;;;;;;;ACR3G,SAAS,cAAc,QAAgC;AACrD,QAAO;EACL,GAAG;EACH,SAAS,OAAO,YAAA,GAAA,kBAAA,aAAuB;EACvC,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU,CAACA,gBAAAA,UAAUC,gBAAAA,UAAU;EACzE;;AAuBH,SAAgB,aAAa,QAAkC;AAC7D,KAAI,OAAO,WAAW,WACpB,QAAO,OAAO,QAAoB;EAChC,MAAM,WAAW,MAAM,OAAO,IAAI;EAElC,MAAM,UADU,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,EACxC,IAAI,cAAc;AAEzC,SAAO,OAAO,WAAW,IAAI,OAAO,KAAM;;AAI9C,KAAI,UAAU,OAAO,CACnB,QAAO,OAAO,MAAM,aAAa;EAE/B,MAAM,UADU,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,EACxC,IAAI,cAAc;AAEzC,SAAO,OAAO,WAAW,IAAI,OAAO,KAAM;GAC1C;CAIJ,MAAM,UADU,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EAClC,IAAI,cAAc;AAEzC,QAAO,OAAO,WAAW,IAAI,OAAO,KAAM"}
+{"version":3,"file":"index.cjs","names":["parserTs","parserTsx"],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a fulfilled `Promise.allSettled` result.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseFulfilledResult).map((r) => r.value)\n * ```\n */\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport type { CLIOptions, UserConfig } from '@kubb/core'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\n\ntype ConfigValue<TInput> = UserConfig<TInput>\ntype ConfigArray<TInput> = Array<ConfigValue<TInput>>\ntype ConfigResult<TInput> = ConfigValue<TInput> | ConfigArray<TInput>\ntype ConfigPromise<TInput> = Promise<ConfigResult<TInput>>\ntype ConfigFactory<TInput> = (cli: CLIOptions) => PossiblePromise<ConfigResult<TInput>>\ntype DefinedConfig<TInput> = ConfigResult<TInput> | ConfigPromise<TInput> | ((cli: CLIOptions) => Promise<ConfigResult<TInput>>)\n\n/**\n * Applies default adapter and parsers to a single user config when not set.\n *\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs, parserTsx]`\n */\nfunction applyDefaults<TInput>(config: UserConfig<TInput>): UserConfig<TInput> {\n  return {\n    ...config,\n    adapter: config.adapter ?? adapterOas(),\n    parsers: config.parsers?.length ? config.parsers : [parserTs, parserTsx],\n  }\n}\n\nfunction normalizeConfig<TInput>(config: UserConfig<TInput> | Array<UserConfig<TInput>>): UserConfig<TInput> | Array<UserConfig<TInput>> {\n  if (Array.isArray(config)) {\n    return config.map(applyDefaults)\n  }\n\n  return applyDefaults(config)\n}\n\n/**\n * Helper for defining a Kubb configuration with built-in defaults.\n *\n * When no `adapter` is provided, `adapterOas()` is used automatically.\n * When no `parsers` are provided, `[parserTsx]` is used automatically.\n *\n * Accepts either:\n * - A config object or array of configs\n * - A function returning the config(s), optionally async,\n *   receiving the CLI options as argument\n *\n * @example\n * export default defineConfig(({ logLevel }) => ({\n *   root: 'src',\n *   plugins: [myPlugin()],\n * }))\n */\nexport function defineConfig<TInput>(config: (cli: CLIOptions) => PossiblePromise<UserConfig<TInput>>): (cli: CLIOptions) => Promise<UserConfig<TInput>>\nexport function defineConfig<TInput>(\n  config: (cli: CLIOptions) => PossiblePromise<Array<UserConfig<TInput>>>,\n): (cli: CLIOptions) => Promise<Array<UserConfig<TInput>>>\nexport function defineConfig<TInput>(config: Promise<UserConfig<TInput>>): Promise<UserConfig<TInput>>\nexport function defineConfig<TInput>(config: Promise<Array<UserConfig<TInput>>>): Promise<Array<UserConfig<TInput>>>\nexport function defineConfig<TInput>(config: UserConfig<TInput>): UserConfig<TInput>\nexport function defineConfig<TInput>(config: Array<UserConfig<TInput>>): Array<UserConfig<TInput>>\nexport function defineConfig<TInput>(config: ConfigFactory<TInput>): (cli: CLIOptions) => Promise<ConfigResult<TInput>>\nexport function defineConfig<TInput>(config: ConfigResult<TInput> | ConfigPromise<TInput> | ConfigFactory<TInput>): DefinedConfig<TInput> {\n  if (typeof config === 'function') {\n    return async (cli: CLIOptions) => {\n      return normalizeConfig(await config(cli))\n    }\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => normalizeConfig(resolved))\n  }\n\n  return normalizeConfig(config)\n}\n"],"mappings":";;;;;;;;;;;;;AAmBA,SAAgB,UAAa,QAAkD;AAC7E,QAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;;;;;;;;;;ACF3G,SAAS,cAAsB,QAAgD;AAC7E,QAAO;EACL,GAAG;EACH,SAAS,OAAO,YAAA,GAAA,kBAAA,aAAuB;EACvC,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU,CAACA,gBAAAA,UAAUC,gBAAAA,UAAU;EACzE;;AAGH,SAAS,gBAAwB,QAAwG;AACvI,KAAI,MAAM,QAAQ,OAAO,CACvB,QAAO,OAAO,IAAI,cAAc;AAGlC,QAAO,cAAc,OAAO;;AA6B9B,SAAgB,aAAqB,QAAqG;AACxI,KAAI,OAAO,WAAW,WACpB,QAAO,OAAO,QAAoB;AAChC,SAAO,gBAAgB,MAAM,OAAO,IAAI,CAAC;;AAI7C,KAAI,UAAU,OAAO,CACnB,QAAO,OAAO,MAAM,aAAa,gBAAgB,SAAS,CAAC;AAG7D,QAAO,gBAAgB,OAAO"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { t as __name } from "./chunk--u3MIqq1.js";
-import { Adapter, CLIOptions, Config, HookStylePlugin, InputData, InputPath, Parser, PluginFactoryOptions, UserPlugin } from "@kubb/core";
+import { CLIOptions, UserConfig } from "@kubb/core";
 
 //#region ../../internals/utils/src/promise.d.ts
 /** A value that may already be resolved or still pending.
@@ -13,51 +13,11 @@ import { Adapter, CLIOptions, Config, HookStylePlugin, InputData, InputPath, Par
  */
 type PossiblePromise<T> = Promise<T> | T;
 //#endregion
-//#region src/types.d.ts
-type Input = InputPath | InputData;
-type UnknownUserPlugin = UserPlugin<PluginFactoryOptions<string, object, object, unknown, object>>;
-/**
- * Partial version of {@link Config} intended for use in `kubb.config.ts`.
- *
- * Fields that have sensible defaults (`root`, `plugins`, `parsers`, `adapter`) are optional.
- */
-type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter'> & {
-  /**
-   * The project root directory, which can be either an absolute path or a path relative to the location of your `kubb.config.ts` file.
-   * @default process.cwd()
-   */
-  root?: string;
-  /**
-   * An array of parsers used to convert generated files to strings.
-   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
-   *
-   * A catch-all fallback parser is always appended last for any unhandled extension.
-   *
-   * When omitted, `parserTsx` from `@kubb/parser-ts` is used automatically as the
-   * default (requires `@kubb/parser-ts` to be installed as an optional dependency).
-   * @default [parserTsx] — from `@kubb/parser-ts`
-   */
-  parsers?: Array<Parser>;
-  /**
-   * Adapter that converts the input file into a `@kubb/ast` `InputNode` — the universal
-   * intermediate representation consumed by all Kubb plugins.
-   *
-   * When omitted, `adapterOas()` from `@kubb/adapter-oas` is used automatically as the
-   * default (requires `@kubb/adapter-oas` to be installed as an optional dependency).
-   *
-   * @default adapterOas() — from `@kubb/adapter-oas`
-   */
-  adapter?: Adapter;
-  /**
-   * An array of Kubb plugins used for code generation.
-   * Each plugin may declare additional configurable options.
-   * If a plugin depends on another, an error is thrown when the dependency is missing.
-   * Use `dependencies` on the plugin to declare execution order.
-   */
-  plugins?: Array<Omit<UnknownUserPlugin, 'inject'> | HookStylePlugin>;
-};
-//#endregion
 //#region src/defineConfig.d.ts
+type ConfigValue<TInput> = UserConfig<TInput>;
+type ConfigArray<TInput> = Array<ConfigValue<TInput>>;
+type ConfigResult<TInput> = ConfigValue<TInput> | ConfigArray<TInput>;
+type ConfigFactory<TInput> = (cli: CLIOptions) => PossiblePromise<ConfigResult<TInput>>;
 /**
  * Helper for defining a Kubb configuration with built-in defaults.
  *
@@ -75,9 +35,13 @@ type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'par
  *   plugins: [myPlugin()],
  * }))
  */
-declare function defineConfig(config: (cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>): (cli: CLIOptions) => Promise<UserConfig | UserConfig[]>;
-declare function defineConfig(config: Promise<UserConfig | UserConfig[]>): Promise<UserConfig | UserConfig[]>;
-declare function defineConfig(config: UserConfig | UserConfig[]): UserConfig | UserConfig[];
+declare function defineConfig<TInput>(config: (cli: CLIOptions) => PossiblePromise<UserConfig<TInput>>): (cli: CLIOptions) => Promise<UserConfig<TInput>>;
+declare function defineConfig<TInput>(config: (cli: CLIOptions) => PossiblePromise<Array<UserConfig<TInput>>>): (cli: CLIOptions) => Promise<Array<UserConfig<TInput>>>;
+declare function defineConfig<TInput>(config: Promise<UserConfig<TInput>>): Promise<UserConfig<TInput>>;
+declare function defineConfig<TInput>(config: Promise<Array<UserConfig<TInput>>>): Promise<Array<UserConfig<TInput>>>;
+declare function defineConfig<TInput>(config: UserConfig<TInput>): UserConfig<TInput>;
+declare function defineConfig<TInput>(config: Array<UserConfig<TInput>>): Array<UserConfig<TInput>>;
+declare function defineConfig<TInput>(config: ConfigFactory<TInput>): (cli: CLIOptions) => Promise<ConfigResult<TInput>>;
 //#endregion
 export { defineConfig };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -28,18 +28,16 @@ function applyDefaults(config) {
 		parsers: config.parsers?.length ? config.parsers : [parserTs, parserTsx]
 	};
 }
+function normalizeConfig(config) {
+	if (Array.isArray(config)) return config.map(applyDefaults);
+	return applyDefaults(config);
+}
 function defineConfig(config) {
 	if (typeof config === "function") return async (cli) => {
-		const resolved = await config(cli);
-		const result = (Array.isArray(resolved) ? resolved : [resolved]).map(applyDefaults);
-		return result.length === 1 ? result[0] : result;
+		return normalizeConfig(await config(cli));
 	};
-	if (isPromise(config)) return config.then((resolved) => {
-		const result = (Array.isArray(resolved) ? resolved : [resolved]).map(applyDefaults);
-		return result.length === 1 ? result[0] : result;
-	});
-	const result = (Array.isArray(config) ? config : [config]).map(applyDefaults);
-	return result.length === 1 ? result[0] : result;
+	if (isPromise(config)) return config.then((resolved) => normalizeConfig(resolved));
+	return normalizeConfig(config);
 }
 //#endregion
 export { defineConfig };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a fulfilled `Promise.allSettled` result.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseFulfilledResult).map((r) => r.value)\n * ```\n */\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport type { CLIOptions } from '@kubb/core'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\nimport type { ConfigInput, UserConfig } from './types.ts'\n\n/**\n * Applies default adapter and parsers to a single user config when not set.\n *\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs, parserTsx]`\n */\nfunction applyDefaults(config: UserConfig): UserConfig {\n  return {\n    ...config,\n    adapter: config.adapter ?? adapterOas(),\n    parsers: config.parsers?.length ? config.parsers : [parserTs, parserTsx],\n  }\n}\n\n/**\n * Helper for defining a Kubb configuration with built-in defaults.\n *\n * When no `adapter` is provided, `adapterOas()` is used automatically.\n * When no `parsers` are provided, `[parserTsx]` is used automatically.\n *\n * Accepts either:\n * - A config object or array of configs\n * - A function returning the config(s), optionally async,\n *   receiving the CLI options as argument\n *\n * @example\n * export default defineConfig(({ logLevel }) => ({\n *   root: 'src',\n *   plugins: [myPlugin()],\n * }))\n */\nexport function defineConfig(config: (cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>): (cli: CLIOptions) => Promise<UserConfig | UserConfig[]>\nexport function defineConfig(config: Promise<UserConfig | UserConfig[]>): Promise<UserConfig | UserConfig[]>\nexport function defineConfig(config: UserConfig | UserConfig[]): UserConfig | UserConfig[]\nexport function defineConfig(config: ConfigInput): ConfigInput {\n  if (typeof config === 'function') {\n    return async (cli: CLIOptions) => {\n      const resolved = await config(cli)\n      const configs = Array.isArray(resolved) ? resolved : [resolved]\n      const result = configs.map(applyDefaults)\n\n      return result.length === 1 ? result[0]! : result\n    }\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => {\n      const configs = Array.isArray(resolved) ? resolved : [resolved]\n      const result = configs.map(applyDefaults)\n\n      return result.length === 1 ? result[0]! : result\n    })\n  }\n\n  const configs = Array.isArray(config) ? config : [config]\n  const result = configs.map(applyDefaults)\n\n  return result.length === 1 ? result[0]! : result\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,UAAa,QAAkD;AAC7E,QAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;;;;;;;;;;ACR3G,SAAS,cAAc,QAAgC;AACrD,QAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAW,YAAY;EACvC,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU,CAAC,UAAU,UAAU;EACzE;;AAuBH,SAAgB,aAAa,QAAkC;AAC7D,KAAI,OAAO,WAAW,WACpB,QAAO,OAAO,QAAoB;EAChC,MAAM,WAAW,MAAM,OAAO,IAAI;EAElC,MAAM,UADU,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,EACxC,IAAI,cAAc;AAEzC,SAAO,OAAO,WAAW,IAAI,OAAO,KAAM;;AAI9C,KAAI,UAAU,OAAO,CACnB,QAAO,OAAO,MAAM,aAAa;EAE/B,MAAM,UADU,MAAM,QAAQ,SAAS,GAAG,WAAW,CAAC,SAAS,EACxC,IAAI,cAAc;AAEzC,SAAO,OAAO,WAAW,IAAI,OAAO,KAAM;GAC1C;CAIJ,MAAM,UADU,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,EAClC,IAAI,cAAc;AAEzC,QAAO,OAAO,WAAW,IAAI,OAAO,KAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../internals/utils/src/promise.ts","../src/defineConfig.ts"],"sourcesContent":["/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\n/** Returns `true` when `result` is a thenable `Promise`.\n *\n * @example\n * ```ts\n * isPromise(Promise.resolve(1)) // true\n * isPromise(42)                 // false\n * ```\n */\nexport function isPromise<T>(result: PossiblePromise<T>): result is Promise<T> {\n  return result !== null && result !== undefined && typeof (result as Record<string, unknown>)['then'] === 'function'\n}\n\n/** Returns `true` when `result` is a fulfilled `Promise.allSettled` result.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseFulfilledResult).map((r) => r.value)\n * ```\n */\nexport function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T> {\n  return result.status === 'fulfilled'\n}\n\n/** Returns `true` when `result` is a rejected `Promise.allSettled` result with a typed `reason`.\n *\n * @example\n * ```ts\n * const results = await Promise.allSettled([p1, p2])\n * results.filter(isPromiseRejectedResult<Error>).map((r) => r.reason.message)\n * ```\n */\nexport function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & { reason: T } {\n  return result.status === 'rejected'\n}\n","import { isPromise, type PossiblePromise } from '@internals/utils'\nimport { adapterOas } from '@kubb/adapter-oas'\nimport type { CLIOptions, UserConfig } from '@kubb/core'\nimport { parserTs, parserTsx } from '@kubb/parser-ts'\n\ntype ConfigValue<TInput> = UserConfig<TInput>\ntype ConfigArray<TInput> = Array<ConfigValue<TInput>>\ntype ConfigResult<TInput> = ConfigValue<TInput> | ConfigArray<TInput>\ntype ConfigPromise<TInput> = Promise<ConfigResult<TInput>>\ntype ConfigFactory<TInput> = (cli: CLIOptions) => PossiblePromise<ConfigResult<TInput>>\ntype DefinedConfig<TInput> = ConfigResult<TInput> | ConfigPromise<TInput> | ((cli: CLIOptions) => Promise<ConfigResult<TInput>>)\n\n/**\n * Applies default adapter and parsers to a single user config when not set.\n *\n * - `adapter` defaults to `adapterOas()`\n * - `parsers` defaults to `[parserTs, parserTsx]`\n */\nfunction applyDefaults<TInput>(config: UserConfig<TInput>): UserConfig<TInput> {\n  return {\n    ...config,\n    adapter: config.adapter ?? adapterOas(),\n    parsers: config.parsers?.length ? config.parsers : [parserTs, parserTsx],\n  }\n}\n\nfunction normalizeConfig<TInput>(config: UserConfig<TInput> | Array<UserConfig<TInput>>): UserConfig<TInput> | Array<UserConfig<TInput>> {\n  if (Array.isArray(config)) {\n    return config.map(applyDefaults)\n  }\n\n  return applyDefaults(config)\n}\n\n/**\n * Helper for defining a Kubb configuration with built-in defaults.\n *\n * When no `adapter` is provided, `adapterOas()` is used automatically.\n * When no `parsers` are provided, `[parserTsx]` is used automatically.\n *\n * Accepts either:\n * - A config object or array of configs\n * - A function returning the config(s), optionally async,\n *   receiving the CLI options as argument\n *\n * @example\n * export default defineConfig(({ logLevel }) => ({\n *   root: 'src',\n *   plugins: [myPlugin()],\n * }))\n */\nexport function defineConfig<TInput>(config: (cli: CLIOptions) => PossiblePromise<UserConfig<TInput>>): (cli: CLIOptions) => Promise<UserConfig<TInput>>\nexport function defineConfig<TInput>(\n  config: (cli: CLIOptions) => PossiblePromise<Array<UserConfig<TInput>>>,\n): (cli: CLIOptions) => Promise<Array<UserConfig<TInput>>>\nexport function defineConfig<TInput>(config: Promise<UserConfig<TInput>>): Promise<UserConfig<TInput>>\nexport function defineConfig<TInput>(config: Promise<Array<UserConfig<TInput>>>): Promise<Array<UserConfig<TInput>>>\nexport function defineConfig<TInput>(config: UserConfig<TInput>): UserConfig<TInput>\nexport function defineConfig<TInput>(config: Array<UserConfig<TInput>>): Array<UserConfig<TInput>>\nexport function defineConfig<TInput>(config: ConfigFactory<TInput>): (cli: CLIOptions) => Promise<ConfigResult<TInput>>\nexport function defineConfig<TInput>(config: ConfigResult<TInput> | ConfigPromise<TInput> | ConfigFactory<TInput>): DefinedConfig<TInput> {\n  if (typeof config === 'function') {\n    return async (cli: CLIOptions) => {\n      return normalizeConfig(await config(cli))\n    }\n  }\n\n  if (isPromise(config)) {\n    return config.then((resolved) => normalizeConfig(resolved))\n  }\n\n  return normalizeConfig(config)\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,UAAa,QAAkD;AAC7E,QAAO,WAAW,QAAQ,WAAW,KAAA,KAAa,OAAQ,OAAmC,YAAY;;;;;;;;;;ACF3G,SAAS,cAAsB,QAAgD;AAC7E,QAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAW,YAAY;EACvC,SAAS,OAAO,SAAS,SAAS,OAAO,UAAU,CAAC,UAAU,UAAU;EACzE;;AAGH,SAAS,gBAAwB,QAAwG;AACvI,KAAI,MAAM,QAAQ,OAAO,CACvB,QAAO,OAAO,IAAI,cAAc;AAGlC,QAAO,cAAc,OAAO;;AA6B9B,SAAgB,aAAqB,QAAqG;AACxI,KAAI,OAAO,WAAW,WACpB,QAAO,OAAO,QAAoB;AAChC,SAAO,gBAAgB,MAAM,OAAO,IAAI,CAAC;;AAI7C,KAAI,UAAU,OAAO,CACnB,QAAO,OAAO,MAAM,aAAa,gBAAgB,SAAS,CAAC;AAG7D,QAAO,gBAAgB,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kubb",
-  "version": "5.0.0-alpha.39",
+  "version": "5.0.0-alpha.40",
   "description": "Transform OpenAPI specifications into TypeScript, React-Query, Zod, Faker.js, MSW and more with a plugin-based code generation tool.",
   "keywords": [
     "typescript",
@@ -51,12 +51,12 @@
     }
   ],
   "dependencies": {
-    "@kubb/adapter-oas": "5.0.0-alpha.39",
-    "@kubb/agent": "5.0.0-alpha.39",
-    "@kubb/cli": "5.0.0-alpha.39",
-    "@kubb/core": "5.0.0-alpha.39",
-    "@kubb/mcp": "5.0.0-alpha.39",
-    "@kubb/parser-ts": "5.0.0-alpha.39"
+    "@kubb/adapter-oas": "5.0.0-alpha.40",
+    "@kubb/agent": "5.0.0-alpha.40",
+    "@kubb/cli": "5.0.0-alpha.40",
+    "@kubb/core": "5.0.0-alpha.40",
+    "@kubb/mcp": "5.0.0-alpha.40",
+    "@kubb/parser-ts": "5.0.0-alpha.40"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0"

package/src/defineConfig.ts

@@ -1,8 +1,14 @@
 import { isPromise, type PossiblePromise } from '@internals/utils'
 import { adapterOas } from '@kubb/adapter-oas'
-import type { CLIOptions } from '@kubb/core'
+import type { CLIOptions, UserConfig } from '@kubb/core'
 import { parserTs, parserTsx } from '@kubb/parser-ts'
-import type { ConfigInput, UserConfig } from './types.ts'
+
+type ConfigValue<TInput> = UserConfig<TInput>
+type ConfigArray<TInput> = Array<ConfigValue<TInput>>
+type ConfigResult<TInput> = ConfigValue<TInput> | ConfigArray<TInput>
+type ConfigPromise<TInput> = Promise<ConfigResult<TInput>>
+type ConfigFactory<TInput> = (cli: CLIOptions) => PossiblePromise<ConfigResult<TInput>>
+type DefinedConfig<TInput> = ConfigResult<TInput> | ConfigPromise<TInput> | ((cli: CLIOptions) => Promise<ConfigResult<TInput>>)
 
 /**
  * Applies default adapter and parsers to a single user config when not set.
@@ -10,7 +16,7 @@ import type { ConfigInput, UserConfig } from './types.ts'
  * - `adapter` defaults to `adapterOas()`
  * - `parsers` defaults to `[parserTs, parserTsx]`
  */
-function applyDefaults(config: UserConfig): UserConfig {
+function applyDefaults<TInput>(config: UserConfig<TInput>): UserConfig<TInput> {
   return {
     ...config,
     adapter: config.adapter ?? adapterOas(),
@@ -18,6 +24,14 @@ function applyDefaults(config: UserConfig): UserConfig {
   }
 }
 
+function normalizeConfig<TInput>(config: UserConfig<TInput> | Array<UserConfig<TInput>>): UserConfig<TInput> | Array<UserConfig<TInput>> {
+  if (Array.isArray(config)) {
+    return config.map(applyDefaults)
+  }
+
+  return applyDefaults(config)
+}
+
 /**
  * Helper for defining a Kubb configuration with built-in defaults.
  *
@@ -35,31 +49,25 @@ function applyDefaults(config: UserConfig): UserConfig {
  *   plugins: [myPlugin()],
  * }))
  */
-export function defineConfig(config: (cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>): (cli: CLIOptions) => Promise<UserConfig | UserConfig[]>
-export function defineConfig(config: Promise<UserConfig | UserConfig[]>): Promise<UserConfig | UserConfig[]>
-export function defineConfig(config: UserConfig | UserConfig[]): UserConfig | UserConfig[]
-export function defineConfig(config: ConfigInput): ConfigInput {
+export function defineConfig<TInput>(config: (cli: CLIOptions) => PossiblePromise<UserConfig<TInput>>): (cli: CLIOptions) => Promise<UserConfig<TInput>>
+export function defineConfig<TInput>(
+  config: (cli: CLIOptions) => PossiblePromise<Array<UserConfig<TInput>>>,
+): (cli: CLIOptions) => Promise<Array<UserConfig<TInput>>>
+export function defineConfig<TInput>(config: Promise<UserConfig<TInput>>): Promise<UserConfig<TInput>>
+export function defineConfig<TInput>(config: Promise<Array<UserConfig<TInput>>>): Promise<Array<UserConfig<TInput>>>
+export function defineConfig<TInput>(config: UserConfig<TInput>): UserConfig<TInput>
+export function defineConfig<TInput>(config: Array<UserConfig<TInput>>): Array<UserConfig<TInput>>
+export function defineConfig<TInput>(config: ConfigFactory<TInput>): (cli: CLIOptions) => Promise<ConfigResult<TInput>>
+export function defineConfig<TInput>(config: ConfigResult<TInput> | ConfigPromise<TInput> | ConfigFactory<TInput>): DefinedConfig<TInput> {
   if (typeof config === 'function') {
     return async (cli: CLIOptions) => {
-      const resolved = await config(cli)
-      const configs = Array.isArray(resolved) ? resolved : [resolved]
-      const result = configs.map(applyDefaults)
-
-      return result.length === 1 ? result[0]! : result
+      return normalizeConfig(await config(cli))
     }
   }
 
   if (isPromise(config)) {
-    return config.then((resolved) => {
-      const configs = Array.isArray(resolved) ? resolved : [resolved]
-      const result = configs.map(applyDefaults)
-
-      return result.length === 1 ? result[0]! : result
-    })
+    return config.then((resolved) => normalizeConfig(resolved))
   }
 
-  const configs = Array.isArray(config) ? config : [config]
-  const result = configs.map(applyDefaults)
-
-  return result.length === 1 ? result[0]! : result
+  return normalizeConfig(config)
 }

package/src/types.ts

@@ -1,52 +0,0 @@
-import type { PossiblePromise } from '@internals/utils'
-import type { Adapter, CLIOptions, Config, HookStylePlugin, InputData, InputPath, Parser, PluginFactoryOptions, UserPlugin } from '@kubb/core'
-
-type Input = InputPath | InputData
-type UnknownUserPlugin = UserPlugin<PluginFactoryOptions<string, object, object, unknown, object>>
-
-/**
- * Partial version of {@link Config} intended for use in `kubb.config.ts`.
- *
- * Fields that have sensible defaults (`root`, `plugins`, `parsers`, `adapter`) are optional.
- */
-export type UserConfig<TInput = Input> = Omit<Config<TInput>, 'root' | 'plugins' | 'parsers' | 'adapter'> & {
-  /**
-   * The project root directory, which can be either an absolute path or a path relative to the location of your `kubb.config.ts` file.
-   * @default process.cwd()
-   */
-  root?: string
-  /**
-   * An array of parsers used to convert generated files to strings.
-   * Each parser handles specific file extensions (e.g. `.ts`, `.tsx`).
-   *
-   * A catch-all fallback parser is always appended last for any unhandled extension.
-   *
-   * When omitted, `parserTsx` from `@kubb/parser-ts` is used automatically as the
-   * default (requires `@kubb/parser-ts` to be installed as an optional dependency).
-   * @default [parserTsx] — from `@kubb/parser-ts`
-   */
-  parsers?: Array<Parser>
-  /**
-   * Adapter that converts the input file into a `@kubb/ast` `InputNode` — the universal
-   * intermediate representation consumed by all Kubb plugins.
-   *
-   * When omitted, `adapterOas()` from `@kubb/adapter-oas` is used automatically as the
-   * default (requires `@kubb/adapter-oas` to be installed as an optional dependency).
-   *
-   * @default adapterOas() — from `@kubb/adapter-oas`
-   */
-  adapter?: Adapter
-  /**
-   * An array of Kubb plugins used for code generation.
-   * Each plugin may declare additional configurable options.
-   * If a plugin depends on another, an error is thrown when the dependency is missing.
-   * Use `dependencies` on the plugin to declare execution order.
-   */
-  // inject needs to be omitted because else we have a clash with the PluginDriver instance
-  plugins?: Array<Omit<UnknownUserPlugin, 'inject'> | HookStylePlugin>
-}
-
-/**
- * All accepted forms of a Kubb configuration.
- */
-export type ConfigInput = PossiblePromise<UserConfig | UserConfig[]> | ((cli: CLIOptions) => PossiblePromise<UserConfig | UserConfig[]>)