@v-tilt/browser 1.10.1 → 1.10.4

package/dist/module.d.ts

@@ -287,6 +287,24 @@ interface AutocaptureOptions {
      * Overrides VTiltConfig.mask_all_element_attributes for autocapture specifically.
      */
     mask_all_element_attributes?: boolean;
+    /**
+     * Capture form field values on change events (default: false)
+     *
+     * When enabled, captures $el_value and $selected_text properties:
+     * - $el_value: The programmatic value (input.value, option.value, checkbox checked state)
+     * - $selected_text: Human-readable selection (option text, checkbox label)
+     *
+     * Protected by multiple privacy layers:
+     * - Password and hidden inputs are never captured
+     * - Fields with sensitive names (cc, pass, ssn, etc.) are skipped
+     * - Credit card and SSN patterns in values are filtered out
+     * - Elements with vt-sensitive or vt-no-capture classes are excluded
+     *
+     * Use case: Tracking search keywords, filter selections, etc.
+     *
+     * @default false
+     */
+    capture_element_values?: boolean;
 }
 /** Mask options for input elements in session recording */
 interface SessionRecordingMaskInputOptions {
@@ -1423,6 +1441,78 @@ declare class ChatWrapper implements Feature {
     private _onScriptLoaded;
 }
 
+/**
+ * VTD Overlay Feature
+ *
+ * Displays destination content in a fullscreen iframe overlay when vtd= URL parameter is present.
+ * Used for tracking links that redirect to specific content (video, page, etc.).
+ *
+ * Example: https://example.com/?vt=person_id&vtd=https://youtube.com/watch?v=abc123
+ *
+ * @see docs/architecture/proposals/vt-vtd-tracking-links.md
+ */
+
+interface VtdOverlayConfig {
+    /** Whether the overlay feature is enabled */
+    enabled?: boolean;
+}
+declare class VtdOverlay implements Feature {
+    readonly name = "VtdOverlay";
+    private _instance;
+    private _config;
+    private _isStarted;
+    private _destinationUrl;
+    private _originalUrl;
+    private _isLoading;
+    private _container;
+    private _iframe;
+    private _loadingEl;
+    constructor(instance: VTilt, config?: VtdOverlayConfig);
+    static extractConfig(config: VTiltConfig): VtdOverlayConfig;
+    get isEnabled(): boolean;
+    get isStarted(): boolean;
+    startIfEnabled(): void;
+    stop(): void;
+    onConfigUpdate(config: VTiltConfig): void;
+    /**
+     * Set the destination URL and show the overlay.
+     * Called by vtilt.ts when vtd= parameter is detected.
+     *
+     * @param url - The destination URL (can be URL-encoded)
+     */
+    setDestinationUrl(url: string): void;
+    /**
+     * Get the current destination URL.
+     */
+    getDestinationUrl(): string | null;
+    /**
+     * Close the overlay with animation.
+     */
+    close(): void;
+    private _isValidUrl;
+    /**
+     * Transform URLs to embeddable format for known platforms.
+     * Many sites block iframe embedding but provide dedicated embed URLs.
+     */
+    private _toEmbedUrl;
+    private _getHostname;
+    private _getFaviconUrl;
+    private _showOverlay;
+    private _destroyOverlay;
+    private _attachEventListeners;
+    private _getBackdropStyles;
+    private _getModalStyles;
+    private _getHeaderStyles;
+    private _getHeaderHTML;
+    private _getIframeWrapperStyles;
+    private _getLoadingStyles;
+    private _getLoadingHTML;
+    private _getIframeStyles;
+    private _getGlobalStyles;
+    private _truncateUrl;
+    private _escapeHtml;
+}
+
 /**
  * Request Queue - Event Batching (PostHog-style)
  *
@@ -1583,7 +1673,7 @@ declare class SimpleEventEmitter {
  */
 
 declare class VTilt {
-    readonly version = "1.10.1";
+    readonly version: string;
     __loaded: boolean;
     __request_queue: QueuedRequest[];
     historyAutocapture?: HistoryAutocapture;
@@ -1591,6 +1681,7 @@ declare class VTilt {
     sessionRecording?: SessionRecordingWrapper;
     chat?: ChatWrapper;
     webVitals?: WebVitalsManager;
+    vtdOverlay?: VtdOverlay;
     private configManager;
     sessionManager: SessionManager;
     userManager: UserManager;
@@ -1647,6 +1738,7 @@ declare class VTilt {
     private _setup_unload_handler;
     private _start_queue_if_opted_in;
     private _read_vt_param_from_url;
+    private _initVtdOverlay;
     _execute_array(array: any[]): void;
     _dom_loaded(): void;
 }