maquina 0.5.2 → 0.7.1

data/app/models/maquina/active_session.rb

@@ -1,6 +1,35 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the ActiveSession model in the Maquina module.
+  # Manages active user sessions and their expiration.
+  #
+  # == Attributes
+  #
+  # - +maquina_user_id+:: Foreign key reference to the associated User.
+  # - +expires_at+:: Timestamp when the session expires.
+  # - +user_agent+:: The user agent string from the client browser.
+  # - +remote_addr+:: The remote IP address of the client.
+  # - +return_url+:: URL to return to after session activities.
+  #
+  # == Associations
+  #
+  # - +user+:: Belongs to a User.
+  #
+  # == Validations
+  #
+  # - +expires_at+:: Must be present and in the future if session expiration is configured.
+  # - +user+:: Must not be blocked.
+  #
+  # == Callbacks
+  #
+  # - After initialize: Sets initial expiration time for new sessions based on configuration.
+  #
+  # == Delegations
+  #
+  # - +blocked?+:: Delegated to the associated user.
+  #
   class ActiveSession < ApplicationRecord
     belongs_to :user, class_name: "Maquina::User", foreign_key: :maquina_user_id
     delegate :blocked?, to: :user
@@ -10,6 +39,11 @@ module Maquina
     validates :expires_at, presence: true, comparison: {greater_than: Time.zone.now}, if: ->(session) { (session.new_record? || session.changed.includes?("expires_at")) && Maquina.configuration.session_expiration.present? }
     validate :non_blocked_user
 
+    # Checks if the session has expired
+    #
+    # Returns:
+    # - true -> if expires_at is set and in the past
+    # - false -> if expires_at is not set or is in the future
     def expired?
       return false if expires_at.blank?
 
@@ -18,12 +52,18 @@ module Maquina
 
     private
 
+    # Validates that the associated user is not blocked
+    #
+    # Adds an error if the user is blocked
     def non_blocked_user
       return if user.blank? || !blocked?
 
       errors.add(:user, :blocked)
     end
 
+    # Sets the initial expiration time for new sessions
+    #
+    # Uses the configured session expiration duration if available
     def configure_expiration
       if new_record? && expires_at.blank? && Maquina.configuration.session_expiration.present?
         self.expires_at = Time.zone.now.since(Maquina.configuration.session_expiration)

data/app/models/maquina/current.rb

@@ -1,20 +1,57 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the Current context in the Maquina module.
+  # Manages per-request global state for the current user session.
+  #
+  # == Attributes
+  #
+  # - +active_session+:: The current active session for the request.
+  # - +user+:: The current authenticated user.
+  # - +membership+:: The current user's default membership.
+  #
+  # == Usage
+  #
+  # Current attributes are cleared between requests and provide a thread-safe way to
+  # handle request-specific data. They are automatically reset after each request.
+  #
   class Current < ActiveSupport::CurrentAttributes
     attribute :active_session, :user, :membership
 
+    # Checks if there is a valid signed-in session
+    #
+    # Returns:
+    # - true -> if there is an active, non-expired, non-blocked session
+    # - false -> if there is no active session or the session is invalid
     def signed_in?
-      return false if active_session.blank?
-      !active_session.expired? && !active_session.blocked?
+      if active_session.blank? || active_session.expired? || active_session.blocked?
+        self.user = nil
+        self.membership = nil
+
+        false
+      end
+      true
     end
 
+    # Sets the active session and updates related attributes
+    #
+    # When setting a new active session, automatically updates the current user
+    # and their default membership.
+    #
+    # Args:
+    # - value -> Maquina::ActiveSession: The active session to set
     def active_session=(value)
       super
       self.user = value&.user
       self.membership = user.default_membership
     end
 
+    # Checks if the current user has management privileges
+    #
+    # Returns:
+    # - true -> if the current user has management access
+    # - false -> if the current user does not have management access
     def management?
       user.management?
     end

data/app/models/maquina/invitation.rb

@@ -1,13 +1,41 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the Invitation model in the Maquina module.
+  # Manages invitations sent to users to join the system.
+  #
+  # == Attributes
+  #
+  # - +email+:: The email address of the invited user (required, must be valid format).
+  # - +accepted_at+:: Timestamp indicating when the invitation was accepted, nil if pending.
+  #
+  # == Validations
+  #
+  # - +email+:: Must be present and in valid email format.
+  #
   class Invitation < ApplicationRecord
     validates :email, presence: true, format: {with: URI::MailTo::EMAIL_REGEXP}
 
+    # Checks if the invitation has been accepted
+    #
+    # Returns:
+    # - true -> if the invitation has been accepted
+    # - false -> if the invitation is still pending
     def accepted?
       accepted_at.present?
     end
 
+    # Marks the invitation as accepted with the current timestamp
+    #
+    # Updates the accepted_at timestamp with the current time.
+    #
+    # Returns:
+    # - true -> if the update was successful
+    # - false -> if the update failed
+    #
+    # Raises:
+    # - ActiveRecord::RecordInvalid -> if validation fails
     def accept!
       update!(accepted_at: Time.zone.now)
     end

data/app/models/maquina/membership.rb

@@ -1,10 +1,32 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the Membership model in the Maquina module.
+  # Links users to organizations and defines their roles and permissions within them.
+  #
+  # == Attributes
+  #
+  # - +maquina_organization_id+:: Foreign key reference to the associated Organization.
+  # - +maquina_user_id+:: Foreign key reference to the associated User.
+  # - +owner+:: Boolean flag indicating if the member is an owner of the organization.
+  # - +role+:: Enum defining the member's role within the organization (configured via Maquina.configuration.membership_roles).
+  # - +blocked_at+:: Timestamp indicating when the membership was blocked, nil if active.
+  #
+  # == Associations
+  #
+  # - +organization+:: Belongs to an Organization.
+  # - +user+:: Belongs to a User.
+  #
+  # == Enums
+  #
+  # - +role+:: Available roles are defined in Maquina.configuration.membership_roles.
+  #   These define the member's permissions and access level within their organization.
+  #
   class Membership < ApplicationRecord
     belongs_to :organization, class_name: "Maquina::Organization", foreign_key: :maquina_organization_id
     belongs_to :user, class_name: "Maquina::User", foreign_key: :maquina_user_id
 
-    enum role: Maquina.configuration.membership_roles
+    enum :role, Maquina.configuration.membership_roles
   end
 end

data/app/models/maquina/organization.rb

@@ -1,8 +1,25 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the Organization model in the Maquina module.
+  #
+  # == Attributes
+  #
+  # - +name+:: The name of the Organization.
+  # - +active+:: A boolean flag indicating whether the Organization is active.
+  # - +maquina_plan_id+:: The foreign key reference to the associated Plan.
+  #
+  # == Associations
+  #
+  # - +plan+:: Belongs to a Plan (optional). When the associated Plan is deleted, the reference is set to null.
+  #
+  # == Usage
+  #
+  # The Organization model represents an organizational entity within the Maquina module.
+  # Organizations can be associated with a pricing plan and their active status can be tracked.
+  #
   class Organization < ApplicationRecord
-
-    belongs_to :plan, class_name: "Maquina::Plan", foreign_key: :maquina_plan_id, optional: true
+    belongs_to :plan, class_name: "Maquina::Plan", foreign_key: :maquina_plan_id, optional: true, counter_cache: true
   end
 end

data/app/models/maquina/plan.rb

@@ -8,6 +8,11 @@ module Maquina
   #
   # - +price+:: The price of the Plan, represented as a monetary value with currency.
   # - +name+:: The name of the Plan.
+  # - +organizations_count+:: Counter cache for the number of associated organizations.
+  #
+  # == Associations
+  #
+  # - +organizations+:: Has many organizations. When plan is deleted, organization references are set to null.
   #
   # == Validations
   #
@@ -15,22 +20,37 @@ module Maquina
   # - +price+:: Must be greater than 0 if the Plan is not marked as free.
   # - +name+:: Must be present and unique.
   #
-  # == Scopes
+  # == Monetized Attributes
   #
-  # - +search_full+:: Provides a search scope for Plan model, allowing searching by name with options for prefix matching and matching any word.
+  # - +price+:: Uses the Money gem to handle currency and monetary calculations.
   #
   # == Usage
   #
   # The Plan model represents a pricing plan in the Maquina module. To use the Plan model, create instances with valid
   # attributes and use the provided methods and scopes for querying and manipulating plan data.
-
+  #
   class Plan < ApplicationRecord
-    has_many :organizations, class_name: "Maquina::Organization", foreign_key: :maquina_plan_id, dependent: :nullify
+    has_many :organizations, class_name: "Maquina::Organization", foreign_key: :maquina_plan_id, dependent: :nullify,
+      counter_cache: true
 
     monetize :price_cents
 
-    validates :price, numericality: {greater_than_or_equal_to: 0}, if: ->(plan) { plan.free? }
-    validates :price, numericality: {greater_than: 0}, if: ->(plan) { !plan.free? }
+    validates :price, numericality: {greater_than_or_equal_to: 0.00}, if: ->(plan) { plan.free? }
+    validates :price, numericality: {greater_than: 0.00}, if: ->(plan) { !plan.free? }
     validates :name, presence: true, uniqueness: true
+
+    def self.searchable?
+      true
+    end
+
+    if Maquina.configuration.search_adapter == :sqlite
+      include Maquina::SqliteSearch
+
+      search_scope :name
+    elsif Maquina.configuration.search_adapter == :pg_search
+      include PgSearch::Model
+
+      pg_search_scope :full_search, against: [:name], using: {tsearch: {prefix: true}}
+    end
   end
 end

data/app/models/maquina/used_password.rb

@@ -1,12 +1,42 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the UsedPassword model in the Maquina module.
+  # Keeps track of previously used passwords for users to prevent password reuse.
+  #
+  # == Attributes
+  #
+  # - +password_digest+:: Encrypted password digest (required).
+  # - +maquina_user_id+:: Foreign key reference to the associated User.
+  #
+  # == Associations
+  #
+  # - +user+:: Belongs to a User.
+  #
+  # == Encryption
+  #
+  # - +password_digest+:: Value is encrypted at rest in the database.
+  #
   class UsedPassword < ApplicationRecord
     belongs_to :user, class_name: "Maquina::User", foreign_key: :maquina_user_id
 
     encrypts :password_digest
     validates :password_digest, presence: true
 
+    # Stores a new password digest for a user while maintaining password history limit.
+    # If password retention is disabled via configuration, no storage occurs.
+    #
+    # Args:
+    # - +user_id+:: Integer representing the ID of the user
+    # - +password_digest+:: String of encrypted password digest to store
+    #
+    # Returns:
+    # - +nil+:: If password retention is disabled (count is nil or 0)
+    # - +Maquina::UsedPassword+:: The newly created used password record
+    #
+    # Example:
+    #   Maquina::UsedPassword.store_password_digest(1, "digest123")
     def self.store_password_digest(user_id, password_digest)
       return if Maquina.configuration.password_retain_count.blank? || Maquina.configuration.password_retain_count.zero?
 

data/app/models/maquina/user.rb

@@ -1,9 +1,46 @@
 # frozen_string_literal: true
 
 module Maquina
+  ##
+  # A class representing the User model in the Maquina module.
+  #
+  # == Attributes
+  #
+  # - +email+:: The user's email address (required, unique, automatically normalized).
+  # - +password+:: Encrypted password that must meet complexity requirements.
+  # - +password_expires_at+:: Timestamp indicating when the password expires.
+  #
+  # == Associations
+  #
+  # - +memberships+:: Has many memberships linking users to organizations.
+  # - +active_sessions+:: Has many active sessions that are destroyed when the user is deleted.
+  #
+  # == Included Modules
+  #
+  # - +RetainPasswords+:: Handles password retention functionality.
+  # - +Blockeable+:: Provides blocking/unblocking capabilities.
+  # - +Multifactor+:: Implements multi-factor authentication features.
+  #
+  # == Validations
+  #
+  # - +email+:: Must be present, unique, and in valid email format.
+  # - +password+:: Must contain at least:
+  #   * 8 characters
+  #   * 1 uppercase letter
+  #   * 1 lowercase letter
+  #   * 1 number
+  #   * 1 special character (@$!%*?&#-=+)
+  #
+  # == Normalizations
+  #
+  # - +email+:: Automatically stripped of whitespace and converted to lowercase.
+  #
+  # == Security
+  #
+  # Uses has_secure_password for password encryption and authentication.
+  #
   class User < ApplicationRecord
     include Maquina::RetainPasswords
-    include Maquina::AuthenticateBy
     include Maquina::Blockeable
     include Maquina::Multifactor
 
@@ -16,24 +53,29 @@ module Maquina
     validates :email, presence: true, uniqueness: true, format: {with: URI::MailTo::EMAIL_REGEXP}
     validates :password, format: {with: PASSWORD_COMPLEXITY_REGEX}, unless: ->(user) { user.password.blank? }
 
-    before_save :downcase_email
+    normalizes :email, with: ->(email) { email.strip.downcase }
 
+    # Checks if the user's password has expired
+    #
+    # Returns true if password_expires_at is set and in the past, false otherwise
     def expired_password?
       return false if password_expires_at.blank?
 
       password_expires_at < Time.zone.now
     end
 
+    # Returns the user's default active membership
+    #
+    # A default membership is the first unblocked membership associated with an active organization.
+    # Returns nil if user is management or no valid membership exists.
+    #
+    # Returns:
+    # - Maquina::Membership: the default membership
+    # - nil: if user is management or no valid membership exists
     def default_membership
       return nil if management?
 
       memberships.detect { |membership| membership.blocked_at.blank? && membership.organization.present? && membership.organization.active? }
     end
-
-    private
-
-    def downcase_email
-      self.email = email.downcase
-    end
   end
 end

data/app/policies/maquina/application_policy.rb

@@ -41,7 +41,7 @@ module Maquina
     end
 
     def admin?
-      (Maquina::Current.membership.present? && Maquina::Current.membership.admin?)
+      Maquina::Current.membership.present? && Maquina::Current.membership.admin?
     end
 
     relation_scope do |scope|

data/app/policies/maquina/dashboard_policy.rb

@@ -0,0 +1,7 @@
+module Maquina
+  class DashboardPolicy < ApplicationPolicy
+    def management_stats?
+      management?
+    end
+  end
+end

data/app/views/layouts/maquina/application.html.erb

@@ -8,11 +8,11 @@
 
     <%= stylesheet_link_tag "tailwind", "inter-font", "data-turbo-track": "reload" %>
 
-    <%= maquina_importmap_tags %>
+    <%= javascript_importmap_tags %>
   </head>
 
   <body class="h-full">
-    <%= render partial: "navbar" %>
+    <%= render partial: "maquina/application/navbar" %>
 
     <%= turbo_frame_tag :alert do %>
       <%= render Maquina::Application::Alert.new(flash) %>

data/app/views/layouts/maquina/sessions.html.erb

@@ -10,7 +10,7 @@
     <%= yield :head %>
 
     <%= stylesheet_link_tag "tailwind", "inter-font", "data-turbo-track": "reload" %>
-    <%= maquina_importmap_tags %>
+    <%= javascript_importmap_tags %>
 
     <%= turbo_refreshes_with method: :morph, scroll: :preserve %>
   </head>

data/app/views/maquina/application/_navbar.html.erb

@@ -1,4 +1,11 @@
-<nav class="transition-all ease-in-out delay-300 backdrop-blur-sm bg-white shadow-sm fixed top-0 left-0 right-0 z-20" data-controller="mobile-menu" data-navbar-target="navbar">
+<nav
+  class="
+    transition-all ease-in-out delay-300 backdrop-blur-sm bg-white shadow-sm fixed
+    top-0 left-0 right-0 z-20
+  "
+  data-controller="mobile-menu"
+  data-navbar-target="navbar"
+>
   <div class="max-w-7xl mx-auto px-2 sm:px-4 lg:px-8">
     <div class="flex justify-between h-16">
       <div class="flex px-2 lg:px-0">
@@ -6,8 +13,6 @@
         <%= render Maquina::Navbar::Menu.new %>
       </div>
 
-      <%= render Maquina::Navbar::Search.new(query: params[:q], url: collection_path) if action_name == "index" && respond_to?(:collection_path) && collection_path.present? && respond_to?(:resource_class) && resource_class.searchable? %>
-
       <%= render Maquina::Navbar::MobileButton.new %>
 
       <div class="hidden sm:ml-6 lg:flex sm:items-center">

data/app/views/maquina/application/components/checkbox_component.rb

@@ -6,12 +6,12 @@ module Maquina
       class CheckboxComponent < ComponentBase
         def view_template
           div(**control_html) do
-            div(class: "flex h-5 items-center") do
+            div(class: "flex h-6 items-center") do
               @form.check_box attribute_name, **input_html
             end
-            div(class: "text-sm leading-6") do
+            div(class: "ml-3 text-sm leading-6") do
               @form.label attribute_name, class: "label #{label_css_class}"
-              help_template
+              help_template(margin: false)
             end
           end
         end

data/app/views/maquina/application/components/component_base.rb

@@ -5,6 +5,7 @@ module Maquina
     module Components
       class ComponentBase < Phlex::HTML
         include ApplicationView
+        include Phlex::Rails::Helpers::TokenList
 
         def initialize(resource:, form:, options: {})
           @resource = resource
@@ -41,11 +42,11 @@ module Maquina
           @options.dig(:control_html, :label_class) || ""
         end
 
-        def help_template
+        def help_template(margin: true)
           help = t("helpers.help.#{@resource.model_name.i18n_key}.#{attribute_name}", default: nil)
           return if help.blank?
 
-          p(class: "help") { unsafe_raw help }
+          p(class: token_list("help", "mt-0": !margin)) { unsafe_raw help }
         end
 
         def error_template

data/app/views/maquina/application/edit.html.erb

@@ -1,9 +1,12 @@
-<div class="bg-white">
-  <div class="mx-auto max-w-7xl py-12 px-4 sm:px-6 lg:px-8">
-    <div class="mx-auto max-w-3xl">
-      <%= turbo_frame_tag class_to_form_frame(resource_class) do %>
-        <%= render Maquina::Application::Edit.new(resource: resource) %>
-      <% end %>
-    </div>
+<div
+  class="
+    bg-white mx-auto max-w-4xl py-12 px-4 sm:px-6 lg:px-8 border border-gray-200
+    rounded-lg shadow-sm
+  "
+>
+  <div class="mx-auto max-w-3xl">
+    <%= turbo_frame_tag class_to_form_frame(resource_class) do %>
+      <%= render Maquina::Application::Edit.new(resource: resource) %>
+    <% end %>
   </div>
 </div>

data/app/views/maquina/application/filters.rb

@@ -0,0 +1,118 @@
+module Maquina
+  module Application
+    class Filters < Phlex::HTML
+      include ApplicationView
+      include Phlex::Rails::Helpers::LinkTo
+      include Phlex::Rails::Helpers::TokenList
+
+      delegate :request, :filters, :resource_class, :collection_path, :params, to: :helpers
+
+      def view_template
+        div(class: "flex flex-1 items-center space-x-2") do
+          filters.each_pair do |field, options|
+            selected_option = calculate_selected(field, options)
+            display_filter(field, selected_option, options)
+          end
+
+          active_filters = filters.keys.select { |field| params[field].present? }
+          link_to(collection_path(**clear_filters), class: token_list("text-skin-dimmed text-xs border border-gray-200 inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 hover:bg-white hover:text-skin-base py-2 h-9 px-2 lg:px-3", hidden: active_filters.empty?)) do
+            span { t("filters.clear") }
+            svg(width: "15", height: "15", viewbox: "0 0 15 15", fill: "none", xmlns: "http://www.w3.org/2000/svg", class: "ml-2 h-4 w-4") do |s|
+              s.path(d: "M11.7816 4.03157C12.0062 3.80702 12.0062 3.44295 11.7816 3.2184C11.5571 2.99385 11.193 2.99385 10.9685 3.2184L7.50005 6.68682L4.03164 3.2184C3.80708 2.99385 3.44301 2.99385 3.21846 3.2184C2.99391 3.44295 2.99391 3.80702 3.21846 4.03157L6.68688 7.49999L3.21846 10.9684C2.99391 11.193 2.99391 11.557 3.21846 11.7816C3.44301 12.0061 3.80708 12.0061 4.03164 11.7816L7.50005 8.31316L10.9685 11.7816C11.193 12.0061 11.5571 12.0061 11.7816 11.7816C12.0062 11.557 12.0062 11.193 11.7816 10.9684L8.31322 7.49999L11.7816 4.03157Z",
+                fill: "currentColor",
+                fill_rule: "evenodd",
+                clip_rule: "evenodd")
+            end
+          end
+        end
+      end
+
+      private
+
+      def calculate_selected(field, options)
+        param_value = params[field] || nil
+        value = []
+
+        value = options.detect { |option| option[1].to_s == param_value } || [] if param_value.present?
+
+        value
+      end
+
+      def display_filter(field, selected_option, options)
+        div(class: "relative inline-block text-left", data: {controller: "popup-menu"}) do
+          button(class: "text-skin-dimmed inline-flex items-center justify-center whitespace-nowrap font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 border bg-gray-50 shadow-sm hover:bg-white hover:text-skin-base rounded-md px-3 text-xs h-9",
+            type: "button", aria_haspopup: "dialog", aria_expanded: "false", data_action: "popup-menu#toggleTransition") do
+            unsafe_raw filter_icon
+            plain resource_class.human_attribute_name(field)
+
+            if selected_option.any?
+              div(data_orientation: "vertical", role: "none", class: "hiddens shrink-0 border-l border-gray-300 w-[1px] mx-2 h-4")
+              div(class: "hiddens space-x-1 flex") do
+                div(class: "inline-flex items-center border py-0.5 text-xs transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 border-transparent bg-skin-accented/80 text-white hover:bg-skin-accented/90 rounded-sm px-1 font-normal") { selected_option.first }
+              end
+            end
+          end
+
+          div(class: "hidden absolute left-0 z-10 mt-2 w-56 origin-top-right rounded-md bg-white shadow-lg ring-1 ring-black ring-opacity-5 focus:outline-none",
+            role: "menu", "aria-orientation": "vertical", "aria-labelledby": "menu-button", tabindex: "-1", data: data_attributes) do
+            div(class: "py-1", role: "none") do
+              options.each_pair do |label, value|
+                current_value = value.to_s == selected_option.last.to_s
+
+                link_to(current_params(field, value), class: "text-skin-muted block px-4 py-2 text-sm relative flex cursor-default select-none items-center hover:bg-gray-100", role: "menuitem", tabindex: "-1", "data-value": value) do
+                  div(class: "filter-option", selected: current_value) do
+                    unsafe_raw selected_icon
+                  end
+                  span { label }
+                end
+              end
+            end
+          end
+        end
+      end
+
+      def current_params(filter, option)
+        current_params = request.query_parameters.except("page")
+        current_params.reject! { |key, value| value.blank? }
+
+        if current_params[filter] == option.to_s
+          current_params.except(filter)
+        else
+          current_params.merge(filter => option)
+        end
+      end
+
+      def clear_filters
+        request.query_parameters.except("page", *filters.keys.map(&:to_s))
+      end
+
+      def selected_icon
+        <<~SVG
+          <svg xmlns="http://www.w3.org/2000/svg" width="15" height="15" viewbox="0 0 15 15" fill="none" class="h-4 w-4">
+            <path d="M11.4669 3.72684C11.7558 3.91574 11.8369 4.30308 11.648 4.59198L7.39799 11.092C7.29783 11.2452 7.13556 11.3467 6.95402 11.3699C6.77247 11.3931 6.58989 11.3355 6.45446 11.2124L3.70446 8.71241C3.44905 8.48022 3.43023 8.08494 3.66242 7.82953C3.89461 7.57412 4.28989 7.55529 4.5453 7.78749L6.75292 9.79441L10.6018 3.90792C10.7907 3.61902 11.178 3.53795 11.4669 3.72684Z" fill="currentColor" fill-rule="evenodd" clip-rule="evenodd"/>
+          </svg>
+        SVG
+      end
+
+      def filter_icon
+        <<~SVG
+          <svg xmlns="http://www.w3.org/2000/svg" width="15" height="15" viewbox="0 0 15 15" fill="none" class="mr-2 h-4 w-4">
+            <path d="M7.49991 0.876892C3.84222 0.876892 0.877075 3.84204 0.877075 7.49972C0.877075 11.1574 3.84222 14.1226 7.49991 14.1226C11.1576 14.1226 14.1227 11.1574 14.1227 7.49972C14.1227 3.84204 11.1576 0.876892 7.49991 0.876892ZM1.82707 7.49972C1.82707 4.36671 4.36689 1.82689 7.49991 1.82689C10.6329 1.82689 13.1727 4.36671 13.1727 7.49972C13.1727 10.6327 10.6329 13.1726 7.49991 13.1726C4.36689 13.1726 1.82707 10.6327 1.82707 7.49972ZM7.50003 4C7.77617 4 8.00003 4.22386 8.00003 4.5V7H10.5C10.7762 7 11 7.22386 11 7.5C11 7.77614 10.7762 8 10.5 8H8.00003V10.5C8.00003 10.7761 7.77617 11 7.50003 11C7.22389 11 7.00003 10.7761 7.00003 10.5V8H4.50003C4.22389 8 4.00003 7.77614 4.00003 7.5C4.00003 7.22386 4.22389 7 4.50003 7H7.00003V4.5C7.00003 4.22386 7.22389 4 7.50003 4Z" fill="currentColor" fill-rule="evenodd" clip-rule="evenodd"/>
+          </svg>
+        SVG
+      end
+
+      def data_attributes
+        {
+          "popup-menu-target": "menu",
+          "transition-enter": "transition ease-out duration-100",
+          "transition-enter-active": "transform opacity-0 scale-95",
+          "transition-enter-to": "transform opacity-100 scale-100",
+          "transition-leave": "transition ease-in duration-75",
+          "transition-leave-active": "transform opacity-100 scale-100",
+          "transition-leave-to": "transform opacity-0 scale-95"
+        }
+      end
+    end
+  end
+end