@gostudent/shared-ui-library-mcp 1.27.0 → 1.29.0

package/library-manifest.json

@@ -1,5 +1,5 @@
 {
-  "libraryVersion": "1.27.0",
+  "libraryVersion": "1.29.0",
   "components": [
     {
       "name": "Avatar",
@@ -173,6 +173,16 @@
           "description": "Called with a noon-normalised `Date` when the user selects a day or clicks Today.",
           "options": []
         },
+        {
+          "name": "onMonthChange",
+          "description": "Called when the displayed month changes (via prev/next buttons or Today button).",
+          "options": []
+        },
+        {
+          "name": "onTodayClick",
+          "description": "Called when the Today button is clicked, before onChange fires.",
+          "options": []
+        },
         {
           "name": "markedDates",
           "description": "Dates that show a dot indicator (e.g. days with booked lessons).",
@@ -1583,6 +1593,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```",
@@ -1628,6 +1720,11 @@
           "description": "",
           "options": []
         },
+        {
+          "name": "onProfileDropdownOpen",
+          "description": "",
+          "options": []
+        },
         {
           "name": "navItems",
           "description": "",
@@ -1687,6 +1784,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```",
@@ -1839,7 +1987,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)",
@@ -2224,6 +2373,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)",
@@ -2507,6 +2657,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.27.0",
+  "version": "1.29.0",
   "description": "MCP server for @gostudent/shared-ui-library — exposes components, icons, and tokens to Claude",
   "type": "module",
   "bin": {