@aleph-alpha/lib-mcp 4.1.1 → 5.1.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",
@@ -597,6 +643,50 @@
     ],
     "_autoGenerated": true
   },
+  "CkMilkdownEditor": {
+    "description": "Markdown WYSIWYG editor built on [Milkdown Crepe](https://milkdown.dev/docs/guide/using-crepe). Its content is styled with the very same per-tag class map that {@link CkMarkdownRenderer} uses, so a message edited here looks identical to the rendered reply — no visual jump between reading and editing. The feature set is deliberately small and chat-oriented: a floating toolbar (bold, italic, strikethrough, inline code, link), bullet / ordered / task lists, blockquotes, links with a hover tooltip, fenced code blocks with syntax highlighting and a copy button, and an empty-document placeholder. Tables, images, LaTeX, slash menus and drag handles are intentionally not enabled. The editor itself loads lazily on mount, so importing this component does not pull ProseMirror / CodeMirror into the consumer's initial bundle.",
+    "category": "Form Inputs",
+    "useCases": [
+      "edit an assistant reply before sending",
+      "compose a rich prompt",
+      "edit a saved note in markdown",
+      "inline WYSIWYG editing of a user message"
+    ],
+    "keywords": [
+      "markdown",
+      "editor",
+      "wysiwyg",
+      "milkdown",
+      "crepe",
+      "prosemirror",
+      "rich text",
+      "v-model",
+      "compose"
+    ],
+    "related": [
+      "CkMarkdownRenderer",
+      "CkPromptInput",
+      "CkEditableUserMessage"
+    ],
+    "props": [
+      "modelValue",
+      "placeholder",
+      "readonly",
+      "disabled",
+      "ariaLabel",
+      "classes",
+      "autofocus"
+    ],
+    "examples": [
+      "Default",
+      "WithInitialContent",
+      "Readonly",
+      "Disabled",
+      "CustomClasses",
+      "SideBySideWithRenderer"
+    ],
+    "_autoGenerated": true
+  },
   "CkModelSelector": {
     "description": "Compact dropdown for choosing the active model, sized to sit inline in a prompt field next to the send button. Controlled component: pass the available `models` and the `selectedModelId`, and react to `update:selectedModelId` (so it works with `v-model:selected-model-id`). Purely presentational — fetching the list and persisting the choice are the consumer's responsibility.",
     "category": "Actions",
@@ -947,6 +1037,7 @@
       "WithFooterActions",
       "WithCustomUserContent",
       "WithCustomAgentContent",
+      "WithCitations",
       "StreamingSimulation",
       "WithCustomMarkdownClasses",
       "DefaultCodeBlock",

package/components-meta.json

@@ -57,7 +57,14 @@
     "examples": [
       "Default",
       "Destructive",
-      "AllVariants"
+      "AllVariants",
+      "Dismissible",
+      "Accessibility",
+      "DismissInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -86,7 +93,13 @@
     "examples": [
       "Default",
       "Simple",
-      "FullWidthContent"
+      "FullWidthContent",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -121,6 +134,7 @@
       "WithBadges",
       "WithCheckboxes",
       "WithExternalItems",
+      "Virtualized",
       "Accessibility",
       "FilterAndSelect",
       "KeyboardNavigation",
@@ -210,6 +224,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",
@@ -481,7 +534,13 @@
       "Removable",
       "WithAndWithoutLeadingIcon",
       "Group",
-      "FocusOrderInteractive"
+      "FocusOrderInteractive",
+      "Accessibility",
+      "ChipInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -525,7 +584,8 @@
       "WithMaxHeight",
       "WithoutCopyButton",
       "PlainText",
-      "HtmlWithLineNumbers"
+      "HtmlWithLineNumbers",
+      "Streaming"
     ],
     "_autoGenerated": true
   },
@@ -557,7 +617,13 @@
       "TitleOnly",
       "WithMaxWidth",
       "CustomHeaderSlot",
-      "WithForm"
+      "WithForm",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -593,7 +659,13 @@
       "NonModal",
       "WithoutHandle",
       "LongContent",
-      "OpenByDefault"
+      "OpenByDefault",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -634,7 +706,14 @@
       "WithIconTrigger",
       "WithSoftToggleTrigger",
       "WithSoftToggleTriggerAndText",
-      "WithAvatarTrigger"
+      "ItemTypes",
+      "WithAvatarTrigger",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -673,6 +752,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 +886,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 +959,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 +988,11 @@
     "examples": [
       "Default",
       "Sizes",
-      "IconLibrary"
+      "IconLibrary",
+      "Flags",
+      "Social",
+      "Payment",
+      "Crypto"
     ],
     "_autoGenerated": true
   },
@@ -1058,7 +1171,13 @@
       "WithInput",
       "WithCheckbox",
       "DisabledState",
-      "RequiredField"
+      "RequiredField",
+      "Accessibility",
+      "LabelActivation",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1099,9 +1218,20 @@
       "Multiple",
       "WithFilter",
       "WithGroups",
+      "Scrollable",
+      "Virtualized",
+      "EmptyState",
       "Disabled",
       "HighlightOnHover",
-      "WithDisabledItems"
+      "WithDisabledItems",
+      "Accessibility",
+      "SingleSelection",
+      "MultipleSelection",
+      "Filtering",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1170,7 +1300,13 @@
       "Controlled",
       "Positions",
       "Alignments",
-      "OpenByDefault"
+      "OpenByDefault",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1365,6 +1501,7 @@
       "Multiple",
       "MultipleWithDefaultValue",
       "WithDefaultValue",
+      "Virtualized",
       "Accessibility",
       "OpenSelectClose",
       "KeyboardNavigation",
@@ -1440,7 +1577,13 @@
       "NonModal",
       "WithForm",
       "LongContent",
-      "OpenByDefault"
+      "OpenByDefault",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1518,7 +1661,13 @@
       "Default",
       "Range",
       "Vertical",
-      "Disabled"
+      "Disabled",
+      "Accessibility",
+      "KeyboardNavigation",
+      "KeyboardRangeNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1643,7 +1792,16 @@
     "props": [],
     "examples": [
       "Default",
-      "Disabled"
+      "Checked",
+      "Disabled",
+      "AllSizes",
+      "WithField",
+      "Accessibility",
+      "ToggleBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1705,7 +1863,13 @@
       "WithDisabledTab",
       "Vertical",
       "ManualActivation",
-      "Controlled"
+      "Controlled",
+      "Accessibility",
+      "SelectionBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1739,7 +1903,14 @@
       "Disabled",
       "MaxTags",
       "EmailInput",
-      "WithListbox"
+      "WithListbox",
+      "Accessibility",
+      "TagInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint",
+      "MaxTagsLimit"
     ],
     "_autoGenerated": true
   },
@@ -1773,7 +1944,15 @@
     ],
     "examples": [
       "Default",
-      "Disabled"
+      "WithLabel",
+      "States",
+      "Disabled",
+      "Accessibility",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "TextEntry",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1811,13 +1990,21 @@
     ],
     "examples": [
       "Default",
+      "Pressed",
       "Outline",
       "Soft",
+      "IconOnly",
       "WithText",
       "Small",
       "Large",
       "Disabled",
-      "AllStates"
+      "AllStates",
+      "Accessibility",
+      "ToggleBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1851,13 +2038,20 @@
       "Default",
       "Outline",
       "Single",
+      "Multiple",
       "Small",
       "Large",
       "Disabled",
       "WithText",
       "ViewToggle",
       "IndividualDisabled",
-      "AllStates"
+      "AllStates",
+      "Accessibility",
+      "SelectionBehavior",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -1902,7 +2096,13 @@
       "AllSides",
       "UseCases",
       "WithText",
-      "CustomOffset"
+      "CustomOffset",
+      "Accessibility",
+      "PointerInteraction",
+      "KeyboardNavigation",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint"
     ],
     "_autoGenerated": true
   },
@@ -2060,7 +2260,14 @@
       "CustomMaxSizeLabel",
       "AnyTypeNoFooter",
       "Disabled",
-      "CustomLabels"
+      "CustomLabels",
+      "Accessibility",
+      "KeyboardNavigation",
+      "DisabledGuards",
+      "ScreenReader",
+      "ZoomMagnification",
+      "MobileBreakpoint",
+      "DialogIntegration"
     ],
     "_autoGenerated": true
   },
@@ -2120,6 +2327,42 @@
     ],
     "_autoGenerated": true
   },
+  "UiLayout": {
+    "description": "Container for the primary content area — the main part of an application layout. It renders the sheet surface (`background/surface/secondary`) and carries the design system's 48px margin on its left and right edges — 32px below the `desktop` breakpoint (1200px), toward the minimum desktop size of 1024px — so pages start from the same inset instead of each carrying its own spacing. Divide the space inside it with a 12-column grid and 24px gutters. Slots: `default` for the page content; `split` for a split view — a border divides the content box into two equal parts, each keeping a 28px margin from the divider and a 6-column grid of its own; and `sidebar` for secondary content — locked to the right edge and sized by `sidebarMode`. In the sidebar view the primary area is the rounded sheet (12px radius) while the sidebar has no surface of its own; both keep 48px margins.",
+    "category": "Layout",
+    "useCases": [
+      "main content area",
+      "page body",
+      "layout grid container",
+      "split view",
+      "secondary sidebar"
+    ],
+    "keywords": [
+      "layout",
+      "content",
+      "main",
+      "margin",
+      "grid",
+      "page",
+      "split",
+      "sidebar"
+    ],
+    "related": [
+      "UiSidebar",
+      "UiTopBar"
+    ],
+    "props": [
+      "as",
+      "sidebarMode"
+    ],
+    "examples": [
+      "Default",
+      "TogglingTheSidebar",
+      "ScrollingContent",
+      "ZoomMagnification"
+    ],
+    "_autoGenerated": true
+  },
   "UiPlaceholder": {
     "description": "Placeholder for foundation components (internal development use).",
     "category": "Foundations",
@@ -2136,6 +2379,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 +2421,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.1.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",