mozaic-mcp-server 2.1.1 → 2.3.0

package/dist/tools/generate-freemarker.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+/**
+ * Generate Freemarker macro usage code
+ *
+ * This tool generates ready-to-use Freemarker template code with:
+ * - Import statement for the macro
+ * - Macro invocation with configuration object
+ * - Example configuration based on component props
+ */
+const _GenerateFreemarkerInputSchema = z.object({
+    component: z.string().describe("Component name (e.g., 'button', 'field', 'modal')"),
+    config: z
+        .string()
+        .optional()
+        .describe('Configuration object as JSON (e.g., {"color": "primary", "size": "m"})'),
+    content: z.string().optional().describe("Nested content for the macro (if applicable)"),
+});
+export function handleGenerateFreemarker(db, input) {
+    const componentSlug = input.component.toLowerCase().replace(/\s+/g, "-");
+    // Find component
+    const component = db
+        .prepare(`
+    SELECT id, name, slug, description
+    FROM components
+    WHERE frameworks LIKE '%freemarker%'
+      AND (LOWER(slug) LIKE ? OR LOWER(name) LIKE ?)
+    LIMIT 1
+  `)
+        .get(`%${componentSlug}%`, `%${componentSlug}%`);
+    if (!component) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Component "${input.component}" not found in Freemarker components.\n\nTry listing available components first with list_freemarker_components.`,
+                },
+            ],
+        };
+    }
+    // Get component props for configuration example
+    const props = db
+        .prepare(`
+    SELECT name, type, default_value, required, description
+    FROM component_props
+    WHERE component_id = ?
+    ORDER BY required DESC, name ASC
+  `)
+        .all(component.id);
+    // Generate macro file name (lowercase with underscores)
+    const macroFileName = component.slug.replace(/-/g, "");
+    // Parse user configuration or use example
+    let configObject = {};
+    if (input.config) {
+        try {
+            configObject = JSON.parse(input.config);
+        }
+        catch {
+            // If parsing fails, treat as simple key-value
+            configObject = {};
+        }
+    }
+    else {
+        // Generate example configuration from props
+        props.slice(0, 3).forEach((prop) => {
+            if (prop.default_value) {
+                configObject[prop.name] = prop.default_value;
+            }
+            else if (prop.type === "boolean") {
+                configObject[prop.name] = false;
+            }
+            else if (prop.type === "string") {
+                configObject[prop.name] = `example_${prop.name}`;
+            }
+        });
+    }
+    // Format configuration as Freemarker assignment
+    const configLines = [];
+    Object.entries(configObject).forEach(([key, value]) => {
+        let formattedValue;
+        if (typeof value === "string") {
+            formattedValue = `"${value}"`;
+        }
+        else if (typeof value === "boolean") {
+            formattedValue = value.toString();
+        }
+        else if (typeof value === "object" && value !== null) {
+            formattedValue = JSON.stringify(value, null, 4).replace(/"(\w+)":/g, '"$1":');
+        }
+        else {
+            formattedValue = String(value);
+        }
+        configLines.push(`    "${key}": ${formattedValue}`);
+    });
+    const configString = configLines.length > 0 ? `\n${configLines.join(",\n")}\n` : "";
+    // Generate nested content
+    const nestedContent = input.content || "Content goes here";
+    // Generate the complete Freemarker template code
+    const code = `<#import "mozaic/${macroFileName}.ftl" as ${macroFileName}>
+
+<#-- Configuration for ${component.name} -->
+<#assign config${component.name} = {${configString}}>
+
+<#-- Render ${component.name} -->
+<@${macroFileName}.${macroFileName} config=config${component.name}>
+    ${nestedContent}
+</@${macroFileName}.${macroFileName}>`;
+    // Build description
+    let description = `# Freemarker ${component.name}\n\n`;
+    description += `${component.description}\n\n`;
+    description += `## Generated Code\n\n\`\`\`ftl\n${code}\n\`\`\`\n\n`;
+    if (props.length > 0) {
+        description += `## Available Configuration Options\n\n`;
+        props.forEach((prop) => {
+            const required = prop.required ? " (required)" : "";
+            const defaultVal = prop.default_value ? ` [default: ${prop.default_value}]` : "";
+            description += `- **${prop.name}** (${prop.type})${required}${defaultVal}\n`;
+            if (prop.description) {
+                description += `  ${prop.description}\n`;
+            }
+        });
+        description += `\n`;
+    }
+    description += `## Usage Notes\n\n`;
+    description += `1. Import the macro at the top of your .ftl file\n`;
+    description += `2. Define configuration using <#assign config = {...}>\n`;
+    description += `3. Call the macro with <@${macroFileName}.${macroFileName} config=config>...</@>\n`;
+    description += `4. Nested content goes between opening and closing tags\n\n`;
+    description += `## Installation\n\n`;
+    description += `Add to your project's pom.xml:\n\n`;
+    description += `\`\`\`xml\n`;
+    description += `<dependency>\n`;
+    description += `    <groupId>com.adeo.mozaic</groupId>\n`;
+    description += `    <artifactId>mozaic-freemarker</artifactId>\n`;
+    description += `    <version>LATEST_VERSION</version>\n`;
+    description += `</dependency>\n`;
+    description += `\`\`\`\n`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: description,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=generate-freemarker.js.map

package/dist/tools/generate-freemarker.js.map

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

package/dist/tools/generate-webcomponent.d.ts

@@ -0,0 +1,38 @@
+import type Database from "better-sqlite3";
+export interface GenerateWebComponentInput {
+    component: string;
+    attributes?: Record<string, string>;
+    children?: string;
+}
+export declare function handleGenerateWebComponent(db: Database.Database, input: GenerateWebComponentInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const generateWebComponentTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            component: {
+                type: string;
+                description: string;
+            };
+            attributes: {
+                type: string;
+                description: string;
+                additionalProperties: {
+                    type: string;
+                };
+            };
+            children: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=generate-webcomponent.d.ts.map

package/dist/tools/generate-webcomponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-webcomponent.d.ts","sourceRoot":"","sources":["../../src/tools/generate-webcomponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,yBAAyB,GAC/B;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAwBpD;AAiDD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;CA2BpC,CAAC"}

package/dist/tools/generate-webcomponent.js

@@ -0,0 +1,83 @@
+import { getComponentBySlug } from "../db/queries.js";
+export function handleGenerateWebComponent(db, input) {
+    const { component, attributes = {}, children = "" } = input;
+    // Normalize component name to kebab-case slug
+    const slug = component.toLowerCase().replace(/^mozaic-/, "");
+    const componentData = getComponentBySlug(db, slug);
+    // Get tag name (should be kebab-case)
+    const tagName = componentData?.slug || `mozaic-${slug}`;
+    const code = generateWebComponent(tagName, attributes, children);
+    let output = `// Import web component\n`;
+    output += `import '@adeo/mozaic-web-components/${slug}.js';\n\n`;
+    output += `// Usage in HTML\n${code}`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: output,
+            },
+        ],
+    };
+}
+function generateWebComponent(tagName, attributes, children) {
+    const attributesString = generateAttributesString(attributes);
+    if (children) {
+        return `<${tagName}${attributesString}>\n  ${children}\n</${tagName}>`;
+    }
+    if (Object.keys(attributes).length === 0) {
+        return `<${tagName}></${tagName}>`;
+    }
+    return `<${tagName}${attributesString}></${tagName}>`;
+}
+function generateAttributesString(attributes) {
+    if (Object.keys(attributes).length === 0) {
+        return "";
+    }
+    const parts = [];
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        // Web component attributes are always strings
+        // Boolean attributes: if truthy, add attribute without value
+        if (value === "true" || value === "") {
+            parts.push(key);
+        }
+        else if (value === "false") {
+            // Skip false boolean attributes
+            continue;
+        }
+        else {
+            // All other values as string attributes
+            parts.push(`${key}="${value}"`);
+        }
+    }
+    return parts.length > 0 ? "\n  " + parts.join("\n  ") : "";
+}
+// Tool definition for MCP
+export const generateWebComponentTool = {
+    name: "generate_webcomponent",
+    description: "Generate Web Component code using Mozaic Design System (@adeo/mozaic-web-components). Returns ready-to-use HTML with import statement.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            component: {
+                type: "string",
+                description: "Component type to generate (e.g., button, card, modal). Will be converted to kebab-case tag name (e.g., mozaic-button)",
+            },
+            attributes: {
+                type: "object",
+                description: "HTML attributes to apply to the component (all values as strings). Use 'true'/'false' for boolean attributes.",
+                additionalProperties: {
+                    type: "string",
+                },
+            },
+            children: {
+                type: "string",
+                description: "Inner HTML content / slot content to place inside the component",
+            },
+        },
+        required: ["component"],
+    },
+};
+//# sourceMappingURL=generate-webcomponent.js.map

package/dist/tools/generate-webcomponent.js.map

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

package/dist/tools/get-component-info.d.ts

@@ -1,7 +1,7 @@
 import type Database from "better-sqlite3";
 export interface GetComponentInfoInput {
     component: string;
-    framework?: "vue" | "react" | "html";
+    framework?: "vue" | "react" | "html" | "webcomponents" | "freemarker";
 }
 export interface ComponentInfoOutput {
     name: string;

package/dist/tools/get-component-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-component-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;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,CA6DpD;AAqBD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAoBhC,CAAC"}
+{"version":3,"file":"get-component-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,YAAY,CAAC;CACvE;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;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,CA6DpD;AA6BD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;CAoBhC,CAAC"}

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

@@ -62,6 +62,14 @@ function generateBasicExample(componentName, framework) {
             return `<${tag}>Content</${tag}>`;
         case "react":
             return `<${tag}>Content</${tag}>`;
+        case "webcomponents": {
+            const tagName = componentName.replace(/^M/, "").toLowerCase();
+            return `<mozaic-${tagName}>Content</mozaic-${tagName}>`;
+        }
+        case "freemarker": {
+            const macroName = componentName.replace(/^M/, "").toLowerCase().replace(/-/g, "");
+            return `<#import "mozaic/${macroName}.ftl" as ${macroName}>\n<@${macroName}.${macroName} config={}>Content</@${macroName}.${macroName}>`;
+        }
         case "html": {
             const cssClass = `mc-${componentName.replace(/^M/, "").toLowerCase()}`;
             return `<div class="${cssClass}">Content</div>`;
@@ -83,7 +91,7 @@ export const getComponentInfoTool = {
             },
             framework: {
                 type: "string",
-                enum: ["vue", "react", "html"],
+                enum: ["vue", "react", "html", "webcomponents", "freemarker"],
                 default: "vue",
                 description: "Framework for code examples",
             },

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

@@ -1 +1 @@
-{"version":3,"file":"get-component-info.js","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AA4BtD,MAAM,UAAU,sBAAsB,CACpC,EAAqB,EACrB,KAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IAE/C,mEAAmE;IACnE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAExD,MAAM,aAAa,GAAG,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wBAAwB,SAAS,mEAAmE;iBAC3G;aACF;SACF,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,gBAAgB,GAAG,CAAC,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC;SACpD,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC;SAC1C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,IAAI,EAAE,EAAE,CAAC,IAAI;KACd,CAAC,CAAC,CAAC;IAEN,eAAe;IACf,MAAM,MAAM,GAAwB;QAClC,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,WAAW,EAAE,aAAa,CAAC,WAAW;QACtC,KAAK,EAAE,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,YAAY;YACvB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;YAC7B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,KAAK,EAAE,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,MAAM,EAAE,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvD,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,aAAa,CAAC,UAAU,IAAI,EAAE;KAC3C,CAAC;IAEF,kCAAkC;IAClC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,oBAAoB,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzE,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,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,yCAAyC;AACzC,SAAS,oBAAoB,CAAC,aAAqB,EAAE,SAAiB;IACpE,MAAM,GAAG,GAAG,aAAa,CAAC;IAE1B,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,IAAI,GAAG,aAAa,GAAG,GAAG,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,IAAI,GAAG,aAAa,GAAG,GAAG,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACvE,OAAO,eAAe,QAAQ,iBAAiB,CAAC;QAClD,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,0BAA0B;AAC1B,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,oMAAoM;IACtM,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;gBAC9B,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,6BAA6B;aAC3C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC"}
+{"version":3,"file":"get-component-info.js","sourceRoot":"","sources":["../../src/tools/get-component-info.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-freemarker-info.d.ts

@@ -0,0 +1,27 @@
+import Database from "better-sqlite3";
+import { z } from "zod";
+/**
+ * Get detailed information about a Freemarker component
+ *
+ * Returns:
+ * - Component metadata (name, description, category)
+ * - Configuration options (props)
+ * - CSS classes
+ * - Usage examples
+ */
+declare const _GetFreemarkerInfoInputSchema: z.ZodObject<{
+    component: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    component: string;
+}, {
+    component: string;
+}>;
+export type GetFreemarkerInfoInput = z.infer<typeof _GetFreemarkerInfoInputSchema>;
+export declare function handleGetFreemarkerInfo(db: Database.Database, input: GetFreemarkerInfoInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export {};
+//# sourceMappingURL=get-freemarker-info.d.ts.map

package/dist/tools/get-freemarker-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-freemarker-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-freemarker-info.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH,QAAA,MAAM,6BAA6B;;;;;;EAEjC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEnF,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,sBAAsB,GAC5B;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAkLpD"}

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

@@ -0,0 +1,161 @@
+import { z } from "zod";
+/**
+ * Get detailed information about a Freemarker component
+ *
+ * Returns:
+ * - Component metadata (name, description, category)
+ * - Configuration options (props)
+ * - CSS classes
+ * - Usage examples
+ */
+const _GetFreemarkerInfoInputSchema = z.object({
+    component: z.string().describe("Component name (e.g., 'button', 'field', 'modal')"),
+});
+export function handleGetFreemarkerInfo(db, input) {
+    const componentSlug = input.component.toLowerCase().replace(/\s+/g, "-");
+    // Find component
+    const component = db
+        .prepare(`
+    SELECT id, name, slug, category, description
+    FROM components
+    WHERE frameworks LIKE '%freemarker%'
+      AND (LOWER(slug) LIKE ? OR LOWER(name) LIKE ?)
+    LIMIT 1
+  `)
+        .get(`%${componentSlug}%`, `%${componentSlug}%`);
+    if (!component) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Component "${input.component}" not found in Freemarker components.\n\nTry searching with list_freemarker_components.`,
+                },
+            ],
+        };
+    }
+    // Get configuration options (props)
+    const props = db
+        .prepare(`
+    SELECT name, type, default_value, required, description
+    FROM component_props
+    WHERE component_id = ?
+    ORDER BY required DESC, name ASC
+  `)
+        .all(component.id);
+    // Get CSS classes
+    const cssClasses = db
+        .prepare(`
+    SELECT class_name, description
+    FROM component_css_classes
+    WHERE component_id = ?
+    ORDER BY class_name ASC
+  `)
+        .all(component.id);
+    // Build markdown description
+    let output = `# ${component.name} (Freemarker)\n\n`;
+    output += `**Category:** ${component.category}\n\n`;
+    if (component.description) {
+        output += `## Description\n\n${component.description}\n\n`;
+    }
+    // Configuration options
+    output += `## Configuration Options\n\n`;
+    if (props.length > 0) {
+        output += `| Option | Type | Required | Default | Description |\n`;
+        output += `|--------|------|----------|---------|-------------|\n`;
+        props.forEach((prop) => {
+            const required = prop.required ? "✓" : "";
+            const defaultVal = prop.default_value || "-";
+            const desc = prop.description || "-";
+            output += `| \`${prop.name}\` | ${prop.type} | ${required} | ${defaultVal} | ${desc} |\n`;
+        });
+    }
+    else {
+        output += `No configuration options documented.\n`;
+    }
+    output += `\n`;
+    // CSS Classes
+    if (cssClasses.length > 0) {
+        output += `## CSS Classes\n\n`;
+        cssClasses.forEach((cls) => {
+            output += `- \`${cls.class_name}\``;
+            if (cls.description) {
+                output += ` - ${cls.description}`;
+            }
+            output += `\n`;
+        });
+        output += `\n`;
+    }
+    // Usage example
+    const macroFileName = component.slug.replace(/-/g, "");
+    output += `## Usage Example\n\n`;
+    output += `\`\`\`ftl\n`;
+    output += `<#import "mozaic/${macroFileName}.ftl" as ${macroFileName}>\n\n`;
+    output += `<#assign config = {\n`;
+    // Add example configuration
+    const exampleProps = props.slice(0, 3);
+    if (exampleProps.length > 0) {
+        exampleProps.forEach((prop, index) => {
+            let exampleValue;
+            if (prop.default_value) {
+                exampleValue = prop.type === "string" ? `"${prop.default_value}"` : prop.default_value;
+            }
+            else if (prop.type === "boolean") {
+                exampleValue = "false";
+            }
+            else if (prop.type === "string") {
+                exampleValue = `"example"`;
+            }
+            else {
+                exampleValue = '""';
+            }
+            const comma = index < exampleProps.length - 1 ? "," : "";
+            output += `    "${prop.name}": ${exampleValue}${comma}\n`;
+        });
+    }
+    output += `}>\n\n`;
+    output += `<@${macroFileName}.${macroFileName} config=config>\n`;
+    output += `    Content goes here\n`;
+    output += `</@${macroFileName}.${macroFileName}>\n`;
+    output += `\`\`\`\n\n`;
+    // Installation
+    output += `## Installation\n\n`;
+    output += `Add to your project's \`pom.xml\`:\n\n`;
+    output += `\`\`\`xml\n`;
+    output += `<dependency>\n`;
+    output += `    <groupId>com.adeo.mozaic</groupId>\n`;
+    output += `    <artifactId>mozaic-freemarker</artifactId>\n`;
+    output += `    <version>LATEST_VERSION</version>\n`;
+    output += `</dependency>\n`;
+    output += `\`\`\`\n\n`;
+    // Documentation link
+    output += `## Documentation\n\n`;
+    output += `For more information, visit the [Mozaic Freemarker repository](https://github.com/adeo/mozaic-freemarker).\n`;
+    // JSON metadata for programmatic access
+    const jsonData = {
+        name: component.name,
+        slug: component.slug,
+        category: component.category,
+        description: component.description,
+        framework: "freemarker",
+        props: props.map((p) => ({
+            name: p.name,
+            type: p.type,
+            required: p.required,
+            default: p.default_value,
+            description: p.description,
+        })),
+        cssClasses: cssClasses.map((c) => c.class_name),
+    };
+    output += `\n---\n\n`;
+    output += `### Component Data (JSON)\n\n`;
+    output += `\`\`\`json\n${JSON.stringify(jsonData, null, 2)}\n\`\`\`\n`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: output,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=get-freemarker-info.js.map

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

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

package/dist/tools/get-webcomponent-info.d.ts

@@ -0,0 +1,52 @@
+import type Database from "better-sqlite3";
+export interface GetWebComponentInfoInput {
+    component: string;
+}
+export interface WebComponentInfoOutput {
+    name: string;
+    tagName: string;
+    description?: string;
+    attributes: Array<{
+        name: string;
+        type?: string;
+        default?: string;
+        required: boolean;
+        options?: string[];
+        description?: string;
+    }>;
+    slots: Array<{
+        name: string;
+        description?: string;
+    }>;
+    events: Array<{
+        name: string;
+        payload?: string;
+        description?: string;
+    }>;
+    cssProperties: string[];
+    examples: Array<{
+        title?: string;
+        code: string;
+    }>;
+}
+export declare function handleGetWebComponentInfo(db: Database.Database, input: GetWebComponentInfoInput): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export declare const getWebComponentInfoTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            component: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+//# sourceMappingURL=get-webcomponent-info.d.ts.map

package/dist/tools/get-webcomponent-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-webcomponent-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-webcomponent-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;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,CA8JpD;AAQD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAenC,CAAC"}