@smwb/ui-mcp-solid 0.2.2 → 0.3.0

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": [
     "JSX.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": [
     "JSX.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": [
     "JSX.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": [
     "JSX.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": [
     "JSX.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"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

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<JSX.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": [
     "JSX.HTMLAttributes<HTMLElement>"
   ],

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

@@ -1,6 +1,10 @@
 {
   "name": "SidebarMenuItem",
   "description": "Sidebar Menu Item component from the navigation module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<JSX.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": [
     "JSX.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": [
     "JSX.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-solid",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Model Context Protocol server exposing the @smwb/ui-solid (SolidJS) component catalog and customization guide.",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@smwb/ui-solid": "^0.2.2",
+    "@smwb/ui-solid": "^0.3.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-solid 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-solid 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-solid components",
     description:
-      "Search the @smwb/ui-solid component catalog by exact, partial, fuzzy, or multi-word queries across names, ids, descriptions, and prop names.",
+      "Search the @smwb/ui-solid 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-solid component props",
     description:
-      "Return the full metadata document for a @smwb/ui-solid 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-solid 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()