vite-plugin-smart-prefetch 0.3.3 → 0.3.5

package/dist/runtime 2/index.d.cts

@@ -0,0 +1,192 @@
+type PrefetchStrategy = 'auto' | 'hover' | 'visible' | 'idle' | 'hybrid';
+interface ModelConfig {
+    /** Model type */
+    type: 'probability' | 'ml' | 'hybrid';
+    /** Minimum probability threshold (0.0 - 1.0, default: 0.3) */
+    threshold: number;
+    /** Maximum routes to prefetch per page (default: 3) */
+    maxPrefetch: number;
+    /** How often to update the model */
+    updateInterval?: 'build' | 'daily' | 'weekly';
+}
+interface DataSourceMetadata {
+    /** Provider name */
+    provider: 'google-analytics' | 'firebase-analytics' | 'guess-js' | 'manual' | string;
+    /** Date range analyzed */
+    dateRange: string;
+    /** Total sessions analyzed */
+    totalSessions: number;
+    /** Total unique routes found */
+    totalRoutes?: number;
+}
+interface PrefetchTarget {
+    /** Target route to prefetch */
+    route: string;
+    /** Probability of transition (0.0 - 1.0) */
+    probability: number;
+    /** Number of observed transitions */
+    count: number;
+    /** Chunk file to prefetch (set by config generator) */
+    chunk?: string;
+    /** Dependency chunks to prefetch (extracted from Vite manifest imports) */
+    imports?: string[];
+    /** Priority level */
+    priority: 'high' | 'medium' | 'low';
+    /** Whether this is a manual rule */
+    manual?: boolean;
+}
+interface RouteMetadata {
+    /** Total transitions from this route */
+    totalTransitions: number;
+    /** Most common destination */
+    topDestination: string;
+    /** Average time spent on page (seconds) */
+    averageTimeOnPage?: number;
+}
+interface PrefetchConfig {
+    /** Schema version */
+    version: string;
+    /** Generation timestamp */
+    generatedAt: string;
+    /** Environment */
+    environment: string;
+    /** Data source info */
+    dataSource: DataSourceMetadata;
+    /** Model info */
+    model: {
+        type: ModelConfig['type'];
+        threshold: number;
+        maxPrefetch: number;
+        accuracy?: number;
+    };
+    /** Route predictions with chunk mappings */
+    routes: {
+        [sourceRoute: string]: {
+            prefetch: Array<PrefetchTarget & {
+                chunk: string;
+            }>;
+            metadata?: RouteMetadata;
+        };
+    };
+    /** Quick lookup: route -> chunk file */
+    chunks: {
+        [route: string]: string;
+    };
+}
+
+/**
+ * Prefetch Manager (Runtime)
+ * Manages route prefetching in the browser
+ */
+
+declare class PrefetchManager {
+    private config;
+    private prefetched;
+    private strategy;
+    private observer;
+    private debug;
+    constructor(strategy?: PrefetchStrategy, debug?: boolean);
+    /**
+     * Initialize the prefetch manager
+     * Loads configuration and sets up observers
+     */
+    init(): Promise<void>;
+    /**
+     * Prefetch routes based on current route
+     */
+    prefetch(currentRoute: string): void;
+    /**
+     * Prefetch a specific target
+     */
+    private prefetchTarget;
+    /**
+     * Hybrid strategy: prioritize based on probability
+     * FOR TESTING: Fetch all priorities to verify chunks are correct
+     */
+    private prefetchHybrid;
+    /**
+     * Prefetch during idle time
+     */
+    private prefetchOnIdle;
+    /**
+     * Inject prefetch link into DOM
+     */
+    private injectPrefetchLink;
+    /**
+     * Check if prefetching should be performed based on network conditions
+     */
+    private shouldPrefetch;
+    /**
+     * Initialize IntersectionObserver for 'visible' strategy
+     */
+    private initIntersectionObserver;
+    /**
+     * Observe an element for visibility-based prefetching
+     */
+    observeLink(element: HTMLElement, route: string): void;
+    /**
+     * Manually trigger prefetch for a specific route
+     * Useful for hover events
+     */
+    prefetchRoute(route: string): void;
+    /**
+     * Get prefetch statistics
+     */
+    getStats(): {
+        totalPrefetched: number;
+        prefetchedRoutes: string[];
+        configLoaded: boolean;
+        strategy: PrefetchStrategy;
+    };
+    /**
+     * Check if a route has been prefetched
+     */
+    isPrefetched(route: string): boolean;
+    /**
+     * Clear all prefetch state
+     */
+    clear(): void;
+    /**
+     * Get all prefetch link elements currently in the DOM
+     */
+    getActivePrefetchLinks(): HTMLLinkElement[];
+    /**
+     * Log current state for debugging
+     */
+    logDebugInfo(): void;
+    /**
+     * Log all prefetched pages and chunks (summary view)
+     */
+    logPrefetchSummary(): void;
+}
+
+/**
+ * Debug Utilities for Smart Prefetch Plugin
+ * Helper functions to inspect and debug prefetch behavior
+ */
+/**
+ * Get all prefetch link elements from the DOM
+ */
+declare function getPrefetchLinks(): HTMLLinkElement[];
+/**
+ * Get prefetch links added by our plugin (with data attributes)
+ */
+declare function getPluginPrefetchLinks(): HTMLLinkElement[];
+/**
+ * Log all prefetch links in a formatted way
+ */
+declare function logPrefetchLinks(): void;
+/**
+ * Monitor prefetch activity in real-time
+ */
+declare function monitorPrefetchActivity(): () => void;
+/**
+ * Check if the smart prefetch plugin is properly configured
+ */
+declare function checkPluginConfiguration(): void;
+/**
+ * Expose all debug utilities globally for console access
+ */
+declare function exposeDebugUtils(): void;
+
+export { type PrefetchConfig, PrefetchManager, type PrefetchStrategy, type PrefetchTarget, checkPluginConfiguration, exposeDebugUtils, getPluginPrefetchLinks, getPrefetchLinks, logPrefetchLinks, monitorPrefetchActivity };

package/dist/runtime 2/index.d.ts

@@ -0,0 +1,192 @@
+type PrefetchStrategy = 'auto' | 'hover' | 'visible' | 'idle' | 'hybrid';
+interface ModelConfig {
+    /** Model type */
+    type: 'probability' | 'ml' | 'hybrid';
+    /** Minimum probability threshold (0.0 - 1.0, default: 0.3) */
+    threshold: number;
+    /** Maximum routes to prefetch per page (default: 3) */
+    maxPrefetch: number;
+    /** How often to update the model */
+    updateInterval?: 'build' | 'daily' | 'weekly';
+}
+interface DataSourceMetadata {
+    /** Provider name */
+    provider: 'google-analytics' | 'firebase-analytics' | 'guess-js' | 'manual' | string;
+    /** Date range analyzed */
+    dateRange: string;
+    /** Total sessions analyzed */
+    totalSessions: number;
+    /** Total unique routes found */
+    totalRoutes?: number;
+}
+interface PrefetchTarget {
+    /** Target route to prefetch */
+    route: string;
+    /** Probability of transition (0.0 - 1.0) */
+    probability: number;
+    /** Number of observed transitions */
+    count: number;
+    /** Chunk file to prefetch (set by config generator) */
+    chunk?: string;
+    /** Dependency chunks to prefetch (extracted from Vite manifest imports) */
+    imports?: string[];
+    /** Priority level */
+    priority: 'high' | 'medium' | 'low';
+    /** Whether this is a manual rule */
+    manual?: boolean;
+}
+interface RouteMetadata {
+    /** Total transitions from this route */
+    totalTransitions: number;
+    /** Most common destination */
+    topDestination: string;
+    /** Average time spent on page (seconds) */
+    averageTimeOnPage?: number;
+}
+interface PrefetchConfig {
+    /** Schema version */
+    version: string;
+    /** Generation timestamp */
+    generatedAt: string;
+    /** Environment */
+    environment: string;
+    /** Data source info */
+    dataSource: DataSourceMetadata;
+    /** Model info */
+    model: {
+        type: ModelConfig['type'];
+        threshold: number;
+        maxPrefetch: number;
+        accuracy?: number;
+    };
+    /** Route predictions with chunk mappings */
+    routes: {
+        [sourceRoute: string]: {
+            prefetch: Array<PrefetchTarget & {
+                chunk: string;
+            }>;
+            metadata?: RouteMetadata;
+        };
+    };
+    /** Quick lookup: route -> chunk file */
+    chunks: {
+        [route: string]: string;
+    };
+}
+
+/**
+ * Prefetch Manager (Runtime)
+ * Manages route prefetching in the browser
+ */
+
+declare class PrefetchManager {
+    private config;
+    private prefetched;
+    private strategy;
+    private observer;
+    private debug;
+    constructor(strategy?: PrefetchStrategy, debug?: boolean);
+    /**
+     * Initialize the prefetch manager
+     * Loads configuration and sets up observers
+     */
+    init(): Promise<void>;
+    /**
+     * Prefetch routes based on current route
+     */
+    prefetch(currentRoute: string): void;
+    /**
+     * Prefetch a specific target
+     */
+    private prefetchTarget;
+    /**
+     * Hybrid strategy: prioritize based on probability
+     * FOR TESTING: Fetch all priorities to verify chunks are correct
+     */
+    private prefetchHybrid;
+    /**
+     * Prefetch during idle time
+     */
+    private prefetchOnIdle;
+    /**
+     * Inject prefetch link into DOM
+     */
+    private injectPrefetchLink;
+    /**
+     * Check if prefetching should be performed based on network conditions
+     */
+    private shouldPrefetch;
+    /**
+     * Initialize IntersectionObserver for 'visible' strategy
+     */
+    private initIntersectionObserver;
+    /**
+     * Observe an element for visibility-based prefetching
+     */
+    observeLink(element: HTMLElement, route: string): void;
+    /**
+     * Manually trigger prefetch for a specific route
+     * Useful for hover events
+     */
+    prefetchRoute(route: string): void;
+    /**
+     * Get prefetch statistics
+     */
+    getStats(): {
+        totalPrefetched: number;
+        prefetchedRoutes: string[];
+        configLoaded: boolean;
+        strategy: PrefetchStrategy;
+    };
+    /**
+     * Check if a route has been prefetched
+     */
+    isPrefetched(route: string): boolean;
+    /**
+     * Clear all prefetch state
+     */
+    clear(): void;
+    /**
+     * Get all prefetch link elements currently in the DOM
+     */
+    getActivePrefetchLinks(): HTMLLinkElement[];
+    /**
+     * Log current state for debugging
+     */
+    logDebugInfo(): void;
+    /**
+     * Log all prefetched pages and chunks (summary view)
+     */
+    logPrefetchSummary(): void;
+}
+
+/**
+ * Debug Utilities for Smart Prefetch Plugin
+ * Helper functions to inspect and debug prefetch behavior
+ */
+/**
+ * Get all prefetch link elements from the DOM
+ */
+declare function getPrefetchLinks(): HTMLLinkElement[];
+/**
+ * Get prefetch links added by our plugin (with data attributes)
+ */
+declare function getPluginPrefetchLinks(): HTMLLinkElement[];
+/**
+ * Log all prefetch links in a formatted way
+ */
+declare function logPrefetchLinks(): void;
+/**
+ * Monitor prefetch activity in real-time
+ */
+declare function monitorPrefetchActivity(): () => void;
+/**
+ * Check if the smart prefetch plugin is properly configured
+ */
+declare function checkPluginConfiguration(): void;
+/**
+ * Expose all debug utilities globally for console access
+ */
+declare function exposeDebugUtils(): void;
+
+export { type PrefetchConfig, PrefetchManager, type PrefetchStrategy, type PrefetchTarget, checkPluginConfiguration, exposeDebugUtils, getPluginPrefetchLinks, getPrefetchLinks, logPrefetchLinks, monitorPrefetchActivity };