@gostudent/shared-ui-library-mcp 2.2.0-DT-17070.1 → 3.0.0

package/library-manifest.json

@@ -1,5 +1,5 @@
 {
-  "libraryVersion": "2.1.0",
+  "libraryVersion": "3.0.0",
   "components": [
     {
       "name": "Avatar",
@@ -223,11 +223,6 @@
           "description": "Legend label for secondary marked dates. Defaults to \"has pending feedback\".",
           "options": []
         },
-        {
-          "name": "legendText",
-          "description": "Simple centered helper message shown in the footer, e.g. \"Please select a date\". Ignored when markedDates or secondaryMarkedDates are provided.",
-          "options": []
-        },
         {
           "name": "todayLabel",
           "description": "Label for the Today button. Defaults to \"Today\".",
@@ -235,7 +230,7 @@
         },
         {
           "name": "hasTodayButton",
-          "description": "Show the \"Today\" button. When false, the header drops it and splits the prev/next nav to the edges (arrow, month label, arrow), using the same chevron icons as the grouped nav. Defaults to true.",
+          "description": "Show the \"Today\" button. When false, the header drops it and splits the prev/next nav to the edges (arrow, month label, arrow) — large arrow icons under `appearance=\"bottomSheet\"`, the same chevrons under `appearance=\"default\"`. Defaults to true.",
           "options": []
         },
         {
@@ -1015,7 +1010,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": [
         {
@@ -1028,12 +1023,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"
         },
         {
@@ -1050,7 +1053,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": [
         {
@@ -1065,6 +1068,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",
@@ -1074,7 +1082,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": [
         {
@@ -1087,12 +1095,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"
         },
         {
@@ -1537,11 +1553,6 @@
           "description": "Legend label for secondary marked dates. Defaults to \"has pending feedback\".",
           "options": []
         },
-        {
-          "name": "legendText",
-          "description": "Simple centered helper message shown in the footer, e.g. \"Please select a date\". Ignored when markedDates or secondaryMarkedDates are provided.",
-          "options": []
-        },
         {
           "name": "disabledDates",
           "description": "Dates that are not selectable.",
@@ -1733,7 +1744,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\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`        | \"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```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/compositions-historylessoncard",
       "props": [
         {
@@ -1746,12 +1757,12 @@
         },
         {
           "name": "location",
-          "description": "Room (online) or center (offline) name shown in the metadata row.",
+          "description": "Room (online) or center (offline) name shown in the metadata row. Omit to hide the line entirely — e.g. an online lesson with no physical place.",
           "options": []
         },
         {
           "name": "attendanceStatus",
-          "description": "Student attendance for this lesson. Absent states hide the button/chevron entirely.",
+          "description": "Student attendance for this lesson. Absent states hide the button/chevron entirely. Omit when attendance was never marked — the badge is then hidden rather than asserting a state.",
           "options": [
             "present",
             "absent",

package/package.json

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