@marketrix.ai/widget 3.8.53 → 3.8.117

package/dist/src/components/base/icons.d.ts

@@ -14,7 +14,6 @@ export interface IconData {
     paths: IconPath[];
 }
 export declare const icons: {
-    /** FaCheckCircle */
     readonly checkCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -22,7 +21,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaCircle */
     readonly circle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -30,7 +28,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaExclamationCircle */
     readonly exclamationCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -38,7 +35,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaTimesCircle */
     readonly timesCircle: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -46,7 +42,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaBan */
     readonly ban: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -54,7 +49,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaArrowUp */
     readonly arrowUp: {
         readonly viewBox: "0 0 448 512";
         readonly paths: [{
@@ -62,7 +56,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FaArrowDown */
     readonly arrowDown: {
         readonly viewBox: "0 0 448 512";
         readonly paths: [{
@@ -70,7 +63,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** FiX */
     readonly x: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -89,7 +81,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** IoChatbubbleEllipsesOutline */
     readonly chatBubble: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -109,7 +100,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** IoStop */
     readonly stop: {
         readonly viewBox: "0 0 512 512";
         readonly paths: [{
@@ -117,7 +107,6 @@ export declare const icons: {
             readonly fill: "currentColor";
         }];
     };
-    /** LuMousePointerClick */
     readonly mousePointerClick: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{
@@ -157,7 +146,6 @@ export declare const icons: {
             readonly strokeLinejoin: "round";
         }];
     };
-    /** SiTicktick */
     readonly ticktick: {
         readonly viewBox: "0 0 24 24";
         readonly paths: [{

package/dist/src/index.d.ts

@@ -33,10 +33,6 @@ export { getCurrentConfig };
  * Renders widget into parent container with shadow DOM
  */
 export declare const MarketrixWidget: React.FC<MarketrixWidgetProps>;
-/**
- * addWidget - Function that auto-detects mode and initializes widget
- * Supports preview, production, and dev modes
- */
 export declare const mountWidget: (config: AddWidgetConfig) => Promise<void>;
 export type { InstructionType } from './sdk';
 export type { AddWidgetConfig, ChatMessage, MarketrixConfig, MarketrixWidgetProps, WidgetState } from './types';

package/dist/src/services/ApiService.d.ts

@@ -2,17 +2,11 @@ import type { MarketrixConfig, SendMessageRequest, SendMessageResponse } from '.
 export declare class ApiService {
     private config;
     constructor(config: MarketrixConfig);
-    /**
-     * Get the current chat ID (does not create if missing)
-     */
     getChatId(): string | null;
     /**
      * Get user_id from various sources (config, localStorage, sessionStorage)
      */
     private getUserId;
-    /**
-     * Log widget question to action_log
-     */
     logWidgetQuestion(question: string, mode: string): Promise<void>;
     /**
      * Send a message via the typed stream (fire-and-forget).

package/dist/src/services/DomService.d.ts

@@ -1,6 +1,3 @@
-/**
- * Fingerprint of an indexed element for validation
- */
 export interface ElementFingerprint {
     tagName: string;
     id: string | null;
@@ -13,23 +10,14 @@ export interface ElementFingerprint {
     selector: string;
     indexVersion: number;
 }
-/**
- * Result of validating an element at a given index
- */
 export interface ValidationResult {
     isValid: boolean;
     mismatchReason?: 'element_removed' | 'element_changed';
 }
-/**
- * Result of looking up an element by index
- */
 export interface ElementLookupResult {
     element: HTMLElement | null;
     error?: string;
 }
-/**
- * Result of validated element lookup (includes validation info)
- */
 export interface ValidatedElementResult extends ElementLookupResult {
     validation: ValidationResult;
 }
@@ -43,13 +31,7 @@ export declare class DomService {
     private indexVersion;
     private constructor();
     static getInstance(): DomService;
-    /**
-     * Generate a unique CSS selector for an element
-     */
     private generateSelector;
-    /**
-     * Generate a fingerprint for an element to enable validation later
-     */
     private generateFingerprint;
     /**
      * Check if an element matches a stored fingerprint.
@@ -66,29 +48,14 @@ export declare class DomService {
      * Always clears previous index first.
      */
     indexInteractableElements(): Array<[number, Element]>;
-    /**
-     * Get element coordinates using getBoundingClientRect()
-     * Returns viewport-relative coordinates
-     */
     private getElementCoordinates;
-    /**
-     * Check if an element creates a stacking context
-     * Based on CSS stacking context rules
-     */
     private isStackingContext;
-    /**
-     * Calculate global z-order for an element
-     * Traverses up the DOM tree to identify stacking contexts and calculate z-order
-     */
     private calculateGlobalZOrder;
     /**
      * Get HTML snapshot with data-id attributes injected.
      * This re-indexes the live DOM and then produces a corresponding HTML string.
      */
     getSnapshotHtml(): string;
-    /**
-     * Get actionable elements metadata
-     */
     getInteractableElements(): Array<{
         index: number;
         fingerprint: ElementFingerprint;

package/dist/src/services/ScreenShareService.d.ts

@@ -8,12 +8,5 @@
  * @returns Promise resolving to the MediaStream
  */
 export declare function startScreenShare(): Promise<MediaStream>;
-/**
- * Stop screen sharing and clear the stream reference.
- */
 export declare function stopScreenShare(): void;
-/**
- * Check if screensharing is currently active.
- * @returns True if screensharing is active, false otherwise
- */
 export declare function isScreenSharing(): boolean;

package/dist/src/services/SessionManager.d.ts

@@ -9,13 +9,7 @@ declare class SessionManager {
     private chatId;
     private initializationPromise;
     private constructor();
-    /**
-     * Get singleton instance
-     */
     static getInstance(): SessionManager;
-    /**
-     * Get current chat ID without creating a new one
-     */
     getChatId(): string | null;
     /**
      * Get or create chat ID with promise-based locking

package/dist/src/services/SessionRecorder.d.ts

@@ -17,13 +17,7 @@ export declare class SessionRecorder {
     private consecutiveFailures;
     private isFlushing;
     constructor(chatId: string, applicationId: number);
-    /**
-     * Send rrweb/metadata command via POST
-     */
     private sendMetadata;
-    /**
-     * Buffer an event and trigger flush if thresholds are met
-     */
     private bufferEvent;
     /**
      * Flush buffered events via POST.
@@ -44,16 +38,7 @@ export declare class SessionRecorder {
      * Internal start implementation. Checks stopRequested at each async boundary.
      */
     private doStart;
-    /**
-     * Stop recording session. Flushes remaining events before stopping.
-     */
     stop(): void;
-    /**
-     * Get current session ID
-     */
     getSessionId(): string;
-    /**
-     * Check if recording is active
-     */
     isActive(): boolean;
 }

package/dist/src/services/StorageService.d.ts

@@ -22,9 +22,6 @@ import type { ChatMessage, InstructionType, MarketrixConfig } from '../types';
 type StoredMessage = Omit<ChatMessage, 'videoStream' | 'timestamp'> & {
     timestamp: string;
 };
-/**
- * Unified storage structure for all widget data
- */
 export interface MarketrixChatContext {
     chat_id: string | null;
     messages: StoredMessage[];
@@ -48,25 +45,10 @@ declare class StorageService {
     private context;
     private constructor();
     static getInstance(): StorageService;
-    /**
-     * Load context from localStorage
-     */
     private loadContext;
-    /**
-     * Save context to localStorage
-     */
     private saveContext;
-    /**
-     * Get the full context
-     */
     getContext(): MarketrixChatContext;
-    /**
-     * Update context with partial data
-     */
     updateContext(updates: Partial<MarketrixChatContext>): void;
-    /**
-     * Check if a string is a valid chat_id
-     */
     private isValidChatId;
     /**
      * Get chat_id with window.name fallback for cross-page navigation
@@ -85,9 +67,6 @@ declare class StorageService {
     getConfig(): MarketrixConfig | null;
     setConfig(config: MarketrixConfig | null): void;
     clear(): void;
-    /**
-     * Check if context exists and has a valid chat_id
-     */
     hasValidContext(): boolean;
 }
 export declare const storageService: StorageService;

package/dist/src/services/ValidationService.d.ts

@@ -20,13 +20,6 @@ export declare class ValidationService {
      * Handles both mtxId+mtxKey and mtxApp cases
      */
     validateConfig(config: MarketrixConfig): Promise<WidgetValidationResult>;
-    /**
-     * Validate by mtxId and mtxKey
-     */
     private validateByMarketrixId;
-    /**
-     * Validate by mtxApp directly
-     * Validates the application by ID
-     */
     private validateByApplication;
 }

package/dist/src/types/index.d.ts

@@ -86,10 +86,6 @@ export interface SendMessageResponse {
     task_id?: string;
 }
 export type WidgetPosition = WidgetSettingsData['widget_position'];
-/**
- * Configuration for addWidget function
- * Supports preview, production, and dev modes
- */
 export type AddWidgetConfig = ({
     settings: WidgetSettingsData;
     mtxId?: never;
@@ -119,9 +115,6 @@ export type AddWidgetConfig = ({
     /** Controls screen sharing prompts and button. When false, screen access requests are auto-denied and Share Screen button is hidden. Default: true */
     use_screenshare?: boolean;
 };
-/**
- * Props for MarketrixWidget React component
- */
 export interface MarketrixWidgetProps {
     settings: WidgetSettingsData;
     container?: HTMLElement;

package/dist/src/utils/apiUtils.d.ts

@@ -5,9 +5,6 @@ import type { MarketrixConfig } from '../types';
  * Consolidates error instanceof Error ? error.message : String(error)
  */
 export declare function extractErrorMessage(error: unknown, fallback?: string): string;
-/**
- * Handle API error with consistent error message extraction
- */
 export declare function handleApiError(error: unknown, context?: string, config?: Partial<MarketrixConfig>): {
     isValid: false;
     error: string;

package/dist/src/utils/bootstrap.d.ts

@@ -25,50 +25,16 @@ export declare const createWidgetContainer: (parentContainer?: HTMLElement, cont
  * @param previewMode - If true, disables network operations (for integration previews)
  */
 export declare const mountWidgetToContainer: (mountEl: HTMLElement, config: MarketrixConfig, previewMode?: boolean) => Root;
-/**
- * Destroy widget container
- * @param container - Container to destroy
- */
 export declare const destroyWidgetContainer: (container: HTMLElement) => void;
-/**
- * Get current widget instance
- */
 export declare const getWidgetInstance: () => Root | null;
-/**
- * Set widget instance
- */
 export declare const setWidgetInstance: (instance: Root | null) => void;
-/**
- * Get current configuration
- */
 export declare const getCurrentConfig: () => MarketrixConfig | null;
-/**
- * Set current configuration
- */
 export declare const setCurrentConfig: (config: MarketrixConfig | null) => void;
-/**
- * Check if widget is initialized
- */
 export declare const isWidgetInitialized: () => boolean;
-/**
- * Clear widget instance and config
- */
 export declare const clearWidgetState: () => void;
-/**
- * Set programmatic initialization in progress flag
- */
 export declare const setProgrammaticInitInProgress: (inProgress: boolean) => void;
-/**
- * Check if programmatic initialization is in progress
- */
 export declare const isProgrammaticInitInProgress: () => boolean;
-/**
- * Show widget settings loader with optional message
- */
 export declare const showWidgetSettingsLoader: (message?: string) => void;
-/**
- * Hide widget settings loader
- */
 export declare const hideWidgetSettingsLoader: () => void;
 /**
  * Auto-initialize widget from script tag attributes

package/dist/src/utils/chat.d.ts

@@ -5,21 +5,9 @@
  * - Removing thinking markers
  */
 import type { ChatMessage, InstructionType } from '../types';
-/**
- * Remove all __THINKING__ markers from message content
- */
 export declare function removeThinkingMarkers(content: string): string;
-/**
- * Remove thinking marker from end of content (for display)
- */
 export declare function removeThinkingMarkerFromEnd(content: string): string;
-/**
- * Check if content has thinking marker
- */
 export declare function hasThinkingMarker(content: string): boolean;
-/**
- * Add thinking marker to content
- */
 export declare function addThinkingMarker(content: string): string;
 /**
  * Message Finder Utility
@@ -56,21 +44,9 @@ export declare function findMessageForProgress(options: FindMessageOptions): {
  * Also the set that requires element highlighting in ToolService.
  */
 export declare const WAIT_FOR_USER_TOOLS: Set<string>;
-/**
- * Add a new progress step to a message
- */
 export declare function addProgressLine(message: ChatMessage, toolName: string, explanation: string): ChatMessage;
-/**
- * Mark the last incomplete progress step as completed
- */
 export declare function markProgressLineComplete(message: ChatMessage, toolName?: string): ChatMessage;
-/**
- * Mark the last incomplete progress step as failed
- */
 export declare function markProgressLineFailed(message: ChatMessage, toolName: string, error: string): ChatMessage;
-/**
- * Add or remove thinking marker based on task state
- */
 export declare function updateThinkingMarker(message: ChatMessage, isTaskRunning: boolean, currentMode: 'show' | 'tell' | 'do', isWaitingForUser?: boolean): ChatMessage;
 /**
  * Tool Name Mapping — derived from BROWSER_TOOLS (single source of truth).

package/dist/src/utils/{format.d.ts → color.d.ts}

@@ -1,26 +1,17 @@
 /**
  * Color utility functions for widget theming
  */
-/**
- * Converts hex color to RGB
- */
 export declare function hexToRgb(hex: string): {
     r: number;
     g: number;
     b: number;
 } | null;
-/**
- * Gets a contrasting color (white or black) based on the background color
- */
 export declare function getContrastingColor(color: string): string;
 /**
  * Adds opacity to a color
  * Supports hex colors (with or without #) and rgb/rgba strings
  */
 export declare function addOpacity(color: string, opacity: number): string;
-/**
- * Darkens a color by a specified amount (0-1)
- */
 export declare function darkenColor(color: string, amount: number): string;
 export declare const formatMessageTime: (date: Date | undefined) => string;
 export declare const getModeDisplayName: (mode: "show" | "tell" | "do") => string;

package/dist/src/utils/{common.d.ts → logger.d.ts}

@@ -4,9 +4,6 @@
  * Centralized logging utility with log levels and environment-based filtering.
  * Only logs in development mode to reduce noise in production.
  */
-/**
- * Create a scoped logger with a fixed prefix
- */
 export declare function createLogger(prefix: string): {
     debug: (message: string, ...args: unknown[]) => void;
     info: (message: string, ...args: unknown[]) => void;

package/dist/src/utils/validation.d.ts

@@ -5,15 +5,6 @@
  * These are shared utilities used across the codebase.
  */
 import type { WidgetSettingsData } from '../sdk';
-/**
- * Type guard for WidgetSettingsData
- */
 export declare function isWidgetSettingsData(data: unknown): data is WidgetSettingsData;
-/**
- * Type guard for HTMLElement
- */
 export declare function isHTMLElement(element: Element | null): element is HTMLElement;
-/**
- * Type guard for HTMLScriptElement
- */
 export declare function isHTMLScriptElement(element: Element | null): element is HTMLScriptElement;