feat(zod): promote zod4 converter to stable (#763)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Documentation**
* Updated all documentation and example code to reference
`ZodToJsonSchemaConverter` instead of the previous experimental alias.
This streamlines and clarifies usage instructions for OpenAPI spec
generation.

* **Refactor**
* Renamed the interface and class for the JSON Schema converter to
remove the experimental prefix, reflecting their stable status.
* Updated all references in the codebase and tests to use the new names,
ensuring consistency throughout.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: dinwwwh

README.md

@@ -177,7 +177,7 @@ This is a quick overview of how to use oRPC. For more details, please refer to t
 
    ```ts
    import { OpenAPIGenerator } from '@orpc/openapi'
-   import { experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
+   import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 
    const generator = new OpenAPIGenerator({
      schemaConverters: [new ZodToJsonSchemaConverter()]

apps/content/docs/openapi/getting-started.md

@@ -171,9 +171,7 @@ Just a small tweak makes your oRPC API OpenAPI-compliant!
 
 ```ts twoslash
 import { OpenAPIGenerator } from '@orpc/openapi'
-import {
-  experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter
-} from '@orpc/zod/zod4'
+import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 import { router } from './shared/planet'
 
 const generator = new OpenAPIGenerator({

apps/content/docs/openapi/openapi-specification.md

@@ -72,7 +72,7 @@ import {
   ZodToJsonSchemaConverter
 } from '@orpc/zod' // <-- zod v3
 import {
-  experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter
+  ZodToJsonSchemaConverter
 } from '@orpc/zod/zod4' // <-- zod v4
 import {
   experimental_ValibotToJsonSchemaConverter as ValibotToJsonSchemaConverter

apps/content/docs/openapi/plugins/openapi-reference.md

@@ -14,9 +14,7 @@ This plugin relies on the [OpenAPI Generator](/docs/openapi/openapi-specificatio
 ## Setup
 
 ```ts
-import {
-  experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter
-} from '@orpc/zod/zod4'
+import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 import { OpenAPIReferencePlugin } from '@orpc/openapi/plugins'
 
 const handler = new OpenAPIHandler(router, {

packages/json-schema/src/smart-coercion-plugin.test.ts

@@ -1,5 +1,5 @@
 import * as z from 'zod'
-import { experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter } from '../../zod/src/zod4'
+import { ZodToJsonSchemaConverter } from '../../zod/src/zod4'
 import { experimental_SmartCoercionPlugin as SmartCoercionPlugin } from './smart-coercion-plugin'
 
 describe('smartCoercionPlugin', () => {

packages/openapi/src/openapi-generator.test.ts

@@ -1,7 +1,7 @@
 import type { AnyContractProcedure } from '@orpc/contract'
 import { eventIterator, oc } from '@orpc/contract'
 import * as z from 'zod'
-import { experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter } from '../../zod/src/zod4'
+import { ZodToJsonSchemaConverter } from '../../zod/src/zod4'
 import { customOpenAPIOperation } from './openapi-custom'
 import { OpenAPIGenerator } from './openapi-generator'
 

packages/zod/README.md

@@ -86,7 +86,7 @@ const Example = z.object({
 
 ```ts
 import { OpenAPIGenerator } from '@orpc/openapi'
-import { experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
+import { ZodToJsonSchemaConverter } from '@orpc/zod/zod4'
 
 const openAPIGenerator = new OpenAPIGenerator({
   schemaConverters: [new ZodToJsonSchemaConverter()],

packages/zod/src/zod4/converter.components.test.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod/v4'
-import { experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter } from './converter'
+import { ZodToJsonSchemaConverter } from './converter'
 
 const User = z.object({
   id: z.string(),

packages/zod/src/zod4/converter.test.ts

@@ -1,7 +1,7 @@
 import * as z from 'zod/v4'
 import * as zm from 'zod/v4-mini'
 import {
-  experimental_ZodToJsonSchemaConverter as ZodToJsonSchemaConverter,
+  ZodToJsonSchemaConverter,
 } from './converter'
 
 describe('zodToJsonSchemaConverter', () => {

packages/zod/src/zod4/converter.ts

@@ -39,7 +39,7 @@ import {
   experimental_JSON_SCHEMA_REGISTRY as JSON_SCHEMA_REGISTRY,
 } from './registries'
 
-export interface experimental_ZodToJsonSchemaConverterOptions {
+export interface ZodToJsonSchemaConverterOptions {
   /**
    * Max depth of lazy type.
    *
@@ -85,15 +85,15 @@ export interface experimental_ZodToJsonSchemaConverterOptions {
   >[]
 }
 
-export class experimental_ZodToJsonSchemaConverter implements ConditionalSchemaConverter {
-  private readonly maxLazyDepth: Exclude<experimental_ZodToJsonSchemaConverterOptions['maxLazyDepth'], undefined>
-  private readonly maxStructureDepth: Exclude<experimental_ZodToJsonSchemaConverterOptions['maxStructureDepth'], undefined>
-  private readonly anyJsonSchema: Exclude<experimental_ZodToJsonSchemaConverterOptions['anyJsonSchema'], undefined>
-  private readonly unsupportedJsonSchema: Exclude<experimental_ZodToJsonSchemaConverterOptions['unsupportedJsonSchema'], undefined>
-  private readonly undefinedJsonSchema: Exclude<experimental_ZodToJsonSchemaConverterOptions['undefinedJsonSchema'], undefined>
-  private readonly interceptors: Exclude<experimental_ZodToJsonSchemaConverterOptions['interceptors'], undefined>
+export class ZodToJsonSchemaConverter implements ConditionalSchemaConverter {
+  private readonly maxLazyDepth: Exclude<ZodToJsonSchemaConverterOptions['maxLazyDepth'], undefined>
+  private readonly maxStructureDepth: Exclude<ZodToJsonSchemaConverterOptions['maxStructureDepth'], undefined>
+  private readonly anyJsonSchema: Exclude<ZodToJsonSchemaConverterOptions['anyJsonSchema'], undefined>
+  private readonly unsupportedJsonSchema: Exclude<ZodToJsonSchemaConverterOptions['unsupportedJsonSchema'], undefined>
+  private readonly undefinedJsonSchema: Exclude<ZodToJsonSchemaConverterOptions['undefinedJsonSchema'], undefined>
+  private readonly interceptors: Exclude<ZodToJsonSchemaConverterOptions['interceptors'], undefined>
 
-  constructor(options: experimental_ZodToJsonSchemaConverterOptions = {}) {
+  constructor(options: ZodToJsonSchemaConverterOptions = {}) {
     this.maxLazyDepth = options.maxLazyDepth ?? 2
     this.maxStructureDepth = options.maxStructureDepth ?? 10
     this.anyJsonSchema = options.anyJsonSchema ?? {}