@v-tilt/browser 1.10.2 → 1.10.6

package/dist/module.d.ts

@@ -268,6 +268,19 @@ interface AutocaptureOptions {
      * Example: ['[data-track]', '.track-click']
      */
     css_selector_allowlist?: string[];
+    /**
+     * CSS selectors to exclude from autocapture.
+     * If any element in the tree matches, the event is NOT captured.
+     *
+     * By default, common cookie consent banner patterns are excluded:
+     * - Elements with 'cookie', 'consent', 'gdpr', 'privacy' in id/class
+     * - Known consent management platforms (CookieBot, OneTrust, Iubenda, etc.)
+     *
+     * Set to empty array [] to disable default filtering.
+     *
+     * Example: ['#my-custom-banner', '[data-no-track]']
+     */
+    css_selector_ignorelist?: string[];
     /**
      * Element attributes to exclude from capture
      * Example: ['data-secret', 'aria-label']
@@ -1441,6 +1454,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)
  *
@@ -1609,6 +1694,7 @@ declare class VTilt {
     sessionRecording?: SessionRecordingWrapper;
     chat?: ChatWrapper;
     webVitals?: WebVitalsManager;
+    vtdOverlay?: VtdOverlay;
     private configManager;
     sessionManager: SessionManager;
     userManager: UserManager;
@@ -1665,6 +1751,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;
 }