@kubb/core 4.22.0 → 4.22.2

package/dist/utils.d.ts

@@ -1,226 +1,3 @@
-import { t as __name } from "./chunk-iVr_oF3V.js";
-import { F as AsyncEventEmitter, j as PossiblePromise } from "./types-Dv2RimvH.js";
-import { n as getBarrelFiles } from "./getBarrelFiles-D_2NWu2Q.js";
-
-//#region src/utils/buildJSDoc.d.ts
-
-/**
- * Builds a JSDoc comment block with custom indentation.
- * @param comments - Array of comment strings to include in the JSDoc block
- * @param options - Configuration options for formatting
- * @returns Formatted JSDoc string or fallback string if no comments
- */
-declare function buildJSDoc(comments: Array<string>, options?: {
-  /**
-   * String to use for indenting each line of the JSDoc comment
-   * @default '   * ' (3 spaces + asterisk + space)
-   */
-  indent?: string;
-  /**
-   * String to append after the closing JSDoc tag
-   * @default '\n  ' (newline + 2 spaces)
-   */
-  suffix?: string;
-  /**
-   * String to return when there are no comments
-   * @default '  ' (2 spaces)
-   */
-  fallback?: string;
-}): string;
-//#endregion
-//#region src/utils/Cache.d.ts
-declare class Cache<T> {
-  #private;
-  get(key: string): Promise<T | null>;
-  set(key: string, value: T): Promise<void>;
-  delete(key: string): Promise<void>;
-  clear(): Promise<void>;
-  keys(): Promise<string[]>;
-  values(): Promise<T[]>;
-  flush(): Promise<void>;
-}
-//#endregion
-//#region src/utils/checkOnlineStatus.d.ts
-/**
- * Check if the system has internet connectivity
- * Uses DNS lookup to well-known stable domains as a lightweight connectivity test
- */
-declare function isOnline(): Promise<boolean>;
-/**
- * Execute a function only if online, otherwise silently skip
- */
-declare function executeIfOnline<T>(fn: () => Promise<T>): Promise<T | null>;
-//#endregion
-//#region src/utils/FunctionParams.d.ts
-type FunctionParamsASTWithoutType = {
-  name?: string;
-  type?: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-type FunctionParamsASTWithType = {
-  name?: never;
-  type: string;
-  /**
-   * @default true
-   */
-  required?: boolean;
-  /**
-   * @default true
-   */
-  enabled?: boolean;
-  default?: string;
-};
-/**
- * @deprecated
- */
-type FunctionParamsAST = FunctionParamsASTWithoutType | FunctionParamsASTWithType;
-/**
- * @deprecated
- */
-declare class FunctionParams {
-  #private;
-  constructor();
-  get items(): FunctionParamsAST[];
-  add(item: FunctionParamsAST | Array<FunctionParamsAST | FunctionParamsAST[] | undefined> | undefined): FunctionParams;
-  static toObject(items: FunctionParamsAST[]): FunctionParamsAST;
-  toObject(): FunctionParamsAST;
-  static toString(items: (FunctionParamsAST | FunctionParamsAST[])[]): string;
-  toString(): string;
-}
-//#endregion
-//#region src/utils/formatHrtime.d.ts
-/**
- * Calculates elapsed time in milliseconds from a high-resolution start time.
- * Rounds to 2 decimal places to provide sub-millisecond precision without noise.
- */
-declare function getElapsedMs(hrStart: [number, number]): number;
-/**
- * Converts a millisecond duration into a human-readable string.
- * Adjusts units (ms, s, m s) based on the magnitude of the duration.
- */
-declare function formatMs(ms: number): string;
-/**
- * Convenience helper to get and format elapsed time in one step.
- */
-declare function formatHrtime(hrStart: [number, number]): string;
-//#endregion
-//#region src/utils/getNestedAccessor.d.ts
-/**
- * Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
- * @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
- * @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
- * @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
- *
- * @example
- * ```ts
- * getNestedAccessor('pagination.next.id', 'lastPage')
- * // returns: "lastPage?.['pagination']?.['next']?.['id']"
- *
- * getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
- * // returns: "lastPage?.['pagination']?.['next']?.['id']"
- *
- * getNestedAccessor('', 'lastPage')
- * // returns: undefined
- * ```
- */
-declare function getNestedAccessor(param: string | string[], accessor: string): string | undefined;
-//#endregion
-//#region src/utils/promise.d.ts
-declare function isPromise<T>(result: PossiblePromise<T>): result is Promise<T>;
-declare function isPromiseFulfilledResult<T = unknown>(result: PromiseSettledResult<unknown>): result is PromiseFulfilledResult<T>;
-declare function isPromiseRejectedResult<T>(result: PromiseSettledResult<unknown>): result is Omit<PromiseRejectedResult, 'reason'> & {
-  reason: T;
-};
-//#endregion
-//#region src/utils/renderTemplate.d.ts
-declare function renderTemplate<TData extends Record<string, unknown> = Record<string, unknown>>(template: string, data?: TData | undefined): string;
-//#endregion
-//#region src/utils/resolveModuleSource.d.ts
-declare function resolveModuleSource(pkgName: string): {
-  readonly path: string;
-  readonly source: string;
-  readonly ext: string;
-};
-//#endregion
-//#region src/utils/serializePluginOptions.d.ts
-/**
- * Serialize plugin options for safe JSON transport.
- * Strips functions, symbols, and undefined values recursively.
- */
-declare function serializePluginOptions(options: unknown): unknown;
-//#endregion
-//#region src/utils/timeout.d.ts
-declare function timeout(ms: number): Promise<unknown>;
-//#endregion
-//#region src/utils/URLPath.d.ts
-type URLObject = {
-  url: string;
-  params?: Record<string, string>;
-};
-type ObjectOptions = {
-  type?: 'path' | 'template';
-  replacer?: (pathParam: string) => string;
-  stringify?: boolean;
-};
-type Options = {
-  casing?: 'camelcase';
-};
-declare class URLPath {
-  #private;
-  path: string;
-  constructor(path: string, options?: Options);
-  /**
-   * Convert Swagger path to URLPath(syntax of Express)
-   * @example /pet/{petId} => /pet/:petId
-   */
-  get URL(): string;
-  get isURL(): boolean;
-  /**
-   * Convert Swagger path to template literals/ template strings(camelcase)
-   * @example /pet/{petId} => `/pet/${petId}`
-   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
-   * @example /account/userID => `/account/${userId}`
-   */
-  get template(): string;
-  get object(): URLObject | string;
-  get params(): Record<string, string> | undefined;
-  toObject({
-    type,
-    replacer,
-    stringify
-  }?: ObjectOptions): URLObject | string;
-  /**
-   * Convert Swagger path to template literals/ template strings(camelcase)
-   * @example /pet/{petId} => `/pet/${petId}`
-   * @example /account/monetary-accountID => `/account/${monetaryAccountId}`
-   * @example /account/userID => `/account/${userId}`
-   */
-  toTemplateString({
-    prefix,
-    replacer
-  }?: {
-    prefix?: string;
-    replacer?: (pathParam: string) => string;
-  }): string;
-  getParams(replacer?: (pathParam: string) => string): Record<string, string> | undefined;
-  /**
-   * Convert Swagger path to URLPath(syntax of Express)
-   * @example /pet/{petId} => /pet/:petId
-   */
-  toURLPath(): string;
-}
-//#endregion
-//#region src/utils/uniqueName.d.ts
-declare function getUniqueName(originalName: string, data: Record<string, number>): string;
-declare function setUniqueName(originalName: string, data: Record<string, number>): string;
-//#endregion
-export { AsyncEventEmitter, Cache, FunctionParams, type FunctionParamsAST, type URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
-//# sourceMappingURL=utils.d.ts.map
+import { A as AsyncEventEmitter } from "./types-Cn3Gwsf3.js";
+import { C as buildJSDoc, S as Cache, _ as getElapsedMs, a as timeout, b as executeIfOnline, c as renderTemplate, d as isPromiseRejectedResult, f as getNestedAccessor, g as formatMs, h as formatHrtime, i as URLPath, l as isPromise, m as getBarrelFiles, n as setUniqueName, o as serializePluginOptions, r as URLObject, s as resolveModuleSource, t as getUniqueName, u as isPromiseFulfilledResult, v as FunctionParams, x as isOnline, y as FunctionParamsAST } from "./index-C0nP9vjm.js";
+export { AsyncEventEmitter, Cache, FunctionParams, FunctionParamsAST, URLObject, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };

package/dist/utils.js

@@ -1,265 +1,4 @@
-import { t as __name } from "./chunk-iVr_oF3V.js";
-import { a as getElapsedMs, i as formatMs, l as getUniqueName, n as URLPath, o as AsyncEventEmitter, r as formatHrtime, t as getBarrelFiles, u as setUniqueName } from "./getBarrelFiles-gRyVPFBP.js";
-import { m as camelCase } from "./transformers-8ju9ixkG.js";
-import path from "node:path";
-import { orderBy } from "natural-orderby";
-import { fileURLToPath } from "node:url";
-import { readFileSync } from "node:fs";
-import dns from "node:dns";
-import createJiti from "jiti";
+import { C as setUniqueName, S as getUniqueName, _ as formatMs, a as isPromise, c as getNestedAccessor, d as executeIfOnline, f as isOnline, g as formatHrtime, h as URLPath, i as renderTemplate, l as getBarrelFiles, m as buildJSDoc, n as serializePluginOptions, o as isPromiseFulfilledResult, p as Cache, r as resolveModuleSource, s as isPromiseRejectedResult, t as timeout, u as FunctionParams, v as getElapsedMs, y as AsyncEventEmitter } from "./utils-C3cuilmF.js";
+import "./transformers-8ju9ixkG.js";
 
-//#region src/utils/buildJSDoc.ts
-/**
-* Builds a JSDoc comment block with custom indentation.
-* @param comments - Array of comment strings to include in the JSDoc block
-* @param options - Configuration options for formatting
-* @returns Formatted JSDoc string or fallback string if no comments
-*/
-function buildJSDoc(comments, options = {}) {
-	const { indent = "   * ", suffix = "\n  ", fallback = "  " } = options;
-	if (comments.length === 0) return fallback;
-	return `/**\n${comments.map((c) => `${indent}${c}`).join("\n")}\n   */${suffix}`;
-}
-
-//#endregion
-//#region src/utils/Cache.ts
-var Cache = class {
-	#buffer = /* @__PURE__ */ new Map();
-	async get(key) {
-		return this.#buffer.get(key) ?? null;
-	}
-	async set(key, value) {
-		this.#buffer.set(key, value);
-	}
-	async delete(key) {
-		this.#buffer.delete(key);
-	}
-	async clear() {
-		this.#buffer.clear();
-	}
-	async keys() {
-		return [...this.#buffer.keys()];
-	}
-	async values() {
-		return [...this.#buffer.values()];
-	}
-	async flush() {}
-};
-
-//#endregion
-//#region src/utils/checkOnlineStatus.ts
-/**
-* Check if the system has internet connectivity
-* Uses DNS lookup to well-known stable domains as a lightweight connectivity test
-*/
-async function isOnline() {
-	for (const domain of [
-		"dns.google.com",
-		"cloudflare.com",
-		"one.one.one.one"
-	]) try {
-		await dns.promises.resolve(domain);
-		return true;
-	} catch {}
-	return false;
-}
-/**
-* Execute a function only if online, otherwise silently skip
-*/
-async function executeIfOnline(fn) {
-	if (!await isOnline()) return null;
-	try {
-		return await fn();
-	} catch {
-		return null;
-	}
-}
-
-//#endregion
-//#region src/utils/FunctionParams.ts
-/**
-* @deprecated
-*/
-var FunctionParams = class FunctionParams {
-	#items = [];
-	constructor() {
-		return this;
-	}
-	get items() {
-		return this.#items.flat();
-	}
-	add(item) {
-		if (!item) return this;
-		if (Array.isArray(item)) {
-			item.filter(Boolean).forEach((it) => {
-				this.#items.push(it);
-			});
-			return this;
-		}
-		this.#items.push(item);
-		return this;
-	}
-	static #orderItems(items) {
-		return orderBy(items.filter(Boolean), [(v) => {
-			if (Array.isArray(v)) return;
-			return !v.default;
-		}, (v) => {
-			if (Array.isArray(v)) return;
-			return v.required ?? true;
-		}], ["desc", "desc"]);
-	}
-	static #addParams(acc, item) {
-		const { enabled = true, name, type, required = true, ...rest } = item;
-		if (!enabled) return acc;
-		if (!name) {
-			acc.push(`${type}${rest.default ? ` = ${rest.default}` : ""}`);
-			return acc;
-		}
-		const parameterName = name.startsWith("{") ? name : camelCase(name);
-		if (type) if (required) acc.push(`${parameterName}: ${type}${rest.default ? ` = ${rest.default}` : ""}`);
-		else acc.push(`${parameterName}?: ${type}`);
-		else acc.push(`${parameterName}`);
-		return acc;
-	}
-	static toObject(items) {
-		let type = [];
-		let name = [];
-		const enabled = items.every((item) => item.enabled) ? items.at(0)?.enabled : true;
-		const required = items.every((item) => item.required) ?? true;
-		items.forEach((item) => {
-			name = FunctionParams.#addParams(name, {
-				...item,
-				type: void 0
-			});
-			if (items.some((item$1) => item$1.type)) type = FunctionParams.#addParams(type, item);
-		});
-		return {
-			name: `{ ${name.join(", ")} }`,
-			type: type.length ? `{ ${type.join("; ")} }` : void 0,
-			enabled,
-			required
-		};
-	}
-	toObject() {
-		const items = FunctionParams.#orderItems(this.#items).flat();
-		return FunctionParams.toObject(items);
-	}
-	static toString(items) {
-		return FunctionParams.#orderItems(items).reduce((acc, item) => {
-			if (Array.isArray(item)) {
-				if (item.length <= 0) return acc;
-				const subItems = FunctionParams.#orderItems(item);
-				const objectItem = FunctionParams.toObject(subItems);
-				return FunctionParams.#addParams(acc, objectItem);
-			}
-			return FunctionParams.#addParams(acc, item);
-		}, []).join(", ");
-	}
-	toString() {
-		const items = FunctionParams.#orderItems(this.#items);
-		return FunctionParams.toString(items);
-	}
-};
-
-//#endregion
-//#region src/utils/getNestedAccessor.ts
-/**
-* Converts a param path (string with dot notation or array of strings) to a JavaScript accessor expression.
-* @param param - The param path, e.g., 'pagination.next.id' or ['pagination', 'next', 'id']
-* @param accessor - The base accessor, e.g., 'lastPage' or 'firstPage'
-* @returns A JavaScript accessor expression, e.g., "lastPage?.['pagination']?.['next']?.['id']", or undefined if param is empty
-*
-* @example
-* ```ts
-* getNestedAccessor('pagination.next.id', 'lastPage')
-* // returns: "lastPage?.['pagination']?.['next']?.['id']"
-*
-* getNestedAccessor(['pagination', 'next', 'id'], 'lastPage')
-* // returns: "lastPage?.['pagination']?.['next']?.['id']"
-*
-* getNestedAccessor('', 'lastPage')
-* // returns: undefined
-* ```
-*/
-function getNestedAccessor(param, accessor) {
-	const parts = Array.isArray(param) ? param : param.split(".");
-	if (parts.length === 0 || parts.length === 1 && parts[0] === "") return;
-	return parts.reduce((acc, part) => `${acc}?.['${part}']`, accessor);
-}
-
-//#endregion
-//#region src/utils/promise.ts
-function isPromise(result) {
-	return !!result && typeof result?.then === "function";
-}
-function isPromiseFulfilledResult(result) {
-	return result.status === "fulfilled";
-}
-function isPromiseRejectedResult(result) {
-	return result.status === "rejected";
-}
-
-//#endregion
-//#region src/utils/renderTemplate.ts
-function renderTemplate(template, data = void 0) {
-	if (!data || !Object.keys(data).length) return template.replace(/{{(.*?)}}/g, "");
-	return template.match(/{{(.*?)}}/g)?.reduce((prev, curr) => {
-		const index = curr.split(/{{|}}/).filter(Boolean)[0]?.trim();
-		if (index === void 0) return prev;
-		const value = data[index];
-		if (value === void 0) return prev;
-		return prev.replace(curr, () => {
-			if (typeof value === "boolean") return `${value.toString()}` || "false";
-			return value || "";
-		}).trim();
-	}, template) || "";
-}
-
-//#endregion
-//#region src/utils/resolveModuleSource.ts
-function resolveModuleSource(pkgName) {
-	const parentURL = import.meta.url;
-	const resolved = createJiti(parentURL).esmResolve(pkgName, parentURL);
-	const filePath = resolved.startsWith("file:") ? fileURLToPath(resolved) : resolved;
-	return {
-		path: filePath,
-		source: readFileSync(filePath, { encoding: "utf-8" }),
-		ext: path.extname(filePath)
-	};
-}
-
-//#endregion
-//#region src/utils/serializePluginOptions.ts
-/**
-* Serialize plugin options for safe JSON transport.
-* Strips functions, symbols, and undefined values recursively.
-*/
-function serializePluginOptions(options) {
-	if (options === null || options === void 0) return {};
-	if (typeof options !== "object") return options;
-	if (Array.isArray(options)) return options.map(serializePluginOptions);
-	const serialized = {};
-	for (const [key, value] of Object.entries(options)) {
-		if (typeof value === "function" || typeof value === "symbol" || value === void 0) continue;
-		if (typeof value === "object" && value !== null) serialized[key] = serializePluginOptions(value);
-		else serialized[key] = value;
-	}
-	return serialized;
-}
-
-//#endregion
-//#region src/utils/timeout.ts
-async function timeout(ms) {
-	return new Promise((resolve$1) => {
-		const timeout$1 = setTimeout(() => {
-			resolve$1(timeout$1);
-		}, ms);
-	}).then((timeout$1) => {
-		clearTimeout(timeout$1);
-		return true;
-	});
-}
-
-//#endregion
-export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };
-//# sourceMappingURL=utils.js.map
+export { AsyncEventEmitter, Cache, FunctionParams, URLPath, buildJSDoc, executeIfOnline, formatHrtime, formatMs, getBarrelFiles, getElapsedMs, getNestedAccessor, getUniqueName, isOnline, isPromise, isPromiseFulfilledResult, isPromiseRejectedResult, renderTemplate, resolveModuleSource, serializePluginOptions, setUniqueName, timeout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/core",
-  "version": "4.22.0",
+  "version": "4.22.2",
   "description": "Core functionality for Kubb's plugin-based code generation system, providing the foundation for transforming OpenAPI specifications.",
   "keywords": [
     "typescript",
@@ -70,6 +70,7 @@
   },
   "files": [
     "src",
+    "schemas",
     "dist",
     "*.d.ts",
     "*.d.cts",