@kubb/plugin-faker 5.0.0-alpha.8 → 5.0.0-beta.3

package/dist/Faker-fcQEB9i5.js

@@ -0,0 +1,384 @@
+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}`;
+}
+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.
+*/
+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 { 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 };
+
+//# sourceMappingURL=Faker-fcQEB9i5.js.map

package/dist/Faker-fcQEB9i5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Faker-fcQEB9i5.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\n/**\n * Import name that can be a string or a renamed import object.\n */\nexport type ImportName = string | { propertyName: string; name?: string }\n\n/**\n * Import entry containing module path and imported names.\n */\nexport type ImportEntry = {\n  name: string | Array<ImportName>\n  path: string\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\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n\n/**\n * Filters imports to only those that are actually used in the generated code.\n * Checks for function calls matching the imported names.\n */\nexport function filterUsedImports(imports: Array<ImportEntry>, text: string, skipImportNames: Array<string> = []): Array<ImportEntry> {\n  return imports.filter((entry) => {\n    const names = (Array.isArray(entry.name) ? entry.name : [entry.name])\n      .map((name) => {\n        if (typeof name === 'string') {\n          return name\n        }\n\n        return name?.name ?? name?.propertyName\n      })\n      .filter((name): name is string => Boolean(name))\n\n    return names.some((name) => {\n      if (skipImportNames.includes(name)) {\n        return false\n      }\n\n      return new RegExp(`\\\\b${escapeRegExp(name)}\\\\b(?=\\\\s*\\\\()`).test(text)\n    })\n  })\n}\n\n/**\n * Detects and resolves import name conflicts by adding aliases to conflicting names.\n * Returns updated imports with a mapping of original names to their aliases.\n */\nexport function aliasConflictingImports(\n  imports: Array<ImportEntry>,\n  reservedNames: Iterable<string>,\n): { imports: Array<ImportEntry>; aliases: Map<string, string> } {\n  const reservedNameSet = new Set(reservedNames)\n  const aliases = new Map<string, string>()\n\n  const aliasedImports = imports.map((entry) => {\n    const names = Array.isArray(entry.name) ? entry.name : [entry.name]\n    const aliasedNames = names.map((item): ImportName => {\n      if (typeof item !== 'string' || !reservedNameSet.has(item)) {\n        return item\n      }\n\n      const alias = `${item}Schema`\n      aliases.set(item, alias)\n\n      return { propertyName: item, name: alias }\n    })\n\n    return aliasedNames.some((item) => typeof item === 'object' && item.name)\n      ? {\n          ...entry,\n          name: aliasedNames,\n        }\n      : entry\n  })\n\n  return {\n    imports: aliasedImports,\n    aliases,\n  }\n}\n\n/**\n * Replaces all occurrences of original names with their aliased versions in the given text.\n */\nexport function rewriteAliasedImports(text: string, aliases: ReadonlyMap<string, string>): string {\n  return Array.from(aliases).reduce((acc, [name, alias]) => acc.replace(new RegExp(`\\\\b${escapeRegExp(name)}\\\\b`, 'g'), alias), text)\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":"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"}

package/dist/components.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_components = require("./components-IdP8GXXX.cjs");
-exports.Faker = require_components.Faker;
+const require_Faker = require("./Faker-BgleOzVN.cjs");
+exports.Faker = require_Faker.Faker;

package/dist/components.d.ts

@@ -1,31 +1,2 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { n as PluginFaker } from "./types-r7BubMLO.js";
-import { Schema } from "@kubb/plugin-oas";
-import { FabricReactNode } from "@kubb/react-fabric/types";
-
-//#region src/components/Faker.d.ts
-type Props = {
-  name: string;
-  typeName: string;
-  tree: Array<Schema>;
-  seed?: PluginFaker['options']['seed'];
-  description?: string;
-  regexGenerator?: PluginFaker['options']['regexGenerator'];
-  mapper?: PluginFaker['options']['mapper'];
-  dateParser?: PluginFaker['options']['dateParser'];
-  canOverride: boolean;
-};
-declare function Faker({
-  tree,
-  description,
-  name,
-  typeName,
-  seed,
-  regexGenerator,
-  canOverride,
-  mapper,
-  dateParser
-}: Props): FabricReactNode;
-//#endregion
-export { Faker };
-//# sourceMappingURL=components.d.ts.map
+import { t as Faker } from "./Faker-CdyPfOPg.js";
+export { Faker };

package/dist/components.js

@@ -1,2 +1,2 @@
-import { t as Faker } from "./components-BkBIov4R.js";
+import { t as Faker } from "./Faker-fcQEB9i5.js";
 export { Faker };

package/dist/fakerGenerator-C3Ho3BaI.d.ts

@@ -0,0 +1,9 @@
+import { t as __name } from "./chunk--u3MIqq1.js";
+import { o as PluginFaker } from "./printerFaker-CJiwzoto.js";
+import * as _$_kubb_core0 from "@kubb/core";
+
+//#region src/generators/fakerGenerator.d.ts
+declare const fakerGenerator: _$_kubb_core0.Generator<PluginFaker, unknown>;
+//#endregion
+export { fakerGenerator as t };
+//# sourceMappingURL=fakerGenerator-C3Ho3BaI.d.ts.map