@salla.sa/ui-ai-kit-core 1.0.0

package/dist/types/components.d.ts

@@ -0,0 +1,860 @@
+/* eslint-disable */
+/* tslint:disable */
+/**
+ * This is an autogenerated file created by the Stencil compiler.
+ * It contains typing information for all components that exist in this project.
+ */
+import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { IconName } from "./utils/icon-registry";
+import { LoadingStep } from "./components/ai-loading/ai-loading";
+import { RatingValue } from "./components/ai-rating/ai-rating";
+export { IconName } from "./utils/icon-registry";
+export { LoadingStep } from "./components/ai-loading/ai-loading";
+export { RatingValue } from "./components/ai-rating/ai-rating";
+export namespace Components {
+    interface AiCard {
+        /**
+          * Remove the default padding
+          * @default false
+         */
+        "noPadding": boolean;
+        /**
+          * Remove the shadow
+          * @default false
+         */
+        "noShadow": boolean;
+    }
+    interface AiChatContainer {
+        /**
+          * Enable/disable auto-scroll to latest message
+          * @default true
+         */
+        "autoScroll": boolean;
+        /**
+          * Height of the panel when position='float'
+          * @default '600px'
+         */
+        "floatHeight": string;
+        /**
+          * Controls visibility of the chat panel
+          * @default false
+         */
+        "isOpen": boolean;
+        /**
+          * Position of the panel: 'left', 'right', or 'float'
+          * @default 'right'
+         */
+        "position": 'left' | 'right' | 'float';
+        /**
+          * Show AI watermark in the top half of the container
+          * @default false
+         */
+        "showWatermark": boolean;
+        /**
+          * Width of the panel (CSS value, e.g., '400px', '30%', '28rem')
+          * @default '28rem'
+         */
+        "width": string;
+    }
+    interface AiChatHeader {
+        /**
+          * Human mode: avatar image URL
+          * @default ''
+         */
+        "agentAvatar": string;
+        /**
+          * Human mode: agent's display name
+          * @default ''
+         */
+        "agentName": string;
+        /**
+          * Human mode: status label (e.g. "Active")
+          * @default ''
+         */
+        "agentStatus": string;
+        /**
+          * Agent mode: conversation title
+          * @default 'محادثة جديدة'
+         */
+        "conversation": string;
+        /**
+          * @default false
+         */
+        "isDraggable": boolean;
+        /**
+          * Layout variant
+          * @default 'agent'
+         */
+        "mode": 'agent' | 'human';
+        /**
+          * Human mode: show the back button
+          * @default true
+         */
+        "showBack": boolean;
+    }
+    interface AiChatMessage {
+        /**
+          * @default ''
+         */
+        "agentName": string;
+        /**
+          * @default ''
+         */
+        "content": string;
+        /**
+          * @default false
+         */
+        "enableRegenerate": boolean;
+        /**
+          * @default null
+         */
+        "feedbackValue": 'up' | 'down' | null;
+        /**
+          * @default 'text'
+         */
+        "format": 'text' | 'markdown';
+        /**
+          * @default 'user'
+         */
+        "role": 'user' | 'agent';
+        /**
+          * @default true
+         */
+        "showActions": boolean;
+        /**
+          * @default ''
+         */
+        "timestamp": string;
+    }
+    interface AiIcon {
+        /**
+          * Icon name from the registry
+         */
+        "name": IconName;
+        /**
+          * Size in pixels for width and height
+          * @default 16
+         */
+        "size": number;
+    }
+    interface AiLink {
+        /**
+          * Href URL
+          * @default '#'
+         */
+        "href": string;
+        /**
+          * Link display label
+          * @default ''
+         */
+        "label": string;
+        /**
+          * Rel attribute — defaults to noopener noreferrer for _blank
+          * @default ''
+         */
+        "rel": string;
+        /**
+          * Link target
+          * @default '_blank'
+         */
+        "target": '_blank' | '_self' | '_parent' | '_top';
+    }
+    interface AiLoading {
+        /**
+          * Whether steps card is collapsible
+          * @default true
+         */
+        "collapsible": boolean;
+        /**
+          * Steps mode expand state
+          * @default true
+         */
+        "expanded": boolean;
+        /**
+          * Steps mode title
+          * @default 'خطة التنفيذ'
+         */
+        "headerTitle": string;
+        /**
+          * Main mode switch
+          * @default 'thinking'
+         */
+        "mode": 'thinking' | 'steps';
+        /**
+          * Thinking mode status text
+          * @default 'جاري التفكير...'
+         */
+        "statusText": string;
+        /**
+          * Steps as JSON string array of LoadingStep
+          * @default '[]'
+         */
+        "steps": string;
+    }
+    interface AiMessageInput {
+        /**
+          * Whether the input is disabled
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Placeholder text for the textarea
+          * @default 'ايش في بالك؟'
+         */
+        "placeholder": string;
+        /**
+          * Set the textarea value programmatically (e.g. after speech-to-text transcription)
+         */
+        "setInputValue": (value: string) => Promise<void>;
+        /**
+          * Whether to show the voice recording button
+          * @default true
+         */
+        "showVoiceButton": boolean;
+    }
+    interface AiRating {
+        /**
+          * Disable interaction
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Main question label
+          * @default 'كيف كانت تجربتك؟'
+         */
+        "question": string;
+        /**
+          * Sub-label below the question
+          * @default 'رأيك يساعدنا نحسن الخدمة'
+         */
+        "subtitle": string;
+        /**
+          * Currently selected rating value (1–5)
+          * @default null
+         */
+        "value": RatingValue | null;
+    }
+    interface AiSuggestion {
+        /**
+          * Disabled state
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Suggestion text label
+          * @default ''
+         */
+        "label": string;
+    }
+    interface AiVoiceInput {
+        /**
+          * Whether to auto-start recording on mount
+          * @default false
+         */
+        "autoStart": boolean;
+        /**
+          * Whether the voice input is disabled
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Whether to show the waveform animation
+          * @default true
+         */
+        "showWaveform": boolean;
+    }
+}
+export interface AiChatHeaderCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiChatHeaderElement;
+}
+export interface AiChatMessageCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiChatMessageElement;
+}
+export interface AiLoadingCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiLoadingElement;
+}
+export interface AiMessageInputCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiMessageInputElement;
+}
+export interface AiRatingCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiRatingElement;
+}
+export interface AiSuggestionCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiSuggestionElement;
+}
+export interface AiVoiceInputCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLAiVoiceInputElement;
+}
+declare global {
+    interface HTMLAiCardElement extends Components.AiCard, HTMLStencilElement {
+    }
+    var HTMLAiCardElement: {
+        prototype: HTMLAiCardElement;
+        new (): HTMLAiCardElement;
+    };
+    interface HTMLAiChatContainerElement extends Components.AiChatContainer, HTMLStencilElement {
+    }
+    var HTMLAiChatContainerElement: {
+        prototype: HTMLAiChatContainerElement;
+        new (): HTMLAiChatContainerElement;
+    };
+    interface HTMLAiChatHeaderElementEventMap {
+        "closeClick": void;
+        "editClick": void;
+        "dropdownClick": void;
+        "moreClick": void;
+        "backClick": void;
+        "headerDragStart": { clientX: number; clientY: number };
+    }
+    interface HTMLAiChatHeaderElement extends Components.AiChatHeader, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiChatHeaderElementEventMap>(type: K, listener: (this: HTMLAiChatHeaderElement, ev: AiChatHeaderCustomEvent<HTMLAiChatHeaderElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiChatHeaderElementEventMap>(type: K, listener: (this: HTMLAiChatHeaderElement, ev: AiChatHeaderCustomEvent<HTMLAiChatHeaderElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiChatHeaderElement: {
+        prototype: HTMLAiChatHeaderElement;
+        new (): HTMLAiChatHeaderElement;
+    };
+    interface HTMLAiChatMessageElementEventMap {
+        "messageCopy": void;
+        "messageFeedback": 'up' | 'down';
+        "messageRegenerate": void;
+    }
+    interface HTMLAiChatMessageElement extends Components.AiChatMessage, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiChatMessageElementEventMap>(type: K, listener: (this: HTMLAiChatMessageElement, ev: AiChatMessageCustomEvent<HTMLAiChatMessageElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiChatMessageElementEventMap>(type: K, listener: (this: HTMLAiChatMessageElement, ev: AiChatMessageCustomEvent<HTMLAiChatMessageElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiChatMessageElement: {
+        prototype: HTMLAiChatMessageElement;
+        new (): HTMLAiChatMessageElement;
+    };
+    interface HTMLAiIconElement extends Components.AiIcon, HTMLStencilElement {
+    }
+    var HTMLAiIconElement: {
+        prototype: HTMLAiIconElement;
+        new (): HTMLAiIconElement;
+    };
+    interface HTMLAiLinkElement extends Components.AiLink, HTMLStencilElement {
+    }
+    var HTMLAiLinkElement: {
+        prototype: HTMLAiLinkElement;
+        new (): HTMLAiLinkElement;
+    };
+    interface HTMLAiLoadingElementEventMap {
+        "toggleExpand": boolean;
+        "stepClick": LoadingStep;
+    }
+    interface HTMLAiLoadingElement extends Components.AiLoading, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiLoadingElementEventMap>(type: K, listener: (this: HTMLAiLoadingElement, ev: AiLoadingCustomEvent<HTMLAiLoadingElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiLoadingElementEventMap>(type: K, listener: (this: HTMLAiLoadingElement, ev: AiLoadingCustomEvent<HTMLAiLoadingElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiLoadingElement: {
+        prototype: HTMLAiLoadingElement;
+        new (): HTMLAiLoadingElement;
+    };
+    interface HTMLAiMessageInputElementEventMap {
+        "sendMessage": string;
+        "voiceButtonClick": void;
+    }
+    interface HTMLAiMessageInputElement extends Components.AiMessageInput, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiMessageInputElementEventMap>(type: K, listener: (this: HTMLAiMessageInputElement, ev: AiMessageInputCustomEvent<HTMLAiMessageInputElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiMessageInputElementEventMap>(type: K, listener: (this: HTMLAiMessageInputElement, ev: AiMessageInputCustomEvent<HTMLAiMessageInputElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiMessageInputElement: {
+        prototype: HTMLAiMessageInputElement;
+        new (): HTMLAiMessageInputElement;
+    };
+    interface HTMLAiRatingElementEventMap {
+        "ratingChange": RatingValue;
+    }
+    interface HTMLAiRatingElement extends Components.AiRating, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiRatingElementEventMap>(type: K, listener: (this: HTMLAiRatingElement, ev: AiRatingCustomEvent<HTMLAiRatingElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiRatingElementEventMap>(type: K, listener: (this: HTMLAiRatingElement, ev: AiRatingCustomEvent<HTMLAiRatingElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiRatingElement: {
+        prototype: HTMLAiRatingElement;
+        new (): HTMLAiRatingElement;
+    };
+    interface HTMLAiSuggestionElementEventMap {
+        "suggestionClick": string;
+    }
+    interface HTMLAiSuggestionElement extends Components.AiSuggestion, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiSuggestionElementEventMap>(type: K, listener: (this: HTMLAiSuggestionElement, ev: AiSuggestionCustomEvent<HTMLAiSuggestionElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiSuggestionElementEventMap>(type: K, listener: (this: HTMLAiSuggestionElement, ev: AiSuggestionCustomEvent<HTMLAiSuggestionElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiSuggestionElement: {
+        prototype: HTMLAiSuggestionElement;
+        new (): HTMLAiSuggestionElement;
+    };
+    interface HTMLAiVoiceInputElementEventMap {
+        "audioRecorded": { blob: Blob; duration: number };
+        "recordingCancel": void;
+    }
+    interface HTMLAiVoiceInputElement extends Components.AiVoiceInput, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLAiVoiceInputElementEventMap>(type: K, listener: (this: HTMLAiVoiceInputElement, ev: AiVoiceInputCustomEvent<HTMLAiVoiceInputElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLAiVoiceInputElementEventMap>(type: K, listener: (this: HTMLAiVoiceInputElement, ev: AiVoiceInputCustomEvent<HTMLAiVoiceInputElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLAiVoiceInputElement: {
+        prototype: HTMLAiVoiceInputElement;
+        new (): HTMLAiVoiceInputElement;
+    };
+    interface HTMLElementTagNameMap {
+        "ai-card": HTMLAiCardElement;
+        "ai-chat-container": HTMLAiChatContainerElement;
+        "ai-chat-header": HTMLAiChatHeaderElement;
+        "ai-chat-message": HTMLAiChatMessageElement;
+        "ai-icon": HTMLAiIconElement;
+        "ai-link": HTMLAiLinkElement;
+        "ai-loading": HTMLAiLoadingElement;
+        "ai-message-input": HTMLAiMessageInputElement;
+        "ai-rating": HTMLAiRatingElement;
+        "ai-suggestion": HTMLAiSuggestionElement;
+        "ai-voice-input": HTMLAiVoiceInputElement;
+    }
+}
+declare namespace LocalJSX {
+    interface AiCard {
+        /**
+          * Remove the default padding
+          * @default false
+         */
+        "noPadding"?: boolean;
+        /**
+          * Remove the shadow
+          * @default false
+         */
+        "noShadow"?: boolean;
+    }
+    interface AiChatContainer {
+        /**
+          * Enable/disable auto-scroll to latest message
+          * @default true
+         */
+        "autoScroll"?: boolean;
+        /**
+          * Height of the panel when position='float'
+          * @default '600px'
+         */
+        "floatHeight"?: string;
+        /**
+          * Controls visibility of the chat panel
+          * @default false
+         */
+        "isOpen"?: boolean;
+        /**
+          * Position of the panel: 'left', 'right', or 'float'
+          * @default 'right'
+         */
+        "position"?: 'left' | 'right' | 'float';
+        /**
+          * Show AI watermark in the top half of the container
+          * @default false
+         */
+        "showWatermark"?: boolean;
+        /**
+          * Width of the panel (CSS value, e.g., '400px', '30%', '28rem')
+          * @default '28rem'
+         */
+        "width"?: string;
+    }
+    interface AiChatHeader {
+        /**
+          * Human mode: avatar image URL
+          * @default ''
+         */
+        "agentAvatar"?: string;
+        /**
+          * Human mode: agent's display name
+          * @default ''
+         */
+        "agentName"?: string;
+        /**
+          * Human mode: status label (e.g. "Active")
+          * @default ''
+         */
+        "agentStatus"?: string;
+        /**
+          * Agent mode: conversation title
+          * @default 'محادثة جديدة'
+         */
+        "conversation"?: string;
+        /**
+          * @default false
+         */
+        "isDraggable"?: boolean;
+        /**
+          * Layout variant
+          * @default 'agent'
+         */
+        "mode"?: 'agent' | 'human';
+        /**
+          * Back-arrow button (human mode)
+         */
+        "onBackClick"?: (event: AiChatHeaderCustomEvent<void>) => void;
+        /**
+          * Cancel / close button
+         */
+        "onCloseClick"?: (event: AiChatHeaderCustomEvent<void>) => void;
+        /**
+          * Title / chevron click → open conversation list (agent mode)
+         */
+        "onDropdownClick"?: (event: AiChatHeaderCustomEvent<void>) => void;
+        /**
+          * Pencil-edit button (agent mode)
+         */
+        "onEditClick"?: (event: AiChatHeaderCustomEvent<void>) => void;
+        /**
+          * Fired on pointerdown of the drag handle. Composed + bubbling so ai-chat-container can receive it across shadow roots.
+         */
+        "onHeaderDragStart"?: (event: AiChatHeaderCustomEvent<{ clientX: number; clientY: number }>) => void;
+        /**
+          * Chevron-down button (human mode)
+         */
+        "onMoreClick"?: (event: AiChatHeaderCustomEvent<void>) => void;
+        /**
+          * Human mode: show the back button
+          * @default true
+         */
+        "showBack"?: boolean;
+    }
+    interface AiChatMessage {
+        /**
+          * @default ''
+         */
+        "agentName"?: string;
+        /**
+          * @default ''
+         */
+        "content"?: string;
+        /**
+          * @default false
+         */
+        "enableRegenerate"?: boolean;
+        /**
+          * @default null
+         */
+        "feedbackValue"?: 'up' | 'down' | null;
+        /**
+          * @default 'text'
+         */
+        "format"?: 'text' | 'markdown';
+        "onMessageCopy"?: (event: AiChatMessageCustomEvent<void>) => void;
+        "onMessageFeedback"?: (event: AiChatMessageCustomEvent<'up' | 'down'>) => void;
+        "onMessageRegenerate"?: (event: AiChatMessageCustomEvent<void>) => void;
+        /**
+          * @default 'user'
+         */
+        "role"?: 'user' | 'agent';
+        /**
+          * @default true
+         */
+        "showActions"?: boolean;
+        /**
+          * @default ''
+         */
+        "timestamp"?: string;
+    }
+    interface AiIcon {
+        /**
+          * Icon name from the registry
+         */
+        "name"?: IconName;
+        /**
+          * Size in pixels for width and height
+          * @default 16
+         */
+        "size"?: number;
+    }
+    interface AiLink {
+        /**
+          * Href URL
+          * @default '#'
+         */
+        "href"?: string;
+        /**
+          * Link display label
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * Rel attribute — defaults to noopener noreferrer for _blank
+          * @default ''
+         */
+        "rel"?: string;
+        /**
+          * Link target
+          * @default '_blank'
+         */
+        "target"?: '_blank' | '_self' | '_parent' | '_top';
+    }
+    interface AiLoading {
+        /**
+          * Whether steps card is collapsible
+          * @default true
+         */
+        "collapsible"?: boolean;
+        /**
+          * Steps mode expand state
+          * @default true
+         */
+        "expanded"?: boolean;
+        /**
+          * Steps mode title
+          * @default 'خطة التنفيذ'
+         */
+        "headerTitle"?: string;
+        /**
+          * Main mode switch
+          * @default 'thinking'
+         */
+        "mode"?: 'thinking' | 'steps';
+        "onStepClick"?: (event: AiLoadingCustomEvent<LoadingStep>) => void;
+        "onToggleExpand"?: (event: AiLoadingCustomEvent<boolean>) => void;
+        /**
+          * Thinking mode status text
+          * @default 'جاري التفكير...'
+         */
+        "statusText"?: string;
+        /**
+          * Steps as JSON string array of LoadingStep
+          * @default '[]'
+         */
+        "steps"?: string;
+    }
+    interface AiMessageInput {
+        /**
+          * Whether the input is disabled
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Event emitted when a message is sent
+         */
+        "onSendMessage"?: (event: AiMessageInputCustomEvent<string>) => void;
+        /**
+          * Event emitted when the voice button is clicked — caller controls rendering the voice recorder
+         */
+        "onVoiceButtonClick"?: (event: AiMessageInputCustomEvent<void>) => void;
+        /**
+          * Placeholder text for the textarea
+          * @default 'ايش في بالك؟'
+         */
+        "placeholder"?: string;
+        /**
+          * Whether to show the voice recording button
+          * @default true
+         */
+        "showVoiceButton"?: boolean;
+    }
+    interface AiRating {
+        /**
+          * Disable interaction
+          * @default false
+         */
+        "disabled"?: boolean;
+        "onRatingChange"?: (event: AiRatingCustomEvent<RatingValue>) => void;
+        /**
+          * Main question label
+          * @default 'كيف كانت تجربتك؟'
+         */
+        "question"?: string;
+        /**
+          * Sub-label below the question
+          * @default 'رأيك يساعدنا نحسن الخدمة'
+         */
+        "subtitle"?: string;
+        /**
+          * Currently selected rating value (1–5)
+          * @default null
+         */
+        "value"?: RatingValue | null;
+    }
+    interface AiSuggestion {
+        /**
+          * Disabled state
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Suggestion text label
+          * @default ''
+         */
+        "label"?: string;
+        "onSuggestionClick"?: (event: AiSuggestionCustomEvent<string>) => void;
+    }
+    interface AiVoiceInput {
+        /**
+          * Whether to auto-start recording on mount
+          * @default false
+         */
+        "autoStart"?: boolean;
+        /**
+          * Whether the voice input is disabled
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Event emitted when audio blob is ready
+         */
+        "onAudioRecorded"?: (event: AiVoiceInputCustomEvent<{ blob: Blob; duration: number }>) => void;
+        /**
+          * Event emitted when recording is canceled
+         */
+        "onRecordingCancel"?: (event: AiVoiceInputCustomEvent<void>) => void;
+        /**
+          * Whether to show the waveform animation
+          * @default true
+         */
+        "showWaveform"?: boolean;
+    }
+
+    interface AiCardAttributes {
+        "noPadding": boolean;
+        "noShadow": boolean;
+    }
+    interface AiChatContainerAttributes {
+        "isOpen": boolean;
+        "position": 'left' | 'right' | 'float';
+        "width": string;
+        "autoScroll": boolean;
+        "showWatermark": boolean;
+        "floatHeight": string;
+    }
+    interface AiChatHeaderAttributes {
+        "mode": 'agent' | 'human';
+        "conversation": string;
+        "agentName": string;
+        "agentStatus": string;
+        "agentAvatar": string;
+        "showBack": boolean;
+        "isDraggable": boolean;
+    }
+    interface AiChatMessageAttributes {
+        "role": 'user' | 'agent';
+        "content": string;
+        "format": 'text' | 'markdown';
+        "agentName": string;
+        "timestamp": string;
+        "showActions": boolean;
+        "enableRegenerate": boolean;
+        "feedbackValue": 'up' | 'down' | null;
+    }
+    interface AiIconAttributes {
+        "name": IconName;
+        "size": number;
+    }
+    interface AiLinkAttributes {
+        "label": string;
+        "href": string;
+        "target": '_blank' | '_self' | '_parent' | '_top';
+        "rel": string;
+    }
+    interface AiLoadingAttributes {
+        "mode": 'thinking' | 'steps';
+        "statusText": string;
+        "steps": string;
+        "headerTitle": string;
+        "expanded": boolean;
+        "collapsible": boolean;
+    }
+    interface AiMessageInputAttributes {
+        "placeholder": string;
+        "disabled": boolean;
+        "showVoiceButton": boolean;
+    }
+    interface AiRatingAttributes {
+        "question": string;
+        "subtitle": string;
+        "value": RatingValue | null;
+        "disabled": boolean;
+    }
+    interface AiSuggestionAttributes {
+        "label": string;
+        "disabled": boolean;
+    }
+    interface AiVoiceInputAttributes {
+        "disabled": boolean;
+        "showWaveform": boolean;
+        "autoStart": boolean;
+    }
+
+    interface IntrinsicElements {
+        "ai-card": Omit<AiCard, keyof AiCardAttributes> & { [K in keyof AiCard & keyof AiCardAttributes]?: AiCard[K] } & { [K in keyof AiCard & keyof AiCardAttributes as `attr:${K}`]?: AiCardAttributes[K] } & { [K in keyof AiCard & keyof AiCardAttributes as `prop:${K}`]?: AiCard[K] };
+        "ai-chat-container": Omit<AiChatContainer, keyof AiChatContainerAttributes> & { [K in keyof AiChatContainer & keyof AiChatContainerAttributes]?: AiChatContainer[K] } & { [K in keyof AiChatContainer & keyof AiChatContainerAttributes as `attr:${K}`]?: AiChatContainerAttributes[K] } & { [K in keyof AiChatContainer & keyof AiChatContainerAttributes as `prop:${K}`]?: AiChatContainer[K] };
+        "ai-chat-header": Omit<AiChatHeader, keyof AiChatHeaderAttributes> & { [K in keyof AiChatHeader & keyof AiChatHeaderAttributes]?: AiChatHeader[K] } & { [K in keyof AiChatHeader & keyof AiChatHeaderAttributes as `attr:${K}`]?: AiChatHeaderAttributes[K] } & { [K in keyof AiChatHeader & keyof AiChatHeaderAttributes as `prop:${K}`]?: AiChatHeader[K] };
+        "ai-chat-message": Omit<AiChatMessage, keyof AiChatMessageAttributes> & { [K in keyof AiChatMessage & keyof AiChatMessageAttributes]?: AiChatMessage[K] } & { [K in keyof AiChatMessage & keyof AiChatMessageAttributes as `attr:${K}`]?: AiChatMessageAttributes[K] } & { [K in keyof AiChatMessage & keyof AiChatMessageAttributes as `prop:${K}`]?: AiChatMessage[K] };
+        "ai-icon": Omit<AiIcon, keyof AiIconAttributes> & { [K in keyof AiIcon & keyof AiIconAttributes]?: AiIcon[K] } & { [K in keyof AiIcon & keyof AiIconAttributes as `attr:${K}`]?: AiIconAttributes[K] } & { [K in keyof AiIcon & keyof AiIconAttributes as `prop:${K}`]?: AiIcon[K] };
+        "ai-link": Omit<AiLink, keyof AiLinkAttributes> & { [K in keyof AiLink & keyof AiLinkAttributes]?: AiLink[K] } & { [K in keyof AiLink & keyof AiLinkAttributes as `attr:${K}`]?: AiLinkAttributes[K] } & { [K in keyof AiLink & keyof AiLinkAttributes as `prop:${K}`]?: AiLink[K] };
+        "ai-loading": Omit<AiLoading, keyof AiLoadingAttributes> & { [K in keyof AiLoading & keyof AiLoadingAttributes]?: AiLoading[K] } & { [K in keyof AiLoading & keyof AiLoadingAttributes as `attr:${K}`]?: AiLoadingAttributes[K] } & { [K in keyof AiLoading & keyof AiLoadingAttributes as `prop:${K}`]?: AiLoading[K] };
+        "ai-message-input": Omit<AiMessageInput, keyof AiMessageInputAttributes> & { [K in keyof AiMessageInput & keyof AiMessageInputAttributes]?: AiMessageInput[K] } & { [K in keyof AiMessageInput & keyof AiMessageInputAttributes as `attr:${K}`]?: AiMessageInputAttributes[K] } & { [K in keyof AiMessageInput & keyof AiMessageInputAttributes as `prop:${K}`]?: AiMessageInput[K] };
+        "ai-rating": Omit<AiRating, keyof AiRatingAttributes> & { [K in keyof AiRating & keyof AiRatingAttributes]?: AiRating[K] } & { [K in keyof AiRating & keyof AiRatingAttributes as `attr:${K}`]?: AiRatingAttributes[K] } & { [K in keyof AiRating & keyof AiRatingAttributes as `prop:${K}`]?: AiRating[K] };
+        "ai-suggestion": Omit<AiSuggestion, keyof AiSuggestionAttributes> & { [K in keyof AiSuggestion & keyof AiSuggestionAttributes]?: AiSuggestion[K] } & { [K in keyof AiSuggestion & keyof AiSuggestionAttributes as `attr:${K}`]?: AiSuggestionAttributes[K] } & { [K in keyof AiSuggestion & keyof AiSuggestionAttributes as `prop:${K}`]?: AiSuggestion[K] };
+        "ai-voice-input": Omit<AiVoiceInput, keyof AiVoiceInputAttributes> & { [K in keyof AiVoiceInput & keyof AiVoiceInputAttributes]?: AiVoiceInput[K] } & { [K in keyof AiVoiceInput & keyof AiVoiceInputAttributes as `attr:${K}`]?: AiVoiceInputAttributes[K] } & { [K in keyof AiVoiceInput & keyof AiVoiceInputAttributes as `prop:${K}`]?: AiVoiceInput[K] };
+    }
+}
+export { LocalJSX as JSX };
+declare module "@stencil/core" {
+    export namespace JSX {
+        interface IntrinsicElements {
+            "ai-card": LocalJSX.IntrinsicElements["ai-card"] & JSXBase.HTMLAttributes<HTMLAiCardElement>;
+            "ai-chat-container": LocalJSX.IntrinsicElements["ai-chat-container"] & JSXBase.HTMLAttributes<HTMLAiChatContainerElement>;
+            "ai-chat-header": LocalJSX.IntrinsicElements["ai-chat-header"] & JSXBase.HTMLAttributes<HTMLAiChatHeaderElement>;
+            "ai-chat-message": LocalJSX.IntrinsicElements["ai-chat-message"] & JSXBase.HTMLAttributes<HTMLAiChatMessageElement>;
+            "ai-icon": LocalJSX.IntrinsicElements["ai-icon"] & JSXBase.HTMLAttributes<HTMLAiIconElement>;
+            "ai-link": LocalJSX.IntrinsicElements["ai-link"] & JSXBase.HTMLAttributes<HTMLAiLinkElement>;
+            "ai-loading": LocalJSX.IntrinsicElements["ai-loading"] & JSXBase.HTMLAttributes<HTMLAiLoadingElement>;
+            "ai-message-input": LocalJSX.IntrinsicElements["ai-message-input"] & JSXBase.HTMLAttributes<HTMLAiMessageInputElement>;
+            "ai-rating": LocalJSX.IntrinsicElements["ai-rating"] & JSXBase.HTMLAttributes<HTMLAiRatingElement>;
+            "ai-suggestion": LocalJSX.IntrinsicElements["ai-suggestion"] & JSXBase.HTMLAttributes<HTMLAiSuggestionElement>;
+            "ai-voice-input": LocalJSX.IntrinsicElements["ai-voice-input"] & JSXBase.HTMLAttributes<HTMLAiVoiceInputElement>;
+        }
+    }
+}