# =====================================
# Todo TUI Configuration File
# =====================================
# 
# This is a comprehensive configuration file for Todo TUI.
# Copy this file to your configuration directory:
# 
# macOS/Linux: ~/.config/todotui/config.yaml
# Windows:     %APPDATA%/todotui/config.yaml
#
# All settings are optional. If not specified, defaults will be used.
# Remove or comment out any settings you don't want to customize.

# =====================================
# Theme Settings
# =====================================
# Controls the color scheme of the application
# Available themes:
#   - catppuccin      (default, warm pastel colors)
#   - nord            (cool, arctic-inspired colors)
#   - everforest-dark (earthy, forest-inspired dark theme)
#   - everforest-light (earthy, forest-inspired light theme)
theme: catppuccin

# =====================================
# Priority Level Settings
# =====================================
# Define custom priority levels for your tasks
# Rules:
#   - First element MUST be empty string ("") for "no priority"
#   - Use single letters (A-Z) for priority levels
#   - Order defines priority hierarchy (first = highest priority)
#   - You can add/remove levels as needed
priority_levels:
  - ""    # No priority (required)
  - A     # Highest priority
  - B     # High priority
  - C     # Medium priority
  - D     # Low priority
  # - E   # You can add more levels like this

# =====================================
# File Settings
# =====================================
# Default todo.txt file path
# If specified, you don't need to provide a file path when running todotui
# Supports:
#   - Absolute paths: /path/to/todo.txt
#   - Home directory: ~/todo.txt
#   - Relative paths: ./todo.txt
default_todo_file: ./sample.todo.txt

# =====================================
# User Interface Settings
# =====================================
ui:
  # Layout Configuration
  # ====================
  
  # Left pane width as a ratio of total terminal width
  # Range: 0.1 - 0.9
  # Recommended: 0.25 - 0.4 for optimal balance
  left_pane_ratio: 0.33
  
  # Minimum width constraints (in characters)
  # These prevent panes from becoming too narrow on small terminals
  min_left_pane_width: 18      # Filter/project list pane
  min_right_pane_width: 28     # Task detail pane
  
  # Vertical spacing around content
  # Range: 1 - 5
  # Recommended: 2 - 3 for comfortable viewing
  vertical_padding: 2

# =====================================
# Logging Configuration
# =====================================
# Todo TUI outputs logs to stderr for troubleshooting
logging:
  # Log Level
  # =========
  # Available levels: DEBUG, INFO, WARN, ERROR
  # Default: WARN (warnings and errors only)
  log_level: "WARN"

# =====================================
# Example Configurations
# =====================================
# 
# Minimal Configuration:
# ----------------------
# theme: catppuccin
# default_todo_file: ~/todo.txt
# 
# Compact Layout (for smaller terminals):
# ---------------------------------------
# theme: nord
# ui:
#   left_pane_ratio: 0.25
#   min_left_pane_width: 15
#   min_right_pane_width: 25
#   vertical_padding: 1
# 
# Spacious Layout (for larger terminals):
# ---------------------------------------
# theme: everforest-dark
# ui:
#   left_pane_ratio: 0.4
#   min_left_pane_width: 25
#   min_right_pane_width: 35
#   vertical_padding: 3
# 
# Developer Setup (with debug logging):
# -------------------------------------
# logging:
#   enable_debug: true