@luzmo/analytics-components-kit 1.0.5-beta.1 → 1.0.5-beta.3

package/angular/utils/store/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * State Store
+ *
+ * State management utilities for item and dashboard state
+ * with undo/redo support and real-time collaboration capabilities.
+ *
+ * @module store
+ *
+ * @example
+ * ```typescript
+ * // Standalone item with undo/redo
+ * import { createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * const itemStore = createItemStore({
+ *   type: 'bar-chart',
+ *   slots: [{ name: 'measure', content: [...] }],
+ *   options: { display: { title: true } }
+ * });
+ *
+ * itemStore.subscribe((state) => {
+ *   // Update UI with new state
+ * });
+ *
+ * itemStore.updateOption('display.title', false);
+ * itemStore.undo(); // Restores title to true
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the store registry
+ * import {
+ *   registerItemStore,
+ *   getStore
+ * } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * // Create and register stores
+ * const store = registerItemStore({ type: 'bar-chart' });
+ *
+ * // Use store ID in components
+ * element.storeId = store.id;
+ *
+ * // Retrieve store by ID anywhere in the app
+ * const sameStore = getStore(store.id);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Dashboard with real-time collaboration
+ * import { createDashboardStore } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * const dashboardStore = createDashboardStore(dashboardConfig);
+ *
+ * // Sync with other peers
+ * dashboardStore.subscribeLocalUpdates((updates) => {
+ *   websocket.send(updates);
+ * });
+ *
+ * websocket.onmessage = (msg) => {
+ *   dashboardStore.importUpdates(msg.data);
+ * };
+ * ```
+ */
+import type { ItemState, ItemStoreConfig, ItemStore, DashboardState, DashboardStoreConfig, DashboardStore } from './types';
+/**
+ * Promise that resolves immediately.
+ * Kept for API compatibility - yjs is pure JavaScript and doesn't require WASM initialization.
+ *
+ * @example
+ * ```typescript
+ * import { ready, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * await ready;
+ * const store = createItemStore({ type: 'bar-chart' });
+ * ```
+ */
+export declare const ready: Promise<void>;
+/**
+ * Execute a callback when the DOM is ready.
+ * Handles the ES module timing issue where DOMContentLoaded may have already fired.
+ *
+ * @param callback Function to execute when DOM is ready
+ *
+ * @example
+ * ```typescript
+ * import { onReady, createItemStore } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * onReady(() => {
+ *   const store = createItemStore({ type: 'bar-chart' });
+ *   initializeApp(store);
+ * });
+ * ```
+ */
+export declare function onReady(callback: () => void): void;
+export { createItemStore } from './item-store';
+export { createDashboardStore } from './dashboard-store';
+/**
+ * Create an item store.
+ * This async version is kept for API compatibility.
+ * Since yjs is pure JavaScript, no async initialization is needed.
+ *
+ * @param initialState Initial item state (optional)
+ * @param config Store configuration (optional)
+ * @param storeId Optional store ID (auto-generated UUID if not provided)
+ * @returns Promise resolving to ItemStore instance
+ *
+ * @example
+ * ```typescript
+ * const store = await createItemStoreAsync({
+ *   type: 'bar-chart',
+ *   options: { display: { title: true } }
+ * });
+ * ```
+ */
+export declare function createItemStoreAsync(initialState?: Partial<ItemState>, config?: ItemStoreConfig, storeId?: string): Promise<ItemStore>;
+/**
+ * Create a dashboard store.
+ * This async version is kept for API compatibility.
+ * Since yjs is pure JavaScript, no async initialization is needed.
+ *
+ * @param initialState Initial dashboard state (optional)
+ * @param config Store configuration (optional)
+ * @param storeId Optional store ID (auto-generated UUID if not provided)
+ * @returns Promise resolving to DashboardStore instance
+ *
+ * @example
+ * ```typescript
+ * const store = await createDashboardStoreAsync({
+ *   version: '1.0.0',
+ *   views: [{ screenModus: 'desktop', options: {}, filters: [], items: [] }]
+ * });
+ * ```
+ */
+export declare function createDashboardStoreAsync(initialState?: Partial<DashboardState>, config?: DashboardStoreConfig, storeId?: string): Promise<DashboardStore>;
+export { getStore, getItemStore, getDashboardStore, hasStore, getStoreIds, registerStore, registerItemStore, registerDashboardStore, removeStore, destroyStore, clearRegistry } from './store-registry';
+export type { BaseStoreConfig, DashboardStoreConfig, ItemStoreConfig, ItemState, Slot, SlotContent, DashboardItemState, DashboardParameter, DashboardState, FilterConfig, ItemPosition, ScreenMode, TimezoneConfig, ViewOptions, ViewState, BaseStore, DashboardStore, ItemStore, ChangeSubscriber, LocalUpdatesSubscriber, StateSubscriber, SubscribeOptions, Unsubscribe } from './types';

package/angular/utils/store/store-registry.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Store Registry
+ *
+ * A global registry for stores that allows components to reference stores
+ * by ID.
+ *
+ * @module store-registry
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   registerItemStore,
+ *   getStore
+ * } from '@luzmo/analytics-components-kit/utils/store';
+ *
+ * // Create and register a store (auto-registers with its ID)
+ * const store = registerItemStore({ type: 'bar-chart' });
+ * const storeId = store.id; // Use this in component props
+ *
+ * // Later, retrieve the store by ID
+ * const sameStore = getStore(storeId);
+ * ```
+ */
+import type { BaseStore, DashboardState, DashboardStore, DashboardStoreConfig, ItemState, ItemStore, ItemStoreConfig } from './types';
+/**
+ * Get a store by its ID
+ *
+ * @param storeId The unique store identifier
+ * @returns The store instance, or undefined if not found
+ *
+ * @example
+ * ```typescript
+ * const store = getStore('my-store-id');
+ * if (store) {
+ *   const state = store.getState();
+ * }
+ * ```
+ */
+export declare function getStore<T = unknown>(storeId: string): BaseStore<T> | undefined;
+/**
+ * Get an item store by its ID
+ *
+ * @param storeId The unique store identifier
+ * @returns The item store instance, or undefined if not found
+ */
+export declare function getItemStore(storeId: string): ItemStore | undefined;
+/**
+ * Get a dashboard store by its ID
+ *
+ * @param storeId The unique store identifier
+ * @returns The dashboard store instance, or undefined if not found
+ */
+export declare function getDashboardStore(storeId: string): DashboardStore | undefined;
+/**
+ * Check if a store exists in the registry
+ *
+ * @param storeId The store ID to check
+ * @returns true if the store exists
+ */
+export declare function hasStore(storeId: string): boolean;
+/**
+ * Get all registered store IDs
+ *
+ * @returns Array of all registered store IDs
+ */
+export declare function getStoreIds(): string[];
+/**
+ * Register an existing store in the registry
+ *
+ * @param store The store instance to register
+ * @returns The store instance (for chaining)
+ * @throws Error if a store with the same ID already exists
+ *
+ * @example
+ * ```typescript
+ * const store = createItemStore({ type: 'bar-chart' });
+ * registerStore(store);
+ * // Now accessible via getStore(store.id)
+ * ```
+ */
+export declare function registerStore<T extends BaseStore<unknown>>(store: T): T;
+/**
+ * Create and register a new item store
+ *
+ * @param initialState Initial item state (optional)
+ * @param config Store configuration (optional)
+ * @param storeId Optional custom store ID (auto-generated if not provided)
+ * @returns The registered ItemStore instance
+ *
+ * @example
+ * ```typescript
+ * // Create stores
+ * const store1 = registerItemStore({ type: 'bar-chart' });
+ * const store2 = registerItemStore({ type: 'line-chart' });
+ *
+ * // Use store IDs in components
+ * element.storeId = store1.id;
+ * ```
+ */
+export declare function registerItemStore(initialState?: Partial<ItemState>, config?: ItemStoreConfig, storeId?: string): ItemStore;
+/**
+ * Create and register a new dashboard store
+ *
+ * @param initialState Initial dashboard state (optional)
+ * @param config Store configuration (optional)
+ * @param storeId Optional custom store ID (auto-generated if not provided)
+ * @returns The registered DashboardStore instance
+ *
+ * @example
+ * ```typescript
+ * // Create dashboard store
+ * const dashboardStore = registerDashboardStore({
+ *   views: [{ screenModus: 'desktop', options: {}, filters: [], items: [] }]
+ * });
+ *
+ * // Use in components
+ * dashboardElement.storeId = dashboardStore.id;
+ * ```
+ */
+export declare function registerDashboardStore(initialState?: Partial<DashboardState>, config?: DashboardStoreConfig, storeId?: string): DashboardStore;
+/**
+ * Remove a store from the registry
+ *
+ * Note: This does NOT destroy the store, only removes it from the registry.
+ * Call store.destroy() separately if you want to clean up the store.
+ *
+ * @param storeId The store ID to remove
+ * @returns true if the store was removed, false if it wasn't in the registry
+ *
+ * @example
+ * ```typescript
+ * const store = getStore(storeId);
+ * if (store) {
+ *   removeStore(storeId);
+ *   store.destroy(); // Clean up the store
+ * }
+ * ```
+ */
+export declare function removeStore(storeId: string): boolean;
+/**
+ * Remove and destroy a store
+ *
+ * Removes the store from the registry and calls destroy() on it.
+ *
+ * @param storeId The store ID to remove and destroy
+ * @returns true if the store was found and destroyed
+ *
+ * @example
+ * ```typescript
+ * destroyStore('my-store-id');
+ * ```
+ */
+export declare function destroyStore(storeId: string): boolean;
+/**
+ * Clear all stores from the registry
+ *
+ * Optionally destroys all stores before clearing.
+ *
+ * @param destroy If true, calls destroy() on each store before clearing
+ *
+ * @example
+ * ```typescript
+ * // Just clear the registry
+ * clearRegistry();
+ *
+ * // Clear and destroy all stores
+ * clearRegistry(true);
+ * ```
+ */
+export declare function clearRegistry(destroy?: boolean): void;

package/components/ad-hoc-slot-content-BwcFfXCV.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.
+ * */
+const e=require("./type-check-BehV9ZL1.cjs"),t=require("./slot-role-classification-2wChhpcq.cjs");var n=e=>typeof e==`string`&&e.trim().length>0,r=t=>!!(t&&n(t.formula)&&!t.formulaId&&!e.s(t.formula)),i=e=>!!(e&&n(e.expression)&&!e.columnId&&!e.column&&!e.formulaId&&!e.formula),a=e=>i(e)?e?.expression:r(e)?e?.formula:void 0,o=e=>e?.columnId??e?.formulaId??e?.column??e?.formula??e?.expression,s=(e,n)=>i(e)?!0:!e||!r(e)?!1:t.i({slotName:String(n.name??``),slotType:n.type,contentKind:t.r(e)})===`measure`;Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return a}});

package/components/ad-hoc-slot-content-hSlT62VS.js

@@ -0,0 +1,29 @@
+/*! * 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.
+ * */
+import { s as e } from "./type-check-CGREdneG.js";
+import { i as t, r as n } from "./slot-role-classification-B8bkGhQ_.js";
+//#region src/utils/slot-content/ad-hoc-slot-content.ts
+var r = (e) => typeof e == "string" && e.trim().length > 0, i = (t) => !!(t && r(t.formula) && !t.formulaId && !e(t.formula)), a = (e) => !!(e && r(e.expression) && !e.columnId && !e.column && !e.formulaId && !e.formula), o = (e) => a(e) ? e?.expression : i(e) ? e?.formula : void 0, s = (e) => e?.columnId ?? e?.formulaId ?? e?.column ?? e?.formula ?? e?.expression, c = (e, r) => a(e) ? !0 : !e || !i(e) ? !1 : t({
+	slotName: String(r.name ?? ""),
+	slotType: r.type,
+	contentKind: n(e)
+}) === "measure";
+//#endregion
+export { c as i, s as n, i as r, o as t };

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

@@ -1,11 +1,20 @@
 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';
+import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptProperties, AiPromptSavedAgentProperties, BuildAiPromptRequestContext } from './ai-prompt-types';
+export type { AiPromptAgent, AiPromptBuiltInAgentProperties, AiPromptImageInput, AiPromptCreateBody, AiPromptDeleteBody, AiPromptInput, AiPromptItemTask, AiPromptProperties, AiPromptPropertiesBase, AiPromptSavedAgentProperties, AiPromptScreenMode, BuildAiPromptRequestContext, DashboardStatePayload, LuzmoDashboardGeneratedEventDetail, LuzmoPromptSubmittedEventDetail, LuzmoRestoreRequestedEventDetail } from './ai-prompt-types';
+export { AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES, AI_PROMPT_MAX_ATTACHMENTS, assertValidAiPromptAttachmentFiles, assertValidAiPromptAttachmentUrls, isAiPromptAcceptedImageFile, isAiPromptAcceptedImageMimeType, isAiPromptAcceptedImageUrl } from '../../utils/ai-prompt';
 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;
+/**
+ * Properties for a saved Agent run. The agent id resolves datasets, capabilities and theme
+ * server-side, so `agent` and `task` are deliberately absent: sending either alongside
+ * `agent_id` is a 400. Chart and dashboard context still travel: a saved Agent runs as the
+ * universal agent, whose planner reads `item` and `dashboard` entries out of the current
+ * input, so dropping them would blind it to what the host is showing.
+ */
+export declare function buildSavedAgentAiPromptProperties(agentId: string, ctx: BuildAiPromptRequestContext): AiPromptSavedAgentProperties;
 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

@@ -149,13 +149,28 @@ export declare class LuzmoAiChat extends LuzmoElement {
      * When true, at least one dataset must be selected before the prompt can be submitted
      */
     requireDataset: boolean;
+    /** Enables image attachments (PNG/JPEG/WebP/GIF). */
+    allowImages: boolean;
+    /** Enables mic dictation; audio is transcribed via `POST /aidictation` and inserted as editable text. */
+    allowVoiceInput: boolean;
+    /** Attachment MIME types/extensions. Defaults to PNG/JPEG/WebP/GIF when `allow-images` is set. */
+    acceptedFileTypes: string[];
+    /** Optional upload override; otherwise uploads via `POST /upload` on attach. */
+    uploadAttachments?: (files: File[], options?: {
+        signal?: AbortSignal;
+    }) => Promise<string[]>;
     /**
      * Which aiprompt agent to use. Determines request payload and stream handling.
+     * With `agent-id` set it no longer shapes the request payload, only stream handling.
      * @default 'item'
      */
     agent: AiPromptAgent;
     /**
-     * Task for the item agent (`generate`, `suggest`, `describe`).
+     * Saved Agent id (UUID) to run the prompt as.
+     */
+    agentId?: string;
+    /**
+     * Task for the item agent (`generate`, `suggest`, `describe`). Ignored when `agent-id` is set.
      * @default 'generate'
      */
     task: AiPromptItemTask;
@@ -247,6 +262,7 @@ export declare class LuzmoAiChat extends LuzmoElement {
     get session(): AiChatSession | null;
     private _getRenderState;
     private _createDomBridgeCallbacks;
+    private get _resolvedAcceptedFileTypes();
     private _buildSessionConfig;
     private _emitConversationIdChanged;
     private _restoreViaSession;

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

@@ -1,3 +1,4 @@
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { Dataset, LuzmoChart } from '../../types';
 export type AiPromptAgent = 'item' | 'dashboard' | 'analyst';
 export type AiPromptItemTask = 'generate' | 'suggest' | 'describe';
@@ -26,10 +27,13 @@ export interface AiPromptDashboardInput {
     value: DashboardStatePayload;
     current_screen_mode?: AiPromptScreenMode;
 }
-export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput;
-export interface AiPromptProperties {
-    agent: AiPromptAgent;
-    task: AiPromptItemTask | 'generate';
+export interface AiPromptImageInput {
+    type: 'image';
+    url: string;
+}
+export type AiPromptInput = AiPromptTextInput | AiPromptDatasetInput | AiPromptItemInput | AiPromptDashboardInput | AiPromptImageInput;
+/** Fields both aiprompt create shapes share, whichever agent selector is used. */
+export interface AiPromptPropertiesBase {
     conversation_id?: string;
     locale_id?: string;
     timezone_id?: string;
@@ -37,6 +41,22 @@ export interface AiPromptProperties {
     response_mode: 'mixed';
     input: AiPromptInput[];
 }
+/** Built-in agent request: `agent` (plus `task`) selects the server-side behaviour. */
+export interface AiPromptBuiltInAgentProperties extends AiPromptPropertiesBase {
+    agent: AiPromptAgent;
+    task: AiPromptItemTask | 'generate';
+    agent_id?: never;
+}
+/**
+ * Saved Agent request: the agent id resolves datasets, capabilities and theme server-side.
+ * `agent_id` combined with `agent`, `task` or `capabilities` is a 400 — it is strictly one or the other.
+ */
+export interface AiPromptSavedAgentProperties extends AiPromptPropertiesBase {
+    agent_id: string;
+    agent?: never;
+    task?: never;
+}
+export type AiPromptProperties = AiPromptBuiltInAgentProperties | AiPromptSavedAgentProperties;
 export interface AiPromptCreateBody {
     key: string;
     token: string;
@@ -61,6 +81,7 @@ export interface BuildAiPromptRequestContext {
     authKey: string;
     authToken: string;
     conversationId: string | null;
+    agentId?: string;
     apiVersion?: string;
     stream?: boolean;
     localeId?: string;
@@ -71,6 +92,7 @@ export interface BuildAiPromptRequestContext {
     dashboard?: DashboardStatePayload | null;
     currentScreenMode?: AiPromptScreenMode;
     task?: AiPromptItemTask;
+    attachmentUrls?: string[];
 }
 export interface LuzmoPromptSubmittedEventDetail {
     prompt: string;
@@ -80,6 +102,8 @@ export interface LuzmoPromptSubmittedEventDetail {
     request: AiPromptCreateBody;
     url: string;
     signal?: AbortSignal;
+    attachments?: PromptBoxAttachment[];
+    attachmentUrls?: string[];
 }
 export interface LuzmoRestoreRequestedEventDetail {
     apiMessageId: string;

package/components/ai-chat/index.cjs

@@ -17,4 +17,4 @@
  * 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-DLDSaC7W.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;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../ai-interaction-textarea-CQBP9-DW.cjs"),t=require("../ai-chat-CBLWbv9C.cjs");exports.AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES=e.c,exports.AI_PROMPT_MAX_ATTACHMENTS=e.l,exports.AiChatSession=t.i,exports.AiChatSessionController=t.r,exports.LuzmoAiChat=t.n,exports.LuzmoAiChatEmptyState=t.E,exports.assertValidAiPromptAttachmentFiles=e.u,exports.assertValidAiPromptAttachmentUrls=e.d,exports.blobToBase64=e.n,exports.buildAiDictationRequest=e.r,exports.buildAiPromptDeleteRequest=t._,exports.buildAiPromptProperties=t.v,exports.buildAiPromptRequest=t.y,exports.buildAnalystAiPromptProperties=t.b,exports.buildDashboardAiPromptProperties=t.x,exports.buildItemAiPromptProperties=t.S,exports.buildSavedAgentAiPromptProperties=t.C,exports.chartToItemAsset=t.w,exports.createAiChatSession=t.a,exports.createInitialProgress=t.f,exports.createInitialStreamState=t.o,exports.createStreamHandler=t.s,exports.extractChartFromChunk=t.u,exports.extractDashboardFromChunk=t.d,exports.fetchStreamingResponse=t.m,exports.getAgentStreamDefinition=t.c,exports.getAiDictationUrl=e.i,exports.getAiPromptUrl=t.T,exports.getUploadUrl=e.o,exports.hasProgressChunk=t.p,exports.isAiPromptAcceptedImageFile=e.f,exports.isAiPromptAcceptedImageMimeType=e.p,exports.isAiPromptAcceptedImageUrl=e.m,exports.isRecognizedStep=t.t,exports.parseStreamLine=t.h,exports.processStreamChunk=t.l,exports.readNdjsonStream=t.g,exports.streamAiDictation=e.a,exports.uploadAiPromptImages=e.s;

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

@@ -5,6 +5,7 @@ declare global {
     }
 }
 export type { ProgressTreeNode, AssistantMessageAction, AssistantMessageActionConfirmVariant, AssistantMessageActionEventDetail, AiChatMessageSentEventDetail, AiChatDatasetsChangedEventDetail, AiChatConversationIdChangedEventDetail } from '../../types/ai-chat.types';
+export type { PromptBoxAttachment, PromptBoxFileIcons } from '../ai-interaction-textarea';
 export { isRecognizedStep } from './ai-chat-events';
 export type { AiChatCompleteEvent, AiChatRecognizedStepType, AiChatStepBase, AiChatStepEvent, RecognizedStepEvent, UnknownStepEvent } from './ai-chat-events';
 export { AiChatSession, AiChatSessionController, createAiChatSession } from './session';
@@ -15,6 +16,8 @@ export { LuzmoAiChatEmptyState } from './empty-state';
 export type { AiChatEmptyStateSuggestion, AiChatEmptyStateSuggestionSelectedDetail } from './empty-state';
 export * from './ai-prompt-types';
 export * from './ai-chat-request';
+export { getUploadUrl, uploadAiPromptImages, getAiDictationUrl, streamAiDictation, buildAiDictationRequest, blobToBase64 } from '../../utils/ai-prompt';
+export type { UploadAiPromptImagesOptions, AiDictationCreateBody, AiDictationProperties, BuildAiDictationRequestOptions, StreamAiDictationOptions } from '../../utils/ai-prompt';
 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

@@ -24,5 +24,6 @@
 		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-BBc330Jm.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 };
+import { a as e, c as t, d as n, f as r, i, l as a, m as o, n as s, o as c, p as l, r as u, s as d, u as f } from "../ai-interaction-textarea-Bgd3y_cP.js";
+import { C as p, E as m, S as h, T as g, _, a as v, b as y, c as b, d as x, f as S, g as C, h as w, i as T, l as E, m as D, n as O, o as k, p as A, r as j, s as M, t as N, u as P, v as F, w as I, x as L, y as R } from "../ai-chat-BtQaM37y.js";
+export { t as AI_PROMPT_ACCEPTED_IMAGE_MIME_TYPES, a as AI_PROMPT_MAX_ATTACHMENTS, T as AiChatSession, j as AiChatSessionController, O as LuzmoAiChat, m as LuzmoAiChatEmptyState, f as assertValidAiPromptAttachmentFiles, n as assertValidAiPromptAttachmentUrls, s as blobToBase64, u as buildAiDictationRequest, _ as buildAiPromptDeleteRequest, F as buildAiPromptProperties, R as buildAiPromptRequest, y as buildAnalystAiPromptProperties, L as buildDashboardAiPromptProperties, h as buildItemAiPromptProperties, p as buildSavedAgentAiPromptProperties, I as chartToItemAsset, v as createAiChatSession, S as createInitialProgress, k as createInitialStreamState, M as createStreamHandler, P as extractChartFromChunk, x as extractDashboardFromChunk, D as fetchStreamingResponse, b as getAgentStreamDefinition, i as getAiDictationUrl, g as getAiPromptUrl, c as getUploadUrl, A as hasProgressChunk, r as isAiPromptAcceptedImageFile, l as isAiPromptAcceptedImageMimeType, o as isAiPromptAcceptedImageUrl, N as isRecognizedStep, w as parseStreamLine, E as processStreamChunk, C as readNdjsonStream, e as streamAiDictation, d as uploadAiPromptImages };

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

@@ -40,6 +40,12 @@ export declare class AiChatSessionController {
      */
     syncProperties(changedProperties: Map<string, unknown>): void;
     requireSession(): AiChatSession;
+    /**
+     * Auth/API props from the element for host-owned sessions.
+     * Skips nullish chart/dashboard/screen mode so host-owned values are not wiped.
+     * Never touches host `fetchStreaming`.
+     */
+    private _mergeHostElementConfig;
     /** Re-attach UI bridge and state subscription after {@link teardown} on reconnect. */
     connect(): void;
     teardown(): void;

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

@@ -1,3 +1,4 @@
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { ProgressTreeNode } from '@luzmo/lucero/progress-steps';
 import type { AiSampleChart, ChatMessage, Dataset, LuzmoChart } from '../../../types';
 import type { AiChatCompleteEvent, AiChatStepEvent } from '../ai-chat-events';
@@ -5,6 +6,7 @@ import type { AiPromptAgent, AiPromptCreateBody, AiPromptDeleteBody, AiPromptIte
 import type { StreamingRequestOptions, StreamingResponse } from '../stream/transport';
 export interface AiChatSessionConfig {
     agent: AiPromptAgent;
+    agentId?: string;
     authKey: string;
     authToken: string;
     apiUrl?: string;
@@ -60,6 +62,13 @@ export interface AiChatSessionCallbacks {
      * with the same payload shape as the former `luzmo-prompt-submitted` event plus an abort signal. No built-in fetch.
      */
     onPromptSubmitted?: (detail: LuzmoPromptSubmittedEventDetail) => void | Promise<void>;
+    /**
+     * Optional image upload override. When omitted, images upload via `POST /upload`.
+     * Return one signed URL per file (same order).
+     */
+    uploadAttachments?: (files: File[], options?: {
+        signal?: AbortSignal;
+    }) => Promise<string[]>;
     /** Host-owned cleanup hook invoked for user-initiated prompt stops. */
     onPromptStopped?: () => void | Promise<void>;
     /**
@@ -75,6 +84,10 @@ export interface AiChatSessionSubmitParams {
     aiMessageId?: string;
     /** When true, does not append a user message (e.g. `initial-prompt` already in the transcript). */
     skipUserMessage?: boolean;
+    /** Local prompt-box files; uploaded unless `attachmentUrls` is set. */
+    attachments?: PromptBoxAttachment[];
+    /** Signed image URLs already uploaded (`{ type: 'image', url }` inputs). Skips upload. */
+    attachmentUrls?: string[];
 }
 export interface AiChatSessionRestoreParams {
     restoreToMessageId: string;

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

@@ -1,3 +1,4 @@
+import type { PromptBoxAttachment } from '@luzmo/lucero';
 import type { Dataset } from '../../../types';
 import type { AiPromptCreateBody, AiPromptDeleteBody, LuzmoPromptSubmittedEventDetail } from '../ai-prompt-types';
 import type { AiChatSessionCallbacks, AiChatSessionConfig, AiChatSessionRestoreParams, AiChatSessionRestoreResult, AiChatSessionState, AiChatSessionSubmitParams } from './ai-chat-session-types';
@@ -53,9 +54,19 @@ export declare class AiChatSession {
     removeDataset(datasetId: string): void;
     isDatasetRequirementMet(): boolean;
     getAiPromptUrl(): string;
-    buildRequestBody(prompt: string, datasetIds: string[]): AiPromptCreateBody;
+    buildRequestBody(prompt: string, datasetIds: string[], attachmentUrls?: string[]): AiPromptCreateBody;
     /** Same payload passed to {@link AiChatSessionCallbacks.onPromptSubmitted}. */
-    buildPromptSubmittedDetail(prompt: string, selectedDatasets: Dataset[], datasetIds: string[], signal?: AbortSignal): LuzmoPromptSubmittedEventDetail;
+    buildPromptSubmittedDetail(params: {
+        prompt: string;
+        selectedDatasets: Dataset[];
+        datasetIds: string[];
+        signal?: AbortSignal;
+        attachments?: PromptBoxAttachment[];
+        attachmentUrls?: string[];
+    }): LuzmoPromptSubmittedEventDetail;
+    /** Prefer provided URLs; otherwise upload via host callback or built-in `/upload`. */
+    private _resolveAttachmentUrls;
+    private _normalizeUploadedUrls;
     /**
      * Append the user prompt (unless `skipUserMessage`), start streaming, and update {@link state}.
      */