docs: update Valibot plugin page

Author: mrlubos

docs/.vitepress/config/en.ts

@@ -94,6 +94,10 @@ export default defineConfig({
           {
             collapsed: true,
             items: [
+              {
+                link: '/openapi-ts/plugins/valibot',
+                text: 'Valibot',
+              },
               {
                 link: '/openapi-ts/plugins/zod',
                 text: 'Zod',
@@ -118,10 +122,6 @@ export default defineConfig({
                 link: '/openapi-ts/plugins/typebox',
                 text: 'TypeBox <span data-soon>soon</span>',
               },
-              {
-                link: '/openapi-ts/plugins/valibot',
-                text: 'Valibot <span data-soon>soon</span>',
-              },
               {
                 link: '/openapi-ts/plugins/yup',
                 text: 'Yup <span data-soon>soon</span>',

docs/openapi-ts/plugins.md

@@ -26,6 +26,7 @@ These plugins help reduce boilerplate associated with third-party dependencies.
 - [`@tanstack/svelte-query`](/openapi-ts/plugins/tanstack-query)
 - [`@tanstack/vue-query`](/openapi-ts/plugins/tanstack-query)
 - [`fastify`](/openapi-ts/plugins/fastify)
+- [`valibot`](/openapi-ts/plugins/valibot)
 - [`zod`](/openapi-ts/plugins/zod)
 
 ## Upcoming
@@ -47,7 +48,6 @@ The following plugins are planned but not in development yet. You can help us pr
 - [Supertest](/openapi-ts/plugins/supertest) <span data-soon>Soon</span>
 - [SWR](/openapi-ts/plugins/swr) <span data-soon>Soon</span>
 - [TypeBox](/openapi-ts/plugins/typebox) <span data-soon>Soon</span>
-- [Valibot](/openapi-ts/plugins/valibot) <span data-soon>Soon</span>
 - [Yup](/openapi-ts/plugins/yup) <span data-soon>Soon</span>
 - [Zustand](/openapi-ts/plugins/zustand) <span data-soon>Soon</span>
 

docs/openapi-ts/plugins/valibot.md

@@ -3,14 +3,74 @@ title: Valibot
 description: Valibot plugin for Hey API. Compatible with all our features.
 ---
 
-# Valibot <span data-soon>soon</span>
+# Valibot
 
 ::: warning
-This feature isn't in development yet. Help us prioritize it by voting on [GitHub](https://github.com/hey-api/openapi-ts/issues/1474).
+This feature is in development! :tada: Try it out and provide feedback on [GitHub](https://github.com/hey-api/openapi-ts/issues/1474).
 :::
 
 ### About
 
 [Valibot](https://valibot.dev) is the open source schema library for TypeScript with bundle size, type safety and developer experience in mind.
 
+<!-- ### Demo
+
+<button class="buttonLink" @click="(event) => embedProject('hey-api-client-fetch-plugin-valibot-example')(event)">
+Launch demo
+</button> -->
+
+## Features
+
+- seamless integration with `@hey-api/openapi-ts` ecosystem
+- Valibot schemas for requests, responses, and reusable components
+
+## Installation
+
+In your [configuration](/openapi-ts/get-started), add `valibot` to your plugins and you'll be ready to generate Valibot artifacts. :tada:
+
+```js
+import { defaultPlugins } from '@hey-api/openapi-ts';
+
+export default {
+  input: 'https://get.heyapi.dev/hey-api/backend',
+  output: 'src/client',
+  plugins: [
+    ...defaultPlugins,
+    '@hey-api/client-fetch',
+    'valibot', // [!code ++]
+  ],
+};
+```
+
+## SDKs
+
+To automatically validate response data in your SDKs, set `sdk.validator` to `true`.
+
+```js
+import { defaultPlugins } from '@hey-api/openapi-ts';
+
+export default {
+  input: 'https://get.heyapi.dev/hey-api/backend',
+  output: 'src/client',
+  plugins: [
+    ...defaultPlugins,
+    '@hey-api/client-fetch',
+    'valibot',
+    {
+      name: '@hey-api/sdk', // [!code ++]
+      validator: true, // [!code ++]
+    },
+  ],
+};
+```
+
+## Output
+
+The Valibot plugin will generate the following artifacts, depending on the input specification.
+
+## Schemas
+
+More information will be provided as we finalize the plugin.
+
+<!--@include: ../../examples.md-->
 <!--@include: ../../sponsors.md-->

docs/openapi-ts/validators.md

@@ -13,12 +13,12 @@ Whatever your reason to use validators might be, you can rest assured that you'r
 
 Hey API natively supports the following validators.
 
+- [Valibot](/openapi-ts/plugins/valibot)
 - [Zod](/openapi-ts/plugins/zod)
 - [Ajv](/openapi-ts/plugins/ajv) <span data-soon>Soon</span>
 - [Arktype](/openapi-ts/plugins/arktype) <span data-soon>Soon</span>
 - [Joi](/openapi-ts/plugins/joi) <span data-soon>Soon</span>
 - [TypeBox](/openapi-ts/plugins/typebox) <span data-soon>Soon</span>
-- [Valibot](/openapi-ts/plugins/valibot) <span data-soon>Soon</span>
 - [Yup](/openapi-ts/plugins/yup) <span data-soon>Soon</span>
 
 Don't see your validator? Let us know your interest by [opening an issue](https://github.com/hey-api/openapi-ts/issues).