docs: unplugin docs

docs/.vitepress/config.ts

@@ -182,6 +182,17 @@ const pluginsSidebar = [
       },
     ],
   },
+  {
+    text: 'Build plugins',
+    collapsed: false,
+    items: [
+      {
+        text: 'unplugin-kubb <span class="new">new</span>',
+        collapsed: false,
+        link: '/plugins/unplugin/',
+      },
+    ],
+  },
   {
     text: 'Swagger plugins',
     collapsed: false,
@@ -370,6 +381,17 @@ const pluginsMenu = [
       },
     ],
   },
+  {
+    text: 'Build plugins',
+    collapsed: false,
+    items: [
+      {
+        text: 'unplugin-kubb',
+        collapsed: false,
+        link: '/plugins/unplugin/',
+      },
+    ],
+  },
   {
     text: 'Swagger plugins',
     items: [

docs/plugins/unplugin/index.md

@@ -0,0 +1,186 @@
+---
+layout: doc
+
+title: unplugin-kubb
+outline: deep
+---
+
+# unplugin-kubb <a href="https://paka.dev/npm/unplugin-kubb@latest/api">🦙</a>
+
+Kubb plugin for Vite, Webpack, Esbuild, Rollup, Nuxt, Astro and Rspack.
+
+## Installation
+
+::: code-group
+
+```shell [bun <img src="/feature/bun.svg"/>]
+bun add unplugin-kubb @kubb/core
+```
+
+```shell [pnpm <img src="/feature/pnpm.svg"/>]
+pnpm add unplugin-kubb @kubb/core
+```
+
+```shell [npm <img src="/feature/npm.svg"/>]
+npm install unplugin-kubb @kubb/core
+```
+
+```shell [yarn <img src="/feature/yarn.svg"/>]
+yarn add unplugin-kubb @kubb/core
+```
+
+:::
+
+## Options
+
+### config
+
+Define the options for Kubb.
+
+::: info type
+
+```typescript [Options]
+type Options = {
+  config: UserConfig
+}
+```
+
+:::
+
+::: info
+
+Type: `Options` <br/>
+
+::: code-group
+
+```typescript [kubb.config.ts]
+import { defineConfig } from '@kubb/core'
+import createSwagger from '@kubb/swagger'
+import createSwaggerTanstackQuery from '@kubb/swagger-tanstack-query'
+import createSwaggerTS from '@kubb/swagger-ts'
+
+/** @type {import('@kubb/core').UserConfig} */
+export const config = {
+  root: '.',
+  input: {
+    path: './petStore.yaml',
+  },
+  output: {
+    path: './src/gen',
+    clean: true,
+  },
+  plugins: [
+    createSwagger({ output: false }),
+    createSwaggerTS({
+      output: {
+        path: 'models',
+      },
+    }),
+  ],
+}
+```
+
+```typescript [vite.config.ts]
+import react from '@vitejs/plugin-react'
+import kubb from 'unplugin-kubb/vite'
+import { defineConfig } from 'vite'
+import { config } from './kubb.config'
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    react(),
+    kubb({
+      config,
+    }),
+  ],
+})
+```
+
+:::
+
+## Examples
+
+### Vite
+
+```ts
+// vite.config.ts
+import Plugin from 'unplugin-kubb/vite'
+
+export default defineConfig({
+  plugins: [
+    Plugin({/* options */}),
+  ],
+})
+```
+
+### Rollup
+
+```ts
+// rollup.config.js
+import Plugin from 'unplugin-kubb/rollup'
+
+export default {
+  plugins: [
+    Plugin({/* options */}),
+  ],
+}
+```
+
+### Webpack
+
+```ts
+// webpack.config.js
+module.exports = {
+  /* ... */
+  plugins: [
+    require('unplugin-kubb/webpack')({/* options */}),
+  ],
+}
+```
+
+### Nuxt
+
+```ts
+// nuxt.config.js
+export default defineNuxtConfig({
+  modules: [
+    ['unplugin-kubb/nuxt', {/* options */}],
+  ],
+})
+```
+
+> This module works for both Nuxt 2 and [Nuxt Vite](https://github.com/nuxt/vite)
+
+### Vue CLI
+
+```ts
+// vue.config.js
+module.exports = {
+  configureWebpack: {
+    plugins: [
+      require('unplugin-kubb/webpack')({/* options */}),
+    ],
+  },
+}
+```
+
+### Esbuild
+
+```ts
+// esbuild.config.js
+import { build } from 'esbuild'
+import Plugin from 'unplugin-kubb/esbuild'
+
+build({
+  plugins: [Plugin()],
+})
+```
+
+## Depended
+
+- [`@kubb/core`](/plugins/core/)
+
+## Links
+
+- [Vite](https://vitejs.dev/)

packages/config/eslint-config/package.json

@@ -45,20 +45,20 @@
   "dependencies": {
     "@eslint/js": "^8.56.0",
     "@types/eslint": "~8.56.2",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "~6.15.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.1",
+    "@typescript-eslint/parser": "~7.0.1",
     "eslint-config-prettier": "~9.1.0",
     "eslint-config-turbo": "^1.12.4",
     "eslint-formatter-pretty": "^6.0.1",
     "eslint-plugin-eslint-plugin": "^5.3.0",
     "eslint-plugin-import": "~2.29.1",
     "eslint-plugin-react": "~7.33.2",
-    "eslint-plugin-simple-import-sort": "^10.0.0",
+    "eslint-plugin-simple-import-sort": "^12.0.0",
     "eslint-plugin-turbo": "^1.12.4",
-    "eslint-plugin-unused-imports": "~3.0.0",
+    "eslint-plugin-unused-imports": "~3.1.0",
     "eslint-plugin-vitest": "~0.3.22",
     "eslint-plugin-vitest-globals": "~1.4.0",
-    "globals": "^13.24.0"
+    "globals": "^14.0.0"
   },
   "devDependencies": {
     "@kubb/ts-config": "workspace:*",

packages/config/tsup-config/package.json

@@ -44,7 +44,7 @@
     "tsup": "^8.0.2"
   },
   "peerDependencies": {
-    "tsup": "^8.0.1"
+    "tsup": "^8.0.2"
   },
   "packageManager": "[email protected]",
   "engines": {

packages/unplugin/README.md

@@ -4,7 +4,7 @@
 <h1>unplugin-kubb</h1>
 
 <p>
-   Kubb plugin for Vite, webpack, esbuild, Rollup, Nuxt, Astro and Rspack.
+   Kubb plugin for Vite, Webpack, Esbuild, Rollup, Nuxt, Astro and Rspack.
   </p>
   <img src="https://raw.githubusercontent.com/kubb-project/kubb/main/assets/banner.png" alt="logo"  height="auto" />
 
@@ -48,8 +48,6 @@ export default defineConfig({
 })
 ```
 
-Example: [`playground/`](./playground/)
-
 <br></details>
 
 <details>
@@ -130,6 +128,20 @@ build({
 
 <br></details>
 
+## Options
+
+### config
+
+Define the options for Kubb.
+
+::: info type
+
+```typescript [Options]
+type Options = {
+  config: UserConfig
+}
+```
+
 <!-- Badges -->
 
 [npm-version-src]: https://img.shields.io/npm/v/unplugin-kubb?flat&colorA=18181B&colorB=f58517