@smwb/ui-mcp-react 2.1.3 → 2.2.0

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

@@ -1,6 +1,10 @@
 {
   "name": "BottomBar",
   "description": "Bottom Bar component from the navigation module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLElement>"
   ],

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

@@ -1,6 +1,10 @@
 {
   "name": "Breadcrumbs",
   "description": "Hierarchical navigation trail.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLElement>"
   ],

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

@@ -1,6 +1,11 @@
 {
   "name": "Menu",
   "description": "Dropdown menu anchored to a trigger element.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "The trigger renders on the server; the menu surface mounts on the client."
+  },
   "extends": [
     "MenuFloatingProps &\n  React.HTMLAttributes<HTMLElement> & {\n    variant?: \"static\" | \"floating\";\n    dense?: boolean;\n  }"
   ],

package/component-meta/navigation/menu/menuDivider.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuDivider",
   "description": "Non-interactive separator between menu items.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLLIElement>"
   ],

package/component-meta/navigation/menu/menuFloating.json

@@ -1,6 +1,11 @@
 {
   "name": "MenuFloating",
   "description": "Floating positioned surface used by menus and popovers.",
+  "ssr": {
+    "safe": true,
+    "rendering": "client",
+    "note": "Floating surface portaled on the client; nothing is emitted during SSR."
+  },
   "extends": [
     "React.HTMLAttributes<HTMLDivElement>"
   ],

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

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

package/component-meta/navigation/menu/menuItemIcon.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuItemIcon",
   "description": "Leading icon slot for a menu item.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLSpanElement>"
   ],

package/component-meta/navigation/menu/menuItemText.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuItemText",
   "description": "Primary text slot for a menu item.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLSpanElement>"
   ],

package/component-meta/navigation/menu/menuList.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuList",
   "description": "List container inside a menu.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLDivElement>"
   ],

package/component-meta/navigation/menu/menuSubmenu.json

@@ -1,6 +1,10 @@
 {
   "name": "MenuSubmenu",
   "description": "Nested submenu with hover or click activation.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Pick<MenuFloatingProps, \"placement\" | \"onClose\"> &\n  React.HTMLAttributes<HTMLDivElement> & {\n    toggleElement?: React.ReactElement;\n    /** Items and/or nested `MenuSubmenu` elements (multi-level supported). */\n    children: React.ReactNode;\n    /** Open the submenu on pointer hover in addition to click. */\n    openOnHover?: boolean;\n  }"
   ],

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.2.0",
   "description": "Model Context Protocol server exposing the @smwb/ui-react (React) component catalog and customization guide.",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@smwb/ui-react": "^2.1.3",
+    "@smwb/ui-react": "^2.2.0",
     "@smwb/ui-styles": "^1.0.3",
     "glob": "^13.0.6",
     "typescript": "^6.0.3",

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()