@warlock.js/core 4.0.174 → 4.1.2

package/esm/dev-server/dependency-graph.mjs

@@ -0,0 +1,303 @@
+//#region ../../@warlock.js/core/src/dev-server/dependency-graph.ts
+/**
+* Dependency Graph
+* Tracks bidirectional relationships between files:
+* - dependencies: files that this file imports
+* - dependents: files that import this file
+*
+* Each forward edge also carries an `isTypeOnly` flag so cycle detection
+* can distinguish runtime cycles from ones formed purely by `import type`
+* edges — the latter are erased by TypeScript and have no runtime effect.
+*/
+var DependencyGraph = class {
+	constructor() {
+		this.dependencies = /* @__PURE__ */ new Map();
+		this.dependents = /* @__PURE__ */ new Map();
+		this.files = null;
+	}
+	/**
+	* Build dependency graph from FileManager map
+	*/
+	build(files) {
+		this.files = files;
+		this.dependencies.clear();
+		this.dependents.clear();
+		for (const [relativePath, fileManager] of files) {
+			if (!this.dependencies.has(relativePath)) this.dependencies.set(relativePath, /* @__PURE__ */ new Map());
+			if (!this.dependents.has(relativePath)) this.dependents.set(relativePath, /* @__PURE__ */ new Set());
+			for (const dependency of fileManager.dependencies) {
+				const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);
+				this.addDependency(relativePath, dependency, isTypeOnly);
+			}
+		}
+		const cycles = this.detectCircularDependencies();
+		if (cycles.length > 0) this.displayCircularDependencyWarnings(cycles);
+	}
+	/**
+	* Add a dependency relationship.
+	* If the edge already exists, the type-only flag is ANDed: any runtime
+	* statement between the two files makes the edge runtime permanently.
+	*
+	* @param file The file that has the dependency
+	* @param dependency The file being depended upon
+	* @param isTypeOnly Whether every reference from `file` to `dependency` is type-only
+	*/
+	addDependency(file, dependency, isTypeOnly = false) {
+		if (!this.dependencies.has(file)) this.dependencies.set(file, /* @__PURE__ */ new Map());
+		if (!this.dependents.has(dependency)) this.dependents.set(dependency, /* @__PURE__ */ new Set());
+		const edges = this.dependencies.get(file);
+		const existing = edges.get(dependency);
+		if (existing) existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;
+		else edges.set(dependency, { isTypeOnly });
+		this.dependents.get(dependency).add(file);
+	}
+	/**
+	* Remove a dependency relationship
+	* @param file The file that has the dependency
+	* @param dependency The file being depended upon
+	*/
+	removeDependency(file, dependency) {
+		this.dependencies.get(file)?.delete(dependency);
+		this.dependents.get(dependency)?.delete(file);
+	}
+	/**
+	* Remove all relationships for a file
+	* @param file The file to remove
+	*/
+	removeFile(file) {
+		const deps = this.dependencies.get(file);
+		if (deps) for (const dependency of deps.keys()) this.dependents.get(dependency)?.delete(file);
+		const dependents = this.dependents.get(file);
+		if (dependents) for (const dependent of dependents) this.dependencies.get(dependent)?.delete(file);
+		this.dependencies.delete(file);
+		this.dependents.delete(file);
+	}
+	/**
+	* Update dependencies for a file.
+	*
+	* Accepts the updated `Set<string>` of dependency paths; when the caller
+	* has per-edge type-only info, pass `typeOnlyDependencies` so the new
+	* edges get the correct flag. Missing flag defaults to runtime.
+	*
+	* @param file The file to update
+	* @param newDependencies New set of dependency paths
+	* @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only
+	*/
+	updateFile(file, newDependencies, typeOnlyDependencies = /* @__PURE__ */ new Set()) {
+		const oldEdges = this.dependencies.get(file) ?? /* @__PURE__ */ new Map();
+		for (const oldDep of oldEdges.keys()) if (!newDependencies.has(oldDep)) this.removeDependency(file, oldDep);
+		for (const newDep of newDependencies) {
+			const isTypeOnly = typeOnlyDependencies.has(newDep);
+			const existing = oldEdges.get(newDep);
+			if (!existing) {
+				this.addDependency(file, newDep, isTypeOnly);
+				continue;
+			}
+			if (existing.isTypeOnly !== isTypeOnly) existing.isTypeOnly = isTypeOnly;
+		}
+	}
+	/**
+	* Get files that this file depends on (imports)
+	* @param file The file to check
+	* @returns Set of files this file imports
+	*/
+	getDependencies(file) {
+		const edges = this.dependencies.get(file);
+		if (!edges) return /* @__PURE__ */ new Set();
+		return new Set(edges.keys());
+	}
+	/**
+	* Check whether the edge `file → dependency` is type-only.
+	* Returns false if the edge does not exist.
+	*/
+	isEdgeTypeOnly(file, dependency) {
+		return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;
+	}
+	/**
+	* Get files that depend on this file (importers)
+	* @param file The file to check
+	* @returns Set of files that import this file
+	*/
+	getDependents(file) {
+		return this.dependents.get(file) || /* @__PURE__ */ new Set();
+	}
+	/**
+	* Get invalidation chain for a file
+	* Returns all files that need to be reloaded when this file changes
+	* Includes the file itself and all transitive dependents
+	* @param file The file that changed
+	* @returns Array of files to invalidate (in order)
+	*/
+	getInvalidationChain(file) {
+		const chain = [file];
+		const visited = new Set([file]);
+		const traverse = (current) => {
+			const deps = this.getDependents(current);
+			for (const dep of deps) if (!visited.has(dep)) {
+				visited.add(dep);
+				chain.push(dep);
+				traverse(dep);
+			}
+		};
+		traverse(file);
+		return chain;
+	}
+	/**
+	* Detect circular dependencies in the dependency graph.
+	* Uses depth-first search to find cycles.
+	*
+	* Filtering rule (per-edge): a cycle is suppressed when **any** edge in
+	* the chain is type-only. TypeScript erases type-only imports entirely,
+	* so a single type-only edge breaks the cycle at runtime. Only warn when
+	* every edge is a runtime binding — that's the cycle that actually loops
+	* at load time.
+	*
+	* @returns Array of circular dependency chains (each chain is an array of file paths)
+	*/
+	detectCircularDependencies() {
+		const cycles = [];
+		const visited = /* @__PURE__ */ new Set();
+		const recursionStack = /* @__PURE__ */ new Set();
+		const dfs = (file, path) => {
+			visited.add(file);
+			recursionStack.add(file);
+			path.push(file);
+			const edges = this.dependencies.get(file);
+			if (edges) {
+				for (const dep of edges.keys()) if (!visited.has(dep)) dfs(dep, [...path]);
+				else if (recursionStack.has(dep)) {
+					const cycleStart = path.indexOf(dep);
+					const cycle = [...path.slice(cycleStart), dep];
+					cycles.push(cycle);
+				}
+			}
+			recursionStack.delete(file);
+		};
+		for (const file of this.dependencies.keys()) if (!visited.has(file)) dfs(file, []);
+		return cycles.filter((cycle) => this.isRuntimeCycle(cycle));
+	}
+	/**
+	* True iff every edge in the cycle is a runtime binding. The cycle array
+	* ends with a duplicate of its start (`[A, B, C, A]`) so we walk the
+	* consecutive pairs once — any type-only edge means TS erases the loop
+	* and there is no runtime cycle to report.
+	*/
+	isRuntimeCycle(cycle) {
+		for (let index = 0; index < cycle.length - 1; index++) {
+			const from = cycle[index];
+			const to = cycle[index + 1];
+			if (this.isEdgeTypeOnly(from, to)) return false;
+		}
+		return true;
+	}
+	/**
+	* Display circular dependency warnings in a formatted, user-friendly way
+	* Shows each cycle with visual tree structure and helpful recommendations
+	*/
+	displayCircularDependencyWarnings(cycles) {
+		const colors = {
+			yellow: (text) => `\x1b[33m${text}\x1b[0m`,
+			cyan: (text) => `\x1b[36m${text}\x1b[0m`,
+			dim: (text) => `\x1b[2m${text}\x1b[0m`,
+			bold: (text) => `\x1b[1m${text}\x1b[0m`,
+			green: (text) => `\x1b[32m${text}\x1b[0m`
+		};
+		console.log("");
+		console.log(colors.yellow("⚠️  Circular Dependencies Detected"));
+		console.log(colors.dim("━".repeat(60)));
+		console.log("");
+		console.log(colors.dim(`Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? "s" : ""}`));
+		console.log("");
+		cycles.forEach((cycle, index) => {
+			console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));
+			console.log("");
+			cycle.forEach((file, fileIndex) => {
+				const isLast = fileIndex === cycle.length - 1;
+				const arrow = isLast ? colors.dim("   └─→ ") : colors.dim("   ├─→ ");
+				const fileName = file.split("/").pop() || file;
+				const filePath = colors.dim(file.replace(fileName, ""));
+				if (isLast) console.log(arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`));
+				else console.log(arrow + filePath + colors.bold(fileName));
+			});
+			console.log("");
+		});
+		console.log(colors.dim("━".repeat(60)));
+		console.log(colors.yellow("💡 How to Fix:"));
+		console.log("");
+		const exampleCycle = cycles[0];
+		const fileA = exampleCycle[0]?.split("/").pop() || "fileA.ts";
+		const fileB = exampleCycle[1]?.split("/").pop() || "fileB.ts";
+		const stripExt = (file) => file.replace(/\.tsx?$/, "");
+		const kind = classifyCycle(exampleCycle);
+		if (kind === "resource" || kind === "model") {
+			console.log(colors.green(`  ✨ Use lazy() for the back-reference`));
+			console.log(colors.dim(`   ${kind === "resource" ? "Resources" : "Models"} that reference each other should declare`));
+			console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));
+			console.log("");
+			console.log(colors.dim(`     import { lazy } from "@warlock.js/cascade";`));
+			console.log(colors.dim(`     // inside ${fileB}:`));
+			console.log(colors.dim(`     other: lazy(() => ${kind === "resource" ? "OtherResource" : "OtherModel"})`));
+			console.log("");
+		} else {
+			console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));
+			console.log(colors.dim(`   In ${fileB}, change:`));
+			console.log(colors.dim(`     import { SomeClass } from "./${stripExt(fileA)}";`));
+			console.log(colors.dim(`   To:`));
+			console.log(colors.dim(`     const { SomeClass } = await import("./${stripExt(fileA)}");`));
+			console.log("");
+		}
+		console.log(colors.dim("  Other options:"));
+		console.log(colors.dim("    • Extract the shared symbols into a third file both can import."));
+		console.log(colors.dim("    • Pass the dependency as a constructor/function parameter instead."));
+		console.log("");
+		console.log(colors.dim("━".repeat(60)));
+		console.log(colors.dim("   Circular dependencies can cause HMR issues and hard-to-debug"));
+		console.log(colors.dim("   initialization order problems. Consider refactoring."));
+		console.log("");
+	}
+	/**
+	* Get statistics about the dependency graph
+	*/
+	getStats() {
+		let totalDependencies = 0;
+		let maxDependencies = 0;
+		let maxDependents = 0;
+		let mostDependedFile = "";
+		let mostDependingFile = "";
+		for (const [file, deps] of this.dependencies) {
+			totalDependencies += deps.size;
+			if (deps.size > maxDependencies) {
+				maxDependencies = deps.size;
+				mostDependingFile = file;
+			}
+		}
+		for (const [file, deps] of this.dependents) if (deps.size > maxDependents) {
+			maxDependents = deps.size;
+			mostDependedFile = file;
+		}
+		return {
+			totalFiles: this.dependencies.size,
+			totalDependencies,
+			avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,
+			maxDependencies,
+			maxDependents,
+			mostDependingFile,
+			mostDependedFile
+		};
+	}
+};
+/**
+* Pick the most useful "fix-it" hint for a cycle by inspecting the file
+* extensions involved. Cascade resources/models have a first-class fix
+* (`lazy()`); generic cycles just want a dynamic import.
+*/
+function classifyCycle(cycle) {
+	const files = cycle.slice(0, -1);
+	if (files.every((file) => file.endsWith(".resource.ts") || file.endsWith(".resource.tsx"))) return "resource";
+	if (files.every((file) => file.endsWith(".model.ts") || file.endsWith(".model.tsx"))) return "model";
+	return "generic";
+}
+
+//#endregion
+export { DependencyGraph };
+//# sourceMappingURL=dependency-graph.mjs.map

package/esm/dev-server/dependency-graph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/dev-server/dependency-graph.ts"],"sourcesContent":["import type { FileManager } from \"./file-manager\";\r\n\r\n/**\r\n * Dependency Graph\r\n * Tracks bidirectional relationships between files:\r\n * - dependencies: files that this file imports\r\n * - dependents: files that import this file\r\n *\r\n * Each forward edge also carries an `isTypeOnly` flag so cycle detection\r\n * can distinguish runtime cycles from ones formed purely by `import type`\r\n * edges — the latter are erased by TypeScript and have no runtime effect.\r\n */\r\nexport class DependencyGraph {\r\n  /**\r\n   * Map of file -> files it depends on (imports).\r\n   * Key: relative file path.\r\n   * Value: relative dependency path → `{ isTypeOnly }` for that edge.\r\n   */\r\n  private dependencies = new Map<string, Map<string, { isTypeOnly: boolean }>>();\r\n\r\n  /**\r\n   * Map of file -> files that depend on it (importers)\r\n   * Key: relative file path\r\n   * Value: Set of relative file paths that import this file\r\n   */\r\n  private dependents = new Map<string, Set<string>>();\r\n\r\n  /**\r\n   * Reference to the files map for accessing FileManager instances\r\n   * Used to read per-file typeOnlyDependencies during graph build.\r\n   */\r\n  private files: Map<string, FileManager> | null = null;\r\n\r\n  /**\r\n   * Build dependency graph from FileManager map\r\n   */\r\n  public build(files: Map<string, FileManager>) {\r\n    this.files = files;\r\n\r\n    this.dependencies.clear();\r\n    this.dependents.clear();\r\n\r\n    for (const [relativePath, fileManager] of files) {\r\n      if (!this.dependencies.has(relativePath)) {\r\n        this.dependencies.set(relativePath, new Map());\r\n      }\r\n\r\n      if (!this.dependents.has(relativePath)) {\r\n        this.dependents.set(relativePath, new Set());\r\n      }\r\n\r\n      for (const dependency of fileManager.dependencies) {\r\n        const isTypeOnly = fileManager.typeOnlyDependencies.has(dependency);\r\n\r\n        this.addDependency(relativePath, dependency, isTypeOnly);\r\n      }\r\n    }\r\n\r\n    const cycles = this.detectCircularDependencies();\r\n\r\n    if (cycles.length > 0) {\r\n      this.displayCircularDependencyWarnings(cycles);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Add a dependency relationship.\r\n   * If the edge already exists, the type-only flag is ANDed: any runtime\r\n   * statement between the two files makes the edge runtime permanently.\r\n   *\r\n   * @param file The file that has the dependency\r\n   * @param dependency The file being depended upon\r\n   * @param isTypeOnly Whether every reference from `file` to `dependency` is type-only\r\n   */\r\n  public addDependency(file: string, dependency: string, isTypeOnly: boolean = false) {\r\n    if (!this.dependencies.has(file)) {\r\n      this.dependencies.set(file, new Map());\r\n    }\r\n\r\n    if (!this.dependents.has(dependency)) {\r\n      this.dependents.set(dependency, new Set());\r\n    }\r\n\r\n    const edges = this.dependencies.get(file)!;\r\n    const existing = edges.get(dependency);\r\n\r\n    if (existing) {\r\n      existing.isTypeOnly = existing.isTypeOnly && isTypeOnly;\r\n    } else {\r\n      edges.set(dependency, { isTypeOnly });\r\n    }\r\n\r\n    this.dependents.get(dependency)!.add(file);\r\n  }\r\n\r\n  /**\r\n   * Remove a dependency relationship\r\n   * @param file The file that has the dependency\r\n   * @param dependency The file being depended upon\r\n   */\r\n  public removeDependency(file: string, dependency: string) {\r\n    this.dependencies.get(file)?.delete(dependency);\r\n    this.dependents.get(dependency)?.delete(file);\r\n  }\r\n\r\n  /**\r\n   * Remove all relationships for a file\r\n   * @param file The file to remove\r\n   */\r\n  public removeFile(file: string) {\r\n    const deps = this.dependencies.get(file);\r\n\r\n    if (deps) {\r\n      for (const dependency of deps.keys()) {\r\n        this.dependents.get(dependency)?.delete(file);\r\n      }\r\n    }\r\n\r\n    const dependents = this.dependents.get(file);\r\n\r\n    if (dependents) {\r\n      for (const dependent of dependents) {\r\n        this.dependencies.get(dependent)?.delete(file);\r\n      }\r\n    }\r\n\r\n    this.dependencies.delete(file);\r\n    this.dependents.delete(file);\r\n  }\r\n\r\n  /**\r\n   * Update dependencies for a file.\r\n   *\r\n   * Accepts the updated `Set<string>` of dependency paths; when the caller\r\n   * has per-edge type-only info, pass `typeOnlyDependencies` so the new\r\n   * edges get the correct flag. Missing flag defaults to runtime.\r\n   *\r\n   * @param file The file to update\r\n   * @param newDependencies New set of dependency paths\r\n   * @param typeOnlyDependencies Subset of `newDependencies` whose edges are type-only\r\n   */\r\n  public updateFile(\r\n    file: string,\r\n    newDependencies: Set<string>,\r\n    typeOnlyDependencies: Set<string> = new Set(),\r\n  ) {\r\n    const oldEdges = this.dependencies.get(file) ?? new Map<string, { isTypeOnly: boolean }>();\r\n\r\n    for (const oldDep of oldEdges.keys()) {\r\n      if (!newDependencies.has(oldDep)) {\r\n        this.removeDependency(file, oldDep);\r\n      }\r\n    }\r\n\r\n    for (const newDep of newDependencies) {\r\n      const isTypeOnly = typeOnlyDependencies.has(newDep);\r\n      const existing = oldEdges.get(newDep);\r\n\r\n      if (!existing) {\r\n        this.addDependency(file, newDep, isTypeOnly);\r\n\r\n        continue;\r\n      }\r\n\r\n      if (existing.isTypeOnly !== isTypeOnly) {\r\n        existing.isTypeOnly = isTypeOnly;\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get files that this file depends on (imports)\r\n   * @param file The file to check\r\n   * @returns Set of files this file imports\r\n   */\r\n  public getDependencies(file: string): Set<string> {\r\n    const edges = this.dependencies.get(file);\r\n\r\n    if (!edges) {\r\n      return new Set();\r\n    }\r\n\r\n    return new Set(edges.keys());\r\n  }\r\n\r\n  /**\r\n   * Check whether the edge `file → dependency` is type-only.\r\n   * Returns false if the edge does not exist.\r\n   */\r\n  public isEdgeTypeOnly(file: string, dependency: string): boolean {\r\n    return this.dependencies.get(file)?.get(dependency)?.isTypeOnly === true;\r\n  }\r\n\r\n  /**\r\n   * Get files that depend on this file (importers)\r\n   * @param file The file to check\r\n   * @returns Set of files that import this file\r\n   */\r\n  public getDependents(file: string): Set<string> {\r\n    return this.dependents.get(file) || new Set();\r\n  }\r\n\r\n  /**\r\n   * Get invalidation chain for a file\r\n   * Returns all files that need to be reloaded when this file changes\r\n   * Includes the file itself and all transitive dependents\r\n   * @param file The file that changed\r\n   * @returns Array of files to invalidate (in order)\r\n   */\r\n  public getInvalidationChain(file: string): string[] {\r\n    const chain: string[] = [file];\r\n    const visited = new Set([file]);\r\n\r\n    const traverse = (current: string) => {\r\n      const deps = this.getDependents(current);\r\n      for (const dep of deps) {\r\n        if (!visited.has(dep)) {\r\n          visited.add(dep);\r\n          chain.push(dep);\r\n          traverse(dep); // Recursive traversal\r\n        }\r\n      }\r\n    };\r\n\r\n    traverse(file);\r\n    return chain;\r\n  }\r\n\r\n  /**\r\n   * Detect circular dependencies in the dependency graph.\r\n   * Uses depth-first search to find cycles.\r\n   *\r\n   * Filtering rule (per-edge): a cycle is suppressed when **any** edge in\r\n   * the chain is type-only. TypeScript erases type-only imports entirely,\r\n   * so a single type-only edge breaks the cycle at runtime. Only warn when\r\n   * every edge is a runtime binding — that's the cycle that actually loops\r\n   * at load time.\r\n   *\r\n   * @returns Array of circular dependency chains (each chain is an array of file paths)\r\n   */\r\n  public detectCircularDependencies(): string[][] {\r\n    const cycles: string[][] = [];\r\n    const visited = new Set<string>();\r\n    const recursionStack = new Set<string>();\r\n\r\n    const dfs = (file: string, path: string[]): void => {\r\n      visited.add(file);\r\n      recursionStack.add(file);\r\n      path.push(file);\r\n\r\n      const edges = this.dependencies.get(file);\r\n\r\n      if (edges) {\r\n        for (const dep of edges.keys()) {\r\n          if (!visited.has(dep)) {\r\n            dfs(dep, [...path]);\r\n          } else if (recursionStack.has(dep)) {\r\n            const cycleStart = path.indexOf(dep);\r\n            const cycle = [...path.slice(cycleStart), dep];\r\n\r\n            cycles.push(cycle);\r\n          }\r\n        }\r\n      }\r\n\r\n      recursionStack.delete(file);\r\n    };\r\n\r\n    for (const file of this.dependencies.keys()) {\r\n      if (!visited.has(file)) {\r\n        dfs(file, []);\r\n      }\r\n    }\r\n\r\n    return cycles.filter((cycle) => this.isRuntimeCycle(cycle));\r\n  }\r\n\r\n  /**\r\n   * True iff every edge in the cycle is a runtime binding. The cycle array\r\n   * ends with a duplicate of its start (`[A, B, C, A]`) so we walk the\r\n   * consecutive pairs once — any type-only edge means TS erases the loop\r\n   * and there is no runtime cycle to report.\r\n   */\r\n  private isRuntimeCycle(cycle: string[]): boolean {\r\n    for (let index = 0; index < cycle.length - 1; index++) {\r\n      const from = cycle[index];\r\n      const to = cycle[index + 1];\r\n\r\n      if (this.isEdgeTypeOnly(from, to)) {\r\n        return false;\r\n      }\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Display circular dependency warnings in a formatted, user-friendly way\r\n   * Shows each cycle with visual tree structure and helpful recommendations\r\n   */\r\n  private displayCircularDependencyWarnings(cycles: string[][]): void {\r\n    const colors = {\r\n      yellow: (text: string) => `\\x1b[33m${text}\\x1b[0m`,\r\n      cyan: (text: string) => `\\x1b[36m${text}\\x1b[0m`,\r\n      dim: (text: string) => `\\x1b[2m${text}\\x1b[0m`,\r\n      bold: (text: string) => `\\x1b[1m${text}\\x1b[0m`,\r\n      green: (text: string) => `\\x1b[32m${text}\\x1b[0m`,\r\n    };\r\n\r\n    console.log(\"\");\r\n    console.log(colors.yellow(\"⚠️  Circular Dependencies Detected\"));\r\n    console.log(colors.dim(\"━\".repeat(60)));\r\n    console.log(\"\");\r\n    console.log(\r\n      colors.dim(\r\n        `Found ${colors.bold(cycles.length.toString())} circular dependency chain${cycles.length > 1 ? \"s\" : \"\"}`,\r\n      ),\r\n    );\r\n    console.log(\"\");\r\n\r\n    cycles.forEach((cycle, index) => {\r\n      console.log(colors.cyan(`  ${index + 1}. Cycle with ${cycle.length - 1} files:`));\r\n      console.log(\"\");\r\n\r\n      // Display the cycle chain\r\n      cycle.forEach((file, fileIndex) => {\r\n        const isLast = fileIndex === cycle.length - 1;\r\n        const arrow = isLast ? colors.dim(\"   └─→ \") : colors.dim(\"   ├─→ \");\r\n        const fileName = file.split(\"/\").pop() || file;\r\n        const filePath = colors.dim(file.replace(fileName, \"\"));\r\n\r\n        if (isLast) {\r\n          // Last item is the same as first (completes the cycle)\r\n          console.log(\r\n            arrow + colors.yellow(`${filePath}${colors.bold(fileName)} (cycle completes)`),\r\n          );\r\n        } else {\r\n          console.log(arrow + filePath + colors.bold(fileName));\r\n        }\r\n      });\r\n\r\n      console.log(\"\");\r\n    });\r\n\r\n    console.log(colors.dim(\"━\".repeat(60)));\r\n    console.log(colors.yellow(\"💡 How to Fix:\"));\r\n    console.log(\"\");\r\n\r\n    const exampleCycle = cycles[0];\r\n    const fileA = exampleCycle[0]?.split(\"/\").pop() || \"fileA.ts\";\r\n    const fileB = exampleCycle[1]?.split(\"/\").pop() || \"fileB.ts\";\r\n    const stripExt = (file: string) => file.replace(/\\.tsx?$/, \"\");\r\n\r\n    const kind = classifyCycle(exampleCycle);\r\n\r\n    if (kind === \"resource\" || kind === \"model\") {\r\n      // Cascade's `lazy()` is purpose-built for circular relations between\r\n      // resources and models — recommend it first, not as a footnote.\r\n      console.log(colors.green(`  ✨ Use lazy() for the back-reference`));\r\n      console.log(\r\n        colors.dim(\r\n          `   ${kind === \"resource\" ? \"Resources\" : \"Models\"} that reference each other should declare`,\r\n        ),\r\n      );\r\n      console.log(colors.dim(`   one side with lazy() so the import resolves at access time:`));\r\n      console.log(\"\");\r\n      console.log(colors.dim(`     import { lazy } from \"@warlock.js/cascade\";`));\r\n      console.log(colors.dim(`     // inside ${fileB}:`));\r\n      console.log(colors.dim(`     other: lazy(() => ${kind === \"resource\" ? \"OtherResource\" : \"OtherModel\"})`));\r\n      console.log(\"\");\r\n    } else {\r\n      // Generic cycle — dynamic import is the most common reliable fix.\r\n      console.log(colors.green(`  ✨ Convert one edge to a dynamic import`));\r\n      console.log(colors.dim(`   In ${fileB}, change:`));\r\n      console.log(colors.dim(`     import { SomeClass } from \"./${stripExt(fileA)}\";`));\r\n      console.log(colors.dim(`   To:`));\r\n      console.log(\r\n        colors.dim(`     const { SomeClass } = await import(\"./${stripExt(fileA)}\");`),\r\n      );\r\n      console.log(\"\");\r\n    }\r\n\r\n    console.log(colors.dim(\"  Other options:\"));\r\n    console.log(colors.dim(\"    • Extract the shared symbols into a third file both can import.\"));\r\n    console.log(colors.dim(\"    • Pass the dependency as a constructor/function parameter instead.\"));\r\n    console.log(\"\");\r\n\r\n    console.log(colors.dim(\"━\".repeat(60)));\r\n    console.log(colors.dim(\"   Circular dependencies can cause HMR issues and hard-to-debug\"));\r\n    console.log(colors.dim(\"   initialization order problems. Consider refactoring.\"));\r\n    console.log(\"\");\r\n  }\r\n\r\n  /**\r\n   * Get statistics about the dependency graph\r\n   */\r\n  public getStats() {\r\n    let totalDependencies = 0;\r\n    let maxDependencies = 0;\r\n    let maxDependents = 0;\r\n    let mostDependedFile = \"\";\r\n    let mostDependingFile = \"\";\r\n\r\n    for (const [file, deps] of this.dependencies) {\r\n      totalDependencies += deps.size;\r\n      if (deps.size > maxDependencies) {\r\n        maxDependencies = deps.size;\r\n        mostDependingFile = file;\r\n      }\r\n    }\r\n\r\n    for (const [file, deps] of this.dependents) {\r\n      if (deps.size > maxDependents) {\r\n        maxDependents = deps.size;\r\n        mostDependedFile = file;\r\n      }\r\n    }\r\n\r\n    return {\r\n      totalFiles: this.dependencies.size,\r\n      totalDependencies,\r\n      avgDependenciesPerFile: totalDependencies / this.dependencies.size || 0,\r\n      maxDependencies,\r\n      maxDependents,\r\n      mostDependingFile,\r\n      mostDependedFile,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Pick the most useful \"fix-it\" hint for a cycle by inspecting the file\r\n * extensions involved. Cascade resources/models have a first-class fix\r\n * (`lazy()`); generic cycles just want a dynamic import.\r\n */\r\nfunction classifyCycle(cycle: string[]): \"resource\" | \"model\" | \"generic\" {\r\n  const files = cycle.slice(0, -1); // last entry repeats the first\r\n  if (files.every(file => file.endsWith(\".resource.ts\") || file.endsWith(\".resource.tsx\"))) {\r\n    return \"resource\";\r\n  }\r\n  if (files.every(file => file.endsWith(\".model.ts\") || file.endsWith(\".model.tsx\"))) {\r\n    return \"model\";\r\n  }\r\n  return \"generic\";\r\n}\r\n"],"mappings":"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"}

package/esm/dev-server/dev-logger.mjs

@@ -0,0 +1,110 @@
+import { Path } from "./path.mjs";
+import { colors } from "@mongez/copper";
+import dayjs from "dayjs";
+
+//#region ../../@warlock.js/core/src/dev-server/dev-logger.ts
+/**
+* Dev server logger — Vite-style formatting helpers.
+*/
+function timestamp() {
+	return colors.dim(`${dayjs().format("HH:mm:ss A")}`);
+}
+function devLog(message) {
+	console.log(`${timestamp()} ${message}`);
+}
+function devLogSuccess(message) {
+	console.log(`${timestamp()} ${colors.green("✓")} ${colors.green(message)}`);
+}
+/**
+* Colourise a stack trace so the eye lands on *your* code.
+*
+* - Error header (`ReferenceError: x is not defined`) → bold red.
+* - Frames in project `src/` → highlighted: a green `›` pointer, yellow
+*   function name, cyan relative path, dim `:line:col`. These are almost
+*   always where the bug is.
+* - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames
+*   → dimmed and relativised. Still there for context, just out of the way.
+*
+* Source maps are enabled in dev, so the paths/lines here are already the
+* original `.ts` locations — this only changes how they're painted.
+*/
+function formatErrorStack(stack) {
+	const frame = /^(\s*)at (.+?) \((.+):(\d+):(\d+)\)$/;
+	const bareFrame = /^(\s*)at (.+):(\d+):(\d+)$/;
+	let headerDone = false;
+	return stack.split("\n").map((line) => {
+		const withFn = line.match(frame);
+		const bare = line.match(bareFrame);
+		if (!withFn && !bare) return headerDone ? colors.dim(line) : colors.bold(colors.red(line));
+		headerDone = true;
+		const fn = withFn ? withFn[2] : "";
+		const file = withFn ? withFn[3] : bare[2];
+		const lineNo = withFn ? withFn[4] : bare[3];
+		const col = withFn ? withFn[5] : bare[4];
+		const isNodeInternal = file.startsWith("node:");
+		const isDep = file.includes("node_modules");
+		const isFramework = /[\\/]@warlock\.js[\\/]/.test(file);
+		const isUserCode = !isNodeInternal && !isDep && !isFramework;
+		const rel = isNodeInternal ? file : Path.toRelative(file);
+		const loc = `:${lineNo}:${col}`;
+		if (isUserCode) return `  ${colors.green("›")} ${colors.dim("at")} ${colors.yellow(fn || "<anonymous>")} ${colors.cyan(rel)}${colors.dim(loc)}`;
+		const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;
+		return `    ${colors.dim(label)}`;
+	}).join("\n");
+}
+function devLogError(message, error) {
+	console.log(`${timestamp()} ${colors.red("✗")} ${colors.red(message)}`);
+	if (error?.stack) console.log(formatErrorStack(error.stack));
+}
+function devLogWarn(message) {
+	console.log(`${timestamp()} ${colors.yellow("⚠")} ${colors.yellow(message)}`);
+}
+function devLogInfo(message) {
+	console.log(`${timestamp()} ${colors.cyan(message)}`);
+}
+function devLogDim(message) {
+	console.log(`${timestamp()} ${colors.dim(message)}`);
+}
+function devLogHMR(file, dependents) {
+	const relativePath = Path.toRelative(file);
+	const depInfo = dependents ? colors.dim(` +${dependents} module${dependents > 1 ? "s" : ""}`) : "";
+	console.log(`${timestamp()} 🔥 ${colors.green("hmr update")} ${colors.dim(relativePath)}${depInfo}`);
+}
+function devLogReady(message) {
+	console.log(`\n${timestamp()}  ${colors.green("➜")}  ${colors.bold(message)}`);
+}
+function devLogSection(title) {
+	console.log(`\n${timestamp()} ${colors.bold(colors.cyan(title))}`);
+}
+/**
+* Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the
+* project root. The loader hook keeps source paths in the URL so we only
+* need to strip the absolute prefix — no cache-path translation any more.
+*/
+function formatModuleNotFoundError(error, suggestions) {
+	const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);
+	if (!match) return error.message;
+	const [, modulePath, importerPath] = match;
+	const lines = [
+		"",
+		`${colors.red("❌ MODULE NOT FOUND")}`,
+		"",
+		`${colors.dim("Cannot find:")} ${colors.cyan(Path.toRelative(modulePath))}`,
+		"",
+		`${colors.dim("Imported by:")}`,
+		`  ${colors.yellow("→")} ${colors.white(Path.toRelative(importerPath))}`
+	];
+	if (suggestions && suggestions.length > 0) {
+		lines.push("");
+		lines.push(`${colors.dim("Did you mean?")}`);
+		suggestions.forEach((s) => lines.push(`  ${colors.cyan("→")} ${colors.green(s)}`));
+	}
+	lines.push("");
+	return lines.join("\n");
+}
+/** @deprecated alias retained for older callers. Use `devLog` directly. */
+const devServeLog = devLog;
+
+//#endregion
+export { devLogDim, devLogError, devLogHMR, devLogInfo, devLogReady, devLogSection, devLogSuccess, devLogWarn, devServeLog, formatModuleNotFoundError };
+//# sourceMappingURL=dev-logger.mjs.map

package/esm/dev-server/dev-logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-logger.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/dev-server/dev-logger.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport dayjs from \"dayjs\";\r\nimport { Path } from \"./path\";\r\n\r\n/**\r\n * Dev server logger — Vite-style formatting helpers.\r\n */\r\n\r\nfunction timestamp(): string {\r\n  return colors.dim(`${dayjs().format(\"HH:mm:ss A\")}`);\r\n}\r\n\r\nexport function devLog(message: string) {\r\n  console.log(`${timestamp()} ${message}`);\r\n}\r\n\r\nexport function devLogSuccess(message: string) {\r\n  console.log(`${timestamp()} ${colors.green(\"✓\")} ${colors.green(message)}`);\r\n}\r\n\r\n/**\r\n * Colourise a stack trace so the eye lands on *your* code.\r\n *\r\n * - Error header (`ReferenceError: x is not defined`) → bold red.\r\n * - Frames in project `src/` → highlighted: a green `›` pointer, yellow\r\n *   function name, cyan relative path, dim `:line:col`. These are almost\r\n *   always where the bug is.\r\n * - Framework (`@warlock.js`), `node_modules`, and `node:` internal frames\r\n *   → dimmed and relativised. Still there for context, just out of the way.\r\n *\r\n * Source maps are enabled in dev, so the paths/lines here are already the\r\n * original `.ts` locations — this only changes how they're painted.\r\n */\r\nexport function formatErrorStack(stack: string): string {\r\n  const frame = /^(\\s*)at (.+?) \\((.+):(\\d+):(\\d+)\\)$/;\r\n  const bareFrame = /^(\\s*)at (.+):(\\d+):(\\d+)$/;\r\n  let headerDone = false;\r\n\r\n  return stack\r\n    .split(\"\\n\")\r\n    .map(line => {\r\n      const withFn = line.match(frame);\r\n      const bare = line.match(bareFrame);\r\n\r\n      if (!withFn && !bare) {\r\n        // Header line(s) before the first frame.\r\n        const painted = headerDone ? colors.dim(line) : colors.bold(colors.red(line));\r\n        return painted;\r\n      }\r\n\r\n      headerDone = true;\r\n\r\n      const fn = withFn ? withFn[2] : \"\";\r\n      const file = withFn ? withFn[3] : bare![2];\r\n      const lineNo = withFn ? withFn[4] : bare![3];\r\n      const col = withFn ? withFn[5] : bare![4];\r\n\r\n      const isNodeInternal = file.startsWith(\"node:\");\r\n      const isDep = file.includes(\"node_modules\");\r\n      const isFramework = /[\\\\/]@warlock\\.js[\\\\/]/.test(file);\r\n      const isUserCode = !isNodeInternal && !isDep && !isFramework;\r\n\r\n      const rel = isNodeInternal ? file : Path.toRelative(file);\r\n      const loc = `:${lineNo}:${col}`;\r\n\r\n      if (isUserCode) {\r\n        return (\r\n          `  ${colors.green(\"›\")} ${colors.dim(\"at\")} ` +\r\n          `${colors.yellow(fn || \"<anonymous>\")} ` +\r\n          `${colors.cyan(rel)}${colors.dim(loc)}`\r\n        );\r\n      }\r\n\r\n      const label = fn ? `at ${fn} ${rel}${loc}` : `at ${rel}${loc}`;\r\n      return `    ${colors.dim(label)}`;\r\n    })\r\n    .join(\"\\n\");\r\n}\r\n\r\nexport function devLogError(message: string, error?: any) {\r\n  console.log(`${timestamp()} ${colors.red(\"✗\")} ${colors.red(message)}`);\r\n  if (error?.stack) console.log(formatErrorStack(error.stack));\r\n}\r\n\r\nexport function devLogWarn(message: string) {\r\n  console.log(`${timestamp()} ${colors.yellow(\"⚠\")} ${colors.yellow(message)}`);\r\n}\r\n\r\nexport function devLogInfo(message: string) {\r\n  console.log(`${timestamp()} ${colors.cyan(message)}`);\r\n}\r\n\r\nexport function devLogDim(message: string) {\r\n  console.log(`${timestamp()} ${colors.dim(message)}`);\r\n}\r\n\r\nexport function devLogHMR(file: string, dependents?: number) {\r\n  const relativePath = Path.toRelative(file);\r\n  const depInfo = dependents\r\n    ? colors.dim(` +${dependents} module${dependents > 1 ? \"s\" : \"\"}`)\r\n    : \"\";\r\n  console.log(\r\n    `${timestamp()} 🔥 ${colors.green(\"hmr update\")} ${colors.dim(relativePath)}${depInfo}`,\r\n  );\r\n}\r\n\r\nexport function devLogConfig(file: string, connectors?: string[]) {\r\n  const relativePath = Path.toRelative(file);\r\n  const connectorInfo =\r\n    connectors && connectors.length > 0 ? colors.dim(` → restarting ${connectors.join(\", \")}`) : \"\";\r\n  console.log(\r\n    `${timestamp()} ${colors.cyan(\"config reload\")} ${colors.dim(relativePath)}${connectorInfo}`,\r\n  );\r\n}\r\n\r\nexport function devLogReady(message: string) {\r\n  console.log(`\\n${timestamp()}  ${colors.green(\"➜\")}  ${colors.bold(message)}`);\r\n}\r\n\r\nexport function devLogSection(title: string) {\r\n  console.log(`\\n${timestamp()} ${colors.bold(colors.cyan(title))}`);\r\n}\r\n\r\n/**\r\n * Format ERR_MODULE_NOT_FOUND so the displayed paths are relative to the\r\n * project root. The loader hook keeps source paths in the URL so we only\r\n * need to strip the absolute prefix — no cache-path translation any more.\r\n */\r\nexport function formatModuleNotFoundError(error: Error, suggestions?: string[]): string {\r\n  const match = error.message.match(/Cannot find module '([^']+)' imported from '([^']+)'/);\r\n  if (!match) return error.message;\r\n\r\n  const [, modulePath, importerPath] = match;\r\n  const lines: string[] = [\r\n    \"\",\r\n    `${colors.red(\"❌ MODULE NOT FOUND\")}`,\r\n    \"\",\r\n    `${colors.dim(\"Cannot find:\")} ${colors.cyan(Path.toRelative(modulePath))}`,\r\n    \"\",\r\n    `${colors.dim(\"Imported by:\")}`,\r\n    `  ${colors.yellow(\"→\")} ${colors.white(Path.toRelative(importerPath))}`,\r\n  ];\r\n\r\n  if (suggestions && suggestions.length > 0) {\r\n    lines.push(\"\");\r\n    lines.push(`${colors.dim(\"Did you mean?\")}`);\r\n    suggestions.forEach(s => lines.push(`  ${colors.cyan(\"→\")} ${colors.green(s)}`));\r\n  }\r\n\r\n  lines.push(\"\");\r\n  return lines.join(\"\\n\");\r\n}\r\n\r\n/** @deprecated alias retained for older callers. Use `devLog` directly. */\r\nexport const devServeLog = devLog;\r\n"],"mappings":";;;;;;;;AAQA,SAAS,YAAoB;CAC3B,OAAO,OAAO,IAAI,GAAG,MAAM,EAAE,OAAO,YAAY,GAAG;AACrD;AAEA,SAAgB,OAAO,SAAiB;CACtC,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,SAAS;AACzC;AAEA,SAAgB,cAAc,SAAiB;CAC7C,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,MAAM,GAAG,EAAE,GAAG,OAAO,MAAM,OAAO,GAAG;AAC5E;;;;;;;;;;;;;;AAeA,SAAgB,iBAAiB,OAAuB;CACtD,MAAM,QAAQ;CACd,MAAM,YAAY;CAClB,IAAI,aAAa;CAEjB,OAAO,MACJ,MAAM,IAAI,EACV,KAAI,SAAQ;EACX,MAAM,SAAS,KAAK,MAAM,KAAK;EAC/B,MAAM,OAAO,KAAK,MAAM,SAAS;EAEjC,IAAI,CAAC,UAAU,CAAC,MAGd,OADgB,aAAa,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,OAAO,IAAI,IAAI,CAAC;EAI9E,aAAa;EAEb,MAAM,KAAK,SAAS,OAAO,KAAK;EAChC,MAAM,OAAO,SAAS,OAAO,KAAK,KAAM;EACxC,MAAM,SAAS,SAAS,OAAO,KAAK,KAAM;EAC1C,MAAM,MAAM,SAAS,OAAO,KAAK,KAAM;EAEvC,MAAM,iBAAiB,KAAK,WAAW,OAAO;EAC9C,MAAM,QAAQ,KAAK,SAAS,cAAc;EAC1C,MAAM,cAAc,yBAAyB,KAAK,IAAI;EACtD,MAAM,aAAa,CAAC,kBAAkB,CAAC,SAAS,CAAC;EAEjD,MAAM,MAAM,iBAAiB,OAAO,KAAK,WAAW,IAAI;EACxD,MAAM,MAAM,IAAI,OAAO,GAAG;EAE1B,IAAI,YACF,OACE,KAAK,OAAO,MAAM,GAAG,EAAE,GAAG,OAAO,IAAI,IAAI,EAAE,GACxC,OAAO,OAAO,MAAM,aAAa,EAAE,GACnC,OAAO,KAAK,GAAG,IAAI,OAAO,IAAI,GAAG;EAIxC,MAAM,QAAQ,KAAK,MAAM,GAAG,GAAG,MAAM,QAAQ,MAAM,MAAM;EACzD,OAAO,OAAO,OAAO,IAAI,KAAK;CAChC,CAAC,EACA,KAAK,IAAI;AACd;AAEA,SAAgB,YAAY,SAAiB,OAAa;CACxD,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,IAAI,GAAG,EAAE,GAAG,OAAO,IAAI,OAAO,GAAG;CACtE,IAAI,OAAO,OAAO,QAAQ,IAAI,iBAAiB,MAAM,KAAK,CAAC;AAC7D;AAEA,SAAgB,WAAW,SAAiB;CAC1C,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,OAAO,GAAG,EAAE,GAAG,OAAO,OAAO,OAAO,GAAG;AAC9E;AAEA,SAAgB,WAAW,SAAiB;CAC1C,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,KAAK,OAAO,GAAG;AACtD;AAEA,SAAgB,UAAU,SAAiB;CACzC,QAAQ,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,IAAI,OAAO,GAAG;AACrD;AAEA,SAAgB,UAAU,MAAc,YAAqB;CAC3D,MAAM,eAAe,KAAK,WAAW,IAAI;CACzC,MAAM,UAAU,aACZ,OAAO,IAAI,KAAK,WAAW,SAAS,aAAa,IAAI,MAAM,IAAI,IAC/D;CACJ,QAAQ,IACN,GAAG,UAAU,EAAE,MAAM,OAAO,MAAM,YAAY,EAAE,GAAG,OAAO,IAAI,YAAY,IAAI,SAChF;AACF;AAWA,SAAgB,YAAY,SAAiB;CAC3C,QAAQ,IAAI,KAAK,UAAU,EAAE,IAAI,OAAO,MAAM,GAAG,EAAE,IAAI,OAAO,KAAK,OAAO,GAAG;AAC/E;AAEA,SAAgB,cAAc,OAAe;CAC3C,QAAQ,IAAI,KAAK,UAAU,EAAE,GAAG,OAAO,KAAK,OAAO,KAAK,KAAK,CAAC,GAAG;AACnE;;;;;;AAOA,SAAgB,0BAA0B,OAAc,aAAgC;CACtF,MAAM,QAAQ,MAAM,QAAQ,MAAM,sDAAsD;CACxF,IAAI,CAAC,OAAO,OAAO,MAAM;CAEzB,MAAM,GAAG,YAAY,gBAAgB;CACrC,MAAM,QAAkB;EACtB;EACA,GAAG,OAAO,IAAI,oBAAoB;EAClC;EACA,GAAG,OAAO,IAAI,cAAc,EAAE,GAAG,OAAO,KAAK,KAAK,WAAW,UAAU,CAAC;EACxE;EACA,GAAG,OAAO,IAAI,cAAc;EAC5B,KAAK,OAAO,OAAO,GAAG,EAAE,GAAG,OAAO,MAAM,KAAK,WAAW,YAAY,CAAC;CACvE;CAEA,IAAI,eAAe,YAAY,SAAS,GAAG;EACzC,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,GAAG,OAAO,IAAI,eAAe,GAAG;EAC3C,YAAY,SAAQ,MAAK,MAAM,KAAK,KAAK,OAAO,KAAK,GAAG,EAAE,GAAG,OAAO,MAAM,CAAC,GAAG,CAAC;CACjF;CAEA,MAAM,KAAK,EAAE;CACb,OAAO,MAAM,KAAK,IAAI;AACxB;;AAGA,MAAa,cAAc"}

package/esm/dev-server/development-server.mjs

@@ -0,0 +1,115 @@
+import { ConnectorLifecyclePhase } from "../connectors/types.mjs";
+import { devLogReady, devLogSection, devLogWarn, devServeLog } from "./dev-logger.mjs";
+import { connectorsManager } from "../connectors/connectors-manager.mjs";
+import { warlockConfigManager } from "../warlock-config/warlock-config.manager.mjs";
+import { MANIFEST_PATH } from "./flags.mjs";
+import { filesOrchestrator } from "./files-orchestrator.mjs";
+import "../warlock-config/index.mjs";
+import { LayerExecutor } from "./layer-executor.mjs";
+import { typeGenerator } from "./type-generator.mjs";
+import { colors } from "@mongez/copper";
+import events from "@mongez/events";
+import { fileExistsAsync, getFileAsync, unlinkAsync } from "@warlock.js/fs";
+
+//#region ../../@warlock.js/core/src/dev-server/development-server.ts
+/**
+* Top-level coordinator for `warlock dev`. Wires the file orchestrator, the
+* connectors, and the layer executor together, and listens for the watcher's
+* batched events to drive HMR.
+*/
+var DevelopmentServer = class {
+	constructor(options = {}) {
+		this.running = false;
+		this.options = options;
+		devLogSection("Starting Development Server...");
+	}
+	async start() {
+		try {
+			const startedAt = performance.now();
+			if (this.options.fresh && await fileExistsAsync(MANIFEST_PATH)) {
+				await unlinkAsync(MANIFEST_PATH);
+				devServeLog(colors.cyanBright("Cleared manifest (--fresh)"));
+			}
+			await filesOrchestrator.init();
+			await filesOrchestrator.initializeAll();
+			await filesOrchestrator.watchFiles();
+			filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());
+			this.setupEventListeners();
+			await this.autoDiscoverFiles();
+			await filesOrchestrator.moduleLoader.loadAll();
+			await connectorsManager.startPhase("late");
+			this.layerExecutor = new LayerExecutor(filesOrchestrator.getDependencyGraph(), filesOrchestrator.specialFilesCollector, filesOrchestrator.moduleLoader, (absolutePath) => filesOrchestrator.bumpVersion(absolutePath), () => filesOrchestrator.flushVersionBumps());
+			this.running = true;
+			const duration = performance.now() - startedAt;
+			devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);
+			const devServerConfig = await warlockConfigManager.get("devServer");
+			const generateTypings = this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;
+			const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;
+			if (generateTypings) typeGenerator.executeGenerateAllCommand();
+			if (healthCheckers) filesOrchestrator.startCheckingHealth(healthCheckers === true ? void 0 : healthCheckers);
+		} catch (error) {
+			devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));
+			await this.shutdown();
+			throw error;
+		}
+	}
+	/**
+	* Eagerly import files whose decorators populate global registries so any
+	* symbol-by-name resolution later in boot finds them.
+	*/
+	async autoDiscoverFiles() {
+		const discoveryTypes = ["model"];
+		for (const file of filesOrchestrator.files.values()) if (file.type && discoveryTypes.includes(file.type)) await filesOrchestrator.moduleLoader.loadModule(file, file.type);
+	}
+	setupEventListeners() {
+		events.on("dev-server:batch-complete", (batch) => this.handleBatchComplete(batch));
+	}
+	async handleBatchComplete(batch) {
+		if (!this.running || !this.layerExecutor) return;
+		if (batch.changed.includes("warlock.config.ts")) devLogWarn("warlock.config.ts changed — restart the dev server to apply.");
+		if (batch.changed.length > 0) batch.changed = await dropNoOpChanges(batch.changed);
+		if (batch.added.length + batch.changed.length + batch.deleted.length === 0) return;
+		const codeFiles = [...batch.added, ...batch.changed].filter((p) => !isEnvPath(p));
+		try {
+			await this.layerExecutor.executeBatchReload(codeFiles, filesOrchestrator.getFiles(), batch.deleted, batch.changed);
+			typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed]);
+			filesOrchestrator.checkHealth(batch);
+		} catch (error) {
+			devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));
+		}
+	}
+	async shutdown() {
+		if (!this.running) return;
+		devServeLog(colors.redBright("Shutting down Development Server..."));
+		this.running = false;
+		await connectorsManager.shutdown();
+		devServeLog(colors.greenBright("Development Server stopped"));
+	}
+	isRunning() {
+		return this.running;
+	}
+};
+async function dropNoOpChanges(changedPaths) {
+	return (await Promise.all(changedPaths.map(async (relativePath) => {
+		if (isEnvPath(relativePath)) return relativePath;
+		const file = filesOrchestrator.files.get(relativePath);
+		if (!file) return null;
+		const content = await getFileAsync(file.absolutePath);
+		if (content.trim() === file.source) return null;
+		file.source = content;
+		return relativePath;
+	}))).filter((p) => p !== null);
+}
+function isEnvPath(path) {
+	const basename = path.split("/").pop() ?? path;
+	return basename === ".env" || basename.startsWith(".env.");
+}
+function parseDuration(ms) {
+	if (ms < 1e3) return `${ms.toFixed(2)}ms`;
+	if (ms > 6e4) return `${(ms / 6e4).toFixed(2)}m`;
+	return `${(ms / 1e3).toFixed(2)}s`;
+}
+
+//#endregion
+export { DevelopmentServer };
+//# sourceMappingURL=development-server.mjs.map

package/esm/dev-server/development-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport events from \"@mongez/events\";\r\nimport { fileExistsAsync, getFileAsync, unlinkAsync } from \"@warlock.js/fs\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { warlockConfigManager } from \"../warlock-config\";\r\nimport { devLogReady, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\r\nimport { filesOrchestrator } from \"./files-orchestrator\";\r\nimport { MANIFEST_PATH } from \"./flags\";\r\nimport { LayerExecutor } from \"./layer-executor\";\r\nimport type { StartDevServerOptions } from \"./start-development-server\";\r\nimport { typeGenerator } from \"./type-generator\";\r\n\r\ntype Batch = { added: string[]; changed: string[]; deleted: string[] };\r\n\r\n/**\r\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\r\n * connectors, and the layer executor together, and listens for the watcher's\r\n * batched events to drive HMR.\r\n */\r\nexport class DevelopmentServer {\r\n  private layerExecutor?: LayerExecutor;\r\n  private running = false;\r\n  private readonly options: StartDevServerOptions;\r\n\r\n  public constructor(options: StartDevServerOptions = {}) {\r\n    this.options = options;\r\n    devLogSection(\"Starting Development Server...\");\r\n  }\r\n\r\n  public async start(): Promise<void> {\r\n    try {\r\n      const startedAt = performance.now();\r\n\r\n      // --fresh deletes the manifest so reconciliation re-parses every file\r\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\r\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\r\n        await unlinkAsync(MANIFEST_PATH);\r\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\r\n      }\r\n\r\n      await filesOrchestrator.init();\r\n      await filesOrchestrator.initializeAll();\r\n      await filesOrchestrator.watchFiles();\r\n\r\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\r\n\r\n      this.setupEventListeners();\r\n\r\n      // Decorator-driven registries (models, etc.) must be populated before\r\n      // routes/services can resolve symbols by name.\r\n      await this.autoDiscoverFiles();\r\n\r\n      await filesOrchestrator.moduleLoader.loadAll();\r\n\r\n      // Late-phase connectors (http, socket) bind after app code has\r\n      // registered routes/listeners.\r\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\r\n\r\n      this.layerExecutor = new LayerExecutor(\r\n        filesOrchestrator.getDependencyGraph(),\r\n        filesOrchestrator.specialFilesCollector,\r\n        filesOrchestrator.moduleLoader,\r\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\r\n        () => filesOrchestrator.flushVersionBumps(),\r\n      );\r\n\r\n      this.running = true;\r\n\r\n      const duration = performance.now() - startedAt;\r\n      devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);\r\n\r\n      // Precedence: explicit CLI option > devServer.* config > default.\r\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\r\n      const generateTypings =\r\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\r\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\r\n\r\n      if (generateTypings) typeGenerator.executeGenerateAllCommand();\r\n\r\n      if (healthCheckers) {\r\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\r\n      }\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\r\n      await this.shutdown();\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Eagerly import files whose decorators populate global registries so any\r\n   * symbol-by-name resolution later in boot finds them.\r\n   */\r\n  private async autoDiscoverFiles(): Promise<void> {\r\n    const discoveryTypes = [\"model\"] as const;\r\n    for (const file of filesOrchestrator.files.values()) {\r\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\r\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\r\n      }\r\n    }\r\n  }\r\n\r\n  private setupEventListeners(): void {\r\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => this.handleBatchComplete(batch));\r\n  }\r\n\r\n  private async handleBatchComplete(batch: Batch): Promise<void> {\r\n    if (!this.running || !this.layerExecutor) return;\r\n\r\n    // warlock.config.ts holds settings read at boot (CLI commands, build\r\n    // options, watch patterns, scheduled jobs). Hot-reloading it would\r\n    // leave running services configured with stale values, so tell the\r\n    // dev they need a restart and don't pretend to apply the change.\r\n    if (batch.changed.includes(\"warlock.config.ts\")) {\r\n      devLogWarn(\"warlock.config.ts changed — restart the dev server to apply.\");\r\n    }\r\n\r\n    // Some editors fsync on save without writing — drop no-op changes.\r\n    if (batch.changed.length > 0) {\r\n      batch.changed = await dropNoOpChanges(batch.changed);\r\n    }\r\n\r\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\r\n    if (total === 0) return;\r\n\r\n    const codeFiles = [...batch.added, ...batch.changed].filter((p) => !isEnvPath(p));\r\n\r\n    try {\r\n      await this.layerExecutor.executeBatchReload(\r\n        codeFiles,\r\n        filesOrchestrator.getFiles(),\r\n        batch.deleted,\r\n        batch.changed,\r\n      );\r\n\r\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed]);\r\n\r\n      filesOrchestrator.checkHealth(batch);\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\r\n    }\r\n  }\r\n\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.running) return;\r\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\r\n    this.running = false;\r\n    await connectorsManager.shutdown();\r\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\r\n  }\r\n\r\n  public isRunning(): boolean {\r\n    return this.running;\r\n  }\r\n}\r\n\r\nasync function dropNoOpChanges(changedPaths: string[]): Promise<string[]> {\r\n  const kept = await Promise.all(\r\n    changedPaths.map(async (relativePath) => {\r\n      if (isEnvPath(relativePath)) return relativePath;\r\n\r\n      const file = filesOrchestrator.files.get(relativePath);\r\n      if (!file) return null;\r\n\r\n      const content = await getFileAsync(file.absolutePath);\r\n      if (content.trim() === file.source) return null;\r\n\r\n      file.source = content;\r\n      return relativePath;\r\n    }),\r\n  );\r\n\r\n  return kept.filter((p): p is string => p !== null);\r\n}\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\nfunction parseDuration(ms: number): string {\r\n  if (ms < 1000) return `${ms.toFixed(2)}ms`;\r\n  if (ms > 60_000) return `${(ms / 60_000).toFixed(2)}m`;\r\n  return `${(ms / 1000).toFixed(2)}s`;\r\n}\r\n"],"mappings":"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"}

package/esm/dev-server/events.mjs

@@ -0,0 +1,9 @@
+//#region ../../@warlock.js/core/src/dev-server/events.ts
+const DEV_SERVER_EVENTS = {
+	MANIFEST_NOT_FOUND: "dev-server.manifest.not-found",
+	FILE_READY: "dev-server.file.ready"
+};
+
+//#endregion
+export { DEV_SERVER_EVENTS };
+//# sourceMappingURL=events.mjs.map

package/esm/dev-server/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/dev-server/events.ts"],"sourcesContent":["export const DEV_SERVER_EVENTS = {\n  MANIFEST_NOT_FOUND: \"dev-server.manifest.not-found\",\n  FILE_READY: \"dev-server.file.ready\",\n};\n"],"mappings":";AAAA,MAAa,oBAAoB;CAC/B,oBAAoB;CACpB,YAAY;AACd"}