@aleph-alpha/chat-kit 1.7.0 → 1.10.0

package/dist/components/base/CkFileItemsList/CkFileItemsList.vue.d.ts

@@ -0,0 +1,38 @@
+import { type UiFileItemSize } from '@aleph-alpha/ui-library';
+import type { CkFileEntry, CkFileItemsListProps } from './types';
+type __VLS_Slots = {
+    item: (props: {
+        file: CkFileEntry;
+        remove: () => void;
+        size: UiFileItemSize;
+        isRemovable: boolean;
+        removeLabel: string;
+        disabled: boolean;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<CkFileItemsListProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    remove: (id: string | number) => any;
+    "item-click": (file: CkFileEntry, originalEvent: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<CkFileItemsListProps> & Readonly<{
+    onRemove?: ((id: string | number) => any) | undefined;
+    "onItem-click"?: ((file: CkFileEntry, originalEvent: MouseEvent) => any) | undefined;
+}>, {
+    size: UiFileItemSize;
+    disabled: boolean;
+    isRemovable: boolean;
+    removeLabel: string;
+    maxInline: number;
+    triggerLabel: string;
+    triggerAriaLabel: string;
+    listLabel: string;
+    popoverClass: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+//# sourceMappingURL=CkFileItemsList.vue.d.ts.map

package/dist/components/base/CkFileItemsList/CkFileItemsList.vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CkFileItemsList.vue.d.ts","sourceRoot":"","sources":["../../../../src/components/base/CkFileItemsList/CkFileItemsList.vue"],"names":[],"mappings":"AA2KA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,WAAW,EAEX,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAwBjB,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,CAAC,KAAK,EAAE;QACZ,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,IAAI,EAAE,cAAc,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,OAAO,CAAC;KACnB,KAAK,OAAO,CAAC;CACf,CAAC;AAqVF,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;6EAId,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AAWzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/base/CkFileItemsList/index.d.ts

@@ -0,0 +1,3 @@
+export { default as CkFileItemsList } from './CkFileItemsList.vue';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/base/CkFileItemsList/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/base/CkFileItemsList/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,mBAAmB,SAAS,CAAC"}

package/dist/components/base/CkFileItemsList/types.d.ts

@@ -0,0 +1,59 @@
+import type { UiFileItemMediaTone, UiFileItemSize } from '@aleph-alpha/ui-library';
+export interface CkFileEntry {
+    /** Stable id used as the `:key` and emitted with `remove`. */
+    id: string | number;
+    /** Full file name. */
+    filename: string;
+    /** Short type label, e.g. `PDF`. */
+    typeLabel?: string;
+    /** Size label, e.g. `1.2 MB`. */
+    sizeLabel?: string;
+    /** Upload progress 0–100; `< 100` shows a progress bar. */
+    progress?: number | null;
+    /** Error message; non-empty enters the error state. */
+    error?: string | null;
+    /** Lucide icon override for the media badge. */
+    mediaIcon?: string;
+    /** Media badge tone override. */
+    mediaTone?: UiFileItemMediaTone;
+    /** Per-row disable. */
+    disabled?: boolean;
+}
+/**
+ * Horizontal list of file attachments; collapses to a popover once the
+ * count exceeds `maxInline`.
+ *
+ * @category Inputs
+ * @useCases user message attachments, prompt input previews, chat file row
+ * @keywords files, attachments, file list, popover, chat
+ * @related UiFileItem, UiPopover
+ */
+export interface CkFileItemsListProps {
+    /** Files to render. Order is preserved. */
+    files: CkFileEntry[];
+    /** @default 3 */
+    maxInline?: number;
+    /** @default 'small' */
+    size?: UiFileItemSize;
+    /** Show a remove control on every row. @default false */
+    isRemovable?: boolean;
+    /** Remove control label, forwarded to `UiFileItem`. */
+    removeLabel?: string;
+    /** Disable every row + the collapsed trigger. @default false */
+    disabled?: boolean;
+    /** Visible label on the collapsed trigger. Defaults to `"{n} files"`. */
+    triggerLabel?: string;
+    /** A11y label for the trigger. Falls back to `triggerLabel`, then count. */
+    triggerAriaLabel?: string;
+    /** `aria-label` for the `<ul>` (e.g. `"Attached files"`). */
+    listLabel?: string;
+    /** Extra classes for the popover content (override the default `w-64`). */
+    popoverClass?: string;
+}
+export interface CkFileItemsListEmits {
+    /** Remove control activated. Suppressed for disabled rows. */
+    (event: 'remove', id: CkFileEntry['id']): void;
+    /** Row clicked outside any interactive child. Suppressed for disabled rows. */
+    (event: 'item-click', file: CkFileEntry, originalEvent: MouseEvent): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/components/base/CkFileItemsList/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/base/CkFileItemsList/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/C,+EAA+E;IAC/E,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3E"}

package/dist/components/base/CkHistoryItem/activeIndicator.d.ts

@@ -1,15 +1,5 @@
 /**
- * Shared class string for the left-edge active indicator used by a chat
- * history row.
- *
- * The `::before` pseudo-element is always mounted so CSS has something to
- * transition. At rest it's painted from `scale-x-0` + `opacity-0` with its
- * transform anchored on the left edge (`origin-left`); when the row's
- * `data-active="true"` flips on, the bar paints in from left to right while
- * fading in, using a 200ms linear curve.
- *
- * Kept as a string constant (rather than generated via `cn`) so UnoCSS's
- * static scanner picks up every utility class for atomic CSS generation.
+ * Uses the shared UI library active indicator preflight class.
  */
-export declare const CHAT_HISTORY_ACTIVE_INDICATOR_CLASS = "before:absolute before:z-10 before:top-1/2 before:left-0 before:h-1/2 before:w-0.5 before:-translate-y-1/2 before:origin-left before:scale-x-0 before:rounded-full before:bg-background-accent-default before:opacity-0 before:transition-[transform,opacity] before:duration-200 before:ease-linear before:content-[\"\"] data-[active=true]:before:scale-x-100 data-[active=true]:before:opacity-100";
+export declare const CHAT_HISTORY_ACTIVE_INDICATOR_CLASS = "ui-active-indicator";
 //# sourceMappingURL=activeIndicator.d.ts.map

package/dist/components/base/CkHistoryItem/activeIndicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activeIndicator.d.ts","sourceRoot":"","sources":["../../../../src/components/base/CkHistoryItem/activeIndicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mCAAmC,2YACwV,CAAC"}
+{"version":3,"file":"activeIndicator.d.ts","sourceRoot":"","sources":["../../../../src/components/base/CkHistoryItem/activeIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mCAAmC,wBAAwB,CAAC"}

package/dist/components/base/index.d.ts

@@ -5,6 +5,8 @@ export type { CkConversationLayoutProps } from './CkConversationLayout';
 export { CkCopyMessageActionButton } from './CkCopyMessageActionButton';
 export { CkFeedbackButton } from './CkFeedbackButton';
 export type { CkFeedbackButtonProps, CkFeedbackValue, } from './CkFeedbackButton';
+export { CkFileItemsList } from './CkFileItemsList';
+export type { CkFileEntry, CkFileItemsListProps, CkFileItemsListEmits, } from './CkFileItemsList';
 export { CkHistoryItem } from './CkHistoryItem';
 export type { CkHistoryItemProps, CkHistoryItemEmits } from './CkHistoryItem';
 export { CkHistoryWrapper } from './CkHistoryWrapper';

package/dist/components/base/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/base/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/components/index.d.ts

@@ -1,5 +1,5 @@
-export { CkAgentMessage, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkHistoryItem, CkHistoryWrapper, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './base';
-export type { CkConversationLayoutProps, CkFeedbackButtonProps, CkFeedbackValue, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './base';
+export { CkAgentMessage, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkFileItemsList, CkHistoryItem, CkHistoryWrapper, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './base';
+export type { CkConversationLayoutProps, CkFeedbackButtonProps, CkFeedbackValue, CkFileEntry, CkFileItemsListEmits, CkFileItemsListProps, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './base';
 export { CkConversation, CkHistory, CkInput } from './composed';
 export type { CkConversationProps, CkHistoryEmits, CkHistoryProps, } from './composed';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,QAAQ,CAAC;AAChB,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/components/index.js

@@ -1,21 +1,22 @@
-import { _, a, b, C, c, d, e, f, g, h, i, j, k, l, m, n, o, p } from "../CkInput.vue_vue_type_script_setup_true_lang-C5C09u0z.js";
+import { _, a, b, C, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q } from "../CkInput.vue_vue_type_script_setup_true_lang-CR3lzV0q.js";
 export {
   _ as CkAgentMessage,
   a as CkConversation,
   b as CkConversationLayout,
   C as CkCopyMessageActionButton,
   c as CkFeedbackButton,
-  d as CkHistory,
-  e as CkHistoryItem,
-  f as CkHistoryWrapper,
-  g as CkInput,
-  h as CkMarkdownRenderer,
-  i as CkMessageActionButton,
-  j as CkPromptActionButton,
-  k as CkPromptInput,
-  l as CkPromptInputDisclaimer,
-  m as CkPromptStopButton,
-  n as CkSendIcon,
-  o as CkStopIcon,
-  p as CkUserMessage
+  d as CkFileItemsList,
+  e as CkHistory,
+  f as CkHistoryItem,
+  g as CkHistoryWrapper,
+  h as CkInput,
+  i as CkMarkdownRenderer,
+  j as CkMessageActionButton,
+  k as CkPromptActionButton,
+  l as CkPromptInput,
+  m as CkPromptInputDisclaimer,
+  n as CkPromptStopButton,
+  o as CkSendIcon,
+  p as CkStopIcon,
+  q as CkUserMessage
 };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { useChat, useConversationSessions, useConversations, } from './composabl
 export type { ChatActions, ChatState, ConversationSession, CreateConversationInput, MessageHandler, MutationOptions, UseChatReturn, UseConversationSessionsReturn, UseConversationsOptions, UseConversationsReturn, } from './composables';
 export { SdkError, createDocumentUploadProvider, defaultDocumentUploadConfig, defaultEndpoints, useDocumentUploadWithDefaultConfig, } from './composables/fileUpload';
 export type { DocumentUploadConfig, DocumentUploadProvider, FileEntry, FileStatus, } from './composables/fileUpload';
-export { CkAgentMessage, CkConversation, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkHistory, CkHistoryItem, CkHistoryWrapper, CkInput, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './components';
-export type { CkConversationLayoutProps, CkConversationProps, CkFeedbackButtonProps, CkFeedbackValue, CkHistoryEmits, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './components';
+export { CkAgentMessage, CkConversation, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkFileItemsList, CkHistory, CkHistoryItem, CkHistoryWrapper, CkInput, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './components';
+export type { CkConversationLayoutProps, CkConversationProps, CkFeedbackButtonProps, CkFeedbackValue, CkFileEntry, CkFileItemsListEmits, CkFileItemsListProps, CkHistoryEmits, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './components';
 export type { BaseMessage, Conversation, ConversationTree, MessageContent, MessageContentStatus, MessageReasoningContent, MessageRole, MessageStatus, MessageTextContent, MessageToolContent, TreeMessage, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,UAAU,GACX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,UAAU,GACX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { u } from "./useMessageHandler-ZRC-gIOJ.js";
 import { C, d, p, u as u2, a } from "./useChatKitLabels-ftC52m7f.js";
 import { S, c, d as d2, a as a2, u as u3, b, e, f } from "./index-BLq6_Lt2.js";
-import { _, a as a3, b as b2, C as C2, c as c2, d as d3, e as e2, f as f2, g, h, i, j, k, l, m, n, o, p as p2 } from "./CkInput.vue_vue_type_script_setup_true_lang-C5C09u0z.js";
+import { _, a as a3, b as b2, C as C2, c as c2, d as d3, e as e2, f as f2, g, h, i, j, k, l, m, n, o, p as p2, q } from "./CkInput.vue_vue_type_script_setup_true_lang-CR3lzV0q.js";
 export {
   C as CHAT_KIT_LABELS,
   _ as CkAgentMessage,
@@ -9,19 +9,20 @@ export {
   b2 as CkConversationLayout,
   C2 as CkCopyMessageActionButton,
   c2 as CkFeedbackButton,
-  d3 as CkHistory,
-  e2 as CkHistoryItem,
-  f2 as CkHistoryWrapper,
-  g as CkInput,
-  h as CkMarkdownRenderer,
-  i as CkMessageActionButton,
-  j as CkPromptActionButton,
-  k as CkPromptInput,
-  l as CkPromptInputDisclaimer,
-  m as CkPromptStopButton,
-  n as CkSendIcon,
-  o as CkStopIcon,
-  p2 as CkUserMessage,
+  d3 as CkFileItemsList,
+  e2 as CkHistory,
+  f2 as CkHistoryItem,
+  g as CkHistoryWrapper,
+  h as CkInput,
+  i as CkMarkdownRenderer,
+  j as CkMessageActionButton,
+  k as CkPromptActionButton,
+  l as CkPromptInput,
+  m as CkPromptInputDisclaimer,
+  n as CkPromptStopButton,
+  o as CkSendIcon,
+  p2 as CkStopIcon,
+  q as CkUserMessage,
   S as SdkError,
   c as createDocumentUploadProvider,
   d as defaultChatKitLabels,

package/dist/types.d.ts

@@ -24,11 +24,19 @@ export interface MessageTextContent {
  * Tool invocation triggered by the assistant during its turn. Only the tool
  * name is rendered; arguments and results are intentionally outside the
  * UI-facing model and should be tracked by the host application.
+ *
+ * `text` and `icon` are optional server-provided display hints (sourced from
+ * a `display` block on the wire payload, e.g.
+ * `ResponseOutputTool.display`). When present, the UI is expected to render
+ * the human-readable `text` and the lucide.dev `icon` instead of falling
+ * back to the raw tool `name`.
  */
 export interface MessageToolContent {
     type: 'tool';
     id: string;
     name: string;
+    text?: string;
+    icon?: string;
 }
 /**
  * Chain-of-thought / reasoning segment produced by the assistant. `text` is

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/chat-kit",
-  "version": "1.7.0",
+  "version": "1.10.0",
   "description": "Chat kit package for building chat interfaces with Vue",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,8 +52,7 @@
     "node": ">=20.19.0"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://npm.pkg.github.com"
+    "access": "public"
   },
   "repository": {
     "type": "git",
@@ -72,7 +71,7 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "unified": "^11.0.5",
-    "@aleph-alpha/ui-library": "2.4.3"
+    "@aleph-alpha/ui-library": "2.6.0"
   },
   "devDependencies": {
     "@storybook/addon-a11y": "10.2.17",
@@ -98,7 +97,7 @@
     "vitest": "4.0.15",
     "vue": "^3.5.27",
     "vue-tsc": "^3.2.4",
-    "@aleph-alpha/config-css": "1.1.0"
+    "@aleph-alpha/config-css": "1.2.0"
   },
   "scripts": {
     "build": "vite build && vue-tsc --project tsconfig.build.json --declaration --emitDeclarationOnly --outDir dist",

package/src/adapters/responses-api.spec.ts

@@ -271,6 +271,57 @@ describe('responsesToTree', () => {
     expect(assistant.content[2].type).toBe('text');
   });
 
+  it('forwards `display.text` and `display.icon` from a tool output onto the resulting tool content', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          toolOutput({
+            id: 'tool-1',
+            type: 'mcp_call',
+            name: 'firecrawl_scrape',
+            display: {
+              text: 'Searching the web',
+              icon: 'globe',
+              phase: 'done',
+            },
+          }),
+          assistantOutput('msg-a1', 'Done'),
+        ],
+      }),
+    ]);
+
+    const tool = tree.nodes['msg-a1']!.content[0];
+    expect(tool).toMatchObject({
+      type: 'tool',
+      id: 'tool-1',
+      name: 'firecrawl_scrape',
+      text: 'Searching the web',
+      icon: 'globe',
+    });
+  });
+
+  it('omits `text` / `icon` on tool content when the tool output has no `display` block', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          toolOutput({ id: 'tool-1', type: 'mcp_call', name: 'search' }),
+          assistantOutput('msg-a1', 'Done'),
+        ],
+      }),
+    ]);
+
+    const tool = tree.nodes['msg-a1']!.content[0];
+    expect(tool.type).toBe('tool');
+    if (tool.type === 'tool') {
+      expect(tool.text).toBeUndefined();
+      expect(tool.icon).toBeUndefined();
+    }
+  });
+
   it('creates an assistant node from reasoning / tool outputs even when no message output is present', () => {
     const tree = responsesToTree([
       makeResponse({

package/src/adapters/responses-api.ts

@@ -142,6 +142,23 @@ export type ResponseOutputToolType =
   | 'image_generation_call'
   | 'local_shell_call';
 
+/**
+ * Server-provided rendering hints for a tool invocation. The server emits a
+ * human-readable `text` (e.g. "Searching the web…") and a lucide.dev `icon`
+ * name to display alongside the tool, plus a `phase` describing the current
+ * lifecycle stage so the UI can swap labels/icons as the call progresses.
+ *
+ * Only `'done'` is received in a response today.
+ */
+export interface ResponseOutputToolDisplay {
+  /** Human-readable label to render for the tool (server-controlled). */
+  text: string;
+  /** Lucide.dev icon name to render next to the label. */
+  icon: string;
+  /** Lifecycle phase of the tool call. */
+  phase: 'done';
+}
+
 /**
  * Tool-related output produced during a Responses-API turn. Covers tool
  * discovery (`mcp_list_tools`), invocation (`mcp_call`, `function_call`,
@@ -165,6 +182,12 @@ export interface ResponseOutputTool {
   call_id?: string;
   /** Tool result payload (shape depends on the tool kind). */
   output?: unknown;
+  /**
+   * Optional server-provided display hints (label, icon, phase). When
+   * present, `responsesToTree` forwards `text` and `icon` onto the
+   * resulting `MessageToolContent` so the UI can render them directly.
+   */
+  display?: ResponseOutputToolDisplay;
   [key: string]: unknown;
 }
 
@@ -260,6 +283,18 @@ function textPart(text: string, id?: string): MessageContent {
   return { type: 'text', id: id ?? generateId(), text, status: 'completed' };
 }
 
+// Build a `MessageToolContent` for one tool invocation, forwarding the
+// optional server-provided `display.text` / `display.icon` hints when
+// present so the UI can render them directly.
+function toolPart(out: ResponseOutputTool): MessageContent {
+  return {
+    type: 'tool',
+    id: out.id,
+    name: out.name ?? out.type,
+    ...(out.display ? { text: out.display.text, icon: out.display.icon } : {}),
+  };
+}
+
 // Build the `content` array for one assistant turn from a Responses-API
 // record. Reasoning trails, tool invocations, and visible text all belong to
 // the same turn and are kept in their original wire order so the UI can
@@ -291,11 +326,7 @@ function toAssistantParts(resp: StoredResponse): MessageContent[] {
       case 'mcp_call':
       case 'function_call':
       case 'tool_call': {
-        parts.push({
-          type: 'tool',
-          id: out.id,
-          name: out.name ?? out.type,
-        });
+        parts.push(toolPart(out));
         break;
       }
       default:

package/src/components/base/CkFileItemsList/CkFileItemRow.vue

@@ -0,0 +1,61 @@
+<script setup lang="ts">
+import { UiFileItem, type UiFileItemSize } from '@aleph-alpha/ui-library';
+import type { CkFileEntry } from './types';
+
+// Private row used by `CkFileItemsList` to share the slot fallback between
+// the inline row and the popover list. Not exported from the package.
+defineOptions({
+  name: 'CkFileItemRow',
+  inheritAttrs: false,
+});
+
+defineProps<{
+  file: CkFileEntry;
+  size: UiFileItemSize;
+  isRemovable: boolean;
+  removeLabel: string;
+  disabled: boolean;
+}>();
+
+const emit = defineEmits<{
+  remove: [];
+}>();
+
+// Mirrors the public `item` slot scope on `CkFileItemsList`.
+defineSlots<{
+  default?: (props: {
+    file: CkFileEntry;
+    remove: () => void;
+    size: UiFileItemSize;
+    isRemovable: boolean;
+    removeLabel: string;
+    disabled: boolean;
+  }) => unknown;
+}>();
+</script>
+
+<template>
+  <slot
+    :file="file"
+    :remove="() => emit('remove')"
+    :size="size"
+    :is-removable="isRemovable"
+    :remove-label="removeLabel"
+    :disabled="disabled"
+  >
+    <UiFileItem
+      :filename="file.filename"
+      :type-label="file.typeLabel"
+      :size-label="file.sizeLabel"
+      :progress="file.progress ?? null"
+      :error="file.error ?? null"
+      :media-icon="file.mediaIcon"
+      :media-tone="file.mediaTone"
+      :size="size"
+      :removable="isRemovable && !disabled"
+      :remove-label="removeLabel"
+      :disabled="disabled"
+      @remove="emit('remove')"
+    />
+  </slot>
+</template>

package/src/components/base/CkFileItemsList/CkFileItemsList.spec.ts

@@ -0,0 +1,96 @@
+import { render, screen, within } from '@testing-library/vue';
+import userEvent from '@testing-library/user-event';
+import { describe, expect, it } from 'vitest';
+import CkFileItemsList from './CkFileItemsList.vue';
+import type { CkFileEntry } from './types';
+
+const files: CkFileEntry[] = [
+  { id: 'a', filename: 'report.pdf' },
+  { id: 'b', filename: 'notes.md' },
+  { id: 'c', filename: 'data.csv' },
+  { id: 'd', filename: 'archive.zip' },
+];
+
+describe('CkFileItemsList', () => {
+  it('renders all files inline when count <= maxInline', () => {
+    const { container } = render(CkFileItemsList, {
+      props: { files: files.slice(0, 3) },
+    });
+
+    const list = container.querySelector('[data-slot="file-items-list"]');
+    expect(list).toBeTruthy();
+    expect(list?.querySelectorAll('li')).toHaveLength(3);
+    expect(
+      container.querySelector('[data-slot="file-items-list-trigger"]'),
+    ).toBeNull();
+  });
+
+  it('collapses into a popover trigger when count exceeds maxInline', () => {
+    render(CkFileItemsList, { props: { files } });
+
+    const trigger = screen.getByRole('button', { name: /4 files/i });
+    expect(trigger).toBeInTheDocument();
+    expect(trigger).toHaveTextContent('4 files');
+  });
+
+  it('uses an explicit triggerLabel when provided', () => {
+    render(CkFileItemsList, {
+      props: { files, triggerLabel: '+1 more attachment' },
+    });
+
+    expect(screen.getByRole('button')).toHaveTextContent('+1 more attachment');
+  });
+
+  it('emits remove with the file id from inline items', async () => {
+    const user = userEvent.setup();
+    const { emitted } = render(CkFileItemsList, {
+      props: { files: files.slice(0, 2), isRemovable: true },
+    });
+
+    const list = document.querySelector('[data-slot="file-items-list"]')!;
+    const removeButtons = within(list as HTMLElement).getAllByRole('button', {
+      name: /remove file/i,
+    });
+    await user.click(removeButtons[1]);
+
+    expect(emitted('remove')).toEqual([['b']]);
+  });
+
+  it('hides remove controls by default', () => {
+    render(CkFileItemsList, { props: { files: files.slice(0, 2) } });
+
+    expect(screen.queryByRole('button', { name: /remove file/i })).toBeNull();
+  });
+
+  it('renders a custom row via the `item` scoped slot and forwards remove', async () => {
+    const user = userEvent.setup();
+    const { container, emitted } = render(CkFileItemsList, {
+      props: { files: files.slice(0, 2) },
+      slots: {
+        item: `
+          <template #item="{ file, remove }">
+            <button
+              type="button"
+              data-testid="custom-row"
+              :data-id="file.id"
+              @click="remove"
+            >
+              {{ file.filename }}
+            </button>
+          </template>
+        `,
+      },
+    });
+
+    const rows = container.querySelectorAll<HTMLElement>(
+      '[data-testid="custom-row"]',
+    );
+    expect(rows).toHaveLength(2);
+    expect(rows[0]).toHaveTextContent('report.pdf');
+
+    expect(container.querySelector('[data-slot="file-item"]')).toBeNull();
+
+    await user.click(rows[1]);
+    expect(emitted('remove')).toEqual([['b']]);
+  });
+});