@yuaone/core 0.1.0

package/dist/cross-file-refactor.d.ts

@@ -0,0 +1,352 @@
+/**
+ * @module cross-file-refactor
+ * @description Cross-File Refactoring Engine — enables safe renaming, moving, extracting,
+ * and inlining symbols across multiple TypeScript/JavaScript files.
+ *
+ * Provides preview (dry-run) mode, rollback support, and safety checks (breaking change
+ * detection, risk assessment). Uses regex-based analysis consistent with the rest of yuan-core.
+ */
+/** Supported refactoring operations. */
+export type RefactorType = "rename" | "move" | "extract_function" | "extract_interface" | "inline" | "change_signature";
+/** A request describing the desired refactoring operation. */
+export interface RefactorRequest {
+    /** Refactoring type */
+    type: RefactorType;
+    /** Symbol to rename (for rename/move/inline/change_signature) */
+    symbolName?: string;
+    /** New name (for rename) */
+    newName?: string;
+    /** Scope to a specific file (optional, for rename) */
+    file?: string;
+    /** Destination file path (for move) */
+    targetFile?: string;
+    /** Source file path (for extract/move/inline/change_signature) */
+    sourceFile?: string;
+    /** Start line for extraction (1-based) */
+    startLine?: number;
+    /** End line for extraction (1-based) */
+    endLine?: number;
+    /** Name for the extracted symbol */
+    extractedName?: string;
+    /** New parameter list (for change_signature) */
+    newParams?: {
+        name: string;
+        type: string;
+        optional?: boolean;
+    }[];
+    /** New return type (for change_signature) */
+    newReturnType?: string;
+    /** Whether to add a re-export in the source file (for move) */
+    addReExport?: boolean;
+}
+/** Preview of a refactoring, before it is applied. */
+export interface RefactorPreview {
+    /** Refactoring type */
+    type: RefactorType;
+    /** Files that will be changed */
+    affectedFiles: FileChange[];
+    /** Total number of individual text changes */
+    totalChanges: number;
+    /** Breaking changes detected */
+    breakingChanges: BreakingChange[];
+    /** Risk level */
+    riskLevel: "low" | "medium" | "high";
+    /** Warnings for the developer */
+    warnings: string[];
+    /** Whether this can be automatically applied */
+    canAutoApply: boolean;
+}
+/** Changes to a single file. */
+export interface FileChange {
+    /** Absolute file path */
+    file: string;
+    /** Individual text changes within the file */
+    changes: TextChange[];
+    /** Whether this is a newly created file */
+    isNewFile: boolean;
+    /** Whether this file will be deleted */
+    isDeletedFile: boolean;
+}
+/** A single text replacement within a file. */
+export interface TextChange {
+    /** Start line (1-based) */
+    startLine: number;
+    /** End line (1-based, inclusive) */
+    endLine: number;
+    /** Original text */
+    oldText: string;
+    /** Replacement text */
+    newText: string;
+    /** Human-readable reason for the change */
+    reason: string;
+}
+/** A breaking change detected during preview. */
+export interface BreakingChange {
+    /** Type of breaking change */
+    type: "api_change" | "export_removed" | "signature_change" | "type_change";
+    /** Human-readable description */
+    description: string;
+    /** File where the break occurs */
+    file: string;
+    /** Line number */
+    line: number;
+    /** Severity */
+    severity: "warning" | "error";
+}
+/** Result of applying a refactoring. */
+export interface RefactorResult {
+    /** Whether the refactoring was fully applied */
+    success: boolean;
+    /** Changes that were successfully applied */
+    appliedChanges: FileChange[];
+    /** Changes that failed */
+    failedChanges: {
+        file: string;
+        error: string;
+    }[];
+    /** Whether rollback is available */
+    rollbackAvailable: boolean;
+    /** ID to pass to rollback() */
+    rollbackId: string;
+}
+/** Safety analysis before and after a refactoring. */
+export interface RefactorSafety {
+    /** Pre-application checks */
+    preCheck: {
+        affectedFiles: string[];
+        breakingChanges: BreakingChange[];
+        riskLevel: "low" | "medium" | "high";
+    };
+    /** Post-application checks */
+    postCheck: {
+        buildSuccess: boolean;
+        noNewErrors: boolean;
+    };
+}
+/**
+ * Cross-File Refactoring Engine.
+ *
+ * Enables safe renaming, moving, extracting, and inlining of symbols
+ * across TypeScript/JavaScript projects. Supports preview (dry-run),
+ * rollback, and breaking change detection.
+ *
+ * @example
+ * ```ts
+ * const refactor = new CrossFileRefactor("/path/to/project");
+ * const preview = await refactor.renameSymbol("OldName", "NewName");
+ * if (preview.riskLevel !== "high") {
+ *   const result = await refactor.apply({ type: "rename", symbolName: "OldName", newName: "NewName" });
+ * }
+ * ```
+ */
+export declare class CrossFileRefactor {
+    private projectPath;
+    private rollbacks;
+    private rollbackOrder;
+    constructor(projectPath: string);
+    /**
+     * Generate a preview of the refactoring without making changes.
+     *
+     * @param request - The refactoring request
+     * @returns Preview with affected files, breaking changes, and risk assessment
+     */
+    preview(request: RefactorRequest): Promise<RefactorPreview>;
+    /**
+     * Apply a refactoring to disk. Snapshots all affected files first
+     * so the operation can be rolled back.
+     *
+     * @param request - The refactoring request
+     * @returns Result including applied changes and rollback ID
+     */
+    apply(request: RefactorRequest): Promise<RefactorResult>;
+    /**
+     * Roll back a previously applied refactoring by restoring original file contents.
+     *
+     * @param rollbackId - The rollback ID returned by apply()
+     * @returns True if rollback was successful
+     */
+    rollback(rollbackId: string): Promise<boolean>;
+    /**
+     * Rename a symbol across all files that reference it.
+     * Updates the definition, all usages, and all import statements.
+     *
+     * @param symbolName - Current symbol name
+     * @param newName - Desired new name
+     * @param scopeFile - Optional file to restrict the rename to
+     * @returns Preview of all changes
+     */
+    renameSymbol(symbolName: string, newName: string, scopeFile?: string): Promise<RefactorPreview>;
+    /**
+     * Move a symbol from one file to another. Updates all import statements
+     * across the project and optionally adds a re-export for backward compatibility.
+     *
+     * @param symbolName - Symbol to move
+     * @param sourceFile - Current file (absolute path)
+     * @param targetFile - Destination file (absolute path)
+     * @param addReExport - Whether to add a re-export in the source file
+     * @returns Preview of all changes
+     */
+    moveSymbol(symbolName: string, sourceFile: string, targetFile: string, addReExport?: boolean): Promise<RefactorPreview>;
+    /**
+     * Extract a range of lines into a new function. Infers parameters from
+     * variables used but defined outside the selection, and return values from
+     * variables modified inside the selection.
+     *
+     * @param sourceFile - File containing the code to extract
+     * @param startLine - First line to extract (1-based)
+     * @param endLine - Last line to extract (1-based, inclusive)
+     * @param functionName - Name for the new function
+     * @param targetFile - File to place the function in (same file if omitted)
+     * @returns Preview of all changes
+     */
+    extractFunction(sourceFile: string, startLine: number, endLine: number, functionName: string, targetFile?: string): Promise<RefactorPreview>;
+    /**
+     * Extract an interface from a class's public members.
+     *
+     * @param className - Class to extract from
+     * @param interfaceName - Name for the new interface
+     * @param sourceFile - File containing the class
+     * @returns Preview of all changes
+     */
+    extractInterface(className: string, interfaceName: string, sourceFile: string): Promise<RefactorPreview>;
+    /**
+     * Inline a simple function at all call sites (replace calls with the function body).
+     * Only works for simple single-expression or single-statement functions.
+     *
+     * @param functionName - Function to inline
+     * @param sourceFile - File where the function is defined
+     * @returns Preview of all changes
+     */
+    inlineFunction(functionName: string, sourceFile: string): Promise<RefactorPreview>;
+    /**
+     * Change a function's parameter list and/or return type. Updates the definition
+     * and all call sites.
+     *
+     * @param functionName - Function to modify
+     * @param sourceFile - File where the function is defined
+     * @param newParams - New parameter list
+     * @param newReturnType - New return type (optional)
+     * @returns Preview of all changes
+     */
+    changeSignature(functionName: string, sourceFile: string, newParams: {
+        name: string;
+        type: string;
+        optional?: boolean;
+    }[], newReturnType?: string): Promise<RefactorPreview>;
+    /**
+     * Perform safety analysis on a refactoring preview.
+     * Returns pre-check info and placeholder post-check (build verification
+     * must be run separately after apply).
+     *
+     * @param preview - The refactoring preview to analyze
+     * @returns Safety analysis result
+     */
+    checkSafety(preview: RefactorPreview): Promise<RefactorSafety>;
+    /**
+     * Find all usages of a symbol across the project using regex word boundary matching.
+     * Excludes occurrences inside comments and string literals.
+     */
+    private findAllUsages;
+    /**
+     * Find all import statements that reference a symbol.
+     */
+    private findImports;
+    /**
+     * Generate import path updates when a symbol moves between files.
+     */
+    private generateImportUpdates;
+    /**
+     * Check if a symbol is exported from any file.
+     */
+    private isSymbolExported;
+    /**
+     * Extract a symbol's full definition (with JSDoc) from file content.
+     */
+    private extractDefinition;
+    /**
+     * Find the end line of a definition by tracking brace depth.
+     * For single-line type aliases or simple declarations, returns the same line.
+     */
+    private findDefinitionEnd;
+    /**
+     * Extract public members from a class definition.
+     */
+    private extractClassMembers;
+    /**
+     * Extract a function's body and metadata for inlining.
+     */
+    private extractFunctionBody;
+    /**
+     * Infer function parameters from a code block by finding variables
+     * that are used but not defined within the selection.
+     */
+    private inferParameters;
+    /**
+     * Infer return values: variables modified inside the selection that are
+     * used after the selection.
+     */
+    private inferReturnValues;
+    /**
+     * Read a file's content as UTF-8 text.
+     */
+    private readFile;
+    /**
+     * Apply text changes to file content. Changes are applied in reverse line order
+     * to preserve line numbers.
+     */
+    private applyChanges;
+    /**
+     * Snapshot files for potential rollback. Returns a unique rollback ID.
+     * Maintains a maximum of MAX_ROLLBACKS snapshots.
+     */
+    private snapshotFiles;
+    /**
+     * Recursively collect all TypeScript/JavaScript source files in a directory.
+     */
+    private collectSourceFiles;
+    /**
+     * Replace a symbol name in a line using word boundary matching.
+     * Preserves string literals and comments.
+     */
+    private replaceSymbolInLine;
+    /**
+     * Check if a line is a comment (single-line // or starts inside a block comment).
+     */
+    private isCommentLine;
+    /**
+     * Basic heuristic: check if a symbol occurrence is inside a string literal.
+     * Counts unescaped quotes before the symbol position.
+     */
+    private isInStringLiteral;
+    /**
+     * Compute the relative import path from one file to another,
+     * with .js extension (ESM convention).
+     */
+    private computeRelativeImportPath;
+    /**
+     * Find the best line to insert a new import statement.
+     * Returns the line number (1-based) after the last existing import.
+     */
+    private findImportInsertLine;
+    /**
+     * Detect the leading whitespace (indentation) of a line.
+     */
+    private detectIndent;
+    /**
+     * Escape special regex characters in a string.
+     */
+    private escapeRegex;
+    /**
+     * Deduplicate text changes for the same line, keeping only the last one.
+     */
+    private deduplicateChanges;
+    /**
+     * Assess the risk level of a refactoring based on scope and breaking changes.
+     */
+    private assessRisk;
+    /**
+     * Create an empty preview with warnings (for error cases).
+     */
+    private emptyPreview;
+}
+//# sourceMappingURL=cross-file-refactor.d.ts.map

package/dist/cross-file-refactor.d.ts.map

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