ariadne_view_components 0.0.43 → 0.0.44

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

@@ -0,0 +1,31 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do %>
+  <div class="ariadne-rounded-md ariadne-p-4 <%= BG_SCHEME_CLASS_MAPPINGS[@scheme] %>">
+    <div class="ariadne-flex">
+      <div class="ariadne-flex-shrink-0">
+        <%= icon %>
+      </div>
+      <div class="ariadne-ml-3">
+        <div class="ariadne-mt-2 ariadne-text-sm <%= CONTENT_SCHEME_CLASS_MAPPINGS[@scheme] %>">
+          <p><%= content %></p>
+        </div>
+        <% if has_action? %>
+          <div class="ariadne-mt-4 ariadne-pt-5">
+            <div class="ariadne--mx-2 ariadne--my-1.5 ariadne-flex">
+              <%= action %>
+            </div>
+          </div>
+        <% end %>
+      </div>
+      <% if dismissible? %>
+        <div class="ariadne-pl-3">
+          <div class="ariadne--mx-1.5 ariadne--my-1.5">
+            <button type="button" class="ariadne-inline-flex ariadne-rounded-md ariadne-p-1.5 focus:ariadne-outline-none focus:ariadne-ring-2 focus:ariadne-ring-offset-2 <%= dismissible_classes %>">
+              <span class="ariadne-sr-only">Dismiss</span>
+              <%= ariadne_heroicon icon: :"x-mark", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE %>
+            </button>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  </div>
+<% end %>

data/app/components/ariadne/flash_component.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `FlashComponent` to inform users of successful messages, pending actions, or urgent notices
+  class FlashComponent < Ariadne::Component
+    include IconHelper
+
+    DEFAULT_SCHEME = :default
+
+    DEFAULT_CLASSES = "ariadne-mt-0"
+
+    DISMISSIBLE_SCHEME_CLASS_MAPPINGS = {
+      default: "ariadne-text-slate-500 ariadne-bg-blue-50 hover:ariadne-bg-blue-100 focus:ariadne-ring-offset-blue-50 focus:ariadne-ring-blue-600",
+      info: "ariadne-text-slate-500 ariadne-bg-blue-50 hover:ariadne-bg-blue-100 focus:ariadne-ring-offset-blue-50 focus:ariadne-ring-blue-600",
+      success: "ariadne-text-green-500 ariadne-bg-green-50 hover:ariadne-bg-green-100 focus:ariadne-ring-offset-green-50 focus:ariadne-ring-green-600",
+      warning: "ariadne-text-yellow-500 ariadne-bg-yellow-50 hover:ariadne-bg-yellow-100 focus:ariadne-ring-offset-yellow-50 focus:ariadne-ring-yellow-600",
+      danger: "ariadne-text-red-500 ariadne-bg-red-50 hover:ariadne-bg-red-100 focus:ariadne-ring-offset-red-50 focus:ariadne-ring-red-600",
+    }.freeze
+    VALID_DISMISSIBLE_SCHEMES = DISMISSIBLE_SCHEME_CLASS_MAPPINGS.keys.freeze
+
+    BG_SCHEME_CLASS_MAPPINGS = {
+      default: "ariadne-bg-blue-50",
+      info: "ariadne-bg-blue-50",
+      success: "ariadne-bg-green-50",
+      warning: "ariadne-bg-yellow-50",
+      danger: "ariadne-bg-red-50",
+    }.freeze
+    VALID_BG_SCHEMES = BG_SCHEME_CLASS_MAPPINGS.keys.freeze
+
+    CONTENT_SCHEME_CLASS_MAPPINGS = {
+      default: "ariadne-text-slate-700",
+      info: "ariadne-text-slate-700",
+      success: "ariadne-text-green-700",
+      warning: "ariadne-text-yellow-700",
+      danger: "ariadne-text-red-700",
+    }.freeze
+    VALID_CONTENT_SCHEMES = CONTENT_SCHEME_CLASS_MAPPINGS.keys.freeze
+
+    # Optional visuals appearing to the left of the flash banner.
+    #
+    # Use:
+    #
+    # - `icon` for a <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    #
+    # @option params [Symbol] :icon The rendered tag name
+    # @option params [Symbol] :icon Name of <%= link_to_heroicons %> to use.
+    # @option params [Symbol] :variant <%= one_of(HeroiconsHelper::Icon::VALID_VARIANTS, sort: false) %>
+    # @option params [String] :classes  <%= link_to_classes_docs %>
+    # @option params [Hash] :attributes Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    renders_one :icon, lambda { |tag: :svg, icon:, variant:, classes: "", attributes: {}|
+      @icon = icon
+      @variant = variant
+
+      tag = check_incoming_tag(:svg, tag)
+      Ariadne::HeroiconComponent.new(tag: tag, icon: icon, variant: variant, classes: classes, attributes: attributes)
+    }
+
+    # Optional action content showed at the bottom of the component.
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_one :action, lambda { |tag: :div, classes: "", attributes: {}|
+      tag = check_incoming_tag(:div, tag)
+
+      actual_classes = merge_class_names(classes)
+
+      render(Ariadne::BaseComponent.new(tag: tag, classes: actual_classes, attributes: attributes))
+    }
+
+    # @example Schemes
+    #   <%= render(Ariadne::FlashComponent.new) { "This is a flash message!" } %>
+    #   <%= render(Ariadne::FlashComponent.new(scheme: :warning)) { "This is a warning flash message!" } %>
+    #   <%= render(Ariadne::FlashComponent.new(scheme: :danger)) { "This is a danger flash message!" } %>
+    #   <%= render(Ariadne::FlashComponent.new(scheme: :success)) { "This is a success flash message!" } %>
+    #
+    # @example Dismissible
+    #   <%= render(Ariadne::FlashComponent.new(dismissible: true)) { "This is a dismissible flash message!" } %>
+    #
+    # @example Icon
+    #   <%= render(Ariadne::FlashComponent.new) do |component| %>
+    #     <% component.with_icon(icon: :"user-group", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE) %>
+    #     Look at this icon.
+    #   <% end %>
+    #
+    # @example With actions
+    #   <%= render(Ariadne::FlashComponent.new) do |component| %>
+    #     <% component.with_action do %>
+    #       <%= render(Ariadne::ButtonComponent.new(size: :sm)) { "Take action" } %>
+    #     <% end %>
+    #     This is a flash message with actions!
+    #   <% end %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param dismissible [Boolean] Whether the component can be dismissed with an X button.
+    # @param icon [Symbol, String] Name of <%= link_to_heroicons %> to use.
+    # @param scheme [Symbol] <%= one_of(Ariadne::FlashComponent::VALID_CONTENT_SCHEMES) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: :div, dismissible: false, scheme: DEFAULT_SCHEME, classes: "", attributes: {})
+      @dismissible = dismissible
+
+      @tag = check_incoming_tag(:div, tag)
+
+      @scheme = fetch_or_raise(VALID_CONTENT_SCHEMES, scheme)
+
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        CONTENT_SCHEME_CLASS_MAPPINGS[@scheme],
+        classes,
+      )
+
+      @attributes = attributes
+    end
+    # TODO: test this
+    private def has_action?
+      action.present?
+    end
+    # TODO: test this
+    private def dismissible?
+      @dismissible.present?
+    end
+
+    private def dismissible_classes
+      DISMISSIBLE_SCHEME_CLASS_MAPPINGS[@scheme]
+    end
+  end
+end

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

@@ -0,0 +1,5 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |component| %>
+  <% items.each do |item| %>
+    <%= item %>
+  <% end %>
+<% end %>

data/app/components/ariadne/flex_component.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Adds a flex container to the page.
+  class FlexComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-flex"
+
+    VALID_TYPES = [:row, :column, :row_reverse, :column_reverse].freeze
+
+    # The sub-items(s) to render
+    renders_many :items, lambda { |static_content = nil, &block|
+      next static_content if static_content.present?
+
+      view_context.capture { block&.call }
+    }
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::FlexComponent.new(type: :column)) { "Example" } %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param type [Symbol] <%= one_of(Ariadne::FlexComponent::VALID_TYPES) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, type:, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @type = fetch_or_raise(VALID_TYPES, type)
+
+      flex_class = case @type
+      when :row
+        "ariadne-flex-row"
+      when :column
+        "ariadne-flex-col"
+      when :row_reverse
+        "ariadne-flex-row-reverse"
+      when :column_reverse
+        "ariadne-flex-col-reverse"
+      end
+
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+        flex_class,
+      )
+
+      @attributes = attributes
+    end
+
+    def render?
+      items?
+    end
+  end
+end

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

@@ -0,0 +1,7 @@
+<%= render Ariadne::BaseComponent.new(tag: :footer, classes: @classes, attributes: @attributes) do |footer| %>
+  <%= render Ariadne::ContainerComponent.new do |container| %>
+    <p class="ariadne-mt-6 ariadne-text-sm ariadne-text-slate-500 sm:ariadne-mt-0">
+      <%= content %>
+    </p>
+  <% end %>
+<% end %>

data/app/components/ariadne/footer_component.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Adds a footer to the bottom of every page.
+  class FooterComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-py-5"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::FooterComponent.new) { "Footer." } %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+<%= render Ariadne::BaseComponent.new(tag: :ul, classes: @classes, attributes: @attributes) do |grid| %>
+  <% items.each do |item| %>
+    <li class="<%= item.classes %>">
+      <% if item.link? %>
+        <%= render(item.link) do %>
+          <%= item.entry %>
+        <% end %>
+        <% if item.actions.any? %>
+          <div>
+            <div class="ariadne--mt-px ariadne-flex ariadne-divide-x">
+              <% item.actions.each_with_index do |action, idx| %>
+                <div class="<%= idx.zero? ? '' : 'ariadne--ml-px ' %>w-0 ariadne-flex-1 ariadne-flex">
+                  <%= action %>
+                </div>
+              <% end %>
+            </div>
+          </div>
+        <% end %>
+      <% else %>
+        <div class="ariadne-flex-1 ariadne-flex ariadne-flex-col ariadne-p-8">
+          <%= item.entry %>
+        </div>
+      <% end %>
+    </li>
+  <% end %>
+<% end %>

data/app/components/ariadne/grid_component.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Arranges items as a ariadne-grid.
+  class GridComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-grid ariadne-gap-6 sm:ariadne-grid-cols-2 lg:ariadne-grid-cols-3"
+
+    DEFAULT_LINK_COLOR_CLASSES = "focus:ariadne-outline-none focus:ariadne-ring-2 focus:ariadne-ring-offset-2 focus:ariadne-ring-purple-500"
+
+    # The items to show in the ariadne-grid.
+    renders_many :items, "GridItem"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::GridComponent.new) { "Example" } %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      default_attributes = { role: "list" }
+      @attributes = default_attributes.merge(attributes)
+    end
+
+    # This component is part of `GridComponent` and should not be
+    # used as a standalone component.
+    class GridItem < Ariadne::Component
+      DEFAULT_ITEM_CLASSES = "ariadne-flex ariadne-flex-col ariadne-text-center ariadne-rounded-lg ariadne-shadow text-black-700 ariadne-border-black"
+
+      DEFAULT_ENTRY_CLASSES = "ariadne-group ariadne-flex-1 ariadne-flex ariadne-flex-col ariadne-p-8 hover:ariadne-text-gray-500"
+      renders_one :entry, lambda { |classes: "", attributes: {}, &block|
+        view_context.capture do
+          actual_classes = merge_class_names(DEFAULT_ENTRY_CLASSES, classes)
+          render(Ariadne::BaseComponent.new(tag: :div, classes: actual_classes, attributes: attributes)) { block&.call }
+        end
+      }
+
+      DEFAULT_ACTION_LINK_CLASSES = "ariadne-relative ariadne--mr-px ariadne-w-0 ariadne-flex-1 ariadne-inline-flex ariadne-items-center ariadne-justify-center ariadne-py-4 ariadne-text-sm ariadne-font-medium ariadne-border ariadne-border-transparent"
+      DEFAULT_ACTION_LINK_COLORS = "ariadne-h-full hover:ariadne-text-gray-500"
+      renders_many :actions, lambda { |href:, icon:, label:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, variant: HeroiconsHelper::Icon::VARIANT_SOLID, classes: "", attributes: {}, text_classes: ""|
+        actual_classes = merge_class_names(DEFAULT_ACTION_LINK_CLASSES, DEFAULT_ACTION_LINK_COLORS, classes)
+        render(Ariadne::LinkComponent.new(href: href, classes: actual_classes, attributes: attributes)) do
+          render(Ariadne::HeroiconComponent.new(icon: icon, size: size, variant: variant, text_classes: text_classes)) { label }
+        end
+      }
+
+      renders_one :link, lambda { |href:, classes: "", attributes: {}|
+        Ariadne::LinkComponent.new(href: href, classes: classes, attributes: attributes)
+      }
+
+      attr_reader :classes, :attributes
+
+      def initialize(classes: "", attributes: {})
+        @classes = merge_class_names(DEFAULT_ITEM_CLASSES, classes)
+        @attributes = attributes
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes))
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+ <%= render Ariadne::BaseComponent.new(tag: :header, classes: @classes, attributes: @attributes) do |header| %>
+  <%= render Ariadne::ContainerComponent.new do |container| %>
+    <nav class="ariadne-relative ariadne-z-50 ariadne-flex ariadne-justify-between">
+      <div class="ariadne-flex ariadne-items-center md:ariadne-gap-x-12">
+        <% if has_logo? %>
+          <%= render Ariadne::LinkComponent.new(href: @href, classes: "ariadne-text-billy-purple") do %>
+            <% if has_image_logo? %>
+              <span class="ariadne-sr-only"><%= @text %></span>
+            <% end %>
+            <%= logo %>
+          <% end %>
+        <% end %>
+        <div class="md:ariadne-flex md:ariadne-gap-x-6">
+          <% navigation_links.each do |link| %>
+            <%= link %>
+          <% end %>
+        </div>
+      </div>
+      <div class="ariadne-flex ariadne-items-center ariadne-gap-x-5 md:ariadne-gap-x-8">
+        <div class="md:ariadne-block">
+          <% action_links.each do |link| %>
+            <%= link %>
+          <% end %>
+        </div>
+        <%= signup_link if has_signup_link? %>
+        <%= profile_link if has_profile_link? %>
+      </nav>
+    <% end %>
+  <% end %>

data/app/components/ariadne/header_component.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Represents the top navigation bar on every page.
+  class HeaderComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-sticky ariadne-top-0 ariadne-z-50 ariadne-px-4 ariadne-pt-4 ariadne-h-16 ariadne-shadow-sm shadow-slate-900/5 ariadne-transition ariadne-duration-500"
+    LINK_CLASSES = "ariadne-rounded-lg ariadne-py-1 ariadne-px-2 text-slate-700 hover:bg-slate-100 hover:text-slate-900"
+
+    DEFAULT_TEXT_LOGO_CLASSES = "ariadne-flex ariadne-items-center ariadne-font-bold ariadne-text-xl"
+    DEFAULT_IMAGE_LOGO_CLASSES = "ariadne-h-10 ariadne-w-auto"
+
+    # Leading visuals at the far left of the header. You can pass either
+    # `src` or `as_text` but not both.
+    #
+    # @param href [String] Where the logo should link to.
+    # @param src [String] The URL of the image logo.
+    # @param alt [String] Alt text for accessibility.
+    # @param text [Boolean] The text to display
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_one :logo, lambda { |href: nil, src: nil, alt: nil, text: "", classes: "", attributes: {}|
+      @href = href
+      @text = text
+
+      if src.blank?
+        actual_classes = merge_class_names(DEFAULT_TEXT_LOGO_CLASSES, classes)
+        Ariadne::Text.new(tag: :span, classes: actual_classes, attributes: attributes)
+      else
+        actual_classes = merge_class_names(DEFAULT_IMAGE_LOGO_CLASSES, classes)
+        actual_attributes = { width: 40, height: 40 }.merge(attributes)
+        @image_logo = Ariadne::ImageComponent.new(src: src, alt: alt, classes: actual_classes, attributes: actual_attributes)
+      end
+    }
+
+    # Text within the header, representing navigation.
+    #
+    # @param tag [String, Symbol] The tag to use for the link.
+    # @param href [String] The link destination.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    DEFAULT_NAV_LINK_CLASSES = "ariadne-inline-block ariadne-rounded-lg ariadne-py-1 ariadne-px-2 ariadne-text-sm text-slate-700 hover:bg-slate-100 hover:text-slate-900"
+    renders_many :navigation_links, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_NAV_LINK_CLASSES, classes)
+      Ariadne::LinkComponent.new(tag: tag, href: href, classes: actual_classes, attributes: attributes)
+    }
+
+    # Text within the header, representing actions.
+    #
+    # @param tag [String, Symbol] The tag to use for the link.
+    # @param href [String] The link destination.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_many :action_links, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_NAV_LINK_CLASSES, classes)
+      Ariadne::LinkComponent.new(tag: tag, href: href, classes: actual_classes, attributes: attributes)
+    }
+
+    # Text within the header, representing a signup.
+    #
+    # @param tag [String, Symbol] The tag to use for the link.
+    # @param href [String] The link destination.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    DEFAULT_SIGNUP_LINK_CLASSES = "group ariadne-inline-flex ariadne-items-center ariadne-justify-center ariadne-rounded-full ariadne-py-2 ariadne-px-4 ariadne-text-sm ariadne-font-semibold focus:ariadne-outline-none focus-visible:ariadne-outline-2 focus-visible:outline-offset-2"
+    renders_one :signup_link, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_SIGNUP_LINK_CLASSES, classes)
+      Ariadne::LinkComponent.new(tag: tag, href: href, classes: actual_classes, attributes: attributes)
+    }
+
+    DEFAULT_PROFILE_LINK_CLASSES = "group ariadne-inline-flex ariadne-items-center ariadne-justify-center ariadne-rounded-full ariadne-py-2 ariadne-px-4 ariadne-text-sm ariadne-font-semibold focus:ariadne-outline-none focus-visible:ariadne-outline-2 focus-visible:outline-offset-2"
+    renders_one :profile_link, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_PROFILE_LINK_CLASSES, classes)
+      Ariadne::LinkComponent.new(tag: tag, href: href, classes: actual_classes, attributes: attributes)
+    }
+
+    # @example Basic example
+    #
+    # <%= render(Ariadne::HeaderComponent.new) do |header| %>
+    #    <%= header.logo(text: true) { "GitHub" } %>
+    #    <%= header.navigation_link(href: "#features") { "Features" } %>
+    #    <%= header.login_link(href: "/login") { "Login" } %>
+    # <% end %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+    end
+
+    private def has_logo?
+      logo.present?
+    end
+
+    private def has_image_logo?
+      has_logo? && @image_logo.present?
+    end
+
+    private def has_signup_link?
+      signup_link.present?
+    end
+
+    private def has_profile_link?
+      profile_link.present?
+    end
+  end
+end

data/app/components/ariadne/heading_component.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # `Heading` should be used to communicate page organization and hierarchy.
+  #
+  # - Set tag to one of `:h1`, `:h2`, `:h3`, `:h4`, `:h5`, `:h6` based on what is appropriate for the page context.
+  # - Use `Heading` as the title of a section or sub section.
+  # - Do not use `Heading` for styling alone. For simply styling text, consider using <%= link_to_component(Ariadne::Text) %> with relevant <%= link_to_typography_docs %>
+  #   such as `font_size` and `font_weight`.
+  # - Do not jump heading levels. For instance, do not follow a `<h1>` with an `<h3>`. Heading levels should increase by one in ascending order.
+  #
+  # @accessibility
+  #   While sighted users rely on visual cues such as font size changes to determine what the heading is, assistive technology users rely on programatic cues that can be read out.
+  #   When text on a page is visually implied to be a heading, ensure that it is coded as a heading. Additionally, visually implied heading level and coded heading level should be
+  #   consistent. [See WCAG success criteria: 1.3.1: Info and Relationships](https://www.w3.org/WAI/WCAG21/Understanding/info-and-relationships.html)
+  #
+  #   Headings allow assistive technology users to quickly navigate around a page. Navigation to text that is not meant to be a heading can be a confusing experience.
+  #   <%= link_to_heading_practices %>
+  class HeadingComponent < Ariadne::Component
+    TAG_OPTIONS = [:h1, :h2, :h3, :h4, :h5, :h6].freeze
+
+    TAG_TO_CLASSES = {
+      h1: "ariadne-font-bold ariadne-leading-7 sm:ariadne-text-3xl",
+      h2: "ariadne-text-3xl ariadne-font-extrabold",
+      h3: "ariadne-text-2xl ariadne-font-extrabold",
+    }
+    # @example Default
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h1)) { "H1 Text" } %>
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h2)) { "H2 Text" } %>
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h3)) { "H3 Text" } %>
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h4)) { "H4 Text" } %>
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h5)) { "H5 Text" } %>
+    #   <%= render(Ariadne::HeadingComponent.new(tag: :h6)) { "H6 Text" } %>
+    #
+    # @param tag [String]  <%= one_of(Ariadne::HeadingComponent::TAG_OPTIONS) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: nil, classes: "", attributes: {})
+      @tag = fetch_or_raise(TAG_OPTIONS, tag)
+      @attributes = attributes
+
+      @classes = merge_class_names(*TAG_TO_CLASSES[tag], classes)
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) { content }
+    end
+  end
+end

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

@@ -0,0 +1,4 @@
+<%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do %>
+  <%= @icon.path %>
+<% end %>
+<%= render(Ariadne::BaseComponent.new(tag: :span, classes: @text_classes, attributes: @text_attributes)) { content } if content.present? %>