@kubb/plugin-faker 5.0.0-beta.4 → 5.0.0-beta.56

package/README.md

@@ -1,19 +1,16 @@
 <div align="center">
-  <h1>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">
+    <img src="https://kubb.dev/og.png" alt="Kubb banner">
   </a>
 
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
-[![Coverage][coverage-src]][coverage-href]
+[![Stars][stars-src]][stars-href]
 [![License][license-src]][license-href]
-[![Sponsors][sponsors-src]][sponsors-href]
+[![Node][node-src]][node-href]
 
 <h4>
-<a href="https://codesandbox.io/s/github/kubb-labs/kubb/tree/main//examples/typescript" 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,11 +18,31 @@
 </h4>
 </div>
 
-Swagger integration to create mock data based on Faker.js
+<br />
+
+# @kubb/plugin-faker
+
+### Generate Faker mock data from OpenAPI
+
+`@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.
+
+## 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 open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:
 
 - [Become a Sponsor on GitHub](https://github.com/sponsors/stijnvanhulle)
 
@@ -35,19 +52,19 @@ Kubb uses an MIT-licensed open source project with its ongoing development made
   </a>
 </p>
 
+## License
+
+[MIT](https://github.com/kubb-labs/plugins/blob/main/LICENSE)
+
 <!-- Badges -->
 
-[npm-version-src]: https://img.shields.io/npm/v/@kubb/plugin-faker?flat&colorA=18181B&colorB=f58517
-[npm-version-href]: https://npmjs.com/package/@kubb/plugin-faker
-[npm-downloads-src]: https://img.shields.io/npm/dm/@kubb/plugin-faker?flat&colorA=18181B&colorB=f58517
-[npm-downloads-href]: https://npmjs.com/package/@kubb/plugin-faker
-[license-src]: https://img.shields.io/github/license/kubb-labs/kubb.svg?flat&colorA=18181B&colorB=f58517
+[npm-version-src]: https://shieldcn.dev/npm/v/@kubb/plugin-faker.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-version-href]: https://npmx.dev/package/@kubb/plugin-faker
+[npm-downloads-src]: https://shieldcn.dev/npm/dm/@kubb/plugin-faker.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[npm-downloads-href]: https://npmx.dev/package/@kubb/plugin-faker
+[stars-src]: https://shieldcn.dev/github/stars/kubb-labs/kubb.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[stars-href]: https://github.com/kubb-labs/kubb
+[license-src]: https://shieldcn.dev/npm/license/@kubb/plugin-faker.svg?variant=secondary&size=xs&theme=zinc
 [license-href]: https://github.com/kubb-labs/kubb/blob/main/LICENSE
-[build-src]: https://img.shields.io/github/actions/workflow/status/kubb-labs/kubb/ci.yaml?style=flat&colorA=18181B&colorB=f58517
-[build-href]: https://www.npmjs.com/package/@kubb/plugin-faker
-[minified-src]: https://img.shields.io/bundlephobia/min/@kubb/plugin-faker?style=flat&colorA=18181B&colorB=f58517
-[minified-href]: https://www.npmjs.com/package/@kubb/plugin-faker
-[coverage-src]: https://img.shields.io/codecov/c/github/kubb-labs/kubb?style=flat&colorA=18181B&colorB=f58517
-[coverage-href]: https://www.npmjs.com/package/@kubb/plugin-faker
-[sponsors-src]: https://img.shields.io/github/sponsors/stijnvanhulle?style=flat&colorA=18181B&colorB=f58517
-[sponsors-href]: https://github.com/sponsors/stijnvanhulle/
+[node-src]: https://shieldcn.dev/npm/node/@kubb/plugin-faker.svg?variant=secondary&size=xs&theme=zinc&mode=dark
+[node-href]: https://npmx.dev/package/@kubb/plugin-faker

package/dist/{Faker-CdyPfOPg.d.ts → Faker-A5UuxwJj.d.ts}

@@ -1,5 +1,5 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { o as PluginFaker, t as PrinterFakerFactory } from "./printerFaker-CJiwzoto.js";
+import { t as __name } from "./chunk-C0LytTxp.js";
+import { o as PluginFaker, t as PrinterFakerFactory } from "./printerFaker-CMCJT3FB.js";
 import { ast } from "@kubb/core";
 import { KubbReactNode } from "@kubb/renderer-jsx/types";
 
@@ -24,4 +24,4 @@ declare function Faker({
 }: Props): KubbReactNode;
 //#endregion
 export { Faker as t };
-//# sourceMappingURL=Faker-CdyPfOPg.d.ts.map
+//# sourceMappingURL=Faker-A5UuxwJj.d.ts.map

package/dist/{Faker-fcQEB9i5.js → Faker-CHh0JtBG.js}

@@ -1,52 +1,10 @@
-import "./chunk--u3MIqq1.js";
-import { posix } from "node:path";
+import "./chunk-C0LytTxp.js";
+import { jsStringEscape } from "@kubb/ast/utils";
 import { ast } from "@kubb/core";
 import { functionPrinter } from "@kubb/plugin-ts";
 import { File, Function } from "@kubb/renderer-jsx";
+import { posix } from "node:path";
 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.
@@ -96,14 +54,6 @@ function canOverrideSchema(node) {
 	]).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) {
@@ -143,10 +93,11 @@ function shouldInlineSingleResponseSchema(schema) {
 * 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);
+	const responses = node.responses.filter((response) => response.content?.[0]?.schema);
 	if (!responses.length) return null;
 	if (responses.length === 1) {
-		if (shouldInlineSingleResponseSchema(responses[0].schema)) return responses[0].schema;
+		const schema = responses[0].content?.[0]?.schema;
+		if (schema && shouldInlineSingleResponseSchema(schema)) return schema;
 		return ast.createSchema({
 			type: "ref",
 			name: resolver.resolveResponseStatusName(node, responses[0].statusCode)
@@ -180,56 +131,6 @@ function toRelativeImportPath(from, to) {
 	const relativePath = posix.relative(posix.dirname(from), to);
 	return relativePath.startsWith("../") ? relativePath : `./${relativePath}`;
 }
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
-* Filters imports to only those that are actually used in the generated code.
-* Checks for function calls matching the imported names.
-*/
-function filterUsedImports(imports, text, skipImportNames = []) {
-	return imports.filter((entry) => {
-		return (Array.isArray(entry.name) ? entry.name : [entry.name]).map((name) => {
-			if (typeof name === "string") return name;
-			return name?.name ?? name?.propertyName;
-		}).filter((name) => Boolean(name)).some((name) => {
-			if (skipImportNames.includes(name)) return false;
-			return new RegExp(`\\b${escapeRegExp(name)}\\b(?=\\s*\\()`).test(text);
-		});
-	});
-}
-/**
-* Detects and resolves import name conflicts by adding aliases to conflicting names.
-* Returns updated imports with a mapping of original names to their aliases.
-*/
-function aliasConflictingImports(imports, reservedNames) {
-	const reservedNameSet = new Set(reservedNames);
-	const aliases = /* @__PURE__ */ new Map();
-	return {
-		imports: imports.map((entry) => {
-			const aliasedNames = (Array.isArray(entry.name) ? entry.name : [entry.name]).map((item) => {
-				if (typeof item !== "string" || !reservedNameSet.has(item)) return item;
-				const alias = `${item}Schema`;
-				aliases.set(item, alias);
-				return {
-					propertyName: item,
-					name: alias
-				};
-			});
-			return aliasedNames.some((item) => typeof item === "object" && item.name) ? {
-				...entry,
-				name: aliasedNames
-			} : entry;
-		}),
-		aliases
-	};
-}
-/**
-* Replaces all occurrences of original names with their aliased versions in the given text.
-*/
-function rewriteAliasedImports(text, aliases) {
-	return Array.from(aliases).reduce((acc, [name, alias]) => acc.replace(new RegExp(`\\b${escapeRegExp(name)}\\b`, "g"), alias), text);
-}
 /**
 * 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.
@@ -276,7 +177,7 @@ function resolveFakerTypeUsage(node, typeName, canOverride) {
 	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;
+	let returnType = canOverride ? typeName : null;
 	if (isScalar) returnType = getScalarType(node, typeName);
 	return {
 		dataType,
@@ -310,42 +211,15 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 	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 useGenericOverride = canOverride && isObject;
+	const fakerTextWithOverride = (() => {
+		if (canOverride && isTuple) return `data || ${fakerText}`;
+		if (canOverride && isArray) return `[\n  ...${fakerText},\n  ...(data || [])\n]`;
+		if (canOverride && isScalar) return `data ?? ${fakerText}`;
+		return 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 {
+	if (!useGenericOverride) {
 		const dataParamName = /\bdata\b/.test(fakerTextWithOverride) ? "data" : "_data";
 		const params = ast.createFunctionParameters({ params: [ast.createFunctionParameter({
 			name: dataParamName,
@@ -357,6 +231,7 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 		})] });
 		const paramsSignature = declarationPrinter.print(params) ?? "";
 		const returnType = resolvedReturnType;
+		const returnExpression = node.type === "ref" && canOverride && returnType ? `${fakerTextWithOverride} as ${returnType}` : fakerTextWithOverride;
 		return /* @__PURE__ */ jsx(File.Source, {
 			name,
 			isExportable: true,
@@ -366,11 +241,32 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 				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}`]
+				returnType: returnType ?? void 0,
+				children: [seed ? /* @__PURE__ */ jsxs(Fragment, { children: [`faker.seed(${JSON.stringify(seed)})`, /* @__PURE__ */ jsx("br", {})] }) : void 0, `return ${returnExpression}`]
 			})
 		});
 	}
+	const functionSignature = `${description ? `/**\n   * @description ${jsStringEscape(description)}\n   */\n  ` : ""}export function ${name}<TData extends Partial<${typeName}> = object>(data?: TData)`;
+	const seedCode = seed ? `faker.seed(${JSON.stringify(seed)})\n  ` : "";
+	const { cyclicSchemas, schemaName } = printer.options;
+	const functionBody = node.type === "object" && !!cyclicSchemas && (node.properties ?? []).some((p) => ast.containsCircularRef(p.schema, {
+		circularSchemas: cyclicSchemas,
+		excludeName: schemaName
+	})) ? `{
+  ${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 Omit<typeof defaultFakeData, keyof TData> & TData
+}` : `{
+  ${seedCode}const defaultFakeData = ${fakerText}
+  return {
+    ...defaultFakeData,
+    ...(data || {}),
+  } as Omit<typeof defaultFakeData, keyof TData> & TData
+}`;
 	return /* @__PURE__ */ jsxs(File.Source, {
 		name,
 		isExportable: true,
@@ -379,6 +275,6 @@ function Faker({ node, description, name, typeName, printer, seed, canOverride }
 	});
 }
 //#endregion
-export { filterUsedImports as a, resolveSchemaRef as c, trimQuotes as d, canOverrideSchema as i, resolveTypeReference as l, aliasConflictingImports as n, localeToFakerImport as o, buildResponseUnionSchema as r, resolveParamNameByLocation as s, Faker as t, rewriteAliasedImports as u };
+export { resolveParamNameByLocation as a, localeToFakerImport as i, buildResponseUnionSchema as n, resolveTypeReference as o, canOverrideSchema as r, Faker as t };
 
-//# sourceMappingURL=Faker-fcQEB9i5.js.map
+//# sourceMappingURL=Faker-CHh0JtBG.js.map

package/dist/Faker-CHh0JtBG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Faker-CHh0JtBG.js","names":["SCALAR_TYPES","ARRAY_TYPES"],"sources":["../src/utils.ts","../src/components/Faker.tsx"],"sourcesContent":["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 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.content?.[0]?.schema)\n\n  if (!responses.length) {\n    return null\n  }\n\n  if (responses.length === 1) {\n    const schema = responses[0]!.content?.[0]?.schema\n    if (schema && shouldInlineSingleResponseSchema(schema)) {\n      return 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 */\nfunction 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 | null\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 : null\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 '@kubb/ast/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  const useGenericOverride = canOverride && isObject\n  const fakerTextWithOverride = (() => {\n    if (canOverride && isTuple) return `data || ${fakerText}`\n    if (canOverride && isArray) return `[\\n  ...${fakerText},\\n  ...(data || [])\\n]`\n    if (canOverride && isScalar) return `data ?? ${fakerText}`\n    return fakerText\n  })()\n\n  const { dataType, returnType: resolvedReturnType } = resolveFakerTypeUsage(node, typeName, canOverride)\n\n  if (!useGenericOverride) {\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    // A `ref` wrapper delegates to another faker. Object fakers are now generic and\n    // widen to `Partial<T>` when called with a `Partial<T>`-typed argument, so cast\n    // back to the wrapper's declared return type to keep it assignable.\n    const returnExpression = node.type === 'ref' && canOverride && returnType ? `${fakerTextWithOverride} as ${returnType}` : fakerTextWithOverride\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 ?? undefined}\n        >\n          {seed ? (\n            <>\n              {`faker.seed(${JSON.stringify(seed)})`}\n              <br />\n            </>\n          ) : undefined}\n          {`return ${returnExpression}`}\n        </Function>\n      </File.Source>\n    )\n  }\n\n  // Generate function with defaultFakeData structure\n  const jsdoc = description ? `/**\\n   * @description ${jsStringEscape(description)}\\n   */\\n  ` : ''\n  const functionSignature = `${jsdoc}export function ${name}<TData extends Partial<${typeName}> = object>(data?: TData)`\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  const functionBody = hasGetters\n    ? `{\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 Omit<typeof defaultFakeData, keyof TData> & TData\n}`\n    : `{\n  ${seedCode}const defaultFakeData = ${fakerText}\n  return {\n    ...defaultFakeData,\n    ...(data || {}),\n  } as Omit<typeof defaultFakeData, keyof TData> & TData\n}`\n\n  return (\n    <File.Source name={name} isExportable isIndexable>\n      {functionSignature}\n      {functionBody}\n    </File.Source>\n  )\n}\n"],"mappings":"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"}