@kubb/plugin-faker 5.0.0-beta.22 → 5.0.0-beta.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubb/plugin-faker",
-  "version": "5.0.0-beta.22",
+  "version": "5.0.0-beta.27",
   "description": "Generate Faker.js mock data factories from your OpenAPI schemas. Produces realistic seed data, test fixtures, and datasets for development and testing.",
   "keywords": [
     "code-generation",
@@ -66,15 +66,15 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@kubb/core": "5.0.0-beta.22",
-    "@kubb/renderer-jsx": "5.0.0-beta.22",
-    "@kubb/plugin-ts": "5.0.0-beta.22"
+    "@kubb/core": "5.0.0-beta.27",
+    "@kubb/renderer-jsx": "5.0.0-beta.27",
+    "@kubb/plugin-ts": "5.0.0-beta.27"
   },
   "devDependencies": {
     "@internals/utils": "0.0.0"
   },
   "peerDependencies": {
-    "@kubb/renderer-jsx": "5.0.0-beta.22"
+    "@kubb/renderer-jsx": "5.0.0-beta.27"
   },
   "size-limit": [
     {

package/src/components/Faker.tsx

@@ -76,7 +76,7 @@ export function Faker({ node, description, name, typeName, printer, seed, canOve
           name={name}
           JSDoc={{ comments: description ? [`@description ${jsStringEscape(description)}`] : [] }}
           params={canOverride ? paramsSignature : undefined}
-          returnType={returnType}
+          returnType={returnType ?? undefined}
         >
           {seed ? (
             <>

package/src/generators/fakerGenerator.tsx

@@ -7,6 +7,12 @@ import { printerFaker } from '../printers/printerFaker.ts'
 import type { PluginFaker } from '../types.ts'
 import { buildResponseUnionSchema, canOverrideSchema, localeToFakerImport, resolveParamNameByLocation, resolveTypeReference } from '../utils.ts'
 
+/**
+ * Built-in generator for `@kubb/plugin-faker`. Emits one `createX` factory
+ * per schema in the spec plus per-operation request/response factories. Each
+ * factory returns a value matching the corresponding TypeScript type from
+ * `@kubb/plugin-ts`.
+ */
 export const fakerGenerator = defineGenerator<PluginFaker>({
   name: 'faker',
   renderer: jsxRendererSync,
@@ -25,11 +31,11 @@ export const fakerGenerator = defineGenerator<PluginFaker>({
     const mode = ctx.getMode(output)
     const meta = {
       name: resolver.resolveName(schemaName),
-      file: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group }),
+      file: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group: group ?? undefined }),
       typeName: tsResolver.resolveTypeName(schemaName),
       typeFile: tsResolver.resolveFile(
         { name: schemaName, extname: '.ts' },
-        { root, output: pluginTs.options?.output ?? output, group: pluginTs.options?.group },
+        { root, output: pluginTs.options?.output ?? output, group: pluginTs.options?.group ?? undefined },
       ),
     } as const
     const canOverride = canOverrideSchema(node)
@@ -57,7 +63,7 @@ export const fakerGenerator = defineGenerator<PluginFaker>({
     const imports = adapter
       .getImports(node, (schemaName) => ({
         name: resolver.resolveName(schemaName),
-        path: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group }).path,
+        path: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group: group ?? undefined }).path,
       }))
       .filter((entry) => entry.path !== meta.file.path)
     const usedImports = filterUsedImports(imports, fakerText)
@@ -131,7 +137,10 @@ export const fakerGenerator = defineGenerator<PluginFaker>({
     const cyclicSchemas = new Set<string>(ctx.meta.circularNames)
 
     const meta = {
-      file: resolver.resolveFile({ name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path }, { root, output, group }),
+      file: resolver.resolveFile(
+        { name: node.operationId, extname: '.ts', tag: node.tags[0] ?? 'default', path: node.path },
+        { root, output, group: group ?? undefined },
+      ),
       typeFile: tsResolver.resolveFile(
         {
           name: node.operationId,
@@ -142,7 +151,7 @@ export const fakerGenerator = defineGenerator<PluginFaker>({
         {
           root,
           output: pluginTs.options?.output ?? output,
-          group: pluginTs.options?.group,
+          group: pluginTs.options?.group ?? undefined,
         },
       ),
     } as const
@@ -151,7 +160,7 @@ export const fakerGenerator = defineGenerator<PluginFaker>({
       return adapter
         .getImports(schema, (schemaName) => ({
           name: resolver.resolveName(schemaName),
-          path: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group }).path,
+          path: resolver.resolveFile({ name: schemaName, extname: '.ts' }, { root, output, group: group ?? undefined }).path,
         }))
         .filter((entry) => entry.path !== meta.file.path)
     }

package/src/plugin.ts

@@ -6,17 +6,34 @@ import { resolverFaker } from './resolvers/resolverFaker.ts'
 import type { PluginFaker } from './types.ts'
 
 /**
- * Canonical plugin name for `@kubb/plugin-faker`, used in driver lookups and warnings.
+ * Canonical plugin name for `@kubb/plugin-faker`. Used for driver lookups and
+ * cross-plugin dependency references.
  */
 export const pluginFakerName = 'plugin-faker' satisfies PluginFaker['name']
 
 /**
- * Generates Faker mock data factories from OpenAPI/AST specification.
- *
- * Creates randomized test data and mock helpers from schema definitions.
+ * Generates one mock-data factory per OpenAPI schema using Faker.js. Call
+ * `createPet()` to get a realistic `Pet` object. Useful for tests, Storybook,
+ * and local development without a running backend.
  *
  * @example
- * `import pluginFaker from '@kubb/plugin-faker'; export default defineConfig({ plugins: [pluginFaker({ output: { path: 'mocks' } })], })`
+ * ```ts
+ * import { defineConfig } from 'kubb'
+ * import { pluginTs } from '@kubb/plugin-ts'
+ * import { pluginFaker } from '@kubb/plugin-faker'
+ *
+ * export default defineConfig({
+ *   input: { path: './petStore.yaml' },
+ *   output: { path: './src/gen' },
+ *   plugins: [
+ *     pluginTs(),
+ *     pluginFaker({
+ *       output: { path: './mocks' },
+ *       seed: [100],
+ *     }),
+ *   ],
+ * })
+ * ```
  */
 export const pluginFaker = definePlugin<PluginFaker>((options) => {
   const {
@@ -50,7 +67,7 @@ export const pluginFaker = definePlugin<PluginFaker>((options) => {
               return `${camelCase(ctx.group)}Controller`
             },
       } satisfies Group)
-    : undefined
+    : null
 
   return {
     name: pluginFakerName,

package/src/printers/printerFaker.ts

@@ -3,12 +3,30 @@ import { ast } from '@kubb/core'
 import type { PluginFaker, ResolverFaker } from '../types.ts'
 
 /**
- * Partial printer nodes for Faker generation, mapping schema types to output strings.
+ * Partial map of node-type overrides for the Faker printer. Each key is a
+ * `SchemaType` (`'string'`, `'date'`, ...) and each handler returns the
+ * Faker expression for that schema as a string. Use `this.transform` to
+ * recurse into nested schema nodes and `this.options` to read printer options.
+ *
+ * @example Override the integer handler
+ * ```ts
+ * pluginFaker({
+ *   printer: {
+ *     nodes: {
+ *       integer() {
+ *         return 'faker.number.float()'
+ *       },
+ *     },
+ *   },
+ * })
+ * ```
  */
 export type PrinterFakerNodes = ast.PrinterPartial<string, PrinterFakerOptions>
 
 /**
- * Configuration options for the Faker printer, including resolvers, mappers, and cyclic schema tracking.
+ * Options passed to the Faker printer at instantiation: the parser library
+ * for date strings, the regex generator, the user-supplied schema-name
+ * mapper, and the resolver used to compute identifiers.
  */
 export type PrinterFakerOptions = {
   dateParser?: PluginFaker['resolvedOptions']['dateParser']
@@ -85,7 +103,7 @@ const fakerKeywordMapper = {
   },
   boolean: () => 'faker.datatype.boolean()',
   null: () => 'null',
-  array: (items: string[] = [], min?: number, max?: number) => {
+  array: (items: Array<string> = [], min?: number, max?: number) => {
     if (items.length > 1) {
       return `faker.helpers.arrayElements([${items.join(', ')}])`
     }
@@ -106,9 +124,9 @@ const fakerKeywordMapper = {
 
     return `faker.helpers.multiple(() => (${item}))`
   },
-  tuple: (items: string[] = []) => `[${items.join(', ')}]`,
+  tuple: (items: Array<string> = []) => `[${items.join(', ')}]`,
   enum: (items: Array<string | number | boolean | undefined> = [], type = 'any') => `faker.helpers.arrayElement<${type}>([${items.join(', ')}])`,
-  union: (items: string[] = []) => `faker.helpers.arrayElement<any>([${items.join(', ')}])`,
+  union: (items: Array<string> = []) => `faker.helpers.arrayElement<any>([${items.join(', ')}])`,
   datetime: () => 'faker.date.anytime().toISOString()',
   date: (representation: 'date' | 'string' = 'string', parser: PluginFaker['resolvedOptions']['dateParser'] = 'faker') => {
     if (representation === 'string') {
@@ -142,7 +160,7 @@ const fakerKeywordMapper = {
   },
   uuid: () => 'faker.string.uuid()',
   url: () => 'faker.internet.url()',
-  and: (items: string[] = []) => {
+  and: (items: Array<string> = []) => {
     if (items.length === 0) {
       return '{}'
     }
@@ -258,7 +276,7 @@ export const printerFaker: (options: PrinterFakerOptions) => ast.Printer<Printer
         return fakerKeywordMapper.enum(getEnumValues(node).map(parseEnumValue), this.options.typeName)
       },
       union(node): string {
-        const items: string[] = (node.members ?? [])
+        const items: Array<string> = (node.members ?? [])
           .map((member) =>
             printNested(member, {
               nestedInObject: true,
@@ -269,7 +287,7 @@ export const printerFaker: (options: PrinterFakerOptions) => ast.Printer<Printer
         return fakerKeywordMapper.union(items)
       },
       intersection(node): string {
-        const items: string[] = (node.members ?? [])
+        const items: Array<string> = (node.members ?? [])
           .map((member) =>
             printNested(member, {
               nestedInObject: true,
@@ -280,7 +298,7 @@ export const printerFaker: (options: PrinterFakerOptions) => ast.Printer<Printer
         return fakerKeywordMapper.and(items)
       },
       array(node): string {
-        const items: string[] = (node.items ?? [])
+        const items: Array<string> = (node.items ?? [])
           .map((member) =>
             printNested(member, {
               typeName: this.options.typeName ? `NonNullable<${this.options.typeName}>[number]` : undefined,
@@ -292,7 +310,7 @@ export const printerFaker: (options: PrinterFakerOptions) => ast.Printer<Printer
         return fakerKeywordMapper.array(items, node.min, node.max)
       },
       tuple(node): string {
-        const items: string[] = (node.items ?? [])
+        const items: Array<string> = (node.items ?? [])
           .map((member, index) =>
             printNested(member, {
               typeName: this.options.typeName ? `NonNullable<${this.options.typeName}>[${index}]` : undefined,

package/src/resolvers/resolverFaker.ts

@@ -1,16 +1,20 @@
 import { createHash } from 'node:crypto'
 import path from 'node:path'
-import { camelCase, isValidVarName } from '@internals/utils'
+import { camelCase, ensureValidVarName } from '@internals/utils'
 import { defineResolver, KubbDriver } from '@kubb/core'
 import type { PluginFaker } from '../types.ts'
 
 /**
- * Naming convention resolver for Faker plugin.
+ * Default resolver used by `@kubb/plugin-faker`. Decides the names and file
+ * paths for every generated mock factory. Functions and files are prefixed
+ * with `create` so `Pet` becomes `createPet`.
  *
- * Provides default naming helpers using camelCase with a `create` prefix for factory functions and files.
+ * @example Resolve a factory name
+ * ```ts
+ * import { resolverFaker } from '@kubb/plugin-faker'
  *
- * @example
- * `resolverFaker.default('list pets', 'function')  // → 'createListPets'`
+ * resolverFaker.default('list pets', 'function') // 'createListPets'
+ * ```
  */
 export const resolverFaker = defineResolver<PluginFaker>(() => {
   return {
@@ -18,12 +22,7 @@ export const resolverFaker = defineResolver<PluginFaker>(() => {
     pluginName: 'plugin-faker',
     default(name, type) {
       const resolvedName = camelCase(name, { isFile: type === 'file', prefix: 'create' })
-
-      if (type === 'file' || isValidVarName(resolvedName)) {
-        return resolvedName
-      }
-
-      return `_${resolvedName}`
+      return type === 'file' ? resolvedName : ensureValidVarName(resolvedName)
     },
     resolveName(name, type) {
       return this.default(name, type)

package/src/types.ts

@@ -73,80 +73,86 @@ export type ResolverFaker = Resolver &
 
 export type Options = {
   /**
-   * Specify the export location for the files and define the behavior of the output.
-   * @default { path: 'mocks', barrelType: 'named' }
+   * Where the generated mock factories are written and how they are exported.
+   *
+   * @default { path: 'mocks', barrel: { type: 'named' } }
    */
   output?: Output
   /**
-   * Group the Faker mocks based on the provided name.
+   * Split generated files into subfolders based on the operation's tag.
    */
   group?: Group
   /**
-   * Tags, operations, or paths to exclude from generation.
+   * Skip operations matching at least one entry in the list.
    */
   exclude?: Array<Exclude>
   /**
-   * Tags, operations, or paths to include in generation.
+   * Restrict generation to operations matching at least one entry in the list.
    */
   include?: Array<Include>
   /**
-   * Override options for specific tags, operations, or paths.
+   * Apply a different options object to operations matching a pattern.
    */
   override?: Array<Override<ResolvedOptions>>
   /**
-   * Parser to use when formatting date/time values as strings.
+   * Library used to format string-represented date, time, and datetime fields.
+   * Any library exporting a default function works; Kubb adds the import for you.
    *
    * @default 'faker'
    */
   dateParser?: 'faker' | 'dayjs' | 'moment' | (string & {})
   /**
-   * Generator to use for RegExp patterns.
+   * Library used to generate strings that satisfy a regex `pattern` keyword.
+   * - `'faker'` uses `faker.helpers.fromRegExp`. No extra dependency.
+   * - `'randexp'` uses the `randexp` package. Supports a wider regex grammar.
    *
    * @default 'faker'
    */
   regexGenerator?: 'faker' | 'randexp'
   /**
-   * Provide per-property faker expressions keyed by property name.
+   * Map a schema name to a custom Faker expression. Use this when the schema name
+   * does not give Faker enough context (`'email'`, `'avatarUrl'`, `'phoneNumber'`).
    */
   mapper?: Record<string, string>
   /**
-   * Locale for generating mock data.
-   * Imports the matching localized `@faker-js/faker` instance so names, addresses,
-   * and phone numbers reflect the target region.
+   * Faker locale code. Switches the named import to `fakerXX` from `@faker-js/faker`
+   * so names, addresses, and phone numbers reflect the target region.
    *
    * @default 'en'
-   *
    * @example German
    * `locale: 'de'`
-   *
    * @example Austrian German
    * `locale: 'de_AT'`
-   *
    * @see https://fakerjs.dev/api/localization.html
    */
   locale?: string
   /**
-   * Seed faker for deterministic output.
+   * Value passed to `faker.seed(...)`. Set this for deterministic mock output,
+   * which is useful for snapshot tests.
    */
-  seed?: number | number[]
+  seed?: number | Array<number>
   /**
-   * Apply casing to parameter names to match your configuration.
+   * Rename properties inside path/query/header mocks. Body mocks are unaffected.
+   *
+   * @note Must match the value of `paramsCasing` on `@kubb/plugin-ts`.
    */
   paramsCasing?: 'camelcase'
   /**
-   * Additional generators alongside the default generators.
+   * Custom generators that run alongside the built-in Faker generators.
    */
   generators?: Array<Generator<PluginFaker>>
   /**
-   * Override naming conventions for function names and types.
+   * Override the naming of generated factory helpers. Common use: append `Mock` or
+   * `Factory` so helpers do not clash with imported types.
    */
   resolver?: Partial<ResolverFaker> & ThisType<ResolverFaker>
   /**
-   * AST visitor to transform generated nodes.
+   * AST visitor applied to schema and operation nodes before printing.
    */
   transformer?: ast.Visitor
   /**
-   * Override individual faker printer node handlers.
+   * Replace the Faker handler for a specific schema type (`'integer'`, `'date'`, ...).
+   * Each handler returns the Faker expression as a string.
    */
   printer?: {
     nodes?: PrinterFakerNodes
@@ -155,7 +161,7 @@ export type Options = {
 
 type ResolvedOptions = {
   output: Output
-  group: Group | undefined
+  group: Group | null
   exclude: NonNullable<Options['exclude']>
   include: Options['include']
   override: NonNullable<Options['override']>

package/src/utils.ts

@@ -225,7 +225,7 @@ export function resolveFakerTypeUsage(
   canOverride: boolean,
 ): {
   dataType: string
-  returnType: string | undefined
+  returnType: string | null
   usesTypeName: boolean
 } {
   const isArray = ARRAY_TYPES.has(node.type)
@@ -242,7 +242,7 @@ export function resolveFakerTypeUsage(
     dataType = getScalarType(node, typeName)
   }
 
-  let returnType = canOverride ? typeName : undefined
+  let returnType = canOverride ? typeName : null
 
   if (isScalar) {
     returnType = getScalarType(node, typeName)

package/dist/Faker-AHTTvWZS.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Faker-AHTTvWZS.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 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  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    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  // Generate function with defaultFakeData structure\n  const jsdoc = description ? `/**\\n   * @description ${jsStringEscape(description)}\\n   */\\n  ` : ''\n  const 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  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 Required<${typeName}>\n}`\n    : `{\n  ${seedCode}const defaultFakeData = ${fakerText}\n  return {\n    ...defaultFakeData,\n    ...(data || {}),\n  } as Required<${typeName}>\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/Faker-BoPNqNfi.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Faker-BoPNqNfi.cjs","names":["ast","SCALAR_TYPES","ARRAY_TYPES","posix","ast","File","Function"],"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 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  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    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  // Generate function with defaultFakeData structure\n  const jsdoc = description ? `/**\\n   * @description ${jsStringEscape(description)}\\n   */\\n  ` : ''\n  const 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  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 Required<${typeName}>\n}`\n    : `{\n  ${seedCode}const defaultFakeData = ${fakerText}\n  return {\n    ...defaultFakeData,\n    ...(data || {}),\n  } as Required<${typeName}>\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;;;;;AAMnB,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,OAAOA,WAAAA,IAAI,aAAa;GAAE,MAAM;GAAO,MAAM,SAAS,0BAA0B,MAAM,UAAU,GAAI,WAAW;GAAE,CAAC;;CAGpH,OAAOA,WAAAA,IAAI,aAAa;EACtB,MAAM;EACN,SAAS,UAAU,KAAK,aAAaA,WAAAA,IAAI,aAAa;GAAE,MAAM;GAAO,MAAM,SAAS,0BAA0B,MAAM,SAAS,WAAW;GAAE,CAAC,CAAC;EAC7I,CAAC;;AAGJ,MAAMC,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,eAAeC,UAAAA,MAAM,SAASA,UAAAA,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,UAAUD,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;;;;AC3OH,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,sBAAA,GAAA,gBAAA,iBAAqC,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,MAAM,qBAAqB,eAAe;CAC1C,MAAM,+BAA+B;EACnC,IAAI,eAAe,SAAS,OAAO,WAAW;EAC9C,IAAI,eAAe,SAAS,OAAO,WAAW,UAAU;EACxD,IAAI,eAAe,UAAU,OAAO,WAAW;EAC/C,OAAO;KACL;CAEJ,MAAM,EAAE,UAAU,YAAY,uBAAuB,sBAAsB,MAAM,UAAU,YAAY;CAEvG,IAAI,CAAC,oBAAoB;EAEvB,MAAM,gBADW,WAAW,KAAK,sBACH,GAAG,SAAS;EAC1C,MAAM,SAASG,WAAAA,IAAI,yBAAyB,EAC1C,QAAQ,CACNA,WAAAA,IAAI,wBAAwB;GAC1B,MAAM;GACN,MAAMA,WAAAA,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,iBAAA,GAAA,+BAAA,KAACC,mBAAAA,KAAK,QAAN;GAAmB;GAAM,cAAA;GAAa,aAAA;aACpC,iBAAA,GAAA,+BAAA,MAACC,mBAAAA,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,iBAAA,GAAA,+BAAA,MAAA,+BAAA,UAAA,EAAA,UAAA,CACG,cAAc,KAAK,UAAU,KAAK,CAAC,IACpC,iBAAA,GAAA,+BAAA,KAAC,MAAD,EAAM,CAAA,CACL,EAAA,CAAA,GACD,KAAA,GACH,UAAU,wBACF;;GACC,CAAA;;CAMlB,MAAM,oBAAoB,GADZ,cAAc,0BAA0B,eAAe,YAAY,CAAC,eAAe,GAC9D,kBAAkB,KAAK,kBAAkB,SAAS,eAAe,SAAS;CAE7G,MAAM,WAAW,OAAO,cAAc,KAAK,UAAU,KAAK,CAAC,SAAS;CAOpE,MAAM,EAAE,eAAe,eAAe,QAAQ;CAM9C,MAAM,eAJJ,KAAK,SAAS,YACd,CAAC,CAAC,kBACD,KAAK,cAAc,EAAE,EAAE,MAAM,MAAMF,WAAAA,IAAI,oBAAoB,EAAE,QAAQ;EAAE,iBAAiB;EAAe,aAAa;EAAY,CAAC,CAAC,GAGjI;IACF,SAAS,0BAA0B,UAAU;;;;;;uCAMV,SAAS;KAE1C;IACF,SAAS,0BAA0B,UAAU;;;;kBAI/B,SAAS;;CAGzB,OACE,iBAAA,GAAA,+BAAA,MAACC,mBAAAA,KAAK,QAAN;EAAmB;EAAM,cAAA;EAAa,aAAA;YAAtC,CACG,mBACA,aACW"}

package/dist/fakerGenerator-B-QnVz9o.d.ts

@@ -1,9 +0,0 @@
-import { t as __name } from "./chunk--u3MIqq1.js";
-import { o as PluginFaker } from "./printerFaker-W0pLunAj.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-B-QnVz9o.d.ts.map