@buenojs/bueno 0.8.9 → 0.8.11

package/dist/frontend/hmr.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Hot Module Replacement (HMR) Implementation
+ *
+ * Provides live updates without full page refreshes for a better developer experience.
+ * Supports React Fast Refresh, Vue Hot Component Replacement, Svelte HMR, and Solid Hot Reloading.
+ *
+ * @module frontend/hmr
+ */
+import type { FrontendFramework, HMRConfig, HMRUpdate, HMRUpdateError } from "./types.js";
+/**
+ * Manages Hot Module Replacement for the development server.
+ *
+ * Features:
+ * - WebSocket server for client communication
+ * - File watching with dependency tracking
+ * - Framework-specific HMR support (React, Vue, Svelte, Solid)
+ * - Debounced file change handling
+ * - Error overlay support
+ */
+export declare class HMRManager {
+    private config;
+    private logger;
+    private clients;
+    private dependencyGraph;
+    private pendingUpdates;
+    private debounceTimer;
+    private framework;
+    private devServerPort;
+    private watcher;
+    constructor(framework: FrontendFramework, devServerPort: number, config?: Partial<HMRConfig>);
+    /**
+     * Normalize partial config to full config with defaults
+     */
+    private normalizeConfig;
+    /**
+     * Get the HMR client script for injection
+     */
+    getClientScript(): string;
+    /**
+     * Get the WebSocket URL for HMR
+     */
+    getWebSocketUrl(): string;
+    /**
+     * Get the HMR port
+     */
+    getPort(): number;
+    /**
+     * Check if HMR is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Handle WebSocket upgrade request
+     */
+    handleUpgrade(request: Request): WebSocket | null;
+    /**
+     * Handle fetch requests for WebSocket server
+     */
+    private handleWebSocketFetch;
+    /**
+     * Handle WebSocket connection open
+     */
+    private handleWebSocketOpen;
+    /**
+     * Handle WebSocket connection close
+     */
+    private handleWebSocketClose;
+    /**
+     * Handle WebSocket message from client
+     */
+    private handleWebSocketMessage;
+    /**
+     * Send message to a WebSocket client
+     */
+    private sendToClient;
+    /**
+     * Broadcast update to all connected clients
+     */
+    broadcastUpdate(update: HMRUpdate): void;
+    /**
+     * Start file watching
+     */
+    startWatching(rootDir: string): void;
+    /**
+     * Stop file watching
+     */
+    stopWatching(): void;
+    /**
+     * Handle a file change event
+     */
+    private handleFileChange;
+    /**
+     * Check if a file should be ignored
+     */
+    private shouldIgnoreFile;
+    /**
+     * Schedule debounced update processing
+     */
+    private scheduleDebouncedUpdate;
+    /**
+     * Process all pending file updates
+     */
+    private processPendingUpdates;
+    /**
+     * Determine the type of update needed
+     */
+    private determineUpdateType;
+    /**
+     * Handle module accepted from client
+     */
+    private handleModuleAccepted;
+    /**
+     * Register a file in the dependency graph
+     */
+    registerFile(filePath: string, imports?: string[]): void;
+    /**
+     * Get files that depend on a given file
+     */
+    getDependents(filePath: string): string[];
+    /**
+     * Get files that a file imports
+     */
+    getImports(filePath: string): string[];
+    /**
+     * Broadcast an error to all clients
+     */
+    broadcastError(error: Error | HMRUpdateError): void;
+    /**
+     * Generate a unique client ID
+     */
+    private generateClientId;
+    /**
+     * Generate a file ID from a file path
+     */
+    private generateFileId;
+    /**
+     * Get the number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Get all connected client IDs
+     */
+    getClientIds(): string[];
+    /**
+     * Disconnect all clients
+     */
+    disconnectAll(): void;
+    /**
+     * Stop the HMR manager
+     */
+    stop(): void;
+    /**
+     * Get framework-specific HMR runtime code
+     */
+    getFrameworkRuntime(): string;
+    /**
+     * React Fast Refresh runtime
+     */
+    private getReactRuntime;
+    /**
+     * Vue HMR runtime
+     */
+    private getVueRuntime;
+    /**
+     * Svelte HMR runtime
+     */
+    private getSvelteRuntime;
+    /**
+     * Solid HMR runtime
+     */
+    private getSolidRuntime;
+}
+/**
+ * Create an HMR manager
+ */
+export declare function createHMRManager(framework: FrontendFramework, devServerPort: number, config?: Partial<HMRConfig>): HMRManager;
+/**
+ * Check if a file is an HMR boundary
+ * (a file that can accept hot updates without propagating to parents)
+ */
+export declare function isHMRBoundary(filePath: string, content: string): boolean;
+/**
+ * Parse imports from a file's content
+ */
+export declare function parseImports(content: string, filePath: string): string[];
+//# sourceMappingURL=hmr.d.ts.map

package/dist/frontend/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../src/frontend/hmr.ts"],"names":[],"mappings":"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"}