opticore-webapp 1.0.69 → 1.0.71

package/dist/index.cjs

@@ -30,116 +30,35 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  HotReloadWatcher: () => HotReloadWatcher,
   WebServer: () => WebServerCore,
   envPath: () => envPath
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/core/webServer.core.ts
-var path2 = __toESM(require("path"), 1);
-var import_node_process3 = __toESM(require("process"), 1);
+var path3 = __toESM(require("path"), 1);
+var import_node_process4 = __toESM(require("process"), 1);
 var import_cors = __toESM(require("cors"), 1);
-var import_express = __toESM(require("express"), 1);
-var import_chokidar = __toESM(require("chokidar"), 1);
 var import_opticore_catch_exception_error3 = require("opticore-catch-exception-error");
+var import_opticore_express2 = require("opticore-express");
 var import_opticore_env_access2 = require("opticore-env-access");
+var import_opticore_http_response4 = require("opticore-http-response");
+var import_opticore_translator3 = require("opticore-translator");
 var import_opticore_request_call_event = require("opticore-request-call-event");
-var import_opticore_dependency_inject2 = require("opticore-dependency-inject");
-var import_opticore_http_response3 = require("opticore-http-response");
-var import_opticore_translator2 = require("opticore-translator");
 
 // src/core/handlers/eventProcess.handler.ts
 var import_node_process = __toESM(require("process"), 1);
 var import_node_events = __toESM(require("events"), 1);
+var import_opticore_express = require("opticore-express");
 var import_opticore_catch_exception_error = require("opticore-catch-exception-error");
-
-// src/utils/isTransformError.utils.ts
-var isTransformErrorUtils = (error) => {
-  return error?.name === "TransformError" || error?.message?.includes("Transform failed") || error?.message?.includes("esbuild");
-};
-
-// src/core/handlers/eventProcess.handler.ts
-function eventProcessHandler(localeLanguage, expressApp) {
+function eventProcessHandler(localeLanguage) {
   const errorEmitter = new import_node_events.default();
+  const app = (0, import_opticore_express.express)();
   const serverListenEvent = new import_opticore_catch_exception_error.ServerListenEventError(localeLanguage);
-  console.log("[Server] Setting up error event handlers...");
   errorEmitter.on(import_opticore_catch_exception_error.CEventNameError.error, (error) => {
-    console.error("[Server] EventEmitter error caught:", error.message);
-    if (isTransformErrorUtils(error)) {
-      handleTransformError(error);
-    }
     serverListenEvent.listenerError(error);
   });
-  function handleTransformError(error) {
-    console.error("[Server] ============================================");
-    console.error("[Server] TRANSFORM ERROR DETECTED");
-    console.error("[Server] ============================================");
-    console.error("[Server] Message:", error.message);
-    console.error("[Server] Stack:", error.stack);
-    if (error.errors && Array.isArray(error.errors)) {
-      error.errors.forEach((err, index) => {
-        console.error(`[Server] Error ${index + 1}:`, err.text);
-        if (err.location) {
-          console.error(`[Server]   File: ${err.location.file}`);
-          console.error(`[Server]   Line: ${err.location.line}, Column: ${err.location.column}`);
-        }
-      });
-    }
-    const fileMatch = error.message.match(/([^:]+\.ts):(\d+):(\d+):/);
-    if (fileMatch) {
-      console.error("[Server] Problem file:", fileMatch[1]);
-      console.error("[Server] Line:", fileMatch[2], "Column:", fileMatch[3]);
-    }
-    const errorDetailMatch = error.message.match(/ERROR: (.+)$/m);
-    if (errorDetailMatch) {
-      console.error("[Server] Error detail:", errorDetailMatch[1]);
-    }
-    console.error("[Server] ============================================");
-    if (import_node_process.default.send) {
-      import_node_process.default.send({
-        type: "TRANSFORM_ERROR",
-        error: error.message,
-        stack: error.stack,
-        errorName: error.name,
-        details: error.errors,
-        timestamp: Date.now()
-      });
-    }
-  }
-  import_node_process.default.on(import_opticore_catch_exception_error.CEvent.uncaughtException, (error) => {
-    console.error("[Server] UNCAUGHT EXCEPTION:", error.message);
-    console.error("[Server] Stack:", error.stack);
-    if (isTransformErrorUtils(error)) {
-      errorEmitter.emit("transformError", error);
-    }
-    serverListenEvent.uncaughtException(error);
-    if (import_node_process.default.send) {
-      const messageType = isTransformErrorUtils(error) ? "TRANSFORM_ERROR" : "HOT_RELOAD_ERROR";
-      import_node_process.default.send({
-        type: messageType,
-        error: error.message,
-        stack: error.stack,
-        errorName: error.name,
-        timestamp: Date.now()
-      });
-    }
-  });
-  import_node_process.default.on(import_opticore_catch_exception_error.CEvent.unhandledRejection, (reason, promise) => {
-    console.error("[Server] UNHANDLED REJECTION:", reason);
-    if (isTransformErrorUtils(reason)) {
-      errorEmitter.emit("transformError", reason);
-    }
-    serverListenEvent.unhandledRejection(reason, promise);
-    if (import_node_process.default.send) {
-      const messageType = isTransformErrorUtils(reason) ? "TRANSFORM_ERROR" : "HOT_RELOAD_ERROR";
-      import_node_process.default.send({
-        type: messageType,
-        error: reason?.message || String(reason),
-        errorName: reason?.name,
-        timestamp: Date.now()
-      });
-    }
-  });
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.beforeExit, (code) => {
     setTimeout(() => {
       serverListenEvent.processBeforeExit(code);
@@ -154,20 +73,20 @@ function eventProcessHandler(localeLanguage, expressApp) {
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.rejectionHandled, (promise) => {
     serverListenEvent.promiseRejectionHandled(promise);
   });
+  import_node_process.default.on(import_opticore_catch_exception_error.CEvent.uncaughtException, (error) => {
+    serverListenEvent.uncaughtException(error);
+  });
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.uncaughtExceptionMonitor, (error) => {
-    console.error("[Server] UNCAUGHT EXCEPTION MONITOR:", error.message);
-    if (isTransformErrorUtils(error)) {
-      errorEmitter.emit("transformError", error);
-    }
     serverListenEvent.uncaughtExceptionMonitor(error);
   });
+  import_node_process.default.on(import_opticore_catch_exception_error.CEvent.unhandledRejection, (reason, promise) => {
+    serverListenEvent.unhandledRejection(reason, promise);
+  });
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.warning, (warning) => {
     serverListenEvent.warning(warning);
   });
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.message, (message) => {
-    if (message.type !== "HOT_RELOAD_REQUEST" && message.type !== "SERVER_READY") {
-      serverListenEvent.message(message);
-    }
+    serverListenEvent.message(message);
   });
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.multipleResolves, (type, promise, reason) => {
     serverListenEvent.multipleResolves(type, promise, reason);
@@ -178,15 +97,9 @@ function eventProcessHandler(localeLanguage, expressApp) {
   import_node_process.default.on(import_opticore_catch_exception_error.CEvent.sigterm, (signal) => {
     serverListenEvent.sigtermSignalReceived(signal);
   });
-  expressApp.use((err, req, res, next) => {
-    console.error("[Server] Express error middleware triggered:", err.message);
-    console.error("[Server] Request URL:", req.url);
-    console.error("[Server] Request method:", req.method);
-    errorEmitter.emit(import_opticore_catch_exception_error.CEventNameError.error, err);
+  app.use((err, req, res, next) => {
     serverListenEvent.expressErrorHandlingMiddleware(errorEmitter, err, req, res, next);
   });
-  console.log("[Server] Error event handlers configured successfully");
-  return errorEmitter;
 }
 
 // src/application/service/core.service.ts
@@ -238,18 +151,20 @@ var dependenciesContainerProvider = (localLang) => {
 };
 
 // src/application/service/core.service.ts
-var import_opticore_logger2 = require("opticore-logger");
+var import_opticore_dependency_inject2 = require("opticore-dependency-inject");
 
-// src/application/service/logger.service.ts
-var SLogger = (localLang) => {
-  return {
-    get serverLog() {
-      return dependenciesContainerProvider(localLang).resolve("OpticoreLogger");
-    },
-    get logger() {
-      return dependenciesContainerProvider(localLang).resolve("LoggerCore");
-    }
-  };
+// src/utils/parsingDateTime.utils.ts
+var parsingDateTimeUtils = (localFormatTime) => {
+  const now = /* @__PURE__ */ new Date();
+  const formatter = new Intl.DateTimeFormat(localFormatTime, {
+    day: "2-digit",
+    month: "2-digit",
+    year: "numeric",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false
+  });
+  return formatter.format(now);
 };
 
 // src/application/service/core.service.ts
@@ -258,10 +173,12 @@ var CoreService = class {
   environmentPath;
   serverLog;
   logger;
+  container;
   constructor(localLang, environmentPath) {
+    this.loadTranslationFiles();
     this.environmentPath = environmentPath;
     this.localLanguage = localLang;
-    loaderTranslationFile(this.localLanguage);
+    this.container = new import_opticore_dependency_inject2.SContainer(localLang);
     this.serverLog = dependenciesContainerProvider(localLang).resolve("OpticoreLogger");
     this.logger = dependenciesContainerProvider(localLang).resolve("LoggerCore");
   }
@@ -275,6 +192,41 @@ var CoreService = class {
   formatMemoryUsage(data) {
     return `${Math.round(data / 1024 / 1024 * 100) / 100} MB`;
   }
+  loadTranslationFiles() {
+    loaderTranslationFile(this.localLanguage);
+  }
+  /**
+   *
+   * @param filePath
+   * @private
+   *
+   * Return void
+   */
+  getEnvFileLoading(filePath) {
+    this.loadTranslationFiles();
+    try {
+      const fullPath = path.resolve(import_node_process2.default.cwd(), filePath);
+      if (fs.existsSync(fullPath)) {
+        const env = fs.readFileSync(fullPath, "utf-8");
+        const lines = env.split("\n");
+        lines.forEach((line) => {
+          const match = line.match(/^([^#=]+)=([^#]+)$/);
+          if (match) {
+            const key = match[1].trim();
+            import_node_process2.default.env[key] = match[2].trim();
+          }
+        });
+      }
+    } catch (err) {
+      this.logger.error({
+        message: err.message,
+        title: import_opticore_translator.TranslationLoader.t("EnvFileLoading", this.localLanguage),
+        errorType: err.code,
+        stackTrace: err.stack,
+        httpCodeValue: import_opticore_http_response.HttpStatusCode.INTERNAL_SERVER_ERROR
+      });
+    }
+  }
   /**
    * Returns an Object containing a node version, openssl, and v0
    */
@@ -299,7 +251,7 @@ var CoreService = class {
    * and Memory usage system
    */
   getUsageMemory() {
-    loaderTranslationFile(this.localLanguage);
+    this.loadTranslationFiles();
     const memoryData = import_node_process2.default.memoryUsage();
     const data = {
       [import_opticore_translator.TranslationLoader.t("totalMemoryAllocated", this.localLanguage)]: this.formatMemoryUsage(memoryData.rss),
@@ -331,37 +283,6 @@ var CoreService = class {
       "startingTime": `${executionTime.toFixed(5)} ms`
     };
   }
-  /**
-   *
-   * @param filePath
-   * @private
-   *
-   * Return void
-   */
-  getEnvFileLoading(filePath) {
-    try {
-      const fullPath = path.resolve(import_node_process2.default.cwd(), filePath);
-      if (fs.existsSync(fullPath)) {
-        const env = fs.readFileSync(fullPath, "utf-8");
-        const lines = env.split("\n");
-        lines.forEach((line) => {
-          const match = line.match(/^([^#=]+)=([^#]+)$/);
-          if (match) {
-            const key = match[1].trim();
-            import_node_process2.default.env[key] = match[2].trim();
-          }
-        });
-      }
-    } catch (err) {
-      this.logger.error({
-        message: err.message,
-        title: import_opticore_translator.TranslationLoader.t("EnvFileLoading", this.localLanguage),
-        errorType: err.code,
-        stackTrace: err.stack,
-        httpCodeValue: import_opticore_http_response.HttpStatusCode.INTERNAL_SERVER_ERROR
-      });
-    }
-  }
   /**
    *
    * @param development
@@ -370,14 +291,15 @@ var CoreService = class {
    * Return string
    */
   getServerRunningMode(development, production) {
+    this.loadTranslationFiles();
     try {
-      loaderTranslationFile(this.localLanguage);
       this.getEnvFileLoading(".env");
-      const env = (0, import_opticore_env_access.getEnvironnementValue)(path.join(envPath));
-      const isDevelopment = env.devEnv === development && env.prodEnv === "";
+      const env = (0, import_opticore_env_access.getEnvironmentValue)(path.join(envPath));
+      const isDevelopment = env.devEnv === development;
+      const isProd = env.prodEnv === production;
       if (isDevelopment) {
         return `${import_opticore_translator.TranslationLoader.t("serverRunning", this.localLanguage)} ${import_ansi_colors.default.bgBlue(`${import_ansi_colors.default.bold(`${development}`)}`)} mode`;
-      } else if (!isDevelopment) {
+      } else if (isProd) {
         return `${import_opticore_translator.TranslationLoader.t("serverRunning", this.localLanguage)} ${import_ansi_colors.default.bgBlue(`${import_ansi_colors.default.bold(`${production}`)}`)} mode`;
       } else {
         return `${import_opticore_translator.TranslationLoader.t("serverRunning", this.localLanguage)} ${import_ansi_colors.default.bgBlue(`${import_ansi_colors.default.bold(`${development}`)}`)} mode`;
@@ -393,10 +315,10 @@ var CoreService = class {
     }
   }
   infoServer(host, port) {
+    this.loadTranslationFiles();
     try {
-      loaderTranslationFile(this.localLanguage);
-      const getEnvironment = (0, import_opticore_env_access.getEnvironnementValue)(this.environmentPath);
-      const msg5 = getEnvironment.protocolTransfert === "" ? import_ansi_colors.default.underline(`http://${host}:${port}`) : import_ansi_colors.default.underline(`${getEnvironment.protocolTransfert}://${host}:${port}`);
+      const getEnvironment = (0, import_opticore_env_access.getEnvironmentValue)(this.environmentPath);
+      const msg5 = getEnvironment.protocolTransfer === "" ? import_ansi_colors.default.underline(`http://${host}:${port}`) : import_ansi_colors.default.underline(`${getEnvironment.protocolTransfer}://${host}:${port}`);
       const messages = [
         import_opticore_translator.TranslationLoader.t("webServerListening", this.localLanguage),
         import_opticore_translator.TranslationLoader.t("webServerUsingNodeVersion", this.localLanguage, { nodeVersion: this.getVersions().nodeVersion }),
@@ -416,20 +338,33 @@ var CoreService = class {
       });
       console.log(border);
       console.log("\n");
-      const logCore = new import_opticore_logger2.LoggerCore();
-      logCore.success({
-        title: import_opticore_translator.TranslationLoader.t("serverRunningTitle", this.localLanguage),
-        message: import_opticore_translator.TranslationLoader.t("serverRunningAt", this.localLanguage, { server: msg5 })
-      });
-      SLogger(this.localLanguage).serverLog.serverLog({
-        timestamp: (/* @__PURE__ */ new Date()).toString(),
+      this.serverLog.serverLog({
+        timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
         level: "SERVER",
         title: import_opticore_translator.TranslationLoader.t("serverRunningTitle", this.localLanguage),
         typeName: import_opticore_translator.TranslationLoader.t("opticoreServerTypeName", this.localLanguage),
         message: import_opticore_translator.TranslationLoader.t("serverRunningAt", this.localLanguage, { server: msg5 })
       });
+      const dependenciesList = this.container.listDependencies();
+      if (dependenciesList.length > 0) {
+        this.serverLog.opticoreLog({
+          level: "OPTICORE",
+          message: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_STORED", this.localLanguage, { dependenciesList: dependenciesList.join(", ") }),
+          timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
+          title: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_CONTAINER", this.localLanguage),
+          typeName: "DEPENDENCIES_CONTAINER"
+        });
+      } else {
+        this.serverLog.opticoreLog({
+          level: "OPTICORE",
+          message: import_opticore_translator.TranslationLoader.t("NO_DEPENDENCIES_STORED", this.localLanguage),
+          timestamp: parsingDateTimeUtils(getEnvironment.localFormatTime),
+          title: import_opticore_translator.TranslationLoader.t("DEPENDENCIES_CONTAINER", this.localLanguage),
+          typeName: "DEPENDENCIES_CONTAINER"
+        });
+      }
     } catch (err) {
-      SLogger(this.localLanguage).logger.error({
+      this.logger.error({
         message: err.message,
         title: import_opticore_translator.TranslationLoader.t("server", this.localLanguage),
         errorType: err.code,
@@ -445,6 +380,20 @@ var dateTimeFormattedUtils = `${(/* @__PURE__ */ new Date()).getMonth()}-${(/* @
 
 // src/application/service/serverStartError.service.ts
 var import_opticore_catch_exception_error2 = require("opticore-catch-exception-error");
+
+// src/application/service/logger.service.ts
+var SLogger = (localLang) => {
+  return {
+    get serverLog() {
+      return dependenciesContainerProvider(localLang).resolve("OpticoreLogger");
+    },
+    get logger() {
+      return dependenciesContainerProvider(localLang).resolve("LoggerCore");
+    }
+  };
+};
+
+// src/application/service/serverStartError.service.ts
 var import_opticore_http_response2 = require("opticore-http-response");
 var SServerStartError = (err, environmentPath) => {
   if (err.name) {
@@ -476,391 +425,165 @@ var SServerStartError = (err, environmentPath) => {
   }
 };
 
+// src/core/webServer.core.ts
+var import_opticore_dependency_inject3 = require("opticore-dependency-inject");
+
+// src/application/service/getEnvFileLoading.service.ts
+var import_path = __toESM(require("path"), 1);
+var import_node_process3 = __toESM(require("process"), 1);
+var import_fs = __toESM(require("fs"), 1);
+var import_opticore_translator2 = require("opticore-translator");
+var import_opticore_http_response3 = require("opticore-http-response");
+var getEnvFileLoadingService = (filePath, localLanguage) => {
+  loaderTranslationFile(localLanguage);
+  const logger = dependenciesContainerProvider(localLanguage).resolve("LoggerCore");
+  try {
+    const fullPath = import_path.default.resolve(import_node_process3.default.cwd(), filePath);
+    if (import_fs.default.existsSync(fullPath)) {
+      const env = import_fs.default.readFileSync(fullPath, "utf-8");
+      const lines = env.split("\n");
+      lines.forEach((line) => {
+        const match = line.match(/^([^#=]+)=([^#]+)$/);
+        if (match) {
+          const key = match[1].trim();
+          import_node_process3.default.env[key] = match[2].trim();
+        }
+      });
+    }
+  } catch (err) {
+    logger.error({
+      message: err.message,
+      title: import_opticore_translator2.TranslationLoader.t("EnvFileLoading", localLanguage),
+      errorType: err.code,
+      stackTrace: err.stack,
+      httpCodeValue: import_opticore_http_response3.HttpStatusCode.INTERNAL_SERVER_ERROR
+    });
+  }
+};
+
 // src/core/webServer.core.ts
 var WebServerCore = class {
   serverUtility;
-  expressApp;
+  expressApp = (0, import_opticore_express2.express)();
+  container;
   localLanguage;
   loggerConfig;
-  getEnvironment;
+  routerExpressApp;
+  getEnvironmentValue;
   environmentPath;
   serverListenEvent;
-  // Existing properties
-  currentRoutes = [];
-  currentDependencies = [];
-  server = void 0;
-  errorEmitter;
-  serverStatus = "STARTING";
-  serverStartTime = /* @__PURE__ */ new Date();
-  // HMR properties
-  fileWatcher = null;
-  hmrRestartPending = false;
-  hmrDebounceTimeout = null;
-  hmrRestartCount = 0;
-  lastHmrRestartTime = 0;
-  /**
-   * Creates a new WebServerCore instance.
-   *
-   * @constructor
-   * @param {WebServerConstructorInterface} paramsConstructor - Configuration parameters
-   *
-   * @param {express.Application} paramsConstructor.app - Express application instance
-   * @param {LoggerCore} paramsConstructor.loggerConfig - Logger configuration
-   * @param {string} paramsConstructor.environmentPath - Path to environment file
-   * @param {string} paramsConstructor.localLanguage - Default language for translations
-   * @param {CorsOptions} paramsConstructor.corsOriginOptions - CORS configuration
-   *
-   * @returns {WebServerCore} New WebServerCore instance
-   *
-   * @throws {Error} If environment file cannot be loaded
-   *
-   * @example
-   * ```typescript
-   * const server = new WebServerCore({
-   *   app: express(),
-   *   loggerConfig: new LoggerCore(config),
-   *   environmentPath: ".env",
-   *   localLanguage: "fr",
-   *   corsOriginOptions: { origin: "http://localhost:3000" }
-   * });
-   * ```
-   */
+  dependenciesRegistered = false;
   constructor(paramsConstructor) {
-    this.getEnvironment = (0, import_opticore_env_access2.getEnvironmentValue)(paramsConstructor.environmentPath);
+    this.loadTranslationFiles();
+    this.stackTraceErrorHandling();
+    this.getEnvironmentValue = (0, import_opticore_env_access2.getEnvironmentValue)(paramsConstructor.environmentPath);
+    this.routerExpressApp = paramsConstructor.app;
     this.loggerConfig = paramsConstructor.loggerConfig;
     this.localLanguage = paramsConstructor.localLanguage;
     this.environmentPath = paramsConstructor.environmentPath;
-    this.expressApp = (0, import_express.default)();
-    this.serverListenEvent = new import_opticore_catch_exception_error3.ServerListenEventError(paramsConstructor.localLanguage);
-    this.expressApp.use(import_express.default.json());
-    this.expressApp.use(import_express.default.raw());
-    this.expressApp.use(import_express.default.text());
-    this.expressApp.use(import_express.default.urlencoded({ extended: true }));
+    this.container = new import_opticore_dependency_inject3.SContainer(paramsConstructor.localLanguage);
+    this.expressApp.use(import_opticore_express2.express.json());
+    this.expressApp.use(import_opticore_express2.express.raw());
+    this.expressApp.use(import_opticore_express2.express.text());
+    this.expressApp.use(import_opticore_express2.express.urlencoded({ extended: true }));
     this.expressApp.use((0, import_cors.default)(paramsConstructor.corsOriginOptions));
+    this.serverListenEvent = new import_opticore_catch_exception_error3.ServerListenEventError(paramsConstructor.localLanguage);
     this.serverUtility = new CoreService(paramsConstructor.localLanguage, paramsConstructor.environmentPath);
-    this.serverStatus = "STARTING";
-    this.serverStartTime = /* @__PURE__ */ new Date();
-    this.setupProcessEventListeners();
   }
   /**
-   * Starts the HTTP server and initializes all components including HMR if enabled.
-   *
-   * @method onStartServer
-   * @public
    *
-   * @param {TFeatureRoutes[]} routers - Array of feature routes to register
-   * @param {(env: IEnvVariables) => void} [databaseCallback] - Optional database connection callback
-   * @param {TDependency[]} [dependenciesProvider] - Optional dependency injection providers
-   *
-   * @returns {serverWebApp | undefined} HTTP server instance or undefined if startup fails
-   *
-   * @throws {ServerListenEventError} If port/host configuration is invalid
-   * @throws {Error} If server initialization fails
-   *
-   * @fires WebServerCore#startHttpServer - When server successfully starts
-   * @fires WebServerCore#startHMR - When HMR is started (if enabled)
-   * @fires WebServerCore#serverError - When server fails to start
-   *
-   * @example
-   * ```typescript
-   * const server = app.onStartServer(
-   *   routes,
-   *   (env) => connectToDatabase(env),
-   *   dependencies
-   * );
-   *
-   * if (server) {
-   *   console.log("Server started successfully");
-   * }
-   * ```
+   * @param dependencies
    */
-  onStartServer(routers, databaseCallback, dependenciesProvider) {
+  registerDependencies(dependencies2) {
+    this.loadTranslationFiles();
     try {
-      loaderTranslationFile(this.localLanguage);
-      this.currentRoutes = routers;
-      this.currentDependencies = dependenciesProvider || [];
-      this.serverStartTime = /* @__PURE__ */ new Date();
-      this.serverStatus = "STARTING";
-      if (!this.validateServerParameters()) {
-        return void 0;
-      }
-      const server = this.startHttpServer(databaseCallback);
-      if (this.getEnvironment.hmrEnabled) {
-        this.startHMR();
+      getEnvFileLoadingService(".env", this.localLanguage);
+      if (dependencies2 && dependencies2.length > 0) {
+        dependencies2.forEach((dependency) => {
+          this.container.register(dependency.key, dependency.factory, dependency.scope);
+        });
       }
-      return server;
-    } catch (error) {
-      this.handleStartupError(error);
+    } catch (err) {
+      SLogger(this.environmentPath).logger.error({
+        message: err.message,
+        title: "Register Dependencies",
+        errorType: err.code,
+        stackTrace: err.stack,
+        httpCodeValue: import_opticore_http_response4.HttpStatusCode.INTERNAL_SERVER_ERROR
+      });
     }
   }
   /**
-   * Validates server configuration parameters.
    *
-   * @method validateServerParameters
-   * @private
-   *
-   * @returns {boolean} True if all parameters are valid, false otherwise
-   *
-   * @remarks
-   * Validates:
-   * - Port number is valid and positive
-   * - Host is not empty
-   * - Local language is specified
-   * - HMR configuration (if enabled)
+   * @param routers
+   * @param databaseCallback
+   * @param dependenciesProvider
    */
-  validateServerParameters() {
-    loaderTranslationFile(this.localLanguage);
-    const port = Number(this.getEnvironment.appPort);
-    if (isNaN(port) || port <= 0) {
+  onStartServer(routers, databaseCallback, dependenciesProvider) {
+    this.loadTranslationFiles();
+    getEnvFileLoadingService(".env", this.localLanguage);
+    if (this.getEnvironmentValue.appPort === "" && Number(this.getEnvironmentValue.appPort) === 0) {
+      this.serverListenEvent.hostPortUndefined(Number(this.getEnvironmentValue.appPort));
+    } else if (this.getEnvironmentValue.appHost === "") {
+      this.serverListenEvent.hostUndefined(this.getEnvironmentValue.appHost);
+    } else if (Number(this.getEnvironmentValue.appPort) === 0) {
       this.serverListenEvent.portUndefined();
-      return false;
-    }
-    if (!this.getEnvironment.appHost || this.getEnvironment.appHost.trim() === "") {
-      this.serverListenEvent.hostUndefined(this.getEnvironment.appHost);
-      return false;
-    }
-    if (!this.localLanguage || this.localLanguage.trim() === "") {
-      SLogger(this.localLanguage).logger.error({
-        message: import_opticore_translator2.TranslationLoader.t("noDefaultLocalLang", this.localLanguage),
-        title: import_opticore_translator2.TranslationLoader.t("noLocalLang", this.localLanguage),
-        errorType: import_opticore_translator2.TranslationLoader.t("localLangMissing", this.localLanguage),
+    } else if (this.localLanguage === "") {
+      SLogger(this.environmentPath).logger.error({
+        message: import_opticore_translator3.TranslationLoader.t("noDefaultLocalLang", this.localLanguage),
+        title: import_opticore_translator3.TranslationLoader.t("noLocalLang", this.localLanguage),
+        errorType: import_opticore_translator3.TranslationLoader.t("localLangMissing", this.localLanguage),
         stackTrace: void 0,
-        httpCodeValue: import_opticore_http_response3.HttpStatusCode.NOT_FOUND
+        httpCodeValue: import_opticore_http_response4.HttpStatusCode.NOT_FOUND
       });
-      return false;
-    }
-    if (this.getEnvironment.hmrEnabled) {
-      if (!this.getEnvironment.hmrWatchPatterns || this.getEnvironment.hmrWatchPatterns.length === 0) {
-        SLogger(this.localLanguage).logger.warn({
-          title: import_opticore_translator2.TranslationLoader.t("HMR_CONFIG_WARNING", this.localLanguage),
-          message: "HMR enabled but no watch patterns defined"
-        });
-      }
-    }
-    return true;
-  }
-  /**
-   * Starts the HTTP server and sets up event listeners.
-   *
-   * @method startHttpServer
-   * @private
-   *
-   * @param {(env: IEnvVariables) => void} [databaseCallback] - Database connection callback
-   *
-   * @returns {serverWebApp | undefined} HTTP server instance or undefined if startup fails
-   *
-   * @throws {Error} If server fails to start
-   */
-  startHttpServer(databaseCallback) {
-    try {
-      loaderTranslationFile(this.localLanguage);
-      const port = Number(this.getEnvironment.appPort);
-      const host = this.getEnvironment.appHost;
-      this.server = this.expressApp.listen(port, host, () => {
-        try {
-          this.configureServerComponents(databaseCallback);
-          this.serverStatus = "READY";
-          SLogger(this.localLanguage).logger.info({
-            title: import_opticore_translator2.TranslationLoader.t("SERVER_RUNNING_TITLE", this.localLanguage),
-            message: import_opticore_translator2.TranslationLoader.t("SERVER_RUNNING_AT", this.localLanguage, {
-              server: `${host}:${port}`,
-              hmrEnabled: this.getEnvironment.hmrEnabled ? "with HMR" : "without HMR"
-            })
-          });
-        } catch (err) {
-          this.handleServerConfigurationError(err);
+    } else {
+      return this.expressApp.listen(
+        Number(this.getEnvironmentValue.appPort),
+        () => {
+          this.loadTranslationFiles();
+          try {
+            databaseCallback(this.getEnvironmentValue);
+            if (dependenciesProvider) {
+              this.registerDependencies(dependenciesProvider);
+            }
+            this.container.loadServices();
+            this.expressApp.use(import_opticore_express2.express.static(path3.join(import_node_process4.default.cwd(), "public/template")));
+            this.registerRoutes(routers);
+          } catch (err) {
+            SServerStartError(err, this.environmentPath);
+          }
         }
-      });
-      this.setupServerEventListeners();
-      return this.server;
-    } catch (error) {
-      this.serverListenEvent.onEventError(
-        new Error(import_opticore_translator2.TranslationLoader.t(
-          "HTTP_SERVER_FAILED",
-          this.localLanguage,
-          { errorMessage: error.message }
-        ))
       );
     }
   }
   /**
-   * Configures server components (database, dependencies, routes, etc.).
-   *
-   * @method configureServerComponents
-   * @private
-   *
-   * @param {(env: IEnvVariables) => void} [databaseCallback] - Database connection callback
-   *
-   * @returns {void}
    *
-   * @throws {Error} If component configuration fails
+   * @param serverWeb
    */
-  configureServerComponents(databaseCallback) {
-    try {
-      loaderTranslationFile(this.localLanguage);
-      if (databaseCallback && typeof databaseCallback === "function") {
-        try {
-          databaseCallback(this.getEnvironment);
-        } catch (dbError) {
-          this.serverListenEvent.listenerError(
-            new Error(import_opticore_translator2.TranslationLoader.t("DB_CON_FAILED", this.localLanguage, { dbErrorMessage: dbError.message }))
-          );
-        }
-      }
-      try {
-        new import_opticore_dependency_inject2.SContainer(this.localLanguage, this.currentDependencies);
-      } catch (depError) {
-        this.serverListenEvent.listenerError(
-          new Error(import_opticore_translator2.TranslationLoader.t("DEPENDENCY_INJECTION_FAILED", this.localLanguage, { depErrorMessage: depError.message }))
-        );
-      }
-      this.expressApp.use(import_express.default.static(path2.join(import_node_process3.default.cwd(), "public/template")));
-      this.registerRoutes(this.currentRoutes);
-      this.setupErrorHandling();
+  onListeningOnServerEvent(serverWeb) {
+    this.loadTranslationFiles();
+    serverWeb.on(import_opticore_catch_exception_error3.CEventNameError.error, (err) => {
+      this.serverListenEvent.onEventError(err);
+    }).on(import_opticore_catch_exception_error3.CEventNameError.close, () => {
+      this.serverListenEvent.serverClosing();
+    }).on(import_opticore_catch_exception_error3.CEventNameError.drop, () => {
+      this.serverListenEvent.dropNewConnection();
+    }).on(import_opticore_catch_exception_error3.CEventNameError.listening, () => {
       this.infoWebApp();
-    } catch (error) {
-      this.serverListenEvent.listenerError(
-        new Error(import_opticore_translator2.TranslationLoader.t("SERVER_COMPONENT_CONFIG_FAILED", this.localLanguage, { errorMessage: error.message }))
-      );
-      throw error;
-    }
-  }
-  /**
-   * Handles server configuration errors.
-   *
-   * @method handleServerConfigurationError
-   * @private
-   *
-   * @param {any} err - The error that occurred
-   *
-   * @returns {void}
-   */
-  handleServerConfigurationError(err) {
-    loaderTranslationFile(this.localLanguage);
-    this.serverStatus = "ERROR";
-    this.serverListenEvent.onEventError(err);
-    try {
-      SServerStartError(err, this.environmentPath);
-    } catch (startError) {
-      this.serverListenEvent.listenerError(startError);
-    }
-  }
-  /**
-   * Handles general startup errors.
-   *
-   * @method handleStartupError
-   * @private
-   *
-   * @param {any} error - The startup error
-   *
-   * @returns {void}
-   */
-  handleStartupError(error) {
-    loaderTranslationFile(this.localLanguage);
-    this.serverStatus = "ERROR";
-    this.serverListenEvent.listenerError(error);
-    SLogger(this.localLanguage).logger.error({
-      title: import_opticore_translator2.TranslationLoader.t("GLOBAL_STARTUP_ERROR", this.localLanguage),
-      message: error.message,
-      errorType: error.name || "StartupError",
-      stackTrace: error.stack,
-      httpCodeValue: import_opticore_http_response3.HttpStatusCode.INTERNAL_SERVER_ERROR
-    });
-  }
-  /**
-   * Sets up Node.js process event listeners.
-   *
-   * @method setupProcessEventListeners
-   * @private
-   *
-   * @returns {void}
-   *
-   * @remarks
-   * Listens for:
-   * - Process exit events
-   * - Uncaught exceptions
-   * - Unhandled rejections
-   * - System signals (SIGINT, SIGTERM)
-   */
-  setupProcessEventListeners() {
-    loaderTranslationFile(this.localLanguage);
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.beforeExit, (code) => {
-      this.serverListenEvent.processBeforeExit(code);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.disconnect, () => {
-      this.serverListenEvent.processDisconnected();
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.exit, (code) => {
-      this.serverListenEvent.exited(code);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.message, (message) => {
-      this.serverListenEvent.message(message);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.multipleResolves, (type, promise, reason) => {
-      this.serverListenEvent.multipleResolves(type, promise, reason);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.rejectionHandled, (promise) => {
-      this.serverListenEvent.promiseRejectionHandled(promise);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.uncaughtException, (error) => {
-      this.serverListenEvent.uncaughtException(error);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.uncaughtExceptionMonitor, (error) => {
-      this.serverListenEvent.uncaughtExceptionMonitor(error);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.unhandledRejection, (reason, promise) => {
-      this.serverListenEvent.unhandledRejection(reason, promise);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.warning, (warning) => {
-      this.serverListenEvent.warning(warning);
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.sigint, () => {
-      this.serverListenEvent.processInterrupted();
-    });
-    import_node_process3.default.on(import_opticore_catch_exception_error3.CEvent.sigterm, (signal) => {
-      this.serverListenEvent.sigtermSignalReceived(signal);
     });
   }
   /**
-   * Sets up HTTP server event listeners.
-   *
-   * @method setupServerEventListeners
-   * @private
    *
-   * @returns {void}
-   *
-   * @remarks
-   * Configures listeners for:
-   * - Server errors
-   * - Connection closing
-   * - Connection dropping
-   * - HTTP requests (for logging)
-   *
-   * @listens Server#error - Server error events
-   * @listens Server#close - Server closing events
-   * @listens Server#drop - Connection drop events
-   * @listens Server#request - HTTP request events
+   * @param serverWeb
    */
-  setupServerEventListeners() {
-    loaderTranslationFile(this.localLanguage);
-    if (!this.server) {
-      return;
-    }
-    this.server.on(import_opticore_catch_exception_error3.CEventNameError.error, (err) => {
-      this.serverListenEvent.onEventError(err);
-    });
-    this.server.on(import_opticore_catch_exception_error3.CEventNameError.close, () => {
-      this.serverListenEvent.serverClosing();
-    });
-    this.server.on(import_opticore_catch_exception_error3.CEventNameError.drop, () => {
-      this.serverListenEvent.dropNewConnection();
-    });
-    this.server.on(import_opticore_catch_exception_error3.CEventNameError.request, (req, res) => {
+  onRequestOnServerEvent(serverWeb) {
+    this.loadTranslationFiles();
+    serverWeb.on(import_opticore_catch_exception_error3.CEventNameError.request, (req, res) => {
       (0, import_opticore_request_call_event.requestCallsEvent)(
         req,
         res,
-        this.getEnvironment.appHost,
-        Number(this.getEnvironment.appPort),
+        this.getEnvironmentValue.appHost,
+        Number(this.getEnvironmentValue.appPort),
         dateTimeFormattedUtils,
         this.environmentPath,
         this.localLanguage
@@ -868,627 +591,437 @@ var WebServerCore = class {
     });
   }
   /**
-   * Sets up error handling middleware and event emitters.
    *
-   * @method setupErrorHandling
    * @private
-   *
-   * @returns {void}
    */
-  setupErrorHandling() {
+  loadTranslationFiles() {
     loaderTranslationFile(this.localLanguage);
-    SLogger(this.localLanguage).logger.info({
-      title: import_opticore_translator2.TranslationLoader.t("SETTING_UP", this.localLanguage),
-      message: import_opticore_translator2.TranslationLoader.t("SETTING_UP_ERROR", this.localLanguage)
-    });
-    this.errorEmitter = eventProcessHandler(this.localLanguage, this.expressApp);
-    if (this.errorEmitter) {
-      this.expressApp.use((err, req, res, next) => {
-        this.serverListenEvent.expressErrorHandlingMiddleware(
-          this.errorEmitter,
-          err,
-          req,
-          res,
-          next
-        );
-      });
-      this.errorEmitter.on("transformError", (error) => {
-        this.serverListenEvent.listenerError(error);
-      });
-      this.errorEmitter.on("error", (error) => {
-        this.serverListenEvent.listenerError(error);
-      });
-      this.errorEmitter.on("hotReload", (data) => {
-        SLogger(this.localLanguage).logger.info({
-          title: import_opticore_translator2.TranslationLoader.t("HOT_RELOAD_EVENT", this.localLanguage),
-          message: `Hot reload triggered for ${data.file}`
-        });
-      });
-    }
-    SLogger(this.localLanguage).logger.info({
-      title: import_opticore_translator2.TranslationLoader.t("ERROR_HANDLING", this.localLanguage),
-      message: import_opticore_translator2.TranslationLoader.t("ERROR_HANDLING_CONFIGURED", this.localLanguage)
-    });
   }
   /**
-   * Registers routes with the Express application.
    *
-   * @method registerRoutes
+   * @param allFeatureRoutes
    * @private
-   *
-   * @param {any[]} allFeatureRoutes - Array of feature routes to register
-   *
-   * @returns {void}
    */
   registerRoutes(allFeatureRoutes) {
-    allFeatureRoutes.forEach((router) => {
-      if (router.routes) {
-        router.routes.forEach((route) => {
-          this.expressApp.use(route.path, route.handler);
-        });
-      }
+    allFeatureRoutes.map((router) => {
+      router.routes.map((route) => {
+        this.expressApp.use(route.path, route.handler);
+      });
     });
   }
   /**
-   * Displays server information.
    *
-   * @method infoWebApp
    * @private
-   *
-   * @returns {void}
    */
-  infoWebApp() {
-    loaderTranslationFile(this.localLanguage);
-    this.serverUtility.infoServer(
-      this.getEnvironment.appHost,
-      Number(this.getEnvironment.appPort)
-    );
+  stackTraceErrorHandling() {
+    return eventProcessHandler(this.localLanguage);
   }
   /**
-   * Starts the Hot Module Replacement (HMR) file watching system.
    *
-   * @method startHMR
    * @private
-   *
-   * @returns {void}
-   *
-   * @remarks
-   * Configures file watcher based on environment variables:
-   * - HMR_ENABLED: Enable/disable HMR
-   * - HMR_WATCH_PATTERNS: Files to watch
-   * - HMR_IGNORE_PATTERNS: Files to ignore
-   *
-   * @throws {Error} If HMR configuration is invalid
    */
-  startHMR() {
+  infoWebApp() {
+    this.loadTranslationFiles();
+    this.serverUtility.infoServer(
+      this.getEnvironmentValue.appHost,
+      Number(this.getEnvironmentValue.appPort)
+    );
+  }
+};
+
+// src/hotReload/hotReload.watcher.ts
+var import_child_process = require("child_process");
+var import_fs2 = require("fs");
+var import_promises = require("fs/promises");
+var import_path2 = require("path");
+var import_dotenv = require("dotenv");
+var import_chalk2 = __toESM(require("chalk"), 1);
+var import_ansi_colors2 = __toESM(require("ansi-colors"), 1);
+var import_gradient_string = __toESM(require("gradient-string"), 1);
+var DEFAULT_WATCH_EXTENSIONS = [".ts", ".js", ".mjs", ".cjs", ".json"];
+var DEFAULT_HOT_RELOAD_EXTENSIONS = [".json"];
+var DEFAULT_IGNORE = [
+  "node_modules",
+  "dist",
+  ".git",
+  "package.json",
+  "package-lock.json",
+  ".idea",
+  ".vscode",
+  "coverage",
+  "logs"
+];
+var DEFAULT_DEBOUNCE_MS = 300;
+var DEFAULT_MAX_CRASH_RESTARTS = 5;
+var HotReloadWatcher = class {
+  cfg;
+  child = null;
+  watchers = [];
+  debounceTimer = null;
+  isRestarting = false;
+  crashRestartCount = 0;
+  started = false;
+  restartStart = 0;
+  constructor(config) {
+    this.cfg = {
+      entry: (0, import_path2.resolve)(config.entry),
+      runtime: config.runtime ?? "node",
+      runtimeArgs: config.runtimeArgs ?? [],
+      rootDir: (0, import_path2.resolve)(config.rootDir ?? process.cwd()),
+      watchDirs: config.watchDirs ?? [],
+      watchExtensions: config.watchExtensions ?? DEFAULT_WATCH_EXTENSIONS,
+      ignore: [...DEFAULT_IGNORE, ...config.ignore ?? []],
+      envFile: config.envFile ?? ".env",
+      hotReloadExtensions: config.hotReloadExtensions ?? DEFAULT_HOT_RELOAD_EXTENSIONS,
+      debounceMs: config.debounceMs ?? DEFAULT_DEBOUNCE_MS,
+      restartOnCrash: config.restartOnCrash ?? true,
+      maxCrashRestarts: config.maxCrashRestarts ?? DEFAULT_MAX_CRASH_RESTARTS
+    };
+  }
+  // ─── Public API ──────────────────────────────────────────────────────────
+  async start() {
+    if (this.started) return;
+    this.started = true;
+    this.printBanner();
+    this.spawnChild();
+    await this.setupWatchers();
+    this.setupProcessSignals();
+  }
+  async stop() {
+    this.watchers.forEach((w) => {
+      w.close();
+    });
+    this.watchers = [];
+    await this.killChild(true);
+    this.printStopped();
+  }
+  // ─── Child process management ────────────────────────────────────────────
+  spawnChild() {
+    const { entry, runtime, runtimeArgs } = this.cfg;
     try {
-      loaderTranslationFile(this.localLanguage);
-      const hmrConfig = this.getEnvironment;
-      if (!hmrConfig.hmrEnabled) {
-        SLogger(this.localLanguage).logger.info({
-          title: import_opticore_translator2.TranslationLoader.t("HMR_DISABLED", this.localLanguage),
-          message: "HMR is disabled in configuration"
-        });
-        return;
-      }
-      if (!hmrConfig.hmrWatchPatterns || hmrConfig.hmrWatchPatterns.length === 0) {
-        SLogger(this.localLanguage).logger.error({
-          title: import_opticore_translator2.TranslationLoader.t("HMR_WATCH_PATTERNS_MISSING", this.localLanguage),
-          message: "No watch patterns defined for HMR",
-          errorType: "HMR Configuration Error",
-          httpCodeValue: import_opticore_http_response3.HttpStatusCode.BAD_REQUEST
-        });
-        return;
-      }
-      const watchPatterns = hmrConfig.hmrWatchPatterns;
-      const ignorePatterns = hmrConfig.hmrIgnorePatterns || [
-        "node_modules/**",
-        "dist/**",
-        "build/**",
-        "*.log",
-        ".git/**"
-      ];
-      const allPatterns = [
-        ...watchPatterns,
-        ...ignorePatterns.map((pattern) => `!${pattern}`)
-      ];
-      this.fileWatcher = import_chokidar.default.watch(allPatterns, {
-        ignored: /(^|[/\\])\../,
-        persistent: true,
-        ignoreInitial: true,
-        awaitWriteFinish: {
-          stabilityThreshold: 300,
-          pollInterval: 100
-        },
-        cwd: import_node_process3.default.cwd(),
-        depth: 10
+      this.child = runtime === "node" ? (0, import_child_process.fork)(entry, [], {
+        stdio: ["inherit", "inherit", "inherit", "ipc"],
+        env: process.env
+      }) : (0, import_child_process.spawn)(runtime, [...runtimeArgs, entry], {
+        stdio: "inherit",
+        env: process.env,
+        shell: false
       });
-      this.fileWatcher.on("ready", () => this.onHMRWatcherReady(watchPatterns, ignorePatterns)).on("change", (filePath) => this.handleFileChange(filePath)).on("add", (filePath) => this.handleFileChange(filePath, "added")).on("unlink", (filePath) => this.handleFileChange(filePath, "deleted")).on("error", (error) => this.onHMRWatcherError(error));
-      this.hmrRestartCount = 0;
-      this.lastHmrRestartTime = Date.now();
-      SLogger(this.localLanguage).logger.info({
-        title: import_opticore_translator2.TranslationLoader.t("HMR_STARTED", this.localLanguage),
-        message: import_opticore_translator2.TranslationLoader.t("HMR_MONITORING_STARTED", this.localLanguage)
+      this.child.on("exit", (code) => {
+        if (this.isRestarting) return;
+        if (code !== 0 && code !== null) {
+          this.printCrash(code);
+          if (this.cfg.restartOnCrash && this.crashRestartCount < this.cfg.maxCrashRestarts) {
+            this.crashRestartCount++;
+            this.printCrashRetry(this.crashRestartCount, this.cfg.maxCrashRestarts);
+            setTimeout(() => {
+              this.spawnChild();
+            }, 1e3);
+          } else if (this.crashRestartCount >= this.cfg.maxCrashRestarts) {
+            this.printCrashLimit(this.cfg.maxCrashRestarts);
+            process.exit(1);
+          }
+        }
       });
-    } catch (error) {
-      SLogger(this.localLanguage).logger.error({
-        title: import_opticore_translator2.TranslationLoader.t("HMR_START_FAILED", this.localLanguage),
-        message: error.message,
-        errorType: "HMR Error",
-        stackTrace: error.stack
+      this.child.on("error", (err) => {
+        this.printError(`Failed to start child process: ${err.message}`);
       });
+    } catch (err) {
+      this.printError(`Cannot spawn '${runtime} ${entry}': ${err.message}`);
+      process.exit(1);
     }
   }
-  /**
-   * Handles file change events with debouncing.
-   *
-   * @method handleFileChange
-   * @private
-   *
-   * @param {string} filePath - Path of the changed file
-   * @param {string} [action="modified"] - Type of file change (modified/added/deleted)
-   *
-   * @returns {void}
-   *
-   * @remarks
-   * Uses debouncing to prevent multiple rapid reloads.
-   * Debounce time configurable via HMR_DEBOUNCE_MS environment variable.
-   */
-  handleFileChange(filePath, action = "modified") {
-    const debounceMs = this.getEnvironment.hmrDebounceMs || 500;
-    if (this.hmrDebounceTimeout) {
-      clearTimeout(this.hmrDebounceTimeout);
-    }
-    this.hmrDebounceTimeout = setTimeout(async () => {
-      await this.triggerHotReload(filePath, action);
-    }, debounceMs);
-    SLogger(this.localLanguage).logger.info({
-      title: import_opticore_translator2.TranslationLoader.t("FILE_CHANGE_DETECTED", this.localLanguage),
-      message: `File ${action}: ${filePath}`
+  async killChild(silent = false) {
+    if (!this.child) return;
+    const child = this.child;
+    this.child = null;
+    await new Promise((done) => {
+      const forceKill = setTimeout(() => {
+        child.kill("SIGKILL");
+        done();
+      }, 3e3);
+      child.once("exit", () => {
+        clearTimeout(forceKill);
+        done();
+      });
+      child.kill("SIGTERM");
     });
   }
-  /**
-   * Triggers a hot reload operation.
-   *
-   * @method triggerHotReload
-   * @private
-   *
-   * @param {string} filePath - Path of the changed file
-   * @param {string} action - Type of file change
-   *
-   * @returns {Promise<void>}
-   *
-   * @remarks
-   * - Checks if reload is already in progress
-   * - Validates restart limits
-   * - Performs appropriate reload actions based on file type
-   * - Emits hotReload event
-   */
-  async triggerHotReload(filePath, action) {
-    if (this.hmrRestartPending) {
-      return;
+  // ─── File watching ────────────────────────────────────────────────────────
+  async setupWatchers() {
+    const dirs = [
+      this.cfg.rootDir,
+      ...this.cfg.watchDirs.map((d) => (0, import_path2.resolve)(d))
+    ];
+    for (const dir of dirs) {
+      await this.watchDirectoryRecursive(dir);
     }
-    if (!this.canProceedWithHMRRestart()) {
+  }
+  async watchDirectoryRecursive(dir) {
+    if (this.shouldIgnoreDir(dir)) return;
+    try {
+      await (0, import_promises.access)(dir);
+    } catch {
       return;
     }
-    this.hmrRestartPending = true;
-    this.hmrRestartCount++;
-    this.lastHmrRestartTime = Date.now();
     try {
-      loaderTranslationFile(this.localLanguage);
-      SLogger(this.localLanguage).logger.info({
-        title: import_opticore_translator2.TranslationLoader.t("HOT_RELOAD_STARTING", this.localLanguage),
-        message: import_opticore_translator2.TranslationLoader.t("RELOADING_APPLICATION", this.localLanguage, {
-          file: filePath,
-          action
-        })
-      });
-      if (this.errorEmitter) {
-        this.errorEmitter.emit("hotReload", {
-          file: filePath,
-          action,
-          timestamp: /* @__PURE__ */ new Date(),
-          restartCount: this.hmrRestartCount
-        });
-      }
-      await this.performHotReloadActions(filePath);
-      SLogger(this.localLanguage).logger.success({
-        title: import_opticore_translator2.TranslationLoader.t("HOT_RELOAD_COMPLETE", this.localLanguage),
-        message: import_opticore_translator2.TranslationLoader.t("APPLICATION_RELOADED", this.localLanguage, {
-          file: filePath,
-          restartCount: this.hmrRestartCount,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        })
+      const watcher = (0, import_fs2.watch)(dir, (event2, filename) => {
+        if (!filename) return;
+        this.onFileChange((0, import_path2.join)(dir, filename));
       });
-    } catch (error) {
-      SLogger(this.localLanguage).logger.error({
-        title: import_opticore_translator2.TranslationLoader.t("HOT_RELOAD_FAILED", this.localLanguage),
-        message: error.message,
-        errorType: "HotReloadError",
-        stackTrace: error.stack,
-        httpCodeValue: import_opticore_http_response3.HttpStatusCode.INTERNAL_SERVER_ERROR
+      watcher.on("error", () => {
       });
-    } finally {
-      this.hmrRestartPending = false;
+      this.watchers.push(watcher);
+      const entries = await (0, import_promises.readdir)(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          await this.watchDirectoryRecursive((0, import_path2.join)(dir, entry.name));
+        }
+      }
+    } catch {
     }
   }
-  /**
-   * Performs appropriate hot reload actions based on file type.
-   *
-   * @method performHotReloadActions
-   * @private
-   *
-   * @param {string} filePath - Path of the changed file
-   *
-   * @returns {Promise<void>}
-   *
-   * @remarks
-   * Different actions for different file types:
-   * - .json/.env: Reload translations
-   * - routes/controller files: Reload routes
-   * - config/.env files: Reload dependencies
-   */
-  async performHotReloadActions(filePath) {
-    if (filePath.includes(".json") || filePath.endsWith(".env")) {
-      loaderTranslationFile(this.localLanguage);
-    }
-    if (filePath.includes("routes") || filePath.includes("controller")) {
-      await this.reloadRoutes();
-    }
-    if (filePath.includes("config") || filePath.includes(".env")) {
-      await this.reloadDependencies();
+  // ─── Change handling ─────────────────────────────────────────────────────
+  onFileChange(filePath) {
+    if (this.shouldIgnoreFile(filePath)) return;
+    if (!this.isWatchedFile(filePath)) return;
+    const rel = (0, import_path2.relative)(this.cfg.rootDir, filePath);
+    if (this.isHotReloadable(filePath)) {
+      this.doHotReload(filePath, rel);
+    } else {
+      this.scheduleRestart(rel);
     }
   }
-  /**
-   * Reloads routes dynamically.
-   *
-   * @method reloadRoutes
-   * @private
-   *
-   * @returns {Promise<void>}
-   *
-   * @throws {Error} If route reloading fails
-   *
-   * @remarks
-   * This method should be implemented based on your architecture.
-   * It should reload route modules from the filesystem.
-   */
-  async reloadRoutes() {
-    try {
-      SLogger(this.localLanguage).logger.info({
-        title: import_opticore_translator2.TranslationLoader.t("ROUTES_RELOADED", this.localLanguage),
-        message: "Routes dynamically reloaded"
-      });
-    } catch (error) {
-      throw new Error(`Route reload failed: ${error.message}`);
+  doHotReload(filePath, relativePath) {
+    if (this.isEnvFile(filePath)) {
+      (0, import_dotenv.config)({ path: filePath, override: true });
+      this.printHot(relativePath, "env variables reloaded");
+      this.sendIpc({ type: "hot-reload", file: relativePath, kind: "env" });
+    } else {
+      this.printHot(relativePath, "json config reloaded");
+      this.sendIpc({ type: "hot-reload", file: relativePath, kind: "json" });
     }
   }
-  /**
-   * Reloads dependencies dynamically.
-   *
-   * @method reloadDependencies
-   * @private
-   *
-   * @returns {Promise<void>}
-   *
-   * @throws {Error} If dependency reloading fails
-   */
-  async reloadDependencies() {
-    try {
-      if (this.currentDependencies.length > 0) {
-        new import_opticore_dependency_inject2.SContainer(this.localLanguage, this.currentDependencies);
-        SLogger(this.localLanguage).logger.info({
-          title: import_opticore_translator2.TranslationLoader.t("DEPENDENCIES_RELOADED", this.localLanguage),
-          message: "Dependencies reloaded"
-        });
+  scheduleRestart(relativePath) {
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    this.debounceTimer = setTimeout(async () => {
+      this.printReloading(relativePath);
+      this.restartStart = Date.now();
+      this.isRestarting = true;
+      this.crashRestartCount = 0;
+      await this.killChild(true);
+      this.isRestarting = false;
+      this.spawnChild();
+      this.printReady(Date.now() - this.restartStart);
+    }, this.cfg.debounceMs);
+  }
+  // ─── IPC ─────────────────────────────────────────────────────────────────
+  sendIpc(message) {
+    if (this.child && typeof this.child.send === "function") {
+      try {
+        this.child.send(message);
+      } catch {
       }
-    } catch (error) {
-      throw new Error(`Dependency reload failed: ${error.message}`);
     }
   }
-  /**
-   * Checks if HMR restart can proceed based on configuration limits.
-   *
-   * @method canProceedWithHMRRestart
-   * @private
-   *
-   * @returns {boolean} True if restart can proceed, false otherwise
-   *
-   * @remarks
-   * Checks:
-   * - Auto-restart enabled/disabled
-   * - Maximum restarts per minute limit
-   */
-  canProceedWithHMRRestart() {
-    const hmrConfig = this.getEnvironment;
-    if (!hmrConfig.hmrAutoRestarts) {
-      SLogger(this.localLanguage).logger.warn({
-        title: import_opticore_translator2.TranslationLoader.t("HMR_AUTO_RESTART_DISABLED", this.localLanguage),
-        message: "HMR auto-restart disabled"
-      });
-      return false;
-    }
-    const maxRestarts = hmrConfig.hmrMaxRestarts || 5;
-    const now = Date.now();
-    const oneMinuteAgo = now - 6e4;
-    if (this.lastHmrRestartTime < oneMinuteAgo) {
-      this.hmrRestartCount = 0;
-    }
-    if (this.hmrRestartCount >= maxRestarts) {
-      const nextReset = Math.ceil((this.lastHmrRestartTime + 6e4 - now) / 1e3);
-      SLogger(this.localLanguage).logger.error({
-        title: import_opticore_translator2.TranslationLoader.t("HMR_RESTART_LIMIT_EXCEEDED", this.localLanguage),
-        message: import_opticore_translator2.TranslationLoader.t("HMR_RESTART_LIMIT_MESSAGE", this.localLanguage, {
-          max: maxRestarts,
-          nextReset
-        })
-      });
-      return false;
-    }
-    return true;
+  // ─── Ignore / watch filters ───────────────────────────────────────────────
+  shouldIgnoreDir(dirPath) {
+    return this.cfg.ignore.some((p) => dirPath.includes(`/${p}`) || dirPath.endsWith(p));
   }
-  /**
-   * Called when the HMR watcher is ready.
-   *
-   * @method onHMRWatcherReady
-   * @private
-   *
-   * @param {string[]} watchPatterns - Patterns being watched
-   * @param {string[]} ignorePatterns - Patterns being ignored
-   *
-   * @returns {void}
-   */
-  onHMRWatcherReady(watchPatterns, ignorePatterns) {
-    SLogger(this.localLanguage).logger.info({
-      title: import_opticore_translator2.TranslationLoader.t("HMR_WATCHER_READY", this.localLanguage),
-      message: import_opticore_translator2.TranslationLoader.t("HMR_WATCHING_DETAILS", this.localLanguage, {
-        watchCount: watchPatterns,
-        ignoreCount: ignorePatterns
-      })
-    });
+  shouldIgnoreFile(filePath) {
+    const name = (0, import_path2.basename)(filePath);
+    const rel = (0, import_path2.relative)(this.cfg.rootDir, filePath);
+    return this.cfg.ignore.some((p) => name === p || rel.includes(p) || filePath.includes(`/${p}/`));
   }
-  /**
-   * Handles HMR watcher errors.
-   *
-   * @method onHMRWatcherError
-   * @private
-   *
-   * @param {Error} error - The watcher error
-   *
-   * @returns {void}
-   */
-  onHMRWatcherError(error) {
-    SLogger(this.localLanguage).logger.error({
-      title: import_opticore_translator2.TranslationLoader.t("HMR_WATCHER_ERROR", this.localLanguage),
-      message: error.message,
-      errorType: "FileWatcherError",
-      stackTrace: error.stack
-    });
+  isWatchedFile(filePath) {
+    if (this.isEnvFile(filePath)) return true;
+    return this.cfg.watchExtensions.includes((0, import_path2.extname)(filePath));
+  }
+  isHotReloadable(filePath) {
+    if (this.isEnvFile(filePath)) return true;
+    return this.cfg.hotReloadExtensions.includes((0, import_path2.extname)(filePath));
+  }
+  isEnvFile(filePath) {
+    const name = (0, import_path2.basename)(filePath);
+    return name === this.cfg.envFile || name.startsWith(".env");
+  }
+  // ─── ANSI strip helper (for width calculation) ────────────────────────────
+  strip(str) {
+    return str.replace(/\[[0-9;]*m/g, "").replace(/\][^]*/g, "");
   }
+  // ─── Timestamp ────────────────────────────────────────────────────────────
+  ts() {
+    const n = /* @__PURE__ */ new Date();
+    const h = String(n.getHours()).padStart(2, "0");
+    const m = String(n.getMinutes()).padStart(2, "0");
+    const s = String(n.getSeconds()).padStart(2, "0");
+    return `${h}:${m}:${s}`;
+  }
+  // ─── Console output ───────────────────────────────────────────────────────
   /**
-   * Stops the HMR system.
-   *
-   * @method stopHMR
-   * @private
-   *
-   * @returns {void}
+   * Startup banner — mirrors the infoServer() box style from CoreService.
+   *
+   *   ╔══════════════════════════════════════════╗
+   *   gradient title
+   *   ╔══ bgGreen box ════════════════════════╗
+   *    entry    dist/index.js
+   *    runtime  node  (IPC enabled)
+   *    root     ./src
+   *    watching .ts  .js  .json  .env
+   *    debounce 300ms
+   *   ╚══════════════════════════════════════════╝
    */
-  stopHMR() {
-    if (this.fileWatcher) {
-      this.fileWatcher.close();
-      this.fileWatcher = null;
-    }
-    if (this.hmrDebounceTimeout) {
-      clearTimeout(this.hmrDebounceTimeout);
-      this.hmrDebounceTimeout = null;
-    }
-    SLogger(this.localLanguage).logger.info({
-      title: import_opticore_translator2.TranslationLoader.t("HMR_STOPPED", this.localLanguage),
-      message: import_opticore_translator2.TranslationLoader.t("HMR_MONITORING_STOPPED", this.localLanguage)
+  printBanner() {
+    const entryRel = (0, import_path2.relative)(process.cwd(), this.cfg.entry) || this.cfg.entry;
+    const rootRel = (0, import_path2.relative)(process.cwd(), this.cfg.rootDir) || ".";
+    const runtimeStr = this.cfg.runtime === "node" ? `node  ${import_chalk2.default.blackBright("(IPC enabled)")}` : this.cfg.runtime;
+    const extStr = [...this.cfg.watchExtensions, ".env"].join("  ");
+    const ignoreStr = this.cfg.ignore.slice(0, 4).join("  ") + (this.cfg.ignore.length > 4 ? `  ${import_chalk2.default.blackBright(`+${this.cfg.ignore.length - 4} more`)}` : "");
+    const TITLE = "OPTICORE  HOT  RELOAD";
+    const rows = [
+      ` entry     ${import_chalk2.default.white.bold(entryRel)}`,
+      ` runtime   ${runtimeStr}`,
+      ` root      ${import_chalk2.default.white(rootRel)}`,
+      ` watching  ${import_chalk2.default.cyan(extStr)}`,
+      ` ignoring  ${import_chalk2.default.blackBright(ignoreStr)}`,
+      ` debounce  ${import_chalk2.default.white(`${this.cfg.debounceMs}ms`)}`
+    ];
+    const maxLen = Math.max(
+      TITLE.length + 4,
+      ...rows.map((r) => this.strip(r).length)
+    ) + 4;
+    const border = import_chalk2.default.bgGreen.white(" ".repeat(maxLen));
+    const titlePad = " ".repeat(Math.max(0, Math.floor((maxLen - TITLE.length) / 2)));
+    console.log("\n" + titlePad + (0, import_gradient_string.default)(["#43e97b", "#38f9d7", "#00c6fb"])(TITLE));
+    console.log(border);
+    rows.forEach((row) => {
+      const cleanLen = this.strip(row).length;
+      const padding = Math.max(0, maxLen - cleanLen - 2);
+      console.log(import_chalk2.default.bgGreen.white(` ${row}${" ".repeat(padding)} `));
     });
+    console.log(border);
+    console.log(import_chalk2.default.blackBright(` watching for changes...
+`));
   }
   /**
-   * Stops the server and HMR system cleanly.
-   *
-   * @method onStopServer
-   * @public
+   * HOT event — in-process reload, no server restart.
    *
-   * @returns {void}
+   *   ✔  [ HOT ]  14:23:45  |  .env                →  env variables reloaded
    */
-  onStopServer() {
-    this.stopHMR();
-    if (this.server) {
-      this.server.close(() => {
-        SLogger(this.localLanguage).logger.info({
-          title: import_opticore_translator2.TranslationLoader.t("SERVER_STOPPED", this.localLanguage),
-          message: "Server stopped cleanly"
-        });
-      });
-      this.serverStatus = "STOPPED";
-    }
+  printHot(file, action) {
+    const badge = import_ansi_colors2.default.bgCyan(import_ansi_colors2.default.white.bold("  HOT  "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const filePart = import_chalk2.default.cyan.bold(file.padEnd(32));
+    const arrow = import_chalk2.default.green("\u2192");
+    const msg = import_chalk2.default.green(action);
+    console.log(`  ${import_chalk2.default.green("\u2714")}  ${badge}  ${ts}  ${sep}  ${filePart} ${arrow}  ${msg}`);
   }
   /**
-   * Gets the current server state information.
+   * RELOAD event — server restart triggered.
    *
-   * @method getServerState
-   * @public
-   *
-   * @returns {IServerStateInfo} Server state information object
-   *
-   * @remarks
-   * Includes:
-   * - Status, host, port
-   * - Route and dependency counts
-   * - Uptime and memory usage
-   * - HMR configuration and statistics
+   *   ⚡  [ RELOAD ]  14:24:03  |  src/routes/user.ts   →  restarting server...
    */
-  getServerState() {
-    const now = /* @__PURE__ */ new Date();
-    const uptime = this.serverStartTime ? now.getTime() - this.serverStartTime.getTime() : 0;
-    return {
-      status: this.serverStatus,
-      isRunning: this.server !== void 0 && this.serverStatus === "READY",
-      host: this.getEnvironment.appHost,
-      port: Number(this.getEnvironment.appPort),
-      language: this.localLanguage,
-      routesCount: this.currentRoutes.length,
-      dependenciesCount: this.currentDependencies.length,
-      startTime: this.serverStartTime,
-      currentTime: now,
-      uptime,
-      uptimeFormatted: this.formatUptime(uptime),
-      memoryUsage: import_node_process3.default.memoryUsage(),
-      pid: import_node_process3.default.pid,
-      platform: import_node_process3.default.platform,
-      nodeVersion: import_node_process3.default.version,
-      cwd: import_node_process3.default.cwd(),
-      hmrEnabled: this.getEnvironment.hmrEnabled,
-      hmrWatchingFiles: this.getEnvironment.hmrWatchPatterns?.length || 0,
-      hmrRestartCount: this.hmrRestartCount
-    };
+  printReloading(file) {
+    const badge = import_ansi_colors2.default.bgYellow(import_ansi_colors2.default.white.bold(" RELOAD "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const filePart = import_chalk2.default.yellow.bold(file.padEnd(32));
+    const arrow = import_chalk2.default.yellow("\u2192");
+    const msg = import_chalk2.default.yellow("restarting server...");
+    console.log(`
+  ${import_chalk2.default.yellow("\u26A1")}  ${badge}  ${ts}  ${sep}  ${filePart} ${arrow}  ${msg}`);
   }
   /**
-   * Gets the current server status.
-   *
-   * @method getServerStatus
-   * @public
+   * READY event — server successfully restarted.
+   * Uses the same full-width bgGreen border as infoServer().
    *
-   * @returns {TServerStatus} Current server status
+   *   ════════════════════════════════════════════
+   *    READY   server restarted in 245ms
+   *   ════════════════════════════════════════════
    */
-  getServerStatus() {
-    return this.serverStatus;
+  printReady(elapsedMs) {
+    const msg = `  server restarted in ${import_chalk2.default.white.bold(`${elapsedMs}ms`)}`;
+    const cleanLen = this.strip(msg).length;
+    const width = Math.max(52, cleanLen + 6);
+    const border = import_chalk2.default.bgGreen.white(" ".repeat(width));
+    const padding = Math.max(0, width - cleanLen - 2);
+    const line = import_chalk2.default.bgGreen.white(` ${import_chalk2.default.bgGreen.white.bold("  READY ")} ${msg}${" ".repeat(padding)} `);
+    console.log(`  ${border}`);
+    console.log(`  ${line}`);
+    console.log(`  ${border}
+`);
   }
   /**
-   * Gets detailed server statistics.
-   *
-   * @method getServerStats
-   * @public
-   *
-   * @returns {IServerStats} Server statistics object
+   * CRASH event — unexpected child process exit.
    *
-   * @remarks
-   * Includes:
-   * - Performance metrics (CPU, memory)
-   * - Uptime information
-   * - HMR statistics
+   *   ✘  [ CRASH ]  14:24:10  |  server exited with code 1
    */
-  getServerStats() {
-    const uptime = this.serverStartTime ? Date.now() - this.serverStartTime.getTime() : 0;
-    const memory = import_node_process3.default.memoryUsage();
-    return {
-      status: this.serverStatus,
-      uptime: this.formatUptime(uptime),
-      memory: {
-        rss: this.formatBytes(memory.rss),
-        heapTotal: this.formatBytes(memory.heapTotal),
-        heapUsed: this.formatBytes(memory.heapUsed),
-        external: this.formatBytes(memory.external)
-      },
-      performance: {
-        cpuUsage: import_node_process3.default.cpuUsage(),
-        resourceUsage: import_node_process3.default.resourceUsage?.()
-      },
-      hmrStats: {
-        enabled: this.getEnvironment.hmrEnabled,
-        restartCount: this.hmrRestartCount,
-        lastRestartTime: this.lastHmrRestartTime,
-        watchingFiles: this.getEnvironment.hmrWatchPatterns?.length || 0
-      }
-    };
+  printCrash(code) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  CRASH "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.red(`server exited with code ${import_chalk2.default.bold(String(code))}`);
+    console.log(`
+  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${msg}`);
   }
   /**
-   * Formats milliseconds into a human-readable uptime string.
+   * RETRY event — auto-restart after crash.
    *
-   * @method formatUptime
-   * @private
-   *
-   * @param {number} ms - Milliseconds to format
-   *
-   * @returns {string} Formatted uptime string
-   *
-   * @example
-   * formatUptime(3661000) // returns "1h 1m 1s"
+   *   ↺  [ RETRY ]  14:24:11  |  attempt 1 / 5
    */
-  formatUptime(ms) {
-    const seconds = Math.floor(ms / 1e3);
-    const minutes = Math.floor(seconds / 60);
-    const hours = Math.floor(minutes / 60);
-    const days = Math.floor(hours / 24);
-    if (days > 0) {
-      return `${days}d ${hours % 24}h ${minutes % 60}m`;
-    } else if (hours > 0) {
-      return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
-    } else if (minutes > 0) {
-      return `${minutes}m ${seconds % 60}s`;
-    } else {
-      return `${seconds}s`;
-    }
+  printCrashRetry(attempt, max) {
+    const badge = import_ansi_colors2.default.bgMagenta(import_ansi_colors2.default.white.bold("  RETRY "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.magenta(`auto-restart attempt ${import_chalk2.default.bold(`${attempt} / ${max}`)}`);
+    console.log(`  ${import_chalk2.default.magenta("\u21BA")}  ${badge}  ${ts}  ${sep}  ${msg}`);
   }
   /**
-   * Formats bytes into a human-readable size string.
-   *
-   * @method formatBytes
-   * @private
-   *
-   * @param {number} bytes - Bytes to format
-   *
-   * @returns {string} Formatted size string
-   *
-   * @example
-   * formatBytes(1048576) // returns "1.00 MB"
+   * LIMIT reached — give up restarting.
    */
-  formatBytes(bytes) {
-    const units = ["B", "KB", "MB", "GB", "TB"];
-    let value = bytes;
-    let unitIndex = 0;
-    while (value >= 1024 && unitIndex < units.length - 1) {
-      value /= 1024;
-      unitIndex++;
-    }
-    return `${value.toFixed(2)} ${units[unitIndex]}`;
+  printCrashLimit(max) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  ERROR "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    const msg = import_chalk2.default.red(`max crash restarts reached (${import_chalk2.default.bold(String(max))}), giving up`);
+    console.log(`
+  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${msg}
+`);
   }
   /**
-   * Checks if HMR is currently active.
-   *
-   * @method isHMRActive
-   * @public
-   *
-   * @returns {boolean} True if HMR is enabled and watching files, false otherwise
+   * Error — miscellaneous internal error.
    */
-  isHMRActive() {
-    return this.getEnvironment.hmrEnabled && this.fileWatcher !== null;
+  printError(message) {
+    const badge = import_ansi_colors2.default.bgRed(import_ansi_colors2.default.white.bold("  ERROR "));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    console.error(`  ${import_chalk2.default.red("\u2718")}  ${badge}  ${ts}  ${sep}  ${import_chalk2.default.red(message)}`);
   }
   /**
-   * Gets detailed HMR information and status.
-   *
-   * @method getHMRInfo
-   * @public
-   *
-   * @returns {any} HMR information object
-   *
-   * @remarks
-   * Includes:
-   * - Configuration settings from .env
-   * - Current restart count
-   * - Watcher status
+   * Stopped — watcher shut down.
    */
-  getHMRInfo() {
-    return {
-      enabled: this.getEnvironment.hmrEnabled,
-      watchPatterns: this.getEnvironment.hmrWatchPatterns,
-      ignorePatterns: this.getEnvironment.hmrIgnorePatterns,
-      debounceMs: this.getEnvironment.hmrDebounceMs,
-      maxRestarts: this.getEnvironment.hmrMaxRestarts,
-      autoRestart: this.getEnvironment.hmrAutoRestarts,
-      currentRestartCount: this.hmrRestartCount,
-      lastRestartTime: this.lastHmrRestartTime,
-      isWatching: this.fileWatcher !== null,
-      isRestartPending: this.hmrRestartPending
+  printStopped() {
+    const badge = import_ansi_colors2.default.bgBlackBright(import_ansi_colors2.default.white.bold(" STOPPED"));
+    const ts = import_chalk2.default.blackBright(this.ts());
+    const sep = import_chalk2.default.blackBright("|");
+    console.log(`  ${import_chalk2.default.gray("\u25A0")}  ${badge}  ${ts}  ${sep}  ${import_chalk2.default.gray("watcher stopped")}
+`);
+  }
+  // ─── Graceful shutdown ────────────────────────────────────────────────────
+  setupProcessSignals() {
+    const shutdown = async () => {
+      console.log("");
+      await this.stop();
+      process.exit(0);
     };
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HotReloadWatcher,
   WebServer,
   envPath
 });