ariadne_view_components 0.0.12-x86_64-darwin → 0.0.14-x86_64-darwin

data/app/components/ariadne/tab_nav_component.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `TabNavComponent` to style navigation links, typically placed at the top
+  # of the page.
+  #
+  # For panel navigation, use <%= link_to_component(Ariadne::TabContainerComponent) %> instead.
+  #
+  # @accessibility
+  #   - By default, `TabNavComponent` renders links within a `<nav>` element. `<nav>` has an
+  #     implicit landmark role of `navigation` which should be reserved for main links.
+  #     For all other set of links, set tag to `:div`.
+  #   - See <%= link_to_component(Ariadne::TabComponent) %> for additional
+  #     accessibility considerations.
+  class TabNavComponent < Ariadne::Component
+    DEFAULT_TAG = :nav
+    TAG_OPTIONS = [DEFAULT_TAG, :div].freeze
+
+    BODY_TAG_DEFAULT = :ul
+
+    # keep this consistent with tab-container-component.ts
+    SELECTED_CLASSES = "ariadne-border-indigo-500 ariadne-text-indigo-600"
+    UNSELECTED_CLASSES = "ariadne-text-gray-500 hover:ariadne-text-gray-700 hover:ariadne-border-gray-300"
+
+    DEFAULT_CLASSES = ""
+
+    # Tabs to be rendered. Use the tabs to list page links.
+    #
+    # @param selected [Boolean] Whether the tab is selected.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_many :tabs, lambda { |selected: false, href: nil, classes: "", attributes: {}|
+      attributes[:href] = href
+      attributes[:"data-tab-nav-component-target"] = "tab"
+      attributes[:"data-action"] = "click->tab-nav-component#toggle"
+
+      actual_classes = class_names(selected ? SELECTED_CLASSES : UNSELECTED_CLASSES, classes)
+      Ariadne::TabComponent.new(
+        selected: selected,
+
+        classes: actual_classes,
+        attributes: attributes,
+      )
+    }
+
+    # @example Default with `<nav>`
+    #   @description
+    #     `<nav>` is a landmark and should be reserved for main navigation links. See <%= link_to_accessibility %>.
+    #   @code
+    #     <%= render(Ariadne::TabNavComponent.new(label: "Nav")) do |c| %>
+    #       <% c.tab(selected: true, href: "#") { "Tab 1" } %>
+    #       <% c.tab(href: "#") { "Tab 2" } %>
+    #       <% c.tab(href: "#") { "Tab 3" } %>
+    #     <% end %>
+    #
+    # @param label [String] Sets an `aria-label` that helps assistive technology users understand the purpose of the links, and distinguish it from similar elements.
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(label:, tag: DEFAULT_TAG, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+      @attributes[:"aria-label"] = label
+      @attributes[:"data-controller"] = "tab-nav-component"
+    end
+  end
+end

data/app/components/ariadne/table_nav_component.html.erb

@@ -0,0 +1,52 @@
+<div class="ariadne-inline-block ariadne-min-w-full ariadne-py-2 ariadne-align-middle md:ariadne-px-6 lg:ariadne-px-8">
+  <div class="ariadne-overflow-hidden ariadne-shadow ariadne-ring-1 ariadne-ring-black ariadne-ring-opacity-5 md:ariadne-rounded-lg">
+    <%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do |table| %>
+      <% if has_header_row? %>
+        <thead>
+          <%= render(Ariadne::BaseComponent.new(tag: :tr, classes: header_row.classes, attributes: header_row.attributes)) do %>
+            <%= header_row.selection_cell %>
+            <%= header_row.main_cell %>
+            <% header_row.action_cells.each_with_index do |action_cell, idx| %>
+              <% if idx.zero? %>
+                <%= action_cell %>
+              <% elsif idx == header_row.action_cells.size - 1 %>
+                <%= action_cell %>
+              <% else %>
+                <%= action_cell %>
+              <% end %>
+            <% end %>
+          <% end %>
+        </thead>
+      <% end %>
+      <tbody>
+        <% rows.each do |row| %>
+          <%= render(Ariadne::BaseComponent.new(tag: :tr, classes: row.classes, attributes: row.attributes)) do %>
+            <%= row.selection_cell %>
+            <%= row.main_cell %>
+            <% row.metadata_cells.each_with_index do |metadata_cell, idx| %>
+              <% if idx.zero? %>
+                <%= metadata_cell %>
+              <% elsif idx == row.metadata_cells.size - 1 %>
+                <%= metadata_cell %>
+              <% else %>
+                <%= metadata_cell %>
+              <% end %>
+            <% end %>
+          <% end %>
+        <% end %>
+      </tbody>
+    <% end %>
+  </div>
+  <% if has_footer? %>
+    <%= render(Ariadne::BaseComponent.new(tag: :div, classes: footer.classes, attributes: footer.attributes)) do %>
+      <%= footer.records_info %>
+      <%= render(Ariadne::BaseComponent.new(tag: :nav, classes: footer.pagination_bar.classes, attributes: footer.pagination_bar.attributes)) do %>
+        <%= footer.pagination_bar.prev_page %>
+        <% footer.pagination_bar.items.each do |item| %>
+          <%= item %>
+        <% end %>
+        <%= footer.pagination_bar.next_page %>
+      <% end %>
+    <% end %>
+  <% end %>
+</div>

data/app/components/ariadne/table_nav_component.rb

@@ -0,0 +1,338 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # The `TableNavComponent` is used to render a table navigation.
+  class TableNavComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-min-w-full ariadne-divide-y ariadne-divide-gray-300"
+
+    renders_one :header_row, "BaseRowItem::HeaderRowItem"
+
+    renders_many :rows, "BaseRowItem::RowItem"
+
+    renders_one :footer, "FooterItem"
+
+    DEFAULT_TAG = :table
+
+    # @example Default
+    #
+    # <%= render(Ariadne::TableNavComponent.new) do |table| %>
+    #   <%= table.header_row do |header_row| %>
+    #     <% header_row.selection_cell do %>
+    #       Status
+    #     <% end %>
+    #     <% header_row.main_cell do %>
+    #       State
+    #     <% end %>
+    #     <% header_row.action_cell do %>
+    #       Labels
+    #     <% end %>
+    #   <% end %>
+    #   <%= table.row do |row| %>
+    #     <% row.selection_cell do %>
+    #       G
+    #     <% end %>
+    #     <% row.main_cell do %>
+    #       "California"
+    #     <% end %>
+    #     <% row.metadata_cell do %>
+    #       Labels
+    #     <% end %>
+    #   <% end %>
+    #   <%= table.row do |row| %>
+    #     <% row.selection_cell do %>
+    #       V
+    #     <% end %>
+    #     <% row.main_cell do %>
+    #       "New York"
+    #     <% end %>
+    #     <% row.metadata_cell do %>
+    #       Labels
+    #     <% end %>
+    #   <% end %>
+    #   <%= table.row do |row| %>
+    #     <% row.cell do %>
+    #       D
+    #     <% end %>
+    #     <% row.selection_cell do %>
+    #       "Texas"
+    #     <% end %>
+    #     <% row.metadata_cell do %>
+    #       Labels
+    #     <% end %>
+    #   <% end %>
+    # <% end %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @tag = DEFAULT_TAG
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+    end
+
+    def has_header_row?
+      header_row.present?
+    end
+
+    def has_footer?
+      footer.present?
+    end
+
+    # This component is part of `TableNavComponent` and should not be
+    # used as a standalone component.
+    class BaseRowItem < Ariadne::TableNavComponent
+      BASE_ROW_CLASSES = ""
+
+      DEFAULT_TAG = :tr
+
+      BASE_SELECTION_CLASSES = ""
+      renders_one :selection_cell, lambda { |classes: "", attributes: {}|
+        actual_classes = class_names(BASE_SELECTION_CLASSES, classes)
+        if header?
+          Ariadne::TableNavComponent::BaseCellItem::HeaderCellItem.new(classes: actual_classes, attributes: attributes)
+        else
+          Ariadne::TableNavComponent::BaseCellItem::CellItem.new(classes: actual_classes, attributes: attributes)
+        end
+      }
+
+      BASE_MAIN_CLASSES = "ariadne-pr-5"
+      renders_one :main_cell, lambda { |classes: "", attributes: {}|
+        actual_classes = class_names(BASE_MAIN_CLASSES, classes)
+        if header?
+          Ariadne::TableNavComponent::BaseCellItem::HeaderCellItem.new(classes: actual_classes, attributes: attributes)
+        else
+          Ariadne::TableNavComponent::BaseCellItem::CellItem.new(classes: actual_classes, attributes: attributes)
+        end
+      }
+
+      attr_reader :classes, :attributes
+
+      def initialize(classes: "", attributes: {})
+        @tag = DEFAULT_TAG
+        @classes = class_names(BASE_ROW_CLASSES, classes)
+
+        @attributes = attributes
+      end
+
+      private def linked?
+        @href.present?
+      end
+
+      private def header?
+        @header.present?
+      end
+
+      def call
+        Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)
+      end
+
+      # This component is part of `TableNavComponent` and should not be
+      # used as a standalone component.
+      class RowItem < Ariadne::TableNavComponent::BaseRowItem
+        DEFAULT_ROW_CLASSES = "ariadne-bg-white"
+        DEFAULT_METADATA_CLASSES = ""
+        renders_many :metadata_cells, lambda { |classes: "", attributes: {}|
+          actual_classes = class_names(DEFAULT_METADATA_CLASSES, classes)
+          Ariadne::TableNavComponent::BaseCellItem::CellItem.new(classes: actual_classes, attributes: attributes)
+        }
+
+        attr_reader :href
+
+        def initialize(classes: "", attributes: {})
+          @header = false
+
+          actual_classes = class_names(DEFAULT_ROW_CLASSES, classes)
+
+          super(classes: actual_classes, attributes: attributes)
+        end
+      end
+
+      # This component is part of `TableNavComponent` and should not be
+      # used as a standalone component.
+      class HeaderRowItem < Ariadne::TableNavComponent::BaseRowItem
+        DEFAULT_HEADER_ROW_CLASSES = "ariadne-bg-gray-50 ariadne-text-left"
+
+        renders_many :action_cells, lambda { |classes: "", attributes: {}|
+          Ariadne::TableNavComponent::BaseCellItem::HeaderCellItem.new(classes: classes, attributes: attributes)
+        }
+
+        def initialize(classes: "", attributes: {})
+          @header = true
+
+          actual_classes = class_names(
+            DEFAULT_HEADER_ROW_CLASSES,
+            classes,
+          )
+
+          super(classes: actual_classes, attributes: attributes)
+        end
+      end
+    end
+
+    # This component is part of `TableNavComponent` and should not be
+    # used as a standalone component.
+    class BaseCellItem < Ariadne::TableNavComponent
+      DEFAULT_CELL_CLASSES = "ariadne-py-3.5 ariadne-pl-4 ariadne-pr-3 ariadne-text-left ariadne-text-sm ariadne-text-gray-900"
+
+      attr_writer :first, :last
+
+      def initialize(classes: "", attributes: {})
+        @classes = class_names(
+          DEFAULT_CELL_CLASSES,
+          classes,
+        )
+
+        @attributes = attributes
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do
+          content
+        end
+      end
+
+      # This component is part of `TableNavComponent` and should not be
+      # used as a standalone component.
+      class HeaderCellItem < Ariadne::TableNavComponent::BaseCellItem
+        DEFAULT_HEADER_CELL_CLASSES = "ariadne-py-3.5 ariadne-pl-4 ariadne-pr-3 ariadne-text-left ariadne-text-sm ariadne-font-semibold ariadne-text-gray-900 sm:ariadne-pl-6 md:ariadne-pl-0"
+
+        DEFAULT_TAG = :th
+
+        WIDTH_CLASSES = {
+          none: "ariadne-flex-none ariadne-w-14 ariadne-px-4",
+          default: "ariadne-flex-initial",
+          narrow: "ariadne-flex-initial ariadne-w-1/5 ariadne-text-right",
+          wide: "ariadne-flex-grow ariadne-w-3/5 sm:ariadne-pl-6",
+        }
+
+        # TODO: add one_of check for width
+        def initialize(classes: "", attributes: {})
+          @tag = DEFAULT_TAG
+          actual_classes = class_names(DEFAULT_HEADER_CELL_CLASSES, classes)
+          attributes["scope"] = "col"
+          super(classes: actual_classes, attributes: attributes)
+        end
+      end
+
+      # This component is part of `TableNavComponent` and should not be
+      # used as a standalone component.
+      class CellItem < Ariadne::TableNavComponent::BaseCellItem
+        DEFAULT_CELL_CLASSES = ""
+
+        DEFAULT_TAG = :td
+
+        # TODO: add one_of check for width
+        def initialize(classes: "", attributes: {})
+          @tag = DEFAULT_TAG
+          actual_classes = class_names(DEFAULT_CELL_CLASSES, classes)
+          super(classes: actual_classes, attributes: attributes)
+        end
+      end
+    end
+
+    # This component is part of `TableNavComponent` and should not be
+    # used as a standalone component.
+    class FooterItem < Ariadne::TableNavComponent
+      DEFAULT_FOOTER_CLASSES = "ariadne-border-none ariadne-flex ariadne-items-center ariadne-justify-between ariadne-px-4 ariadne-py-3 sm:ariadne-px-6"
+
+      DEFAULT_RESULT_CLASSES = "ariadne-text-sm ariadne-text-gray-700"
+      renders_one :records_info, lambda { |classes: "", attributes: {}|
+        actual_classes = class_names(DEFAULT_RESULT_CLASSES, classes)
+        Ariadne::BaseComponent.new(tag: :p, classes: actual_classes, attributes: attributes)
+      }
+
+      renders_one :pagination_bar, "Ariadne::TableNavComponent::PaginationBarItem"
+
+      attr_reader :classes, :attributes
+
+      def initialize(classes: "", attributes: {})
+        @classes = class_names(
+          DEFAULT_FOOTER_CLASSES,
+          classes,
+        )
+
+        @attributes = attributes
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes)) do
+          records_info.to_s + pagination_bar.to_s
+        end
+      end
+    end
+
+    # This component is part of `TableNavComponent` and should not be
+    # used as a standalone component.
+    class PaginationBarItem < Ariadne::FooterComponent
+      DEFAULT_PREV_PAGE_CLASSES = "ariadne-relative ariadne-inline-flex ariadne-items-center ariadne-rounded-l-md ariadne-border ariadne-border-gray-300 ariadne-bg-white ariadne-px-2 ariadne-py-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-500 hover:ariadne-bg-gray-50 focus:ariadne-z-20"
+      renders_one :prev_page, lambda { |disabled: false, href:, classes: "", attributes: {}|
+        if disabled
+          actual_classes = class_names(DEFAULT_PREV_PAGE_CLASSES, "ariadne-bg-gray-50", classes)
+
+          render(Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes)) do
+            render(Ariadne::HeroiconComponent.new(icon: "chevron-left", size: :sm, variant: :mini, text_attributes: { "aria-hidden": true }, text_classes: "ariadne-sr-only"))
+          end
+        else
+          actual_classes = class_names(DEFAULT_PREV_PAGE_CLASSES, "hover:ariadne-bg-gray-50", classes)
+          attributes[:"aria-label"] = "previous"
+
+          render(Ariadne::LinkComponent.new(href: href, classes: actual_classes, attributes: attributes)) do
+            render(Ariadne::HeroiconComponent.new(icon: "chevron-left", size: :sm, variant: :mini, text_attributes: { "aria-hidden": true }, text_classes: "ariadne-sr-only"))
+          end
+        end
+      }
+
+      DEFAULT_PAGE_CLASSES = "ariadne-relative ariadne-inline-flex ariadne-items-center ariadne-border ariadne-border-gray-300 ariadne-bg-white ariadne-px-4 ariadne-py-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-500 hover:ariadne-bg-gray-50 focus:ariadne-z-20"
+      DEFAULT_CURRENT_PAGE_CLASSES = "ariadne-relative ariadne-z-10 ariadne-inline-flex ariadne-items-center ariadne-border ariadne-border-indigo-500 ariadne-bg-indigo-50 ariadne-px-4 ariadne-py-2 ariadne-text-sm ariadne-font-medium ariadne-text-indigo-600 focus:ariadne-z-20"
+      DEFAULT_GAP_CLASSES = " ariadne-relative ariadne-inline-flex ariadne-items-center ariadne-border ariadne-border-gray-300 ariadne-bg-white ariadne-px-4 ariadne-py-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-700"
+      renders_many :items, lambda { |link:, classes: "", attributes: {}|
+        page, href = link
+        if page.is_a?(Integer)
+          actual_classes = class_names(DEFAULT_PAGE_CLASSES, classes)
+          render(Ariadne::LinkComponent.new(href: href, classes: actual_classes, attributes: attributes)) { page.to_s }
+        elsif page.is_a?(String)
+          actual_classes = class_names(DEFAULT_CURRENT_PAGE_CLASSES, classes)
+          render(Ariadne::LinkComponent.new(href: href, classes: actual_classes, attributes: attributes)) { page.to_s }
+        elsif page == :gap
+          actual_classes = class_names(DEFAULT_GAP_CLASSES, classes)
+          render(Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes)) { h(href.to_s) }
+        end
+      }
+
+      DEFAULT_NEXT_PAGE_CLASSES = "ariadne-relative ariadne-inline-flex ariadne-items-center ariadne-rounded-r-md ariadne-border ariadne-border-gray-300 ariadne-bg-white ariadne-px-2 ariadne-py-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-500 hover:ariadne-bg-gray-50 focus:ariadne-z-20"
+      renders_one :next_page, lambda { |disabled: false, href:, classes: "", attributes: {}|
+        if disabled
+          actual_classes = class_names(DEFAULT_NEXT_PAGE_CLASSES, "ariadne-bg-gray-50", classes)
+
+          render(Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes)) do
+            render(Ariadne::HeroiconComponent.new(icon: "chevron-right", size: :sm, variant: :mini, text_attributes: { "aria-hidden": true }, text_classes: "ariadne-sr-only"))
+          end
+        else
+          actual_classes = class_names(DEFAULT_NEXT_PAGE_CLASSES, "hover:ariadne-bg-gray-50", classes)
+          attributes[:"aria-label"] = "next"
+
+          render(Ariadne::LinkComponent.new(href: href, classes: actual_classes, attributes: attributes)) do
+            render(Ariadne::HeroiconComponent.new(icon: "chevron-right", size: :sm, variant: :mini, text_attributes: { "aria-hidden": true }, text_classes: "ariadne-sr-only"))
+          end
+        end
+      }
+
+      attr_reader :classes, :attributes
+
+      DEFAULT_PAGINATOR_CLASSES = "ariadne-flex ariadne-items-center ariadne-justify-between ariadne-m-10"
+      def initialize(classes: "", attributes: {})
+        @classes = class_names(
+          DEFAULT_PAGINATOR_CLASSES,
+          classes,
+        )
+
+        @attributes = attributes
+        @attributes[:"aria-label"] ||= "paginator"
+      end
+    end
+  end
+end

data/app/components/ariadne/time_ago_component.rb

@@ -21,7 +21,7 @@ module Ariadne
       @tag = check_incoming_tag(DEFAULT_TAG, tag)
       @classes = class_names(
         DEFAULT_CLASSES,
-        classes
+        classes,
       )
 
       @time = time

data/app/components/ariadne/timeline_component.rb

@@ -25,7 +25,7 @@ module Ariadne
       @tag = check_incoming_tag(DEFAULT_TAG, tag)
       @classes = class_names(
         DEFAULT_CLASSES,
-        classes
+        classes,
       )
 
       @attributes = attributes

data/app/components/ariadne/tooltip_component.html.erb

@@ -1,4 +1,4 @@
 <%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do %>
   <span><%= @text %></span>
-  <span class="tooltip-arrow ariadne-absolute ariadne-block" data-popper-arrow></span>
+  <span class="ariadne-tooltip-arrow ariadne-absolute ariadne-block" data-popper-arrow></span>
 <% end %>

data/app/components/ariadne/tooltip_component.rb

@@ -28,13 +28,13 @@ module Ariadne
     DEFAULT_PLACEMENT = :top
     VALID_PLACEMENTS = [DEFAULT_PLACEMENT, :right, :bottom, :left].freeze
 
-    DEFAULT_CLASSES = "ariadne-invisible ariadne-absolute ariadne-bg-slate-900 ariadne-text-white ariadne-font-semibold ariadne-max-w-xs ariadne-py-1 ariadne-px-2 ariadne-rounded z-max"
+    DEFAULT_CLASSES = "ariadne-invisible ariadne-absolute ariadne-bg-slate-900 ariadne-text-white ariadne-font-semibold ariadne-max-w-xs ariadne-py-1 ariadne-px-2 ariadne-rounded ariadne-z-max"
 
     DATA_CONTROLLER = "tooltip-component"
     DATA_ACTION = "mouseover->tooltip-component#show mouseout->tooltip-component#hide"
 
     TYPE_DEFAULT = :description
-    TYPE_OPTIONS = [:label, TYPE_DEFAULT].freeze
+    VALID_TYPES = [:label, TYPE_DEFAULT].freeze
 
     # DEFAULT_DATA_ATTRIBUTES = {
     #   "data-controller": DATA_CONTROLLER,
@@ -85,7 +85,7 @@ module Ariadne
     # @param tag [Symbol, String] The rendered tag name
     # @param for_id [String] The ID of the element that the tooltip should be attached to.
     # @param text [String] The text content of the tooltip. This should be brief and no longer than a sentence.
-    # @param type [Symbol] <%= one_of(Ariadne::TooltipComponent::TYPE_OPTIONS) %>
+    # @param type [Symbol] <%= one_of(Ariadne::TooltipComponent::VALID_TYPES) %>
     # @param direction [Symbol] <%= one_of(Ariadne::TooltipComponent::VALID_PLACEMENTS) %>
     # @param classes [String] <%= link_to_classes_docs %>
     # @param attributes [Hash] <%= link_to_attributes_docs %>
@@ -101,7 +101,7 @@ module Ariadne
       @attributes[:for] = for_id
 
       @attributes[:"data-tooltip-component-placement"] = fetch_or_raise(VALID_PLACEMENTS, direction)
-      @attributes[:"data-type"] = fetch_or_raise(TYPE_OPTIONS, type)
+      @attributes[:"data-type"] = fetch_or_raise(VALID_TYPES, type)
       @attributes[:"data-tooltip-component-target"] = "tooltip"
     end
   end

data/app/lib/ariadne/action_view_extensions/form_helper.rb

@@ -6,16 +6,30 @@ module Ariadne
     module FormHelper
       include ClassNameHelper
 
-      DEFAULT_FORM_CLASSES = "space-y-8 divide-y divide-gray-200 sm:space-y-5"
-      def ariadne_form_with(model: nil, scope: nil, url: nil, format: nil, classes: {}, attributes: {}, **options, &block)
+      DEFAULT_FORM_CLASSES = "ariadne-space-y-8 ariadne-divide-y ariadne-divide-gray-200 sm:ariadne-space-y-5"
+      def ariadne_form_with(model: nil, scope: nil, url: nil, format: nil, classes: "", attributes: {}, **options, &block)
         options[:class] = class_names(DEFAULT_FORM_CLASSES, options[:class])
         options[:builder] ||= Ariadne::FormBuilder
         options[:html] ||= {}
-        options = options.merge(attributes)
-        data = {
-          controller: "ariadne-form",
-        }
-        form_with(model: model, scope: scope, url: url, format: format, data: data, **options, &block)
+
+        data = options.delete(:data) || {}
+        attributes = attributes.delete_if do |key, value|
+          key_name = key.to_s
+          if key_name.start_with?("data-")
+            data[key_name.sub(/^data-/, "").to_sym] = value
+            true
+          else
+            false
+          end
+        end
+
+        data[:controller] = if data.fetch(:controller, {}).present?
+          "#{data[:controller]} ariadne-form"
+        else
+          "ariadne-form"
+        end
+
+        form_with(model: model, scope: scope, url: url, format: format, data: data, attributes: attributes, **options, &block)
       end
     end
   end

data/app/lib/ariadne/fetch_or_fallback_helper.rb

@@ -22,14 +22,17 @@ module Ariadne
 
     InvalidValueError = Class.new(StandardError)
 
-    TRUE_OR_FALSE = [true, false].freeze
+    TRUE_OR_FALSE = Set.new([true, false]).freeze
 
-    def fetch_or_raise(allowed_values, given_value)
+    INTEGER_TYPES = Set.new(["Integer"]).freeze
+
+    def fetch_or_raise(allowed_values, given_value, against: nil)
       if !allowed_values.is_a?(Array) && !allowed_values.is_a?(Set)
         raise ArgumentError, "allowed_values must be an array or a set; it was #{allowed_values.class}"
       end
 
-      if allowed_values.include?(given_value)
+      check_against_given_value = against || given_value
+      if allowed_values.include?(check_against_given_value)
         given_value
       else
         raise InvalidValueError, <<~MSG
@@ -41,10 +44,15 @@ module Ariadne
       end
     end
 
+    # TODO: use these two more
     def fetch_or_raise_boolean(given_value)
       fetch_or_raise(TRUE_OR_FALSE, given_value)
     end
 
+    def fetch_or_raise_integer(given_value)
+      fetch_or_raise(INTEGER_TYPES, given_value, against: given_value.class.name)
+    end
+
     # TODO: test this
     def check_incoming_tag(preferred_tag, given_tag)
       return preferred_tag if given_tag.blank? || preferred_tag == given_tag

data/app/lib/ariadne/form_builder.rb

@@ -27,7 +27,7 @@ module Ariadne
     end
 
     DEFAULT_LABEL_CLASSES = "ariadne-block ariadne-text-sm ariadne-font-medium ariadne-text-gray-700 ariadne-pl-2"
-    def label(object_name, content, ptions = {}, &block)
+    def label(object_name, content, options = {}, &block)
       options[:class] = class_names(DEFAULT_LABEL_CLASSES, options.delete(:classes))
       super(object_name, content, options, &block)
     end
@@ -39,7 +39,7 @@ module Ariadne
     end
 
     DEFAULT_CHECKBOX_CLASSES = "focus:ariadne-ring-indigo-500 ariadne-h-4 ariadne-w-4 ariadne-text-indigo-600 ariadne-border-gray-300 ariadne-rounded"
-    def check_box(method, options = {}, checked_value = "1", unchecked_value = "0")
+    def check_box(object_name, method, options = {}, checked_value = "1", unchecked_value = "0")
       options[:class] = class_names(DEFAULT_CHECKBOX_CLASSES, options.delete(:classes))
       super(method, options, checked_value, unchecked_value)
     end

data/app/lib/ariadne/icon_helper.rb

@@ -1,18 +1,11 @@
 # frozen_string_literal: true
 
-# Ariadne::FetchOrFallbackHelper
-# A little helper to enable graceful fallbacks
+# Ariadne::IconHelper
+# A helper that insists on certain values when
+# checking herocions and their varients.
 #
-# Use this helper to quietly ensure a value is
-# one that you expect:
-#
-# allowed_values    - allowed options for *value*
-# given_value       - input being coerced
-# fallback          - returned if *given_value* is not included in *allowed_values*
-#
-# fetch_or_raise([1,2,3], 5) => 2
-# fetch_or_raise([1,2,3], 1) => 1
-# fetch_or_raise([1,2,3], nil) => 2
+# Use this helper to loudly ensure a value is
+# one that you expect.
 module Ariadne
   # :nodoc:
   module IconHelper
@@ -23,11 +16,22 @@ module Ariadne
 
       icon_presence!(icon, variant)
       variant_presence!(icon, variant)
-      fetch_or_raise(HeroiconsHelper::Icon::VALID_VARIANTS, variant)
+      ensure_valid_variant(variant)
 
       true
     end
 
+    def ensure_valid_variant(variant)
+      check_variant = if variant.blank? || !variant.respond_to?(:to_s)
+        ""
+      else
+        variant.to_s
+      end
+
+      fetch_or_raise(HeroiconsHelper::Icon::VALID_VARIANTS, check_variant)
+    end
+    module_function :ensure_valid_variant
+
     def has_partial_icon?(icon, variant)
       icon.present? || variant.present?
     end

data/lib/ariadne/view_components/constants.rb

@@ -8,8 +8,8 @@ module Ariadne
     class Constants
       CONSTANTS = JSON.parse(
         File.read(
-          File.join(File.dirname(__FILE__), "../../../static/constants.json")
-        )
+          File.join(File.dirname(__FILE__), "../../../static/constants.json"),
+        ),
       ).freeze
 
       class << self