@gostudent/shared-ui-library-mcp 2.2.0 → 3.1.0

package/library-manifest.json

@@ -1,5 +1,5 @@
 {
-  "libraryVersion": "2.2.0",
+  "libraryVersion": "3.1.0",
   "components": [
     {
       "name": "Avatar",
@@ -924,6 +924,14 @@
           "name": "children",
           "description": "Text content displayed next to the icon.",
           "options": []
+        },
+        {
+          "name": "size",
+          "description": "Text size. Accepts a single size or a `[mobile, desktop]` tuple for responsive behaviour, e.g. `size={[\"md\", \"sm\"]}`. Defaults to `[\"md\", \"sm\"]` (md on mobile, sm on desktop). The controls panel only supports a single value — see the **Responsive** story for the tuple API.",
+          "options": [
+            "sm",
+            "md"
+          ]
         }
       ],
       "examples": [
@@ -931,6 +939,11 @@
           "name": "Default",
           "jsx": "<MetadataItem icon={<EventNoteIcon />} children=\"Mon, 14 Apr 2025\" />",
           "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-data-display-metadataitem--default"
+        },
+        {
+          "name": "Responsive",
+          "jsx": "<MetadataItem mobileSize=\"md\" desktopSize=\"sm\" children=\"Mon, 14 Apr 2025\" />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-data-display-metadataitem--responsive"
         }
       ]
     },
@@ -1010,7 +1023,7 @@
     },
     {
       "name": "InlineNotification",
-      "description": "Embedded within the page layout, directly associated with a specific area of content.\nStays visible until the user dismisses it or the condition resolves.\n\nSupports five intent types: `info-neutral`, `info-branded`, `success`, `warning`, `error`.\n\nThe layout is responsive: stacked (mobile) → horizontal single-row (desktop ≥ 1024px).\nUse `stacked` to force the column layout regardless of viewport — useful inside narrow sidebar columns.\n\n### Usage\n\n```tsx\nimport { InlineNotification } from '@gostudent/shared-ui-library';\n\n<InlineNotification\n  type=\"success\"\n  title=\"Changes saved\"\n  message=\"Your profile has been updated successfully.\"\n  onDismiss={() => {}}\n/>\n```",
+      "description": "Embedded within the page layout, directly associated with a specific area of content.\nStays visible until the user dismisses it or the condition resolves.\n\nSupports five intent types: `info-neutral`, `info-branded`, `success`, `warning`, `error`.\nSupports two sizes: `default` (16px padding) and `small` (8px padding).\n\nThe layout is responsive: stacked (mobile) → horizontal single-row (desktop ≥ 1024px).\nUse `stacked` to force the column layout regardless of viewport — useful inside narrow sidebar columns.\n\n### Usage\n\n```tsx\nimport { InlineNotification } from '@gostudent/shared-ui-library';\n\n<InlineNotification\n  type=\"success\"\n  title=\"Changes saved\"\n  message=\"Your profile has been updated successfully.\"\n  onDismiss={() => {}}\n/>\n```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/components-notification-inlinenotification",
       "props": [
         {
@@ -1023,12 +1036,20 @@
             "warning",
             "error"
           ]
+        },
+        {
+          "name": "size",
+          "description": "",
+          "options": [
+            "default",
+            "small"
+          ]
         }
       ],
       "examples": [
         {
           "name": "Default",
-          "jsx": "<InlineNotification type=\"info-neutral\" title=\"Notification title\" message=\"This is an informational message.\" />",
+          "jsx": "<InlineNotification type=\"info-neutral\" size=\"default\" title=\"Notification title\" message=\"This is an informational message.\" />",
           "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-notification-inlinenotification--default"
         },
         {
@@ -1045,7 +1066,7 @@
     },
     {
       "name": "ToastNotification",
-      "description": "Transient overlay notifications that appear over the page content and auto-dismiss after a set duration (default 5s).\n\nWrap your app (or story) in `<ToastProvider>` and trigger toasts via the `useToast` hook.\n\n### Interaction rules\n- Hovering a toast pauses the auto-dismiss timer\n- Clicking ✕ dismisses immediately\n- New toasts push existing ones down (max 3 visible at once)\n- On mobile: full-width bottom-sheet style\n\n### Usage\n\n```tsx\nimport { ToastProvider, useToast } from '@gostudent/shared-ui-library';\n\nfunction App() {\n  return (\n    <ToastProvider>\n      <MyPage />\n    </ToastProvider>\n  );\n}\n\nfunction MyPage() {\n  const { addToast } = useToast();\n  return (\n    <button onClick={() => addToast({ type: 'success', title: 'Saved', message: 'Your changes have been saved.' })}>\n      Save\n    </button>\n  );\n}\n```",
+      "description": "Transient overlay notifications that appear over the page content and auto-dismiss after a set duration (default 5s).\nSupports two sizes: `default` (16px padding) and `small` (8px padding).\n\nWrap your app (or story) in `<ToastProvider>` and trigger toasts via the `useToast` hook.\n\n### Interaction rules\n- Hovering a toast pauses the auto-dismiss timer\n- Clicking ✕ dismisses immediately\n- New toasts push existing ones down (max 3 visible at once)\n- On mobile: full-width bottom-sheet style\n\n### Usage\n\n```tsx\nimport { ToastProvider, useToast } from '@gostudent/shared-ui-library';\n\nfunction App() {\n  return (\n    <ToastProvider>\n      <MyPage />\n    </ToastProvider>\n  );\n}\n\nfunction MyPage() {\n  const { addToast } = useToast();\n  return (\n    <button onClick={() => addToast({ type: 'success', title: 'Saved', message: 'Your changes have been saved.' })}>\n      Save\n    </button>\n  );\n}\n```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/components-notification-toastnotification",
       "props": [
         {
@@ -1060,6 +1081,11 @@
           "jsx": "// See \"Interactive\" story — uses interactive render wrapper",
           "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-notification-toastnotification--interactive"
         },
+        {
+          "name": "AllSizes",
+          "jsx": "// See \"AllSizes\" story — uses interactive render wrapper",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-notification-toastnotification--all-sizes"
+        },
         {
           "name": "InteractionRules",
           "jsx": "// See \"InteractionRules\" story — uses interactive render wrapper",
@@ -1069,7 +1095,7 @@
     },
     {
       "name": "TopBanner",
-      "description": "Full-width persistent notification placed above or below the main navigation bar.\nUsed for high-priority, global announcements (maintenance windows, subscription warnings, system-wide alerts).\n\n- Inline single-line layout, 56px height\n- 5 intent types: `info-neutral`, `info-branded`, `success`, `warning`, `error`\n- `info-branded` uses the Stars icon and branded colours\n- Max 1 banner at a time (usage rule — not enforced by the component)\n- Does not auto-dismiss\n\n### Usage\n\n```tsx\nimport { TopBanner } from '@gostudent/shared-ui-library';\n\n<TopBanner\n  type=\"warning\"\n  title=\"Scheduled maintenance\"\n  message=\"Maintenance on Apr 26, 02:00–04:00 UTC.\"\n  actionLink\n  linkText=\"Learn more\"\n  onDismiss={() => {}}\n/>\n```",
+      "description": "Full-width persistent notification placed above or below the main navigation bar.\nUsed for high-priority, global announcements (maintenance windows, subscription warnings, system-wide alerts).\n\n- Inline single-line layout, 56px height\n- 5 intent types: `info-neutral`, `info-branded`, `success`, `warning`, `error`\n- 2 sizes: `default` (16px/24px text) and `small` (14px/20px text)\n- ⚠️ Breaking visual change: prior to the `size` prop, text always rendered at 14px/20px\n  (now `small`). Consumers not passing `size` will see larger default text after upgrading.\n- `info-branded` uses the Stars icon and branded colours\n- Max 1 banner at a time (usage rule — not enforced by the component)\n- Does not auto-dismiss\n\n### Usage\n\n```tsx\nimport { TopBanner } from '@gostudent/shared-ui-library';\n\n<TopBanner\n  type=\"warning\"\n  title=\"Scheduled maintenance\"\n  message=\"Maintenance on Apr 26, 02:00–04:00 UTC.\"\n  actionLink\n  linkText=\"Learn more\"\n  onDismiss={() => {}}\n/>\n```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/components-notification-topbanner",
       "props": [
         {
@@ -1082,12 +1108,20 @@
             "warning",
             "error"
           ]
+        },
+        {
+          "name": "size",
+          "description": "",
+          "options": [
+            "default",
+            "small"
+          ]
         }
       ],
       "examples": [
         {
           "name": "Default",
-          "jsx": "<TopBanner type=\"info-neutral\" title=\"Information title\" message=\"This is an informational message.\" actionLink={true} linkText=\"Action link\" />",
+          "jsx": "<TopBanner type=\"info-neutral\" size=\"default\" title=\"Information title\" message=\"This is an informational message.\" actionLink={true} linkText=\"Action link\" />",
           "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/components-notification-topbanner--default"
         },
         {
@@ -1345,7 +1379,7 @@
         },
         {
           "name": "size",
-          "description": "`xs` is only meaningful with `shape=\"pill\"` (8/16 SemiBold — a compact pill for dense contexts). Accepts a single size or a `[mobile, desktop]` tuple for responsive behaviour, e.g. `size={[\"md\", \"sm\"]}`. See the **Responsive** story.",
+          "description": "`xs` is only meaningful with `shape=\"pill\"` (8/16 SemiBold — a compact pill for dense contexts). `shape=\"pill\"` defaults to `sm` (not `md`) when `size` is omitted — pill only intends to support `sm`/`xs`. Accepts a single size or a `[mobile, desktop]` tuple for responsive behaviour, e.g. `size={[\"md\", \"sm\"]}`. See the **Responsive** story.",
           "options": [
             "xs",
             "sm",
@@ -1723,7 +1757,7 @@
     },
     {
       "name": "HistoryLessonCard",
-      "description": "A single row in a student's lesson history list. Behaviour is driven by `attendanceStatus` and\n`isDocumented`:\n\n| `attendanceStatus`                | `isDocumented` | Renders |\n|-------------------------------------|------------------|---------|\n| `present`                         | `false`        | \"Document lesson\" button |\n| `present`                         | `true`         | Expandable tag row (chevron) revealing behaviour + learning content |\n| `absent` / `absent-with-reason`  | —                | Header, metadata and tags only — no button or chevron |\n| omitted                             | `false`/`true` | No attendance badge; otherwise behaves as `present` |\n\n`attendanceStatus` and `location` are both optional. Omit `attendanceStatus` when attendance\nwas never marked — the badge is hidden rather than claiming a state the data does not support.\nOmit `location` when the lesson had no place, e.g. an online lesson.\n\n### Usage\n\n```tsx\nimport { HistoryLessonCard } from '@gostudent/shared-ui-library';\n\n<HistoryLessonCard\n  subject=\"Math\"\n  date=\"10 Jul 2026\"\n  time=\"14:00 - 15:00\"\n  modality=\"offline\"\n  location=\"Centrostudi Navigli\"\n  attendanceStatus=\"present\"\n  isDocumented={false}\n  onDocumentLesson={() => {}}\n/>\n```",
+      "description": "A single row in a student's lesson history list. Behaviour is driven by `attendanceStatus` and\n`isDocumented`:\n\n| `attendanceStatus`                | `isDocumented` | Renders |\n|-------------------------------------|------------------|---------|\n| `present`                         | `false`        | \"Pending feedback\" pill + \"Document lesson\" button |\n| `present`                         | `true`         | Expandable tag row (chevron) revealing behaviour + learning content |\n| `absent` / `absent-with-reason`  | —                | Header, metadata and tags only — no button, pill or chevron |\n| omitted                             | `false`/`true` | No attendance badge; otherwise behaves as `present` |\n\n`attendanceStatus` and `location` are both optional. Omit `attendanceStatus` when attendance\nwas never marked — the badge is hidden rather than claiming a state the data does not support.\nOmit `location` when the lesson had no place, e.g. an online lesson.\n\n### Usage\n\n```tsx\nimport { HistoryLessonCard } from '@gostudent/shared-ui-library';\n\n<HistoryLessonCard\n  subject=\"Math\"\n  date=\"10 Jul 2026\"\n  time=\"14:00 - 15:00\"\n  modality=\"offline\"\n  location=\"Centrostudi Navigli\"\n  attendanceStatus=\"present\"\n  isDocumented={false}\n  onDocumentLesson={() => {}}\n/>\n```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/compositions-historylessoncard",
       "props": [
         {
@@ -2348,6 +2382,7 @@
   ],
   "icons": {
     "names": [
+      "AgainIcon",
       "ArrowLeftIcon",
       "ArrowRightIcon",
       "BookIcon",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gostudent/shared-ui-library-mcp",
-  "version": "2.2.0",
+  "version": "3.1.0",
   "description": "MCP server for @gostudent/shared-ui-library — exposes components, icons, and tokens to Claude",
   "type": "module",
   "bin": {