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

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_usingCtx = require("./usingCtx-BN2OKJRx.cjs");
+const require_usingCtx = require("./usingCtx-eyNeehd2.cjs");
 let node_async_hooks = require("node:async_hooks");
 let node_util = require("node:util");
 let node_crypto = require("node:crypto");
@@ -44,6 +44,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.
@@ -172,7 +192,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
 /**
@@ -198,7 +218,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",
 	/**
@@ -353,13 +373,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",
@@ -742,6 +762,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: (0, node_path.resolve)(config.root, input)
+	};
+}
+//#endregion
 //#region src/Resolver.ts
 function isNamespace(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -1030,8 +1099,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 ? node_path.default.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" : node_path.default.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}`);
@@ -1320,14 +1391,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);
 				},
@@ -1491,8 +1560,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,
@@ -1810,28 +1878,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: (0, node_path.resolve)(config.root, input.path)
-	};
-}
 //#endregion
 //#region src/createStorage.ts
 /**
@@ -1921,7 +1967,7 @@ function createLimiter(concurrency) {
 * import { defineConfig } from 'kubb'
 *
 * export default defineConfig({
-*   input:  { path: './petStore.yaml' },
+*   input:  './petStore.yaml',
 *   output: { path: './src/gen' },
 *   storage: fsStorage(),
 * })
@@ -1979,7 +2025,6 @@ function resolveConfig(userConfig) {
 		output: {
 			format: false,
 			lint: false,
-			extension: { ".ts": ".ts" },
 			defaultBanner: "simple",
 			...userConfig.output
 		},
@@ -2089,7 +2134,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()],
@@ -2414,30 +2459,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
@@ -2454,7 +2503,7 @@ function defineParser(parser) {
 * import { defineConfig } from 'kubb'
 *
 * export default defineConfig({
-*   input:  { path: './petStore.yaml' },
+*   input:  './petStore.yaml',
 *   output: { path: './src/gen' },
 *   storage: memoryStorage(),
 * })
@@ -2494,6 +2543,7 @@ exports.Diagnostics = Diagnostics;
 exports.Hookable = require_usingCtx.Hookable;
 exports.KubbDriver = KubbDriver;
 exports.Resolver = Resolver;
+exports.applyConfigDefaults = applyConfigDefaults;
 exports.cliReporter = cliReporter;
 exports.createAdapter = createAdapter;
 exports.createKubb = createKubb;
@@ -2506,6 +2556,7 @@ exports.defineParser = defineParser;
 exports.definePlugin = definePlugin;
 exports.fileReporter = fileReporter;
 exports.fsStorage = fsStorage;
+exports.getInputKind = getInputKind;
 exports.jsonReporter = jsonReporter;
 exports.logLevel = logLevel;
 exports.memoryStorage = memoryStorage;