ruby_ui_admin 0.1.0

data/app/components/ruby_ui_admin/ui/pagination_item.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+# A page link styled with the Button classes (outline when active, ghost otherwise).
+module RubyUIAdmin
+  module UI
+    class PaginationItem < Base
+      def initialize(href: "#", active: false, **attrs)
+        @href = href
+        @active = active
+        super(**attrs)
+      end
+
+      def view_template(&block)
+        li do
+          a(href: @href, **attrs, &block)
+        end
+      end
+
+      private
+
+      def default_attrs
+        {
+          aria: {current: @active ? "page" : nil},
+          class: [
+            RubyUI::Button.new(variant: @active ? :outline : :ghost).attrs[:class]
+          ]
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/select.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RubyUIAdmin
+  module UI
+    # Convenience wrapper around RubyUI's NativeSelect: takes an array of [label, value]
+    # `options` (plus `selected:`/`include_blank:`) instead of explicit option components,
+    # so call sites stay terse. Renders the styled native select with a custom chevron.
+    class Select < Base
+      def initialize(options: [], selected: nil, include_blank: false, **attrs)
+        @options = options
+        @selected = selected
+        @include_blank = include_blank
+        super(**attrs)
+      end
+
+      def view_template
+        render NativeSelect.new(**attrs) do
+          render(NativeSelectOption.new(value: "")) { "—" } if @include_blank
+
+          @options.each do |(label, value)|
+            opts = {value: value}
+            opts[:selected] = true if value.to_s == @selected.to_s
+            render(NativeSelectOption.new(**opts)) { label.to_s }
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_action.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastAction < Base
+      def initialize(label:, on: nil, **attrs)
+        @label = label
+        @on = on
+        super(**attrs)
+      end
+
+      def view_template
+        button(**attrs) { @label }
+      end
+
+      private
+
+      def default_attrs
+        data = {slot: "action"}
+        data[:action] = @on if @on
+        {
+          type: "button",
+          data: data,
+          class: "inline-flex h-6 shrink-0 cursor-pointer items-center justify-center rounded px-2 text-xs font-medium bg-foreground text-background border-0 ml-auto hover:opacity-90 focus:outline-none focus:ring-2 focus:ring-ring transition-opacity disabled:pointer-events-none disabled:opacity-50"
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_cancel.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastCancel < Base
+      def initialize(label:, **attrs)
+        @label = label
+        super(**attrs)
+      end
+
+      def view_template
+        button(**attrs) { @label }
+      end
+
+      private
+
+      def default_attrs
+        {
+          type: "button",
+          data: {
+            slot: "cancel",
+            action: "click->ruby-ui--toast#dismiss"
+          },
+          class: "inline-flex h-6 shrink-0 cursor-pointer items-center justify-center rounded px-2 text-xs font-medium bg-foreground/10 text-foreground border-0 ml-auto hover:bg-foreground/15 focus:outline-none focus:ring-2 focus:ring-ring transition-colors"
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_close.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastClose < Base
+      def view_template
+        button(**attrs) do
+          svg(
+            xmlns: "http://www.w3.org/2000/svg",
+            width: "14",
+            height: "14",
+            viewbox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            stroke_width: "2",
+            stroke_linecap: "round",
+            stroke_linejoin: "round",
+            class: "size-3.5"
+          ) do |s|
+            s.path(d: "M18 6 6 18")
+            s.path(d: "m6 6 12 12")
+          end
+          span(class: "sr-only") { "Close" }
+        end
+      end
+
+      private
+
+      def default_attrs
+        {
+          type: "button",
+          aria_label: "Close toast",
+          data: {
+            slot: "close",
+            action: "click->ruby-ui--toast#dismiss"
+          },
+          class: "absolute right-2 top-2 size-6 cursor-pointer rounded-md text-foreground/60 p-0 flex items-center justify-center transition-colors hover:bg-muted hover:text-foreground focus:outline-none focus:ring-1 focus:ring-ring"
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_description.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastDescription < Base
+      def view_template(&)
+        div(**attrs, &)
+      end
+
+      private
+
+      def default_attrs
+        {
+          data: {slot: "description"},
+          class: "font-normal leading-[1.4] text-muted-foreground"
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_icon.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastIcon < Base
+      def initialize(variant: nil, **attrs)
+        @variant = variant&.to_sym
+        super(**attrs)
+      end
+
+      def view_template
+        return unless renderable?
+
+        span(**attrs) do
+          svg(
+            xmlns: "http://www.w3.org/2000/svg",
+            width: "16",
+            height: "16",
+            viewbox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            stroke_width: "2",
+            stroke_linecap: "round",
+            stroke_linejoin: "round",
+            class: "#{svg_classes} -ml-px"
+          ) { |s| paths(s) }
+        end
+      end
+
+      private
+
+      def renderable?
+        %i[success error warning info loading].include?(@variant)
+      end
+
+      def svg_classes
+        base = "size-4"
+        (@variant == :loading) ? "#{base} animate-spin" : base
+      end
+
+      def paths(s)
+        case @variant
+        when :success
+          s.circle(cx: "12", cy: "12", r: "10")
+          s.path(d: "m9 12 2 2 4-4")
+        when :error
+          s.path(d: "M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z")
+          s.path(d: "m15 9-6 6")
+          s.path(d: "m9 9 6 6")
+        when :warning
+          s.path(d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3")
+          s.path(d: "M12 9v4")
+          s.path(d: "M12 17h.01")
+        when :info
+          s.circle(cx: "12", cy: "12", r: "10")
+          s.path(d: "M12 16v-4")
+          s.path(d: "M12 8h.01")
+        when :loading
+          s.path(d: "M21 12a9 9 0 1 1-6.219-8.56")
+        end
+      end
+
+      def default_attrs
+        {data: {slot: "icon"}, class: "shrink-0 inline-flex items-center justify-start relative size-4 -ml-[3px] mr-1 text-foreground"}
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_item.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastItem < Base
+      ALERT_VARIANTS = %i[error].freeze
+
+      def initialize(
+        variant: :default,
+        id: nil,
+        duration: nil,
+        dismissible: true,
+        invert: false,
+        on_dismiss: nil,
+        on_auto_close: nil,
+        **attrs
+      )
+        @variant = variant.to_sym
+        @id = id
+        @duration = duration
+        @dismissible = dismissible
+        @invert = invert
+        @on_dismiss = on_dismiss
+        @on_auto_close = on_auto_close
+        super(**attrs)
+      end
+
+      def view_template(&)
+        li(**attrs, &)
+      end
+
+      private
+
+      def default_attrs
+        a = {
+          role: ALERT_VARIANTS.include?(@variant) ? "alert" : "status",
+          aria_atomic: "true",
+          tabindex: "0",
+          data: {
+            variant: @variant.to_s,
+            state: "pending",
+            swipe: "none",
+            controller: "ruby-ui--toast",
+            ruby_ui__toaster_target: "toast",
+            ruby_ui__toast_dismissible_value: @dismissible.to_s,
+            ruby_ui__toast_invert_value: @invert.to_s
+          },
+          class: item_classes
+        }
+        a[:id] = @id if @id
+        a[:data][:ruby_ui__toast_duration_value] = @duration.to_s if @duration
+        a[:data][:ruby_ui__toast_on_dismiss_value] = @on_dismiss if @on_dismiss
+        a[:data][:ruby_ui__toast_on_auto_close_value] = @on_auto_close if @on_auto_close
+        a
+      end
+
+      def item_classes
+        <<~CLASSES.tr("\n", " ").squeeze(" ").strip
+          group/toast pointer-events-auto absolute left-0 right-0
+          flex w-[356px] max-w-full items-center gap-1.5
+          rounded-lg border bg-popover text-popover-foreground
+          border-border p-4 text-[13px] shadow-[0_4px_12px_rgba(0,0,0,0.1)]
+          group-data-[close-button=true]/toaster:pr-10
+          transition-[transform,opacity] duration-300 ease-out
+          will-change-transform
+          opacity-[var(--opacity,1)]
+          data-[state=pending]:opacity-0
+          data-[state=closing]:opacity-0
+          data-[swipe=move]:transition-none
+        CLASSES
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_region.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI. The behaviour
+# is driven by RubyUI's Stimulus controllers (ruby-ui--toaster / ruby-ui--toast), loaded
+# self-hosted via the importmap in the admin layout.
+module RubyUIAdmin
+  module UI
+    class ToastRegion < Base
+      SKELETON_VARIANTS = %i[default success error warning info loading].freeze
+
+      # Maps Rails flash keys to RubyUI toast variants (admin semantics: notice = success,
+      # alert = error), with explicit variant keys passed through.
+      FLASH_VARIANTS = {
+        "notice" => :success,
+        "success" => :success,
+        "alert" => :error,
+        "error" => :error,
+        "warning" => :warning,
+        "info" => :info
+      }.freeze
+
+      def initialize(
+        position: :bottom_right,
+        expand: false,
+        max: 3,
+        duration: 4000,
+        gap: 14,
+        offset: 24,
+        theme: :system,
+        rich_colors: false,
+        close_button: false,
+        hotkey: %w[alt t],
+        dir: :ltr,
+        flash: nil,
+        **attrs
+      )
+        @position = position.to_sym
+        @expand = expand
+        @max = max
+        @duration = duration
+        @gap = gap
+        @offset = offset
+        @theme = theme.to_sym
+        @rich_colors = rich_colors
+        @close_button = close_button
+        @hotkey = hotkey
+        @dir = dir
+        @flash = flash
+        super(**attrs)
+      end
+
+      def view_template(&block)
+        div(**attrs) do
+          ol(id: "ruby-ui-toaster", class: "pointer-events-auto relative m-0 p-0 list-none w-[356px] max-w-full") do
+            render_flash if @flash
+            yield(self) if block
+          end
+          SKELETON_VARIANTS.each { |v| skeleton(v) }
+          slot_template("actionTpl") { render ToastAction.new(label: "") }
+          slot_template("cancelTpl") { render ToastCancel.new(label: "") }
+          slot_template("closeTpl") { render ToastClose.new }
+        end
+      end
+
+      private
+
+      def flash_variant(key)
+        FLASH_VARIANTS[key.to_s] || :info
+      end
+
+      def render_flash
+        @flash.each do |key, message|
+          next if message.nil? || message.to_s.empty?
+
+          variant = flash_variant(key)
+          render ToastItem.new(variant: variant, id: "flash-#{key}", duration: @duration) do
+            render ToastIcon.new(variant: variant)
+            render ToastTitle.new { message.to_s }
+          end
+        end
+      end
+
+      def skeleton(variant)
+        template(
+          data: {
+            ruby_ui__toaster_target: "skeleton",
+            variant: variant.to_s
+          }
+        ) do
+          render ToastItem.new(variant: variant) do
+            render ToastIcon.new(variant: variant)
+            div(class: "flex flex-col gap-0.5 flex-1 min-w-0") do
+              render ToastTitle.new
+              render ToastDescription.new
+            end
+            render ToastClose.new if @close_button
+          end
+        end
+      end
+
+      def slot_template(target_name, &)
+        template(data: {ruby_ui__toaster_target: target_name}, &)
+      end
+
+      def default_attrs
+        {
+          id: "ruby-ui-toaster-region",
+          role: "region",
+          aria_label: "Notifications",
+          aria_live: "polite",
+          data: {
+            controller: "ruby-ui--toaster",
+            # NOTE: deliberately NOT `turbo_permanent` (RubyUI ships it permanent). Under Turbo
+            # Drive a permanent region is carried over between visits, which would discard the new
+            # page's server-rendered flash toast — letting it re-render each visit keeps flash working.
+            close_button: @close_button.to_s,
+            position: @position.to_s.tr("_", "-"),
+            ruby_ui__toaster_position_value: @position.to_s.tr("_", "-"),
+            ruby_ui__toaster_expand_value: @expand.to_s,
+            ruby_ui__toaster_max_value: @max.to_s,
+            ruby_ui__toaster_duration_value: @duration.to_s,
+            ruby_ui__toaster_gap_value: @gap.to_s,
+            ruby_ui__toaster_offset_value: @offset.to_s,
+            ruby_ui__toaster_theme_value: @theme.to_s,
+            ruby_ui__toaster_rich_colors_value: @rich_colors.to_s,
+            ruby_ui__toaster_close_button_value: @close_button.to_s,
+            ruby_ui__toaster_hotkey_value: Array(@hotkey).join("+"),
+            ruby_ui__toaster_dir_value: @dir.to_s
+          },
+          class: region_classes
+        }
+      end
+
+      def region_classes
+        <<~CLASSES.tr("\n", " ").squeeze(" ").strip
+          group/toaster pointer-events-none fixed z-[100] p-4 sm:p-6
+          data-[position=top-left]:top-0 data-[position=top-left]:left-0
+          data-[position=top-center]:top-0 data-[position=top-center]:left-1/2 data-[position=top-center]:-translate-x-1/2
+          data-[position=top-right]:top-0 data-[position=top-right]:right-0
+          data-[position=bottom-left]:bottom-0 data-[position=bottom-left]:left-0
+          data-[position=bottom-center]:bottom-0 data-[position=bottom-center]:left-1/2 data-[position=bottom-center]:-translate-x-1/2
+          data-[position=bottom-right]:bottom-0 data-[position=bottom-right]:right-0
+        CLASSES
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui/toast_title.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# Vendored from RubyUI (github.com/ruby-ui), namespaced under RubyUIAdmin::UI.
+module RubyUIAdmin
+  module UI
+    class ToastTitle < Base
+      def view_template(&)
+        div(**attrs, &)
+      end
+
+      private
+
+      def default_attrs
+        {
+          data: {slot: "title"},
+          class: "font-medium leading-normal"
+        }
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/ui.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "phlex"
+
+module RubyUIAdmin
+  # Vendored RubyUI primitives, namespaced under the engine so they never collide
+  # with a host app's own `RubyUI` Phlex::Kit. Visual language and
+  # Tailwind classes are taken from RubyUI for consistency.
+  module UI
+    extend Phlex::Kit
+  end
+end

data/app/components/ruby_ui_admin/views/action.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module RubyUIAdmin
+  module Views
+    # Full-page confirmation/form for a custom action (no-JS fallback for the modal).
+    class Action < Base
+      def initialize(resource:, action:, action_id:, record_ids:)
+        @resource = resource
+        @action = action
+        @action_id = action_id
+        @record_ids = record_ids
+      end
+
+      def page_title
+        "#{@action.name} · #{RubyUIAdmin.configuration.app_name}"
+      end
+
+      def content
+        div(class: "mb-6") do
+          a(href: resource_index_path(@resource.class), class: "text-sm text-muted-foreground hover:underline") { "← #{@resource.navigation_label}" }
+          h1(class: "text-2xl font-semibold tracking-tight mt-1") { @action.name }
+        end
+
+        render RubyUI::Card.new(class: "max-w-2xl") do
+          render RubyUI::CardContent.new(class: "pt-6") do
+            render RubyUIAdmin::Views::ActionForm.new(
+              resource: @resource,
+              action: @action,
+              action_id: @action_id,
+              record_ids: @record_ids
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/ruby_ui_admin/views/action_form.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module RubyUIAdmin
+  module Views
+    # The inner form of a custom action (message + fields + buttons). Shared by the
+    # action page (Views::Action) and the inline action dialog (Views::ActionTrigger).
+    class ActionForm < Phlex::HTML
+      include RubyUIAdmin::UI
+      include RailsHelpers
+      include PathHelpers
+
+      def initialize(resource:, action:, action_id:, record_ids: [], frame_id: nil)
+        @resource = resource
+        @action = action
+        @action_id = action_id
+        @record_ids = record_ids
+        @frame_id = frame_id
+      end
+
+      # When loaded into the modal's `<turbo-frame>`, wrap the form in the matching frame so
+      # Turbo swaps it in. `data-turbo-frame="_top"` makes the submit break out into a full
+      # visit (POST→303→redirect+flash) instead of just reloading the frame. On the standalone
+      # action page (no frame_id) the form renders bare and `_top` is a harmless no-op.
+      def view_template
+        if @frame_id
+          tag(:turbo_frame, id: @frame_id) { render_form }
+        else
+          render_form
+        end
+      end
+
+      def render_form
+        form(action: action_path, method: "post", enctype: form_enctype, class: "space-y-5", data: {turbo_frame: "_top"}) do
+          input(type: "hidden", name: "authenticity_token", value: form_authenticity_token)
+          record_id_fields
+          render_message
+          @action.get_fields.each { |field| render_field(field) }
+          render_actions
+        end
+      end
+
+      private
+
+      def action_path
+        ruby_ui_admin.resource_action_path(resource_name: @resource.route_key, action_id: @action_id)
+      end
+
+      # File-upload fields require a multipart form.
+      def form_enctype
+        @action.get_fields.any? { |field| %i[file files].include?(field.type) } ? "multipart/form-data" : nil
+      end
+
+      def record_id_fields
+        Array(@record_ids).each do |id|
+          input(type: "hidden", name: "record_ids[]", value: id)
+        end
+      end
+
+      def render_message
+        message = @action.message
+        return if message.blank?
+
+        div(class: "text-sm text-muted-foreground") { raw(safe(message.to_s)) }
+      end
+
+      def render_field(field)
+        # A lone checkbox reads as "[ ] Label" — render it inline beside the label.
+        if field.type == :boolean
+          div(class: "space-y-1.5") do
+            label(class: "flex items-center gap-2 text-sm font-medium leading-none") do
+              render RubyUIAdmin::Views::FieldInput.new(field: field, record: nil, name_prefix: "fields")
+              plain field.name
+              span(class: "text-destructive ml-0.5") { "*" } if field.required?
+            end
+          end
+          return
+        end
+
+        div(class: "space-y-1.5") do
+          label(class: "text-sm font-medium leading-none") do
+            plain field.name
+            span(class: "text-destructive ml-0.5") { "*" } if field.required?
+          end
+          render RubyUIAdmin::Views::FieldInput.new(field: field, record: nil, name_prefix: "fields")
+        end
+      end
+
+      def render_actions
+        div(class: "flex items-center gap-3 pt-2") do
+          render(RubyUI::Button.new(type: :submit, variant: :primary)) { @action.class.confirm_button_label }
+
+          # Closes the dialog when inside one (Stimulus preventDefaults); otherwise falls back to
+          # the index. `_top` ensures any non-prevented click escapes the frame (a full visit)
+          # rather than rendering the index inside the modal frame.
+          a(
+            href: resource_index_path(@resource.class),
+            data: {action: "click->rua--dialog#close", turbo_frame: "_top"},
+            class: "text-sm text-muted-foreground hover:underline"
+          ) { @action.class.cancel_button_label }
+        end
+      end
+    end
+  end
+end