@kodaris/krubble-app-components 1.0.69 → 1.0.71

package/dist/chatbot.d.ts

@@ -1,20 +1,69 @@
 import { LitElement } from 'lit';
 /**
- * Chat message interface
+ * An internal file stored on the server. Mirrors the backend InternalFileViewDto
+ * (and its InternalFileCreateUpdateDto base), so files loaded with a conversation
+ * pass through unchanged. The chatbot displays images from these by building a
+ * view URL from `internalFileID` at render time.
+ */
+export interface KRChatbotInternalFile {
+    internalFileID: number;
+    internalFileUUID?: string;
+    niceName?: string;
+    mimeType?: string;
+    lastModified?: string;
+    fileType?: string;
+    path?: string;
+    created?: string;
+    entityID?: number;
+    entityType?: string;
+    geoCoordinates?: string;
+    imageDetectionType?: string;
+    name?: string;
+    description?: string;
+    creator?: string;
+    keywords?: string;
+    subType?: string;
+    alt?: string;
+    metadata?: string;
+    deleted?: boolean;
+    extraText?: string;
+    emailID?: number;
+    aiPimSource?: string;
+    aiPimLastParsed?: string;
+    aiPimStatus?: string;
+    folder?: string;
+    status?: string;
+    extra1?: string;
+    extra2?: string;
+    extra3?: string;
+    extra4?: string;
+    extra5?: string;
+    parentInternalFileID?: number;
+    isFolder?: boolean;
+    type?: string;
+    aiPimEnabled?: boolean;
+}
+/**
+ * Chat message interface. Field names mirror the backend
+ * ConversationMessageViewDto so loaded messages pass through without remapping.
  */
 export interface KRChatbotMessage {
-    role: 'user' | 'assistant';
+    type: 'user' | 'assistant';
     content: string;
     reasoning?: string;
+    /** Internal files attached to this message. */
+    internalFiles?: KRChatbotInternalFile[];
 }
 /**
  * Callback function type for sending messages.
- * Receives the user's message text and the current conversation history.
- * Must return a Response with a streaming body (SSE format).
+ * Receives the user's message text, the current conversation history, and the
+ * raw image files attached to this message. Must return a Response with a
+ * streaming body (SSE format).
  */
 export type KRChatbotSend = (params: {
     message: string;
     messages: KRChatbotMessage[];
+    internalFiles: File[];
 }) => Promise<Response>;
 /**
  * AI chatbot component with SSE streaming.
@@ -36,7 +85,7 @@ export type KRChatbotSend = (params: {
  * ## Usage
  * ```html
  * <kr-chatbot
- *   title="AI Assistant"
+ *   label="AI Assistant"
  *   .send=${(params) => {
  *     return fetch('/api/ai/chat/stream', {
  *       method: 'POST',
@@ -69,19 +118,32 @@ export declare class KRChatbot extends LitElement {
     private _dragStartTop;
     private _resizeStartW;
     private _resizeStartH;
+    /** Counter for depth-aware dragenter/dragleave tracking. */
+    private _dragDepth;
+    /** Monotonic id source for pending attachments. */
+    private _pendingSeq;
     /**
      * Callback function for sending messages. Receives the user's message and
      * current conversation history. Must return a Response with a streaming SSE body.
+     *
+     * Optional — when not set, the chatbot uses its built-in default that streams
+     * from the Kodaris Bedrock conversation endpoints. Set this to override.
      */
     send: KRChatbotSend | null;
     /**
      * Callback function called when the user clears the conversation.
      * Must return a Promise — messages are only cleared if it resolves.
+     *
+     * Optional — when not set, the chatbot uses its built-in default that clears
+     * the Kodaris Bedrock conversation state. Set this to override.
      */
     clear: (() => Promise<unknown>) | null;
     /**
      * Callback function called on init to load existing conversation messages.
      * Must return a Promise that resolves with an array of KRChatbotMessage.
+     *
+     * Optional — when not set, the chatbot uses its built-in default that loads
+     * existing messages from the Kodaris Bedrock conversation. Set this to override.
      */
     load: (() => Promise<KRChatbotMessage[]>) | null;
     /**
@@ -90,13 +152,9 @@ export declare class KRChatbot extends LitElement {
      */
     messages: KRChatbotMessage[];
     /**
-     * Header title text.
+     * Header label text.
      */
-    title: string;
-    /**
-     * Header subtitle text (shown below title with a green status dot).
-     */
-    subtitle: string;
+    label: string;
     /**
      * Input placeholder text.
      */
@@ -105,13 +163,34 @@ export declare class KRChatbot extends LitElement {
      * Whether the chat panel is open. Only relevant in floating mode.
      */
     opened: boolean;
+    /**
+     * Hide the built-in floating toggle button. Use this when an external
+     * control (e.g. the site-editor bar) owns opening the chat — the panel is
+     * then driven via the `open()` / `close()` / `toggle()` methods.
+     */
+    hideToggle: boolean;
+    /**
+     * Layout mode.
+     * - `'floating'` (default): the chatbot is a fixed bottom-right widget with a
+     *   toggle button, and the panel can be dragged and resized. This is the
+     *   traditional chat-widget appearance.
+     * - `'inline'`: the chatbot drops its fixed positioning and fills its parent
+     *   container (100% width/height, no border radius/shadow, no toggle, no
+     *   drag/resize). The panel is always open. Use this to embed the chat as a
+     *   full page or panel region.
+     */
+    variant: 'floating' | 'inline';
     private _inputValue;
     private _isStreaming;
-    private _statusText;
     private _error;
+    /** Images staged in the composer, before the message is sent. */
+    private _pendingInternalFiles;
+    /** True while a file is being dragged over the panel (shows the drop overlay). */
+    private _isDraggingFile;
     private _panelEl;
     private _messagesEl;
     private _inputEl;
+    private _fileInputEl;
     connectedCallback(): void;
     disconnectedCallback(): void;
     updated(changed: Map<string, unknown>): void;
@@ -119,6 +198,12 @@ export declare class KRChatbot extends LitElement {
      * Stops the current stream without clearing the conversation.
      */
     stop(): void;
+    /** Open the chat panel. */
+    open(): void;
+    /** Close the chat panel. */
+    close(): void;
+    /** Toggle the chat panel open/closed. */
+    toggle(): void;
     /**
      * Shows a full-viewport transparent overlay during drag/resize operations.
      *
@@ -150,6 +235,22 @@ export declare class KRChatbot extends LitElement {
     private _applyStoredLayout;
     private _handleInputChange;
     private _handleKeyDown;
+    private _openFilePicker;
+    private _handleFileInputChange;
+    private _handlePaste;
+    private _handleDragEnter;
+    private _handleDragOver;
+    private _handleDragLeave;
+    private _handleDrop;
+    private _hasFiles;
+    /** Stage a set of image files in the composer (held locally until send). */
+    private _addFiles;
+    private _removePending;
+    private _clearPending;
+    /** Open the shared full-screen previewer for a message image. */
+    private _openImage;
+    /** Whether the send button is active: needs text or at least one image. */
+    private _canSend;
     private _handleSubmit;
     private _handleStop;
     private _handleClear;

package/dist/chatbot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../src/chatbot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAMrD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,0BA8hBpB;IAIF,OAAO,CAAC,OAAO,CAAwD;IAEvE,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAA4B;IAE5C,OAAO,CAAC,UAAU,CAAM;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAI1B;;;OAGG;IAEH,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElC;;;OAGG;IAEH,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAQ;IAE9C;;;OAGG;IAEH,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAQ;IAExD;;;OAGG;IAEH,QAAQ,EAAE,gBAAgB,EAAE,CAAM;IAElC;;OAEG;IAEH,KAAK,SAAS;IAEd;;OAEG;IAEH,QAAQ,SAAM;IAEd;;OAEG;IAEH,WAAW,SAAuB;IAElC;;OAEG;IAKH,MAAM,UAAS;IAKf,OAAO,CAAC,WAAW,CAAM;IAGzB,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,WAAW,CAAM;IAGzB,OAAO,CAAC,MAAM,CAAM;IAKpB,OAAO,CAAC,QAAQ,CAAe;IAG/B,OAAO,CAAC,WAAW,CAAe;IAGlC,OAAO,CAAC,QAAQ,CAAuB;IAI9B,iBAAiB;IAYjB,oBAAoB;IAUpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAsB9C;;OAEG;IACH,IAAI;IAMJ;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,sBAAsB;IA+B9B,OAAO,CAAC,sBAAsB;IA+B9B,OAAO,CAAC,gBAAgB,CA+CvB;IAED,OAAO,CAAC,cAAc,CAarB;IAED,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IA2FrB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IA2FxB,OAAO,CAAC,kBAAkB;IAsBjB,MAAM;CAgPhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,SAAS,CAAC;KACzB;CACF"}
+{"version":3,"file":"chatbot.d.ts","sourceRoot":"","sources":["../src/chatbot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AASrD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,EAAE,IAAI,EAAE,CAAC;CACvB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAoBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,0BAsrBpB;IAIF,OAAO,CAAC,OAAO,CAAwD;IAEvE,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO,CAAC,QAAQ,CAA4B;IAE5C,OAAO,CAAC,UAAU,CAAM;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,WAAW,CAAK;IAExB,OAAO,CAAC,cAAc,CAAK;IAE3B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,aAAa,CAAK;IAE1B,4DAA4D;IAC5D,OAAO,CAAC,UAAU,CAAK;IAEvB,mDAAmD;IACnD,OAAO,CAAC,WAAW,CAAK;IAIxB;;;;;;OAMG;IAEH,IAAI,EAAE,aAAa,GAAG,IAAI,CAAQ;IAElC;;;;;;OAMG;IAEH,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAQ;IAE9C;;;;;;OAMG;IAEH,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAAG,IAAI,CAAQ;IAExD;;;OAGG;IAEH,QAAQ,EAAE,gBAAgB,EAAE,CAAM;IAElC;;OAEG;IAEH,KAAK,SAAS;IAEd;;OAEG;IAEH,WAAW,SAAuB;IAElC;;OAEG;IAKH,MAAM,UAAS;IAEf;;;;OAIG;IAMH,UAAU,UAAS;IAEnB;;;;;;;;;OASG;IAKH,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAc;IAK5C,OAAO,CAAC,WAAW,CAAM;IAGzB,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,MAAM,CAAM;IAEpB,iEAAiE;IAEjE,OAAO,CAAC,qBAAqB,CAAsC;IAEnE,kFAAkF;IAElF,OAAO,CAAC,eAAe,CAAS;IAKhC,OAAO,CAAC,QAAQ,CAAe;IAG/B,OAAO,CAAC,WAAW,CAAe;IAGlC,OAAO,CAAC,QAAQ,CAAuB;IAGvC,OAAO,CAAC,YAAY,CAAoB;IAI/B,iBAAiB;IA+BjB,oBAAoB;IAYpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAsB9C;;OAEG;IACH,IAAI;IAIJ,2BAA2B;IAC3B,IAAI;IAMJ,4BAA4B;IAC5B,KAAK;IAML,yCAAyC;IACzC,MAAM;IAMN;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,sBAAsB;IAmC9B,OAAO,CAAC,sBAAsB;IAmC9B,OAAO,CAAC,gBAAgB,CA+CvB;IAED,OAAO,CAAC,cAAc,CAarB;IAED,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,SAAS;IAIjB,4EAA4E;IAC5E,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IAKrB,iEAAiE;IACjE,OAAO,CAAC,UAAU;IAOlB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAoIrB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAoFxB,OAAO,CAAC,kBAAkB;IAqBjB,MAAM;CAuUhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,YAAY,EAAE,SAAS,CAAC;KACzB;CACF"}