hyperlist 1.1.7 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7963687b87c7d271d9e45e5574e7af4edb900e49cc60a567774e4be54a386f51
-  data.tar.gz: '055148f7bc87ab9af632b5ad52eae9a367bdc8b4c84c8bbff28ed5686502e30a'
+  metadata.gz: aef5338683dfa697e59042f093e0db9a748ef53515952a295b1c9eb972519ac5
+  data.tar.gz: fbad5a0f6022d40cfd147846d3de81b317b41fff39036c9085a0230fc0a144c4
 SHA512:
-  metadata.gz: 17a562ee3ccdbcd2434c7a6fc5b08f3bccb696fb0a0100e735ea7e5f5e267021de31c0b9c8007dd4990818e236d9d0f7a87cebeed4384b69161202e0f1f6f8c9
-  data.tar.gz: 27a237a412326e4f45fa17cd7b622bfa5073f39a4b2f87ce1bc6af264eb0506d2f663b39338cd66738b54f95e7ccd48d85838c58eb6bad7c15ec84e007bd68dc
+  metadata.gz: fd23aaaaa0ffbb7b1d73fdc99a46d3fb08d265000e1e10651e747857a4ab5d78dbf523d967e87d4ca82a1f0f8ff46d3fc563cec4441c3a86de7a3651f0cb41e6
+  data.tar.gz: 98ae50b53b8a9b4578ed50c81b8dcd763af2273f44bca200f27627cdc808f61b620baa0d76c09a9a776107de3de637e50c1daf660c7c77903debb8ee1868909d

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to the HyperList Ruby TUI will be documented in this file.
 
+## [1.2.0] - 2025-08-20
+
+### Added
+- **User-Defined Templates**
+  - Save any HyperList document as a reusable template (`:st` or `:save-template`)
+  - Template manager for listing and deleting custom templates (`:lt`, `:dt`)
+  - Enhanced template browser showing both built-in and user templates
+  - Template metadata including description and creation date
+  - Templates stored in `~/.hyperlist/templates/` for easy backup and sharing
+  - JSON format for template storage with full hierarchy preservation
+  
+### Changed
+- Template system now supports both built-in and user-created templates
+- Template browser UI improved with separate sections for built-in vs user templates
+- Help documentation updated with new template commands
+
 ## [1.1.7] - 2025-08-15
 
 ### Fixed

data/README.md

@@ -6,7 +6,8 @@
 [![GitHub stars](https://img.shields.io/github/stars/isene/HyperList.svg)](https://github.com/isene/HyperList/stargazers)
 [![Stay Amazing](https://img.shields.io/badge/Stay-Amazing-blue.svg)](https://isene.org)
 
-<img src="hyperlist_logo.svg" align="left" width="150" height="150">
+<img src="img/hyperlist_logo.svg" align="left" width="150" height="150">
+<br clear="left"/>
 
 A powerful Terminal User Interface (TUI) application for creating, editing, and managing HyperLists - a methodology for describing anything in a hierarchical, structured format.
 
@@ -23,12 +24,21 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 ## Screenshots
 
 ### Main Interface
-![HyperList Main View](screenshot_sample.png)
+![HyperList Main View](img/screenshot_sample.png)
 
 ### Help Screen
-![HyperList Help](screenshot_help.png)
+![HyperList Help](img/screenshot_help.png)
+
+## What's New in v1.2.0
 
-## What's New in v1.1.0
+### 📝 User-Defined Templates
+- **Save as Template**: Save any HyperList document as a reusable template (`:st`)
+- **Template Manager**: List and delete your custom templates (`:lt`, `:dt`)
+- **Enhanced Template Browser**: Shows both built-in and user templates
+- **Template Metadata**: Includes description and creation date
+- Templates stored in `~/.hyperlist/templates/` for easy backup and sharing
+
+## Previous Updates (v1.1.0)
 
 ### 🔐 Encryption Support
 - **File-level encryption** for sensitive files (dot files like `.passwords.hl`)
@@ -62,7 +72,7 @@ For historical context and the original VIM implementation, see: [hyperlist.vim]
 - **Powerful Navigation**: Jump between items, references, and markers
 - **Full Editing Capabilities**: Create, edit, delete, move, and reorganize items
 - **Checkbox Support**: Multiple checkbox types with completion tracking
-- **Template System**: Jump to and fill in template markers
+- **Template System**: Built-in templates plus save/load custom templates
 - **Presentation Mode**: Focus on current item with auto-collapse
 
 ### Security Features
@@ -158,6 +168,7 @@ hyperlist file.txt          # Open any text file
 - `R` - Go to reference
 - `F` - Open file reference
 - `P` - Presentation mode (with auto-collapse)
+- `t` - Insert template (built-in or custom)
 - `?` - Help screen
 
 #### File Commands
@@ -169,6 +180,12 @@ hyperlist file.txt          # Open any text file
 - `:export md` - Export to Markdown
 - `:graph` - Export to PNG
 
+#### Template Commands
+- `:st` - Save current document as template
+- `:dt` - Delete a user template
+- `:lt` - List all user templates
+- `t` - Browse and insert templates
+
 ## Examples
 
 ### Simple Todo List

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.1.7 - Terminal User Interface for HyperList files
+    HyperList v1.2.0 - 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.1.7"
+  puts "HyperList v1.2.0"
   exit 0
 end
 
@@ -64,13 +64,15 @@ require 'cgi'
 require 'openssl'
 require 'digest'
 require 'base64'
+require 'fileutils'
+require 'json'
 
 class HyperListApp
   include Rcurses
   include Rcurses::Input
   include Rcurses::Cursor
   
-  VERSION = "1.1.7"
+  VERSION = "1.2.0"
   
   def initialize(filename = nil)
     @filename = filename ? File.expand_path(filename) : nil
@@ -98,6 +100,8 @@ class HyperListApp
     @auto_save_enabled = false
     @auto_save_interval = 60  # seconds
     @last_auto_save = Time.now
+    @templates_dir = File.expand_path("~/.hyperlist/templates")
+    ensure_templates_dir
     @templates = load_templates
     @macro_recording = false
     @macro_register = {}  # Store macros by key
@@ -136,8 +140,11 @@ class HyperListApp
   end
   
   def setup_ui
-    Rcurses.clear_screen
-    Cursor.hide
+    # Only do rcurses operations if initialized
+    if defined?(Rcurses.instance_variable_get) && Rcurses.instance_variable_get(:@initialized)
+      Rcurses.clear_screen
+      Cursor.hide
+    end
     
     # Ensure we have the latest terminal size
     if IO.console
@@ -2169,7 +2176,7 @@ class HyperListApp
     help_lines << help_line("#{"C-E".fg("10")}", "Encrypt/decrypt line", "#{"C-U".fg("10")}", "Toggle State/Trans underline")
     help_lines << help_line("#{"R".fg("10")}", "Go to reference", "#{"F".fg("10")}", "Open file")
     help_lines << help_line("#{"N".fg("10")}", "Next = marker", "#{"P".fg("10")}", "Presentation mode")
-    help_lines << help_line("#{"t".fg("10")}", "Insert template", "#{":template".fg("10")}", "Show templates")
+    help_lines << help_line("#{"t".fg("10")}", "Insert template", "#{":st".fg("10")}", "Save as template")
     help_lines << help_line("#{"Ma".fg("10")}", "Record macro 'a'", "#{"@a".fg("10")}", "Play macro 'a'")
     help_lines << help_line("#{":vsplit".fg("10")}", "Split view vertically", "#{"w".fg("10")}", "Switch panes")
     help_lines << ""
@@ -2180,6 +2187,11 @@ class HyperListApp
     help_lines << help_line("#{":graph :g".fg("10")}", "Export to PNG graph", "#{":vsplit :vs".fg("10")}", "Split view")
     help_lines << help_line("#{":as on".fg("10")}", "Enable autosave", "#{":as off".fg("10")}", "Disable autosave")
     help_lines << help_line("#{":as N".fg("10")}", "Set interval (secs)", "#{":as".fg("10")}", "Show autosave status")
+    help_lines << ""
+    help_lines << "#{"TEMPLATES".fg("14")}"
+    help_lines << help_line("#{":st".fg("10")}", "Save as template", "#{":dt".fg("10")}", "Delete template")
+    help_lines << help_line("#{":lt".fg("10")}", "List user templates", "#{"t".fg("10")}", "Insert template")
+    help_lines << ""
     help_lines << help_line("#{"q".fg("10")}", "Quit (asks to save)", "#{"Q".fg("10")}", "Force quit")
     help_lines << ""
     help_lines << "#{"COLOR SCHEME".fg("14")}"
@@ -2853,8 +2865,18 @@ class HyperListApp
     when "autosave", "as"
       status = @auto_save_enabled ? "enabled" : "disabled"
       @message = "Auto-save is #{status} (interval: #{@auto_save_interval}s)"
-    when "t"
+    when "t", "template", "templates"
       show_templates
+    when "save-template", "savetemplate", "st"
+      save_as_template
+    when /^save-template\s+(.+)/, /^savetemplate\s+(.+)/, /^st\s+(.+)/
+      save_as_template($1.strip)
+    when "delete-template", "deletetemplate", "dt"
+      delete_template
+    when /^delete-template\s+(.+)/, /^deletetemplate\s+(.+)/, /^dt\s+(.+)/
+      delete_template($1.strip)
+    when "list-templates", "listtemplates", "lt"
+      show_template_manager(:list)
     when "foldlevel"
       level = @footer.ask("Fold to level (0-9): ", "")
       if level =~ /^[0-9]$/
@@ -3202,8 +3224,13 @@ class HyperListApp
     end
   end
   
+  def ensure_templates_dir
+    FileUtils.mkdir_p(@templates_dir) unless File.exist?(@templates_dir)
+  end
+
   def load_templates
-    {
+    # Start with built-in templates
+    templates = {
       "project" => [
         {"text" => "Project: =Project Name=", "level" => 0},
         {"text" => "[_] Define project scope", "level" => 1},
@@ -3306,6 +3333,214 @@ class HyperListApp
         {"text" => "=Tips, variations, serving suggestions=", "level" => 2}
       ]
     }
+    
+    # Load user templates from templates directory
+    if File.directory?(@templates_dir)
+      Dir.glob(File.join(@templates_dir, "*.hlt")).each do |template_file|
+        template_name = File.basename(template_file, ".hlt")
+        begin
+          template_data = JSON.parse(File.read(template_file))
+          # Convert template data to the expected format
+          if template_data.is_a?(Hash) && template_data["items"]
+            templates[template_name] = template_data["items"].map do |item|
+              {"text" => item["text"], "level" => item["level"]}
+            end
+          end
+        rescue => e
+          # Skip invalid template files
+        end
+      end
+    end
+    
+    templates
+  end
+  
+  def save_as_template(name = nil)
+    # Ask for template name if not provided
+    if name.nil? || name.empty?
+      name = @footer.ask("Template name: ", "")
+      return if name.nil? || name.empty?
+    end
+    
+    # Sanitize template name
+    name = name.gsub(/[^a-zA-Z0-9_-]/, '_')
+    
+    # Ask for description
+    description = @footer.ask("Template description (optional): ", "")
+    
+    # Prepare template data
+    template_data = {
+      "name" => name,
+      "description" => description,
+      "created" => Time.now.strftime("%Y-%m-%dT%H:%M:%S"),
+      "items" => @items.map do |item|
+        {
+          "text" => item["text"],
+          "level" => item["level"]
+        }
+      end
+    }
+    
+    # Save template file
+    template_path = File.join(@templates_dir, "#{name}.hlt")
+    
+    # Check if template already exists
+    if File.exist?(template_path)
+      response = @footer.ask("Template '#{name}' already exists. Overwrite? (y/n): ", "")
+      return unless response.downcase == 'y'
+    end
+    
+    File.write(template_path, JSON.pretty_generate(template_data))
+    @message = "Template '#{name}' saved successfully"
+  end
+  
+  def delete_template(name = nil)
+    # Get list of user templates
+    user_templates = get_user_templates
+    
+    if user_templates.empty?
+      @message = "No user templates found"
+      return
+    end
+    
+    # Show template list if name not provided
+    if name.nil? || name.empty?
+      show_template_manager(:delete)
+      return
+    end
+    
+    template_path = File.join(@templates_dir, "#{name}.hlt")
+    
+    if File.exist?(template_path)
+      response = @footer.ask("Delete template '#{name}'? (y/n): ", "")
+      if response.downcase == 'y'
+        File.delete(template_path)
+        @message = "Template '#{name}' deleted"
+        # Reload templates
+        @templates = load_templates
+      end
+    else
+      @message = "Template '#{name}' not found"
+    end
+  end
+  
+  def get_user_templates
+    templates = []
+    if File.directory?(@templates_dir)
+      Dir.glob(File.join(@templates_dir, "*.hlt")).each do |template_file|
+        template_name = File.basename(template_file, ".hlt")
+        begin
+          template_data = JSON.parse(File.read(template_file))
+          templates << {
+            "name" => template_name,
+            "description" => template_data["description"] || "",
+            "created" => template_data["created"] || "",
+            "path" => template_file
+          }
+        rescue => e
+          # Skip invalid template files
+        end
+      end
+    end
+    templates.sort_by { |t| t["name"] }
+  end
+  
+  def show_template_manager(action = :list)
+    # Store original state
+    original_state = {
+      items: @items.dup,
+      current: @current,
+      offset: @offset,
+      filename: @filename,
+      modified: @modified
+    }
+    
+    user_templates = get_user_templates
+    
+    # Build template manager view
+    @items = []
+    case action
+    when :delete
+      @items << {"text" => "DELETE TEMPLATE (press Enter to delete, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
+    else
+      @items << {"text" => "USER TEMPLATES (press Enter to select, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
+    end
+    @items << {"text" => "="*50, "level" => 0, "fold" => false, "raw" => true}
+    
+    if user_templates.empty?
+      @items << {"text" => "No user templates found", "level" => 0, "fold" => false, "raw" => true}
+    else
+      user_templates.each_with_index do |template, idx|
+        desc = template["description"].empty? ? "No description" : template["description"]
+        created = template["created"].empty? ? "" : " (#{Time.parse(template["created"]).strftime('%Y-%m-%d')})"
+        @items << {
+          "text" => "#{idx+1}. #{template["name"]}: #{desc}#{created}",
+          "level" => 0,
+          "fold" => false,
+          "raw" => true,
+          "template_name" => template["name"],
+          "template_action" => action
+        }
+      end
+    end
+    
+    @current = 2  # Start at first template
+    @offset = 0
+    
+    selected_template = nil
+    exit_loop = false
+    
+    # Template manager loop
+    while !exit_loop
+      begin
+        render_main
+        footer_text = case action
+        when :delete
+          "Delete Template | Enter: delete | q: cancel | j/k: navigate"
+        else
+          "User Templates | Enter: select | q: cancel | j/k: navigate"
+        end
+        @footer.text = footer_text
+        @footer.refresh
+        
+        c = getchr
+        next if c.nil?
+        
+        case c
+        when "q", "ESC", "C-c", "Q"
+          exit_loop = true
+        when "j", "DOWN"
+          @current = [@current + 1, @items.length - 1].min
+        when "k", "UP"
+          @current = [@current - 1, 2].max
+        when "ENTER", "RETURN", "\n", "\r"
+          if @current >= 2 && @current < @items.length
+            item = @items[@current]
+            if item && item.is_a?(Hash) && item["template_name"]
+              selected_template = item["template_name"]
+              exit_loop = true
+            end
+          end
+        end
+      rescue => e
+        @message = "Error in template manager: #{e.message}"
+        exit_loop = true
+      end
+    end
+    
+    # Restore original state
+    @items = original_state[:items]
+    @current = original_state[:current]
+    @offset = original_state[:offset]
+    @filename = original_state[:filename]
+    @modified = original_state[:modified]
+    
+    # Process selected template
+    if selected_template && action == :delete
+      delete_template(selected_template)
+    end
+    
+    selected_template
   end
   
   def show_templates
@@ -3318,24 +3553,33 @@ class HyperListApp
       modified: @modified
     }
     
-    # Create template selection view
+    # Create template selection view combining built-in and user templates
     template_list = [
-      ["project", "Project Plan - Complete project management template"],
-      ["meeting", "Meeting Agenda - Structure for meeting notes"],
-      ["daily", "Daily Planner - Daily task and schedule template"],
-      ["checklist", "Simple Checklist - Basic checkbox list"],
-      ["brainstorm", "Brainstorming Session - Idea generation template"],
-      ["recipe", "Recipe - Cooking recipe structure"]
+      ["project", "Project Plan - Complete project management template", "built-in"],
+      ["meeting", "Meeting Agenda - Structure for meeting notes", "built-in"],
+      ["daily", "Daily Planner - Daily task and schedule template", "built-in"],
+      ["checklist", "Simple Checklist - Basic checkbox list", "built-in"],
+      ["brainstorm", "Brainstorming Session - Idea generation template", "built-in"],
+      ["recipe", "Recipe - Cooking recipe structure", "built-in"]
     ]
     
+    # Add user templates to the list
+    user_templates = get_user_templates
+    user_templates.each do |template|
+      desc = template["description"].empty? ? "User template" : template["description"]
+      template_list << [template["name"], desc, "user"]
+    end
+    
     # Build template selection items
     @items = []
     @items << {"text" => "TEMPLATES (press Enter to insert, q to cancel)", "level" => 0, "fold" => false, "raw" => true}
     @items << {"text" => "="*50, "level" => 0, "fold" => false, "raw" => true}
     
-    template_list.each_with_index do |(key, desc), idx|
+    # Add built-in templates section
+    @items << {"text" => "BUILT-IN TEMPLATES:", "level" => 0, "fold" => false, "raw" => true}
+    template_list.select { |t| t[2] == "built-in" }.each_with_index do |(key, desc, type), idx|
       @items << {
-        "text" => "#{idx+1}. #{key.capitalize}: #{desc}", 
+        "text" => "  #{idx+1}. #{key.capitalize}: #{desc}", 
         "level" => 0, 
         "fold" => false, 
         "raw" => true, 
@@ -3343,6 +3587,21 @@ class HyperListApp
       }
     end
     
+    # Add user templates section if any exist
+    if user_templates.any?
+      @items << {"text" => "", "level" => 0, "fold" => false, "raw" => true}
+      @items << {"text" => "USER TEMPLATES:", "level" => 0, "fold" => false, "raw" => true}
+      template_list.select { |t| t[2] == "user" }.each_with_index do |(key, desc, type), idx|
+        @items << {
+          "text" => "  #{key}: #{desc}", 
+          "level" => 0, 
+          "fold" => false, 
+          "raw" => true, 
+          "template_key" => key
+        }
+      end
+    end
+    
     @current = 2  # Start at first template
     @offset = 0
     
@@ -4252,6 +4511,19 @@ class HyperListApp
   end
   
   def run
+    # Initialize rcurses explicitly (no longer auto-initialized)
+    Rcurses.init!
+    
+    # Flush any buffered input (like the Enter key from running the command)
+    while IO.select([$stdin], nil, nil, 0)
+      $stdin.read_nonblock(1024) rescue break
+    end
+    
+    # Now that rcurses is initialized, set up the UI properly
+    Rcurses.clear_screen
+    Cursor.hide
+    setup_ui
+    
     render
     
     loop do
@@ -4260,6 +4532,14 @@ class HyperListApp
       
       c = getchr
       
+      # Skip nil input (shouldn't happen normally)
+      next if c.nil?
+      
+      # Skip newline at the very start (buffered from command execution)
+      if c == "\n" && @last_key.nil?
+        next
+      end
+      
       # Track last key for double-key combinations
       prev_key = @last_key
       @last_key = c
@@ -4550,13 +4830,15 @@ class HyperListApp
     quit
   ensure
     Cursor.show
-    Rcurses.clear_screen
+    # Screen clearing disabled for debugging
+    # Rcurses.clear_screen
   end
 end
 
 # Main
-if __FILE__ == $0
-  # Normal operation - help/version already handled at top of file
+# When installed as a gem executable, this file is loaded (not executed directly)
+# so we can't use __FILE__ == $0. Just run unless we already handled help/version.
+unless ARGV[0] == '-h' || ARGV[0] == '--help' || ARGV[0] == '-v' || ARGV[0] == '--version'
   app = HyperListApp.new(ARGV[0])
   app.run
 end

data/hyperlist.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name          = "hyperlist"
-  spec.version       = "1.1.7"
+  spec.version       = "1.2.0"
   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.1.7
+  version: 1.2.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: "."
 cert_chain: []
-date: 2025-08-14 00:00:00.000000000 Z
+date: 2025-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -73,20 +73,12 @@ files:
 - CHANGELOG.md
 - LICENSE
 - README.md
-- debug_instructions.md
-- diagnose.rb
-- diagnose_ruby34.rb
-- diagnose_ruby34_detailed.rb
-- diagnose_safe.rb
-- fix_terminal.sh
 - hyperlist
 - hyperlist.gemspec
-- hyperlist_logo.svg
-- hyperlist_ruby34_wrapper.rb
-- rcurses_ruby34_patch.rb
+- img/hyperlist_logo.svg
+- img/screenshot_help.png
+- img/screenshot_sample.png
 - sample.hl
-- screenshot_help.png
-- screenshot_sample.png
 - test.hl
 homepage: https://github.com/isene/HyperList
 licenses: