@aleph-alpha/lib-mcp 1.7.0 → 2.0.0

package/chat-kit-components-meta.json

@@ -0,0 +1,546 @@
+{
+  "CkAgentMessage": {
+    "description": "Layout for a single assistant (agent) turn in a conversation. Exposes `icon`, `header`, default content and `footer` slots for full control over each section while keeping consistent spacing and alignment.",
+    "category": "Messages",
+    "useCases": [
+      "render assistant reply",
+      "AI message layout",
+      "conversation turn",
+      "streaming message container"
+    ],
+    "keywords": [
+      "agent",
+      "assistant",
+      "message",
+      "bubble",
+      "reply",
+      "ai",
+      "conversation"
+    ],
+    "related": [
+      "CkUserMessage",
+      "CkConversation",
+      "CkMarkdownRenderer",
+      "CkCopyMessageActionButton"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "WithFooterActions",
+      "WithRichContent",
+      "WithCustomHeader",
+      "WithoutIcon"
+    ],
+    "_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",
+    "useCases": [
+      "conversation scroll container",
+      "streaming chat layout",
+      "chat viewport with auto-scroll",
+      "follow-the-bottom chat list"
+    ],
+    "keywords": [
+      "conversation",
+      "layout",
+      "scroll",
+      "auto-scroll",
+      "streaming",
+      "chat",
+      "container"
+    ],
+    "related": [
+      "CkConversation",
+      "CkAgentMessage",
+      "CkUserMessage"
+    ],
+    "props": [
+      "messages"
+    ],
+    "examples": [
+      "Default",
+      "StreamingSimulation",
+      "Empty"
+    ],
+    "_autoGenerated": true
+  },
+  "CkCopyMessageActionButton": {
+    "description": "Copy-to-clipboard action button for chat messages. Shows a check icon and announces success for assistive technologies, then reverts after a delay.",
+    "category": "Actions",
+    "useCases": [
+      "copy assistant reply",
+      "copy message to clipboard",
+      "chat message action",
+      "feedback action on message footer"
+    ],
+    "keywords": [
+      "copy",
+      "clipboard",
+      "action",
+      "message",
+      "button",
+      "icon",
+      "feedback"
+    ],
+    "related": [
+      "CkMessageActionButton",
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "text",
+      "disabled",
+      "durationMs",
+      "ariaLabelCopy",
+      "ariaLabelCopied",
+      "writeToClipboard"
+    ],
+    "examples": [
+      "Default",
+      "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",
+    "useCases": [
+      "chat history row",
+      "thread list entry",
+      "recent conversation item"
+    ],
+    "keywords": [
+      "chat",
+      "history",
+      "item",
+      "row",
+      "conversation",
+      "thread"
+    ],
+    "related": [
+      "CkHistoryWrapper"
+    ],
+    "props": [],
+    "examples": [
+      "Default",
+      "Active",
+      "AlwaysShowAction",
+      "NoMeta",
+      "WithActionPopover"
+    ],
+    "_autoGenerated": true
+  },
+  "CkHistoryWrapper": {
+    "description": "Vertical stack for chat history rows (`CkHistoryItem`). Sidebar-agnostic: can be used anywhere in the app, not only inside a sidebar.",
+    "category": "Layout",
+    "useCases": [
+      "chat history list",
+      "thread list container",
+      "recent conversations stack"
+    ],
+    "keywords": [
+      "chat",
+      "history",
+      "list",
+      "stack",
+      "container",
+      "wrapper"
+    ],
+    "related": [
+      "CkHistoryItem"
+    ],
+    "props": [
+      "withGap"
+    ],
+    "examples": [
+      "Default",
+      "WithoutGap"
+    ],
+    "_autoGenerated": true
+  },
+  "CkMarkdownRenderer": {
+    "description": "Renders a Markdown string as Vue VNodes with per-tag class overrides and an optional `code-block` slot. Use for assistant messages that contain prose, lists, tables, and code blocks.",
+    "category": "Data Display",
+    "useCases": [
+      "render assistant markdown reply",
+      "syntax-highlighted code blocks",
+      "GFM tables",
+      "chat message body"
+    ],
+    "keywords": [
+      "markdown",
+      "renderer",
+      "gfm",
+      "remark",
+      "code block",
+      "prose"
+    ],
+    "related": [
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "content",
+      "classes",
+      "plugins"
+    ],
+    "examples": [
+      "Default",
+      "WithCodeBlocks",
+      "WithCustomCodeBlockSlot",
+      "ComplexMarkdown",
+      "WithCustomClasses",
+      "GfmFeatures",
+      "WithCustomPlugin"
+    ],
+    "_autoGenerated": true
+  },
+  "CkMessageActionButton": {
+    "description": "Small icon-only action button used in the footer of chat messages. Acts as a ghost-styled wrapper around `UiButton` with consistent chat-kit tokens.",
+    "category": "Actions",
+    "useCases": [
+      "message footer action",
+      "like/dislike reaction",
+      "share button on reply",
+      "secondary message action"
+    ],
+    "keywords": [
+      "icon button",
+      "action",
+      "message",
+      "ghost",
+      "accessible",
+      "aria-label",
+      "button"
+    ],
+    "related": [
+      "CkCopyMessageActionButton",
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "ariaLabel",
+      "disabled"
+    ],
+    "examples": [
+      "Default"
+    ],
+    "_autoGenerated": true
+  },
+  "CkPromptActionButton": {
+    "description": "Icon-only call-to-action button styled for the chat prompt area (brand color). Typically used as the \"send\" button inside a prompt input toolbar, but works for any primary prompt-level action.",
+    "category": "Actions",
+    "useCases": [
+      "send message button",
+      "submit prompt",
+      "primary chat action",
+      "loading send button",
+      "disabled send button"
+    ],
+    "keywords": [
+      "prompt",
+      "send",
+      "action",
+      "button",
+      "icon",
+      "submit",
+      "loading",
+      "brand"
+    ],
+    "related": [
+      "CkPromptInput",
+      "CkInput",
+      "CkMessageActionButton"
+    ],
+    "props": [
+      "ariaLabel",
+      "disabled",
+      "loading",
+      "type"
+    ],
+    "examples": [
+      "Default",
+      "Disabled",
+      "Loading"
+    ],
+    "_autoGenerated": true
+  },
+  "CkPromptInput": {
+    "description": "Low-level prompt input: a single auto-growing textarea with left/right toolbar slots, a footer slot, and keyboard submission (Enter to submit, Shift+Enter for newline). Use when you need full control over the prompt layout; for a turnkey chat input use `CkInput` instead.",
+    "category": "Form Inputs",
+    "useCases": [
+      "raw chat prompt textarea",
+      "custom prompt toolbar",
+      "auto-growing textarea",
+      "compose box",
+      "keyboard submit"
+    ],
+    "keywords": [
+      "prompt",
+      "input",
+      "textarea",
+      "chat",
+      "auto-grow",
+      "compose",
+      "submit",
+      "v-model"
+    ],
+    "related": [
+      "CkInput",
+      "CkPromptActionButton",
+      "CkPromptInputDisclaimer"
+    ],
+    "props": [
+      "modelValue",
+      "placeholder",
+      "disabled",
+      "maxHeight",
+      "ariaLabel"
+    ],
+    "examples": [
+      "Default",
+      "WithToolbarSlots",
+      "WithFooterSlot",
+      "Disabled"
+    ],
+    "_autoGenerated": true
+  },
+  "CkPromptInputDisclaimer": {
+    "description": "Small helper/disclaimer line typically rendered under a chat input (\"AI may produce incorrect answers\"). Renders nothing when there is no text and no default slot content, making it safe to always include.",
+    "category": "Feedback",
+    "useCases": [
+      "chat disclaimer",
+      "ai may make mistakes",
+      "prompt footnote",
+      "small help text under input"
+    ],
+    "keywords": [
+      "disclaimer",
+      "notice",
+      "footer",
+      "help text",
+      "ai",
+      "prompt",
+      "input"
+    ],
+    "related": [
+      "CkInput",
+      "CkPromptInput"
+    ],
+    "props": [
+      "text"
+    ],
+    "examples": [
+      "Default",
+      "WithSlot",
+      "Empty"
+    ],
+    "_autoGenerated": true
+  },
+  "CkPromptStopButton": {
+    "description": "Icon-only button used to stop an in-flight assistant generation. Shares the brand styling of `CkPromptActionButton` but is intended to replace it in the prompt toolbar while a response is streaming.",
+    "category": "Actions",
+    "useCases": [
+      "stop assistant generation",
+      "cancel streaming reply",
+      "abort in-flight request",
+      "halt llm response"
+    ],
+    "keywords": [
+      "stop",
+      "cancel",
+      "abort",
+      "prompt",
+      "action",
+      "button",
+      "icon",
+      "streaming"
+    ],
+    "related": [
+      "CkPromptActionButton",
+      "CkPromptInput",
+      "CkInput"
+    ],
+    "props": [
+      "ariaLabel",
+      "disabled"
+    ],
+    "examples": [
+      "Default",
+      "Disabled"
+    ],
+    "_autoGenerated": true
+  },
+  "CkUserMessage": {
+    "description": "Bubble layout for a single user turn in a conversation. Renders the message text on the right side with a tokenized background and max-width; supports a default slot for custom inline content.",
+    "category": "Messages",
+    "useCases": [
+      "render user message bubble",
+      "conversation turn from user",
+      "chat input preview",
+      "right-aligned message"
+    ],
+    "keywords": [
+      "user",
+      "message",
+      "bubble",
+      "chat",
+      "conversation",
+      "turn"
+    ],
+    "related": [
+      "CkAgentMessage",
+      "CkConversation"
+    ],
+    "props": [
+      "message"
+    ],
+    "examples": [
+      "Default",
+      "LongMessage",
+      "MultilineMessage",
+      "WithSlotContent"
+    ],
+    "_autoGenerated": true
+  },
+  "CkConversation": {
+    "description": "High-level chat conversation: renders user and agent messages, Markdown for assistant replies, an avatar, copy-to-clipboard action, streaming viewport, and slots for overriding any part of the rendering. Use as the drop-in conversation surface for most chat-kit integrations.",
+    "category": "Messages",
+    "useCases": [
+      "complete chat conversation ui",
+      "streaming chat with markdown",
+      "assistant chat view",
+      "llm conversation component",
+      "drop-in chat surface"
+    ],
+    "keywords": [
+      "conversation",
+      "chat",
+      "messages",
+      "assistant",
+      "agent",
+      "user",
+      "markdown",
+      "streaming",
+      "avatar"
+    ],
+    "related": [
+      "CkConversationLayout",
+      "CkAgentMessage",
+      "CkUserMessage",
+      "CkMarkdownRenderer",
+      "CkCopyMessageActionButton",
+      "CkInput"
+    ],
+    "props": [
+      "messages",
+      "agentAvatarImage",
+      "agentAvatarFallback",
+      "agentLoadingImage",
+      "agentMarkdownClasses"
+    ],
+    "examples": [
+      "Default",
+      "WithIcon",
+      "WithCustomAvatarFallback",
+      "NoIcon",
+      "WithCustomIcon",
+      "WithFooterActions",
+      "WithCustomUserContent",
+      "WithCustomAgentContent",
+      "StreamingSimulation",
+      "WithCustomMarkdownClasses",
+      "WithCustomCodeBlock",
+      "Empty"
+    ],
+    "_autoGenerated": true
+  },
+  "CkHistory": {
+    "description": "Composed conversation history list. Renders each conversation as a real `<a href>` row so middle-click, cmd/ctrl-click, and right-click \"Copy link address\" all work natively. Plain left-clicks are intercepted via a RouterLink-style guard and exposed as a `select` event so consumers can call `router.push(...)` (or any other navigation primitive) themselves. Per-row \"Edit\" and \"Delete\" actions are rendered internally; consumers receive `edit` / `delete` events with the corresponding conversation. Use the `#item` scoped slot to fully replace the row rendering — for example to wrap each row in `<RouterLink>` for native vue-router integration. The slot scope exposes the resolved row data (`conversation`, `href`, `isActive`, `title`) plus `select` / `edit` / `delete` helpers that emit the same events as the default rendering.",
+    "category": "Messages",
+    "useCases": [
+      "conversation history list",
+      "recent chats sidebar entry",
+      "thread navigation",
+      "chat history pane"
+    ],
+    "keywords": [
+      "conversation",
+      "history",
+      "list",
+      "navigation",
+      "link",
+      "sidebar",
+      "threads",
+      "routerlink"
+    ],
+    "related": [
+      "CkHistoryWrapper",
+      "CkHistoryItem"
+    ],
+    "props": [
+      "conversations",
+      "hrefResolver",
+      "activeId",
+      "showAction",
+      "showActionOnHover"
+    ],
+    "examples": [
+      "Default",
+      "WithoutActions",
+      "RouterLinkIntegration",
+      "WithCustomItem"
+    ],
+    "_autoGenerated": true
+  },
+  "CkInput": {
+    "description": "Drop-in chat input: combines `CkPromptInput`, a `CkPromptActionButton` send button, and a `CkPromptInputDisclaimer`. Supports `v-model`, loading and disabled states, and slots to customize the toolbar and footer.",
+    "category": "Form Inputs",
+    "useCases": [
+      "chat compose input",
+      "prompt box with send button",
+      "llm input with disclaimer",
+      "quick-start chat input",
+      "turnkey chat input"
+    ],
+    "keywords": [
+      "input",
+      "prompt",
+      "chat",
+      "send",
+      "compose",
+      "disclaimer",
+      "loading",
+      "v-model",
+      "textarea"
+    ],
+    "related": [
+      "CkPromptInput",
+      "CkPromptActionButton",
+      "CkPromptInputDisclaimer",
+      "CkConversation"
+    ],
+    "props": [
+      "modelValue",
+      "placeholder",
+      "disabled",
+      "loading",
+      "maxHeight",
+      "ariaLabel",
+      "stopAriaLabel",
+      "disclaimer"
+    ],
+    "examples": [
+      "Default",
+      "WithModeToggle",
+      "FullExample",
+      "Disabled",
+      "Loading",
+      "WithLongText",
+      "MobileWidth"
+    ],
+    "_autoGenerated": true
+  }
+}

package/components-meta.json

@@ -109,7 +109,7 @@
     "_autoGenerated": true
   },
   "UiBadge": {
-    "description": "A small label for status, counts, or categories. Use for tags, notifications counts, status indicators, or labels.",
+    "description": "A small label for status, counts, or categories. Use for tags, notification counts, status indicators, or labels.",
     "category": "Feedback",
     "useCases": [
       "status label",
@@ -132,20 +132,27 @@
     ],
     "props": [
       "variant",
+      "size",
       "asChild",
       "startIcon",
-      "endIcon"
+      "endIcon",
+      "disabled"
     ],
     "examples": [
       "Default",
       "Secondary",
-      "Destructive",
       "Outline",
+      "Destructive",
+      "Success",
+      "Warning",
+      "Verified",
+      "Disabled",
       "WithStartIcon",
       "WithEndIcon",
       "WithBothIcons",
       "WithIconSlot",
-      "Pill",
+      "Numbers",
+      "Sizes",
       "AllVariants"
     ],
     "_autoGenerated": true
@@ -169,7 +176,6 @@
       "interactive"
     ],
     "related": [
-      "UiIconButton",
       "UiLink"
     ],
     "props": [
@@ -198,7 +204,9 @@
       "LoadingWithBothIcons",
       "WithIconSlot",
       "AsChild",
-      "AllVariants"
+      "AllVariants",
+      "IconSizes",
+      "AllVariantsAndSizes"
     ],
     "_autoGenerated": true
   },
@@ -690,25 +698,13 @@
     "_autoGenerated": true
   },
   "UiIcon": {
-    "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"
-    ],
+    "description": "UiIcon component",
+    "category": "Uncategorized",
+    "useCases": [],
     "keywords": [
-      "icon",
-      "symbol",
-      "graphic",
-      "lucide",
-      "svg"
-    ],
-    "related": [
-      "UiIconButton",
-      "UiButton"
+      "icon"
     ],
+    "related": [],
     "props": [
       "name",
       "size",
@@ -723,7 +719,7 @@
     "_autoGenerated": true
   },
   "UiIconButton": {
-    "description": "A button that displays only an icon without text. Use for compact actions like close, edit, delete, or toolbar buttons.",
+    "description": "A button that displays only an icon without text. Use for compact actions like close, edit, delete, or toolbar buttons. It is being merged into `UiButton` — use `UiButton` with an icon-only child and an `aria-label` instead (e.g. `<UiButton size=\"icon-sm\" aria-label=\"Close\"><UiIcon name=\"x\" /></UiButton>`).",
     "category": "Actions",
     "useCases": [
       "close button",
@@ -769,14 +765,15 @@
     "_autoGenerated": true
   },
   "UiInput": {
-    "description": "A text input field for single-line user input. Use for forms, search bars, and any text entry that fits on one line.",
+    "description": "A text input field for single-line user input. Use for forms, search bars, and any text entry that fits on one line. When `type=\"file\"`, the native `Choose File` button is hidden and replaced by a `UiButton` (with an upload icon) rendered inside the input. The selected file name (or count) is shown as the input value, and selected files are emitted via `update:files`.",
     "category": "Form Inputs",
     "useCases": [
       "text entry",
       "search field",
       "email input",
       "password field",
-      "form field"
+      "form field",
+      "file upload"
     ],
     "keywords": [
       "input",
@@ -786,18 +783,25 @@
       "search",
       "email",
       "password",
-      "textbox"
+      "textbox",
+      "file",
+      "upload"
     ],
     "related": [
       "UiTextarea",
       "UiSelect",
-      "UiCheckbox"
+      "UiCheckbox",
+      "UiFileUploadBox"
     ],
     "props": [
       "name",
+      "type",
       "disabled",
       "placeholder",
-      "required"
+      "required",
+      "accept",
+      "multiple",
+      "uploadButtonLabel"
     ],
     "examples": [
       "Default",
@@ -1191,6 +1195,8 @@
       "WithDisabledItems",
       "Disabled",
       "Sizes",
+      "Multiple",
+      "MultipleWithDefaultValue",
       "WithDefaultValue"
     ],
     "_autoGenerated": true