ariadne_view_components 0.0.43 → 0.0.44

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

@@ -0,0 +1,47 @@
+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'
+
+export default class RichTextArea extends Controller {
+  static targets = ['editor']
+
+  declare readonly editorTargets: [HTMLDivElement]
+
+  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?.addEventListener('submit', () => {
+          tiptapValueContainer.setAttribute('value', pmEditor.getText() || '')
+          pmEditor.commands.clearContent() // TODO: test this
+        })
+      }
+    }
+  }
+}

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

@@ -0,0 +1,6 @@
+<%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do %>
+  <% if @has_form %>
+    <input type="hidden" data-tiptap-value-container=true name="<%= @name %>" id="<%= @name %>">
+  <% end %>
+  <div class="tiptap-editor" name="rich-text-area" data-rich-text-area-component-target="editor"></div>
+<% end %>

data/app/components/ariadne/rich_text_area_component.rb

@@ -0,0 +1,35 @@
+# 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 RichTextAreaComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    DEFAULT_CLASSES = ""
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::RichTextAreaComponent.new(name: "bodytext", sr_label: "Enter message contents")) { "Example" } %>
+    #
+    # @param name [Symbol] Identifies the form/param name for this rich text area.
+    # @param sr_label [String] A label to introduce these tabs for screen readers.
+    # @param has_form [Boolean] Indicates whether this component is wrapped in a form.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(name:, sr_label:, has_form: true, classes: "", attributes: {})
+      @tag = DEFAULT_TAG
+      @name = name
+      @sr_label = sr_label
+      @has_form = has_form
+
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+      @attributes = attributes
+      @attributes[:"data-controller"] = "rich-text-area-component"
+      @attributes[:"data-has-form"] = true if @has_form
+    end
+  end
+end

data/app/components/ariadne/slideover_component/slideover-component.d.ts

@@ -0,0 +1,9 @@
+import { Controller } from '@hotwired/stimulus';
+export default class SlideoverComponent extends Controller {
+    static targets: string[];
+    readonly expandableTarget: HTMLDivElement;
+    readonly expandWrapperTarget: HTMLDivElement;
+    readonly slidePanelTargets: [HTMLDivElement];
+    readonly buttonWrapperTarget: HTMLDivElement;
+    toggle(): void;
+}

data/app/components/ariadne/slideover_component/slideover-component.js

@@ -0,0 +1,11 @@
+import { Controller } from '@hotwired/stimulus';
+class SlideoverComponent extends Controller {
+    toggle() {
+        this.expandableTarget.classList.toggle('ariadne-hidden');
+        for (const slidePanel of this.slidePanelTargets) {
+            slidePanel.classList.toggle('ariadne-hidden');
+        }
+    }
+}
+SlideoverComponent.targets = ['expandable', 'expandWrapper', 'slidePanel', 'buttonWrapper'];
+export default SlideoverComponent;

data/app/components/ariadne/slideover_component/slideover-component.ts

@@ -0,0 +1,17 @@
+import {Controller} from '@hotwired/stimulus'
+
+export default class SlideoverComponent extends Controller {
+  static targets = ['expandable', 'expandWrapper', 'slidePanel', 'buttonWrapper']
+
+  declare readonly expandableTarget: HTMLDivElement
+  declare readonly expandWrapperTarget: HTMLDivElement
+  declare readonly slidePanelTargets: [HTMLDivElement]
+  declare readonly buttonWrapperTarget: HTMLDivElement
+
+  toggle() {
+    this.expandableTarget.classList.toggle('ariadne-hidden')
+    for (const slidePanel of this.slidePanelTargets) {
+      slidePanel.classList.toggle('ariadne-hidden')
+    }
+  }
+}

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

@@ -0,0 +1,9 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |slideover| %>
+  <div data-slideover-component-target="expandable" class="ariadne-hidden ariadne-px-3">
+    <%= content %>
+  </div>
+  <div data-slideover-component-target="buttonWrapper" class="ariadne-relative ariadne-flex ariadne-justify-center">
+    <%= open_button %>
+    <%= close_button %>
+  </div>
+<% end %>

data/app/components/ariadne/slideover_component.rb

@@ -0,0 +1,66 @@
+# 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 SlideoverComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DIRECTION_Y_DOWN = :yd
+    DIRECTION_X_LEFT = :xl
+    VALID_DIRECTIONS = [DIRECTION_Y_DOWN, DIRECTION_X_LEFT].freeze
+
+    DEFAULT_CLASSES = "ariadne-flex ariadne-flex-col"
+
+    DEFAULT_BUTTON_CLASSES = "ariadne-inline-flex ariadne-items-center ariadne-shadow-sm ariadne-px-4 ariadne-py-1.5 ariadne-pb-2 ariadne-text-sm ariadne-leading-5 ariadne-font-medium ariadne-rounded-full " + Ariadne::ButtonComponent::SCHEME_CLASS_MAPPINGS[:default]
+    renders_one :open_button, lambda { |selected: false, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_BUTTON_CLASSES, classes, selected ? "" : BASE_HIDDEN_CLASS)
+
+      attributes[:id] ||= "btnOpen"
+      attributes[:"data-slideover-component-target"] ||= "slidePanel"
+      attributes[:"data-action"] ||= "click->slideover-component#toggle"
+      attributes[:type] ||= "submit"
+
+      Ariadne::ButtonComponent.new(classes: actual_classes, attributes: attributes)
+    }
+
+    renders_one :close_button, lambda { |selected: false, classes: "", attributes: {}|
+      actual_classes = merge_class_names(DEFAULT_BUTTON_CLASSES, classes, selected ? "" : BASE_HIDDEN_CLASS)
+
+      attributes[:id] ||= "btnClose"
+      attributes[:"data-slideover-component-target"] ||= "slidePanel"
+      attributes[:"data-action"] ||= "click->slideover-component#toggle"
+      attributes[:type] ||= "submit"
+
+      Ariadne::ButtonComponent.new(classes: actual_classes, attributes: attributes)
+    }
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::SlideoverComponent.new(direction: Ariadne::SlideoverComponent::DIRECTION_Y_DOWN)) { "Example" } %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param direction [Symbol] <%= one_of(Ariadne::SlideoverComponent::VALID_DIRECTIONS) %>
+    # @param open_text [String] The text to use to open the slideover.
+    # @param close_text [String] The text to use to close the slideover.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, direction:, open_text: "Open", close_text: "Close", classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @direction = fetch_or_raise(VALID_DIRECTIONS, direction)
+
+      @open_text = open_text
+      @close_text = close_text
+      @attributes = attributes
+      @attributes[:"data-controller"] = "slideover-component"
+      @attributes[:"data-slideover-component-target"] = "expandWrapper"
+    end
+  end
+end

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

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

data/app/components/ariadne/tab_component.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # This component is part of navigation components such as `Ariadne::TabContainerComponent`.
+  # and `Ariadne::TabNavComponent` and should not be used by itself.
+  #
+  # @accessibility
+  #   `TabComponent` renders the selected anchor tab with `aria-current="page"` by default.
+  #    When the selected tab does not correspond to the current page, such as in a nested inner tab, make sure to use aria-current="true"
+  class TabComponent < Ariadne::Component
+    DEFAULT_ARIA_CURRENT_FOR_ANCHOR = :page
+    ARIA_CURRENT_OPTIONS_FOR_ANCHOR = [true, DEFAULT_ARIA_CURRENT_FOR_ANCHOR].freeze
+
+    # Panel controlled by the Tab. This will not render anything in the tab itself.
+    # It will provide a accessor for the Tab's parent to call and render the panel
+    # content in the appropriate place.
+    #
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_one :panel, lambda { |classes: "", attributes: {}|
+      attributes[:id] = @panel_id
+      tag = :div
+      attributes[:role] ||= :tabpanel
+      attributes[:hidden] = true unless @selected
+
+      label_present = aria("label", attributes) || aria("labelledby", attributes)
+      unless label_present
+        if @id.present?
+          attributes[:"aria-labelledby"] = @id
+        else
+          raise ArgumentError, "Panels must be labelled. Either set a unique `id` on the tab, or set an `aria-label` directly on the panel"
+        end
+      end
+
+      Ariadne::BaseComponent.new(tag: tag, classes: classes, attributes: attributes)
+    }
+
+    # The tab's text.
+    #
+    # @param kwargs [Hash] The same arguments as <%= link_to_component(Ariadne::Text) %>.
+    renders_one :text, Ariadne::Text
+    # TODO: test what hapenns with really long inbox names
+
+    attr_reader :selected, :id, :classes, :attributes
+
+    DEFAULT_CLASSES = "ariadne-border-transparent ariadne-text-gray-500 hover:ariadne-text-gray-700 hover:ariadne-border-gray-300 ariadne-whitespace-nowrap ariadne-py-4 ariadne-px-1 ariadne-border-b-2 ariadne-font-medium ariadne-text-sm"
+
+    # @example Default
+    #
+    #  <%= render(Ariadne::TabComponent.new(id: "pub-comment")) do |tab| %>
+    #    <% tab.text { "Public comment" } %>
+    #    <% tab.panel { "Public comment panel" } %>
+    #  <% end %>
+    # @param id [String] The unique ID of the tab.
+    # @param selected [Boolean] Whether the tab is selected or not.
+    # @param with_panel [Boolean] Whether the Tab has an associated panel.
+    # @param href [String] The link to navigate to when the tab is clicked.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(id: nil, selected: false, with_panel: false, href: nil, classes: "", attributes: {})
+      @id = id
+
+      @href = href
+      @selected = selected
+
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+      @attributes[:id] ||= @id
+
+      if with_panel # TODO: test
+        if @id.blank?
+          raise ArgumentError, "Tabs with panels must have a unique `id`"
+        end
+
+        @tag = :button
+        @attributes[:type] = :button
+        @attributes[:role] = :tab
+        @panel_id = "panel-#{@id}"
+        @attributes[:"aria-controls"] = @panel_id
+      else
+        @tag = :a
+      end
+
+      return unless @selected
+
+      if @tag == :a
+        aria_current = aria("current", attributes) || DEFAULT_ARIA_CURRENT_FOR_ANCHOR
+        @attributes[:"aria-current"] = fetch_or_raise(ARIA_CURRENT_OPTIONS_FOR_ANCHOR, aria_current)
+      else
+        @attributes[:"aria-selected"] = true
+      end
+    end
+  end
+end

data/app/components/ariadne/tab_container_component/tab-container-component.d.ts

@@ -0,0 +1 @@
+import '@github/tab-container-element';

data/app/components/ariadne/tab_container_component/tab-container-component.js

@@ -0,0 +1,23 @@
+import '@github/tab-container-element';
+// keep in sync with tab_container_component.rb
+const DEFAULT_SELECTED_CLASSES = ['ariadne-border-slate-500', 'ariadne-text-slate-600'];
+const DEFAULT_UNSELECTED_CLASSES = [
+    'ariadne-text-gray-500',
+    'hover:ariadne-text-gray-700',
+    'hover:ariadne-border-gray-300',
+];
+for (const tabContainer of document.getElementsByTagName('tab-container')) {
+    tabContainer.addEventListener('tab-container-change', function (event) {
+        var _a;
+        const newPanel = event.detail.relatedTarget;
+        const tabContainer = newPanel.closest('tab-container');
+        const tabList = tabContainer.firstElementChild;
+        const currentTab = tabList.querySelector('[aria-selected="true"]');
+        const tabId = (_a = newPanel.getAttribute('id')) === null || _a === void 0 ? void 0 : _a.split('-').slice(1).join('-');
+        const newTab = tabList.querySelector(`#${tabId}`);
+        currentTab.classList.remove(...DEFAULT_SELECTED_CLASSES);
+        currentTab.classList.add(...DEFAULT_UNSELECTED_CLASSES);
+        newTab.classList.add(...DEFAULT_SELECTED_CLASSES);
+        newTab.classList.remove(...DEFAULT_UNSELECTED_CLASSES);
+    });
+}

data/app/components/ariadne/tab_container_component/tab-container-component.ts

@@ -0,0 +1,24 @@
+import '@github/tab-container-element'
+
+// keep in sync with tab_container_component.rb
+const DEFAULT_SELECTED_CLASSES: string[] = ['ariadne-border-slate-500', 'ariadne-text-slate-600']
+const DEFAULT_UNSELECTED_CLASSES: string[] = [
+  'ariadne-text-gray-500',
+  'hover:ariadne-text-gray-700',
+  'hover:ariadne-border-gray-300',
+]
+
+for (const tabContainer of document.getElementsByTagName('tab-container')) {
+  tabContainer.addEventListener('tab-container-change', function (event: Event) {
+    const newPanel = (event as CustomEvent).detail.relatedTarget as HTMLElement
+    const tabContainer = newPanel.closest('tab-container') as HTMLElement
+    const tabList = tabContainer.firstElementChild as HTMLElement
+    const currentTab = tabList.querySelector('[aria-selected="true"]') as HTMLElement
+    const tabId = newPanel.getAttribute('id')?.split('-').slice(1).join('-')
+    const newTab = tabList.querySelector(`#${tabId}`) as HTMLElement
+    currentTab.classList.remove(...DEFAULT_SELECTED_CLASSES)
+    currentTab.classList.add(...DEFAULT_UNSELECTED_CLASSES)
+    newTab.classList.add(...DEFAULT_SELECTED_CLASSES)
+    newTab.classList.remove(...DEFAULT_UNSELECTED_CLASSES)
+  })
+}

data/app/components/ariadne/tab_container_component.erb

@@ -0,0 +1,10 @@
+<%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do  |component| %>
+  <div role="tablist">
+    <% tabs.each do |tab| %>
+      <%= tab %>
+    <% end %>
+  </div>
+  <% tabs.each do |tab| %>
+    <%= tab.panel %>
+  <% end %>
+<% end %>

data/app/components/ariadne/tab_container_component.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # A container for a row of tags. Keyboard support is provided.
+  # @accessibility This component requires you to pass in a `sr_label`
+  # attribute, which will be used to label the tabs for screen readers.
+  class TabContainerComponent < Ariadne::Component
+    DEFAULT_TAG = :"tab-container"
+
+    DEFAULT_CLASSES = ""
+
+    DEFAULT_SELECTED_CLASSES = "ariadne-border-slate-500 ariadne-text-slate-600"
+    DEFAULT_UNSELECTED_CLASSES = "ariadne-text-gray-500 hover:ariadne-text-gray-700 hover:ariadne-border-gray-300"
+
+    # Tabs and panels to be rendered.
+    #
+    # @param id [String] The unique ID of the tab.
+    # @param selected [Boolean] Whether the tab is selected.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_many :tabs, lambda { |id: "", selected: false, classes: "", attributes: {}|
+      actual_classes = merge_class_names(selected ? DEFAULT_SELECTED_CLASSES : DEFAULT_UNSELECTED_CLASSES, classes)
+
+      Ariadne::TabComponent.new(
+        id: id,
+        selected: selected,
+        with_panel: true,
+
+        classes: actual_classes,
+        attributes: attributes,
+      )
+    }
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::TabContainerComponent.new(sr_label: "Comments")) do |tab_container| %>
+    #     <%= render(Ariadne::TabComponent.new(id: "pub-comment")) do |tab| %>
+    #       <% tab.with_text { "Tab 1" } %>
+    #       <% tab.with_panel { "Panel 1" } %>
+    #     <% end %>
+    #     <%= render(Ariadne::TabComponent.new(id: "pub-comment")) do |tab| %>
+    #       <% tab.with_text { "Tab 2" } %>
+    #       <% tab.with_panel { "Panel 2" } %>
+    #     <% end %>
+    #   <% end %>
+    #
+    # %>
+    #
+    # @param sr_label [String] Sets an `aria-label` that helps assistive technology users understand the purpose of the tabs.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(sr_label:, classes: "", attributes: {})
+      @tag = DEFAULT_TAG
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+      @attributes[:"aria-label"] = sr_label
+      @attributes[:role] = :presentation
+    end
+
+    def render?
+      tabs?
+    end
+  end
+end

data/app/components/ariadne/tab_nav_component/tab-nav-component.d.ts

@@ -0,0 +1,9 @@
+import { Controller } from '@hotwired/stimulus';
+export default class TabNavComponent extends Controller {
+    static targets: string[];
+    readonly tabTargets: [HTMLAnchorElement];
+    SELECTED_CLASSES: string[];
+    UNSELECTED_CLASSES: string[];
+    connect(): void;
+    toggle(event: Event): void;
+}

data/app/components/ariadne/tab_nav_component/tab-nav-component.js

@@ -0,0 +1,33 @@
+import { Controller } from '@hotwired/stimulus';
+class TabNavComponent extends Controller {
+    constructor() {
+        super(...arguments);
+        // keep in synch with tab_nav_component
+        this.SELECTED_CLASSES = ['ariadne-border-slate-500', 'ariadne-text-slate-600'];
+        this.UNSELECTED_CLASSES = ['ariadne-text-gray-500', 'hover:ariadne-text-gray-700', 'hover:ariadne-border-gray-300'];
+    }
+    connect() {
+        for (const tab of this.tabTargets) {
+            if (tab.hasAttribute('aria-current')) {
+                tab.classList.add(...this.SELECTED_CLASSES);
+                tab.classList.remove(...this.UNSELECTED_CLASSES);
+            }
+        }
+    }
+    toggle(event) {
+        for (const tab of this.tabTargets) {
+            if (tab === event.target) {
+                tab.setAttribute('aria-current', 'page');
+                tab.classList.add(...this.SELECTED_CLASSES);
+                tab.classList.remove(...this.UNSELECTED_CLASSES);
+            }
+            else if (tab.hasAttribute('aria-current')) {
+                tab.removeAttribute('aria-current');
+                tab.classList.add(...this.UNSELECTED_CLASSES);
+                tab.classList.remove(...this.SELECTED_CLASSES);
+            }
+        }
+    }
+}
+TabNavComponent.targets = ['tab'];
+export default TabNavComponent;

data/app/components/ariadne/tab_nav_component/tab-nav-component.ts

@@ -0,0 +1,34 @@
+import {Controller} from '@hotwired/stimulus'
+
+export default class TabNavComponent extends Controller {
+  static targets = ['tab']
+
+  declare readonly tabTargets: [HTMLAnchorElement]
+
+  // keep in synch with tab_nav_component
+  SELECTED_CLASSES = ['ariadne-border-slate-500', 'ariadne-text-slate-600']
+  UNSELECTED_CLASSES = ['ariadne-text-gray-500', 'hover:ariadne-text-gray-700', 'hover:ariadne-border-gray-300']
+
+  connect() {
+    for (const tab of this.tabTargets) {
+      if (tab.hasAttribute('aria-current')) {
+        tab.classList.add(...this.SELECTED_CLASSES)
+        tab.classList.remove(...this.UNSELECTED_CLASSES)
+      }
+    }
+  }
+
+  toggle(event: Event) {
+    for (const tab of this.tabTargets) {
+      if (tab === event.target) {
+        tab.setAttribute('aria-current', 'page')
+        tab.classList.add(...this.SELECTED_CLASSES)
+        tab.classList.remove(...this.UNSELECTED_CLASSES)
+      } else if (tab.hasAttribute('aria-current')) {
+        tab.removeAttribute('aria-current')
+        tab.classList.add(...this.UNSELECTED_CLASSES)
+        tab.classList.remove(...this.SELECTED_CLASSES)
+      }
+    }
+  }
+}

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

@@ -0,0 +1,7 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |component| %>
+  <ul class="ariadne-list-none">
+    <% tabs.each do |tab| %>
+      <li class="ariadne-inline-flex"><%= tab %></li>
+    <% end %>
+  </ul>
+<% end %>

data/app/components/ariadne/tab_nav_component.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Use `TabNavComponent` to style navigation links, typically placed at the top
+  # of the page.
+  #
+  # For panel navigation, use <%= link_to_component(Ariadne::TabContainerComponent) %> instead.
+  #
+  # @accessibility
+  #   - By default, `TabNavComponent` renders links within a `<nav>` element. `<nav>` has an
+  #     implicit landmark role of `navigation` which should be reserved for main links.
+  #     For all other set of links, set tag to `:div`.
+  #   - See <%= link_to_component(Ariadne::TabComponent) %> for additional
+  #     accessibility considerations.
+  class TabNavComponent < Ariadne::Component
+    DEFAULT_TAG = :nav
+    TAG_OPTIONS = [DEFAULT_TAG, :div].freeze
+
+    BODY_TAG_DEFAULT = :ul
+
+    # keep this consistent with tab-container-component.ts
+    SELECTED_CLASSES = "ariadne-border-slate-600 ariadne-text-slate-700"
+    UNSELECTED_CLASSES = "ariadne-text-slate-500 hover:ariadne-text-slate-700 hover:ariadne-border-slate-700"
+
+    DEFAULT_CLASSES = ""
+
+    # Tabs to be rendered. Use the tabs to list page links.
+    #
+    # @param selected [Boolean] Whether the tab is selected.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    renders_many :tabs, lambda { |selected: false, href: nil, classes: "", attributes: {}|
+      attributes[:href] = href
+      attributes[:"data-tab-nav-component-target"] = "tab"
+      attributes[:"data-action"] = "click->tab-nav-component#toggle"
+
+      actual_classes = merge_class_names(selected ? SELECTED_CLASSES : UNSELECTED_CLASSES, classes)
+      Ariadne::TabComponent.new(
+        selected: selected,
+
+        classes: actual_classes,
+        attributes: attributes,
+      )
+    }
+
+    # @example Default with `<nav>`
+    #   @description
+    #     `<nav>` is a landmark and should be reserved for main navigation links. See <%= link_to_accessibility %>.
+    #   @code
+    #     <%= render(Ariadne::TabNavComponent.new(label: "Nav")) do |c| %>
+    #       <% c.with_tab(selected: true, href: "#") { "Tab 1" } %>
+    #       <% c.with_tab(href: "#") { "Tab 2" } %>
+    #       <% c.with_tab(href: "#") { "Tab 3" } %>
+    #     <% end %>
+    #
+    # @param label [String] Sets an `aria-label` that helps assistive technology users understand the purpose of the links, and distinguish it from similar elements.
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param classes [String] <%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(label:, tag: DEFAULT_TAG, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = merge_class_names(
+        DEFAULT_CLASSES,
+        classes,
+      )
+
+      @attributes = attributes
+      @attributes[:"aria-label"] = label
+      @attributes[:"data-controller"] = "tab-nav-component"
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+<div class="ariadne-inline-block ariadne-min-w-full ariadne-align-middle md:ariadne-px-6 lg:ariadne-px-8">
+  <div class="ariadne-overflow-hidden ariadne-shadow ariadne-ring-1 ariadne-ring-black ariadne-ring-opacity-5 md:ariadne-rounded-lg">
+    <%= render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) do |table| %>
+      <% if has_header_row? %>
+        <thead>
+          <%= render(Ariadne::BaseComponent.new(tag: :tr, classes: header_row.classes, attributes: header_row.attributes)) do %>
+            <%= header_row.selection_cell %>
+            <%= header_row.main_cell %>
+            <% header_row.action_cells.each_with_index do |action_cell, idx| %>
+              <% if idx.zero? %>
+                <%= action_cell %>
+              <% elsif idx == header_row.action_cells.size - 1 %>
+                <%= action_cell %>
+              <% else %>
+                <%= action_cell %>
+              <% end %>
+            <% end %>
+          <% end %>
+        </thead>
+      <% end %>
+      <tbody>
+        <% rows.each do |row| %>
+          <%= render(Ariadne::BaseComponent.new(tag: :tr, classes: row.classes, attributes: row.attributes)) do %>
+            <%= row.selection_cell %>
+            <%= row.main_cell %>
+            <% row.metadata_cells.each_with_index do |metadata_cell, idx| %>
+              <% if idx.zero? %>
+                <%= metadata_cell %>
+              <% elsif idx == row.metadata_cells.size - 1 %>
+                <%= metadata_cell %>
+              <% else %>
+                <%= metadata_cell %>
+              <% end %>
+            <% end %>
+          <% end %>
+        <% end %>
+      </tbody>
+    <% end %>
+  </div>
+  <% if has_footer? %>
+    <%= render(Ariadne::BaseComponent.new(tag: :div, classes: footer.classes, attributes: footer.attributes)) do %>
+      <%= footer.records_info %>
+      <%= render(Ariadne::BaseComponent.new(tag: :nav, classes: footer.pagination_bar.classes, attributes: footer.pagination_bar.attributes)) do %>
+        <%= footer.pagination_bar.prev_page %>
+        <% footer.pagination_bar.items.each do |item| %>
+          <%= item %>
+        <% end %>
+        <%= footer.pagination_bar.next_page %>
+      <% end %>
+    <% end %>
+  <% end %>
+</div>