gitx.do 0.1.0 → 0.1.2

package/dist/ops/tree-diff.d.ts

@@ -1,291 +0,0 @@
-/**
- * @fileoverview Tree Diff Operations
- *
- * This module provides functionality for comparing Git trees and detecting
- * changes between them, including added, deleted, modified, renamed, and
- * copied files.
- *
- * ## Features
- *
- * - Compare two tree objects to detect changes
- * - Detect file additions, deletions, modifications
- * - Rename detection based on content similarity
- * - Copy detection
- * - Binary file detection
- * - Path filtering with glob patterns
- * - Type change detection (file to symlink, etc.)
- *
- * ## Usage Example
- *
- * ```typescript
- * import { diffTrees, DiffStatus } from './ops/tree-diff'
- *
- * // Compare two trees
- * const result = await diffTrees(store, oldTreeSha, newTreeSha, {
- *   detectRenames: true,
- *   similarityThreshold: 50
- * })
- *
- * // Process changes
- * for (const entry of result.entries) {
- *   switch (entry.status) {
- *     case DiffStatus.ADDED:
- *       console.log(`+ ${entry.path}`)
- *       break
- *     case DiffStatus.DELETED:
- *       console.log(`- ${entry.path}`)
- *       break
- *     case DiffStatus.MODIFIED:
- *       console.log(`M ${entry.path}`)
- *       break
- *     case DiffStatus.RENAMED:
- *       console.log(`R ${entry.oldPath} -> ${entry.path}`)
- *       break
- *   }
- * }
- *
- * console.log(`Stats: ${result.stats.added} added, ${result.stats.deleted} deleted`)
- * ```
- *
- * @module ops/tree-diff
- */
-import type { TreeEntry } from '../types/objects';
-import type { TreeDiffObjectStore as ObjectStore } from '../types/storage';
-/**
- * Status of a file in a diff.
- *
- * These status codes match Git's diff status output.
- *
- * @enum {string}
- */
-export declare enum DiffStatus {
-    /** File was added */
-    ADDED = "A",
-    /** File was deleted */
-    DELETED = "D",
-    /** File was modified */
-    MODIFIED = "M",
-    /** File was renamed */
-    RENAMED = "R",
-    /** File was copied */
-    COPIED = "C",
-    /** File type changed (e.g., file to symlink) */
-    TYPE_CHANGED = "T",
-    /** Unmerged (conflict) */
-    UNMERGED = "U"
-}
-/**
- * File mode constants for Git objects
- */
-export declare enum FileMode {
-    /** Regular file (not executable) */
-    REGULAR = "100644",
-    /** Executable file */
-    EXECUTABLE = "100755",
-    /** Symbolic link */
-    SYMLINK = "120000",
-    /** Git submodule (gitlink) */
-    GITLINK = "160000",
-    /** Directory (tree) */
-    TREE = "040000"
-}
-/**
- * Represents a single entry in a diff result
- */
-export interface DiffEntry {
-    /** Path to the file (new path for renames/copies) */
-    path: string;
-    /** Status of the change */
-    status: DiffStatus;
-    /** Old file mode (null for added files) */
-    oldMode: string | null;
-    /** New file mode (null for deleted files) */
-    newMode: string | null;
-    /** Old object SHA (null for added files) */
-    oldSha: string | null;
-    /** New object SHA (null for deleted files) */
-    newSha: string | null;
-    /** Original path (for renames/copies) */
-    oldPath?: string;
-    /** Similarity percentage (for renames/copies, 0-100) */
-    similarity?: number;
-    /** Whether the file is binary */
-    isBinary?: boolean;
-}
-/**
- * Options for tree diff operations
- */
-export interface DiffOptions {
-    /** Enable rename detection (default: true) */
-    detectRenames?: boolean;
-    /** Enable copy detection (default: false) */
-    detectCopies?: boolean;
-    /** Similarity threshold for rename/copy detection (0-100, default: 50) */
-    similarityThreshold?: number;
-    /** Filter paths by glob patterns (include) */
-    pathspecs?: string[];
-    /** Paths to exclude */
-    excludePaths?: string[];
-    /** Include binary file detection (default: true) */
-    detectBinary?: boolean;
-    /** Maximum file size to consider for rename/copy detection */
-    maxRenameSize?: number;
-    /** Whether to recurse into subdirectories (default: true) */
-    recursive?: boolean;
-    /** Only show names, not full diff info */
-    nameOnly?: boolean;
-    /** Show only file status, not diff content */
-    nameStatus?: boolean;
-}
-/**
- * Result of a tree diff operation
- */
-export interface DiffResult {
-    /** List of diff entries */
-    entries: DiffEntry[];
-    /** Statistics about the diff */
-    stats: {
-        added: number;
-        deleted: number;
-        modified: number;
-        renamed: number;
-        copied: number;
-    };
-}
-/**
- * ObjectStore interface for tree diff operations.
- * Re-exported from storage types for convenience.
- */
-export type { ObjectStore };
-/**
- * Represents an index entry for diff-to-index operations
- */
-export interface IndexEntry {
-    path: string;
-    mode: string;
-    sha: string;
-    /** Stage number (0 = normal, 1-3 = merge conflict stages) */
-    stage: number;
-    /** File modification time */
-    mtime?: number;
-    /** File size */
-    size?: number;
-}
-/**
- * Check if a file appears to be binary based on its content
- *
- * A file is considered binary if it contains null bytes in the first
- * 8000 bytes (similar to Git's heuristic).
- *
- * @param content - File content to check
- * @returns true if the file appears to be binary
- */
-export declare function isBinaryContent(content: Uint8Array): boolean;
-/**
- * Calculate similarity between two blobs for rename/copy detection
- *
- * Uses a simple heuristic based on shared content.
- *
- * @param store - Object store for retrieving blob contents
- * @param oldSha - SHA of the old blob
- * @param newSha - SHA of the new blob
- * @returns Promise resolving to similarity percentage (0-100)
- */
-export declare function calculateSimilarity(store: ObjectStore, oldSha: string, newSha: string): Promise<number>;
-/**
- * Parse a file mode string and determine its type
- *
- * @param mode - File mode string (e.g., '100644', '040000')
- * @returns Object with mode information
- */
-export declare function parseMode(mode: string): {
-    isFile: boolean;
-    isDirectory: boolean;
-    isSymlink: boolean;
-    isSubmodule: boolean;
-    isExecutable: boolean;
-};
-/**
- * Check if a mode change represents a significant type change
- *
- * @param oldMode - Old file mode
- * @param newMode - New file mode
- * @returns true if the mode change is significant (e.g., file to symlink)
- */
-export declare function isModeChangeSignificant(oldMode: string, newMode: string): boolean;
-/**
- * Filter diff entries by pathspecs
- *
- * @param entries - Diff entries to filter
- * @param pathspecs - Glob patterns to include
- * @param excludePaths - Paths to exclude
- * @returns Filtered entries
- */
-export declare function filterByPathspecs(entries: DiffEntry[], pathspecs?: string[], excludePaths?: string[]): DiffEntry[];
-/**
- * Recursively walk a tree and collect all entries with full paths
- *
- * @param store - Object store for retrieving tree contents
- * @param treeSha - SHA of the tree to walk
- * @param prefix - Path prefix for entries
- * @returns Promise resolving to flat list of entries with full paths
- */
-export declare function walkTree(store: ObjectStore, treeSha: string, prefix?: string): Promise<Array<TreeEntry & {
-    fullPath: string;
-}>>;
-/**
- * Compare two trees and return the differences
- *
- * @param store - Object store for retrieving tree contents
- * @param oldTreeSha - SHA of the old tree (null for initial commit comparison)
- * @param newTreeSha - SHA of the new tree (null to compare against empty)
- * @param options - Diff options
- * @returns Promise resolving to diff result
- */
-export declare function diffTrees(store: ObjectStore, oldTreeSha: string | null, newTreeSha: string | null, options?: DiffOptions): Promise<DiffResult>;
-/**
- * Detect renames in a set of diff entries
- *
- * This function takes a list of added and deleted files and attempts to
- * match them based on content similarity to detect renames.
- *
- * @param store - Object store for retrieving blob contents
- * @param entries - Initial diff entries (before rename detection)
- * @param options - Diff options (particularly similarityThreshold)
- * @returns Promise resolving to entries with renames detected
- */
-export declare function detectRenames(store: ObjectStore, entries: DiffEntry[], options?: DiffOptions): Promise<DiffEntry[]>;
-/**
- * Detect copies in a set of diff entries
- *
- * This function takes a list of diff entries and attempts to detect
- * if any added files are copies of existing files.
- *
- * @param store - Object store for retrieving blob contents
- * @param entries - Initial diff entries
- * @param existingPaths - Map of existing paths to their SHAs
- * @param options - Diff options
- * @returns Promise resolving to entries with copies detected
- */
-export declare function detectCopies(store: ObjectStore, entries: DiffEntry[], existingPaths: Map<string, string>, options?: DiffOptions): Promise<DiffEntry[]>;
-/**
- * Compare a tree to the index (staging area)
- *
- * @param store - Object store for retrieving tree contents
- * @param treeSha - SHA of the tree to compare (typically HEAD)
- * @param index - Index entries to compare against
- * @param options - Diff options
- * @returns Promise resolving to diff result
- */
-export declare function diffTreeToIndex(store: ObjectStore, treeSha: string | null, index: IndexEntry[], options?: DiffOptions): Promise<DiffResult>;
-/**
- * Compare a tree to working directory entries
- *
- * @param store - Object store for retrieving tree contents
- * @param treeSha - SHA of the tree to compare
- * @param workingEntries - Working directory file entries
- * @param options - Diff options
- * @returns Promise resolving to diff result
- */
-export declare function diffTreeToWorktree(store: ObjectStore, treeSha: string | null, workingEntries: IndexEntry[], options?: DiffOptions): Promise<DiffResult>;
-//# sourceMappingURL=tree-diff.d.ts.map

package/dist/ops/tree-diff.d.ts.map

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