mozaic-mcp-server 1.0.0

package/dist/tools/get-install-info.js

@@ -0,0 +1,160 @@
+import { getComponentBySlug, listComponents } from "../db/queries.js";
+const PACKAGES = {
+    vue: {
+        name: "@mozaic-ds/vue-3",
+        peerDependencies: ["vue@^3.0"],
+    },
+    react: {
+        name: "@mozaic-ds/react",
+        peerDependencies: ["react@^17 || ^18", "react-dom@^17 || ^18"],
+    },
+};
+const RELATED_PACKAGES = {
+    styles: "@mozaic-ds/styles",
+    icons: "@mozaic-ds/icons",
+};
+function pascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join("");
+}
+function getInstallCommand(packageName, packageManager) {
+    switch (packageManager) {
+        case "yarn":
+            return `yarn add ${packageName}`;
+        case "pnpm":
+            return `pnpm add ${packageName}`;
+        default:
+            return `npm install ${packageName}`;
+    }
+}
+export function handleGetInstallInfo(db, input) {
+    const { component, framework = "vue", packageManager = "npm" } = input;
+    if (!component || component.trim().length === 0) {
+        const components = listComponents(db).slice(0, 10);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Please provide a component name",
+                        example: 'get_install_info({ component: "button", framework: "vue" })',
+                        availableComponents: components.map((c) => c.slug),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    // Find the component in database
+    const componentData = getComponentBySlug(db, component);
+    if (!componentData) {
+        // Try to find similar components
+        const allComponents = listComponents(db);
+        const searchTerm = component.toLowerCase();
+        const similar = allComponents
+            .filter((c) => c.slug.toLowerCase().includes(searchTerm) || searchTerm.includes(c.slug.toLowerCase()))
+            .slice(0, 5);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `Component "${component}" not found`,
+                        suggestions: similar.length > 0 ? similar.map((c) => c.slug) : undefined,
+                        hint: "Use list_components to see all available components",
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    const packageInfo = PACKAGES[framework];
+    const componentName = `M${pascalCase(componentData.slug)}`;
+    const response = {
+        component: componentName,
+        componentSlug: componentData.slug,
+        framework,
+        package: packageInfo.name,
+        installCommand: getInstallCommand(packageInfo.name, packageManager),
+        imports: {
+            component: framework === "vue"
+                ? `import { ${componentName} } from "${packageInfo.name}";`
+                : `import { ${componentName} } from "${packageInfo.name}";`,
+            styles: `@import "${RELATED_PACKAGES.styles}/lib/index.css";`,
+        },
+        peerDependencies: packageInfo.peerDependencies,
+        relatedPackages: {
+            styles: {
+                name: RELATED_PACKAGES.styles,
+                installCommand: getInstallCommand(RELATED_PACKAGES.styles, packageManager),
+                description: "Required CSS styles for Mozaic components",
+            },
+            icons: {
+                name: RELATED_PACKAGES.icons,
+                installCommand: getInstallCommand(RELATED_PACKAGES.icons, packageManager),
+                description: "SVG icons library (optional)",
+            },
+        },
+        quickStart: framework === "vue"
+            ? {
+                setup: `// main.ts
+import { createApp } from "vue";
+import App from "./App.vue";
+import "${RELATED_PACKAGES.styles}/lib/index.css";
+
+createApp(App).mount("#app");`,
+                usage: `<template>
+  <${componentName} />
+</template>
+
+<script setup lang="ts">
+import { ${componentName} } from "${packageInfo.name}";
+</script>`,
+            }
+            : {
+                setup: `// index.tsx
+import "${RELATED_PACKAGES.styles}/lib/index.css";`,
+                usage: `import { ${componentName} } from "${packageInfo.name}";
+
+function MyComponent() {
+  return <${componentName} />;
+}`,
+            },
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+// Tool definition for MCP
+export const getInstallInfoTool = {
+    name: "get_install_info",
+    description: "Get installation commands and import statements for a Mozaic component. Returns package name, install command (npm/yarn/pnpm), import statements, peer dependencies, and quick start code.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            component: {
+                type: "string",
+                description: 'Component name (e.g., "button", "modal", "text-input")',
+            },
+            framework: {
+                type: "string",
+                enum: ["vue", "react"],
+                default: "vue",
+                description: "Target framework: vue (@mozaic-ds/vue-3) or react (@mozaic-ds/react)",
+            },
+            packageManager: {
+                type: "string",
+                enum: ["npm", "yarn", "pnpm"],
+                default: "npm",
+                description: "Package manager for install commands",
+            },
+        },
+        required: ["component"],
+    },
+};
+//# sourceMappingURL=get-install-info.js.map

package/dist/tools/get-install-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-install-info.js","sourceRoot":"","sources":["../../src/tools/get-install-info.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-components.d.ts

@@ -0,0 +1,32 @@
+import type Database from "better-sqlite3";
+export interface ListComponentsInput {
+    category?: "form" | "navigation" | "feedback" | "layout" | "data-display" | "action" | "all";
+}
+export interface ComponentListItem {
+    name: string;
+    slug: string;
+    category: string;
+    description?: string;
+}
+export declare function handleListComponents(db: Database.Database, input: ListComponentsInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const listComponentsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+        };
+    };
+};
+//# sourceMappingURL=list-components.d.ts.map

package/dist/tools/list-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.d.ts","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC9F;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,mBAAmB,GACzB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAkDpD;AAGD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;CAe9B,CAAC"}

package/dist/tools/list-components.js

@@ -0,0 +1,62 @@
+import { listComponents as dbListComponents } from "../db/queries.js";
+export function handleListComponents(db, input) {
+    const { category = "all" } = input;
+    const components = dbListComponents(db, category === "all" ? undefined : category);
+    if (components.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: category === "all"
+                        ? "No components found in the database."
+                        : `No components found in category: ${category}`,
+                },
+            ],
+        };
+    }
+    // Group by category for better readability
+    const grouped = {};
+    for (const component of components) {
+        const cat = component.category || "other";
+        if (!grouped[cat]) {
+            grouped[cat] = [];
+        }
+        grouped[cat].push({
+            name: component.name,
+            slug: component.slug,
+            category: cat,
+            description: component.description,
+        });
+    }
+    // Format output
+    const output = {
+        total: components.length,
+        categories: Object.keys(grouped),
+        components: category === "all" ? grouped : components,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// Tool definition for MCP
+export const listComponentsTool = {
+    name: "list_components",
+    description: "List available Mozaic framework components (Vue/React) by category. For CSS-only utilities (Flexy, Margin, etc.), use list_css_utilities instead.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            category: {
+                type: "string",
+                enum: ["form", "navigation", "feedback", "layout", "data-display", "action", "all"],
+                default: "all",
+                description: "Filter components by category",
+            },
+        },
+    },
+};
+//# sourceMappingURL=list-components.js.map

package/dist/tools/list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.js","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAatE,MAAM,UAAU,oBAAoB,CAClC,EAAqB,EACrB,KAA0B;IAE1B,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAEnC,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAEnF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,QAAQ,KAAK,KAAK;wBAChB,CAAC,CAAC,sCAAsC;wBACxC,CAAC,CAAC,oCAAoC,QAAQ,EAAE;iBACrD;aACF;SACF,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,OAAO,GAAwC,EAAE,CAAC;IAExD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,IAAI,OAAO,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,GAAG;YACb,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,UAAU,CAAC,MAAM;QACxB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,UAAU,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;KACtD,CAAC;IAEF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,mJAAmJ;IACrJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC;gBACnF,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;KACF;CACF,CAAC"}

package/dist/tools/list-css-utilities.d.ts

@@ -0,0 +1,27 @@
+import type Database from "better-sqlite3";
+export interface ListCssUtilitiesInput {
+    category?: "layout" | "utility" | "all";
+}
+export declare function handleListCssUtilities(db: Database.Database, input: ListCssUtilitiesInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const listCssUtilitiesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            category: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+//# sourceMappingURL=list-css-utilities.d.ts.map

package/dist/tools/list-css-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-css-utilities.d.ts","sourceRoot":"","sources":["../../src/tools/list-css-utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;CACzC;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,qBAAqB,GAC3B;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAgCpD;AAGD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;CAiBhC,CAAC"}

package/dist/tools/list-css-utilities.js

@@ -0,0 +1,48 @@
+import { listCssUtilities } from "../db/queries.js";
+export function handleListCssUtilities(db, input) {
+    const { category = "all" } = input;
+    const utilities = listCssUtilities(db, category);
+    if (utilities.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No CSS utilities found for category: ${category}`,
+                },
+            ],
+        };
+    }
+    const output = utilities.map((u) => ({
+        name: u.name,
+        slug: u.slug,
+        category: u.category,
+        description: u.description,
+        classCount: u.classCount,
+    }));
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// Tool definition for MCP
+export const listCssUtilitiesTool = {
+    name: "list_css_utilities",
+    description: "List available Mozaic CSS utility classes by category. These are CSS-only utilities for layout (Flexy, Container) and spacing (Margin, Padding, Ratio, Scroll). Use get_css_utility to get detailed class names and examples.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            category: {
+                type: "string",
+                enum: ["layout", "utility", "all"],
+                default: "all",
+                description: "Filter by category: 'layout' (Flexy, Container), 'utility' (Margin, Padding, etc.), or 'all'",
+            },
+        },
+        required: [],
+    },
+};
+//# sourceMappingURL=list-css-utilities.js.map

package/dist/tools/list-css-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-css-utilities.js","sourceRoot":"","sources":["../../src/tools/list-css-utilities.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMpD,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,KAA4B;IAE5B,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAEnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEjD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wCAAwC,QAAQ,EAAE;iBACzD;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,+NAA+N;IACjO,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC;gBAClC,OAAO,EAAE,KAAK;gBACd,WAAW,EACT,8FAA8F;aACjG;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC"}

package/dist/tools/search-documentation.d.ts

@@ -0,0 +1,37 @@
+import type Database from "better-sqlite3";
+export interface SearchDocumentationInput {
+    query: string;
+    limit?: number;
+}
+export interface SearchResult {
+    title: string;
+    path: string;
+    snippet: string;
+    category?: string;
+}
+export declare function handleSearchDocumentation(db: Database.Database, input: SearchDocumentationInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const searchDocumentationTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=search-documentation.d.ts.map

package/dist/tools/search-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,wBAAwB,GAC9B;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAsCpD;AAiFD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;CAkBnC,CAAC"}

package/dist/tools/search-documentation.js

@@ -0,0 +1,120 @@
+import { searchDocumentation as dbSearchDocumentation } from "../db/queries.js";
+export function handleSearchDocumentation(db, input) {
+    const { query, limit = 5 } = input;
+    if (!query || query.trim().length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Please provide a search query.",
+                },
+            ],
+        };
+    }
+    // Generate multiple search strategies from strict to fuzzy
+    const searchStrategies = buildSearchStrategies(query);
+    // Try each strategy until we find results
+    for (const ftsQuery of searchStrategies) {
+        try {
+            const results = dbSearchDocumentation(db, ftsQuery, limit);
+            if (results.length > 0) {
+                return formatResults(results, query);
+            }
+        }
+        catch {
+            // FTS5 syntax error - try next strategy
+            continue;
+        }
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `No documentation found for: "${query}". Try different keywords or use list_components to see available components.`,
+            },
+        ],
+    };
+}
+// Build multiple FTS5 search strategies from strict to fuzzy
+function buildSearchStrategies(query) {
+    // Remove special characters that might break FTS5
+    // Also replace hyphens with spaces since FTS5 tokenizes on hyphens
+    const cleaned = query.replace(/[^\w\s]/g, " ");
+    // Split into terms and filter short ones
+    const terms = cleaned
+        .trim()
+        .split(/\s+/)
+        .filter((term) => term.length > 1);
+    if (terms.length === 0) {
+        return [query.trim()];
+    }
+    // Single term: just use prefix matching
+    if (terms.length === 1) {
+        return [`${terms[0]}*`];
+    }
+    // Multiple terms: try strategies from strict to fuzzy
+    return [
+        // 1. Exact phrase match
+        `"${terms.join(" ")}"`,
+        // 2. All terms required with prefix (AND)
+        terms.map((t) => `${t}*`).join(" AND "),
+        // 3. Any term matches with prefix (OR) - most fuzzy
+        terms.map((t) => `${t}*`).join(" OR "),
+    ];
+}
+function formatResults(results, originalQuery) {
+    const output = {
+        query: originalQuery,
+        resultCount: results.length,
+        results: results.map((r) => ({
+            title: r.title,
+            path: r.path,
+            category: r.category,
+            snippet: cleanSnippet(r.snippet),
+            url: `https://mozaic.adeo.cloud${r.path}`,
+        })),
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(output, null, 2),
+            },
+        ],
+    };
+}
+// Clean up FTS5 snippet output
+function cleanSnippet(snippet) {
+    if (!snippet)
+        return "";
+    // Remove HTML tags but keep the text
+    let cleaned = snippet.replace(/<mark>/g, "**").replace(/<\/mark>/g, "**");
+    // Normalize whitespace
+    cleaned = cleaned.replace(/\s+/g, " ").trim();
+    // Truncate if too long
+    if (cleaned.length > 200) {
+        cleaned = cleaned.substring(0, 200) + "...";
+    }
+    return cleaned;
+}
+// Tool definition for MCP
+export const searchDocumentationTool = {
+    name: "search_documentation",
+    description: "Search Mozaic Design System documentation for components, patterns, and guidelines",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query (e.g., 'button variants', 'form validation', 'color tokens')",
+            },
+            limit: {
+                type: "number",
+                default: 5,
+                description: "Maximum number of results to return",
+            },
+        },
+        required: ["query"],
+    },
+};
+//# sourceMappingURL=search-documentation.js.map

package/dist/tools/search-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.js","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-icons.d.ts

@@ -0,0 +1,41 @@
+import type Database from "better-sqlite3";
+export interface SearchIconsInput {
+    query: string;
+    type?: string;
+    size?: number;
+    limit?: number;
+}
+export declare function handleSearchIcons(db: Database.Database, input: SearchIconsInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const searchIconsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            size: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=search-icons.d.ts.map

package/dist/tools/search-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-icons.d.ts","sourceRoot":"","sources":["../../src/tools/search-icons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,gBAAgB,GACtB;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CA2DpD;AA6ED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CA4B3B,CAAC"}