igniter 0.5.0 → 0.5.1

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/datetime.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "time"
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Datetime < Arbre::Component
+          builder_method :datetime
+
+          DEFAULT_FORMAT = "%Y-%m-%d %H:%M UTC"
+
+          def build(value, *args)
+            options = extract_options!(args)
+            format = options.delete(:format) || DEFAULT_FORMAT
+            class_name = options.delete(:class_name)
+            time = coerce_time(value)
+
+            super(options.merge(class: merge_classes("font-mono text-xs leading-6 text-stone-300", class_name), datetime: time&.iso8601))
+            text_node(time ? time.utc.strftime(format) : value.to_s)
+          end
+
+          private
+
+          def coerce_time(value)
+            return value.utc if value.is_a?(Time)
+            return value.to_time.utc if value.respond_to?(:to_time)
+            return Time.parse(value.to_s).utc unless value.nil? || value.to_s.empty?
+          rescue StandardError
+            nil
+          end
+
+          def tag_name
+            "time"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/display_value_support.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        module DisplayValueSupport
+          private
+
+          def render_semantic_scalar(view, value, as:, theme:, badge_options: nil)
+            case as
+            when :badge
+              view.badge(value, **(badge_options || {}))
+            when :code
+              view.code(value.to_s, class: theme.code_class)
+            when :boolean
+              view.boolean(value)
+            when :datetime
+              view.datetime(value)
+            when :indicator
+              view.indicator(value)
+            when :number
+              view.number(value)
+            when :percentage
+              view.percentage(value)
+            else
+              view.text_node(display_text(value))
+            end
+          end
+
+          def display_text(value)
+            value.is_a?(Symbol) ? humanize_label(value) : value.to_s
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/empty_state.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class EmptyState < Arbre::Component
+          builder_method :empty_state
+
+          def build(*args)
+            options = extract_options!(args)
+            title = args.shift || options.delete(:title) || "Nothing here yet"
+            message = options.delete(:message)
+            action_label = options.delete(:action_label)
+            action_href = options.delete(:action_href)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("rounded-[28px] border border-dashed border-white/10 bg-white/[0.03] px-5 py-6 text-center", class_name)))
+            div(title, class: "text-sm font-semibold uppercase tracking-[0.18em] text-stone-300")
+            div(message, class: "mt-2 text-sm leading-6 text-stone-400") if message
+            if action_label && action_href
+              a(
+                action_label,
+                href: action_href,
+                class: Igniter::Frontend::Tailwind::UI::Tokens.underline_link(theme: :orange, extra: "mt-4 inline-flex text-sm")
+              )
+            end
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/event_list.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class EventList < Arbre::Component
+          builder_method :event_list
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("feed event-list", class_name)))
+            render_build_block(block)
+          end
+
+          def event(title = nil, meta: nil, detail: nil, class_name: nil, &block)
+            div(class: merge_classes("feed-item", class_name)) do |item|
+              item.strong(title) if title
+              if meta
+                item.br if title
+                item.span(meta, class: "caption")
+              end
+              if detail
+                item.br if title || meta
+                item.text_node(detail)
+              end
+              item.instance_exec(&block) if block
+            end
+          end
+
+          private
+
+          def tag_name
+            "div"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/filters.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Filters < Arbre::Component
+          builder_method :filters
+
+          Field = ::Data.define(:kind, :name, :label, :placeholder, :value, :options, :include_blank, :input_id)
+          Action = ::Data.define(:kind, :label, :href)
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            action = options.delete(:action) || "#"
+            method = options.delete(:method) || "get"
+            title = options.delete(:title)
+            subtitle = options.delete(:subtitle)
+            values = stringify_values(options.delete(:values) || {})
+            class_name = options.delete(:class_name)
+            compact = options.delete(:compact)
+
+            @theme = ui_theme(:companion)
+            @action = action
+            @method = method
+            @title = title
+            @subtitle = subtitle
+            @values = values
+            @compact = compact
+            @fields = []
+            @actions = []
+
+            super(options.merge(class: merge_classes("filters-panel rounded-[28px] border border-white/10 bg-white/[0.04] p-4", class_name)))
+            render_build_block(block) if block&.arity.to_i <= 0
+            render_component
+          end
+
+          def search(name, label: nil, placeholder: nil, value: nil, input_id: nil)
+            @fields << Field.new(:search, name.to_s, label, placeholder, resolve_value(name, value), nil, nil, input_id)
+            nil
+          end
+
+          def select(name, options:, label: nil, selected: nil, include_blank: "Any", input_id: nil)
+            @fields << Field.new(:select, name.to_s, label, nil, resolve_value(name, selected), options, include_blank, input_id)
+            nil
+          end
+
+          def hidden(name, value)
+            @fields << Field.new(:hidden, name.to_s, nil, nil, value, nil, nil, nil)
+            nil
+          end
+
+          def submit(label = "Apply Filters")
+            @actions << Action.new(:submit, label, nil)
+            nil
+          end
+
+          def clear(label = "Clear", href: @action)
+            @actions << Action.new(:clear, label, href)
+            nil
+          end
+
+          private
+
+          def render_component
+            render_header
+            form(action: @action, method: @method, class: "grid gap-4") do |form_view|
+              render_hidden_fields(form_view)
+              render_fields(form_view)
+              render_actions(form_view)
+            end
+          end
+
+          def render_header
+            return if @title.nil? && @subtitle.nil?
+
+            div(class: "mb-4 grid gap-1") do
+              h3(@title, class: @theme.section_heading_class(extra: "mt-0")) if @title
+              div(@subtitle, class: @theme.muted_text_class) if @subtitle
+            end
+          end
+
+          def render_hidden_fields(form_view)
+            @fields.select { |field| field.kind == :hidden }.each do |field|
+              form_view.input(type: "hidden", name: field.name, value: field.value)
+            end
+          end
+
+          def render_fields(form_view)
+            visible_fields = @fields.reject { |field| field.kind == :hidden }
+            return if visible_fields.empty?
+
+            grid_class = @compact ? "grid gap-3 md:grid-cols-[minmax(0,1.2fr)_minmax(180px,220px)]" : "grid gap-3 md:grid-cols-2"
+
+            form_view.div(class: grid_class) do |grid|
+              visible_fields.each do |field|
+                grid.div(class: "grid gap-2") do |container|
+                  render_label(container, field)
+                  render_field(container, field)
+                end
+              end
+            end
+          end
+
+          def render_actions(form_view)
+            actions = @actions.dup
+            actions << Action.new(:submit, "Apply Filters", nil) if actions.none? { |item| item.kind == :submit }
+
+            form_view.div(class: "flex flex-wrap items-center gap-3") do |bar|
+              actions.each do |action|
+                case action.kind
+                when :submit
+                  bar.button(
+                    action.label,
+                    type: "submit",
+                    class: Igniter::Frontend::Tailwind::UI::Tokens.action(variant: :soft, theme: :orange, size: :sm)
+                  )
+                when :clear
+                  bar.a(action.label, href: action.href, class: Igniter::Frontend::Tailwind::UI::Tokens.underline_link(theme: :orange))
+                end
+              end
+            end
+          end
+
+          def render_label(container, field)
+            return unless field.label
+
+            container.label(field.label, for: field.input_id || field.name, class: @theme.field_label_class)
+          end
+
+          def render_field(container, field)
+            case field.kind
+            when :search
+              container.input(
+                id: field.input_id || field.name,
+                type: "text",
+                name: field.name,
+                value: field.value,
+                placeholder: field.placeholder || "Search",
+                class: @theme.input_class
+              )
+            when :select
+              options = build_select_options(field)
+              container.select(id: field.input_id || field.name, name: field.name, class: @theme.input_class) do |select|
+                options.each do |label, value|
+                  option_attrs = { value: value }
+                  option_attrs[:selected] = true if field.value.to_s == value.to_s
+                  select.option(label, **option_attrs)
+                end
+              end
+            end
+          end
+
+          def build_select_options(field)
+            options = Array(field.options).map do |entry|
+              entry.is_a?(Array) ? entry : [entry.to_s, entry.to_s]
+            end
+
+            return options if field.include_blank.nil?
+
+            [[field.include_blank.to_s, ""]] + options
+          end
+
+          def resolve_value(name, explicit)
+            return explicit unless explicit.nil?
+
+            @values.fetch(name.to_s, nil)
+          end
+
+          def stringify_values(values)
+            values.each_with_object({}) { |(key, value), memo| memo[key.to_s] = value }
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/indicator.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Indicator < Arbre::Component
+          builder_method :indicator
+
+          TONE_CLASS = {
+            neutral: "bg-stone-500",
+            healthy: "bg-emerald-300",
+            warning: "bg-amber-300",
+            danger: "bg-rose-300",
+            info: "bg-cyan-300",
+            accent: "bg-orange-300"
+          }.freeze
+
+          def build(label, *args)
+            options = extract_options!(args)
+            tone = options.delete(:tone)&.to_sym || infer_tone(label)
+            class_name = options.delete(:class_name)
+            titleize = options.key?(:titleize) ? options.delete(:titleize) : true
+            normalized = titleize ? humanize_label(label) : label.to_s
+
+            super(options.merge(class: merge_classes("inline-flex items-center gap-2 text-sm text-stone-200", class_name)))
+            span(class: merge_classes("inline-flex h-2.5 w-2.5 rounded-full", TONE_CLASS.fetch(tone, TONE_CLASS[:neutral])))
+            span(normalized, class: "font-medium")
+          end
+
+          private
+
+          def infer_tone(value)
+            token = value.to_s.downcase.strip.gsub(/\s+/, "_")
+
+            case token
+            when "ready", "healthy", "online", "running", "joined", "active"
+              :healthy
+            when "pending", "queued", "awaiting", "degraded", "warming"
+              :warning
+            when "failed", "blocked", "offline", "error"
+              :danger
+            when "detached", "idle", "neutral"
+              :info
+            else
+              :neutral
+            end
+          end
+
+          def tag_name
+            "span"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/json_panel.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "json"
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class JsonPanel < Arbre::Component
+          builder_method :json_panel
+
+          def build(*args)
+            options = extract_options!(args)
+            title = options.delete(:title)
+            payload = options.delete(:payload)
+            panel_id = options.delete(:panel_id)
+            span = options.delete(:span)
+            class_name = options.delete(:class_name)
+            span_class = span ? "span-#{span}" : nil
+
+            super(options.merge(class: merge_classes("panel", span_class, class_name)))
+            h2(title) if title
+            pre(id: panel_id) { |code| code.text_node(JSON.pretty_generate(payload)) }
+          end
+
+          private
+
+          def tag_name
+            "article"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/key_value_list.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class KeyValueList < Arbre::Component
+          builder_method :key_value_list
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("kv-list", class_name)))
+            render_build_block(block)
+          end
+
+          def item(label, value = nil, &block)
+            dt(humanize_label(label), class: "kv-term")
+            dd(class: "kv-value") do
+              if block
+                render_build_block(block)
+              else
+                text_node(value.to_s)
+              end
+            end
+          end
+
+          private
+
+          def tag_name
+            "dl"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/loading_state.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class LoadingState < Arbre::Component
+          builder_method :loading_state
+
+          def build(*args)
+            options = extract_options!(args)
+            title = args.shift || options.delete(:title) || "Loading"
+            message = options.delete(:message)
+            lines = (options.delete(:lines) || 3).to_i
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("rounded-[28px] border border-white/10 bg-white/[0.03] px-5 py-6", class_name)))
+            div(title, class: "text-sm font-semibold uppercase tracking-[0.18em] text-stone-300")
+            div(message, class: "mt-2 text-sm leading-6 text-stone-400") if message
+            div(class: "mt-5 grid gap-3") do |stack|
+              lines.times do |index|
+                width_class =
+                  case index % 3
+                  when 0 then "w-full"
+                  when 1 then "w-4/5"
+                  else "w-3/5"
+                  end
+
+                stack.div(class: merge_classes("h-3 animate-pulse rounded-full bg-white/10", width_class))
+              end
+            end
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/metric_grid.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class MetricGrid < Arbre::Component
+          builder_method :metric_grid
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("stats metric-grid", class_name)))
+            render_build_block(block)
+          end
+
+          def metric(label, value, hint: nil)
+            div(class: "stat") do |card|
+              card.strong humanize_label(label)
+              card.span value.to_s
+              card.div hint, class: "caption" if hint
+            end
+          end
+
+          private
+
+          def tag_name
+            "div"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/number.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Number < Arbre::Component
+          builder_method :number
+
+          def build(value, *args)
+            options = extract_options!(args)
+            precision = options.key?(:precision) ? options.delete(:precision).to_i : default_precision(value)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("font-mono text-sm leading-6 text-stone-100", class_name)))
+            text_node(format_number(value, precision: precision))
+          end
+
+          private
+
+          def default_precision(value)
+            numeric = coerce_number(value)
+            return 0 unless numeric
+
+            numeric.to_f == numeric.to_i ? 0 : 2
+          end
+
+          def format_number(value, precision:)
+            numeric = coerce_number(value)
+            return value.to_s unless numeric
+
+            whole, fractional = format("%.#{precision}f", numeric).split(".")
+            whole = whole.reverse.scan(/\d{1,3}/).join(",").reverse
+            precision.zero? ? whole : "#{whole}.#{fractional}"
+          end
+
+          def coerce_number(value)
+            return value if value.is_a?(Numeric)
+            return Float(value.to_s) unless value.nil? || value.to_s.empty?
+          rescue ArgumentError, TypeError
+            nil
+          end
+
+          def tag_name
+            "span"
+          end
+        end
+      end
+    end
+  end
+end

data/packages/igniter-frontend/lib/igniter/frontend/arbre/components/page_header.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class PageHeader < Arbre::Component
+          builder_method :page_header
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            title = options.delete(:title)
+            eyebrow = options.delete(:eyebrow)
+            description = options.delete(:description)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("hero", class_name)))
+
+            div(eyebrow, class: "eyebrow") if eyebrow
+            h1 title
+            div(description) if description
+
+            render_build_block(block)
+          end
+
+          def meta(&block)
+            div(class: "meta", &block)
+          end
+
+          def actions(&block)
+            div(class: "actions", &block)
+          end
+
+          def stats(&block)
+            div(class: "stats", &block)
+          end
+
+          def notice(message, class_name: "ok")
+            div(message, class: class_name)
+          end
+
+          private
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end