@smwb/ui-mcp-react 2.1.3 → 2.3.0

package/component-meta/navigation/overflowMenu/overflowMenu.json

@@ -0,0 +1,56 @@
+{
+  "name": "OverflowMenu",
+  "description": "One-shot kebab/overflow menu from an items array (trigger + floating Menu).",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "The trigger button renders on the server; the menu surface mounts on the client."
+  },
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/overflowMenu/overflowMenu.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/button/button.entry.less",
+      "@smwb/ui-styles/less/components/icon/icon.entry.less",
+      "@smwb/ui-styles/less/components/menu/menu.entry.less"
+    ],
+    "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/overflowMenu/overflowMenu.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/button/button.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/icon/icon.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/menu/menu.entry.less\";"
+  },
+  "props": {
+    "items": {
+      "type": "OverflowMenuItem[]",
+      "required": true,
+      "description": "Breadcrumb or navigation items."
+    },
+    "icon": {
+      "type": "string",
+      "required": false,
+      "description": "Trigger icon name (default `more_vert`)."
+    },
+    "placement": {
+      "type": "Placement",
+      "required": false,
+      "description": "Preferred floating placement relative to the anchor."
+    },
+    "aria-label": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible label when no visible title is present."
+    },
+    "disabled": {
+      "type": "boolean",
+      "required": false,
+      "description": "Whether the control is disabled and non-interactive."
+    },
+    "className": {
+      "type": "string",
+      "required": false,
+      "description": "Additional CSS class name(s) for the root element."
+    }
+  }
+}

package/component-meta/navigation/pagination/pagination.json

@@ -1,6 +1,10 @@
 {
   "name": "Pagination",
   "description": "Page navigation control with previous and next actions.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<HTMLAttributes<HTMLElement>, \"onChange\">"
   ],

package/component-meta/navigation/sidebar/sidebar.json

@@ -1,6 +1,10 @@
 {
   "name": "Sidebar",
   "description": "Vertical navigation sidebar with collapsible sections.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLElement>"
   ],

package/component-meta/navigation/sidebar/sidebar.menuItem.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuItem",
   "description": "Interactive item inside a menu list.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<React.HTMLAttributes<HTMLDivElement>, \"title\">"
   ],

package/component-meta/navigation/stepper/stepper.json

@@ -1,6 +1,10 @@
 {
   "name": "Stepper",
   "description": "Multi-step progress indicator with optional navigation.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLDivElement>"
   ],

package/component-meta/navigation/tabs/tab/tab.json

@@ -1,6 +1,10 @@
 {
   "name": "Tab",
   "description": "Single selectable tab trigger.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLButtonElement | HTMLAnchorElement>"
   ],

package/component-meta/navigation/tabs/tabs.json

@@ -1,6 +1,10 @@
 {
   "name": "Tabs",
   "description": "Tab list container controlling associated panels.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/componentMeta.mjs

@@ -306,6 +306,7 @@ export function parseComponentMetaFile(absolutePath, relativePath) {
     id,
     name: parsed.name,
     description: parsed.description ?? "",
+    ssr: parsed.ssr,
     extends: parsed.extends,
     inheritedAttributes: parsed.inheritedAttributes,
     styles: parsed.styles,
@@ -349,6 +350,7 @@ export function searchComponents(catalog, query, limit = 10) {
       id: entry.id,
       name: entry.name,
       description: entry.description,
+      ssr: entry.ssr,
       propCount: entry.propNames.length,
     }));
   }
@@ -373,6 +375,7 @@ export function searchComponents(catalog, query, limit = 10) {
       id: entry.id,
       name: entry.name,
       description: entry.description,
+      ssr: entry.ssr,
       propCount: entry.propNames.length,
       score,
       matchReasons: reasons,
@@ -413,6 +416,7 @@ export function getComponentProps(catalog, nameOrId) {
     id: entry.id,
     name: entry.name,
     description: entry.description,
+    ssr: entry.ssr,
     extends: entry.extends,
     inheritedAttributes: entry.inheritedAttributes,
     styles: entry.styles,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smwb/ui-mcp-react",
-  "version": "2.1.3",
+  "version": "2.3.0",
   "description": "Model Context Protocol server exposing the @smwb/ui-react (React) component catalog and customization guide.",
   "license": "MIT",
   "type": "module",
@@ -28,8 +28,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@smwb/ui-react": "^2.1.3",
-    "@smwb/ui-styles": "^1.0.3",
+    "@smwb/ui-react": "^2.3.0",
+    "@smwb/ui-styles": "^1.1.0",
     "glob": "^13.0.6",
     "typescript": "^6.0.3",
     "vitest": "^2.1.9"

package/server.mjs

@@ -20,7 +20,7 @@ const server = new McpServer(
   },
   {
     instructions:
-      "@smwb/ui-react component catalog and customization guide. Use search_components / get_component_props for API metadata, and search_customization / get_customization for theming and appearance options.",
+      "@smwb/ui-react component catalog and customization guide. Use search_components / get_component_props for API metadata, and search_customization / get_customization for theming and appearance options. Every component exposes an `ssr` field: `safe` (always true — nothing throws during renderToString), `rendering` (\"universal\" = emits static HTML on the server and hydrates; \"client\" = a pure overlay that renders nothing server-side and mounts via a portal after hydration), and an optional `note`.",
   }
 );
 
@@ -29,7 +29,7 @@ server.registerTool(
   {
     title: "Search @smwb/ui-react components",
     description:
-      "Search the @smwb/ui-react component catalog by exact, partial, fuzzy, or multi-word queries across names, ids, descriptions, and prop names.",
+      "Search the @smwb/ui-react component catalog by exact, partial, fuzzy, or multi-word queries across names, ids, descriptions, and prop names. Each result includes its `ssr` classification (`rendering`: \"universal\" or \"client\").",
     inputSchema: z.object({
       query: z.string().describe("Search query, for example: button, chat, text field"),
       limit: z.number().int().min(1).max(50).optional().describe("Maximum number of matches to return"),
@@ -54,7 +54,7 @@ server.registerTool(
   {
     title: "Get @smwb/ui-react component props",
     description:
-      "Return the full metadata document for a @smwb/ui-react component, including prop names, types, required flags, descriptions, and required Less imports (`styles.base`, `styles.entries`, `styles.dependencies`, `styles.importExample`).",
+      "Return the full metadata document for a @smwb/ui-react component, including prop names, types, required flags, descriptions, SSR classification (`ssr.safe`, `ssr.rendering`, `ssr.note`), and required Less imports (`styles.base`, `styles.entries`, `styles.dependencies`, `styles.importExample`).",
     inputSchema: z.object({
       nameOrId: z
         .string()