@luzmo/analytics-components-kit 1.0.8 → 1.0.9-beta.1

package/components/ai-interaction-textarea/ai-interaction-textarea.d.ts

@@ -0,0 +1,232 @@
+import '@luzmo/lucero/action-button';
+import '@luzmo/lucero/icon';
+import '@luzmo/lucero/prompt-box';
+import { LitElement, PropertyValues, TemplateResult } from 'lit';
+import type { Agent } from '../../types/agent.types';
+import type { Dataset } from '../../types/dataset.types';
+import type { PromptBoxAttachment, PromptBoxFileIcons } from './types';
+import '../dataset-icon';
+import '../dataset-selector-row';
+/**
+ * @customElement luzmo-ai-interaction-textarea
+ * @summary A textarea for AI interaction with dataset selection. Uses Lucero `luzmo-prompt-box` for visuals; theme it with `--luzmo-prompt-box-*` on this host or an ancestor.
+ * @fires {CustomEvent<PromptSubmittedEventDetail>} prompt-submitted - Fired when a prompt is submitted with selected datasets
+ * @fires {CustomEvent<void>} prompt-stopped - Fired when a running prompt is stopped
+ *
+ * @property {boolean} disabled - When true, disables the entire component (opacity 60%, no interactions)
+ * @property {boolean} single-line - When true, starts in compact single-line mode and auto-expands as needed
+ * @property {boolean} hide-dataset-button - When true, hides the "+ Add dataset" button
+ * @property {boolean} hide-dataset-icons - When true, hides dataset-specific icons in selector tags and `@` mention dataset headers
+ * @property {number} max-visible-selected-datasets - Maximum number of selected dataset tags shown before the overflow control (default: 5)
+ * @property {boolean} disable-dataset-modification - When true, disables the "+ Add dataset" button and disables dataset pill removal
+ * @property {boolean} hide-selected-datasets - When true, hides the dataset row entirely
+ * @property {boolean} hide-agents - When true, hides the Agents section in the add dropdown and ignores `selectedAgent` for `require-dataset` and `prompt-submitted`
+ * @property {boolean} disable-column-mentions - When true, disables `@` trigger mentions completely
+ * @property {boolean} is-generating - When true, shows a spinning loader icon instead of the submit arrow
+ * @property {boolean} stoppable - When true, shows a stop control while `is-generating` is true
+ * @property {string} value - The current value of the textarea (can be controlled from parent to clear or set text)
+ * @property {boolean} retain-on-submit - When true, retains the input value after submission (default: false, clears on submit)
+ * @property {boolean} require-dataset - When true, a selected agent or at least one selected dataset is required before the prompt can be submitted
+ * @property {boolean} allow-images - When true, enables image attachments (paste or file picker); uploads eagerly on attach
+ * @property {boolean} allow-voice-input - When true, shows Lucero mic recording and streams transcript via `POST /aidictation`
+ * @property {string[]} accepted-file-types - Accepted MIME types or extensions for attachments (e.g. `image/png`, `.webp`)
+ * @property {string} api-version - API version for built-in `POST /upload` and `/aidictation` (default `0.1.0`)
+ * @property {Function} uploadAttachments - Optional override for eager image upload on attach; return one signed URL per file
+ *
+ * @property {string} --luzmo-ai-interaction-textarea-disabled-opacity - Opacity of the host when `disabled` (does not map to Lucero prompt-box tokens)
+ */
+export declare class LuzmoAiInteractionTextarea extends LitElement {
+    static styles: import("lit").CSSResult;
+    static tagName: string;
+    /**
+     * Placeholder text for the textarea
+     */
+    placeholder: string;
+    /**
+     * Array of selected datasets
+     */
+    selectedDatasets: Dataset[];
+    /**
+     * 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, shows public datasets alongside the user's other datasets. */
+    includePublicDatasets: boolean;
+    /**
+     * Alias for includePublicDatasets.
+     * @deprecated Use includePublicDatasets instead.
+     */
+    get flagOpendata(): boolean;
+    set flagOpendata(value: boolean);
+    /**
+     * When true, disables the entire component (sets opacity to 60% and prevents all interactions)
+     */
+    disabled: boolean;
+    /**
+     * When true, starts in compact single-line mode and auto-expands as needed
+     */
+    singleLine: boolean;
+    /**
+     * When true, hides the "+ Add dataset" button
+     */
+    hideDatasetButton: boolean;
+    /**
+     * When true, hides dataset-specific icons in selector tags and @ mention dataset headers
+     */
+    hideDatasetIcons: boolean;
+    /** Maximum number of selected dataset tags shown before the overflow control. */
+    maxVisibleSelectedDatasets: number;
+    /**
+     * The saved Agent the prompt is scoped to, or null
+     */
+    selectedAgent: Agent | null;
+    /**
+     * When true, hides the Agents section in the add dropdown and ignores `selectedAgent` for `require-dataset` and `prompt-submitted`
+     */
+    hideAgents: boolean;
+    /**
+     * When true, disables the "+ Add dataset" button and disables dataset pill removal
+     */
+    disableDatasetModification: boolean;
+    /**
+     * When true, hides the dataset row entirely
+     */
+    hideSelectedDatasets: boolean;
+    /**
+     * When true, disables @ trigger mentions completely
+     */
+    disableColumnMentions: boolean;
+    /**
+     * When true, shows a spinning loader icon instead of the submit arrow
+     */
+    isGenerating: boolean;
+    /**
+     * When true, shows a stop control on the prompt box while `isGenerating` is true
+     */
+    stoppable: boolean;
+    /**
+     * The current value of the textarea (controlled from parent)
+     */
+    value: string;
+    /**
+     * When true, retains the input value after submitting a prompt (default: false)
+     * When false (default), clears the textarea value after submission
+     */
+    retainOnSubmit: boolean;
+    /**
+     * When true, a selected agent or at least one selected dataset is required before the prompt can be submitted
+     */
+    requireDataset: boolean;
+    /** When true, enables image attachments via paste or the file picker. */
+    allowImages: boolean;
+    /** When true, shows Lucero's mic control; the `POST /aidictation` transcript is inserted, never auto-sent. */
+    allowVoiceInput: boolean;
+    /** Accepted attachment MIME types or extensions. */
+    acceptedFileTypes: string[];
+    /** API version for built-in `POST /upload` and `POST /aidictation` (default `0.1.0`). */
+    apiVersion: string;
+    /** Optional upload override; return one signed URL per file. */
+    uploadAttachments?: (files: File[], options?: {
+        signal?: AbortSignal;
+    }) => Promise<string[]>;
+    /** Custom icons for non-image attachment tiles, keyed by extension. */
+    fileIcons: PromptBoxFileIcons;
+    private _promptValue;
+    private _isPromptValid;
+    private _fieldTriggerOptions;
+    private _datasetsFieldConfig;
+    private _attachmentError;
+    /** True while Lucero is capturing microphone audio. */
+    private _isRecording;
+    /** True while `/aidictation` is in flight (awaiting / streaming transcript). */
+    private _isTranscribing;
+    private _activeFieldRequestId;
+    private readonly _attachmentUploads;
+    private _pendingAttachmentSync;
+    private _attachmentSyncScheduled;
+    private _attachmentErrorClearHandle;
+    private _submitInProgress;
+    /** True from the start of a voice session until it completes, fails, or is cancelled. */
+    private _voiceSessionActive;
+    /** Exact prompt contents from when the current voice session started. */
+    private _preRecordingValue;
+    /** Text before the insert point (cursor at recording start). */
+    private _voicePrefix;
+    /** Text after the insert point (cursor at recording start). */
+    private _voiceSuffix;
+    /** Accumulated transcript for the current dictation request. */
+    private _streamedTranscript;
+    private _transcriptionController;
+    private _promptBox?;
+    private get _voiceBusy();
+    private get _buttonDisabled();
+    private get _activeAgent();
+    private get _promptPending();
+    private get _promptReadonly();
+    private get _actionsDisabled();
+    private get _fieldTriggers();
+    private _renderFieldTriggerIcon;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _configureBroker;
+    private _handlePromptInput;
+    openFilePicker(): void;
+    addFiles(files: File[]): string[];
+    removeAttachment(id: string): void;
+    setAttachmentLoading(id: string, loading: boolean): void;
+    clearAttachments(): void;
+    getAttachments(): PromptBoxAttachment[];
+    getAttachmentUrls(attachments?: PromptBoxAttachment[]): string[];
+    private _handleAttachClick;
+    private _showAttachmentError;
+    private _cleanupAttachmentUpload;
+    private _abortAllAttachmentUploads;
+    private _uploadSingleFile;
+    private _startAttachmentUpload;
+    private _handleAttachmentsChange;
+    private _syncAttachments;
+    private _waitForAttachmentUploads;
+    private _submitPrompt;
+    private _handleDatasetSelected;
+    private _handleDatasetRemoved;
+    private _handleAgentSelected;
+    private _handleAgentRemoved;
+    private _getLocalizedFieldLabel;
+    private _mapColumnToTriggerOption;
+    private _mapFormulaToTriggerOption;
+    private _updateFieldTriggerOptionsFromConfig;
+    private _refreshDatasetsFieldConfig;
+    private _handlePromptSubmit;
+    private _handlePromptStop;
+    private _handleVoiceKeydown;
+    private _getCaretTextOffset;
+    private _setPromptText;
+    private _captureVoiceInsertPoint;
+    private _applyStreamedTranscript;
+    private _resetVoiceSessionState;
+    private _abortTranscription;
+    private _cancelVoiceSession;
+    private _handleRecord;
+    private _handleRecordCancel;
+    private _handleRecordError;
+    private _handleRecordingComplete;
+    private _transcribeRecording;
+    private _syncControlledValueToPromptBox;
+    protected willUpdate(changedProperties: PropertyValues): void;
+    protected updated(changedProperties: PropertyValues): void;
+    protected render(): TemplateResult;
+}

package/components/ai-interaction-textarea/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-interaction-textarea-CmFGJzbb.cjs");Object.defineProperty(exports,"LuzmoAiInteractionTextarea",{enumerable:!0,get:function(){return e.t}});

package/components/ai-interaction-textarea/index.d.ts

@@ -0,0 +1,10 @@
+import { LuzmoAiInteractionTextarea } from './ai-interaction-textarea';
+declare global {
+    interface HTMLElementTagNameMap {
+        'luzmo-ai-interaction-textarea': LuzmoAiInteractionTextarea;
+    }
+}
+export { LuzmoAiInteractionTextarea } from './ai-interaction-textarea';
+export type { PromptBoxAttachment, PromptBoxFileIcons, PromptSubmittedEventDetail } from './types';
+export type { Agent } from '../../types/agent.types';
+export type { Dataset } from '../../types/dataset.types';

package/components/ai-interaction-textarea/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-shadow-color-rgb: 0, 0, 0;--luzmo-shadow-opacity: 0.1;--luzmo-shadow-color: rgba(var(--luzmo-shadow-color-rgb), var(--luzmo-shadow-opacity));--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 { t as e } from "../ai-interaction-textarea-BXKG2elT.js";
+export { e as LuzmoAiInteractionTextarea };

package/components/ai-interaction-textarea/types.d.ts

@@ -0,0 +1,12 @@
+import type { PromptBoxAttachment, PromptBoxFileIcons } from '@luzmo/lucero';
+import type { Agent } from '../../types/agent.types';
+import type { Dataset } from '../../types/dataset.types';
+export type { PromptBoxAttachment, PromptBoxFileIcons };
+export interface PromptSubmittedEventDetail {
+    prompt: string;
+    selectedDatasets: Dataset[];
+    selectedAgent: Agent | null;
+    attachments: PromptBoxAttachment[];
+    /** Signed image URLs from eager upload on attach, ordered to match image attachments. */
+    attachmentUrls: string[];
+}