language

type CoverageRunner interface {
	// RunCoverage runs test coverage analysis for the project.
	// Returns per-package coverage results or an error if coverage cannot be run.
	RunCoverage(projectPath string, excludePatterns []string) ([]*coverage.PackageCoverage, error)
}

type DependencyAnalyzer interface {
	// Analyze extracts and categorizes dependencies from parsed files.
	// Returns per-package dependency information.
	Analyze(files []*parser.FileMetrics) ([]*dependencies.PackageDependencies, error)

	// DetectCircularDependencies finds circular import chains.
	// Returns a list of detected cycles.
	DetectCircularDependencies(files []*parser.FileMetrics) ([]*dependencies.CircularDependency, error)
}

type DetectorRunner interface {
	// RunDetectors analyzes a file and returns any issues found by enabled detectors.
	// The implementation may re-parse the file to obtain language-specific AST.
	RunDetectors(cfg *config.AnalysisConfig, file *parser.FileMetrics) []*detectors.Issue
}

type Language interface {
	// Name returns the lowercase identifier for this language (e.g., "go", "python", "typescript").
	// This is used for CLI flags and configuration.
	Name() string

	// DisplayName returns the human-readable name (e.g., "Go", "Python", "TypeScript").
	// This is used in user-facing messages and reports.
	DisplayName() string

	// Extensions returns the file extensions for this language (e.g., [".go"], [".py"], [".ts", ".tsx"]).
	// Extensions should include the leading dot.
	Extensions() []string

	// DefaultExcludePatterns returns glob patterns to exclude by default for this language.
	// For example, Go excludes "vendor/**" and "**/*_test.go".
	DefaultExcludePatterns() []string

	// Parser returns a parser for this language's source files.
	Parser() parser.Parser

	// DetectorRunner returns a runner for anti-pattern detectors.
	// Each language handles its own AST internally - the analyzer never sees language-specific types.
	DetectorRunner(cfg *config.AnalysisConfig) DetectorRunner

	// CoverageRunner returns a runner for test coverage analysis.
	// Returns nil if coverage analysis is not supported for this language.
	CoverageRunner(cfg *config.AnalysisConfig, statusReporter status.Reporter) CoverageRunner

	// DependencyAnalyzer returns an analyzer for dependency analysis.
	// Returns nil if dependency analysis is not supported for this language.
	DependencyAnalyzer(projectPath string) (DependencyAnalyzer, error)
}