fix: restore v2-compatible Options type and operation JSDoc in generated hooks

- Import Options from ../requests/sdk.gen instead of ../requests/client;
  the sdk.gen Options is extended with `client` and `meta`, which v2 hooks
  accepted (per-request client override would fail to typecheck otherwise)
- Emit the operation's JSDoc (description and @deprecated) on every
  generated hook, matching v2 output

With this, regenerated output for all 5 example apps is semantically
identical to v2.2.0 — remaining diffs are import statement merging and
blank lines only.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: 7nohe

src/tsmorph/buildMutationHooks.mts

@@ -54,6 +54,8 @@ export function buildUseMutationHook(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [

src/tsmorph/buildQueryHooks.mts

@@ -106,6 +106,8 @@ export function buildUseQueryHook(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [
@@ -137,6 +139,8 @@ export function buildUseSuspenseQueryHook(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [
@@ -196,6 +200,8 @@ export function buildUseInfiniteQueryHook(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [
@@ -240,6 +246,8 @@ export function buildPrefetchFn(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [
@@ -284,6 +292,8 @@ export function buildEnsureQueryDataFn(
 
   return {
     kind: StructureKind.VariableStatement,
+    // Copy the operation's JSDoc (description and @deprecated) from the SDK function
+    leadingTrivia: op.jsDoc ? `${op.jsDoc}\n` : undefined,
     isExported: true,
     declarationKind: VariableDeclarationKind.Const,
     declarations: [

src/tsmorph/projectFactory.mts

@@ -28,15 +28,16 @@ export function createGenerationProject(): Project {
 }
 
 /**
- * Build import structure for client library.
- * In v0.73+, Options type is exported from the generated client file.
+ * Build import structure for the Options type.
+ * sdk.gen re-exports Options extended with `client` and `meta`, which the
+ * base client Options lacks; hooks must accept those properties.
  */
 export function buildClientImport(
   _ctx: GenerationContext,
 ): ImportDeclarationStructure {
   return {
     kind: StructureKind.ImportDeclaration,
-    moduleSpecifier: "../requests/client",
+    moduleSpecifier: "../requests/sdk.gen",
     namedImports: [{ name: "Options", isTypeOnly: true }],
   };
 }