rich-ruby 1.0.0

data/examples/syntax_markdown_demo.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+# Demo of Syntax Highlighting and Markdown Rendering
+
+require_relative "../lib/rich"
+
+console = Rich::Console.new
+
+console.rule("Syntax Highlighting Demo", style: "bold cyan")
+puts ""
+
+# Ruby code
+ruby_code = <<~RUBY
+  # Ruby example
+  class User
+    attr_accessor :name, :email
+
+    def initialize(name, email)
+      @name = name
+      @email = email
+    end
+
+    def greet
+      puts "Hello, \#{@name}!"
+    end
+  end
+
+  user = User.new("Alice", "alice@example.com")
+  user.greet
+RUBY
+
+puts "Ruby:"
+puts ""
+syntax = Rich::Syntax.new(ruby_code, language: "ruby", line_numbers: true)
+puts syntax.render
+puts ""
+
+# Python code
+python_code = <<~PYTHON
+  # Python example
+  import json
+  from dataclasses import dataclass
+
+  @dataclass
+  class Config:
+      name: str
+      debug: bool = False
+
+  def load_config(path: str) -> Config:
+      with open(path) as f:
+          data = json.load(f)
+      return Config(**data)
+
+  if __name__ == "__main__":
+      config = load_config("config.json")
+      print(f"Loaded: {config.name}")
+PYTHON
+
+puts "Python:"
+puts ""
+syntax = Rich::Syntax.new(python_code, language: "python", line_numbers: true, theme: :monokai)
+puts syntax.render
+puts ""
+
+# JavaScript
+js_code = <<~JS
+  // JavaScript example
+  const express = require('express');
+  const app = express();
+
+  app.get('/api/users', async (req, res) => {
+    const users = await User.findAll();
+    res.json({ data: users, count: users.length });
+  });
+
+  app.listen(3000, () => console.log('Server running'));
+JS
+
+puts "JavaScript (Dracula theme):"
+puts ""
+syntax = Rich::Syntax.new(js_code, language: "javascript", line_numbers: true, theme: :dracula)
+puts syntax.render
+puts ""
+
+# SQL
+sql_code = <<~SQL
+  -- Get active users with their orders
+  SELECT u.name, u.email, COUNT(o.id) AS order_count
+  FROM users u
+  LEFT JOIN orders o ON u.id = o.user_id
+  WHERE u.status = 'active'
+    AND o.created_at >= '2025-01-01'
+  GROUP BY u.id
+  HAVING order_count > 5
+  ORDER BY order_count DESC
+  LIMIT 10;
+SQL
+
+puts "SQL:"
+puts ""
+syntax = Rich::Syntax.new(sql_code, language: "sql")
+puts syntax.render
+puts ""
+
+console.rule("Markdown Rendering Demo", style: "bold cyan")
+puts ""
+
+markdown = <<~MD
+  # Welcome to Rich Markdown
+
+  This is a **full-featured** Markdown renderer for your *terminal*.
+
+  ## Features
+
+  ### Text Formatting
+
+  You can use **bold**, *italic*, ***bold italic***, ~~strikethrough~~, and `inline code`.
+
+  ### Lists
+
+  Unordered list:
+  - First item
+  - Second item
+    - Nested item
+    - Another nested
+
+  Ordered list:
+  1. Step one
+  2. Step two
+  3. Step three
+
+  ### Blockquotes
+
+  > This is a blockquote.
+  > It can span multiple lines.
+  > -- Someone Famous
+
+  ### Code Blocks
+
+  ```ruby
+  def hello(name)
+    puts "Hello, \#{name}!"
+  end
+  ```
+
+  ### Tables
+
+  | Name     | Language | Stars |
+  |----------|----------|-------|
+  | Ruby     | Ruby     | 21k   |
+  | Python   | Python   | 58k   |
+  | Node.js  | JS       | 102k  |
+
+  ### Links
+
+  Check out [Rich Library](https://github.com/Textualize/rich) for more!
+
+  ---
+
+  That's all folks!
+MD
+
+md = Rich::Markdown.new(markdown)
+puts md.render(max_width: 70)
+
+console.rule("Demo Complete!", style: "bold green")

data/examples/verify.rb

@@ -0,0 +1,215 @@
+# frozen_string_literal: true
+
+# Full verification test for the Rich library
+
+require_relative "../lib/rich"
+
+puts "=" * 60
+puts "Rich Library Verification Test"
+puts "=" * 60
+puts ""
+
+# Track results
+results = []
+
+def test(name)
+  print "Testing #{name}... "
+  begin
+    yield
+    puts "✓ PASS"
+    true
+  rescue StandardError => e
+    puts "✗ FAIL: #{e.message}"
+    false
+  end
+end
+
+# Test 1: Basic imports
+results << test("Module loading") do
+  raise "Console not defined" unless defined?(Rich::Console)
+  raise "Color not defined" unless defined?(Rich::Color)
+  raise "Style not defined" unless defined?(Rich::Style)
+  raise "Text not defined" unless defined?(Rich::Text)
+  raise "Panel not defined" unless defined?(Rich::Panel)
+  raise "Table not defined" unless defined?(Rich::Table)
+  raise "Tree not defined" unless defined?(Rich::Tree)
+  raise "Progress not defined" unless defined?(Rich::ProgressBar)
+end
+
+# Test 2: ColorTriplet
+results << test("ColorTriplet") do
+  triplet = Rich::ColorTriplet.new(255, 128, 64)
+  raise "Hex wrong" unless triplet.hex == "#ff8040"
+  raise "RGB wrong" unless triplet.red == 255 && triplet.green == 128
+  
+  from_hex = Rich::ColorTriplet.from_hex("#00ff00")
+  raise "From hex wrong" unless from_hex.green == 255
+end
+
+# Test 3: Color parsing
+results << test("Color parsing") do
+  red = Rich::Color.parse("red")
+  raise "Red not parsed" unless red.type == Rich::ColorType::STANDARD
+  
+  hex = Rich::Color.parse("#ff5500")
+  raise "Hex not parsed" unless hex.type == Rich::ColorType::TRUECOLOR
+  
+  named = Rich::Color.parse("bright_blue")
+  raise "Named not parsed" unless named.number == 12
+end
+
+# Test 4: Style parsing
+results << test("Style parsing") do
+  style = Rich::Style.parse("bold red on white")
+  raise "Bold not set" unless style.bold?
+  raise "Color wrong" unless style.color.name == "red"
+  raise "Bgcolor wrong" unless style.bgcolor.name == "white"
+end
+
+# Test 5: Style combination
+results << test("Style combination") do
+  s1 = Rich::Style.parse("bold")
+  s2 = Rich::Style.parse("red")
+  combined = s1 + s2
+  raise "Combination failed" unless combined.bold? && combined.color.name == "red"
+end
+
+# Test 6: Console creation
+results << test("Console creation") do
+  console = Rich::Console.new
+  raise "Width missing" unless console.width > 0
+  raise "Height missing" unless console.height > 0
+  raise "Color system missing" unless Rich::ColorSystem::ALL.include?(console.color_system)
+end
+
+# Test 7: Cell width calculation
+results << test("Cell width calculation") do
+  raise "ASCII wrong" unless Rich::Cells.cell_len("Hello") == 5
+  raise "CJK wrong" unless Rich::Cells.cell_len("你好") == 4  # 2 chars × 2 width
+  raise "Empty wrong" unless Rich::Cells.cell_len("") == 0
+end
+
+# Test 8: Segment creation
+results << test("Segment creation") do
+  seg = Rich::Segment.new("Hello", style: Rich::Style.parse("bold"))
+  raise "Text wrong" unless seg.text == "Hello"
+  raise "Style missing" unless seg.style.bold?
+end
+
+# Test 9: Text with spans
+results << test("Text with spans") do
+  text = Rich::Text.new("Hello ")
+  text.append("World", style: "red")
+  raise "Plain wrong" unless text.plain == "Hello World"
+  raise "Spans wrong" unless text.spans.length == 1
+end
+
+# Test 10: Markup parsing
+results << test("Markup parsing") do
+  text = Rich::Markup.parse("[bold]Hello[/bold]")
+  raise "Parse failed" unless text.plain == "Hello"
+  raise "Style not applied" unless text.spans.any? { |s| s.style.bold? }
+end
+
+# Test 11: Panel rendering
+results << test("Panel rendering") do
+  panel = Rich::Panel.new("Content", title: "Title")
+  output = panel.render(max_width: 40)
+  raise "No border" unless output.include?("╭") || output.include?("+")
+  raise "No content" unless output.include?("Content")
+end
+
+# Test 12: Table rendering
+results << test("Table rendering") do
+  table = Rich::Table.new
+  table.add_column("Name")
+  table.add_column("Value")
+  table.add_row("Key", "123")
+  output = table.render(max_width: 40)
+  raise "No header" unless output.include?("Name")
+  raise "No data" unless output.include?("123")
+end
+
+# Test 13: Tree rendering
+results << test("Tree rendering") do
+  tree = Rich::Tree.new("Root")
+  tree.add("Child 1")
+  tree.add("Child 2")
+  output = tree.render
+  raise "No root" unless output.include?("Root")
+  raise "No children" unless output.include?("Child")
+end
+
+# Test 14: Progress bar
+results << test("Progress bar") do
+  bar = Rich::ProgressBar.new(total: 100, completed: 50)
+  raise "Progress wrong" unless bar.progress == 0.5
+  raise "Percentage wrong" unless bar.percentage == 50
+  
+  bar.advance(25)
+  raise "Advance failed" unless bar.percentage == 75
+end
+
+# Test 15: Spinner
+results << test("Spinner") do
+  spinner = Rich::Spinner.new
+  frame1 = spinner.frame
+  spinner.advance
+  frame2 = spinner.frame
+  raise "Spinner not advancing" if frame1 == frame2 && spinner.frames.length > 1
+end
+
+# Test 16: Box styles
+results << test("Box styles") do
+  boxes = [Rich::Box::ASCII, Rich::Box::ROUNDED, Rich::Box::HEAVY, Rich::Box::DOUBLE]
+  boxes.each do |box|
+    raise "Missing top_left" if box.top_left.nil?
+    raise "Missing horizontal" if box.horizontal.nil?
+  end
+end
+
+# Test 17: JSON highlighting
+results << test("JSON highlighting") do
+  data = { "name" => "test", "value" => 123 }
+  output = Rich::JSON.to_s(data)
+  raise "No output" if output.empty?
+end
+
+# Test 18: Columns layout
+results << test("Columns layout") do
+  cols = Rich::Columns.new(%w[one two three four])
+  output = cols.render(max_width: 40)
+  raise "No content" unless output.include?("one")
+end
+
+# Test 19: Windows Console API (on Windows)
+if Gem.win_platform?
+  results << test("Windows Console API") do
+    raise "Win32Console not loaded" unless defined?(Rich::Win32Console)
+    raise "supports_ansi? missing" unless Rich::Win32Console.respond_to?(:supports_ansi?)
+    
+    # Get console size
+    size = Rich::Win32Console.get_size
+    raise "Size detection failed" unless size && size[0] > 0
+  end
+end
+
+# Test 20: Control codes
+results << test("Control codes") do
+  raise "Clear missing" if Rich::Control.clear_screen.empty?
+  raise "Cursor up missing" if Rich::Control.cursor_up(5).empty?
+  raise "Reset missing" if Rich::Control.reset.empty?
+end
+
+puts ""
+puts "=" * 60
+passed = results.count(true)
+total = results.length
+puts "Results: #{passed}/#{total} tests passed"
+puts "=" * 60
+
+if passed == total
+  puts "\n🎉 All tests passed! Rich library is fully functional."
+else
+  puts "\n⚠️  Some tests failed. Please review the output above."
+end

data/examples/visual_demo.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+# Quick visual demo - no interaction needed
+
+require_relative "../lib/rich"
+
+console = Rich::Console.new
+
+puts ""
+console.rule("🎨 Rich Ruby - Quick Visual Demo", style: "bold magenta")
+puts ""
+
+# =============================================================================
+# COLORS & STYLES
+# =============================================================================
+puts "▸ Color & Style Examples:"
+puts ""
+console.print("  Normal text")
+console.print("  Bold text", style: "bold")
+console.print("  Italic text", style: "italic")
+console.print("  Underlined text", style: "underline")
+console.print("  Red text", style: "red")
+console.print("  Green on black", style: "green on black")
+console.print("  Bold blue", style: "bold blue")
+console.print("  Bright magenta italic", style: "bright_magenta italic")
+puts ""
+
+# Color gradient
+print "  Gradient: "
+40.times do |i|
+  r = (255 * i / 40.0).to_i
+  g = (128).to_i
+  b = (255 * (40 - i) / 40.0).to_i
+  style = Rich::Style.new(bgcolor: Rich::Color.from_triplet(Rich::ColorTriplet.new(r, g, b)))
+  console.write(style.render + " " + "\e[0m")
+end
+puts ""
+puts ""
+
+# =============================================================================
+# PANEL
+# =============================================================================
+puts "▸ Panel Example:"
+puts ""
+panel = Rich::Panel.new(
+  "Panels are great for highlighting content!\nThey support titles, subtitles, and styles.",
+  title: "📦 My Panel",
+  subtitle: "Rich Ruby Library",
+  border_style: "cyan",
+  title_style: "bold white"
+)
+puts panel.render(max_width: 55)
+puts ""
+
+# =============================================================================
+# TABLE
+# =============================================================================
+puts "▸ Table Example:"
+puts ""
+table = Rich::Table.new(title: "📊 System Stats", border_style: "green")
+table.add_column("Metric", header_style: "bold cyan")
+table.add_column("Value", justify: :right, header_style: "bold cyan")
+table.add_column("Status", justify: :center, header_style: "bold cyan")
+
+table.add_row("CPU Usage", "45%", "🟢 Normal")
+table.add_row("Memory", "2.4 GB", "🟢 Normal")
+table.add_row("Disk I/O", "120 MB/s", "🟡 High")
+table.add_row("Network", "50 Mbps", "🟢 Normal")
+
+puts table.render(max_width: 55)
+puts ""
+
+# =============================================================================
+# TREE
+# =============================================================================
+puts "▸ Tree Example:"
+puts ""
+tree = Rich::Tree.new("📁 my_project/", style: "bold yellow")
+src = tree.add("📁 src/", style: "bold")
+src.add("📄 main.rb", style: "green")
+src.add("📄 config.rb", style: "green")
+models = src.add("📁 models/", style: "bold")
+models.add("📄 user.rb", style: "green")
+models.add("📄 post.rb", style: "green")
+tree.add("📄 Gemfile", style: "cyan")
+tree.add("📄 README.md", style: "cyan")
+
+puts tree.render
+puts ""
+
+# =============================================================================
+# PROGRESS BARS
+# =============================================================================
+puts "▸ Progress Bar Examples:"
+puts ""
+
+[0, 25, 50, 75, 100].each do |pct|
+  bar = Rich::ProgressBar.new(total: 100, completed: pct, width: 30, complete_style: "green", incomplete_style: "dim")
+  print "  #{pct.to_s.rjust(3)}%: "
+  puts bar.render
+end
+puts ""
+
+# =============================================================================
+# SPINNERS
+# =============================================================================
+puts "▸ Spinner Styles:"
+puts ""
+spinners = [
+  [Rich::ProgressStyle::DOTS, "Dots   "],
+  [Rich::ProgressStyle::LINE, "Line   "],
+  [Rich::ProgressStyle::CIRCLE, "Circle "],
+  [Rich::ProgressStyle::BOUNCE, "Bounce "]
+]
+
+spinners.each do |frames, name|
+  print "  #{name}: "
+  frames.each { |f| print "#{f} " }
+  puts ""
+end
+puts ""
+
+# =============================================================================
+# JSON
+# =============================================================================
+puts "▸ JSON Highlighting:"
+puts ""
+data = {
+  "name" => "Rich",
+  "version" => "0.1.0",
+  "features" => ["colors", "tables", "trees"],
+  "windows" => true
+}
+puts Rich::JSON.to_s(data)
+puts ""
+
+# =============================================================================
+# FINALE
+# =============================================================================
+console.rule("✅ Demo Complete!", style: "bold green")
+puts ""
+console.print("Run ", end_str: "")
+console.print("examples/showcase.rb", style: "bold cyan")
+console.print(" for the interactive version with animations!")
+puts ""

data/lib/rich/_palettes.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require_relative "color_triplet"
+
+module Rich
+  # Color palette definitions for terminal color systems.
+  # Provides lookup tables for standard 16-color, 256-color (8-bit),
+  # and Windows console color palettes.
+  module Palettes
+    # Standard 16-color ANSI palette (colors 0-15)
+    # These are the typical default colors, but terminals may customize them
+    STANDARD_PALETTE = [
+      ColorTriplet.new(0, 0, 0),        # 0: Black
+      ColorTriplet.new(128, 0, 0),      # 1: Red
+      ColorTriplet.new(0, 128, 0),      # 2: Green
+      ColorTriplet.new(128, 128, 0),    # 3: Yellow
+      ColorTriplet.new(0, 0, 128),      # 4: Blue
+      ColorTriplet.new(128, 0, 128),    # 5: Magenta
+      ColorTriplet.new(0, 128, 128),    # 6: Cyan
+      ColorTriplet.new(192, 192, 192),  # 7: White
+      ColorTriplet.new(128, 128, 128),  # 8: Bright Black (Gray)
+      ColorTriplet.new(255, 0, 0),      # 9: Bright Red
+      ColorTriplet.new(0, 255, 0),      # 10: Bright Green
+      ColorTriplet.new(255, 255, 0),    # 11: Bright Yellow
+      ColorTriplet.new(0, 0, 255),      # 12: Bright Blue
+      ColorTriplet.new(255, 0, 255),    # 13: Bright Magenta
+      ColorTriplet.new(0, 255, 255),    # 14: Bright Cyan
+      ColorTriplet.new(255, 255, 255)   # 15: Bright White
+    ].freeze
+
+    # Windows Console palette (slightly different from ANSI standard)
+    WINDOWS_PALETTE = [
+      ColorTriplet.new(12, 12, 12),     # 0: Black
+      ColorTriplet.new(197, 15, 31),    # 1: Red
+      ColorTriplet.new(19, 161, 14),    # 2: Green
+      ColorTriplet.new(193, 156, 0),    # 3: Yellow
+      ColorTriplet.new(0, 55, 218),     # 4: Blue
+      ColorTriplet.new(136, 23, 152),   # 5: Magenta
+      ColorTriplet.new(58, 150, 221),   # 6: Cyan
+      ColorTriplet.new(204, 204, 204),  # 7: White
+      ColorTriplet.new(118, 118, 118),  # 8: Bright Black (Gray)
+      ColorTriplet.new(231, 72, 86),    # 9: Bright Red
+      ColorTriplet.new(22, 198, 12),    # 10: Bright Green
+      ColorTriplet.new(249, 241, 165),  # 11: Bright Yellow
+      ColorTriplet.new(59, 120, 255),   # 12: Bright Blue
+      ColorTriplet.new(180, 0, 158),    # 13: Bright Magenta
+      ColorTriplet.new(97, 214, 214),   # 14: Bright Cyan
+      ColorTriplet.new(242, 242, 242)   # 15: Bright White
+    ].freeze
+
+    # Generate the 256-color (8-bit) palette
+    # Colors 0-15: Standard colors
+    # Colors 16-231: 6x6x6 color cube
+    # Colors 232-255: Grayscale ramp
+    EIGHT_BIT_PALETTE = begin
+      palette = []
+
+      # Colors 0-15: Standard palette
+      STANDARD_PALETTE.each { |color| palette << color }
+
+      # Colors 16-231: 6x6x6 color cube
+      # Each component can be 0, 95, 135, 175, 215, or 255
+      cube_values = [0, 95, 135, 175, 215, 255]
+      (0...6).each do |r|
+        (0...6).each do |g|
+          (0...6).each do |b|
+            palette << ColorTriplet.new(cube_values[r], cube_values[g], cube_values[b])
+          end
+        end
+      end
+
+      # Colors 232-255: Grayscale ramp (24 shades, excluding black and white)
+      (0...24).each do |i|
+        gray = 8 + i * 10
+        palette << ColorTriplet.new(gray, gray, gray)
+      end
+
+      palette.freeze
+    end
+
+    class << self
+      # Find the closest color in a palette
+      # @param triplet [ColorTriplet] Color to match
+      # @param palette [Array<ColorTriplet>] Palette to search
+      # @param start_index [Integer] Starting index in palette
+      # @param end_index [Integer] Ending index in palette (exclusive)
+      # @return [Integer] Index of closest matching color
+      def match_color(triplet, palette: EIGHT_BIT_PALETTE, start_index: 0, end_index: nil)
+        end_index ||= palette.length
+
+        best_index = start_index
+        best_distance = Float::INFINITY
+
+        (start_index...end_index).each do |i|
+          distance = triplet.weighted_distance(palette[i])
+          if distance < best_distance
+            best_distance = distance
+            best_index = i
+          end
+        end
+
+        best_index
+      end
+
+      # Match to standard 16-color palette
+      # @param triplet [ColorTriplet] Color to match
+      # @return [Integer] Standard color index (0-15)
+      def match_standard(triplet)
+        match_color(triplet, palette: STANDARD_PALETTE, start_index: 0, end_index: 16)
+      end
+
+      # Match to 8-bit palette (256 colors)
+      # @param triplet [ColorTriplet] Color to match
+      # @return [Integer] 8-bit color index (0-255)
+      def match_eight_bit(triplet)
+        match_color(triplet, palette: EIGHT_BIT_PALETTE, start_index: 0, end_index: 256)
+      end
+
+      # Match to Windows console palette
+      # @param triplet [ColorTriplet] Color to match
+      # @return [Integer] Windows color index (0-15)
+      def match_windows(triplet)
+        match_color(triplet, palette: WINDOWS_PALETTE, start_index: 0, end_index: 16)
+      end
+
+      # Get a color from the 8-bit palette
+      # @param index [Integer] Color index (0-255)
+      # @return [ColorTriplet]
+      def get_eight_bit(index)
+        EIGHT_BIT_PALETTE[index.clamp(0, 255)]
+      end
+
+      # Get a color from the standard palette
+      # @param index [Integer] Color index (0-15)
+      # @return [ColorTriplet]
+      def get_standard(index)
+        STANDARD_PALETTE[index.clamp(0, 15)]
+      end
+
+      # Get a color from the Windows palette
+      # @param index [Integer] Color index (0-15)
+      # @return [ColorTriplet]
+      def get_windows(index)
+        WINDOWS_PALETTE[index.clamp(0, 15)]
+      end
+    end
+  end
+end