@nexus-ioc/graph-analyzer 0.1.0

package/dist/parser/provider/use-class-parser.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseClassParser = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+const tsquery_1 = require("@phenomnomnominal/tsquery");
+const ts = tslib_1.__importStar(require("typescript"));
+const dependency_extractor_1 = require("../dependency-extractor");
+const provideRegexp = /provide:\s*([^,\s]+)/;
+const useClassRegexp = /useClass:\s*([A-Za-z_][A-Za-z0-9_]*)/;
+const scopeRegexp = /scope:\s*([A-Za-z_][\w.]*)/;
+class UseClassParser {
+    constructor(provider, sourceFile, currentFilePath) {
+        this.provider = provider;
+        this.sourceFile = sourceFile;
+        this.currentFilePath = currentFilePath;
+        this.type = "UseClass";
+        this._token = null;
+        this._value = null;
+        this._scope = null;
+        this._dependencies = [];
+        this.dependencyExtractor = new dependency_extractor_1.DependencyExtractor();
+    }
+    parse() {
+        const token = this.provider.match(provideRegexp);
+        const useClass = this.provider.match(useClassRegexp);
+        const scope = this.provider.match(scopeRegexp);
+        if (token) {
+            this._token = token[1];
+        }
+        if (useClass) {
+            this._value = useClass[1];
+            // Extract dependencies from the class
+            if (this.sourceFile && this._value) {
+                this._dependencies = this.extractDependenciesFromClass(this._value);
+            }
+        }
+        if (scope) {
+            this._scope = scope[1];
+        }
+        return this;
+    }
+    extractDependenciesFromClass(className) {
+        if (!this.sourceFile) {
+            return [];
+        }
+        // First, try to find the class in the current file (module file)
+        let classDeclaration = this.findClassDeclaration(className, this.sourceFile);
+        let targetSourceFile = this.sourceFile;
+        // If not found, try to find the import and load the actual class file
+        if (!classDeclaration && this.currentFilePath) {
+            const classSourceFile = this.findAndLoadClassFile(className);
+            if (classSourceFile) {
+                classDeclaration = this.findClassDeclaration(className, classSourceFile);
+                targetSourceFile = classSourceFile;
+            }
+        }
+        if (!classDeclaration) {
+            return [];
+        }
+        // Extract dependencies using the DependencyExtractor
+        return this.dependencyExtractor.extractDependencies(classDeclaration, targetSourceFile);
+    }
+    findAndLoadClassFile(className) {
+        if (!this.sourceFile || !this.currentFilePath) {
+            return undefined;
+        }
+        // Find the import statement for this class
+        const importPath = this.findImportPathForClass(className);
+        if (!importPath) {
+            return undefined;
+        }
+        // Resolve the full path
+        const fullPath = this.resolveImportPath(importPath);
+        if (!fullPath || !fs.existsSync(fullPath)) {
+            return undefined;
+        }
+        // Load and parse the file
+        try {
+            const content = fs.readFileSync(fullPath, "utf8");
+            return ts.createSourceFile(fullPath, content, ts.ScriptTarget.Latest, true);
+        }
+        catch (_error) {
+            return undefined;
+        }
+    }
+    findImportPathForClass(className) {
+        if (!this.sourceFile) {
+            return undefined;
+        }
+        // Find import declarations that include this class
+        const importDeclarations = (0, tsquery_1.query)(this.sourceFile, "ImportDeclaration");
+        for (const node of importDeclarations) {
+            if (!ts.isImportDeclaration(node)) {
+                continue;
+            }
+            const importClause = node.importClause;
+            if (!importClause || !importClause.namedBindings) {
+                continue;
+            }
+            // Check named imports
+            if (ts.isNamedImports(importClause.namedBindings)) {
+                for (const element of importClause.namedBindings.elements) {
+                    if (element.name.text === className) {
+                        // Found the import!
+                        if (ts.isStringLiteral(node.moduleSpecifier)) {
+                            return node.moduleSpecifier.text;
+                        }
+                    }
+                }
+            }
+        }
+        return undefined;
+    }
+    resolveImportPath(importPath) {
+        if (!this.currentFilePath) {
+            return undefined;
+        }
+        // Skip node_modules
+        if (!importPath.startsWith(".")) {
+            return undefined;
+        }
+        const dir = path.dirname(this.currentFilePath);
+        const resolved = path.resolve(dir, importPath);
+        // Try different extensions
+        const extensions = [".ts", ".tsx", "/index.ts", "/index.tsx"];
+        for (const ext of extensions) {
+            const fullPath = resolved.endsWith(".ts") ? resolved : resolved + ext;
+            if (fs.existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+        return undefined;
+    }
+    findClassDeclaration(className, sourceFile) {
+        // Use tsquery to find the class declaration
+        const selector = `ClassDeclaration[name.name="${className}"]`;
+        const nodes = (0, tsquery_1.query)(sourceFile, selector);
+        for (const node of nodes) {
+            if (ts.isClassDeclaration(node)) {
+                return node;
+            }
+        }
+        return undefined;
+    }
+    get token() {
+        return this._token;
+    }
+    get value() {
+        return this._value;
+    }
+    get scope() {
+        return this._scope;
+    }
+    get dependencies() {
+        return this._dependencies;
+    }
+}
+exports.UseClassParser = UseClassParser;
+//# sourceMappingURL=use-class-parser.js.map

package/dist/parser/provider/use-class-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-class-parser.js","sourceRoot":"","sources":["../../../src/parser/provider/use-class-parser.ts"],"names":[],"mappings":"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"}

package/dist/parser/provider/use-factory-parser.d.ts

@@ -0,0 +1,15 @@
+import type { ProvidersInterface } from "../../interfaces/providers.interface";
+export declare class UseFactoryParser implements ProvidersInterface {
+    private readonly provider;
+    readonly type = "UseFactory";
+    private _token;
+    private _value;
+    private _inject;
+    private _scope;
+    constructor(provider: string);
+    parse(): this;
+    get token(): string | null;
+    get value(): string | null;
+    get inject(): string[];
+    get scope(): string | null;
+}

package/dist/parser/provider/use-factory-parser.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseFactoryParser = void 0;
+const provideRegexp = /provide:\s*"([^"]+)"/;
+const useFactoryRegexp = /useFactory:\s*((?:\([^)]*\)\s*=>\s*\{[^}]*\}))/;
+const injectRegexp = /inject:\s*\[([^\]]+)\]/;
+const scopeRegexp = /scope:\s*([^,}]+)/;
+class UseFactoryParser {
+    constructor(provider) {
+        this.provider = provider;
+        this.type = "UseFactory";
+        this._token = null;
+        this._value = null;
+        this._inject = [];
+        this._scope = null;
+    }
+    parse() {
+        const token = this.provider.match(provideRegexp);
+        const useFactory = this.provider.match(useFactoryRegexp);
+        const inject = this.provider.match(injectRegexp);
+        const scope = this.provider.match(scopeRegexp);
+        if (token) {
+            this._token = token[1];
+        }
+        if (useFactory) {
+            this._value = useFactory[1];
+        }
+        if (inject) {
+            this._inject = inject[1]
+                .split(",")
+                .map((inject) => inject.trim())
+                .map((inject) => inject.replace(/^["']|["']$/g, "")); // Remove surrounding quotes
+        }
+        if (scope) {
+            this._scope = scope[1].trim();
+        }
+        return this;
+    }
+    get token() {
+        return this._token;
+    }
+    get value() {
+        return this._value;
+    }
+    get inject() {
+        return this._inject;
+    }
+    get scope() {
+        return this._scope;
+    }
+}
+exports.UseFactoryParser = UseFactoryParser;
+//# sourceMappingURL=use-factory-parser.js.map

package/dist/parser/provider/use-factory-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-factory-parser.js","sourceRoot":"","sources":["../../../src/parser/provider/use-factory-parser.ts"],"names":[],"mappings":";;;AAEA,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAC7C,MAAM,gBAAgB,GAAG,gDAAgD,CAAC;AAC1E,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAC9C,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAa,gBAAgB;IAO5B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAN7B,SAAI,GAAG,YAAY,CAAC;QAC5B,WAAM,GAAkB,IAAI,CAAC;QAC7B,WAAM,GAAkB,IAAI,CAAC;QAC7B,YAAO,GAAa,EAAE,CAAC;QACvB,WAAM,GAAkB,IAAI,CAAC;IAEW,CAAC;IAEjD,KAAK;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE/C,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;iBACtB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;iBAC9B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,4BAA4B;QACpF,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;CACD;AApDD,4CAoDC"}

package/dist/parser/provider/use-value-parser.d.ts

@@ -0,0 +1,13 @@
+import type { ProvidersInterface } from "../../interfaces/providers.interface";
+export declare class UseValueParser implements ProvidersInterface {
+    private readonly provider;
+    readonly type = "UseValue";
+    private _token;
+    private _value;
+    private _scope;
+    constructor(provider: string);
+    parse(): this;
+    get token(): string | null;
+    get value(): string | null;
+    get scope(): string | null;
+}

package/dist/parser/provider/use-value-parser.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseValueParser = void 0;
+const provideRegexp = /provide:\s*"([^"]+)"/;
+const useValueRegexp = /useValue:\s*"([^"]+)"/;
+const scopeRegexp = /scope:\s*([^,}]+)/;
+class UseValueParser {
+    constructor(provider) {
+        this.provider = provider;
+        this.type = "UseValue";
+        this._token = null;
+        this._value = null;
+        this._scope = null;
+    }
+    parse() {
+        const token = this.provider.match(provideRegexp);
+        const useValue = this.provider.match(useValueRegexp);
+        const scope = this.provider.match(scopeRegexp);
+        if (token) {
+            this._token = token[1];
+        }
+        if (useValue) {
+            this._value = useValue[1];
+        }
+        if (scope) {
+            this._scope = scope[1].trim();
+        }
+        return this;
+    }
+    get token() {
+        return this._token;
+    }
+    get value() {
+        return this._value;
+    }
+    get scope() {
+        return this._scope;
+    }
+}
+exports.UseValueParser = UseValueParser;
+//# sourceMappingURL=use-value-parser.js.map

package/dist/parser/provider/use-value-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-value-parser.js","sourceRoot":"","sources":["../../../src/parser/provider/use-value-parser.ts"],"names":[],"mappings":";;;AAEA,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAC7C,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAa,cAAc;IAM1B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAL7B,SAAI,GAAG,UAAU,CAAC;QAC1B,WAAM,GAAkB,IAAI,CAAC;QAC7B,WAAM,GAAkB,IAAI,CAAC;QAC7B,WAAM,GAAkB,IAAI,CAAC;IAEW,CAAC;IAEjD,KAAK;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAE/C,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;CACD;AAvCD,wCAuCC"}

package/dist/parser/rules.d.ts

@@ -0,0 +1,10 @@
+import type * as ts from "typescript";
+export declare const rules: ({
+    rule: string;
+    callback(nodes: ts.Node[], _file: ts.SourceFile): void;
+    name?: undefined;
+} | {
+    name: string;
+    rule: string;
+    callback(nodes: ts.Node[], _file: ts.SourceFile): void;
+})[];

package/dist/parser/rules.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rules = void 0;
+let entryModule = null;
+exports.rules = [
+    {
+        rule: "CallExpression",
+        callback(nodes, _file) {
+            if (entryModule) {
+                return;
+            }
+            for (const node of nodes) {
+                const text = node.getText();
+                const match = text.match(/\.create\((\w+)\)/);
+                if (match) {
+                    entryModule = match[1];
+                    return;
+                }
+            }
+        },
+    },
+    {
+        name: "findNsModuleDecorators",
+        rule: 'Decorator[expression.expression.name="NsModule"]',
+        callback(nodes, _file) {
+            for (const node of nodes) {
+                const text = node.getText();
+                const match = text.match(/imports:\s*\[([^\]]+)\]/);
+                if (match) {
+                    const modules = match[1].split(",").map((m) => m.trim());
+                    console.log("modules: ", modules);
+                }
+            }
+        },
+    },
+];
+//# sourceMappingURL=rules.js.map

package/dist/parser/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/parser/rules.ts"],"names":[],"mappings":";;;AAEA,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEzB,QAAA,KAAK,GAAG;IACpB;QACC,IAAI,EAAE,gBAAgB;QACtB,QAAQ,CAAC,KAAgB,EAAE,KAAoB;YAC9C,IAAI,WAAW,EAAE,CAAC;gBACjB,OAAO;YACR,CAAC;YAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;gBAE9C,IAAI,KAAK,EAAE,CAAC;oBACX,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACvB,OAAO;gBACR,CAAC;YACF,CAAC;QACF,CAAC;KACD;IACD;QACC,IAAI,EAAE,wBAAwB;QAC9B,IAAI,EAAE,kDAAkD;QACxD,QAAQ,CAAC,KAAgB,EAAE,KAAoB;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBAEpD,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,OAAO,GAAa,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAEnE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBACnC,CAAC;YACF,CAAC;QACF,CAAC;KACD;CACD,CAAC"}

package/dist/utils/error-formatter.d.ts

@@ -0,0 +1,27 @@
+import type { ValidationError } from "./validator";
+export declare class ErrorFormatter {
+    /**
+     * Format a validation error with clear sections
+     */
+    static formatValidationError(error: ValidationError): string;
+    /**
+     * Format a generic error with context-aware suggestions
+     */
+    static formatError(error: Error): string;
+    /**
+     * Get context-aware suggestions based on error message
+     */
+    private static getSuggestionsForError;
+    /**
+     * Format a success message
+     */
+    static formatSuccess(message: string): string;
+    /**
+     * Format a warning message
+     */
+    static formatWarning(message: string): string;
+    /**
+     * Format an info message
+     */
+    static formatInfo(message: string): string;
+}

package/dist/utils/error-formatter.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorFormatter = void 0;
+class ErrorFormatter {
+    /**
+     * Format a validation error with clear sections
+     */
+    static formatValidationError(error) {
+        const lines = [];
+        // Header
+        lines.push("");
+        lines.push("=".repeat(50));
+        lines.push("❌ Error");
+        lines.push("=".repeat(50));
+        lines.push("");
+        // Error message
+        lines.push(error.message);
+        lines.push("");
+        // Details if available
+        if (error.details) {
+            lines.push("Details:");
+            lines.push(`  ${error.details}`);
+            lines.push("");
+        }
+        // Suggestions
+        if (error.suggestions && error.suggestions.length > 0) {
+            lines.push("Suggestions:");
+            for (const suggestion of error.suggestions) {
+                if (suggestion === "") {
+                    lines.push("");
+                }
+                else {
+                    lines.push(`  • ${suggestion}`);
+                }
+            }
+            lines.push("");
+        }
+        // Footer
+        lines.push("For more help, run: graph-analyzer --help");
+        lines.push("");
+        return lines.join("\n");
+    }
+    /**
+     * Format a generic error with context-aware suggestions
+     */
+    static formatError(error) {
+        const lines = [];
+        const errorMessage = error.message;
+        // Header
+        lines.push("");
+        lines.push("=".repeat(50));
+        lines.push("❌ Error");
+        lines.push("=".repeat(50));
+        lines.push("");
+        // Error message
+        lines.push(errorMessage);
+        lines.push("");
+        // Add context-aware suggestions
+        const suggestions = ErrorFormatter.getSuggestionsForError(errorMessage);
+        if (suggestions.length > 0) {
+            lines.push("Suggestions:");
+            for (const suggestion of suggestions) {
+                if (suggestion === "") {
+                    lines.push("");
+                }
+                else {
+                    lines.push(`  • ${suggestion}`);
+                }
+            }
+            lines.push("");
+        }
+        // Footer
+        lines.push("For more help, run: graph-analyzer --help");
+        lines.push("");
+        return lines.join("\n");
+    }
+    /**
+     * Get context-aware suggestions based on error message
+     */
+    static getSuggestionsForError(errorMessage) {
+        const suggestions = [];
+        // Decorator errors (check before "not found" to avoid false matches)
+        if (errorMessage.toLowerCase().includes("decorator")) {
+            suggestions.push("Ensure decorators are enabled in tsconfig.json:");
+            suggestions.push('  "experimentalDecorators": true');
+            suggestions.push('  "emitDecoratorMetadata": true');
+        }
+        // File not found errors
+        else if (errorMessage.includes("not found") ||
+            errorMessage.includes("ENOENT")) {
+            suggestions.push("Check if the file path is correct");
+            suggestions.push("Make sure you're in the project root directory");
+            suggestions.push("Use an absolute path or relative path from current directory");
+            suggestions.push(`Current directory: ${process.cwd()}`);
+        }
+        // No entry module errors
+        else if (errorMessage.includes("No entry module")) {
+            suggestions.push("Make sure your entry file contains a NexusFactory.create() call");
+            suggestions.push("Check that the root module is properly decorated with @NsModule");
+            suggestions.push("");
+            suggestions.push("Example entry file:");
+            suggestions.push("  import { NexusFactory } from '@nexus-ioc/core';");
+            suggestions.push("  import { AppModule } from './app.module';");
+            suggestions.push("");
+            suggestions.push("  const app = NexusFactory.create(AppModule);");
+        }
+        // Invalid format errors
+        else if (errorMessage.includes("Invalid format")) {
+            suggestions.push("Use one of: json, png, html, or both");
+            suggestions.push("Example: graph-analyzer -f json src/main.ts");
+        }
+        // Invalid configuration errors
+        else if (errorMessage.includes("Invalid configuration")) {
+            suggestions.push("Check your configuration file syntax");
+            suggestions.push("Ensure all values match the expected types");
+            suggestions.push("Run: graph-analyzer --init to generate a valid config");
+        }
+        // Configuration file errors
+        else if (errorMessage.includes("Configuration file")) {
+            suggestions.push("Check if the configuration file exists");
+            suggestions.push("Verify the file path is correct");
+            suggestions.push("Run: graph-analyzer --init to create a new config");
+        }
+        // TypeScript compilation errors
+        else if (errorMessage.includes("Cannot read properties") ||
+            errorMessage.includes("undefined")) {
+            suggestions.push("Check your TypeScript configuration (tsconfig.json)");
+            suggestions.push("Ensure all required compiler options are set");
+            suggestions.push("Verify that your entry file is valid TypeScript");
+            suggestions.push("");
+            suggestions.push("Try specifying tsconfig.json explicitly:");
+            suggestions.push("  graph-analyzer -c ./tsconfig.json src/main.ts");
+        }
+        // Permission errors
+        else if (errorMessage.includes("EACCES") ||
+            errorMessage.includes("permission")) {
+            suggestions.push("Check file and directory permissions");
+            suggestions.push("Make sure you have read/write access");
+            suggestions.push("Try running with appropriate permissions");
+        }
+        // Module resolution errors
+        else if (errorMessage.includes("Cannot find module") ||
+            errorMessage.includes("Module not found")) {
+            suggestions.push("Check that all dependencies are installed");
+            suggestions.push("Run: npm install or yarn install");
+            suggestions.push("Verify import paths in your code");
+            suggestions.push("Check your tsconfig.json paths configuration");
+        }
+        // Generic fallback
+        else {
+            suggestions.push("Check the error message above for details");
+            suggestions.push("Verify your configuration and file paths");
+            suggestions.push("Try running with --verbose for more information");
+        }
+        return suggestions;
+    }
+    /**
+     * Format a success message
+     */
+    static formatSuccess(message) {
+        return `✓ ${message}`;
+    }
+    /**
+     * Format a warning message
+     */
+    static formatWarning(message) {
+        return `⚠ ${message}`;
+    }
+    /**
+     * Format an info message
+     */
+    static formatInfo(message) {
+        return `ℹ ${message}`;
+    }
+}
+exports.ErrorFormatter = ErrorFormatter;
+//# sourceMappingURL=error-formatter.js.map

package/dist/utils/error-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.js","sourceRoot":"","sources":["../../src/utils/error-formatter.ts"],"names":[],"mappings":"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"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,45 @@
+export interface ValidationError {
+    type: string;
+    message: string;
+    suggestions: string[];
+    details?: string;
+}
+export declare class Validator {
+    /**
+     * Validate that a file exists
+     */
+    static validateFileExists(filePath: string): ValidationError | null;
+    /**
+     * Validate that a file has a valid TypeScript extension
+     */
+    static validateTypeScriptFile(filePath: string): ValidationError | null;
+    /**
+     * Validate that a file is readable
+     */
+    static validateFileReadable(filePath: string): ValidationError | null;
+    /**
+     * Validate that tsconfig.json exists if specified
+     */
+    static validateTsConfig(tsConfigPath: string | undefined): ValidationError | null;
+    /**
+     * Check if Graphviz is installed (required for PNG generation)
+     */
+    static validateGraphvizInstalled(format: string | undefined): ValidationError | null;
+    /**
+     * Validate entry file comprehensively
+     */
+    static validateEntryFile(filePath: string): ValidationError | null;
+    /**
+     * Validate output directory is writable
+     */
+    static validateOutputDirectory(outputPath: string): ValidationError | null;
+    /**
+     * Run all pre-flight validations
+     */
+    static runPreflightChecks(options: {
+        entryFile: string;
+        tsConfig?: string;
+        output?: string;
+        format?: string;
+    }): ValidationError | null;
+}