shellfie 0.1.1 → 1.0.0

data/lib/shellfie/rendering/window_chrome.rb

@@ -0,0 +1,196 @@
+# frozen_string_literal: true
+
+require_relative "shape_helpers"
+require_relative "../image_magick_command_builder"
+require_relative "../text_metrics"
+
+module Shellfie
+  module Rendering
+    module WindowChrome
+      include ShapeHelpers
+
+      def draw_shadow(convert, geometry)
+        shadow = theme.window_decoration[:shadow]
+        scale = geometry[:scale]
+        offset_x = (shadow[:offset_x] * scale).to_i
+        offset_y = (shadow[:offset_y] * scale).to_i
+        radius = geometry[:scaled_radius]
+        margin = geometry[:margin]
+
+        convert.fill shadow[:color]
+        draw_roundrect(
+          convert,
+          margin + offset_x,
+          margin + offset_y,
+          margin + geometry[:scaled_width] - 1 + offset_x,
+          margin + geometry[:scaled_height] - 1 + offset_y,
+          radius
+        )
+        convert.blur "0x#{(shadow[:blur] * scale).to_i}"
+      end
+
+      def draw_window(convert, geometry, transparent:)
+        margin = geometry[:margin]
+        background = color_with_opacity(theme.colors[:background], config.window[:opacity], true)
+
+        convert.fill background
+        draw_roundrect(
+          convert,
+          margin,
+          margin,
+          margin + geometry[:scaled_width] - 1,
+          margin + geometry[:scaled_height] - 1,
+          geometry[:scaled_radius]
+        )
+
+        draw_border(convert, geometry)
+      end
+
+      def draw_title_bar(convert, geometry)
+        margin = geometry[:margin]
+        title_y2 = margin + geometry[:scaled_title_bar] - 1
+
+        convert.fill theme.colors[:title_bar]
+        draw_roundrect(
+          convert,
+          margin,
+          margin,
+          margin + geometry[:scaled_width] - 1,
+          title_y2,
+          geometry[:scaled_radius]
+        )
+        convert.fill theme.colors[:title_bar]
+        ImageMagickCommandBuilder.rectangle(
+          convert,
+          margin,
+          margin + geometry[:scaled_radius],
+          margin + geometry[:scaled_width] - 1,
+          title_y2
+        )
+
+        draw_title_separator(convert, geometry, title_y2)
+        draw_buttons(convert, geometry)
+        draw_title(convert, geometry)
+      end
+
+      def draw_title_separator(convert, geometry, y)
+        color = theme.colors[:title_bar_border]
+        return unless color
+
+        convert.stroke color
+        convert.strokewidth 1
+        ImageMagickCommandBuilder.line(convert, geometry[:margin], y, geometry[:margin] + geometry[:scaled_width] - 1, y)
+        convert.stroke "none"
+      end
+
+      def draw_border(convert, geometry)
+        color = theme.colors[:border]
+        return unless color
+
+        convert.fill "none"
+        convert.stroke color
+        convert.strokewidth [geometry[:scale].to_i, 1].max
+        draw_roundrect(
+          convert,
+          geometry[:margin],
+          geometry[:margin],
+          geometry[:margin] + geometry[:scaled_width] - 1,
+          geometry[:margin] + geometry[:scaled_height] - 1,
+          geometry[:scaled_radius]
+        )
+        convert.stroke "none"
+      end
+
+      def draw_buttons(convert, geometry)
+        return draw_windows_buttons(convert, geometry) if theme.button_style == :icons
+
+        button_radius = ((theme.window_decoration[:button_size] / 2.0) * geometry[:scale]).to_i
+        centers = circle_button_centers(geometry)
+
+        centers.each_with_index do |(x, y), index|
+          convert.fill theme.button_colors[index]
+          convert.stroke "rgba(0,0,0,0.18)"
+          convert.strokewidth [geometry[:scale].to_i, 1].max
+          ImageMagickCommandBuilder.circle(convert, x, y, button_radius)
+        end
+        convert.stroke "none"
+      end
+
+      def circle_button_centers(geometry)
+        scale = geometry[:scale]
+        size = (theme.window_decoration[:button_size] * scale).to_i
+        spacing = ((theme.window_decoration[:button_spacing] + theme.window_decoration[:button_size]) * scale).to_i
+        y = geometry[:margin] + geometry[:scaled_title_bar] / 2
+
+        start_x = if theme.buttons_position == :left
+                    geometry[:margin] + (16 * scale).to_i
+                  else
+                    group_width = size * 3 + (theme.window_decoration[:button_spacing] * scale).to_i * 2
+                    geometry[:margin] + geometry[:scaled_width] - (16 * scale).to_i - group_width + size / 2
+                  end
+
+        3.times.map { |index| [start_x + index * spacing, y] }
+      end
+
+      def draw_windows_buttons(convert, geometry)
+        scale = geometry[:scale]
+        button_width = ((theme.window_decoration[:button_width] || 46) * scale).to_i
+        icon_size = (10 * scale).to_i
+        start_x = geometry[:margin] + geometry[:scaled_width] - button_width * 3
+        center_y = geometry[:margin] + geometry[:scaled_title_bar] / 2
+        color = theme.colors[:title_text]
+
+        convert.stroke color
+        convert.strokewidth [scale.to_i, 1].max
+        convert.fill "none"
+
+        3.times do |index|
+          center_x = start_x + button_width * index + button_width / 2
+          draw_windows_icon(convert, index, center_x, center_y, icon_size)
+        end
+
+        convert.stroke "none"
+      end
+
+      def draw_title(convert, geometry)
+        scaled_font_size = geometry[:scaled_font_size]
+        group_width = button_group_width(geometry)
+        reserve_left = theme.buttons_position == :left ? group_width + (32 * geometry[:scale]).to_i : (12 * geometry[:scale]).to_i
+        reserve_right = theme.buttons_position == :right ? group_width + (12 * geometry[:scale]).to_i : (12 * geometry[:scale]).to_i
+        available_width = geometry[:scaled_width] - reserve_left - reserve_right
+        title = fit_text(config.title.to_s, available_width, scaled_font_size)
+        title_width = TextMetrics.pixel_width(title, scaled_font_size)
+        min_x = geometry[:margin] + reserve_left
+        max_x = geometry[:margin] + geometry[:scaled_width] - reserve_right - title_width
+        centered_x = geometry[:margin] + (geometry[:scaled_width] - title_width) / 2
+        x = title_x(min_x, max_x, centered_x)
+        y = geometry[:margin] + geometry[:scaled_title_bar] / 2 + scaled_font_size / 3
+
+        draw_text(convert, title, x, y - scaled_font_size, theme.colors[:title_text], scaled_font_size, geometry[:font_config])
+      end
+
+      def title_x(min_x, max_x, centered_x)
+        case theme.title_alignment
+        when :left
+          min_x
+        when :right
+          max_x
+        else
+          [[centered_x, min_x].max, max_x].min
+        end
+      end
+
+      def button_group_width(geometry)
+        scale = geometry[:scale]
+        if theme.button_style == :icons
+          ((theme.window_decoration[:button_width] || 46) * 3 * scale).to_i
+        else
+          size = theme.window_decoration[:button_size]
+          spacing = theme.window_decoration[:button_spacing]
+          ((size * 3 + spacing * 2) * scale).to_i
+        end
+      end
+
+    end
+  end
+end

data/lib/shellfie/svg_raster_wrapper.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "tempfile"
+require "mini_magick"
+
+module Shellfie
+  class SvgRasterWrapper
+    class << self
+      def write(output_path)
+        temp = Tempfile.new(["shellfie-svg", ".png"], binmode: true)
+        temp.close
+        yield temp.path
+        image = MiniMagick::Image.open(temp.path)
+        File.binwrite(output_path, svg_document(image.width, image.height, File.binread(temp.path)))
+      ensure
+        if temp
+          temp.close unless temp.closed?
+          File.delete(temp.path) if File.exist?(temp.path)
+        end
+      end
+
+      private
+
+      def svg_document(width, height, png_data)
+        encoded = [png_data].pack("m0")
+        <<~SVG
+          <?xml version="1.0" encoding="UTF-8"?>
+          <svg xmlns="http://www.w3.org/2000/svg" width="#{width}" height="#{height}" viewBox="0 0 #{width} #{height}">
+            <image width="#{width}" height="#{height}" href="data:image/png;base64,#{encoded}"/>
+          </svg>
+        SVG
+      end
+    end
+  end
+end

data/lib/shellfie/text_metrics.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Shellfie
+  module TextMetrics
+    module_function
+
+    def cell_width(text)
+      text.to_s.each_char.sum { |char| char_width(char) }
+    end
+
+    def pixel_width(text, font_size)
+      (cell_width(text) * font_size * 0.6).ceil
+    end
+
+    def take_cells(text, max_cells)
+      result = +""
+      used_cells = 0
+
+      text.to_s.each_char do |char|
+        width = char_width(char)
+        break if used_cells + width > max_cells
+
+        result << char
+        used_cells += width
+      end
+
+      result
+    end
+
+    def drop_cells(text, cells_to_drop)
+      used_cells = 0
+      text.to_s.each_char.with_object(+"") do |char, result|
+        width = char_width(char)
+        if used_cells < cells_to_drop
+          used_cells += width
+          next
+        end
+
+        result << char
+      end
+    end
+
+    def split_cells(text, max_cells)
+      return [text.to_s] if max_cells <= 0
+
+      chunks = []
+      current = +""
+      used_cells = 0
+
+      text.to_s.each_char do |char|
+        width = char_width(char)
+        if used_cells.positive? && used_cells + width > max_cells
+          chunks << current
+          current = +""
+          used_cells = 0
+        end
+
+        current << char
+        used_cells += width
+      end
+
+      chunks << current unless current.empty?
+      chunks
+    end
+
+    def char_width(char)
+      codepoint = char.ord
+      return 0 if combining?(codepoint)
+      return 0 if codepoint < 32 || codepoint == 0x7f
+      return 2 if wide?(codepoint)
+
+      1
+    end
+
+    def combining?(codepoint)
+      (0x0300..0x036f).cover?(codepoint) ||
+        (0x1ab0..0x1aff).cover?(codepoint) ||
+        (0x1dc0..0x1dff).cover?(codepoint) ||
+        (0x20d0..0x20ff).cover?(codepoint) ||
+        (0xfe20..0xfe2f).cover?(codepoint)
+    end
+
+    def wide?(codepoint)
+      (0x1100..0x115f).cover?(codepoint) ||
+        (0x2329..0x232a).cover?(codepoint) ||
+        (0x2e80..0xa4cf).cover?(codepoint) ||
+        (0xac00..0xd7a3).cover?(codepoint) ||
+        (0xf900..0xfaff).cover?(codepoint) ||
+        (0xfe10..0xfe19).cover?(codepoint) ||
+        (0xfe30..0xfe6f).cover?(codepoint) ||
+        (0xff00..0xff60).cover?(codepoint) ||
+        (0xffe0..0xffe6).cover?(codepoint) ||
+        (0x1f300..0x1faff).cover?(codepoint)
+    end
+  end
+end

data/lib/shellfie/theme_data.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Shellfie
+  class ThemeData
+    attr_reader :name, :colors, :window_decoration, :button_colors, :buttons_position, :button_style, :font,
+                :title_alignment
+
+    def self.from_theme(theme, name:, colors: {}, window_decoration: {}, font: {}, headless: false)
+      data = new(
+        name: name,
+        colors: theme.colors.merge(colors || {}),
+        window_decoration: deep_merge(theme.window_decoration, window_decoration || {}),
+        button_colors: theme.button_colors,
+        buttons_position: theme.buttons_position,
+        button_style: theme.button_style,
+        font: theme.font.merge(font || {}),
+        title_alignment: theme.title_alignment
+      )
+      headless ? data.headless : data
+    end
+
+    def self.deep_merge(base, overrides)
+      base.merge(overrides) do |_key, left, right|
+        left.is_a?(Hash) && right.is_a?(Hash) ? deep_merge(left, right) : right
+      end
+    end
+
+    def initialize(name:, colors:, window_decoration:, button_colors:, buttons_position:, button_style:, font:,
+                   title_alignment:)
+      @name = name
+      @colors = deep_freeze_copy(colors)
+      @window_decoration = deep_freeze_copy(window_decoration)
+      @button_colors = deep_freeze_copy(button_colors)
+      @buttons_position = buttons_position
+      @button_style = button_style
+      @font = deep_freeze_copy(font)
+      @title_alignment = title_alignment
+      freeze
+    end
+
+    def color_for(name)
+      return name if name.is_a?(String) && name.start_with?("#")
+
+      colors[name.to_sym] || colors[:foreground]
+    end
+
+    def headless
+      self.class.new(
+        name: name,
+        colors: colors,
+        window_decoration: self.class.deep_merge(
+          window_decoration,
+          title_bar_height: 0,
+          corner_radius: 0,
+          button_size: 0,
+          button_spacing: 0
+        ),
+        button_colors: [],
+        buttons_position: :left,
+        button_style: :none,
+        font: font,
+        title_alignment: :left
+      )
+    end
+
+    private
+
+    def deep_freeze_copy(value)
+      copy = case value
+             when Hash
+               value.each_with_object({}) { |(key, nested), result| result[key] = deep_freeze_copy(nested) }
+             when Array
+               value.map { |nested| deep_freeze_copy(nested) }
+             else
+               value
+             end
+      copy.freeze
+    end
+  end
+end

data/lib/shellfie/theme_registry.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require_relative "themes/base"
+require_relative "themes/configured"
+require_relative "themes/macos"
+require_relative "themes/ubuntu"
+require_relative "themes/windows_terminal"
+require_relative "headless_theme_registry"
+require_relative "theme_data"
+
+module Shellfie
+  class ThemeRegistry
+    WINDOW_THEMES = {
+      "macos" => Themes::MacOS,
+      "ubuntu" => Themes::Ubuntu,
+      "windows" => Themes::WindowsTerminal
+    }.freeze
+
+    COLOR_SCHEMES = {
+      "dracula" => {
+        background: "#282a36",
+        foreground: "#f8f8f2",
+        black: "#21222c",
+        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"
+      },
+      "one_dark" => {
+        background: "#282c34",
+        foreground: "#abb2bf",
+        red: "#e06c75",
+        green: "#98c379",
+        yellow: "#e5c07b",
+        blue: "#61afef",
+        magenta: "#c678dd",
+        cyan: "#56b6c2",
+        white: "#abb2bf"
+      },
+      "solarized_dark" => {
+        background: "#002b36",
+        foreground: "#839496",
+        red: "#dc322f",
+        green: "#859900",
+        yellow: "#b58900",
+        blue: "#268bd2",
+        magenta: "#d33682",
+        cyan: "#2aa198",
+        white: "#eee8d5"
+      },
+      "catppuccin_mocha" => {
+        background: "#1e1e2e",
+        foreground: "#cdd6f4",
+        red: "#f38ba8",
+        green: "#a6e3a1",
+        yellow: "#f9e2af",
+        blue: "#89b4fa",
+        magenta: "#cba6f7",
+        cyan: "#94e2d5",
+        white: "#bac2de"
+      }
+    }.freeze
+
+    class << self
+      def build(config)
+        base_name = config.theme == "custom" ? (config.window_theme || "macos") : (config.window_theme || config.theme)
+        base_theme = fetch_window_theme(base_name).new
+        colors = color_scheme(config.color_scheme).merge(config.colors)
+
+        theme = Themes::Configured.new(
+          base_theme,
+          name: config.theme,
+          colors: colors,
+          window_decoration: config.window_decoration,
+          font: font_overrides(config)
+        )
+        theme_data = ThemeData.from_theme(theme, name: config.theme)
+        config.headless ? HeadlessThemeRegistry.build(theme_data) : theme_data
+      end
+
+      def valid_theme?(name)
+        name == "custom" || WINDOW_THEMES.key?(name)
+      end
+
+      def valid_window_theme?(name)
+        WINDOW_THEMES.key?(name)
+      end
+
+      def valid_color_scheme?(name)
+        name.nil? || COLOR_SCHEMES.key?(name)
+      end
+
+      def available_themes
+        (WINDOW_THEMES.keys + ["custom"]).sort
+      end
+
+      def available_color_schemes
+        COLOR_SCHEMES.keys.sort
+      end
+
+      private
+
+      def fetch_window_theme(name)
+        WINDOW_THEMES.fetch(name) do
+          raise ValidationError, "Invalid theme '#{name}'\n  → Available themes: #{available_themes.join(", ")}"
+        end
+      end
+
+      def color_scheme(name)
+        return {} unless name
+
+        COLOR_SCHEMES.fetch(name)
+      end
+
+      def font_overrides(config)
+        config.font == Config::DEFAULTS[:font] ? {} : config.font
+      end
+    end
+  end
+end

data/lib/shellfie/themes/base.rb

@@ -23,6 +23,9 @@ module Shellfie
           foreground: "#ffffff",
           title_bar: "#3c3c3c",
           title_text: "#ffffff",
+          title_bar_border: "rgba(255,255,255,0.08)",
+          border: "rgba(255,255,255,0.10)",
+          selection: "rgba(80,140,255,0.28)",
           black: "#000000",
           red: "#ff5555",
           green: "#50fa7b",
@@ -54,11 +57,17 @@ module Shellfie
         :left
       end
 
+      def title_alignment
+        :center
+      end
+
       def font
         {
           family: "Monaco",
           size: 14,
-          line_height: 1.4
+          line_height: 1.4,
+          fallback_family: "Menlo",
+          emoji_family: "Apple Color Emoji"
         }
       end
 

data/lib/shellfie/themes/configured.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Shellfie
+  module Themes
+    class Configured
+      def initialize(base_theme, name:, colors: {}, window_decoration: {}, font: {})
+        @base_theme = base_theme
+        @name = name
+        @colors = colors || {}
+        @window_decoration = window_decoration || {}
+        @font = font || {}
+      end
+
+      def name
+        @name
+      end
+
+      def window_decoration
+        deep_merge(@base_theme.window_decoration, @window_decoration)
+      end
+
+      def colors
+        @base_theme.colors.merge(@colors)
+      end
+
+      def font
+        @base_theme.font.merge(@font)
+      end
+
+      def button_colors
+        @base_theme.button_colors
+      end
+
+      def button_style
+        @base_theme.button_style
+      end
+
+      def buttons_position
+        @base_theme.buttons_position
+      end
+
+      def title_alignment
+        @base_theme.title_alignment
+      end
+
+      def color_for(name)
+        return name if name.is_a?(String) && name.start_with?("#")
+
+        colors[name.to_sym] || colors[:foreground]
+      end
+
+      private
+
+      def deep_merge(base, overrides)
+        base.merge(overrides) do |_key, left, right|
+          left.is_a?(Hash) && right.is_a?(Hash) ? deep_merge(left, right) : right
+        end
+      end
+    end
+  end
+end

data/lib/shellfie/themes/macos.rb

@@ -43,7 +43,9 @@ module Shellfie
         {
           family: "SF Mono",
           size: 14,
-          line_height: 1.4
+          line_height: 1.4,
+          fallback_family: "Menlo",
+          emoji_family: "Apple Color Emoji"
         }
       end
     end

data/lib/shellfie/themes/ubuntu.rb

@@ -49,7 +49,8 @@ module Shellfie
         {
           family: "Ubuntu Mono",
           size: 14,
-          line_height: 1.4
+          line_height: 1.4,
+          fallback_family: "DejaVu Sans Mono"
         }
       end
     end

data/lib/shellfie/themes/windows_terminal.rb

@@ -13,6 +13,7 @@ module Shellfie
         {
           title_bar_height: 32,
           button_size: 10,
+          button_width: 46,
           button_spacing: 0,
           corner_radius: 0,
           shadow: { blur: 15, offset_x: 0, offset_y: 5, color: "rgba(0,0,0,0.25)" }
@@ -52,11 +53,16 @@ module Shellfie
         :right
       end
 
+      def title_alignment
+        :left
+      end
+
       def font
         {
           family: "Cascadia Mono",
           size: 14,
-          line_height: 1.3
+          line_height: 1.3,
+          fallback_family: "Consolas"
         }
       end
     end

data/lib/shellfie/version.rb

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