feat: support comment propagation from GraphQL to Zod describe

[CemYil03]

Summary

• Adds a new withDescriptions config option for zod and zodv4 schemas
• When enabled, GraphQL description comments (triple-quote """...""") are passed through to Zod's .describe() method on both field-level and type-level schemas
• Includes escaping for special characters (backslashes, single quotes, newlines)

Motivation

Zod's .describe() metadata is used by tools like Vercel's AI SDK to give LLMs context about each field when schemas are provided as tool inputs. Without this, AI models have no semantic understanding of what each field represents. This makes the plugin AI-ready by bridging GraphQL's rich type documentation into the generated validation schemas.

Example

"""A user input"""
input UserInput {
    """The user's name"""
    name: String!
}

generates:

export function UserInputSchema(): z.ZodObject<Properties<UserInput>> {
    return z.object({
        name: z.string().describe('The user\'s name')
    }).describe('A user input')
}

Test plan

• Added tests for field-level descriptions, type-level descriptions, combined, disabled (false), special character escaping, and object types with withObjectType
• Tests added for both zod and zodv4 visitors
• TypeScript compilation passes with zero errors

[CemYil03]

@Code-Hex @MH4GF @simonljus @elijaholmos could any of you find a few minutes for a code review please 😊

[jbhurruth]

Looks great. I would love this feature to get in soon if my review means anything

[Code-Hex]

Closing this because the main part of the feature is now on main through #1423. withDescriptions: true emits Zod/Zod v4 field .describe(...) calls now, with tests and README coverage.

Your PR also covered type-level .describe(...) on the generated object schema. That did not land in #1423, and I do not want to pretend it did. I split that remaining piece into #1429 so it can be handled as a smaller follow-up instead of keeping this stale PR open.

Appreciate the patch. It helped clarify the shape of the feature.