feat: add comprehensive GraphQL debug dashboard with VFS inspection (#42)

* feat: add comprehensive GraphQL debug dashboard

- Add new debug endpoint at /_nitro/graphql/debug
- Display environment, scanned files, and runtime info
- Show resolver exports with color-coded type badges
- Add virtual module inspection
- Implement GraphQL brand colors and professional design
- Support scrollable lists for large resolver counts
- Add JSON API endpoint with ?format=json

Features:
- Color-coded resolver types (query/mutation/type/directive)
- Unique symbols for each resolver type
- Tailwind CSS v4 with custom scrollbars
- GraphQL pink (#E535AB) brand theming
- Responsive grid layouts
- File path listings for schemas and documents

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* feat: display generated virtual module source code in debug dashboard

- Add virtualModules field to debugInfo with generated code
- Create expandable/collapsible details for each virtual module
- Show module statistics (line count, byte size)
- Add copy-to-clipboard functionality for each module
- Color-code modules by type (schemas, resolvers, directives, config)
- Display modules:
  - server-schemas (blue)
  - server-resolvers (GraphQL pink)
  - server-directives (amber)
  - module-config (purple)
  - graphql-config (emerald)

Improvements:
- Users can now inspect generated VFS code at runtime
- Each module shows size and line count
- One-click copy functionality
- Scrollable code blocks with max-height
- Professional color coding matching resolver types

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix: use actual virtual module source code instead of runtime samples

- Fix virtualModules field to use debugInfo.virtualModules (string code)
- Rename runtime sample data to virtualModuleSamples
- Add null check for virtualModules to prevent errors
- Now displays actual generated TypeScript/JavaScript code

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

* fix: resolve TypeScript type errors in virtual modules and debug route

- Add type casting for virtual module generators (as string)
- Add explicit any types for import map parameters
- Fix Promise<string> | string type conflicts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: productdevbook

src/index.ts

@@ -206,43 +206,64 @@ export default defineNitroModule({
       nitro.scanDocuments = docs
 
       // Validate resolver setup and provide helpful diagnostics (only in dev)
-      if (nitro.options.dev && resolvers.length > 0) {
-        const totalExports = resolvers.reduce((sum, r) => sum + r.imports.length, 0)
-        consola.success(`[nitro-graphql] Found ${totalExports} resolver export(s) from ${resolvers.length} file(s)`)
-
-        // Show breakdown by type for better visibility
-        const typeCount = {
-          query: 0,
-          mutation: 0,
-          resolver: 0,
-          type: 0,
-          subscription: 0,
-          directive: 0,
-        }
-        for (const resolver of resolvers) {
-          for (const imp of resolver.imports) {
-            if (imp.type in typeCount) {
-              typeCount[imp.type as keyof typeof typeCount]++
+      if (nitro.options.dev) {
+        consola.box({
+          title: 'Nitro GraphQL',
+          message: [
+            `Framework: ${nitro.options.graphql?.framework || 'Not configured'}`,
+            `Schemas: ${schemas.length}`,
+            `Resolvers: ${resolvers.length}`,
+            `Directives: ${directives.length}`,
+            `Documents: ${docs.length}`,
+            '',
+            'Debug Dashboard: /_nitro/graphql/debug',
+          ].join('\n'),
+          style: {
+            borderColor: 'cyan',
+            borderStyle: 'rounded',
+          },
+        })
+
+        if (resolvers.length > 0) {
+          const totalExports = resolvers.reduce((sum, r) => sum + r.imports.length, 0)
+
+          // Show breakdown by type for better visibility
+          const typeCount = {
+            query: 0,
+            mutation: 0,
+            resolver: 0,
+            type: 0,
+            subscription: 0,
+            directive: 0,
+          }
+          for (const resolver of resolvers) {
+            for (const imp of resolver.imports) {
+              if (imp.type in typeCount) {
+                typeCount[imp.type as keyof typeof typeCount]++
+              }
             }
           }
-        }
 
-        const breakdown: string[] = []
-        if (typeCount.query > 0)
-          breakdown.push(`${typeCount.query} query`)
-        if (typeCount.mutation > 0)
-          breakdown.push(`${typeCount.mutation} mutation`)
-        if (typeCount.resolver > 0)
-          breakdown.push(`${typeCount.resolver} resolver`)
-        if (typeCount.type > 0)
-          breakdown.push(`${typeCount.type} type`)
-        if (typeCount.subscription > 0)
-          breakdown.push(`${typeCount.subscription} subscription`)
-        if (typeCount.directive > 0)
-          breakdown.push(`${typeCount.directive} directive`)
-
-        if (breakdown.length > 0) {
-          consola.info(`[nitro-graphql] Resolver breakdown: ${breakdown.join(', ')}`)
+          const breakdown: string[] = []
+          if (typeCount.query > 0)
+            breakdown.push(`${typeCount.query} query`)
+          if (typeCount.mutation > 0)
+            breakdown.push(`${typeCount.mutation} mutation`)
+          if (typeCount.resolver > 0)
+            breakdown.push(`${typeCount.resolver} resolver`)
+          if (typeCount.type > 0)
+            breakdown.push(`${typeCount.type} type`)
+          if (typeCount.subscription > 0)
+            breakdown.push(`${typeCount.subscription} subscription`)
+          if (typeCount.directive > 0)
+            breakdown.push(`${typeCount.directive} directive`)
+
+          if (breakdown.length > 0) {
+            consola.success(`[nitro-graphql] ${totalExports} resolver export(s): ${breakdown.join(', ')}`)
+          }
+        }
+        else {
+          consola.warn('[nitro-graphql] No resolvers found. Check /_nitro/graphql/debug for details.')
         }
       }
     })
@@ -292,6 +313,16 @@ export default defineNitroModule({
       method: 'get',
     })
 
+    // Debug endpoint (development only)
+    if (nitro.options.dev) {
+      nitro.options.handlers.push({
+        route: '/_nitro/graphql/debug',
+        handler: join(runtime, 'debug'),
+        method: 'get',
+      })
+      consola.info('[nitro-graphql] Debug dashboard available at: /_nitro/graphql/debug')
+    }
+
     // Auto-import utilities
     if (nitro.options.imports) {
       nitro.options.imports.presets ??= []