fatty 0.99.0

data/lib/fatty/colors/pairs.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Fatty
+  module Colors
+    # Stable Curses color-pair IDs. These are intentionally constant so the
+    # renderer can refer to them without dynamic allocation.
+    #
+    # Pair 0 is reserved in ncurses; start at 1.
+    module Pairs
+      OUTPUT           = 1
+      INPUT            = 2
+      INPUT_SUGGESTION = 3
+      CURSOR           = 4
+      REGION           = 5
+
+      STATUS_INFO      = 6
+      STATUS_WARN      = 7
+      STATUS_ERROR     = 8
+      STATUS_GOOD      = 9
+      STATUS           = 10
+
+      ALERT_INFO  = 11
+      ALERT_WARN  = 12
+      ALERT_ERROR = 13
+      ALERT_GOOD  = 14
+      ALERT = 15
+
+      SEARCH = 20
+      SEARCH_HIGHLIGHT = 21
+      SEARCH_HIGHLIGHT_SECONDARY = 22
+      PAGER_STATUS = 23
+
+      POPUP           = 30
+      POPUP_SELECTION = 31
+      POPUP_INPUT     = 32
+      POPUP_FRAME     = 33
+      POPUP_COUNTS    = 34
+
+      # Role -> pair id mapping for iteration.
+      ROLE_TO_PAIR = {
+        output: OUTPUT,
+        input: INPUT,
+        input_suggestion: INPUT_SUGGESTION,
+        cursor: CURSOR,
+        region: REGION,
+
+        good: STATUS_GOOD,
+        info: STATUS_INFO,
+        warn: STATUS_WARN,
+        error: STATUS_ERROR,
+        status: STATUS,
+
+        alert_info: ALERT_INFO,
+        alert_warn: ALERT_WARN,
+        alert_error: ALERT_ERROR,
+        alert_good: ALERT_GOOD,
+        alert: ALERT,
+
+        match_current: SEARCH_HIGHLIGHT,
+        match_other: SEARCH_HIGHLIGHT_SECONDARY,
+        search_input: SEARCH,
+
+        pager_status: PAGER_STATUS,
+
+        popup: POPUP,
+        popup_selection: POPUP_SELECTION,
+        popup_input: POPUP_INPUT,
+        popup_frame: POPUP_FRAME,
+        popup_counts: POPUP_COUNTS,
+      }.freeze
+    end
+  end
+end

data/lib/fatty/colors/palette.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Fatty
+  module Colors
+    # Palette compiles a resolved symbolic theme_spec into a renderer-ready
+    # palette.
+    #
+    # A theme_spec is produced by Fatty::Themes::Resolver. It maps role names
+    # to symbolic color specifications, usually color names and attributes:
+    #
+    # #+begin_src ruby
+    #   {
+    #     output: { fg: "white", bg: "navy" },
+    #     alert_warn: { fg: "yellow", bg: "pink", attrs: [:bold] },
+    #   }
+    # #+end_src
+    #
+    # A palette maps those same role names to concrete rendering data:
+    #
+    # #+begin_src ruby
+    #   {
+    #     output: {
+    #       fg: 7,
+    #       bg: 4,
+    #       fg_rgb: [255, 255, 255],
+    #       bg_rgb: [0, 0, 128],
+    #       pair: 1,
+    #       attrs: [],
+    #     },
+    #   }
+    # #+end_src
+    #
+    # Curses renderers use :pair and :attrs. Truecolor renderers use
+    # :fg_rgb, :bg_rgb, and :attrs.
+    #
+    # - .build :: returns the compiled palette without touching curses.
+    # - .apply! :: also initializes curses color pairs.
+    #
+    module Palette
+      DEFAULT_ROLE = { fg: "default", bg: "default" }.freeze
+
+      # Compile a theme_spec into a renderer-ready palette without initializing
+      # curses color pairs.
+      def self.compile(theme_spec, available_colors:)
+        palette = {}
+        roles = (theme_spec.keys + Pairs::ROLE_TO_PAIR.keys).compact.uniq
+
+        roles.each do |role|
+          role_spec = theme_spec.fetch(role, DEFAULT_ROLE)
+
+          fg_spec = role_spec[:fg] || DEFAULT_ROLE[:fg]
+          bg_spec = role_spec[:bg] || DEFAULT_ROLE[:bg]
+
+          fg = Fatty::Color.resolve(fg_spec, available_colors: available_colors)
+          bg = Fatty::Color.resolve(bg_spec, available_colors: available_colors)
+          attrs = Array(role_spec[:attrs] || role_spec["attrs"]).map(&:to_sym)
+          fg_rgb = Fatty::Color.rgb(fg_spec)
+          bg_rgb = Fatty::Color.rgb(bg_spec)
+
+          palette[role] = {
+            fg: fg,
+            bg: bg,
+            fg_rgb: fg_rgb,
+            bg_rgb: bg_rgb,
+            pair: Pairs::ROLE_TO_PAIR[role],
+            attrs: attrs,
+          }
+        end
+        palette
+      end
+    end
+  end
+end