@smwb/ui-mcp-react 2.1.3 → 2.3.0

package/component-meta/dataDisplay/lazyImage/lazyImage.json

@@ -0,0 +1,56 @@
+{
+  "name": "LazyImage",
+  "description": "Image with a built-in onError fallback and optional in-viewport lazy loading.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "Renders the image markup on the server; the IntersectionObserver lazy-load runs on the client."
+  },
+  "extends": [
+    "Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"onError\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/lazyImage/lazyImage.entry.less"
+    ],
+    "dependencies": [],
+    "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/lazyImage/lazyImage.entry.less\";"
+  },
+  "props": {
+    "src": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Image URL. When absent (or after a load error) the `fallback` is shown."
+    },
+    "alt": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Alternative text for images or icons."
+    },
+    "fallback": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Rendered in place of the image when it is missing or fails to load."
+    },
+    "lazy": {
+      "type": "boolean",
+      "required": false,
+      "description": "Defer loading until the image scrolls into view (IntersectionObserver). Default true."
+    },
+    "aspectRatio": {
+      "type": "string | number",
+      "required": false,
+      "description": "CSS `aspect-ratio` for the wrapper (e.g. `1`, `\"4 / 3\"`) to reserve space before load."
+    },
+    "onError": {
+      "type": "(event: React.SyntheticEvent<HTMLImageElement>) => void",
+      "required": false,
+      "description": "Fires on a load error (after the fallback is swapped in)."
+    }
+  }
+}

package/component-meta/dataDisplay/list/list.json

@@ -1,6 +1,10 @@
 {
   "name": "List",
   "description": "Vertical list container with optional subheader.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLUListElement>"
   ],

package/component-meta/dataDisplay/list/listItem.json

@@ -1,6 +1,10 @@
 {
   "name": "ListItem",
   "description": "Single row inside a List.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/dataDisplay/table/table.json

@@ -1,6 +1,10 @@
 {
   "name": "Table",
   "description": "Table wrapper with optional pagination settings.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLDivElement>"
   ],

package/component-meta/dataDisplay/table/tableBody.json

@@ -1,6 +1,10 @@
 {
   "name": "TableBody",
   "description": "Table body section wrapper.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLTableSectionElement>"
   ],

package/component-meta/dataDisplay/table/tableCell.json

@@ -1,6 +1,10 @@
 {
   "name": "TableCell",
   "description": "Standard table data cell.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "TdHTMLAttributes<HTMLTableCellElement>"
   ],

package/component-meta/dataDisplay/table/tableHead.json

@@ -1,6 +1,10 @@
 {
   "name": "TableHead",
   "description": "Table head section wrapper.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLTableSectionElement>"
   ],

package/component-meta/dataDisplay/table/tableHeadCell.json

@@ -1,6 +1,10 @@
 {
   "name": "TableHeadCell",
   "description": "Table header cell with optional sorting affordance.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "ThHTMLAttributes<HTMLTableCellElement>"
   ],

package/component-meta/dataDisplay/table/tablePagination/tablePagination.baseTablePagination.json

@@ -1,6 +1,10 @@
 {
   "name": "BaseTablePagination",
   "description": "Base Table Pagination component from the dataDisplay module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/dataDisplay/table/tablePagination/tablePagination.json

@@ -1,6 +1,10 @@
 {
   "name": "TablePagination",
   "description": "Pagination controls for tabular data.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "WithTotalCount | WithHasNextPage"
   ],

package/component-meta/dataDisplay/table/tableRow.json

@@ -1,6 +1,10 @@
 {
   "name": "TableRow",
   "description": "Table row wrapper.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLTableRowElement>"
   ],

package/component-meta/dataDisplay/thumbCard/thumbCard.json

@@ -0,0 +1,83 @@
+{
+  "name": "ThumbCard",
+  "description": "Selectable gallery card with image fallback, corner action slots, and a hover preview.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "Renders the card + image on the server; the hover preview is portaled on the client."
+  },
+  "extends": [
+    "Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/thumbCard/thumbCard.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/lazyImage/lazyImage.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/thumbCard/thumbCard.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/lazyImage/lazyImage.entry.less\";"
+  },
+  "props": {
+    "src": {
+      "type": "string",
+      "required": false,
+      "description": "Thumbnail URL; falls back to `fallback` when missing / failed."
+    },
+    "caption": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Caption. Optional. Type: React.ReactNode."
+    },
+    "selected": {
+      "type": "boolean",
+      "required": false,
+      "description": "Controlled selected tab index or value."
+    },
+    "onSelect": {
+      "type": "() => void",
+      "required": false,
+      "description": "Makes the card a selectable button (keyboard + `aria-pressed`)."
+    },
+    "fallback": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Shown in place of the image when `src` is missing / fails."
+    },
+    "hoverPreview": {
+      "type": "React.ReactNode | string",
+      "required": false,
+      "description": "A larger preview shown in a floating popup after a hover delay."
+    },
+    "topStart": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Top-left overlay slot (e.g. a favourite star)."
+    },
+    "topEnd": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Top-right overlay slot (e.g. a kebab menu)."
+    },
+    "lazy": {
+      "type": "boolean",
+      "required": false,
+      "description": "Lazy. Optional. Type: boolean."
+    },
+    "disabled": {
+      "type": "boolean",
+      "required": false,
+      "description": "Whether the control is disabled and non-interactive."
+    },
+    "hoverDelay": {
+      "type": "number",
+      "required": false,
+      "description": "Delay (ms) before the hover preview appears. Default 350."
+    }
+  }
+}

package/component-meta/dataDisplay/treeView/treeView.json

@@ -1,6 +1,10 @@
 {
   "name": "TreeView",
   "description": "Hierarchical tree with expand, collapse, and selection.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\">"
   ],

package/component-meta/dataDisplay/typography/typography.json

@@ -1,6 +1,10 @@
 {
   "name": "Typography",
   "description": "Text renderer mapped to semantic HTML tags and design tokens.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLElement>"
   ],

package/component-meta/feedBack/message/message.json

@@ -1,6 +1,10 @@
 {
   "name": "Message",
   "description": "Inline feedback message with severity styling and optional dismiss action.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLDivElement>"
   ],

package/component-meta/feedBack/modal/modal.content.json

@@ -1,6 +1,10 @@
 {
   "name": "Content",
   "description": "Modal scrollable content area.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/modal/modal.footer.json

@@ -1,6 +1,10 @@
 {
   "name": "Footer",
   "description": "Modal footer slot for actions.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/modal/modal.header.json

@@ -1,6 +1,10 @@
 {
   "name": "Header",
   "description": "Modal header slot with title and close affordance.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/modal/modal.json

@@ -1,6 +1,11 @@
 {
   "name": "Modal",
   "description": "Dialog overlay with focus trap and composable header, content, and footer.",
+  "ssr": {
+    "safe": true,
+    "rendering": "client",
+    "note": "Renders nothing on the server; the dialog is portaled into <body> on the client after hydration."
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/progressIndicator/progressIndicator.circularProgress.json

@@ -1,6 +1,10 @@
 {
   "name": "CircularProgress",
   "description": "Circular indeterminate or determinate progress indicator.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/progressIndicator/progressIndicator.json

@@ -1,6 +1,10 @@
 {
   "name": "ProgressIndicator",
   "description": "Linear or circular progress indicator.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/feedBack/saveAssetDialog/saveAssetDialog.json

@@ -0,0 +1,101 @@
+{
+  "name": "SaveAssetDialog",
+  "description": "Name-it / preview / confirm-cancel save dialog on Modal, with busy state.",
+  "ssr": {
+    "safe": true,
+    "rendering": "client",
+    "note": "Renders nothing on the server; the dialog is portaled into <body> on the client after hydration."
+  },
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/saveAssetDialog/saveAssetDialog.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/button/button.entry.less",
+      "@smwb/ui-styles/less/components/modal/modal.entry.less",
+      "@smwb/ui-styles/less/components/textField/textField.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/saveAssetDialog/saveAssetDialog.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/modal/modal.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";"
+  },
+  "props": {
+    "open": {
+      "type": "boolean",
+      "required": true,
+      "description": "Controlled open/visible state."
+    },
+    "title": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible title or tooltip text."
+    },
+    "nameLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Label for the name field. Omit `onNameChange` AND `name` to hide the field."
+    },
+    "name": {
+      "type": "string",
+      "required": false,
+      "description": "Form field name submitted with the value."
+    },
+    "onNameChange": {
+      "type": "(name: string) => void",
+      "required": false,
+      "description": "On Name Change. Optional. Type: (name: string) => void."
+    },
+    "previewSrc": {
+      "type": "string",
+      "required": false,
+      "description": "Preview image URL (e.g. a freshly captured thumbnail)."
+    },
+    "onCapture": {
+      "type": "() => void",
+      "required": false,
+      "description": "Shows a Capture button when provided."
+    },
+    "captureLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Capture Label. Optional. Type: string."
+    },
+    "busy": {
+      "type": "boolean",
+      "required": false,
+      "description": "Disables the actions + name field while a save/capture is in flight."
+    },
+    "confirmLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Confirm Label. Optional. Type: string."
+    },
+    "cancelLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Cancel Label. Optional. Type: string."
+    },
+    "onConfirm": {
+      "type": "() => void",
+      "required": true,
+      "description": "On Confirm. Required. Type: () => void."
+    },
+    "onClose": {
+      "type": "() => void",
+      "required": true,
+      "description": "Callback fired when the user dismisses the component."
+    },
+    "children": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Extra content between the name field/preview and the actions."
+    },
+    "className": {
+      "type": "string",
+      "required": false,
+      "description": "Additional CSS class name(s) for the root element."
+    }
+  }
+}

package/component-meta/feedBack/skeleton/skeleton.json

@@ -1,6 +1,10 @@
 {
   "name": "Skeleton",
   "description": "Loading placeholder with pulse or wave animation.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "HTMLAttributes<HTMLElement>"
   ],

package/component-meta/feedBack/snackbar/snackbar.json

@@ -1,6 +1,11 @@
 {
   "name": "Snackbar",
   "description": "Transient notification surface controlled by the snackbar provider.",
+  "ssr": {
+    "safe": true,
+    "rendering": "client",
+    "note": "Transient surface portaled on the client; nothing is emitted during SSR."
+  },
   "extends": [
     "React.HTMLAttributes<HTMLElement>"
   ],

package/component-meta/feedBack/snackbar/snackbar.snackbarsProvider.json

@@ -1,6 +1,10 @@
 {
   "name": "SnackbarsProvider",
   "description": "Snackbars Provider component from the feedBack module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLElement>"
   ],

package/component-meta/feedBack/tooltip/tooltip.json

@@ -1,6 +1,11 @@
 {
   "name": "Tooltip",
   "description": "Floating hint shown on hover, focus, or click.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "The trigger renders on the server; the floating tip mounts on the client."
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/inputs/button/button.json

@@ -1,6 +1,10 @@
 {
   "name": "Button",
   "description": "Action button with variants, optional icon, ripple feedback, and link support.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLButtonElement | HTMLAnchorElement>"
   ],

package/component-meta/inputs/buttonGroups/buttonGroup.json

@@ -1,6 +1,10 @@
 {
   "name": "ButtonGroup",
   "description": "Grouped buttons rendered as a single segmented control.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.HTMLAttributes<HTMLDivElement>"
   ],

package/component-meta/inputs/checkbox/checkbox.json

@@ -1,6 +1,10 @@
 {
   "name": "Checkbox",
   "description": "Binary selection control with label support.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<InputHTMLAttributes<HTMLInputElement>, \"onChange\" | \"size\">"
   ],

package/component-meta/inputs/datePicker/dataPickerDays.json

@@ -1,6 +1,10 @@
 {
   "name": "DataPickerDays",
   "description": "Calendar day grid for the date picker.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Partial<\n  Pick<\n    DatePickerProps,\n    | \"value\"\n    | \"showDaysOutsideMonth\"\n    | \"onChange\"\n    | \"disablePast\"\n    | \"disableFuture\"\n    | \"weekStartsOn\"\n    | \"minDate\"\n    | \"maxDate\"\n    | \"isDateDisabled\"\n    | \"locale\"\n  >\n>"
   ],

package/component-meta/inputs/datePicker/dataPickerHeader.json

@@ -1,6 +1,10 @@
 {
   "name": "DataPickerHeader",
   "description": "Month/year navigation header for the date picker calendar.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/inputs/datePicker/dataPickerInput.json

@@ -1,6 +1,10 @@
 {
   "name": "DataPickerInput",
   "description": "Internal date picker input field and toggle control.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<\n  DatePickerProps,\n  \"locale\" | \"showDaysOutsideMonth\" | \"disablePast\" | \"disableFuture\" | \"weekStartsOn\" | \"placement\"\n>"
   ],

package/component-meta/inputs/datePicker/datePicker.json

@@ -1,6 +1,11 @@
 {
   "name": "DatePicker",
   "description": "Date selection input with calendar popup.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "The input renders on the server; the calendar popup mounts on the client."
+  },
   "extends": [
     "Omit<TextFieldProps, \"onBlur\" | \"onChange\" | \"value\" | \"defaultValue\">"
   ],

package/component-meta/inputs/datePicker/datePickerIconButton.json

@@ -1,6 +1,10 @@
 {
   "name": "DataPickerIconButton",
   "description": "Data Picker Icon Button component from the inputs module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "React.ButtonHTMLAttributes<HTMLButtonElement> & {\n  size?: \"medium\" | \"small\";\n  edge?: \"start\" | \"end\";\n}"
   ],

package/component-meta/inputs/datePicker/datePickerList.json

@@ -1,6 +1,10 @@
 {
   "name": "DataPickerList",
   "description": "Data Picker List component from the inputs module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "styles": {
     "base": [
       "@smwb/ui-styles/less/foundation.less",

package/component-meta/inputs/dateTimePicker/dateTimePicker.json

@@ -1,6 +1,11 @@
 {
   "name": "DateTimePicker",
   "description": "Combined date and time selection input.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "The input renders on the server; the picker popup mounts on the client."
+  },
   "extends": [
     "Omit<TextFieldProps, \"onBlur\" | \"onChange\" | \"value\" | \"defaultValue\">"
   ],

package/component-meta/inputs/dateTimePicker/dateTimePickerInput.json

@@ -1,6 +1,10 @@
 {
   "name": "DateTimePickerInput",
   "description": "Internal date-time picker input field and toggle control.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
   "extends": [
     "Omit<\n  DateTimePickerProps,\n  | \"locale\"\n  | \"showDaysOutsideMonth\"\n  | \"disablePast\"\n  | \"disableFuture\"\n  | \"weekStartsOn\"\n  | \"placement\"\n  | \"minDate\"\n  | \"maxDate\"\n  | \"isDateDisabled\"\n>"
   ],