ariadne_view_components 0.0.10-x86_64-linux

data/app/components/ariadne/header_component.rb

@@ -0,0 +1,114 @@
+# 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-py-5 ariadne-bg-white ariadne-shadow-sm shadow-slate-900/5 ariadne-transition ariadne-duration-500"
+    # ariadne-flex ariadne-flex-wrap ariadne-items-center ariadne-justify-between ariadne-bg-white   dark:ariadne-shadow-none  dark:ariadne-bg-transparent
+    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 as_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, as_text: false, classes: "", attributes: {}|
+      @href = href
+      if as_text.present?
+        actual_classes = class_names(DEFAULT_TEXT_LOGO_CLASSES, classes)
+        @text_logo = Ariadne::Text.new(tag: :span, classes: actual_classes, attributes: attributes)
+      else
+        actual_classes = 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 = 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 = 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:outline-2 focus-visible:outline-offset-2"
+    renders_one :signup_link, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = 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:outline-2 focus-visible:outline-offset-2"
+    renders_one :profile_link, lambda { |tag: Ariadne::LinkComponent::DEFAULT_TAG, href:, classes: "", attributes: {}|
+      actual_classes = 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(as_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 = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @attributes = attributes
+    end
+
+    private def has_logo?
+      logo.present?
+    end
+
+    private def has_text_logo?
+      logo.present? && @text_logo.present?
+    end
+
+    private def has_image_logo?
+      logo.present? && @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 = 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.html.erb

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

data/app/components/ariadne/heroicon_component.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+require "heroicons_helper"
+
+module Ariadne
+  # `Heroicon` renders an <%= link_to_heroicons %> with <%= link_to_attributes_docs %>.
+  # `Heroicon` can also be rendered with the `heroicon` helper.
+  class HeroiconComponent < Ariadne::Component
+    DEFAULT_TEXT_CLASSES = "ariadne-pl-2"
+
+    include IconHelper
+    include HeroiconsHelper
+
+    SIZE_DEFAULT = :sm
+    SIZE_MEDIUM = :md
+    SIZE_LARGE = :lg
+
+    SIZE_MAPPINGS = {
+      SIZE_DEFAULT => 16,
+      SIZE_MEDIUM => 24,
+      SIZE_LARGE => 128,
+    }.freeze
+    SIZE_OPTIONS = SIZE_MAPPINGS.keys
+
+    PRELOADED_ICONS = [
+      { name: "bell",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "check",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "chevron-down",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "clipboard",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "clock",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "information-circle",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "dots-horizontal",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "link",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "lock-closed",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "mail",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "menu",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "pencil",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "plus-sm",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "question-mark-circle",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "search",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "search",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "trash",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+      { name: "x-mark",
+        variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, },
+    ].freeze
+
+    # @example Default
+    #   <%= render(Ariadne::HeroiconComponent.new(icon: :check, variant: HeroiconsHelper::Icon::VARIANT_OUTLINE)) %>
+    #   <%= render(Ariadne::HeroiconComponent.new(icon: :check, variant: HeroiconsHelper::Icon::VARIANT_SOLID)) %>
+    #
+    # @example Medium
+    #   <%= render(Ariadne::HeroiconComponent.new(icon: :"user-group", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, size: :md)) %>
+    #
+    # @example Helper
+    #   <%= ariadne_heroicon(icon: :check, variant: HeroiconsHelper::Icon::VARIANT_OUTLINE) %>
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param icon [Symbol, String] Name of <%= link_to_heroicons %> to use.
+    # @param variant [String] <%= one_of(HeroiconsHelper::Icon::VALID_VARIANTS, sort: false) %>
+    # @param size [Symbol] <%= one_of(Ariadne::HeroiconComponent::SIZE_MAPPINGS, sort: false) %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    # @param text_classes [String] <%= link_to_classes_docs %>
+    # @param text_attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: :svg, icon:, variant:, size: SIZE_DEFAULT, classes: "", attributes: {}, text_classes: "", text_attributes: {})
+      @tag = check_incoming_tag(:svg, tag)
+
+      check_icon_presence!(icon, variant)
+
+      @attributes = attributes
+      @attributes[:aria] ||= {}
+
+      if @attributes[:aria][:label] || @attributes[:"aria-label"]
+        @attributes[:role] = "img"
+      else
+        @attributes[:aria][:hidden] = true
+      end
+
+      # Don't allow sizes under 16px
+      if attributes[:height].present? && attributes[:height].to_i < 16 || attributes[:width].present? && attributes[:width].to_i < 16
+        attributes.delete(:height)
+        attributes.delete(:width)
+      end
+
+      # Filter out classify options to prevent them from becoming invalid html attributes.
+      # Note height and width are both classify options and valid html attributes.
+      attributes = {
+        height: @attributes[:height] || SIZE_MAPPINGS[fetch_or_raise(SIZE_OPTIONS, size)],
+        width: @attributes[:width],
+      }
+
+      @icon = heroicon(icon, variant: variant, **attributes)
+
+      @classes = class_names(
+        @icon.attributes[:class],
+        classes
+      )
+      @attributes.merge!(@icon.attributes.except(:class, :"aria-hidden"))
+
+      @text_classes = class_names(DEFAULT_TEXT_CLASSES, text_classes)
+      @text_attributes = text_attributes
+    end
+
+    class << self
+      def _after_compile
+        HeroiconsHelper::Cache.preload!(PRELOADED_ICONS) do |found, icon|
+          HeroiconComponent.new(icon: icon[:name], variant: icon[:variant]) unless found
+        end
+      end
+    end
+  end
+end

data/app/components/ariadne/image_component.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `Image` to render images.
+  #
+  # @accessibility
+  #   Always provide a meaningful `alt`.
+  class ImageComponent < Ariadne::Component
+    DEFAULT_TAG = :img
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::ImageComponent.new(src: "https://github.com/github.png", alt: "GitHub")) %>
+    #
+    # @example Helper
+    #
+    #   <%= ariadne_image(src: "https://github.com/github.png", alt: "GitHub") %>
+    #
+    # @example Lazy loading
+    #
+    #   <%= render(Ariadne::ImageComponent.new(src: "https://github.com/github.png", alt: "GitHub", lazy: true)) %>
+    #
+    # @example Custom size
+    #
+    #   <%= render(Ariadne::ImageComponent.new(src: "https://github.com/github.png", alt: "GitHub", attributes: { height: 100, width: 100 })) %>
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param src [String] The source url of the image.
+    # @param alt [String] Specifies an alternate text for the image.
+    # @param lazy [Boolean] Whether or not to lazily load the image.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, src:, alt:, lazy: false, classes: "", attributes: {})
+      @attributes = attributes
+
+      @src = src
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = classes
+
+      @attributes[:alt] = alt
+      @attributes[:src] = image_path(@src)
+
+      return unless lazy
+
+      @attributes[:loading] = :lazy
+      @attributes[:decoding] = :async
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes))
+    end
+  end
+end

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

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

data/app/components/ariadne/inline_flex_component.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Represents two items side-by-side. Typically, this will be an icon (of CSS classes, SVG, or a Heroicon icon)
+  # with optional text.
+  #
+  # InlineFlexComponent differs from HeroiconComponent in that it is intended to be
+  # used within (or next to) text, whereas HeroiconComponent is intended to only
+  # present a static list of SVG images (and can be embedded in buttons or shown alone).
+  class InlineFlexComponent < Ariadne::Component
+    DEFAULT_TAG = :span
+    DEFAULT_CLASSES = "ariadne-inline-flex ariadne-items-baseline"
+
+    STATE_OPTIONS = [:closed, :open].freeze
+
+    STATE_OPEN_SVG = <<~MSG
+      <svg viewBox="0 0 24 24" width="12" height="12" class="ariadne-stroke-state-open" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round">
+        <circle cx="12" cy="12" r="10"></circle>
+      </svg>
+    MSG
+    STATE_CLOSED_SVG = <<~MSG
+      <svg viewBox="0 0 24 24" width="12" height="12" class="ariadne-stroke-state-closed fill-state-closed " stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round">
+        <circle cx="12" cy="12" r="10"></circle>
+      </svg>
+    MSG
+
+    DEFAULT_TEXT_OPEN_CLASSES = "ariadne-text-state-open"
+    DEFAULT_TEXT_CLOSED_CLASSES = "ariadne-text-state-closed"
+    DEFAULT_TEXT_CLASSES = "ariadne-pl-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-900"
+    renders_one :icon, lambda { |tag: :svg, icon:, variant:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, classes: "", attributes: {}, text_classes: "", text_attributes: {}|
+      actual_text_classes = class_names(DEFAULT_TEXT_CLASSES, text_classes)
+      Ariadne::HeroiconComponent.new(tag: tag, icon: icon, variant: variant, size: size, classes: classes, attributes: attributes, text_classes: actual_text_classes, text_attributes: text_attributes) { content }
+    }
+
+    renders_one :item, lambda { |classes: "", attributes: {}|
+      Ariadne::BaseComponent.new(tag: :span, classes: classes, attributes: attributes) { content }
+    }
+
+    DEFAULT_LABEL_CLASSES = "ariadne-pl-2 ariadne-text-sm ariadne-font-medium ariadne-text-gray-900"
+    renders_one :text, lambda { |classes: "", attributes: {}|
+      actual_classes = class_names(DEFAULT_LABEL_CLASSES, classes)
+      Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes) { content }
+    }
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
+    #      <% c.item { Ariadne::InlineFlexComponent::STATE_OPEN_SVG.html_safe } %>
+    #   <% end %>
+    #
+    #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
+    #      <% c.icon(icon: :check, size: :sm, variant: HeroiconsHelper::Icon::VARIANT_SOLID) %>
+    #      <% c.text { "Closed" } %>
+    #   <% end %>
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = class_names(DEFAULT_CLASSES, classes)
+      @attributes = attributes
+    end
+  end
+end

data/app/components/ariadne/link_component.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `Link` for navigating from one page to another. `Link` styles anchor tags with default styling and hover text-decoration.
+  class LinkComponent < Ariadne::Component
+    DEFAULT_TAG = :a
+    TAG_OPTIONS = [DEFAULT_TAG, :span].freeze
+
+    DEFAULT_CLASSES = "ariadne-cursor-pointer"
+    DEFAULT_ACTIONABLE_CLASSES = " ariadne-cursor-pointer ariadne-underline ariadne-decoration-double ariadne-font-semibold hover:ariadne-text-button-text-color focus:ariadne-outline-none focus:ariadne-ring-2 focus:ariadne-ring-offset-2 focus:ariadne-ring-purple-500"
+
+    # `Tooltip` that appears on mouse hover or keyboard focus over the button. Use tooltips sparingly and as a last resort.
+    # **Important:** This tooltip defaults to `type: :description`. In a few scenarios, `type: :label` may be more appropriate.
+    # Consult the <%= link_to_component(Ariadne::TooltipComponent) %> documentation for more information.
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param text [String] The text content of the tooltip. This should be brief and no longer than a sentence.
+    # @param direction [Symbol] <%= one_of(Ariadne::TooltipComponent::VALID_PLACEMENTS) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::TooltipComponent) %>.
+    renders_one :tooltip, lambda { |tag: Ariadne::TooltipComponent::DEFAULT_TAG, text:, direction: Ariadne::TooltipComponent::DEFAULT_PLACEMENT, type: Ariadne::TooltipComponent::TYPE_DEFAULT, classes: "", attributes: {}|
+      raise ArgumentError, "Links with a tooltip must have a unique `id` set on the `LinkComponent`." if @id.blank?
+
+      Ariadne::TooltipComponent.new(tag: tag, for_id: @id, text: text, direction: direction, type: type, classes: classes, attributes: attributes)
+    }
+
+    # @example Default
+    #   <%= render(Ariadne::LinkComponent.new(href: "#")) { "Link" } %>
+    #
+    # @example Span as link
+    #   <%= render(Ariadne::LinkComponent.new(tag: :span, href: "#")) { "Span as a link" } %>
+    #
+    # @example With tooltip
+    #   @description
+    #     Use tooltips sparingly and as a last resort. Consult the <%= link_to_component(Ariadne::TooltipComponent) %> documentation for more information.
+    #   @code
+    #     <%= render(Ariadne::LinkComponent.new(href: "#", attributes: { id: "link-with-tooltip" })) do |c| %>
+    #       <% c.tooltip(text: "Tooltip text") %>
+    #       Link
+    #     <% end %>
+    #
+    # @param tag [String]  <%= one_of(Ariadne::LinkComponent::TAG_OPTIONS) %>
+    # @param href [String] URL to be used for the link.
+    # @param actionable [Boolean] If true, adds additional classes to the link to make it more aware.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, href:,  actionable: false, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+
+      @attributes = attributes
+      @attributes[:href] = href
+
+      @id = @attributes[:id]
+
+      @classes = class_names(DEFAULT_CLASSES, classes)
+      @classes << DEFAULT_ACTIONABLE_CLASSES if actionable
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do
+        content.to_s + tooltip.to_s
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |list| %>
+  <% items.each do |item| %>
+    <% if item.linked? %>
+      <%= render Ariadne::BaseComponent.new(tag: :li, classes: item.classes, attributes: item.attributes) do %>
+        <%= render Ariadne::LinkComponent.new(href: item.link[:href], classes: item.link[:classes], attributes: item.link[:attributes]) do %>
+          <%= item.entry %>
+        <% end %>
+      <% end %>
+    <% else %>
+      <%= render Ariadne::BaseComponent.new(tag: :li, classes: item.classes, attributes: item.attributes) do %>
+        <%= item.entry %>
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>

data/app/components/ariadne/list_component.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # `List` is used to show a list of items in a vertical format.
+  class ListComponent < Ariadne::Component
+    DEFAULT_TAG = :ul
+    DEFAULT_UL_CLASSES = "ariadne-divide-y ariadne-divide-gray-300"
+
+    renders_many :items, "ListItem"
+
+    # @example Basic
+    #   <% numbers = [1, 2, 3] %>
+    #   <%= render(Ariadne::ListComponent.new) do |list| %>
+    #     <% numbers.each do |number| %>
+    #       <%= list.item do |item|  %>
+    #         <%= item.entry { number } %>
+    #       <% 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_UL_CLASSES, classes)
+      @attributes = attributes
+    end
+
+    def render?
+      items.any?
+    end
+
+    # This component is part of `ListComponent` and should not be
+    # used as a standalone component.
+    class ListItem < Ariadne::Component
+      DEFAULT_ITEM_CLASSES = "ariadne-relative ariadne-p-1.5 focus:ariadne-ring-2 focus:ariadne-ring-offset-2 focus:ariadne-ring-purple-500 hover:ariadne-bg-button-hover-color"
+
+      renders_one :entry, lambda { |static_content = nil, &block|
+        next static_content if static_content.present?
+
+        render(Ariadne::BaseComponent.new(tag: :div)) do
+          view_context.capture { block&.call }
+        end
+      }
+
+      attr_reader :link, :classes, :attributes
+
+      def initialize(link: {}, classes: "", attributes: {})
+        @link = link
+        @classes = class_names(DEFAULT_ITEM_CLASSES, classes)
+        @attributes = attributes
+      end
+
+      def selected?
+        @selected
+      end
+
+      def linked?
+        @link.present?
+      end
+
+      def call
+        Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes)
+      end
+    end
+  end
+end

data/app/components/ariadne/main_component.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Add a general description of component here
+  # Add additional usage considerations or best practices that may aid the user to use the component correctly.
+  # @accessibility Add any accessibility considerations
+  class MainComponent < Ariadne::Component
+    DEFAULT_CLASSES = "flex-auto"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::MainComponent.new) { "Example" } %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @tag = :main
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @attributes = attributes
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do
+        render(Ariadne::ContainerComponent.new) { content }
+      end
+    end
+  end
+end

data/app/components/ariadne/narrow_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/narrow_container_component.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Add a general description of component here
+  # Add additional usage considerations or best practices that may aid the user to use the component correctly.
+  # @accessibility Add any accessibility considerations
+  class NarrowContainerComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-max-w-7xl ariadne-mx-auto ariadne-py-12 ariadne-px-4 sm:ariadne-px-6 lg:ariadne-py-16 lg:ariadne-px-8"
+
+    # @example Default
+    #   <%= render(Ariadne::NarrowContainerComponent.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/panel_bar_component.html.erb

@@ -0,0 +1,20 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |list| %>
+  <% panels.each_with_index do |panel, idx| %>
+    <%= render Ariadne::BaseComponent.new(tag: :li, classes: panel.classes, attributes: panel.attributes) do %>
+      <%= render Ariadne::BaseComponent.new(tag: :div, classes: Ariadne::PanelBarComponent::PanelItem::DEFAULT_WRAPPER_CLASSES) do %>
+        <span class="ariadne-px-6 ariadne-py-4 ariadne-flex ariadne-items-center ariadne-text-sm ariadne-font-medium">
+          <%= panel.icon %>
+          <span class="ariadne-ml-4 ariadne-text-sm ariadne-font-medium ariadne-text-gray-900"><%= panel.label %></span>
+          <!-- Arrow separator for lg screens and up -->
+          <% if idx + 1 < panels.size %>
+            <div class="md:ariadne-block ariadne-hidden ariadne-absolute ariadne-top-0 ariadne-right-0 ariadne-h-full ariadne-w-5" aria-hidden="true">
+              <svg class="ariadne-h-full ariadne-w-full ariadne-text-gray-300" viewBox="0 0 22 80" fill="none" preserveAspectRatio="none">
+                <path d="M0 -2L20 40L0 82" vector-effect="non-scaling-stroke" stroke="currentcolor" stroke-linejoin="round"></path>
+              </svg>
+            </div>
+          <% end %>
+        </span>
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>