@elia-assistant/chatui 1.0.0

package/dist/lib/n8nClient.d.ts

@@ -0,0 +1,18 @@
+import type { ChatConfig } from '../types/index.ts';
+export declare class N8nApiError extends Error {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+/**
+ * Send a message to the n8n webhook.
+ *
+ * Non-streaming: expects { output: string } response.
+ * Streaming: SSE; each event contains data: { text: "chunk" } or data: { output: "full" }.
+ *
+ * @param config   Chat configuration
+ * @param sessionId  Current session ID (maps to chatSessionKey)
+ * @param text     User message text
+ * @param onChunk  Called with each streaming chunk (enables streaming mode)
+ * @returns Full bot response text
+ */
+export declare function sendMessage(config: ChatConfig, sessionId: string, text: string, language?: string, onChunk?: (chunk: string) => void): Promise<string>;

package/dist/lib/storage.d.ts

@@ -0,0 +1,3 @@
+export declare function load<T>(key: string, fallback: T): T;
+export declare function save<T>(key: string, value: T): void;
+export declare function remove(key: string): void;

package/dist/shims/use-sync-external-store-shim.d.ts

@@ -0,0 +1 @@
+export { useSyncExternalStore } from 'react';

package/dist/store/chatStore.d.ts

@@ -0,0 +1,37 @@
+import type { Message, Session } from '../types/index.ts';
+interface ChatState {
+    sessions: Session[];
+    activeSessionId: string | null;
+    messages: Record<string, Message[]>;
+    isStreaming: boolean;
+    createSession(): string;
+    setActiveSession(id: string): void;
+    addMessage(sessionId: string, msg: Message): void;
+    appendToLastBot(sessionId: string, chunk: string): void;
+    setStreaming(val: boolean): void;
+    deleteSession(id: string): void;
+    renameSession(id: string, title: string): void;
+    clearMessages(sessionId: string): void;
+}
+export declare const useChatStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ChatState>, "setState" | "persist"> & {
+    setState(partial: ChatState | Partial<ChatState> | ((state: ChatState) => ChatState | Partial<ChatState>), replace?: false | undefined): unknown;
+    setState(state: ChatState | ((state: ChatState) => ChatState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ChatState, {
+            sessions: Session[];
+            activeSessionId: string | null;
+            messages: Record<string, Message[]>;
+        }, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: ChatState) => void) => () => void;
+        onFinishHydration: (fn: (state: ChatState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<ChatState, {
+            sessions: Session[];
+            activeSessionId: string | null;
+            messages: Record<string, Message[]>;
+        }, unknown>>;
+    };
+}>;
+export {};

package/dist/store/settingsStore.d.ts

@@ -0,0 +1,23 @@
+import type { ChatConfig } from '../types/index.ts';
+interface SettingsState {
+    config: ChatConfig;
+    activeTheme: string;
+    language: string;
+    setConfig(patch: Partial<ChatConfig>): void;
+    setTheme(id: string): void;
+    setLanguage(lang: string): void;
+}
+export declare const useSettingsStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SettingsState>, "setState" | "persist"> & {
+    setState(partial: SettingsState | Partial<SettingsState> | ((state: SettingsState) => SettingsState | Partial<SettingsState>), replace?: false | undefined): unknown;
+    setState(state: SettingsState | ((state: SettingsState) => SettingsState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<SettingsState, SettingsState, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SettingsState) => void) => () => void;
+        onFinishHydration: (fn: (state: SettingsState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<SettingsState, SettingsState, unknown>>;
+    };
+}>;
+export {};

package/dist/store.js

@@ -0,0 +1,2 @@
+import { t as e } from "./chunks/settingsStore-BqlYxczg.js";
+export { e as useSettingsStore };

package/dist/themes.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeDef } from './types/index.ts';
+export declare const themes: ThemeDef[];
+export declare const defaultThemeId = "midnight";
+export declare function getTheme(id: string): ThemeDef;

package/dist/types/index.d.ts

@@ -0,0 +1,138 @@
+/** Per-language content overrides — keyed by language code e.g. "en", "sk" */
+export interface LangOverride {
+    /** Initial bot messages shown before the user sends anything */
+    initialMessages?: string[];
+    /** CTA popup text (window mode) */
+    ctaText?: string;
+    /** Bot display name */
+    botName?: string;
+    /** Welcome screen subtitle */
+    welcomeSubtitle?: string;
+    /** Per-language tab title overrides (titles only — feed URLs/items are global). */
+    tabs?: {
+        notifications?: {
+            title?: string;
+        };
+        help?: {
+            title?: string;
+        };
+        chat?: {
+            title?: string;
+        };
+    };
+}
+export type NotificationTagVariant = 'neutral' | 'success' | 'warning' | 'danger';
+export interface NotificationTag {
+    label: string;
+    variant?: NotificationTagVariant;
+}
+export interface NotificationItem {
+    id?: string;
+    title: string;
+    message: string;
+    /** Tag entries can be plain strings (rendered as 'neutral') or { label, variant } objects. */
+    tags?: Array<string | NotificationTag>;
+    /** Verbatim string — host pre-formats. */
+    date?: string;
+    cta?: {
+        url: string;
+        title: string;
+    };
+}
+export interface FaqItem {
+    id?: string;
+    question: string;
+    answer: string;
+    category?: string;
+}
+export interface ChatConfig {
+    webhookUrl: string;
+    webhookConfig?: {
+        method?: 'POST' | 'GET';
+        headers?: Record<string, string>;
+    };
+    chatInputKey?: string;
+    chatSessionKey?: string;
+    metadata?: Record<string, unknown>;
+    showWelcomeScreen?: boolean;
+    defaultLanguage?: string;
+    /** Global fallback initial messages — per-language overrides live in i18n[lang].initialMessages */
+    initialMessages?: string[];
+    allowFileUploads?: boolean;
+    allowedFilesMimeTypes?: string;
+    /** Per-language content: initial messages, CTA text, bot name, welcome subtitle */
+    i18n?: Record<string, LangOverride>;
+    streaming?: boolean;
+    botName?: string;
+    theme?: string;
+    showSidebar?: boolean;
+    mode?: 'window' | 'fullscreen' | 'mixed';
+    showCta?: boolean;
+    ctaText?: string;
+    ctaDelay?: number;
+    ctaSound?: boolean;
+    /** Hide the built-in settings UI (gear button, theme picker, settings modal). */
+    hideSettings?: boolean;
+    /** Bot avatar. Built-in id (e.g. 'amara'), URL, or data URL. */
+    botAvatar?: string;
+    /** Popup toggle button icon (window mode). Built-in id, URL, or data URL. */
+    toggleButtonIcon?: string;
+    /** Link text shown after the localized "Powered by" prefix. Default: 'ELIA AI Assistant'. */
+    poweredByLabel?: string;
+    /** Link target URL. Default: 'https://www.elia-asistent.com'. */
+    poweredByUrl?: string;
+    /** Hide the entire "Powered by" footer line. */
+    poweredByHide?: boolean;
+    /** In fullscreen layout, present the chat as a bottom sheet (rounded top, drag handle, dimmed
+     *  backdrop above) instead of fully covering the viewport. Applies to mode 'fullscreen' and to
+     *  'mixed' on mobile. Default: false. */
+    fullscreenSheet?: boolean;
+    /** Sheet height as a CSS length (vh, %, px). Default: '75vh'. */
+    fullscreenSheetHeight?: string;
+    /** Optional tabs above the chat panel. Tab is active iff its block has feedUrl OR items. */
+    tabs?: {
+        notifications?: {
+            title?: string;
+            feedUrl?: string;
+            items?: NotificationItem[];
+        };
+        help?: {
+            title?: string;
+            feedUrl?: string;
+            items?: FaqItem[];
+        };
+        chat?: {
+            title?: string;
+        };
+    };
+}
+export interface Message {
+    id: string;
+    role: 'user' | 'bot';
+    content: string;
+    ts: number;
+}
+export interface Session {
+    id: string;
+    title: string;
+    createdAt: number;
+}
+export interface ThemeDef {
+    id: string;
+    label: string;
+    scheme: 'dark' | 'light';
+    vars: ThemeVars;
+}
+export interface ThemeVars {
+    bgBase: string;
+    bgSurface: string;
+    bgSurface2: string;
+    bgBorder: string;
+    accent: string;
+    accentFg: string;
+    fgPrimary: string;
+    fgSecondary: string;
+    fgMuted: string;
+    userBubble: string;
+    userBubbleFg: string;
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@elia-assistant/chatui",
+  "version": "1.0.0",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/chatui.iife.js",
+  "jsdelivr": "./dist/chatui.iife.js",
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./vanilla": {
+      "default": "./dist/chatui.iife.js"
+    },
+    "./store": {
+      "types": "./dist/store/settingsStore.d.ts",
+      "default": "./dist/store.js"
+    },
+    "./chat-store": {
+      "types": "./dist/store/chatStore.d.ts",
+      "default": "./dist/chat-store.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./css": {
+      "types": "./dist/chatui.css.d.ts",
+      "default": "./dist/chatui.css"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b --noEmit && vite build && vite build --config vite.iife.config.ts && tsc -p tsconfig.build.json",
+    "preview": "vite preview",
+    "pack:dry": "npm pack --dry-run",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "react-dom": { "optional": true }
+  },
+  "dependencies": {
+    "i18next": "^25.0.0",
+    "i18next-resources-to-backend": "^1.2.0",
+    "react-i18next": "^16.0.0",
+    "react-markdown": "^9.0.0",
+    "remark-gfm": "^4.0.0",
+    "zustand": "^5.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@tailwindcss/vite": "^4.0.0",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.0.0",
+    "typescript": "~5.9.0",
+    "vite": "^8.0.0",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}