hyperlist 1.9.0 → 1.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f638bfa971829555f7f078ed1c2e5a498a3e0d4026dea67fd547bc881fdec61
-  data.tar.gz: 3cbb6c08d664e5ed7111384ef275293c9616c8c213f3cc189beaf1e3054fbfac
+  metadata.gz: bb81e544d2363e852a1e29bb1eef3d2fd891e766b2ade2a3e5c56fdc3073302e
+  data.tar.gz: 14f24e55bfb6f3241ef9120cadcc680971617bfa5378893c3523e4eb1cb1105b
 SHA512:
-  metadata.gz: a71a5cfa04c8e52652f990d970f6fc7a1e65a5a89a9869b558937a016ae7c8e2aa0017910a23941158abbbfb6c8d92a2f0b8d50075cb3cb303d06c04f62c876d
-  data.tar.gz: cccf1614ea64a35296d0de28b35d3ca3098fc31d68296cb271ef93ca5e085ffc2801fac04b98df96c72340b00adb39003fbcb55651f5561fe7e3a36ecf63a9e6
+  metadata.gz: 067b8ba96f97768aa5461e2458b7215cf045926875765ac631b450c9a15ed2313ded67f7986163c6fef8c5408dddf0160a10fa7933ffedbe23722822078e9060
+  data.tar.gz: c10a7a1e147fadd212445b9d5ee7baadada737f53ccc55aa89db86f95f2cb208edf1d56a373020c4ac51c5a898e5c2198cb1458cccbfea36526dff104cfe61a7

data/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to the HyperList Ruby TUI will be documented in this file.
 
+## [1.9.2] - 2025-12-02
+
+### Fixed
+- **Presentation mode completely rewritten**
+  - Now dynamically folds/unfolds as you navigate (like hyperlist.vim)
+  - Entering presentation mode (C-P) now stays on the current item instead of jumping to the first line
+  - Moving up/down properly reveals the path to the current item while folding everything else
+  - Uses proper item tracking via real indices to handle fold state changes correctly
+
+## [1.9.1] - 2025-12-02
+
+### Added
+- **External file change detection**
+  - Automatically detects when the file is modified by other processes (vim, another Claude Code session, etc.)
+  - Prompts user to reload with "File changed externally. Reload? (y/n)"
+  - Preserves cursor position after reload
+  - Option to ignore external changes (updates internal timestamp to avoid repeated prompts)
+
+### Fixed
+- **Quote coloring inside parentheses (comments)**
+  - Fixed issue where quotes inside parentheses like `(this is a "comment" in here)` would break the cyan coloring
+  - The closing quote would terminate coloring, leaving the rest of the comment white
+  - Now the entire parentheses content stays cyan as intended
+
+## [1.9.0] - 2025-10-24
+
+### Added
+- **Item Tagging & Batch Operations**
+  - Tag items with 't' key for batch operations (auto-advance cursor)
+  - Visual feedback: dark blue background for tagged items, lighter blue for tagged+selected
+  - Status bar shows [T:N] count of tagged items
+  - Clear all tags with 'u' key
+  - Regex tagging with 'C-T' - tag all items matching a pattern
+  - Batch operations: D/C-D (delete), y/Y (yank), Tab/S-Tab (indent) work on all tagged items
+
+- **External Editor Support**
+  - Press 'E' to spawn $EDITOR (vim, nano, etc.)
+  - Automatic save/reload workflow
+  - Proper terminal state management
+  - Full screen refresh on return
+
+- **Enhanced Paste & Navigation**
+  - 'P' to paste above current item (vim-style)
+  - Presentation mode moved to 'C-P'
+  - Templates moved to 'T' key
+  - Undo moved to 'U' key (RTFM-consistent)
+
+### Enhanced
+- **Smart Modified Flag**
+  - [+] indicator removed when undoing back to original file state
+  - Tracks original state to detect true modifications
+
 ## [1.8.0] - 2025-09-22
 
 ### Enhanced

data/README.md

@@ -29,9 +29,28 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 ### Help Screen
 ![HyperList Help](img/screenshot_help.png)
 
-## What's New in v1.9.0
+## What's New in v1.9.2
 
-### 🏷️ Item Tagging & Batch Operations
+### Presentation Mode Fixed
+- **Dynamic folding**: Presentation mode now works like hyperlist.vim - folds/unfolds dynamically as you navigate
+- **Cursor preservation**: Entering presentation mode (C-P) stays on the current item instead of jumping to the first line
+- **Proper navigation**: Moving up/down reveals the path to the current item while folding everything else
+
+## Previous Release: v1.9.1
+
+### External File Change Detection
+- **Auto-detect external changes**: HyperList now monitors when the file is modified by other processes (vim, another Claude Code session, etc.)
+- **Reload prompt**: Shows "File changed externally. Reload? (y/n)" when changes are detected
+- **Cursor preservation**: Your cursor position is preserved after reload
+- **Skip option**: Press 'n' to ignore external changes and continue editing
+
+### Bug Fix: Quote Coloring in Comments
+- Fixed an issue where quotes inside parentheses (comments) like `(this is a "comment" in here)` would break the cyan coloring
+- The entire parentheses content now stays cyan as intended
+
+## Previous Release: v1.9.0
+
+### Item Tagging & Batch Operations
 - **Tag items**: Press 't' to tag/untag items for batch operations
 - **Auto-advance**: Cursor automatically moves to next item after tagging for fast consecutive tagging
 - **Visual feedback**: Tagged items show dark blue background, lighter blue when selected
@@ -41,47 +60,47 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 - **Batch operations**: Delete (D/C-D), yank (y/Y), and indent (Tab/S-Tab) work on all tagged items
 - Tag consecutive or non-consecutive items, then perform operations on the entire set
 
-### ✏️ External Editor Support
+### External Editor Support
 - **Edit in $EDITOR**: Press 'E' to spawn your preferred editor (vim, nano, emacs, etc.)
 - **Seamless workflow**: File saved automatically, editor launched, changes reloaded on exit
 - **Terminal management**: Terminal state properly saved and restored
 - Uses `$EDITOR` environment variable (defaults to vi if not set)
 
-### 📋 Enhanced Paste & Navigation
+### Enhanced Paste & Navigation
 - **Paste above**: Press 'P' to paste above current item (vim-style)
 - **Paste below**: Press 'p' to paste below current item (existing)
 - **Presentation mode**: Moved to 'C-P' (was 'P') for consistency
 - **Templates**: Moved to 'T' key (was 't')
 - **Undo**: Moved to 'U' key (was 'u') - consistent with RTFM
 
-### 🎯 Smart Modified Flag
+### Smart Modified Flag
 - **Intelligent tracking**: `[+]` indicator automatically removed when undoing back to original file state
 - **Clean status**: No false "modified" indicator after complete undo to original
 
 ## Previous Release: v1.8.0
 
-### 📋 Multi-Line Paste Support
+### Multi-Line Paste Support
 - **Paste multiple lines**: When pasting multi-line content into item insertion prompts ('o', 'O', 'a', 'A'), each line becomes a separate item
 - **Visual feedback**: Shows `[+N lines]` indicator during multi-line paste
 - **Smart insertion**: All pasted lines inserted as siblings at the same level
 - Great for importing bullet lists from PDFs, emails, or other documents
 - Requires rcurses 6.1.5+
 
-### 📄 PDF/LaTeX Export
+### PDF/LaTeX Export
 - **Export to PDF**: `:export pdf filename.pdf` - Full LaTeX-based PDF generation
 - **Export to LaTeX**: `:export latex filename.tex` - Get the LaTeX source
 - **Professional output**: Color-coded elements, table of contents, headers
 - **Complete HyperList support**: All syntax elements rendered beautifully
 - Requires: texlive-latex-base and texlive-latex-extra packages
 
-### 📋 System Clipboard Integration
+### System Clipboard Integration
 - **Yank to clipboard**: 'y' and 'Y' now copy to system clipboard
 - **Middle-click paste**: Yanked items can be pasted into other terminals
 - **Preserves indentation**: Copied text maintains proper structure
 
 ## Previous Version Features (v1.4.0)
 
-### 🎨 Configuration Lines & Theming
+### Configuration Lines & Theming
 - **Configuration Lines**: Add settings at the bottom of HyperList files using `((option=value, option2=value))`
 - **Theme Support**: Three color themes - `light` (bright colors), `normal` (standard), `dark` (for light terminals)
 - **Line Wrapping**: Enable with `wrap=yes` - wrapped lines use `+` prefix per HyperList spec
@@ -142,13 +161,13 @@ All `:set` commands automatically update the file's configuration line.
 - Secure AES-256-CBC encryption with PBKDF2 key derivation
 - Password caching for the session
 
-### 🎯 Enhanced Presentation Mode
+### Enhanced Presentation Mode
 - **Auto-collapse** everything outside the current context
 - **Smart focus**: Shows only current item, ancestors, and immediate children
 - **Visual hierarchy**: Focused items in full color, others greyed out
 - Improved navigation with proper cursor tracking
 
-### 🎨 Better Visual Experience
+### Better Visual Experience
 - **Improved highlighting**: Dark gray background preserves syntax colors
 - **Subtle selection**: No more harsh reverse video
 - **Preserved colors**: All HyperList elements maintain their colors when selected

data/hyperlist

@@ -7,7 +7,7 @@
 # Check for help/version BEFORE loading any libraries
 if ARGV[0] == '-h' || ARGV[0] == '--help'
   puts <<~HELP
-    HyperList v1.9.0 - Terminal User Interface for HyperList files
+    HyperList v1.9.2 - Terminal User Interface for HyperList files
     
     USAGE
       hyperlist [OPTIONS] [FILE]
@@ -52,7 +52,7 @@ if ARGV[0] == '-h' || ARGV[0] == '--help'
   HELP
   exit 0
 elsif ARGV[0] == '-v' || ARGV[0] == '--version'
-  puts "HyperList v1.9.0"
+  puts "HyperList v1.9.2"
   exit 0
 end
 
@@ -73,7 +73,7 @@ class HyperListApp
   include Rcurses::Input
   include Rcurses::Cursor
   
-  VERSION = "1.9.0"
+  VERSION = "1.9.2"
   
   def initialize(filename = nil)
     @filename = filename ? File.expand_path(filename) : nil
@@ -124,7 +124,8 @@ class HyperListApp
     @split_offset = 0  # Second view scroll offset
     @active_pane = :main  # :main or :split
     @message_timeout = nil  # For timed message display
-    
+    @file_mtime = nil  # Track file modification time for external change detection
+
     # Global configuration
     @config_file = File.expand_path("~/.hyperlist/config.yml")
     @indent_size = 2  # Default indentation (2-5 spaces)
@@ -228,6 +229,9 @@ class HyperListApp
     @config_line = nil  # Reset config line before loading
     @tagged_items = []  # Clear tags when loading new file
 
+    # Track file modification time for external change detection
+    @file_mtime = File.mtime(file) rescue nil
+
     # Read file content
     content = File.read(file) rescue ""
     
@@ -527,12 +531,48 @@ class HyperListApp
   def load_command_history
     history_file = File.expand_path("~/.hyperlist_command_history")
     return [] unless File.exist?(history_file)
-    
+
     File.readlines(history_file).map(&:strip).reject(&:empty?).last(100)
   rescue
     []
   end
-  
+
+  # Check if file was modified externally and prompt for reload
+  def check_file_changed
+    return unless @filename && File.exist?(@filename) && @file_mtime
+
+    current_mtime = File.mtime(@filename) rescue nil
+    return unless current_mtime && current_mtime > @file_mtime
+
+    # File changed externally - prompt user
+    @footer.text = "File changed externally. Reload? (y/n): "
+    @footer.refresh
+
+    response = getchr
+    if response&.downcase == 'y'
+      # Save cursor position
+      saved_current = @current
+      saved_offset = @offset
+
+      load_file(@filename)
+
+      # Restore cursor position (clamped to new file size)
+      visible = get_visible_items
+      @current = [saved_current, visible.length - 1, 0].max
+      @current = [@current, visible.length - 1].min if visible.length > 0
+      @offset = saved_offset
+
+      @message = "File reloaded"
+      @modified = false
+      clear_cache
+      render
+    else
+      # Update mtime to avoid repeated prompts
+      @file_mtime = current_mtime
+      @message = "External changes ignored"
+    end
+  end
+
   def save_command_history
     history_file = File.expand_path("~/.hyperlist_command_history")
     File.open(history_file, 'w') do |f|
@@ -712,6 +752,7 @@ class HyperListApp
     @modified = false
     @original_items = @items.map { |item| item.dup }  # Save state after save
     @last_auto_save = Time.now if @auto_save_enabled
+    @file_mtime = File.mtime(@filename) rescue nil  # Update mtime after save
   end
   
   def check_auto_save
@@ -1606,9 +1647,10 @@ class HyperListApp
     
     # Handle parentheses content (moved here to avoid conflicts with properties)
     # Based on hyperlist.vim: '(.\{-})'
+    # Color entire parentheses content as cyan - quotes inside are also cyan
     result = safe_regex_replace(result, /\(([^)]*)\)/) do |match|
-      content = match[1..-2]  # Extract content between parentheses
-      "(".fg(colors["cyan"]) + content.fg(colors["cyan"]) + ")".fg(colors["cyan"])
+      # Just color the whole thing cyan - no special handling for quotes inside
+      match.fg(colors["cyan"])
     end
     
     # Handle semicolons as separators (they separate items on the same line)
@@ -1624,11 +1666,17 @@ class HyperListApp
     
     # Handle quoted strings (only double quotes are special in HyperList)
     # Based on hyperlist.vim: '".\{-}"'
-    result.gsub!(/"([^"]*)"/) do
-      content = $1
+    # Use safe_regex_replace to avoid processing quotes inside already-colored parentheses
+    result = safe_regex_replace(result, /"([^"]*)"/) do |match|
+      content = match[1..-2]  # Extract content between quotes
       # Color any ## sequences inside the quotes as red
-      content.gsub!(/(##[<>-]+)/) { $1.fg(colors["red"]) }
-      '"'.fg(colors["cyan"]) + content.fg(colors["cyan"]) + '"'.fg(colors["cyan"])  # Cyan for quoted strings
+      colored_content = content.gsub(/(##[<>-]+)/) { $1.fg(colors["red"]) }
+      # If no ## sequences were found, just color the whole thing cyan
+      if colored_content == content
+        match.fg(colors["cyan"])  # Color entire quoted string cyan
+      else
+        '"'.fg(colors["cyan"]) + colored_content + '"'.fg(colors["cyan"])
+      end
     end
     
     # Handle change markup - all double-hashes should be red
@@ -1995,28 +2043,28 @@ class HyperListApp
 
   def move_up
     if @presentation_mode
-      # In presentation mode, we need to handle navigation differently
-      visible_before = get_visible_items
-      
+      # In presentation mode: move to target, then update folds
+      visible = get_visible_items
+      return if visible.empty?
+
+      # Calculate target position
       if @current == 0
-        # Wrap around to last item
-        target_index = visible_before.length - 1
+        target_index = visible.length - 1
       else
         target_index = @current - 1
       end
-      
-      # Get the actual item we want to move to
-      target_item = visible_before[target_index]
-      target_real_idx = get_real_index(target_item)
-      
-      # Update presentation focus for the target item
+
+      # Get the real index of the target item
+      target_real_idx = get_real_index(visible[target_index])
+
+      # Temporarily set current to target so update_presentation_focus works on it
       @current = target_index
       update_presentation_focus
-      
-      # Now find where the target item ended up after reorganization
-      visible_after = get_visible_items
-      visible_after.each_with_index do |item, idx|
-        if get_real_index(item) == target_real_idx
+
+      # After fold changes, find where the target item is now
+      new_visible = get_visible_items
+      new_visible.each_with_index do |item, idx|
+        if item["_real_index"] == target_real_idx
           @current = idx
           break
         end
@@ -2024,9 +2072,8 @@ class HyperListApp
     else
       # Normal mode navigation
       max_items = get_visible_items.length - 1
-      
+
       if @current == 0
-        # Wrap around to last item
         @current = max_items
       else
         @current = [@current - 1, 0].max
@@ -2036,29 +2083,29 @@ class HyperListApp
   
   def move_down
     if @presentation_mode
-      # In presentation mode, we need to handle navigation differently
-      visible_before = get_visible_items
-      max = visible_before.length - 1
-      
-      if @current == max
-        # Wrap around to first item
+      # In presentation mode: move to target, then update folds
+      visible = get_visible_items
+      return if visible.empty?
+      max = visible.length - 1
+
+      # Calculate target position
+      if @current >= max
         target_index = 0
       else
         target_index = @current + 1
       end
-      
-      # Get the actual item we want to move to
-      target_item = visible_before[target_index]
-      target_real_idx = get_real_index(target_item)
-      
-      # Update presentation focus for the target item
+
+      # Get the real index of the target item
+      target_real_idx = get_real_index(visible[target_index])
+
+      # Temporarily set current to target so update_presentation_focus works on it
       @current = target_index
       update_presentation_focus
-      
-      # Now find where the target item ended up after reorganization
-      visible_after = get_visible_items
-      visible_after.each_with_index do |item, idx|
-        if get_real_index(item) == target_real_idx
+
+      # After fold changes, find where the target item is now
+      new_visible = get_visible_items
+      new_visible.each_with_index do |item, idx|
+        if item["_real_index"] == target_real_idx
           @current = idx
           break
         end
@@ -2066,9 +2113,8 @@ class HyperListApp
     else
       # Normal mode navigation
       max = get_visible_items.length - 1
-      
-      if @current == max
-        # Wrap around to first item
+
+      if @current >= max
         @current = 0
       else
         @current = [@current + 1, max].min
@@ -2297,84 +2343,80 @@ class HyperListApp
       # Enter presentation mode
       # Remember which item we're on before any folding changes
       visible_items = get_visible_items
-      if @current < visible_items.length
-        target_item = visible_items[@current]
-      end
-      
+      return if visible_items.empty? || @current >= visible_items.length
+
+      # Get the real index of the current item
+      target_real_idx = visible_items[@current]["_real_index"]
+
       @presentation_mode = true
-      # Clear cache to force re-rendering  
+      # Clear cache to force re-rendering
       @processed_cache.clear
       update_presentation_focus
-      
-      # Make sure cursor is still on the same item after initial folding
-      if target_item
-        new_visible = get_visible_items
-        new_position = new_visible.index(target_item)
-        @current = new_position if new_position
+
+      # Find where the target item is after fold changes
+      new_visible = get_visible_items
+      new_visible.each_with_index do |item, idx|
+        if item["_real_index"] == target_real_idx
+          @current = idx
+          break
+        end
       end
-      
-      @message = "Presentation mode enabled - focus on current item"
+
+      @message = "Presentation mode enabled"
     end
   end
   
   def update_presentation_focus
-    # This method updates the focus in presentation mode
-    # It will be called whenever the cursor moves
+    # Presentation mode: fold everything, then reveal path to current item
+    # Like vim's: fold to level 0, then zv (reveal current line)
     return unless @presentation_mode
-    
+
     visible_items = get_visible_items
     return if visible_items.empty? || @current >= visible_items.length
-    
-    # Remember which item we're focused on
+
+    # Get the current item before we change anything
     current_item = visible_items[@current]
-    current_level = current_item["level"]
     current_real_idx = get_real_index(current_item)
-    
-    # First, fold everything
+    return unless current_real_idx
+
+    current_level = current_item["level"]
+
+    # Step 1: Fold everything that has children
     @items.each_with_index do |item, idx|
       item["fold"] = has_children?(idx, @items)
       item["presentation_focus"] = false
     end
-    
-    # Mark current item as in focus and unfold it in the main items array
-    if current_real_idx && current_real_idx < @items.length
-      @items[current_real_idx]["presentation_focus"] = true
-      @items[current_real_idx]["fold"] = false
-    end
-    
-    # Unfold all ancestors of current item
-    ancestor_indices = []
+
+    # Step 2: Unfold all ancestors (path from root to current item)
     search_level = current_level - 1
     idx = current_real_idx - 1
-    
     while idx >= 0 && search_level >= 0
       if @items[idx]["level"] == search_level
-        @items[idx]["fold"] = false
-        @items[idx]["presentation_focus"] = false  # Ancestors visible but not focused
-        ancestor_indices << idx
+        @items[idx]["fold"] = false  # Unfold this ancestor
         search_level -= 1
       end
       idx -= 1
     end
-    
-    # Mark immediate children as in focus (only one level down)
+
+    # Step 3: Unfold the current item to show its direct children
+    @items[current_real_idx]["fold"] = false
+    @items[current_real_idx]["presentation_focus"] = true
+
+    # Step 4: Mark direct children as in focus (for visual highlighting)
     idx = current_real_idx + 1
     while idx < @items.length && @items[idx]["level"] > current_level
       if @items[idx]["level"] == current_level + 1
         @items[idx]["presentation_focus"] = true
-        # Don't unfold children - let them stay folded unless user explicitly unfolds
       end
       idx += 1
     end
-    
-    # Now recalculate the cursor position to point to the same item
+
+    # Step 5: Recalculate cursor position after fold changes
     new_visible_items = get_visible_items
     new_position = new_visible_items.index(current_item)
-    if new_position
-      @current = new_position
-    end
-    
-    # Clear cache to force re-rendering with new focus
+    @current = new_position if new_position
+
+    # Clear cache to force re-rendering
     @processed_cache.clear
   end
   
@@ -6397,7 +6439,10 @@ class HyperListApp
     loop do
       # Check for auto-save
       check_auto_save if @auto_save_enabled
-      
+
+      # Check for external file changes
+      check_file_changed
+
       c = getchr
       
       # Skip nil input (shouldn't happen normally)

data/hyperlist.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "hyperlist"
-  spec.version       = "1.9.0"
+  spec.version       = "1.9.2"
   spec.authors       = ["Geir Isene"]
   spec.email         = ["g@isene.com"]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hyperlist
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.2
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: "."
 cert_chain: []
-date: 2025-10-24 00:00:00.000000000 Z
+date: 2025-12-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses