@iress-oss/ids-mcp-server 0.0.1 → 5.14.2

package/{build → dist}/searchHandlers.js

@@ -1,10 +1,10 @@
 /**
  * Tool handlers for search and documentation operations
  */
-import { z } from "zod";
-import * as path from "path";
-import { getMarkdownFiles, readFileContent } from "./utils.js";
-import { DOCS_DIR } from "./config.js";
+import { z } from 'zod';
+import * as path from 'path';
+import { getMarkdownFiles, readFileContent } from './utils.js';
+import { DOCS_DIR } from './config.js';
 export function handleGetUsageExamples(args) {
     const schema = z.object({
         component: z.string(),
@@ -14,18 +14,18 @@ export function handleGetUsageExamples(args) {
     const markdownFiles = getMarkdownFiles();
     // Find component files (main + recipes)
     const componentFiles = markdownFiles.filter((file) => file.includes(`${component.toLowerCase()}`) ||
-        (file.includes("recipes") &&
+        (file.includes('recipes') &&
             file.toLowerCase().includes(component.toLowerCase())));
     if (componentFiles.length === 0) {
         return {
             content: [
                 {
-                    type: "text",
+                    type: 'text',
                     text: `No examples found for "${component}". Try: ${markdownFiles
-                        .filter((f) => f.startsWith("components-"))
+                        .filter((f) => f.startsWith('components-'))
                         .slice(0, 5)
-                        .map((f) => f.replace("components-", "").replace("-docs.md", ""))
-                        .join(", ")}`,
+                        .map((f) => f.replace('components-', '').replace('-docs.md', ''))
+                        .join(', ')}`,
                 },
             ],
         };
@@ -36,8 +36,8 @@ export function handleGetUsageExamples(args) {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
             // Extract code examples
-            const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
-            const jsxBlocks = content.match(/<[A-Z][^>]*>[\s\S]*?<\/[A-Z][^>]*>/g) || [];
+            const codeBlocks = content.match(/```[\s\S]*?```/g) ?? [];
+            const jsxBlocks = content.match(/<[A-Z][^>]*>[\s\S]*?<\/[A-Z][^>]*>/g) ?? [];
             if (pattern) {
                 // Filter examples by pattern
                 const patternMatches = [...codeBlocks, ...jsxBlocks].filter((block) => block.toLowerCase().includes(pattern.toLowerCase()));
@@ -51,13 +51,18 @@ export function handleGetUsageExamples(args) {
             console.error(`Error reading file ${file}:`, error);
         }
     }
+    const patternSuffix = pattern ? ` (${pattern} pattern)` : '';
+    const patternNotFoundSuffix = pattern ? ` with pattern "${pattern}"` : '';
+    const examplesText = examples.length > 0
+        ? `**${component} Usage Examples**${patternSuffix}:\n\n${examples
+            .slice(0, 5)
+            .join('\n\n---\n\n')}`
+        : `No usage examples found for "${component}"${patternNotFoundSuffix}.`;
     return {
         content: [
             {
-                type: "text",
-                text: examples.length > 0
-                    ? `**${component} Usage Examples**${pattern ? ` (${pattern} pattern)` : ""}:\n\n${examples.slice(0, 5).join("\n\n---\n\n")}`
-                    : `No usage examples found for "${component}"${pattern ? ` with pattern "${pattern}"` : ""}.`,
+                type: 'text',
+                text: examplesText,
             },
         ],
     };
@@ -74,7 +79,7 @@ export function handleSearchIdsDocs(args) {
         try {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
-            const lines = content.split("\n");
+            const lines = content.split('\n');
             lines.forEach((line, index) => {
                 const searchLine = case_sensitive ? line : line.toLowerCase();
                 const searchQuery = case_sensitive ? query : query.toLowerCase();
@@ -82,9 +87,9 @@ export function handleSearchIdsDocs(args) {
                     // Get context (surrounding lines)
                     const contextStart = Math.max(0, index - 1);
                     const contextEnd = Math.min(lines.length - 1, index + 1);
-                    const context = lines.slice(contextStart, contextEnd + 1).join("\n");
+                    const context = lines.slice(contextStart, contextEnd + 1).join('\n');
                     results.push({
-                        file: file.replace("-docs.md", "").replace(/^[a-z]+-/, ""),
+                        file: file.replace('-docs.md', '').replace(/^[a-z]+-/, ''),
                         line: index + 1,
                         content: line.trim(),
                         context,
@@ -99,12 +104,12 @@ export function handleSearchIdsDocs(args) {
     return {
         content: [
             {
-                type: "text",
+                type: 'text',
                 text: results.length > 0
                     ? `Found ${results.length} matches in IDS documentation:\n\n${results
                         .slice(0, 15) // Limit results
                         .map((r) => `**${r.file}:${r.line}**\n\`\`\`\n${r.context}\n\`\`\``)
-                        .join("\n\n")}`
+                        .join('\n\n')}`
                     : `No matches found for "${query}" in IDS documentation.`,
             },
         ],
@@ -113,31 +118,32 @@ export function handleSearchIdsDocs(args) {
 export function handleGetDesignTokens(args) {
     const schema = z.object({
         type: z
-            .enum(["colors", "spacing", "typography", "breakpoints", "all"])
-            .default("all"),
+            .enum(['colors', 'spacing', 'typography', 'breakpoints', 'all'])
+            .default('all'),
     });
     const { type } = schema.parse(args);
     const markdownFiles = getMarkdownFiles();
     // Find foundation files related to design tokens
-    const foundationFiles = markdownFiles.filter((file) => file.startsWith("foundations-") && (type === "all" || file.includes(type)));
+    const foundationFiles = markdownFiles.filter((file) => file.startsWith('foundations-') &&
+        (type === 'all' || file.includes(type)));
     const tokenInfo = [];
     for (const file of foundationFiles) {
         try {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
             // Extract CSS custom properties and token information
-            const cssVariables = content.match(/--iress-[a-z-]+/g) || [];
-            const tokenSections = content.match(/###?\s+[^#\n]+[\s\S]*?(?=###|$)/g) || [];
+            const cssVariables = content.match(/--iress-[a-z-]+/g) ?? [];
+            const tokenSections = content.match(/#{2,3}\s+[^#\n]+/g) ?? [];
             if (cssVariables.length > 0 || tokenSections.length > 0) {
                 let fileInfo = `**${file
-                    .replace("foundations-", "")
-                    .replace("-docs.md", "")}**\n`;
+                    .replace('foundations-', '')
+                    .replace('-docs.md', '')}**\n`;
                 if (cssVariables.length > 0) {
                     const uniqueVars = [...new Set(cssVariables)].slice(0, 10);
-                    fileInfo += `CSS Variables: ${uniqueVars.join(", ")}\n`;
+                    fileInfo += `CSS Variables: ${uniqueVars.join(', ')}\n`;
                 }
                 if (tokenSections.length > 0) {
-                    fileInfo += `\n${tokenSections.slice(0, 3).join("\n\n")}`;
+                    fileInfo += `\n${tokenSections.slice(0, 3).join('\n\n')}`;
                 }
                 tokenInfo.push(fileInfo);
             }
@@ -146,20 +152,61 @@ export function handleGetDesignTokens(args) {
             console.error(`Error reading file ${file}:`, error);
         }
     }
+    const typeLabel = type !== 'all' ? ` (${type})` : '';
+    const typeNotFoundLabel = type !== 'all' ? ` for ${type}` : '';
     return {
         content: [
             {
-                type: "text",
+                type: 'text',
                 text: tokenInfo.length > 0
-                    ? `**IDS Design Tokens${type !== "all" ? ` (${type})` : ""}**\n\n${tokenInfo.join("\n\n---\n\n")}`
-                    : `No design token information found${type !== "all" ? ` for ${type}` : ""}. Available foundations: ${markdownFiles
-                        .filter((f) => f.startsWith("foundations-"))
-                        .map((f) => f.replace("foundations-", "").replace("-docs.md", ""))
-                        .join(", ")}`,
+                    ? `**IDS Design Tokens${typeLabel}**\n\n${tokenInfo.join('\n\n---\n\n')}`
+                    : `No design token information found${typeNotFoundLabel}. Available foundations: ${markdownFiles
+                        .filter((f) => f.startsWith('foundations-'))
+                        .map((f) => f.replace('foundations-', '').replace('-docs.md', ''))
+                        .join(', ')}`,
             },
         ],
     };
 }
+function findSectionContent(content, section) {
+    const sectionRegex = new RegExp(`(#{1,3}\\s+.*${section}.*?(?=#{1,3}|$))`, 'gis');
+    const sectionMatch = sectionRegex.exec(content);
+    if (sectionMatch) {
+        return sectionMatch[0];
+    }
+    // Try to find sections that contain the search term
+    const sections = content.split(/(?=#{1,3}\s+)/);
+    const matchingSections = sections.filter((sectionContent) => sectionContent.toLowerCase().includes(section.toLowerCase()));
+    return matchingSections.length > 0 ? matchingSections.join('\n\n') : null;
+}
+function addContextLines(lines, startIndex, endIndex, contextLines) {
+    for (let j = startIndex; j < endIndex; j++) {
+        if (!contextLines.includes(lines[j])) {
+            contextLines.push(lines[j]);
+        }
+    }
+}
+function filterContentByQuery(content, query) {
+    const lines = content.split('\n');
+    const contextLines = [];
+    const queryLower = query.toLowerCase();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.toLowerCase().includes(queryLower)) {
+            // Add context lines before
+            const startContext = Math.max(0, i - 3);
+            addContextLines(lines, startContext, i, contextLines);
+            // Add the matching line
+            if (!contextLines.includes(line)) {
+                contextLines.push(line);
+            }
+            // Add context lines after
+            const endContext = Math.min(lines.length, i + 4);
+            addContextLines(lines, i + 1, endContext, contextLines);
+        }
+    }
+    return contextLines.length > 0 ? contextLines.join('\n') : null;
+}
 export function handleGetDesignGuidelines(args) {
     const schema = z.object({
         section: z.string().optional(),
@@ -168,14 +215,14 @@ export function handleGetDesignGuidelines(args) {
     const { section, query } = schema.parse(args);
     try {
         // Read the guidelines.md file from the docs directory
-        const guidelinesPath = path.join(DOCS_DIR, "..", "guidelines.md");
+        const guidelinesPath = path.join(DOCS_DIR, 'guidelines.md');
         const content = readFileContent(guidelinesPath);
         if (!content) {
             return {
                 content: [
                     {
-                        type: "text",
-                        text: "Design guidelines file not found. Please ensure guidelines.md exists in the docs directory.",
+                        type: 'text',
+                        text: 'Design guidelines file not found. Please ensure guidelines.md exists in the docs directory.',
                     },
                 ],
             };
@@ -183,88 +230,56 @@ export function handleGetDesignGuidelines(args) {
         let filteredContent = content;
         // Filter by section if specified
         if (section) {
-            const sectionRegex = new RegExp(`(#{1,3}\\s+.*${section}.*?(?=#{1,3}|$))`, "gis");
-            const sectionMatch = content.match(sectionRegex);
-            if (sectionMatch) {
-                filteredContent = sectionMatch[0];
+            const sectionContent = findSectionContent(content, section);
+            if (sectionContent) {
+                filteredContent = sectionContent;
             }
             else {
-                // Try to find sections that contain the search term
-                const sections = content.split(/(?=#{1,3}\s+)/);
-                const matchingSections = sections.filter((section) => section.toLowerCase().includes(section.toLowerCase()));
-                if (matchingSections.length > 0) {
-                    filteredContent = matchingSections.join("\n\n");
-                }
-                else {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: `Section "${section}" not found in design guidelines. Available sections include: Core Design Principles, Visual Design Standards, Component Guidelines, Accessibility, Layout Systems, and Best Practices.`,
-                            },
-                        ],
-                    };
-                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Section "${section}" not found in design guidelines. Available sections include: Core Design Principles, Visual Design Standards, Component Guidelines, Accessibility, Layout Systems, and Best Practices.`,
+                        },
+                    ],
+                };
             }
         }
         // Filter by query if specified
         if (query) {
-            const lines = filteredContent.split("\n");
-            const relevantLines = [];
-            let contextLines = [];
-            for (let i = 0; i < lines.length; i++) {
-                const line = lines[i];
-                if (line.toLowerCase().includes(query.toLowerCase())) {
-                    // Add context lines before
-                    const startContext = Math.max(0, i - 3);
-                    for (let j = startContext; j < i; j++) {
-                        if (!contextLines.includes(lines[j])) {
-                            contextLines.push(lines[j]);
-                        }
-                    }
-                    // Add the matching line
-                    if (!contextLines.includes(line)) {
-                        contextLines.push(line);
-                    }
-                    // Add context lines after
-                    const endContext = Math.min(lines.length, i + 4);
-                    for (let j = i + 1; j < endContext; j++) {
-                        if (!contextLines.includes(lines[j])) {
-                            contextLines.push(lines[j]);
-                        }
-                    }
-                }
-            }
-            if (contextLines.length > 0) {
-                filteredContent = contextLines.join("\n");
+            const queryContent = filterContentByQuery(filteredContent, query);
+            if (queryContent) {
+                filteredContent = queryContent;
             }
             else {
                 return {
                     content: [
                         {
-                            type: "text",
+                            type: 'text',
                             text: `No guidelines found matching "${query}". Try searching for terms like: accessibility, typography, colors, spacing, components, principles, or usability.`,
                         },
                     ],
                 };
             }
         }
+        const sectionSuffix = section ? ` - ${section}` : '';
+        const querySuffix = query ? ` (filtered by: ${query})` : '';
         return {
             content: [
                 {
-                    type: "text",
-                    text: `**IDS Design Guidelines${section ? ` - ${section}` : ""}${query ? ` (filtered by: ${query})` : ""}**\n\n${filteredContent}`,
+                    type: 'text',
+                    text: `**IDS Design Guidelines${sectionSuffix}${querySuffix}**\n\n${filteredContent}`,
                 },
             ],
         };
     }
     catch (error) {
-        console.error("Error reading guidelines:", error);
+        console.error('Error reading guidelines:', error);
         return {
             content: [
                 {
-                    type: "text",
-                    text: "Error reading design guidelines. Please ensure the guidelines.md file exists and is accessible.",
+                    type: 'text',
+                    text: 'Error reading design guidelines. Please ensure the guidelines.md file exists and is accessible.',
                 },
             ],
         };