@nahisaho/musubix-core 1.0.0

package/dist/design/solid-validator.d.ts

@@ -0,0 +1,188 @@
+/**
+ * SOLID Validator
+ *
+ * Validates code against SOLID principles
+ *
+ * @packageDocumentation
+ * @module design/solid-validator
+ *
+ * @see REQ-DES-003 - SOLID Principles Validation
+ * @see Article III - Design Validation
+ */
+import type { CodeStructure } from './pattern-detector.js';
+/**
+ * SOLID principle
+ */
+export type SOLIDPrinciple = 'S' | 'O' | 'L' | 'I' | 'D';
+/**
+ * SOLID principle info
+ */
+export interface SOLIDPrincipleInfo {
+    /** Principle code */
+    code: SOLIDPrinciple;
+    /** Full name */
+    name: string;
+    /** Description */
+    description: string;
+    /** Violation indicators */
+    violationIndicators: string[];
+}
+/**
+ * SOLID principles information
+ */
+export declare const SOLID_PRINCIPLES: Record<SOLIDPrinciple, SOLIDPrincipleInfo>;
+/**
+ * SOLID violation
+ */
+export interface SOLIDViolation {
+    /** Principle violated */
+    principle: SOLIDPrinciple;
+    /** Severity */
+    severity: 'high' | 'medium' | 'low';
+    /** Class/element involved */
+    element: string;
+    /** Description */
+    description: string;
+    /** Suggestion */
+    suggestion: string;
+    /** Code location */
+    location?: {
+        file?: string;
+        line?: number;
+    };
+}
+/**
+ * SOLID validation result
+ */
+export interface SOLIDValidationResult {
+    /** Overall score (0-100) */
+    score: number;
+    /** Score by principle */
+    principleScores: Record<SOLIDPrinciple, number>;
+    /** Violations found */
+    violations: SOLIDViolation[];
+    /** Recommendations */
+    recommendations: string[];
+    /** Summary */
+    summary: SOLIDSummary;
+}
+/**
+ * SOLID summary
+ */
+export interface SOLIDSummary {
+    /** Total classes analyzed */
+    classesAnalyzed: number;
+    /** Classes with violations */
+    classesWithViolations: number;
+    /** Total violations */
+    totalViolations: number;
+    /** Violations by principle */
+    violationsByPrinciple: Record<SOLIDPrinciple, number>;
+    /** Compliance level */
+    complianceLevel: 'excellent' | 'good' | 'moderate' | 'poor';
+}
+/**
+ * SOLID validator configuration
+ */
+export interface SOLIDValidatorConfig {
+    /** Methods threshold for SRP */
+    srpMethodThreshold: number;
+    /** Interface methods threshold for ISP */
+    ispMethodThreshold: number;
+    /** Enable strict mode */
+    strictMode: boolean;
+    /** Principles to validate */
+    enabledPrinciples: SOLIDPrinciple[];
+}
+/**
+ * Default configuration
+ */
+export declare const DEFAULT_SOLID_CONFIG: SOLIDValidatorConfig;
+/**
+ * SOLID Validator
+ */
+export declare class SOLIDValidator {
+    private config;
+    constructor(config?: Partial<SOLIDValidatorConfig>);
+    /**
+     * Validate code structure against SOLID
+     */
+    validate(structure: CodeStructure): SOLIDValidationResult;
+    /**
+     * Validate source code string
+     */
+    validateCode(code: string): SOLIDValidationResult;
+    /**
+     * Validate Single Responsibility Principle
+     */
+    private validateSRP;
+    /**
+     * Validate Open/Closed Principle
+     */
+    private validateOCP;
+    /**
+     * Validate Liskov Substitution Principle
+     */
+    private validateLSP;
+    /**
+     * Validate Interface Segregation Principle
+     */
+    private validateISP;
+    /**
+     * Validate Dependency Inversion Principle
+     */
+    private validateDIP;
+    /**
+     * Detect god class indicators
+     */
+    private detectGodClassIndicators;
+    /**
+     * Check if method name suggests type checking
+     */
+    private suggestsTypeChecking;
+    /**
+     * Build inheritance hierarchy
+     */
+    private buildHierarchy;
+    /**
+     * Group methods by purpose
+     */
+    private groupMethodsByPurpose;
+    /**
+     * Calculate score from violations
+     */
+    private calculateScore;
+    /**
+     * Generate recommendations
+     */
+    private generateRecommendations;
+    /**
+     * Generate summary
+     */
+    private generateSummary;
+    /**
+     * Parse code into structure (simplified)
+     */
+    private parseCodeStructure;
+    /**
+     * Extract methods
+     */
+    private extractMethods;
+    /**
+     * Extract properties
+     */
+    private extractProperties;
+    /**
+     * Get principle information
+     */
+    static getPrincipleInfo(principle: SOLIDPrinciple): SOLIDPrincipleInfo;
+    /**
+     * Get all principles
+     */
+    static getAllPrinciples(): SOLIDPrincipleInfo[];
+}
+/**
+ * Create SOLID validator instance
+ */
+export declare function createSOLIDValidator(config?: Partial<SOLIDValidatorConfig>): SOLIDValidator;
+//# sourceMappingURL=solid-validator.d.ts.map

package/dist/design/solid-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solid-validator.d.ts","sourceRoot":"","sources":["../../src/design/solid-validator.ts"],"names":[],"mappings":"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"}