thaum 0.1.0 → 0.2.0

data/lib/thaum/themes.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+module Thaum
+  Theme = Data.define(
+    :bg, :fg, :accent, :border, :dim,
+    :selection, :selection_fg, :pressed,
+    :input_bg, :bar_bg,
+    :success_fg, :warning_fg, :error_fg, :info_fg,
+    :muted_fg, :disabled_fg
+  ) do
+    # New semantic fields are optional to keep existing Theme.new callers
+    # working. Defaults are chosen to be safe and legible.
+    def initialize(
+      bg:, fg:, accent:, border:, dim:,
+      selection:, selection_fg:, pressed:,
+      input_bg:, bar_bg:,
+      success_fg: nil, warning_fg: nil, error_fg: nil, info_fg: nil,
+      muted_fg: nil, disabled_fg: nil
+    )
+      success_fg  ||= accent
+      warning_fg  ||= accent
+      error_fg    ||= accent
+      info_fg     ||= accent
+      muted_fg    ||= dim
+      disabled_fg ||= dim
+
+      super
+    end
+  end
+
+  module Themes
+    CATPPUCCIN_MOCHA = Theme.new(
+      bg:           "#1e1e2e",
+      fg:           "#cdd6f4",
+      accent:       "#89b4fa",
+      border:       "#45475a",
+      dim:          "#585b70",
+      selection:    "#313244",
+      selection_fg: "#cdd6f4",
+      pressed:      "#181825",
+      input_bg:     "#181825",
+      bar_bg:       "#11111b",
+      success_fg:   "#a6e3a1",
+      warning_fg:   "#f9e2af",
+      error_fg:     "#f38ba8",
+      info_fg:      "#89dceb",
+      muted_fg:     "#7f849c",
+      disabled_fg:  "#6c7086"
+    )
+
+    CATPPUCCIN_LATTE = Theme.new(
+      bg:           "#eff1f5",
+      fg:           "#4c4f69",
+      accent:       "#1e66f5",
+      border:       "#bcc0cc",
+      dim:          "#acb0be",
+      selection:    "#ccd0da",
+      selection_fg: "#4c4f69",
+      pressed:      "#dce0e8",
+      input_bg:     "#e6e9ef",
+      bar_bg:       "#dce0e8",
+      success_fg:   "#40a02b",
+      warning_fg:   "#df8e1d",
+      error_fg:     "#d20f39",
+      info_fg:      "#209fb5",
+      muted_fg:     "#8c8fa1",
+      disabled_fg:  "#9ca0b0"
+    )
+
+    GRUVBOX_DARK = Theme.new(
+      bg:           "#282828",
+      fg:           "#ebdbb2",
+      accent:       "#fabd2f",
+      border:       "#504945",
+      dim:          "#7c6f64",
+      selection:    "#3c3836",
+      selection_fg: "#ebdbb2",
+      pressed:      "#1d2021",
+      input_bg:     "#1d2021",
+      bar_bg:       "#1d2021",
+      success_fg:   "#b8bb26",
+      warning_fg:   "#fabd2f",
+      error_fg:     "#fb4934",
+      info_fg:      "#83a598",
+      muted_fg:     "#a89984",
+      disabled_fg:  "#7c6f64"
+    )
+
+    NORD = Theme.new(
+      bg:           "#2e3440",
+      fg:           "#d8dee9",
+      accent:       "#88c0d0",
+      border:       "#3b4252",
+      dim:          "#4c566a",
+      selection:    "#434c5e",
+      selection_fg: "#eceff4",
+      pressed:      "#242933",
+      input_bg:     "#3b4252",
+      bar_bg:       "#242933",
+      success_fg:   "#a3be8c",
+      warning_fg:   "#ebcb8b",
+      error_fg:     "#bf616a",
+      info_fg:      "#88c0d0",
+      muted_fg:     "#81a1c1",
+      disabled_fg:  "#616e88"
+    )
+
+    DRACULA = Theme.new(
+      bg:           "#282a36",
+      fg:           "#f8f8f2",
+      accent:       "#bd93f9",
+      border:       "#44475a",
+      dim:          "#6272a4",
+      selection:    "#44475a",
+      selection_fg: "#f8f8f2",
+      pressed:      "#21222c",
+      input_bg:     "#21222c",
+      bar_bg:       "#191a21",
+      success_fg:   "#50fa7b",
+      warning_fg:   "#f1fa8c",
+      error_fg:     "#ff5555",
+      info_fg:      "#8be9fd",
+      muted_fg:     "#6272a4",
+      disabled_fg:  "#6272a4"
+    )
+
+    SOLARIZED_DARK = Theme.new(
+      bg:           "#002b36",
+      fg:           "#839496",
+      accent:       "#268bd2",
+      border:       "#073642",
+      dim:          "#586e75",
+      selection:    "#073642",
+      selection_fg: "#93a1a1",
+      pressed:      "#001f27",
+      input_bg:     "#073642",
+      bar_bg:       "#001f27",
+      success_fg:   "#859900",
+      warning_fg:   "#b58900",
+      error_fg:     "#dc322f",
+      info_fg:      "#2aa198",
+      muted_fg:     "#657b83",
+      disabled_fg:  "#586e75"
+    )
+
+    SOLARIZED_LIGHT = Theme.new(
+      bg:           "#fdf6e3",
+      fg:           "#657b83",
+      accent:       "#268bd2",
+      border:       "#eee8d5",
+      dim:          "#93a1a1",
+      selection:    "#eee8d5",
+      selection_fg: "#586e75",
+      pressed:      "#ddd6c1",
+      input_bg:     "#eee8d5",
+      bar_bg:       "#ddd6c1",
+      success_fg:   "#859900",
+      warning_fg:   "#b58900",
+      error_fg:     "#dc322f",
+      info_fg:      "#2aa198",
+      muted_fg:     "#93a1a1",
+      disabled_fg:  "#93a1a1"
+    )
+
+    MATERIAL = Theme.new(
+      bg:           "#263238",
+      fg:           "#eeffff",
+      accent:       "#82aaff",
+      border:       "#314549",
+      dim:          "#546e7a",
+      selection:    "#314549",
+      selection_fg: "#eeffff",
+      pressed:      "#1e272c",
+      input_bg:     "#1e272c",
+      bar_bg:       "#1e272c",
+      success_fg:   "#c3e88d",
+      warning_fg:   "#ffcb6b",
+      error_fg:     "#f07178",
+      info_fg:      "#89ddff",
+      muted_fg:     "#78909c",
+      disabled_fg:  "#607d8b"
+    )
+
+    BY_NAME = {
+      catppuccin_mocha: CATPPUCCIN_MOCHA,
+      catppuccin_latte: CATPPUCCIN_LATTE,
+      gruvbox_dark:     GRUVBOX_DARK,
+      nord:             NORD,
+      dracula:          DRACULA,
+      solarized_dark:   SOLARIZED_DARK,
+      solarized_light:  SOLARIZED_LIGHT,
+      material:         MATERIAL
+    }.freeze
+
+    REQUIRED_KEYS = Theme.members.freeze
+
+    CONTRAST_RULES = [
+      [:fg, :bg, 4.0],
+      [:selection_fg, :selection, 4.3],
+      [:accent, :bg, 2.5],
+      [:muted_fg, :bg, 2.0],
+      [:disabled_fg, :bg, 1.5]
+    ].freeze
+
+    DEFAULT = CATPPUCCIN_MOCHA
+
+    def self.validate_all!
+      BY_NAME.each { |name, theme| validate_theme!(name: name, theme: theme) }
+      true
+    end
+
+    def self.[](name)
+      BY_NAME.fetch(name) do
+        raise ArgumentError, "unknown theme #{name.inspect} (known: #{BY_NAME.keys.join(", ")})"
+      end
+    end
+
+    def self.names = BY_NAME.keys
+
+    def self.validate_theme!(name:, theme:)
+      missing = REQUIRED_KEYS.select { |key| theme.public_send(key).nil? }
+      raise ArgumentError, "theme #{name} is missing keys: #{missing.join(', ')}" unless missing.empty?
+
+      CONTRAST_RULES.each do |fg_key, bg_key, min|
+        fg = theme.public_send(fg_key)
+        bg = theme.public_send(bg_key)
+        next unless hex_color?(fg) && hex_color?(bg)
+
+        ratio = contrast_ratio(hex_a: fg, hex_b: bg)
+        next if ratio >= min
+
+        raise ArgumentError,
+              format("theme %s contrast too low for %s/%s: %.2f < %.1f", name, fg_key, bg_key, ratio, min)
+      end
+
+      true
+    end
+
+    def self.hex_color?(value)
+      value.is_a?(String) && /\A#[0-9a-fA-F]{6}\z/.match?(value)
+    end
+
+    def self.contrast_ratio(hex_a:, hex_b:)
+      l1 = relative_luminance(hex_a)
+      l2 = relative_luminance(hex_b)
+      hi = [l1, l2].max
+      lo = [l1, l2].min
+      (hi + 0.05) / (lo + 0.05)
+    end
+
+    def self.relative_luminance(hex)
+      r = hex[1, 2].to_i(16) / 255.0
+      g = hex[3, 2].to_i(16) / 255.0
+      b = hex[5, 2].to_i(16) / 255.0
+
+      # WCAG sRGB transform
+      rs = r <= 0.03928 ? (r / 12.92) : (((r + 0.055) / 1.055)**2.4)
+      gs = g <= 0.03928 ? (g / 12.92) : (((g + 0.055) / 1.055)**2.4)
+      bs = b <= 0.03928 ? (b / 12.92) : (((b + 0.055) / 1.055)**2.4)
+      (0.2126 * rs) + (0.7152 * gs) + (0.0722 * bs)
+    end
+
+    private_class_method :validate_theme!, :hex_color?, :contrast_ratio, :relative_luminance
+
+    validate_all!
+  end
+end

data/lib/thaum/tree.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Thaum
+  # Recursive walk over a Layout subtree. Yields every direct or transitive
+  # child of `node`, in declaration order. Callers filter by class.
+  module Tree
+    module_function
+
+    def walk(node, &block)
+      (node.subtree_children || []).each do |child|
+        block.call(child)
+        walk(child, &block) if child.respond_to?(:subtree_children)
+      end
+    end
+  end
+end

data/lib/thaum/version.rb

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

data/lib/thaum.rb

@@ -1,8 +1,71 @@
 # frozen_string_literal: true
 
+require "concurrent"
+require "unicode/display_width/string_ext"
+
 require_relative "thaum/version"
+require_relative "thaum/rendering/style"
+require_relative "thaum/rendering/cell"
+require_relative "thaum/rect"
+require_relative "thaum/rendering/box_drawing"
+require_relative "thaum/rendering/buffer"
+require_relative "thaum/rendering/canvas"
+require_relative "thaum/seq"
+require_relative "thaum/color"
+require_relative "thaum/terminal"
+require_relative "thaum/event"
+require_relative "thaum/key_event"
+require_relative "thaum/events"
+require_relative "thaum/keys"
+require_relative "thaum/escape_parser"
+require_relative "thaum/input_reader"
+require_relative "thaum/rendering/renderer"
+require_relative "thaum/themes"
+require_relative "thaum/sigil"
+require_relative "thaum/concerns/layout"
+require_relative "thaum/octagram"
+require_relative "thaum/concerns/focus"
+require_relative "thaum/concerns/context_update"
+require_relative "thaum/concerns/modal"
+require_relative "thaum/concerns/tab_navigation"
+require_relative "thaum/app"
+require_relative "thaum/action"
+require_relative "thaum/tree"
+require_relative "thaum/hit_test"
+require_relative "thaum/painter"
+require_relative "thaum/dispatch"
+require_relative "thaum/run_loop"
+require_relative "thaum/sigils/text"
+require_relative "thaum/sigils/text_input"
+require_relative "thaum/sigils/select"
+require_relative "thaum/sigils/button"
+require_relative "thaum/sigils/scroll_view"
+require_relative "thaum/sigils/table"
+require_relative "thaum/sigils/spinner"
+require_relative "thaum/sigils/progress_bar"
+require_relative "thaum/sigils/checkbox"
+require_relative "thaum/sigils/status_bar"
+require_relative "thaum/sigils/tabs"
 
 module Thaum
   class Error < StandardError; end
-  # Your code goes here...
+  class LayoutError < Error; end
+  class EmitFromUpdateError < Error; end
+  class FocusOrderError < Error; end
+
+  # Invoke a handler, rescuing any exception so a bug in user code can't
+  # leave the terminal in raw mode + alt screen. Logs class, message, and
+  # backtrace to stderr.
+  def self.safe_invoke(label)
+    yield
+  rescue StandardError => e
+    warn "[Thaum] unhandled exception in #{label}: #{e.class}: #{e.message}"
+    warn e.backtrace.join("\n") if e.backtrace
+    nil
+  end
+
+  # Startup entry point. Blocks until app.quit is called. Returns nil.
+  def self.run(app, tick: 0.1, threads: 4)
+    RunLoop.run(app:, tick:, threads:)
+  end
 end

metadata

@@ -1,15 +1,62 @@
 --- !ruby/object:Gem::Specification
 name: thaum
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Tad Thorley
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: coming soon
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: |
+  Build full-screen terminal apps in Ruby. Thaum provides a declarative
+  layout DSL, composable sigils (widgets) and octagrams (composite
+  components), a diff-based renderer with truecolor support, event
+  dispatch with ticks and background actions, focus management, themes,
+  and snapshot testing.
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -17,7 +64,69 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/checkbox.rb
+- examples/counter.rb
+- examples/hello_world.rb
+- examples/layout_demo.rb
+- examples/modal.rb
+- examples/mouse.rb
+- examples/octagram_picker.rb
+- examples/picker.rb
+- examples/progress_bar.rb
+- examples/scroll_view.rb
+- examples/select.rb
+- examples/spinner.rb
+- examples/status_bar.rb
+- examples/stopwatch.rb
+- examples/table.rb
+- examples/tabs.rb
+- examples/text.rb
+- examples/theme_picker.rb
+- examples/todo.rb
 - lib/thaum.rb
+- lib/thaum/action.rb
+- lib/thaum/app.rb
+- lib/thaum/color.rb
+- lib/thaum/concerns/context_update.rb
+- lib/thaum/concerns/focus.rb
+- lib/thaum/concerns/layout.rb
+- lib/thaum/concerns/modal.rb
+- lib/thaum/concerns/tab_navigation.rb
+- lib/thaum/dispatch.rb
+- lib/thaum/escape_parser.rb
+- lib/thaum/event.rb
+- lib/thaum/events.rb
+- lib/thaum/hit_test.rb
+- lib/thaum/input_reader.rb
+- lib/thaum/key_event.rb
+- lib/thaum/keys.rb
+- lib/thaum/minitest.rb
+- lib/thaum/octagram.rb
+- lib/thaum/painter.rb
+- lib/thaum/rect.rb
+- lib/thaum/rendering/box_drawing.rb
+- lib/thaum/rendering/buffer.rb
+- lib/thaum/rendering/canvas.rb
+- lib/thaum/rendering/cell.rb
+- lib/thaum/rendering/renderer.rb
+- lib/thaum/rendering/style.rb
+- lib/thaum/run_loop.rb
+- lib/thaum/seq.rb
+- lib/thaum/sigil.rb
+- lib/thaum/sigils/button.rb
+- lib/thaum/sigils/checkbox.rb
+- lib/thaum/sigils/progress_bar.rb
+- lib/thaum/sigils/scroll_view.rb
+- lib/thaum/sigils/select.rb
+- lib/thaum/sigils/spinner.rb
+- lib/thaum/sigils/status_bar.rb
+- lib/thaum/sigils/table.rb
+- lib/thaum/sigils/tabs.rb
+- lib/thaum/sigils/text.rb
+- lib/thaum/sigils/text_input.rb
+- lib/thaum/terminal.rb
+- lib/thaum/themes.rb
+- lib/thaum/tree.rb
 - lib/thaum/version.rb
 - sig/thaum.rbs
 homepage: https://github.com/urug/thaum
@@ -26,6 +135,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/urug/thaum
   source_code_uri: https://github.com/urug/thaum
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -42,5 +152,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.3
 specification_version: 4
-summary: A Ruby TUI framework
+summary: A declarative TUI framework for Ruby
 test_files: []