ariadne_view_components 0.0.4 → 0.0.5

data/app/components/ariadne/heroicon_component.rb

@@ -6,15 +6,19 @@ 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 = "pl-2"
+
     include IconHelper
     include HeroiconsHelper
 
-    SIZE_DEFAULT = :s
-    SIZE_MEDIUM = :m
+    SIZE_DEFAULT = :sm
+    SIZE_MEDIUM = :md
+    SIZE_LARGE = :lg
 
     SIZE_MAPPINGS = {
       SIZE_DEFAULT => 16,
       SIZE_MEDIUM => 24,
+      SIZE_LARGE => 128,
     }.freeze
     SIZE_OPTIONS = SIZE_MAPPINGS.keys
 
@@ -62,7 +66,7 @@ module Ariadne
     #   <%= 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: :m)) %>
+    #   <%= 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) %>
@@ -73,7 +77,9 @@ module Ariadne
     # @param variant [String] <%= one_of(HeroiconsHelper::Icon::VARIANTS, sort: false) %>
     # @param size [Symbol] <%= one_of(Ariadne::HeroiconComponent::SIZE_MAPPINGS, sort: false) %>
     # @param attributes [Hash] <%= link_to_attributes_docs %>
-    def initialize(tag: :svg, icon:, variant:, size: SIZE_DEFAULT, classes: "", attributes: {})
+    # @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)
@@ -107,11 +113,16 @@ module Ariadne
         classes
       )
       @attributes.merge!(@icon.attributes.except(:class, :"aria-hidden"))
+
+      @text_classes = class_names(DEFAULT_TEXT_CLASSES, text_classes)
+      @text_attributes = text_attributes
     end
 
-    def self._after_compile
-      HeroiconsHelper::Cache.preload!(PRELOADED_ICONS) do |found, icon|
-        HeroiconComponent.new(icon: icon[:name], variant: icon[:variant]) unless found
+    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

data/app/components/ariadne/inline_flex_component.rb

@@ -24,19 +24,21 @@ module Ariadne
       </svg>
     MSG
 
-    renders_one :icon, lambda { |icon, tag: :svg, variant:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, classes: "", attributes: {}|
-      Ariadne::HeroiconComponent.new(tag: tag, icon: icon, variant: variant, size: size, classes: classes, attributes: attributes)
+    DEFAULT_TEXT_OPEN_CLASSES = "text-state-open"
+    DEFAULT_TEXT_CLOSED_CLASSES = "text-state-closed"
+    DEFAULT_TEXT_CLASSES = "pl-2 text-sm font-medium text-gray-900"
+    renders_one :icon, lambda { |tag: :svg, icon:, variant:, size: Ariadne::HeroiconComponent::SIZE_DEFAULT, classes: "", attributes: {}, text_classes: "", text_attributes: {}|
+      actual_text_classes = class_names(DEFAULT_TEXT_CLASSES, text_classes)
+      Ariadne::HeroiconComponent.new(tag: tag, icon: icon, variant: variant, size: size, classes: classes, attributes: attributes, text_classes: actual_text_classes, text_attributes: text_attributes) { content }
     }
 
-    renders_one :item, lambda { |tag: :span, classes: "", attributes: {}|
-      Ariadne::BaseComponent.new(tag: tag, classes: classes, attributes: attributes) { content }
+    renders_one :item, lambda { |classes: "", attributes: {}|
+      Ariadne::BaseComponent.new(tag: :span, classes: classes, attributes: attributes) { content }
     }
 
-    DEFAULT_TEXT_OPEN_CLASSES = "text-state-open"
-    DEFAULT_TEXT_CLOSED_CLASSES = "text-state-closed"
-    DEFAULT_TEXT_CLASSES = "pl-2 text-sm font-medium text-gray-900 text-sm"
+    DEFAULT_LABEL_CLASSES = "pl-2 text-sm font-medium text-gray-900"
     renders_one :text, lambda { |classes: "", attributes: {}|
-      actual_classes = class_names(DEFAULT_TEXT_CLASSES, classes)
+      actual_classes = class_names(DEFAULT_LABEL_CLASSES, classes)
       Ariadne::BaseComponent.new(tag: :span, classes: actual_classes, attributes: attributes) { content }
     }
 
@@ -47,7 +49,7 @@ module Ariadne
     #   <% end %>
     #
     #   <%= render(Ariadne::InlineFlexComponent.new) do |c| %>
-    #      <% c.icon(:check, size: :s, variant: HeroiconsHelper::Icon::VARIANT_SOLID) %>
+    #      <% c.icon(icon: :check, size: :sm, variant: HeroiconsHelper::Icon::VARIANT_SOLID) %>
     #      <% c.text { "Closed" } %>
     #   <% end %>
     #

data/app/components/ariadne/link_component.rb

@@ -6,19 +6,22 @@ module Ariadne
     DEFAULT_TAG = :a
     TAG_OPTIONS = [DEFAULT_TAG, :span].freeze
 
-    # `Tooltip` that appears on mouse hover or keyboard focus over the link. Use tooltips sparingly and as a last resort.
+    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] <%= link_to_attributes_docs %>
-    renders_one :tooltip, lambda { |tag: :"tool-tip", text:, classes: "", attributes: {}|
+    # @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?
 
-      actual_classes = class_names(classes)
-
-      Ariadne::TooltipComponent.new(tag: tag, text: text, classes: actual_classes, attributes: attributes)
+      Ariadne::TooltipComponent.new(tag: tag, for_id: @id, text: text, direction: direction, type: type, classes: classes, attributes: attributes)
     }
 
     # @example Default
@@ -38,9 +41,10 @@ module Ariadne
     #
     # @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:, classes: "", attributes: {})
+    def initialize(tag: DEFAULT_TAG, href:,  actionable: false, classes: "", attributes: {})
       @tag = check_incoming_tag(DEFAULT_TAG, tag)
 
       @attributes = attributes
@@ -48,7 +52,8 @@ module Ariadne
 
       @id = @attributes[:id]
 
-      @classes = classes
+      @classes = class_names(DEFAULT_CLASSES, classes)
+      @classes << DEFAULT_ACTIONABLE_CLASSES if actionable
     end
 
     def call

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

@@ -1,17 +1,15 @@
 <%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |list| %>
   <% items.each do |item| %>
     <% if item.linked? %>
-      <li data-highlight-target="highlightable" class="relative <%= selected? ? 'bg-button-bg-color' : 'hover:bg-button-hover-color' %> focus:ring-2 focus:ring-offset-2 focus:ring-purple-500">
-        <%= render(item.link) do %>
-          <%= item.header %>
+      <%= 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 %>
-      </li>
+      <% end %>
     <% else %>
-      <li data-highlight-target="highlightable" class="relative <%= selected? ? 'bg-button-bg-color' : 'hover:bg-button-hover-color' %> focus:ring-2 focus:ring-offset-2 focus:ring-purple-500">
-        <%= item.header %>
+      <%= render Ariadne::BaseComponent.new(tag: :li, classes: item.classes, attributes: item.attributes) do %>
         <%= item.entry %>
-      </li>
+      <% end %>
     <% end %>
   <% end %>
 <% end %>

data/app/components/ariadne/list_component.rb

@@ -17,16 +17,6 @@ module Ariadne
     #     <% end %>
     #   <% end %>
     #
-    # @example With a header
-    #   <% numbers = [1, 2, 3] %>
-    #   <%= render(Ariadne::ListComponent.new) do |list| %>
-    #     <% numbers.each_with_index do |number, idx| %>
-    #       <%= list.item do |item|  %>
-    #         <%= item.header { idx } %>
-    #         <%= item.entry { number } %>
-    #       <% end %>
-    #     <% end %>
-    #   <% end %>
     #
     # @param classes [String] <%= link_to_classes_docs %>
     # @param attributes [Hash] <%= link_to_attributes_docs %>
@@ -34,11 +24,6 @@ module Ariadne
       @tag = :ul
       @classes = class_names(DEFAULT_UL_CLASSES, classes)
       @attributes = attributes
-      @attributes[:"data-controller"] = "highlight"
-    end
-
-    def selected?
-      false
     end
 
     def render?
@@ -48,33 +33,22 @@ module Ariadne
     # This component is part of `ListComponent` and should not be
     # used as a standalone component.
     class Item < Ariadne::Component
-      renders_one :header, lambda { |static_content = nil, &block|
-        next static_content if static_content.present?
-
-        render(Ariadne::BaseComponent.new(tag: :div, classes: "flex justify-between")) do
-          view_context.capture { block&.call }
-        end
-      }
+      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, classes: "mt-1")) do
+        render(Ariadne::BaseComponent.new(tag: :div)) do
           view_context.capture { block&.call }
         end
       }
 
-      attr_accessor :selected
       attr_reader :link, :classes, :attributes
 
       def initialize(link: {}, classes: "", attributes: {})
-        if link.present?
-          @link = Ariadne::LinkComponent.new(**link)
-        end
-
-        @classes = classes
+        @link = link
+        @classes = class_names(DEFAULT_ITEM_CLASSES, classes)
         @attributes = attributes
-        @selected = false
       end
 
       def selected?
@@ -86,10 +60,6 @@ module Ariadne
       end
 
       def call
-        if selected
-          link_arguments[:"aria-current"] = "page"
-        end
-
         Ariadne::BaseComponent.new(tag: :div, classes: @classes, attributes: @attributes)
       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/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.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

@@ -1,11 +1,8 @@
 <%= render Ariadne::BaseComponent.new(tag: @tag, classes: @classes, attributes: @attributes) do |slideover| %>
-  <div data-slideover-component-target="expandWrapper" class="flex flex-col">
+  <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 class="relative top-4 inset-0 flex flex-row items-center bg-filter-panel" aria-hidden="true">
-      <div class="w-full border-t border-billy-purple z-10"></div>
-    </div>
     <div data-slideover-component-target="buttonWrapper" data-slideover-component-form-id="<%= @form_id %>" class="relative flex justify-center">
       <%= open_button %>
       <%= close_button %>

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

@@ -8,14 +8,14 @@ module Ariadne
     DEFAULT_TAG = :div
     TAG_OPTIONS = [DEFAULT_TAG].freeze
 
-    DIRECTION_Y = :y
-    DIRECTION_X = :x
-    VALID_DIRECTIONS = [DIRECTION_Y, DIRECTION_X].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 border border-our-purple-300 z-50 text-sm leading-5 font-medium rounded-full text-gray-700 bg-white hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500"
-    renders_one :open_button, lambda { |text:, classes: "", attributes: {}|
+    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"
@@ -23,15 +23,17 @@ module Ariadne
       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::InlineFlexComponent.new(attributes: { "data-slideover-component-target" => "slide-panel" })) do |flex|
-          flex.icon(:"chevron-double-down", size: :s, variant: HeroiconsHelper::Icon::VARIANT_SOLID)
-          flex.text { text }
-        end
+        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 { |text:, classes: "", attributes: {}|
+    renders_one :close_button, lambda { |label:, classes: "", attributes: {}, text_classes: ""|
       actual_classes = class_names(DEFAULT_BUTTON_CLASSES, classes)
 
       attributes[:id] ||= "btnClose"
@@ -39,17 +41,19 @@ module Ariadne
       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::InlineFlexComponent.new(attributes: { "data-slideover-component-target" => "slide-panel" })) do |flex|
-          flex.icon(:"chevron-double-up", size: :s, variant: HeroiconsHelper::Icon::VARIANT_SOLID)
-          flex.text { text }
-        end
+        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)) { "Example" } %>
+    #   <%= 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) %>

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/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 %>