fluxbit_view_components 0.3.0 → 0.4.0

data/app/components/fluxbit/skeleton_component.rb

@@ -0,0 +1,237 @@
+# frozen_string_literal: true
+
+##
+# The `Fluxbit::SkeletonComponent` is a customizable skeleton loading component that extends `Fluxbit::Component`.
+# It provides animated placeholders for content that is loading, supporting various types like text, images, cards,
+# avatars, and more complex layouts.
+#
+# @example Basic usage
+#   = fx_skeleton
+#   = fx_skeleton(variant: :image)
+#   = fx_skeleton(variant: :card)
+#
+# @see docs/02_Components/Skeleton.md For detailed documentation.
+class Fluxbit::SkeletonComponent < Fluxbit::Component
+  include Fluxbit::Config::SkeletonComponent
+
+  ##
+  # Initializes the skeleton component with the given properties.
+  #
+  # @param [Hash] **props The properties to customize the skeleton.
+  # @option props [Symbol] :variant (:default) The type of skeleton (:default, :text, :image, :video, :avatar, :card, :widget, :list, :testimonial, :button).
+  # @option props [Boolean] :animation (true) Whether to show the pulse animation.
+  # @option props [Integer] :rows (3) Number of text rows for default/text variants.
+  # @option props [Symbol] :size (:medium) Size for avatar, image, and video variants (:small, :medium, :large).
+  # @option props [Integer] :lines (nil) Number of lines for text-based variants.
+  # @option props [String] :remove_class ('') CSS classes to remove from the default class list.
+  # @option props [Hash] **props Remaining options declared as HTML attributes.
+  #
+  # @return [Fluxbit::SkeletonComponent]
+  def initialize(**props)
+    super
+    @props = props
+
+    @variant = options(@props.delete(:variant),
+                       collection: [ :default, :text, :image, :video, :avatar, :card, :widget, :list, :testimonial, :button ],
+                       default: @@variant)
+    @animation = options(@props.delete(:animation), default: @@animation)
+    @rows = options(@props.delete(:rows), default: @@rows).to_i
+    @size = options(@props.delete(:size), collection: [ :small, :medium, :large ], default: :medium)
+    @lines = @props.delete(:lines)&.to_i
+
+    declare_classes
+    @props[:class] = remove_class(@props.delete(:remove_class) || "", @props[:class])
+    @props[:role] = "status"
+    @props["aria-label"] = "Loading"
+  end
+
+  def call
+    tag.div(**@props) do
+      case @variant
+      when :default, :text
+        render_text_skeleton
+      when :image
+        render_image_skeleton
+      when :video
+        render_video_skeleton
+      when :avatar
+        render_avatar_skeleton
+      when :card
+        render_card_skeleton
+      when :widget
+        render_widget_skeleton
+      when :list
+        render_list_skeleton
+      when :testimonial
+        render_testimonial_skeleton
+      when :button
+        render_button_skeleton
+      end
+    end
+  end
+
+  private
+
+  def declare_classes
+    base_classes = []
+    base_classes << styles[:base] if @animation
+    base_classes << styles[:container]
+
+    add(class: base_classes.join(" "), to: @props, first_element: true)
+  end
+
+  def render_text_skeleton
+    lines_count = @lines || @rows
+    content = []
+
+    lines_count.times do |index|
+      width_class = case index
+      when 0 then styles[:widths][:first_line]
+      when lines_count - 1 then styles[:widths][:last_line]
+      else styles[:widths][:full]
+      end
+
+      content << tag.div(class: "#{styles[:text][:line]} #{width_class} #{styles[:spacing][:small]}")
+    end
+
+    content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+    safe_join(content)
+  end
+
+  def render_image_skeleton
+    content = []
+    content << tag.div(class: "#{styles[:image][:container]} #{styles[:image][@size]}") do
+      concat(
+        tag.svg(class: styles[:image][:icon],
+                "aria-hidden": "true",
+                xmlns: "http://www.w3.org/2000/svg",
+                fill: "currentColor",
+                viewBox: "0 0 20 18") do
+          concat(
+            tag.path(d: "M18 0H2a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V2a2 2 0 0 0-2-2Zm-5.5 4a1.5 1.5 0 1 1 0 3 1.5 1.5 0 0 1 0-3Zm4.376 10.481A1 1 0 0 1 16 15H4a1 1 0 0 1-.895-1.447l3.5-7A1 1 0 0 1 7.468 6a.965.965 0 0 1 .9.5l2.775 4.757 1.546-1.887a1 1 0 0 1 1.618.1l2.541 4a1 1 0 0 1 .028 1.011Z")
+          )
+        end
+      )
+    end
+    content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+    safe_join(content)
+  end
+
+  def render_video_skeleton
+    content = []
+    content << tag.div(class: "#{styles[:video][:container]} #{styles[:video][@size]}") do
+      concat(
+        tag.svg(class: styles[:video][:icon],
+                "aria-hidden": "true",
+                xmlns: "http://www.w3.org/2000/svg",
+                fill: "currentColor",
+                viewBox: "0 0 16 20") do
+          concat(
+            tag.path(d: "M5 5V.13a2.96 2.96 0 0 0-1.293.749L.879 3.707A2.98 2.98 0 0 0 .13 5H5Z")
+          )
+          concat(
+            tag.path(d: "M14.066 0H7v5a2 2 0 0 1-2 2H0v11a1.97 1.97 0 0 0 1.934 2h12.132A1.97 1.97 0 0 0 16 18V2a1.97 1.97 0 0 0-1.934-2ZM9 13a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-2a2 2 0 0 1 2-2h2a2 2 0 0 1 2 2v2Zm4 .382a1 1 0 0 1-1.447.894L10 13v-2l1.553-1.276a1 1 0 0 1 1.447.894v2.764Z")
+          )
+        end
+      )
+    end
+    content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+    safe_join(content)
+  end
+
+  def render_avatar_skeleton
+    content = []
+    content << tag.div(class: styles[:avatar][@size])
+    content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+    safe_join(content)
+  end
+
+  def render_card_skeleton
+    tag.div(class: styles[:card][:container]) do
+      content = []
+      content << tag.div(class: "#{styles[:card][:header]} #{styles[:spacing][:medium]} #{styles[:widths][:card_header]}")
+
+      lines_count = @lines || @rows
+      lines_count.times do |index|
+        width_class = index == lines_count - 1 ? styles[:widths][:last_line] : styles[:widths][:full]
+        spacing_class = index < lines_count - 1 ? styles[:spacing][:small] : ""
+        content << tag.div(class: "#{styles[:card][:body]} #{spacing_class} #{width_class}")
+      end
+
+      content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+      safe_join(content)
+    end
+  end
+
+  def render_widget_skeleton
+    tag.div(class: styles[:widget][:container]) do
+      content = []
+      content << tag.div(class: "#{styles[:widget][:title]} #{styles[:widths][:widget_title]}")
+
+      lines_count = @lines || @rows
+      lines_count.times do |index|
+        width_class = index == lines_count - 1 ? styles[:widths][:last_line] : styles[:widths][:full]
+        spacing_class = index < lines_count - 1 ? styles[:spacing][:small] : ""
+        content << tag.div(class: "#{styles[:widget][:content]} #{spacing_class} #{width_class}")
+      end
+
+      content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+      safe_join(content)
+    end
+  end
+
+  def render_list_skeleton
+    tag.div(class: styles[:list][:container]) do
+      content = []
+
+      lines_count = @lines || @rows
+      lines_count.times do
+        content << tag.div(class: styles[:list][:item]) do
+          concat(tag.div(class: styles[:list][:avatar]))
+          concat(
+            tag.div(class: styles[:list][:content]) do
+              concat(tag.div(class: "#{styles[:text][:line]} #{styles[:widths][:list_name]} #{styles[:spacing][:small]}"))
+              concat(tag.div(class: "#{styles[:text][:small]} #{styles[:widths][:list_content]}"))
+            end
+          )
+        end
+      end
+
+      content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+      safe_join(content)
+    end
+  end
+
+  def render_testimonial_skeleton
+    tag.div(class: styles[:testimonial][:container]) do
+      content = []
+
+      lines_count = @lines || @rows
+      lines_count.times do |index|
+        width = index == lines_count - 1 ? styles[:widths][:testimonial_last] : styles[:widths][:full]
+        spacing_class = index < lines_count - 1 ? styles[:spacing][:small] : ""
+        content << tag.div(class: "#{styles[:testimonial][:quote]} #{width} #{spacing_class}")
+      end
+
+      content << tag.div(class: styles[:testimonial][:author]) do
+        concat(tag.div(class: styles[:testimonial][:avatar]))
+        concat(
+          tag.div do
+            concat(tag.div(class: "#{styles[:text][:line]} #{styles[:widths][:testimonial_name]} #{styles[:spacing][:small]}"))
+            concat(tag.div(class: "#{styles[:text][:small]} #{styles[:widths][:testimonial_title]}"))
+          end
+        )
+      end
+
+      content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+      safe_join(content)
+    end
+  end
+
+  def render_button_skeleton
+    content = []
+    content << tag.div(class: styles[:button])
+    content << tag.span(t("fluxbit.skeleton.loading"), class: styles[:screen_reader])
+    safe_join(content)
+  end
+end

data/app/components/fluxbit/speed_dial_action_component.html.erb

@@ -0,0 +1,30 @@
+<% if @text_outside && @text %>
+  <div class="<%= styles[:action][:text][:base] %>">
+    <span class="<%= text_classes %>"><%= @text %></span>
+    <% if @href %>
+      <%= link_to(@href, **@props) do %>
+        <%= icon @icon, class: icon_classes if @icon %>
+        <%= content if content.present? %>
+      <% end %>
+    <% else %>
+      <%= tag.button(**@props) do %>
+        <%= icon @icon, class: icon_classes if @icon %>
+        <%= content if content.present? %>
+      <% end %>
+    <% end %>
+  </div>
+<% else %>
+  <% if @href %>
+    <%= link_to(@href, **@props) do %>
+      <%= icon @icon, class: icon_classes if @icon %>
+      <%= content if content.present? %>
+    <% end %>
+  <% else %>
+    <%= tag.button(**@props) do %>
+      <%= icon @icon, class: icon_classes if @icon %>
+      <%= content if content.present? %>
+    <% end %>
+  <% end %>
+<% end %>
+
+<%= render_popover_or_tooltip %>

data/app/components/fluxbit/speed_dial_action_component.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# The `Fluxbit::SpeedDialActionComponent` is a component for rendering individual action items in a Speed Dial.
+class Fluxbit::SpeedDialActionComponent < Fluxbit::Component
+  include Fluxbit::Config::SpeedDialComponent
+
+  # Initializes the SpeedDialAction component.
+  #
+  # @param [Hash] **props The properties to customize the speed dial action.
+  # @option props [String, Symbol] :icon (nil) The icon to display in the action button.
+  # @option props [String] :text (nil) The text label for the action.
+  # @option props [String] :tooltip (nil) The tooltip text (defaults to text if not provided).
+  # @option props [String] :href (nil) The URL to link to (creates an anchor tag instead of button).
+  # @option props [Boolean] :text_outside (false) Whether to display text outside the button.
+  # @option props [Boolean] :square (false) Whether to use square shape instead of rounded.
+  # @option props [Symbol] :tooltip_placement (:left) Tooltip placement.
+  # @option props [String] :remove_class ('') CSS classes to remove from the default class list.
+  # @option props [Hash] **props Remaining options declared as HTML attributes.
+  #
+  # @return [Fluxbit::SpeedDialActionComponent]
+  def initialize(**props)
+    super(**props.slice(:tooltip_text, :tooltip_placement, :tooltip_trigger))
+    @props = props
+
+    @icon = @props.delete(:icon)
+    @text = @props.delete(:text)
+    @tooltip = @props.delete(:tooltip) || @text
+    @href = @props.delete(:href)
+    @text_outside = options @props.delete(:text_outside), default: false
+    @square = options @props.delete(:square), default: false
+    @tooltip_placement = options @props.delete(:tooltip_placement), default: :left
+    @props[:id] ||= "speed-dial-action-#{random_id}"
+
+    # Set tooltip via parent component if provided
+    @tooltip_text = @tooltip if @tooltip.present?
+
+    add class: [
+      styles[:action][:base],
+      @square ? styles[:action][:shapes][:square] : styles[:action][:shapes][:rounded]
+    ], to: @props
+    @props[:type] ||= "button" unless @href
+
+    remove_class_from_props(@props)
+  end
+
+  def before_render
+    add_popover_or_tooltip
+  end
+
+  private
+
+  def icon_classes
+    styles[:action][:icon]
+  end
+
+  def text_classes
+    styles[:action][:text][:outside]
+  end
+end

data/app/components/fluxbit/speed_dial_component.html.erb

@@ -0,0 +1,33 @@
+<div <%= tag.attributes(**@props) %> data-dial-init>
+  <% if top_position? %>
+    <button type="button" data-dial-toggle="<%= menu_id %>" aria-controls="<%= menu_id %>" aria-expanded="false" class="<%= classes trigger_classes %>">
+      <% if @trigger_icon.nil? %>
+        <%= plus_icon(class: styles[:trigger][:icon]) %>
+      <% else %>
+        <%= icon @trigger_icon, class: styles[:trigger][:icon] %>
+      <% end %>
+      <span class="<%= styles[:screen_reader] %>"><%= t("fluxbit.speed_dial.open_actions_menu") %></span>
+    </button>
+
+    <div id="<%= menu_id %>" class="<%= classes menu_classes %>">
+      <% actions.each do |action| %>
+        <%= action %>
+      <% end %>
+    </div>
+  <% else %>
+    <div id="<%= menu_id %>" class="<%= classes menu_classes %>">
+      <% actions.each do |action| %>
+        <%= action %>
+      <% end %>
+    </div>
+
+    <button type="button" data-dial-toggle="<%= menu_id %>" aria-controls="<%= menu_id %>" aria-expanded="false" class="<%= classes trigger_classes %>">
+      <% if @trigger_icon.nil? %>
+        <%= plus_icon(class: styles[:trigger][:icon]) %>
+      <% else %>
+        <%= icon @trigger_icon, class: styles[:trigger][:icon] %>
+      <% end %>
+      <span class="<%= styles[:screen_reader] %>"><%= t("fluxbit.speed_dial.open_actions_menu") %></span>
+    </button>
+  <% end %>
+</div>

data/app/components/fluxbit/speed_dial_component.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# The `Fluxbit::SpeedDialComponent` is a component for rendering customizable Speed Dial floating action buttons.
+class Fluxbit::SpeedDialComponent < Fluxbit::Component
+  include Fluxbit::Config::SpeedDialComponent
+
+  # Slot for speed dial action items
+  renders_many :actions, lambda { |**props|
+    Fluxbit::SpeedDialActionComponent.new(
+      text_outside: @text_outside,
+      square: @square,
+      **props
+    )
+  }
+
+  # Initializes the SpeedDial component with various customization options.
+  #
+  # @param [Hash] **props The properties to customize the speed dial.
+  # @option props [Symbol] :position (:bottom_right) The position of the speed dial (:top_left, :top_right, :bottom_left, :bottom_right).
+  # @option props [Boolean] :square (false) Whether to use square shape instead of rounded.
+  # @option props [Boolean] :text_outside (false) Whether to display text outside action buttons.
+  # @option props [String, Symbol] :trigger_icon The icon for the trigger button.
+  # @option props [String] :remove_class ('') CSS classes to remove from the default class list.
+  # @option props [Hash] **props Remaining options declared as HTML attributes.
+  #
+  # @return [Fluxbit::SpeedDialComponent]
+  def initialize(**props)
+    super
+    @props = props
+
+    @position = options @props.delete(:position), collection: styles[:positions].keys, default: @@position
+    @square = options @props.delete(:square), default: @@square
+    @text_outside = options @props.delete(:text_outside), default: @@text_outside
+    @trigger_icon = @props.delete(:trigger_icon)
+    @props[:id] ||= "speed-dial-#{random_id}"
+
+    add class: [
+      styles[:base],
+      styles[:positions][@position]
+    ], to: @props
+
+    remove_class_from_props(@props)
+  end
+
+  private
+
+  def classes(class_array)
+    class_array.compact.join(" ")
+  end
+
+  def menu_id
+    "#{@props[:id]}-menu"
+  end
+
+  def trigger_classes
+    [
+      styles[:trigger][:base],
+      @square ? styles[:trigger][:shapes][:square] : styles[:trigger][:shapes][:rounded]
+    ]
+  end
+
+  def top_position?
+    @position.in?([ :top_left, :top_right ])
+  end
+
+  def menu_classes
+    [
+      styles[:menu][:base],
+      styles[:menu][:hidden],
+      top_position? ? styles[:menu][:spacing][:top] : styles[:menu][:spacing][:bottom]
+    ]
+  end
+end

data/app/components/fluxbit/spinner_component.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# The `Fluxbit::SpinnerComponent` is a component for rendering loading spinners.
+class Fluxbit::SpinnerComponent < Fluxbit::Component
+  include Fluxbit::Config::SpinnerComponent
+
+  # Initializes the Spinner component with various customization options.
+  #
+  # @param [Hash] **props The properties to customize the spinner.
+  # @option props [Symbol] :color (:default) The color theme of the spinner (:default, :info, :success, :failure, :warning, :pink, :purple).
+  # @option props [Integer] :size (1) The size of the spinner (0 to 4).
+  # @option props [String] :label ('Loading...') The aria-label for accessibility.
+  # @option props [String] :remove_class ('') CSS classes to remove from the default class list.
+  # @option props [Hash] **props Remaining options declared as HTML attributes.
+  #
+  # @return [Fluxbit::SpinnerComponent]
+  def initialize(**props)
+    super
+    @props = props
+
+    @color = options @props.delete(:color), collection: styles[:colors].keys, default: @@color
+    @size = options @props.delete(:size), collection: (0..styles[:sizes].size - 1).to_a, default: @@size
+    @label = @props.delete(:label) || @@label
+
+    add class: [
+      styles[:base],
+      styles[:sizes][@size.to_i],
+      styles[:colors][@color]
+    ], to: @props
+
+    # Add accessibility attributes
+    @props[:role] = "status"
+    @props[:"aria-label"] = @label
+
+    remove_class_from_props(@props)
+  end
+
+  def call
+    tag.svg(**@props, viewBox: "0 0 100 101", fill: "none", xmlns: "http://www.w3.org/2000/svg") do
+      concat(
+        tag.path(
+          d: "M100 50.5908C100 78.2051 77.6142 100.591 50 100.591C22.3858 100.591 0 78.2051 0 50.5908C0 22.9766 22.3858 0.59082 50 0.59082C77.6142 0.59082 100 22.9766 100 50.5908ZM9.08144 50.5908C9.08144 73.1895 27.4013 91.5094 50 91.5094C72.5987 91.5094 90.9186 73.1895 90.9186 50.5908C90.9186 27.9921 72.5987 9.67226 50 9.67226C27.4013 9.67226 9.08144 27.9921 9.08144 50.5908Z",
+          fill: "currentColor"
+        )
+      )
+      concat(
+        tag.path(
+          d: "M93.9676 39.0409C96.393 38.4038 97.8624 35.9116 97.0079 33.5539C95.2932 28.8227 92.871 24.3692 89.8167 20.348C85.8452 15.1192 80.8826 10.7238 75.2124 7.41289C69.5422 4.10194 63.2754 1.94025 56.7698 1.05124C51.7666 0.367541 46.6976 0.446843 41.7345 1.27873C39.2613 1.69328 37.813 4.19778 38.4501 6.62326C39.0873 9.04874 41.5694 10.4717 44.0505 10.1071C47.8511 9.54855 51.7191 9.52689 55.5402 10.0491C60.8642 10.7766 65.9928 12.5457 70.6331 15.2552C75.2735 17.9648 79.3347 21.5619 82.5849 25.841C84.9175 28.9121 86.7997 32.2913 88.1811 35.8758C89.083 38.2158 91.5421 39.6781 93.9676 39.0409Z",
+          fill: "currentFill"
+        )
+      )
+      concat(
+        tag.span(@label, class: screen_reader_classes)
+      )
+    end
+  end
+
+  private
+
+  def spinner_classes
+    [
+      styles[:base],
+      styles[:sizes][@size.to_i],
+      styles[:colors][@color]
+    ].compact.join(" ")
+  end
+
+  def screen_reader_classes
+    styles[:screen_reader]
+  end
+end

data/app/components/fluxbit/spinner_percent_component.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+# The `Fluxbit::SpinnerPercentComponent` is a component for rendering progress spinners with percentage display.
+class Fluxbit::SpinnerPercentComponent < Fluxbit::Component
+  include Fluxbit::Config::SpinnerPercentComponent
+
+  # Initializes the SpinnerPercent component with various customization options.
+  #
+  # @param [Hash] **props The properties to customize the spinner.
+  # @option props [Symbol] :color (:default) The color theme of the spinner (:default, :info, :success, :failure, :warning, :pink, :purple).
+  # @option props [Integer] :size (1) The size of the spinner (-1 to 4).
+  # @option props [Integer] :percent (0) The percentage completion (0 to 100).
+  # @option props [String] :label ('Loading...') The aria-label for accessibility.
+  # @option props [Boolean] :show_percent (true) Whether to display the percentage text.
+  # @option props [String] :text (nil) Custom text to display instead of percentage. If provided, overrides show_percent.
+  # @option props [Hash] :label_html ({}) HTML attributes for the inner text element. Supports remove_class key to remove default classes.
+  # @option props [Boolean] :animate (false) Whether to apply rotation animation to the circle.
+  # @option props [Symbol] :speed (:normal) The speed of rotation animation (:slow, :normal, :fast, :very_fast).
+  # @option props [String] :remove_class ('') CSS classes to remove from the default class list.
+  # @option props [Hash] **props Remaining options declared as HTML attributes.
+  #
+  # @return [Fluxbit::SpinnerPercentComponent]
+  def initialize(**props)
+    super
+    @props = props
+
+    @color = options @props.delete(:color), collection: styles[:colors].keys, default: @@color
+    @size = options @props.delete(:size), collection: (0..styles[:sizes].count - 1).to_a, default: @@size
+    @percent = [ @props.delete(:percent) || @@percent, 0 ].max
+    @percent = [ @percent, 100 ].min
+    @label = @props.delete(:label) || @@label
+    @show_percent = @props.delete(:show_percent)
+    @show_percent = @@show_percent if @show_percent.nil?
+    @text = @props.delete(:text) || @@text
+    @label_html = @props.delete(:label_html) || {}
+    @animate = @props.delete(:animate)
+    @animate = @@animate if @animate.nil?
+    @speed = options @props.delete(:speed), collection: styles[:speeds].keys, default: @@speed
+
+    add class: [
+      styles[:base],
+      styles[:sizes][@size]
+    ], to: @props
+
+    # Add accessibility attributes
+    @props[:role] = "progressbar"
+    @props[:"aria-label"] = @label
+    @props[:"aria-valuenow"] = @percent
+    @props[:"aria-valuemin"] = "0"
+    @props[:"aria-valuemax"] = "100"
+
+    # Add Stimulus controller
+    @props[:data] ||= {}
+    @props[:data][:controller] = "fx-spinner-percent"
+    @props[:data][:"fx-spinner-percent-percent-value"] = @percent
+    @props[:data][:"fx-spinner-percent-animate-value"] = @animate
+    @props[:data][:"fx-spinner-percent-speed-value"] = @speed
+    @props[:data][:"fx-spinner-percent-has-custom-text-value"] = !@text.nil?
+
+    remove_class_from_props(@props)
+  end
+
+  def call
+    content_tag(:div, **@props) do
+      concat svg_content
+      concat text_content
+      concat screen_reader_content
+    end
+  end
+
+  private
+
+  def container_classes
+    [
+      styles[:base],
+      styles[:sizes][@size]
+    ].compact.join(" ")
+  end
+
+  def background_circle_classes
+    styles[:colors][@color].split.first # gets "text-gray-200" part
+  end
+
+  def progress_circle_classes
+    styles[:colors][@color].split.last # gets "stroke-blue-600" part
+  end
+
+  def svg_classes
+    classes = [ styles[:sizes][@size] ]
+    classes << styles[:speeds][@speed] if @animate
+    classes.compact.join(" ")
+  end
+
+  def percentage_text_classes
+    [
+      styles[:percentage_text][:position],
+      styles[:text_colors][@color]
+    ].compact.join(" ")
+  end
+
+  def circumference
+    # For a circle with radius 45 (viewBox is 100x100, radius should be ~45 to fit nicely)
+    2 * Math::PI * 45
+  end
+
+  def stroke_dasharray
+    circumference
+  end
+
+  def stroke_dashoffset
+    circumference - (@percent / 100.0) * circumference
+  end
+
+  def screen_reader_classes
+    styles[:screen_reader]
+  end
+
+  def label_text_classes
+    # Start with default classes
+    default_classes = percentage_text_classes.split(" ")
+
+    # Remove classes specified in label_html[:remove_class]
+    remove_class = @label_html[:remove_class] || @label_html["remove_class"]
+    if remove_class && !remove_class.empty?
+      remove_classes = remove_class.split(" ")
+      default_classes = default_classes - remove_classes
+    end
+
+    # Add custom classes from label_html[:class]
+    custom_classes = @label_html[:class]&.split(" ") || []
+
+    # Combine and join
+    (default_classes + custom_classes).uniq.join(" ")
+  end
+
+  def label_attrs
+    label_attrs = @label_html.dup
+    label_attrs.delete(:class)
+    label_attrs.delete(:remove_class)
+    label_attrs.delete("remove_class")
+    label_attrs[:class] = label_text_classes
+    label_attrs[:"data-fx-spinner-percent-target"] = "text"
+
+    label_attrs
+  end
+
+  def svg_content
+    tag.svg(class: "#{styles[:svg][:transform]} #{svg_classes}", viewBox: "0 0 100 100") do
+      concat(
+        tag.circle(cx: "50", cy: "50", r: "45", stroke: "currentColor",
+          "stroke-width": "8", fill: "transparent", class: background_circle_classes)
+      )
+      concat(
+        tag.circle(cx: "50", cy: "50", r: "45", stroke: "currentColor",
+          "stroke-width": "8", fill: "transparent", "stroke-linecap": "round",
+          "stroke-dasharray": stroke_dasharray, "stroke-dashoffset": stroke_dashoffset,
+          class: "#{progress_circle_classes} #{styles[:progress_circle][:transition]}",
+          "data-fx-spinner-percent-target": "progress")
+      )
+    end
+  end
+
+  def text_content
+    return "".html_safe unless @text || @show_percent
+
+    tag.div(**label_attrs) do
+      @text || "#{@percent}%"
+    end
+  end
+
+  def screen_reader_content
+    tag.span(@label, class: screen_reader_classes)
+  end
+end