shellfie 0.1.0

data/examples/animation.yml

@@ -0,0 +1,33 @@
+# animation.yml - Animated GIF example
+theme: macos
+title: "Terminal — zsh"
+
+window:
+  width: 600
+  padding: 20
+
+animation:
+  typing_speed: 50
+  command_delay: 500
+  cursor_blink: true
+  loop: true
+
+frames:
+  - prompt: "$ "
+    type: "echo Hello, World!"
+    delay: 500
+
+  - output: "Hello, World!"
+    delay: 1000
+
+  - prompt: "$ "
+    type: "ls -la"
+    delay: 500
+
+  - output: |
+      total 24
+      drwxr-xr-x  5 user  staff   160 Jan 10 10:00 .
+      drwxr-xr-x  3 user  staff    96 Jan 10 09:00 ..
+      -rw-r--r--  1 user  staff  1024 Jan 10 10:00 README.md
+      -rw-r--r--  1 user  staff   512 Jan 10 10:00 Gemfile
+    delay: 2000

data/examples/colored.yml

@@ -0,0 +1,20 @@
+# colored.yml - Example with ANSI color codes
+theme: ubuntu
+title: "user@ubuntu: ~/project"
+
+window:
+  width: 700
+  padding: 20
+
+lines:
+  - prompt: "\e[32muser@ubuntu\e[0m:\e[34m~/project\e[0m$ "
+    command: "bundle exec rspec"
+
+  - output: |
+      \e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m\e[32m.\e[0m
+
+  - output: "Finished in 0.12 seconds (files took 0.5 seconds to load)"
+  - output: "\e[32m10 examples, 0 failures\e[0m"
+
+  - prompt: "\e[32muser@ubuntu\e[0m:\e[34m~/project\e[0m$ "
+    command: ""

data/examples/demo_animation.yml

@@ -0,0 +1,31 @@
+theme: macos
+title: "Terminal — zsh"
+
+window:
+  width: 550
+  padding: 18
+  visible_lines: 7
+
+animation:
+  typing_speed: 35
+  command_delay: 400
+  loop: true
+
+frames:
+  - prompt: "$ "
+    type: "shellfie generate config.yml -o demo.png"
+    delay: 600
+
+  - output: "Generated: demo.png"
+    delay: 1200
+
+  - prompt: "$ "
+    type: "shellfie themes"
+    delay: 500
+
+  - output: |
+      Available themes:
+        macos   - macOS Terminal style
+        ubuntu  - Ubuntu Terminal style
+        windows - Windows Terminal style
+    delay: 2000

data/examples/headless.yml

@@ -0,0 +1,16 @@
+# headless.yml - Terminal output without window decoration
+theme: macos
+headless: true
+
+window:
+  width: 500
+  padding: 15
+
+lines:
+  - prompt: "$ "
+    command: "ruby -v"
+
+  - output: "ruby 3.3.0 (2024-12-25 revision 5124f9ac75) [arm64-darwin24]"
+
+  - prompt: "$ "
+    command: ""

data/examples/scrolling.yml

@@ -0,0 +1,48 @@
+# scrolling.yml - Animation with fixed visible lines and scrolling
+theme: macos
+title: "Terminal — zsh"
+
+window:
+  width: 600
+  padding: 20
+  visible_lines: 6  # Number of lines visible in the terminal window
+
+animation:
+  typing_speed: 40
+  command_delay: 300
+  loop: true
+
+frames:
+  - prompt: "$ "
+    type: "for i in {1..10}; do echo \"Line $i\"; done"
+    delay: 500
+
+  - output: "Line 1"
+    delay: 200
+
+  - output: "Line 2"
+    delay: 200
+
+  - output: "Line 3"
+    delay: 200
+
+  - output: "Line 4"
+    delay: 200
+
+  - output: "Line 5"
+    delay: 200
+
+  - output: "Line 6"
+    delay: 200
+
+  - output: "Line 7"
+    delay: 200
+
+  - output: "Line 8"
+    delay: 200
+
+  - output: "Line 9"
+    delay: 200
+
+  - output: "Line 10"
+    delay: 1500

data/examples/simple.yml

@@ -0,0 +1,21 @@
+# simple.yml - Basic terminal screenshot example
+theme: macos
+title: "Terminal — zsh"
+
+window:
+  width: 600
+  padding: 20
+
+lines:
+  - prompt: "$ "
+    command: "gem install shellfie"
+
+  - output: |
+      Fetching shellfie-0.1.0.gem
+      Successfully installed shellfie-0.1.0
+      1 gem installed
+
+  - prompt: "$ "
+    command: "shellfie --version"
+
+  - output: "shellfie 0.1.0"

data/exe/shellfie

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/shellfie"
+
+Shellfie::CLI.new(ARGV).run

data/exe/shf

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# shf - Short alias for shellfie
+load File.expand_path("shellfie", __dir__)

data/lib/shellfie/ansi_parser.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+require "strscan"
+
+module Shellfie
+  Segment = Struct.new(:text, :foreground, :background, :bold, :italic, :underline, keyword_init: true)
+
+  class AnsiParser
+    ANSI_REGEX = /\e\[([0-9;]*)m/
+
+    COLORS = {
+      30 => :black,
+      31 => :red,
+      32 => :green,
+      33 => :yellow,
+      34 => :blue,
+      35 => :magenta,
+      36 => :cyan,
+      37 => :white,
+      90 => :bright_black,
+      91 => :bright_red,
+      92 => :bright_green,
+      93 => :bright_yellow,
+      94 => :bright_blue,
+      95 => :bright_magenta,
+      96 => :bright_cyan,
+      97 => :bright_white
+    }.freeze
+
+    BG_COLORS = {
+      40 => :black,
+      41 => :red,
+      42 => :green,
+      43 => :yellow,
+      44 => :blue,
+      45 => :magenta,
+      46 => :cyan,
+      47 => :white,
+      100 => :bright_black,
+      101 => :bright_red,
+      102 => :bright_green,
+      103 => :bright_yellow,
+      104 => :bright_blue,
+      105 => :bright_magenta,
+      106 => :bright_cyan,
+      107 => :bright_white
+    }.freeze
+
+    def initialize
+      reset_state
+    end
+
+    def parse(text)
+      segments = []
+      scanner = StringScanner.new(text)
+      current_text = +""
+
+      while !scanner.eos?
+        if scanner.scan(ANSI_REGEX)
+          unless current_text.empty?
+            segments << create_segment(current_text)
+            current_text = +""
+          end
+          process_codes(scanner[1])
+        else
+          current_text << scanner.getch
+        end
+      end
+
+      segments << create_segment(current_text) unless current_text.empty?
+      segments
+    end
+
+    private
+
+    def reset_state
+      @foreground = nil
+      @background = nil
+      @bold = false
+      @italic = false
+      @underline = false
+    end
+
+    def create_segment(text)
+      Segment.new(
+        text: text,
+        foreground: @foreground,
+        background: @background,
+        bold: @bold,
+        italic: @italic,
+        underline: @underline
+      )
+    end
+
+    def process_codes(codes_str)
+      return reset_state if codes_str.empty?
+
+      codes = codes_str.split(";").map(&:to_i)
+      i = 0
+
+      while i < codes.length
+        code = codes[i]
+
+        case code
+        when 0
+          reset_state
+        when 1
+          @bold = true
+        when 3
+          @italic = true
+        when 4
+          @underline = true
+        when 22
+          @bold = false
+        when 23
+          @italic = false
+        when 24
+          @underline = false
+        when 30..37, 90..97
+          @foreground = COLORS[code]
+        when 38
+          i, @foreground = parse_extended_color(codes, i)
+        when 39
+          @foreground = nil
+        when 40..47, 100..107
+          @background = BG_COLORS[code]
+        when 48
+          i, @background = parse_extended_color(codes, i)
+        when 49
+          @background = nil
+        end
+
+        i += 1
+      end
+    end
+
+    def parse_extended_color(codes, i)
+      return [i, nil] if codes[i + 1].nil?
+
+      case codes[i + 1]
+      when 5
+        color_index = codes[i + 2]
+        [i + 2, color_256(color_index)]
+      when 2
+        r, g, b = codes[i + 2], codes[i + 3], codes[i + 4]
+        [i + 4, format("#%02x%02x%02x", r, g, b)]
+      else
+        [i, nil]
+      end
+    end
+
+    def color_256(index)
+      return nil unless index
+
+      if index < 16
+        standard_colors = %i[
+          black red green yellow blue magenta cyan white
+          bright_black bright_red bright_green bright_yellow
+          bright_blue bright_magenta bright_cyan bright_white
+        ]
+        standard_colors[index]
+      elsif index < 232
+        index -= 16
+        r = (index / 36) * 51
+        g = ((index % 36) / 6) * 51
+        b = (index % 6) * 51
+        format("#%02x%02x%02x", r, g, b)
+      else
+        gray = (index - 232) * 10 + 8
+        format("#%02x%02x%02x", gray, gray, gray)
+      end
+    end
+  end
+end

data/lib/shellfie/cli.rb

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../shellfie"
+
+module Shellfie
+  class CLI
+    COMMANDS = %w[generate init themes validate version help].freeze
+
+    def initialize(args)
+      @args = args
+      @options = {}
+    end
+
+    def run
+      return show_help if @args.empty?
+
+      command = @args.shift
+
+      case command
+      when "generate", "g"
+        run_generate
+      when "init"
+        run_init
+      when "themes"
+        run_themes
+      when "validate"
+        run_validate
+      when "version", "-v", "--version"
+        run_version
+      when "help", "-h", "--help"
+        show_help
+      else
+        puts "Unknown command: #{command}"
+        puts "Run 'shellfie help' for usage information."
+        exit 1
+      end
+    rescue Shellfie::Error => e
+      puts "Error: #{e.message}"
+      exit determine_exit_code(e)
+    end
+
+    private
+
+    def run_generate
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: shellfie generate INPUT_FILE [options]"
+
+        opts.on("-o", "--output PATH", "Output file path (required)") do |path|
+          @options[:output] = path
+        end
+
+        opts.on("-t", "--theme NAME", "Override theme (macos, ubuntu, windows)") do |theme|
+          @options[:theme] = theme
+        end
+
+        opts.on("-a", "--animate", "Generate animated GIF") do
+          @options[:animate] = true
+        end
+
+        opts.on("-s", "--scale FACTOR", "Output scale (1, 2, 3)") do |scale|
+          @options[:scale] = scale.to_i
+        end
+
+        opts.on("-w", "--width PIXELS", Integer, "Override width") do |width|
+          @options[:width] = width
+        end
+
+        opts.on("--no-shadow", "Disable shadow effect") do
+          @options[:shadow] = false
+        end
+
+        opts.on("--transparent", "Transparent background") do
+          @options[:transparent] = true
+        end
+
+        opts.on("--no-header", "Disable window header (headless mode)") do
+          @options[:headless] = true
+        end
+      end
+
+      parser.parse!(@args)
+
+      input_file = @args.shift
+      raise ConfigError, "Input file is required" unless input_file
+      raise ConfigError, "Output file is required (use -o option)" unless @options[:output]
+
+      config = Parser.parse(input_file)
+
+      if @options[:theme] || @options[:width] || @options[:headless]
+        config = Config.new(
+          theme: @options[:theme] || config.theme,
+          title: config.title,
+          window: config.window.merge(@options[:width] ? { width: @options[:width] } : {}),
+          font: config.font,
+          lines: config.lines,
+          animation: config.animation,
+          frames: config.frames,
+          headless: @options[:headless] || config.headless
+        )
+      end
+
+      if @options[:animate] || config.animated?
+        generator = GifGenerator.new(config)
+        output = generator.generate(
+          @options[:output],
+          scale: @options[:scale] || 1,
+          shadow: @options[:shadow] != false
+        )
+      else
+        renderer = Renderer.new(config)
+        output = renderer.render(
+          @options[:output],
+          scale: @options[:scale] || 1,
+          shadow: @options[:shadow] != false,
+          transparent: @options[:transparent] || false
+        )
+      end
+
+      puts "Generated: #{output}"
+    end
+
+    def run_init
+      sample_config = <<~YAML
+        # Shellfie configuration file
+        theme: macos
+        title: "Terminal — zsh"
+
+        window:
+          width: 600
+          padding: 20
+
+        lines:
+          - prompt: "$ "
+            command: "gem install shellfie"
+
+          - output: |
+              Fetching shellfie-#{VERSION}.gem
+              Successfully installed shellfie-#{VERSION}
+              1 gem installed
+
+          - prompt: "$ "
+            command: "shellfie --version"
+
+          - output: "shellfie #{VERSION}"
+      YAML
+
+      puts sample_config
+    end
+
+    def run_themes
+      puts "Available themes:"
+      puts
+      puts "  macos     - macOS Terminal style (red/yellow/green buttons, left side)"
+      puts "  ubuntu    - Ubuntu Terminal style (buttons on right side)"
+      puts "  windows   - Windows Terminal style (square corners, icons)"
+      puts
+      puts "Use: shellfie generate config.yml -o output.png -t THEME_NAME"
+    end
+
+    def run_validate
+      input_file = @args.shift
+      raise ConfigError, "Input file is required" unless input_file
+
+      config = Parser.parse(input_file)
+      puts "✓ Configuration is valid"
+      puts "  Theme: #{config.theme}"
+      puts "  Title: #{config.title}"
+      puts "  Lines: #{config.lines.size}"
+      puts "  Mode: #{config.animated? ? "animated" : "static"}"
+    end
+
+    def run_version
+      puts "shellfie #{VERSION}"
+    end
+
+    def show_help
+      puts <<~HELP
+        Shellfie - Terminal screenshot-style image generator
+
+        Usage: shellfie <command> [options]
+               shf <command> [options]
+
+        Commands:
+          generate    Generate image from configuration file
+          init        Output sample configuration
+          themes      List available themes
+          validate    Validate configuration file
+          version     Show version
+          help        Show this help
+
+        Generate Options:
+          -o, --output PATH      Output file path (required)
+          -t, --theme NAME       Override theme (macos, ubuntu, windows)
+          -a, --animate          Generate animated GIF
+          -s, --scale FACTOR     Output scale (1, 2, 3)
+          -w, --width PIXELS     Override width
+          --no-shadow            Disable shadow effect
+          --no-header            Disable window header (headless mode)
+          --transparent          Transparent background
+
+        Examples:
+          shellfie generate config.yml -o terminal.png
+          shellfie generate config.yml -o demo.gif --animate
+          shellfie generate config.yml -o retina.png --scale 2
+          shellfie init > my-config.yml
+          shellfie themes
+
+          # Short form
+          shf generate config.yml -o terminal.png
+          shf init > config.yml
+      HELP
+    end
+
+    def determine_exit_code(error)
+      case error
+      when ParseError, ValidationError
+        2
+      when RenderError, ImageError
+        3
+      when DependencyError
+        4
+      else
+        1
+      end
+    end
+  end
+end

data/lib/shellfie/config.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Shellfie
+  class Config
+    DEFAULTS = {
+      theme: "macos",
+      window: {
+        width: 600,
+        padding: 20,
+        opacity: 1.0,
+        visible_lines: nil
+      },
+      font: {
+        family: "Monaco",
+        size: 14,
+        line_height: 1.4
+      },
+      animation: {
+        typing_speed: 80,
+        command_delay: 500,
+        cursor_blink: true,
+        loop: false
+      }
+    }.freeze
+
+    attr_reader :theme, :title, :window, :font, :lines, :animation, :frames, :headless
+
+    def initialize(options = {})
+      merged = merge_defaults(options)
+      @theme = merged[:theme]
+      @title = merged[:title] || "Terminal"
+      @window = merged[:window]
+      @font = merged[:font]
+      @lines = merged[:lines] || []
+      @animation = merged[:animation]
+      @frames = merged[:frames] || []
+      @headless = options[:headless] || false
+    end
+
+    def static?
+      @frames.empty?
+    end
+
+    def animated?
+      !static?
+    end
+
+    private
+
+    def merge_defaults(options)
+      result = {}
+      DEFAULTS.each do |key, value|
+        result[key] = if value.is_a?(Hash) && options[key].is_a?(Hash)
+                        value.merge(options[key])
+                      else
+                        options.key?(key) ? options[key] : value
+                      end
+      end
+      result[:title] = options[:title]
+      result[:lines] = options[:lines]
+      result[:frames] = options[:frames]
+      result
+    end
+  end
+end

data/lib/shellfie/errors.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Shellfie
+  class Error < StandardError; end
+
+  class ConfigError < Error; end
+  class ParseError < ConfigError; end
+  class ValidationError < ConfigError; end
+
+  class RenderError < Error; end
+  class FontError < RenderError; end
+  class ImageError < RenderError; end
+
+  class DependencyError < Error; end
+end