@compass-ai/nova 1.0.74 → 1.0.76

package/dist/utils/diff.d.ts

@@ -1,311 +0,0 @@
-/**
- * Diff generation utilities using the diff library
- *
- * This module provides utilities for generating, colorizing, and analyzing
- * differences between file contents. It wraps the 'diff' library to provide
- * a clean API for creating unified diffs, word-level diffs, and change summaries.
- *
- * Features:
- * - Unified diff generation with configurable context
- * - Syntax highlighting for terminal display
- * - Change statistics (additions, deletions)
- * - Word-level diff for granular changes
- * - Patch application support
- */
-import * as Diff from 'diff';
-/**
- * Represents the result of a diff operation
- */
-export interface DiffResult {
-    /** The unified diff string in standard patch format */
-    unified: string;
-    /** Number of lines added */
-    additions: number;
-    /** Number of lines removed */
-    deletions: number;
-    /** Array of individual changes */
-    changes: DiffChange[];
-}
-/**
- * Represents a single change in a diff
- */
-export interface DiffChange {
-    /** Type of change: add, remove, or unchanged */
-    type: 'add' | 'remove' | 'unchanged';
-    /** The content of the change */
-    value: string;
-    /** Line number where the change occurs (if applicable) */
-    lineNumber?: number;
-    /** Number of lines affected by this change */
-    count?: number;
-}
-/**
- * Options for diff generation
- */
-export interface DiffOptions {
-    /** Name of the file being diffed (for header) */
-    fileName?: string;
-    /** Number of context lines to include around changes (default: 3) */
-    context?: number;
-    /** Label for the old version (default: 'original') */
-    oldHeader?: string;
-    /** Label for the new version (default: 'modified') */
-    newHeader?: string;
-    /** Whether to ignore leading/trailing whitespace */
-    ignoreWhitespace?: boolean;
-}
-export declare function generateDiff(oldContent: string, newContent: string, options?: DiffOptions): DiffResult;
-/**
- * Colorizes a unified diff for terminal display
- *
- * Applies ANSI color codes to a unified diff string for better
- * readability in terminal output.
- *
- * Color scheme:
- * - File headers (+++/---): Bold
- * - Hunk headers (@@): Cyan
- * - Additions (+): Green
- * - Deletions (-): Red
- * - Context lines: Gray/dim
- *
- * @param diff - The unified diff string to colorize
- * @returns The colorized diff string with ANSI codes
- *
- * @example
- * ```typescript
- * const coloredDiff = colorizeDiff(diffResult.unified);
- * console.log(coloredDiff);
- * ```
- */
-export declare function colorizeDiff(diff: string): string;
-/**
- * Generates a human-readable summary of changes
- *
- * Creates a concise summary string showing the number of additions
- * and deletions in a diff result.
- *
- * @param diff - The DiffResult to summarize
- * @returns A formatted summary string
- *
- * @example
- * ```typescript
- * const summary = generateDiffSummary(diffResult);
- * // Output: "+5 additions, -3 removed"
- * ```
- */
-export declare function generateDiffSummary(diff: DiffResult): string;
-/**
- * Generates a word-level diff for more granular change visualization
- *
- * Unlike line-level diffs, this shows exactly which words changed
- * within lines, useful for reviewing small edits.
- *
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @returns A string with inline highlighting of word changes
- *
- * @example
- * ```typescript
- * const wordDiff = generateWordDiff(
- *   'The quick brown fox',
- *   'The slow brown dog'
- * );
- * // Shows 'quick' removed, 'slow' added, 'fox' removed, 'dog' added
- * ```
- */
-export declare function generateWordDiff(oldContent: string, newContent: string): string;
-/**
- * Generates a character-level diff for very granular changes
- *
- * Shows exactly which characters changed, useful for reviewing
- * typo fixes or small edits.
- *
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @returns A string with inline highlighting of character changes
- */
-export declare function generateCharDiff(oldContent: string, newContent: string): string;
-/**
- * Checks if two strings are identical
- *
- * A simple utility to quickly check if there are any differences
- * between two strings without generating a full diff.
- *
- * @param a - First string to compare
- * @param b - Second string to compare
- * @returns True if the strings are identical, false otherwise
- */
-export declare function areIdentical(a: string, b: string): boolean;
-/**
- * Gets the number of changed lines between two strings
- *
- * A quick way to get the total number of lines affected by changes
- * without generating a full diff result.
- *
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @returns The total number of lines added or removed
- */
-export declare function getChangedLineCount(oldContent: string, newContent: string): number;
-/**
- * Applies a unified patch to content
- *
- * Takes a unified diff patch and applies it to the original content
- * to produce the modified content.
- *
- * @param content - The original content to patch
- * @param patch - The unified diff patch to apply
- * @returns The patched content, or false if the patch failed to apply
- *
- * @example
- * ```typescript
- * const patched = applyPatch(originalContent, patchString);
- * if (patched === false) {
- *   console.error('Patch failed to apply');
- * }
- * ```
- */
-export declare function applyPatch(content: string, patch: string): string | false;
-/**
- * Creates a structured patch that can be applied later
- *
- * Generates a patch object that contains all the information needed
- * to transform the old content into the new content.
- *
- * @param fileName - Name of the file being patched
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @param options - Additional options for patch creation
- * @returns A structured patch string
- */
-export declare function createStructuredPatch(fileName: string, oldContent: string, newContent: string, options?: {
-    oldHeader?: string;
-    newHeader?: string;
-    context?: number;
-}): string;
-/**
- * Parses a unified diff into structured hunks
- *
- * Breaks down a unified diff into individual hunks that can be
- * processed or displayed separately.
- *
- * @param patch - The unified diff patch to parse
- * @returns Array of parsed patch objects
- */
-export declare function parsePatch(patch: string): Diff.ParsedDiff[];
-/**
- * Generates a two-column side-by-side diff
- *
- * Creates a representation suitable for side-by-side display
- * of old and new content.
- *
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @returns Array of line pairs for side-by-side display
- */
-export declare function generateSideBySideDiff(oldContent: string, newContent: string): Array<{
-    left: string | null;
-    right: string | null;
-    type: 'add' | 'remove' | 'unchanged';
-}>;
-/**
- * Calculates similarity percentage between two strings
- *
- * Uses the diff to calculate how similar two strings are,
- * returning a percentage from 0 (completely different) to 100 (identical).
- *
- * @param oldContent - The original content
- * @param newContent - The new/modified content
- * @returns Similarity percentage (0-100)
- */
-export declare function calculateSimilarity(oldContent: string, newContent: string): number;
-/**
- * Formats a diff for compact display
- *
- * Creates a condensed version of the diff suitable for
- * limited display space.
- *
- * @param diff - The DiffResult to format
- * @param maxLines - Maximum number of lines to show (default: 10)
- * @returns Formatted compact diff string
- */
-export declare function formatCompactDiff(diff: DiffResult, maxLines?: number): string;
-/**
- * Represents a single change block in a compact diff
- */
-export interface CompactChangeBlock {
-    /** Starting line number in the original file */
-    lineStart: number;
-    /** Ending line number in the original file */
-    lineEnd: number;
-    /** Lines before the change (with line numbers) */
-    before: string[];
-    /** Lines after the change (with line numbers) */
-    after: string[];
-}
-/**
- * Context information for a compact edit response
- */
-export interface CompactEditContext {
-    /** Total lines in the modified file */
-    totalLines: number;
-    /** Array of line numbers that were edited */
-    editedLines: number[];
-    /** Detected scope/function names affected by the changes */
-    scopesAffected: string[];
-}
-/**
- * Compact edit response format for token-efficient LLM responses
- */
-export interface CompactEditResponse {
-    /** File path that was edited */
-    path: string;
-    /** Whether the edit was successful */
-    success: boolean;
-    /** Context information about the edit */
-    context: CompactEditContext;
-    /** Array of change blocks showing before/after with context */
-    changes: CompactChangeBlock[];
-    /** Number of lines added */
-    additions: number;
-    /** Number of lines deleted */
-    deletions: number;
-}
-/**
- * Detects function, class, or method names that contain a given line
- *
- * Searches backwards from the given line to find the nearest scope declaration.
- * Supports common patterns in JavaScript, TypeScript, Python, Go, Rust, Java, etc.
- *
- * @param lines - Array of file lines
- * @param lineNumber - The line number to find the scope for (1-indexed)
- * @returns The name of the containing scope, or undefined if not found
- */
-export declare function detectContainingScope(lines: string[], lineNumber: number): string | undefined;
-/**
- * Generates a compact edit response from old and new content
- *
- * Creates a token-efficient representation of file changes that includes:
- * - Line numbers and context around changes
- * - Affected scope detection (function/class names)
- * - Before/after comparison blocks
- *
- * @param oldContent - The original file content
- * @param newContent - The modified file content
- * @param filePath - Path to the file being edited
- * @param contextLines - Number of context lines to include around changes (default: 2)
- * @returns A CompactEditResponse with structured change information
- *
- * @example
- * ```typescript
- * const response = generateCompactEditResponse(
- *   oldContent,
- *   newContent,
- *   'src/components/Button.tsx',
- *   2
- * );
- * // Returns structured response with ~500 chars instead of ~8K
- * ```
- */
-export declare function generateCompactEditResponse(oldContent: string, newContent: string, filePath: string, contextLines?: number): CompactEditResponse;
-//# sourceMappingURL=diff.d.ts.map

package/dist/utils/diff.d.ts.map

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