@gostudent/shared-ui-library-mcp 1.28.0 → 1.30.0-DT-17034.1

package/library-manifest.json

@@ -1,5 +1,5 @@
 {
-  "libraryVersion": "1.28.0",
+  "libraryVersion": "1.30.0",
   "components": [
     {
       "name": "Avatar",
@@ -228,6 +228,11 @@
           "description": "Label for the Today button. Defaults to \"Today\".",
           "options": []
         },
+        {
+          "name": "hasTodayButton",
+          "description": "Show the \"Today\" button. When false under `appearance=\"bottomSheet\"`, the header also reverts to an edge-arrow layout (arrow, month label, arrow). Defaults to true.",
+          "options": []
+        },
         {
           "name": "previousMonthLabel",
           "description": "Accessible label for the previous month nav button. Defaults to \"Previous month\".",
@@ -646,6 +651,11 @@
             "stretch"
           ]
         },
+        {
+          "name": "fluid",
+          "description": "Fill the containing block instead of capping at the layout content max-width and auto-centering on desktop. Use when the Grid is nested inside a flex/grid parent (or any narrower container), where the default centering would otherwise add side margins. Defaults to `false`.",
+          "options": []
+        },
         {
           "name": "as",
           "description": "Renders as this HTML element or React component. Defaults to `div`.",
@@ -1339,12 +1349,20 @@
   "compositions": [
     {
       "name": "CalendarSheet",
-      "description": "Mobile bottom-sheet calendar. Composes `Drawer position=\"bottom\"` with\n`<Calendar appearance=\"bottomSheet\">` — no calendar internals are re-implemented.\n\nSelecting a date closes the sheet by default (`closeOnSelect`). Dismiss via\nscrim-tap, Escape, or date selection. The grabber handle is visual-only (v1).\n\nPair with `CalendarTrigger` for the month-selector control that opens the sheet.\n\n### Usage\n\n```tsx\nimport { CalendarSheet, CalendarTrigger } from '@gostudent/shared-ui-library';\n\nconst [open, setOpen] = useState(false);\nconst [date, setDate] = useState<Date | null>(null);\n\n<CalendarTrigger\n  label={date ? format(date, 'd MMM yyyy') : 'Select date'}\n  onOpen={() => setOpen(true)}\n  onClear={() => setDate(null)}\n  hasSelection={!!date}\n/>\n\n<CalendarSheet\n  isOpen={open}\n  onClose={() => setOpen(false)}\n  value={date}\n  onChange={setDate}\n  markedDates={bookedDates}\n/>\n```",
+      "description": "Mobile bottom-sheet calendar. Composes `Drawer position=\"bottom\"` with\n`<Calendar appearance=\"bottomSheet\">` — no calendar internals are re-implemented.\n\nSelecting a date closes the sheet by default (`closeOnSelect`). Dismiss via\nscrim-tap, Escape, or date selection. The grabber handle is visual-only (v1).\n\nPair with `CalendarTrigger` for the month-selector control that opens the sheet.\n\nSet `variant=\"inline\"` to render the calendar directly in a layout instead of\nan overlay — useful for desktop two-pane flows where the calendar sits alongside\nother content. `isOpen`/`onClose` are ignored in this mode; see the `Inline` story.\n\n### Usage\n\n```tsx\nimport { CalendarSheet, CalendarTrigger } from '@gostudent/shared-ui-library';\n\nconst [open, setOpen] = useState(false);\nconst [date, setDate] = useState<Date | null>(null);\n\n<CalendarTrigger\n  label={date ? format(date, 'd MMM yyyy') : 'Select date'}\n  onOpen={() => setOpen(true)}\n  onClear={() => setDate(null)}\n  hasSelection={!!date}\n/>\n\n<CalendarSheet\n  isOpen={open}\n  onClose={() => setOpen(false)}\n  value={date}\n  onChange={setDate}\n  markedDates={bookedDates}\n/>\n```",
       "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/compositions-calendarsheet",
       "props": [
+        {
+          "name": "variant",
+          "description": "'overlay' (default): bottom-sheet via Drawer, requires isOpen/onClose. 'inline': renders the calendar directly in the layout, no Drawer/portal — isOpen/onClose are ignored.",
+          "options": [
+            "overlay",
+            "inline"
+          ]
+        },
         {
           "name": "isOpen",
-          "description": "Controls whether the sheet is visible.",
+          "description": "Controls whether the sheet is visible. Ignored when variant is \"inline\".",
           "options": []
         },
         {
@@ -1402,6 +1420,11 @@
           "description": "0 = week starts Sunday, 1 = week starts Monday (default).",
           "options": []
         },
+        {
+          "name": "hasTodayButton",
+          "description": "Show the \"Today\" button. When false, the header reverts to the pre-Today-button edge-arrow layout (arrow, month label, arrow). Default: true.",
+          "options": []
+        },
         {
           "name": "sheetHeight",
           "description": "Override the sheet panel height. Default: 488px (Figma spec).",
@@ -1593,6 +1616,88 @@
         }
       ]
     },
+    {
+      "name": "StudentLessonCard",
+      "description": "The student-portal counterpart to `TutorLessonCard`. It displays a lesson session from the\nstudent's perspective: the identity block shows the **tutor**, and group lessons additionally show\nan `AvatarGroup` of the fellow classmates.\n\nSupports states driven by the `lessonState`, `type`, `modality`, and `feedbackState` props:\n\n| `lessonState`  | `modality` | `feedbackState` | Actions |\n|------------------|-------------|-------------------|---------|\n| `upcoming`     | `online`  | —                 | \"Workspace\" link + \"Start lesson\" + \"Rate lesson\" (inactive) |\n| `upcoming`     | `offline` | —                 | \"Rate lesson\" (inactive) |\n| `in-progress`  | `online`  | —                 | \"Workspace\" link + \"Start lesson\" + \"Rate lesson\" (active) |\n| `in-progress`  | `offline` | —                 | \"Rate lesson\" (active) |\n| `completed`    | any         | `pending`       | \"Rate lesson\" button (primary, active) |\n| `completed`    | any         | `submitted`     | \"Check feedback\" button (secondary) |\n\n### Usage\n\n```tsx\nimport { StudentLessonCard } from '@gostudent/shared-ui-library';\n\n<StudentLessonCard\n  title=\"English lesson\"\n  modality=\"online\"\n  type=\"individual\"\n  subjects={['English']}\n  time=\"17:00 - 18:00\"\n  lessonState=\"upcoming\"\n  tutor={{ name: 'Jane Tutor' }}\n  isStartLessonDisabled\n/>\n```",
+      "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/compositions-studentlessoncard",
+      "props": [
+        {
+          "name": "title",
+          "description": "Lesson title shown as the card heading.",
+          "options": [
+            "online",
+            "offline"
+          ]
+        },
+        {
+          "name": "type",
+          "description": "Lesson type — group lessons show a classmate AvatarGroup beside the tutor.",
+          "options": [
+            "individual",
+            "group"
+          ]
+        },
+        {
+          "name": "subjects",
+          "description": "Array of subject labels rendered as Tag pills.",
+          "options": []
+        },
+        {
+          "name": "time",
+          "description": "Formatted time range, e.g. \"17:00 - 18:00\".",
+          "options": [
+            "upcoming",
+            "in-progress",
+            "completed"
+          ]
+        },
+        {
+          "name": "feedbackState",
+          "description": "Feedback phase for completed lessons.",
+          "options": [
+            "pending",
+            "submitted"
+          ]
+        },
+        {
+          "name": "isStartLessonDisabled",
+          "description": "Disables the \"Start lesson\" button.",
+          "options": []
+        },
+        {
+          "name": "hasKebab",
+          "description": "Show or hide the kebab menu. When enabled, passes menu items to the card.",
+          "options": []
+        },
+        {
+          "name": "tutor",
+          "description": "Tutor object ({ name, avatarSrc }) shown in the identity block.",
+          "options": []
+        },
+        {
+          "name": "onStartLesson",
+          "description": "Called when \"Start lesson\" is clicked.",
+          "options": []
+        }
+      ],
+      "examples": [
+        {
+          "name": "UpcomingIndividual",
+          "jsx": "<StudentLessonCard title=\"Individual lesson\" modality=\"online\" type=\"individual\" subjects={['English']} time=\"17:00 - 18:00\" lessonState=\"upcoming\" isStartLessonDisabled={true} tutor={TUTOR} hasKebab={true} />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-studentlessoncard--upcoming-individual"
+        },
+        {
+          "name": "UpcomingGroup",
+          "jsx": "<StudentLessonCard title=\"Group lesson\" modality=\"online\" type=\"group\" subjects={['English', 'Biology', 'Math']} time=\"17:00 - 18:00\" lessonState=\"upcoming\" isStartLessonDisabled={true} tutor={TUTOR} classmates={CLASSMATES} hasKebab={true} />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-studentlessoncard--upcoming-group"
+        },
+        {
+          "name": "UpcomingGroupOffline",
+          "jsx": "<StudentLessonCard title=\"Group lesson\" modality=\"offline\" type=\"group\" subjects={['English', 'Biology', 'Math']} time=\"17:00 - 18:00\" room=\"Room 1\" lessonCenter=\"Centrostudi Navigli\" lessonState=\"upcoming\" tutor={TUTOR} classmates={CLASSMATES} hasKebab={true} />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-studentlessoncard--upcoming-group-offline"
+        }
+      ]
+    },
     {
       "name": "TopNavigation",
       "description": "Responsive top navigation bar. On **mobile/tablet** (< 1024 px) it shows the logo and a hamburger button that opens a slide-in drawer.\nOn **desktop** (≥ 1024 px) it shows the logo, a tab list, and the user section (Avatar + name + role Tag + chevron) with a dropdown.\n\nThe drawer open/close state is managed internally — no external state needed.\n\n### Usage\n\n```tsx\nimport { TopNavigation } from '@gostudent/shared-ui-library';\n\n<TopNavigation\n  tabs={[\n    { label: 'Lessons', isSelected: true, onClick: () => {} },\n    { label: 'My availability', isSelected: false, onClick: () => {} },\n  ]}\n  userName=\"Anna James\"\n  userRole=\"tutor\"\n  navItems={[\n    { icon: DashboardIcon, label: 'Lessons', isSelected: true, onClick: () => {} },\n  ]}\n  languages={[{ value: 'en', label: 'English' }]}\n  onLanguageClick={() => {}}\n  onLogout={() => {}}\n/>\n```",
@@ -1702,6 +1807,57 @@
         }
       ]
     },
+    {
+      "name": "TutorDetails",
+      "description": "Renders a single tutor as an **Avatar** plus name in a horizontal row.\n\nBy default the name is shown in full. Set `truncate` to clip it with an ellipsis **on mobile**\nwhen it overflows — from the `tablet` breakpoint up the full name is always shown.\n\nTwo sizes are available — `md` (32px avatar, default) and `sm` (24px avatar).\n\nSetting `disabled` dims the row to 50% opacity and shows an \"Unavailable\" tooltip on hover/focus\n(override via `disabledLabel`).\n\nIntended for use inside `StudentLessonCard` as the tutor identity block — the student-portal\ncounterpart to `StudentDetails`.\n\n### Usage\n\n```tsx\nimport { TutorDetails } from '@gostudent/shared-ui-library';\n\n<TutorDetails name=\"John Doe\" avatarSrc=\"https://i.pravatar.cc/150?u=john\" />\n```",
+      "storybookUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/docs/compositions-tutordetails",
+      "props": [
+        {
+          "name": "name",
+          "description": "Avatar status badge.",
+          "options": [
+            "default",
+            "done",
+            "pending"
+          ]
+        },
+        {
+          "name": "size",
+          "description": "Avatar size: sm=24px, md=32px (default).",
+          "options": [
+            "sm",
+            "md"
+          ]
+        },
+        {
+          "name": "truncate",
+          "description": "Truncate the name with an ellipsis on mobile when it overflows. Off by default.",
+          "options": []
+        },
+        {
+          "name": "disabled",
+          "description": "Tooltip text shown on hover/focus when disabled. Defaults to \"Unavailable\".",
+          "options": []
+        }
+      ],
+      "examples": [
+        {
+          "name": "Default",
+          "jsx": "<TutorDetails name=\"John Doe\" />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-tutordetails--default"
+        },
+        {
+          "name": "WithAvatarImage",
+          "jsx": "<TutorDetails name=\"John Doe\" avatarSrc=\"https://i.pravatar.cc/150?u=john\" />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-tutordetails--with-avatar-image"
+        },
+        {
+          "name": "Small",
+          "jsx": "<TutorDetails name=\"John Doe\" size=\"sm\" />",
+          "storyUrl": "https://62835ff8873d45004a627ad4-snugmmtvrg.chromatic.com/?path=/story/compositions-tutordetails--small"
+        }
+      ]
+    },
     {
       "name": "TutorLessonCard",
       "description": "A domain-level card that displays a lesson session with all associated metadata.\n\nSupports states driven by the `lessonState`, `type`, `modality`, and `feedbackState` props:\n\n| `lessonState` | `type`        | `modality`  | `feedbackState` | Description |\n|----------------|-----------------|--------------|-----------------|-------------|\n| `upcoming`   | `individual`  | `online`   | —               | Metadata row (time) + actions in a wrapping flex row, \"Workspace\" link + \"Start GoClass\" button, `StudentDetails` always visible below |\n| `upcoming`   | `group`       | `online`   | —               | Metadata row (time, student count) + actions in a wrapping flex row, optional kebab menu, always-visible `StudentDetails` (desktop) / \"N students\" disclosure (mobile) below |\n| `upcoming`   | `individual`  | `offline`  | —               | Offline modality tag, metadata row includes room/lesson center, single \"Document lesson\" button |\n| `upcoming`   | `group`       | `offline`  | —               | Offline modality tag, metadata row includes room/lesson center, \"N students\" disclosure below |\n| `completed`  | `individual`  | `online`   | `pending`     | `StudentDetails` (24px, pending badge) inline, no dropdown, \"Document lesson\" button |\n| `completed`  | `group`       | `online`   | `pending`     | Disclosure toggle revealing `StudentDetails` (24px, done/pending badges), \"Document lesson\" button |\n| `completed`  | `group`       | `online`   | `submitted`   | \"Review feedback\" button, always-visible `StudentDetails` (desktop) / \"N students\" disclosure (mobile) |\n| `completed`  | `individual`  | `online`   | `submitted`   | \"Review feedback\" button, `StudentDetails` inline at both breakpoints |\n\nOnline lessons also show a \"Workspace\" link (secondary/link-styled) alongside \"Start GoClass\" /\n\"Document lesson\", for every lesson state.\n\n### Usage\n\n```tsx\nimport { TutorLessonCard } from '@gostudent/shared-ui-library';\n\n<TutorLessonCard\n  title=\"English lesson\"\n  modality=\"online\"\n  type=\"individual\"\n  subjects={['English']}\n  time=\"17:00 - 18:00\"\n  lessonState=\"upcoming\"\n  students={[{ name: 'Alice Smith', grade: '8', subject: 'English' }]}\n  isStartLessonDisabled\n/>\n```",
@@ -1755,6 +1911,11 @@
           "description": "Disables the \"Start lesson\" button in upcoming state.",
           "options": []
         },
+        {
+          "name": "isDocumentLessonDisabled",
+          "description": "Shows \"Document lesson\" disabled with a tooltip explaining why, instead of hiding it. Used before the 30-minute pre-lesson documentation window opens.",
+          "options": []
+        },
         {
           "name": "hasKebab",
           "description": "Show or hide the kebab menu. When enabled, passes menu items to the card.",
@@ -1774,6 +1935,31 @@
           "name": "onStartLesson",
           "description": "Called when \"Start GoClass\" is clicked.",
           "options": []
+        },
+        {
+          "name": "docs",
+          "description": "",
+          "options": []
+        },
+        {
+          "name": "docs",
+          "description": "",
+          "options": []
+        },
+        {
+          "name": "labels",
+          "description": "",
+          "options": []
+        },
+        {
+          "name": "labels",
+          "description": "",
+          "options": []
+        },
+        {
+          "name": "labels",
+          "description": "",
+          "options": []
         }
       ],
       "examples": [
@@ -1799,6 +1985,9 @@
     "names": [
       "ArrowLeftIcon",
       "ArrowRightIcon",
+      "BookIcon",
+      "BookStarIcon",
+      "CakeIcon",
       "CancelFilledIcon",
       "ChevronDownIcon",
       "ChevronLeftIcon",
@@ -1812,6 +2001,7 @@
       "ErrorFilledIcon",
       "EventNoteIcon",
       "GlobeIcon",
+      "GradeIcon",
       "GraduationCapIcon",
       "GroupIcon",
       "HistoryIcon",
@@ -1820,17 +2010,23 @@
       "InfoIcon",
       "KebabIcon",
       "LocationCenterIcon",
+      "LocationIcon",
       "LogoutIcon",
       "MenuIcon",
+      "MoreIcon",
       "OfflineIcon",
       "PendingFilledIcon",
+      "PhoneIcon",
       "PlanetIcon",
       "PlusIcon",
+      "SearchIcon",
       "StarsIcon",
+      "TagIcon",
       "TickFilledIcon",
       "TickIcon",
       "UploadIcon",
-      "WarningFilledIcon"
+      "WarningFilledIcon",
+      "WarningOutlinedIcon"
     ],
     "sizes": [
       "sm",
@@ -1854,7 +2050,8 @@
         "breakpointDesktopScreenWidth": "var(--breakpoint-desktop-screen-width)",
         "breakpointTabletScreenWidth": "var(--breakpoint-tablet-screen-width)",
         "breakpointMobileScreenWidth": "var(--breakpoint-mobile-screen-width)",
-        "breakpointLayoutContentMaxWidth": "var(--breakpoint-layout-content-max-width)"
+        "breakpointLayoutContentMaxWidth": "var(--breakpoint-layout-content-max-width)",
+        "breakpointTooltipContentMaxWidth": "var(--breakpoint-tooltip-content-max-width)"
       },
       "error": {
         "error50": "var(--error-50)",
@@ -2239,6 +2436,7 @@
         "colorBorderFeedbackDefault": "var(--color-border-feedback-default)",
         "colorBorderDark": "var(--color-border-dark)",
         "colorBorderPill": "var(--color-border-pill)",
+        "colorBorderSelected": "var(--color-border-selected)",
         "colorTextPrimary": "var(--color-text-primary)",
         "colorTextSecondary": "var(--color-text-secondary)",
         "colorTextInverse": "var(--color-text-inverse)",
@@ -2522,6 +2720,7 @@
         "colorBorderFeedbackDefault": "var(--color-border-feedback-default)",
         "colorBorderDark": "var(--color-border-dark)",
         "colorBorderPill": "var(--color-border-pill)",
+        "colorBorderSelected": "var(--color-border-selected)",
         "colorTextPrimary": "var(--color-text-primary)",
         "colorTextSecondary": "var(--color-text-secondary)",
         "colorTextInverse": "var(--color-text-inverse)",

package/package.json

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