feat: add documentation and configuration for new docs package, enhance ESLint settings, and update pnpm workspace

Author: hairyf

docs/.config/docs.yaml

@@ -0,0 +1,26 @@
+# yaml-language-server: $schema=https://unpkg.com/undocs/schema/config.json
+
+name: genapi
+shortDescription: API generator that converts OpenAPI (v2~v3) and other input sources into TypeScript/JavaScript APIs
+description: Convert OpenAPI specifications into TypeScript/JavaScript API code with flexible customization options.
+github: hairyf/genapi
+url: 'https://genapi.hairyf.com'
+lang: en
+themeColor: green
+landing:
+  heroCode: npm i @genapi/core @genapi/presets -D
+  contributors: true
+  features:
+    - title: Multiple HTTP Clients
+      icon: 🚀
+      description: Support for axios, fetch, ky, got, ofetch, uni and more HTTP clients
+    - title: TypeScript/JavaScript
+      icon: 🔄
+      description: Generate both TypeScript and JavaScript API code
+    - title: Flexible & Customizable
+      icon: 🛠️
+      description: Flexible pipeline system for customizing the generation process
+    - title: OpenAPI Support
+      icon: 📋
+      description: Full support for OpenAPI 2.0 and 3.x specifications
+automd: true

docs/.docs/.data/content/contents.sqlite

@@ -0,0 +1,4 @@
+node_modules
+.nuxt
+.output
+dist

docs/.docs/public/icon.svg

@@ -0,0 +1 @@
+icon: i-lucide-book-open

docs/.gitignore

@@ -0,0 +1,55 @@
+# Getting Started
+
+genapi is a powerful API generator that converts OpenAPI (v2~v3) and other input sources into TypeScript/JavaScript APIs.
+
+## Installation
+
+You can install genapi via npm:
+
+:pm-install{name="@genapi/core"}
+
+You also need to install the presets package:
+
+:pm-install{name="@genapi/presets"}
+
+## Basic Usage
+
+Create a configuration file `genapi.config.ts` in your project root:
+
+```ts
+import { defineConfig } from '@genapi/core'
+import { axios } from '@genapi/presets'
+
+export default defineConfig({
+  preset: axios.ts,
+  // your input source (swagger api url or json)
+  input: 'http://example.com/api-docs',
+  output: {
+    main: 'src/api/index.ts',
+    type: 'src/api/index.type.ts',
+  },
+  meta: {
+    // your API baseUrl
+    baseURL: 'import.meta.env.VITE_APP_BASE_API',
+    // customize the output response type. default 'T'
+    responseType: 'T extends { data?: infer V } ? V : void',
+  },
+})
+```
+
+Then run:
+
+```bash
+npm run genapi
+```
+
+## Features
+
+- 🚀 **Multiple HTTP Clients** - Support for axios、fetch、ky、got、ofetch、uni and more
+- 🔄 **Language Support** - Generate both TypeScript and JavaScript APIs
+- 🛠️ **Customizable** - Flexible pipeline system for customizing the generation process
+- 📋 **OpenAPI Support** - Full support for OpenAPI 2.0 and 3.x specifications
+
+## Next Steps
+
+Check out the [Configuration Guide](/en/guide/configuration) to learn more about configuration options.

docs/1.guide/.navigation.yml

@@ -0,0 +1,178 @@
+# Configuration
+
+genapi defines API generation behavior through configuration files. Configuration files support TypeScript, JavaScript, or JSON formats.
+
+## Configuration File
+
+Create one of the following configuration files in your project root:
+
+- `genapi.config.ts`
+- `genapi.config.js`
+- `genapi.config.json`
+
+## Basic Configuration
+
+```ts
+import { defineConfig } from '@genapi/core'
+import { axios } from '@genapi/presets'
+
+export default defineConfig({
+  preset: axios.ts,
+  input: 'http://example.com/api-docs',
+  output: {
+    main: 'src/api/index.ts',
+    type: 'src/api/index.type.ts',
+  },
+})
+```
+
+## Configuration Options
+
+### preset
+
+Preset configuration that defines how APIs are generated. genapi provides multiple presets:
+
+- `axios.ts` / `axios.js` - Use axios client
+- `fetch.ts` / `fetch.js` - Use native fetch API
+- `ky.ts` / `ky.js` - Use ky client
+- `got.ts` / `got.js` - Use got client
+- `ofetch.ts` / `ofetch.js` - Use ofetch client
+- `uni.ts` / `uni.js` - Use uni-app network request library
+
+### input
+
+Input source, which can be:
+
+- **URL string**: Directly pass in the API documentation URL
+  ```ts
+  input: 'http://example.com/api-docs'
+  ```
+
+- **Object**: Contains `uri` or `json` field
+  ```ts
+  input: {
+    uri: 'http://example.com/api-docs'
+  }
+  // or
+  input: {
+    json: { /* OpenAPI JSON object */ }
+  }
+  ```
+
+### output
+
+Output configuration, defines the generated file paths:
+
+```ts
+output: {
+  main: 'src/api/index.ts',      // Main file path
+  type: 'src/api/index.type.ts', // Type definition file path (optional)
+}
+```
+
+### meta
+
+Metadata configuration for customizing generated code:
+
+```ts
+meta: {
+  // API base URL
+  baseURL: 'import.meta.env.VITE_APP_BASE_API',
+  // Custom response type transformation
+  responseType: 'T extends { data?: infer V } ? V : void',
+}
+```
+
+## Multiple Services
+
+For projects with multiple services, use the `servers` configuration:
+
+```ts
+export default defineConfig({
+  // All servers inherit the upper layer configuration
+  meta: {
+    baseURL: 'https://example.com/api',
+  },
+  servers: [
+    {
+      input: 'http://service1/api-docs',
+      output: { main: 'src/api/service1.ts' }
+    },
+    {
+      input: 'http://service2/api-docs',
+      output: { main: 'src/api/service2.ts' }
+    },
+  ]
+})
+```
+
+## Patch - Static Patches
+
+Make exact-match modifications to operations and type definitions:
+
+```ts
+export default defineConfig({
+  preset: axios.ts,
+  input: 'https://petstore.swagger.io/v2/swagger.json',
+  patch: {
+    operations: {
+      // Rename function
+      postUpdateUserUsingPOST: 'updateUserInfo',
+      // Modify parameters and return type
+      getUserUsingGET: {
+        name: 'getUser',
+        parameters: [{ name: 'id', type: 'string', required: true }],
+        responseType: 'UserResponse'
+      }
+    },
+    definitions: {
+      // Rename type
+      UserDto: 'User',
+      // Override type (creates type alias)
+      SessionDto: {
+        name: 'Session',
+        type: '{ name: string, age: number }'
+      }
+    }
+  }
+})
+```
+
+## Transform - Global Transformations
+
+Batch transform operations and type definitions via functions:
+
+```ts
+export default defineConfig({
+  preset: axios.ts,
+  input: 'https://petstore.swagger.io/v2/swagger.json',
+  transform: {
+    operation: name => `api_${name}`, // Batch add prefix
+    definition: name => name.endsWith('Dto') ? name.slice(0, -3) : name
+  },
+  patch: {
+    // transform executes first, patch executes after
+    operations: { api_getUser: 'fetchUser' }
+  }
+})
+```
+
+## MockJS - Mock Data Generation
+
+Automatically generate mock methods for each API function (requires `better-mock`):
+
+```ts
+export default defineConfig({
+  preset: axios.ts,
+  input: 'https://petstore.swagger.io/v2/swagger.json',
+  mockjs: true,
+})
+```
+
+Usage:
+
+```ts
+import { getUser } from './api'
+
+const mockUser = getUser.mock() // Returns mock data conforming to type definitions
+```

docs/1.guide/1.index.md

@@ -0,0 +1,101 @@
+# Presets
+
+genapi provides multiple preset configurations supporting different HTTP clients and languages.
+
+## Available Presets
+
+### axios
+
+Use the popular axios HTTP client:
+
+```ts
+import { axios } from '@genapi/presets'
+
+export default defineConfig({
+  preset: axios.ts, // TypeScript
+  // or
+  preset: axios.js, // JavaScript
+})
+```
+
+### fetch
+
+Use the native browser fetch API:
+
+```ts
+import { fetch } from '@genapi/presets'
+
+export default defineConfig({
+  preset: fetch.ts,
+  // or
+  preset: fetch.js,
+})
+```
+
+### ky
+
+Use the tiny and elegant ky HTTP client:
+
+```ts
+import { ky } from '@genapi/presets'
+
+export default defineConfig({
+  preset: ky.ts,
+  // or
+  preset: ky.js,
+})
+```
+
+### got
+
+Use the human-friendly got HTTP request library:
+
+```ts
+import { got } from '@genapi/presets'
+
+export default defineConfig({
+  preset: got.ts,
+  // or
+  preset: got.js,
+})
+```
+
+### ofetch
+
+Use a better fetch API with TypeScript support:
+
+```ts
+import { ofetch } from '@genapi/presets'
+
+export default defineConfig({
+  preset: ofetch.ts,
+  // or
+  preset: ofetch.js,
+})
+```
+
+### uni
+
+Use `@uni-helper/uni-network` uniapp network request library:
+
+```ts
+import { uni } from '@genapi/presets'
+
+export default defineConfig({
+  preset: uni.ts,
+  // or
+  preset: uni.js,
+})
+```
+
+## TypeScript vs JavaScript
+
+- **TypeScript presets** (`*.ts`): Generate TypeScript code with complete type definitions
+- **JavaScript presets** (`*.js`): Generate JavaScript code with corresponding type definition files (`.d.ts`)
+
+## Recommendations
+
+- **Web projects**: Recommended to use `axios.ts` or `fetch.ts`
+- **Node.js projects**: Recommended to use `got.ts` or `ky.ts`
+- **Nuxt/UnJS projects**: Recommended to use `ofetch.ts`
+- **UniApp projects**: Use `uni.ts`