fix based on comments

Author: malcolm-kee

docs/.vitepress/config/en.ts

@@ -194,7 +194,7 @@ export default defineConfig({
               },
               {
                 link: '/openapi-ts/plugins/faker',
-                text: 'Faker <span data-badge>vote</span>',
+                text: 'Faker',
               },
               {
                 link: '/openapi-ts/plugins/falso',

docs/.vitepress/theme/versions/FakerVersionSwitcher.vue

@@ -0,0 +1,15 @@
+<script setup lang="ts">
+import VersionSwitcher from '@components/VersionSwitcher.vue';
+
+const versions = [
+  {
+    label: 'Faker 10',
+    short: 'v10',
+    value: 'v10',
+  },
+];
+</script>
+
+<template>
+  <VersionSwitcher :values="versions" default="v10" />
+</template>

docs/openapi-ts/plugins/faker.md

@@ -1,14 +1,16 @@
 ---
-title: Faker
-description: Generate realistic mock data factories from OpenAPI with the Faker plugin for openapi-ts. Fully compatible with all core features.
+title: Faker v10 Plugin
+description: Generate realistic mock data factories from OpenAPI with the Faker v10 plugin for openapi-ts. Fully compatible with all core features.
 ---
 
 <script setup lang="ts">
 import Heading from '@components/Heading.vue';
+import FakerVersionSwitcher from '@versions/FakerVersionSwitcher.vue';
 </script>
 
 <Heading>
-  <h1>Faker</h1>
+  <h1>Faker<span class="sr-only"> v10</span></h1>
+  <FakerVersionSwitcher />
 </Heading>
 
 ### About
@@ -19,6 +21,7 @@ The Faker plugin for Hey API generates factory functions from your OpenAPI spec
 
 ## Features
 
+- Faker v10 support
 - seamless integration with `@hey-api/openapi-ts` ecosystem
 - factory functions for reusable schema definitions and operation responses
 - smart property name inference for realistic data (e.g. `email` &rarr; `faker.internet.email()`)
@@ -211,14 +214,27 @@ export default {
 
 See the [Faker localization guide](https://fakerjs.dev/guide/localization) for available locales.
 
+## Deterministic Results
+
+For snapshot testing or reproducible output, you can seed the faker instance and fix the reference date to ensure deterministic results.
+
+```ts
+import { faker } from '@faker-js/faker';
+
+faker.seed(42);
+faker.setDefaultRefDate('2026-01-01T00:00:00.000Z');
+
+const data = fakeFoo({ faker });
+// always returns the same output
+```
+
 ## Custom Faker Instance
 
-For runtime locale switching or seeded deterministic output, you can pass your own faker instance via the `faker` option.
+You can pass your own [faker instance](https://fakerjs.dev/api/faker.html) via the `faker` option for runtime locale switching or other customizations.
 
 ```ts
 import { faker } from '@faker-js/faker/locale/de';
 
-faker.seed(42);
 const data = fakeFoo({ faker });
 ```
 

packages/openapi-ts/src/plugins/@faker-js/faker/v10/toAst/array.ts

@@ -38,7 +38,7 @@ export function arrayToExpression({
   // faker requires both min and max — fill in sensible defaults when only one is specified
   if (schema.minItems !== undefined || schema.maxItems !== undefined) {
     const min = schema.minItems ?? 0;
-    const max = schema.maxItems ?? 1000;
+    const max = schema.maxItems ?? 100;
     const countObj = $.object().prop('min', $.literal(min)).prop('max', $.literal(max));
     const options = $.object().prop('count', countObj);
     return fakerCtx.fakerAccessor.attr('helpers').attr('multiple').call(callback, options);

packages/openapi-ts/src/plugins/@faker-js/faker/v10/toAst/enum.ts

@@ -16,7 +16,7 @@ export function enumToExpression(
     if (item.const === null || item.type === 'null') {
       members.push($.fromValue(null));
     } else if (item.const !== undefined) {
-      members.push($.literal(item.const as string));
+      members.push($.literal(item.const as string | number));
     }
   }
 

packages/openapi-ts/src/plugins/@faker-js/faker/v10/toAst/number.ts

@@ -23,6 +23,9 @@ export function numberToExpression(
   let min: number | undefined;
   let max: number | undefined;
 
+  // For floats, exclusive bounds are passed as-is to faker's min/max options,
+  // which treats them as inclusive. This is technically not strictly exclusive,
+  // but fine in practice since the chance of hitting the exact bound is negligible.
   if (schema.exclusiveMinimum !== undefined) {
     min = isInteger ? schema.exclusiveMinimum + 1 : schema.exclusiveMinimum;
   } else if (schema.minimum !== undefined) {

packages/openapi-ts/src/plugins/@faker-js/faker/v10/toAst/string.ts

@@ -39,7 +39,7 @@ export function stringToExpression(
   // faker requires both min and max — fill in sensible defaults when only one is specified
   if (schema.minLength !== undefined || schema.maxLength !== undefined) {
     const min = schema.minLength ?? 0;
-    const max = schema.maxLength ?? 1000;
+    const max = schema.maxLength ?? 100;
     const lengthObj = $.object().prop('min', $.literal(min)).prop('max', $.literal(max));
     return ctx.fakerAccessor
       .attr('string')