shellfie 0.1.0

data/lib/shellfie/gif_generator.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "mini_magick"
+require_relative "renderer"
+
+module Shellfie
+  class GifGenerator
+    attr_reader :config, :theme
+
+    def initialize(config)
+      @config = config
+      @renderer = Renderer.new(config)
+      @theme = @renderer.theme
+    end
+
+    def generate(output_path, scale: 1, shadow: true)
+      check_dependencies!
+
+      frames = build_animation_frames
+      images = render_frames(frames, scale: scale, shadow: shadow)
+      combine_to_gif(images, output_path)
+      cleanup_temp_files(images)
+      output_path
+    end
+
+    private
+
+    def check_dependencies!
+      result = `which magick 2>/dev/null || which convert 2>/dev/null`.strip
+      if result.empty?
+        raise DependencyError, <<~MSG
+          ImageMagick not found
+            → Please install ImageMagick: brew install imagemagick
+            → Or visit: https://imagemagick.org/script/download.php
+        MSG
+      end
+    end
+
+    def build_animation_frames
+      frames = []
+      current_lines = []
+      animation_settings = config.animation
+
+      config.frames.each do |frame|
+        if frame.type
+          typing_frames = build_typing_frames(
+            current_lines.dup,
+            frame.prompt || "",
+            frame.type,
+            animation_settings[:typing_speed] || 80
+          )
+          frames.concat(typing_frames)
+          current_lines << { prompt: frame.prompt, command: frame.type }
+        end
+
+        if frame.output
+          frame.output.split("\n").each do |line|
+            current_lines << { output: line }
+          end
+          frames << { lines: build_display_lines(current_lines), delay: frame.delay || 100 }
+        end
+
+        if frame.delay && frame.delay > 0 && !frame.output
+          frames << { lines: build_display_lines(current_lines), delay: frame.delay }
+        end
+      end
+
+      frames
+    end
+
+    def build_typing_frames(base_lines, prompt, command, typing_speed)
+      frames = []
+      chars = command.chars
+
+      chars.each_with_index do |_char, i|
+        typed = command[0..i]
+        lines = base_lines.dup
+        lines << { prompt: prompt, command: typed, cursor: true }
+        frames << { lines: build_display_lines(lines), delay: typing_speed }
+      end
+
+      final_lines = base_lines.dup
+      final_lines << { prompt: prompt, command: command }
+      frames << { lines: build_display_lines(final_lines), delay: typing_speed }
+
+      frames
+    end
+
+    def build_display_lines(lines_data)
+      lines_data.map do |line_data|
+        if line_data[:prompt]
+          text = "#{line_data[:prompt]}#{line_data[:command]}"
+          text += "█" if line_data[:cursor]
+          Line.new(prompt: text, command: nil, output: nil)
+        else
+          Line.new(prompt: nil, command: nil, output: line_data[:output])
+        end
+      end
+    end
+
+    def render_frames(frames, scale:, shadow:)
+      temp_dir = Dir.mktmpdir("shellfie")
+      images = []
+
+      frames.each_with_index do |frame, idx|
+        frame_config = create_frame_config(frame[:lines])
+        renderer = Renderer.new(frame_config)
+        output_path = File.join(temp_dir, "frame_#{format("%04d", idx)}.png")
+        renderer.render(output_path, scale: scale, shadow: shadow)
+        images << { path: output_path, delay: frame[:delay] }
+      end
+
+      images
+    end
+
+    def create_frame_config(lines)
+      Config.new(
+        theme: config.theme,
+        title: config.title,
+        window: config.window,
+        font: config.font,
+        lines: lines,
+        headless: config.headless
+      )
+    end
+
+    def combine_to_gif(images, output_path)
+      MiniMagick.convert do |convert|
+        convert.dispose "background"
+        convert.loop config.animation[:loop] ? 0 : 1
+
+        images.each do |img|
+          delay = (img[:delay] / 10.0).round
+          convert.delay delay
+          convert << img[:path]
+        end
+
+        convert.dither "FloydSteinberg"
+        convert.colors 256
+        convert.layers "optimize"
+        convert << output_path
+      end
+    end
+
+    def cleanup_temp_files(images)
+      images.each { |img| File.delete(img[:path]) if File.exist?(img[:path]) }
+      temp_dir = File.dirname(images.first[:path]) if images.any?
+      Dir.rmdir(temp_dir) if temp_dir && Dir.exist?(temp_dir) && Dir.empty?(temp_dir)
+    end
+  end
+end

data/lib/shellfie/parser.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "yaml"
+require_relative "config"
+require_relative "errors"
+
+module Shellfie
+  class Parser
+    class << self
+      def parse(path)
+        raise ParseError, "Configuration file not found: #{path}" unless File.exist?(path)
+
+        content = File.read(path)
+        parse_string(content)
+      end
+
+      def parse_string(content)
+        raw = YAML.safe_load(content, symbolize_names: true)
+        validate_config(raw)
+        build_config(raw)
+      rescue Psych::SyntaxError => e
+        raise ParseError, "Invalid YAML syntax: #{e.message}"
+      end
+
+      private
+
+      def validate_config(raw)
+        raise ValidationError, "Empty configuration" if raw.nil? || raw.empty?
+
+        valid_themes = %w[macos ubuntu windows]
+        if raw[:theme] && !valid_themes.include?(raw[:theme])
+          raise ValidationError, "Invalid theme '#{raw[:theme]}'\n  → Available themes: #{valid_themes.join(", ")}"
+        end
+
+        if raw[:lines].nil? && raw[:frames].nil?
+          raise ValidationError, "Configuration must have either 'lines' or 'frames'"
+        end
+      end
+
+      def build_config(raw)
+        options = {
+          theme: raw[:theme],
+          title: raw[:title],
+          window: symbolize_hash(raw[:window]),
+          font: symbolize_hash(raw[:font]),
+          lines: parse_lines(raw[:lines]),
+          animation: symbolize_hash(raw[:animation]),
+          frames: parse_frames(raw[:frames]),
+          headless: raw[:headless] || false
+        }.compact
+
+        Config.new(options)
+      end
+
+      def symbolize_hash(hash)
+        return nil unless hash.is_a?(Hash)
+
+        hash.transform_keys(&:to_sym)
+      end
+
+      def parse_lines(lines)
+        return [] unless lines.is_a?(Array)
+
+        lines.map do |line|
+          Line.new(
+            prompt: line[:prompt],
+            command: line[:command],
+            output: line[:output]
+          )
+        end
+      end
+
+      def parse_frames(frames)
+        return [] unless frames.is_a?(Array)
+
+        frames.map do |frame|
+          Frame.new(
+            prompt: frame[:prompt],
+            type: frame[:type],
+            output: frame[:output],
+            delay: frame[:delay] || 0
+          )
+        end
+      end
+    end
+  end
+
+  Line = Struct.new(:prompt, :command, :output, keyword_init: true)
+  Frame = Struct.new(:prompt, :type, :output, :delay, keyword_init: true)
+end

data/lib/shellfie/renderer.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+require "mini_magick"
+require_relative "ansi_parser"
+require_relative "themes/base"
+require_relative "themes/macos"
+require_relative "themes/ubuntu"
+require_relative "themes/windows_terminal"
+
+module Shellfie
+  class Renderer
+    THEMES = {
+      "macos" => Themes::MacOS,
+      "ubuntu" => Themes::Ubuntu,
+      "windows" => Themes::WindowsTerminal
+    }.freeze
+
+    attr_reader :config, :theme
+
+    def initialize(config)
+      @config = config
+      @theme = load_theme(config.theme)
+      @ansi_parser = AnsiParser.new
+    end
+
+    def render(output_path, scale: 1, shadow: true, transparent: false)
+      check_dependencies!
+
+      lines = build_lines
+      create_image(lines, output_path, scale: scale, shadow: shadow, transparent: transparent)
+      output_path
+    end
+
+    private
+
+    def load_theme(name)
+      klass = THEMES[name] || THEMES["macos"]
+      klass.new
+    end
+
+    def check_dependencies!
+      result = `which magick 2>/dev/null || which convert 2>/dev/null`.strip
+      if result.empty?
+        raise DependencyError, <<~MSG
+          ImageMagick not found
+            → Please install ImageMagick: brew install imagemagick
+            → Or visit: https://imagemagick.org/script/download.php
+        MSG
+      end
+    end
+
+    def build_lines
+      config.lines.flat_map do |line|
+        result = []
+        if line.prompt
+          prompt_segments = @ansi_parser.parse(line.prompt)
+          command_segments = line.command ? @ansi_parser.parse(line.command) : []
+          result << { segments: prompt_segments + command_segments }
+        end
+        if line.output
+          line.output.split("\n").each do |output_line|
+            result << { segments: @ansi_parser.parse(output_line) }
+          end
+        end
+        result
+      end
+    end
+
+    def create_image(lines, output_path, scale:, shadow:, transparent:)
+      decoration = theme.window_decoration
+      font_config = config.font.is_a?(Hash) ? config.font : theme.font
+      padding = config.window[:padding] || 20
+      width = config.window[:width] || 600
+      line_height = (font_config[:size] || 14) * (font_config[:line_height] || 1.4)
+      title_bar_height = config.headless ? 0 : decoration[:title_bar_height]
+      visible_lines = config.window[:visible_lines]
+
+      display_line_count = visible_lines || lines.size
+      content_height = display_line_count * line_height + padding * 2
+      total_height = title_bar_height + content_height
+      corner_radius = decoration[:corner_radius]
+
+      if visible_lines && lines.size > visible_lines
+        lines = lines.last(visible_lines)
+      end
+
+      scaled_width = (width * scale).to_i
+      scaled_height = (total_height * scale).to_i
+      scaled_padding = (padding * scale).to_i
+      scaled_title_bar = (title_bar_height * scale).to_i
+      scaled_line_height = (line_height * scale).to_i
+      scaled_font_size = ((font_config[:size] || 14) * scale).to_i
+      scaled_radius = (corner_radius * scale).to_i
+
+      margin = shadow ? (50 * scale).to_i : (10 * scale).to_i
+      canvas_width = scaled_width + margin * 2
+      canvas_height = scaled_height + margin * 2
+
+      MiniMagick.convert do |convert|
+        convert.size "#{canvas_width}x#{canvas_height}"
+        convert << "xc:transparent"
+
+        if shadow
+          convert.fill "rgba(0,0,0,0.3)"
+          shadow_offset = (10 * scale).to_i
+          convert.draw "roundrectangle #{margin + shadow_offset},#{margin + shadow_offset} " \
+                       "#{margin + scaled_width - 1 + shadow_offset},#{margin + scaled_height - 1 + shadow_offset} " \
+                       "#{scaled_radius},#{scaled_radius}"
+          convert.blur "0x#{(15 * scale).to_i}"
+        end
+
+        convert.fill theme.colors[:background]
+        convert.draw "roundrectangle #{margin},#{margin} " \
+                     "#{margin + scaled_width - 1},#{margin + scaled_height - 1} " \
+                     "#{scaled_radius},#{scaled_radius}"
+
+        unless config.headless
+          convert.fill theme.colors[:title_bar]
+          title_y2 = margin + scaled_title_bar - 1
+          convert.draw "roundrectangle #{margin},#{margin} " \
+                       "#{margin + scaled_width - 1},#{title_y2} " \
+                       "#{scaled_radius},#{scaled_radius}"
+          convert.fill theme.colors[:title_bar]
+          convert.draw "rectangle #{margin},#{margin + scaled_radius} " \
+                       "#{margin + scaled_width - 1},#{title_y2}"
+
+          button_x, button_y = button_positions(margin, scaled_title_bar, scale)
+          button_radius = ((theme.window_decoration[:button_size] / 2) * scale).to_i
+
+          theme.button_colors.each_with_index do |color, i|
+            spacing = ((theme.window_decoration[:button_spacing] + theme.window_decoration[:button_size]) * scale).to_i
+            bx = button_x + i * spacing
+            convert.fill color
+            convert.draw "circle #{bx},#{button_y} #{bx + button_radius},#{button_y}"
+          end
+
+          convert.fill theme.colors[:title_text]
+          convert.pointsize scaled_font_size
+          title_y = margin + scaled_title_bar / 2 + scaled_font_size / 3
+          title_x = margin + scaled_width / 2
+          convert.gravity "NorthWest"
+          convert.draw "text #{title_x - config.title.to_s.length * scaled_font_size / 4},#{title_y - scaled_font_size} '#{escape_text(config.title.to_s)}'"
+        end
+
+        content_y = margin + scaled_title_bar + scaled_padding
+        lines.each_with_index do |line, idx|
+          y = content_y + idx * scaled_line_height + scaled_font_size
+          x = margin + scaled_padding
+          draw_line_segments(convert, line[:segments], x, y, scaled_font_size, font_config)
+        end
+
+        convert << output_path
+      end
+    end
+
+    def button_positions(margin, title_bar_height, scale)
+      button_size = (theme.window_decoration[:button_size] * scale).to_i
+      scaled_width = ((config.window[:width] || 600) * scale).to_i
+
+      if theme.buttons_position == :left
+        x = margin + (16 * scale).to_i
+      else
+        x = margin + scaled_width - (16 * scale).to_i - button_size * 3
+      end
+      y = margin + title_bar_height / 2
+
+      [x, y]
+    end
+
+    def draw_line_segments(convert, segments, x, y, font_size, font_config)
+      current_x = x
+
+      segments.each do |segment|
+        color = segment.foreground ? theme.color_for(segment.foreground) : theme.colors[:foreground]
+        text = escape_text(segment.text)
+
+        next if text.empty?
+
+        convert.fill color
+        convert.pointsize font_size
+
+        convert.draw "text #{current_x},#{y} '#{text}'"
+
+        char_width = font_size * 0.6
+        current_x += (segment.text.length * char_width).to_i
+      end
+    end
+
+    def escape_text(text)
+      text.to_s.gsub("'", "\\\\'").gsub("\\", "\\\\\\\\")
+    end
+  end
+end

data/lib/shellfie/themes/base.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Shellfie
+  module Themes
+    class Base
+      def name
+        "base"
+      end
+
+      def window_decoration
+        {
+          title_bar_height: 28,
+          button_size: 12,
+          button_spacing: 8,
+          corner_radius: 10,
+          shadow: { blur: 20, offset_x: 0, offset_y: 10, color: "rgba(0,0,0,0.3)" }
+        }
+      end
+
+      def colors
+        {
+          background: "#1e1e1e",
+          foreground: "#ffffff",
+          title_bar: "#3c3c3c",
+          title_text: "#ffffff",
+          black: "#000000",
+          red: "#ff5555",
+          green: "#50fa7b",
+          yellow: "#f1fa8c",
+          blue: "#6272a4",
+          magenta: "#ff79c6",
+          cyan: "#8be9fd",
+          white: "#f8f8f2",
+          bright_black: "#6272a4",
+          bright_red: "#ff6e6e",
+          bright_green: "#69ff94",
+          bright_yellow: "#ffffa5",
+          bright_blue: "#d6acff",
+          bright_magenta: "#ff92df",
+          bright_cyan: "#a4ffff",
+          bright_white: "#ffffff"
+        }
+      end
+
+      def button_colors
+        %w[#ff5f56 #ffbd2e #27c93f]
+      end
+
+      def button_style
+        :circles
+      end
+
+      def buttons_position
+        :left
+      end
+
+      def font
+        {
+          family: "Monaco",
+          size: 14,
+          line_height: 1.4
+        }
+      end
+
+      def color_for(name)
+        return name if name.is_a?(String) && name.start_with?("#")
+
+        colors[name.to_sym] || colors[:foreground]
+      end
+    end
+  end
+end

data/lib/shellfie/themes/macos.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Shellfie
+  module Themes
+    class MacOS < Base
+      def name
+        "macos"
+      end
+
+      def window_decoration
+        {
+          title_bar_height: 28,
+          button_size: 12,
+          button_spacing: 8,
+          corner_radius: 10,
+          shadow: { blur: 50, offset_x: 0, offset_y: 25, color: "rgba(0,0,0,0.4)" }
+        }
+      end
+
+      def colors
+        super.merge(
+          background: "#1e1e1e",
+          title_bar: "#3c3c3c",
+          title_text: "#ffffff"
+        )
+      end
+
+      def button_colors
+        %w[#ff5f56 #ffbd2e #27c93f]
+      end
+
+      def button_style
+        :circles
+      end
+
+      def buttons_position
+        :left
+      end
+
+      def font
+        {
+          family: "SF Mono",
+          size: 14,
+          line_height: 1.4
+        }
+      end
+    end
+  end
+end

data/lib/shellfie/themes/ubuntu.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Shellfie
+  module Themes
+    class Ubuntu < Base
+      def name
+        "ubuntu"
+      end
+
+      def window_decoration
+        {
+          title_bar_height: 36,
+          button_size: 14,
+          button_spacing: 6,
+          corner_radius: 12,
+          shadow: { blur: 30, offset_x: 0, offset_y: 15, color: "rgba(0,0,0,0.35)" }
+        }
+      end
+
+      def colors
+        super.merge(
+          background: "#300a24",
+          foreground: "#ffffff",
+          title_bar: "#2c2c2c",
+          title_text: "#ffffff",
+          green: "#4e9a06",
+          yellow: "#c4a000",
+          blue: "#3465a4",
+          magenta: "#75507b",
+          cyan: "#06989a"
+        )
+      end
+
+      def button_colors
+        %w[#f46067 #f5bf55 #5fc454]
+      end
+
+      def button_style
+        :circles
+      end
+
+      def buttons_position
+        :right
+      end
+
+      def font
+        {
+          family: "Ubuntu Mono",
+          size: 14,
+          line_height: 1.4
+        }
+      end
+    end
+  end
+end

data/lib/shellfie/themes/windows_terminal.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Shellfie
+  module Themes
+    class WindowsTerminal < Base
+      def name
+        "windows"
+      end
+
+      def window_decoration
+        {
+          title_bar_height: 32,
+          button_size: 10,
+          button_spacing: 0,
+          corner_radius: 0,
+          shadow: { blur: 15, offset_x: 0, offset_y: 5, color: "rgba(0,0,0,0.25)" }
+        }
+      end
+
+      def colors
+        super.merge(
+          background: "#0c0c0c",
+          foreground: "#cccccc",
+          title_bar: "#1f1f1f",
+          title_text: "#ffffff",
+          black: "#0c0c0c",
+          red: "#c50f1f",
+          green: "#13a10e",
+          yellow: "#c19c00",
+          blue: "#0037da",
+          magenta: "#881798",
+          cyan: "#3a96dd",
+          white: "#cccccc",
+          bright_black: "#767676",
+          bright_red: "#e74856",
+          bright_green: "#16c60c",
+          bright_yellow: "#f9f1a5",
+          bright_blue: "#3b78ff",
+          bright_magenta: "#b4009e",
+          bright_cyan: "#61d6d6",
+          bright_white: "#f2f2f2"
+        )
+      end
+
+      def button_style
+        :icons
+      end
+
+      def buttons_position
+        :right
+      end
+
+      def font
+        {
+          family: "Cascadia Mono",
+          size: 14,
+          line_height: 1.3
+        }
+      end
+    end
+  end
+end

data/lib/shellfie/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Shellfie
+  VERSION = "0.1.0"
+end

data/lib/shellfie.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "shellfie/version"
+require_relative "shellfie/errors"
+require_relative "shellfie/config"
+require_relative "shellfie/parser"
+require_relative "shellfie/ansi_parser"
+require_relative "shellfie/renderer"
+require_relative "shellfie/gif_generator"
+require_relative "shellfie/cli"
+
+module Shellfie
+end