ariadne_view_components 0.0.43 → 0.0.44

data/app/components/ariadne/heroicon_component.rb

@@ -0,0 +1,166 @@
+# 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_XSMALL = :xs
+    SIZE_SMALL = :sm
+    SIZE_DEFAULT = :md
+    SIZE_LARGE = :lg
+
+    SIZE_MAPPINGS = {
+      SIZE_XSMALL => 16,
+      SIZE_SMALL => 20,
+      SIZE_DEFAULT => 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 = merge_class_names(
+        @icon.attributes[:class],
+        classes,
+      )
+      @attributes.merge!(@icon.attributes.except(:class, :"aria-hidden"))
+
+      @text_classes = merge_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] = @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/inline_flex_component.html.erb

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

data/app/components/ariadne/inline_flex_component.rb

@@ -0,0 +1,72 @@
+# 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 ariadne-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"
+    renders_one :icon, lambda { |tag: :svg, icon:, variant:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, classes: "", attributes: {}, text_classes: "", text_attributes: {}|
+      actual_text_classes = merge_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"
+    renders_one :text, lambda { |classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_LABEL_CLASSES, classes)
+      Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes) { content }
+    }
+
+    renders_one :dropdown, "Ariadne::DropdownComponent"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
+    #      <% c.with_item { Ariadne::InlineFlexComponent::STATE_OPEN_SVG.html_safe } %>
+    #   <% end %>
+    #
+    #   # TODO: STATE_CLOSED_SVG colors didn't show until it was listed in an example
+    #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
+    #      <% c.with_item { Ariadne::InlineFlexComponent::STATE_CLOSED_SVG.html_safe } %>
+    #   <% end %>
+    #
+    #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
+    #      <% c.with_icon(icon: :check, size: :sm, variant: HeroiconsHelper::Icon::VARIANT_SOLID) %>
+    #      <% c.with_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 = merge_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 hover:ariadne-text-button-text-color focus:ariadne-outline-none focus:ariadne-ring-2 focus:ariadne-ring-offset-2 focus:ariadne-ring-purple-500"
+    DEFAULT_ACTIONABLE_CLASSES = "ariadne-cursor-pointer ariadne-font-semibold ariadne-underline ariadne-decoration-double"
+
+    # `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.with_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 = merge_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/list_component.html.erb

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

data/app/components/ariadne/list_component.rb

@@ -0,0 +1,70 @@
+# 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.with_item do |item|  %>
+    #         <%= 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 = merge_class_names(DEFAULT_UL_CLASSES, classes)
+      @attributes = attributes
+    end
+
+    def render?
+      items?
+    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"
+
+      attr_reader :link, :classes, :attributes
+
+      def initialize(link: {}, classes: "", attributes: {})
+        @link = link
+        @classes = merge_class_names(DEFAULT_ITEM_CLASSES, classes)
+        @attributes = attributes
+      end
+
+      def selected?
+        @selected
+      end
+
+      private def linked?
+        @link.present?
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: :li, classes: @classes, attributes: @attributes)) do
+          if linked?
+            classes = @link[:classes] || ""
+            attributes = @link[:attributes] || {}
+            render(Ariadne::LinkComponent.new(href: @link[:href], classes: classes, attributes: attributes)) do
+              content
+            end
+          else
+            content
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/ariadne/narrow_container_component/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 = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+    end
+  end
+end

data/app/components/ariadne/panel_bar_component/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>
+          <!-- TODO: fix this -->
+          <% 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 %>

data/app/components/ariadne/panel_bar_component.rb

@@ -0,0 +1,80 @@
+# 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 PanelBarComponent < Ariadne::Component
+    DEFAULT_TAG = :ol
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-border ariadne-border-gray-300 ariadne-rounded-md ariadne-divide-y ariadne-divide-gray-300 md:ariadne-flex md:ariadne-divide-y-0"
+
+    renders_many :panels, "PanelItem"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::PanelBarComponent.new) { "Example" } %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @tag = DEFAULT_TAG
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+      @attributes[:role] ||= "list"
+    end
+
+    # def render?
+    #   items.any?
+    # end
+
+    # This component is part of `PanelBarComponent` and should not be
+    # used as a standalone component.
+    class PanelItem < Ariadne::Component
+      DEFAULT_ITEM_CLASSES = "ariadne-relative md:ariadne-flex-1 md:ariadne-flex"
+      DEFAULT_WRAPPER_CLASSES = "group ariadne-flex ariadne-items-center ariadne-w-full"
+
+      # TODO: fix this
+      renders_one :icon, lambda { |static_content = nil, &block|
+        next static_content if static_content.present?
+
+        view_context.capture { block&.call }
+      }
+
+      renders_one :label, lambda { |static_content = nil, &block|
+        next static_content if static_content.present?
+
+        view_context.capture { block&.call }
+      }
+
+      attr_reader :link, :classes, :attributes
+
+      def initialize(link: {}, classes: "", attributes: {})
+        @link = link
+        if @link.present?
+          @link["classes"] = merge_class_names(DEFAULT_WRAPPER_CLASSES, @link["classes"])
+        end
+        @classes = merge_class_names(DEFAULT_ITEM_CLASSES, classes)
+        @attributes = attributes
+      end
+
+      def selected?
+        @selected
+      end
+
+      def linked?
+        @link.present?
+      end
+
+      def call
+        render(Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes))
+      end
+    end
+  end
+end

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

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

data/app/components/ariadne/pill_component.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Creates a ariadne-rounded label that resembles a medicine pill.
+  class PillComponent < Ariadne::Component
+    DEFAULT_TAG = :span
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-flex-shrink-0 ariadne-inline-block ariadne-px-2 ariadne-py-1 ariadne-text-xs ariadne-font-medium ariadne-rounded-full ariadne-whitespace-nowrap"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::PillComponent.new(color: [49, 186, 115, 1.0])) { "Admin" } %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param color [String] The rgba color of the pill.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, color:, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+
+      @red = color[0]
+      @green = color[1]
+      @blue = color[2]
+      @alpha = color[3]
+
+      @attributes = attributes
+      @attributes["style"] = "background-color: rgba(#{@red}, #{@green}, #{@blue}, #{@alpha});"
+      @text_color = contrast_of(@red, @green, @blue)
+
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+        @text_color,
+      )
+    end
+
+    private def contrast_of(red, green, blue)
+      luminance = (0.299 * red + 0.587 * green + 0.114 * blue) / 255
+
+      luminance > 0.5 ? "ariadne-text-black" : "ariadne-text-white"
+    end
+  end
+end

data/app/components/ariadne/rich_text_area_component/rich-text-area-component.d.ts

@@ -0,0 +1,6 @@
+import { Controller } from '@hotwired/stimulus';
+export default class RichTextArea extends Controller {
+    static targets: string[];
+    readonly editorTargets: [HTMLDivElement];
+    connect(): void;
+}

data/app/components/ariadne/rich_text_area_component/rich-text-area-component.js

@@ -0,0 +1,38 @@
+import { Controller } from '@hotwired/stimulus';
+import { Editor } from '@tiptap/core';
+import { Document } from '@tiptap/extension-document';
+import { Paragraph } from '@tiptap/extension-paragraph';
+import { Text } from '@tiptap/extension-text';
+import DropCursor from '@tiptap/extension-dropcursor';
+import GapCursor from '@tiptap/extension-gapcursor';
+import { History } from '@tiptap/extension-history';
+class RichTextArea extends Controller {
+    connect() {
+        for (const editorElement of this.editorTargets) {
+            const pmEditor = new Editor({
+                extensions: [DropCursor, GapCursor, History, Document, Paragraph, Text],
+                content: '',
+                injectCSS: false,
+                element: editorElement,
+                editorProps: {
+                    attributes: {
+                        class: 'ariadne-h-28 ariadne-max-h-48 ariadne-p-2 ariadne-rounded-lg ariadne-overflow-y-auto focus:ariadne-outline-none',
+                    },
+                },
+                parseOptions: {
+                    preserveWhitespace: true,
+                },
+            });
+            const tiptapValueContainer = editorElement.previousElementSibling;
+            if (tiptapValueContainer) {
+                const parentForm = editorElement.closest('form');
+                parentForm === null || parentForm === void 0 ? void 0 : parentForm.addEventListener('submit', () => {
+                    tiptapValueContainer.setAttribute('value', pmEditor.getText() || '');
+                    pmEditor.commands.clearContent(); // TODO: test this
+                });
+            }
+        }
+    }
+}
+RichTextArea.targets = ['editor'];
+export default RichTextArea;