oh-my-node-modules 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,562 @@
+/**
+ * Core type definitions for oh-my-node-modules
+ *
+ * These types represent the domain model for node_modules analysis.
+ * Each interface answers a specific question about the data structure.
+ */
+/**
+ * Represents a discovered node_modules directory with all relevant metadata.
+ * This is the core data structure that flows through the entire application.
+ */
+interface NodeModulesInfo {
+    /** Absolute path to the node_modules directory */
+    path: string;
+    /** Absolute path to the parent project directory (containing package.json) */
+    projectPath: string;
+    /** Project name from package.json, or directory name if no package.json */
+    projectName: string;
+    /** Project version from package.json, or undefined if not available */
+    projectVersion?: string;
+    /** Total size in bytes (recursive, includes all nested files) */
+    sizeBytes: number;
+    /** Human-readable size string (e.g., "1.2 GB", "456 MB") */
+    sizeFormatted: string;
+    /** Number of packages directly in node_modules (top-level) */
+    packageCount: number;
+    /** Total number of packages including nested dependencies */
+    totalPackageCount: number;
+    /** Last modification time of the node_modules directory */
+    lastModified: Date;
+    /** Formatted string showing how long ago (e.g., "30d ago", "2d ago") */
+    lastModifiedFormatted: string;
+    /** Whether this node_modules is currently selected for deletion */
+    selected: boolean;
+    /** Whether this project is marked as a favorite (never suggest deleting) */
+    isFavorite: boolean;
+    /** Age category for color coding */
+    ageCategory: AgeCategory;
+    /** Size category for color coding */
+    sizeCategory: SizeCategory;
+}
+/**
+ * Age categories determine visual styling in the TUI.
+ * Used to highlight stale/old node_modules that might be safe to delete.
+ */
+type AgeCategory = 'fresh' | 'recent' | 'old' | 'stale';
+/**
+ * Size categories determine visual styling and smart selection rules.
+ * Helps users quickly identify large disk space consumers.
+ */
+type SizeCategory = 'small' | 'medium' | 'large' | 'huge';
+/**
+ * Sort options for the TUI list view.
+ * Each option represents a different way to organize the results.
+ */
+type SortOption = 'size-desc' | 'size-asc' | 'date-desc' | 'date-asc' | 'name-asc' | 'name-desc' | 'packages-desc' | 'packages-asc';
+/**
+ * Configuration options for the scanning process.
+ * Controls what gets scanned and how results are filtered.
+ */
+interface ScanOptions {
+    /** Root directory to start scanning from */
+    rootPath: string;
+    /** Maximum depth to scan (undefined = unlimited) */
+    maxDepth?: number;
+    /** Patterns to exclude (glob strings) */
+    excludePatterns: string[];
+    /** Whether to follow symbolic links */
+    followSymlinks: boolean;
+    /** Minimum size threshold in bytes (skip smaller node_modules) */
+    minSizeBytes?: number;
+    /** Maximum age in days (only include node_modules older than this) */
+    olderThanDays?: number;
+}
+/**
+ * Configuration options for the deletion operation.
+ * Controls safety checks and behavior during deletion.
+ */
+interface DeleteOptions {
+    /** Whether to perform a dry run (don't actually delete) */
+    dryRun: boolean;
+    /** Whether to skip confirmation prompts */
+    yes: boolean;
+    /** Whether to check for running processes before deleting */
+    checkRunningProcesses: boolean;
+    /** Whether to show a progress bar during deletion */
+    showProgress: boolean;
+}
+/**
+ * Results of a deletion operation.
+ * Provides detailed feedback about what was deleted and any errors.
+ */
+interface DeletionResult {
+    /** Total number of node_modules directories attempted */
+    totalAttempted: number;
+    /** Number successfully deleted */
+    successful: number;
+    /** Number that failed to delete */
+    failed: number;
+    /** Total bytes freed (or that would be freed in dry run) */
+    bytesFreed: number;
+    /** Human-readable formatted version of bytes freed */
+    formattedBytesFreed: string;
+    /** Detailed results for each deletion attempt */
+    details: DeletionDetail[];
+}
+/**
+ * Result of a single node_modules deletion attempt.
+ */
+interface DeletionDetail {
+    /** The node_modules info that was targeted */
+    nodeModules: NodeModulesInfo;
+    /** Whether the deletion succeeded */
+    success: boolean;
+    /** Error message if deletion failed */
+    error?: string;
+    /** Time taken to delete in milliseconds */
+    durationMs: number;
+}
+/**
+ * Application state for the TUI.
+ * Centralized state management following the reactive pattern.
+ */
+interface AppState {
+    /** All discovered node_modules directories */
+    nodeModules: NodeModulesInfo[];
+    /** Currently selected index in the list (for keyboard navigation) */
+    selectedIndex: number;
+    /** Current sort option */
+    sortBy: SortOption;
+    /** Current filter string (empty = no filter) */
+    filterQuery: string;
+    /** Whether the app is currently scanning */
+    isScanning: boolean;
+    /** Whether the app is currently deleting */
+    isDeleting: boolean;
+    /** Scan progress (0-100) */
+    scanProgress: number;
+    /** Total bytes reclaimed in this session */
+    sessionBytesReclaimed: number;
+    /** Whether to show the help overlay */
+    showHelp: boolean;
+    /** Error message to display (undefined = no error) */
+    errorMessage?: string;
+}
+/**
+ * CLI arguments parsed from command line.
+ * Used to configure the application behavior.
+ */
+interface CliArgs {
+    /** Path to scan (default: current directory) */
+    path: string;
+    /** Quick scan mode (no TUI, just report) */
+    scan: boolean;
+    /** Auto-delete mode (no TUI, delete matching criteria) */
+    auto: boolean;
+    /** Dry run mode (don't actually delete) */
+    dryRun: boolean;
+    /** Skip confirmations */
+    yes: boolean;
+    /** Minimum size threshold for auto mode (e.g., "1gb", "500mb") */
+    minSize?: string;
+    /** Output as JSON */
+    json: boolean;
+    /** Show help message */
+    help: boolean;
+    /** Show version */
+    version: boolean;
+}
+/**
+ * Statistics calculated from a list of node_modules.
+ * Used for summary displays and overview headers.
+ */
+interface ScanStatistics$1 {
+    /** Total number of projects found */
+    totalProjects: number;
+    /** Total number of node_modules directories */
+    totalNodeModules: number;
+    /** Total size of all node_modules in bytes */
+    totalSizeBytes: number;
+    /** Total size formatted as human-readable string */
+    totalSizeFormatted: string;
+    /** Number of selected node_modules */
+    selectedCount: number;
+    /** Total size of selected node_modules */
+    selectedSizeBytes: number;
+    /** Total size of selected formatted */
+    selectedSizeFormatted: string;
+    /** Average age in days */
+    averageAgeDays: number;
+    /** Number of stale node_modules (>30 days) */
+    staleCount: number;
+}
+/**
+ * Color configuration for terminal output.
+ * Provides semantic color mapping for different categories.
+ */
+interface ColorConfig {
+    /** Color for huge directories (>1GB) */
+    huge: string;
+    /** Color for large directories (>500MB) */
+    large: string;
+    /** Color for small directories (<100MB) */
+    small: string;
+    /** Color for stale/old directories */
+    stale: string;
+    /** Color for fresh directories */
+    fresh: string;
+    /** Color for selected items */
+    selected: string;
+    /** Color for errors */
+    error: string;
+    /** Color for success */
+    success: string;
+    /** Color for warnings */
+    warning: string;
+    /** Color for info/primary text */
+    info: string;
+}
+/** Default color configuration using standard terminal colors */
+declare const DEFAULT_COLORS: ColorConfig;
+/**
+ * Thresholds for size categorization in bytes.
+ * Used to determine visual styling and smart selection rules.
+ */
+declare const SIZE_THRESHOLDS: {
+    /** 100 MB - upper bound for "small" category */
+    readonly SMALL: number;
+    /** 500 MB - upper bound for "medium" category */
+    readonly MEDIUM: number;
+    /** 1 GB - upper bound for "large" category */
+    readonly LARGE: number;
+};
+/**
+ * Thresholds for age categorization in days.
+ * Used to identify stale node_modules that might be safe to delete.
+ */
+declare const AGE_THRESHOLDS: {
+    /** 7 days - still considered fresh */
+    readonly FRESH: 7;
+    /** 30 days - warning threshold */
+    readonly RECENT: 30;
+    /** 90 days - stale threshold */
+    readonly OLD: 90;
+};
+
+/**
+ * Scanner module for discovering and analyzing node_modules directories
+ *
+ * This module handles the core scanning functionality:
+ * - Recursive directory traversal
+ * - Size calculation (recursive)
+ * - Package.json parsing
+ * - Metadata extraction
+ *
+ * All operations are async and non-blocking to keep the TUI responsive.
+ */
+
+/**
+ * Result of a directory scan operation.
+ */
+interface ScanResult {
+    /** Discovered node_modules entries */
+    nodeModules: NodeModulesInfo[];
+    /** Number of directories scanned */
+    directoriesScanned: number;
+    /** Any errors encountered during scanning */
+    errors: string[];
+}
+/**
+ * Recursively scan for node_modules directories starting from root path.
+ *
+ * This is the main entry point for discovery. It walks the directory tree,
+ * identifies node_modules folders, and collects metadata about each one.
+ *
+ * @param options - Scan configuration options
+ * @param onProgress - Optional callback for progress updates (0-100)
+ * @returns Scan results with all discovered node_modules
+ */
+declare function scanForNodeModules(options: ScanOptions, onProgress?: (progress: number) => void): Promise<ScanResult>;
+/**
+ * Analyze a specific node_modules directory and extract all metadata.
+ *
+ * This function performs the heavy lifting of:
+ * - Calculating total size (recursive)
+ * - Counting packages
+ * - Reading parent project info
+ * - Determining age and size categories
+ *
+ * @param nodeModulesPath - Path to node_modules directory
+ * @param projectPath - Path to parent project (containing package.json)
+ * @returns Complete metadata for the node_modules
+ */
+declare function analyzeNodeModules(nodeModulesPath: string, projectPath: string): Promise<NodeModulesInfo>;
+/**
+ * Load ignore patterns from .onmignore file.
+ *
+ * Looks for .onmignore in:
+ * 1. Current working directory
+ * 2. Home directory
+ *
+ * @returns Array of ignore patterns
+ */
+declare function loadIgnorePatterns(): Promise<string[]>;
+/**
+ * Load favorites list from .onmfavorites file.
+ *
+ * Favorites are projects that should never be suggested for deletion.
+ *
+ * @returns Set of favorite project paths
+ */
+declare function loadFavorites(): Promise<Set<string>>;
+/**
+ * Check if a node_modules directory is currently in use.
+ *
+ * This is a safety check to prevent deleting node_modules that
+ * might be actively being used by a running process.
+ *
+ * Note: This is a best-effort check and may not catch all cases.
+ *
+ * @param path - Path to node_modules
+ * @returns True if potentially in use
+ */
+declare function isNodeModulesInUse(path: string): Promise<boolean>;
+/**
+ * Quick scan mode - just report without full metadata.
+ *
+ * Faster than full scan when you just need a quick overview.
+ *
+ * @param rootPath - Root directory to scan
+ * @returns Basic info about found node_modules
+ */
+declare function quickScan(rootPath: string): Promise<Array<{
+    path: string;
+    projectPath: string;
+    projectName: string;
+}>>;
+
+/**
+ * Deletion module for safely removing node_modules directories
+ *
+ * This module handles:
+ * - Safe deletion with confirmations
+ * - Dry run mode
+ * - Progress tracking
+ * - Error handling
+ * - In-use detection
+ *
+ * Safety is the priority - we never delete without explicit confirmation
+ * and we check for potential issues before proceeding.
+ */
+
+/**
+ * Delete selected node_modules directories.
+ *
+ * This is the main entry point for deletion operations. It:
+ * 1. Filters to only selected items
+ * 2. Performs safety checks
+ * 3. Deletes each node_modules (or simulates in dry run)
+ * 4. Collects results and statistics
+ *
+ * @param nodeModules - List of all node_modules (selected ones will be deleted)
+ * @param options - Deletion options
+ * @param onProgress - Optional callback for progress updates
+ * @returns Deletion results with statistics
+ */
+declare function deleteSelectedNodeModules(nodeModules: NodeModulesInfo[], options: DeleteOptions, onProgress?: (current: number, total: number, currentPath: string) => void): Promise<DeletionResult>;
+/**
+ * Generate a preview report of what would be deleted.
+ *
+ * Used for dry run mode and confirmation prompts.
+ *
+ * @param nodeModules - All node_modules items
+ * @returns Formatted report string
+ */
+declare function generateDeletionPreview(nodeModules: NodeModulesInfo[]): string;
+/**
+ * Generate a JSON report of deletion results.
+ *
+ * @param result - Deletion result
+ * @returns JSON string
+ */
+declare function generateJSONReport(result: DeletionResult): string;
+/**
+ * Select node_modules by size criteria.
+ *
+ * Helper for "select all >500MB" functionality.
+ *
+ * @param nodeModules - All node_modules
+ * @param minSizeBytes - Minimum size in bytes
+ * @returns Updated array with selections
+ */
+declare function selectBySize(nodeModules: NodeModulesInfo[], minSizeBytes: number): NodeModulesInfo[];
+/**
+ * Select node_modules by age criteria.
+ *
+ * Helper for "select all older than X days" functionality.
+ *
+ * @param nodeModules - All node_modules
+ * @param minAgeDays - Minimum age in days
+ * @returns Updated array with selections
+ */
+declare function selectByAge(nodeModules: NodeModulesInfo[], minAgeDays: number): NodeModulesInfo[];
+/**
+ * Select all node_modules.
+ *
+ * @param nodeModules - All node_modules
+ * @param selected - Whether to select (true) or deselect (false)
+ * @returns Updated array
+ */
+declare function selectAll(nodeModules: NodeModulesInfo[], selected: boolean): NodeModulesInfo[];
+/**
+ * Invert selection.
+ *
+ * @param nodeModules - All node_modules
+ * @returns Updated array with inverted selections
+ */
+declare function invertSelection(nodeModules: NodeModulesInfo[]): NodeModulesInfo[];
+
+/**
+ * Utility functions for oh-my-node-modules
+ *
+ * This module provides pure functions for common operations like
+ * formatting bytes, parsing sizes, and date calculations.
+ * Pure functions make testing easier and reduce side effects.
+ */
+
+/**
+ * Statistics calculated from a list of node_modules.
+ * Used for summary displays and overview headers.
+ */
+interface ScanStatistics {
+    /** Total number of projects found */
+    totalProjects: number;
+    /** Total number of node_modules directories */
+    totalNodeModules: number;
+    /** Total size of all node_modules in bytes */
+    totalSizeBytes: number;
+    /** Total size formatted as human-readable string */
+    totalSizeFormatted: string;
+    /** Number of selected node_modules */
+    selectedCount: number;
+    /** Total size of selected node_modules */
+    selectedSizeBytes: number;
+    /** Total size of selected formatted */
+    selectedSizeFormatted: string;
+    /** Average age in days */
+    averageAgeDays: number;
+    /** Number of stale node_modules (>30 days) */
+    staleCount: number;
+}
+/**
+ * Format bytes into human-readable string.
+ * Uses binary units (MiB, GiB) for accuracy.
+ *
+ * @param bytes - Number of bytes to format
+ * @returns Formatted string like "1.2 GB" or "456 MB"
+ */
+declare function formatBytes(bytes: number): string;
+/**
+ * Parse human-readable size string into bytes.
+ * Supports formats like "1gb", "500MB", "10mb"
+ *
+ * @param sizeStr - Size string to parse
+ * @returns Size in bytes, or undefined if invalid
+ */
+declare function parseSize(sizeStr: string): number | undefined;
+/**
+ * Format a date into "X days ago" string.
+ * Provides more readable relative time than raw dates.
+ *
+ * @param date - Date to format
+ * @returns Formatted string like "30d ago" or "2d ago"
+ */
+declare function formatRelativeTime(date: Date): string;
+/**
+ * Determine size category based on bytes.
+ * Used for color coding and smart selection.
+ *
+ * @param bytes - Size in bytes
+ * @returns Size category
+ */
+declare function getSizeCategory(bytes: number): SizeCategory;
+/**
+ * Determine age category based on days since modification.
+ * Used to identify potentially stale node_modules.
+ *
+ * @param lastModified - Last modification date
+ * @returns Age category
+ */
+declare function getAgeCategory(lastModified: Date): AgeCategory;
+/**
+ * Sort node_modules by the specified option.
+ * Pure function that returns a new sorted array.
+ *
+ * @param items - Array to sort
+ * @param sortBy - Sort option
+ * @returns New sorted array
+ */
+declare function sortNodeModules(items: NodeModulesInfo[], sortBy: SortOption): NodeModulesInfo[];
+/**
+ * Filter node_modules by search query.
+ * Matches against project name and path.
+ *
+ * @param items - Array to filter
+ * @param query - Search query (case-insensitive)
+ * @returns Filtered array
+ */
+declare function filterNodeModules(items: NodeModulesInfo[], query: string): NodeModulesInfo[];
+/**
+ * Calculate statistics from node_modules list.
+ * Used for overview displays and summaries.
+ *
+ * @param items - Node modules to analyze
+ * @returns Calculated statistics
+ */
+declare function calculateStatistics(items: NodeModulesInfo[]): ScanStatistics;
+/**
+ * Toggle selection state for a node_modules item.
+ * Returns new array with toggled item (immutable update).
+ *
+ * @param items - Current items array
+ * @param index - Index of item to toggle
+ * @returns New array with toggled selection
+ */
+declare function toggleSelection(items: NodeModulesInfo[], index: number): NodeModulesInfo[];
+/**
+ * Select or deselect all items matching a predicate.
+ * Useful for "select all >500MB" or "select all stale" operations.
+ *
+ * @param items - Current items array
+ * @param predicate - Function to determine which items to select
+ * @param selected - Whether to select (true) or deselect (false)
+ * @returns New array with updated selections
+ */
+declare function selectByPredicate(items: NodeModulesInfo[], predicate: (item: NodeModulesInfo) => boolean, selected: boolean): NodeModulesInfo[];
+
+/**
+ * oh-my-node-modules - Public API
+ *
+ * This module exports the public API for programmatic use.
+ * Most users will use the CLI, but the API is available for
+ * integration with other tools.
+ *
+ * @example
+ * ```typescript
+ * import { scanForNodeModules, deleteSelectedNodeModules } from 'oh-my-node-modules';
+ *
+ * const result = await scanForNodeModules({
+ *   rootPath: '/path/to/projects',
+ *   excludePatterns: [],
+ *   followSymlinks: false,
+ * });
+ *
+ * // ... process results ...
+ * ```
+ */
+
+declare const VERSION = "1.0.0";
+
+export { AGE_THRESHOLDS, DEFAULT_COLORS, SIZE_THRESHOLDS, VERSION, analyzeNodeModules, calculateStatistics, deleteSelectedNodeModules, filterNodeModules, formatBytes, formatRelativeTime, generateDeletionPreview, generateJSONReport, getAgeCategory, getSizeCategory, invertSelection, isNodeModulesInUse, loadFavorites, loadIgnorePatterns, parseSize, quickScan, scanForNodeModules, selectAll, selectByAge, selectByPredicate, selectBySize, sortNodeModules, toggleSelection };
+export type { AgeCategory, AppState, CliArgs, ColorConfig, DeleteOptions, DeletionDetail, DeletionResult, NodeModulesInfo, ScanOptions, ScanStatistics$1 as ScanStatistics, SizeCategory, SortOption };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../src/types.ts","../src/scanner.ts","../src/deletion.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":["/**\n * Core type definitions for oh-my-node-modules\n * \n * These types represent the domain model for node_modules analysis.\n * Each interface answers a specific question about the data structure.\n */\n\n/** \n * Represents a discovered node_modules directory with all relevant metadata.\n * This is the core data structure that flows through the entire application.\n */\nexport interface NodeModulesInfo {\n  /** Absolute path to the node_modules directory */\n  path: string;\n  \n  /** Absolute path to the parent project directory (containing package.json) */\n  projectPath: string;\n  \n  /** Project name from package.json, or directory name if no package.json */\n  projectName: string;\n  \n  /** Project version from package.json, or undefined if not available */\n  projectVersion?: string;\n  \n  /** Total size in bytes (recursive, includes all nested files) */\n  sizeBytes: number;\n  \n  /** Human-readable size string (e.g., \"1.2 GB\", \"456 MB\") */\n  sizeFormatted: string;\n  \n  /** Number of packages directly in node_modules (top-level) */\n  packageCount: number;\n  \n  /** Total number of packages including nested dependencies */\n  totalPackageCount: number;\n  \n  /** Last modification time of the node_modules directory */\n  lastModified: Date;\n  \n  /** Formatted string showing how long ago (e.g., \"30d ago\", \"2d ago\") */\n  lastModifiedFormatted: string;\n  \n  /** Whether this node_modules is currently selected for deletion */\n  selected: boolean;\n  \n  /** Whether this project is marked as a favorite (never suggest deleting) */\n  isFavorite: boolean;\n  \n  /** Age category for color coding */\n  ageCategory: AgeCategory;\n  \n  /** Size category for color coding */\n  sizeCategory: SizeCategory;\n}\n\n/** \n * Age categories determine visual styling in the TUI.\n * Used to highlight stale/old node_modules that might be safe to delete.\n */\nexport type AgeCategory = 'fresh' | 'recent' | 'old' | 'stale';\n\n/**\n * Size categories determine visual styling and smart selection rules.\n * Helps users quickly identify large disk space consumers.\n */\nexport type SizeCategory = 'small' | 'medium' | 'large' | 'huge';\n\n/**\n * Sort options for the TUI list view.\n * Each option represents a different way to organize the results.\n */\nexport type SortOption = \n  | 'size-desc'      // Largest first (default)\n  | 'size-asc'       // Smallest first\n  | 'date-desc'      // Most recently modified first\n  | 'date-asc'       // Oldest first\n  | 'name-asc'       // Alphabetical A-Z\n  | 'name-desc'      // Alphabetical Z-A\n  | 'packages-desc'  // Most packages first\n  | 'packages-asc';  // Fewest packages first\n\n/**\n * Configuration options for the scanning process.\n * Controls what gets scanned and how results are filtered.\n */\nexport interface ScanOptions {\n  /** Root directory to start scanning from */\n  rootPath: string;\n  \n  /** Maximum depth to scan (undefined = unlimited) */\n  maxDepth?: number;\n  \n  /** Patterns to exclude (glob strings) */\n  excludePatterns: string[];\n  \n  /** Whether to follow symbolic links */\n  followSymlinks: boolean;\n  \n  /** Minimum size threshold in bytes (skip smaller node_modules) */\n  minSizeBytes?: number;\n  \n  /** Maximum age in days (only include node_modules older than this) */\n  olderThanDays?: number;\n}\n\n/**\n * Configuration options for the deletion operation.\n * Controls safety checks and behavior during deletion.\n */\nexport interface DeleteOptions {\n  /** Whether to perform a dry run (don't actually delete) */\n  dryRun: boolean;\n  \n  /** Whether to skip confirmation prompts */\n  yes: boolean;\n  \n  /** Whether to check for running processes before deleting */\n  checkRunningProcesses: boolean;\n  \n  /** Whether to show a progress bar during deletion */\n  showProgress: boolean;\n}\n\n/**\n * Results of a deletion operation.\n * Provides detailed feedback about what was deleted and any errors.\n */\nexport interface DeletionResult {\n  /** Total number of node_modules directories attempted */\n  totalAttempted: number;\n  \n  /** Number successfully deleted */\n  successful: number;\n  \n  /** Number that failed to delete */\n  failed: number;\n  \n  /** Total bytes freed (or that would be freed in dry run) */\n  bytesFreed: number;\n  \n  /** Human-readable formatted version of bytes freed */\n  formattedBytesFreed: string;\n  \n  /** Detailed results for each deletion attempt */\n  details: DeletionDetail[];\n}\n\n/**\n * Result of a single node_modules deletion attempt.\n */\nexport interface DeletionDetail {\n  /** The node_modules info that was targeted */\n  nodeModules: NodeModulesInfo;\n  \n  /** Whether the deletion succeeded */\n  success: boolean;\n  \n  /** Error message if deletion failed */\n  error?: string;\n  \n  /** Time taken to delete in milliseconds */\n  durationMs: number;\n}\n\n/**\n * Application state for the TUI.\n * Centralized state management following the reactive pattern.\n */\nexport interface AppState {\n  /** All discovered node_modules directories */\n  nodeModules: NodeModulesInfo[];\n  \n  /** Currently selected index in the list (for keyboard navigation) */\n  selectedIndex: number;\n  \n  /** Current sort option */\n  sortBy: SortOption;\n  \n  /** Current filter string (empty = no filter) */\n  filterQuery: string;\n  \n  /** Whether the app is currently scanning */\n  isScanning: boolean;\n  \n  /** Whether the app is currently deleting */\n  isDeleting: boolean;\n  \n  /** Scan progress (0-100) */\n  scanProgress: number;\n  \n  /** Total bytes reclaimed in this session */\n  sessionBytesReclaimed: number;\n  \n  /** Whether to show the help overlay */\n  showHelp: boolean;\n  \n  /** Error message to display (undefined = no error) */\n  errorMessage?: string;\n}\n\n/**\n * Initial state factory function.\n * Creates a fresh application state with sensible defaults.\n */\nexport function createInitialState(): AppState {\n  return {\n    nodeModules: [],\n    selectedIndex: 0,\n    sortBy: 'size-desc',\n    filterQuery: '',\n    isScanning: false,\n    isDeleting: false,\n    scanProgress: 0,\n    sessionBytesReclaimed: 0,\n    showHelp: false,\n  };\n}\n\n/**\n * CLI arguments parsed from command line.\n * Used to configure the application behavior.\n */\nexport interface CliArgs {\n  /** Path to scan (default: current directory) */\n  path: string;\n  \n  /** Quick scan mode (no TUI, just report) */\n  scan: boolean;\n  \n  /** Auto-delete mode (no TUI, delete matching criteria) */\n  auto: boolean;\n  \n  /** Dry run mode (don't actually delete) */\n  dryRun: boolean;\n  \n  /** Skip confirmations */\n  yes: boolean;\n  \n  /** Minimum size threshold for auto mode (e.g., \"1gb\", \"500mb\") */\n  minSize?: string;\n  \n  /** Output as JSON */\n  json: boolean;\n  \n  /** Show help message */\n  help: boolean;\n  \n  /** Show version */\n  version: boolean;\n}\n\n/**\n * Statistics calculated from a list of node_modules.\n * Used for summary displays and overview headers.\n */\nexport interface ScanStatistics {\n  /** Total number of projects found */\n  totalProjects: number;\n  \n  /** Total number of node_modules directories */\n  totalNodeModules: number;\n  \n  /** Total size of all node_modules in bytes */\n  totalSizeBytes: number;\n  \n  /** Total size formatted as human-readable string */\n  totalSizeFormatted: string;\n  \n  /** Number of selected node_modules */\n  selectedCount: number;\n  \n  /** Total size of selected node_modules */\n  selectedSizeBytes: number;\n  \n  /** Total size of selected formatted */\n  selectedSizeFormatted: string;\n  \n  /** Average age in days */\n  averageAgeDays: number;\n  \n  /** Number of stale node_modules (>30 days) */\n  staleCount: number;\n}\n\n/**\n * Color configuration for terminal output.\n * Provides semantic color mapping for different categories.\n */\nexport interface ColorConfig {\n  /** Color for huge directories (>1GB) */\n  huge: string;\n  \n  /** Color for large directories (>500MB) */\n  large: string;\n  \n  /** Color for small directories (<100MB) */\n  small: string;\n  \n  /** Color for stale/old directories */\n  stale: string;\n  \n  /** Color for fresh directories */\n  fresh: string;\n  \n  /** Color for selected items */\n  selected: string;\n  \n  /** Color for errors */\n  error: string;\n  \n  /** Color for success */\n  success: string;\n  \n  /** Color for warnings */\n  warning: string;\n  \n  /** Color for info/primary text */\n  info: string;\n}\n\n/** Default color configuration using standard terminal colors */\nexport const DEFAULT_COLORS: ColorConfig = {\n  huge: 'red',\n  large: 'yellow',\n  small: 'green',\n  stale: 'gray',\n  fresh: 'white',\n  selected: 'cyan',\n  error: 'red',\n  success: 'green',\n  warning: 'yellow',\n  info: 'blue',\n};\n\n/**\n * Thresholds for size categorization in bytes.\n * Used to determine visual styling and smart selection rules.\n */\nexport const SIZE_THRESHOLDS = {\n  /** 100 MB - upper bound for \"small\" category */\n  SMALL: 100 * 1024 * 1024,\n  /** 500 MB - upper bound for \"medium\" category */\n  MEDIUM: 500 * 1024 * 1024,\n  /** 1 GB - upper bound for \"large\" category */\n  LARGE: 1024 * 1024 * 1024,\n} as const;\n\n/**\n * Thresholds for age categorization in days.\n * Used to identify stale node_modules that might be safe to delete.\n */\nexport const AGE_THRESHOLDS = {\n  /** 7 days - still considered fresh */\n  FRESH: 7,\n  /** 30 days - warning threshold */\n  RECENT: 30,\n  /** 90 days - stale threshold */\n  OLD: 90,\n} as const;\n","/**\n * Scanner module for discovering and analyzing node_modules directories\n * \n * This module handles the core scanning functionality:\n * - Recursive directory traversal\n * - Size calculation (recursive)\n * - Package.json parsing\n * - Metadata extraction\n * \n * All operations are async and non-blocking to keep the TUI responsive.\n */\n\nimport { promises as fs } from 'fs';\nimport { join, basename, dirname } from 'path';\nimport type { NodeModulesInfo, ScanOptions } from './types.js';\nimport {\n  formatBytes,\n  formatRelativeTime,\n  getSizeCategory,\n  getAgeCategory,\n  readPackageJson,\n  shouldExcludePath,\n  fileExists,\n} from './utils.js';\n\n/**\n * Result of a directory scan operation.\n */\ninterface ScanResult {\n  /** Discovered node_modules entries */\n  nodeModules: NodeModulesInfo[];\n  /** Number of directories scanned */\n  directoriesScanned: number;\n  /** Any errors encountered during scanning */\n  errors: string[];\n}\n\n/**\n * Recursively scan for node_modules directories starting from root path.\n * \n * This is the main entry point for discovery. It walks the directory tree,\n * identifies node_modules folders, and collects metadata about each one.\n * \n * @param options - Scan configuration options\n * @param onProgress - Optional callback for progress updates (0-100)\n * @returns Scan results with all discovered node_modules\n */\nexport async function scanForNodeModules(\n  options: ScanOptions,\n  onProgress?: (progress: number) => void\n): Promise<ScanResult> {\n  const result: ScanResult = {\n    nodeModules: [],\n    directoriesScanned: 0,\n    errors: [],\n  };\n\n  const visitedPaths = new Set<string>();\n  const pathsToScan: Array<{ path: string; depth: number }> = [\n    { path: options.rootPath, depth: 0 },\n  ];\n\n  let processedCount = 0;\n  let totalEstimate = 1; // Start with 1, will adjust as we discover\n\n  while (pathsToScan.length > 0) {\n    const { path: currentPath, depth } = pathsToScan.shift()!;\n\n    // Skip if already visited or exceeds max depth\n    if (visitedPaths.has(currentPath)) continue;\n    if (options.maxDepth !== undefined && depth > options.maxDepth) continue;\n    if (shouldExcludePath(currentPath, options.excludePatterns)) continue;\n\n    visitedPaths.add(currentPath);\n    result.directoriesScanned++;\n\n    try {\n      const entries = await fs.readdir(currentPath, { withFileTypes: true });\n      \n      // Check if current directory has node_modules\n      const hasNodeModules = entries.some(\n        entry => entry.isDirectory() && entry.name === 'node_modules'\n      );\n\n      if (hasNodeModules) {\n        const nodeModulesPath = join(currentPath, 'node_modules');\n        const info = await analyzeNodeModules(nodeModulesPath, currentPath);\n\n        // Apply filters\n        if (options.minSizeBytes && info.sizeBytes < options.minSizeBytes) {\n          // Skip - too small\n        } else if (\n          options.olderThanDays &&\n          getAgeInDays(info.lastModified) < options.olderThanDays\n        ) {\n          // Skip - too recent\n        } else {\n          result.nodeModules.push(info);\n        }\n      }\n\n      // Add subdirectories to scan queue (excluding node_modules itself)\n      for (const entry of entries) {\n        if (\n          entry.isDirectory() &&\n          entry.name !== 'node_modules' &&\n          !entry.name.startsWith('.')\n        ) {\n          const subPath = join(currentPath, entry.name);\n          if (!shouldExcludePath(subPath, options.excludePatterns)) {\n            pathsToScan.push({ path: subPath, depth: depth + 1 });\n            totalEstimate++;\n          }\n        }\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      result.errors.push(`Error scanning ${currentPath}: ${errorMessage}`);\n    }\n\n    // Report progress\n    processedCount++;\n    if (onProgress) {\n      const progress = Math.min(100, Math.round((processedCount / totalEstimate) * 100));\n      onProgress(progress);\n    }\n  }\n\n  // Ensure we report 100% at the end\n  if (onProgress) {\n    onProgress(100);\n  }\n\n  return result;\n}\n\n/**\n * Analyze a specific node_modules directory and extract all metadata.\n * \n * This function performs the heavy lifting of:\n * - Calculating total size (recursive)\n * - Counting packages\n * - Reading parent project info\n * - Determining age and size categories\n * \n * @param nodeModulesPath - Path to node_modules directory\n * @param projectPath - Path to parent project (containing package.json)\n * @returns Complete metadata for the node_modules\n */\nexport async function analyzeNodeModules(\n  nodeModulesPath: string,\n  projectPath: string\n): Promise<NodeModulesInfo> {\n  // Get basic stats\n  const stats = await fs.stat(nodeModulesPath);\n  \n  // Calculate size and count packages\n  const { totalSize, packageCount, totalPackageCount } = await calculateDirectorySize(\n    nodeModulesPath\n  );\n\n  // Read project info from package.json\n  const packageJson = await readPackageJson(projectPath);\n  const projectName = packageJson?.name || basename(projectPath);\n  const projectVersion = packageJson?.version;\n\n  // Determine categories\n  const sizeCategory = getSizeCategory(totalSize);\n  const ageCategory = getAgeCategory(stats.mtime);\n\n  return {\n    path: nodeModulesPath,\n    projectPath,\n    projectName,\n    projectVersion,\n    sizeBytes: totalSize,\n    sizeFormatted: formatBytes(totalSize),\n    packageCount,\n    totalPackageCount,\n    lastModified: stats.mtime,\n    lastModifiedFormatted: formatRelativeTime(stats.mtime),\n    selected: false,\n    isFavorite: false,\n    ageCategory,\n    sizeCategory,\n  };\n}\n\n/**\n * Recursively calculate directory size and package counts.\n * \n * This is an expensive operation for large node_modules directories.\n * We optimize by:\n * - Using iterative approach (avoid stack overflow)\n * - Counting only top-level packages for packageCount\n * - Counting all packages for totalPackageCount\n * \n * @param dirPath - Directory to analyze\n * @returns Size in bytes and package counts\n */\nasync function calculateDirectorySize(dirPath: string): Promise<{\n  totalSize: number;\n  packageCount: number;\n  totalPackageCount: number;\n}> {\n  let totalSize = 0;\n  let packageCount = 0;\n  let totalPackageCount = 0;\n  let isTopLevel = true;\n\n  const pathsToProcess: string[] = [dirPath];\n  const processedPaths = new Set<string>();\n\n  while (pathsToProcess.length > 0) {\n    const currentPath = pathsToProcess.pop()!;\n    \n    if (processedPaths.has(currentPath)) continue;\n    processedPaths.add(currentPath);\n\n    try {\n      const stats = await fs.stat(currentPath);\n      \n      if (stats.isFile()) {\n        totalSize += stats.size;\n      } else if (stats.isDirectory()) {\n        // Add directory entry size (approximate)\n        totalSize += 4096; // Typical directory entry size\n        \n        // Count packages at top level only\n        if (isTopLevel && currentPath !== dirPath) {\n          const entryName = basename(currentPath);\n          // Skip hidden directories and special directories\n          if (!entryName.startsWith('.') && entryName !== '.bin') {\n            packageCount++;\n          }\n        }\n        \n        // Count all packages for total\n        if (currentPath !== dirPath) {\n          const entryName = basename(currentPath);\n          if (!entryName.startsWith('.') && entryName !== '.bin') {\n            totalPackageCount++;\n          }\n        }\n\n        // Read directory contents\n        try {\n          const entries = await fs.readdir(currentPath, { withFileTypes: true });\n          for (const entry of entries) {\n            const entryPath = join(currentPath, entry.name);\n            pathsToProcess.push(entryPath);\n          }\n        } catch {\n          // Permission denied or other error - skip this directory\n        }\n      } else if (stats.isSymbolicLink()) {\n        // Skip symbolic links to avoid cycles\n      }\n    } catch {\n      // File not accessible - skip\n    }\n\n    if (currentPath === dirPath) {\n      isTopLevel = false;\n    }\n  }\n\n  return { totalSize, packageCount, totalPackageCount };\n}\n\n/**\n * Helper to get age in days from a date.\n */\nfunction getAgeInDays(date: Date): number {\n  const now = new Date();\n  return Math.floor((now.getTime() - date.getTime()) / (1000 * 60 * 60 * 24));\n}\n\n/**\n * Load ignore patterns from .onmignore file.\n * \n * Looks for .onmignore in:\n * 1. Current working directory\n * 2. Home directory\n * \n * @returns Array of ignore patterns\n */\nexport async function loadIgnorePatterns(): Promise<string[]> {\n  const patterns: string[] = [\n    '**/node_modules/**', // Never scan inside node_modules\n    '**/.git/**',\n    '**/.*', // Hidden directories\n  ];\n\n  const ignoreFiles = [\n    join(process.cwd(), '.onmignore'),\n    join(process.env.HOME || process.cwd(), '.onmignore'),\n  ];\n\n  for (const ignoreFile of ignoreFiles) {\n    try {\n      if (await fileExists(ignoreFile)) {\n        const content = await fs.readFile(ignoreFile, 'utf-8');\n        const lines = content\n          .split('\\n')\n          .map(line => line.trim())\n          .filter(line => line && !line.startsWith('#'));\n        patterns.push(...lines);\n      }\n    } catch {\n      // Ignore errors reading ignore files\n    }\n  }\n\n  return patterns;\n}\n\n/**\n * Load favorites list from .onmfavorites file.\n * \n * Favorites are projects that should never be suggested for deletion.\n * \n * @returns Set of favorite project paths\n */\nexport async function loadFavorites(): Promise<Set<string>> {\n  const favorites = new Set<string>();\n\n  const favoritesFile = join(process.env.HOME || process.cwd(), '.onmfavorites');\n\n  try {\n    if (await fileExists(favoritesFile)) {\n      const content = await fs.readFile(favoritesFile, 'utf-8');\n      const lines = content\n        .split('\\n')\n        .map(line => line.trim())\n        .filter(line => line && !line.startsWith('#'));\n      \n      for (const line of lines) {\n        favorites.add(line);\n      }\n    }\n  } catch {\n    // Ignore errors reading favorites\n  }\n\n  return favorites;\n}\n\n/**\n * Check if a node_modules directory is currently in use.\n * \n * This is a safety check to prevent deleting node_modules that\n * might be actively being used by a running process.\n * \n * Note: This is a best-effort check and may not catch all cases.\n * \n * @param path - Path to node_modules\n * @returns True if potentially in use\n */\nexport async function isNodeModulesInUse(path: string): Promise<boolean> {\n  // This is a simplified check - in production, you might want to:\n  // 1. Check for lock files\n  // 2. Check for running node processes using this path\n  // 3. Check for open file handles\n  \n  try {\n    const lockFiles = ['.package-lock.json', 'yarn.lock', 'pnpm-lock.yaml'];\n    const projectPath = dirname(path);\n    \n    for (const lockFile of lockFiles) {\n      const lockPath = join(projectPath, lockFile);\n      try {\n        const stats = await fs.stat(lockPath);\n        // If lock file was modified in the last minute, might be in use\n        const oneMinuteAgo = Date.now() - 60 * 1000;\n        if (stats.mtime.getTime() > oneMinuteAgo) {\n          return true;\n        }\n      } catch {\n        // Lock file doesn't exist - that's fine\n      }\n    }\n  } catch {\n    // Error checking - assume not in use\n  }\n\n  return false;\n}\n\n/**\n * Quick scan mode - just report without full metadata.\n * \n * Faster than full scan when you just need a quick overview.\n * \n * @param rootPath - Root directory to scan\n * @returns Basic info about found node_modules\n */\nexport async function quickScan(rootPath: string): Promise<Array<{\n  path: string;\n  projectPath: string;\n  projectName: string;\n}>> {\n  const results: Array<{ path: string; projectPath: string; projectName: string }> = [];\n  const visitedPaths = new Set<string>();\n  const pathsToScan = [rootPath];\n\n  while (pathsToScan.length > 0) {\n    const currentPath = pathsToScan.pop()!;\n    \n    if (visitedPaths.has(currentPath)) continue;\n    visitedPaths.add(currentPath);\n\n    try {\n      const entries = await fs.readdir(currentPath, { withFileTypes: true });\n      \n      const hasNodeModules = entries.some(\n        entry => entry.isDirectory() && entry.name === 'node_modules'\n      );\n\n      if (hasNodeModules) {\n        const projectPath = currentPath;\n        const nodeModulesPath = join(currentPath, 'node_modules');\n        const packageJson = await readPackageJson(projectPath);\n        \n        results.push({\n          path: nodeModulesPath,\n          projectPath,\n          projectName: packageJson?.name || basename(projectPath),\n        });\n      }\n\n      // Add subdirectories\n      for (const entry of entries) {\n        if (\n          entry.isDirectory() &&\n          entry.name !== 'node_modules' &&\n          !entry.name.startsWith('.')\n        ) {\n          pathsToScan.push(join(currentPath, entry.name));\n        }\n      }\n    } catch {\n      // Skip directories we can't read\n    }\n  }\n\n  return results;\n}\n","/**\n * Deletion module for safely removing node_modules directories\n * \n * This module handles:\n * - Safe deletion with confirmations\n * - Dry run mode\n * - Progress tracking\n * - Error handling\n * - In-use detection\n * \n * Safety is the priority - we never delete without explicit confirmation\n * and we check for potential issues before proceeding.\n */\n\nimport { promises as fs } from 'fs';\nimport { join } from 'path';\nimport type { NodeModulesInfo, DeleteOptions, DeletionResult, DeletionDetail } from './types.js';\nimport { formatBytes, fileExists } from './utils.js';\nimport { isNodeModulesInUse } from './scanner.js';\n\n/**\n * Delete selected node_modules directories.\n * \n * This is the main entry point for deletion operations. It:\n * 1. Filters to only selected items\n * 2. Performs safety checks\n * 3. Deletes each node_modules (or simulates in dry run)\n * 4. Collects results and statistics\n * \n * @param nodeModules - List of all node_modules (selected ones will be deleted)\n * @param options - Deletion options\n * @param onProgress - Optional callback for progress updates\n * @returns Deletion results with statistics\n */\nexport async function deleteSelectedNodeModules(\n  nodeModules: NodeModulesInfo[],\n  options: DeleteOptions,\n  onProgress?: (current: number, total: number, currentPath: string) => void\n): Promise<DeletionResult> {\n  const selected = nodeModules.filter(nm => nm.selected);\n  \n  const result: DeletionResult = {\n    totalAttempted: selected.length,\n    successful: 0,\n    failed: 0,\n    bytesFreed: 0,\n    formattedBytesFreed: '0 B',\n    details: [],\n  };\n\n  for (let i = 0; i < selected.length; i++) {\n    const item = selected[i];\n    \n    if (onProgress) {\n      onProgress(i + 1, selected.length, item.projectName);\n    }\n\n    const detail = await deleteNodeModules(item, options);\n    result.details.push(detail);\n\n    if (detail.success) {\n      result.successful++;\n      result.bytesFreed += item.sizeBytes;\n    } else {\n      result.failed++;\n    }\n  }\n\n  result.formattedBytesFreed = formatBytes(result.bytesFreed);\n  return result;\n}\n\n/**\n * Delete a single node_modules directory.\n * \n * Performs safety checks before deletion:\n * - Verifies it's actually a node_modules directory\n * - Checks if it's in use (if enabled)\n * - Verifies the path is valid\n * \n * @param nodeModules - NodeModulesInfo to delete\n * @param options - Deletion options\n * @returns Detailed result of the deletion\n */\nasync function deleteNodeModules(\n  nodeModules: NodeModulesInfo,\n  options: DeleteOptions\n): Promise<DeletionDetail> {\n  const startTime = Date.now();\n  \n  const detail: DeletionDetail = {\n    nodeModules,\n    success: false,\n    durationMs: 0,\n  };\n\n  try {\n    // Safety check 1: Verify path ends with node_modules\n    if (!nodeModules.path.endsWith('node_modules')) {\n      detail.error = 'Path does not appear to be a node_modules directory';\n      detail.durationMs = Date.now() - startTime;\n      return detail;\n    }\n\n    // Safety check 2: Verify directory exists\n    if (!(await fileExists(nodeModules.path))) {\n      detail.error = 'Directory does not exist';\n      detail.durationMs = Date.now() - startTime;\n      return detail;\n    }\n\n    // Safety check 3: Check if in use\n    if (options.checkRunningProcesses) {\n      const inUse = await isNodeModulesInUse(nodeModules.path);\n      if (inUse) {\n        detail.error = 'Directory appears to be in use by a running process';\n        detail.durationMs = Date.now() - startTime;\n        return detail;\n      }\n    }\n\n    // Safety check 4: Verify it looks like a real node_modules\n    const isValidNodeModules = await verifyNodeModules(nodeModules.path);\n    if (!isValidNodeModules) {\n      detail.error = 'Directory does not appear to be a valid node_modules';\n      detail.durationMs = Date.now() - startTime;\n      return detail;\n    }\n\n    // Perform deletion (or simulate)\n    if (options.dryRun) {\n      // In dry run, just simulate success\n      detail.success = true;\n    } else {\n      // Actually delete the directory\n      await fs.rm(nodeModules.path, { recursive: true, force: true });\n      detail.success = true;\n    }\n\n    detail.durationMs = Date.now() - startTime;\n  } catch (error) {\n    detail.error = error instanceof Error ? error.message : String(error);\n    detail.durationMs = Date.now() - startTime;\n  }\n\n  return detail;\n}\n\n/**\n * Verify that a directory looks like a real node_modules.\n * \n * We check for:\n * - Directory name is exactly \"node_modules\"\n * - Contains at least one subdirectory (package)\n * - Parent directory contains package.json\n * \n * These checks prevent accidental deletion of similarly named directories.\n * \n * @param path - Path to verify\n * @returns True if it looks like a valid node_modules\n */\nasync function verifyNodeModules(path: string): Promise<boolean> {\n  try {\n    // Check name\n    const parts = path.split('/');\n    if (parts[parts.length - 1] !== 'node_modules') {\n      return false;\n    }\n\n    // Check it has contents (not empty)\n    const entries = await fs.readdir(path);\n    const hasSubdirs = entries.some(async entry => {\n      const entryPath = join(path, entry);\n      const stats = await fs.stat(entryPath);\n      return stats.isDirectory();\n    });\n\n    // Parent should have package.json\n    const parentPath = path.replace(/\\/node_modules$/, '').replace(/\\\\node_modules$/, '');\n    const hasPackageJson = await fileExists(join(parentPath, 'package.json'));\n\n    return hasSubdirs || hasPackageJson;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate a preview report of what would be deleted.\n * \n * Used for dry run mode and confirmation prompts.\n * \n * @param nodeModules - All node_modules items\n * @returns Formatted report string\n */\nexport function generateDeletionPreview(nodeModules: NodeModulesInfo[]): string {\n  const selected = nodeModules.filter(nm => nm.selected);\n  \n  if (selected.length === 0) {\n    return 'No node_modules selected for deletion.';\n  }\n\n  const totalBytes = selected.reduce((sum, nm) => sum + nm.sizeBytes, 0);\n  \n  let report = `\\n⚠️  You are about to delete ${selected.length} node_modules director${selected.length === 1 ? 'y' : 'ies'}:\\n\\n`;\n  \n  for (const nm of selected) {\n    const shortPath = nm.path.replace(process.cwd(), '.');\n    report += `   • ${shortPath} (${nm.sizeFormatted})\\n`;\n  }\n  \n  report += `\\n   Total space to reclaim: ${formatBytes(totalBytes)}\\n`;\n  \n  return report;\n}\n\n/**\n * Generate a JSON report of deletion results.\n * \n * @param result - Deletion result\n * @returns JSON string\n */\nexport function generateJSONReport(result: DeletionResult): string {\n  return JSON.stringify({\n    summary: {\n      totalAttempted: result.totalAttempted,\n      successful: result.successful,\n      failed: result.failed,\n      bytesFreed: result.bytesFreed,\n      formattedBytesFreed: result.formattedBytesFreed,\n    },\n    details: result.details.map(d => ({\n      path: d.nodeModules.path,\n      projectName: d.nodeModules.projectName,\n      sizeBytes: d.nodeModules.sizeBytes,\n      sizeFormatted: d.nodeModules.sizeFormatted,\n      success: d.success,\n      error: d.error,\n      durationMs: d.durationMs,\n    })),\n  }, null, 2);\n}\n\n/**\n * Select node_modules by size criteria.\n * \n * Helper for \"select all >500MB\" functionality.\n * \n * @param nodeModules - All node_modules\n * @param minSizeBytes - Minimum size in bytes\n * @returns Updated array with selections\n */\nexport function selectBySize(\n  nodeModules: NodeModulesInfo[],\n  minSizeBytes: number\n): NodeModulesInfo[] {\n  return nodeModules.map(nm => \n    nm.sizeBytes >= minSizeBytes ? { ...nm, selected: true } : nm\n  );\n}\n\n/**\n * Select node_modules by age criteria.\n * \n * Helper for \"select all older than X days\" functionality.\n * \n * @param nodeModules - All node_modules\n * @param minAgeDays - Minimum age in days\n * @returns Updated array with selections\n */\nexport function selectByAge(\n  nodeModules: NodeModulesInfo[],\n  minAgeDays: number\n): NodeModulesInfo[] {\n  const now = new Date();\n  return nodeModules.map(nm => {\n    const ageDays = Math.floor((now.getTime() - nm.lastModified.getTime()) / (1000 * 60 * 60 * 24));\n    return ageDays >= minAgeDays ? { ...nm, selected: true } : nm;\n  });\n}\n\n/**\n * Select all node_modules.\n * \n * @param nodeModules - All node_modules\n * @param selected - Whether to select (true) or deselect (false)\n * @returns Updated array\n */\nexport function selectAll(\n  nodeModules: NodeModulesInfo[],\n  selected: boolean\n): NodeModulesInfo[] {\n  return nodeModules.map(nm => ({ ...nm, selected }));\n}\n\n/**\n * Invert selection.\n * \n * @param nodeModules - All node_modules\n * @returns Updated array with inverted selections\n */\nexport function invertSelection(nodeModules: NodeModulesInfo[]): NodeModulesInfo[] {\n  return nodeModules.map(nm => ({ ...nm, selected: !nm.selected }));\n}\n","/**\n * Utility functions for oh-my-node-modules\n * \n * This module provides pure functions for common operations like\n * formatting bytes, parsing sizes, and date calculations.\n * Pure functions make testing easier and reduce side effects.\n */\n\nimport { promises as fs } from 'fs';\nimport { join } from 'path';\nimport type { \n  NodeModulesInfo, \n  AgeCategory, \n  SizeCategory,\n  SortOption \n} from './types.js';\nimport { SIZE_THRESHOLDS, AGE_THRESHOLDS } from './types.js';\n\n// Re-export for convenience\nexport { SIZE_THRESHOLDS, AGE_THRESHOLDS };\n\n/**\n * Statistics calculated from a list of node_modules.\n * Used for summary displays and overview headers.\n */\nexport interface ScanStatistics {\n  /** Total number of projects found */\n  totalProjects: number;\n  \n  /** Total number of node_modules directories */\n  totalNodeModules: number;\n  \n  /** Total size of all node_modules in bytes */\n  totalSizeBytes: number;\n  \n  /** Total size formatted as human-readable string */\n  totalSizeFormatted: string;\n  \n  /** Number of selected node_modules */\n  selectedCount: number;\n  \n  /** Total size of selected node_modules */\n  selectedSizeBytes: number;\n  \n  /** Total size of selected formatted */\n  selectedSizeFormatted: string;\n  \n  /** Average age in days */\n  averageAgeDays: number;\n  \n  /** Number of stale node_modules (>30 days) */\n  staleCount: number;\n}\n\n/**\n * Format bytes into human-readable string.\n * Uses binary units (MiB, GiB) for accuracy.\n * \n * @param bytes - Number of bytes to format\n * @returns Formatted string like \"1.2 GB\" or \"456 MB\"\n */\nexport function formatBytes(bytes: number): string {\n  if (bytes === 0) return '0 B';\n  \n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const base = 1024;\n  const exponent = Math.floor(Math.log(bytes) / Math.log(base));\n  const unit = units[Math.min(exponent, units.length - 1)];\n  const value = bytes / Math.pow(base, exponent);\n  \n  // Show 1 decimal place for MB and above, 0 for smaller\n  const decimals = exponent >= 2 ? 1 : 0;\n  return `${value.toFixed(decimals)} ${unit}`;\n}\n\n/**\n * Parse human-readable size string into bytes.\n * Supports formats like \"1gb\", \"500MB\", \"10mb\"\n * \n * @param sizeStr - Size string to parse\n * @returns Size in bytes, or undefined if invalid\n */\nexport function parseSize(sizeStr: string): number | undefined {\n  const match = sizeStr.trim().toLowerCase().match(/^(\\d+(?:\\.\\d+)?)\\s*(b|kb|mb|gb|tb)?$/);\n  if (!match) return undefined;\n  \n  const value = parseFloat(match[1]);\n  const unit = match[2] || 'b';\n  \n  const multipliers: Record<string, number> = {\n    b: 1,\n    kb: 1024,\n    mb: 1024 * 1024,\n    gb: 1024 * 1024 * 1024,\n    tb: 1024 * 1024 * 1024 * 1024,\n  };\n  \n  return Math.floor(value * (multipliers[unit] || 1));\n}\n\n/**\n * Format a date into \"X days ago\" string.\n * Provides more readable relative time than raw dates.\n * \n * @param date - Date to format\n * @returns Formatted string like \"30d ago\" or \"2d ago\"\n */\nexport function formatRelativeTime(date: Date): string {\n  const now = new Date();\n  const diffMs = now.getTime() - date.getTime();\n  const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n  \n  if (diffDays === 0) {\n    const diffHours = Math.floor(diffMs / (1000 * 60 * 60));\n    if (diffHours === 0) {\n      const diffMinutes = Math.floor(diffMs / (1000 * 60));\n      return diffMinutes <= 1 ? 'just now' : `${diffMinutes}m ago`;\n    }\n    return `${diffHours}h ago`;\n  }\n  \n  if (diffDays < 30) return `${diffDays}d ago`;\n  if (diffDays < 365) return `${Math.floor(diffDays / 30)}mo ago`;\n  return `${Math.floor(diffDays / 365)}y ago`;\n}\n\n/**\n * Determine size category based on bytes.\n * Used for color coding and smart selection.\n * \n * @param bytes - Size in bytes\n * @returns Size category\n */\nexport function getSizeCategory(bytes: number): SizeCategory {\n  if (bytes > SIZE_THRESHOLDS.LARGE) return 'huge';\n  if (bytes > SIZE_THRESHOLDS.MEDIUM) return 'large';\n  if (bytes > SIZE_THRESHOLDS.SMALL) return 'medium';\n  return 'small';\n}\n\n/**\n * Determine age category based on days since modification.\n * Used to identify potentially stale node_modules.\n * \n * @param lastModified - Last modification date\n * @returns Age category\n */\nexport function getAgeCategory(lastModified: Date): AgeCategory {\n  const now = new Date();\n  const diffDays = Math.floor((now.getTime() - lastModified.getTime()) / (1000 * 60 * 60 * 24));\n  \n  if (diffDays > AGE_THRESHOLDS.OLD) return 'stale';\n  if (diffDays > AGE_THRESHOLDS.RECENT) return 'old';\n  if (diffDays > AGE_THRESHOLDS.FRESH) return 'recent';\n  return 'fresh';\n}\n\n/**\n * Calculate age in days from a date.\n * \n * @param date - Date to calculate age from\n * @returns Number of days\n */\nexport function getAgeInDays(date: Date): number {\n  const now = new Date();\n  return Math.floor((now.getTime() - date.getTime()) / (1000 * 60 * 60 * 24));\n}\n\n/**\n * Sort node_modules by the specified option.\n * Pure function that returns a new sorted array.\n * \n * @param items - Array to sort\n * @param sortBy - Sort option\n * @returns New sorted array\n */\nexport function sortNodeModules(\n  items: NodeModulesInfo[],\n  sortBy: SortOption\n): NodeModulesInfo[] {\n  const sorted = [...items]; // Create copy to avoid mutation\n  \n  switch (sortBy) {\n    case 'size-desc':\n      return sorted.sort((a, b) => b.sizeBytes - a.sizeBytes);\n    case 'size-asc':\n      return sorted.sort((a, b) => a.sizeBytes - b.sizeBytes);\n    case 'date-desc':\n      return sorted.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());\n    case 'date-asc':\n      return sorted.sort((a, b) => a.lastModified.getTime() - b.lastModified.getTime());\n    case 'name-asc':\n      return sorted.sort((a, b) => a.projectName.localeCompare(b.projectName));\n    case 'name-desc':\n      return sorted.sort((a, b) => b.projectName.localeCompare(a.projectName));\n    case 'packages-desc':\n      return sorted.sort((a, b) => b.totalPackageCount - a.totalPackageCount);\n    case 'packages-asc':\n      return sorted.sort((a, b) => a.totalPackageCount - b.totalPackageCount);\n    default:\n      return sorted;\n  }\n}\n\n/**\n * Filter node_modules by search query.\n * Matches against project name and path.\n * \n * @param items - Array to filter\n * @param query - Search query (case-insensitive)\n * @returns Filtered array\n */\nexport function filterNodeModules(\n  items: NodeModulesInfo[],\n  query: string\n): NodeModulesInfo[] {\n  if (!query.trim()) return items;\n  \n  const lowerQuery = query.toLowerCase();\n  return items.filter(item => \n    item.projectName.toLowerCase().includes(lowerQuery) ||\n    item.path.toLowerCase().includes(lowerQuery)\n  );\n}\n\n/**\n * Calculate statistics from node_modules list.\n * Used for overview displays and summaries.\n * \n * @param items - Node modules to analyze\n * @returns Calculated statistics\n */\nexport function calculateStatistics(items: NodeModulesInfo[]): ScanStatistics {\n  const selectedItems = items.filter(item => item.selected);\n  const totalSize = items.reduce((sum, item) => sum + item.sizeBytes, 0);\n  const selectedSize = selectedItems.reduce((sum, item) => sum + item.sizeBytes, 0);\n  \n  const totalAge = items.reduce((sum, item) => {\n    return sum + getAgeInDays(item.lastModified);\n  }, 0);\n  \n  const staleCount = items.filter(item => item.ageCategory === 'stale').length;\n  \n  return {\n    totalProjects: new Set(items.map(item => item.projectPath)).size,\n    totalNodeModules: items.length,\n    totalSizeBytes: totalSize,\n    totalSizeFormatted: formatBytes(totalSize),\n    selectedCount: selectedItems.length,\n    selectedSizeBytes: selectedSize,\n    selectedSizeFormatted: formatBytes(selectedSize),\n    averageAgeDays: items.length > 0 ? Math.round(totalAge / items.length) : 0,\n    staleCount,\n  };\n}\n\n/**\n * Check if a path should be excluded based on patterns.\n * Supports glob-like patterns with * and ? wildcards.\n * \n * @param path - Path to check\n * @param patterns - Exclusion patterns\n * @returns True if path should be excluded\n */\nexport function shouldExcludePath(path: string, patterns: string[]): boolean {\n  return patterns.some(pattern => {\n    // Convert glob pattern to regex\n    const regexPattern = pattern\n      .replace(/\\*\\*/g, '{{GLOBSTAR}}')\n      .replace(/\\*/g, '[^/]*')\n      .replace(/\\?/g, '.')\n      .replace(/\\{\\{GLOBSTAR\\}\\}/g, '.*');\n    \n    const regex = new RegExp(regexPattern, 'i');\n    return regex.test(path);\n  });\n}\n\n/**\n * Toggle selection state for a node_modules item.\n * Returns new array with toggled item (immutable update).\n * \n * @param items - Current items array\n * @param index - Index of item to toggle\n * @returns New array with toggled selection\n */\nexport function toggleSelection(\n  items: NodeModulesInfo[],\n  index: number\n): NodeModulesInfo[] {\n  if (index < 0 || index >= items.length) return items;\n  \n  return items.map((item, i) => \n    i === index ? { ...item, selected: !item.selected } : item\n  );\n}\n\n/**\n * Select or deselect all items matching a predicate.\n * Useful for \"select all >500MB\" or \"select all stale\" operations.\n * \n * @param items - Current items array\n * @param predicate - Function to determine which items to select\n * @param selected - Whether to select (true) or deselect (false)\n * @returns New array with updated selections\n */\nexport function selectByPredicate(\n  items: NodeModulesInfo[],\n  predicate: (item: NodeModulesInfo) => boolean,\n  selected: boolean\n): NodeModulesInfo[] {\n  return items.map(item => \n    predicate(item) ? { ...item, selected } : item\n  );\n}\n\n/**\n * Get a color for a size category.\n * Used for consistent visual feedback across the TUI.\n * \n * @param category - Size category\n * @returns Color name for Ink Text component\n */\nexport function getSizeColor(category: SizeCategory): string {\n  switch (category) {\n    case 'huge': return 'red';\n    case 'large': return 'yellow';\n    case 'medium': return 'cyan';\n    case 'small': return 'green';\n    default: return 'white';\n  }\n}\n\n/**\n * Get a color for an age category.\n * \n * @param category - Age category\n * @returns Color name for Ink Text component\n */\nexport function getAgeColor(category: AgeCategory): string {\n  switch (category) {\n    case 'stale': return 'gray';\n    case 'old': return 'yellow';\n    case 'recent': return 'cyan';\n    case 'fresh': return 'green';\n    default: return 'white';\n  }\n}\n\n/**\n * Truncate a string to fit within a maximum length.\n * Adds ellipsis if truncated.\n * \n * @param str - String to truncate\n * @param maxLength - Maximum length\n * @returns Truncated string\n */\nexport function truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  if (maxLength <= 3) return str.slice(0, maxLength);\n  return str.slice(0, maxLength - 3) + '...';\n}\n\n/**\n * Safe file existence check that doesn't throw.\n * Useful for checking if package.json exists before parsing.\n * \n * @param path - Path to check\n * @returns True if file exists\n */\nexport async function fileExists(path: string): Promise<boolean> {\n  try {\n    await fs.access(path);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read and parse package.json safely.\n * Returns undefined if file doesn't exist or is invalid.\n * \n * @param projectPath - Path to project directory\n * @returns Parsed package.json or undefined\n */\nexport async function readPackageJson(\n  projectPath: string\n): Promise<{ name?: string; version?: string } | undefined> {\n  const packagePath = join(projectPath, 'package.json');\n  \n  try {\n    const content = await fs.readFile(packagePath, 'utf-8');\n    const parsed = JSON.parse(content) as { name?: string; version?: string };\n    return parsed;\n  } catch {\n    return undefined;\n  }\n}\n","/**\n * oh-my-node-modules - Public API\n * \n * This module exports the public API for programmatic use.\n * Most users will use the CLI, but the API is available for\n * integration with other tools.\n * \n * @example\n * ```typescript\n * import { scanForNodeModules, deleteSelectedNodeModules } from 'oh-my-node-modules';\n * \n * const result = await scanForNodeModules({\n *   rootPath: '/path/to/projects',\n *   excludePatterns: [],\n *   followSymlinks: false,\n * });\n * \n * // ... process results ...\n * ```\n */\n\n// Core types\nexport type {\n  NodeModulesInfo,\n  AgeCategory,\n  SizeCategory,\n  SortOption,\n  ScanOptions,\n  DeleteOptions,\n  DeletionResult,\n  DeletionDetail,\n  AppState,\n  CliArgs,\n  ScanStatistics,\n  ColorConfig,\n} from './types.js';\n\n// Core functions\nexport { scanForNodeModules, analyzeNodeModules, quickScan, loadIgnorePatterns, loadFavorites, isNodeModulesInUse } from './scanner.js';\nexport { deleteSelectedNodeModules, generateDeletionPreview, generateJSONReport, selectBySize, selectByAge, selectAll, invertSelection } from './deletion.js';\nexport {\n  formatBytes,\n  parseSize,\n  formatRelativeTime,\n  getSizeCategory,\n  getAgeCategory,\n  sortNodeModules,\n  filterNodeModules,\n  calculateStatistics,\n  toggleSelection,\n  selectByPredicate,\n} from './utils.js';\n\n// Constants\nexport { SIZE_THRESHOLDS, AGE_THRESHOLDS, DEFAULT_COLORS } from './types.js';\n\n// Version\nexport const VERSION = '1.0.0';\n"],"names":["ScanStatistics"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,kBAAA,IAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,iBAAA,WAAA;AACA;AACA,kBAAA,YAAA;AACA;AACA;AACA;AACA;AACA;AACO,KAAA,WAAA;AACP;AACA;AACA;AACA;AACO,KAAA,YAAA;AACP;AACA;AACA;AACA;AACO,KAAA,UAAA;AACP;AACA;AACA;AACA;AACO,UAAA,WAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAA,aAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,aAAA,cAAA;AACA;AACA;AACA;AACA;AACO,UAAA,cAAA;AACP;AACA,iBAAA,eAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAA,QAAA;AACP;AACA,iBAAA,eAAA;AACA;AACA;AACA;AACA,YAAA,UAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAMA;AACA;AACA;AACA;AACO,UAAA,OAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAAA,gBAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,UAAA,WAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,cAAA,EAAA,WAAA;AACP;AACA;AACA;AACA;AACO,cAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,cAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;;ACxPA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA,UAAA,UAAA;AACA;AACA,iBAAA,eAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,UAAA,WAAA,4CAAA,OAAA,CAAA,UAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,gDAAA,OAAA,CAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,IAAA,OAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,aAAA,IAAA,OAAA,CAAA,GAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,gBAAA,OAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,SAAA,oBAAA,OAAA,CAAA,KAAA;AACP;AACA;AACA;AACA;;AC1FA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,yBAAA,cAAA,eAAA,aAAA,aAAA,+EAAA,OAAA,CAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,uBAAA,cAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,SAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,YAAA,cAAA,eAAA,2BAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,WAAA,cAAA,eAAA,yBAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,SAAA,cAAA,eAAA,wBAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,eAAA,cAAA,eAAA,KAAA,eAAA;;AC/EP;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACO,UAAA,cAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,WAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,SAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,kBAAA,OAAA,IAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,eAAA,iBAAA,YAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,cAAA,eAAA,IAAA,GAAA,WAAA;AAQP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,eAAA,QAAA,eAAA,YAAA,UAAA,GAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,iBAAA,QAAA,eAAA,oBAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,mBAAA,QAAA,eAAA,KAAA,cAAA;AAUP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,eAAA,QAAA,eAAA,oBAAA,eAAA;AACP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,iBAAA,iBAAA,QAAA,eAAA,sBAAA,eAAA,kCAAA,eAAA;;ACtIP;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMO,cAAA,OAAA;;;;"}