@assistant-ui/mcp-docs-server 0.1.31 → 0.1.32

package/dist/constants.js

@@ -1,14 +1,18 @@
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
+//#region src/constants.ts
 const __dirname = dirname(fileURLToPath(import.meta.url));
-export const ROOT_DIR = join(__dirname, "../../../");
-export const PACKAGE_DIR = join(__dirname, "../");
-export const EXAMPLES_PATH = join(ROOT_DIR, "examples");
+const ROOT_DIR = join(__dirname, "../../../");
+const PACKAGE_DIR = join(__dirname, "../");
+const EXAMPLES_PATH = join(ROOT_DIR, "examples");
 const DOCS_BASE = join(PACKAGE_DIR, ".docs");
-export const DOCS_PATH = join(DOCS_BASE, "raw/docs");
-export const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
-export const MDX_EXTENSION = ".mdx";
-export const MD_EXTENSION = ".md";
-export const MAX_FILE_SIZE = 10 * 1024 * 1024;
-export const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
+const DOCS_PATH = join(DOCS_BASE, "raw/docs");
+const CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
+const MDX_EXTENSION = ".mdx";
+const MD_EXTENSION = ".md";
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const IS_PREPARE_MODE = process.argv[1]?.includes("prepare-docs/prepare");
+//#endregion
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, PACKAGE_DIR, ROOT_DIR };
+
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAElD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AAExD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,CACtD,sBAAsB,CACvB,CAAC"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { dirname, join } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nexport const ROOT_DIR = join(__dirname, \"../../../\");\nexport const PACKAGE_DIR = join(__dirname, \"../\");\n\nexport const EXAMPLES_PATH = join(ROOT_DIR, \"examples\");\n\nconst DOCS_BASE = join(PACKAGE_DIR, \".docs\");\nexport const DOCS_PATH = join(DOCS_BASE, \"raw/docs\");\nexport const CODE_EXAMPLES_PATH = join(DOCS_BASE, \"organized/code-examples\");\n\nexport const MDX_EXTENSION = \".mdx\";\nexport const MD_EXTENSION = \".md\";\n\nexport const MAX_FILE_SIZE = 10 * 1024 * 1024;\n\nexport const IS_PREPARE_MODE = process.argv[1]?.includes(\n  \"prepare-docs/prepare\",\n);\n"],"mappings":";;;AAGA,MAAM,YAAY,QAAQ,cAAc,OAAO,KAAK,GAAG,CAAC;AAExD,MAAa,WAAW,KAAK,WAAW,WAAW;AACnD,MAAa,cAAc,KAAK,WAAW,KAAK;AAEhD,MAAa,gBAAgB,KAAK,UAAU,UAAU;AAEtD,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,MAAa,YAAY,KAAK,WAAW,UAAU;AACnD,MAAa,qBAAqB,KAAK,WAAW,yBAAyB;AAE3E,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,gBAAgB,KAAK,OAAO;AAEzC,MAAa,kBAAkB,QAAQ,KAAK,IAAI,SAC9C,sBACF"}

package/dist/index.d.ts

@@ -1,4 +1,8 @@
-import { McpServer } from "@modelcontextprotocol/sdk";
-export declare const server: McpServer;
-export declare function runServer(): Promise<void>;
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+//#region src/index.d.ts
+declare const server: McpServer;
+declare function runServer(): Promise<void>;
+//#endregion
+export { runServer, server };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,kCAAgD;AAcpE,eAAO,MAAM,MAAM,WAGjB,CAAC;AAeH,wBAAsB,SAAS,kBAW9B"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;cAca,MAAA,EAAM,SAGjB;AAAA,iBAeoB,SAAA,CAAA,GAAS,OAAA"}

package/dist/index.js

@@ -1,33 +1,34 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { PACKAGE_DIR } from "./constants.js";
+import { logger } from "./utils/logger.js";
 import { docsTools } from "./tools/docs.js";
 import { examplesTools } from "./tools/examples.js";
-import { logger } from "./utils/logger.js";
-import { PACKAGE_DIR } from "./constants.js";
-import { readFileSync } from "node:fs";
 import { join } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "node:fs";
+//#region src/index.ts
 const packageJson = JSON.parse(readFileSync(join(PACKAGE_DIR, "package.json"), "utf-8"));
-export const server = new McpServer({
-    name: "assistant-ui-docs",
-    version: packageJson.version,
+const server = new McpServer({
+	name: "assistant-ui-docs",
+	version: packageJson.version
 });
 server.tool(docsTools.name, docsTools.description, docsTools.parameters, docsTools.execute);
 server.tool(examplesTools.name, examplesTools.description, examplesTools.parameters, examplesTools.execute);
-export async function runServer() {
-    try {
-        logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);
-        const transport = new StdioServerTransport();
-        await server.connect(transport);
-    }
-    catch (error) {
-        logger.error("Failed to start MCP server", error);
-        process.exit(1);
-    }
-}
-if (import.meta.url === `file://${process.argv[1]}`) {
-    void runServer().catch((error) => {
-        console.error("Failed to start server:", error);
-        process.exit(1);
-    });
+async function runServer() {
+	try {
+		logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);
+		const transport = new StdioServerTransport();
+		await server.connect(transport);
+	} catch (error) {
+		logger.error("Failed to start MCP server", error);
+		process.exit(1);
+	}
 }
+if (import.meta.url === `file://${process.argv[1]}`) runServer().catch((error) => {
+	console.error("Failed to start server:", error);
+	process.exit(1);
+});
+//#endregion
+export { runServer, server };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAClC,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,WAAW,EACrB,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,OAAO,CAClB,CAAC;AACF,MAAM,CAAC,IAAI,CACT,aAAa,CAAC,IAAI,EAClB,aAAa,CAAC,WAAW,EACzB,aAAa,CAAC,UAAU,EACxB,aAAa,CAAC,OAAO,CACtB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CACT,0CAA0C,WAAW,CAAC,OAAO,EAAE,CAChE,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,KAAK,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.tool(\n  docsTools.name,\n  docsTools.description,\n  docsTools.parameters,\n  docsTools.execute,\n);\nserver.tool(\n  examplesTools.name,\n  examplesTools.description,\n  examplesTools.parameters,\n  examplesTools.execute,\n);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,KACL,UAAU,MACV,UAAU,aACV,UAAU,YACV,UAAU,OACZ;AACA,OAAO,KACL,cAAc,MACd,cAAc,aACd,cAAc,YACd,cAAc,OAChB;AAEA,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,EAAE,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/prepare-docs/code-examples.d.ts

@@ -1,2 +1,5 @@
-export declare function prepareCodeExamples(): Promise<void>;
+//#region src/prepare-docs/code-examples.d.ts
+declare function prepareCodeExamples(): Promise<void>;
+//#endregion
+export { prepareCodeExamples };
 //# sourceMappingURL=code-examples.d.ts.map

package/dist/prepare-docs/code-examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-examples.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"AA2FA,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkEzD"}
+{"version":3,"file":"code-examples.d.ts","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"mappings":";iBA2FsB,mBAAA,CAAA,GAAuB,OAAO"}

package/dist/prepare-docs/code-examples.js

@@ -1,129 +1,117 @@
-import { rm, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
-import { join, relative, extname } from "node:path";
+import { EXAMPLES_PATH, ROOT_DIR } from "../constants.js";
 import { logger } from "../utils/logger.js";
-import { ROOT_DIR, EXAMPLES_PATH } from "../constants.js";
+import { extname, join, relative } from "node:path";
+import { mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+//#region src/prepare-docs/code-examples.ts
 const OUTPUT_DIR = join(ROOT_DIR, "packages/mcp-docs-server/.docs/organized/code-examples");
-const MAX_LINES = 10000;
+const MAX_LINES = 1e4;
 async function scanDirectory(dir, baseDir) {
-    const files = [];
-    try {
-        const entries = await readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const fullPath = join(dir, entry.name);
-            if (entry.isDirectory()) {
-                const skipDirs = [
-                    "node_modules",
-                    "dist",
-                    "build",
-                    ".next",
-                    ".git",
-                    ".turbo",
-                ];
-                if (!skipDirs.includes(entry.name)) {
-                    const subFiles = await scanDirectory(fullPath, baseDir);
-                    files.push(...subFiles);
-                }
-            }
-            else if (entry.isFile()) {
-                const includeExts = [
-                    ".ts",
-                    ".tsx",
-                    ".js",
-                    ".jsx",
-                    ".json",
-                    ".css",
-                    ".md",
-                    ".mdx",
-                ];
-                const ext = extname(entry.name).toLowerCase();
-                if (includeExts.includes(ext) ||
-                    entry.name === "package.json" ||
-                    entry.name === "tsconfig.json") {
-                    try {
-                        const content = await readFile(fullPath, "utf-8");
-                        const relativePath = relative(baseDir, fullPath);
-                        files.push({ path: relativePath, content });
-                    }
-                    catch (error) {
-                        logger.warn(`Failed to read file: ${fullPath}`, error);
-                    }
-                }
-            }
-        }
-    }
-    catch (error) {
-        logger.error(`Failed to scan directory: ${dir}`, error);
-    }
-    return files;
+	const files = [];
+	try {
+		const entries = await readdir(dir, { withFileTypes: true });
+		for (const entry of entries) {
+			const fullPath = join(dir, entry.name);
+			if (entry.isDirectory()) {
+				if (![
+					"node_modules",
+					"dist",
+					"build",
+					".next",
+					".git",
+					".turbo"
+				].includes(entry.name)) {
+					const subFiles = await scanDirectory(fullPath, baseDir);
+					files.push(...subFiles);
+				}
+			} else if (entry.isFile()) {
+				const includeExts = [
+					".ts",
+					".tsx",
+					".js",
+					".jsx",
+					".json",
+					".css",
+					".md",
+					".mdx"
+				];
+				const ext = extname(entry.name).toLowerCase();
+				if (includeExts.includes(ext) || entry.name === "package.json" || entry.name === "tsconfig.json") try {
+					const content = await readFile(fullPath, "utf-8");
+					const relativePath = relative(baseDir, fullPath);
+					files.push({
+						path: relativePath,
+						content
+					});
+				} catch (error) {
+					logger.warn(`Failed to read file: ${fullPath}`, error);
+				}
+			}
+		}
+	} catch (error) {
+		logger.error(`Failed to scan directory: ${dir}`, error);
+	}
+	return files;
 }
 function getFileType(filename) {
-    const ext = extname(filename).toLowerCase();
-    const extMap = {
-        ".ts": "typescript",
-        ".tsx": "tsx",
-        ".js": "javascript",
-        ".jsx": "jsx",
-        ".json": "json",
-        ".css": "css",
-        ".md": "markdown",
-        ".mdx": "mdx",
-    };
-    return extMap[ext] || "text";
+	return {
+		".ts": "typescript",
+		".tsx": "tsx",
+		".js": "javascript",
+		".jsx": "jsx",
+		".json": "json",
+		".css": "css",
+		".md": "markdown",
+		".mdx": "mdx"
+	}[extname(filename).toLowerCase()] || "text";
 }
-export async function prepareCodeExamples() {
-    logger.info("Preparing code examples...");
-    try {
-        await rm(OUTPUT_DIR, { recursive: true, force: true });
-        await mkdir(OUTPUT_DIR, { recursive: true });
-        const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });
-        for (const dir of exampleDirs) {
-            if (dir.isDirectory() && !dir.name.startsWith(".")) {
-                const examplePath = join(EXAMPLES_PATH, dir.name);
-                logger.info(`Processing example: ${dir.name}`);
-                let description = "";
-                try {
-                    const packageJsonPath = join(examplePath, "package.json");
-                    const packageJson = JSON.parse(await readFile(packageJsonPath, "utf-8"));
-                    description = packageJson.description || "";
-                }
-                catch (error) {
-                    if (error?.code !== "ENOENT") {
-                        logger.warn(`Failed to read package.json for ${dir.name}:`, error);
-                    }
-                    else {
-                        logger.debug(`No package.json found for example: ${dir.name}`);
-                    }
-                }
-                const files = await scanDirectory(examplePath, examplePath);
-                files.sort((a, b) => a.path.localeCompare(b.path));
-                let markdown = `# Example: ${dir.name}\n\n`;
-                if (description) {
-                    markdown += `${description}\n\n`;
-                }
-                let totalLines = 0;
-                for (const file of files) {
-                    const lines = file.content.split("\n").length;
-                    if (totalLines + lines > MAX_LINES) {
-                        markdown += `\n_Note: Additional files truncated due to size limits_\n`;
-                        break;
-                    }
-                    // Normalize Windows backslashes to forward slashes for consistent markdown output
-                    markdown += `## ${file.path.replace(/\\/g, "/")}\n\n`;
-                    markdown += `\`\`\`${getFileType(file.path)}\n`;
-                    markdown += file.content;
-                    markdown += `\n\`\`\`\n\n`;
-                    totalLines += lines;
-                }
-                const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);
-                await writeFile(outputPath, markdown, "utf-8");
-                logger.debug(`Created example: ${outputPath}`);
-            }
-        }
-        logger.info("Code examples preparation complete");
-    }
-    catch (error) {
-        logger.error("Failed to prepare code examples", error);
-        throw error;
-    }
+async function prepareCodeExamples() {
+	logger.info("Preparing code examples...");
+	try {
+		await rm(OUTPUT_DIR, {
+			recursive: true,
+			force: true
+		});
+		await mkdir(OUTPUT_DIR, { recursive: true });
+		const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });
+		for (const dir of exampleDirs) if (dir.isDirectory() && !dir.name.startsWith(".")) {
+			const examplePath = join(EXAMPLES_PATH, dir.name);
+			logger.info(`Processing example: ${dir.name}`);
+			let description = "";
+			try {
+				const packageJsonPath = join(examplePath, "package.json");
+				description = JSON.parse(await readFile(packageJsonPath, "utf-8")).description || "";
+			} catch (error) {
+				if (error?.code !== "ENOENT") logger.warn(`Failed to read package.json for ${dir.name}:`, error);
+				else logger.debug(`No package.json found for example: ${dir.name}`);
+			}
+			const files = await scanDirectory(examplePath, examplePath);
+			files.sort((a, b) => a.path.localeCompare(b.path));
+			let markdown = `# Example: ${dir.name}\n\n`;
+			if (description) markdown += `${description}\n\n`;
+			let totalLines = 0;
+			for (const file of files) {
+				const lines = file.content.split("\n").length;
+				if (totalLines + lines > MAX_LINES) {
+					markdown += `\n_Note: Additional files truncated due to size limits_\n`;
+					break;
+				}
+				markdown += `## ${file.path.replace(/\\/g, "/")}\n\n`;
+				markdown += `\`\`\`${getFileType(file.path)}\n`;
+				markdown += file.content;
+				markdown += `\n\`\`\`\n\n`;
+				totalLines += lines;
+			}
+			const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);
+			await writeFile(outputPath, markdown, "utf-8");
+			logger.debug(`Created example: ${outputPath}`);
+		}
+		logger.info("Code examples preparation complete");
+	} catch (error) {
+		logger.error("Failed to prepare code examples", error);
+		throw error;
+	}
 }
+//#endregion
+export { prepareCodeExamples };
+
 //# sourceMappingURL=code-examples.js.map

package/dist/prepare-docs/code-examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-examples.js","sourceRoot":"","sources":["../../src/prepare-docs/code-examples.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"code-examples.js","names":[],"sources":["../../src/prepare-docs/code-examples.ts"],"sourcesContent":["import { rm, mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR, EXAMPLES_PATH } from \"../constants.js\";\n\nconst OUTPUT_DIR = join(\n  ROOT_DIR,\n  \"packages/mcp-docs-server/.docs/organized/code-examples\",\n);\nconst MAX_LINES = 10000;\n\ninterface FileContent {\n  path: string;\n  content: string;\n}\n\nasync function scanDirectory(\n  dir: string,\n  baseDir: string,\n): Promise<FileContent[]> {\n  const files: FileContent[] = [];\n\n  try {\n    const entries = await readdir(dir, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name);\n\n      if (entry.isDirectory()) {\n        const skipDirs = [\n          \"node_modules\",\n          \"dist\",\n          \"build\",\n          \".next\",\n          \".git\",\n          \".turbo\",\n        ];\n        if (!skipDirs.includes(entry.name)) {\n          const subFiles = await scanDirectory(fullPath, baseDir);\n          files.push(...subFiles);\n        }\n      } else if (entry.isFile()) {\n        const includeExts = [\n          \".ts\",\n          \".tsx\",\n          \".js\",\n          \".jsx\",\n          \".json\",\n          \".css\",\n          \".md\",\n          \".mdx\",\n        ];\n        const ext = extname(entry.name).toLowerCase();\n\n        if (\n          includeExts.includes(ext) ||\n          entry.name === \"package.json\" ||\n          entry.name === \"tsconfig.json\"\n        ) {\n          try {\n            const content = await readFile(fullPath, \"utf-8\");\n            const relativePath = relative(baseDir, fullPath);\n            files.push({ path: relativePath, content });\n          } catch (error) {\n            logger.warn(`Failed to read file: ${fullPath}`, error);\n          }\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to scan directory: ${dir}`, error);\n  }\n\n  return files;\n}\n\nfunction getFileType(filename: string): string {\n  const ext = extname(filename).toLowerCase();\n  const extMap: Record<string, string> = {\n    \".ts\": \"typescript\",\n    \".tsx\": \"tsx\",\n    \".js\": \"javascript\",\n    \".jsx\": \"jsx\",\n    \".json\": \"json\",\n    \".css\": \"css\",\n    \".md\": \"markdown\",\n    \".mdx\": \"mdx\",\n  };\n  return extMap[ext] || \"text\";\n}\n\nexport async function prepareCodeExamples(): Promise<void> {\n  logger.info(\"Preparing code examples...\");\n\n  try {\n    await rm(OUTPUT_DIR, { recursive: true, force: true });\n    await mkdir(OUTPUT_DIR, { recursive: true });\n\n    const exampleDirs = await readdir(EXAMPLES_PATH, { withFileTypes: true });\n\n    for (const dir of exampleDirs) {\n      if (dir.isDirectory() && !dir.name.startsWith(\".\")) {\n        const examplePath = join(EXAMPLES_PATH, dir.name);\n        logger.info(`Processing example: ${dir.name}`);\n\n        let description = \"\";\n        try {\n          const packageJsonPath = join(examplePath, \"package.json\");\n          const packageJson = JSON.parse(\n            await readFile(packageJsonPath, \"utf-8\"),\n          );\n          description = packageJson.description || \"\";\n        } catch (error: any) {\n          if (error?.code !== \"ENOENT\") {\n            logger.warn(`Failed to read package.json for ${dir.name}:`, error);\n          } else {\n            logger.debug(`No package.json found for example: ${dir.name}`);\n          }\n        }\n\n        const files = await scanDirectory(examplePath, examplePath);\n\n        files.sort((a, b) => a.path.localeCompare(b.path));\n\n        let markdown = `# Example: ${dir.name}\\n\\n`;\n        if (description) {\n          markdown += `${description}\\n\\n`;\n        }\n\n        let totalLines = 0;\n        for (const file of files) {\n          const lines = file.content.split(\"\\n\").length;\n          if (totalLines + lines > MAX_LINES) {\n            markdown += `\\n_Note: Additional files truncated due to size limits_\\n`;\n            break;\n          }\n\n          // Normalize Windows backslashes to forward slashes for consistent markdown output\n          markdown += `## ${file.path.replace(/\\\\/g, \"/\")}\\n\\n`;\n          markdown += `\\`\\`\\`${getFileType(file.path)}\\n`;\n          markdown += file.content;\n          markdown += `\\n\\`\\`\\`\\n\\n`;\n\n          totalLines += lines;\n        }\n\n        const outputPath = join(OUTPUT_DIR, `${dir.name}.md`);\n        await writeFile(outputPath, markdown, \"utf-8\");\n        logger.debug(`Created example: ${outputPath}`);\n      }\n    }\n\n    logger.info(\"Code examples preparation complete\");\n  } catch (error) {\n    logger.error(\"Failed to prepare code examples\", error);\n    throw error;\n  }\n}\n"],"mappings":"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"}

package/dist/prepare-docs/copy-raw.d.ts

@@ -1,2 +1,5 @@
-export declare function copyRaw(): Promise<void>;
+//#region src/prepare-docs/copy-raw.d.ts
+declare function copyRaw(): Promise<void>;
+//#endregion
+export { copyRaw };
 //# sourceMappingURL=copy-raw.d.ts.map

package/dist/prepare-docs/copy-raw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.d.ts","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"AAkCA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB7C"}
+{"version":3,"file":"copy-raw.d.ts","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"mappings":";iBAkCsB,OAAA,CAAA,GAAW,OAAO"}

package/dist/prepare-docs/copy-raw.js

@@ -1,50 +1,53 @@
-import { rm, mkdir, readdir, copyFile } from "node:fs/promises";
-import { join, extname } from "node:path";
-import { logger } from "../utils/logger.js";
 import { ROOT_DIR } from "../constants.js";
+import { logger } from "../utils/logger.js";
+import { extname, join } from "node:path";
+import { copyFile, mkdir, readdir, rm } from "node:fs/promises";
+//#region src/prepare-docs/copy-raw.ts
 const DOCS_SOURCE = join(ROOT_DIR, "apps/docs/content/docs");
 const BLOG_SOURCE = join(ROOT_DIR, "apps/docs/content/blog");
 const DOCS_DEST = join(ROOT_DIR, "packages/mcp-docs-server/.docs/raw");
 async function copyDir(src, dest) {
-    try {
-        await mkdir(dest, { recursive: true });
-        const entries = await readdir(src, { withFileTypes: true });
-        for (const entry of entries) {
-            const srcPath = join(src, entry.name);
-            const destPath = join(dest, entry.name);
-            if (entry.isDirectory()) {
-                await copyDir(srcPath, destPath);
-            }
-            else if (entry.isFile()) {
-                const ext = extname(entry.name).toLowerCase();
-                if (ext === ".mdx" || ext === ".md") {
-                    await copyFile(srcPath, destPath);
-                    logger.debug(`Copied: ${srcPath} -> ${destPath}`);
-                }
-            }
-        }
-    }
-    catch (error) {
-        logger.error(`Failed to copy directory: ${src}`, error);
-        throw error;
-    }
+	try {
+		await mkdir(dest, { recursive: true });
+		const entries = await readdir(src, { withFileTypes: true });
+		for (const entry of entries) {
+			const srcPath = join(src, entry.name);
+			const destPath = join(dest, entry.name);
+			if (entry.isDirectory()) await copyDir(srcPath, destPath);
+			else if (entry.isFile()) {
+				const ext = extname(entry.name).toLowerCase();
+				if (ext === ".mdx" || ext === ".md") {
+					await copyFile(srcPath, destPath);
+					logger.debug(`Copied: ${srcPath} -> ${destPath}`);
+				}
+			}
+		}
+	} catch (error) {
+		logger.error(`Failed to copy directory: ${src}`, error);
+		throw error;
+	}
 }
-export async function copyRaw() {
-    logger.info("Copying raw documentation files...");
-    try {
-        await rm(DOCS_DEST, { recursive: true, force: true });
-        await mkdir(DOCS_DEST, { recursive: true });
-        const docsPath = join(DOCS_DEST, "docs");
-        await copyDir(DOCS_SOURCE, docsPath);
-        logger.info(`Copied documentation to ${docsPath}`);
-        const blogPath = join(DOCS_DEST, "blog");
-        await copyDir(BLOG_SOURCE, blogPath);
-        logger.info(`Copied blog posts to ${blogPath}`);
-        logger.info("Raw documentation copy complete");
-    }
-    catch (error) {
-        logger.error("Failed to copy raw documentation", error);
-        throw error;
-    }
+async function copyRaw() {
+	logger.info("Copying raw documentation files...");
+	try {
+		await rm(DOCS_DEST, {
+			recursive: true,
+			force: true
+		});
+		await mkdir(DOCS_DEST, { recursive: true });
+		const docsPath = join(DOCS_DEST, "docs");
+		await copyDir(DOCS_SOURCE, docsPath);
+		logger.info(`Copied documentation to ${docsPath}`);
+		const blogPath = join(DOCS_DEST, "blog");
+		await copyDir(BLOG_SOURCE, blogPath);
+		logger.info(`Copied blog posts to ${blogPath}`);
+		logger.info("Raw documentation copy complete");
+	} catch (error) {
+		logger.error("Failed to copy raw documentation", error);
+		throw error;
+	}
 }
+//#endregion
+export { copyRaw };
+
 //# sourceMappingURL=copy-raw.js.map

package/dist/prepare-docs/copy-raw.js.map

@@ -1 +1 @@
-{"version":3,"file":"copy-raw.js","sourceRoot":"","sources":["../../src/prepare-docs/copy-raw.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"copy-raw.js","names":[],"sources":["../../src/prepare-docs/copy-raw.ts"],"sourcesContent":["import { rm, mkdir, readdir, copyFile } from \"node:fs/promises\";\nimport { join, extname } from \"node:path\";\nimport { logger } from \"../utils/logger.js\";\nimport { ROOT_DIR } from \"../constants.js\";\n\nconst DOCS_SOURCE = join(ROOT_DIR, \"apps/docs/content/docs\");\nconst BLOG_SOURCE = join(ROOT_DIR, \"apps/docs/content/blog\");\nconst DOCS_DEST = join(ROOT_DIR, \"packages/mcp-docs-server/.docs/raw\");\n\nasync function copyDir(src: string, dest: string): Promise<void> {\n  try {\n    await mkdir(dest, { recursive: true });\n    const entries = await readdir(src, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const srcPath = join(src, entry.name);\n      const destPath = join(dest, entry.name);\n\n      if (entry.isDirectory()) {\n        await copyDir(srcPath, destPath);\n      } else if (entry.isFile()) {\n        const ext = extname(entry.name).toLowerCase();\n        if (ext === \".mdx\" || ext === \".md\") {\n          await copyFile(srcPath, destPath);\n          logger.debug(`Copied: ${srcPath} -> ${destPath}`);\n        }\n      }\n    }\n  } catch (error) {\n    logger.error(`Failed to copy directory: ${src}`, error);\n    throw error;\n  }\n}\n\nexport async function copyRaw(): Promise<void> {\n  logger.info(\"Copying raw documentation files...\");\n\n  try {\n    await rm(DOCS_DEST, { recursive: true, force: true });\n    await mkdir(DOCS_DEST, { recursive: true });\n\n    const docsPath = join(DOCS_DEST, \"docs\");\n    await copyDir(DOCS_SOURCE, docsPath);\n    logger.info(`Copied documentation to ${docsPath}`);\n\n    const blogPath = join(DOCS_DEST, \"blog\");\n    await copyDir(BLOG_SOURCE, blogPath);\n    logger.info(`Copied blog posts to ${blogPath}`);\n\n    logger.info(\"Raw documentation copy complete\");\n  } catch (error) {\n    logger.error(\"Failed to copy raw documentation\", error);\n    throw error;\n  }\n}\n"],"mappings":";;;;;AAKA,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,cAAc,KAAK,UAAU,wBAAwB;AAC3D,MAAM,YAAY,KAAK,UAAU,oCAAoC;AAErE,eAAe,QAAQ,KAAa,MAA6B;CAC/D,IAAI;EACF,MAAM,MAAM,MAAM,EAAE,WAAW,KAAK,CAAC;EACrC,MAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;EAE1D,KAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,UAAU,KAAK,KAAK,MAAM,IAAI;GACpC,MAAM,WAAW,KAAK,MAAM,MAAM,IAAI;GAEtC,IAAI,MAAM,YAAY,GACpB,MAAM,QAAQ,SAAS,QAAQ;QAC1B,IAAI,MAAM,OAAO,GAAG;IACzB,MAAM,MAAM,QAAQ,MAAM,IAAI,EAAE,YAAY;IAC5C,IAAI,QAAQ,UAAU,QAAQ,OAAO;KACnC,MAAM,SAAS,SAAS,QAAQ;KAChC,OAAO,MAAM,WAAW,QAAQ,MAAM,UAAU;IAClD;GACF;EACF;CACF,SAAS,OAAO;EACd,OAAO,MAAM,6BAA6B,OAAO,KAAK;EACtD,MAAM;CACR;AACF;AAEA,eAAsB,UAAyB;CAC7C,OAAO,KAAK,oCAAoC;CAEhD,IAAI;EACF,MAAM,GAAG,WAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACpD,MAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAE1C,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,2BAA2B,UAAU;EAEjD,MAAM,WAAW,KAAK,WAAW,MAAM;EACvC,MAAM,QAAQ,aAAa,QAAQ;EACnC,OAAO,KAAK,wBAAwB,UAAU;EAE9C,OAAO,KAAK,iCAAiC;CAC/C,SAAS,OAAO;EACd,OAAO,MAAM,oCAAoC,KAAK;EACtD,MAAM;CACR;AACF"}

package/dist/prepare-docs/prepare.d.ts

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=prepare.d.ts.map
+export { };

package/dist/prepare-docs/prepare.js

@@ -1,22 +1,22 @@
 import { logger } from "../utils/logger.js";
-import { copyRaw } from "./copy-raw.js";
 import { prepareCodeExamples } from "./code-examples.js";
+import { copyRaw } from "./copy-raw.js";
+//#region src/prepare-docs/prepare.ts
 async function prepare() {
-    logger.info("Starting documentation preparation...");
-    try {
-        await copyRaw();
-        await prepareCodeExamples();
-        logger.info("Documentation preparation complete");
-    }
-    catch (error) {
-        logger.error("Documentation preparation failed", error);
-        throw error;
-    }
-}
-if (import.meta.url === `file://${process.argv[1]}`) {
-    prepare().catch((error) => {
-        logger.error("Preparation failed", error);
-        process.exit(1);
-    });
+	logger.info("Starting documentation preparation...");
+	try {
+		await copyRaw();
+		await prepareCodeExamples();
+		logger.info("Documentation preparation complete");
+	} catch (error) {
+		logger.error("Documentation preparation failed", error);
+		throw error;
+	}
 }
+if (import.meta.url === `file://${process.argv[1]}`) prepare().catch((error) => {
+	logger.error("Preparation failed", error);
+	process.exit(1);
+});
+//#endregion
+
 //# sourceMappingURL=prepare.js.map