@nice2dev/game-engine 1.3.15 → 1.3.17

package/dist/esm/performance/HotReload.js

@@ -1,516 +1,471 @@
-/**
- * @file HotReload.ts
- * @description Live code and asset reload without stopping the game
- * PRO-1.5: Runtime & Performance
- *
- * Features:
- * - Live code reloading
- * - Asset hot-swap
- * - State preservation
- * - Module dependency tracking
- * - WebSocket file watching
- * - Graceful error handling
- * - Rollback on failure
- */
-// ============================================================
-// Default Configuration
-// ============================================================
 const DEFAULT_HOT_RELOAD_CONFIG = {
-    enabled: true,
-    watchPaths: ['src/', 'assets/'],
-    excludePatterns: ['node_modules/', '.git/', 'dist/'],
-    debounceMs: 100,
-    retryAttempts: 3,
-    preserveState: true,
-    rollbackOnError: true,
-    autoConnect: true,
+  enabled: true,
+  watchPaths: ["src/", "assets/"],
+  excludePatterns: ["node_modules/", ".git/", "dist/"],
+  debounceMs: 100,
+  retryAttempts: 3,
+  preserveState: true,
+  rollbackOnError: true,
+  autoConnect: true
 };
-// ============================================================
-// Module Registry
-// ============================================================
 class ModuleRegistry {
-    constructor() {
-        this.modules = new Map();
-        this.states = new Map();
-        this.loaders = new Map();
-    }
-    registerModule(asset) {
-        this.modules.set(asset.id, asset);
-        // Update dependency graph
-        for (const depId of asset.dependencies) {
-            const dep = this.modules.get(depId);
-            if (dep && !dep.dependents.includes(asset.id)) {
-                dep.dependents.push(asset.id);
-            }
-        }
-    }
-    unregisterModule(id) {
-        const asset = this.modules.get(id);
-        if (!asset) {
-            return;
-        }
-        // Remove from dependents lists
-        for (const depId of asset.dependencies) {
-            const dep = this.modules.get(depId);
-            if (dep) {
-                dep.dependents = dep.dependents.filter((d) => d !== id);
-            }
-        }
-        this.modules.delete(id);
-        this.states.delete(id);
-    }
-    getModule(id) {
-        return this.modules.get(id);
-    }
-    getModuleByPath(path) {
-        for (const asset of this.modules.values()) {
-            if (asset.path === path) {
-                return asset;
-            }
-        }
-        return undefined;
-    }
-    getAllModules() {
-        return Array.from(this.modules.values());
-    }
-    getDependents(id) {
-        const dependents = new Set();
-        const toProcess = [id];
-        while (toProcess.length > 0) {
-            const currentId = toProcess.pop();
-            const asset = this.modules.get(currentId);
-            if (asset) {
-                for (const depId of asset.dependents) {
-                    if (!dependents.has(depId)) {
-                        dependents.add(depId);
-                        toProcess.push(depId);
-                    }
-                }
-            }
-        }
-        return Array.from(dependents);
-    }
-    saveState(id, state, exports) {
-        this.states.set(id, { id, state, exports });
-    }
-    getState(id) {
-        return this.states.get(id);
-    }
-    clearState(id) {
-        this.states.delete(id);
-    }
-    registerLoader(type, loader) {
-        this.loaders.set(type, loader);
-    }
-    getLoader(type) {
-        return this.loaders.get(type);
-    }
+  constructor() {
+    this.modules = /* @__PURE__ */ new Map();
+    this.states = /* @__PURE__ */ new Map();
+    this.loaders = /* @__PURE__ */ new Map();
+  }
+  registerModule(asset) {
+    this.modules.set(asset.id, asset);
+    for (const depId of asset.dependencies) {
+      const dep = this.modules.get(depId);
+      if (dep && !dep.dependents.includes(asset.id)) {
+        dep.dependents.push(asset.id);
+      }
+    }
+  }
+  unregisterModule(id) {
+    const asset = this.modules.get(id);
+    if (!asset) {
+      return;
+    }
+    for (const depId of asset.dependencies) {
+      const dep = this.modules.get(depId);
+      if (dep) {
+        dep.dependents = dep.dependents.filter((d) => d !== id);
+      }
+    }
+    this.modules.delete(id);
+    this.states.delete(id);
+  }
+  getModule(id) {
+    return this.modules.get(id);
+  }
+  getModuleByPath(path) {
+    for (const asset of this.modules.values()) {
+      if (asset.path === path) {
+        return asset;
+      }
+    }
+    return void 0;
+  }
+  getAllModules() {
+    return Array.from(this.modules.values());
+  }
+  getDependents(id) {
+    const dependents = /* @__PURE__ */ new Set();
+    const toProcess = [id];
+    while (toProcess.length > 0) {
+      const currentId = toProcess.pop();
+      const asset = this.modules.get(currentId);
+      if (asset) {
+        for (const depId of asset.dependents) {
+          if (!dependents.has(depId)) {
+            dependents.add(depId);
+            toProcess.push(depId);
+          }
+        }
+      }
+    }
+    return Array.from(dependents);
+  }
+  saveState(id, state, exports) {
+    this.states.set(id, { id, state, exports });
+  }
+  getState(id) {
+    return this.states.get(id);
+  }
+  clearState(id) {
+    this.states.delete(id);
+  }
+  registerLoader(type, loader) {
+    this.loaders.set(type, loader);
+  }
+  getLoader(type) {
+    return this.loaders.get(type);
+  }
 }
-// ============================================================
-// File Watcher (WebSocket-based)
-// ============================================================
 class FileWatcher {
-    constructor(config) {
-        this.ws = null;
+  constructor(config) {
+    this.ws = null;
+    this.reconnectAttempts = 0;
+    this.maxReconnectAttempts = 5;
+    this.reconnectDelay = 1e3;
+    this.debounceTimers = /* @__PURE__ */ new Map();
+    this.config = config;
+  }
+  connect() {
+    if (!this.config.serverUrl) {
+      console.warn("HotReload: No server URL configured");
+      return;
+    }
+    try {
+      this.ws = new WebSocket(this.config.serverUrl);
+      this.ws.onopen = () => {
         this.reconnectAttempts = 0;
-        this.maxReconnectAttempts = 5;
-        this.reconnectDelay = 1000;
-        this.debounceTimers = new Map();
-        this.config = config;
-    }
-    connect() {
-        if (!this.config.serverUrl) {
-            console.warn('HotReload: No server URL configured');
-            return;
-        }
+        this.onConnected?.();
+        this.sendWatchConfig();
+      };
+      this.ws.onmessage = (event) => {
         try {
-            this.ws = new WebSocket(this.config.serverUrl);
-            this.ws.onopen = () => {
-                this.reconnectAttempts = 0;
-                this.onConnected?.();
-                this.sendWatchConfig();
-            };
-            this.ws.onmessage = (event) => {
-                try {
-                    const data = JSON.parse(event.data);
-                    if (data.type === 'change') {
-                        this.handleFileChange({
-                            path: data.path,
-                            type: data.changeType,
-                            timestamp: Date.now(),
-                        });
-                    }
-                }
-                catch {
-                    // Ignore parse errors
-                }
-            };
-            this.ws.onclose = () => {
-                this.onDisconnected?.();
-                this.attemptReconnect();
-            };
-            this.ws.onerror = (event) => {
-                this.onError?.(new Error(`WebSocket error: ${event}`));
-            };
-        }
-        catch (error) {
-            this.onError?.(error);
-        }
-    }
-    disconnect() {
-        if (this.ws) {
-            this.ws.close();
-            this.ws = null;
-        }
-    }
-    attemptReconnect() {
-        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
-            return;
-        }
-        this.reconnectAttempts++;
-        setTimeout(() => {
-            this.connect();
-        }, this.reconnectDelay * this.reconnectAttempts);
-    }
-    sendWatchConfig() {
-        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-            return;
-        }
-        this.ws.send(JSON.stringify({
-            type: 'watch',
-            paths: this.config.watchPaths,
-            exclude: this.config.excludePatterns,
-        }));
-    }
-    handleFileChange(event) {
-        // Check exclusions
-        if (this.isExcluded(event.path)) {
-            return;
-        }
-        // Debounce
-        const existingTimer = this.debounceTimers.get(event.path);
-        if (existingTimer) {
-            clearTimeout(existingTimer);
-        }
-        const timer = setTimeout(() => {
-            this.debounceTimers.delete(event.path);
-            this.onFileChange?.(event);
-        }, this.config.debounceMs);
-        this.debounceTimers.set(event.path, timer);
-    }
-    isExcluded(path) {
-        return this.config.excludePatterns.some((pattern) => path.includes(pattern));
-    }
-    setOnFileChange(callback) {
-        this.onFileChange = callback;
-    }
-    setOnConnected(callback) {
-        this.onConnected = callback;
-    }
-    setOnDisconnected(callback) {
-        this.onDisconnected = callback;
-    }
-    setOnError(callback) {
-        this.onError = callback;
-    }
-    isConnected() {
-        return this.ws?.readyState === WebSocket.OPEN;
-    }
+          const data = JSON.parse(event.data);
+          if (data.type === "change") {
+            this.handleFileChange({
+              path: data.path,
+              type: data.changeType,
+              timestamp: Date.now()
+            });
+          }
+        } catch {
+        }
+      };
+      this.ws.onclose = () => {
+        this.onDisconnected?.();
+        this.attemptReconnect();
+      };
+      this.ws.onerror = (event) => {
+        this.onError?.(new Error(`WebSocket error: ${event}`));
+      };
+    } catch (error) {
+      this.onError?.(error);
+    }
+  }
+  disconnect() {
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+  }
+  attemptReconnect() {
+    if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+      return;
+    }
+    this.reconnectAttempts++;
+    setTimeout(() => {
+      this.connect();
+    }, this.reconnectDelay * this.reconnectAttempts);
+  }
+  sendWatchConfig() {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      return;
+    }
+    this.ws.send(
+      JSON.stringify({
+        type: "watch",
+        paths: this.config.watchPaths,
+        exclude: this.config.excludePatterns
+      })
+    );
+  }
+  handleFileChange(event) {
+    if (this.isExcluded(event.path)) {
+      return;
+    }
+    const existingTimer = this.debounceTimers.get(event.path);
+    if (existingTimer) {
+      clearTimeout(existingTimer);
+    }
+    const timer = setTimeout(() => {
+      this.debounceTimers.delete(event.path);
+      this.onFileChange?.(event);
+    }, this.config.debounceMs);
+    this.debounceTimers.set(event.path, timer);
+  }
+  isExcluded(path) {
+    return this.config.excludePatterns.some((pattern) => path.includes(pattern));
+  }
+  setOnFileChange(callback) {
+    this.onFileChange = callback;
+  }
+  setOnConnected(callback) {
+    this.onConnected = callback;
+  }
+  setOnDisconnected(callback) {
+    this.onDisconnected = callback;
+  }
+  setOnError(callback) {
+    this.onError = callback;
+  }
+  isConnected() {
+    return this.ws?.readyState === WebSocket.OPEN;
+  }
 }
-// ============================================================
-// Hot Reload System
-// ============================================================
 class HotReloadSystem {
-    constructor(config) {
-        this.history = [];
-        this.backups = new Map();
-        this.reloading = false;
-        this.config = { ...DEFAULT_HOT_RELOAD_CONFIG, ...config };
-        this.registry = new ModuleRegistry();
-        this.watcher = new FileWatcher(this.config);
-        this.setupWatcher();
-    }
-    setupWatcher() {
-        this.watcher.setOnFileChange((event) => {
-            this.handleFileChange(event);
-        });
-        this.watcher.setOnConnected(() => {
-            console.log('HotReload: Connected to file watcher');
-        });
-        this.watcher.setOnDisconnected(() => {
-            console.log('HotReload: Disconnected from file watcher');
-        });
-        if (this.config.autoConnect && this.config.serverUrl) {
-            this.watcher.connect();
-        }
-    }
-    async handleFileChange(event) {
-        if (!this.config.enabled || this.reloading) {
-            return;
-        }
-        const asset = this.registry.getModuleByPath(event.path);
-        if (!asset) {
-            return;
-        }
-        if (event.type === 'delete') {
-            // Handle deletion
-            this.registry.unregisterModule(asset.id);
-            return;
-        }
-        await this.reload(asset.id);
-    }
-    // ─── Reload Operations ─────────────────────────────────
-    async reload(assetId) {
-        const startTime = performance.now();
-        this.reloading = true;
-        const asset = this.registry.getModule(assetId);
-        if (!asset) {
-            this.reloading = false;
-            return {
-                success: false,
-                assetId,
-                reloadedAssets: [],
-                preservedState: false,
-                rollback: false,
-                error: 'Asset not found',
-                duration: performance.now() - startTime,
-            };
-        }
-        this.onReloadStarted?.(assetId);
-        // Create backup
-        if (this.config.rollbackOnError) {
-            this.createBackup(asset);
-        }
-        // Preserve state
-        let preservedState = false;
-        if (this.config.preserveState) {
-            preservedState = this.preserveState(asset);
-        }
-        // Get all assets that need reloading (including dependents)
-        const dependents = this.registry.getDependents(assetId);
-        const assetsToReload = [assetId, ...dependents];
-        const reloadedAssets = [];
-        let success = true;
-        let error;
-        // Reload with retries
-        for (const id of assetsToReload) {
-            const reloadSuccess = await this.reloadSingle(id);
-            if (reloadSuccess) {
-                reloadedAssets.push(id);
-            }
-            else {
-                success = false;
-                error = `Failed to reload ${id}`;
-                break;
-            }
-        }
-        // Handle failure
-        let rollback = false;
-        if (!success && this.config.rollbackOnError) {
-            rollback = this.performRollback(assetId);
-        }
-        // Restore state
-        if (success && preservedState) {
-            this.restoreState(asset);
-        }
-        const duration = performance.now() - startTime;
-        // Record event
-        this.recordEvent({
-            assetId,
-            path: asset.path,
-            type: asset.type,
-            oldVersion: asset.version,
-            newVersion: asset.version + 1,
-            timestamp: Date.now(),
-            success,
-            error,
-            duration,
-        });
-        this.reloading = false;
-        const result = {
-            success,
-            assetId,
-            reloadedAssets,
-            preservedState,
-            rollback,
-            error,
-            duration,
-        };
-        if (success) {
-            this.onReloadCompleted?.(result);
-        }
-        else {
-            this.onReloadFailed?.(assetId, new Error(error ?? 'Unknown error'));
-        }
-        return result;
-    }
-    async reloadSingle(assetId) {
-        const asset = this.registry.getModule(assetId);
-        if (!asset) {
-            return false;
-        }
-        const loader = this.registry.getLoader(asset.type);
-        if (!loader) {
-            return false;
-        }
-        let attempts = 0;
-        while (attempts < this.config.retryAttempts) {
-            try {
-                // Fetch new content
-                const content = await loader(asset.path + '?v=' + Date.now());
-                // Update asset
-                asset.version++;
-                asset.lastModified = Date.now();
-                asset.hash = await this.calculateHash(String(content));
-                return true;
-            }
-            catch {
-                attempts++;
-                await this.delay(100 * attempts);
-            }
-        }
-        return false;
-    }
-    createBackup(asset) {
-        const state = this.registry.getState(asset.id);
-        this.backups.set(asset.id, {
-            asset: { ...asset },
-            content: state?.exports ?? {},
-        });
-    }
-    performRollback(assetId) {
-        const backup = this.backups.get(assetId);
-        if (!backup) {
-            return false;
-        }
-        // Restore original asset
-        this.registry.registerModule(backup.asset);
-        this.onRollback?.(assetId);
+  constructor(config) {
+    this.history = [];
+    this.backups = /* @__PURE__ */ new Map();
+    this.reloading = false;
+    this.config = { ...DEFAULT_HOT_RELOAD_CONFIG, ...config };
+    this.registry = new ModuleRegistry();
+    this.watcher = new FileWatcher(this.config);
+    this.setupWatcher();
+  }
+  setupWatcher() {
+    this.watcher.setOnFileChange((event) => {
+      this.handleFileChange(event);
+    });
+    this.watcher.setOnConnected(() => {
+      console.log("HotReload: Connected to file watcher");
+    });
+    this.watcher.setOnDisconnected(() => {
+      console.log("HotReload: Disconnected from file watcher");
+    });
+    if (this.config.autoConnect && this.config.serverUrl) {
+      this.watcher.connect();
+    }
+  }
+  async handleFileChange(event) {
+    if (!this.config.enabled || this.reloading) {
+      return;
+    }
+    const asset = this.registry.getModuleByPath(event.path);
+    if (!asset) {
+      return;
+    }
+    if (event.type === "delete") {
+      this.registry.unregisterModule(asset.id);
+      return;
+    }
+    await this.reload(asset.id);
+  }
+  // ─── Reload Operations ─────────────────────────────────
+  async reload(assetId) {
+    const startTime = performance.now();
+    this.reloading = true;
+    const asset = this.registry.getModule(assetId);
+    if (!asset) {
+      this.reloading = false;
+      return {
+        success: false,
+        assetId,
+        reloadedAssets: [],
+        preservedState: false,
+        rollback: false,
+        error: "Asset not found",
+        duration: performance.now() - startTime
+      };
+    }
+    this.onReloadStarted?.(assetId);
+    if (this.config.rollbackOnError) {
+      this.createBackup(asset);
+    }
+    let preservedState = false;
+    if (this.config.preserveState) {
+      preservedState = this.preserveState(asset);
+    }
+    const dependents = this.registry.getDependents(assetId);
+    const assetsToReload = [assetId, ...dependents];
+    const reloadedAssets = [];
+    let success = true;
+    let error;
+    for (const id of assetsToReload) {
+      const reloadSuccess = await this.reloadSingle(id);
+      if (reloadSuccess) {
+        reloadedAssets.push(id);
+      } else {
+        success = false;
+        error = `Failed to reload ${id}`;
+        break;
+      }
+    }
+    let rollback = false;
+    if (!success && this.config.rollbackOnError) {
+      rollback = this.performRollback(assetId);
+    }
+    if (success && preservedState) {
+      this.restoreState(asset);
+    }
+    const duration = performance.now() - startTime;
+    this.recordEvent({
+      assetId,
+      path: asset.path,
+      type: asset.type,
+      oldVersion: asset.version,
+      newVersion: asset.version + 1,
+      timestamp: Date.now(),
+      success,
+      error,
+      duration
+    });
+    this.reloading = false;
+    const result = {
+      success,
+      assetId,
+      reloadedAssets,
+      preservedState,
+      rollback,
+      error,
+      duration
+    };
+    if (success) {
+      this.onReloadCompleted?.(result);
+    } else {
+      this.onReloadFailed?.(assetId, new Error(error ?? "Unknown error"));
+    }
+    return result;
+  }
+  async reloadSingle(assetId) {
+    const asset = this.registry.getModule(assetId);
+    if (!asset) {
+      return false;
+    }
+    const loader = this.registry.getLoader(asset.type);
+    if (!loader) {
+      return false;
+    }
+    let attempts = 0;
+    while (attempts < this.config.retryAttempts) {
+      try {
+        const content = await loader(asset.path + "?v=" + Date.now());
+        asset.version++;
+        asset.lastModified = Date.now();
+        asset.hash = await this.calculateHash(String(content));
         return true;
-    }
-    preserveState(asset) {
-        const state = this.registry.getState(asset.id);
-        if (state) {
-            this.onStatePreserved?.(asset.id, state);
-            return true;
-        }
-        return false;
-    }
-    restoreState(asset) {
-        const state = this.registry.getState(asset.id);
-        if (state) {
-            // State restoration logic would depend on the module system
-            console.log(`HotReload: Restored state for ${asset.id}`);
-        }
-    }
-    recordEvent(event) {
-        this.history.push(event);
-        // Keep last 100 events
-        if (this.history.length > 100) {
-            this.history.shift();
-        }
-    }
-    // ─── Registration ──────────────────────────────────────
-    register(id, path, type, dependencies = []) {
-        this.registry.registerModule({
-            id,
-            path,
-            type,
-            version: 1,
-            lastModified: Date.now(),
-            hash: '',
-            dependencies,
-            dependents: [],
-        });
-    }
-    unregister(id) {
-        this.registry.unregisterModule(id);
-    }
-    registerLoader(type, loader) {
-        this.registry.registerLoader(type, loader);
-    }
-    saveModuleState(id, state, exports) {
-        this.registry.saveState(id, state, exports);
-    }
-    // ─── Utilities ─────────────────────────────────────────
-    async calculateHash(content) {
-        const encoder = new TextEncoder();
-        const data = encoder.encode(content);
-        const hashBuffer = await crypto.subtle.digest('SHA-256', data);
-        const hashArray = Array.from(new Uint8Array(hashBuffer));
-        return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
-    }
-    delay(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    // ─── Control ───────────────────────────────────────────
-    enable() {
-        this.config.enabled = true;
-    }
-    disable() {
-        this.config.enabled = false;
-    }
-    isEnabled() {
-        return this.config.enabled;
-    }
-    connect() {
-        this.watcher.connect();
-    }
-    disconnect() {
-        this.watcher.disconnect();
-    }
-    isConnected() {
-        return this.watcher.isConnected();
-    }
-    // ─── History & Stats ───────────────────────────────────
-    getHistory() {
-        return [...this.history];
-    }
-    getRecentReloads(count = 10) {
-        return this.history.slice(-count);
-    }
-    getStats() {
-        const successful = this.history.filter((e) => e.success).length;
-        const failed = this.history.filter((e) => !e.success).length;
-        const avgDuration = this.history.length > 0
-            ? this.history.reduce((sum, e) => sum + e.duration, 0) / this.history.length
-            : 0;
-        return {
-            totalReloads: this.history.length,
-            successfulReloads: successful,
-            failedReloads: failed,
-            averageDuration: avgDuration,
-            registeredModules: this.registry.getAllModules().length,
-        };
-    }
-    // ─── Callbacks ─────────────────────────────────────────
-    setOnReloadStarted(callback) {
-        this.onReloadStarted = callback;
-    }
-    setOnReloadCompleted(callback) {
-        this.onReloadCompleted = callback;
-    }
-    setOnReloadFailed(callback) {
-        this.onReloadFailed = callback;
-    }
-    setOnStatePreserved(callback) {
-        this.onStatePreserved = callback;
-    }
-    setOnRollback(callback) {
-        this.onRollback = callback;
-    }
+      } catch {
+        attempts++;
+        await this.delay(100 * attempts);
+      }
+    }
+    return false;
+  }
+  createBackup(asset) {
+    const state = this.registry.getState(asset.id);
+    this.backups.set(asset.id, {
+      asset: { ...asset },
+      content: state?.exports ?? {}
+    });
+  }
+  performRollback(assetId) {
+    const backup = this.backups.get(assetId);
+    if (!backup) {
+      return false;
+    }
+    this.registry.registerModule(backup.asset);
+    this.onRollback?.(assetId);
+    return true;
+  }
+  preserveState(asset) {
+    const state = this.registry.getState(asset.id);
+    if (state) {
+      this.onStatePreserved?.(asset.id, state);
+      return true;
+    }
+    return false;
+  }
+  restoreState(asset) {
+    const state = this.registry.getState(asset.id);
+    if (state) {
+      console.log(`HotReload: Restored state for ${asset.id}`);
+    }
+  }
+  recordEvent(event) {
+    this.history.push(event);
+    if (this.history.length > 100) {
+      this.history.shift();
+    }
+  }
+  // ─── Registration ──────────────────────────────────────
+  register(id, path, type, dependencies = []) {
+    this.registry.registerModule({
+      id,
+      path,
+      type,
+      version: 1,
+      lastModified: Date.now(),
+      hash: "",
+      dependencies,
+      dependents: []
+    });
+  }
+  unregister(id) {
+    this.registry.unregisterModule(id);
+  }
+  registerLoader(type, loader) {
+    this.registry.registerLoader(type, loader);
+  }
+  saveModuleState(id, state, exports) {
+    this.registry.saveState(id, state, exports);
+  }
+  // ─── Utilities ─────────────────────────────────────────
+  async calculateHash(content) {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(content);
+    const hashBuffer = await crypto.subtle.digest("SHA-256", data);
+    const hashArray = Array.from(new Uint8Array(hashBuffer));
+    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  // ─── Control ───────────────────────────────────────────
+  enable() {
+    this.config.enabled = true;
+  }
+  disable() {
+    this.config.enabled = false;
+  }
+  isEnabled() {
+    return this.config.enabled;
+  }
+  connect() {
+    this.watcher.connect();
+  }
+  disconnect() {
+    this.watcher.disconnect();
+  }
+  isConnected() {
+    return this.watcher.isConnected();
+  }
+  // ─── History & Stats ───────────────────────────────────
+  getHistory() {
+    return [...this.history];
+  }
+  getRecentReloads(count = 10) {
+    return this.history.slice(-count);
+  }
+  getStats() {
+    const successful = this.history.filter((e) => e.success).length;
+    const failed = this.history.filter((e) => !e.success).length;
+    const avgDuration = this.history.length > 0 ? this.history.reduce((sum, e) => sum + e.duration, 0) / this.history.length : 0;
+    return {
+      totalReloads: this.history.length,
+      successfulReloads: successful,
+      failedReloads: failed,
+      averageDuration: avgDuration,
+      registeredModules: this.registry.getAllModules().length
+    };
+  }
+  // ─── Callbacks ─────────────────────────────────────────
+  setOnReloadStarted(callback) {
+    this.onReloadStarted = callback;
+  }
+  setOnReloadCompleted(callback) {
+    this.onReloadCompleted = callback;
+  }
+  setOnReloadFailed(callback) {
+    this.onReloadFailed = callback;
+  }
+  setOnStatePreserved(callback) {
+    this.onStatePreserved = callback;
+  }
+  setOnRollback(callback) {
+    this.onRollback = callback;
+  }
 }
-// ============================================================
-// Factory Functions
-// ============================================================
 function createHotReloadSystem(config) {
-    return new HotReloadSystem(config);
+  return new HotReloadSystem(config);
 }
 function createModuleRegistry() {
-    return new ModuleRegistry();
+  return new ModuleRegistry();
 }
 function createFileWatcher(config) {
-    return new FileWatcher(config);
+  return new FileWatcher(config);
 }
-
-export { DEFAULT_HOT_RELOAD_CONFIG, FileWatcher, HotReloadSystem, ModuleRegistry, createFileWatcher, createHotReloadSystem, createModuleRegistry };
+export {
+  DEFAULT_HOT_RELOAD_CONFIG,
+  FileWatcher,
+  HotReloadSystem,
+  ModuleRegistry,
+  createFileWatcher,
+  createHotReloadSystem,
+  createModuleRegistry
+};