@mantine/mcp-server 9.6.3 → 9.7.1

package/README.md

@@ -15,7 +15,12 @@ npx @mantine/mcp-server
 
 ## Tools
 
-- `list_items`
-- `get_item_doc`
-- `get_item_props`
-- `search_docs`
+- `search_docs` – search all documentation; returns ranked matches, often pointing at a specific section
+- `get_item_doc` – outline by default, one section with `section`, whole page with `full: true`
+- `get_item_props` – component props, or a hook's TypeScript signature
+- `list_items` – filter by `kind`, `group`, `category`, `package` or `query`
+- `get_api` – resolve a symbol (`useForm`, `useDisclosure`) to its signature
+
+## Coverage
+
+406 documents: components, hooks, `@mantine/form`, styling, theming, framework and migration guides, and FAQ pages. Changelogs are not indexed.

package/cjs/data-client.cjs

@@ -1,127 +1,257 @@
 "use client";
+const require_search = require("./search.cjs");
 //#region packages/@mantine/mcp-server/src/data-client.ts
-function normalizeValue(value) {
+function normalize(value) {
 	return value.trim().toLowerCase();
 }
 function clampLimit(limit, fallback, max) {
 	if (typeof limit !== "number" || Number.isNaN(limit)) return fallback;
 	return Math.max(1, Math.min(max, Math.floor(limit)));
 }
+const INDEX_REVALIDATE_INTERVAL_MS = 3e5;
+/** Fetches and caches the static MCP data published alongside the docs site */
 var MantineMcpDataClient = class {
 	constructor(baseUrl = "https://mantine.dev/mcp", timeoutMs = 1e4) {
 		this.indexCache = null;
-		this.itemCache = /* @__PURE__ */ new Map();
+		this.indexEtag = null;
+		this.indexCheckedAt = 0;
+		this.sectionsCache = null;
+		this.docCache = /* @__PURE__ */ new Map();
+		this.scorer = null;
 		this.baseUrl = baseUrl.replace(/\/+$/, "");
 		this.timeoutMs = timeoutMs;
 	}
-	async fetchJson(relativePath) {
+	async fetchJson(relativePath, etag) {
 		const controller = new AbortController();
 		const timer = setTimeout(() => controller.abort(), this.timeoutMs);
 		try {
 			const url = `${this.baseUrl}/${relativePath.replace(/^\/+/, "")}`;
-			const response = await fetch(url, { signal: controller.signal });
+			const headers = etag ? { "If-None-Match": etag } : void 0;
+			const response = await fetch(url, {
+				signal: controller.signal,
+				headers
+			});
+			if (response.status === 304) return {
+				data: null,
+				etag
+			};
 			if (!response.ok) throw new Error(`Failed to fetch ${url}: ${response.status}`);
-			return await response.json();
+			return {
+				data: await response.json(),
+				etag: response.headers.get("etag")
+			};
 		} finally {
 			clearTimeout(timer);
 		}
 	}
+	/**
+	* Re-fetches the index if the published copy changed since it was cached.
+	*
+	* Best-effort: a revalidation failure (network blip, non-ok response) is logged and
+	* swallowed so the still-good cached index keeps serving the in-flight request instead of
+	* failing it outright.
+	*/
+	async revalidateIndex() {
+		try {
+			const { data, etag } = await this.fetchJson("index.json", this.indexEtag);
+			if (data) {
+				this.indexCache = data;
+				this.indexEtag = etag ?? null;
+				this.sectionsCache = null;
+				this.docCache.clear();
+				this.scorer = null;
+			}
+		} catch (error) {
+			console.error("Failed to revalidate Mantine MCP index, serving cached data", error);
+		}
+	}
 	async getIndex() {
-		if (this.indexCache) return this.indexCache;
-		this.indexCache = await this.fetchJson("index.json");
+		if (!this.indexCache) {
+			const { data, etag } = await this.fetchJson("index.json");
+			this.indexCache = data ?? [];
+			this.indexEtag = etag ?? null;
+			this.indexCheckedAt = Date.now();
+			return this.indexCache;
+		}
+		const now = Date.now();
+		if (now - this.indexCheckedAt >= INDEX_REVALIDATE_INTERVAL_MS) {
+			this.indexCheckedAt = now;
+			await this.revalidateIndex();
+		}
 		return this.indexCache;
 	}
+	async getSections() {
+		if (this.sectionsCache) return this.sectionsCache;
+		const { data } = await this.fetchJson("sections.json");
+		this.sectionsCache = data ?? [];
+		return this.sectionsCache;
+	}
+	async getScorer() {
+		if (this.scorer) return this.scorer;
+		const index = await this.getIndex();
+		const sections = await this.getSections();
+		this.scorer = require_search.createSearchScorer(index, sections);
+		return this.scorer;
+	}
+	async getDocData(id) {
+		const cached = this.docCache.get(id);
+		if (cached) return cached;
+		const { data } = await this.fetchJson(`docs/${id}.json`);
+		if (!data) throw new Error(`Missing document data for ${id}`);
+		this.docCache.set(id, data);
+		return data;
+	}
 	async listItems(args = {}) {
-		const kind = args.kind || "component";
-		const query = args.query ? normalizeValue(args.query) : null;
-		const packageName = args.package ? normalizeValue(args.package) : null;
-		const limit = clampLimit(args.limit, 30, 200);
-		return (await this.getIndex()).filter((item) => item.kind === kind).filter((item) => packageName ? normalizeValue(item.package) === packageName : true).filter((item) => {
-			if (!query) return true;
-			return normalizeValue(item.name).includes(query) || normalizeValue(item.description).includes(query) || normalizeValue(item.searchText).includes(query);
-		}).slice(0, limit);
+		const limit = clampLimit(args.limit, 30, 500);
+		const query = args.query ? normalize(args.query) : null;
+		return (await this.getIndex()).filter((item) => args.kind ? item.kind === args.kind : true).filter((item) => args.group ? item.group === args.group : true).filter((item) => args.category ? normalize(item.category) === normalize(args.category) : true).filter((item) => args.package ? normalize(item.package || "") === normalize(args.package) : true).filter((item) => query ? item.searchText.includes(query) : true).slice(0, limit);
+	}
+	async findItem(args) {
+		const requested = normalize(args.name);
+		const index = await this.getIndex();
+		const candidates = args.kind ? index.filter((item) => item.kind === args.kind) : index;
+		return candidates.find((item) => normalize(item.id) === requested) || candidates.find((item) => normalize(item.name) === requested) || candidates.find((item) => normalize(item.name).startsWith(requested)) || candidates.find((item) => item.searchText.includes(requested)) || null;
 	}
-	scoreMatch(item, query) {
-		const normalizedQuery = normalizeValue(query);
-		const normalizedName = normalizeValue(item.name);
-		if (normalizedName === normalizedQuery) return 100;
-		if (normalizedName.startsWith(normalizedQuery)) return 80;
-		if (normalizedName.includes(normalizedQuery)) return 70;
-		if (normalizeValue(item.searchText).includes(normalizedQuery)) return 40;
-		const tokens = normalizedQuery.split(/\s+/).filter(Boolean);
-		const matchedTokens = tokens.filter((token) => normalizeValue(item.searchText).includes(token));
-		if (tokens.length > 0 && matchedTokens.length > 0) return 10 + matchedTokens.length / tokens.length * 20;
-		return 0;
+	/** Names close to a failed lookup, for a helpful error message */
+	async suggestFor(name) {
+		return require_search.suggestNames(await this.getIndex(), name);
 	}
-	async searchDocs(args) {
-		const kind = args.kind || "component";
+	async search(args) {
 		const limit = clampLimit(args.limit, 20, 100);
 		const query = args.query.trim();
 		if (!query) return [];
-		return (await this.getIndex()).filter((item) => item.kind === kind).map((item) => ({
+		const index = await this.getIndex();
+		const sections = await this.getSections();
+		const scorer = await this.getScorer();
+		const allowed = index.filter((item) => args.kind ? item.kind === args.kind : true).filter((item) => args.package ? normalize(item.package || "") === normalize(args.package) : true);
+		const allowedIds = new Map(allowed.map((item) => [item.id, item]));
+		const sectionHits = sections.filter((section) => allowedIds.has(section.id)).map((section) => ({
+			section,
+			score: scorer.scoreSection(section, query)
+		})).filter((entry) => entry.score > 0);
+		const pageHits = allowed.map((item) => ({
 			item,
-			score: this.scoreMatch(item, query)
-		})).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score).slice(0, limit).map((entry) => ({
+			score: scorer.scoreItem(item, query)
+		})).filter((entry) => entry.score > 0);
+		const merged = /* @__PURE__ */ new Map();
+		pageHits.forEach((hit) => {
+			merged.set(hit.item.id, {
+				item: hit.item,
+				score: hit.score
+			});
+		});
+		sectionHits.forEach((hit) => {
+			const item = allowedIds.get(hit.section.id);
+			const key = `${hit.section.id}#${hit.section.slug}`;
+			merged.set(key, {
+				item,
+				section: hit.section,
+				score: hit.score
+			});
+		});
+		return Array.from(merged.values()).sort((a, b) => b.score - a.score).slice(0, limit).map((entry) => ({
 			id: entry.item.id,
 			name: entry.item.name,
 			kind: entry.item.kind,
 			package: entry.item.package,
 			route: entry.item.route,
+			docsUrl: entry.item.docsUrl,
 			description: entry.item.description,
+			section: entry.section?.slug,
+			heading: entry.section?.heading,
+			snippet: entry.section?.snippet,
 			score: Number(entry.score.toFixed(2))
 		}));
 	}
-	async getItemDataById(id) {
-		const cached = this.itemCache.get(id);
-		if (cached) return cached;
-		const data = await this.fetchJson(`components/${id}.json`);
-		this.itemCache.set(id, data);
-		return data;
-	}
-	async findItem(args) {
-		const kind = args.kind || "component";
-		const requested = normalizeValue(args.name);
-		const byKind = (await this.getIndex()).filter((item) => item.kind === kind);
-		const exactId = byKind.find((item) => normalizeValue(item.id) === requested);
-		if (exactId) return exactId;
-		const exactName = byKind.find((item) => normalizeValue(item.name) === requested);
-		if (exactName) return exactName;
-		const prefixName = byKind.find((item) => normalizeValue(item.name).startsWith(requested));
-		if (prefixName) return prefixName;
-		return byKind.find((item) => normalizeValue(item.searchText).includes(requested)) || null;
-	}
-	async getItemDoc(args) {
+	async getDoc(args) {
 		const item = await this.findItem(args);
 		if (!item) return null;
-		const data = await this.getItemDataById(item.id);
+		const data = await this.getDocData(item.id);
+		if (args.full) return {
+			item,
+			mode: "full",
+			markdown: [data.intro, ...data.sections.map((s) => `## ${s.heading}\n\n${s.body}`)].join("\n\n")
+		};
+		if (args.section) {
+			const requested = normalize(args.section);
+			const section = data.sections.find((s) => s.slug === requested) || data.sections.find((s) => normalize(s.heading) === requested);
+			if (!section) return {
+				item,
+				mode: "section-not-found",
+				availableSections: data.sections.map((s) => s.slug)
+			};
+			return {
+				item,
+				mode: "section",
+				heading: section.heading,
+				markdown: section.body
+			};
+		}
 		return {
-			item: {
-				id: data.id,
-				name: data.name,
-				kind: data.kind,
-				package: data.package,
-				route: data.route,
-				description: data.description,
-				llmUrl: data.llmUrl
-			},
-			markdown: data.markdown
+			item,
+			mode: "outline",
+			intro: data.intro,
+			sections: data.sections.map((s) => ({
+				slug: s.slug,
+				heading: s.heading
+			})),
+			source: data.source,
+			docs: data.docs
 		};
 	}
-	async getItemProps(args) {
+	/** The section that most plausibly documents a page's API, when no structured props or signature exist */
+	findApiSection(sections) {
+		return sections.find((s) => /api|return type|overview/i.test(s.heading));
+	}
+	async getProps(args) {
 		const item = await this.findItem(args);
 		if (!item) return null;
-		const data = await this.getItemDataById(item.id);
-		return {
-			item: {
-				id: data.id,
-				name: data.name,
-				kind: data.kind,
-				package: data.package,
-				route: data.route,
-				description: data.description
-			},
+		const data = await this.getDocData(item.id);
+		if (data.props.length > 0) return {
+			item,
+			kind: "props",
 			props: data.props
 		};
+		if (data.signature) return {
+			item,
+			kind: "signature",
+			signature: data.signature,
+			exportedTypeNames: data.exportedTypeNames
+		};
+		const apiSection = this.findApiSection(data.sections);
+		return {
+			item,
+			kind: "sections",
+			message: `${item.name} has no generated props or signature. Use get_item_doc with a section instead.`,
+			suggestedSection: apiSection?.slug,
+			availableSections: data.sections.map((s) => s.slug)
+		};
+	}
+	async getApi(symbol) {
+		const index = await this.getIndex();
+		const requested = normalize(symbol);
+		const candidates = index.filter((item) => item.hasSignature || item.propsCount > 0 || item.kind === "hook");
+		const match = candidates.find((item) => normalize(item.name).replace(/-/g, "") === requested.replace(/-/g, "")) || candidates.find((item) => item.searchText.includes(requested));
+		if (!match) return null;
+		const data = await this.getDocData(match.id);
+		const hasExportedTypeNames = !!data.exportedTypeNames && data.exportedTypeNames.length > 0;
+		if (!data.signature && !hasExportedTypeNames) {
+			const apiSection = this.findApiSection(data.sections);
+			return {
+				item: match,
+				signature: data.signature,
+				exportedTypeNames: data.exportedTypeNames,
+				propsCount: data.props.length,
+				suggestedSection: apiSection?.slug,
+				availableSections: data.sections.map((s) => s.slug)
+			};
+		}
+		return {
+			item: match,
+			signature: data.signature,
+			exportedTypeNames: data.exportedTypeNames,
+			propsCount: data.props.length
+		};
 	}
 };
 //#endregion

package/cjs/data-client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-client.cjs","names":[],"sources":["../src/data-client.ts"],"sourcesContent":["import { GetItemArgs, IndexItem, ItemData, ItemKind, ListItemsArgs, SearchDocsArgs } from './types';\n\nfunction normalizeValue(value: string) {\n  return value.trim().toLowerCase();\n}\n\nfunction clampLimit(limit: number | undefined, fallback: number, max: number) {\n  if (typeof limit !== 'number' || Number.isNaN(limit)) {\n    return fallback;\n  }\n\n  return Math.max(1, Math.min(max, Math.floor(limit)));\n}\n\nexport class MantineMcpDataClient {\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private indexCache: IndexItem[] | null = null;\n  private itemCache = new Map<string, ItemData>();\n\n  constructor(baseUrl = 'https://mantine.dev/mcp', timeoutMs = 10000) {\n    this.baseUrl = baseUrl.replace(/\\/+$/, '');\n    this.timeoutMs = timeoutMs;\n  }\n\n  private async fetchJson<T>(relativePath: string): Promise<T> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const url = `${this.baseUrl}/${relativePath.replace(/^\\/+/, '')}`;\n      const response = await fetch(url, { signal: controller.signal });\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch ${url}: ${response.status}`);\n      }\n\n      return (await response.json()) as T;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async getIndex() {\n    if (this.indexCache) {\n      return this.indexCache;\n    }\n\n    this.indexCache = await this.fetchJson<IndexItem[]>('index.json');\n    return this.indexCache;\n  }\n\n  async listItems(args: ListItemsArgs = {}) {\n    const kind = args.kind || 'component';\n    const query = args.query ? normalizeValue(args.query) : null;\n    const packageName = args.package ? normalizeValue(args.package) : null;\n    const limit = clampLimit(args.limit, 30, 200);\n\n    const index = await this.getIndex();\n\n    return index\n      .filter((item) => item.kind === kind)\n      .filter((item) => (packageName ? normalizeValue(item.package) === packageName : true))\n      .filter((item) => {\n        if (!query) {\n          return true;\n        }\n\n        return (\n          normalizeValue(item.name).includes(query) ||\n          normalizeValue(item.description).includes(query) ||\n          normalizeValue(item.searchText).includes(query)\n        );\n      })\n      .slice(0, limit);\n  }\n\n  private scoreMatch(item: IndexItem, query: string) {\n    const normalizedQuery = normalizeValue(query);\n    const normalizedName = normalizeValue(item.name);\n\n    if (normalizedName === normalizedQuery) {\n      return 100;\n    }\n\n    if (normalizedName.startsWith(normalizedQuery)) {\n      return 80;\n    }\n\n    if (normalizedName.includes(normalizedQuery)) {\n      return 70;\n    }\n\n    if (normalizeValue(item.searchText).includes(normalizedQuery)) {\n      return 40;\n    }\n\n    const tokens = normalizedQuery.split(/\\s+/).filter(Boolean);\n    const matchedTokens = tokens.filter((token) => normalizeValue(item.searchText).includes(token));\n\n    if (tokens.length > 0 && matchedTokens.length > 0) {\n      return 10 + (matchedTokens.length / tokens.length) * 20;\n    }\n\n    return 0;\n  }\n\n  async searchDocs(args: SearchDocsArgs) {\n    const kind: ItemKind = args.kind || 'component';\n    const limit = clampLimit(args.limit, 20, 100);\n    const query = args.query.trim();\n\n    if (!query) {\n      return [];\n    }\n\n    const index = await this.getIndex();\n\n    return index\n      .filter((item) => item.kind === kind)\n      .map((item) => ({ item, score: this.scoreMatch(item, query) }))\n      .filter((entry) => entry.score > 0)\n      .sort((a, b) => b.score - a.score)\n      .slice(0, limit)\n      .map((entry) => ({\n        id: entry.item.id,\n        name: entry.item.name,\n        kind: entry.item.kind,\n        package: entry.item.package,\n        route: entry.item.route,\n        description: entry.item.description,\n        score: Number(entry.score.toFixed(2)),\n      }));\n  }\n\n  private async getItemDataById(id: string): Promise<ItemData> {\n    const cached = this.itemCache.get(id);\n    if (cached) {\n      return cached;\n    }\n\n    const data = await this.fetchJson<ItemData>(`components/${id}.json`);\n    this.itemCache.set(id, data);\n    return data;\n  }\n\n  async findItem(args: GetItemArgs) {\n    const kind = args.kind || 'component';\n    const requested = normalizeValue(args.name);\n    const index = await this.getIndex();\n\n    const byKind = index.filter((item) => item.kind === kind);\n\n    const exactId = byKind.find((item) => normalizeValue(item.id) === requested);\n    if (exactId) {\n      return exactId;\n    }\n\n    const exactName = byKind.find((item) => normalizeValue(item.name) === requested);\n    if (exactName) {\n      return exactName;\n    }\n\n    const prefixName = byKind.find((item) => normalizeValue(item.name).startsWith(requested));\n    if (prefixName) {\n      return prefixName;\n    }\n\n    return byKind.find((item) => normalizeValue(item.searchText).includes(requested)) || null;\n  }\n\n  async getItemDoc(args: GetItemArgs) {\n    const item = await this.findItem(args);\n    if (!item) {\n      return null;\n    }\n\n    const data = await this.getItemDataById(item.id);\n\n    return {\n      item: {\n        id: data.id,\n        name: data.name,\n        kind: data.kind,\n        package: data.package,\n        route: data.route,\n        description: data.description,\n        llmUrl: data.llmUrl,\n      },\n      markdown: data.markdown,\n    };\n  }\n\n  async getItemProps(args: GetItemArgs) {\n    const item = await this.findItem(args);\n    if (!item) {\n      return null;\n    }\n\n    const data = await this.getItemDataById(item.id);\n\n    return {\n      item: {\n        id: data.id,\n        name: data.name,\n        kind: data.kind,\n        package: data.package,\n        route: data.route,\n        description: data.description,\n      },\n      props: data.props,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"data-client.cjs","names":["createSearchScorer","suggestNames"],"sources":["../src/data-client.ts"],"sourcesContent":["import { createSearchScorer, SearchScorer, suggestNames } from './search';\nimport {\n  DocData,\n  GetItemArgs,\n  IndexItem,\n  ListItemsArgs,\n  SearchDocsArgs,\n  SectionRecord,\n} from './types';\n\nfunction normalize(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction clampLimit(limit: number | undefined, fallback: number, max: number): number {\n  if (typeof limit !== 'number' || Number.isNaN(limit)) {\n    return fallback;\n  }\n\n  return Math.max(1, Math.min(max, Math.floor(limit)));\n}\n\nconst INDEX_REVALIDATE_INTERVAL_MS = 5 * 60 * 1000;\n\n/** Fetches and caches the static MCP data published alongside the docs site */\nexport class MantineMcpDataClient {\n  private readonly baseUrl: string;\n  private readonly timeoutMs: number;\n  private indexCache: IndexItem[] | null = null;\n  private indexEtag: string | null = null;\n  private indexCheckedAt = 0;\n  private sectionsCache: SectionRecord[] | null = null;\n  private docCache = new Map<string, DocData>();\n  private scorer: SearchScorer | null = null;\n\n  constructor(baseUrl = 'https://mantine.dev/mcp', timeoutMs = 10000) {\n    this.baseUrl = baseUrl.replace(/\\/+$/, '');\n    this.timeoutMs = timeoutMs;\n  }\n\n  private async fetchJson<T>(relativePath: string, etag?: string | null) {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n\n    try {\n      const url = `${this.baseUrl}/${relativePath.replace(/^\\/+/, '')}`;\n      const headers = etag ? { 'If-None-Match': etag } : undefined;\n      const response = await fetch(url, { signal: controller.signal, headers });\n\n      if (response.status === 304) {\n        return { data: null as T | null, etag };\n      }\n\n      if (!response.ok) {\n        throw new Error(`Failed to fetch ${url}: ${response.status}`);\n      }\n\n      return { data: (await response.json()) as T, etag: response.headers.get('etag') };\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  /**\n   * Re-fetches the index if the published copy changed since it was cached.\n   *\n   * Best-effort: a revalidation failure (network blip, non-ok response) is logged and\n   * swallowed so the still-good cached index keeps serving the in-flight request instead of\n   * failing it outright.\n   */\n  private async revalidateIndex(): Promise<void> {\n    try {\n      const { data, etag } = await this.fetchJson<IndexItem[]>('index.json', this.indexEtag);\n\n      if (data) {\n        this.indexCache = data;\n        this.indexEtag = etag ?? null;\n        this.sectionsCache = null;\n        this.docCache.clear();\n        this.scorer = null;\n      }\n    } catch (error) {\n      // oxlint-disable-next-line no-console\n      console.error('Failed to revalidate Mantine MCP index, serving cached data', error);\n    }\n  }\n\n  async getIndex(): Promise<IndexItem[]> {\n    if (!this.indexCache) {\n      const { data, etag } = await this.fetchJson<IndexItem[]>('index.json');\n      this.indexCache = data ?? [];\n      this.indexEtag = etag ?? null;\n      this.indexCheckedAt = Date.now();\n      return this.indexCache;\n    }\n\n    const now = Date.now();\n    if (now - this.indexCheckedAt >= INDEX_REVALIDATE_INTERVAL_MS) {\n      this.indexCheckedAt = now;\n      await this.revalidateIndex();\n    }\n\n    return this.indexCache;\n  }\n\n  async getSections(): Promise<SectionRecord[]> {\n    if (this.sectionsCache) {\n      return this.sectionsCache;\n    }\n\n    const { data } = await this.fetchJson<SectionRecord[]>('sections.json');\n    this.sectionsCache = data ?? [];\n    return this.sectionsCache;\n  }\n\n  private async getScorer(): Promise<SearchScorer> {\n    if (this.scorer) {\n      return this.scorer;\n    }\n\n    const index = await this.getIndex();\n    const sections = await this.getSections();\n    this.scorer = createSearchScorer(index, sections);\n    return this.scorer;\n  }\n\n  private async getDocData(id: string): Promise<DocData> {\n    const cached = this.docCache.get(id);\n    if (cached) {\n      return cached;\n    }\n\n    const { data } = await this.fetchJson<DocData>(`docs/${id}.json`);\n    if (!data) {\n      throw new Error(`Missing document data for ${id}`);\n    }\n\n    this.docCache.set(id, data);\n    return data;\n  }\n\n  async listItems(args: ListItemsArgs = {}): Promise<IndexItem[]> {\n    const limit = clampLimit(args.limit, 30, 500);\n    const query = args.query ? normalize(args.query) : null;\n    const index = await this.getIndex();\n\n    return index\n      .filter((item) => (args.kind ? item.kind === args.kind : true))\n      .filter((item) => (args.group ? item.group === args.group : true))\n      .filter((item) =>\n        args.category ? normalize(item.category) === normalize(args.category) : true\n      )\n      .filter((item) =>\n        args.package ? normalize(item.package || '') === normalize(args.package) : true\n      )\n      .filter((item) => (query ? item.searchText.includes(query) : true))\n      .slice(0, limit);\n  }\n\n  async findItem(args: GetItemArgs): Promise<IndexItem | null> {\n    const requested = normalize(args.name);\n    const index = await this.getIndex();\n    const candidates = args.kind ? index.filter((item) => item.kind === args.kind) : index;\n\n    return (\n      candidates.find((item) => normalize(item.id) === requested) ||\n      candidates.find((item) => normalize(item.name) === requested) ||\n      candidates.find((item) => normalize(item.name).startsWith(requested)) ||\n      candidates.find((item) => item.searchText.includes(requested)) ||\n      null\n    );\n  }\n\n  /** Names close to a failed lookup, for a helpful error message */\n  async suggestFor(name: string): Promise<string[]> {\n    return suggestNames(await this.getIndex(), name);\n  }\n\n  async search(args: SearchDocsArgs) {\n    const limit = clampLimit(args.limit, 20, 100);\n    const query = args.query.trim();\n\n    if (!query) {\n      return [];\n    }\n\n    const index = await this.getIndex();\n    const sections = await this.getSections();\n    const scorer = await this.getScorer();\n\n    const allowed = index\n      .filter((item) => (args.kind ? item.kind === args.kind : true))\n      .filter((item) =>\n        args.package ? normalize(item.package || '') === normalize(args.package) : true\n      );\n    const allowedIds = new Map(allowed.map((item) => [item.id, item]));\n\n    const sectionHits = sections\n      .filter((section) => allowedIds.has(section.id))\n      .map((section) => ({ section, score: scorer.scoreSection(section, query) }))\n      .filter((entry) => entry.score > 0);\n\n    const pageHits = allowed\n      .map((item) => ({ item, score: scorer.scoreItem(item, query) }))\n      .filter((entry) => entry.score > 0);\n\n    const merged = new Map<string, { item: IndexItem; section?: SectionRecord; score: number }>();\n\n    pageHits.forEach((hit) => {\n      merged.set(hit.item.id, { item: hit.item, score: hit.score });\n    });\n\n    sectionHits.forEach((hit) => {\n      const item = allowedIds.get(hit.section.id)!;\n      const key = `${hit.section.id}#${hit.section.slug}`;\n      merged.set(key, { item, section: hit.section, score: hit.score });\n    });\n\n    return Array.from(merged.values())\n      .sort((a, b) => b.score - a.score)\n      .slice(0, limit)\n      .map((entry) => ({\n        id: entry.item.id,\n        name: entry.item.name,\n        kind: entry.item.kind,\n        package: entry.item.package,\n        route: entry.item.route,\n        docsUrl: entry.item.docsUrl,\n        description: entry.item.description,\n        section: entry.section?.slug,\n        heading: entry.section?.heading,\n        snippet: entry.section?.snippet,\n        score: Number(entry.score.toFixed(2)),\n      }));\n  }\n\n  async getDoc(args: GetItemArgs) {\n    const item = await this.findItem(args);\n    if (!item) {\n      return null;\n    }\n\n    const data = await this.getDocData(item.id);\n\n    if (args.full) {\n      const body = [data.intro, ...data.sections.map((s) => `## ${s.heading}\\n\\n${s.body}`)].join(\n        '\\n\\n'\n      );\n      return { item, mode: 'full' as const, markdown: body };\n    }\n\n    if (args.section) {\n      const requested = normalize(args.section);\n      const section =\n        data.sections.find((s) => s.slug === requested) ||\n        data.sections.find((s) => normalize(s.heading) === requested);\n\n      if (!section) {\n        return {\n          item,\n          mode: 'section-not-found' as const,\n          availableSections: data.sections.map((s) => s.slug),\n        };\n      }\n\n      return { item, mode: 'section' as const, heading: section.heading, markdown: section.body };\n    }\n\n    return {\n      item,\n      mode: 'outline' as const,\n      intro: data.intro,\n      sections: data.sections.map((s) => ({ slug: s.slug, heading: s.heading })),\n      source: data.source,\n      docs: data.docs,\n    };\n  }\n\n  /** The section that most plausibly documents a page's API, when no structured props or signature exist */\n  private findApiSection(sections: DocData['sections']) {\n    return sections.find((s) => /api|return type|overview/i.test(s.heading));\n  }\n\n  async getProps(args: GetItemArgs) {\n    const item = await this.findItem(args);\n    if (!item) {\n      return null;\n    }\n\n    const data = await this.getDocData(item.id);\n\n    if (data.props.length > 0) {\n      return { item, kind: 'props' as const, props: data.props };\n    }\n\n    if (data.signature) {\n      return {\n        item,\n        kind: 'signature' as const,\n        signature: data.signature,\n        exportedTypeNames: data.exportedTypeNames,\n      };\n    }\n\n    const apiSection = this.findApiSection(data.sections);\n\n    return {\n      item,\n      kind: 'sections' as const,\n      message: `${item.name} has no generated props or signature. Use get_item_doc with a section instead.`,\n      suggestedSection: apiSection?.slug,\n      availableSections: data.sections.map((s) => s.slug),\n    };\n  }\n\n  async getApi(symbol: string) {\n    const index = await this.getIndex();\n    const requested = normalize(symbol);\n\n    const candidates = index.filter(\n      (item) => item.hasSignature || item.propsCount > 0 || item.kind === 'hook'\n    );\n\n    const match =\n      candidates.find(\n        (item) => normalize(item.name).replace(/-/g, '') === requested.replace(/-/g, '')\n      ) || candidates.find((item) => item.searchText.includes(requested));\n\n    if (!match) {\n      return null;\n    }\n\n    const data = await this.getDocData(match.id);\n    const hasExportedTypeNames = !!data.exportedTypeNames && data.exportedTypeNames.length > 0;\n\n    if (!data.signature && !hasExportedTypeNames) {\n      const apiSection = this.findApiSection(data.sections);\n\n      return {\n        item: match,\n        signature: data.signature,\n        exportedTypeNames: data.exportedTypeNames,\n        propsCount: data.props.length,\n        suggestedSection: apiSection?.slug,\n        availableSections: data.sections.map((s) => s.slug),\n      };\n    }\n\n    return {\n      item: match,\n      signature: data.signature,\n      exportedTypeNames: data.exportedTypeNames,\n      propsCount: data.props.length,\n    };\n  }\n}\n"],"mappings":"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"}

package/cjs/search.cjs

@@ -0,0 +1,133 @@
+"use client";
+//#region packages/@mantine/mcp-server/src/search.ts
+const STOPWORDS = /* @__PURE__ */ new Set([
+	"a",
+	"an",
+	"the",
+	"and",
+	"or",
+	"of",
+	"to",
+	"in",
+	"on",
+	"for",
+	"with",
+	"how",
+	"do",
+	"i",
+	"my",
+	"is",
+	"it",
+	"can",
+	"use",
+	"using",
+	"when",
+	"what",
+	"that",
+	"this",
+	"be",
+	"as",
+	"at",
+	"by",
+	"from",
+	"are",
+	"get"
+]);
+function normalize(value) {
+	return value.trim().toLowerCase();
+}
+function tokenize(value) {
+	return normalize(value).split(/[^a-z0-9.-]+/).filter(Boolean);
+}
+function queryTokens(query) {
+	const raw = tokenize(query);
+	const filtered = raw.filter((token) => token.length > 2 && !STOPWORDS.has(token));
+	return filtered.length > 0 ? filtered : raw;
+}
+/**
+* Builds an IDF-weighted scorer over a fixed corpus.
+*
+* Document frequency is computed lazily per token and cached for the lifetime of the
+* returned scorer, so a common token like "a" contributes almost nothing to a match while
+* a rare token like "zod" dominates it. Callers should rebuild the scorer whenever `index`
+* or `sections` actually change.
+*/
+function createSearchScorer(index, sections) {
+	const sectionDocs = sections.map((section) => normalize(`${section.heading} ${section.snippet}`));
+	const itemDocs = index.map((item) => normalize(item.searchText));
+	const corpus = [...sectionDocs, ...itemDocs];
+	const corpusSize = corpus.length;
+	const documentFrequencyCache = /* @__PURE__ */ new Map();
+	function documentFrequency(token) {
+		const cached = documentFrequencyCache.get(token);
+		if (cached !== void 0) return cached;
+		let count = 0;
+		for (const doc of corpus) if (doc.includes(token)) count += 1;
+		documentFrequencyCache.set(token, count);
+		return count;
+	}
+	function idf(token) {
+		return Math.log((corpusSize + 1) / (documentFrequency(token) + 1));
+	}
+	function coverage(haystack, tokens) {
+		if (tokens.length === 0) return 0;
+		let matchedWeight = 0;
+		let totalWeight = 0;
+		for (const token of tokens) {
+			const weight = idf(token);
+			totalWeight += weight;
+			if (haystack.includes(token)) matchedWeight += weight;
+		}
+		return totalWeight > 0 ? matchedWeight / totalWeight : 0;
+	}
+	return {
+		scoreItem(item, query) {
+			const q = normalize(query);
+			if (!q) return 0;
+			const tokens = queryTokens(query);
+			const name = normalize(item.name);
+			const coverageScore = coverage(normalize(item.searchText), tokens);
+			let bonus = 0;
+			if (name === q) bonus = 60;
+			else if (name.startsWith(q)) bonus = 40;
+			else if (name.includes(q)) bonus = 25;
+			if (tokens.some((token) => name.includes(token))) bonus += 15;
+			return coverageScore * 55 + bonus;
+		},
+		scoreSection(section, query) {
+			const q = normalize(query);
+			if (!q) return 0;
+			const tokens = queryTokens(query);
+			const heading = normalize(section.heading);
+			const coverageScore = coverage(normalize(`${section.heading} ${section.snippet}`), tokens);
+			let bonus = 0;
+			if (heading === q) bonus += 40;
+			else if (heading.includes(q)) bonus += 25;
+			if (tokens.some((token) => heading.includes(token))) bonus += 15;
+			return coverageScore * 60 + bonus;
+		}
+	};
+}
+function editDistance(a, b) {
+	const rows = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+	for (let j = 0; j <= b.length; j += 1) rows[0][j] = j;
+	for (let i = 1; i <= a.length; i += 1) for (let j = 1; j <= b.length; j += 1) {
+		const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+		rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);
+	}
+	return rows[a.length][b.length];
+}
+/** Returns names close enough to a failed lookup to be worth suggesting */
+function suggestNames(index, query, limit = 3) {
+	const q = normalize(query);
+	const threshold = Math.max(2, Math.floor(q.length / 3));
+	return index.map((item) => ({
+		name: item.name,
+		distance: editDistance(q, normalize(item.name))
+	})).filter((entry) => entry.distance <= threshold).sort((a, b) => a.distance - b.distance).slice(0, limit).map((entry) => entry.name);
+}
+//#endregion
+exports.createSearchScorer = createSearchScorer;
+exports.suggestNames = suggestNames;
+
+//# sourceMappingURL=search.cjs.map

package/cjs/search.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.cjs","names":[],"sources":["../src/search.ts"],"sourcesContent":["import { IndexItem, SectionRecord } from './types';\n\nconst STOPWORDS = new Set([\n  'a',\n  'an',\n  'the',\n  'and',\n  'or',\n  'of',\n  'to',\n  'in',\n  'on',\n  'for',\n  'with',\n  'how',\n  'do',\n  'i',\n  'my',\n  'is',\n  'it',\n  'can',\n  'use',\n  'using',\n  'when',\n  'what',\n  'that',\n  'this',\n  'be',\n  'as',\n  'at',\n  'by',\n  'from',\n  'are',\n  'get',\n]);\n\nfunction normalize(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction tokenize(value: string): string[] {\n  return normalize(value)\n    .split(/[^a-z0-9.-]+/)\n    .filter(Boolean);\n}\n\nfunction queryTokens(query: string): string[] {\n  const raw = tokenize(query);\n  const filtered = raw.filter((token) => token.length > 2 && !STOPWORDS.has(token));\n  return filtered.length > 0 ? filtered : raw;\n}\n\n/** A scoring function pair built against a fixed corpus's document-frequency statistics */\nexport interface SearchScorer {\n  scoreItem(item: IndexItem, query: string): number;\n  scoreSection(section: SectionRecord, query: string): number;\n}\n\n/**\n * Builds an IDF-weighted scorer over a fixed corpus.\n *\n * Document frequency is computed lazily per token and cached for the lifetime of the\n * returned scorer, so a common token like \"a\" contributes almost nothing to a match while\n * a rare token like \"zod\" dominates it. Callers should rebuild the scorer whenever `index`\n * or `sections` actually change.\n */\nexport function createSearchScorer(index: IndexItem[], sections: SectionRecord[]): SearchScorer {\n  const sectionDocs = sections.map((section) => normalize(`${section.heading} ${section.snippet}`));\n  const itemDocs = index.map((item) => normalize(item.searchText));\n  const corpus = [...sectionDocs, ...itemDocs];\n  const corpusSize = corpus.length;\n  const documentFrequencyCache = new Map<string, number>();\n\n  function documentFrequency(token: string): number {\n    const cached = documentFrequencyCache.get(token);\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    let count = 0;\n    for (const doc of corpus) {\n      if (doc.includes(token)) {\n        count += 1;\n      }\n    }\n\n    documentFrequencyCache.set(token, count);\n    return count;\n  }\n\n  function idf(token: string): number {\n    return Math.log((corpusSize + 1) / (documentFrequency(token) + 1));\n  }\n\n  function coverage(haystack: string, tokens: string[]): number {\n    if (tokens.length === 0) {\n      return 0;\n    }\n\n    let matchedWeight = 0;\n    let totalWeight = 0;\n\n    for (const token of tokens) {\n      const weight = idf(token);\n      totalWeight += weight;\n\n      if (haystack.includes(token)) {\n        matchedWeight += weight;\n      }\n    }\n\n    return totalWeight > 0 ? matchedWeight / totalWeight : 0;\n  }\n\n  return {\n    scoreItem(item: IndexItem, query: string): number {\n      const q = normalize(query);\n\n      if (!q) {\n        return 0;\n      }\n\n      const tokens = queryTokens(query);\n      const name = normalize(item.name);\n      const haystack = normalize(item.searchText);\n      const coverageScore = coverage(haystack, tokens);\n\n      let bonus = 0;\n      if (name === q) {\n        bonus = 60;\n      } else if (name.startsWith(q)) {\n        bonus = 40;\n      } else if (name.includes(q)) {\n        bonus = 25;\n      }\n\n      if (tokens.some((token) => name.includes(token))) {\n        bonus += 15;\n      }\n\n      return coverageScore * 55 + bonus;\n    },\n\n    scoreSection(section: SectionRecord, query: string): number {\n      const q = normalize(query);\n\n      if (!q) {\n        return 0;\n      }\n\n      const tokens = queryTokens(query);\n      const heading = normalize(section.heading);\n      const haystack = normalize(`${section.heading} ${section.snippet}`);\n      const coverageScore = coverage(haystack, tokens);\n\n      let bonus = 0;\n      if (heading === q) {\n        bonus += 40;\n      } else if (heading.includes(q)) {\n        bonus += 25;\n      }\n\n      if (tokens.some((token) => heading.includes(token))) {\n        bonus += 15;\n      }\n\n      return coverageScore * 60 + bonus;\n    },\n  };\n}\n\nfunction editDistance(a: string, b: string): number {\n  const rows = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);\n\n  for (let j = 0; j <= b.length; j += 1) {\n    rows[0][j] = j;\n  }\n\n  for (let i = 1; i <= a.length; i += 1) {\n    for (let j = 1; j <= b.length; j += 1) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      rows[i][j] = Math.min(rows[i - 1][j] + 1, rows[i][j - 1] + 1, rows[i - 1][j - 1] + cost);\n    }\n  }\n\n  return rows[a.length][b.length];\n}\n\n/** Returns names close enough to a failed lookup to be worth suggesting */\nexport function suggestNames(index: IndexItem[], query: string, limit = 3): string[] {\n  const q = normalize(query);\n  const threshold = Math.max(2, Math.floor(q.length / 3));\n\n  return index\n    .map((item) => ({ name: item.name, distance: editDistance(q, normalize(item.name)) }))\n    .filter((entry) => entry.distance <= threshold)\n    .sort((a, b) => a.distance - b.distance)\n    .slice(0, limit)\n    .map((entry) => entry.name);\n}\n"],"mappings":"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"}