@kubb/plugin-faker 5.0.0-alpha.9 → 5.0.0-beta.10

package/LICENSE

@@ -1,14 +1,21 @@
-Copyright (c) 2026 Stijn Van Hulle
+MIT License
 
-This repository contains software under two licenses:
+Copyright (c) 2026 Kubb Labs
 
-1. Most of the code in this repository is licensed under the
-   MIT License — see licenses/LICENSE-MIT for the full license text.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-2. The following components are licensed under the
-   GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later)
-   — see licenses/LICENSE-AGPL-3.0 for the full license text:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-   - packages/agent (published as @kubb/agent)
-
-Each package's own LICENSE file or package.json specifies its applicable license.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,19 +1,19 @@
 <div align="center">
-  <h1>Plugin Faker</h1>
+  <h1>@kubb/plugin-faker</h1>
   <a href="https://kubb.dev" target="_blank" rel="noopener noreferrer">
     <img width="180" src="https://raw.githubusercontent.com/kubb-labs/kubb/main/assets/logo.png" alt="Kubb logo">
   </a>
 
-
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![Coverage][coverage-src]][coverage-href]
 [![License][license-src]][license-href]
 [![Sponsors][sponsors-src]][sponsors-href]
+
 <h4>
-<a href="https://codesandbox.io/s/github/kubb-labs/kubb/tree/main//examples/typescript" target="_blank">View Demo</a>
+<a href="https://codesandbox.io/s/github/kubb-labs/plugins/tree/main/examples/faker" target="_blank">View Demo</a>
 <span> · </span>
-<a href="https://kubb.dev/" target="_blank">Documentation</a>
+<a href="https://kubb.dev/plugins/faker" target="_blank">Documentation</a>
 <span> · </span>
 <a href="https://github.com/kubb-labs/kubb/issues/" target="_blank">Report Bug</a>
 <span> · </span>
@@ -21,13 +21,32 @@
 </h4>
 </div>
 
+`@kubb/plugin-faker` generates Faker.js factory functions from your OpenAPI schemas. Each schema produces a function that returns realistic mock data matching the schema's structure.
+
+## Features
+
+- Creates one factory function per schema with optional field overrides
+- Uses Faker.js to produce realistic values for common field types
+- Handles recursive schemas with lazy getters to avoid circular reference errors
+- Works with `@kubb/plugin-msw` to serve mock responses in the browser or Node.js
 
-Swagger integration to create mock data based on Faker.js
+## Installation
 
+```bash
+bun add @kubb/plugin-faker
+# or
+pnpm add @kubb/plugin-faker
+# or
+npm install @kubb/plugin-faker
+```
+
+## Documentation
+
+See the [full documentation](https://kubb.dev/plugins/faker) for configuration options and examples.
 
 ## Supporting Kubb
 
-Kubb uses an MIT-licensed open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
+Kubb is an MIT-licensed open source project with its ongoing development made possible entirely by the support of Sponsors. If you would like to become a sponsor, please consider:
 
 - [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
 
@@ -37,7 +56,6 @@ Kubb uses an MIT-licensed open source project with its ongoing development made
   </a>
 </p>
 
-
 <!-- Badges -->
 
 [npm-version-src]: https://img.shields.io/npm/v/@kubb/plugin-faker?flat&colorA=18181B&colorB=f58517

package/dist/Faker-BMgoFj8b.d.ts

@@ -0,0 +1,27 @@
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { o as PluginFaker, t as PrinterFakerFactory } from "./printerFaker-W0pLunAj.js";
+import { ast } from "@kubb/core";
+import { KubbReactNode } from "@kubb/renderer-jsx/types";
+
+//#region src/components/Faker.d.ts
+type Props = {
+  name: string;
+  typeName: string;
+  node: ast.SchemaNode;
+  printer: ast.Printer<PrinterFakerFactory>;
+  seed?: PluginFaker['options']['seed'];
+  description?: string;
+  canOverride: boolean;
+};
+declare function Faker({
+  node,
+  description,
+  name,
+  typeName,
+  printer,
+  seed,
+  canOverride
+}: Props): KubbReactNode;
+//#endregion
+export { Faker as t };
+//# sourceMappingURL=Faker-BMgoFj8b.d.ts.map

package/dist/Faker-CWtonujy.js

@@ -0,0 +1,334 @@
+import "./chunk--u3MIqq1.js";
+import { posix } from "node:path";
+import { ast } from "@kubb/core";
+import { functionPrinter } from "@kubb/plugin-ts";
+import { File, Function } from "@kubb/renderer-jsx";
+import { Fragment, jsx, jsxs } from "@kubb/renderer-jsx/jsx-runtime";
+//#region ../../internals/utils/src/string.ts
+/**
+* Strips a single matching pair of `"..."`, `'...'`, or `` `...` `` from both ends of `text`.
+* Returns the string unchanged when no balanced quote pair is found.
+*
+* @example
+* trimQuotes('"hello"') // 'hello'
+* trimQuotes('hello')   // 'hello'
+*/
+function trimQuotes(text) {
+	if (text.length >= 2) {
+		const first = text[0];
+		const last = text[text.length - 1];
+		if (first === "\"" && last === "\"" || first === "'" && last === "'" || first === "`" && last === "`") return text.slice(1, -1);
+	}
+	return text;
+}
+/**
+* Escapes characters that are not allowed inside JS string literals.
+* Handles quotes, backslashes, and Unicode line terminators (U+2028 / U+2029).
+*
+* @see http://www.ecma-international.org/ecma-262/5.1/#sec-7.8.4
+*
+* @example
+* ```ts
+* jsStringEscape('say "hi"\nbye') // 'say \\"hi\\"\\nbye'
+* ```
+*/
+function jsStringEscape(input) {
+	return `${input}`.replace(/["'\\\n\r\u2028\u2029]/g, (character) => {
+		switch (character) {
+			case "\"":
+			case "'":
+			case "\\": return `\\${character}`;
+			case "\n": return "\\n";
+			case "\r": return "\\r";
+			case "\u2028": return "\\u2028";
+			case "\u2029": return "\\u2029";
+			default: return "";
+		}
+	});
+}
+//#endregion
+//#region src/utils.ts
+/**
+* Returns the `@faker-js/faker` named export for a locale code.
+*
+* Without a locale, returns `'faker'` for the default English instance.
+* With a locale, the language code is converted to upper case and joined with any region suffix.
+*
+* @example Default
+* `localeToFakerImport() // 'faker'`
+*
+* @example Simple locale
+* `localeToFakerImport('de') // 'fakerDE'`
+*
+* @example Compound locale
+* `localeToFakerImport('de_AT') // 'fakerDE_AT'`
+*/
+function localeToFakerImport(locale) {
+	if (!locale) return "faker";
+	const parts = locale.split("_");
+	parts[0] = parts[0].toUpperCase();
+	return `faker${parts.join("_")}`;
+}
+/**
+* Determines if a schema node can be overridden during faker generation.
+*/
+function canOverrideSchema(node) {
+	return new Set([
+		"array",
+		"tuple",
+		"object",
+		"intersection",
+		"union",
+		"enum",
+		"ref",
+		"string",
+		"email",
+		"url",
+		"uuid",
+		"number",
+		"integer",
+		"bigint",
+		"boolean",
+		"date",
+		"time",
+		"datetime",
+		"blob"
+	]).has(node.type);
+}
+/**
+* Resolves a schema reference by looking up the referenced schema in the provided array.
+* Returns the original node if it's not a reference.
+*/
+function resolveSchemaRef(node, schemas) {
+	if (node.type !== "ref") return node;
+	return schemas.find((schema) => schema.name === node.name && schema.type !== "ref") ?? node;
+}
+/**
+* Resolves a parameter name based on its location (path, query, header, etc.) using the provided resolver.
+*/
+function resolveParamNameByLocation(resolver, node, param) {
+	switch (param.in) {
+		case "path": return resolver.resolvePathParamsName(node, param);
+		case "query": return resolver.resolveQueryParamsName(node, param);
+		case "header": return resolver.resolveHeaderParamsName(node, param);
+		default: return resolver.resolveParamName(node, param);
+	}
+}
+function shouldInlineSingleResponseSchema(schema) {
+	return new Set([
+		"any",
+		"unknown",
+		"void",
+		"null",
+		"array",
+		"tuple",
+		"string",
+		"email",
+		"url",
+		"uuid",
+		"number",
+		"integer",
+		"bigint",
+		"boolean",
+		"date",
+		"time",
+		"datetime",
+		"blob",
+		"enum",
+		"union"
+	]).has(schema.type);
+}
+/**
+* Builds a response schema as a union of all response statuses.
+* Returns null if no responses are provided, or embeds single simple responses inline.
+*/
+function buildResponseUnionSchema(node, resolver) {
+	const responses = node.responses.filter((response) => response.schema);
+	if (!responses.length) return null;
+	if (responses.length === 1) {
+		if (shouldInlineSingleResponseSchema(responses[0].schema)) return responses[0].schema;
+		return ast.createSchema({
+			type: "ref",
+			name: resolver.resolveResponseStatusName(node, responses[0].statusCode)
+		});
+	}
+	return ast.createSchema({
+		type: "union",
+		members: responses.map((response) => ast.createSchema({
+			type: "ref",
+			name: resolver.resolveResponseStatusName(node, response.statusCode)
+		}))
+	});
+}
+const SCALAR_TYPES$1 = new Set([
+	"string",
+	"email",
+	"url",
+	"uuid",
+	"number",
+	"integer",
+	"bigint",
+	"boolean",
+	"date",
+	"time",
+	"datetime",
+	"blob",
+	"enum"
+]);
+const ARRAY_TYPES$1 = new Set(["array"]);
+function toRelativeImportPath(from, to) {
+	const relativePath = posix.relative(posix.dirname(from), to);
+	return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
+}
+/**
+* Resolves a type reference, determining if it needs an import statement or inline type reference.
+* Takes into account whether the type can be overridden and the file paths.
+*/
+function resolveTypeReference({ node, canOverride, name, typeName, filePath, typeFilePath }) {
+	const { usesTypeName } = resolveFakerTypeUsage(node, typeName, canOverride);
+	if (!usesTypeName) return { typeName };
+	if (name === typeName) return { typeName: `import('${toRelativeImportPath(filePath, typeFilePath)}').${typeName}` };
+	return {
+		importPath: typeFilePath,
+		typeName
+	};
+}
+/**
+* Maps a schema node type to its corresponding scalar type representation.
+* Returns the type name for enums or the base type (string, number, etc.) for primitives.
+*/
+function getScalarType(node, typeName) {
+	switch (node.type) {
+		case "string":
+		case "email":
+		case "url":
+		case "uuid": return "string";
+		case "number":
+		case "integer": return "number";
+		case "bigint": return "bigint";
+		case "boolean": return "boolean";
+		case "date":
+		case "time": return node.representation === "date" ? "Date" : "string";
+		case "datetime": return "string";
+		case "blob": return "Blob";
+		case "enum": return typeName;
+		default: return typeName;
+	}
+}
+/**
+* Resolves faker type usage information for a schema.
+* Determines the data type, return type, and whether it uses the type name.
+*/
+function resolveFakerTypeUsage(node, typeName, canOverride) {
+	const isArray = ARRAY_TYPES$1.has(node.type);
+	const isTuple = node.type === "tuple";
+	const isScalar = SCALAR_TYPES$1.has(node.type);
+	let dataType = `Partial<${typeName}>`;
+	if (isArray || isTuple || node.type === "union" || node.type === "enum") dataType = typeName;
+	if (isScalar) dataType = getScalarType(node, typeName);
+	let returnType = canOverride ? typeName : void 0;
+	if (isScalar) returnType = getScalarType(node, typeName);
+	return {
+		dataType,
+		returnType,
+		usesTypeName: dataType.includes(typeName) || Boolean(returnType?.includes(typeName))
+	};
+}
+//#endregion
+//#region src/components/Faker.tsx
+const OBJECT_TYPES = new Set(["object", "intersection"]);
+const ARRAY_TYPES = new Set(["array"]);
+const SCALAR_TYPES = new Set([
+	"string",
+	"email",
+	"url",
+	"uuid",
+	"number",
+	"integer",
+	"bigint",
+	"boolean",
+	"date",
+	"time",
+	"datetime",
+	"blob",
+	"enum"
+]);
+const declarationPrinter = functionPrinter({ mode: "declaration" });
+function Faker({ node, description, name, typeName, printer, seed, canOverride }) {
+	const fakerText = printer.print(node) ?? "undefined";
+	const isArray = ARRAY_TYPES.has(node.type);
+	const isObject = OBJECT_TYPES.has(node.type);
+	const isTuple = node.type === "tuple";
+	const isScalar = SCALAR_TYPES.has(node.type);
+	let fakerTextWithOverride = fakerText;
+	let useGenericOverride = false;
+	if (canOverride && isObject) useGenericOverride = true;
+	if (canOverride && isTuple) fakerTextWithOverride = `data || ${fakerText}`;
+	if (canOverride && isArray) fakerTextWithOverride = `[
+  ...${fakerText},
+  ...(data || [])
+]`;
+	if (canOverride && isScalar) fakerTextWithOverride = `data ?? ${fakerText}`;
+	const { dataType, returnType: resolvedReturnType } = resolveFakerTypeUsage(node, typeName, canOverride);
+	let functionSignature = "";
+	let functionBody = "";
+	if (useGenericOverride) {
+		functionSignature = `${description ? `/**\n   * @description ${jsStringEscape(description)}\n   */\n  ` : ""}export function ${name}(data?: Partial<${typeName}>): Required<${typeName}>`;
+		const seedCode = seed ? `faker.seed(${JSON.stringify(seed)})\n  ` : "";
+		const { cyclicSchemas, schemaName } = printer.options;
+		if (node.type === "object" && !!cyclicSchemas && (node.properties ?? []).some((p) => ast.containsCircularRef(p.schema, {
+			circularSchemas: cyclicSchemas,
+			excludeName: schemaName
+		}))) functionBody = `{
+  ${seedCode}const defaultFakeData = ${fakerText}
+  if (data) {
+    for (const [key, value] of Object.entries(data)) {
+      Object.defineProperty(defaultFakeData, key, { value, configurable: true, writable: true, enumerable: true })
+    }
+  }
+  return defaultFakeData as Required<${typeName}>
+}`;
+		else functionBody = `{
+  ${seedCode}const defaultFakeData = ${fakerText}
+  return {
+    ...defaultFakeData,
+    ...(data || {}),
+  } as Required<${typeName}>
+}`;
+	} else {
+		const dataParamName = /\bdata\b/.test(fakerTextWithOverride) ? "data" : "_data";
+		const params = ast.createFunctionParameters({ params: [ast.createFunctionParameter({
+			name: dataParamName,
+			type: ast.createParamsType({
+				variant: "reference",
+				name: dataType
+			}),
+			optional: true
+		})] });
+		const paramsSignature = declarationPrinter.print(params) ?? "";
+		const returnType = resolvedReturnType;
+		return /* @__PURE__ */ jsx(File.Source, {
+			name,
+			isExportable: true,
+			isIndexable: true,
+			children: /* @__PURE__ */ jsxs(Function, {
+				export: true,
+				name,
+				JSDoc: { comments: description ? [`@description ${jsStringEscape(description)}`] : [] },
+				params: canOverride ? paramsSignature : void 0,
+				returnType,
+				children: [seed ? /* @__PURE__ */ jsxs(Fragment, { children: [`faker.seed(${JSON.stringify(seed)})`, /* @__PURE__ */ jsx("br", {})] }) : void 0, `return ${fakerTextWithOverride}`]
+			})
+		});
+	}
+	return /* @__PURE__ */ jsxs(File.Source, {
+		name,
+		isExportable: true,
+		isIndexable: true,
+		children: [functionSignature, functionBody]
+	});
+}
+//#endregion
+export { resolveParamNameByLocation as a, trimQuotes as c, localeToFakerImport as i, buildResponseUnionSchema as n, resolveSchemaRef as o, canOverrideSchema as r, resolveTypeReference as s, Faker as t };
+
+//# sourceMappingURL=Faker-CWtonujy.js.map

package/dist/Faker-CWtonujy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Faker-CWtonujy.js","names":["SCALAR_TYPES","ARRAY_TYPES"],"sources":["../../../internals/utils/src/string.ts","../src/utils.ts","../src/components/Faker.tsx"],"sourcesContent":["/**\n * Strips a single matching pair of `\"...\"`, `'...'`, or `` `...` `` from both ends of `text`.\n * Returns the string unchanged when no balanced quote pair is found.\n *\n * @example\n * trimQuotes('\"hello\"') // 'hello'\n * trimQuotes('hello')   // 'hello'\n */\nexport function trimQuotes(text: string): string {\n  if (text.length >= 2) {\n    const first = text[0]\n    const last = text[text.length - 1]\n    if ((first === '\"' && last === '\"') || (first === \"'\" && last === \"'\") || (first === '`' && last === '`')) {\n      return text.slice(1, -1)\n    }\n  }\n  return text\n}\n\n/**\n * Escapes characters that are not allowed inside JS string literals.\n * Handles quotes, backslashes, and Unicode line terminators (U+2028 / U+2029).\n *\n * @see http://www.ecma-international.org/ecma-262/5.1/#sec-7.8.4\n *\n * @example\n * ```ts\n * jsStringEscape('say \"hi\"\\nbye') // 'say \\\\\"hi\\\\\"\\\\nbye'\n * ```\n */\nexport function jsStringEscape(input: unknown): string {\n  return `${input}`.replace(/[\"'\\\\\\n\\r\\u2028\\u2029]/g, (character) => {\n    switch (character) {\n      case '\"':\n      case \"'\":\n      case '\\\\':\n        return `\\\\${character}`\n      case '\\n':\n        return '\\\\n'\n      case '\\r':\n        return '\\\\r'\n      case '\\u2028':\n        return '\\\\u2028'\n      case '\\u2029':\n        return '\\\\u2029'\n      default:\n        return ''\n    }\n  })\n}\n\n/**\n * Strips the file extension from a path or file name.\n * Only removes the last `.ext` segment when the dot is not part of a directory name.\n *\n * @example\n * trimExtName('petStore.ts')             // 'petStore'\n * trimExtName('/src/models/pet.ts')      // '/src/models/pet'\n * trimExtName('/project.v2/gen/pet.ts')  // '/project.v2/gen/pet'\n * trimExtName('noExtension')             // 'noExtension'\n */\nexport function trimExtName(text: string): string {\n  const dotIndex = text.lastIndexOf('.')\n  if (dotIndex > 0 && !text.includes('/', dotIndex)) {\n    return text.slice(0, dotIndex)\n  }\n  return text\n}\n","import { posix } from 'node:path'\nimport { ast } from '@kubb/core'\nimport type { ResolverFaker } from './types.ts'\n\n/**\n * Returns the `@faker-js/faker` named export for a locale code.\n *\n * Without a locale, returns `'faker'` for the default English instance.\n * With a locale, the language code is converted to upper case and joined with any region suffix.\n *\n * @example Default\n * `localeToFakerImport() // 'faker'`\n *\n * @example Simple locale\n * `localeToFakerImport('de') // 'fakerDE'`\n *\n * @example Compound locale\n * `localeToFakerImport('de_AT') // 'fakerDE_AT'`\n */\nexport function localeToFakerImport(locale?: string): string {\n  if (!locale) {\n    return 'faker'\n  }\n\n  const parts = locale.split('_')\n  parts[0] = parts[0]!.toUpperCase()\n  return `faker${parts.join('_')}`\n}\n\n/**\n * Determines if a schema node can be overridden during faker generation.\n */\nexport function canOverrideSchema(node: ast.SchemaNode): boolean {\n  return new Set<ast.SchemaNode['type']>([\n    'array',\n    'tuple',\n    'object',\n    'intersection',\n    'union',\n    'enum',\n    'ref',\n    'string',\n    'email',\n    'url',\n    'uuid',\n    'number',\n    'integer',\n    'bigint',\n    'boolean',\n    'date',\n    'time',\n    'datetime',\n    'blob',\n  ]).has(node.type)\n}\n\n/**\n * Resolves a schema reference by looking up the referenced schema in the provided array.\n * Returns the original node if it's not a reference.\n */\nexport function resolveSchemaRef(node: ast.SchemaNode, schemas: Array<ast.SchemaNode>): ast.SchemaNode {\n  if (node.type !== 'ref') {\n    return node\n  }\n\n  return schemas.find((schema) => schema.name === node.name && schema.type !== 'ref') ?? node\n}\n\n/**\n * Resolves a parameter name based on its location (path, query, header, etc.) using the provided resolver.\n */\nexport function resolveParamNameByLocation(\n  resolver: Pick<ResolverFaker, 'resolvePathParamsName' | 'resolveQueryParamsName' | 'resolveHeaderParamsName' | 'resolveParamName'>,\n  node: ast.OperationNode,\n  param: ast.ParameterNode,\n): string {\n  switch (param.in) {\n    case 'path':\n      return resolver.resolvePathParamsName(node, param)\n    case 'query':\n      return resolver.resolveQueryParamsName(node, param)\n    case 'header':\n      return resolver.resolveHeaderParamsName(node, param)\n    default:\n      return resolver.resolveParamName(node, param)\n  }\n}\n\nfunction shouldInlineSingleResponseSchema(schema: ast.SchemaNode): boolean {\n  return new Set<ast.SchemaNode['type']>([\n    'any',\n    'unknown',\n    'void',\n    'null',\n    'array',\n    'tuple',\n    'string',\n    'email',\n    'url',\n    'uuid',\n    'number',\n    'integer',\n    'bigint',\n    'boolean',\n    'date',\n    'time',\n    'datetime',\n    'blob',\n    'enum',\n    'union',\n  ]).has(schema.type)\n}\n\n/**\n * Builds a response schema as a union of all response statuses.\n * Returns null if no responses are provided, or embeds single simple responses inline.\n */\nexport function buildResponseUnionSchema(node: ast.OperationNode, resolver: ResolverFaker): ast.SchemaNode | null {\n  const responses = node.responses.filter((response) => response.schema)\n\n  if (!responses.length) {\n    return null\n  }\n\n  if (responses.length === 1) {\n    if (shouldInlineSingleResponseSchema(responses[0]!.schema)) {\n      return responses[0]!.schema\n    }\n\n    return ast.createSchema({ type: 'ref', name: resolver.resolveResponseStatusName(node, responses[0]!.statusCode) })\n  }\n\n  return ast.createSchema({\n    type: 'union',\n    members: responses.map((response) => ast.createSchema({ type: 'ref', name: resolver.resolveResponseStatusName(node, response.statusCode) })),\n  })\n}\n\nconst SCALAR_TYPES = new Set<ast.SchemaNode['type']>([\n  'string',\n  'email',\n  'url',\n  'uuid',\n  'number',\n  'integer',\n  'bigint',\n  'boolean',\n  'date',\n  'time',\n  'datetime',\n  'blob',\n  'enum',\n])\nconst ARRAY_TYPES = new Set<ast.SchemaNode['type']>(['array'])\n\nfunction toRelativeImportPath(from: string, to: string): string {\n  const relativePath = posix.relative(posix.dirname(from), to)\n  return relativePath.startsWith('../') ? relativePath : `./${relativePath}`\n}\n\n/**\n * Resolves a type reference, determining if it needs an import statement or inline type reference.\n * Takes into account whether the type can be overridden and the file paths.\n */\nexport function resolveTypeReference({\n  node,\n  canOverride,\n  name,\n  typeName,\n  filePath,\n  typeFilePath,\n}: {\n  node: ast.SchemaNode\n  canOverride: boolean\n  name: string\n  typeName: string\n  filePath: string\n  typeFilePath: string\n}): { importPath?: string; typeName: string } {\n  const { usesTypeName } = resolveFakerTypeUsage(node, typeName, canOverride)\n\n  if (!usesTypeName) {\n    return { typeName }\n  }\n\n  if (name === typeName) {\n    return {\n      typeName: `import('${toRelativeImportPath(filePath, typeFilePath)}').${typeName}`,\n    }\n  }\n\n  return {\n    importPath: typeFilePath,\n    typeName,\n  }\n}\n\n/**\n * Maps a schema node type to its corresponding scalar type representation.\n * Returns the type name for enums or the base type (string, number, etc.) for primitives.\n */\nexport function getScalarType(node: ast.SchemaNode, typeName: string): string {\n  switch (node.type) {\n    case 'string':\n    case 'email':\n    case 'url':\n    case 'uuid':\n      return 'string'\n    case 'number':\n    case 'integer':\n      return 'number'\n    case 'bigint':\n      return 'bigint'\n    case 'boolean':\n      return 'boolean'\n    case 'date':\n    case 'time':\n      return node.representation === 'date' ? 'Date' : 'string'\n    case 'datetime':\n      return 'string'\n    case 'blob':\n      return 'Blob'\n    case 'enum':\n      return typeName\n    default:\n      return typeName\n  }\n}\n\n/**\n * Resolves faker type usage information for a schema.\n * Determines the data type, return type, and whether it uses the type name.\n */\nexport function resolveFakerTypeUsage(\n  node: ast.SchemaNode,\n  typeName: string,\n  canOverride: boolean,\n): {\n  dataType: string\n  returnType: string | undefined\n  usesTypeName: boolean\n} {\n  const isArray = ARRAY_TYPES.has(node.type)\n  const isTuple = node.type === 'tuple'\n  const isScalar = SCALAR_TYPES.has(node.type)\n\n  let dataType = `Partial<${typeName}>`\n\n  if (isArray || isTuple || node.type === 'union' || node.type === 'enum') {\n    dataType = typeName\n  }\n\n  if (isScalar) {\n    dataType = getScalarType(node, typeName)\n  }\n\n  let returnType = canOverride ? typeName : undefined\n\n  if (isScalar) {\n    returnType = getScalarType(node, typeName)\n  }\n\n  return {\n    dataType,\n    returnType,\n    usesTypeName: dataType.includes(typeName) || Boolean(returnType?.includes(typeName)),\n  }\n}\n","import { jsStringEscape } from '@internals/utils'\nimport { ast } from '@kubb/core'\nimport { functionPrinter } from '@kubb/plugin-ts'\nimport { File, Function } from '@kubb/renderer-jsx'\nimport type { KubbReactNode } from '@kubb/renderer-jsx/types'\nimport type { PrinterFakerFactory } from '../printers/printerFaker.ts'\nimport type { PluginFaker } from '../types.ts'\nimport { resolveFakerTypeUsage } from '../utils.ts'\n\ntype Props = {\n  name: string\n  typeName: string\n  node: ast.SchemaNode\n  printer: ast.Printer<PrinterFakerFactory>\n  seed?: PluginFaker['options']['seed']\n  description?: string\n  canOverride: boolean\n}\n\nconst OBJECT_TYPES = new Set<ast.SchemaNode['type']>(['object', 'intersection'])\nconst ARRAY_TYPES = new Set<ast.SchemaNode['type']>(['array'])\nconst SCALAR_TYPES = new Set<ast.SchemaNode['type']>([\n  'string',\n  'email',\n  'url',\n  'uuid',\n  'number',\n  'integer',\n  'bigint',\n  'boolean',\n  'date',\n  'time',\n  'datetime',\n  'blob',\n  'enum',\n])\nconst declarationPrinter = functionPrinter({ mode: 'declaration' })\n\nexport function Faker({ node, description, name, typeName, printer, seed, canOverride }: Props): KubbReactNode {\n  const fakerText = printer.print(node) ?? 'undefined'\n\n  const isArray = ARRAY_TYPES.has(node.type)\n  const isObject = OBJECT_TYPES.has(node.type)\n  const isTuple = node.type === 'tuple'\n  const isScalar = SCALAR_TYPES.has(node.type)\n\n  let fakerTextWithOverride = fakerText\n  let useGenericOverride = false\n\n  if (canOverride && isObject) {\n    useGenericOverride = true\n  }\n\n  if (canOverride && isTuple) {\n    fakerTextWithOverride = `data || ${fakerText}`\n  }\n\n  if (canOverride && isArray) {\n    fakerTextWithOverride = `[\n  ...${fakerText},\n  ...(data || [])\n]`\n  }\n\n  if (canOverride && isScalar) {\n    fakerTextWithOverride = `data ?? ${fakerText}`\n  }\n\n  const { dataType, returnType: resolvedReturnType } = resolveFakerTypeUsage(node, typeName, canOverride)\n\n  let functionSignature = ''\n  let functionBody = ''\n\n  if (useGenericOverride) {\n    // Generate function with defaultFakeData structure\n    const jsdoc = description ? `/**\\n   * @description ${jsStringEscape(description)}\\n   */\\n  ` : ''\n    functionSignature = `${jsdoc}export function ${name}(data?: Partial<${typeName}>): Required<${typeName}>`\n\n    const seedCode = seed ? `faker.seed(${JSON.stringify(seed)})\\n  ` : ''\n\n    // When the object node has properties that transitively reference a cyclic schema,\n    // the printer emits memoizing getters for those properties. Spreading the object\n    // literal would immediately invoke those getters, triggering recursive faker calls\n    // and causing a stack overflow. Detect this upfront via ast helpers so we can\n    // use Object.defineProperty-based merging instead of spread.\n    const { cyclicSchemas, schemaName } = printer.options\n    const hasGetters =\n      node.type === 'object' &&\n      !!cyclicSchemas &&\n      (node.properties ?? []).some((p) => ast.containsCircularRef(p.schema, { circularSchemas: cyclicSchemas, excludeName: schemaName }))\n\n    if (hasGetters) {\n      functionBody = `{\n  ${seedCode}const defaultFakeData = ${fakerText}\n  if (data) {\n    for (const [key, value] of Object.entries(data)) {\n      Object.defineProperty(defaultFakeData, key, { value, configurable: true, writable: true, enumerable: true })\n    }\n  }\n  return defaultFakeData as Required<${typeName}>\n}`\n    } else {\n      functionBody = `{\n  ${seedCode}const defaultFakeData = ${fakerText}\n  return {\n    ...defaultFakeData,\n    ...(data || {}),\n  } as Required<${typeName}>\n}`\n    }\n  } else {\n    const usesData = /\\bdata\\b/.test(fakerTextWithOverride)\n    const dataParamName = usesData ? 'data' : '_data'\n    const params = ast.createFunctionParameters({\n      params: [\n        ast.createFunctionParameter({\n          name: dataParamName,\n          type: ast.createParamsType({ variant: 'reference', name: dataType }),\n          optional: true,\n        }),\n      ],\n    })\n    const paramsSignature = declarationPrinter.print(params) ?? ''\n    const returnType = resolvedReturnType\n\n    return (\n      <File.Source name={name} isExportable isIndexable>\n        <Function\n          export\n          name={name}\n          JSDoc={{ comments: description ? [`@description ${jsStringEscape(description)}`] : [] }}\n          params={canOverride ? paramsSignature : undefined}\n          returnType={returnType}\n        >\n          {seed ? (\n            <>\n              {`faker.seed(${JSON.stringify(seed)})`}\n              <br />\n            </>\n          ) : undefined}\n          {`return ${fakerTextWithOverride}`}\n        </Function>\n      </File.Source>\n    )\n  }\n\n  return (\n    <File.Source name={name} isExportable isIndexable>\n      {functionSignature}\n      {functionBody}\n    </File.Source>\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;AAQA,SAAgB,WAAW,MAAsB;CAC/C,IAAI,KAAK,UAAU,GAAG;EACpB,MAAM,QAAQ,KAAK;EACnB,MAAM,OAAO,KAAK,KAAK,SAAS;EAChC,IAAK,UAAU,QAAO,SAAS,QAAS,UAAU,OAAO,SAAS,OAAS,UAAU,OAAO,SAAS,KACnG,OAAO,KAAK,MAAM,GAAG,GAAG;;CAG5B,OAAO;;;;;;;;;;;;;AAcT,SAAgB,eAAe,OAAwB;CACrD,OAAO,GAAG,QAAQ,QAAQ,4BAA4B,cAAc;EAClE,QAAQ,WAAR;GACE,KAAK;GACL,KAAK;GACL,KAAK,MACH,OAAO,KAAK;GACd,KAAK,MACH,OAAO;GACT,KAAK,MACH,OAAO;GACT,KAAK,UACH,OAAO;GACT,KAAK,UACH,OAAO;GACT,SACE,OAAO;;GAEX;;;;;;;;;;;;;;;;;;;AC7BJ,SAAgB,oBAAoB,QAAyB;CAC3D,IAAI,CAAC,QACH,OAAO;CAGT,MAAM,QAAQ,OAAO,MAAM,IAAI;CAC/B,MAAM,KAAK,MAAM,GAAI,aAAa;CAClC,OAAO,QAAQ,MAAM,KAAK,IAAI;;;;;AAMhC,SAAgB,kBAAkB,MAA+B;CAC/D,OAAO,IAAI,IAA4B;EACrC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,CAAC,IAAI,KAAK,KAAK;;;;;;AAOnB,SAAgB,iBAAiB,MAAsB,SAAgD;CACrG,IAAI,KAAK,SAAS,OAChB,OAAO;CAGT,OAAO,QAAQ,MAAM,WAAW,OAAO,SAAS,KAAK,QAAQ,OAAO,SAAS,MAAM,IAAI;;;;;AAMzF,SAAgB,2BACd,UACA,MACA,OACQ;CACR,QAAQ,MAAM,IAAd;EACE,KAAK,QACH,OAAO,SAAS,sBAAsB,MAAM,MAAM;EACpD,KAAK,SACH,OAAO,SAAS,uBAAuB,MAAM,MAAM;EACrD,KAAK,UACH,OAAO,SAAS,wBAAwB,MAAM,MAAM;EACtD,SACE,OAAO,SAAS,iBAAiB,MAAM,MAAM;;;AAInD,SAAS,iCAAiC,QAAiC;CACzE,OAAO,IAAI,IAA4B;EACrC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC,CAAC,IAAI,OAAO,KAAK;;;;;;AAOrB,SAAgB,yBAAyB,MAAyB,UAAgD;CAChH,MAAM,YAAY,KAAK,UAAU,QAAQ,aAAa,SAAS,OAAO;CAEtE,IAAI,CAAC,UAAU,QACb,OAAO;CAGT,IAAI,UAAU,WAAW,GAAG;EAC1B,IAAI,iCAAiC,UAAU,GAAI,OAAO,EACxD,OAAO,UAAU,GAAI;EAGvB,OAAO,IAAI,aAAa;GAAE,MAAM;GAAO,MAAM,SAAS,0BAA0B,MAAM,UAAU,GAAI,WAAW;GAAE,CAAC;;CAGpH,OAAO,IAAI,aAAa;EACtB,MAAM;EACN,SAAS,UAAU,KAAK,aAAa,IAAI,aAAa;GAAE,MAAM;GAAO,MAAM,SAAS,0BAA0B,MAAM,SAAS,WAAW;GAAE,CAAC,CAAC;EAC7I,CAAC;;AAGJ,MAAMA,iBAAe,IAAI,IAA4B;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AACF,MAAMC,gBAAc,IAAI,IAA4B,CAAC,QAAQ,CAAC;AAE9D,SAAS,qBAAqB,MAAc,IAAoB;CAC9D,MAAM,eAAe,MAAM,SAAS,MAAM,QAAQ,KAAK,EAAE,GAAG;CAC5D,OAAO,aAAa,WAAW,MAAM,GAAG,eAAe,KAAK;;;;;;AAO9D,SAAgB,qBAAqB,EACnC,MACA,aACA,MACA,UACA,UACA,gBAQ4C;CAC5C,MAAM,EAAE,iBAAiB,sBAAsB,MAAM,UAAU,YAAY;CAE3E,IAAI,CAAC,cACH,OAAO,EAAE,UAAU;CAGrB,IAAI,SAAS,UACX,OAAO,EACL,UAAU,WAAW,qBAAqB,UAAU,aAAa,CAAC,KAAK,YACxE;CAGH,OAAO;EACL,YAAY;EACZ;EACD;;;;;;AAOH,SAAgB,cAAc,MAAsB,UAA0B;CAC5E,QAAQ,KAAK,MAAb;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,QACH,OAAO;EACT,KAAK;EACL,KAAK,WACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,KAAK;EACL,KAAK,QACH,OAAO,KAAK,mBAAmB,SAAS,SAAS;EACnD,KAAK,YACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,SACE,OAAO;;;;;;;AAQb,SAAgB,sBACd,MACA,UACA,aAKA;CACA,MAAM,UAAUA,cAAY,IAAI,KAAK,KAAK;CAC1C,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,WAAWD,eAAa,IAAI,KAAK,KAAK;CAE5C,IAAI,WAAW,WAAW,SAAS;CAEnC,IAAI,WAAW,WAAW,KAAK,SAAS,WAAW,KAAK,SAAS,QAC/D,WAAW;CAGb,IAAI,UACF,WAAW,cAAc,MAAM,SAAS;CAG1C,IAAI,aAAa,cAAc,WAAW,KAAA;CAE1C,IAAI,UACF,aAAa,cAAc,MAAM,SAAS;CAG5C,OAAO;EACL;EACA;EACA,cAAc,SAAS,SAAS,SAAS,IAAI,QAAQ,YAAY,SAAS,SAAS,CAAC;EACrF;;;;ACvPH,MAAM,eAAe,IAAI,IAA4B,CAAC,UAAU,eAAe,CAAC;AAChF,MAAM,cAAc,IAAI,IAA4B,CAAC,QAAQ,CAAC;AAC9D,MAAM,eAAe,IAAI,IAA4B;CACnD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;AACF,MAAM,qBAAqB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,SAAgB,MAAM,EAAE,MAAM,aAAa,MAAM,UAAU,SAAS,MAAM,eAAqC;CAC7G,MAAM,YAAY,QAAQ,MAAM,KAAK,IAAI;CAEzC,MAAM,UAAU,YAAY,IAAI,KAAK,KAAK;CAC1C,MAAM,WAAW,aAAa,IAAI,KAAK,KAAK;CAC5C,MAAM,UAAU,KAAK,SAAS;CAC9B,MAAM,WAAW,aAAa,IAAI,KAAK,KAAK;CAE5C,IAAI,wBAAwB;CAC5B,IAAI,qBAAqB;CAEzB,IAAI,eAAe,UACjB,qBAAqB;CAGvB,IAAI,eAAe,SACjB,wBAAwB,WAAW;CAGrC,IAAI,eAAe,SACjB,wBAAwB;OACrB,UAAU;;;CAKf,IAAI,eAAe,UACjB,wBAAwB,WAAW;CAGrC,MAAM,EAAE,UAAU,YAAY,uBAAuB,sBAAsB,MAAM,UAAU,YAAY;CAEvG,IAAI,oBAAoB;CACxB,IAAI,eAAe;CAEnB,IAAI,oBAAoB;EAGtB,oBAAoB,GADN,cAAc,0BAA0B,eAAe,YAAY,CAAC,eAAe,GACpE,kBAAkB,KAAK,kBAAkB,SAAS,eAAe,SAAS;EAEvG,MAAM,WAAW,OAAO,cAAc,KAAK,UAAU,KAAK,CAAC,SAAS;EAOpE,MAAM,EAAE,eAAe,eAAe,QAAQ;EAM9C,IAJE,KAAK,SAAS,YACd,CAAC,CAAC,kBACD,KAAK,cAAc,EAAE,EAAE,MAAM,MAAM,IAAI,oBAAoB,EAAE,QAAQ;GAAE,iBAAiB;GAAe,aAAa;GAAY,CAAC,CAAC,EAGnI,eAAe;IACjB,SAAS,0BAA0B,UAAU;;;;;;uCAMV,SAAS;;OAG1C,eAAe;IACjB,SAAS,0BAA0B,UAAU;;;;kBAI/B,SAAS;;QAGlB;EAEL,MAAM,gBADW,WAAW,KAAK,sBACH,GAAG,SAAS;EAC1C,MAAM,SAAS,IAAI,yBAAyB,EAC1C,QAAQ,CACN,IAAI,wBAAwB;GAC1B,MAAM;GACN,MAAM,IAAI,iBAAiB;IAAE,SAAS;IAAa,MAAM;IAAU,CAAC;GACpE,UAAU;GACX,CAAC,CACH,EACF,CAAC;EACF,MAAM,kBAAkB,mBAAmB,MAAM,OAAO,IAAI;EAC5D,MAAM,aAAa;EAEnB,OACE,oBAAC,KAAK,QAAN;GAAmB;GAAM,cAAA;GAAa,aAAA;aACpC,qBAAC,UAAD;IACE,QAAA;IACM;IACN,OAAO,EAAE,UAAU,cAAc,CAAC,gBAAgB,eAAe,YAAY,GAAG,GAAG,EAAE,EAAE;IACvF,QAAQ,cAAc,kBAAkB,KAAA;IAC5B;cALd,CAOG,OACC,qBAAA,UAAA,EAAA,UAAA,CACG,cAAc,KAAK,UAAU,KAAK,CAAC,IACpC,oBAAC,MAAD,EAAM,CAAA,CACL,EAAA,CAAA,GACD,KAAA,GACH,UAAU,wBACF;;GACC,CAAA;;CAIlB,OACE,qBAAC,KAAK,QAAN;EAAmB;EAAM,cAAA;EAAa,aAAA;YAAtC,CACG,mBACA,aACW"}