update

Author: codechenx

README.md

@@ -10,9 +10,10 @@
 
 
 <p align="center">
-   <img src="data/icon-192x192.png" alt="tv icon"/>
+   <img src="data/icon_white.png"  style="width:150px;" alt="tv icon"/>
 </p>
 
+
 ## Demo
 
 [![asciicast](https://asciinema.org/a/AL2UvtQBxa00Aa44rhsmqj5mn.svg)](https://asciinema.org/a/AL2UvtQBxa00Aa44rhsmqj5mn)
@@ -34,6 +35,7 @@
   - [Search](#search)
   - [Column Filter](#column-filter)
   - [Text Wrapping](#text-wrapping)
+- [Filter Operators Guide](FILTER_OPERATORS.md)
 - [Advanced Examples](#advanced-examples)
   - [Biological Data Formats](#biological-data-formats)
 
@@ -45,12 +47,13 @@ tv brings spreadsheet-like functionality to your terminal with vim-inspired cont
 - **Smart parsing** - Automatically detects delimiters (CSV, TSV, custom separators)
 - **Progressive loading** - Start viewing large files immediately while they load
 - **Gzip support** - Read compressed files directly
-- **Powerful search** - Find text across all cells with highlighting
-- **Column filtering** - Show only rows matching specific criteria
+- **Powerful search** - Find text across all cells with highlighting and regex pattern matching support
+- **Advanced filtering** - Filter rows with complex regex queries
 - **Flexible sorting** - Sort by any column with intelligent type detection
 - **Text wrapping** - Wrap long cell content for better readability
 - **Statistics & plots** - View column statistics with visual distribution charts
 - **Vim keybindings** - Navigate naturally with h/j/k/l and more
+- **Mouse support** - Click to select cells, scroll with mouse wheel, interact with dialogs
 - **Pipe support** - Read from stdin for seamless integration with shell pipelines
 
 
@@ -219,9 +222,9 @@ tv uses vim-inspired keybindings for intuitive navigation.
 | `/` | Search |
 | `n` | Next search result |
 | `N` | Previous search result |
-| `Ctrl-/` | Clear search |
-| `f` | Filter by column value |
-| `r` | Reset/clear filter |
+| `Esc` | Clear search highlighting / Close dialogs |
+| `f` | Filter by column |
+| `r` | Remove filter for current column |
 | `s` | Sort ascending |
 | `S` | Sort descending |
 | `t` | Toggle column type (String → Number → Date) |
@@ -231,6 +234,18 @@ tv uses vim-inspired keybindings for intuitive navigation.
 | `Esc` | Close dialogs / clear search |
 | `q` | Quit |
 
+### Mouse Support
+
+| Action | Behavior |
+|--------|----------|
+| **Left Click** | Select cell at click position |
+| **Scroll Wheel Up** | Scroll up one row |
+| **Scroll Wheel Down** | Scroll down one row |
+| **Click on Buttons** | Activate buttons in dialogs (Search, Filter, Stats) |
+| **Click on Checkboxes** | Toggle checkboxes in forms (e.g., "Use Regex") |
+
+**Note:** Mouse support works in most modern terminals. If your terminal doesn't support mouse events, you can still use keyboard navigation exclusively.
+
 ## Features in Detail
 
 ### Progressive Loading
@@ -282,53 +297,158 @@ Analyze your data with comprehensive statistics and modern ASCII plots.
 - Frequency distribution with percentages
 - **Visual distribution:** Bar chart of top 15 most frequent values
 
+**Important:** When column filters are active, statistics are calculated **only on the filtered/visible data**, not the entire dataset. The dialog title will indicate when statistics are based on filtered data and show the number of active filters.
+
 The statistics dialog features a split-pane layout with numerical stats on the left and an ASCII graph visualization on the right, powered by `asciigraph` for modern, clean plots.
 
 ### Search
 
-Find text anywhere in your table with full highlighting support.
+Find text anywhere in your table with full highlighting support and powerful regex pattern matching.
 
 **How to search:**
 
 1. Press `/` to open the search dialog
-2. Type your search term (case-insensitive)
-3. Press Enter to execute
-4. Navigate results with `n` (next) and `N` (previous)
-5. Press `Ctrl-/` to clear highlighting
+2. Type your search term.
+3. **Optional:** Press Tab to navigate to the checkboxes, then Space to enable:
+    - **Use Regex**: for pattern matching with regular expressions.
+    - **Case Sensitive**: for case-sensitive matching.
+4. Press Enter to execute the search.
+5. Navigate results with `n` (next) and `N` (previous).
+6. Press `Esc` to clear highlighting.
+
+**Search Modes:**
+
+- **Plain Text (default):** Case-insensitive substring matching. Enable `Case Sensitive` for exact matching.
+- **Regex:** Full regular expression support. By default, regex is case-insensitive. Enable `Case Sensitive` for case-sensitive regex matching.
+
+**Navigation in Search Dialog:**
+- Type your search query in the text field.
+- Press `Tab` to move between the search field, checkboxes, and buttons.
+- Press `Space` to toggle a checkbox when it is focused.
+- Press `Enter` from anywhere in the form to execute the search.
+- Press `Esc` to cancel and close the dialog.
 
 **Visual feedback:**
 - Current match: bright cyan highlight
 - Other matches: gray highlight
-- Footer shows position: `Match 3/12`
+- Footer shows position: `Match 3/12` or `regex matches 3/12`
 
 **Example:**
 ```
-/ → type "error" → Enter → n → n → N → Ctrl-/
+# Simple text search (case-insensitive)
+/ → type "error" → Enter → n → n → N → Esc
+
+# Case-sensitive text search
+/ → check "Case Sensitive" → type "Error" → Enter
+
+# Regex search examples
+/ → check "Use Regex" → type "^ERROR" → Enter     # Lines starting with ERROR (case-insensitive)
+/ → check "Use Regex" and "Case Sensitive" → type "^Error" → Enter # Lines starting with Error (case-sensitive)
+/ → check "Use Regex" → type "\\d{4}-\\d{2}-\\d{2}" → Enter     # Date patterns (YYYY-MM-DD)
+/ → check "Use Regex" → type "user(name)?" → Enter           # Match "user" or "username"
+/ → check "Use Regex" → type "error|warning|critical" → Enter # Match any of these words
+/ → check "Use Regex" → type "@.*\\.(com|org)$" → Enter       # Email domains ending in .com or .org
 ```
 
+**Common Regex Patterns:**
+
+| Pattern | Description | Example Match |
+|---------|-------------|---------------|
+| `^start` | Match at beginning of cell | `^Error` matches "Error: failed" |
+| `end$` | Match at end of cell | `\\.txt$` matches "file.txt" |
+| `\\d+` | Match one or more digits | `\\d+` matches "123" |
+| `\\w+@\\w+\\.\\w+` | Match email pattern | Matches "user@example.com" |
+| `word1\\|word2` | Match either word (OR) | `success\\|complete` matches either |
+| `[A-Z]+` | Match uppercase letters | `[A-Z]{3}` matches "USA" |
+| `.*` | Match any characters | `start.*end` matches "start...end" |
+| `\\s+` | Match whitespace | `\\s{2,}` matches 2+ spaces |
+
+**Note:** For case-insensitive regex search, the `(?i)` flag is automatically added to your pattern. For case-sensitive regex, this flag is omitted.
+
 ### Column Filter
 
-Show only rows where a specific column matches your criteria.
+Show only rows where specific columns match your criteria. **Supports filtering on multiple columns simultaneously**.
 
 **How to filter:**
 
 1. Navigate to the column you want to filter
 2. Press `f` to open the filter dialog
-3. Type filter text (case-insensitive, partial match)
-4. Press Enter to apply
-5. Press `r` to reset and show all rows
+3. Use the dropdown to select an operator (e.g., `contains`, `equals`, `regex`, `>`).
+4. Enter the value to filter by.
+5. Optionally, check the `Case Sensitive` box.
+6. Press Enter to apply the filter.
+7. **Repeat on other columns to add more filters**
+8. Press `r` on a filtered column to remove that column's filter
+
+**Multi-Column Filtering:**
+
+- Apply filters to **multiple columns** by pressing `f` on each column and entering criteria
+- All filters are combined with AND logic (rows must match all active filters)
+- Each column can have different filter criteria including operators
+- Press `f` on a filtered column to edit or remove its filter (empty query removes the filter)
+- The footer shows how many filters are active
+- Filtered column headers display 🔎 icons with orange background
+
+**Operators:**
+
+| Operator | Description |
+|---|---|
+| `contains` | Matches cells containing the term |
+| `equals` | Matches cells that are exactly the term |
+| `starts with` | Matches cells that start with the term |
+| `ends with` | Matches cells that end with the term |
+| `regex` | Matches cells based on a regular expression |
+| `>` | Numeric: greater than (number columns only) |
+| `<` | Numeric: less than (number columns only) |
+| `>=` | Numeric: greater than or equal (number columns only) |
+| `<=` | Numeric: less than or equal (number columns only) |
+
+**Key Features:**
+- **Numeric operators** (`>`, `<`, `>=`, `<=`): Only work on numeric and date columns (automatically detected). Perform numeric comparisons instead of text matching.
+- **Regex**: Provides the full power of regular expressions for complex pattern matching.
+- **Case-Insensitive by default**: All string-based comparisons are case-insensitive unless the `Case Sensitive` box is checked.
+- **Visual indicator**: Filtered column headers show 🔎 icons and an orange background
 
-**Features:**
-- Partial matching: "act" matches "active", "action", "react"
-- Header always visible
-- Footer shows filtered row count
+**Examples:**
 
-**Example:**
-```
-Navigate to "Status" column → f → type "pending" → Enter
+```bash
+# Simple filter - partial match
+Navigate to "Status" column → f → select 'contains' → type "pending" → Enter
+# Result: Matches "Pending", "Pending Review", etc.
+
+# Exact match filter
+Navigate to "Status" column → f → select 'equals' → type "active" → Enter
+# Result: Rows where Status is exactly "active" (case-insensitive)
+
+# Regex filter
+Navigate to "Email" column → f → select 'regex' → type "^.+@gmail\.com$" → Enter
+# Result: Rows where Email ends with "@gmail.com"
+
+# Numeric comparison - greater than
+Navigate to "Age" column → f → select '>' → type "30" → Enter
+# Result: Rows where Age is greater than 30
+
+# Multi-column filtering
+Navigate to "City" column → f → select 'equals' → type "New York" → Enter
+Navigate to "Department" column → f → select 'contains' → type "Engineering" → Enter
+# Result: Rows where City is "New York" AND Department contains "Engineering"
+
+# Edit existing filter
+Navigate to filtered column → f → modify operator/value → Enter
+# Or enter empty text to remove that column's filter
+
+# Remove a specific filter
+Navigate to filtered column → Press r
+# Result: That column's filter removed, other filters remain
 ```
 
-Now only rows where Status contains "pending" are displayed.
+**Visual Feedback:**
+- When a filter is active, the filtered column header displays 🔎 icons and an orange background
+- A dedicated **filter strip** appears above the main footer showing the active filter on the current column.
+- Filter strip format: `🔎 Filter Active: [Column Name] [operator] "query"  |  Press 'r' to clear`
+- The strip automatically hides when you move to a different column
+- Press `r` to clear the filter and return to normal view
+
 
 ### Text Wrapping
 
@@ -434,7 +554,9 @@ tv data.txt -s "  "
 - **Too many columns?** Use `--columns` to show only what you need
 - **Long text?** Press `W` to wrap the current column
 - **Wrong sort order?** Press `t` to change the column type, then `s` to re-sort
+- **Complex filtering?** Use `OR` for alternatives, `AND` for requirements, `ROR` to combine results
 - **Need insights?** Press `i` for comprehensive statistics with visual plots - histograms for numeric data, frequency charts for categorical data
+- **Prefer mouse?** Click cells to select them, use scroll wheel to navigate, and click buttons in dialogs
 
 ## License
 

buffer.go

@@ -2,6 +2,7 @@ package main
 
 import (
 	"errors"
+	"regexp"
 	"sort"
 	"strconv"
 	"strings"
@@ -274,8 +275,6 @@ func parseDateValueFast(s string) int64 {
 	return 0
 }
 
-
-
 // getCol returns the ith column data as a string slice
 // Uses pointer receiver to avoid copying mutex
 func (b *Buffer) getCol(i int) []string {
@@ -502,9 +501,16 @@ func (b *Buffer) selectBySearch(s string) {
 	}
 }
 
-// filterByColumn filters rows based on column value containing the search string
-// Returns a new filtered buffer
-func (b *Buffer) filterByColumn(colIndex int, query string, caseSensitive bool) *Buffer {
+// FilterOptions defines the parameters for a column filter.
+type FilterOptions struct {
+	Query         string
+	Operator      string
+	CaseSensitive bool
+}
+
+// filterByColumn filters rows based on column value using the provided options.
+// It returns a new buffer containing the filtered rows.
+func (b *Buffer) filterByColumn(colIndex int, options FilterOptions) *Buffer {
 	b.mu.RLock()
 	defer b.mu.RUnlock()
 
@@ -517,11 +523,17 @@ func (b *Buffer) filterByColumn(colIndex int, query string, caseSensitive bool)
 	copy(filtered.colType, b.colType)
 
 	// Add header row if present
-	if b.rowFreeze > 0 {
+	if b.rowFreeze > 0 && b.rowLen > 0 {
 		filtered.cont = append(filtered.cont, b.cont[0])
 		filtered.rowLen = 1
 	}
 
+	// Get column type for numeric comparisons
+	colType := colTypeStr
+	if colIndex < len(b.colType) {
+		colType = b.colType[colIndex]
+	}
+
 	// Filter data rows
 	startRow := b.rowFreeze
 	for i := startRow; i < b.rowLen; i++ {
@@ -530,18 +542,77 @@ func (b *Buffer) filterByColumn(colIndex int, query string, caseSensitive bool)
 		}
 
 		cellValue := b.cont[i][colIndex]
-		queryStr := query
-
-		if !caseSensitive {
-			cellValue = toLowerSimple(cellValue)
-			queryStr = toLowerSimple(query)
-		}
 
-		if containsStr(cellValue, queryStr) {
+		// Evaluate filter condition
+		if evaluateFilter(cellValue, options, colType) {
 			filtered.cont = append(filtered.cont, b.cont[i])
 			filtered.rowLen++
 		}
 	}
 
 	return filtered
 }
+
+// evaluateFilter checks if a cell value matches the filter query based on the operator.
+func evaluateFilter(cellValue string, options FilterOptions, colType int) bool {
+	query := options.Query
+	operator := options.Operator
+
+	// Handle numeric comparisons first
+	if colType == colTypeFloat || colType == colTypeDate {
+		isNumericOperator := false
+		switch operator {
+		case ">", "<", ">=", "<=":
+			isNumericOperator = true
+		}
+
+		if isNumericOperator {
+			cellVal := parseNumericValueFast(cellValue)
+			thresholdVal, err := strconv.ParseFloat(strings.TrimSpace(query), 64)
+			if err != nil {
+				return false // Cannot compare if query is not a number
+			}
+
+			switch operator {
+			case ">":
+				return cellVal > thresholdVal
+			case "<":
+				return cellVal < thresholdVal
+			case ">=":
+				return cellVal >= thresholdVal
+			case "<=":
+				return cellVal <= thresholdVal
+			}
+		}
+	}
+
+	// Prepare strings for comparison
+	cell := cellValue
+	q := query
+	if !options.CaseSensitive {
+		cell = strings.ToLower(cell)
+		q = strings.ToLower(q)
+	}
+
+	// Handle string-based operators
+	switch operator {
+	case "contains":
+		return strings.Contains(cell, q)
+	case "equals":
+		return cell == q
+	case "starts with":
+		return strings.HasPrefix(cell, q)
+	case "ends with":
+		return strings.HasSuffix(cell, q)
+	case "regex":
+		// When using regex, the user has full control over case sensitivity in the pattern.
+		re, err := regexp.Compile(options.Query)
+		if err != nil {
+			return false // Invalid regex
+		}
+		return re.MatchString(cellValue)
+	default:
+		// Default to contains for backward compatibility if operator is empty
+		return strings.Contains(cell, q)
+	}
+}