bulma-phlex 0.7.0 → 0.8.0

data/lib/bulma_phlex/rails/card_helper.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module BulmaPhlex
-  module Rails
-    # # Card Helper
-    #
-    # This module provides method `turbo_frame_content` to create a card with a turbo frame as its content.
-    module CardHelper
-      extend ActiveSupport::Concern
-
-      included do
-        include Phlex::Rails::Helpers::TurboFrameTag
-      end
-
-      # Renders a Bulma-styled card with a Turbo Frame as its content. This uses the same signatures as
-      # `turbo_frame_tag`, with the addition of two optional attributes: `pending_message` and `pending_icon`.
-      #
-      # The two pending attributes have the following defaults:
-      # - pending_message: "Loading..."
-      # - pending_icon: "fas fa-spinner fa-pulse"
-      def turbo_frame_content(*ids, src: nil, target: nil, **attributes)
-        pending_message = attributes.delete(:pending_message) || "Loading..."
-        pending_icon = attributes.delete(:pending_icon) || "fas fa-spinner fa-pulse"
-
-        content do
-          turbo_frame_tag ids, src: src, target: target, **attributes do
-            span(class: "icon") { i class: pending_icon }
-            span { plain pending_message }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/bulma_phlex/rails/table_helper.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module BulmaPhlex
-  module Rails
-    # # Table Helper
-    #
-    # This module provides method `amount_column` to create an amount column in a table.
-    module TableHelper
-      extend ActiveSupport::Concern
-
-      included do
-        include Phlex::Rails::Helpers::NumberToCurrency
-      end
-
-      def amount_column(header, currency: {}, **html_attributes, &content)
-        html_attributes[:class] = [html_attributes[:class], "has-text-right"].compact.join(" ")
-
-        column(header, **html_attributes) do |row|
-          number_to_currency(content.call(row), **currency)
-        end
-      end
-    end
-  end
-end

data/lib/bulma_phlex/railtie.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-require "bulma_phlex/rails/card_helper"
-require "bulma_phlex/rails/table_helper"
-
-module BulmaPhlex
-  # # Railtie for BulmaPhlex
-  #
-  # This Railtie adds Rails-specific features to the BulmaPhlex library.
-  class Railtie < ::Rails::Railtie
-    initializer "bulma_phlex" do
-      ActiveSupport.on_load(:action_view) do
-        if defined?(Phlex::Rails)
-          Components::Bulma::Card.include(BulmaPhlex::Rails::CardHelper) if defined?(Turbo)
-          Components::Bulma::Table.include(BulmaPhlex::Rails::TableHelper)
-        end
-      end
-    end
-  end
-end

data/lib/components/bulma/base.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Base component for all Bulma components
-    #
-    # This is the parent class for all Bulma components in this library.
-    # It provides common utility methods and inherits from `Phlex::HTML`.
-    #
-    class Base < Phlex::HTML
-      private
-
-      def icon_span(icon, additional_classes = nil)
-        span(class: "icon #{additional_classes}".strip) do
-          i(class: icon)
-        end
-      end
-    end
-  end
-end

data/lib/components/bulma/card.rb

@@ -1,83 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Card component for content display
-    #
-    # This component implements the [Bulma card](https://bulma.io/documentation/components/card/)
-    # interface. Cards are flexible containers that can display various types of content
-    # including headers, content sections, and more.
-    #
-    # ## Example
-    #
-    # ```ruby
-    # Bulma::Card() do |card|
-    #   card.head("Card Title")
-    #   card.content do
-    #     "This is some card content"
-    #   end
-    #   card.footer_link("View", "/view", target: "_blank")
-    #   card.footer_link("Edit", "/edit", class: "has-text-primary")
-    # end
-    # ```
-    #
-    # ## Rails Feature: Turbo Frame Content
-    #
-    # If the project includes Rails and the Phlex::Rails gem, the `BulmaPhlex::Rails::CardHelper` module
-    # provides a `turbo_frame_content` method to create a card with a turbo frame
-    # as its content. This allows for dynamic loading of card content.
-    class Card < Components::Bulma::Base
-      def view_template(&)
-        vanish(&)
-
-        div(class: "card") do
-          card_header
-          card_content
-          card_footer
-        end
-      end
-
-      def head(title, classes: nil)
-        @header_title = title
-        @header_classes = classes
-      end
-
-      def content(&block)
-        @card_content = block
-      end
-
-      def footer_link(text, href, **html_attributes)
-        (@footer_items ||= []) << [text, href, html_attributes]
-      end
-
-      private
-
-      def card_header
-        return if @header_title.nil?
-
-        header(class: "card-header #{@header_classes}") do
-          p(class: "card-header-title") { plain @header_title }
-        end
-      end
-
-      def card_content
-        return if @card_content.nil?
-
-        div(class: "card-content") do
-          div(class: "content") { @card_content.call }
-        end
-      end
-
-      def card_footer
-        return if @footer_items.nil? || @footer_items.empty?
-
-        footer(class: "card-footer") do
-          @footer_items.each do |text, href, html_attributes|
-            html_attributes[:class] = [html_attributes[:class], "card-footer-item"].compact.join(" ")
-            a(href:, **html_attributes) { text }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/components/bulma/dropdown.rb

@@ -1,109 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Dropdown component
-    #
-    # This component implements the [Bulma Dropdown](https://bulma.io/documentation/components/dropdown/).
-    #
-    # ## [Hoverable or Toggable](https://bulma.io/documentation/components/dropdown/#hoverable-or-toggable)
-    #
-    # By default the dropdown is in Click Mode and assumes a Stimulus controller named `bulma--dropdown` is present to
-    # handle the click events. The controller name can be customized using the `click` option.
-    #
-    # Set click to `false` to make the dropdown hoverable instead of togglable.
-    #
-    # ## Alignment
-    #
-    # Use the `alignment` option to control the dropdown's alignment. By default, it aligns to the left. Pass in
-    # `:right` or `:up` to change the alignment.
-    #
-    # ## Icon
-    #
-    # Use the `icon` option to customize the dropdown's icon. By default, it uses the Font Awesome angle down icon.
-    #
-    # ## Example
-    #
-    # ```ruby
-    # Bulma::Dropdown("Next Actions...") do |dropdown|
-    #   dropdown.link "View Profile", "/profile"
-    #   dropdown.link "Go to Settings", "/settings"
-    #   dropdown.divider
-    #   dropdown.item("This is just a text item")
-    #   dropdown.item do
-    #     div(class: "has-text-weight-bold") { "This is a bold item" }
-    #   end
-    # end
-    # ```
-    #
-    class Dropdown < Components::Bulma::Base
-      def initialize(label, click: "bulma--dropdown", alignment: "left", icon: "fas fa-angle-down")
-        @label = label
-        @click = click
-        @alignment = alignment
-        @icon = icon
-      end
-
-      def view_template(&)
-        div(class: "dropdown #{"is-hoverable" unless @click} #{alignment_class}".strip, **stimulus_controller) do
-          div(class: "dropdown-trigger") do
-            button(
-              class: "button",
-              aria_haspopup: "true",
-              aria_controls: "dropdown-menu",
-              **stimulus_action
-            ) do
-              span { @label }
-              span(class: "icon is-small") do
-                i(class: @icon, aria_hidden: "true")
-              end
-            end
-          end
-
-          div(class: "dropdown-menu", id: "dropdown-menu", role: "menu") do
-            div(class: "dropdown-content", &)
-          end
-        end
-      end
-
-      def item(content = nil, &)
-        if block_given?
-          div(class: "dropdown-item", &)
-        else
-          div(class: "dropdown-item") { content }
-        end
-      end
-
-      def link(label, path)
-        a(class: "dropdown-item", href: path) { label }
-      end
-
-      def divider
-        hr(class: "dropdown-divider")
-      end
-
-      private
-
-      def alignment_class
-        case @alignment.to_sym
-        when :right
-          "is-right"
-        when :up
-          "is-up"
-        end
-      end
-
-      def stimulus_controller
-        return {} unless @click
-
-        { data: { controller: @click } }
-      end
-
-      def stimulus_action
-        return {} unless @click
-
-        { data: { action: "#{@click}#toggle" } }
-      end
-    end
-  end
-end

data/lib/components/bulma/level.rb

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Level component for responsive horizontal layouts
-    #
-    # This component implements the [Bulma level](https://bulma.io/documentation/layout/level/)
-    # interface, providing a flexible horizontal layout system with left and right alignment.
-    #
-    # ## Example:
-    #
-    # ```ruby
-    # Bulma::Level() do |level|
-    #   level.left do
-    #     button(class: "button") { "Left" }
-    #   end
-    #
-    #   level.right do
-    #     button(class: "button") { "Right" }
-    #   end
-    #   level.right do
-    #     button(class: "button") { "Right 2" }
-    #   end
-    # end
-    # ```
-    #
-    class Level < Components::Bulma::Base
-      def initialize
-        @items = []
-        @left = []
-        @right = []
-      end
-
-      def view_template(&)
-        vanish(&)
-
-        div(class: "level") do
-          div(class: "level-left") do
-            @left.each { level_item(it) }
-          end
-
-          @items.each { level_item(it) }
-
-          div(class: "level-right") do
-            @right.each { level_item(it) }
-          end
-        end
-      end
-
-      def item(&content)
-        @items << content
-      end
-
-      def left(&content)
-        @left << content
-      end
-
-      def right(&content)
-        @right << content
-      end
-
-      private
-
-      def level_item(content)
-        div(class: "level-item") { content.call }
-      end
-    end
-  end
-end

data/lib/components/bulma/navigation_bar.rb

@@ -1,108 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Navigation bar component for site navigation
-    #
-    # This component implements the [Bulma navbar](https://bulma.io/documentation/components/navbar/)
-    # interface. It provides a responsive navigation header with support for branding, navigation
-    # links, and dropdown menus, automatically collapsing on mobile devices.
-    #
-    # ## Example
-    #
-    # ```ruby
-    # Bulma::NavigationBar() do |navbar|
-    #   navbar.brand do
-    #     a(href: "/", class: "navbar-item") { "My App" }
-    #   end
-    #
-    #   navbar.left do
-    #     a(href: "/", class: "navbar-item") { "Home" }
-    #     a(href: "/products", class: "navbar-item") { "Products" }
-    #   end
-    #
-    #   navbar.right do
-    #     a(href: "/about", class: "navbar-item") { "About" }
-    #
-    #     div(class: "navbar-item has-dropdown is-hoverable") do
-    #       a(class: "navbar-link") { "Account" }
-    #       Bulma::NavigationBarDropdown() do |dropdown|
-    #         dropdown.item "Sign In", "/login"
-    #         dropdown.item "Register", "/register"
-    #       end
-    #     end
-    #   end
-    # end
-    # ```
-    #
-    class NavigationBar < Components::Bulma::Base
-      def initialize(container: false, classes: "")
-        @container = container
-        @classes = classes
-        @brand = []
-        @left = []
-        @right = []
-      end
-
-      def view_template(&)
-        vanish(&)
-
-        nav(class: "navbar #{@classes}".rstrip,
-            role: "navigation",
-            aria_label: "main navigation",
-            data: { controller: "bulma--navigation-bar" }) do
-          optional_container do
-            div(class: "navbar-brand") do
-              @brand.each(&:call)
-
-              a(class: "navbar-burger",
-                role: "button",
-                aria_label: "menu",
-                aria_expanded: "false",
-                data: {
-                  action: "bulma--navigation-bar#toggle",
-                  "bulma--navigation-bar-target": "burger"
-                }) do
-                4.times { span(aria_hidden: "true") }
-              end
-            end
-
-            div(class: "navbar-menu",
-                data: { "bulma--navigation-bar-target": "menu" }) do
-              div(class: "navbar-start") do
-                @left.each(&:call)
-              end
-
-              div(class: "navbar-end") do
-                @right.each(&:call)
-              end
-            end
-          end
-        end
-      end
-
-      def brand(&block)
-        @brand << block
-      end
-
-      def left(&block)
-        @left << block
-      end
-
-      def right(&block)
-        @right << block
-      end
-
-      private
-
-      def optional_container(&)
-        if @container
-          constraint = @container if @container.is_a?(String) || @container.is_a?(Symbol)
-          div(class: "container #{constraint}".rstrip, &)
-        else
-          yield
-        end
-      end
-    end
-  end
-end

data/lib/components/bulma/navigation_bar_dropdown.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Dropdown component for the Bulma navigation bar
-    #
-    # This component implements the dropdown portion of the [Bulma navbar](https://bulma.io/documentation/components/navbar/#dropdown-menu).
-    # It provides a structured way to add dropdown menus to a navigation bar with headers, items, and dividers.
-    #
-    # ## Example
-    #
-    # ```ruby
-    # Bulma::NavigationBar() do |navbar|
-    #   navbar.brand_item "My App", "/"
-    #
-    #   navbar.right do |menu|
-    #     menu.dropdown "Account" do |dropdown|
-    #       dropdown.header "User"
-    #       dropdown.item "Profile", "/profile"
-    #       dropdown.item "Settings", "/settings"
-    #       dropdown.divider
-    #       dropdown.item "Sign Out", "/logout"
-    #     end
-    #   end
-    # end
-    # ```
-    #
-    class NavigationBarDropdown < Components::Bulma::Base
-      def view_template(&)
-        div(class: "navbar-dropdown is-right", &)
-      end
-
-      def header(label)
-        div(class: "navbar-item header has-text-weight-medium") { label }
-      end
-
-      def item(label, path)
-        a(class: "navbar-item", href: path) { label }
-      end
-
-      def divider
-        hr(class: "navbar-divider")
-      end
-    end
-  end
-end

data/lib/components/bulma/pagination.rb

@@ -1,123 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    # Pagination component for navigating through multi-page content
-    #
-    # This component implements the [Bulma pagination](https://bulma.io/documentation/components/pagination/)
-    # interface, providing navigation controls for paginated content. It shows:
-    # - Previous/next page links
-    # - First/last page links when appropriate
-    # - Current page indicator
-    # - Ellipses for skipped page ranges
-    # - Summary of items being displayed
-    #
-    # ## Example
-    #
-    # ```ruby
-    # # In a controller action:
-    # @products = Product.page(params[:page]).per(20)
-    #
-    # # In the view:
-    # Bulma::Pagination(@products, ->(page) { products_path(page: page) })
-    # ```
-    #
-    class Pagination < Components::Bulma::Base
-      attr_reader :pager, :path_builder
-
-      # Initializes the pagination component
-      #
-      # @param pager [Object] An object that responds to:
-      #   - `current_page` - Integer representing the current page number
-      #   - `total_pages` - Integer representing the total number of pages
-      #   - `per_page` - Integer representing the number of items per page
-      #   - `total_count` - Integer representing the total number of items
-      #   - `previous_page` - Integer or nil representing the previous page number
-      #   - `next_page` - Integer or nil representing the next page number
-      # @param path_builder [Proc] A callable that takes a page number and returns a URL string
-      def initialize(pager, path_builder)
-        @pager = pager
-        @path_builder = path_builder
-      end
-
-      def view_template
-        return unless pager.total_pages > 1
-
-        div(class: "pagination-container mt-5") do
-          nav(class: "pagination", role: "navigation", aria_label: "pagination") do
-            # Previous page link
-            if pager.previous_page
-              a(class: "pagination-previous", href: page_url(pager.previous_page)) { "Previous" }
-            else
-              a(class: "pagination-previous", disabled: true) { "Previous" }
-            end
-
-            # Next page link
-            if pager.next_page
-              a(class: "pagination-next", href: page_url(pager.next_page)) { "Next" }
-            else
-              a(class: "pagination-next", disabled: true) { "Next" }
-            end
-
-            # Page number links
-            ul(class: "pagination-list") do
-              # First page and ellipsis if needed
-              if pager.current_page > 3
-                render_page_item(1)
-                render_ellipsis if pager.current_page > 4
-              end
-
-              # Pages around current page
-              page_window.each do |page_number|
-                render_page_item(page_number)
-              end
-
-              # Ellipsis and last page if needed
-              if pager.current_page < pager.total_pages - 2
-                render_ellipsis if pager.current_page < pager.total_pages - 3
-                render_page_item(pager.total_pages)
-              end
-            end
-          end
-
-          div(class: "has-text-centered mt-2 is-size-7") do
-            start_item = ((pager.current_page - 1) * pager.per_page) + 1
-            end_item = [start_item + pager.per_page - 1, pager.total_count].min
-
-            plain "Showing #{start_item}-#{end_item} of #{pager.total_count} items"
-          end
-        end
-      end
-
-      private
-
-      def render_page_item(page_number)
-        li do
-          if page_number == pager.current_page
-            a(class: "pagination-link is-current",
-              aria_label: "Page #{page_number}",
-              aria_current: "page") { page_number.to_s }
-          else
-            a(class: "pagination-link",
-              href: page_url(page_number),
-              aria_label: "Go to page #{page_number}") { page_number.to_s }
-          end
-        end
-      end
-
-      def render_ellipsis
-        li { span(class: "pagination-ellipsis") { "…" } }
-      end
-
-      def page_window
-        start_page = [pager.current_page - 2, 1].max
-        end_page = [pager.current_page + 2, pager.total_pages].min
-        (start_page..end_page).to_a
-      end
-
-      def page_url(page_number)
-        @path_builder.call(page_number)
-      end
-    end
-  end
-end

data/lib/components/bulma/tab_components/content.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module Components
-  module Bulma
-    module TabComponents
-      # # Content
-      #
-      # This component represents a single content section within the Bulma Tabs component.
-      #
-      # ## Arguments:
-      # - `id`: Unique identifier for the content.
-      # - `active`: Boolean indicating if the content is currently active.
-      # - `data_attributes_proc`: A proc that generates data attributes for the content.
-      class Content < Components::Bulma::Base
-        def initialize(id:, active:, data_attributes_proc: nil)
-          @id = id
-          @active = active
-          @data_attributes = data_attributes_proc ||
-                             Components::Bulma::Tabs::StimulusDataAttributes.new("bulma--tabs").method(:for_content)
-        end
-
-        def view_template(&)
-          div(id: @id,
-              class: @active ? "" : "is-hidden",
-              data: @data_attributes.call(@id), &)
-        end
-      end
-    end
-  end
-end