@kubb/plugin-faker 5.1.0-canary.20261008T204013 → 5.1.1

package/dist/index.cjs

@@ -574,14 +574,14 @@ const SCALAR_TYPES = /* @__PURE__ */ new Set([
 	"enum"
 ]);
 const declarationPrinter = (0, _kubb_plugin_ts.functionPrinter)({ mode: "declaration" });
-function Faker({ node, description, name, typeName, printer, canOverride }) {
+function Faker({ node, description, name, typeName, printer, canOverride, typeMode = "inferred" }) {
 	const fakerText = printer.print(node) ?? "undefined";
 	const isArray = node.type === "array";
 	const isObject = OBJECT_TYPES.has(node.type);
 	const isTuple = node.type === "tuple";
 	const isScalar = SCALAR_TYPES.has(node.type);
 	const isUnion = node.type === "union";
-	const useGenericOverride = canOverride && isObject;
+	const useObjectOverride = canOverride && isObject;
 	const fakerTextWithOverride = (() => {
 		if (canOverride && node.type === "tuple") return `data && data.length === ${node.items?.length ?? 0} && !data.includes(undefined) ? data : ${fakerText}`;
 		if (canOverride && isArray) return `[\n  ...${fakerText},\n  ...(data || []).filter((item) => item !== undefined),\n]`;
@@ -589,7 +589,7 @@ function Faker({ node, description, name, typeName, printer, canOverride }) {
 		return fakerText;
 	})();
 	const { dataType, returnType: resolvedReturnType } = resolveFakerTypeUsage(node, typeName, canOverride);
-	if (!useGenericOverride) {
+	if (!useObjectOverride) {
 		const dataParamName = /\bdata\b/.test(fakerTextWithOverride) ? "data" : "_data";
 		const params = (0, _kubb_plugin_ts.createFunctionParameters)({ params: [(0, _kubb_plugin_ts.createFunctionParameter)({
 			name: dataParamName,
@@ -613,31 +613,35 @@ function Faker({ node, description, name, typeName, printer, canOverride }) {
 			})
 		});
 	}
-	const functionSignature = `${description ? `/**\n   * @description ${jsStringEscape(description)}\n   */\n  ` : ""}export function ${name}<TData extends Partial<${typeName}> = object>(data?: TData)`;
+	const returnType = typeMode === "schema" ? typeName : "Omit<typeof defaultFakeData, keyof NoInfer<TData>> & NoInfer<TData>";
 	const { cyclicSchemas, schemaName } = printer.options;
 	const functionBody = node.type === "object" && !!cyclicSchemas && (node.properties ?? []).some((p) => (0, kubb_kit.containsCircularRef)(p.schema, {
 		circularSchemas: cyclicSchemas,
 		excludeName: schemaName
-	})) ? `{
-  const defaultFakeData = ${fakerText}
-  if (data) {
-    for (const [key, value] of Object.entries(data)) {
-      Object.defineProperty(defaultFakeData, key, { value, configurable: true, writable: true, enumerable: true })
-    }
+	})) ? `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 NoInfer<TData>> & NoInfer<TData>
-}` : `{
-  const defaultFakeData = ${fakerText}
-  return {
-    ...defaultFakeData,
-    ...(data || {}),
-  } as Omit<typeof defaultFakeData, keyof NoInfer<TData>> & NoInfer<TData>
-}`;
-	return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsxs)(kubb_jsx.File.Source, {
+}
+return defaultFakeData as ${returnType}` : `const defaultFakeData = ${fakerText}
+return {
+  ...defaultFakeData,
+  ...(data || {}),
+} as ${returnType}`;
+	return /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.File.Source, {
 		name,
 		isExportable: true,
 		isIndexable: true,
-		children: [functionSignature, functionBody]
+		children: /* @__PURE__ */ (0, kubb_jsx_jsx_runtime.jsx)(kubb_jsx.Function, {
+			export: true,
+			name,
+			JSDoc: { comments: description ? [`@description ${jsStringEscape(description)}`] : [] },
+			generics: typeMode === "schema" ? void 0 : `TData extends Partial<${typeName}> = object`,
+			params: typeMode === "schema" ? `data?: Partial<${typeName}>` : "data?: TData",
+			returnType: typeMode === "schema" ? typeName : void 0,
+			children: functionBody
+		})
 	});
 }
 //#endregion
@@ -1150,9 +1154,9 @@ const fakerGenerator = (0, kubb_kit.defineGenerator)({
 	renderer: kubb_jsx.jsxRenderer,
 	schema(node, ctx) {
 		const { config, resolver, root } = ctx;
-		const { output, group, dateParser, regexGenerator, seed, locale, printer } = ctx.options;
-		const pluginTs = ctx.driver.getPlugin(_kubb_plugin_ts.pluginTsName);
-		if (!node.name || !pluginTs) return;
+		const { output, group, dateParser, regexGenerator, seed, locale, printer, typeMode } = ctx.options;
+		const pluginTs = ctx.requirePlugin(_kubb_plugin_ts.pluginTsName);
+		if (!node.name) return;
 		const tsResolver = ctx.driver.getResolver(_kubb_plugin_ts.pluginTsName);
 		const schemaName = node.name;
 		const isEnumSchema = !!kubb_kit.ast.narrowSchema(node, kubb_kit.ast.schemaTypes.enum);
@@ -1264,16 +1268,16 @@ const fakerGenerator = (0, kubb_kit.defineGenerator)({
 					description: node.description,
 					node,
 					printer: printerInstance,
-					canOverride
+					canOverride,
+					typeMode
 				})
 			]
 		});
 	},
 	operation(node, ctx) {
 		const { config, resolver, root } = ctx;
-		const { output, group, dateParser, regexGenerator, seed, locale, printer } = ctx.options;
-		const pluginTs = ctx.driver.getPlugin(_kubb_plugin_ts.pluginTsName);
-		if (!pluginTs) return;
+		const { output, group, dateParser, regexGenerator, seed, locale, printer, typeMode } = ctx.options;
+		const pluginTs = ctx.requirePlugin(_kubb_plugin_ts.pluginTsName);
 		const tsResolver = ctx.driver.getResolver(_kubb_plugin_ts.pluginTsName);
 		const { path: pathParams, query: queryParams, header: headerParams } = getOperationParameters(node);
 		const paramGroups = [
@@ -1422,7 +1426,8 @@ const fakerGenerator = (0, kubb_kit.defineGenerator)({
 						...printerInstance,
 						print: () => rewrittenFakerText
 					},
-					canOverride
+					canOverride,
+					typeMode
 				})
 			] });
 		}
@@ -1549,13 +1554,14 @@ const pluginFaker = (0, kubb_kit.definePlugin)((options) => {
 	const { output = {
 		path: "mocks",
 		barrel: { type: "named" }
-	}, seed, locale = "en", group, exclude = [], include, override = [], dateParser = "faker", regexGenerator = "faker", printer, resolver: userResolver, macros: userMacros } = options;
+	}, seed, locale = "en", group, exclude = [], include, override = [], typeMode = "inferred", dateParser = "faker", regexGenerator = "faker", printer, resolver: userResolver, macros: userMacros } = options;
 	const groupConfig = createGroupConfig(group);
 	return {
 		name: pluginFakerName,
 		options,
 		dependencies: [_kubb_plugin_ts.pluginTsName],
 		hooks: { "kubb:plugin:setup"(ctx) {
+			ctx.requirePlugin(_kubb_plugin_ts.pluginTsName);
 			ctx.setOptions({
 				output,
 				seed,
@@ -1563,6 +1569,7 @@ const pluginFaker = (0, kubb_kit.definePlugin)((options) => {
 				exclude,
 				include,
 				override,
+				typeMode,
 				group: groupConfig,
 				dateParser,
 				regexGenerator,