ariadne_view_components 0.0.10-x86_64-linux

data/app/components/ariadne/component.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require "view_component/version"
+
+require "heroicons_helper"
+
+module Ariadne
+  # @private
+  class Component < ViewComponent::Base
+    include ViewComponent::SlotableV2 unless ViewComponent::Base < ViewComponent::SlotableV2
+    include ClassNameHelper
+    include FetchOrFallbackHelper
+    include TestSelectorHelper
+    include JoinStyleArgumentsHelper
+    include ViewHelper
+    include Status::Dsl
+    include Audited::Dsl
+    include LoggerHelper
+    include Ariadne::ActionViewExtensions::FormHelper
+
+    BASE_HTML_CLASSES = "ariadne-h-full scroll-smooth ariadne-bg-white ariadne-antialiased"
+    BASE_BODY_CLASSES = "ariadne-flex ariadne-h-full ariadne-flex-col"
+    BASE_WRAPPER_CLASSES = "ariadne-flex ariadne-flex-col ariadne-h-screen ariadne-justify-between"
+    BASE_MAIN_CLASSES = "ariadne-flex-auto"
+
+    INVALID_ARIA_LABEL_TAGS = [:div, :span, :p].freeze
+
+    private def raise_on_invalid_options?
+      Rails.application.config.ariadne_view_components.raise_on_invalid_options
+    end
+
+    private def raise_on_invalid_aria?
+      Rails.application.config.ariadne_view_components.raise_on_invalid_aria
+    end
+
+    private def deprecated_component_warning(new_class: nil, version: nil)
+      return if silence_deprecations?
+
+      message = "#{self.class.name} is deprecated"
+      message += " and will be removed in v#{version}." if version
+      message += " Use #{new_class.name} instead." if new_class
+
+      ActiveSupport::Deprecation.warn(message)
+    end
+
+    private def aria(val, attributes)
+      attributes[:"aria-#{val}"] || attributes.dig(:aria, val.to_sym)
+    end
+
+    private def validate_aria_label!
+      aria_label = aria("label", @attributes)
+      raise ArgumentError, "`aria-label` is required." if aria_label.blank?
+    end
+
+    private def check_denylist(denylist = [], attributes = {})
+      if should_raise_error?
+
+        # Convert denylist from:
+        # { [:p, :pt] => "message" } to:
+        # { p: "message", pt: "message" }
+        unpacked_denylist =
+          denylist.each_with_object({}) do |(keys, value), memo|
+            keys.each { |key| memo[key] = value }
+          end
+
+        violations = unpacked_denylist.keys & attributes.keys
+
+        if violations.any?
+          message = "Found #{violations.count} #{"violation".pluralize(violations)}:"
+          violations.each do |violation|
+            message += "\n The #{violation} argument is not allowed here. #{unpacked_denylist[violation]}"
+          end
+
+          raise(ArgumentError, message)
+        end
+      end
+
+      attributes
+    end
+
+    private def validate_attributes(tag:, denylist_name: :attributes_denylist, attributes: {})
+      deny_single_argument(:class, "Use `classes` instead.", attributes)
+
+      if (denylist = attributes[denylist_name])
+        check_denylist(denylist, attributes)
+
+        # Remove :attributes_denylist key and any denied keys from system arguments
+        attributes.except!(denylist_name)
+        attributes.except!(*denylist.keys.flatten)
+      end
+
+      deny_aria_label(tag: tag, attributes: attributes)
+
+      attributes
+    end
+
+    private def deny_single_argument(key, help_text, attributes)
+      raise ArgumentError, "`#{key}` is an invalid argument. #{help_text}" \
+        if should_raise_error? && attributes.key?(key)
+
+      attributes.except!(key)
+    end
+
+    private def deny_aria_label(tag:, attributes:)
+      return attributes.except!(:skip_aria_label_check) if attributes[:skip_aria_label_check]
+      return if attributes[:role]
+      return unless INVALID_ARIA_LABEL_TAGS.include?(tag)
+
+      deny_aria_key(
+        :label,
+        "Don't use `aria-label` on `#{tag}` elements. See https://www.tpgi.com/short-note-on-aria-label-aria-labelledby-and-aria-describedby/",
+        attributes
+      )
+    end
+
+    private def deny_aria_key(key, help_text, attributes)
+      raise ArgumentError, help_text if should_raise_aria_error? && aria(key, attributes)
+    end
+
+    private def should_raise_error?
+      raise_on_invalid_options? && !ENV["ARIADNE_WARNINGS_DISABLED"]
+    end
+
+    private def should_raise_aria_error?
+      raise_on_invalid_aria? && !ENV["ARIADNE_WARNINGS_DISABLED"]
+    end
+  end
+end

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

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

data/app/components/ariadne/container_component.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # The container wraps the majority, if not all, of the content on a page.
+  class ContainerComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-px-4 sm:ariadne-px-6 lg:ariadne-px-8"
+
+    # @example Default
+    #   <%= render(Ariadne::ContainerComponent.new) do |container| %>
+    #     <%= render(Ariadne::ButtonComponent.new) { "Click me!" } %>
+    #   <% end %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @tag = :div
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @attributes = attributes
+    end
+  end
+end

data/app/components/ariadne/content.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Ariadne
+  #
+  # Use `Content` as a helper to render content passed to a slot without adding any tags.
+  #
+  class Content < Ariadne::Component
+    def call
+      content
+    end
+  end
+end

data/app/components/ariadne/counter_component.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `CounterComponent` to add a count to navigational elements and buttons.
+  #
+  # @accessibility
+  #   Always use `CounterComponent` with adjacent text that provides supplementary information regarding what the count is for. For instance, `Counter`
+  #   should be accompanied with text such as `issues` or `pull requests`.
+  #
+  class CounterComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-inline-flex ariadne-items-center ariadne-p-1 ariadne-border ariadne-border-transparent ariadne-rounded-full ariadne-shadow-sm focus:ariadne-outline-none focus:ariadne-ring-2 focus:ariadne-ring-offset-2"
+
+    # @example Default
+    #   <%= render(Ariadne::CounterComponent.new(count: 25)) %>
+    #
+    # @example Schemes
+    #   <%= render(Ariadne::CounterComponent.new(count: 25)) %>
+    #   <%= render(Ariadne::CounterComponent.new(count: 25)) %>
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param count [Integer, Float::INFINITY, nil] The number to be displayed (e.x. # of issues, pull requests)
+    # @param limit [Integer, nil] Maximum value to display. Pass `nil` for no limit. (e.x. if `count` == 6,000 and `limit` == 5000, counter will display "5,000+")
+    # @param hide_if_zero [Boolean] If true, a `hidden` attribute is added to the counter if `count` is zero.
+    # @param text [String] Text to display instead of count.
+    # @param round [Boolean] Whether to apply rounding logic to value.
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(
+      tag: :span,
+      count: 0,
+      limit: 9_000,
+      hide_if_zero: false,
+      text: "",
+      round: false,
+      classes: "",
+      attributes: {}
+    )
+      @count = count
+      @limit = limit
+      @hide_if_zero = hide_if_zero
+      @text = text
+      @round = round
+      @attributes = attributes
+
+      @has_limit = !@limit.nil?
+
+      @tag = check_incoming_tag(:span, tag)
+
+      @attributes[:title] = title
+
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+      @attributes[:hidden] = true if count == 0 && hide_if_zero
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) { value }
+    end
+
+    private def title
+      if @text.present?
+        @text
+      elsif @count.nil?
+        "Not available"
+      elsif @count == Float::INFINITY
+        "Infinity"
+      else
+        count = @count.to_i
+        str = number_with_delimiter(@has_limit ? [count, @limit].min : count)
+        str += "+" if @has_limit && count > @limit
+        str
+      end
+    end
+
+    private def value
+      if @text.present?
+        @text
+      elsif @count.nil?
+        "" # CSS will hide it
+      elsif @count == Float::INFINITY
+        "∞"
+      else
+        if @round
+          count = @has_limit ? [@count.to_i, @limit].min : @count.to_i
+          precision = count.between?(100_000, 999_999) ? 0 : 1
+          units = { thousand: "k", million: "m", billion: "b" }
+          str = number_to_human(count, precision: precision, significant: false, units: units, format: "%n%u")
+        else
+          @count = @count.to_i
+          str = number_with_delimiter(@has_limit ? [@count, @limit].min : @count)
+        end
+
+        str += "+" if @has_limit && @count.to_i > @limit
+        str
+      end
+    end
+  end
+end

data/app/components/ariadne/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,125 @@
+# 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
+
+    DISMISSIBLE_SCHEME_CLASS_MAPPINGS = {
+      default: "ariadne-text-blue-500 ariadne-bg-blue-50 hover:ariadne-bg-blue-100 focus:ariadne-ring-offset-blue-50 focus:ariadne-ring-blue-600",
+      info: "ariadne-text-blue-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-blue-700",
+      info: "ariadne-text-blue-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 = class_names(classes)
+
+      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.icon(icon: :"user-group", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE) %>
+    #     Look at this icon.
+    #   <% end %>
+    #
+    # @example With actions
+    #   <%= render(Ariadne::FlashComponent.new) do |component| %>
+    #     <% component.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 = class_names(
+        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.rb

@@ -0,0 +1,49 @@
+# 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 = "flex"
+
+    VALID_TYPES = [:row, :column, :row_reverse, :column_reverse].freeze
+
+    # @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 = class_names(
+        DEFAULT_CLASSES,
+        classes,
+        flex_class
+      )
+
+      @attributes = attributes
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) { content }
+    end
+  end
+end

data/app/components/ariadne/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 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) %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @attributes = attributes
+    end
+  end
+end

data/app/components/ariadne/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 %> <%= item.has_href? ? Ariadne::GridComponent::DEFAULT_LINK_COLOR_CLASSES : "ariadne-bg-white" %>">
+      <% if item.has_href? %>
+        <%= render Ariadne::LinkComponent.new(href: item.href) 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,66 @@
+# 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 = "ariadne-text-button-text-color ariadne-bg-button-bg-color 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 = 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 ariadne-my-4 text-black-700 ariadne-border-black"
+
+      DEFAULT_ENTRY_CLASSES = "group ariadne-flex-1 ariadne-flex ariadne-flex-col ariadne-p-8 hover:ariadne-bg-button-hover-color hover:ariadne-text-gray-500 ariadne-rounded-lg"
+      renders_one :entry, lambda { |classes: "", &block|
+        view_context.capture do
+          render(Ariadne::BaseComponent.new(tag: :div, classes: classes)) { block&.call }
+        end
+      }
+
+      DEFAULT_ACTION_LINK_CLASSES = "text-button-text-color 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 ariadne-rounded-bl-lg ariadne-rounded-lg"
+      renders_many :actions, lambda { |href:, icon:, label:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, variant: HeroiconsHelper::Icon::VARIANT_SOLID, classes: "", attributes: {}, text_classes: ""|
+        actual_classes = class_names(DEFAULT_ACTION_LINK_CLASSES, 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
+      }
+
+      attr_reader :href, :classes, :attributes
+
+      def initialize(href: nil, classes: "", attributes: {})
+        @href = href
+        @classes = class_names(DEFAULT_ITEM_CLASSES, classes)
+        @attributes = attributes
+      end
+
+      def has_href?
+        @href.present?
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes))
+      end
+    end
+  end
+end

data/app/components/ariadne/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"><%= content %></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 %>