@aleph-alpha/lib-mcp 2.1.0 → 2.2.0

package/chat-kit-components-meta.json

@@ -103,6 +103,142 @@
     ],
     "_autoGenerated": true
   },
+  "CkFeedbackButton": {
+    "description": "Binary thumbs up / thumbs down feedback control for assistant messages. Fully prop-driven: the host application owns the selection and lock state and decides when (or if) to persist it to a backend. Labels default to those provided by `useChatKitLabels` (which can be translated via `provideChatKitLabels`). The `ariaLabel*` props override the injected labels on a per-instance basis when set.",
+    "category": "Feedback",
+    "useCases": [
+      "like or dislike an assistant reply",
+      "collect binary message rating",
+      "lock feedback after submission",
+      "rate AI response"
+    ],
+    "keywords": [
+      "feedback",
+      "thumbs up",
+      "thumbs down",
+      "like",
+      "dislike",
+      "rating",
+      "vote",
+      "action",
+      "message",
+      "button"
+    ],
+    "related": [
+      "CkMessageActionButton",
+      "CkCopyMessageActionButton",
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "value",
+      "locked",
+      "disabled",
+      "ariaLabelThumbsUp",
+      "ariaLabelThumbsDown",
+      "ariaLabelGroup"
+    ],
+    "examples": [
+      "Default",
+      "SelectedUp",
+      "SelectedDown",
+      "Locked",
+      "Disabled",
+      "SubmitOnSelect"
+    ],
+    "_autoGenerated": true
+  },
+  "CkFeedbackDialog": {
+    "description": "Modal dialog for collecting qualitative feedback on an assistant response. Opened after a binary thumbs-up / thumbs-down click (see `CkFeedbackButton`), it lets the user pick a single reason code and add an optional free-text comment, then submit both alongside the original sentiment. One reason per submission: the backend (feedback-kit) stores a single `reason` enum per response, so the dialog is single-select by design. Fully prop-driven: the host application owns `open`, the list of reasons to show (fetched from `GET /feedback/config`), the response text to display, and the submission handler. The component only manages transient form state (the selected reason and free-text value) until the user submits or cancels. capture a free-text comment, drive a two-step rating flow rating, comment CkConversation, UiDialog, UiToggleGroup",
+    "category": "Feedback",
+    "useCases": [
+      "collect qualitative feedback",
+      "gather a reason code for a response"
+    ],
+    "keywords": [
+      "feedback",
+      "dialog",
+      "modal",
+      "reason codes",
+      "free text",
+      "qualitative"
+    ],
+    "related": [
+      "CkFeedbackButton",
+      "CkMessageActionButton",
+      "CkAgentMessage"
+    ],
+    "props": [
+      "open",
+      "sentiment",
+      "responseText",
+      "reasons",
+      "maxFreeTextLength",
+      "submitting",
+      "disabled",
+      "titlePositive",
+      "titleNegative",
+      "responseHeading",
+      "description",
+      "otherLabel",
+      "otherTooltip",
+      "freeTextPlaceholder",
+      "cancelLabel",
+      "submitLabel"
+    ],
+    "examples": [
+      "Positive",
+      "Negative",
+      "NoResponseColumn",
+      "Submitting",
+      "WithFeedbackButton"
+    ],
+    "_autoGenerated": true
+  },
+  "CkFileItemsList": {
+    "description": "Horizontal list of file attachments; collapses to a popover once the count exceeds `maxInline`.",
+    "category": "Form Inputs",
+    "useCases": [
+      "user message attachments",
+      "prompt input previews",
+      "chat file row"
+    ],
+    "keywords": [
+      "files",
+      "attachments",
+      "file list",
+      "popover",
+      "chat",
+      "file",
+      "items",
+      "list"
+    ],
+    "related": [
+      "UiFileItem",
+      "UiPopover"
+    ],
+    "props": [
+      "files",
+      "maxInline",
+      "size",
+      "isRemovable",
+      "removeLabel",
+      "disabled",
+      "triggerLabel",
+      "triggerAriaLabel",
+      "listLabel",
+      "popoverClass"
+    ],
+    "examples": [
+      "Inline",
+      "Collapsed",
+      "Removable",
+      "CustomItem",
+      "Clickable",
+      "Disabled"
+    ],
+    "_autoGenerated": true
+  },
   "CkHistoryItem": {
     "description": "A single chat history entry with title, optional meta line, active indicator, and a trailing action control (plain button or popover). Sidebar-agnostic: can be used anywhere, not only inside a sidebar.",
     "category": "Actions",
@@ -443,6 +579,7 @@
     ],
     "examples": [
       "Default",
+      "ChainOfThought",
       "WithIcon",
       "WithCustomAvatarFallback",
       "NoIcon",

package/components-meta.json

@@ -62,14 +62,26 @@
     "_autoGenerated": true
   },
   "UiAlertDialog": {
-    "description": "Root alert dialog. Uses core **`Dialog`** (`components/core/dialog/Dialog.vue` → **`DialogRoot`**) with **`modal: true`** Root uses core **`Dialog`** with modal enabled. Subcomponents use **`UiAlertDialog*`** / alert **`DialogContent`** for **`alertdialog`** semantics. Use **`v-model:model`** for controlled mode (unlike **`UiDialog`**, which uses **`v-model:open`**).",
-    "category": "Uncategorized",
-    "useCases": [],
+    "description": "A modal dialog for confirmations that interrupt the user. Use for destructive actions, important decisions, or critical confirmations.",
+    "category": "Overlays",
+    "useCases": [
+      "confirm delete",
+      "destructive action",
+      "important confirmation",
+      "warning"
+    ],
     "keywords": [
       "alert",
-      "dialog"
+      "dialog",
+      "modal",
+      "confirm",
+      "warning",
+      "destructive",
+      "popup"
+    ],
+    "related": [
+      "UiPopover"
     ],
-    "related": [],
     "props": [],
     "examples": [
       "Default",
@@ -78,6 +90,40 @@
     ],
     "_autoGenerated": true
   },
+  "UiAutocomplete": {
+    "description": "Beta: Filterable select input for choosing one or many options. This component is currently beta. Its API and behavior may still change before it is considered stable.",
+    "category": "Form Inputs",
+    "useCases": [
+      "autocomplete",
+      "searchable select",
+      "multi select",
+      "command picker"
+    ],
+    "keywords": [
+      "autocomplete",
+      "combobox",
+      "select",
+      "search",
+      "filter",
+      "multi-select",
+      "beta"
+    ],
+    "related": [
+      "UiSelect",
+      "UiTagsInput",
+      "UiListbox"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "Multiple",
+      "WithSlots",
+      "WithBadges",
+      "WithCheckboxes",
+      "WithExternalItems"
+    ],
+    "_autoGenerated": true
+  },
   "UiAvatar": {
     "description": "A circular image for representing users or entities. Use for profile pictures, user lists, or any person/entity representation.",
     "category": "Data Display",
@@ -102,9 +148,10 @@
     "props": [],
     "examples": [
       "Default",
+      "Sizes",
       "Fallback",
       "Multiple",
-      "Stacked"
+      "AvatarGroup"
     ],
     "_autoGenerated": true
   },
@@ -205,6 +252,7 @@
       "WithIconSlot",
       "AsChild",
       "AllVariants",
+      "DisabledHoverBleed",
       "IconSizes",
       "AllVariantsAndSizes"
     ],
@@ -633,12 +681,15 @@
       "upload",
       "attachment",
       "progress",
+      "success",
+      "error",
       "item"
     ],
     "related": [
       "UiFileUploadBox",
       "UiItem",
-      "UiButton"
+      "UiButton",
+      "UiProgress"
     ],
     "props": [
       "filename",
@@ -647,24 +698,64 @@
       "progress",
       "error",
       "removeLabel",
-      "disabled"
+      "progressLabel",
+      "removable",
+      "disabled",
+      "size",
+      "mediaTone",
+      "mediaIcon"
     ],
     "examples": [
       "Default",
-      "WithProgress",
-      "Complete",
-      "WithError",
+      "DefaultWithProgress",
+      "DefaultSuccess",
+      "DefaultError",
+      "SmallWithProgress",
+      "SmallSuccess",
+      "SmallError",
+      "NonRemovable",
       "Disabled",
-      "DisabledWithError",
-      "ProgressAndError",
-      "FilenameOnly",
-      "AllStates"
+      "AllVariants"
+    ],
+    "_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`",
+    "category": "Data Display",
+    "useCases": [
+      "file-type indicator",
+      "attachment badge"
+    ],
+    "keywords": [
+      "file",
+      "badge",
+      "attachment",
+      "filetype",
+      "icon",
+      "type"
+    ],
+    "related": [
+      "UiFileItem",
+      "UiFileUploadBox"
+    ],
+    "props": [
+      "filename",
+      "tone",
+      "icon",
+      "error",
+      "loading"
+    ],
+    "examples": [
+      "Default",
+      "ErrorState",
+      "AllTypes",
+      "ToneOverrides"
     ],
     "_autoGenerated": true
   },
   "UiFileUploadBox": {
     "description": "Drop zone + file picker for selecting files with optional type/size validation. **Emits:** see {@link UiFileUploadBoxEmits}.",
-    "category": "Components",
+    "category": "Form Inputs",
     "useCases": [
       "file upload area",
       "drag and drop attachments"
@@ -698,13 +789,24 @@
     "_autoGenerated": true
   },
   "UiIcon": {
-    "description": "UiIcon component",
-    "category": "Uncategorized",
-    "useCases": [],
+    "description": "An icon component using Lucide icons. Use for visual indicators, button decorations, or standalone meaningful graphics.",
+    "category": "Data Display",
+    "useCases": [
+      "visual indicator",
+      "button icon",
+      "status icon",
+      "decorative graphic"
+    ],
     "keywords": [
-      "icon"
+      "icon",
+      "symbol",
+      "graphic",
+      "lucide",
+      "svg"
+    ],
+    "related": [
+      "UiButton"
     ],
-    "related": [],
     "props": [
       "name",
       "size",
@@ -785,7 +887,6 @@
       "menu",
       "settings",
       "navigation",
-      "selectable",
       "card"
     ],
     "related": [
@@ -796,6 +897,9 @@
     "props": [
       "variant",
       "size",
+      "title",
+      "description",
+      "desc",
       "asChild",
       "withListSemantics"
     ],
@@ -803,16 +907,14 @@
       "Basic",
       "Variants",
       "Sizes",
+      "CustomSlots",
       "WithIcon",
-      "WithAvatar",
-      "WithImage",
+      "Actions",
+      "ActionTooltip",
+      "Media",
       "Group",
-      "WithHeaderAndFooter",
       "AsLink",
-      "TeamMembersList",
-      "NotificationList",
-      "EmptyStateWithInvite",
-      "AllStates"
+      "AllVariants"
     ],
     "_autoGenerated": true
   },
@@ -1120,6 +1222,36 @@
     ],
     "_autoGenerated": true
   },
+  "UiResizable": {
+    "description": "A resizable panel layout for splitting available space into user-adjustable regions. Use for sidebars, inspectors, editors, and other dense layouts where users need control over panel sizes.",
+    "category": "Layout",
+    "useCases": [
+      "split pane",
+      "resizable sidebar",
+      "editor layout",
+      "inspector panel"
+    ],
+    "keywords": [
+      "resizable",
+      "splitter",
+      "panel",
+      "pane",
+      "layout",
+      "sidebar"
+    ],
+    "related": [
+      "UiSheet",
+      "UiSeparator"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "Vertical",
+      "Collapsible",
+      "PixelSizing"
+    ],
+    "_autoGenerated": true
+  },
   "UiSelect": {
     "description": "A dropdown select for choosing from a list of options. Use for form fields where users must pick one value from many.",
     "category": "Form Inputs",
@@ -1147,6 +1279,7 @@
       "Default",
       "WithGroups",
       "WithDisabledItems",
+      "WithIcons",
       "Disabled",
       "Sizes",
       "Multiple",
@@ -1589,9 +1722,12 @@
     "props": [
       "modelValue",
       "defaultValue",
+      "active",
       "disabled",
       "variant",
-      "size"
+      "size",
+      "leftIcon",
+      "rightIcon"
     ],
     "examples": [
       "Default",
@@ -1718,8 +1854,11 @@
       "WithSorting",
       "WithPagination",
       "WithToolbar",
+      "WithColumnsFilter",
       "WithGlobalFilter",
       "WithRowSelection",
+      "WithDraggableColumns",
+      "WithExpandableRows",
       "FullExample",
       "WithCustomEmptyText",
       "WithCustomEmptySlot",
@@ -1871,6 +2010,7 @@
     "props": [],
     "examples": [
       "Default",
+      "Resizable",
       "Inset",
       "RightSide"
     ],

package/dist/scripts/generate-component-meta.js

@@ -185,28 +185,7 @@ var CHAT_KIT_OUTPUT_PATH = path3.join(
   PACKAGE_ROOT,
   "chat-kit-components-meta.json"
 );
-function extractJSDocTags(content, interfaceName) {
-  const declarationRegex = new RegExp(
-    `export\\s+(?:interface|type)\\s+${escapeRegex(interfaceName)}\\b`
-  );
-  const declarationMatch = content.match(declarationRegex);
-  if (!declarationMatch || declarationMatch.index === void 0) {
-    return { description: "", useCases: [], keywords: [], related: [] };
-  }
-  const contentBefore = content.substring(0, declarationMatch.index);
-  const jsdocEndIndex = contentBefore.lastIndexOf("*/");
-  if (jsdocEndIndex === -1) {
-    return { description: "", useCases: [], keywords: [], related: [] };
-  }
-  const betweenJsdocAndDeclaration = contentBefore.substring(jsdocEndIndex + 2);
-  if (betweenJsdocAndDeclaration.trim() !== "") {
-    return { description: "", useCases: [], keywords: [], related: [] };
-  }
-  const jsdocStartIndex = contentBefore.lastIndexOf("/**");
-  if (jsdocStartIndex === -1 || jsdocStartIndex > jsdocEndIndex) {
-    return { description: "", useCases: [], keywords: [], related: [] };
-  }
-  const jsdoc = contentBefore.substring(jsdocStartIndex + 3, jsdocEndIndex);
+function parseJSDocBlock(jsdoc) {
   const lines = jsdoc.split("\n").map((l) => l.replace(/^\s*\*\s?/, "").trim());
   let description = "";
   const useCases = [];
@@ -231,6 +210,51 @@ function extractJSDocTags(content, interfaceName) {
   }
   return { description, useCases, keywords, related, category };
 }
+function extractJSDocTags(content, interfaceName) {
+  const declarationRegex = new RegExp(
+    `export\\s+(?:interface|type)\\s+${escapeRegex(interfaceName)}\\b`
+  );
+  const declarationMatch = content.match(declarationRegex);
+  if (!declarationMatch || declarationMatch.index === void 0) {
+    return { description: "", useCases: [], keywords: [], related: [] };
+  }
+  const contentBefore = content.substring(0, declarationMatch.index);
+  const jsdocEndIndex = contentBefore.lastIndexOf("*/");
+  if (jsdocEndIndex === -1) {
+    return { description: "", useCases: [], keywords: [], related: [] };
+  }
+  const betweenJsdocAndDeclaration = contentBefore.substring(jsdocEndIndex + 2);
+  if (betweenJsdocAndDeclaration.trim() !== "") {
+    return { description: "", useCases: [], keywords: [], related: [] };
+  }
+  const jsdocStartIndex = contentBefore.lastIndexOf("/**");
+  if (jsdocStartIndex === -1 || jsdocStartIndex > jsdocEndIndex) {
+    return { description: "", useCases: [], keywords: [], related: [] };
+  }
+  const jsdoc = contentBefore.substring(jsdocStartIndex + 3, jsdocEndIndex);
+  return parseJSDocBlock(jsdoc);
+}
+function findBestJSDocSource(content, componentName, primaryInterfaceName) {
+  const primary = extractJSDocTags(content, primaryInterfaceName);
+  if (primary.category) return primary;
+  const propsRegex = new RegExp(
+    `export\\s+(?:interface|type)\\s+(${escapeRegex(componentName)}\\w*Props)\\b`,
+    "g"
+  );
+  let propsMatch;
+  while ((propsMatch = propsRegex.exec(content)) !== null) {
+    if (propsMatch[1] === primaryInterfaceName) continue;
+    const tags = extractJSDocTags(content, propsMatch[1]);
+    if (tags.category) return tags;
+  }
+  const blockRegex = /\/\*\*([\s\S]*?)\*\//g;
+  let blockMatch;
+  while ((blockMatch = blockRegex.exec(content)) !== null) {
+    const tags = parseJSDocBlock(blockMatch[1]);
+    if (tags.category) return tags;
+  }
+  return primary;
+}
 function extractKeywordsFromName(componentName) {
   const name = componentName.replace(/^(?:Ui|Ck)/, "");
   return name.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase().split(/\s+/).filter((word) => word.length > 2);
@@ -284,7 +308,11 @@ function processComponent(componentDir, componentName) {
     /export\s+(?:interface|type)\s+((?:Ui|Ck)\w+Props)/
   );
   const interfaceName = exactMatch?.[1] || subComponentMatch?.[1] || anyPropsMatch?.[1] || `${componentName}Props`;
-  const jsdocData = extractJSDocTags(typesContent, interfaceName);
+  const jsdocData = findBestJSDocSource(
+    typesContent,
+    componentName,
+    interfaceName
+  );
   const nameKeywords = extractKeywordsFromName(componentName);
   const keywords = jsdocData.keywords.length > 0 ? jsdocData.keywords : nameKeywords;
   const category = jsdocData.category || "Uncategorized";
@@ -386,5 +414,7 @@ if (isMain) {
 export {
   extractJSDocTags,
   extractKeywordsFromName,
-  extractProps
+  extractProps,
+  findBestJSDocSource,
+  parseJSDocBlock
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/lib-mcp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/server.js",
@@ -36,8 +36,8 @@
     "@aleph-alpha/tsconfig-frontend": "0.6.0"
   },
   "peerDependencies": {
-    "@aleph-alpha/ui-library": "2.2.0",
-    "@aleph-alpha/chat-kit": "1.1.0"
+    "@aleph-alpha/ui-library": "2.8.0",
+    "@aleph-alpha/chat-kit": "1.13.0"
   },
   "homepage": "https://docs.aleph-alpha.com",
   "scripts": {