@warlock.js/core 4.0.174 → 4.1.2

package/esm/dev-server/health-checker/checkers/eslint-health-checker.mjs

@@ -0,0 +1,155 @@
+import { BaseHealthChecker } from "./base-health-checker.mjs";
+import path from "path";
+import { colors } from "@mongez/copper";
+import fs from "fs";
+import { ESLint } from "eslint";
+
+//#region ../../@warlock.js/core/src/dev-server/health-checker/checkers/eslint-health-checker.ts
+var EslintHealthChecker = class extends BaseHealthChecker {
+	constructor(..._args) {
+		super(..._args);
+		this.eslint = null;
+		this.name = "ESLint";
+		this.workerPath = "./workers/eslint-health.worker";
+		this.initialized = false;
+	}
+	/**
+	* Check if file is a lintable file
+	*/
+	isLintableFile(filePath) {
+		const ext = filePath.toLowerCase();
+		return ext.endsWith(".ts") || ext.endsWith(".tsx") || ext.endsWith(".js") || ext.endsWith(".jsx");
+	}
+	/**
+	* Initialize the health checker
+	*/
+	initialize() {
+		try {
+			const flatConfigPath = path.join(process.cwd(), "eslint.config.js");
+			const flatConfigMjsPath = path.join(process.cwd(), "eslint.config.mjs");
+			const flatConfigCjsPath = path.join(process.cwd(), "eslint.config.cjs");
+			if (!(fs.existsSync(flatConfigPath) || fs.existsSync(flatConfigMjsPath) || fs.existsSync(flatConfigCjsPath))) {
+				this.initialized = true;
+				return this;
+			}
+			this.eslint = new ESLint({ cwd: process.cwd() });
+			this.initialized = true;
+		} catch (error) {
+			console.warn("ESLint Health Checker: Failed to initialize:", error);
+			this.initialized = true;
+		}
+		return this;
+	}
+	/**
+	* Display health check results in a pretty format
+	*/
+	displayResults(file, result) {
+		const stats = result.getStats();
+		if (stats.errors === 0 && stats.warnings === 0) return;
+		const fileName = file.relativePath.replace(/\\/g, "/");
+		const errorCount = stats.errors;
+		const warningCount = stats.warnings;
+		const sourceLines = file.source ? file.source.split("\n") : [];
+		if (errorCount > 0) {
+			const errorMessages = result.messages.filter((m) => m.type === "error");
+			for (const error of errorMessages) {
+				const icon = colors.redBright("✖");
+				const level = colors.redBright(colors.bold("ERROR"));
+				console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`);
+				const ruleId = error.ruleId || "eslint";
+				console.log(`  ${colors.magentaBright(ruleId)} ${colors.dim("→")} ${colors.red(error.message)}`);
+				if (sourceLines.length > 0 && error.lineNumber > 0 && error.lineNumber <= sourceLines.length) {
+					const lineContent = sourceLines[error.lineNumber - 1];
+					const lineNum = error.lineNumber.toString().padStart(4, " ");
+					const errorLength = error.length || 1;
+					const columnIndex = error.columnNumber - 1;
+					console.log(`  ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
+					const prefixPadding = lineNum.length + 3;
+					const columnPadding = " ".repeat(columnIndex);
+					const underline = colors.redBright("~".repeat(Math.max(1, errorLength)));
+					console.log(`  ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
+				}
+			}
+		}
+		if (warningCount > 0) {
+			const warningMessages = result.messages.filter((m) => m.type === "warning");
+			for (const warning of warningMessages) {
+				const icon = colors.yellowBright("⚠");
+				const level = colors.yellowBright(colors.bold("WARNING"));
+				console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`);
+				const ruleId = warning.ruleId || "eslint";
+				console.log(`  ${colors.magentaBright(ruleId)} ${colors.dim("→")} ${colors.yellow(warning.message)}`);
+				if (sourceLines.length > 0 && warning.lineNumber > 0 && warning.lineNumber <= sourceLines.length) {
+					const lineContent = sourceLines[warning.lineNumber - 1];
+					const lineNum = warning.lineNumber.toString().padStart(4, " ");
+					const warningLength = warning.length || 1;
+					const columnIndex = warning.columnNumber - 1;
+					console.log(`  ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
+					const prefixPadding = lineNum.length + 3;
+					const columnPadding = " ".repeat(columnIndex);
+					const underline = colors.yellowBright("~".repeat(Math.max(1, warningLength)));
+					console.log(`  ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
+				}
+			}
+		}
+		const summary = [];
+		if (errorCount > 0) summary.push(colors.red(`${errorCount} error${errorCount > 1 ? "s" : ""}`));
+		if (warningCount > 0) summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? "s" : ""}`));
+	}
+	/**
+	* Validate the health of the file
+	*/
+	async validate(file, result) {
+		if (!this.isLintableFile(file.absolutePath)) {
+			result.markAsHealthy();
+			return result;
+		}
+		if (!this.eslint) {
+			result.markAsHealthy();
+			return result;
+		}
+		try {
+			const lintResults = await this.eslint.lintText(file.source, { filePath: file.absolutePath });
+			if (lintResults.length === 0) {
+				console.log("No lint results", file.relativePath);
+				result.markAsHealthy();
+				return result;
+			}
+			const lintResult = lintResults[0];
+			const errors = [];
+			const warnings = [];
+			for (const message of lintResult.messages) {
+				const isError = message.severity === 2;
+				const isWarning = message.severity === 1;
+				if (isError) errors.push({
+					message: message.message,
+					type: "error",
+					lineNumber: message.line || 1,
+					columnNumber: message.column || 1,
+					length: message.endColumn && message.column ? message.endColumn - message.column : 1,
+					ruleId: message.ruleId || void 0
+				});
+				else if (isWarning) warnings.push({
+					message: message.message,
+					type: "warning",
+					lineNumber: message.line || 1,
+					columnNumber: message.column || 1,
+					length: message.endColumn && message.column ? message.endColumn - message.column : 1,
+					ruleId: message.ruleId || void 0
+				});
+			}
+			if (errors.length > 0) result.addErrors(errors);
+			if (warnings.length > 0) result.addWarnings(warnings);
+			if (errors.length === 0 && warnings.length === 0) result.markAsHealthy();
+			else this.displayResults(file, result);
+		} catch (error) {
+			console.log("ESlint Error:", error);
+			result.markAsHealthy();
+		}
+		return result;
+	}
+};
+
+//#endregion
+export { EslintHealthChecker };
+//# sourceMappingURL=eslint-health-checker.mjs.map

package/esm/dev-server/health-checker/checkers/eslint-health-checker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint-health-checker.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/dev-server/health-checker/checkers/eslint-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ESLint } from \"eslint\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport { FileManager } from \"../../file-manager\";\nimport { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class EslintHealthChecker extends BaseHealthChecker implements FileHealthCheckerContract {\n  /**\n   * ESLint instance (using new ESLint v9 API with flat config)\n   */\n  private eslint: ESLint | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"ESLint\";\n\n  /**\n   * Path to dedicated worker file for ESLint checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/eslint-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a lintable file\n   */\n  private isLintableFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return (\n      ext.endsWith(\".ts\") || ext.endsWith(\".tsx\") || ext.endsWith(\".js\") || ext.endsWith(\".jsx\")\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): EslintHealthChecker {\n    try {\n      // Check if eslint.config.js exists (new flat config format)\n      const flatConfigPath = path.join(process.cwd(), \"eslint.config.js\");\n      const flatConfigMjsPath = path.join(process.cwd(), \"eslint.config.mjs\");\n      const flatConfigCjsPath = path.join(process.cwd(), \"eslint.config.cjs\");\n\n      const hasFlatConfig =\n        fs.existsSync(flatConfigPath) ||\n        fs.existsSync(flatConfigMjsPath) ||\n        fs.existsSync(flatConfigCjsPath);\n\n      if (!hasFlatConfig) {\n        // No flat config found, skip initialization\n        this.initialized = true;\n        return this;\n      }\n\n      // Use new ESLint v9 API with flat config\n      // ESLint will automatically find eslint.config.js in the project root\n      this.eslint = new ESLint({\n        cwd: process.cwd(),\n      });\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"ESLint Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Get rule ID from the error if available\n        const ruleId = error.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Get rule ID from the warning if available\n        const ruleId = warning.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-lintable files\n    if (!this.isLintableFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if ESLint is available\n    if (!this.eslint) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Use lintText to lint the source code directly from FileManager\n      // This ensures we always use the latest content\n      const lintResults = await this.eslint.lintText(file.source, {\n        filePath: file.absolutePath,\n      });\n\n      if (lintResults.length === 0) {\n        console.log(\"No lint results\", file.relativePath);\n        result.markAsHealthy();\n        return result;\n      }\n\n      const lintResult = lintResults[0];\n\n      // Convert ESLint messages to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n\n      for (const message of lintResult.messages) {\n        const isError = message.severity === 2;\n        const isWarning = message.severity === 1;\n\n        if (isError) {\n          errors.push({\n            message: message.message,\n            type: \"error\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        } else if (isWarning) {\n          warnings.push({\n            message: message.message,\n            type: \"warning\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.log(\"ESlint Error:\", error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/health-checker/checkers/typescript-health-checker.d.mts

@@ -0,0 +1,60 @@
+import { FileManager } from "../../file-manager.mjs";
+import { FileHealthResult } from "../file-health-result.mjs";
+import { FileHealthCheckerContract } from "../file-health-checker.contract.mjs";
+import { BaseHealthChecker } from "./base-health-checker.mjs";
+
+//#region ../../@warlock.js/core/src/dev-server/health-checker/checkers/typescript-health-checker.d.ts
+declare class TypescriptHealthChecker extends BaseHealthChecker implements FileHealthCheckerContract {
+  /**
+   * Cached TypeScript program instance
+   */
+  private program;
+  /**
+   * Cached parsed TypeScript configuration
+   */
+  private parsedConfig;
+  /**
+   * Health checker name
+   */
+  name: string;
+  /**
+   * Path to dedicated worker file for TypeScript checking
+   * Runs in a separate thread to avoid blocking the main dev server
+   */
+  workerPath: string;
+  /**
+   * Whether checker is initialized
+   */
+  private initialized;
+  /**
+   * Check if file is a TypeScript file
+   */
+  private isTypeScriptFile;
+  /**
+   * Extract line and column from diagnostic location
+   */
+  private getDiagnosticLocation;
+  /**
+   * Format diagnostic message
+   */
+  private formatDiagnosticMessage;
+  /**
+   * Display health check results in a pretty format
+   */
+  private displayResults;
+  /**
+   * Detect when files are changed
+   */
+  onFileChanges(files: FileManager[]): Promise<void>;
+  /**
+   * Initialize the health checker
+   */
+  initialize(): TypescriptHealthChecker;
+  /**
+   * Validate the health of the file
+   */
+  validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult>;
+}
+//#endregion
+export { TypescriptHealthChecker };
+//# sourceMappingURL=typescript-health-checker.d.mts.map

package/esm/dev-server/health-checker/checkers/typescript-health-checker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-health-checker.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/core/src/dev-server/health-checker/checkers/typescript-health-checker.ts"],"mappings":";;;;;;cAQa,uBAAA,SACH,iBAAA,YACG,yBAAA;;AAFb;;UAOU,OAAA;EA6L0B;;;EAAA,QAxL1B,YAAA;EAmPyC;;;EA9O1C,IAAA;EAfI;;;;EAqBJ,UAAA;EAhBC;;;EAAA,QAqBA,WAAA;EAAA;;;EAAA,QAKA,gBAAA;EA0CA;;;EAAA,QAlCA,qBAAA;EA2J0C;;;EAAA,QAvI1C,uBAAA;EAkMoB;;;EAAA,QApLpB,cAAA;EAoL4D;;;EA3DvD,aAAA,CAAc,KAAA,EAAO,WAAA,KAAgB,OAAA;;;;EAoB3C,UAAA,CAAA,GAAc,uBAAA;;;;EAuCR,QAAA,CAAS,IAAA,EAAM,WAAA,EAAa,MAAA,EAAQ,gBAAA,GAAmB,OAAA,CAAQ,gBAAA;AAAA"}

package/esm/dev-server/health-checker/checkers/typescript-health-checker.mjs

@@ -0,0 +1,192 @@
+import { tsconfigManager } from "../../tsconfig-manager.mjs";
+import { BaseHealthChecker } from "./base-health-checker.mjs";
+import { colors } from "@mongez/copper";
+import ts from "typescript";
+
+//#region ../../@warlock.js/core/src/dev-server/health-checker/checkers/typescript-health-checker.ts
+var TypescriptHealthChecker = class extends BaseHealthChecker {
+	constructor(..._args) {
+		super(..._args);
+		this.program = null;
+		this.parsedConfig = null;
+		this.name = "TypeScript";
+		this.workerPath = "./workers/ts-health.worker";
+		this.initialized = false;
+	}
+	/**
+	* Check if file is a TypeScript file
+	*/
+	isTypeScriptFile(filePath) {
+		const ext = filePath.toLowerCase();
+		return ext.endsWith(".ts") || ext.endsWith(".tsx");
+	}
+	/**
+	* Extract line and column from diagnostic location
+	*/
+	getDiagnosticLocation(diagnostic) {
+		if (diagnostic.file && diagnostic.start !== void 0) {
+			const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+			return {
+				lineNumber: line + 1,
+				columnNumber: character + 1
+			};
+		}
+		return {
+			lineNumber: 1,
+			columnNumber: 1
+		};
+	}
+	/**
+	* Format diagnostic message
+	*/
+	formatDiagnosticMessage(diagnostic) {
+		if (diagnostic.file && diagnostic.start !== void 0) return ts.formatDiagnostic(diagnostic, {
+			getCurrentDirectory: () => process.cwd(),
+			getCanonicalFileName: (fileName) => fileName,
+			getNewLine: () => "\n"
+		});
+		return diagnostic.messageText.toString();
+	}
+	/**
+	* Display health check results in a pretty format
+	*/
+	displayResults(file, result) {
+		const stats = result.getStats();
+		if (stats.errors === 0 && stats.warnings === 0) return;
+		const fileName = file.relativePath.replace(/\\/g, "/");
+		const errorCount = stats.errors;
+		const warningCount = stats.warnings;
+		const sourceLines = file.source ? file.source.split("\n") : [];
+		if (errorCount > 0) {
+			const errorMessages = result.messages.filter((m) => m.type === "error");
+			for (const error of errorMessages) {
+				const icon = colors.redBright("✖");
+				const level = colors.redBright(colors.bold("ERROR"));
+				console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`);
+				const cleanMessage = error.message.split("\n").map((line) => line.replace(/^[^:]+:\d+:\d+ - /, "").trim()).filter((line) => line.length > 0).join("\n");
+				console.log(`  ${colors.dim("→")} ${colors.red(cleanMessage)}`);
+				if (sourceLines.length > 0 && error.lineNumber > 0 && error.lineNumber <= sourceLines.length) {
+					const lineContent = sourceLines[error.lineNumber - 1];
+					const lineNum = error.lineNumber.toString().padStart(4, " ");
+					const errorLength = error.length || 1;
+					const columnIndex = error.columnNumber - 1;
+					console.log(`  ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
+					const prefixPadding = lineNum.length + 3;
+					const columnPadding = " ".repeat(columnIndex);
+					const underline = colors.redBright("~".repeat(Math.max(1, errorLength)));
+					console.log(`  ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
+				}
+			}
+		}
+		if (warningCount > 0) {
+			const warningMessages = result.messages.filter((m) => m.type === "warning");
+			for (const warning of warningMessages) {
+				const icon = colors.yellowBright("⚠");
+				const level = colors.yellowBright(colors.bold("WARNING"));
+				console.log(`\n${icon} ${level} ${colors.dim("in")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`);
+				const cleanMessage = warning.message.split("\n").map((line) => line.replace(/^[^:]+:\d+:\d+ - /, "").trim()).filter((line) => line.length > 0).join("\n");
+				console.log(`  ${colors.dim("→")} ${colors.yellow(cleanMessage)}`);
+				if (sourceLines.length > 0 && warning.lineNumber > 0 && warning.lineNumber <= sourceLines.length) {
+					const lineContent = sourceLines[warning.lineNumber - 1];
+					const lineNum = warning.lineNumber.toString().padStart(4, " ");
+					const warningLength = warning.length || 1;
+					const columnIndex = warning.columnNumber - 1;
+					console.log(`  ${colors.dim(lineNum)} ${colors.dim("│")} ${lineContent || ""}`);
+					const prefixPadding = lineNum.length + 3;
+					const columnPadding = " ".repeat(columnIndex);
+					const underline = colors.yellowBright("~".repeat(Math.max(1, warningLength)));
+					console.log(`  ${colors.dim(" ".repeat(prefixPadding))}${columnPadding}${underline}`);
+				}
+			}
+		}
+		const summary = [];
+		if (errorCount > 0) summary.push(colors.red(`${errorCount} error${errorCount > 1 ? "s" : ""}`));
+		if (warningCount > 0) summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? "s" : ""}`));
+	}
+	/**
+	* Detect when files are changed
+	*/
+	async onFileChanges(files) {
+		if (!this.parsedConfig) return;
+		this.program = ts.createProgram(files.map((file) => file.absolutePath), {
+			...this.parsedConfig.options,
+			incremental: true
+		}, void 0, this.program);
+	}
+	/**
+	* Initialize the health checker
+	*/
+	initialize() {
+		try {
+			if (!tsconfigManager.tsconfig || Object.keys(tsconfigManager.tsconfig).length === 0) {
+				this.initialized = true;
+				return this;
+			}
+			this.parsedConfig = ts.parseJsonConfigFileContent(tsconfigManager.tsconfig, ts.sys, process.cwd());
+			if (this.parsedConfig.errors.length > 0) console.warn("TypeScript Health Checker: tsconfig.json has errors:", this.parsedConfig.errors.map((e) => ts.formatDiagnostic(e, ts.createCompilerHost({}))));
+			this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);
+			this.initialized = true;
+		} catch (error) {
+			console.warn("TypeScript Health Checker: Failed to initialize:", error);
+			this.initialized = true;
+		}
+		return this;
+	}
+	/**
+	* Validate the health of the file
+	*/
+	async validate(file, result) {
+		if (!this.isTypeScriptFile(file.absolutePath)) {
+			result.markAsHealthy();
+			return result;
+		}
+		if (!this.parsedConfig) {
+			result.markAsHealthy();
+			return result;
+		}
+		try {
+			if (!this.program) this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);
+			const sourceFile = this.program.getSourceFile(file.absolutePath);
+			if (!sourceFile) {
+				result.markAsHealthy();
+				return result;
+			}
+			const syntacticDiagnostics = this.program.getSyntacticDiagnostics(sourceFile);
+			const semanticDiagnostics = this.program.getSemanticDiagnostics(sourceFile);
+			const allDiagnostics = [...syntacticDiagnostics, ...semanticDiagnostics];
+			const errors = [];
+			const warnings = [];
+			for (const diagnostic of allDiagnostics) {
+				const location = this.getDiagnosticLocation(diagnostic);
+				const message = this.formatDiagnosticMessage(diagnostic);
+				const errorLength = diagnostic.length || 1;
+				if (diagnostic.category === ts.DiagnosticCategory.Error) errors.push({
+					message,
+					type: "error",
+					lineNumber: location.lineNumber,
+					columnNumber: location.columnNumber,
+					length: errorLength
+				});
+				else if (diagnostic.category === ts.DiagnosticCategory.Warning) warnings.push({
+					message,
+					type: "warning",
+					lineNumber: location.lineNumber,
+					columnNumber: location.columnNumber,
+					length: errorLength
+				});
+			}
+			if (errors.length > 0) result.addErrors(errors);
+			if (warnings.length > 0) result.addWarnings(warnings);
+			if (errors.length === 0 && warnings.length === 0) result.markAsHealthy();
+			else this.displayResults(file, result);
+		} catch (error) {
+			console.warn(`TypeScript Health Checker: Error validating file ${file.relativePath}:`, error);
+			result.markAsHealthy();
+		}
+		return result;
+	}
+};
+
+//#endregion
+export { TypescriptHealthChecker };
+//# sourceMappingURL=typescript-health-checker.mjs.map

package/esm/dev-server/health-checker/checkers/typescript-health-checker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-health-checker.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/dev-server/health-checker/checkers/typescript-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport ts from \"typescript\";\nimport { FileManager } from \"../../file-manager\";\nimport { tsconfigManager } from \"../../tsconfig-manager\";\nimport { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class TypescriptHealthChecker\n  extends BaseHealthChecker\n  implements FileHealthCheckerContract\n{\n  /**\n   * Cached TypeScript program instance\n   */\n  private program: ts.Program | null = null;\n\n  /**\n   * Cached parsed TypeScript configuration\n   */\n  private parsedConfig: ts.ParsedCommandLine | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"TypeScript\";\n\n  /**\n   * Path to dedicated worker file for TypeScript checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/ts-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a TypeScript file\n   */\n  private isTypeScriptFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return ext.endsWith(\".ts\") || ext.endsWith(\".tsx\");\n  }\n\n  /**\n   * Extract line and column from diagnostic location\n   */\n  private getDiagnosticLocation(diagnostic: ts.Diagnostic): {\n    lineNumber: number;\n    columnNumber: number;\n  } {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);\n      return {\n        lineNumber: line + 1, // TypeScript uses 0-based, we use 1-based\n        columnNumber: character + 1,\n      };\n    }\n    return {\n      lineNumber: 1,\n      columnNumber: 1,\n    };\n  }\n\n  /**\n   * Format diagnostic message\n   */\n  private formatDiagnosticMessage(diagnostic: ts.Diagnostic): string {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      return ts.formatDiagnostic(diagnostic, {\n        getCurrentDirectory: () => process.cwd(),\n        getCanonicalFileName: (fileName) => fileName,\n        getNewLine: () => \"\\n\",\n      });\n    }\n    return diagnostic.messageText.toString();\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display header\n    // console.log(\n    //   `\\n${colors.dim(\"╭─\")} ${colors.bold(colors.cyanBright(\"TypeScript Health\"))} ${colors.dim(\"→\")} ${colors.cyan(fileName)}`,\n    // );\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = error.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.red(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = warning.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.yellow(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n\n    // console.log(\n    //   `\\n${colors.dim(\"╰─\")} ${colors.bold(\"TypeScript\")} ${colors.dim(\"→\")} ${summary.join(colors.dim(\" and \"))}`,\n    // );\n  }\n\n  /**\n   * Detect when files are changed\n   */\n  public async onFileChanges(files: FileManager[]): Promise<void> {\n    // recreate an incremental program\n    if (!this.parsedConfig) {\n      return;\n    }\n\n    this.program = ts.createProgram(\n      files.map((file) => file.absolutePath),\n      {\n        ...this.parsedConfig.options,\n        incremental: true,\n      },\n      undefined,\n      this.program!,\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): TypescriptHealthChecker {\n    try {\n      // Verify tsconfigManager is initialized and has config\n      if (!tsconfigManager.tsconfig || Object.keys(tsconfigManager.tsconfig).length === 0) {\n        this.initialized = true;\n        return this;\n      }\n\n      // Parse the config using tsconfigManager's cached config\n      this.parsedConfig = ts.parseJsonConfigFileContent(\n        tsconfigManager.tsconfig,\n        ts.sys,\n        process.cwd(),\n      );\n\n      // Check for config errors\n      if (this.parsedConfig.errors.length > 0) {\n        // Log config errors but continue (will skip validation)\n        console.warn(\n          \"TypeScript Health Checker: tsconfig.json has errors:\",\n          this.parsedConfig.errors.map((e) => ts.formatDiagnostic(e, ts.createCompilerHost({}))),\n        );\n      }\n\n      this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"TypeScript Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-TypeScript files\n    if (!this.isTypeScriptFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if parsed config is available\n    if (!this.parsedConfig) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Lazy-load program on first validation if not already created\n      if (!this.program) {\n        // Create program with all project files from parsed config (for proper type checking)\n        this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n      }\n\n      // Get source file from program\n      const sourceFile = this.program.getSourceFile(file.absolutePath);\n\n      // If file is not in the program, return healthy (might be excluded)\n      if (!sourceFile) {\n        result.markAsHealthy();\n        return result;\n      }\n\n      // Get diagnostics for the specific file only\n      const syntacticDiagnostics = this.program.getSyntacticDiagnostics(sourceFile);\n      const semanticDiagnostics = this.program.getSemanticDiagnostics(sourceFile);\n\n      // Combine all diagnostics\n      const allDiagnostics = [...syntacticDiagnostics, ...semanticDiagnostics];\n\n      // Convert TypeScript diagnostics to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n\n      for (const diagnostic of allDiagnostics) {\n        const location = this.getDiagnosticLocation(diagnostic);\n        const message = this.formatDiagnosticMessage(diagnostic);\n        const errorLength = diagnostic.length || 1;\n\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          errors.push({\n            message,\n            type: \"error\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          warnings.push({\n            message,\n            type: \"warning\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.warn(`TypeScript Health Checker: Error validating file ${file.relativePath}:`, error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":";;;;;;AAQA,IAAa,0BAAb,cACU,kBAEV;;;iBAIuC;sBAKe;cAK9B;oBAMM;qBAKG;;;;;CAK/B,AAAQ,iBAAiB,UAA2B;EAClD,MAAM,MAAM,SAAS,YAAY;EACjC,OAAO,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,MAAM;CACnD;;;;CAKA,AAAQ,sBAAsB,YAG5B;EACA,IAAI,WAAW,QAAQ,WAAW,UAAU,QAAW;GACrD,MAAM,EAAE,MAAM,cAAc,WAAW,KAAK,8BAA8B,WAAW,KAAK;GAC1F,OAAO;IACL,YAAY,OAAO;IACnB,cAAc,YAAY;GAC5B;EACF;EACA,OAAO;GACL,YAAY;GACZ,cAAc;EAChB;CACF;;;;CAKA,AAAQ,wBAAwB,YAAmC;EACjE,IAAI,WAAW,QAAQ,WAAW,UAAU,QAC1C,OAAO,GAAG,iBAAiB,YAAY;GACrC,2BAA2B,QAAQ,IAAI;GACvC,uBAAuB,aAAa;GACpC,kBAAkB;EACpB,CAAC;EAEH,OAAO,WAAW,YAAY,SAAS;CACzC;;;;CAKA,AAAQ,eAAe,MAAmB,QAAgC;EACxE,MAAM,QAAQ,OAAO,SAAS;EAG9B,IAAI,MAAM,WAAW,KAAK,MAAM,aAAa,GAC3C;EAGF,MAAM,WAAW,KAAK,aAAa,QAAQ,OAAO,GAAG;EACrD,MAAM,aAAa,MAAM;EACzB,MAAM,eAAe,MAAM;EAC3B,MAAM,cAAc,KAAK,SAAS,KAAK,OAAO,MAAM,IAAI,IAAI,CAAC;EAQ7D,IAAI,aAAa,GAAG;GAClB,MAAM,gBAAgB,OAAO,SAAS,QAAQ,MAAM,EAAE,SAAS,OAAO;GACtE,KAAK,MAAM,SAAS,eAAe;IACjC,MAAM,OAAO,OAAO,UAAU,GAAG;IACjC,MAAM,QAAQ,OAAO,UAAU,OAAO,KAAK,OAAO,CAAC;IACnD,QAAQ,IACN,KAAK,KAAK,GAAG,MAAM,GAAG,OAAO,IAAI,IAAI,EAAE,GAAG,OAAO,WAAW,QAAQ,IAAI,OAAO,IAAI,IAAI,MAAM,WAAW,GAAG,MAAM,aAAa,EAAE,GAClI;IAGA,MAAM,eADe,MAAM,QAAQ,MAAM,IACT,EAC7B,KAAK,SAAS,KAAK,QAAQ,qBAAqB,EAAE,EAAE,KAAK,CAAC,EAC1D,QAAQ,SAAS,KAAK,SAAS,CAAC,EAChC,KAAK,IAAI;IACZ,QAAQ,IAAI,KAAK,OAAO,IAAI,GAAG,EAAE,GAAG,OAAO,IAAI,YAAY,GAAG;IAG9D,IACE,YAAY,SAAS,KACrB,MAAM,aAAa,KACnB,MAAM,cAAc,YAAY,QAChC;KAEA,MAAM,cAAc,YADF,MAAM,aAAa;KAErC,MAAM,UAAU,MAAM,WAAW,SAAS,EAAE,SAAS,GAAG,GAAG;KAC3D,MAAM,cAAc,MAAM,UAAU;KACpC,MAAM,cAAc,MAAM,eAAe;KAGzC,QAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,eAAe,IAAI;KAK9E,MAAM,gBAAgB,QAAQ,SAAS;KACvC,MAAM,gBAAgB,IAAI,OAAO,WAAW;KAC5C,MAAM,YAAY,OAAO,UAAU,IAAI,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC,CAAC;KACvE,QAAQ,IAAI,KAAK,OAAO,IAAI,IAAI,OAAO,aAAa,CAAC,IAAI,gBAAgB,WAAW;IACtF;GACF;EACF;EAGA,IAAI,eAAe,GAAG;GACpB,MAAM,kBAAkB,OAAO,SAAS,QAAQ,MAAM,EAAE,SAAS,SAAS;GAC1E,KAAK,MAAM,WAAW,iBAAiB;IACrC,MAAM,OAAO,OAAO,aAAa,GAAG;IACpC,MAAM,QAAQ,OAAO,aAAa,OAAO,KAAK,SAAS,CAAC;IACxD,QAAQ,IACN,KAAK,KAAK,GAAG,MAAM,GAAG,OAAO,IAAI,IAAI,EAAE,GAAG,OAAO,WAAW,QAAQ,IAAI,OAAO,IAAI,IAAI,QAAQ,WAAW,GAAG,QAAQ,aAAa,EAAE,GACtI;IAGA,MAAM,eADe,QAAQ,QAAQ,MAAM,IACX,EAC7B,KAAK,SAAS,KAAK,QAAQ,qBAAqB,EAAE,EAAE,KAAK,CAAC,EAC1D,QAAQ,SAAS,KAAK,SAAS,CAAC,EAChC,KAAK,IAAI;IACZ,QAAQ,IAAI,KAAK,OAAO,IAAI,GAAG,EAAE,GAAG,OAAO,OAAO,YAAY,GAAG;IAGjE,IACE,YAAY,SAAS,KACrB,QAAQ,aAAa,KACrB,QAAQ,cAAc,YAAY,QAClC;KAEA,MAAM,cAAc,YADF,QAAQ,aAAa;KAEvC,MAAM,UAAU,QAAQ,WAAW,SAAS,EAAE,SAAS,GAAG,GAAG;KAC7D,MAAM,gBAAgB,QAAQ,UAAU;KACxC,MAAM,cAAc,QAAQ,eAAe;KAG3C,QAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,EAAE,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,eAAe,IAAI;KAK9E,MAAM,gBAAgB,QAAQ,SAAS;KACvC,MAAM,gBAAgB,IAAI,OAAO,WAAW;KAC5C,MAAM,YAAY,OAAO,aAAa,IAAI,OAAO,KAAK,IAAI,GAAG,aAAa,CAAC,CAAC;KAC5E,QAAQ,IAAI,KAAK,OAAO,IAAI,IAAI,OAAO,aAAa,CAAC,IAAI,gBAAgB,WAAW;IACtF;GACF;EACF;EAGA,MAAM,UAAU,CAAC;EACjB,IAAI,aAAa,GACf,QAAQ,KAAK,OAAO,IAAI,GAAG,WAAW,QAAQ,aAAa,IAAI,MAAM,IAAI,CAAC;EAE5E,IAAI,eAAe,GACjB,QAAQ,KAAK,OAAO,OAAO,GAAG,aAAa,UAAU,eAAe,IAAI,MAAM,IAAI,CAAC;CAMvF;;;;CAKA,MAAa,cAAc,OAAqC;EAE9D,IAAI,CAAC,KAAK,cACR;EAGF,KAAK,UAAU,GAAG,cAChB,MAAM,KAAK,SAAS,KAAK,YAAY,GACrC;GACE,GAAG,KAAK,aAAa;GACrB,aAAa;EACf,GACA,QACA,KAAK,OACP;CACF;;;;CAKA,AAAO,aAAsC;EAC3C,IAAI;GAEF,IAAI,CAAC,gBAAgB,YAAY,OAAO,KAAK,gBAAgB,QAAQ,EAAE,WAAW,GAAG;IACnF,KAAK,cAAc;IACnB,OAAO;GACT;GAGA,KAAK,eAAe,GAAG,2BACrB,gBAAgB,UAChB,GAAG,KACH,QAAQ,IAAI,CACd;GAGA,IAAI,KAAK,aAAa,OAAO,SAAS,GAEpC,QAAQ,KACN,wDACA,KAAK,aAAa,OAAO,KAAK,MAAM,GAAG,iBAAiB,GAAG,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC,CACvF;GAGF,KAAK,UAAU,GAAG,cAAc,KAAK,aAAa,WAAW,KAAK,aAAa,OAAO;GAEtF,KAAK,cAAc;EACrB,SAAS,OAAO;GAEd,QAAQ,KAAK,oDAAoD,KAAK;GACtE,KAAK,cAAc;EACrB;EAEA,OAAO;CACT;;;;CAKA,MAAa,SAAS,MAAmB,QAAqD;EAE5F,IAAI,CAAC,KAAK,iBAAiB,KAAK,YAAY,GAAG;GAC7C,OAAO,cAAc;GACrB,OAAO;EACT;EAGA,IAAI,CAAC,KAAK,cAAc;GACtB,OAAO,cAAc;GACrB,OAAO;EACT;EAEA,IAAI;GAEF,IAAI,CAAC,KAAK,SAER,KAAK,UAAU,GAAG,cAAc,KAAK,aAAa,WAAW,KAAK,aAAa,OAAO;GAIxF,MAAM,aAAa,KAAK,QAAQ,cAAc,KAAK,YAAY;GAG/D,IAAI,CAAC,YAAY;IACf,OAAO,cAAc;IACrB,OAAO;GACT;GAGA,MAAM,uBAAuB,KAAK,QAAQ,wBAAwB,UAAU;GAC5E,MAAM,sBAAsB,KAAK,QAAQ,uBAAuB,UAAU;GAG1E,MAAM,iBAAiB,CAAC,GAAG,sBAAsB,GAAG,mBAAmB;GAGvE,MAAM,SAMD,CAAC;GACN,MAAM,WAMD,CAAC;GAEN,KAAK,MAAM,cAAc,gBAAgB;IACvC,MAAM,WAAW,KAAK,sBAAsB,UAAU;IACtD,MAAM,UAAU,KAAK,wBAAwB,UAAU;IACvD,MAAM,cAAc,WAAW,UAAU;IAEzC,IAAI,WAAW,aAAa,GAAG,mBAAmB,OAChD,OAAO,KAAK;KACV;KACA,MAAM;KACN,YAAY,SAAS;KACrB,cAAc,SAAS;KACvB,QAAQ;IACV,CAAC;SACI,IAAI,WAAW,aAAa,GAAG,mBAAmB,SACvD,SAAS,KAAK;KACZ;KACA,MAAM;KACN,YAAY,SAAS;KACrB,cAAc,SAAS;KACvB,QAAQ;IACV,CAAC;GAEL;GAGA,IAAI,OAAO,SAAS,GAClB,OAAO,UAAU,MAAM;GAEzB,IAAI,SAAS,SAAS,GACpB,OAAO,YAAY,QAAQ;GAI7B,IAAI,OAAO,WAAW,KAAK,SAAS,WAAW,GAC7C,OAAO,cAAc;QAGrB,KAAK,eAAe,MAAM,MAAM;EAEpC,SAAS,OAAO;GAEd,QAAQ,KAAK,oDAAoD,KAAK,aAAa,IAAI,KAAK;GAC5F,OAAO,cAAc;EACvB;EAEA,OAAO;CACT;AACF"}

package/esm/dev-server/health-checker/file-health-checker.contract.d.mts

@@ -0,0 +1,63 @@
+import { FileManager } from "../file-manager.mjs";
+import { FileHealthResult } from "./file-health-result.mjs";
+
+//#region ../../@warlock.js/core/src/dev-server/health-checker/file-health-checker.contract.d.ts
+type HealthCheckerFilesStats = {
+  name: string;
+  files: {
+    healthy: number;
+    defective: number;
+  };
+  warnings: {
+    total: number;
+    totalFiles: number;
+  };
+  errors: {
+    total: number;
+    totalFiles: number;
+  };
+};
+interface FileHealthCheckerContract {
+  /**
+   * Health checker name (unique identifier)
+   */
+  name: string;
+  /**
+   * Path to worker file (without extension)
+   *
+   * If provided, the checker runs in a dedicated worker thread.
+   * If undefined, the checker runs in the main thread.
+   *
+   * The path should be relative to the checker's location, without file extension.
+   * The system automatically handles:
+   * - `.ts` extension in development (with tsx loader)
+   * - `.js` extension in production (compiled)
+   *
+   * @example "./workers/ts-health.worker"
+   */
+  workerPath?: string;
+  /**
+   * Initialize the health checker
+   * Called once on startup (before any checks run)
+   */
+  initialize(): void;
+  /**
+   * Detect when files are changed
+   */
+  onFileChanges(files: FileManager[]): Promise<void>;
+  /**
+   * Remove the given file from the checker
+   */
+  removeFile(file: FileManager): void;
+  /**
+   * Validate the health of the file
+   */
+  check(file: FileManager): Promise<FileHealthResult>;
+  /**
+   * @TODO: update it to display the entire health stats of the checker
+   */
+  stats(): Promise<HealthCheckerFilesStats>;
+}
+//#endregion
+export { FileHealthCheckerContract, HealthCheckerFilesStats };
+//# sourceMappingURL=file-health-checker.contract.d.mts.map

package/esm/dev-server/health-checker/file-health-checker.contract.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-health-checker.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/dev-server/health-checker/file-health-checker.contract.ts"],"mappings":";;;;KAGY,uBAAA;EACV,IAAA;EACA,KAAA;IACE,OAAA;IACA,SAAA;EAAA;EAEF,QAAA;IACE,KAAA;IACA,UAAA;EAAA;EAEF,MAAA;IACE,KAAA;IACA,UAAA;EAAA;AAAA;AAAA,UAIa,yBAAA;EAJH;AAAA;AAId;EAIE,IAAA;;;;;;;;;;;;;;EAeA,UAAA;EAWA;;;;EALA,UAAA;EAUiB;;;EALjB,aAAA,CAAc,KAAA,EAAO,WAAA,KAAgB,OAAA;EAU/B;;;EALN,UAAA,CAAW,IAAA,EAAM,WAAA;EAUR;;;EALT,KAAA,CAAM,IAAA,EAAM,WAAA,GAAc,OAAA,CAAQ,gBAAA;;;;EAKlC,KAAA,IAAS,OAAA,CAAQ,uBAAA;AAAA"}

package/esm/dev-server/health-checker/file-health-result.d.mts

@@ -0,0 +1,70 @@
+//#region ../../@warlock.js/core/src/dev-server/health-checker/file-health-result.d.ts
+type FileHealthStats = {
+  /**
+   * File Health State
+   */
+  state: "healthy" | "defective";
+  /**
+   * Number of errors
+   */
+  errors: number;
+  /**
+   * Number of warnings
+   */
+  warnings: number;
+};
+type FileHealthMessage = {
+  /**
+   * Message
+   */
+  message: string;
+  /**
+   * Type of the message
+   */
+  type: "error" | "warning";
+  /**
+   * Line number
+   */
+  lineNumber: number;
+  /**
+   * Column number
+   */
+  columnNumber: number;
+  /**
+   * Length of the error/warning span
+   */
+  length?: number;
+  /**
+   * Rule ID (for ESLint)
+   */
+  ruleId?: string;
+};
+declare class FileHealthResult {
+  /**
+   * Result of the health check
+   */
+  result: "healthy" | "defective";
+  /**
+   * Messages list (either for errors or warnings)
+   */
+  messages: FileHealthMessage[];
+  /**
+   * Mark as healthy
+   */
+  markAsHealthy(): void;
+  /**
+   * Add errors
+   */
+  addErrors(messages: FileHealthMessage[]): void;
+  /**
+   * Add warnings
+   */
+  addWarnings(messages: FileHealthMessage[]): void;
+  /**
+   * Get file health stats
+   */
+  getStats(): FileHealthStats;
+}
+//#endregion
+export { FileHealthResult };
+//# sourceMappingURL=file-health-result.d.mts.map

package/esm/dev-server/health-checker/file-health-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-health-result.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/dev-server/health-checker/file-health-result.ts"],"mappings":";KAAK,eAAA;EAAA;;;EAIH,KAAA;EAAA;;;EAIA,MAAA;EAIQ;AAAA;;EAAR,QAAA;AAAA;AAAA,KAGG,iBAAA;EAQH;;;EAJA,OAAA;EAoBA;;AAAM;EAhBN,IAAA;EAmB2B;;;EAf3B,UAAA;EA4C6B;;;EAxC7B,YAAA;EAeO;;;EAXP,MAAA;EA4BO;;;EAxBP,MAAA;AAAA;AAAA,cAGW,gBAAA;EAqCJ;;;EAjCA,MAAA;;;;EAKA,QAAA,EAAU,iBAAA;;;;EAKV,aAAA,CAAA;;;;EAOA,SAAA,CAAU,QAAA,EAAU,iBAAA;;;;EAQpB,WAAA,CAAY,QAAA,EAAU,iBAAA;;;;EAQtB,QAAA,CAAA,GAAY,eAAA;AAAA"}