@elia-assistant/chatui 1.0.22 → 1.0.25

package/README.md

@@ -65,11 +65,12 @@ const instance = createChat({
 
 - **n8n webhook compatible** — same parameters as `@n8n/chat`; works with any Chat Trigger out of the box
 - **Three display modes** — `fullscreen`, `window` (floating button + popup), or `mixed` (window on desktop, fullscreen on mobile)
+- **Left/right positioning** — `position: 'left'` anchors the floating button and chat window to the left side of the screen
 - **Bottom-sheet style** — opt-in `fullscreenSheet` mode covers ~3/4 of the screen with a rounded top instead of going edge-to-edge
 - **Optional tabs** — surface a Notifications feed (URL or inline JSON) and a searchable FAQ alongside the chat
 - **SSE streaming** — optional word-by-word bot responses
 - **10 built-in themes** — Midnight, Ivory, Sunrise, Cosmos, Forest, Ocean, Cherry, Navy, Lavender, Amber; switch at runtime
-- **12 built-in avatars** + file upload (max 500 KB) or URL — same picker for the floating button icon
+- **30 built-in avatars** + file upload (max 500 KB) or URL — same picker for the floating button icon
 - **CTA popup** — timed speech-bubble with optional Web Audio notification, window mode only
 - **Conversation history** — optional sidebar with persistent multi-session history
 - **Per-language content** — initial messages, bot name, CTA text, welcome subtitle, tab titles, all configurable per language
@@ -107,7 +108,8 @@ All options live on `ChatConfig`. Set them once at boot via `setConfig()` (or pa
 
 | Parameter | Type | Default | Description |
 |---|---|---|---|
-| `mode` | `'fullscreen' \| 'window' \| 'mixed'` | `'fullscreen'` | Display mode |
+| `mode` | `'fullscreen' \| 'window' \| 'mixed'` | `'window'` | Display mode |
+| `position` | `'right' \| 'left'` | `'right'` | Side of the screen the floating widget is anchored to (window / mixed mode) |
 | `fullscreenSheet` | `boolean` | `false` | Render fullscreen as a bottom sheet (rounded top, dimmed backdrop) |
 | `fullscreenSheetHeight` | `string` | `'75vh'` | Sheet height as any CSS length |
 | `showWelcomeScreen` | `boolean` | `true` | Show welcome screen when no messages |

package/dist/assets/avatars/index.d.ts

@@ -1,4 +1,13 @@
 export declare const builtInAvatars: Record<string, string>;
 export declare const builtInAvatarIds: string[];
-/** Resolve a user-supplied value to a URL suitable for <img src>. */
+export declare const WHITE_BG_AVATARS: Set<string>;
+export declare const THEME_BG_AVATARS: Set<string>;
+/** Returns the CSS background value for an avatar container based on the avatar type. */
+export declare function avatarContainerBg(key: string | undefined): string;
+/** Returns the effective avatar key after resolving fallbacks.
+ *  Unknown built-in IDs (e.g. a removed avatar) normalise to 'bubble'.
+ *  External URLs are returned as-is. */
+export declare function effectiveAvatarKey(value: string | undefined): string | undefined;
+/** Resolve a user-supplied value to a URL suitable for <img src>.
+ *  Unknown built-in IDs fall back to the 'bubble' icon. */
 export declare function resolveAvatarUrl(value: string | undefined): string | undefined;