@warlock.js/core 3.0.40 → 4.0.2

package/esm/dev2-server/connectors/http-connector.d.ts

@@ -0,0 +1,29 @@
+import { BaseConnector } from "./base-connector";
+import { ConnectorPriority } from "./types";
+/**
+ * HTTP Connector
+ * Manages HTTP server (Fastify) lifecycle
+ */
+export declare class HttpConnector extends BaseConnector {
+    readonly name = "HTTP Server";
+    readonly priority = ConnectorPriority.HTTP;
+    /**
+     * Files that trigger HTTP server restart
+     * Note: routes.ts changes will be handled by HMR with wildcard routing
+     */
+    protected readonly watchedFiles: string[];
+    /**
+     * Initialize HTTP server
+     */
+    start(): Promise<void>;
+    /**
+     * Shutdown HTTP server
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Override shouldRestart to handle routes.ts specially
+     * routes.ts changes should NOT restart the server (use HMR instead)
+     */
+    shouldRestart(changedFiles: string[]): boolean;
+}
+//# sourceMappingURL=http-connector.d.ts.map

package/esm/dev2-server/connectors/http-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-connector.d.ts","sourceRoot":"","sources":["../../../src/dev2-server/connectors/http-connector.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;;GAGG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAgB,IAAI,iBAAiB;IACrC,SAAgB,QAAQ,0BAA0B;IAElD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,WAAiD;IAEhF;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CnC;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtC;;;OAGG;IACI,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO;CAOtD"}

package/esm/dev2-server/connectors/http-connector.js

@@ -0,0 +1,71 @@
+import config from'@mongez/config';import {registerHttpPlugins}from'../../http/plugins.js';import {startServer,getServer}from'../../http/server.js';import {router}from'../../router/router.js';import {setBaseUrl}from'../../utils/urls.js';import {devLogInfo,devLogSuccess,devLogError}from'../dev-logger.js';import {BaseConnector}from'./base-connector.js';import {ConnectorPriority}from'./types.js';/**
+ * HTTP Connector
+ * Manages HTTP server (Fastify) lifecycle
+ */
+class HttpConnector extends BaseConnector {
+    name = "HTTP Server";
+    priority = ConnectorPriority.HTTP;
+    /**
+     * Files that trigger HTTP server restart
+     * Note: routes.ts changes will be handled by HMR with wildcard routing
+     */
+    watchedFiles = ["src/config/http.ts", "src/config/http.tsx"];
+    /**
+     * Initialize HTTP server
+     */
+    async start() {
+        // TODO: Implement actual HTTP server initialization
+        // - Check if config/http.ts exists
+        // - Load HTTP configuration
+        // - Initialize Fastify
+        // - Setup wildcard route for internal routing
+        // - Start listening on configured port
+        // - Handle startup errors
+        const httpConfig = config.get("http");
+        if (!httpConfig)
+            return;
+        const port = httpConfig.port;
+        devLogInfo("Starting http server on port " + port);
+        const server = startServer();
+        await registerHttpPlugins(server);
+        router.scanDevServer(server);
+        try {
+            // 👇🏻 We can use the url of the server
+            await server.listen({
+                port,
+                host: httpConfig.host,
+            });
+            const baseUrl = config.get("app.baseUrl");
+            // update base url
+            setBaseUrl(baseUrl);
+            devLogSuccess(`Server is listening on ${baseUrl}`);
+        }
+        catch (error) {
+            devLogError("Error while starting http server", error);
+            process.exit(1); // stop the process, exit with error
+        }
+        this.active = true;
+    }
+    /**
+     * Shutdown HTTP server
+     */
+    async shutdown() {
+        if (!this.active) {
+            return;
+        }
+        const server = getServer();
+        server?.close();
+        this.active = false;
+    }
+    /**
+     * Override shouldRestart to handle routes.ts specially
+     * routes.ts changes should NOT restart the server (use HMR instead)
+     */
+    shouldRestart(changedFiles) {
+        // Only restart for config changes, not routes
+        return changedFiles.some((file) => {
+            const relativePath = file.replace(/\\/g, "/");
+            return relativePath === "src/config/http.ts" || relativePath === "src/config/http.tsx";
+        });
+    }
+}export{HttpConnector};//# sourceMappingURL=http-connector.js.map

package/esm/dev2-server/connectors/http-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-connector.js","sources":["../../../src/dev2-server/connectors/http-connector.ts"],"sourcesContent":[null],"names":[],"mappings":"4YASA;;;AAGG;AACG,MAAO,aAAc,SAAQ,aAAa,CAAA;IAC9B,IAAI,GAAG,aAAa,CAAC;AACrB,IAAA,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC;AAElD;;;AAGG;AACgB,IAAA,YAAY,GAAG,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAAC;AAEhF;;AAEG;AACI,IAAA,MAAM,KAAK,GAAA;;;;;;;;QAQhB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAEtC,QAAA,IAAI,CAAC,UAAU;YAAE,OAAO;AAExB,QAAA,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;AAC7B,QAAA,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAC;AAEnD,QAAA,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;AAE7B,QAAA,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAElC,QAAA,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE7B,IAAI;;YAEF,MAAM,MAAM,CAAC,MAAM,CAAC;gBAClB,IAAI;gBACJ,IAAI,EAAE,UAAU,CAAC,IAAI;AACtB,aAAA,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;;YAG1C,UAAU,CAAC,OAAO,CAAC,CAAC;AAEpB,YAAA,aAAa,CAAC,CAAA,uBAAA,EAA0B,OAAO,CAAA,CAAE,CAAC,CAAC;AACpD,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,WAAW,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;AAEvD,YAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,SAAA;AAED,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;KACpB;AAED;;AAEG;AACI,IAAA,MAAM,QAAQ,GAAA;AACnB,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAChB,OAAO;AACR,SAAA;AAED,QAAA,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAE3B,MAAM,EAAE,KAAK,EAAE,CAAC;AAEhB,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;KACrB;AAED;;;AAGG;AACI,IAAA,aAAa,CAAC,YAAsB,EAAA;;AAEzC,QAAA,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,KAAI;YAChC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9C,YAAA,OAAO,YAAY,KAAK,oBAAoB,IAAI,YAAY,KAAK,qBAAqB,CAAC;AACzF,SAAC,CAAC,CAAC;KACJ;AACF"}

package/esm/dev2-server/connectors/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Connectors Module
+ * Exports all connector types and implementations
+ */
+export * from "./types";
+export * from "./base-connector";
+export * from "./database-connector";
+export * from "./cache-connector";
+export * from "./http-connector";
+//# sourceMappingURL=index.d.ts.map

package/esm/dev2-server/connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dev2-server/connectors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/esm/dev2-server/connectors/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Connector Interface
+ * All service connectors (Database, HTTP, Cache, etc.) must implement this interface
+ */
+export interface Connector {
+    /**
+     * Unique name of the connector
+     */
+    readonly name: string;
+    /**
+     * Priority for initialization order
+     * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)
+     */
+    readonly priority: number;
+    /**
+     * Whether the connector is currently active/connected
+     */
+    isActive(): boolean;
+    /**
+     * Initialize the connector
+     * Called during server startup
+     */
+    start(): Promise<void>;
+    /**
+     * Restart the connector
+     * Called when watched files change
+     */
+    restart(): Promise<void>;
+    /**
+     * Gracefully shutdown the connector
+     * Called during server shutdown
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Determine if this connector needs restart based on changed files
+     * @param changedFiles Array of relative file paths that changed
+     * @returns true if connector should restart
+     */
+    shouldRestart(changedFiles: string[]): boolean;
+}
+/**
+ * Connector priority constants
+ */
+export declare enum ConnectorPriority {
+    DATABASE = 1,
+    CACHE = 2,
+    HTTP = 3
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/dev2-server/connectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dev2-server/connectors/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;IAEpB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;OAIG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,IAAI,IAAI;CACT"}

package/esm/dev2-server/connectors/types.js

@@ -0,0 +1,9 @@
+/**
+ * Connector priority constants
+ */
+var ConnectorPriority;
+(function (ConnectorPriority) {
+    ConnectorPriority[ConnectorPriority["DATABASE"] = 1] = "DATABASE";
+    ConnectorPriority[ConnectorPriority["CACHE"] = 2] = "CACHE";
+    ConnectorPriority[ConnectorPriority["HTTP"] = 3] = "HTTP";
+})(ConnectorPriority || (ConnectorPriority = {}));export{ConnectorPriority};//# sourceMappingURL=types.js.map

package/esm/dev2-server/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../src/dev2-server/connectors/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AA+CA;;AAEG;IACS,kBAIX;AAJD,CAAA,UAAY,iBAAiB,EAAA;AAC3B,IAAA,iBAAA,CAAA,iBAAA,CAAA,UAAA,CAAA,GAAA,CAAA,CAAA,GAAA,UAAY,CAAA;AACZ,IAAA,iBAAA,CAAA,iBAAA,CAAA,OAAA,CAAA,GAAA,CAAA,CAAA,GAAA,OAAS,CAAA;AACT,IAAA,iBAAA,CAAA,iBAAA,CAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,MAAQ,CAAA;AACV,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,GAI5B,EAAA,CAAA,CAAA"}

package/esm/dev2-server/dependency-graph.d.ts

@@ -0,0 +1,93 @@
+import type { FileManager } from "./file-manager";
+/**
+ * Dependency Graph
+ * Tracks bidirectional relationships between files:
+ * - dependencies: files that this file imports
+ * - dependents: files that import this file
+ */
+export declare class DependencyGraph {
+    /**
+     * Map of file -> files it depends on (imports)
+     * Key: relative file path
+     * Value: Set of relative file paths this file imports
+     */
+    private dependencies;
+    /**
+     * Map of file -> files that depend on it (importers)
+     * Key: relative file path
+     * Value: Set of relative file paths that import this file
+     */
+    private dependents;
+    /**
+     * Build dependency graph from FileManager map
+     */
+    build(files: Map<string, FileManager>): void;
+    /**
+     * Add a dependency relationship
+     * @param file The file that has the dependency
+     * @param dependency The file being depended upon
+     */
+    addDependency(file: string, dependency: string): void;
+    /**
+     * Remove a dependency relationship
+     * @param file The file that has the dependency
+     * @param dependency The file being depended upon
+     */
+    removeDependency(file: string, dependency: string): void;
+    /**
+     * Remove all relationships for a file
+     * @param file The file to remove
+     */
+    removeFile(file: string): void;
+    /**
+     * Update dependencies for a file
+     * @param file The file to update
+     * @param newDependencies New set of dependencies
+     */
+    updateFile(file: string, newDependencies: Set<string>): void;
+    /**
+     * Get files that this file depends on (imports)
+     * @param file The file to check
+     * @returns Set of files this file imports
+     */
+    getDependencies(file: string): Set<string>;
+    /**
+     * Get files that depend on this file (importers)
+     * @param file The file to check
+     * @returns Set of files that import this file
+     */
+    getDependents(file: string): Set<string>;
+    /**
+     * 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: string): string[];
+    /**
+     * Detect circular dependencies in the dependency graph
+     * Uses depth-first search to find cycles
+     * Note: Type-only imports are already excluded at the parsing level (parse-imports.ts)
+     * @returns Array of circular dependency chains (each chain is an array of file paths)
+     */
+    detectCircularDependencies(): string[][];
+    /**
+     * Display circular dependency warnings in a formatted, user-friendly way
+     * Shows each cycle with visual tree structure and helpful recommendations
+     */
+    private displayCircularDependencyWarnings;
+    /**
+     * Get statistics about the dependency graph
+     */
+    getStats(): {
+        totalFiles: number;
+        totalDependencies: number;
+        avgDependenciesPerFile: number;
+        maxDependencies: number;
+        maxDependents: number;
+        mostDependingFile: string;
+        mostDependedFile: string;
+    };
+}
+//# sourceMappingURL=dependency-graph.d.ts.map

package/esm/dev2-server/dependency-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.d.ts","sourceRoot":"","sources":["../../src/dev2-server/dependency-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAkC;IAEtD;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAAkC;IAEpD;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IA6B5C;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAcrD;;;;OAIG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAKxD;;;OAGG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM;IAsB9B;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC;IAmB5D;;;;OAIG;IACI,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAIjD;;;;OAIG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI/C;;;;;;OAMG;IACI,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAmBnD;;;;;OAKG;IACI,0BAA0B,IAAI,MAAM,EAAE,EAAE;IAkC/C;;;OAGG;IACH,OAAO,CAAC,iCAAiC;IAoDzC;;OAEG;IACI,QAAQ;;;;;;;;;CAgChB"}

package/esm/dev2-server/dependency-graph.js

@@ -0,0 +1,266 @@
+/**
+ * Dependency Graph
+ * Tracks bidirectional relationships between files:
+ * - dependencies: files that this file imports
+ * - dependents: files that import this file
+ */
+class DependencyGraph {
+    /**
+     * Map of file -> files it depends on (imports)
+     * Key: relative file path
+     * Value: Set of relative file paths this file imports
+     */
+    dependencies = new Map();
+    /**
+     * Map of file -> files that depend on it (importers)
+     * Key: relative file path
+     * Value: Set of relative file paths that import this file
+     */
+    dependents = new Map();
+    /**
+     * Build dependency graph from FileManager map
+     */
+    build(files) {
+        // Clear existing graph
+        this.dependencies.clear();
+        this.dependents.clear();
+        // Build graph from all files
+        for (const [relativePath, fileManager] of files) {
+            // Initialize empty sets ONLY if not already present
+            // (addDependency may have already created entries for this file)
+            if (!this.dependencies.has(relativePath)) {
+                this.dependencies.set(relativePath, new Set());
+            }
+            if (!this.dependents.has(relativePath)) {
+                this.dependents.set(relativePath, new Set());
+            }
+            // Add dependencies
+            for (const dependency of fileManager.dependencies) {
+                this.addDependency(relativePath, dependency);
+            }
+        }
+        // Detect circular dependencies
+        const cycles = this.detectCircularDependencies();
+        if (cycles.length > 0) {
+            this.displayCircularDependencyWarnings(cycles);
+        }
+    }
+    /**
+     * Add a dependency relationship
+     * @param file The file that has the dependency
+     * @param dependency The file being depended upon
+     */
+    addDependency(file, dependency) {
+        // Ensure both files exist in the graph
+        if (!this.dependencies.has(file)) {
+            this.dependencies.set(file, new Set());
+        }
+        if (!this.dependents.has(dependency)) {
+            this.dependents.set(dependency, new Set());
+        }
+        // Add bidirectional relationship
+        this.dependencies.get(file).add(dependency);
+        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) {
+        // Remove as dependent from all its dependencies
+        const deps = this.dependencies.get(file);
+        if (deps) {
+            for (const dependency of deps) {
+                this.dependents.get(dependency)?.delete(file);
+            }
+        }
+        // Remove as dependency from all its dependents
+        const dependents = this.dependents.get(file);
+        if (dependents) {
+            for (const dependent of dependents) {
+                this.dependencies.get(dependent)?.delete(file);
+            }
+        }
+        // Remove from maps
+        this.dependencies.delete(file);
+        this.dependents.delete(file);
+    }
+    /**
+     * Update dependencies for a file
+     * @param file The file to update
+     * @param newDependencies New set of dependencies
+     */
+    updateFile(file, newDependencies) {
+        // Get old dependencies
+        const oldDependencies = this.dependencies.get(file) || new Set();
+        // Find removed dependencies
+        for (const oldDep of oldDependencies) {
+            if (!newDependencies.has(oldDep)) {
+                this.removeDependency(file, oldDep);
+            }
+        }
+        // Find added dependencies
+        for (const newDep of newDependencies) {
+            if (!oldDependencies.has(newDep)) {
+                this.addDependency(file, newDep);
+            }
+        }
+    }
+    /**
+     * Get files that this file depends on (imports)
+     * @param file The file to check
+     * @returns Set of files this file imports
+     */
+    getDependencies(file) {
+        return this.dependencies.get(file) || new Set();
+    }
+    /**
+     * 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) || 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); // Recursive traversal
+                }
+            }
+        };
+        traverse(file);
+        return chain;
+    }
+    /**
+     * Detect circular dependencies in the dependency graph
+     * Uses depth-first search to find cycles
+     * Note: Type-only imports are already excluded at the parsing level (parse-imports.ts)
+     * @returns Array of circular dependency chains (each chain is an array of file paths)
+     */
+    detectCircularDependencies() {
+        const cycles = [];
+        const visited = new Set();
+        const recursionStack = new Set();
+        const dfs = (file, path) => {
+            visited.add(file);
+            recursionStack.add(file);
+            path.push(file);
+            const deps = this.getDependencies(file);
+            for (const dep of deps) {
+                if (!visited.has(dep)) {
+                    dfs(dep, [...path]);
+                }
+                else if (recursionStack.has(dep)) {
+                    // Found a cycle
+                    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;
+    }
+    /**
+     * 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`,
+        };
+        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("");
+            // Display the cycle chain
+            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) {
+                    // Last item is the same as first (completes the cycle)
+                    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("💡 Recommendation:"));
+        console.log(colors.dim("   Refactor your code to remove circular dependencies for better"));
+        console.log(colors.dim("   maintainability and HMR performance."));
+        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,
+        };
+    }
+}export{DependencyGraph};//# sourceMappingURL=dependency-graph.js.map

package/esm/dev2-server/dependency-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-graph.js","sources":["../../src/dev2-server/dependency-graph.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/dev2-server/dev-logger.d.ts

@@ -0,0 +1,14 @@
+export declare function devLog(message: string): void;
+export declare function devLogSuccess(message: string): void;
+export declare function devLogError(message: string, error?: any): void;
+export declare function devLogWarn(message: string): void;
+export declare function devLogInfo(message: string): void;
+export declare function devLogDim(message: string): void;
+export declare function devLogHMR(file: string, dependents?: number): void;
+export declare function devLogFSR(reason: string): void;
+export declare function devLogConfig(file: string, connectors?: string[]): void;
+export declare function devLogReady(message: string): void;
+export declare function devLogSection(title: string): void;
+export declare function formatModuleNotFoundError(error: Error): string;
+export declare function devServeLog(message: string): void;
+//# sourceMappingURL=dev-logger.d.ts.map

package/esm/dev2-server/dev-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-logger.d.ts","sourceRoot":"","sources":["../../src/dev2-server/dev-logger.ts"],"names":[],"mappings":"AAcA,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,QAErC;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,QAE5C;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,QAOvD;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,QAEzC;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,QAEzC;AAGD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,QAExC;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,QAK1D;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,QAEvC;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,QAM/D;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,QAE1C;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,QAE1C;AAyCD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CA2B9D;AAGD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,QAE1C"}