ariadne_view_components 0.0.3 → 0.0.6

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 = "cursor-pointer"
+    DEFAULT_ACTIONABLE_CLASSES = " cursor-pointer underline decoration-double font-semibold hover:text-button-text-color focus:outline-none focus:ring-2 focus:ring-offset-2 focus: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,67 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # `List` is used to show a list of items in a vertical format.
+  class ListComponent < Ariadne::Component
+    DEFAULT_UL_CLASSES = "divide-y divide-gray-300"
+
+    renders_many :items, "Item"
+
+    # @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 = :ul
+      @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 Item < Ariadne::Component
+      DEFAULT_ITEM_CLASSES = "relative p-1.5 focus:ring-2 focus:ring-offset-2 focus:ring-purple-500 hover: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/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,30 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Creates a rounded label that resembles a medicine pill.
+  class PillComponent < Ariadne::Component
+    DEFAULT_TAG = :span
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "flex-shrink-0 inline-block px-2 py-0.5 text-xs font-medium rounded-full"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::PillComponent.new(color: "FF0000")) { "Admin" } %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param color [String] The hex 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)
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @attributes = attributes
+      @attributes["style"] = "background-color: ##{color};"
+    end
+  end
+end

data/app/components/ariadne/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.js

@@ -0,0 +1,20 @@
+import { Controller } from '@hotwired/stimulus';
+export default class SlideoverComponent extends Controller {
+    toggle() {
+        var _a;
+        this.expandableTarget.classList.toggle('hidden');
+        this.expandWrapperTarget.classList.toggle('bg-filter-panel');
+        for (const slidePanel of this.slidePanelTargets) {
+            slidePanel.classList.toggle('hidden');
+        }
+        this.buttonWrapperTarget.classList.toggle('bg-filter-panel');
+        if ((_a = document.getElementById('btnClose')) === null || _a === void 0 ? void 0 : _a.classList.contains('hidden')) {
+            const formID = this.buttonWrapperTarget.getAttribute('data-slideover-component-form-id');
+            if (formID) {
+                const form = document.getElementById(formID);
+                form === null || form === void 0 ? void 0 : form.submit();
+            }
+        }
+    }
+}
+SlideoverComponent.targets = ['expandable', 'expandWrapper', 'slidePanel', 'buttonWrapper'];

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

@@ -0,0 +1,26 @@
+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('hidden')
+    this.expandWrapperTarget.classList.toggle('bg-filter-panel')
+    for (const slidePanel of this.slidePanelTargets) {
+      slidePanel.classList.toggle('hidden')
+    }
+    this.buttonWrapperTarget.classList.toggle('bg-filter-panel')
+    if (document.getElementById('btnClose')?.classList.contains('hidden')) {
+      const formID = this.buttonWrapperTarget.getAttribute('data-slideover-component-form-id')
+      if (formID) {
+        const form = <HTMLFormElement>document.getElementById(formID)
+        form?.submit()
+      }
+    }
+  }
+}

data/app/components/ariadne/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.html.erb

@@ -0,0 +1,11 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |slideover| %>
+  <div data-slideover-component-target="expandWrapper" class="flex flex-col z-10">
+    <div data-slideover-component-target="expandable" class="hidden bg-filter-panel px-3 pb-4">
+      <%= content %>
+    </div>
+    <div data-slideover-component-target="buttonWrapper" data-slideover-component-form-id="<%= @form_id %>" class="relative flex justify-center">
+      <%= open_button %>
+      <%= close_button %>
+    </div>
+  </div>
+<% end %>

data/app/components/ariadne/slideover_component.js

@@ -0,0 +1,19 @@
+import { Controller } from '@hotwired/stimulus';
+export default class SlideoverComponent extends Controller {
+    toggle() {
+        var _a;
+        // eslint-disable-next-line no-debugger
+        debugger;
+        this.expandableTarget.classList.toggle('hidden');
+        this.expandWrapperTarget.classList.toggle('bg-filter-panel');
+        for (const slidePanel of this.slidePanelTargets) {
+            slidePanel.classList.toggle('hidden');
+        }
+        this.buttonWrapperTarget.classList.toggle('bg-filter-panel');
+        if ((_a = document.getElementById('btnClose')) === null || _a === void 0 ? void 0 : _a.classList.contains('hidden')) {
+            const form = this.buttonWrapperTarget.closest('form');
+            form === null || form === void 0 ? void 0 : form.submit();
+        }
+    }
+}
+SlideoverComponent.targets = ['expandable', 'expandWrapper', 'slidePanel', 'buttonWrapper'];

data/app/components/ariadne/slideover_component.rb

@@ -0,0 +1,81 @@
+# 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 = ""
+
+    DEFAULT_BUTTON_CLASSES = "inline-flex items-center shadow-sm px-4 py-1.5 pb-2 text-sm leading-5 font-medium rounded-full " + Ariadne::ButtonComponent::SCHEME_CLASS_MAPPINGS[:default]
+    renders_one :open_button, lambda { |label:, classes: "", attributes: {}, text_classes: ""|
+      actual_classes = class_names(DEFAULT_BUTTON_CLASSES, classes)
+
+      attributes[:id] ||= "btnOpen"
+      attributes[:"data-slideover-component-target"] ||= "slidePanel"
+      attributes[:"data-action"] ||= "click->slideover-component#toggle"
+      attributes[:type] ||= "submit"
+
+      icon = case @direction
+      when DIRECTION_Y_DOWN
+        :"chevron-double-down"
+      end
+
+      render(Ariadne::BaseComponent.new(tag: :button, classes: actual_classes, attributes: attributes)) do
+        render(Ariadne::HeroiconComponent.new(icon: icon, size: :sm, variant: HeroiconsHelper::Icon::VARIANT_SOLID, attributes: { "data-slideover-component-target" => "slide-panel" }, text_classes: text_classes)) { label }
+      end
+    }
+
+    renders_one :close_button, lambda { |label:, classes: "", attributes: {}, text_classes: ""|
+      actual_classes = class_names(DEFAULT_BUTTON_CLASSES, classes)
+
+      attributes[:id] ||= "btnClose"
+      attributes[:"data-slideover-component-target"] ||= "slidePanel"
+      attributes[:"data-action"] ||= "click->slideover-component#toggle"
+      attributes[:type] ||= "submit"
+
+      icon = case @direction
+      when DIRECTION_Y_DOWN
+        :"chevron-double-up"
+      end
+
+      render(Ariadne::BaseComponent.new(tag: :button, classes: actual_classes, attributes: attributes)) do
+        render(Ariadne::HeroiconComponent.new(icon: icon, size: :sm, variant: HeroiconsHelper::Icon::VARIANT_SOLID, attributes: { "data-slideover-component-target" => "slide-panel" }, text_classes: text_classes)) { label }
+      end
+    }
+
+    # @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 form_id [String] The ID of any <form> tag to submit when the button is clicked.
+    # @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:, form_id: nil, open_text: "Open", close_text: "Close", classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @direction = fetch_or_raise(VALID_DIRECTIONS, direction)
+      @form_id = form_id
+
+      @open_text = open_text
+      @close_text = close_text
+      @attributes = attributes
+      @attributes[:"data-controller"] = "slideover-component"
+    end
+  end
+end

data/app/components/ariadne/time_ago_component.d.ts

@@ -0,0 +1 @@
+import '@github/time-elements';

data/app/components/ariadne/time_ago_component.js

@@ -0,0 +1 @@
+import '@github/time-elements';

data/app/components/ariadne/time_ago_component.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Displays a time relative to how long ago it was. This component requires JavaScript.
+  class TimeAgoComponent < Ariadne::Component
+    DEFAULT_TAG = :"time-ago"
+    TAG_OPTIONS = [DEFAULT_TAG].freeze
+
+    DEFAULT_CLASSES = "whitespace-nowrap"
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::TimeAgoComponent.new(time: Time.now)) %>
+    #
+    # @param tag [Symbol, String] The rendered tag name.
+    # @param time [Time] The time to be formatted
+    # @param micro [Boolean] If true then the text will be formatted in "micro" mode, using as few characters as possible
+    # @param classes [String] <%%= link_to_classes_docs %>
+    # @param attributes [Hash] <%= link_to_attributes_docs %>
+    def initialize(tag: DEFAULT_TAG, time:, micro: false, classes: "", attributes: {})
+      @tag = check_incoming_tag(DEFAULT_TAG, tag)
+      @classes = class_names(
+        DEFAULT_CLASSES,
+        classes
+      )
+
+      @time = time
+      @micro = micro
+      @attributes = attributes
+      @attributes[:datetime] = @time.utc.iso8601
+      @attributes[:format] = "micro" if @micro
+    end
+
+    def call
+      render(Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes)) { time_in_words }
+    end
+
+    private def time_in_words
+      return @time.in_time_zone.strftime("%b %-d, %Y") unless @micro
+
+      seconds_ago = Time.current - @time
+
+      if seconds_ago < 1.minute
+        "1m"
+      elsif seconds_ago >= 1.minute && seconds_ago < 1.hour
+        "#{(seconds_ago / 60).floor}m"
+      elsif seconds_ago >= 1.hour && seconds_ago < 1.day
+        "#{(seconds_ago / 60 / 60).floor}h"
+      elsif seconds_ago >= 1.day && seconds_ago < 1.year
+        "#{(seconds_ago / 60 / 60 / 24).floor}d"
+      elsif seconds_ago >= 1.year
+        "#{(seconds_ago / 60 / 60 / 24 / 365).floor}y"
+      end
+    end
+  end
+end

data/app/components/ariadne/time_ago_component.ts

@@ -0,0 +1 @@
+import '@github/time-elements'

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

@@ -0,0 +1,19 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do %>
+  <div>
+    <div class="divide-y divide-gray-200">
+      <div class="pb-4">
+        <h2 id="activity-title" class="text-lg font-medium text-gray-900">Timeline</h2>
+      </div>
+      <div class="pt-6">
+        <!-- Activity feed-->
+        <div class="flow-root">
+          <ul role="list" class="-mb-8">
+            <% items.each do %>
+              <%= items %>
+            <% end %>
+          </ul>
+        </div>
+      </div>
+    </div>
+  </div>
+<% end %>

data/app/components/ariadne/timeline_component.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Ariadne
+  # Represents a linear timeline of events. Typically, this is shown
+  # as part of the Conversation component.
+  class TimelineComponent < Ariadne::Component
+    DEFAULT_TAG = :div
+    DEFAULT_CLASSES = ""
+
+    # The sub-items(s) to render
+    renders_many :items, lambda { |static_content = nil, &block|
+      next static_content if static_content.present?
+
+      view_context.capture { block&.call }
+    }
+
+    # @example Default
+    #
+    #   <%= render(Ariadne::TimelineComponent.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(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/tooltip-component.d.ts

@@ -0,0 +1,24 @@
+import { Controller } from '@hotwired/stimulus';
+import type { Instance, Placement } from '@popperjs/core';
+export default class TooltipComponent extends Controller {
+    static targets: string[];
+    readonly triggerTarget: HTMLElement;
+    readonly tooltipTarget: HTMLElement;
+    static values: {
+        placement: {
+            type: StringConstructor;
+            default: string;
+        };
+        offset: {
+            type: ArrayConstructor;
+            default: number[];
+        };
+    };
+    readonly placementValue: Placement;
+    readonly offsetValue: Array<number>;
+    popperInstance: Instance;
+    connect(): void;
+    disconnect(): void;
+    show(): void;
+    hide(): void;
+}

data/app/components/ariadne/tooltip-component.js

@@ -0,0 +1,42 @@
+import { Controller } from '@hotwired/stimulus';
+import { createPopper } from '@popperjs/core';
+export default class TooltipComponent extends Controller {
+    // Create a new Popper instance
+    connect() {
+        this.popperInstance = createPopper(this.triggerTarget, this.tooltipTarget, {
+            placement: this.placementValue,
+            modifiers: [
+                {
+                    name: 'offset',
+                    options: {
+                        offset: this.offsetValue
+                    }
+                }
+            ]
+        });
+    }
+    // Destroy the Popper instance
+    disconnect() {
+        if (this.popperInstance) {
+            this.popperInstance.destroy();
+        }
+    }
+    show() {
+        this.tooltipTarget.setAttribute('data-tooltip-show', '');
+        this.tooltipTarget.classList.remove('invisible');
+        // We need to tell Popper to update the tooltip position
+        // after we show the tooltip, otherwise it will be incorrect
+        this.popperInstance.update();
+        this.dispatch('shown', { detail: { trigger: this.triggerTarget, tooltip: this.tooltipTarget } });
+    }
+    hide() {
+        this.tooltipTarget.removeAttribute('data-tooltip-show');
+        this.tooltipTarget.classList.add('invisible');
+        this.dispatch('hidden', { detail: { trigger: this.triggerTarget, tooltip: this.tooltipTarget } });
+    }
+}
+TooltipComponent.targets = ['trigger', 'tooltip'];
+TooltipComponent.values = {
+    placement: { type: String, default: 'top' },
+    offset: { type: Array, default: [0, 8] }
+};

data/app/components/ariadne/tooltip-component.ts

@@ -0,0 +1,57 @@
+import {Controller} from '@hotwired/stimulus'
+import {createPopper} from '@popperjs/core'
+import type {Instance, Placement} from '@popperjs/core'
+
+export default class TooltipComponent extends Controller {
+  static targets = ['trigger', 'tooltip']
+  declare readonly triggerTarget: HTMLElement
+  declare readonly tooltipTarget: HTMLElement
+
+  static values = {
+    placement: {type: String, default: 'top'},
+    offset: {type: Array, default: [0, 8]}
+  }
+  declare readonly placementValue: Placement
+  declare readonly offsetValue: Array<number>
+
+  popperInstance: Instance
+
+  // Create a new Popper instance
+  connect() {
+    this.popperInstance = createPopper(this.triggerTarget, this.tooltipTarget, {
+      placement: this.placementValue,
+      modifiers: [
+        {
+          name: 'offset',
+          options: {
+            offset: this.offsetValue
+          }
+        }
+      ]
+    })
+  }
+
+  // Destroy the Popper instance
+  disconnect() {
+    if (this.popperInstance) {
+      this.popperInstance.destroy()
+    }
+  }
+
+  show() {
+    this.tooltipTarget.setAttribute('data-tooltip-show', '')
+    this.tooltipTarget.classList.remove('invisible')
+
+    // We need to tell Popper to update the tooltip position
+    // after we show the tooltip, otherwise it will be incorrect
+    this.popperInstance.update()
+    this.dispatch('shown', {detail: {trigger: this.triggerTarget, tooltip: this.tooltipTarget}})
+  }
+
+  hide() {
+    this.tooltipTarget.removeAttribute('data-tooltip-show')
+    this.tooltipTarget.classList.add('invisible')
+
+    this.dispatch('hidden', {detail: {trigger: this.triggerTarget, tooltip: this.tooltipTarget}})
+  }
+}

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

@@ -0,0 +1,4 @@
+<%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do %>
+  <span><%= @text %></span>
+  <span class="tooltip-arrow absolute block" data-popper-arrow></span>
+<% end %>