driftdetect-core 0.1.0

package/dist/rules/quick-fix-generator.d.ts

@@ -0,0 +1,334 @@
+/**
+ * Quick Fix Generator - Code transformation generation for violations
+ *
+ * Generates code transformations (quick fixes) for pattern violations.
+ * Supports multiple fix types: replace, wrap, extract, import, rename, move, delete.
+ * Provides preview of changes before applying.
+ *
+ * @requirements 25.1 - THE Quick_Fix_System SHALL generate code transformations for fixable violations
+ * @requirements 25.2 - THE Quick_Fix SHALL include a preview of the change before applying
+ * @requirements 25.3 - THE Quick_Fix SHALL support fix types: replace, wrap, extract, import, rename, move, delete
+ * @requirements 25.4 - WHEN multiple fixes are available, THE Quick_Fix_System SHALL rank by confidence
+ * @requirements 25.5 - THE Quick_Fix_System SHALL mark the preferred fix for one-click application
+ */
+import type { Violation, QuickFix, QuickFixWithMetadata, FixType, FixImpact } from './types.js';
+/**
+ * Configuration options for the QuickFixGenerator
+ */
+export interface QuickFixGeneratorConfig {
+    /** Minimum confidence threshold for generating fixes */
+    minConfidence?: number;
+    /** Maximum number of fixes to generate per violation */
+    maxFixesPerViolation?: number;
+    /** Whether to generate previews for fixes */
+    generatePreviews?: boolean;
+    /** Whether to validate fixes before returning */
+    validateFixes?: boolean;
+}
+/**
+ * Default QuickFixGenerator configuration
+ */
+export declare const DEFAULT_QUICK_FIX_GENERATOR_CONFIG: Required<QuickFixGeneratorConfig>;
+/**
+ * Strategy for generating a specific type of fix
+ */
+export interface FixStrategy {
+    /** Type of fix this strategy generates */
+    type: FixType;
+    /** Generate a fix for a violation */
+    generate(context: FixContext): QuickFix | null;
+    /** Check if this strategy can handle the violation */
+    canHandle(violation: Violation): boolean;
+    /** Get the confidence score for this fix */
+    getConfidence(context: FixContext): number;
+}
+/**
+ * Context for generating a fix
+ */
+export interface FixContext {
+    /** The violation to fix */
+    violation: Violation;
+    /** File content */
+    content: string;
+    /** Expected code/pattern */
+    expected: string;
+    /** Actual code found */
+    actual: string;
+    /** Additional context for the fix */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of generating fixes for a violation
+ */
+export interface FixGenerationResult {
+    /** Violation ID */
+    violationId: string;
+    /** Generated fixes (sorted by confidence) */
+    fixes: QuickFixWithMetadata[];
+    /** Whether any fixes were generated */
+    hasFixs: boolean;
+    /** The preferred fix (highest confidence) */
+    preferredFix?: QuickFixWithMetadata;
+    /** Errors encountered during generation */
+    errors: string[];
+}
+/**
+ * Strategy for generating replace fixes
+ * Replaces text at a specific range with new text
+ */
+export declare class ReplaceFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private truncateText;
+    private generatePreview;
+}
+/**
+ * Strategy for generating wrap fixes
+ * Wraps code with additional structure (e.g., try/catch, function wrapper)
+ */
+export declare class WrapFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private extractCode;
+    private determineWrapType;
+    private wrapCode;
+    private detectIndent;
+}
+/**
+ * Strategy for generating extract fixes
+ * Extracts code into a new location (e.g., extract function, extract variable)
+ */
+export declare class ExtractFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private extractCode;
+    private generateExtractedName;
+    private createExtraction;
+}
+/**
+ * Strategy for generating import fixes
+ * Adds import statements for missing dependencies
+ */
+export declare class ImportFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private generateImportStatement;
+    private truncateText;
+}
+/**
+ * Strategy for generating rename fixes
+ * Renames symbols to match naming conventions
+ */
+export declare class RenameFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private generateNewName;
+    private toCamelCase;
+    private toPascalCase;
+    private toSnakeCase;
+    private toKebabCase;
+}
+/**
+ * Strategy for generating move fixes
+ * Moves code to a different location (e.g., different file, different position)
+ */
+export declare class MoveFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+    private extractCode;
+    private determineTargetLocation;
+}
+/**
+ * Strategy for generating delete fixes
+ * Deletes code that should be removed
+ */
+export declare class DeleteFixStrategy implements FixStrategy {
+    readonly type: FixType;
+    canHandle(violation: Violation): boolean;
+    getConfidence(_context: FixContext): number;
+    generate(context: FixContext): QuickFix | null;
+}
+/**
+ * QuickFixGenerator class for generating code transformations for violations.
+ *
+ * The generator:
+ * - Takes violations and generates appropriate quick fixes
+ * - Supports multiple fix types: replace, wrap, extract, import, rename, move, delete
+ * - Ranks fixes by confidence and marks preferred fix
+ * - Provides preview of changes before applying
+ *
+ * @requirements 25.1 - Generate code transformations for fixable violations
+ * @requirements 25.3 - Support fix types: replace, wrap, extract, import, rename, move, delete
+ * @requirements 25.4 - Rank fixes by confidence
+ * @requirements 25.5 - Mark preferred fix for one-click application
+ */
+export declare class QuickFixGenerator {
+    private config;
+    private strategies;
+    private fixIdCounter;
+    /**
+     * Create a new QuickFixGenerator instance.
+     *
+     * @param config - Optional configuration options
+     */
+    constructor(config?: QuickFixGeneratorConfig);
+    /**
+     * Generate quick fixes for a violation.
+     *
+     * @param violation - The violation to generate fixes for
+     * @param content - The file content
+     * @returns Fix generation result with ranked fixes
+     *
+     * @requirements 25.1 - Generate code transformations
+     * @requirements 25.4 - Rank by confidence
+     */
+    generateFixes(violation: Violation, content: string): FixGenerationResult;
+    /**
+     * Generate quick fixes for multiple violations.
+     *
+     * @param violations - Array of violations
+     * @param content - The file content
+     * @returns Array of fix generation results
+     */
+    generateFixesForAll(violations: Violation[], content: string): FixGenerationResult[];
+    /**
+     * Generate a specific type of fix for a violation.
+     *
+     * @param violation - The violation to fix
+     * @param content - The file content
+     * @param fixType - The type of fix to generate
+     * @returns The generated fix or null if not applicable
+     */
+    generateFixOfType(violation: Violation, content: string, fixType: FixType): QuickFix | null;
+    /**
+     * Generate a preview of a fix before applying.
+     *
+     * @param fix - The quick fix to preview
+     * @param content - The original file content
+     * @returns Preview string showing the change
+     *
+     * @requirements 25.2 - Include preview of change before applying
+     */
+    generatePreview(fix: QuickFix, content: string): string;
+    /**
+     * Apply a fix to content and return the result.
+     *
+     * This method is idempotent: applying the same fix twice will result in
+     * no additional changes after the first application.
+     *
+     * @param fix - The quick fix to apply
+     * @param content - The original file content
+     * @returns The modified content after applying the fix
+     *
+     * @requirements 25.1 - Generate code transformations for fixable violations
+     */
+    applyFix(fix: QuickFix, content: string): string;
+    /**
+     * Extract text from a position for a given length.
+     * Used for idempotence checking.
+     */
+    private extractTextFromPosition;
+    /**
+     * Check if a fix is idempotent (applying twice has no additional effect).
+     *
+     * A fix is idempotent if after applying it once, the content at the
+     * fix's range already matches the newText, so applying again has no effect.
+     *
+     * @param fix - The quick fix to check
+     * @param content - The original file content
+     * @returns True if the fix is idempotent
+     */
+    isIdempotent(fix: QuickFix, content: string): boolean;
+    /**
+     * Validate a fix before applying.
+     *
+     * @param fix - The quick fix to validate
+     * @param content - The file content
+     * @returns Validation result with any errors
+     */
+    validateFix(fix: QuickFix, content: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Get available fix types for a violation.
+     *
+     * @param violation - The violation to check
+     * @returns Array of fix types that can handle this violation
+     */
+    getAvailableFixTypes(violation: Violation): FixType[];
+    /**
+     * Register a custom fix strategy.
+     *
+     * @param strategy - The fix strategy to register
+     */
+    registerStrategy(strategy: FixStrategy): void;
+    /**
+     * Get all registered fix strategies.
+     *
+     * @returns Array of registered strategies
+     */
+    getStrategies(): FixStrategy[];
+    /**
+     * Calculate the impact of a fix.
+     *
+     * @param fix - The quick fix to assess
+     * @param content - The file content
+     * @returns Impact assessment
+     */
+    calculateImpact(fix: QuickFix, content: string): FixImpact;
+    /**
+     * Add metadata to a quick fix.
+     */
+    private addMetadata;
+    /**
+     * Extract text from a range in content.
+     */
+    private extractTextFromRange;
+    /**
+     * Apply a text edit to content.
+     */
+    private applyTextEdit;
+    /**
+     * Check if a fix might be breaking.
+     */
+    private mightBeBreaking;
+}
+/**
+ * Create a QuickFixGenerator with default configuration.
+ *
+ * @returns New QuickFixGenerator instance
+ */
+export declare function createQuickFixGenerator(): QuickFixGenerator;
+/**
+ * Create a QuickFixGenerator with custom configuration.
+ *
+ * @param config - Configuration options
+ * @returns New QuickFixGenerator instance
+ */
+export declare function createQuickFixGeneratorWithConfig(config: QuickFixGeneratorConfig): QuickFixGenerator;
+/**
+ * Create a QuickFixGenerator with high confidence threshold.
+ *
+ * @returns New QuickFixGenerator instance with high confidence threshold
+ */
+export declare function createHighConfidenceQuickFixGenerator(): QuickFixGenerator;
+/**
+ * Create a QuickFixGenerator with all fixes enabled.
+ *
+ * @returns New QuickFixGenerator instance with all fixes
+ */
+export declare function createFullQuickFixGenerator(): QuickFixGenerator;
+//# sourceMappingURL=quick-fix-generator.d.ts.map

package/dist/rules/quick-fix-generator.d.ts.map

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