igniter 0.5.0 → 0.5.1

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

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Pagination < Arbre::Component
+          builder_method :pagination
+
+          DEFAULT_WINDOW = 5
+
+          def build(*args)
+            options = extract_options!(args)
+            theme = options.delete(:theme) || :companion
+            class_name = options.delete(:class_name)
+            current_page = normalize_page(options.delete(:current_page) || 1)
+            total_pages = normalize_page(options.delete(:total_pages) || 1)
+            total_count = options.delete(:total_count)
+            per_page = options.delete(:per_page)
+            item_name = options.delete(:item_name) || "items"
+            href_builder = options.delete(:href_builder)
+            window = normalize_page(options.delete(:window) || DEFAULT_WINDOW)
+            compact = options.delete(:compact)
+
+            @theme = ui_theme(theme)
+            @current_page = [current_page, total_pages].min
+            @total_pages = total_pages
+            @total_count = total_count
+            @per_page = per_page
+            @item_name = item_name.to_s
+            @href_builder = href_builder
+            @window = window
+            @compact = compact
+
+            super(options.merge(class: merge_classes("pagination-panel grid gap-3", class_name)))
+            render_component
+          end
+
+          private
+
+          def render_component
+            render_summary
+            render_controls if @total_pages > 1
+          end
+
+          def render_summary
+            div(summary_text, class: @theme.muted_text_class(extra: @compact ? "text-sm" : nil))
+          end
+
+          def render_controls
+            nav("aria-label": "#{humanize_label(@item_name)} pagination", class: "flex flex-wrap items-center gap-2") do |bar|
+              render_edge_link(bar, "Previous", @current_page - 1, disabled: @current_page <= 1)
+              page_window.each do |page|
+                render_page_link(bar, page)
+              end
+              render_edge_link(bar, "Next", @current_page + 1, disabled: @current_page >= @total_pages)
+            end
+          end
+
+          def render_edge_link(bar, label, page, disabled:)
+            if disabled
+              bar.span(label, class: disabled_class)
+            else
+              bar.a(label, href: page_href(page), class: action_class(:ghost))
+            end
+          end
+
+          def render_page_link(bar, page)
+            if page == @current_page
+              bar.span(page.to_s, class: current_page_class, "aria-current": "page")
+            else
+              bar.a(page.to_s, href: page_href(page), class: action_class(:soft))
+            end
+          end
+
+          def page_window
+            return (1..@total_pages).to_a if @total_pages <= @window
+
+            half = @window / 2
+            start_page = [@current_page - half, 1].max
+            end_page = start_page + @window - 1
+
+            if end_page > @total_pages
+              end_page = @total_pages
+              start_page = end_page - @window + 1
+            end
+
+            (start_page..end_page).to_a
+          end
+
+          def page_href(page)
+            return "#" unless @href_builder
+
+            @href_builder.call(page)
+          end
+
+          def summary_text
+            return "Page #{@current_page} of #{@total_pages}" if @total_count.nil? || @per_page.nil?
+            return "No #{display_item_name} yet." if @total_count.zero?
+
+            first = ((@current_page - 1) * @per_page) + 1
+            last = [@current_page * @per_page, @total_count].min
+            "Showing #{first}-#{last} of #{@total_count} #{display_item_name}"
+          end
+
+          def display_item_name
+            @item_name.tr("_", " ")
+          end
+
+          def action_class(variant)
+            Igniter::Frontend::Tailwind::UI::Tokens.action(
+              variant: variant,
+              theme: :orange,
+              size: :sm
+            )
+          end
+
+          def current_page_class
+            Igniter::Frontend::Tailwind::UI::Tokens.badge(theme: :orange)
+          end
+
+          def disabled_class
+            merge_classes(
+              "inline-flex items-center justify-center rounded-full border border-white/10 bg-white/[0.03] px-4 py-2 text-sm",
+              "text-stone-500"
+            )
+          end
+
+          def normalize_page(value)
+            integer = value.to_i
+            integer.positive? ? integer : 1
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Panel < Arbre::Component
+          builder_method :panel
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            title = options.delete(:title)
+            subtitle = options.delete(:subtitle)
+            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)))
+
+            build_heading(title, subtitle)
+            @body = div(class: "panel-body")
+            render_build_block(block)
+          end
+
+          def add_child(child)
+            return super if @body.nil? || child.equal?(@body) || child.equal?(@header) || child.equal?(@heading)
+
+            @body << child
+          end
+
+          def meta(value = nil, &block)
+            container = ensure_header_container!
+            value.nil? ? container.div(class: "meta", &block) : container.div(value, class: "meta", &block)
+          end
+
+          def actions(class_name: nil, &block)
+            ensure_header_container!.action_group(class_name: class_name, &block)
+          end
+
+          private
+
+          def build_heading(title, subtitle)
+            return if title.nil? && subtitle.nil?
+
+            ensure_heading_container!
+            @heading.h2(title) if title
+            @heading.div(subtitle, class: "caption") if subtitle
+          end
+
+          def ensure_header_container!
+            @header ||= div(class: "panel-header")
+          end
+
+          def ensure_heading_container!
+            ensure_header_container!
+            @heading ||= @header.div(class: "panel-heading")
+          end
+
+          def tag_name
+            "article"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class Percentage < Arbre::Component
+          builder_method :percentage
+
+          def build(value, *args)
+            options = extract_options!(args)
+            precision = options.key?(:precision) ? options.delete(:precision).to_i : 1
+            fraction = options.key?(:fraction) ? options.delete(:fraction) : infer_fraction(value)
+            class_name = options.delete(:class_name)
+            normalized = normalize_value(value, fraction: fraction)
+            tone = infer_tone(normalized)
+
+            super(options.merge(class: merge_classes("font-mono text-sm leading-6", tone_class(tone), class_name)))
+            text_node("#{format_value(normalized, precision: precision)}%")
+          end
+
+          private
+
+          def infer_fraction(value)
+            numeric = coerce_number(value)
+            numeric && numeric >= 0 && numeric <= 1
+          end
+
+          def normalize_value(value, fraction:)
+            numeric = coerce_number(value)
+            return nil unless numeric
+
+            fraction ? numeric * 100.0 : numeric
+          end
+
+          def format_value(value, precision:)
+            return "--" if value.nil?
+
+            format("%.#{precision}f", value)
+          end
+
+          def infer_tone(value)
+            return :neutral if value.nil?
+            return :healthy if value >= 75
+            return :warning if value >= 40
+
+            :danger
+          end
+
+          def tone_class(tone)
+            case tone
+            when :healthy
+              "text-emerald-200"
+            when :warning
+              "text-amber-200"
+            when :danger
+              "text-rose-200"
+            else
+              "text-stone-300"
+            end
+          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/resource_list.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class ResourceList < Arbre::Component
+          builder_method :resource_list
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            class_name = options.delete(:class_name)
+
+            super(options.merge(class: merge_classes("list resource-list", class_name)))
+            render_build_block(block)
+          end
+
+          def item(title = nil, detail: nil, meta: nil, class_name: nil, &block)
+            li(class: class_name) do |entry|
+              entry.strong(title) if title
+              entry.text_node(" · #{detail}") if detail
+              entry.span(" (#{meta})", class: "caption") if meta
+              entry.instance_exec(&block) if block
+            end
+          end
+
+          private
+
+          def tag_name
+            "ul"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class ScenarioCard < Arbre::Component
+          builder_method :scenario_card
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            title = options.delete(:title)
+            severity = options.delete(:severity)
+            summary = options.delete(:summary)
+            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)))
+            h3(title) if title
+            badge(severity, tone: badge_tone(severity)) if severity
+            div(summary) if summary
+            render_build_block(block)
+          end
+
+          private
+
+          def badge_tone(status)
+            case status.to_s
+            when "healthy"
+              :healthy
+            when "warning"
+              :warning
+            else
+              :danger
+            end
+          end
+
+          def tag_name
+            "article"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class ShellColumns < Arbre::Component
+          builder_method :shell_columns
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            class_name = options.delete(:class_name)
+            @main_class_name = options.delete(:main_class_name)
+            @aside_class_name = options.delete(:aside_class_name)
+
+            super(options.merge(class: merge_classes("grid gap-6 xl:grid-cols-[minmax(0,1.2fr)_minmax(320px,0.8fr)]", class_name)))
+            @main = section(class: merge_classes("grid gap-6 min-w-0", @main_class_name))
+            @aside = section(class: merge_classes("grid gap-6 min-w-0", @aside_class_name))
+            render_build_block(block)
+          end
+
+          def add_child(child)
+            return super if @building_slot || child.equal?(@main) || child.equal?(@aside)
+
+            ensure_main! << child
+          end
+
+          def main(&block)
+            ensure_main!.instance_exec(&block) if block
+            nil
+          end
+
+          def aside(&block)
+            ensure_aside!.instance_exec(&block) if block
+            nil
+          end
+
+          private
+
+          def ensure_main!
+            return @main if @main
+
+            @building_slot = true
+            @main = section(class: merge_classes("grid gap-6 min-w-0", @main_class_name))
+          ensure
+            @building_slot = false
+          end
+
+          def ensure_aside!
+            return @aside if @aside
+
+            @building_slot = true
+            @aside = section(class: merge_classes("grid gap-6 min-w-0", @aside_class_name))
+          ensure
+            @building_slot = false
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require_relative "../component"
+
+module Igniter
+  module Frontend
+    module Arbre
+      module Components
+        class SidebarShell < Arbre::Component
+          builder_method :sidebar_shell
+
+          Item = ::Data.define(:label, :href, :current, :meta)
+          Section = ::Data.define(:title, :items)
+
+          def build(*args, &block)
+            options = extract_options!(args)
+            @title = options.delete(:title)
+            @subtitle = options.delete(:subtitle)
+            @sections = normalize_sections(options.delete(:sections) || [])
+            @summary_items = normalize_summary_items(options.delete(:summary_items) || [])
+            class_name = options.delete(:class_name)
+            sidebar_class_name = options.delete(:sidebar_class_name)
+            content_class_name = options.delete(:content_class_name)
+
+            super(options.merge(class: merge_classes("sidebar-shell grid gap-6 xl:grid-cols-[280px_minmax(0,1fr)]", class_name)))
+            @sidebar = build_sidebar(sidebar_class_name)
+            @content = div(class: merge_classes("grid gap-6 min-w-0", content_class_name))
+            render_build_block(block)
+          end
+
+          def add_child(child)
+            return super if @content.nil? || child.equal?(@sidebar) || child.equal?(@content)
+
+            @content << child
+          end
+
+          private
+
+          def build_sidebar(class_name)
+            aside(class: merge_classes("grid gap-4 self-start xl:sticky xl:top-6", class_name)) do |sidebar|
+              sidebar.div(class: "rounded-[30px] border border-white/10 bg-[#20130f]/95 p-5 shadow-2xl shadow-black/20") do |card|
+                if @title || @subtitle
+                  card.div(class: "grid gap-1") do |header|
+                    header.div(@title, class: "text-sm font-semibold uppercase tracking-[0.22em] text-orange-200") if @title
+                    header.div(@subtitle, class: "text-sm leading-6 text-stone-400") if @subtitle
+                  end
+                end
+
+                if @summary_items.any?
+                  card.div(class: "mt-5 grid gap-3") do |summary|
+                    @summary_items.each do |item|
+                      summary.div(class: "rounded-2xl border border-white/10 bg-white/[0.03] px-4 py-3") do |row|
+                        row.div(item.fetch(:label), class: "text-[11px] font-semibold uppercase tracking-[0.18em] text-stone-400")
+                        row.div(item.fetch(:value).to_s, class: "mt-1 text-sm font-medium text-stone-100")
+                      end
+                    end
+                  end
+                end
+              end
+
+              @sections.each do |section|
+                sidebar.nav("aria-label": section.title.to_s, class: "rounded-[28px] border border-white/10 bg-[#20130f]/95 p-5 shadow-2xl shadow-black/20") do |nav_view|
+                  nav_view.div(section.title.to_s, class: "text-[11px] font-semibold uppercase tracking-[0.18em] text-stone-400") if section.title
+                  nav_view.div(class: "mt-4 grid gap-2") do |list|
+                    section.items.each { |item| render_item(list, item) }
+                  end
+                end
+              end
+            end
+          end
+
+          def render_item(list, item)
+            classes = Igniter::Frontend::Tailwind::UI::Tokens.action(
+              variant: item.current ? :soft : :ghost,
+              theme: :orange,
+              size: :sm,
+              extra: "w-full justify-between"
+            )
+
+            list.a(href: item.href, class: classes, "aria-current": (item.current ? "page" : nil)) do |link|
+              link.span(item.label.to_s)
+              link.span(item.meta.to_s, class: "text-[11px] uppercase tracking-[0.18em] text-stone-400") if item.meta
+            end
+          end
+
+          def normalize_sections(sections)
+            sections.map do |section|
+              Section.new(
+                section[:title],
+                Array(section[:items]).map { |item| Item.new(item[:label], item[:href], item[:current], item[:meta]) }
+              )
+            end
+          end
+
+          def normalize_summary_items(items)
+            items.map { |item| { label: item[:label], value: item[:value] } }
+          end
+
+          def tag_name
+            "section"
+          end
+        end
+      end
+    end
+  end
+end