mozaic-mcp-server 2.2.0 → 2.3.0

package/dist/tools/list-freemarker.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+/**
+ * List Freemarker components by category
+ *
+ * Returns a list of all Freemarker macro components, optionally filtered by category.
+ */
+const _ListFreemarkerInputSchema = z.object({
+    category: z
+        .enum(["all", "action", "form", "feedback", "navigation", "layout", "data-display", "other"])
+        .optional()
+        .default("all")
+        .describe("Filter by category (default: all)"),
+});
+export function handleListFreemarker(db, input) {
+    const category = input.category || "all";
+    let query = `
+    SELECT name, slug, category, description
+    FROM components
+    WHERE frameworks LIKE '%freemarker%'
+  `;
+    const params = [];
+    if (category !== "all") {
+        query += ` AND category = ?`;
+        params.push(category);
+    }
+    query += ` ORDER BY category ASC, name ASC`;
+    const components = db.prepare(query).all(...params);
+    if (components.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No Freemarker components found${category !== "all" ? ` in category "${category}"` : ""}.`,
+                },
+            ],
+        };
+    }
+    // Group components by category
+    const groupedComponents = new Map();
+    components.forEach((component) => {
+        const cat = component.category;
+        if (!groupedComponents.has(cat)) {
+            groupedComponents.set(cat, []);
+        }
+        const group = groupedComponents.get(cat);
+        if (group) {
+            group.push(component);
+        }
+    });
+    // Build output
+    let output = `# Freemarker Components\n\n`;
+    output += `Found ${components.length} components`;
+    if (category !== "all") {
+        output += ` in category "${category}"`;
+    }
+    output += `\n\n`;
+    // List by category
+    const categories = Array.from(groupedComponents.keys()).sort();
+    categories.forEach((cat) => {
+        const comps = groupedComponents.get(cat);
+        if (!comps)
+            return;
+        output += `## ${cat.charAt(0).toUpperCase() + cat.slice(1)} (${comps.length})\n\n`;
+        comps.forEach((comp) => {
+            output += `### ${comp.name}\n`;
+            output += `- **Slug:** \`${comp.slug}\`\n`;
+            if (comp.description) {
+                output += `- **Description:** ${comp.description}\n`;
+            }
+            const macroName = comp.slug.replace(/-/g, "");
+            output += `- **Usage:** \`<#import "mozaic/${macroName}.ftl" as ${macroName}>\`\n`;
+            output += `\n`;
+        });
+    });
+    // Summary by category
+    output += `---\n\n`;
+    output += `## Summary by Category\n\n`;
+    categories.forEach((cat) => {
+        const group = groupedComponents.get(cat);
+        if (group) {
+            output += `- **${cat}**: ${group.length} components\n`;
+        }
+    });
+    output += `\n`;
+    output += `## Next Steps\n\n`;
+    output += `Use \`get_freemarker_info\` to view detailed information about a specific component.\n`;
+    output += `Use \`generate_freemarker\` to generate ready-to-use code for a component.\n`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: output,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-freemarker.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mozaic-mcp-server",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Self-contained Claude Code skills for Mozaic Design System by ADEO",
   "type": "module",
   "main": "dist/index.js",

package/skills/mozaic-freemarker-builder/scripts/generate-component.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# Generate Freemarker macro usage code
+COMPONENT="${1:?Component name required}"
+CONFIG="${2:-{}}"
+CONTENT="${3:-Content goes here}"
+DB_PATH="${MOZAIC_DB_PATH:-${HOME}/.claude/mozaic.db}"
+
+# Get component info
+COMP_DATA=$(sqlite3 "$DB_PATH" "SELECT slug FROM components WHERE frameworks LIKE '%freemarker%' AND (LOWER(slug) LIKE LOWER('%$COMPONENT%') OR LOWER(name) LIKE LOWER('%$COMPONENT%')) LIMIT 1;")
+
+if [ -z "$COMP_DATA" ]; then
+  echo "Component '$COMPONENT' not found"
+  exit 1
+fi
+
+MACRO_NAME=$(echo "$COMP_DATA" | tr '-' '')
+
+# Generate code
+cat <<EOF
+<#import "mozaic/${MACRO_NAME}.ftl" as ${MACRO_NAME}>
+
+<#assign config = ${CONFIG}>
+
+<@${MACRO_NAME}.${MACRO_NAME} config=config>
+    ${CONTENT}
+</@${MACRO_NAME}.${MACRO_NAME}>
+EOF

package/skills/mozaic-freemarker-builder/scripts/get-component.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Get detailed Freemarker component information
+COMPONENT="${1:?Component name required}"
+DB_PATH="${MOZAIC_DB_PATH:-${HOME}/.claude/mozaic.db}"
+
+sqlite3 "$DB_PATH" <<EOF
+.mode json
+SELECT
+  c.name,
+  c.slug,
+  c.category,
+  c.description,
+  json_group_array(
+    json_object(
+      'name', p.name,
+      'type', p.type,
+      'required', p.required,
+      'default', p.default_value,
+      'description', p.description
+    )
+  ) as props
+FROM components c
+LEFT JOIN component_props p ON p.component_id = c.id
+WHERE c.frameworks LIKE '%freemarker%'
+  AND (LOWER(c.slug) LIKE LOWER('%$COMPONENT%') OR LOWER(c.name) LIKE LOWER('%$COMPONENT%'))
+GROUP BY c.id
+LIMIT 1;
+EOF

package/skills/mozaic-freemarker-builder/scripts/list-components.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# List Freemarker components by category
+CATEGORY="${1:-all}"
+DB_PATH="${MOZAIC_DB_PATH:-${HOME}/.claude/mozaic.db}"
+
+sqlite3 "$DB_PATH" <<EOF
+.mode json
+SELECT name, slug, category, description
+FROM components
+WHERE frameworks LIKE '%freemarker%'
+${CATEGORY:+AND category = '$CATEGORY'}
+ORDER BY category, name;
+EOF

package/skills/mozaic-freemarker-builder/scripts/search-components.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Search Freemarker components by name or description
+QUERY="${1:?Search query required}"
+DB_PATH="${MOZAIC_DB_PATH:-${HOME}/.claude/mozaic.db}"
+
+sqlite3 "$DB_PATH" <<EOF
+.mode json
+SELECT name, slug, category, description
+FROM components
+WHERE frameworks LIKE '%freemarker%'
+  AND (LOWER(name) LIKE LOWER('%$QUERY%') OR LOWER(description) LIKE LOWER('%$QUERY%'))
+ORDER BY name
+LIMIT 20;
+EOF

package/skills/mozaic-freemarker-builder/skill.md

@@ -0,0 +1,145 @@
+# Mozaic Freemarker Builder
+
+Interactive Freemarker macro generator for Mozaic Design System. Help users discover, configure, and generate production-ready Freemarker template code with proper imports and configuration.
+
+## Activation
+
+This skill activates when users:
+- Ask about Freemarker components or macros
+- Want to generate Freemarker template code
+- Need help with Mozaic Freemarker implementation
+- Mention ".ftl" files or Freemarker templates
+
+## Workflow
+
+### 1. Discovery Phase
+Ask user what they want to build or which component they need:
+```bash
+# List all Freemarker components
+./scripts/list-components.sh all
+
+# List by category
+./scripts/list-components.sh form
+./scripts/list-components.sh navigation
+```
+
+### 2. Component Selection
+Let user browse and select:
+```bash
+# Search for specific component
+./scripts/search-components.sh "button"
+
+# Get detailed component info
+./scripts/get-component.sh "button"
+```
+
+### 3. Configuration
+Help user configure the component:
+- Show available configuration options (props)
+- Explain required vs optional parameters
+- Provide examples of common configurations
+
+### 4. Code Generation
+Generate ready-to-use Freemarker code:
+```bash
+# Generate basic code
+./scripts/generate-component.sh "button"
+
+# Generate with configuration
+./scripts/generate-component.sh "button" '{"color": "primary", "size": "m"}'
+
+# Generate with content
+./scripts/generate-component.sh "button" '{"color": "accent"}' "Click Me"
+```
+
+## Output Format
+
+Always provide:
+1. **Import statement** - Freemarker import directive
+2. **Configuration object** - <#assign config = {...}>
+3. **Macro invocation** - <@macroname.macroname config=config>...</@>
+4. **Installation info** - Maven dependency
+
+Example output:
+```ftl
+<#import "mozaic/button.ftl" as button>
+
+<#assign configButton = {
+    "color": "primary",
+    "size": "m",
+    "outlined": false
+}>
+
+<@button.button config=configButton>
+    Click Me
+</@button.button>
+```
+
+## Component Categories
+
+- **action**: Buttons, links, icon buttons
+- **form**: Text inputs, checkboxes, radio buttons, fields, file uploaders
+- **feedback**: Notifications, messages, badges, flags, loaders, progress bars, toasters, tooltips
+- **navigation**: Breadcrumbs, tabs, pagination, steppers, menus
+- **layout**: Containers, dividers, modals, drawers, accordions, popovers
+- **data-display**: Cards, tiles, images, avatars, logos, carousels, callouts, tags, ratings
+
+## Best Practices
+
+1. **Always import macros** at the top of .ftl files
+2. **Define configuration separately** using <#assign>
+3. **Use descriptive variable names** (e.g., configButton, configModal)
+4. **Set locale** with <#global locale="fr_FR"/> for i18n
+5. **Nested content** goes between opening and closing macro tags
+
+## Installation
+
+Maven dependency:
+```xml
+<dependency>
+    <groupId>com.adeo.mozaic</groupId>
+    <artifactId>mozaic-freemarker</artifactId>
+    <version>LATEST_VERSION</version>
+</dependency>
+```
+
+## Documentation
+
+Repository: https://github.com/adeo/mozaic-freemarker
+Design System: https://mozaic.adeo.cloud/
+
+## Example Interaction
+
+**User**: "I need a button for my Freemarker template"
+
+**Assistant**: "I'll help you create a button with Mozaic Freemarker. Let me show you the available options..."
+
+*Runs ./scripts/get-component.sh "button"*
+
+"Here are the button configuration options:
+- color: standard, accent, danger, ghost, inverse
+- size: s, m (default), l
+- outlined: boolean for outlined style
+- loading: boolean for loading state
+
+What style would you like?"
+
+**User**: "Primary colored, medium size"
+
+**Assistant**: *Generates code*
+
+"Here's your Freemarker button code:
+```ftl
+<#import "mozaic/button.ftl" as button>
+
+<#assign configButton = {
+    "color": "primary",
+    "size": "m"
+}>
+
+<@button.button config=configButton>
+    Click Me
+</@button.button>
+```
+
+This will render a primary-colored, medium-sized button. You can customize the text between the tags."