@luzmo/analytics-components-kit 1.0.3 → 1.0.4-beta.1

package/components/ai-chat/ai-chat-events.d.ts

@@ -0,0 +1,123 @@
+import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
+import type { AiSampleChart, ChatMessage } from '../../types';
+import type { AiPromptAgent, DashboardStatePayload } from './ai-prompt-types';
+/**
+ * Common fields present on every streamed step event, recognized or not.
+ */
+export interface AiChatStepBase {
+    /** The aiprompt agent that produced this step (`item`, `dashboard`, `analyst`). */
+    agent: AiPromptAgent;
+    /** Current conversation id, or `null` before the backend assigns one. */
+    conversationId: string | null;
+    /** Backend message id, when the chunk carries one. */
+    messageId?: string;
+    /** Always present — the original stream chunk that produced this step. */
+    raw: Record<string, unknown>;
+}
+/** Recognized stream-step type discriminants. */
+export type AiChatRecognizedStepType = 'decision' | 'text' | 'progress' | 'dashboard-title' | 'dashboard-layout' | 'dashboard-item' | 'chart' | 'interrupt';
+/**
+ * Stream steps assembled into a typed `data` payload.
+ * Discriminated by `type` (when `recognized` is `true`).
+ */
+export type RecognizedStepEvent = (AiChatStepBase & {
+    recognized: true;
+    type: 'decision';
+    data: {
+        decision: 'create' | 'edit' | 'question';
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'text';
+    data: {
+        delta: string;
+        text: string;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'progress';
+    data: ProgressTreeNode;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-title';
+    data: {
+        name: Record<string, string>;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-layout';
+    data: DashboardStatePayload;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'dashboard-item';
+    data: {
+        slot: number;
+        chart: Record<string, unknown>;
+    };
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'chart';
+    data: Record<string, unknown>;
+}) | (AiChatStepBase & {
+    recognized: true;
+    type: 'interrupt';
+    data: {
+        question: string;
+    };
+});
+/**
+ * Stream steps not (yet) modeled. Still delivered so consumers never
+ * silently lose data; `data` is a best-effort payload (often identical to `raw`).
+ */
+export type UnknownStepEvent = AiChatStepBase & {
+    recognized: false;
+    /** Raw chunk `type` / `asset_type`. */
+    type: string;
+    /** Best-effort payload (often `=== raw`). */
+    data: unknown;
+};
+/**
+ * Open union of streamed step events. Use {@link isRecognizedStep} to narrow to
+ * the typed {@link RecognizedStepEvent} set; otherwise inspect `raw`.
+ */
+export type AiChatStepEvent = RecognizedStepEvent | UnknownStepEvent;
+/**
+ * Authoritative final result of a streamed response, fired exactly once.
+ */
+export interface AiChatCompleteEvent {
+    /** The aiprompt agent that produced this result. */
+    agent: AiPromptAgent;
+    /** Conversation id for this response. */
+    conversationId: string | null;
+    /** Final assistant message (text + flags). */
+    message: ChatMessage;
+    /** Authoritative dashboard payload (dashboard agent). */
+    dashboard?: DashboardStatePayload;
+    /** Authoritative chart payload (item agent). */
+    chart?: AiSampleChart;
+    /** Dashboard name keyed by locale (dashboard agent). */
+    name?: Record<string, string>;
+    /** Forward-compat: any final assets not modeled explicitly. */
+    assets?: Record<string, unknown>;
+    /** Present when the response failed. */
+    error?: unknown;
+    /** Original terminal chunk. */
+    raw?: Record<string, unknown>;
+}
+/**
+ * Type guard separating the typed, recognized step set from the open passthrough.
+ * Lets consumers `switch` exhaustively on `event.type` with fully narrowed `data`.
+ *
+ * @example
+ * ```ts
+ * onStep: (event) => {
+ *   if (!isRecognizedStep(event)) return; // forward-compatible: ignore or use event.raw
+ *   switch (event.type) {
+ *     case 'decision':
+ *       // event.data.decision is typed
+ *       break;
+ *   }
+ * };
+ * ```
+ */
+export declare function isRecognizedStep(event: AiChatStepEvent): event is RecognizedStepEvent;

package/components/ai-chat/ai-chat-request.d.ts

@@ -0,0 +1,11 @@
+import type { LuzmoChart } from '../../types';
+import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptProperties, BuildAiPromptRequestContext } from './ai-prompt-types';
+export type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptInput, AiPromptItemTask, AiPromptProperties, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoDashboardGeneratedEventDetail, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './ai-prompt-types';
+export declare function getAiPromptUrl(apiUrl: string, apiVersion: string): string;
+export declare function chartToItemAsset(chart: LuzmoChart): Record<string, unknown> | null;
+export declare function buildItemAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildDashboardAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildAnalystAiPromptProperties(ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildAiPromptProperties(agent: AiPromptAgent, ctx: BuildAiPromptRequestContext): AiPromptProperties;
+export declare function buildAiPromptRequest(agent: AiPromptAgent, ctx: BuildAiPromptRequestContext): AiPromptCreateBody;
+export declare function buildAiPromptDeleteRequest(restoreToMessageId: string, authKey: string, authToken: string, apiVersion?: string, conversationId?: string | null): AiPromptDeleteBody;

package/components/ai-chat/ai-chat.d.ts

@@ -0,0 +1,279 @@
+import '@luzmo/lucero/chat-message';
+import '@luzmo/lucero/overlay';
+import '@luzmo/lucero/popover';
+import '@luzmo/lucero/progress-steps';
+import { LuzmoElement } from '../../utils/base';
+import { TemplateResult } from 'lit';
+import type { ChatMessage, Dataset, LuzmoChart } from '../../types';
+import '../ai-interaction-textarea';
+import './empty-state';
+import type { AiChatEmptyStateSuggestion } from './empty-state';
+import type { AiChatSession } from './session/ai-chat-session';
+import type { AiPromptAgent, AiPromptItemTask, AiPromptScreenMode, DashboardStatePayload } from './ai-prompt-types';
+/**
+ * @customElement luzmo-ai-chat
+ * @summary AI chat UI backed by AiChatSession for transcript, datasets, and streaming.
+ * @description Chat state lives in an AiChatSession. By default the element creates an internal
+ * session from auth, agent, and chart or dashboard props; optional messages and selected-datasets
+ * seed it once on connect. Pass .chatSession for a host-owned session (e.g. dashboard editor).
+ * See {@link AiChatSession} / createAiChatSession for callbacks and external fetchStreaming.
+ * @fires {CustomEvent<AiChatStepEvent>} luzmo-step - Fired for every incremental, kit-assembled event during a streamed response (decision, text, progress, dashboard-title/layout/item, chart, interrupt, plus forward-by-default unrecognized chunks). Use `isRecognizedStep` to narrow.
+ * @fires {CustomEvent<AiChatCompleteEvent>} luzmo-complete - Fired exactly once per response with the authoritative final result (dashboard/chart/name) or an `error`.
+ * @fires {CustomEvent<AiChatMessageSentEventDetail>} luzmo-message-sent - Fired when a user sends a message
+ * @fires {CustomEvent<AiChatDatasetsChangedEventDetail>} luzmo-datasets-changed - Fired when the selected datasets change
+ * @fires {CustomEvent<AiChatConversationIdChangedEventDetail>} luzmo-conversation-id-changed - Fired when the conversation ID is updated from the API
+ * @fires {CustomEvent<void>} luzmo-stop - Fired when an in-flight prompt is stopped
+ *
+ * @property {string} --luzmo-ai-chat-background - Background of the chat container
+ * @property {string} --luzmo-ai-chat-border-radius - Border radius of the chat container
+ * @property {string} --luzmo-ai-chat-padding - Padding of the chat container
+ * @property {string} --luzmo-ai-chat-gap - Gap between chat sections and messages
+ * @property {string} --luzmo-ai-chat-border - Border of the chat container
+ * @property {string} --luzmo-ai-chat-box-shadow - Box shadow of the chat container
+ * @property {string} --luzmo-ai-chat-scrollbar-width - Width of the messages scrollbar
+ * @property {string} --luzmo-ai-chat-scrollbar-track-background - Background of the messages scrollbar track
+ * @property {string} --luzmo-ai-chat-scrollbar-track-border-radius - Border radius of the messages scrollbar track
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-background - Background of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-border-radius - Border radius of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-scrollbar-thumb-hover-background - Hover background of the messages scrollbar thumb
+ * @property {string} --luzmo-ai-chat-loading-message-color - Color of the loading spinner icon
+ * @property {string} --luzmo-ai-chat-loading-message-icon-font-size - Font size of the loading spinner icon
+ * @property {string} --luzmo-ai-chat-error-message-color - Color of assistant error messages
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-size - Size of the assistant context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-border-color - Border color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-border-radius - Border radius of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-background - Background of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-color - Icon color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-background - Hover background of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-border-color - Hover border color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-trigger-hover-color - Hover icon color of the context menu trigger button
+ * @property {string} --luzmo-ai-chat-context-menu-item-font-family - Font family of context menu items
+ * @property {string} --luzmo-ai-chat-context-menu-item-hover-background - Hover background of context menu items
+ * @property {string} --luzmo-ai-chat-markdown-line-height - Line height of rendered assistant markdown
+ * @property {string} --luzmo-ai-chat-markdown-spacing - Bottom spacing between markdown blocks (paragraphs, lists, tables, etc.)
+ * @property {string} --luzmo-ai-chat-markdown-heading-spacing - Top spacing above markdown headings (and `hr` margins)
+ * @property {string} --luzmo-ai-chat-markdown-heading-font-weight - Font weight of markdown headings
+ * @property {string} --luzmo-ai-chat-markdown-list-indent - Inline start padding (indent) of markdown lists
+ * @property {string} --luzmo-ai-chat-markdown-link-color - Color of links in markdown
+ * @property {string} --luzmo-ai-chat-markdown-code-font-family - Font family of inline and block code
+ * @property {string} --luzmo-ai-chat-markdown-code-font-size - Font size of inline and block code
+ * @property {string} --luzmo-ai-chat-markdown-code-background - Background of inline code and code blocks
+ * @property {string} --luzmo-ai-chat-markdown-code-border-radius - Border radius of inline code and code blocks
+ * @property {string} --luzmo-ai-chat-markdown-border-color - Border color for blockquotes, horizontal rules, and tables
+ * @property {string} --luzmo-ai-chat-markdown-table-header-background - Background of markdown table header cells
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-gap - Gap between controls in the assistant message actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-margin-top - Top spacing above the assistant message actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-color - Text color for assistant message actions footer content (default: `--luzmo-font-color-extra-dimmed`)
+ * @property {string} --luzmo-ai-chat-assistant-message-actions-font-style - Font style for plain text in the assistant message actions footer (default: `italic`)
+ * @property {string} --luzmo-ai-chat-assistant-message-font-family - Font family shared by assistant messages and their actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-font-size - Font size shared by assistant messages and their actions footer
+ * @property {string} --luzmo-ai-chat-assistant-message-line-height - Line height shared by assistant messages and their actions footer
+ */
+export declare class LuzmoAiChat extends LuzmoElement {
+    static styles: import("lit").CSSResult;
+    static tagName: string;
+    /** Light-DOM slot name for optional actions below the latest assistant message. */
+    static readonly assistantMessageActionsSlot = "assistant-message-actions";
+    /**
+     * Live transcript is {@link AiChatSession.state.messages}. This prop optionally seeds the session on first connect.
+     */
+    messages: ChatMessage[];
+    /**
+     * Live selection is in the session. This prop optionally seeds on first connect.
+     */
+    selectedDatasets: Dataset[];
+    /**
+     * Placeholder text for the textarea
+     */
+    placeholder: string;
+    /**
+     * When true, disables the entire chat interface
+     */
+    disabled: boolean;
+    /**
+     * When true, shows a stop control on the prompt input while a response is generating
+     */
+    stoppable: boolean;
+    /**
+     * When true, shows context menu (3 dots) on assistant messages
+     */
+    showAssistantContextMenu: boolean;
+    /**
+     * Auth key for DataBroker authentication
+     */
+    authKey: string;
+    /**
+     * Auth token for DataBroker authentication
+     */
+    authToken: string;
+    /**
+     * API URL for DataBroker
+     * @default https://api.luzmo.com
+     */
+    apiUrl: string;
+    /**
+     * The URL of the app server for thumbnails and assets
+     * @default https://app.luzmo.com
+     */
+    appServer: string;
+    /**
+     * When true, restricts results to public datasets (opendata parity)
+     */
+    flagOpendata: boolean;
+    /**
+     * When true, hides the "+ Add dataset" button in the input
+     */
+    hideDatasetButton: boolean;
+    /**
+     * When true, hides dataset icons in the input dataset selector and @ mention dataset headers
+     */
+    hideDatasetIcons: boolean;
+    /**
+     * When true, hides the add-dataset button and disables removing selected datasets while keeping pills visible
+     */
+    disableDatasetModification: boolean;
+    /**
+     * When true, hides the dataset row and add-dataset button entirely
+     */
+    hideSelectedDatasets: boolean;
+    /**
+     * When true, disables @ trigger mentions for dataset fields in the input
+     */
+    disableColumnMentions: boolean;
+    /**
+     * When true, at least one dataset must be selected before the prompt can be submitted
+     */
+    requireDataset: boolean;
+    /**
+     * Which aiprompt agent to use. Determines request payload and stream handling.
+     * @default 'item'
+     */
+    agent: AiPromptAgent;
+    /**
+     * Task for the item agent (`generate`, `suggest`, `describe`).
+     * @default 'generate'
+     */
+    task: AiPromptItemTask;
+    /**
+     * AI model preference for item agent chart generation
+     * @default 'performance'
+     */
+    modelPreference: 'performance' | 'quality';
+    /**
+     * Host-owned {@link AiChatSession}. The component subscribes and renders; does not abort on disconnect.
+     */
+    chatSession: AiChatSession | null;
+    /**
+     * Conversation ID (synced into the session; updated when the API returns a new id).
+     * @default null
+     */
+    conversationId: string | null;
+    /**
+     * Chart context for `agent="item"`.
+     * @default null
+     */
+    chart: LuzmoChart | null;
+    /**
+     * Dashboard context for `agent="dashboard"`.
+     * @default null
+     */
+    dashboard: DashboardStatePayload | null;
+    /**
+     * Current screen mode when editing a dashboard.
+     */
+    currentScreenMode?: AiPromptScreenMode;
+    /**
+     * Locale ID sent to the aiprompt API.
+     */
+    localeId?: string;
+    /**
+     * Timezone ID for dashboard agent requests.
+     * @default 'UTC'
+     */
+    timezoneId: string;
+    /**
+     * API version
+     * @default '0.1.0'
+     */
+    apiVersion: string;
+    /**
+     * When true, uses NDJSON streaming for AI responses.
+     * When false, uses a single JSON response.
+     * @default true
+     */
+    stream: boolean;
+    /**
+     * Loading message shown while generating and before progress steps are available.
+     * @default null
+     */
+    loadingMessage: string | null;
+    /**
+     * Message shown in place of the assistant reply when the user stops an in-flight response.
+     * Falls back to a localized default when not set.
+     * @default null
+     */
+    cancelledMessage: string | null;
+    /**
+     * When set, auto-submits via the session without adding a duplicate user message
+     * (assumes the prompt is already in the transcript).
+     * @default null
+     */
+    initialPrompt: string | null;
+    /**
+     * Title for the empty state when there are no messages.
+     */
+    emptyStateTitle: string;
+    /**
+     * Optional label above empty-state suggestion chips. Only shown when `emptyStateSuggestions` is non-empty.
+     */
+    emptyStateSubtitle: string;
+    /**
+     * Optional suggestion chips for the empty state. When empty, only the title is shown.
+     * Each entry may include `selectedDatasets` to pre-select datasets when the chip is activated.
+     */
+    emptyStateSuggestions: AiChatEmptyStateSuggestion[];
+    private _textareaValue;
+    private _assistantMessageActionsHasContent;
+    private _lastProcessedInitialPrompt;
+    private readonly _session;
+    /** Active {@link AiChatSession} (host or auto-created). Null until first bind or action. */
+    get session(): AiChatSession | null;
+    private _getRenderState;
+    private _createDomBridgeCallbacks;
+    private _buildSessionConfig;
+    private _emitConversationIdChanged;
+    private _restoreViaSession;
+    private _handleRestoreState;
+    private _handleDatasetSelected;
+    private _handleDatasetRemoved;
+    private _submitViaSession;
+    private _handlePromptSubmitted;
+    private _handlePromptStopped;
+    private _handleEmptyStateSuggestionSelected;
+    private _processInitialPrompt;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _scrollToBottom;
+    protected updated(changedProperties: Map<string, unknown>): void;
+    private _syncSession;
+    private _handleInitialPromptChange;
+    /**
+     * Parses assistant markdown into HTML and sanitizes it to prevent XSS attacks
+     * while preserving safe formatting (headings, lists, tables, code, links).
+     * @param markdownContent - The markdown string returned by the assistant
+     * @returns Sanitized HTML string safe for rendering
+     */
+    private _renderMarkdown;
+    private _renderProgress;
+    private _isLastAiMessageWithProgress;
+    private _syncAssistantMessageActionsVisibility;
+    private _handleAssistantMessageActionsSlotChange;
+    private _setAssistantMessageActionsHasContent;
+    private _renderAssistantMessageActions;
+    private _renderRestoreMenu;
+    private _renderMessages;
+    private _renderStreamingResponse;
+    private _renderLoadingMessage;
+    private _renderEmptyState;
+    protected render(): TemplateResult;
+}

package/components/ai-chat/ai-prompt-types.d.ts

@@ -0,0 +1,94 @@
+import type { Dataset, LuzmoChart } from '../../types';
+export type AiPromptAgent = 'item' | 'dashboard' | 'analyst';
+export type AiPromptItemTask = 'generate' | 'suggest' | 'describe';
+export type AiPromptScreenMode = 'desktop' | 'tablet' | 'mobile';
+/** Dashboard payload for `agent: 'dashboard'` input (views, syncScreenModes, optional theme). */
+export interface DashboardStatePayload {
+    views: unknown[];
+    syncScreenModes?: boolean;
+    theme?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface AiPromptTextInput {
+    type: 'text';
+    text: string;
+}
+export interface AiPromptDatasetInput {
+    type: 'dataset';
+    id: string;
+}
+export interface AiPromptItemInput {
+    type: 'item';
+    value: Record<string, unknown>;
+}
+export interface AiPromptDashboardInput {
+    type: 'dashboard';
+    value: DashboardStatePayload;
+    current_screen_mode?: AiPromptScreenMode;
+}
+export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput;
+export interface AiPromptProperties {
+    agent: AiPromptAgent;
+    task: AiPromptItemTask | 'generate';
+    conversation_id?: string;
+    locale_id?: string;
+    timezone_id?: string;
+    stream: boolean;
+    response_mode: 'mixed';
+    input: AiPromptInput[];
+}
+export interface AiPromptCreateBody {
+    key: string;
+    token: string;
+    action: 'create';
+    version: string;
+    properties: AiPromptProperties;
+}
+export interface AiPromptDeleteBody {
+    key: string;
+    token: string;
+    action: 'delete';
+    version: string;
+    properties: {
+        agent: 'item';
+        restore_to_message_id: string;
+        conversation_id?: string;
+    };
+}
+export interface BuildAiPromptRequestContext {
+    prompt: string;
+    datasetIds: string[];
+    authKey: string;
+    authToken: string;
+    conversationId: string | null;
+    apiVersion?: string;
+    stream?: boolean;
+    localeId?: string;
+    timezoneId?: string;
+    /** Session/UI preference only; not serialized on aiprompt create until the backend supports it. */
+    modelPreference?: 'performance' | 'quality';
+    chart?: LuzmoChart | null;
+    dashboard?: DashboardStatePayload | null;
+    currentScreenMode?: AiPromptScreenMode;
+    task?: AiPromptItemTask;
+}
+export interface LuzmoPromptSubmittedEventDetail {
+    prompt: string;
+    selectedDatasets: Dataset[];
+    datasetIds: string[];
+    agent: AiPromptAgent;
+    request: AiPromptCreateBody;
+    url: string;
+    signal?: AbortSignal;
+}
+export interface LuzmoRestoreRequestedEventDetail {
+    apiMessageId: string;
+    messageIndex: number;
+    request: AiPromptDeleteBody;
+    url: string;
+}
+export interface LuzmoDashboardGeneratedEventDetail {
+    dashboard: DashboardStatePayload;
+    conversationId: string | null;
+    name?: Record<string, string>;
+}

package/components/ai-chat/empty-state/ai-chat-empty-state.d.ts

@@ -0,0 +1,46 @@
+import '@luzmo/lucero/action-button';
+import { LuzmoElement } from '../../../utils/base';
+import { type TemplateResult } from 'lit';
+import type { AiChatEmptyStateSuggestion } from './types';
+/**
+ * @customElement luzmo-ai-chat-empty-state
+ * @summary Empty state for AI chat with title, subtitle, and prompt suggestions.
+ * @fires {CustomEvent<AiChatEmptyStateSuggestionSelectedDetail>} luzmo-suggestion-selected - Fired when the user selects a suggestion chip
+ *
+ * @property {string} --luzmo-ai-chat-empty-state-header-actions-gap - Gap between the title and the actions block
+ * @property {string} --luzmo-ai-chat-empty-state-actions-gap - Gap between the actions label and suggestion chips
+ * @property {string} --luzmo-ai-chat-empty-state-suggestions-gap - Gap between suggestion chips
+ * @property {string} --luzmo-ai-chat-empty-state-max-width - Maximum content width
+ * @property {string} --luzmo-ai-chat-empty-state-padding-block - Vertical padding
+ * @property {string} --luzmo-ai-chat-empty-state-padding-inline - Horizontal padding
+ * @property {string} --luzmo-ai-chat-empty-state-title-font-size - Title font size
+ * @property {string} --luzmo-ai-chat-empty-state-title-font-weight - Title font weight
+ * @property {string} --luzmo-ai-chat-empty-state-title-line-height - Title line height
+ * @property {string} --luzmo-ai-chat-empty-state-title-color - Title text color
+ * @property {string} --luzmo-ai-chat-empty-state-subtitle-font-size - Subtitle font size
+ * @property {string} --luzmo-ai-chat-empty-state-subtitle-font-weight - Subtitle font weight
+ * @property {string} --luzmo-ai-chat-empty-state-subtitle-line-height - Subtitle line height
+ * @property {string} --luzmo-ai-chat-empty-state-subtitle-color - Subtitle text color (`--luzmo-font-color-dimmed`)
+ */
+export declare class LuzmoAiChatEmptyState extends LuzmoElement {
+    static styles: import("lit").CSSResult;
+    static tagName: string;
+    /**
+     * Heading shown above the suggestions.
+     */
+    title: string;
+    /**
+     * Supporting text shown above suggestion chips when `suggestions` is non-empty.
+     */
+    subtitle: string;
+    /**
+     * Suggestion chips rendered with {@link https://lucero.luzmo.com/ | Lucero} `luzmo-action-button` (`variant="accent"`).
+     */
+    suggestions: AiChatEmptyStateSuggestion[];
+    /**
+     * When true, suggestion chips cannot be activated.
+     */
+    disabled: boolean;
+    private _handleSuggestionActivate;
+    protected render(): TemplateResult;
+}

package/components/ai-chat/empty-state/index.d.ts

@@ -0,0 +1,8 @@
+import { LuzmoAiChatEmptyState } from './ai-chat-empty-state';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-ai-chat-empty-state': LuzmoAiChatEmptyState;
+    }
+}
+export { LuzmoAiChatEmptyState } from './ai-chat-empty-state';
+export type { AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from './types';

package/components/ai-chat/empty-state/types.d.ts

@@ -0,0 +1,14 @@
+import type { Dataset } from '../../../types';
+export type AiChatEmptyStateSuggestion = {
+    /** Visible label on the suggestion chip. */
+    label: string;
+    /** Prompt text inserted or submitted when selected; defaults to `label`. */
+    prompt?: string;
+    /** Datasets applied to the chat input when this suggestion is selected. */
+    selectedDatasets?: Dataset[];
+};
+export type AiChatEmptyStateSuggestionSelectedDetail = {
+    label: string;
+    prompt: string;
+    selectedDatasets?: Dataset[];
+};

package/components/ai-chat/index.cjs

@@ -0,0 +1,20 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../ai-chat-BMDfKnEj.cjs");exports.AiChatSession=e.i,exports.AiChatSessionController=e.r,exports.LuzmoAiChat=e.n,exports.LuzmoAiChatEmptyState=e.T,exports.buildAiPromptDeleteRequest=e._,exports.buildAiPromptProperties=e.v,exports.buildAiPromptRequest=e.y,exports.buildAnalystAiPromptProperties=e.b,exports.buildDashboardAiPromptProperties=e.x,exports.buildItemAiPromptProperties=e.S,exports.chartToItemAsset=e.C,exports.createAiChatSession=e.a,exports.createInitialProgress=e.f,exports.createInitialStreamState=e.o,exports.createStreamHandler=e.s,exports.extractChartFromChunk=e.u,exports.extractDashboardFromChunk=e.d,exports.fetchStreamingResponse=e.m,exports.getAgentStreamDefinition=e.c,exports.getAiPromptUrl=e.w,exports.hasProgressChunk=e.p,exports.isRecognizedStep=e.t,exports.parseStreamLine=e.h,exports.processStreamChunk=e.l,exports.readNdjsonStream=e.g;

package/components/ai-chat/index.d.ts

@@ -0,0 +1,20 @@
+import { LuzmoAiChat } from './ai-chat';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-ai-chat': LuzmoAiChat;
+    }
+}
+export type { ProgressTreeNode, AiChatMessageSentEventDetail, AiChatDatasetsChangedEventDetail, AiChatConversationIdChangedEventDetail } from '../../types/ai-chat.types';
+export { isRecognizedStep } from './ai-chat-events';
+export type { AiChatCompleteEvent, AiChatRecognizedStepType, AiChatStepBase, AiChatStepEvent, RecognizedStepEvent, UnknownStepEvent } from './ai-chat-events';
+export { AiChatSession, AiChatSessionController, createAiChatSession } from './session';
+export type { AiChatSessionControllerOptions, AiChatSessionSeed } from './session/ai-chat-session-controller';
+export type { AiChatSessionBuildContext, AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionState, AiChatSessionSubmitParams, AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './session/ai-chat-session-types';
+export { LuzmoAiChat } from './ai-chat';
+export { LuzmoAiChatEmptyState } from './empty-state';
+export type { AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from './empty-state';
+export * from './ai-prompt-types';
+export * from './ai-chat-request';
+export { createInitialProgress, createInitialStreamState, createStreamHandler, extractChartFromChunk, extractDashboardFromChunk, fetchStreamingResponse, getAgentStreamDefinition, hasProgressChunk, parseStreamLine, processStreamChunk, readNdjsonStream } from './stream';
+export type { StreamingRequestOptions, StreamingResponse } from './stream/transport';
+export type { AgentStreamDefinition, StreamHandlerCallbacks, StreamHandlerContext, StreamHandlerState } from './stream';

package/components/ai-chat/index.js

@@ -0,0 +1,28 @@
+/*! * A kit of modern Luzmo Web Components for analytics in your web application.
+ * 
+ * Copyright © 2026 Luzmo
+ * All rights reserved.
+ * Luzmo web components (“Luzmo Web Components”)
+ * must be used according to the Luzmo Terms of Service.
+ * This license allows users with a current active Luzmo account
+ * to use the Luzmo Web Components. This license terminates
+ * automatically if a user no longer has an active Luzmo account.
+ * Please view the Luzmo Terms of Service at: https://www.luzmo.com/information-pages/terms-of-use.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * */
+// Auto-generated initialization code
+(function() {
+	if (typeof document < "u" && !document.querySelector("style[data-luzmo-vars]")) {
+		let e = document.createElement("style");
+		e.setAttribute("data-luzmo-vars", ""), e.textContent = "html{--luzmo-animation-duration: 0.15s;--luzmo-border-color: rgba(var(--luzmo-border-color-rgb), 0.1);--luzmo-border-color-hover: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-down: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-border-color-focus: rgba(var(--luzmo-border-color-rgb), 0.15);--luzmo-border-color-rgb: 0, 0, 0;--luzmo-border-color-full: rgb(180, 180, 180);--luzmo-border-color-full-hover: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-full-down: color-mix(in oklch, var(--luzmo-border-color-full), black 45%);--luzmo-border-color-full-focus: color-mix(in oklch, var(--luzmo-border-color-full), black 25%);--luzmo-border-color-disabled: #dddddd;--luzmo-border-radius: 6px;--luzmo-border-radius-s: 4px;--luzmo-border-radius-l: 8px;--luzmo-border-radius-xl: 12px;--luzmo-border-radius-full: 999rem;--luzmo-background-color: #ffffff;--luzmo-background-color-rgb: 255, 255, 255;--luzmo-background-color-disabled: #eeeeee;--luzmo-background-color-hover: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-down: color-mix(in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 7%), black 1%);--luzmo-background-color-focus: color-mix( in oklch, color-mix(in oklch, var(--luzmo-background-color), var(--luzmo-primary) 5%), black 1.5% );--luzmo-background-color-highlight: rgb(240, 240, 240);--luzmo-background-color-highlight-disabled: rgb(245, 245, 245);--luzmo-background-color-highlight-hover: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-highlight-down: color-mix(in oklch, var(--luzmo-background-color-highlight), black 20%);--luzmo-background-color-highlight-focus: color-mix(in oklch, var(--luzmo-background-color-highlight), black 10%);--luzmo-background-color-alt-1: rgb(250, 250, 250);--luzmo-background-color-alt-2: rgb(239, 239, 239);--luzmo-border-width: 1px;--luzmo-font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', Helvetica, Arial, sans-serif;--luzmo-font-size-xs: 10px;--luzmo-font-size-s: 12px;--luzmo-font-size-m: 14px;--luzmo-font-size: 14px;--luzmo-font-size-l: 16px;--luzmo-font-size-xl: 18px;--luzmo-font-size-xxl: 20px;--luzmo-font-style: normal;--luzmo-line-height: normal;--luzmo-font-weight: 400;--luzmo-font-weight-semibold: 500;--luzmo-font-weight-bold: 600;--luzmo-font-color: #333;--luzmo-font-color-hard: #000;--luzmo-font-color-disabled: var(--luzmo-color-disabled);--luzmo-font-color-extra-dimmed: #888;--luzmo-font-color-hover: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-font-color-down: color-mix(in oklch, var(--luzmo-font-color), black 20%);--luzmo-font-color-focus: color-mix(in oklch, var(--luzmo-font-color), black 8%);--luzmo-scrollbar-size: 6px;--luzmo-scrollbar-width: thin;--luzmo-scrollbar-track-background: transparent;--luzmo-scrollbar-track-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-background: rgba(var(--luzmo-border-color-rgb), 0.3);--luzmo-scrollbar-thumb-border-radius: var(--luzmo-border-radius-s);--luzmo-scrollbar-thumb-hover-background: rgba(var(--luzmo-border-color-rgb), 0.4);--luzmo-primary: #4434ff;--luzmo-primary-hover: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-down: color-mix(in oklch, var(--luzmo-primary), black 20%);--luzmo-primary-focus: color-mix(in oklch, var(--luzmo-primary), black 8%);--luzmo-primary-inverse-color: #ffffff;--luzmo-primary-rgb: 68, 52, 255;--luzmo-secondary: #ff00ff;--luzmo-secondary-hover: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-down: color-mix(in oklch, var(--luzmo-secondary), black 20%);--luzmo-secondary-focus: color-mix(in oklch, var(--luzmo-secondary), black 8%);--luzmo-secondary-inverse-color: #ffffff;--luzmo-secondary-rgb: 255, 0, 255;--luzmo-secondary-outline: rgba(255, 0, 255, 0.2);--luzmo-negative-color: #ca221c;--luzmo-negative-color-hover: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-down: color-mix(in oklch, var(--luzmo-negative-color), black 20%);--luzmo-negative-color-focus: color-mix(in oklch, var(--luzmo-negative-color), black 8%);--luzmo-negative-color-rgb: 202, 34, 28;--luzmo-positive-color: rgb(20, 150, 101);--luzmo-positive-color-hover: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-down: color-mix(in oklch, var(--luzmo-positive-color), black 20%);--luzmo-positive-color-focus: color-mix(in oklch, var(--luzmo-positive-color), black 8%);--luzmo-positive-color-rgb: 20, 150, 101;--luzmo-selected-color: rgb(110, 110, 110);--luzmo-selected-color-hover: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-down: color-mix(in oklch, var(--luzmo-selected-color), black 45%);--luzmo-selected-color-focus: color-mix(in oklch, var(--luzmo-selected-color), black 25%);--luzmo-selected-color-hard: #1e1e1e;--luzmo-selected-color-hard-hover: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-selected-color-hard-down: color-mix(in oklch, var(--luzmo-selected-color-hard), black 45%);--luzmo-selected-color-hard-focus: color-mix(in oklch, var(--luzmo-selected-color-hard), black 25%);--luzmo-color-informative: #1a77e9;--luzmo-color-informative-rgb: 26, 119, 233;--luzmo-color-disabled: #aaaaaa;--luzmo-spacing-1: 2px;--luzmo-spacing-2: 4px;--luzmo-spacing-3: 8px;--luzmo-spacing-4: 12px;--luzmo-spacing-5: 16px;--luzmo-indicator-gap: 2px;--luzmo-indicator-width: 1px;--luzmo-indicator-color: var(--luzmo-primary);--luzmo-component-height-xxs: 20px;--luzmo-component-height-xs: 24px;--luzmo-component-height-s: 28px;--luzmo-component-height: 32px;--luzmo-component-height-l: 40px;--luzmo-component-height-xl: 48px;--luzmo-component-height-xxl: 64px;--luzmo-icon-size-xxs: 12px;--luzmo-icon-size-xs: 14px;--luzmo-icon-size-s: 16px;--luzmo-icon-size-m: 18px;--luzmo-icon-size-l: 20px;--luzmo-icon-size-xl: 22px;--luzmo-icon-size-xxl: 32px}", document.head.appendChild(e);
+	}
+})();
+import { C as e, S as t, T as n, _ as r, a as i, b as a, c as o, d as s, f as c, g as l, h as u, i as d, l as f, m as p, n as m, o as h, p as g, r as _, s as v, t as y, u as b, v as x, w as S, x as C, y as w } from "../ai-chat-Cd26aDpX.js";
+export { d as AiChatSession, _ as AiChatSessionController, m as LuzmoAiChat, n as LuzmoAiChatEmptyState, r as buildAiPromptDeleteRequest, x as buildAiPromptProperties, w as buildAiPromptRequest, a as buildAnalystAiPromptProperties, C as buildDashboardAiPromptProperties, t as buildItemAiPromptProperties, e as chartToItemAsset, i as createAiChatSession, c as createInitialProgress, h as createInitialStreamState, v as createStreamHandler, b as extractChartFromChunk, s as extractDashboardFromChunk, p as fetchStreamingResponse, o as getAgentStreamDefinition, S as getAiPromptUrl, g as hasProgressChunk, y as isRecognizedStep, u as parseStreamLine, f as processStreamChunk, l as readNdjsonStream };