@sybilion/uilib 1.3.12 → 1.3.15

package/dist/esm/components/ui/Chat/ChatChrome/ChatChrome.js

@@ -30,6 +30,9 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
             if (items.length > 0) {
                 setPendingAttachments(prev => [...prev, ...items]);
             }
+        })
+            .catch(() => {
+            // Extraction failed (parse error, size limit, etc.); skip staging.
         })
             .finally(() => setIsExtractingAttachments(false));
     }, [allowPdfAttachments, promptBusy]);
@@ -65,7 +68,7 @@ function ChatChrome({ showResizeHandle, resizeHandle, onClose, isEmpty, renderPr
     }, [isEmpty, messages.length]);
     return (jsxs("div", { className: S.root, children: [showResizeHandle && resizeHandle ? (jsx(PanelResizeHandle, { edge: "leading", isActive: resizeHandle.isActive, startWidthPx: resizeHandle.startWidthPx, getShellWidth: resizeHandle.getShellWidth, onDragWidth: resizeHandle.onDragWidth, onDragComplete: resizeHandle.onDragComplete, className: cn(SidebarStem.sidebarResizeHandle, S.chatResizeHandle) })) : null, jsx("div", { className: S.panelHeader, children: onClose ? (jsx(Button, { type: "button", variant: "ghost", icon: true, className: S.panelClose, "aria-label": "Close chat", onClick: onClose, children: jsx(X, { className: "size-4" }) })) : null }), jsxs("div", { className: S.content, children: [attachmentsDropzoneEnabled ? (jsx(DropZone, { accept: attachmentAccept, label: "Drop text files to attach", multiple: true, ghost: true, overlayScope: "container", disabled: promptBusy, className: S.attachmentDropzone, onFiles: handleAttachmentFiles })) : null, jsxs(Chat, { isEmpty: isEmpty, scopeId: effectiveScopeId, onChatDeleted: onChatDeleted, children: [isEmpty ? (jsxs(Fragment, { children: [jsx(Chat.EmptyState, { ...emptyState }), renderPresets('fixed')] })) : (jsx("div", { className: S.scrollWrapper, children: jsxs(Scroll, { y: true, yScrollbarClassName: S.scrollbar, className: S.scroll, innerClassName: S.scrollInner, offset: { y: { before: 56, after: 180 } }, fadeSize: "m", autoHide: true, ref: scrollRef, children: [messages.map((msg, index, arr) => {
                                             const isLast = index === arr.length - 1;
-                                            return (jsx(Chat.Message, { role: msg.role, text: msg.text, userCsvAttachment: msg.userCsvAttachment, onQuickReply: onQuickReply, suppressedQuickReplyKeys: suppressedQuickReplyKeys, quickReplyDisabled: isLoading, isLastMessage: isLast, scriptContinue: isLast && scriptContinueLabel
+                                            return (jsx(Chat.Message, { role: msg.role, text: msg.text, userTextFileAttachments: msg.userTextFileAttachments, onQuickReply: onQuickReply, suppressedQuickReplyKeys: suppressedQuickReplyKeys, quickReplyDisabled: isLoading, isLastMessage: isLast, scriptContinue: isLast && scriptContinueLabel
                                                     ? { label: scriptContinueLabel }
                                                     : undefined, onScriptContinue: isLast && scriptContinueLabel
                                                     ? onScriptContinue

package/dist/esm/components/ui/Chat/ChatMessage/ChatMessage.js

@@ -3,14 +3,18 @@ import cn from 'classnames';
 import { InteractiveContent } from '../../InteractiveContent/InteractiveContent.js';
 import { TextShimmer } from '../../TextShimmer/TextShimmer.js';
 import { MessageRole, GENERATING_DASHBOARD_SYSTEM_TEXT } from '../Chat.types.js';
+import { userTextFileAttachmentsFromMessage } from '../userTextFileAttachments.js';
 import { AgentMessageContent } from './AgentMessageContent.js';
 import S from './ChatMessage.styl.js';
-import { UserCsvAttachmentBubble } from './UserCsvAttachmentBubble.js';
+import { UserTextFileAttachmentBubble } from './UserTextFileAttachmentBubble.js';
 
-function ChatMessage({ role, text, userCsvAttachment, onQuickReply, suppressedQuickReplyKeys, quickReplyDisabled, isLastMessage = true, scriptContinue, onScriptContinue, renderMessageChart, }) {
+function ChatMessage({ role, text, userTextFileAttachments, onQuickReply, suppressedQuickReplyKeys, quickReplyDisabled, isLastMessage = true, scriptContinue, onScriptContinue, renderMessageChart, }) {
+    const fileAttachments = userTextFileAttachmentsFromMessage({
+        userTextFileAttachments,
+    });
     const isAssistant = role === MessageRole.ASSISTANT;
     const isSystem = role === MessageRole.SYSTEM;
-    return (jsx("div", { className: cn(S.root, S[`role-${role}`]), children: isSystem ? (jsx("div", { className: S.text, children: text === GENERATING_DASHBOARD_SYSTEM_TEXT ? (jsx(TextShimmer, { as: "span", children: text })) : (text) })) : isAssistant ? (jsx(AgentMessageContent, { text: text, onQuickReply: onQuickReply, suppressedQuickReplyKeys: suppressedQuickReplyKeys, quickReplyDisabled: quickReplyDisabled, isLastMessage: isLastMessage, scriptContinue: scriptContinue, onScriptContinue: onScriptContinue, renderMessageChart: renderMessageChart })) : (jsxs("div", { className: S.userColumn, children: [jsx("div", { className: S.text, children: jsx(InteractiveContent, { text: text }) }), userCsvAttachment ? (jsx(UserCsvAttachmentBubble, { attachment: userCsvAttachment })) : null] })) }));
+    return (jsx("div", { className: cn(S.root, S[`role-${role}`]), children: isSystem ? (jsx("div", { className: S.text, children: text === GENERATING_DASHBOARD_SYSTEM_TEXT ? (jsx(TextShimmer, { as: "span", children: text })) : (text) })) : isAssistant ? (jsx(AgentMessageContent, { text: text, onQuickReply: onQuickReply, suppressedQuickReplyKeys: suppressedQuickReplyKeys, quickReplyDisabled: quickReplyDisabled, isLastMessage: isLastMessage, scriptContinue: scriptContinue, onScriptContinue: onScriptContinue, renderMessageChart: renderMessageChart })) : (jsxs("div", { className: S.userColumn, children: [jsx("div", { className: S.text, children: jsx(InteractiveContent, { text: text }) }), fileAttachments.map(attachment => (jsx(UserTextFileAttachmentBubble, { attachment: attachment }, `${attachment.displayName}:${attachment.filename}`)))] })) }));
 }
 
 export { ChatMessage };

package/dist/esm/components/ui/Chat/ChatMessage/UserTextFileAttachmentBubble.js

@@ -0,0 +1,39 @@
+import { jsx } from 'react/jsx-runtime';
+import { FileChip } from '../../FileChip/FileChip.js';
+import { downloadTextFile } from '../../../../utils/downloadTextFile.js';
+
+function formatFromFilename(filename) {
+    const lower = filename.toLowerCase();
+    if (lower.endsWith('.csv'))
+        return 'csv';
+    if (lower.endsWith('.pdf'))
+        return 'pdf';
+    if (lower.endsWith('.xlsx'))
+        return 'text';
+    return 'text';
+}
+function mimeForFormat(format) {
+    if (format === 'csv')
+        return 'text/csv;charset=utf-8';
+    if (format === 'pdf')
+        return 'application/pdf';
+    return 'text/plain;charset=utf-8';
+}
+function hintForFormat(format, filename) {
+    const lower = filename.toLowerCase();
+    if (format === 'csv')
+        return 'Download .CSV file';
+    if (format === 'pdf')
+        return 'Download file';
+    if (lower.endsWith('.docx'))
+        return 'Download Word document';
+    if (lower.endsWith('.xlsx'))
+        return 'Download spreadsheet';
+    return 'Download text file';
+}
+function UserTextFileAttachmentBubble({ attachment, }) {
+    const format = formatFromFilename(attachment.filename);
+    return (jsx(FileChip, { name: attachment.displayName, format: format, hint: hintForFormat(format, attachment.filename), onClick: () => downloadTextFile(attachment.content, attachment.filename, mimeForFormat(format)) }));
+}
+
+export { UserTextFileAttachmentBubble };

package/dist/esm/components/ui/Chat/ChatPrompt/ChatPromptAttachments.js

@@ -5,7 +5,13 @@ import S from './ChatPrompt.styl.js';
 function ChatPromptAttachments({ attachments, onRemove, disabled = false, }) {
     if (attachments.length === 0)
         return null;
-    return (jsx("div", { className: S.attachments, children: attachments.map((item, index) => (jsx(FileChip, { className: S.attachmentItem, name: item.file.name, format: item.kind === 'pdf' ? 'pdf' : 'text', hint: item.kind === 'pdf' ? 'PDF' : 'Text file', onRemove: () => onRemove(index), disabled: disabled }, `${item.file.name}-${index}`))) }));
+    return (jsx("div", { className: S.attachments, children: attachments.map((item, index) => (jsx(FileChip, { className: S.attachmentItem, name: item.file.name, format: item.kind === 'pdf' ? 'pdf' : 'text', hint: item.kind === 'pdf'
+                ? 'PDF'
+                : item.kind === 'docx'
+                    ? 'Word document'
+                    : item.kind === 'xlsx'
+                        ? 'Spreadsheet'
+                        : 'Text file', onRemove: () => onRemove(index), disabled: disabled }, `${item.file.name}-${index}`))) }));
 }
 
 export { ChatPromptAttachments };

package/dist/esm/components/ui/Chat/ChatSheet/ChatSheet.js

@@ -4,7 +4,7 @@ import { Button } from '../../Button/Button.js';
 import { ChatChrome } from '../ChatChrome/ChatChrome.js';
 import { useChatPanelChromeModel } from './useChatPanelChromeModel.js';
 
-function ChatSheet({ triggerLabel = 'Open Chat', triggerAriaLabel, actionsRef, renderTrigger, presets, scopeId, onMessage, onScriptComplete, onGenerateDashboard, renderMessageChart, emptyState, inline = false, }) {
+function ChatSheet({ triggerLabel = 'Open Chat', triggerAriaLabel, actionsRef, renderTrigger, presets, scopeId, onMessage, onScriptComplete, onGenerateDashboard, renderMessageChart, emptyState, allowedAttachments, allowPdfAttachments, onAttachmentsDropped, inline = false, }) {
     const model = useChatPanelChromeModel({
         embedAsPage: inline,
         presets,
@@ -14,6 +14,9 @@ function ChatSheet({ triggerLabel = 'Open Chat', triggerAriaLabel, actionsRef, r
         onGenerateDashboard,
         renderMessageChart,
         emptyState,
+        allowedAttachments,
+        allowPdfAttachments,
+        onAttachmentsDropped,
     });
     if (actionsRef) {
         actionsRef.current = {

package/dist/esm/components/ui/Chat/ChatSheet/useChatPanelChromeModel.js

@@ -2,6 +2,7 @@ import { jsx } from 'react/jsx-runtime';
 import { useState, useRef, useEffect, useMemo, useCallback } from 'react';
 import { MessageRole, GENERATING_DASHBOARD_SYSTEM_TEXT } from '../Chat.types.js';
 import { isGraphIntakeAssistantStepComplete, matchUserTextToQuickReply, parseScriptLine, textHasQuickReplyMarkers, branchKeysUsedFromChatHistory, branchKeysUsedByUserMessages, extractQuickReplyLabelKeyPairsFromText, entryBranchKeyBeforeLastAssistant, isPresetScriptGraph, branchesFromPresetScriptGraph } from '../ChatMessage/presetScript.js';
+import { buildChatSendMessagePayload, displayTextFromSendPayload } from '../buildChatSendMessagePayload.js';
 import { usedPresetIdsFromMessages, formatChatTranscript } from '../chat-preset-utils.js';
 import { useChatsForScopeId, useChat, useChatOutboundPending, isChatEmpty } from '../../../../contexts/chat-context.js';
 import useEvent from '../../../../hooks/useEvent.js';
@@ -296,10 +297,11 @@ function useChatPanelChromeModel({ embedAsPage, presets, scopeId, onMessage, onS
         onMessage,
         onScriptComplete,
     ]);
-    const handlePromptSubmit = useCallback(async (message) => {
+    const handlePromptSubmit = useCallback(async (message, attachments) => {
         const chatId = currentChatId;
         if (!chatId)
             return;
+        const stagedAttachments = attachments ?? [];
         const quickBranches = quickReplyBranchesByChat[chatId];
         const graphActive = Boolean(quickBranches && Object.keys(quickBranches).length > 0);
         const intake = intakeByChatId[chatId];
@@ -402,8 +404,9 @@ function useChatPanelChromeModel({ embedAsPage, presets, scopeId, onMessage, onS
         try {
             if (chatId)
                 endLocalDemoFlow(chatId);
-            await sendMessage(message);
-            onMessage?.(message);
+            const payload = buildChatSendMessagePayload(message, stagedAttachments);
+            await sendMessage(payload);
+            onMessage?.(displayTextFromSendPayload(payload));
         }
         catch (error) {
             logger.error('Error sending chat message:', error);

package/dist/esm/components/ui/Chat/buildChatSendMessagePayload.js

@@ -0,0 +1,70 @@
+import { sanitizeAttachmentFilename } from './sanitizeAttachmentFilename.js';
+
+function defaultExtForAttachment(item) {
+    const name = item.file.name.toLowerCase();
+    if (item.kind === 'pdf' || name.endsWith('.pdf'))
+        return 'pdf';
+    if (item.kind === 'docx' || name.endsWith('.docx'))
+        return 'docx';
+    if (item.kind === 'xlsx' || name.endsWith('.xlsx'))
+        return 'xlsx';
+    if (name.endsWith('.csv'))
+        return 'csv';
+    if (name.endsWith('.json'))
+        return 'json';
+    if (name.endsWith('.md') || name.endsWith('.markdown'))
+        return 'md';
+    if (name.endsWith('.html') || name.endsWith('.htm'))
+        return 'html';
+    if (name.endsWith('.xml'))
+        return 'xml';
+    if (name.endsWith('.yaml') || name.endsWith('.yml'))
+        return 'yaml';
+    if (name.endsWith('.tsv'))
+        return 'tsv';
+    if (name.endsWith('.ics'))
+        return 'ics';
+    return 'txt';
+}
+function dropItemToUserAttachment(item) {
+    const ext = defaultExtForAttachment(item);
+    return {
+        displayName: item.file.name,
+        filename: sanitizeAttachmentFilename(item.file.name, ext),
+        content: item.text,
+    };
+}
+function buildApiMessage(displayText, attachments) {
+    const parts = [
+        displayText,
+        ...attachments.map(item => item.text.trim()).filter(Boolean),
+    ].filter(Boolean);
+    return parts.join('\n\n');
+}
+/** Resolve file attachments on a send payload. */
+function normalizeUserTextFileAttachments(payload) {
+    return payload.userTextFileAttachments ?? [];
+}
+/**
+ * Build `sendMessage` input from composer text and staged drop items.
+ * Returns a plain string when there are no attachments.
+ */
+function buildChatSendMessagePayload(displayText, attachments) {
+    const trimmed = displayText.trim();
+    if (attachments.length === 0) {
+        return trimmed;
+    }
+    const userTextFileAttachments = attachments.map(dropItemToUserAttachment);
+    const resolvedDisplayText = trimmed.length > 0 ? trimmed : userTextFileAttachments[0].displayName;
+    return {
+        apiMessage: buildApiMessage(resolvedDisplayText, attachments),
+        displayText: resolvedDisplayText,
+        userTextFileAttachments,
+    };
+}
+/** Display text from a string or structured send payload. */
+function displayTextFromSendPayload(message) {
+    return typeof message === 'string' ? message : message.displayText;
+}
+
+export { buildChatSendMessagePayload, displayTextFromSendPayload, normalizeUserTextFileAttachments };

package/dist/esm/components/ui/Chat/chatAttachmentAccept.js

@@ -24,6 +24,10 @@ const TEXT_ATTACHMENT_ACCEPT_PARTS = [
     '.tsv',
     'text/calendar',
     '.ics',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.docx',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.xlsx',
 ];
 const PDF_ATTACHMENT_ACCEPT_PARTS = ['application/pdf', '.pdf'];
 const TEXT_ATTACHMENT_ACCEPT_SET = new Set(TEXT_ATTACHMENT_ACCEPT_PARTS.map(part => part.toLowerCase()));
@@ -46,9 +50,24 @@ function isPdfFile(file) {
         return true;
     return file.name.toLowerCase().endsWith('.pdf');
 }
+function isDocxFile(file) {
+    const type = file.type.toLowerCase();
+    if (type ===
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document') {
+        return true;
+    }
+    return file.name.toLowerCase().endsWith('.docx');
+}
+function isXlsxFile(file) {
+    const type = file.type.toLowerCase();
+    if (type === 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet') {
+        return true;
+    }
+    return file.name.toLowerCase().endsWith('.xlsx');
+}
 function isAttachmentsDropzoneEnabled(allowedAttachments, allowPdfAttachments) {
     return (filterToTextAttachments(allowedAttachments).length > 0 ||
         Boolean(allowPdfAttachments));
 }
 
-export { PDF_ATTACHMENT_ACCEPT_PARTS, TEXT_ATTACHMENT_ACCEPT_PARTS, buildAcceptAttr, filterToTextAttachments, isAttachmentsDropzoneEnabled, isPdfFile };
+export { PDF_ATTACHMENT_ACCEPT_PARTS, TEXT_ATTACHMENT_ACCEPT_PARTS, buildAcceptAttr, filterToTextAttachments, isAttachmentsDropzoneEnabled, isDocxFile, isPdfFile, isXlsxFile };

package/dist/esm/components/ui/Chat/chatAttachmentExtract.js

@@ -1,5 +1,7 @@
-import { isPdfFile } from './chatAttachmentAccept.js';
+import { isPdfFile, isDocxFile, isXlsxFile } from './chatAttachmentAccept.js';
+import { extractDocxFileToText } from './chatDocxExtract.js';
 import { extractPdfFileToText } from './chatPdfExtract.js';
+import { extractXlsxFileToText } from './chatXlsxExtract.js';
 
 function readTextFile(file) {
     return new Promise((resolve, reject) => {
@@ -17,6 +19,14 @@ async function extractChatAttachmentItems(files, allowPdfAttachments) {
             const text = await extractPdfFileToText(file);
             return { file, text, kind: 'pdf' };
         }
+        if (isDocxFile(file)) {
+            const text = await extractDocxFileToText(file);
+            return { file, text, kind: 'docx' };
+        }
+        if (isXlsxFile(file)) {
+            const text = await extractXlsxFileToText(file);
+            return { file, text, kind: 'xlsx' };
+        }
         const text = await readTextFile(file);
         return { file, text, kind: 'text' };
     }));

package/dist/esm/components/ui/Chat/chatDocxExtract.js

@@ -0,0 +1,17 @@
+/** Best-effort plain text from DOCX via mammoth (loaded on demand). */
+async function extractDocxFileToText(file) {
+    const mammoth = await import('mammoth');
+    const result = await mammoth.extractRawText({
+        arrayBuffer: await file.arrayBuffer(),
+    });
+    const errors = result.messages.filter(m => m.type === 'error');
+    if (errors.length > 0) {
+        const detail = errors.map(m => m.message).join('; ');
+        throw new Error(detail
+            ? `Failed to read ${file.name}: ${detail}`
+            : `Failed to read ${file.name}`);
+    }
+    return result.value.trim();
+}
+
+export { extractDocxFileToText };

package/dist/esm/components/ui/Chat/chatXlsxExtract.js

@@ -0,0 +1,34 @@
+const MAX_FILE_BYTES = 10 * 1024 * 1024;
+const MAX_SHEETS = 20;
+const MAX_CSV_CHARS_PER_SHEET = 500_000;
+function truncateCsv(csv) {
+    if (csv.length <= MAX_CSV_CHARS_PER_SHEET)
+        return csv;
+    return `${csv.slice(0, MAX_CSV_CHARS_PER_SHEET).trimEnd()}…`;
+}
+/** Best-effort plain text from XLSX; one CSV block per sheet (xlsx loaded on demand). */
+async function extractXlsxFileToText(file) {
+    const buffer = new Uint8Array(await file.arrayBuffer());
+    if (buffer.byteLength > MAX_FILE_BYTES) {
+        throw new Error(`${file.name} is too large (max ${MAX_FILE_BYTES / (1024 * 1024)} MB)`);
+    }
+    const XLSX = await import('xlsx');
+    const workbook = XLSX.read(buffer, { type: 'array' });
+    const sheetNames = workbook.SheetNames.slice(0, MAX_SHEETS);
+    const sheetTexts = [];
+    for (const sheetName of sheetNames) {
+        const sheet = workbook.Sheets[sheetName];
+        if (!sheet)
+            continue;
+        const csv = truncateCsv(XLSX.utils.sheet_to_csv(sheet, { blankrows: false }).trim());
+        if (csv) {
+            sheetTexts.push(`## Sheet ${sheetName}\n\n${csv}`);
+        }
+    }
+    if (workbook.SheetNames.length > MAX_SHEETS) {
+        sheetTexts.push(`_(Only the first ${MAX_SHEETS} of ${workbook.SheetNames.length} sheets were included.)_`);
+    }
+    return sheetTexts.join('\n\n');
+}
+
+export { extractXlsxFileToText };

package/dist/esm/components/ui/Chat/sanitizeAttachmentFilename.js

@@ -0,0 +1,14 @@
+/** Safe download filename from a display title or original file name. */
+function sanitizeAttachmentFilename(displayTitle, defaultExt = 'txt') {
+    const cleaned = displayTitle
+        .replace(/[/\\?%*:|"<>]/g, '-')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+    const base = cleaned.length > 0 ? cleaned : 'attachment';
+    const ext = defaultExt.startsWith('.') ? defaultExt : `.${defaultExt}`;
+    const pattern = new RegExp(`${ext.replace('.', '\\.')}$`, 'i');
+    return pattern.test(base) ? base : `${base}${ext}`;
+}
+
+export { sanitizeAttachmentFilename };

package/dist/esm/components/ui/Chat/userTextFileAttachments.js

@@ -0,0 +1,6 @@
+/** File attachments on a stored message. */
+function userTextFileAttachmentsFromMessage(message) {
+    return message.userTextFileAttachments ?? [];
+}
+
+export { userTextFileAttachmentsFromMessage };

package/dist/esm/contexts/chat-context.js

@@ -1,6 +1,7 @@
 import { jsx } from 'react/jsx-runtime';
 import { createContext, useState, useCallback, useEffect, useContext, useMemo } from 'react';
 import { MessageRole } from '../components/ui/Chat/Chat.types.js';
+import { normalizeUserTextFileAttachments } from '../components/ui/Chat/buildChatSendMessagePayload.js';
 import { stripJsonDashboardFences } from '../lib/dashboard-spec/stripJsonDashboardFences.js';
 import { LS } from '@homecode/ui';
 
@@ -181,13 +182,17 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
             return undefined;
         addScopeIdToRegistry(scopeId);
         const storedText = stripJsonDashboardFences(text);
-        const attachment = role === MessageRole.USER ? options?.userCsvAttachment : undefined;
+        const attachments = role === MessageRole.USER
+            ? options?.userTextFileAttachments
+            : undefined;
         const newMessage = {
             id: `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
             role,
             text: storedText,
             timestamp: Date.now(),
-            ...(attachment ? { userCsvAttachment: attachment } : {}),
+            ...(attachments?.length
+                ? { userTextFileAttachments: attachments }
+                : {}),
         };
         setChats(prev => {
             const scopeChats = prev[scopeId] ?? [];
@@ -232,7 +237,7 @@ function ChatProvider({ children, userSwitchKey, sendChatMessage: sendChatMessag
         }
         else {
             addMessage(scopeId, targetChatId, MessageRole.USER, message.displayText, {
-                userCsvAttachment: message.userCsvAttachment,
+                userTextFileAttachments: normalizeUserTextFileAttachments(message),
             });
         }
         const pendingChatSessionId = targetChatId;

package/dist/esm/index.js

@@ -23,6 +23,8 @@ export { Chat } from './components/ui/Chat/Chat.js';
 export { usedPresetIdsFromMessages } from './components/ui/Chat/chat-preset-utils.js';
 export { ChatChrome } from './components/ui/Chat/ChatChrome/ChatChrome.js';
 export { TEXT_ATTACHMENT_ACCEPT_PARTS, filterToTextAttachments } from './components/ui/Chat/chatAttachmentAccept.js';
+export { buildChatSendMessagePayload, displayTextFromSendPayload, normalizeUserTextFileAttachments } from './components/ui/Chat/buildChatSendMessagePayload.js';
+export { sanitizeAttachmentFilename } from './components/ui/Chat/sanitizeAttachmentFilename.js';
 export { ChatSheet } from './components/ui/Chat/ChatSheet/ChatSheet.js';
 export { useChatPanelChromeModel } from './components/ui/Chat/ChatSheet/useChatPanelChromeModel.js';
 export { ChatMessage } from './components/ui/Chat/ChatMessage/ChatMessage.js';

package/dist/esm/types/src/components/ui/Chat/Chat.types.d.ts

@@ -7,24 +7,24 @@ export declare enum MessageRole {
 }
 /** System placeholder while dashboard generation runs (must match ChatSheet `addMessage` text). */
 export declare const GENERATING_DASHBOARD_SYSTEM_TEXT = "Generating dashboard\u2026";
-/** USER-only: sample CSV attached to a preset message; shown as a file row + client-side download. */
-export type UserCsvAttachment = {
+/** USER-only: text file attached to a message; shown as downloadable file row(s). */
+export type UserTextFileAttachment = {
     displayName: string;
     filename: string;
     content: string;
 };
-/** Send full text to the chat API while showing `displayText` + optional CSV attachment in the UI. */
+/** Send full text to the chat API while showing `displayText` + optional file attachment(s) in the UI. */
 export type ChatSendMessagePayload = {
     apiMessage: string;
     displayText: string;
-    userCsvAttachment?: UserCsvAttachment;
+    userTextFileAttachments?: UserTextFileAttachment[];
 };
 export interface Message {
     id: string;
     role: MessageRole;
     text: string;
     timestamp: number;
-    userCsvAttachment?: UserCsvAttachment;
+    userTextFileAttachments?: UserTextFileAttachment[];
 }
 export interface Chat {
     session_id: string;
@@ -59,9 +59,9 @@ export type ScriptCompletePayload = {
 };
 export type ChatAttachmentDropItem = {
     file: File;
-    /** UTF-8 text for native text files; PDF yields extracted text. */
+    /** UTF-8 text for native text files; PDF/DOCX/XLSX yield extracted text. */
     text: string;
-    kind: 'text' | 'pdf';
+    kind: 'text' | 'pdf' | 'docx' | 'xlsx';
 };
 export interface ChatPromptProps {
     className?: string;
@@ -85,7 +85,7 @@ export interface ChatPromptProps {
 export interface ChatMessageProps {
     role: MessageRole;
     text: string;
-    userCsvAttachment?: UserCsvAttachment;
+    userTextFileAttachments?: UserTextFileAttachment[];
     onQuickReply?: (branchKey: string, displayLabel: string) => void;
     /** Branch keys already taken (e.g. from chat history); hide quick-reply buttons for these. */
     suppressedQuickReplyKeys?: ReadonlySet<string>;

package/dist/esm/types/src/components/ui/Chat/ChatMessage/ChatMessage.d.ts

@@ -1,2 +1,2 @@
 import { type ChatMessageProps } from '../Chat.types';
-export declare function ChatMessage({ role, text, userCsvAttachment, onQuickReply, suppressedQuickReplyKeys, quickReplyDisabled, isLastMessage, scriptContinue, onScriptContinue, renderMessageChart, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatMessage({ role, text, userTextFileAttachments, onQuickReply, suppressedQuickReplyKeys, quickReplyDisabled, isLastMessage, scriptContinue, onScriptContinue, renderMessageChart, }: ChatMessageProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/types/src/components/ui/Chat/ChatMessage/UserTextFileAttachmentBubble.d.ts

@@ -0,0 +1,4 @@
+import type { UserTextFileAttachment } from '../Chat.types';
+export declare function UserTextFileAttachmentBubble({ attachment, }: {
+    attachment: UserTextFileAttachment;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/esm/types/src/components/ui/Chat/ChatSheet/ChatSheet.d.ts

@@ -19,4 +19,4 @@ export interface ChatSheetProps extends Omit<UseChatPanelChromeModelInput, 'embe
      */
     inline?: boolean;
 }
-export declare function ChatSheet({ triggerLabel, triggerAriaLabel, actionsRef, renderTrigger, presets, scopeId, onMessage, onScriptComplete, onGenerateDashboard, renderMessageChart, emptyState, inline, }: ChatSheetProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChatSheet({ triggerLabel, triggerAriaLabel, actionsRef, renderTrigger, presets, scopeId, onMessage, onScriptComplete, onGenerateDashboard, renderMessageChart, emptyState, allowedAttachments, allowPdfAttachments, onAttachmentsDropped, inline, }: ChatSheetProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/types/src/components/ui/Chat/buildChatSendMessagePayload.d.ts

@@ -0,0 +1,10 @@
+import type { ChatAttachmentDropItem, ChatSendMessagePayload, UserTextFileAttachment } from './Chat.types';
+/** Resolve file attachments on a send payload. */
+export declare function normalizeUserTextFileAttachments(payload: ChatSendMessagePayload): UserTextFileAttachment[];
+/**
+ * Build `sendMessage` input from composer text and staged drop items.
+ * Returns a plain string when there are no attachments.
+ */
+export declare function buildChatSendMessagePayload(displayText: string, attachments: readonly ChatAttachmentDropItem[]): string | ChatSendMessagePayload;
+/** Display text from a string or structured send payload. */
+export declare function displayTextFromSendPayload(message: string | ChatSendMessagePayload): string;

package/dist/esm/types/src/components/ui/Chat/buildChatSendMessagePayload.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/src/components/ui/Chat/chatAttachmentAccept.d.ts

@@ -1,8 +1,10 @@
 /** MIME types and extensions accepted for chat text attachments. */
-export declare const TEXT_ATTACHMENT_ACCEPT_PARTS: readonly ["text/plain", ".txt", "text/csv", ".csv", "text/markdown", ".md", ".markdown", "application/json", ".json", "text/html", ".html", ".htm", "text/xml", "application/xml", ".xml", "text/yaml", "application/yaml", "application/x-yaml", ".yaml", ".yml", "text/tab-separated-values", ".tsv", "text/calendar", ".ics"];
+export declare const TEXT_ATTACHMENT_ACCEPT_PARTS: readonly ["text/plain", ".txt", "text/csv", ".csv", "text/markdown", ".md", ".markdown", "application/json", ".json", "text/html", ".html", ".htm", "text/xml", "application/xml", ".xml", "text/yaml", "application/yaml", "application/x-yaml", ".yaml", ".yml", "text/tab-separated-values", ".tsv", "text/calendar", ".ics", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", ".docx", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", ".xlsx"];
 export declare const PDF_ATTACHMENT_ACCEPT_PARTS: readonly ["application/pdf", ".pdf"];
 /** Keep only tokens from `parts` that appear in the text attachment allowlist. */
 export declare function filterToTextAttachments(parts: readonly string[] | undefined): string[];
 export declare function buildAcceptAttr(filteredTextParts: readonly string[], allowPdf: boolean): string;
 export declare function isPdfFile(file: File): boolean;
+export declare function isDocxFile(file: File): boolean;
+export declare function isXlsxFile(file: File): boolean;
 export declare function isAttachmentsDropzoneEnabled(allowedAttachments: readonly string[] | undefined, allowPdfAttachments: boolean | undefined): boolean;

package/dist/esm/types/src/components/ui/Chat/chatAttachmentAccept.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/src/components/ui/Chat/chatDocxExtract.d.ts

@@ -0,0 +1,2 @@
+/** Best-effort plain text from DOCX via mammoth (loaded on demand). */
+export declare function extractDocxFileToText(file: File): Promise<string>;

package/dist/esm/types/src/components/ui/Chat/chatDocxExtract.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/src/components/ui/Chat/chatXlsxExtract.d.ts

@@ -0,0 +1,2 @@
+/** Best-effort plain text from XLSX; one CSV block per sheet (xlsx loaded on demand). */
+export declare function extractXlsxFileToText(file: File): Promise<string>;

package/dist/esm/types/src/components/ui/Chat/chatXlsxExtract.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/types/src/components/ui/Chat/index.d.ts

@@ -3,6 +3,8 @@ export { usedPresetIdsFromMessages } from './chat-preset-utils';
 export { ChatChrome } from './ChatChrome';
 export type { ChatChromeProps, ChatChromeResizeHandleConfig, } from './ChatChrome';
 export { TEXT_ATTACHMENT_ACCEPT_PARTS, filterToTextAttachments, } from './chatAttachmentAccept';
+export { buildChatSendMessagePayload, displayTextFromSendPayload, normalizeUserTextFileAttachments, } from './buildChatSendMessagePayload';
+export { sanitizeAttachmentFilename } from './sanitizeAttachmentFilename';
 export { ChatSheet } from './ChatSheet/ChatSheet';
 export { useChatPanelChromeModel } from './ChatSheet/useChatPanelChromeModel';
 export type { ChatSheetActions, ChatSheetProps } from './ChatSheet/ChatSheet';
@@ -10,6 +12,6 @@ export type { UseChatPanelChromeModelInput, UseChatPanelChromeModelResult, } fro
 export { ChatMessage } from './ChatMessage';
 export { ChatPrompt } from './ChatPrompt';
 export { ChatPresets } from './ChatPresets';
-export type { Chat as ChatType, ChatAttachmentDropItem, ChatSendMessagePayload, ChatProps, ChatPreset as ChatPresetType, Message, UserCsvAttachment, } from './Chat.types';
+export type { Chat as ChatType, ChatAttachmentDropItem, ChatSendMessagePayload, ChatProps, ChatPreset as ChatPresetType, Message, UserTextFileAttachment, } from './Chat.types';
 export { MessageRole } from './Chat.types';
 export { CsvIcon } from '../../icons/CsvIcon/CsvIcon';

package/dist/esm/types/src/components/ui/Chat/sanitizeAttachmentFilename.d.ts

@@ -0,0 +1,2 @@
+/** Safe download filename from a display title or original file name. */
+export declare function sanitizeAttachmentFilename(displayTitle: string, defaultExt?: string): string;

package/dist/esm/types/src/components/ui/Chat/userTextFileAttachments.d.ts

@@ -0,0 +1,3 @@
+import type { Message, UserTextFileAttachment } from './Chat.types';
+/** File attachments on a stored message. */
+export declare function userTextFileAttachmentsFromMessage(message: Pick<Message, 'userTextFileAttachments'>): UserTextFileAttachment[];

package/dist/esm/types/src/contexts/chat-context.d.ts

@@ -1,10 +1,10 @@
 import { ReactNode } from 'react';
-import { type Chat, type ChatSendMessagePayload, MessageRole, type UserCsvAttachment } from '#uilib/components/ui/Chat/Chat.types';
+import { type Chat, type ChatSendMessagePayload, MessageRole, type UserTextFileAttachment } from '#uilib/components/ui/Chat/Chat.types';
 import type { ChatResponse } from '#uilib/types/chat-api.types';
 export type SendChatMessageFn = (message: string, targetChatId: string) => Promise<ChatResponse>;
-export type { ChatSendMessagePayload, UserCsvAttachment, } from '#uilib/components/ui/Chat/Chat.types';
+export type { ChatSendMessagePayload, UserTextFileAttachment, } from '#uilib/components/ui/Chat/Chat.types';
 export type AddChatMessageOptions = {
-    userCsvAttachment?: UserCsvAttachment;
+    userTextFileAttachments?: UserTextFileAttachment[];
 };
 export interface ChatContextType {
     /** Returns the new session id, or undefined if no user / not created. */

package/dist/esm/types/tests/setup.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sybilion/uilib",
-  "version": "1.3.12",
+  "version": "1.3.15",
   "description": "Sybilion Design System — React UI components (Webpack + Stylus)",
   "publishConfig": {
     "access": "public",
@@ -102,6 +102,7 @@
     "classnames": "^2.3.2",
     "lightweight-charts": "^5.0.9",
     "lucide-react": "^0.546.0",
+    "mammoth": "^1.9.0",
     "motion": "^12.23.12",
     "pdfjs-dist": "^4.10.38",
     "recharts": "^3.2.1",
@@ -109,7 +110,8 @@
     "style-inject": "^0.3.0",
     "tailwindcss": "^4.2.2",
     "tslib": "^2.8.1",
-    "vaul": "^1.1.2"
+    "vaul": "^1.1.2",
+    "xlsx": "^0.18.5"
   },
   "peerDependencies": {
     "@auth0/auth0-react": "^2.3.1",