@fundamental-styles/mcp 0.41.7-rc.8 → 0.41.7

package/data/schemas/component-frontmatter.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://sap.github.io/fundamental-styles/schemas/component-frontmatter.schema.json",
+  "title": "Component Documentation Frontmatter",
+  "description": "JSON Schema for validating component documentation frontmatter in fundamental-styles",
+  "type": "object",
+  "required": [
+    "component",
+    "title",
+    "category",
+    "sourcePath",
+    "generatedAt"
+  ],
+  "properties": {
+    "component": {
+      "type": "string",
+      "description": "Component identifier (usually the selector)",
+      "minLength": 0,
+      "maxLength": 100,
+      "examples": ["fd-button", "fd-table", "fd-dialog", ""]
+    },
+    "title": {
+      "type": "string",
+      "description": "Full component title with category path",
+      "minLength": 3,
+      "maxLength": 200,
+      "examples": ["Components/Buttons/Button", "Layouts/Dynamic Page"]
+    },
+    "category": {
+      "type": "string",
+      "description": "Primary category of the component",
+      "enum": [
+        "Components",
+        "Layouts",
+        "Patterns",
+        "BTP",
+        "AI",
+        "Deprecated",
+        "Dev",
+        "border",
+        "border-radius",
+        "container-queries",
+        "elevation",
+        "heading",
+        "media-queries",
+        "overflow",
+        "padding",
+        "page-title",
+        "patterns",
+        "reset",
+        "text",
+        "typography"
+      ]
+    },
+    "selector": {
+      "type": "string",
+      "description": "CSS selector for the component",
+      "pattern": "^(fd-[a-z][a-z0-9-]*)?$",
+      "maxLength": 100,
+      "examples": ["fd-button", "fd-table", ""]
+    },
+    "cssFile": {
+      "type": "string",
+      "description": "Main CSS file for the component",
+      "maxLength": 100,
+      "examples": ["button.css", "table.css", ""]
+    },
+    "sourcePath": {
+      "type": "string",
+      "description": "Path to the source story file",
+      "pattern": "^packages/[^/]+/stories/.+\\.stories\\.js$",
+      "minLength": 10,
+      "maxLength": 500,
+      "examples": ["packages/styles/stories/Components/button/button.stories.js"]
+    },
+    "tags": {
+      "type": "array",
+      "description": "Tags associated with the component",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 50
+      },
+      "uniqueItems": true,
+      "examples": [[], ["deprecated"], ["experimental", "beta"]]
+    },
+    "dependencies": {
+      "type": "array",
+      "description": "CSS dependencies (other components this component requires)",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 100
+      },
+      "uniqueItems": true,
+      "examples": [["button", "icon", "menu"]]
+    },
+    "relatedComponents": {
+      "type": "array",
+      "description": "Related components that work with this component",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 100
+      },
+      "uniqueItems": true,
+      "examples": [["button-split", "icon", "menu"]]
+    },
+    "stability": {
+      "type": "string",
+      "description": "Component stability status",
+      "enum": ["stable", "deprecated", "experimental"],
+      "examples": ["stable", "deprecated", "experimental"]
+    },
+    "generatedAt": {
+      "type": "string",
+      "description": "ISO 8601 timestamp when documentation was generated",
+      "format": "date-time",
+      "examples": ["2026-05-28T16:36:10.302Z"]
+    }
+  },
+  "additionalProperties": false
+}

package/data/schemas/component-markdown.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://sap.github.io/fundamental-styles/schemas/component-markdown.schema.json",
+  "title": "Component Markdown Schema",
+  "description": "JSON Schema for validating component markdown frontmatter in fundamental-styles",
+  "type": "object",
+  "required": [
+    "component",
+    "title",
+    "category",
+    "selector",
+    "cssFile",
+    "sourcePath",
+    "generatedAt"
+  ],
+  "properties": {
+    "component": {
+      "type": "string",
+      "description": "Component identifier (typically the fd- class name)",
+      "pattern": "^fd-[a-z][a-z0-9-]*$"
+    },
+    "title": {
+      "type": "string",
+      "description": "Human-readable component title",
+      "minLength": 1
+    },
+    "category": {
+      "type": "string",
+      "description": "Component category (Components, BTP, Patterns, AI, Layouts, etc.)",
+      "enum": [
+        "AI",
+        "BTP",
+        "Components",
+        "Deprecated",
+        "Layouts",
+        "Patterns",
+        "Visuals",
+        "common-css",
+        "cx"
+      ]
+    },
+    "selector": {
+      "type": "string",
+      "description": "CSS selector for the component",
+      "pattern": "^fd-[a-z][a-z0-9-]*$"
+    },
+    "cssFile": {
+      "type": "string",
+      "description": "CSS file name for the component",
+      "pattern": "^[a-z][a-z0-9-]*\\.css$"
+    },
+    "sourcePath": {
+      "type": "string",
+      "description": "Path to the source story file",
+      "pattern": "^packages/.*\\.stories\\.js$"
+    },
+    "tags": {
+      "type": "array",
+      "description": "Tags for the component (from Storybook)",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true
+    },
+    "dependencies": {
+      "type": "array",
+      "description": "CSS dependencies required by this component",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*$"
+      },
+      "uniqueItems": true
+    },
+    "generatedAt": {
+      "type": "string",
+      "description": "Timestamp when the documentation was generated",
+      "format": "date-time"
+    }
+  },
+  "additionalProperties": false
+}

package/data/schemas/counter.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/counter.json",
   "title": "Counter Component",
-  "description": "Counter component",
+  "description": "Counters display numerical values with optional indicators (e.g., \"5 new messages\"). Typically used in navigation items, cards, or list headers to show counts, notifications, or status summaries.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/dynamic-page.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/dynamic-page.json",
   "title": "Dynamic Page Component",
-  "description": "Dynamic Page component",
+  "description": "Dynamic Page is foundation for all SAP pages. Generic layout supporting various use cases with variable header and page content. Header is collapsible to help users focus on content while keeping important header info and actions readily available. Uses foundation layout components (dynamic page header, footer toolbar).",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/dynamic-side-content.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/dynamic-side-content.json",
   "title": "Dynamic Side Content Component",
-  "description": "Dynamic Side Content component",
+  "description": "Dynamic Side Content is layout control displaying supplemental content in separate area to support understanding of main content. Two elements: side content section (`.fd-dynamic-side__side`) and main content section (`.fd-dynamic-side__main`). Screen width ratio varies based on available space - side displays left/right or bottom if space limited.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/facet.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/facet.json",
   "title": "Facet Component",
-  "description": "Facet component",
+  "description": "Facets display key-value pairs in a compact, scannable format. Use in object headers or cards to show essential information like status, date, owner, or metrics. Supports icons and semantic colors.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/fieldset.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/fieldset.json",
   "title": "Fieldset Component",
-  "description": "Fieldset component",
+  "description": "A fieldset gives semantic meaning to a group of elements inside a form (e.g., Billing or Shipping Address). Grouping fields provides styling and accessibility benefits, and is especially important for checkbox groups and radio button groups.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/flexible-column-layout.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/flexible-column-layout.json",
   "title": "Flexible Column Layout Component",
-  "description": "Flexible Column Layout component",
+  "description": "Flexible Column Layout is layout control displaying multiple floorplans on single page. Enables faster, more fluid navigation between floorplans than page-by-page. Offers layouts with up to 3 columns (1, 2, 3). Users can resize columns, switch layouts, view rightmost column in full screen. Responsive for desktop and mobile.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/form-group.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/form-group.json",
   "title": "Form Group Component",
-  "description": "Form Group component",
+  "description": "Form groups assemble form elements with labels, messages, and help containers. Components like `fd-form__item` with label and control can be used independently when error messages aren't needed.",
   "type": "object",
   "properties": {
     "baseClass": {
@@ -16,7 +16,8 @@
           "fd-form-group--inline",
           "fd-form-group--with-spacing",
           "fd-form-group--no-padding",
-          "fd-form-group--no-border"
+          "fd-form-group--no-border",
+          "fd-form-group--wrap"
         ]
       },
       "description": "Optional modifier classes"

package/data/schemas/form-header.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/form-header.json",
   "title": "Form Header Component",
-  "description": "Form Header component",
+  "description": "Form headers are titles that provide context about a group of input fields. For example, \"Personal Information\" would categorize fields like Name, Address, etc.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/form-label.schema.json

@@ -14,6 +14,7 @@
       "items": {
         "enum": [
           "fd-form-label--disabled",
+          "fd-form-label--wrap",
           "fd-form-label--unit-description",
           "fd-form-label--required",
           "fd-form-label--colon",

package/data/schemas/form-message.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/form-message.json",
   "title": "Form Message Component",
-  "description": "Form Message component",
+  "description": "Form messages display value state text (success, error, warning, information) shown when focus is on the input field. They work with input control value states to provide feedback to users.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/grid-list.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/grid-list.json",
   "title": "Grid List Component",
-  "description": "Grid List component",
+  "description": "Grid list displays items in a grid format (not rows), ideal for visual content like images, charts, and object cards that benefit from more height. Usually used as an alternative view for lists or tables, focusing on complete items rather than cells.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/input-group.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/input-group.json",
   "title": "Input Group Component",
-  "description": "Input Group component",
+  "description": "Input Group combines form inputs with add-ons (text, icons, or buttons) to help users understand the information being entered. Add-ons can be positioned before, after, or on both sides of the input field. Supports validation states (success, error, warning, information).",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/layout-panel.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/layout-panel.json",
   "title": "Layout Panel Component",
-  "description": "Layout Panel component",
+  "description": "Layout Panels encapsulate part of content, form elements, lists, collections on a page. Place patterns and interactions within panels to achieve focus and separation for tasks with information displayed inside panel. Organizes content into distinct sections.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/page.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/page.json",
   "title": "Page Component",
-  "description": "Page component",
+  "description": "Page is the foundation wrapper for all application pages. Provides consistent structure with optional header, footer, and content areas. Use as the outermost container for every page in your application.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/quick-view.schema.json

@@ -13,7 +13,8 @@
       "type": "array",
       "items": {
         "enum": [
-          "fd-quick-view--header-with-subheader"
+          "fd-quick-view--header-with-subheader",
+          "fd-quick-view--wrap"
         ]
       },
       "description": "Optional modifier classes"

package/data/schemas/section.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/section.json",
   "title": "Section Component",
-  "description": "Section component",
+  "description": "Sections group related content on a page with optional headers and visual separation. Use to organize page content into logical, scannable blocks. Can be collapsible to help users focus on relevant information.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/side-nav.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/side-nav.json",
   "title": "Side Nav Component",
-  "description": "Side Nav component",
+  "description": "Side Navigation provides hierarchical navigation for applications. Displays a collapsible sidebar with navigation items, icons, and nested submenus. Use for primary app navigation in the Shellbar or as dedicated sidebar.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/splitter.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/splitter.json",
   "title": "Splitter Component",
-  "description": "Splitter component",
+  "description": "Splitter divides screen into resizable panes separated by a draggable divider. Users can adjust pane sizes by dragging the separator. Use for master-detail layouts or comparing content side-by-side.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/tabs.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/tabs.json",
   "title": "Tabs Component",
-  "description": "Tabs component",
+  "description": "Tabs organize content into separate views, allowing users to switch between different sections without leaving the page. Use for dividing content into meaningful categories that users can explore one at a time.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/tile.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/tile.json",
   "title": "Tile Component",
-  "description": "Tile component",
+  "description": "Tiles display summarized information or entry points to applications, pages, or actions. Use in home pages, launchpads, or dashboards to present options in a grid layout. Can include icons, titles, subtitles, and quick actions.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/tool-layout.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/tool-layout.json",
   "title": "Tool Layout Component",
-  "description": "Tool Layout component",
+  "description": "Tool Layout consists of three main areas: Tool Header (always present, top-aligned with global actions and navigation controls), Navigation (side navigation in expanded/snapped variants), and Content (empty container for any content). Complete layout structure for tool-based applications.",
   "type": "object",
   "properties": {
     "baseClass": {

package/data/schemas/user-menu.schema.json

@@ -64,6 +64,16 @@
             }
           }
         },
+        "fd-user-menu__header-content-area": {
+          "type": "object",
+          "description": "header-content-area element",
+          "properties": {
+            "class": {
+              "const": "fd-user-menu__header-content-area",
+              "description": "Element class name"
+            }
+          }
+        },
         "fd-user-menu__user-name": {
           "type": "object",
           "description": "user-name element",

package/data/schemas/wizard.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://sap.github.io/fundamental-styles/schemas/wizard.json",
   "title": "Wizard Component",
-  "description": "Wizard component",
+  "description": "Wizard guides user through long or unfamiliar task by dividing into sections, revealing information in digestible way. Consists of walkthrough screen (input required info) and summary page (read-only review before submission). Two types: standard (linear, known steps) and branching (non-linear, variable steps). Supports 3-8 steps, optional steps allowed.",
   "type": "object",
   "properties": {
     "baseClass": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fundamental-styles/mcp",
-  "version": "0.41.7-rc.8",
+  "version": "0.41.7",
   "description": "MCP server exposing fundamental-styles CSS component metadata for AI coding assistants",
   "license": "Apache-2.0",
   "repository": {

package/src/data/load-catalog.d.ts

@@ -1,5 +1,6 @@
 import { AccessibilityFile, ComponentMetadata, ComponentUseCasesFile, DesignToken, HtmlExamplesFile, ModifierRules, RelationshipsFile, UtilityClassesFile } from '../types/component-metadata';
 import { SemanticTagsFile } from '../types/semantic-tags';
+import { type MarkdownDocCache } from './load-markdown-docs';
 export interface ComponentGuidance {
     id: string;
     name: string;
@@ -29,6 +30,7 @@ export interface LoadedCatalog {
     componentUseCases: ComponentUseCasesFile | null;
     componentGuidance: ComponentGuidanceFile | null;
     semanticTags: SemanticTagsFile | null;
+    markdownDocs: MarkdownDocCache;
 }
 export declare function loadCatalog(): LoadedCatalog;
 /** Read a text/markdown file from the data directory. Returns null if not found. */

package/src/data/load-catalog.js

@@ -7,6 +7,7 @@ exports.listSchemas = listSchemas;
 exports.readSchema = readSchema;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const load_markdown_docs_1 = require("./load-markdown-docs");
 function readJson(filePath) {
     try {
         return JSON.parse((0, fs_1.readFileSync)(filePath, 'utf-8'));
@@ -84,6 +85,8 @@ function loadCatalog() {
     const componentGuidance = readJson(resolveDataPath('component-guidance.json'));
     // Semantic tags
     const semanticTags = readJson(resolveDataPath('component-semantic-tags.json'));
+    // Markdown documentation - use lazy-loading cache instead of loading all docs
+    const markdownDocs = (0, load_markdown_docs_1.getMarkdownCache)(50); // Max 50 docs in memory (~5MB instead of ~50MB)
     return {
         version: (_a = catalog === null || catalog === void 0 ? void 0 : catalog.version) !== null && _a !== void 0 ? _a : 'unknown',
         components,
@@ -95,7 +98,8 @@ function loadCatalog() {
         htmlExamples,
         componentUseCases,
         componentGuidance,
-        semanticTags
+        semanticTags,
+        markdownDocs
     };
 }
 /** Read a text/markdown file from the data directory. Returns null if not found. */

package/src/data/load-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-catalog.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/data/load-catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"load-catalog.js","sourceRoot":"","sources":["../../../../../packages/mcp/src/data/load-catalog.ts"],"names":[],"mappings":"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"}

package/src/data/load-markdown-docs.d.ts

@@ -0,0 +1,44 @@
+import { MarkdownDocCache } from './markdown-cache';
+export { MarkdownDocCache } from './markdown-cache';
+export interface ComponentMarkdownDoc {
+    /** Component ID (filename without .md) */
+    id: string;
+    /** Raw markdown content */
+    content: string;
+    /** Parsed frontmatter */
+    frontmatter: {
+        component: string;
+        title: string;
+        selector: string;
+        cssFile: string;
+        category?: string;
+        subcategory?: string;
+        package?: string;
+        description?: string;
+        tags?: string[];
+        relatedComponents?: string[];
+    };
+    /** HTML examples extracted from markdown */
+    examples: Array<{
+        /** Example title from heading or first line */
+        title: string;
+        /** HTML content */
+        html: string;
+        /** Description if available */
+        description?: string;
+    }>;
+}
+/**
+ * Get or create the markdown cache instance
+ * @param maxSize Maximum number of docs to keep in cache (default: 50)
+ */
+export declare function getMarkdownCache(maxSize?: number): MarkdownDocCache;
+/**
+ * Load all component markdown documentation files
+ * @deprecated Use getMarkdownCache() for lazy loading instead
+ * This function loads all docs eagerly and can use ~50MB of memory.
+ * The new cache-based approach uses ~5MB.
+ */
+export declare function loadMarkdownDocs(): Map<string, ComponentMarkdownDoc>;
+/** Get markdown documentation for a specific component */
+export declare function getMarkdownDoc(componentId: string): ComponentMarkdownDoc | null;