nitro-graphql 2.0.0-beta.7 → 2.0.0-beta.70

package/dist/core/debug/template.mjs

@@ -0,0 +1,383 @@
+//#region src/core/debug/template.ts
+/**
+* Escape HTML special characters
+*/
+function escapeHtml(text) {
+	const map = {
+		"&": "&",
+		"<": "&lt;",
+		">": "&gt;",
+		"\"": "&quot;",
+		"'": "&#039;"
+	};
+	return text.replace(/[&<>"']/g, (m) => map[m] || m);
+}
+/**
+* Type color configuration for resolver exports display
+*/
+const TYPE_CONFIG = {
+	query: {
+		bg: "bg-blue-500/10",
+		text: "text-blue-400",
+		border: "border-blue-500/30",
+		symbol: "◆",
+		label: "query"
+	},
+	mutation: {
+		bg: "bg-[#E535AB]/10",
+		text: "text-[#E535AB]",
+		border: "border-[#E535AB]/30",
+		symbol: "●",
+		label: "mutation"
+	},
+	type: {
+		bg: "bg-purple-500/10",
+		text: "text-purple-400",
+		border: "border-purple-500/30",
+		symbol: "▲",
+		label: "type"
+	},
+	directive: {
+		bg: "bg-amber-500/10",
+		text: "text-amber-400",
+		border: "border-amber-500/30",
+		symbol: "@",
+		label: "directive"
+	},
+	resolver: {
+		bg: "bg-emerald-500/10",
+		text: "text-emerald-400",
+		border: "border-emerald-500/30",
+		symbol: "◉",
+		label: "resolver"
+	},
+	subscription: {
+		bg: "bg-teal-500/10",
+		text: "text-teal-400",
+		border: "border-teal-500/30",
+		symbol: "↻",
+		label: "subscription"
+	}
+};
+/**
+* Module color configuration for virtual modules display
+*/
+const MODULE_COLORS = {
+	"server-schemas": {
+		bg: "bg-blue-500/5",
+		border: "border-blue-500/20",
+		text: "text-blue-400"
+	},
+	"server-resolvers": {
+		bg: "bg-[#E535AB]/5",
+		border: "border-[#E535AB]/20",
+		text: "text-[#E535AB]"
+	},
+	"server-directives": {
+		bg: "bg-amber-500/5",
+		border: "border-amber-500/20",
+		text: "text-amber-400"
+	},
+	"module-config": {
+		bg: "bg-purple-500/5",
+		border: "border-purple-500/20",
+		text: "text-purple-400"
+	},
+	"graphql-config": {
+		bg: "bg-emerald-500/5",
+		border: "border-emerald-500/20",
+		text: "text-emerald-400"
+	}
+};
+/**
+* GraphQL logo SVG
+*/
+const GRAPHQL_LOGO = `<svg class="w-10 h-10" viewBox="0 0 400 400" fill="none">
+  <path d="M57.468 302.66l-14.376-8.3 160.15-277.38 14.376 8.3z" fill="#E535AB"/>
+  <path d="M39.8 272.2h320.3v16.6H39.8z" fill="#E535AB"/>
+  <path d="M206.348 374.026l-160.21-92.5 8.3-14.376 160.21 92.5z" fill="#E535AB"/>
+  <path d="M345.522 132.947l-160.21-92.5 8.3-14.376 160.21 92.5z" fill="#E535AB"/>
+  <path d="M54.482 132.883l-8.3-14.375 160.21-92.5 8.3 14.376z" fill="#E535AB"/>
+  <path d="M342.568 302.663l-160.15-277.38 14.376-8.3 160.15 277.38z" fill="#E535AB"/>
+  <path d="M52.5 107.5h16.6v185H52.5z" fill="#E535AB"/>
+  <path d="M330.9 107.5h16.6v185h-16.6z" fill="#E535AB"/>
+  <path d="M203.522 367l-7.25-12.558 139.34-80.45 7.25 12.557z" fill="#E535AB"/>
+  <path d="M369.5 297.9c-9.6 16.7-31 22.4-47.7 12.8-16.7-9.6-22.4-31-12.8-47.7 9.6-16.7 31-22.4 47.7-12.8 16.8 9.7 22.5 31 12.8 47.7M90.9 137c-9.6 16.7-31 22.4-47.7 12.8-16.7-9.6-22.4-31-12.8-47.7 9.6-16.7 31-22.4 47.7-12.8 16.7 9.7 22.4 31 12.8 47.7M30.5 297.9c-9.6-16.7-3.9-38 12.8-47.7 16.7-9.6 38-3.9 47.7 12.8 9.6 16.7 3.9 38-12.8 47.7-16.8 9.6-38.1 3.9-47.7-12.8M309.1 137c-9.6-16.7-3.9-38 12.8-47.7 16.7-9.6 38-3.9 47.7 12.8 9.6 16.7 3.9 38-12.8 47.7-16.7 9.6-38.1 3.9-47.7-12.8M200 395.8c-19.3 0-34.9-15.6-34.9-34.9 0-19.3 15.6-34.9 34.9-34.9 19.3 0 34.9 15.6 34.9 34.9 0 19.2-15.6 34.9-34.9 34.9M200 74c-19.3 0-34.9-15.6-34.9-34.9 0-19.3 15.6-34.9 34.9-34.9 19.3 0 34.9 15.6 34.9 34.9 0 19.3-15.6 34.9-34.9 34.9" fill="#E535AB"/>
+</svg>`;
+/**
+* Render resolver exports section
+*/
+function renderResolverExports(resolverFiles) {
+	if (resolverFiles.length === 0) return "<p class=\"text-slate-500 text-sm\">No resolvers found</p>";
+	return `
+    <div class="max-h-96 overflow-y-auto space-y-2 pr-2">
+      ${resolverFiles.map((r) => {
+		const totalExports = r.exports.length;
+		return `
+          <div class="border border-slate-700/50 rounded-lg p-4 hover:border-[#E535AB]/20 hover:bg-slate-800/30 transition-all">
+            <div class="flex justify-between items-center mb-3">
+              <span class="text-slate-300 font-mono text-xs truncate pr-2">${r.file}</span>
+              <span class="bg-slate-800/80 px-2.5 py-0.5 rounded text-[#E535AB] text-[10px] font-semibold whitespace-nowrap">
+                ${totalExports} export${totalExports !== 1 ? "s" : ""}
+              </span>
+            </div>
+            <div class="flex flex-wrap gap-1.5">
+              ${r.exports.map((e) => {
+			const config = TYPE_CONFIG[e.type] || TYPE_CONFIG.resolver;
+			return `<span class="px-2.5 py-1 rounded border text-[11px] font-mono ${config.bg} ${config.text} ${config.border} hover:scale-105 transition-transform inline-flex items-center gap-1.5">
+                  <span class="font-bold">${config.symbol}</span>
+                  <span class="font-medium">${e.name}</span>
+                  <span class="opacity-60 text-[9px] uppercase tracking-wide">${config.label}</span>
+                </span>`;
+		}).join("")}
+            </div>
+          </div>
+        `;
+	}).join("")}
+    </div>
+  `;
+}
+/**
+* Render virtual modules section
+*/
+function renderVirtualModules(virtualModules) {
+	return Object.entries(virtualModules).map(([moduleName, codeContent]) => {
+		const code = String(codeContent);
+		const colorConfig = MODULE_COLORS[moduleName] || MODULE_COLORS["module-config"];
+		const lineCount = code.split("\n").length;
+		const byteSize = new TextEncoder().encode(code).length;
+		return `
+      <details class="border ${colorConfig.border} ${colorConfig.bg} rounded-lg overflow-hidden group">
+        <summary class="cursor-pointer p-4 hover:bg-slate-800/30 transition-all flex justify-between items-center">
+          <div class="flex items-center gap-3">
+            <span class="${colorConfig.text} text-lg">▸</span>
+            <div>
+              <span class="font-mono text-sm ${colorConfig.text} font-semibold">#nitro-graphql/${moduleName}</span>
+              <div class="text-[10px] text-slate-500 mt-0.5">
+                ${lineCount} lines · ${(byteSize / 1024).toFixed(2)} KB
+              </div>
+            </div>
+          </div>
+          <button
+            onclick="event.stopPropagation(); navigator.clipboard.writeText(this.getAttribute('data-code')); this.textContent = '✓ Copied!'; setTimeout(() => this.textContent = 'Copy', 1000)"
+            data-code="${escapeHtml(code).replace(/"/g, "&quot;")}"
+            class="text-xs px-3 py-1.5 bg-slate-800 hover:bg-slate-700 text-slate-300 rounded border border-slate-600/50 transition-colors"
+          >
+            Copy
+          </button>
+        </summary>
+        <div class="border-t ${colorConfig.border}">
+          <div class="bg-slate-950/80 p-4 max-h-96 overflow-auto">
+            <pre class="text-xs font-mono text-slate-300 leading-relaxed"><code>${escapeHtml(code)}</code></pre>
+          </div>
+        </div>
+      </details>
+    `;
+	}).join("");
+}
+/**
+* Render file list section
+*/
+function renderFileList(files, emptyMessage) {
+	if (files.length === 0) return `<li class="text-slate-500 text-sm">${emptyMessage}</li>`;
+	return files.map((f) => `<li class="text-slate-400 font-mono text-xs flex items-start gap-2 py-1.5 px-2 rounded hover:bg-slate-800/50 transition-colors group">
+      <span class="text-[#E535AB] text-[10px] mt-0.5 group-hover:scale-110 transition-transform">▸</span>
+      <span class="truncate group-hover:text-slate-300">${f}</span>
+    </li>`).join("");
+}
+/**
+* Generate the HTML dashboard for the debug endpoint
+*
+* Used by both Nitro and CLI debug routes.
+*/
+function generateDebugHtml(debugInfo) {
+	return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Nitro GraphQL Debug Dashboard</title>
+  <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"><\/script>
+  <style>
+    @keyframes fadeIn {
+      from { opacity: 0; transform: translateY(10px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+    .animate-fade-in {
+      animation: fadeIn 0.3s ease-out;
+    }
+    /* Custom Scrollbar */
+    ::-webkit-scrollbar {
+      width: 8px;
+      height: 8px;
+    }
+    ::-webkit-scrollbar-track {
+      background: #0f172a;
+      border-radius: 4px;
+    }
+    ::-webkit-scrollbar-thumb {
+      background: #334155;
+      border-radius: 4px;
+    }
+    ::-webkit-scrollbar-thumb:hover {
+      background: #475569;
+    }
+  </style>
+</head>
+<body class="bg-slate-950 text-slate-200 min-h-screen">
+  <div class="container mx-auto max-w-7xl p-6 space-y-6 animate-fade-in">
+    <!-- Header -->
+    <div class="mb-8 border-b border-slate-800 pb-6">
+      <div class="flex items-center gap-3 mb-2">
+        ${GRAPHQL_LOGO}
+        <div>
+          <h1 class="text-3xl font-bold text-slate-100">
+            Nitro GraphQL Debug
+          </h1>
+          <p class="text-sm text-slate-500">Development Diagnostics Dashboard</p>
+        </div>
+      </div>
+    </div>
+
+    <!-- Top Stats Grid -->
+    <div class="grid grid-cols-1 md:grid-cols-3 gap-4">
+      <!-- Environment Card -->
+      <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6 hover:border-[#E535AB]/30 transition-all">
+        <h2 class="text-lg font-semibold mb-4 text-slate-200 flex items-center gap-2">
+          <span class="text-[#E535AB]">●</span> Environment
+        </h2>
+        <div class="space-y-3">
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Mode</span>
+            <span class="text-slate-200 font-medium text-sm">${debugInfo.environment.dev ? "Development" : "Production"}</span>
+          </div>
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Framework</span>
+            <span class="text-slate-200 font-medium text-sm">${debugInfo.environment.framework}</span>
+          </div>
+          <div class="flex justify-between items-center py-2">
+            <span class="text-slate-400 text-sm">GraphQL Server</span>
+            <span class="text-slate-200 font-medium text-sm">${debugInfo.graphql.framework || "Not configured"}</span>
+          </div>
+        </div>
+      </div>
+
+      <!-- Scanned Files Card -->
+      <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6 hover:border-[#E535AB]/30 transition-all">
+        <h2 class="text-lg font-semibold mb-4 text-slate-200 flex items-center gap-2">
+          <span class="text-[#E535AB]">●</span> Scanned Files
+        </h2>
+        <div class="space-y-3">
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Schemas</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.scanned.schemas}</span>
+          </div>
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Resolvers</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.scanned.resolvers}</span>
+          </div>
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Directives</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.scanned.directives}</span>
+          </div>
+          <div class="flex justify-between items-center py-2">
+            <span class="text-slate-400 text-sm">Documents</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.scanned.documents}</span>
+          </div>
+        </div>
+      </div>
+
+      <!-- Runtime Info Card -->
+      <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6 hover:border-[#E535AB]/30 transition-all">
+        <h2 class="text-lg font-semibold mb-4 text-slate-200 flex items-center gap-2">
+          <span class="text-[#E535AB]">●</span> Runtime Loaded
+        </h2>
+        <div class="space-y-3">
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Resolvers</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.runtime.loadedResolvers}</span>
+          </div>
+          <div class="flex justify-between items-center py-2 border-b border-slate-800/50">
+            <span class="text-slate-400 text-sm">Schemas</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.runtime.loadedSchemas}</span>
+          </div>
+          <div class="flex justify-between items-center py-2">
+            <span class="text-slate-400 text-sm">Directives</span>
+            <span class="text-[#E535AB] font-semibold text-sm">${debugInfo.runtime.loadedDirectives}</span>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- Resolver Exports -->
+    <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6">
+      <div class="flex justify-between items-center mb-4">
+        <h2 class="text-xl font-semibold text-slate-200 flex items-center gap-2">
+          <span class="text-[#E535AB]">●</span> Resolver Exports
+        </h2>
+        ${debugInfo.scanned.resolverFiles.length > 0 ? `<span class="text-xs text-slate-500 bg-slate-800/50 px-2 py-1 rounded">${debugInfo.scanned.resolverFiles.length} files</span>` : ""}
+      </div>
+      ${renderResolverExports(debugInfo.scanned.resolverFiles)}
+    </div>
+
+    <!-- Generated Virtual Modules -->
+    <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6">
+      <div class="flex justify-between items-center mb-4">
+        <h2 class="text-xl font-semibold text-slate-200 flex items-center gap-2">
+          <span class="text-[#E535AB]">●</span> Generated Virtual Modules
+        </h2>
+        <span class="text-xs text-slate-500 bg-slate-800/50 px-2 py-1 rounded">
+          ${Object.keys(debugInfo.virtualModules).length} modules
+        </span>
+      </div>
+      <div class="space-y-3">
+        ${renderVirtualModules(debugInfo.virtualModules)}
+      </div>
+    </div>
+
+    <!-- Files Grid -->
+    <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+      <!-- Schema Files -->
+      <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6 hover:border-[#E535AB]/30 transition-all">
+        <div class="flex justify-between items-center mb-4">
+          <h2 class="text-lg font-semibold text-slate-200 flex items-center gap-2">
+            <span class="text-[#E535AB]">●</span> Schema Files
+          </h2>
+          ${debugInfo.scanned.schemaFiles.length > 0 ? `<span class="text-xs text-slate-500 bg-slate-800/50 px-2 py-1 rounded">${debugInfo.scanned.schemaFiles.length} file${debugInfo.scanned.schemaFiles.length !== 1 ? "s" : ""}</span>` : ""}
+        </div>
+        <ul class="space-y-2 max-h-64 overflow-y-auto pr-2">
+          ${renderFileList(debugInfo.scanned.schemaFiles, "No schemas found")}
+        </ul>
+      </div>
+
+      <!-- Document Files -->
+      <div class="bg-slate-900/50 border border-slate-700/50 rounded-lg p-6 hover:border-[#E535AB]/30 transition-all">
+        <div class="flex justify-between items-center mb-4">
+          <h2 class="text-lg font-semibold text-slate-200 flex items-center gap-2">
+            <span class="text-[#E535AB]">●</span> Document Files
+          </h2>
+          ${debugInfo.scanned.documentFiles.length > 0 ? `<span class="text-xs text-slate-500 bg-slate-800/50 px-2 py-1 rounded">${debugInfo.scanned.documentFiles.length} file${debugInfo.scanned.documentFiles.length !== 1 ? "s" : ""}</span>` : ""}
+        </div>
+        <ul class="space-y-2 max-h-64 overflow-y-auto pr-2">
+          ${renderFileList(debugInfo.scanned.documentFiles, "No documents found")}
+        </ul>
+      </div>
+    </div>
+
+    <!-- Reload Button -->
+    <button
+      onclick="location.reload()"
+      class="fixed bottom-8 right-8 bg-[#E535AB] hover:bg-[#d12a99] text-white font-semibold px-6 py-3 rounded-lg shadow-lg hover:shadow-xl hover:shadow-[#E535AB]/20 transform hover:-translate-y-1 transition-all duration-200 flex items-center gap-2 border border-[#E535AB]/20"
+    >
+      <svg class="w-4 h-4" fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
+      </svg>
+      Reload
+    </button>
+  </div>
+</body>
+</html>`;
+}
+
+//#endregion
+export { escapeHtml, generateDebugHtml };

package/dist/core/extend/index.d.mts

@@ -0,0 +1,2 @@
+import { ExtendScanResult, LocalDirExtendSource, isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource } from "./loader.mjs";
+export { ExtendScanResult, LocalDirExtendSource, isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource };

package/dist/core/extend/index.mjs

@@ -0,0 +1,3 @@
+import { isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource } from "./loader.mjs";
+
+export { isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource };

package/dist/core/extend/loader.d.mts

@@ -0,0 +1,40 @@
+import { ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/extend/loader.d.ts
+/**
+ * Local directory extend source configuration
+ */
+interface LocalDirExtendSource {
+  serverDir?: string;
+  clientDir?: string;
+}
+/**
+ * Result of scanning an extend source
+ */
+interface ExtendScanResult {
+  schemas: string[];
+  resolvers: ScannedResolver[];
+  directives: ScannedResolver[];
+  documents: string[];
+  configPath?: string;
+  schemaPath?: string;
+}
+/**
+ * Check if source is a LocalDirExtendSource
+ */
+declare function isLocalDirSource(source: unknown): source is LocalDirExtendSource;
+/**
+ * Resolve extend directories for file watching
+ * Returns directories that should be watched for changes
+ */
+declare function resolveExtendDirs(extend: Array<string | object> | undefined, rootDir: string): Promise<string[]>;
+/**
+ * Scan a single extend source and return the files found
+ */
+declare function scanExtendSource(source: string | object, rootDir: string): Promise<ExtendScanResult>;
+/**
+ * Scan all extend sources and merge results
+ */
+declare function scanAllExtendSources(extend: Array<string | object> | undefined, rootDir: string): Promise<ExtendScanResult>;
+//#endregion
+export { ExtendScanResult, LocalDirExtendSource, isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource };

package/dist/core/extend/loader.mjs

@@ -0,0 +1,198 @@
+import { GRAPHQL_GLOB_PATTERN, RESOLVER_GLOB_PATTERN } from "../constants.mjs";
+import { isLocalPath, loadPackageConfig, resolvePackageFiles } from "../manifest.mjs";
+import { parseSingleFile } from "../scanning/ast-scanner.mjs";
+import { parseDirectiveCall } from "../scanning/directives.mjs";
+import { parseResolverCall } from "../scanning/resolvers.mjs";
+import { existsSync_ } from "../utils/runtime.mjs";
+import { dirname, resolve } from "pathe";
+import { glob } from "tinyglobby";
+
+//#region src/core/extend/loader.ts
+/**
+* Check if source is a LocalDirExtendSource
+*/
+function isLocalDirSource(source) {
+	return source !== null && typeof source === "object" && ("serverDir" in source || "clientDir" in source) && !("manifest" in source) && !("resolvers" in source) && !("schemas" in source);
+}
+/**
+* Resolve extend directories for file watching
+* Returns directories that should be watched for changes
+*/
+async function resolveExtendDirs(extend, rootDir) {
+	if (!extend || !Array.isArray(extend) || extend.length === 0) return [];
+	const dirs = [];
+	for (const source of extend) if (typeof source === "string") {
+		const pkg = await loadPackageConfig(source, rootDir);
+		if (pkg) {
+			const serverDir = resolve(pkg.baseDir, pkg.config.serverDir || "server/graphql");
+			dirs.push(serverDir);
+			if (pkg.config.clientDir) {
+				const clientDir = resolve(pkg.baseDir, pkg.config.clientDir);
+				dirs.push(clientDir);
+			}
+		} else if (isLocalPath(source)) {
+			const localDir = resolve(rootDir, source, "graphql");
+			if (existsSync_(localDir)) dirs.push(localDir);
+		}
+	} else if (isLocalDirSource(source)) {
+		if (source.serverDir && existsSync_(source.serverDir)) dirs.push(source.serverDir);
+		if (source.clientDir && existsSync_(source.clientDir)) dirs.push(source.clientDir);
+	} else if (source && typeof source === "object") {
+		const obj = source;
+		if (obj.schemas) {
+			const schemas = Array.isArray(obj.schemas) ? obj.schemas : [obj.schemas];
+			for (const schemaPath of schemas) dirs.push(dirname(resolve(rootDir, schemaPath)));
+		}
+		if (obj.resolvers) {
+			const resolvers = Array.isArray(obj.resolvers) ? obj.resolvers : [obj.resolvers];
+			for (const resolverPath of resolvers) dirs.push(dirname(resolve(rootDir, resolverPath)));
+		}
+	}
+	return [...new Set(dirs)];
+}
+/**
+* Scan a single extend source and return the files found
+*/
+async function scanExtendSource(source, rootDir) {
+	if (typeof source === "string") return scanPackageSource(source, rootDir);
+	if (isLocalDirSource(source)) return scanLocalDirSource(source);
+	if (source && typeof source === "object") return scanExplicitPaths(source, rootDir);
+	return {
+		schemas: [],
+		resolvers: [],
+		directives: [],
+		documents: []
+	};
+}
+/**
+* Scan all extend sources and merge results
+*/
+async function scanAllExtendSources(extend, rootDir) {
+	if (!extend || !Array.isArray(extend) || extend.length === 0) return {
+		schemas: [],
+		resolvers: [],
+		directives: [],
+		documents: []
+	};
+	const merged = {
+		schemas: [],
+		resolvers: [],
+		directives: [],
+		documents: []
+	};
+	for (const source of extend) {
+		const result = await scanExtendSource(source, rootDir);
+		merged.schemas.push(...result.schemas);
+		merged.resolvers.push(...result.resolvers);
+		merged.directives.push(...result.directives);
+		merged.documents.push(...result.documents);
+		if (result.configPath) merged.configPath = result.configPath;
+		if (result.schemaPath) merged.schemaPath = result.schemaPath;
+	}
+	return merged;
+}
+/**
+* Scan a package for GraphQL files
+*/
+async function scanPackageSource(packageName, rootDir) {
+	const pkg = await loadPackageConfig(packageName, rootDir);
+	if (!pkg) throw new Error(`[nitro-graphql] Config not found for "${packageName}". Create a nitro-graphql.config.ts file in the package root.`);
+	const files = await resolvePackageFiles(pkg);
+	const resolvers = [];
+	const directives = [];
+	for (const resolverPath of files.resolvers) {
+		const parsed = await parseSingleFile(resolverPath, parseResolverCall);
+		if (parsed?.imports.length) resolvers.push(parsed);
+	}
+	for (const directivePath of files.directives) {
+		const parsed = await parseSingleFile(directivePath, parseDirectiveCall);
+		if (parsed?.imports.length) directives.push(parsed);
+	}
+	return {
+		schemas: files.schemas,
+		resolvers,
+		directives,
+		documents: files.documents,
+		configPath: files.configPath,
+		schemaPath: files.schemaPath
+	};
+}
+/**
+* Scan a local directory for GraphQL files
+*/
+async function scanLocalDirSource(source) {
+	const result = {
+		schemas: [],
+		resolvers: [],
+		directives: [],
+		documents: []
+	};
+	const ignorePatterns = [
+		"**/node_modules/**",
+		"**/.git/**",
+		"**/.output/**",
+		"**/.nitro/**",
+		"**/.nuxt/**"
+	];
+	if (source.serverDir && existsSync_(source.serverDir)) {
+		const schemaFiles = await glob(GRAPHQL_GLOB_PATTERN, {
+			cwd: source.serverDir,
+			absolute: true,
+			ignore: ignorePatterns
+		});
+		result.schemas.push(...schemaFiles);
+		const resolverFiles = await glob(RESOLVER_GLOB_PATTERN, {
+			cwd: source.serverDir,
+			absolute: true,
+			ignore: ignorePatterns
+		});
+		for (const resolverPath of resolverFiles) {
+			const parsed = await parseSingleFile(resolverPath, parseResolverCall);
+			if (parsed?.imports.length) result.resolvers.push(parsed);
+		}
+		const directiveFiles = await glob("**/*.directive.ts", {
+			cwd: source.serverDir,
+			absolute: true,
+			ignore: ignorePatterns
+		});
+		for (const directivePath of directiveFiles) {
+			const parsed = await parseSingleFile(directivePath, parseDirectiveCall);
+			if (parsed?.imports.length) result.directives.push(parsed);
+		}
+	}
+	if (source.clientDir && existsSync_(source.clientDir)) {
+		const documentFiles = await glob(GRAPHQL_GLOB_PATTERN, {
+			cwd: source.clientDir,
+			absolute: true,
+			ignore: ignorePatterns
+		});
+		result.documents.push(...documentFiles);
+	}
+	return result;
+}
+/**
+* Scan explicit paths (legacy format)
+*/
+async function scanExplicitPaths(source, rootDir) {
+	const result = {
+		schemas: [],
+		resolvers: [],
+		directives: [],
+		documents: []
+	};
+	if (source.schemas) {
+		const schemas = Array.isArray(source.schemas) ? source.schemas : [source.schemas];
+		for (const schemaPath of schemas) result.schemas.push(resolve(rootDir, schemaPath));
+	}
+	if (source.resolvers) {
+		const resolvers = Array.isArray(source.resolvers) ? source.resolvers : [source.resolvers];
+		for (const resolverPath of resolvers) {
+			const parsed = await parseSingleFile(resolve(rootDir, resolverPath), parseResolverCall);
+			if (parsed?.imports.length) result.resolvers.push(parsed);
+		}
+	}
+	return result;
+}
+
+//#endregion
+export { isLocalDirSource, resolveExtendDirs, scanAllExtendSources, scanExtendSource };