@aleph-alpha/lib-mcp 4.1.1 → 5.0.0

package/chat-kit-components-meta.json

@@ -94,6 +94,7 @@
     "props": [],
     "examples": [
       "Default",
+      "States",
       "Selected",
       "InlineInText",
       "MultiDigitIndex",
@@ -132,6 +133,7 @@
       "fileName",
       "snippet",
       "locationLabel",
+      "collectionName",
       "url",
       "openSourceLabel"
     ],
@@ -139,6 +141,8 @@
       "Default",
       "WithoutLink",
       "WithoutLocation",
+      "WithoutCollection",
+      "LongCollectionName",
       "MinimalSnippetOnly",
       "LongFileName",
       "LongSnippet",
@@ -146,6 +150,46 @@
     ],
     "_autoGenerated": true
   },
+  "CkCitationLabel": {
+    "description": "The bare citation marker — the numbered chip rendered in place of a `[n]` reference, with no popover attached. `CkCitation` composes it as its popover trigger (`as=\"button\"`); use it directly, in its default static `span` form, wherever cited text should keep the marker styling without being interactive (e.g. the response preview in `CkFeedbackDialog`).",
+    "category": "Data Display",
+    "useCases": [
+      "static citation marker",
+      "read-only cited answer",
+      "popover trigger for CkCitation"
+    ],
+    "keywords": [
+      "citation",
+      "source",
+      "reference",
+      "inline",
+      "marker",
+      "footnote",
+      "number",
+      "chip",
+      "label"
+    ],
+    "related": [
+      "CkCitation",
+      "CkCitationCard",
+      "CkMarkdownRenderer",
+      "CkFeedbackDialog"
+    ],
+    "props": [
+      "index",
+      "selected",
+      "as",
+      "ariaLabel"
+    ],
+    "examples": [
+      "Default",
+      "Selected",
+      "AsButton",
+      "InlineInText",
+      "MultiDigitIndex"
+    ],
+    "_autoGenerated": true
+  },
   "CkConversationLayout": {
     "description": "Scroll-aware container that renders a list of messages with sticky-to-bottom behavior, a shrinking spacer so streaming agent replies don't jitter the viewport, and slots for rendering user/agent messages.",
     "category": "Layout",
@@ -356,6 +400,7 @@
       "open",
       "sentiment",
       "responseText",
+      "citations",
       "reasons",
       "maxFreeTextLength",
       "reasonRequired",
@@ -374,6 +419,7 @@
     "examples": [
       "Positive",
       "Negative",
+      "WithCitations",
       "NoResponseColumn",
       "OptionalInput",
       "Submitting",
@@ -947,6 +993,7 @@
       "WithFooterActions",
       "WithCustomUserContent",
       "WithCustomAgentContent",
+      "WithCitations",
       "StreamingSimulation",
       "WithCustomMarkdownClasses",
       "DefaultCodeBlock",

package/components-meta.json

@@ -86,7 +86,13 @@
     "examples": [
       "Default",
       "Simple",
-      "FullWidthContent"
+      "FullWidthContent",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -121,6 +127,7 @@
       "WithBadges",
       "WithCheckboxes",
       "WithExternalItems",
+      "Virtualized",
       "Accessibility",
       "FilterAndSelect",
       "KeyboardNavigation",
@@ -210,6 +217,45 @@
     ],
     "_autoGenerated": true
   },
+  "UiBreadcrumb": {
+    "description": "A navigation trail showing the user's location within a site or app hierarchy. Renders as an ordered list inside a labelled `nav` landmark.",
+    "category": "Navigation",
+    "useCases": [
+      "page hierarchy",
+      "navigation trail",
+      "folder path",
+      "wizard location",
+      "nested resource path"
+    ],
+    "keywords": [
+      "breadcrumb",
+      "navigation",
+      "trail",
+      "path",
+      "hierarchy",
+      "crumbs"
+    ],
+    "related": [
+      "UiNavigationMenu",
+      "UiTabs"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "CustomSeparator",
+      "Collapsed",
+      "WithDropdown",
+      "WithCustomLinkComponent",
+      "Responsive",
+      "KeyboardNavigation",
+      "ZoomMagnification",
+      "ScreenReader",
+      "Accessibility",
+      "ResponsiveDesktop",
+      "MobileBreakpoint"
+    ],
+    "_autoGenerated": true
+  },
   "UiButton": {
     "description": "A clickable button component for triggering actions and submitting forms.",
     "category": "Actions",
@@ -525,7 +571,8 @@
       "WithMaxHeight",
       "WithoutCopyButton",
       "PlainText",
-      "HtmlWithLineNumbers"
+      "HtmlWithLineNumbers",
+      "Streaming"
     ],
     "_autoGenerated": true
   },
@@ -557,7 +604,13 @@
       "TitleOnly",
       "WithMaxWidth",
       "CustomHeaderSlot",
-      "WithForm"
+      "WithForm",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -634,7 +687,14 @@
       "WithIconTrigger",
       "WithSoftToggleTrigger",
       "WithSoftToggleTriggerAndText",
-      "WithAvatarTrigger"
+      "ItemTypes",
+      "WithAvatarTrigger",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -673,6 +733,45 @@
     ],
     "_autoGenerated": true
   },
+  "UiFadeMask": {
+    "description": "Wraps content and lays a gradient band over its edges, so scrolling or clipped content dissolves into the surface instead of ending on a hard cut. Put a scroll container in the slot and the band stays pinned to the wrapper's top or bottom edge, or to both when content runs off either end. The band is decorative and lets pointer events through, so the wrapped content stays scrollable and clickable underneath it. Its height defaults to 4rem on mobile and 6rem from the medium breakpoint up, and can be retuned per usage with the `--ui-fade-mask-height` custom property.",
+    "category": "Layout",
+    "useCases": [
+      "scroll fade",
+      "overflow hint",
+      "clipped text fade",
+      "scroll edge indicator",
+      "sticky header backdrop"
+    ],
+    "keywords": [
+      "fade",
+      "mask",
+      "gradient",
+      "scrim",
+      "overlay",
+      "scroll",
+      "overflow",
+      "edge"
+    ],
+    "related": [
+      "UiSeparator",
+      "UiSheet"
+    ],
+    "props": [
+      "background",
+      "position"
+    ],
+    "examples": [
+      "Default",
+      "Direction",
+      "BothEdges",
+      "OnPrimarySurface",
+      "AllVariants",
+      "KeyboardNavigation",
+      "MobileBreakpoint"
+    ],
+    "_autoGenerated": true
+  },
   "UiField": {
     "description": "A form field wrapper that groups label, input, description, and error messages. Provides consistent layout and accessibility for form controls.",
     "category": "Form Inputs",
@@ -768,22 +867,11 @@
       "mediaTone",
       "mediaIcon"
     ],
-    "examples": [
-      "Default",
-      "DefaultWithProgress",
-      "DefaultSuccess",
-      "DefaultError",
-      "SmallWithProgress",
-      "SmallSuccess",
-      "SmallError",
-      "NonRemovable",
-      "Disabled",
-      "AllVariants"
-    ],
+    "examples": [],
     "_autoGenerated": true
   },
   "UiFileType": {
-    "description": "Round 32×32 badge that visualises a file type with a tone + icon. Mirrors the Figma `Filetype` component (`AA26 / File Upload / Filetype`, node id `26438:42144`): - `Type=Text` (`pdf` / `doc` / `docx` / `txt` / `rtf`) → `accent-pink`  + `file` - `Type=Markdown` (`html` / `htm` / `md` / `mdx`)     → `accent-soft`  + `code-xml` - `Type=Tabular` (`csv` / `tsv` / `xls` / `xlsx`)     → `accent-yellow` + `table-2` - everything else                                     → `default`     + `file`",
+    "description": "Round 32×32 badge that visualises a file type with a tone + icon. Mirrors the Figma `Filetype` component (`AA26 / File Upload / Filetype`, node id `26438:42144`): - `Type=Text` (`pdf` / `doc` / `docx` / `txt` / `rtf`) → `accent-pink`  + `file` - `Type=Markdown` (`html` / `htm` / `md` / `mdx`)     → `accent-soft`  + `code-xml` - `Type=Tabular` (`csv` / `tsv` / `xls` / `xlsx`)     → `accent-yellow` + `table-2` - `Type=Media` (`mp4` / `mov` / `webm` / `mkv` / …)   → `accent-orange` + `image-play` - everything else                                     → `default`     + `file`",
     "category": "Data Display",
     "useCases": [
       "file-type indicator",
@@ -852,20 +940,22 @@
     "_autoGenerated": true
   },
   "UiIcon": {
-    "description": "An icon component using Lucide icons. Use for visual indicators, button decorations, or standalone meaningful graphics.",
+    "description": "An icon component using Lucide icons, or a tree-shakable brand icon imported from `@aleph-alpha/ui-library/icons`. Use for visual indicators, button decorations, or standalone meaningful graphics.",
     "category": "Data Display",
     "useCases": [
       "visual indicator",
       "button icon",
       "status icon",
-      "decorative graphic"
+      "decorative graphic",
+      "country flag"
     ],
     "keywords": [
       "icon",
       "symbol",
       "graphic",
       "lucide",
-      "svg"
+      "svg",
+      "flag"
     ],
     "related": [
       "UiButton"
@@ -879,7 +969,11 @@
     "examples": [
       "Default",
       "Sizes",
-      "IconLibrary"
+      "IconLibrary",
+      "Flags",
+      "Social",
+      "Payment",
+      "Crypto"
     ],
     "_autoGenerated": true
   },
@@ -1099,9 +1193,20 @@
       "Multiple",
       "WithFilter",
       "WithGroups",
+      "Scrollable",
+      "Virtualized",
+      "EmptyState",
       "Disabled",
       "HighlightOnHover",
-      "WithDisabledItems"
+      "WithDisabledItems",
+      "Accessibility",
+      "SingleSelection",
+      "MultipleSelection",
+      "Filtering",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1170,7 +1275,13 @@
       "Controlled",
       "Positions",
       "Alignments",
-      "OpenByDefault"
+      "OpenByDefault",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1365,6 +1476,7 @@
       "Multiple",
       "MultipleWithDefaultValue",
       "WithDefaultValue",
+      "Virtualized",
       "Accessibility",
       "OpenSelectClose",
       "KeyboardNavigation",
@@ -1643,7 +1755,16 @@
     "props": [],
     "examples": [
       "Default",
-      "Disabled"
+      "Checked",
+      "Disabled",
+      "AllSizes",
+      "WithField",
+      "Accessibility",
+      "ToggleBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1705,7 +1826,13 @@
       "WithDisabledTab",
       "Vertical",
       "ManualActivation",
-      "Controlled"
+      "Controlled",
+      "Accessibility",
+      "SelectionBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1773,7 +1900,15 @@
     ],
     "examples": [
       "Default",
-      "Disabled"
+      "WithLabel",
+      "States",
+      "Disabled",
+      "Accessibility",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "TextEntry",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1811,13 +1946,21 @@
     ],
     "examples": [
       "Default",
+      "Pressed",
       "Outline",
       "Soft",
+      "IconOnly",
       "WithText",
       "Small",
       "Large",
       "Disabled",
-      "AllStates"
+      "AllStates",
+      "Accessibility",
+      "ToggleBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1851,13 +1994,20 @@
       "Default",
       "Outline",
       "Single",
+      "Multiple",
       "Small",
       "Large",
       "Disabled",
       "WithText",
       "ViewToggle",
       "IndividualDisabled",
-      "AllStates"
+      "AllStates",
+      "Accessibility",
+      "SelectionBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1902,7 +2052,13 @@
       "AllSides",
       "UseCases",
       "WithText",
-      "CustomOffset"
+      "CustomOffset",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -2060,7 +2216,14 @@
       "CustomMaxSizeLabel",
       "AnyTypeNoFooter",
       "Disabled",
-      "CustomLabels"
+      "CustomLabels",
+      "Accessibility",
+      "KeyboardNavigation",
+      "DisabledGuards",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint",
+      "DialogIntegration"
     ],
     "_autoGenerated": true
   },
@@ -2120,6 +2283,23 @@
     ],
     "_autoGenerated": true
   },
+  "UiLayout": {
+    "description": "UiLayout component",
+    "category": "Uncategorized",
+    "useCases": [],
+    "keywords": [
+      "layout"
+    ],
+    "related": [],
+    "props": [],
+    "examples": [
+      "Default",
+      "TogglingTheSidebar",
+      "ScrollingContent",
+      "ZoomMagnification"
+    ],
+    "_autoGenerated": true
+  },
   "UiPlaceholder": {
     "description": "Placeholder for foundation components (internal development use).",
     "category": "Foundations",
@@ -2136,6 +2316,30 @@
     "examples": [],
     "_autoGenerated": true
   },
+  "UiProfileCard": {
+    "description": "UiProfileCard component",
+    "category": "Uncategorized",
+    "useCases": [],
+    "keywords": [
+      "profile",
+      "card"
+    ],
+    "related": [],
+    "props": [],
+    "examples": [
+      "Default",
+      "WithItemIcons",
+      "WithSubmenus",
+      "LanguagePicker",
+      "Accessibility",
+      "WithAvatarTrigger",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ZoomMagnification",
+      "MobileBreakpoint"
+    ],
+    "_autoGenerated": true
+  },
   "UiSidebar": {
     "description": "Pattern wrapper props for the application sidebar shell. Same API as the underlying core `Sidebar` component.",
     "category": "Patterns",
@@ -2154,9 +2358,59 @@
     "props": [],
     "examples": [
       "Default",
+      "ControlledOpenState",
       "Resizable",
-      "Inset",
-      "RightSide"
+      "RightSide",
+      "KeyboardNavigation",
+      "ZoomMagnification",
+      "ScreenReader",
+      "MobileBreakpoint"
+    ],
+    "_autoGenerated": true
+  },
+  "UiTopBar": {
+    "description": "Application top bar shell. Owns the padded bar, its leading gutter and trailing region, and the mobile/desktop mode — the controls themselves are passed in as slots, each with a `mobile-` counterpart. The default slot wraps the whole layout so it can be replaced outright.",
+    "category": "Patterns",
+    "useCases": [
+      "app shell header",
+      "dashboard top bar",
+      "workspace chrome",
+      "banner landmark"
+    ],
+    "keywords": [
+      "topbar",
+      "top bar",
+      "header",
+      "banner",
+      "app shell",
+      "chrome",
+      "layout",
+      "responsive",
+      "top",
+      "bar"
+    ],
+    "related": [
+      "UiSidebar",
+      "UiSidebarTrigger",
+      "UiFloatActionItems",
+      "UiAvatar"
+    ],
+    "props": [
+      "leadingWidth",
+      "ariaLabel"
+    ],
+    "examples": [
+      "Desktop",
+      "Mobile",
+      "SlotVisibility",
+      "Accessibility",
+      "KeyboardFocusOrder",
+      "ProfileCard",
+      "DefaultSlotWrapper",
+      "SlotVisibilityToggles",
+      "ZoomMagnification",
+      "MobileBreakpoint",
+      "MobileMenuToggle"
     ],
     "_autoGenerated": true
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/lib-mcp",
-  "version": "4.1.1",
+  "version": "5.0.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/server.js",
@@ -23,7 +23,7 @@
   "description": "MCP Server for UI Library and ChatKit component discovery tools.",
   "author": "Aleph Alpha GmbH",
   "engines": {
-    "node": ">=20.19.0"
+    "node": ">=22.13.0"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
@@ -33,7 +33,7 @@
     "esbuild": "^0.28.1",
     "typescript": "^5.2.2",
     "vitest": "^3.2.6",
-    "@aleph-alpha/tsconfig-frontend": "0.7.2"
+    "@aleph-alpha/tsconfig-frontend": "0.7.3"
   },
   "peerDependencies": {
     "@aleph-alpha/ui-library": "~5.3.0",