@compass-ai/nova 1.0.72 → 1.0.74

package/dist/utils/diff.d.ts

@@ -0,0 +1,311 @@
+/**
+ * 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

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