chore: update documentation and configuration examples to use the official Petstore API URL for consistency across guides

Author: hairyf

docs/.config/docs.yaml

@@ -1,5 +1,9 @@
 # yaml-language-server: $schema=https://unpkg.com/undocs/schema/config.json
 
+# 保留 server API（playground /api/generate），否则静态构建会返回 405
+nitro:
+  static: false
+
 name: genapi
 shortDescription: Lightweight API code generator—only the code you need, nothing extra.
 description: A lightweight API code generator that generates only the code you want from OpenAPI and other specs, with no bloat.

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

@@ -14,10 +14,9 @@ Or install dependencies manually:
 
 Running init starts an interactive wizard:
 
-1. **Choose Preset**: axios, fetch, ky, got, ofetch, TanStack React Query, TanStack Vue Query, Pinia Colada, Uni
-2. **Choose output mode**: TS, JS, or Schema (only fetch and ofetch support Schema; TanStack Query and Colada are TS-only)
-3. **Overwrite confirmation**: If config exists, you'll be asked whether to overwrite
-4. **Dependency installation**: Option to install dependencies now or later
+1. **Choose Preset**: fetch, ofetch, axios, ky, got, @tanstack/react-query, @tanstack/vue-query, @pinia/colada, @uni-helper/uni-network
+3. **Overwrite confirmation**: If `genapi.config.ts` already exists, you'll be asked whether to overwrite
+4. **Dependencies**: `@genapi/core` and `@genapi/presets` are installed automatically; Schema mode also adds `fetchdts`
 
 This creates `genapi.config.ts` or `genapi.config.js` in the project root. Then update `input` to your API doc URL.
 
@@ -32,14 +31,14 @@ import { axios } from '@genapi/presets'
 export default defineConfig({
   // preset: pipeline object (e.g. axios.ts) or string (e.g. 'swag-axios-ts')
   preset: axios.ts,
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: {
     main: 'src/api/index.ts',
     type: 'src/api/index.type.ts',
   },
   meta: {
     baseURL: 'import.meta.env.VITE_APP_BASE_API',
-    responseType: 'T extends { data?: infer V } ? V : void',
+    // responseType: 'T extends { data?: infer V } ? V : void',
   },
 })
 ```

docs/1.guide/1.index.md

@@ -18,7 +18,7 @@ import { axios } from '@genapi/presets'
 
 export default defineConfig({
   preset: axios.ts,
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: {
     main: 'src/api/index.ts',
     type: 'src/api/index.type.ts',
@@ -35,12 +35,12 @@ Preset configuration that defines how APIs are generated. You can use either a *
 **Pipeline object (recommended):**
 
 ```ts
-import { axios, tanstackQuery, colada } from '@genapi/presets'
+import { axios, tanstackQuery } from '@genapi/presets'
 
 preset: axios.ts   // or axios.js
 preset: tanstackQuery.react
 preset: tanstackQuery.vue
-preset: colada     // or tanstackQuery.colada
+preset: tanstackQuery.colada
 ```
 
 **Preset string** (default is `'swag-axios-ts'`):
@@ -50,7 +50,7 @@ preset: colada     // or tanstackQuery.colada
 
 **HTTP clients (.ts / .js):** axios, fetch, ky, got, ofetch, uni
 
-**Data layer (TypeScript only):** tanstackQuery.react, tanstackQuery.vue, colada
+**Data layer (TypeScript only):** tanstackQuery.react, tanstackQuery.vue, tanstackQuery.colada
 
 ### input
 

docs/1.guide/2.configuration.md

@@ -97,7 +97,7 @@ import { tanstackQuery } from '@genapi/presets'
 
 export default defineConfig({
   preset: tanstackQuery.react,
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: { main: 'src/api/index.ts' },
 })
 ```
@@ -125,7 +125,7 @@ import { tanstackQuery } from '@genapi/presets'
 
 export default defineConfig({
   preset: tanstackQuery.vue,
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: { main: 'src/api/index.ts' },
 })
 ```
@@ -134,24 +134,13 @@ export default defineConfig({
 
 Uses [@pinia/colada](https://pinia-colada.esm.dev/) for type-safe query/mutation with Vue + Pinia (API: `key` + `query` / `mutation`):
 
-```ts
-import { colada } from '@genapi/presets'
-
-export default defineConfig({
-  preset: colada,
-  input: 'http://example.com/api-docs',
-  output: { main: 'src/api/index.ts' },
-})
-```
-
-Or use from the tanstack namespace:
-
 ```ts
 import { tanstackQuery } from '@genapi/presets'
 
 export default defineConfig({
   preset: tanstackQuery.colada,
-  // ...
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
+  output: { main: 'src/api/index.ts' },
 })
 ```
 
@@ -185,7 +174,7 @@ export function usePostPets() {
 | UniApp | `uni.ts` |
 | React + server state | `tanstackQuery.react` |
 | Vue + server state | `tanstackQuery.vue` |
-| Vue + Pinia data layer | `colada` or `tanstackQuery.colada` |
+| Vue + Pinia data layer | `tanstackQuery.colada` |
 
 ## Next Steps
 

docs/1.guide/3.presets.md

@@ -14,7 +14,7 @@ import { defineConfig } from '@genapi/core'
 
 ### @genapi/presets
 
-Presets package: HTTP client and data-layer pipelines (axios, fetch, ky, got, ofetch, uni, tanstackQuery, colada).
+Presets package: HTTP client and data-layer pipelines (axios, fetch, ky, got, ofetch, uni, tanstackQuery with react/vue/colada).
 
 ```ts
 import { axios, fetch, tanstackQuery } from '@genapi/presets'
@@ -63,7 +63,7 @@ import type { ApiPipeline } from '@genapi/shared'
 
 const config: ApiPipeline.Config = {
   preset: 'swag-axios-ts', // or a pipeline function, e.g. axios.ts
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: { main: 'src/api/index.ts', type: 'src/api/index.type.ts' },
   meta: {},
   patch: {},

docs/2.api/1.index.md

@@ -79,7 +79,7 @@ Defines GenAPI config for `genapi.config.ts` / `genapi.config.js`. Supports sing
 ```ts
 export default defineConfig({
   preset: axios.ts,
-  input: 'http://example.com/api-docs',
+  input: 'https://petstore3.swagger.io/api/v3/openapi.json',
   output: { main: 'src/api/index.ts', type: 'src/api/index.type.ts' },
 })
 ```

packages/core/README.md

@@ -25,7 +25,7 @@ const PRESETS: Record<string, PresetConfig> = {
   // 框架集成：通常有固定模式，且仅支持 TS
   'react-query': { label: '@tanstack/react-query', pkg: 'tanstackQuery', fixedMode: 'react', features: ['ts'] },
   'vue-query': { label: '@tanstack/vue-query', pkg: 'tanstackQuery', fixedMode: 'vue', features: ['ts'] },
-  'colada': { label: '@pinia/colada', pkg: 'colada', features: ['ts'] },
+  'colada': { label: '@pinia/colada', pkg: 'tanstackQuery', fixedMode: 'colada', features: ['ts'] },
   'uni-network': { label: '@uni-helper/uni-network', pkg: 'uni', features: ['ts', 'js'] },
 }
 

packages/core/src/cli/init.ts

@@ -10,7 +10,7 @@ import type { ApiPipeline } from '@genapi/shared'
  * ```ts
  * export default defineConfig({
  *   preset: axios.ts,
- *   input: 'http://example.com/api-docs',
+ *   input: 'https://petstore3.swagger.io/api/v3/openapi.json',
  *   output: { main: 'src/api/index.ts', type: 'src/api/index.type.ts' },
  * })
  * ```

packages/core/src/config/index.ts

@@ -22,7 +22,7 @@ export {
  * @example
  * ```ts
  * import presets from '@genapi/presets'
- * // presets.axios, presets.fetch, presets.ofetch, presets.tanstackQuery, presets.uni, presets.colada
+ * // presets.axios, presets.fetch, presets.ofetch, presets.tanstackQuery, presets.uni; colada: presets.tanstackQuery.colada
  * ```
  */
 export default {