@sebgroup/green-core 2.21.0-rc.20260112150926042 → 2.22.0-rc.20260113120917392

package/bin/mcp-server/tools.js

@@ -1,413 +0,0 @@
-import "../../chunks/chunk.QU3DSPNU.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
-import {
-  buildResourceUri,
-  findComponent,
-  findIcon,
-  loadComponentsIndex,
-  loadGlobalIndex,
-  loadIconsIndex,
-  readMcpFile
-} from "./utils.js";
-function setupToolHandlers(server) {
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-      tools: [
-        {
-          name: "search_components",
-          description: "Search for Green Design System components by name, description, or functionality. Use this when you don't know the exact component name or want to discover available components.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              query: {
-                type: "string",
-                description: "Component name or search term (e.g., 'button', 'dropdown', 'form input', 'arrow icon')"
-              },
-              category: {
-                type: "string",
-                enum: ["component", "icon", "all"],
-                description: "Filter by type. Default: 'all'",
-                default: "all"
-              }
-            },
-            required: ["query"]
-          }
-        },
-        {
-          name: "get_component_docs",
-          description: "Get complete documentation for a specific Green component. ALWAYS specify the framework parameter to get correct import paths, event handling syntax, and framework-specific examples.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              componentName: {
-                type: "string",
-                description: "Component tag name (e.g., 'gds-button') or short name (e.g., 'button')"
-              },
-              framework: {
-                type: "string",
-                enum: ["angular", "react", "web-component"],
-                description: "REQUIRED: Framework you're using. Determines import paths and syntax. Use 'web-component' for vanilla JS/framework-agnostic usage."
-              },
-              includeGuidelines: {
-                type: "boolean",
-                description: "Include UX/design guidelines in response",
-                default: true
-              },
-              includeInstructions: {
-                type: "boolean",
-                description: "Include agent-specific usage instructions if available",
-                default: true
-              }
-            },
-            required: ["componentName", "framework"]
-          }
-        },
-        {
-          name: "list_guides",
-          description: "List available setup guides and conceptual documentation for Green Design System",
-          inputSchema: {
-            type: "object",
-            properties: {
-              category: {
-                type: "string",
-                enum: [
-                  "framework-setup",
-                  "getting-started",
-                  "concepts",
-                  "troubleshooting",
-                  "migration",
-                  "all"
-                ],
-                description: "Filter by category. Default: 'all'",
-                default: "all"
-              },
-              framework: {
-                type: "string",
-                enum: ["angular", "react", "all"],
-                description: "Filter guides relevant to specific framework"
-              }
-            },
-            required: []
-          }
-        },
-        {
-          name: "get_guide",
-          description: "Get the full content of a specific guide. Use list_guides first to discover available guides and their names.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              name: {
-                type: "string",
-                description: "The guide name (e.g., 'angular', 'react', 'installing', 'troubleshooting'). Use list_guides to see available guides."
-              }
-            },
-            required: ["name"]
-          }
-        }
-      ]
-    };
-  });
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    try {
-      switch (name) {
-        case "search_components":
-          return await handleSearchComponents(
-            args
-          );
-        case "get_component_docs":
-          return await handleGetComponentDocs(
-            args
-          );
-        case "list_guides":
-          return await handleListGuides(args);
-        case "get_guide":
-          return await handleGetGuide(args);
-        default:
-          throw new Error(`Unknown tool: ${name}`);
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "Unknown error";
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Error: ${errorMessage}`
-          }
-        ],
-        isError: true
-      };
-    }
-  });
-}
-async function handleSearchComponents(input) {
-  const { query, category = "all" } = input;
-  const results = [];
-  const queryLower = query.toLowerCase();
-  try {
-    const loadComponents = category === "component" || category === "all";
-    const loadIcons = category === "icon" || category === "all";
-    const [componentsIndex, iconsIndex] = await Promise.all([
-      loadComponents ? loadComponentsIndex() : Promise.resolve(null),
-      loadIcons ? loadIconsIndex() : Promise.resolve(null)
-    ]);
-    if (componentsIndex) {
-      for (const component of componentsIndex.components) {
-        const matches = component.tagName.toLowerCase().includes(queryLower) || component.name.toLowerCase().includes(queryLower) || component.className.toLowerCase().includes(queryLower) || component.description?.toLowerCase().includes(queryLower);
-        if (matches) {
-          const shortName = component.tagName.replace(/^gds-/, "");
-          const resourceUris = {};
-          for (const docType of component.files) {
-            resourceUris[docType] = buildResourceUri(
-              "components",
-              shortName,
-              docType
-            );
-          }
-          results.push({
-            name: component.name,
-            tagName: component.tagName,
-            className: component.className,
-            description: component.description,
-            category: "component",
-            availableDocs: component.files,
-            resourceUris
-          });
-        }
-      }
-    }
-    if (iconsIndex) {
-      for (const icon of iconsIndex.icons) {
-        const matches = icon.tagName.toLowerCase().includes(queryLower) || icon.name.toLowerCase().includes(queryLower) || icon.className.toLowerCase().includes(queryLower) || icon.description?.toLowerCase().includes(queryLower);
-        if (matches) {
-          const shortName = icon.tagName.replace(/^gds-/, "");
-          const resourceUris = {};
-          for (const docType of icon.files) {
-            resourceUris[docType] = buildResourceUri(
-              "icons",
-              shortName,
-              docType
-            );
-          }
-          results.push({
-            name: icon.name,
-            tagName: icon.tagName,
-            className: icon.className,
-            description: icon.description,
-            category: "icon",
-            availableDocs: icon.files,
-            resourceUris
-          });
-        }
-      }
-    }
-    results.sort((a, b) => {
-      const aExact = a.tagName.toLowerCase() === queryLower;
-      const bExact = b.tagName.toLowerCase() === queryLower;
-      if (aExact && !bExact) return -1;
-      if (!aExact && bExact) return 1;
-      return a.tagName.localeCompare(b.tagName);
-    });
-    const limitedResults = results.slice(0, 20);
-    return {
-      content: [
-        {
-          type: "text",
-          text: JSON.stringify(
-            {
-              query,
-              resultCount: limitedResults.length,
-              totalMatches: results.length,
-              results: limitedResults
-            },
-            null,
-            2
-          )
-        }
-      ]
-    };
-  } catch (error) {
-    throw new Error(`Search failed: ${error}`);
-  }
-}
-async function handleGetComponentDocs(input) {
-  const {
-    componentName,
-    framework,
-    includeGuidelines = true,
-    includeInstructions = true
-  } = input;
-  try {
-    const [componentsIndex, iconsIndex] = await Promise.all([
-      loadComponentsIndex(),
-      loadIconsIndex()
-    ]);
-    if (!componentsIndex || !iconsIndex) {
-      throw new Error("Failed to load component indexes");
-    }
-    const component = findComponent(componentName, componentsIndex.components);
-    const icon = component ? null : findIcon(componentName, iconsIndex.icons);
-    const found = component || icon;
-    if (!found) {
-      throw new Error(
-        `Component not found: ${componentName}. Try using the search_components tool to find available components.`
-      );
-    }
-    const shortName = found.tagName.replace(/^gds-/, "");
-    const category = component ? "components" : "icons";
-    const sections = [];
-    let primaryDoc;
-    if (framework === "angular") {
-      primaryDoc = "angular";
-    } else if (framework === "react") {
-      primaryDoc = "react";
-    } else {
-      primaryDoc = "api";
-    }
-    sections.push(
-      `# ${found.tagName} - ${framework.charAt(0).toUpperCase() + framework.slice(1)}`
-    );
-    sections.push("");
-    if (framework === "angular" || framework === "react") {
-      sections.push(
-        `\u26A0\uFE0F **${framework.charAt(0).toUpperCase() + framework.slice(1)}-Specific Documentation**`
-      );
-      sections.push(
-        `The import paths and syntax below are for ${framework.charAt(0).toUpperCase() + framework.slice(1)} applications.`
-      );
-      sections.push("");
-    }
-    if (found.files.includes(primaryDoc)) {
-      const content = await readMcpFile(`${shortName}/${primaryDoc}.md`);
-      if (content) {
-        const contentWithoutTitle = content.replace(/^#\s+.*?\n/, "");
-        sections.push(contentWithoutTitle);
-        sections.push("");
-      }
-    }
-    if (includeGuidelines && found.files.includes("guidelines")) {
-      const guidelines = await readMcpFile(`${shortName}/guidelines.md`);
-      if (guidelines) {
-        sections.push("---");
-        sections.push("");
-        sections.push("## Design Guidelines");
-        sections.push("");
-        sections.push(guidelines);
-        sections.push("");
-      }
-    }
-    if (includeInstructions && found.files.includes("instructions")) {
-      const instructions = await readMcpFile(`${shortName}/instructions.md`);
-      if (instructions) {
-        sections.push("---");
-        sections.push("");
-        sections.push("## Usage Instructions");
-        sections.push("");
-        sections.push(instructions);
-        sections.push("");
-      }
-    }
-    sections.push("---");
-    sections.push("");
-    sections.push("\u{1F4A1} **Using a different framework?**");
-    sections.push("Call this tool again with:");
-    if (framework !== "angular")
-      sections.push('- `framework: "angular"` for Angular documentation');
-    if (framework !== "react")
-      sections.push('- `framework: "react"` for React documentation');
-    if (framework !== "web-component")
-      sections.push('- `framework: "web-component"` for vanilla JS usage');
-    return {
-      content: [
-        {
-          type: "text",
-          text: sections.join("\n")
-        }
-      ]
-    };
-  } catch (error) {
-    throw error;
-  }
-}
-async function handleListGuides(input) {
-  const { category = "all", framework } = input;
-  try {
-    const globalIndex = await loadGlobalIndex();
-    if (!globalIndex) {
-      throw new Error("Failed to load global index");
-    }
-    let guides = globalIndex.guides;
-    if (category !== "all") {
-      guides = guides.filter((g) => g.category === category);
-    }
-    if (framework && framework !== "all") {
-      guides = guides.filter((g) => g.tags.includes(framework));
-    }
-    const guidesWithUris = guides.map((guide) => {
-      const name = guide.path.replace(/^(guides|concepts)\//, "").replace(/\.md$/, "");
-      const guideCategory = guide.path.startsWith("guides/") ? "guides" : "concepts";
-      const uri = buildResourceUri(guideCategory, name);
-      return {
-        title: guide.title,
-        category: guide.category,
-        description: guide.description,
-        tags: guide.tags,
-        resourceUri: uri
-      };
-    });
-    return {
-      content: [
-        {
-          type: "text",
-          text: JSON.stringify(
-            {
-              guideCount: guidesWithUris.length,
-              guides: guidesWithUris
-            },
-            null,
-            2
-          )
-        }
-      ]
-    };
-  } catch (error) {
-    throw new Error(`Failed to list guides: ${error}`);
-  }
-}
-async function handleGetGuide(input) {
-  const { name } = input;
-  try {
-    const globalIndex = await loadGlobalIndex();
-    if (!globalIndex) {
-      throw new Error("Failed to load global index");
-    }
-    const guide = globalIndex.guides.find((g) => {
-      const guideName = g.path.replace(/^(guides|concepts)\//, "").replace(/\.md$/, "");
-      return guideName === name;
-    });
-    if (!guide) {
-      throw new Error(
-        `Guide not found: ${name}. Use list_guides to see available guides.`
-      );
-    }
-    const content = await readMcpFile(guide.path);
-    return {
-      content: [
-        {
-          type: "text",
-          text: `# ${guide.title}
-
-${content}`
-        }
-      ]
-    };
-  } catch (error) {
-    throw new Error(`Failed to get guide: ${error}`);
-  }
-}
-export {
-  setupToolHandlers
-};

package/bin/mcp-server/types.d.ts

@@ -1,111 +0,0 @@
-/**
- * Type definitions for Green Design System MCP Server
- */
-/**
- * Component metadata from components.json
- */
-export interface ComponentEntry {
-    name: string;
-    tagName: string;
-    className: string;
-    description?: string;
-    path: string;
-    files: string[];
-    subcomponents?: Array<{
-        tagName: string;
-        description?: string;
-    }>;
-}
-/**
- * Icon metadata from icons.json
- */
-export interface IconEntry {
-    name: string;
-    tagName: string;
-    className: string;
-    description?: string;
-    path: string;
-    files: string[];
-}
-/**
- * Guide metadata from index.json
- */
-export interface GuideEntry {
-    title: string;
-    path: string;
-    category: string;
-    description: string;
-    tags: string[];
-}
-/**
- * Components index structure
- */
-export interface ComponentsIndex {
-    version: string;
-    generatedAt: string;
-    components: ComponentEntry[];
-}
-/**
- * Icons index structure
- */
-export interface IconsIndex {
-    version: string;
-    generatedAt: string;
-    icons: IconEntry[];
-}
-/**
- * Global index structure
- */
-export interface GlobalIndex {
-    version: string;
-    generatedAt: string;
-    components: string;
-    icons: string;
-    guides: GuideEntry[];
-}
-/**
- * Framework types
- */
-export type Framework = 'angular' | 'react' | 'web-component';
-/**
- * Category types for search
- */
-export type Category = 'component' | 'icon' | 'all';
-/**
- * Guide category types
- */
-export type GuideCategory = 'framework-setup' | 'getting-started' | 'concepts' | 'troubleshooting' | 'migration' | 'all';
-/**
- * Search result
- */
-export interface SearchResult {
-    name: string;
-    tagName: string;
-    className: string;
-    description?: string;
-    category: 'component' | 'icon';
-    availableDocs: string[];
-    resourceUris: {
-        [key: string]: string;
-    };
-}
-/**
- * Tool input schemas
- */
-export interface SearchComponentsInput {
-    query: string;
-    category?: Category;
-}
-export interface GetComponentDocsInput {
-    componentName: string;
-    framework: Framework;
-    includeGuidelines?: boolean;
-    includeInstructions?: boolean;
-}
-export interface ListGuidesInput {
-    category?: GuideCategory;
-    framework?: 'angular' | 'react' | 'all';
-}
-export interface GetGuideInput {
-    name: string;
-}

package/bin/mcp-server/utils.d.ts

@@ -1,56 +0,0 @@
-import type { ComponentEntry, ComponentsIndex, GlobalIndex, IconEntry, IconsIndex } from './types.js';
-/**
- * Resolve the path to the MCP data directory
- * When compiled: Server is at dist/libs/core/src/bin/mcp-server/
- * When compiled: MCP data is at dist/libs/core/src/generated/mcp/
- */
-export declare function getMcpDataPath(): string;
-/**
- * Read the package version from package.json at runtime
- */
-export declare function getPackageVersion(): Promise<string>;
-/**
- * Load the components index
- */
-export declare function loadComponentsIndex(): Promise<ComponentsIndex | null>;
-/**
- * Load the icons index
- */
-export declare function loadIconsIndex(): Promise<IconsIndex | null>;
-/**
- * Load the global index
- */
-export declare function loadGlobalIndex(): Promise<GlobalIndex | null>;
-/**
- * Normalize component name for matching
- * Handles both 'gds-button' and 'button' formats
- */
-export declare function normalizeComponentName(name: string): string;
-/**
- * Find a component by name (flexible matching)
- */
-export declare function findComponent(name: string, components: ComponentEntry[]): ComponentEntry | null;
-/**
- * Find an icon by name (flexible matching)
- */
-export declare function findIcon(name: string, icons: IconEntry[]): IconEntry | null;
-/**
- * Read a markdown file from the MCP data directory
- */
-export declare function readMcpFile(relativePath: string): Promise<string | null>;
-/**
- * Check if a file exists in the MCP data directory
- */
-export declare function fileExists(relativePath: string): Promise<boolean>;
-/**
- * Build a resource URI for a component/icon documentation file
- */
-export declare function buildResourceUri(category: 'components' | 'icons' | 'guides' | 'concepts', name: string, docType?: string): string;
-/**
- * Parse a resource URI into its components
- */
-export declare function parseResourceUri(uri: string): {
-    category: string;
-    name: string;
-    docType?: string;
-} | null;

package/bin/mcp-server/utils.js

@@ -1,123 +0,0 @@
-import "../../chunks/chunk.QU3DSPNU.js";
-import { promises as fs } from "fs";
-import * as path from "node:path";
-import { fileURLToPath } from "url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-function getMcpDataPath() {
-  return path.resolve(__dirname, "../../generated/mcp");
-}
-async function getPackageVersion() {
-  try {
-    const packageJsonPath = path.resolve(__dirname, "../../package.json");
-    const content = await fs.readFile(packageJsonPath, "utf-8");
-    const pkg = JSON.parse(content);
-    return pkg.version || "0.0.0";
-  } catch (error) {
-    console.error("Failed to read package version:", error);
-    return "0.0.0";
-  }
-}
-async function loadJsonFile(filePath) {
-  try {
-    const content = await fs.readFile(filePath, "utf-8");
-    return JSON.parse(content);
-  } catch (error) {
-    console.error(`Failed to load ${filePath}:`, error);
-    return null;
-  }
-}
-async function loadComponentsIndex() {
-  const dataPath = getMcpDataPath();
-  return loadJsonFile(path.join(dataPath, "components.json"));
-}
-async function loadIconsIndex() {
-  const dataPath = getMcpDataPath();
-  return loadJsonFile(path.join(dataPath, "icons.json"));
-}
-async function loadGlobalIndex() {
-  const dataPath = getMcpDataPath();
-  return loadJsonFile(path.join(dataPath, "index.json"));
-}
-function normalizeComponentName(name) {
-  const lower = name.toLowerCase().trim();
-  if (lower.startsWith("gds-")) {
-    return lower;
-  }
-  if (lower.startsWith("icon-")) {
-    return `gds-${lower}`;
-  }
-  return `gds-${lower}`;
-}
-function findComponent(name, components) {
-  const normalized = normalizeComponentName(name);
-  let found = components.find((c) => c.tagName === normalized);
-  if (found) return found;
-  const withoutPrefix = name.replace(/^gds-/, "");
-  found = components.find((c) => c.tagName === `gds-${withoutPrefix}`);
-  if (found) return found;
-  const lowerName = name.toLowerCase();
-  found = components.find(
-    (c) => c.tagName.toLowerCase().includes(lowerName) || c.name.toLowerCase().includes(lowerName)
-  );
-  return found || null;
-}
-function findIcon(name, icons) {
-  const normalized = normalizeComponentName(name);
-  let found = icons.find((i) => i.tagName === normalized);
-  if (found) return found;
-  const withoutPrefix = name.replace(/^gds-/, "").replace(/^icon-/, "");
-  found = icons.find((i) => i.tagName === `gds-icon-${withoutPrefix}`);
-  if (found) return found;
-  const lowerName = name.toLowerCase();
-  found = icons.find(
-    (i) => i.tagName.toLowerCase().includes(lowerName) || i.name.toLowerCase().includes(lowerName)
-  );
-  return found || null;
-}
-async function readMcpFile(relativePath) {
-  try {
-    const dataPath = getMcpDataPath();
-    const fullPath = path.join(dataPath, relativePath);
-    return await fs.readFile(fullPath, "utf-8");
-  } catch (error) {
-    console.error(`Failed to read ${relativePath}:`, error);
-    return null;
-  }
-}
-async function fileExists(relativePath) {
-  try {
-    const dataPath = getMcpDataPath();
-    const fullPath = path.join(dataPath, relativePath);
-    await fs.access(fullPath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function buildResourceUri(category, name, docType) {
-  if (docType) {
-    return `green://${category}/${name}/${docType}`;
-  }
-  return `green://${category}/${name}`;
-}
-function parseResourceUri(uri) {
-  const match = uri.match(/^green:\/\/([^/]+)\/([^/]+)(?:\/([^/]+))?$/);
-  if (!match) return null;
-  const [, category, name, docType] = match;
-  return { category, name, docType };
-}
-export {
-  buildResourceUri,
-  fileExists,
-  findComponent,
-  findIcon,
-  getMcpDataPath,
-  getPackageVersion,
-  loadComponentsIndex,
-  loadGlobalIndex,
-  loadIconsIndex,
-  normalizeComponentName,
-  parseResourceUri,
-  readMcpFile
-};