@twobirds/microcomponents 0.9.0 → 0.10.0

package/dist/mcp/index.js

@@ -1,4 +1,280 @@
 #!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region mcp-docs-generate.ts
+/**
+Generates the documentation index for the MCP server directly from src/.
+
+The public API surface is defined by the barrel files (one per src subdirectory,
+named index.ts): every name re-exported there is public, except those preceded by
+a block comment containing @hidden. For each public name the generator locates its
+declaration in the module where it is actually defined and attaches the nearest
+preceding doc block from that same file. Association is proximity-based rather than
+strict AST attachment because some exports carry a private statement between their
+doc block and the export keyword (injectCSS declares a WeakMap cache first).
+
+Overloaded functions contribute every signature to the index, while the doc block
+above the first overload supplies the prose.
+
+@example Regenerate once: pnpm run mcp:docs
+@example Keep it fresh: pnpm run mcp:dev restarts the server process on change
+*/
+var mcp_docs_generate_exports = /* @__PURE__ */ __exportAll({
+	index: () => index$1,
+	undocumented: () => undocumented$1
+});
+/** Read a barrel file, returning each re-exported name with its group and hidden flag. */
+function readBarrel(file) {
+	const lines = readFileSync(file, "utf8").split("\n");
+	for (let i = 0; i < lines.length; i++) {
+		if (!/^\s*export\s+(type\s+)?\{/.test(lines[i])) continue;
+		let k = i;
+		while (k + 1 < lines.length && !/}\s*from/.test(lines[k])) {
+			k++;
+			lines[i] += " " + lines[k].trim();
+			lines[k] = "";
+		}
+		i = k;
+	}
+	const out = [];
+	let pending = "";
+	for (let i = 0; i < lines.length; i++) {
+		const line = lines[i].trim();
+		if (line.startsWith("/**") && !pending) {
+			let k = i;
+			while (k < lines.length && !lines[k].includes("*/")) k++;
+			pending = lines.slice(i, k + 1).join("\n");
+			i = k;
+			continue;
+		}
+		const m = /^export\s+(type\s+)?\{([^}]*)\}\s*from/.exec(line);
+		if (!m) {
+			if (pending && line) pending = "";
+			continue;
+		}
+		for (const raw of m[2].split(",")) {
+			const name = (raw.split(/\bas\b/i).pop() ?? "").trim();
+			if (!/^[A-Za-z_$][\w$]*$/.test(name)) continue;
+			out.push({
+				name,
+				kind: m[1] ? "type" : "value",
+				group: /@group\s+([^\n*/]+)/.exec(pending)?.[1]?.trim(),
+				hidden: pending.includes("@hidden")
+			});
+		}
+		pending = "";
+	}
+	return out;
+}
+function walk(dir) {
+	const files = [];
+	for (const entry of readdirSync(dir, { withFileTypes: true })) {
+		const path = join(dir, entry.name);
+		if (entry.isDirectory()) files.push(...walk(path));
+		else if (basename(path).endsWith(".ts")) files.push(path);
+	}
+	return files;
+}
+function signatureAt(lines, start) {
+	const parts = [];
+	for (let i = start; i < Math.min(lines.length, start + 10); i++) {
+		const t = lines[i].replace(/\s+/g, " ").trim();
+		if (!t) continue;
+		parts.push(t);
+		if (/[{;]\s*$/.test(t)) break;
+	}
+	return parts.join(" ").trim();
+}
+/** Collect doc blocks and declarations for one source file. */
+function scanFile(file) {
+	const lines = readFileSync(file, "utf8").split("\n");
+	const blocks = [];
+	for (let i = 0; i < lines.length; i++) {
+		if (!lines[i].trim().startsWith("/**")) continue;
+		let k = i;
+		while (k < lines.length && !lines[k].includes("*/")) k++;
+		blocks.push({
+			start: i,
+			end: Math.min(k, lines.length - 1),
+			text: lines.slice(i, k + 1).join("\n")
+		});
+		i = k;
+	}
+	const decls = [];
+	for (let i = 0; i < lines.length; i++) for (const [re, kind] of DECL_PATTERNS) {
+		const m = re.exec(lines[i]);
+		if (!m) continue;
+		decls.push({
+			name: m[1],
+			line: i,
+			file,
+			kind,
+			sig: signatureAt(lines, i)
+		});
+	}
+	return {
+		decls,
+		blocks
+	};
+}
+/** Strip comment delimiters and typedoc noise so prose survives as markdown. */
+function extract(block) {
+	const raw = block.text.split("\n");
+	if (raw.length) raw[0] = raw[0].replace(/^\/\*\*/, "");
+	if (raw.length > 1) raw[raw.length - 1] = raw[raw.length - 1].replace(/\*\/$/, "");
+	const markerCol = (/^[\t ]*/.exec(raw[1])?.[0] ?? "").length;
+	const lines = raw.map((l) => l.replace(/^\s*\*?\s?/, "")).map((l) => l.replace(/\{\@link(?:code|linkplain)?\s+([^\s}]+)[^}]*\}/g, "$1"));
+	const isContinuation = (index) => {
+		return (/^[\t ]*/.exec(raw[index])?.[0] ?? "").length > markerCol;
+	};
+	const desc = [];
+	const examples = [];
+	for (let i = 0; i < lines.length; i++) {
+		const ex = /^@example\b\s*(.*)$/.exec(lines[i]);
+		if (!ex) {
+			if (/^@\w/.test(lines[i])) {
+				while (i + 1 < lines.length && isContinuation(i + 1) && !/^@\w/.test(lines[i + 1])) i++;
+				continue;
+			}
+			desc.push(lines[i]);
+			continue;
+		}
+		const title = ex[1].trim();
+		let j = i + 1;
+		while (j < lines.length && !lines[j].trim()) j++;
+		if (!/^`{3}(\w*)/.exec(lines[j]?.trim() ?? "")) continue;
+		const body = [];
+		j++;
+		while (j < lines.length && !/^\s*`{3}/.test(lines[j])) {
+			body.push(lines[j]);
+			j++;
+		}
+		examples.push({
+			title,
+			code: body.join("\n").trim()
+		});
+		i = j;
+	}
+	return {
+		description: desc.join("\n").replace(/\n{3,}/g, "\n\n").replace(/^-{3,}\s*\n/gm, "\n").trim(),
+		examples
+	};
+}
+function pickDoc(name) {
+	const candidates = byName[name];
+	if (!candidates) return void 0;
+	let best;
+	for (const d of candidates) {
+		const before = (scanned[d.file]?.blocks ?? []).filter((b) => b.end < d.line && !/@module\b/.test(b.text));
+		if (!before.length) continue;
+		const near = before[before.length - 1];
+		const gap = d.line - near.end;
+		if (gap > MAX_DOC_GAP_LINES) continue;
+		if (!best || near.end > best.block.end) best = {
+			decl: d,
+			block: near,
+			gap
+		};
+	}
+	return best ?? { decl: candidates[0] };
+}
+var ROOT, SRC, OUTFILE, MAX_DOC_GAP_LINES, DECL_PATTERNS, publicEntries, scanned, byName, pkg, entries, undocumented$1, publicCount, index$1;
+var init_mcp_docs_generate = __esmMin((() => {
+	ROOT = dirname(fileURLToPath(import.meta.url));
+	SRC = join(ROOT, "src");
+	OUTFILE = join(ROOT, "dist", "mcp", "api.json");
+	MAX_DOC_GAP_LINES = 14;
+	DECL_PATTERNS = [
+		[/^(?:export\s+)?(?:async\s+)?function\s*([A-Za-z_$][\w$]*)/, "function"],
+		[/^(?:export\s+)?class\s+([A-Za-z_$][\w$]*)/, "class"],
+		[/^(?:export\s+)?type\s+([A-Za-z_$][\w$]*)(?=[<\s=])/, "type alias"],
+		[/^(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)/, "interface"]
+	];
+	publicEntries = [];
+	for (const dir of [
+		"core",
+		"state",
+		"utils",
+		"types"
+	]) {
+		const barrel = join(SRC, dir, "index.ts");
+		try {
+			publicEntries.push(...readBarrel(barrel));
+		} catch {
+			console.warn(`no barrel at ${barrel}`);
+		}
+	}
+	scanned = Object.fromEntries(walk(SRC).map((file) => [file, scanFile(file)]));
+	byName = {};
+	for (const scan of Object.values(scanned)) for (const d of scan.decls) (byName[d.name] ??= []).push(d);
+	pkg = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8"));
+	entries = {};
+	undocumented$1 = [];
+	for (const pub of publicEntries) {
+		if (pub.hidden) continue;
+		const found = pickDoc(pub.name);
+		if (!found) {
+			undocumented$1.push(`${pub.kind} ${pub.name}`);
+			continue;
+		}
+		const sigs = byName[pub.name].map((d) => d.sig).filter(Boolean);
+		const doc = found.block ? extract(found.block) : {
+			description: "",
+			examples: []
+		};
+		entries[pub.name] = {
+			name: pub.name,
+			kind: found.decl.kind,
+			group: pub.group,
+			file: found.decl.file.replace(ROOT + "/", ""),
+			signatures: sigs.length ? [...new Set(sigs)] : void 0,
+			description: doc.description || void 0,
+			examples: doc.examples.length ? doc.examples : void 0
+		};
+		if (!doc.description) undocumented$1.push(`${pub.kind} ${pub.name}`);
+	}
+	publicCount = publicEntries.filter((p) => !p.hidden).length;
+	index$1 = {
+		libraryVersion: pkg.version,
+		exportedCount: publicCount,
+		entries,
+		undocumented: undocumented$1
+	};
+	if (Boolean(process.argv[1]) && import.meta.url === `file://${resolve(process.argv[1])}`) {
+		writeFileSync(OUTFILE, JSON.stringify(index$1, null, 2));
+		console.log(`${OUTFILE}: ${Object.keys(entries).length} of ${publicCount} public exports documented`);
+		if (undocumented$1.length) {
+			console.warn(`missing doc block (${undocumented$1.length}): ${undocumented$1.join(", ")}`);
+			process.exit(1);
+		}
+	}
+}));
+//#endregion
+//#region src/mcp/index.ts
 /**
 MCP (Model Context Protocol) Server for the Micro Components library.
 
@@ -16,249 +292,193 @@ at the compiled dist/mcp/index.js.
 @example Run from source during development: pnpm run mcp:dev
 @example Regenerate the shipped index only: pnpm run mcp:docs
 */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-import { readdirSync, readFileSync, existsSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MAX_SOURCE_BYTES = 200_000;
-const FENCE = '`'.repeat(3);
-// Development: tsx runs src/mcp/index.ts, where the source file is present, so the
-// index is generated live from src/ and concepts are read straight from docs/concepts.
-// Production: the compiled server sits in dist/mcp, where no .ts source exists, so it
-// reads the prebuilt api.json and the copied concepts/ that the build step emits next to it.
-const IS_DEV = existsSync(join(__dirname, 'index.ts'));
-let index;
-let undocumented;
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var MAX_SOURCE_BYTES = 2e5;
+var FENCE = "`".repeat(3);
+var IS_DEV = existsSync(join(__dirname, "index.ts"));
+var index;
+var undocumented;
 if (IS_DEV) {
-    // variable specifier keeps tsc from resolving the .ts path; tsx resolves it at runtime
-    const generator = '../../mcp-docs-generate.ts';
-    const live = await import(generator);
-    index = live.index;
-    undocumented = live.undocumented;
-}
-else {
-    const data = JSON.parse(readFileSync(join(__dirname, 'api.json'), 'utf8'));
-    index = data;
-    undocumented = data.undocumented;
+	const live = await Promise.resolve().then(() => (init_mcp_docs_generate(), mcp_docs_generate_exports));
+	index = live.index;
+	undocumented = live.undocumented;
+} else {
+	const data = JSON.parse(readFileSync(join(__dirname, "api.json"), "utf8"));
+	index = data;
+	undocumented = data.undocumented;
 }
-const API = index.entries;
+var API = index.entries;
 /** Concept essays live one per file: copied into dist/mcp/concepts in production, read from docs/concepts in development. */
-const CONCEPTS_DIR = IS_DEV ? join(__dirname, '..', '..', 'docs', 'concepts') : join(__dirname, 'concepts');
+var CONCEPTS_DIR = IS_DEV ? join(__dirname, "..", "..", "docs", "concepts") : join(__dirname, "concepts");
 function readConcepts() {
-    if (!existsSync(CONCEPTS_DIR))
-        return {};
-    const out = {};
-    for (const f of readdirSync(CONCEPTS_DIR)) {
-        if (!f.endsWith('.md'))
-            continue;
-        out[f.replace(/\.md$/, '')] = readFileSync(join(CONCEPTS_DIR, f), 'utf8').trim();
-    }
-    return out;
+	if (!existsSync(CONCEPTS_DIR)) return {};
+	const out = {};
+	for (const f of readdirSync(CONCEPTS_DIR)) {
+		if (!f.endsWith(".md")) continue;
+		out[f.replace(/\.md$/, "")] = readFileSync(join(CONCEPTS_DIR, f), "utf8").trim();
+	}
+	return out;
 }
-const CONCEPTS = readConcepts();
-const CONCEPT_NAMES = Object.keys(CONCEPTS);
-// get-source-file is confined to the package root: the installed package in production, the repo root in development.
-const SOURCE_ROOT = join(__dirname, '..', '..');
+var CONCEPTS = readConcepts();
+var CONCEPT_NAMES = Object.keys(CONCEPTS);
+var SOURCE_ROOT = join(__dirname, "..", "..");
 /** First paragraph or sentence of a description, truncated honestly. */
 function summarize(text, limit = 160) {
-    const first = text.split(/\n\s*\n|(?<=[.!?])\s+/)[0] ?? text;
-    const flat = first.replace(/\s+/g, ' ').trim();
-    if (flat.length <= limit)
-        return flat;
-    return `${flat.slice(0, limit).replace(/[\s,\-]+$/, '')}...`;
+	const flat = (text.split(/\n\s*\n|(?<=[.!?])\s+/)[0] ?? text).replace(/\s+/g, " ").trim();
+	if (flat.length <= limit) return flat;
+	return `${flat.slice(0, limit).replace(/[\s,\-]+$/, "")}...`;
 }
-// ---------------------------------------------------------------------------
-// MCP Server Setup
-// ---------------------------------------------------------------------------
-const server = new McpServer({
-    name: 'microcomponents-mcp',
-    version: index.libraryVersion,
+var server = new McpServer({
+	name: "microcomponents-mcp",
+	version: index.libraryVersion
 });
-server.tool('list-components', 'List all documented Micro Components classes, utilities and types with their group and a short summary', {}, async () => {
-    const list = Object.values(API).map((e) => ({
-        name: e.name,
-        kind: e.kind,
-        group: e.group,
-        file: e.file,
-        summary: summarize(e.description ?? '', 120),
-        examples: (e.examples ?? []).length,
-    }));
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    libraryVersion: index.libraryVersion,
-                    exportedCount: index.exportedCount,
-                    components: list,
-                }, null, 2),
-            },
-        ],
-    };
+server.tool("list-components", "List all documented Micro Components classes, utilities and types with their group and a short summary", {}, async () => {
+	const list = Object.values(API).map((e) => ({
+		name: e.name,
+		kind: e.kind,
+		group: e.group,
+		file: e.file,
+		summary: summarize(e.description ?? "", 120),
+		examples: (e.examples ?? []).length
+	}));
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({
+			libraryVersion: index.libraryVersion,
+			exportedCount: index.exportedCount,
+			components: list
+		}, null, 2)
+	}] };
 });
-server.tool('get-component-docs', 'Get comprehensive documentation and usage examples for a Micro Components class or utility', {
-    componentName: z
-        .string()
-        .describe('The name of the component (e.g., DC, defineCE, observe, injectCSS)'),
-}, async ({ componentName }) => {
-    const entry = API[componentName];
-    if (!entry) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `No documentation for "${componentName}". ${Object.keys(API).length} entries exist; call list-components or search-components to discover names.`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    const lines = [
-        `# ${entry.name}`,
-        '',
-        `**Kind:** ${entry.kind ?? 'unknown'}`,
-        ...(entry.group ? [`**Group:** ${entry.group}`] : []),
-        ...(entry.file ? [`**Source:** ${entry.file}`] : []),
-        '',
-    ];
-    if (entry.description)
-        lines.push('## Description', entry.description, '');
-    if (entry.signatures?.length) {
-        lines.push('## Signatures');
-        for (const sig of entry.signatures)
-            lines.push(`${FENCE}ts`, sig, FENCE, '');
-    }
-    const examples = entry.examples ?? [];
-    if (examples.length) {
-        lines.push('## Examples');
-        for (const ex of examples) {
-            if (ex.title)
-                lines.push(`### ${ex.title}`);
-            lines.push(`${FENCE}ts`, ex.code, FENCE, '');
-        }
-    }
-    return { content: [{ type: 'text', text: lines.join('\n') }] };
+server.tool("get-component-docs", "Get comprehensive documentation and usage examples for a Micro Components class or utility", { componentName: z.string().describe("The name of the component (e.g., DC, defineCE, observe, injectCSS)") }, async ({ componentName }) => {
+	const entry = API[componentName];
+	if (!entry) return {
+		content: [{
+			type: "text",
+			text: `No documentation for "${componentName}". ${Object.keys(API).length} entries exist; call list-components or search-components to discover names.`
+		}],
+		isError: true
+	};
+	const lines = [
+		`# ${entry.name}`,
+		"",
+		`**Kind:** ${entry.kind ?? "unknown"}`,
+		...entry.group ? [`**Group:** ${entry.group}`] : [],
+		...entry.file ? [`**Source:** ${entry.file}`] : [],
+		""
+	];
+	if (entry.description) lines.push("## Description", entry.description, "");
+	if (entry.signatures?.length) {
+		lines.push("## Signatures");
+		for (const sig of entry.signatures) lines.push(`${FENCE}ts`, sig, FENCE, "");
+	}
+	const examples = entry.examples ?? [];
+	if (examples.length) {
+		lines.push("## Examples");
+		for (const ex of examples) {
+			if (ex.title) lines.push(`### ${ex.title}`);
+			lines.push(`${FENCE}ts`, ex.code, FENCE, "");
+		}
+	}
+	return { content: [{
+		type: "text",
+		text: lines.join("\n")
+	}] };
 });
-server.tool('search-components', 'Search Micro Components documentation by keyword. Searches names, groups, descriptions and code examples.', {
-    query: z
-        .string()
-        .describe('Search term to find relevant components (e.g., "event", "observable", "css")'),
-}, async ({ query }) => {
-    const q = query.toLowerCase();
-    const scoreEntry = (e) => {
-        let score = 0;
-        if (e.name.toLowerCase() === q)
-            score += 8;
-        if (e.name.toLowerCase().includes(q))
-            score += 4;
-        if ((e.group ?? '').toLowerCase().includes(q))
-            score += 2;
-        if ((e.description ?? '').toLowerCase().includes(q))
-            score += 3;
-        for (const ex of e.examples ?? []) {
-            if (ex.code.toLowerCase().includes(q) || ex.title.toLowerCase().includes(q))
-                score += 2;
-        }
-        return score;
-    };
-    const hits = Object.values(API)
-        .map((e) => ({ e, s: scoreEntry(e) }))
-        .filter((h) => h.s > 0)
-        .sort((a, b) => b.s - a.s || a.e.name.localeCompare(b.e.name))
-        .slice(0, 12);
-    const conceptHits = CONCEPT_NAMES.filter((k) => CONCEPTS[k].toLowerCase().includes(q));
-    if (!hits.length && !conceptHits.length) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `No documentation matched "${query}". Use list-components to see every entry, or get-source-file for raw source.`,
-                },
-            ],
-        };
-    }
-    const results = hits.map((h) => ({
-        name: h.e.name,
-        kind: h.e.kind,
-        group: h.e.group,
-        relevance: h.s,
-        snippet: summarize(h.e.description ?? '', 150),
-    }));
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({ query, results, conceptMatches: conceptHits }, null, 2),
-            },
-        ],
-    };
+server.tool("search-components", "Search Micro Components documentation by keyword. Searches names, groups, descriptions and code examples.", { query: z.string().describe("Search term to find relevant components (e.g., \"event\", \"observable\", \"css\")") }, async ({ query }) => {
+	const q = query.toLowerCase();
+	const scoreEntry = (e) => {
+		let score = 0;
+		if (e.name.toLowerCase() === q) score += 8;
+		if (e.name.toLowerCase().includes(q)) score += 4;
+		if ((e.group ?? "").toLowerCase().includes(q)) score += 2;
+		if ((e.description ?? "").toLowerCase().includes(q)) score += 3;
+		for (const ex of e.examples ?? []) if (ex.code.toLowerCase().includes(q) || ex.title.toLowerCase().includes(q)) score += 2;
+		return score;
+	};
+	const hits = Object.values(API).map((e) => ({
+		e,
+		s: scoreEntry(e)
+	})).filter((h) => h.s > 0).sort((a, b) => b.s - a.s || a.e.name.localeCompare(b.e.name)).slice(0, 12);
+	const conceptHits = CONCEPT_NAMES.filter((k) => CONCEPTS[k].toLowerCase().includes(q));
+	if (!hits.length && !conceptHits.length) return { content: [{
+		type: "text",
+		text: `No documentation matched "${query}". Use list-components to see every entry, or get-source-file for raw source.`
+	}] };
+	const results = hits.map((h) => ({
+		name: h.e.name,
+		kind: h.e.kind,
+		group: h.e.group,
+		relevance: h.s,
+		snippet: summarize(h.e.description ?? "", 150)
+	}));
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({
+			query,
+			results,
+			conceptMatches: conceptHits
+		}, null, 2)
+	}] };
 });
-server.tool('get-core-concept', `Get a core Micro Components concept essay. Available: ${CONCEPT_NAMES.join(', ') || 'none'}`, { concept: z.string().describe(`Concept name, one of: ${CONCEPT_NAMES.join(', ')}`) }, async ({ concept }) => {
-    const content = CONCEPTS[concept];
-    if (!content) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Concept "${concept}" not found. Available: ${CONCEPT_NAMES.join(', ')}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    return { content: [{ type: 'text', text: content }] };
+server.tool("get-core-concept", `Get a core Micro Components concept essay. Available: ${CONCEPT_NAMES.join(", ") || "none"}`, { concept: z.string().describe(`Concept name, one of: ${CONCEPT_NAMES.join(", ")}`) }, async ({ concept }) => {
+	const content = CONCEPTS[concept];
+	if (!content) return {
+		content: [{
+			type: "text",
+			text: `Concept "${concept}" not found. Available: ${CONCEPT_NAMES.join(", ")}`
+		}],
+		isError: true
+	};
+	return { content: [{
+		type: "text",
+		text: content
+	}] };
 });
-server.tool('get-source-file', 'Retrieve the actual source code from a Micro Components library file (package-root relative)', {
-    filepath: z
-        .string()
-        .describe('Path to source file, e.g. dist/core/MC.js, dist/core/MC.d.ts, dist/mcp/concepts/event-system.md'),
-}, async ({ filepath }) => {
-    const full = resolve(SOURCE_ROOT, filepath);
-    // confine reads to the shipped sources so a caller cannot traverse outside them.
-    if (full !== SOURCE_ROOT && !full.startsWith(SOURCE_ROOT + '/')) {
-        return {
-            content: [{ type: 'text', text: `Refused: "${filepath}" is outside the package sources.` }],
-            isError: true,
-        };
-    }
-    if (!existsSync(full)) {
-        return { content: [{ type: 'text', text: `File not found: ${filepath}` }], isError: true };
-    }
-    try {
-        const source = readFileSync(full, 'utf8');
-        if (source.length > MAX_SOURCE_BYTES) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `File too large (${source.length} bytes). Request a specific symbol via get-component-docs instead.`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        return { content: [{ type: 'text', text: source }] };
-    }
-    catch (error) {
-        return { content: [{ type: 'text', text: `Error reading file: ${error}` }], isError: true };
-    }
+server.tool("get-source-file", "Retrieve the actual source code from a Micro Components library file (package-root relative)", { filepath: z.string().describe("Path to source file, e.g. dist/core/MC.js, dist/core/MC.d.ts, dist/mcp/concepts/event-system.md") }, async ({ filepath }) => {
+	const full = resolve(SOURCE_ROOT, filepath);
+	if (full !== SOURCE_ROOT && !full.startsWith(SOURCE_ROOT + "/")) return {
+		content: [{
+			type: "text",
+			text: `Refused: "${filepath}" is outside the package sources.`
+		}],
+		isError: true
+	};
+	if (!existsSync(full)) return {
+		content: [{
+			type: "text",
+			text: `File not found: ${filepath}`
+		}],
+		isError: true
+	};
+	try {
+		const source = readFileSync(full, "utf8");
+		if (source.length > MAX_SOURCE_BYTES) return {
+			content: [{
+				type: "text",
+				text: `File too large (${source.length} bytes). Request a specific symbol via get-component-docs instead.`
+			}],
+			isError: true
+		};
+		return { content: [{
+			type: "text",
+			text: source
+		}] };
+	} catch (error) {
+		return {
+			content: [{
+				type: "text",
+				text: `Error reading file: ${error}`
+			}],
+			isError: true
+		};
+	}
 });
-server.tool('list-undocumented', 'Report public exports whose source lacks a doc block — the drift signal for src/ documentation', {}, async () => ({
-    content: [
-        {
-            type: 'text',
-            text: undocumented.length
-                ? `${undocumented.length} undocumented export(s):\n${undocumented.join('\n')}`
-                : `All ${index.exportedCount} public exports carry a doc block.`,
-        },
-    ],
-}));
-// ============================================================================
-// Start Server
-// ============================================================================
-const transport = new StdioServerTransport();
+server.tool("list-undocumented", "Report public exports whose source lacks a doc block — the drift signal for src/ documentation", {}, async () => ({ content: [{
+	type: "text",
+	text: undocumented.length ? `${undocumented.length} undocumented export(s):\n${undocumented.join("\n")}` : `All ${index.exportedCount} public exports carry a doc block.`
+}] }));
+var transport = new StdioServerTransport();
 await server.connect(transport);
 console.error(`Micro Components MCP server running on stdio (library ${index.libraryVersion}, ${Object.keys(API).length} documented exports)`);
+//#endregion