docs: update documentation for hey-api 0.92.3 plugins system

- Map CLI options (--enums, --noOperationId, --noSchemas, --schemaType)
  to the new @hey-api/openapi-ts plugins API in generate.mts
- Mark --useDateType and --debug as deprecated (no equivalent in new API)
- Update introduction.mdx with new output directory structure
  (sdk.gen.ts, client.gen.ts, client/, core/)
- Update cli-options.mdx with accurate option descriptions
- Update usage.mdx to mention sdk.gen.ts and services.gen.ts shim

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: TakehiroTada

docs/src/content/docs/guides/cli-options.mdx

@@ -27,9 +27,9 @@ Initial page value to infinite query. The default value is `1`.
 
 ## Client Options
 
-Due to the generated clients (Under the `openapi/requests` directory) being based on Hey API, you can pass some options to the Hey API client generator.
+The generated clients (under the `openapi/requests` directory) are produced by `@hey-api/openapi-ts` using its plugins system. The CLI options below are mapped to the corresponding plugin configurations.
 
-You can find what options are passed to the Hey API client generator in the [generate](https://github.com/7nohe/openapi-react-query-codegen/blob/main/src/generate.mts) function.
+You can see the current configuration in the [generate](https://github.com/7nohe/openapi-react-query-codegen/blob/main/src/generate.mts) function.
 
 ### -c, --client \<value\>
 
@@ -43,15 +43,15 @@ More details about the clients can be found in [Hey API Documentation](https://h
 
 ### --format \<value\>
 
-Process output folder with formatter? The default value is `false`.
+Process the generated queries output folder (`openapi/queries`) with a formatter. The `openapi/requests` directory generated by `@hey-api/openapi-ts` is not affected by this option. The default value is `false`.
 The available options are:
 
 - `biome`
 - `prettier`
 
 ### --lint \<value\>
 
-Process output folder with linter? The default value is `false`.
+Process the generated queries output folder (`openapi/queries`) with a linter. The `openapi/requests` directory generated by `@hey-api/openapi-ts` is not affected by this option. The default value is `false`.
 The available options are:
 
 - `biome`
@@ -71,10 +71,14 @@ The available options are:
 
 ### --useDateType
 
+> **Deprecated:** This option is currently accepted but has no effect. It will be removed in a future version.
+
 Use Date type instead of string for date. The default value is `false`.
 
 ### --debug
 
+> **Deprecated:** This option is currently accepted but has no effect. It will be removed in a future version.
+
 Run in debug mode? The default value is `false`.
 
 ### --noSchemas
@@ -83,7 +87,7 @@ Disable generating JSON schemas. The default value is `false`.
 
 ### --schemaTypes \<value\>
 
-Type of JSON schema. The default value is `json`.
+Type of JSON schema. Only applies when `--noSchemas` is not set. The default value is `json`.
 The available options are:
 
 - `json`

docs/src/content/docs/guides/introduction.mdx

@@ -77,8 +77,11 @@ openapi/
 │   ├── queries.ts
 │   └── suspense.ts
 └── requests
+    ├── client/
+    ├── core/
+    ├── client.gen.ts
     ├── index.ts
-    ├── schemas.gen.ts
+    ├── sdk.gen.ts
     ├── services.gen.ts
     └── types.gen.ts
 ```
@@ -107,6 +110,7 @@ import React from "react";
 import ReactDOM from "react-dom/client";
 import App from "./App";
 import { QueryClientProvider, QueryClient } from "@tanstack/react-query";
+// services.gen.ts is a backward-compatibility shim that re-exports from client.gen and sdk.gen
 import { client } from "../openapi/requests/services.gen";
 
 client.setConfig({
@@ -180,6 +184,13 @@ export default App;
     - suspenses.ts Generated suspense hooks
     - prefetch.ts Generated prefetch functions
   - requests Output code generated by `@hey-api/openapi-ts`
+    - client/ Hey API client implementation (internal)
+    - core/ Hey API core utilities (internal)
+    - client.gen.ts Client instance and configuration
+    - sdk.gen.ts SDK functions (primary service functions)
+    - services.gen.ts Backward-compatibility shim (re-exports from client.gen and sdk.gen)
+    - types.gen.ts Generated TypeScript types
+    - index.ts Barrel file
 
 </FileTree>
 

docs/src/content/docs/guides/usage.mdx

@@ -23,7 +23,7 @@ function App() {
 export default App;
 ```
 
-Optionally, you can also use the pure ts client in `openapi/requests/services.gen.ts` to customize your query.
+Optionally, you can also use the pure TypeScript client to customize your query. The SDK functions are defined in `openapi/requests/sdk.gen.ts` and are also available via the backward-compatible `openapi/requests/services.gen.ts` shim.
 
 ```tsx
 import { useQuery } from "@tanstack/react-query";

src/generate.mts

@@ -15,17 +15,46 @@ export async function generate(options: LimitedUserConfig, version: string) {
   const openApiOutputPath = buildRequestsOutputPath(options.output);
   const formattedOptions = formatOptions(options);
 
-  // Map old client option to new plugins system
+  // Map CLI options to new plugins system
   const clientPlugin =
     formattedOptions.client === "@hey-api/client-axios"
       ? "@hey-api/client-axios"
       : "@hey-api/client-fetch";
-  const plugins: UserConfig["plugins"] = [
+
+  const typescriptPlugin: NonNullable<UserConfig["plugins"]>[number] =
+    formattedOptions.enums
+      ? {
+          name: "@hey-api/typescript" as const,
+          enums: formattedOptions.enums,
+        }
+      : "@hey-api/typescript";
+
+  const sdkPlugin: NonNullable<UserConfig["plugins"]>[number] =
+    formattedOptions.noOperationId
+      ? {
+          name: "@hey-api/sdk" as const,
+          operationId: false,
+        }
+      : "@hey-api/sdk";
+
+  const plugins: NonNullable<UserConfig["plugins"]>[number][] = [
     clientPlugin,
-    "@hey-api/typescript",
-    "@hey-api/sdk",
+    typescriptPlugin,
+    sdkPlugin,
   ];
 
+  // Conditionally add schemas plugin
+  if (!formattedOptions.noSchemas) {
+    plugins.push(
+      formattedOptions.schemaType
+        ? {
+            name: "@hey-api/schemas" as const,
+            type: formattedOptions.schemaType,
+          }
+        : "@hey-api/schemas",
+    );
+  }
+
   const config: UserConfig = {
     dryRun: false,
     input: formattedOptions.input,