ariadne_view_components 0.0.43 → 0.0.44

data/app/components/ariadne/blankslate_component.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `Blankslate` when there is a lack of content within a page or section. Use as placeholder to tell users why something isn't there.
+  #
+  # @accessibility
+  #   - The blankslate uses a semantic heading that must be set at the appropriate level based on the hierarchy of the page.
+  #   - All blankslate visuals have been programmed as decorative images, using `aria-hidden=”true”` and `img alt=””`,  which will hide the visual from screen reader users.
+  #   - The blankslate supports a primary and secondary action. Both actions have been built as semantic links with primary and secondary styling.
+  #   - `secondary_action` text should be meaningful out of context and clearly describe the destination. Avoid using vague text like, "Learn more" or "Click here".
+  class BlankslateComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-text-center"
+
+    # Optional visual that renders an <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param icon [String] Name of <%= link_to_heroicons %> to use.
+    # @param size [Symbol] <%= one_of(Ariadne::HeroiconComponent::SIZE_MAPPINGS, sort: false) %>
+    # @param variant [String] <%= one_of(HeroiconsHelper::Icon::VALID_VARIANTS, sort: false) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    renders_one :icon, lambda { |tag: :svg, icon:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, variant: HeroiconsHelper::Icon::VARIANT_SOLID, classes: "", attributes: {}|
+      @icon = icon
+      @variant = variant
+      tag = check_incoming_tag(:svg, tag)
+      Ariadne::HeroiconComponent.new(tag: tag, icon: icon, size: size, variant: variant, classes: classes, attributes: attributes)
+    }
+
+    # Optional visual that renders an <%= link_to_component(Ariadne::ImageComponent) %>.
+    #
+    # @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 %>
+    DEFAULT_IMAGE_SIZE = 56
+    renders_one :image, lambda { |tag: Ariadne::ImageComponent::DEFAULT_TAG, src:, alt:, lazy: false, classes: "", attributes: {}|
+      attributes[:height] = DEFAULT_IMAGE_SIZE
+      attributes[:width] = DEFAULT_IMAGE_SIZE
+
+      Ariadne::ImageComponent.new(tag: tag, src: src, alt: alt, lazy: lazy, classes: classes, attributes: attributes)
+    }
+
+    # Required heading.
+    #
+    # @param tag [Symbol, String]  <%= one_of(Ariadne::HeadingComponent::TAG_OPTIONS) %>
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    DEFAULT_HEADING_CLASSES = "ariadne-text-3xl ariadne-font-extrabold ariadne-tracking-tight ariadne-text-gray-900 sm:ariadne-text-4xl"
+    renders_one :heading, lambda { |tag: :h1, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_HEADING_CLASSES, classes)
+
+      Ariadne::HeadingComponent.new(tag: tag, classes: actual_classes, attributes: attributes)
+    }
+
+    # Optional description.
+    #
+    # - The description should always be informative and actionable.
+    # - Don't use phrases like "You can".
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    renders_one :description, lambda { |tag: :p, classes: "", attributes: {}|
+      actual_tag = check_incoming_tag(:p, tag)
+
+      Ariadne::BaseComponent.new(tag: actual_tag, classes: classes, attributes: attributes)
+    }
+
+    # Optional primary action
+    #
+    # The `primary_action` slot renders an anchor link which is visually styled as a button to provide more emphasis to the
+    # Blankslate's primary action.
+    #
+    # @param href [String] URL to be used for the primary action.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    renders_one :primary_action, lambda { |href: nil, tag: :a, method: nil, size: :md, scheme: :default, classes: "", attributes: {}|
+      attributes[:href] = href
+      attributes[:method] = method
+
+      Ariadne::ButtonComponent.new(
+        tag: tag,
+        type: Ariadne::BaseButton::DEFAULT_TYPE,
+        scheme: scheme,
+        size: size,
+        classes: classes,
+        attributes: attributes,
+      )
+    }
+
+    # Optional secondary action
+    #
+    # The `secondary_action` slot renders a normal anchor link, which can be used to redirect the user to additional information
+    # (e.g. Help documentation).
+    #
+    # @param href [String] URL to be used for the secondary action.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    renders_one :secondary_action, lambda { |href:, classes: "", attributes: {}|
+      attributes[:href] = href
+
+      Ariadne::LinkComponent.new(href: href, classes: classes, attributes: attributes)
+    }
+
+    # @example Basic
+    #   <%= render Ariadne::BlankslateComponent.new do |c| %>
+    #     <% c.with_heading(tag: :h2) { "heading" } %>
+    #     <% c.with_description { "Description"} %>
+    #   <% end %>
+    #
+    # @example Icon
+    #   @description
+    #     Add an `icon` to give additional context. Refer to the [Heroicons](https://heroicons.com) documentation to choose an icon.
+    #   @code
+    #     <%= render Ariadne::BlankslateComponent.new do |c| %>
+    #       <% c.with_icon(icon: :"globe-europe-africa") %>
+    #       <% c.with_heading(tag: :h2) { "heading" } %>
+    #       <% c.with_description { "Description"} %>
+    #     <% end %>
+    #
+    # @example Using an image
+    #   @description
+    #     Add an `image` to give context that an Octicon couldn't.
+    #   @code
+    #     <%= render Ariadne::BlankslateComponent.new do |c| %>
+    #       <% c.with_image(src: "https://github.githubassets.com/images/modules/site/features/security-icon.svg", alt: "Security - secure vault") %>
+    #       <% c.with_heading(tag: :h2){ "heading" } %>
+    #     <% 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
+
+    def render?
+      heading.present?
+    end
+  end
+end

data/app/components/ariadne/body_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 BodyComponent < Ariadne::Component
+    DEFAULT_CLASSES = "ariadne-scroll-smooth ariadne-antialiased"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::BodyComponent.new) { "Example" } %>
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(classes: "", attributes: {})
+      @tag = :body
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) { content }
+    end
+  end
+end

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

@@ -0,0 +1,4 @@
+<%= render Ariadne::BaseButton.new(tag: @tag, type: @type, classes: @classes, attributes: @attributes) do -%>
+  <%= icon %><%= trimmed_content %><%= counter %><%= ariadne_heroicon(icon: :"chevron-down", variant: HeroiconsHelper::Icon::VARIANT_MINI, classes: "ariadne-ml-2 ariadne--mr-1") if dropdown? %>
+  <%= tooltip %>
+<% end -%>

data/app/components/ariadne/button_component.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `Button` for actions (e.g. in forms). Use links for destinations, or moving from one page to another.
+  class ButtonComponent < Ariadne::Component
+    include IconHelper
+
+    DEFAULT_SCHEME = :default
+    LINK_SCHEME = :link
+
+    SCHEME_CLASS_MAPPINGS = {
+      link: Ariadne::LinkComponent::DEFAULT_ACTIONABLE_CLASSES,
+      none: "",
+      default: "ariadne-text-slate-800 ariadne-bg-slate-50 hover:ariadne-bg-slate-100 ariadne-border-slate-300 focus:ariadne-ring-offset-slate-50 focus:ariadne-ring-slate-600",
+      info: "ariadne-text-slate-800 ariadne-bg-slate-50 hover:ariadne-bg-slate-100 ariadne-border-slate-300 focus:ariadne-ring-offset-blue-50 focus:ariadne-ring-slate-600",
+      success: "ariadne-text-green-800 ariadne-bg-green-50 hover:ariadne-bg-green-100 ariadne-border-green-300 focus:ariadne-ring-offset-green-50 focus:ariadne-ring-green-600",
+      warning: "ariadne-text-yellow-800 ariadne-bg-yellow-50 hover:ariadne-bg-yellow-100 ariadne-border-yellow-300 focus:ariadne-ring-offset-yellow-50 focus:ariadne-ring-yellow-600",
+      danger: "ariadne-text-red-800 ariadne-bg-red-50 hover:ariadne-bg-red-100 ariadne-border-red-300 focus:ariadne-ring-offset-red-50 focus:ariadne-ring-red-600",
+    }.freeze
+    VALID_SCHEMES = SCHEME_CLASS_MAPPINGS.keys.freeze
+
+    # Leading visuals appear to the left of the button text.
+    #
+    # Use:
+    #
+    # - `icon` for a <%= link_to_component(Ariadne::HeroiconComponent) %>.
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param icon [String] Name of <%= link_to_heroicons %> to use.
+    # @param variant [String] <%= one_of(HeroiconsHelper::Icon::VALID_VARIANTS, sort: false) %>
+    # @param attributes [Hash] 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)
+                       }
+
+    # Trailing visuals appear to the right of the button text.
+    #
+    # Use:
+    #
+    # - `counter` for a <%= link_to_component(Ariadne::CounterComponent) %>.
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param counter [Number] The starting counter value
+    # @param attributes [Hash] Same arguments as <%= link_to_component(Ariadne::CounterComponent) %>.
+    renders_one :counter, lambda { |tag: :span, count: 0, classes: "", attributes: {}|
+      tag = check_incoming_tag(:span, tag)
+      attributes[:ml] = check_incoming_value(2, ml: attributes[:ml])
+
+      Ariadne::CounterComponent.new(tag: tag, count: count, classes: classes, attributes: attributes)
+    }
+
+    # `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, "Buttons with a tooltip must have a unique `id` set on the `Button`." if @id.blank?
+
+      Ariadne::TooltipComponent.new(for_id: @id, tag: tag, text: text, direction: direction, type: type, classes: classes, attributes: attributes)
+    }
+
+    # @example Schemes
+    #   <%= render(Ariadne::ButtonComponent.new) { "Default" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(scheme: :default)) { "Default" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(scheme: :info)) { "Info" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(scheme: :success)) { "Success" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(scheme: :warning)) { "Warning" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(scheme: :danger)) { "Danger" } %>
+    #
+    # @example Sizes
+    #   <%= render(Ariadne::ButtonComponent.new(size: :sm)) { "Small" } %>
+    #   <%= render(Ariadne::ButtonComponent.new(size: :md)) { "Medium" } %>
+    #
+    # @example With leading visual
+    #   <%= render(Ariadne::ButtonComponent.new) do |c| %>
+    #     <% c.with_icon(icon: :star, variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, classes: "ariadne-text-yellow-600") %>
+    #     Button
+    #   <% end %>
+    #
+    # @example With trailing visual
+    #   <%= render(Ariadne::ButtonComponent.new) do |c| %>
+    #     <% c.with_counter(count: 15) %>
+    #     Button
+    #   <% end %>
+    #
+    # @example With leading and trailing visuals
+    #   <%= render(Ariadne::ButtonComponent.new) do |c| %>
+    #     <% c.with_icon(icon: :star, variant: HeroiconsHelper::Icon::VARIANT_OUTLINE) %>
+    #     <% c.with_counter(count: 15) %>
+    #     Button
+    #   <% end %>
+    #
+    # @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::ButtonComponent.new(attributes: { id: "button-with-tooltip" })) do |c| %>
+    #       <% c.with_tooltip(text: "Tooltip text") %>
+    #       Button
+    #     <% end %>
+    #
+    # @param tag [Symbol]  <%= one_of(Ariadne::BaseButton::TAG_OPTIONS) %>
+    # @param type [Symbol] <%= one_of(Ariadne::BaseButton::VALID_TYPES) %>
+    # @param scheme [Symbol] <%= one_of(Ariadne::ButtonComponent::VALID_SCHEMES) %>
+    # @param size [Symbol] <%= one_of(Ariadne::BaseButton::VALID_SIZES) %>
+    # @param dropdown [Boolean] Whether or not to render a dropdown caret.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(
+      tag: Ariadne::BaseButton::DEFAULT_TAG,
+      type: Ariadne::BaseButton::DEFAULT_TYPE,
+      scheme: DEFAULT_SCHEME,
+      size: BaseButton::DEFAULT_SIZE,
+      dropdown: false,
+      classes: "",
+      attributes: {}
+    )
+      @tag = tag
+      @type = type
+
+      @attributes = attributes
+      @id = @attributes[:id]
+
+      @size = fetch_or_raise(Ariadne::BaseButton::VALID_SIZES, size)
+      @scheme = fetch_or_raise(VALID_SCHEMES, scheme)
+      @scheme = LINK_SCHEME if @tag == :a
+
+      @classes = merge_class_names(
+        SCHEME_CLASS_MAPPINGS[@scheme],
+        classes,
+      )
+
+      @dropdown = dropdown
+    end
+
+    private def dropdown?
+      @dropdown
+    end
+
+    private def trimmed_content
+      return if content.blank?
+
+      trimmed_content = content.strip
+
+      return trimmed_content unless content.html_safe?
+
+      # strip unsets `html_safe`, so we have to set it back again to guarantee that HTML blocks won't break
+      trimmed_content.html_safe # rubocop:disable Rails/OutputSafety
+    end
+
+    private def link?
+      @scheme == LINK_SCHEME
+    end
+  end
+end

data/app/components/ariadne/clipboard_copy_component/clipboard-copy-component.d.ts

@@ -0,0 +1,4 @@
+import { Controller } from '@hotwired/stimulus';
+export default class ClipboardCopyComponent extends Controller {
+    copy(): void;
+}

data/app/components/ariadne/clipboard_copy_component/clipboard-copy-component.js

@@ -0,0 +1,18 @@
+import { Controller } from '@hotwired/stimulus';
+export default class ClipboardCopyComponent extends Controller {
+    copy() {
+        const value = this.element.attributes.getNamedItem('value');
+        const forNode = this.element.attributes.getNamedItem('for');
+        if (value) {
+            navigator.clipboard.writeText(value.value);
+        }
+        else if (forNode) {
+            const node = document.getElementById(forNode.value);
+            navigator.clipboard.writeText((node === null || node === void 0 ? void 0 : node.textContent) || '');
+        }
+        else {
+            // just copy inner text
+            navigator.clipboard.writeText(this.element.textContent || '');
+        }
+    }
+}

data/app/components/ariadne/clipboard_copy_component/clipboard-copy-component.ts

@@ -0,0 +1,19 @@
+import {Controller} from '@hotwired/stimulus'
+
+export default class ClipboardCopyComponent extends Controller {
+  copy() {
+    const value = this.element.attributes.getNamedItem('value')
+
+    const forNode = this.element.attributes.getNamedItem('for')
+
+    if (value) {
+      navigator.clipboard.writeText(value.value)
+    } else if (forNode) {
+      const node = document.getElementById(forNode.value)
+      navigator.clipboard.writeText(node?.textContent || '')
+    } else {
+      // just copy inner text
+      navigator.clipboard.writeText(this.element.textContent || '')
+    }
+  }
+}

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

@@ -0,0 +1,9 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes.merge(controller_data)) do %>
+  <% if content.present? %>
+    <%= content.to_s + tooltip.to_s %>
+  <% else %>
+    <%= render Ariadne::HeroiconComponent.new(icon: :"document-duplicate", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE) %>
+    <!-- TODO: fix, check should replace on click -->
+    <%= render Ariadne::HeroiconComponent.new(icon: :check, variant: HeroiconsHelper::Icon::VARIANT_OUTLINE, classes: "ariadne-text-green-600", attributes: { style: "display: none;" }) %>
+  <% end %>
+<% end %>

data/app/components/ariadne/clipboard_copy_component.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `ClipboardCopyComponent` to copy element text content or input values to the clipboard.
+  #
+  # @accessibility
+  #   Always set an accessible label to help the user interact with the component.
+  class ClipboardCopyComponent < Ariadne::Component
+    DEFAULT_TAG = :"clipboard-copy"
+
+    DEFAULT_CLASSES = LinkComponent::DEFAULT_ACTIONABLE_CLASSES
+
+    DATA_CONTROLLER = "clipboard-copy-component"
+    DATA_ACTION = "click->clipboard-copy-component#copy"
+
+    # `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, "CopyClipboardComponents with a tooltip must have a unique `id` set on the `CopyClipboardComponent`." if @id.blank?
+
+      @data_tooltip_direction = { "data-tooltip-component-direction": direction }
+
+      Ariadne::TooltipComponent.new(tag: tag, for_id: @id, text: text, direction: direction, type: type, classes: classes, attributes: attributes)
+    }
+
+    # @example Default
+    #   <%= render(Ariadne::ClipboardCopyComponent.new(value: "Text to copy", aria_label: "Copy text to the system clipboard" )) %>
+    #
+    # @example With text instead of icons
+    #   <%= render(Ariadne::ClipboardCopyComponent.new(value: "Text to copy", aria_label: "Copy text to the system clipboard" )) do %>
+    #     Click to copy!
+    #   <% end %>
+    #
+    # @example Copying from an element
+    #   <%= render(Ariadne::ClipboardCopyComponent.new(for_id: "blob-path", aria_label: "Copy text to the system clipboard" )) %>
+    #   <div id="blob-path">src/index.js</div>
+    #
+    # @param tag [Symbol, String] The rendered tag name
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param value [String] Text to copy into the users clipboard when they click the component.
+    # @param for_id [String] If `value` is not provided, the element with this id will be copied.
+    # @param aria_label [String] Text for accessibility. Can also be passed in as part of `attributes`, but it must be present.
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, value: "", for_id: nil, aria_label: "", classes: "", attributes: {})
+      @attributes = attributes
+      @value = value
+
+      @attributes[:"aria-label"] = aria_label
+      @attributes[:for] ||= for_id
+      @id = @attributes[:id]
+
+      validate!
+
+      @classes = merge_class_names(DEFAULT_CLASSES, classes)
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @attributes[:value] = value if value.present?
+    end
+
+    private def validate!
+      validate_aria_label!
+      raise ArgumentError, "Must provide either `value` or `for`" if @value.blank? && @attributes[:for].blank?
+      raise ArgumentError, "Must provide only `value` or `for`, not both" if @value.present? && @attributes[:for].present?
+    end
+
+    DATA_CONTROLLERS_WITH_TOOLTIPS = {
+      "data-controller": "#{DATA_CONTROLLER} #{Ariadne::TooltipComponent::DATA_CONTROLLER}",
+      "data-action": "#{DATA_ACTION} #{Ariadne::TooltipComponent::DATA_ACTION}",
+      "data-tooltip-component-target": "trigger",
+    }
+
+    DATA_CONTROLLERS =
+      {
+        "data-controller": DATA_CONTROLLER.to_s,
+        "data-action": DATA_ACTION,
+      }
+
+    def controller_data
+      return DATA_CONTROLLERS_WITH_TOOLTIPS if tooltip.present?
+
+      DATA_CONTROLLERS
+    end
+  end
+end

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

@@ -0,0 +1,37 @@
+<%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do %>
+  <%= render(Ariadne::TabContainerComponent.new(sr_label: @sr_label)) do |tab_container| %>
+    <%= tab_container.with_tab(id: public_tab.id, selected: public_tab.selected, classes: public_tab.classes, attributes: public_tab.attributes) do |tab| %>
+      <% tab.with_text { @public_tab_text } %>
+      <% tab.with_panel(attributes: {:"data-public" => true}) do %>
+        <%= ariadne_form_with(url: @url, method: @method, classes: @classes, attributes: @attributes) do |comment_box| %>
+          <% @hidden_fields.each do |name, value| %>
+            <%= hidden_field_tag name, value %>
+          <% end %>
+          <div class="ariadne-overflow-hidden ariadne-border ariadne-border-slate-300 ariadne-shadow-sm">
+            <%= hidden_field_tag 'message_is_public', true %>
+            <%= render(Ariadne::RichTextAreaComponent.new(name: :message_public_bodytext, sr_label: "Select reply type", attributes: { required: true})) %>
+            <% comment_box.submit { @submit } %>
+          </div>
+          <div class="ariadne-py-2 ariadne-flex ariadne-justify-end">
+            <%= public_submit %>
+          </div>
+        <% end %>
+      <% end %>
+    <% end %>
+    <%= tab_container.with_tab(id: internal_tab.id, selected: internal_tab.selected, classes: internal_tab.classes, attributes: internal_tab.attributes) do |tab| %>
+      <% tab.with_text { @internal_tab_text } %>
+      <% tab.with_panel do %>
+        <%= ariadne_form_with(url: @url, method: @method, classes: @classes, attributes: @attributes) do |comment_box| %>
+          <div class="ariadne-overflow-hidden ariadne-border ariadne-border-gray-300 ariadne-shadow-sm">
+            <%= hidden_field_tag 'message_is_public', false %>
+            <%= render(Ariadne::RichTextAreaComponent.new(name: :message_internal_bodytext, sr_label: "Select reply type", attributes: { required: true})) %>
+            <% comment_box.submit { @submit } %>
+          </div>
+          <div class="ariadne-py-2 ariadne-flex ariadne-justify-end">
+            <%= internal_submit %>
+          </div>
+        <% end %>
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>

data/app/components/ariadne/comment_component.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Defines a submittable form for adding comments to a conversation.
+  #
+  #
+  # @accessibility This component requires you to pass in a `sr_label`
+  # attribute, which will be used to label the tabs for screen readers.
+  class CommentComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "ariadne-border-gray-300 ariadne-border ariadne-shadow ariadne-py-5 ariadne-px-5 ariadne-rounded-md "
+
+    renders_one :public_tab, lambda { |selected: false, text:, classes: "", attributes: {}|
+      attributes[:"data-public"] = true
+      @tab_idx += 1
+      id = attributes.fetch(:id, "public-tab-#{@tab_idx}")
+      @public_tab_text = text
+
+      Ariadne::TabComponent.new(selected: selected, classes: classes, id: id, with_panel: true, attributes: attributes)
+    }
+
+    renders_one :public_submit, lambda { |classes: "", attributes: {}|
+      Ariadne::ButtonComponent.new(type: Ariadne::BaseButton::TYPE_SUBMIT, scheme: Ariadne::ButtonComponent::DEFAULT_SCHEME, classes: classes, attributes: attributes)
+    }
+
+    renders_one :internal_tab, lambda { |selected: false, text:, classes: "", attributes: {}|
+      attributes[:"data-public"] = false
+      @tab_idx += 1
+      id = attributes.fetch(:id, "internal-tab-#{@tab_idx}")
+      @internal_tab_text = text
+
+      Ariadne::TabComponent.new(selected: selected, classes: classes, id: id, with_panel: true, attributes: attributes)
+    }
+
+    renders_one :internal_submit, lambda { |classes: "", attributes: {}|
+      Ariadne::ButtonComponent.new(type: Ariadne::BaseButton::TYPE_SUBMIT, scheme: Ariadne::ButtonComponent::DEFAULT_SCHEME, classes: classes, attributes: attributes)
+    }
+
+    # @example Default
+    #
+    #  <%= render(Ariadne::CommentComponent.new(url: "/messages", method: :post, sr_label: "Select delivery time")) do |comment| %>
+    #    <% comment.with_public_tab(selected: true, text: "Reply to sender") %>
+    #    <% comment.with_public_submit { "Send" } %>
+    #    <% comment.with_internal_tab(text: "Internal comment") %>
+    #    <% comment.with_internal_submit { "Send" } %>
+    #  <% end %>
+    #
+    # @param url [String] The URL to take action against.
+    # @param method [String] The method to use when submitting the form.
+    # @param sr_label [String] A label to introduce these tabs for screen readers.
+    # @param hidden_fields [[String]] An array of arrays of additional (hidden) fields to add to the form.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(url:, method: :post, sr_label:, hidden_fields: [], classes: "", attributes: {})
+      @tag = DEFAULT_TAG
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+      @url = url
+      @method = method
+      @sr_label = sr_label
+
+      @tab_idx = -1
+      @hidden_fields = hidden_fields
+      @attributes = attributes
+    end
+  end
+end