@kubb/core 5.0.0-beta.89 → 5.0.0-beta.91

package/dist/index.d.ts

@@ -1,6 +1,35 @@
 import { t as __name } from "./rolldown-runtime-C0LytTxp.js";
-import { $ as Include, A as KubbHookStartContext, At as Reporter, B as Kubb, C as KubbFilesProcessingEndContext, Ct as ResolverPathParams, D as KubbGenerationStartContext, Dt as Storage, E as KubbGenerationEndContext, Et as createRenderer, F as KubbSuccessContext, Ft as logLevel, G as KubbDriver, H as Generator, I as KubbWarnContext, It as Adapter, J as Parser, K as FileManagerHooks, L as PossibleConfig, Lt as AdapterFactoryOptions, M as KubbInfoContext, Mt as ReporterName, N as KubbLifecycleStartContext, Nt as UserReporter, O as KubbHookEndContext, Ot as createStorage, P as KubbPluginsEndContext, Pt as createReporter, Q as Group, R as UserConfig, Rt as AdapterSource, S as KubbFileProcessingUpdate, St as ResolverPatch, T as KubbFilesProcessingUpdateContext, Tt as RendererFactory, U as GeneratorContext, V as createKubb, W as defineGenerator, X as Exclude, Y as defineParser, Z as Filter, _ as InputPath, _t as Resolver, a as DiagnosticLocation, at as OutputMode, b as KubbDiagnosticContext, bt as ResolverFileParams, c as PerformanceDiagnostic, ct as Plugin, d as SerializedDiagnostic, dt as BannerMeta, et as KubbPluginEndContext, f as UpdateDiagnostic, ft as ResolveBannerContext, g as InputData, gt as ResolvePathOptions, h as Config, ht as ResolveOptionsContext, i as DiagnosticKind, it as Output, j as KubbHooks, jt as ReporterContext, k as KubbHookLineContext, kt as GenerationResult, l as ProblemCode, lt as PluginFactoryOptions, m as CLIOptions, mt as ResolveFileOptions, n as DiagnosticByCode, nt as KubbPluginStartContext, o as DiagnosticSeverity, ot as OutputOptions, p as BuildOutput, pt as ResolveBannerFile, q as Hookable, r as DiagnosticDoc, rt as NormalizedPlugin, s as Diagnostics, st as Override, t as Diagnostic, tt as KubbPluginSetupContext, u as ProblemDiagnostic, ut as definePlugin, v as KubbBuildEndContext, vt as ResolverDefault, w as KubbFilesProcessingStartContext, wt as Renderer, x as KubbErrorContext, xt as ResolverFilePathParams, y as KubbBuildStartContext, yt as ResolverFile, z as CreateKubbOptions, zt as createAdapter } from "./Diagnostics-CM0-Ae30.js";
+import { $ as ResolveBannerFile, A as GeneratorContext, At as ProblemCode, B as KubbPluginEndContext, C as KubbWarnContext, Ct as DiagnosticByCode, D as Kubb, Dt as DiagnosticSeverity, E as CreateKubbOptions, Et as DiagnosticLocation, F as defineParser, Ft as Adapter, G as OutputMode, H as KubbPluginStartContext, I as Exclude, It as AdapterFactoryOptions, J as Plugin, K as OutputOptions, L as Filter, Lt as AdapterSource, M as KubbDriver, Mt as SerializedDiagnostic, N as FileManagerHooks, Nt as UpdateDiagnostic, O as createKubb, Ot as Diagnostics, P as Parser, Pt as Hookable, Q as ResolveBannerContext, R as Group, Rt as createAdapter, S as KubbSuccessContext, St as Diagnostic, T as UserConfig, Tt as DiagnosticKind, U as NormalizedPlugin, V as KubbPluginSetupContext, W as Output, X as definePlugin, Y as PluginFactoryOptions, Z as BannerMeta, _ as KubbHookStartContext, _t as ReporterContext, a as KubbBuildEndContext, at as ResolverFile, b as KubbLifecycleStartContext, bt as createReporter, c as KubbErrorContext, ct as ResolverPatch, d as KubbFilesProcessingStartContext, dt as RendererFactory, et as ResolveFileOptions, f as KubbFilesProcessingUpdateContext, ft as createRenderer, g as KubbHookLineContext, gt as Reporter, h as KubbHookEndContext, ht as GenerationResult, i as Input, it as ResolverDefault, j as defineGenerator, jt as ProblemDiagnostic, k as Generator, kt as PerformanceDiagnostic, l as KubbFileProcessingUpdate, lt as ResolverPathParams, m as KubbGenerationStartContext, mt as createStorage, n as CLIOptions, nt as ResolvePathOptions, o as KubbBuildStartContext, ot as ResolverFileParams, p as KubbGenerationEndContext, pt as Storage, q as Override, r as Config, rt as Resolver, s as KubbDiagnosticContext, st as ResolverFilePathParams, t as BuildOutput, tt as ResolveOptionsContext, u as KubbFilesProcessingEndContext, ut as Renderer, v as KubbHooks, vt as ReporterName, w as PossibleConfig, wt as DiagnosticDoc, x as KubbPluginsEndContext, xt as logLevel, y as KubbInfoContext, yt as UserReporter, z as Include } from "./types-aNebW3Ui.js";
 
+//#region src/applyConfigDefaults.d.ts
+type ApplyConfigDefaultsOptions<TOutput> = {
+  defaultAdapter: Adapter;
+  barrelPlugin: Plugin;
+  barrelPluginName: string; /** Output fields to fill in when the user's config leaves them unset. */
+  defaultOutput: Partial<TOutput>;
+};
+/**
+ * Fills in the config defaults shared by `defineConfig` and the unplugin factory: the fallback
+ * adapter, `defaultOutput`'s fields, and appending the barrel plugin when it's not already
+ * registered. Both entry points construct their own adapter, barrel plugin, and output defaults
+ * (`barrel` is a `@kubb/plugin-barrel` extension field core doesn't know about) and pass them in,
+ * so `@kubb/core` doesn't need to depend on `@kubb/adapter-oas` or `@kubb/plugin-barrel`.
+ */
+declare function applyConfigDefaults<TOutput extends Config['output'] = Config['output']>(config: {
+  adapter?: Adapter;
+  output: TOutput;
+  plugins?: Array<Plugin>;
+}, {
+  defaultAdapter,
+  barrelPlugin,
+  barrelPluginName,
+  defaultOutput
+}: ApplyConfigDefaultsOptions<TOutput>): {
+  adapter: Adapter;
+  output: TOutput;
+  plugins: Array<Plugin>;
+};
+//#endregion
 //#region src/reporters/cliReporter.d.ts
 /**
  * The default `cli` reporter. Renders the {@link Report} for each config as it finishes, independent
@@ -88,6 +117,25 @@ type ResolverOptions<T extends PluginFactoryOptions> = Omit<T['resolver'], keyof
  */
 declare function createResolver<T extends PluginFactoryOptions>(options: ResolverOptions<T>): T['resolver'];
 //#endregion
+//#region src/input.d.ts
+/**
+ * What an `input` value points at, once Kubb has looked at it.
+ *
+ * - `file` is a local file path, absolute or relative to the config file.
+ * - `url` is a remote document to fetch.
+ * - `inline` is OpenAPI content held in the string itself (JSON or YAML).
+ * - `object` is an already-parsed spec.
+ */
+type InputKind = 'file' | 'url' | 'inline' | 'object';
+/**
+ * Classifies an `input` value so callers branch on it once instead of repeating the checks.
+ *
+ * A non-string is a parsed spec (`object`). A string is `inline` when it holds OpenAPI content,
+ * meaning it starts with `{` or `[`, spans multiple lines, or opens with a YAML `openapi:` or
+ * `swagger:` key. Otherwise a string is a `url` when it parses as one, or a `file` path.
+ */
+declare function getInputKind(input: NonNullable<Input>): InputKind;
+//#endregion
 //#region src/storages/fsStorage.d.ts
 /**
  * Built-in filesystem storage driver.
@@ -110,7 +158,7 @@ declare function createResolver<T extends PluginFactoryOptions>(options: Resolve
  * import { defineConfig } from 'kubb'
  *
  * export default defineConfig({
- *   input:  { path: './petStore.yaml' },
+ *   input:  './petStore.yaml',
  *   output: { path: './src/gen' },
  *   storage: fsStorage(),
  * })
@@ -132,7 +180,7 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  * import { defineConfig } from 'kubb'
  *
  * export default defineConfig({
- *   input:  { path: './petStore.yaml' },
+ *   input:  './petStore.yaml',
  *   output: { path: './src/gen' },
  *   storage: memoryStorage(),
  * })
@@ -140,5 +188,5 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  */
 declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileManagerHooks, type Filter, type GenerationResult, type Generator, type GeneratorContext, type Group, Hookable, type Include, InputData, InputPath, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveFileOptions, type ResolveOptionsContext, type ResolvePathOptions, Resolver, type ResolverDefault, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage };
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, type BannerMeta, BuildOutput, CLIOptions, Config, type CreateKubbOptions, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileManagerHooks, type Filter, type GenerationResult, type Generator, type GeneratorContext, type Group, Hookable, type Include, Input, type InputKind, type Kubb, KubbBuildEndContext, KubbBuildStartContext, KubbDiagnosticContext, KubbDriver, KubbErrorContext, KubbFileProcessingUpdate, KubbFilesProcessingEndContext, KubbFilesProcessingStartContext, KubbFilesProcessingUpdateContext, KubbGenerationEndContext, KubbGenerationStartContext, KubbHookEndContext, KubbHookLineContext, KubbHookStartContext, KubbHooks, KubbInfoContext, KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, KubbPluginsEndContext, KubbSuccessContext, KubbWarnContext, type NormalizedPlugin, type Output, type OutputMode, type OutputOptions, type Override, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveFileOptions, type ResolveOptionsContext, type ResolvePathOptions, Resolver, type ResolverDefault, type ResolverFile, type ResolverFileParams, type ResolverFilePathParams, type ResolverPatch, type ResolverPathParams, type SerializedDiagnostic, type Storage, type UpdateDiagnostic, UserConfig, type UserReporter, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, jsonReporter, logLevel, memoryStorage };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 import "./rolldown-runtime-C0LytTxp.js";
-import { a as toFilePath, c as BuildError, d as camelCase, i as clean, l as getErrorMessage, n as FileManager, o as toPosixPath, r as Hookable, s as write, t as _usingCtx, u as toError } from "./usingCtx-Cnrm3TcM.js";
+import { a as toFilePath, c as BuildError, d as camelCase, i as clean, l as getErrorMessage, n as FileManager, o as toPosixPath, r as Hookable, s as write, t as _usingCtx, u as toError } from "./usingCtx-BriKju-v.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { stripVTControlCharacters, styleText } from "node:util";
 import { hash } from "node:crypto";
@@ -42,6 +42,26 @@ function createAdapter(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
+//#region src/applyConfigDefaults.ts
+/**
+* Fills in the config defaults shared by `defineConfig` and the unplugin factory: the fallback
+* adapter, `defaultOutput`'s fields, and appending the barrel plugin when it's not already
+* registered. Both entry points construct their own adapter, barrel plugin, and output defaults
+* (`barrel` is a `@kubb/plugin-barrel` extension field core doesn't know about) and pass them in,
+* so `@kubb/core` doesn't need to depend on `@kubb/adapter-oas` or `@kubb/plugin-barrel`.
+*/
+function applyConfigDefaults(config, { defaultAdapter, barrelPlugin, barrelPluginName, defaultOutput }) {
+	const plugins = config.plugins?.some((plugin) => plugin.name === barrelPluginName) ? config.plugins ?? [] : [...config.plugins ?? [], barrelPlugin];
+	return {
+		adapter: config.adapter ?? defaultAdapter,
+		plugins,
+		output: {
+			...defaultOutput,
+			...config.output
+		}
+	};
+}
+//#endregion
 //#region ../../internals/utils/src/time.ts
 /**
 * Calculates elapsed time in milliseconds from a high-resolution `process.hrtime` start time.
@@ -170,7 +190,7 @@ function memoize(store, factory) {
 }
 //#endregion
 //#region package.json
-var version = "5.0.0-beta.89";
+var version = "5.0.0-beta.91";
 //#endregion
 //#region src/constants.ts
 /**
@@ -196,7 +216,7 @@ const diagnosticCode = {
 	*/
 	unknown: "KUBB_UNKNOWN",
 	/**
-	* The `input.path` file or URL could not be read.
+	* The file or URL set as `input` could not be read.
 	*/
 	inputNotFound: "KUBB_INPUT_NOT_FOUND",
 	/**
@@ -351,13 +371,13 @@ const diagnosticCatalog = {
 	},
 	[diagnosticCode.inputNotFound]: {
 		title: "Input not found",
-		cause: "The file or URL set in `input.path` (or passed as `kubb generate PATH`) could not be read.",
-		fix: "Check that the path or URL exists and is readable, then set it in `input.path` or pass it on the CLI."
+		cause: "The file or URL set as `input` (or passed as `kubb generate PATH`) could not be read.",
+		fix: "Check that the path or URL exists and is readable, then set it as `input` or pass it on the CLI."
 	},
 	[diagnosticCode.inputRequired]: {
 		title: "Input required",
 		cause: "An adapter is configured but no `input` was provided.",
-		fix: "Set `input.path` (a file or URL) or `input.data` (an inline spec) in your Kubb config."
+		fix: "Set `input` to a file path, a URL, an inline spec (JSON/YAML string), or a parsed object in your Kubb config."
 	},
 	[diagnosticCode.refNotFound]: {
 		title: "Reference not found",
@@ -740,6 +760,55 @@ function definePlugin(factory) {
 	return (options) => factory(options ?? {});
 }
 //#endregion
+//#region src/input.ts
+/**
+* Classifies an `input` value so callers branch on it once instead of repeating the checks.
+*
+* A non-string is a parsed spec (`object`). A string is `inline` when it holds OpenAPI content,
+* meaning it starts with `{` or `[`, spans multiple lines, or opens with a YAML `openapi:` or
+* `swagger:` key. Otherwise a string is a `url` when it parses as one, or a `file` path.
+*/
+function getInputKind(input) {
+	if (typeof input !== "string") return "object";
+	const trimmed = input.trimStart();
+	if (trimmed.startsWith("{") || trimmed.startsWith("[") || input.includes("\n") || /^(openapi|swagger)\s*:/i.test(trimmed)) return "inline";
+	if (URL.canParse(input)) return "url";
+	return "file";
+}
+/**
+* Normalizes `config.input` into an `AdapterSource` the adapter can parse.
+*
+* A parsed object and inline content become `{ type: 'data' }`; a URL is kept verbatim and a
+* local path is resolved against `config.root`, both as `{ type: 'path' }`.
+*/
+function inputToAdapterSource(config) {
+	const input = config.input;
+	if (!input) throw new Diagnostics.Error({
+		code: Diagnostics.code.inputRequired,
+		severity: "error",
+		message: "An adapter is configured without an input.",
+		help: "Set `input` to a file path, a URL, an inline spec (JSON/YAML string), or a parsed object in your Kubb config.",
+		location: { kind: "config" }
+	});
+	if (typeof input !== "string") return {
+		type: "data",
+		data: input
+	};
+	const kind = getInputKind(input);
+	if (kind === "inline") return {
+		type: "data",
+		data: input
+	};
+	if (kind === "url") return {
+		type: "path",
+		path: input
+	};
+	return {
+		type: "path",
+		path: resolve(config.root, input)
+	};
+}
+//#endregion
 //#region src/Resolver.ts
 function isNamespace(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1028,8 +1097,10 @@ var Resolver = class Resolver {
 			"* Do not edit manually."
 		];
 		if (config.output.defaultBanner !== "simple") {
-			const input = Array.isArray(config.input) ? config.input[0] : config.input;
-			const source = input && "path" in input ? path.basename(input.path) : input && "data" in input ? "text content" : "";
+			const input = config.input;
+			let source = "";
+			if (typeof input === "string") source = getInputKind(input) === "inline" ? "text content" : path.basename(input);
+			else if (input) source = "text content";
 			if (source) lines.push(`* Source: ${source}`);
 			if (title) lines.push(`* Title: ${title}`);
 			if (version) lines.push(`* OpenAPI spec version: ${version}`);
@@ -1318,14 +1389,12 @@ var KubbDriver = class {
 	* plugins can configure generators, resolvers, macros, and options before `buildStart`.
 	*/
 	async setupHooks() {
-		const noop = () => {};
 		for (const plugin of this.plugins.values()) {
 			const setup = plugin.hooks?.["kubb:plugin:setup"];
 			if (!setup) continue;
 			await setup({
 				config: this.config,
 				options: plugin.options ?? {},
-				updateConfig: noop,
 				addGenerator: (...generators) => {
 					for (const generator of generators) this.registerGenerator(plugin.name, generator);
 				},
@@ -1489,8 +1558,7 @@ var KubbDriver = class {
 				await hooks.callHook("kubb:plugins:end", Object.assign({ config }, this.#filesPayload()));
 				await fileManager.write(fileManager.files, {
 					storage: config.storage,
-					parsers: parsersMap,
-					extension: config.output.extension
+					parsers: parsersMap
 				});
 				await hooks.callHook("kubb:build:end", {
 					files: this.fileManager.files,
@@ -1808,28 +1876,6 @@ var KubbDriver = class {
 		});
 	}
 };
-function inputToAdapterSource(config) {
-	const input = config.input;
-	if (!input) throw new Diagnostics.Error({
-		code: Diagnostics.code.inputRequired,
-		severity: "error",
-		message: "An adapter is configured without an input.",
-		help: "Provide `input.path` (a file or URL) or `input.data` (an inline spec) in your Kubb config.",
-		location: { kind: "config" }
-	});
-	if ("data" in input) return {
-		type: "data",
-		data: input.data
-	};
-	if (URL.canParse(input.path)) return {
-		type: "path",
-		path: input.path
-	};
-	return {
-		type: "path",
-		path: resolve(config.root, input.path)
-	};
-}
 //#endregion
 //#region src/createStorage.ts
 /**
@@ -1919,7 +1965,7 @@ function createLimiter(concurrency) {
 * import { defineConfig } from 'kubb'
 *
 * export default defineConfig({
-*   input:  { path: './petStore.yaml' },
+*   input:  './petStore.yaml',
 *   output: { path: './src/gen' },
 *   storage: fsStorage(),
 * })
@@ -1977,7 +2023,6 @@ function resolveConfig(userConfig) {
 		output: {
 			format: false,
 			lint: false,
-			extension: { ".ts": ".ts" },
 			defaultBanner: "simple",
 			...userConfig.output
 		},
@@ -2087,7 +2132,7 @@ var Kubb = class {
 * import { pluginTs } from '@kubb/plugin-ts'
 *
 * const kubb = createKubb({
-*   input: { path: './petStore.yaml' },
+*   input: './petStore.yaml',
 *   output: { path: './src/gen' },
 *   adapter: adapterOas(),
 *   plugins: [pluginTs()],
@@ -2412,30 +2457,34 @@ function defineGenerator(generator) {
 //#endregion
 //#region src/defineParser.ts
 /**
-* Defines a parser with type-safe `this`. Used to register handlers for new
-* file extensions or to plug a non-TypeScript output into the build.
+* Wraps a parser factory and returns a function that accepts user options and
+* yields a typed {@link Parser}. Mirrors {@link definePlugin}: the factory
+* receives the caller's options, and calling the returned function without
+* options passes an empty object.
+*
+* Register the result in the `parsers` array on `defineConfig`, calling it to
+* apply options (`parserTs({ extension: { '.ts': '.js' } })`).
 *
 * @example
 * ```ts
 * import { defineParser } from '@kubb/core'
 * import { extractStringsFromNodes } from '@kubb/ast'
 *
-* export const jsonParser = defineParser({
+* export const parserJson = defineParser((options: { pretty?: boolean } = {}) => ({
 *   name: 'json',
 *   extNames: ['.json'],
 *   parse(file) {
-*     return file.sources
-*       .map((source) => extractStringsFromNodes(source.nodes ?? []))
-*       .join('\n')
+*     const source = file.sources.map((source) => extractStringsFromNodes(source.nodes ?? [])).join('\n')
+*     return options.pretty ? JSON.stringify(JSON.parse(source), null, 2) : source
 *   },
 *   print(...nodes) {
 *     return nodes.map(String).join('\n')
 *   },
-* })
+* }))
 * ```
 */
-function defineParser(parser) {
-	return parser;
+function defineParser(factory) {
+	return (options) => factory(options ?? {});
 }
 //#endregion
 //#region src/storages/memoryStorage.ts
@@ -2452,7 +2501,7 @@ function defineParser(parser) {
 * import { defineConfig } from 'kubb'
 *
 * export default defineConfig({
-*   input:  { path: './petStore.yaml' },
+*   input:  './petStore.yaml',
 *   output: { path: './src/gen' },
 *   storage: memoryStorage(),
 * })
@@ -2488,6 +2537,6 @@ const memoryStorage = createStorage(() => {
 	};
 });
 //#endregion
-export { Diagnostics, Hookable, KubbDriver, Resolver, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage };
+export { Diagnostics, Hookable, KubbDriver, Resolver, applyConfigDefaults, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createResolver, createStorage, defineGenerator, defineParser, definePlugin, fileReporter, fsStorage, getInputKind, jsonReporter, logLevel, memoryStorage };
 
 //# sourceMappingURL=index.js.map