bulma_x 0.2.0

data/lib/bulma_x/shared/spacing_options.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module BulmaX
+  module Shared
+    module SpacingOptions
+      VALID_SPACING_KEYS = %i[x y top right bottom left].freeze
+      VALID_SPACING_VALUES = ((0..10).to_a + ['auto']).freeze
+
+      module ClassMethods
+        def spacing_options
+          option :margin
+          option :padding
+        end
+      end
+
+      def self.included(base) = base.extend(ClassMethods)
+
+      def spacing_classes
+        [
+          *spacing_normalized(@margin, prefix: 'm'),
+          *spacing_normalized(@padding, prefix: 'p')
+        ]
+      end
+
+      private
+
+      # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
+      def spacing_normalized(spacing, prefix:)
+        case spacing
+        in Hash
+          assert_valid_spacing!(spacing)
+
+          [
+            spacing[:x] && "#{prefix}x-#{spacing[:x]}",
+            spacing[:y] && "#{prefix}y-#{spacing[:y]}",
+            spacing[:top] && "#{prefix}t-#{spacing[:top]}",
+            spacing[:right] && "#{prefix}r-#{spacing[:right]}",
+            spacing[:bottom] && "#{prefix}b-#{spacing[:bottom]}",
+            spacing[:left] && "#{prefix}l-#{spacing[:left]}"
+          ]
+        in Integer => n
+          ["#{prefix}-#{n}"]
+        in nil
+          []
+        end
+      end
+      # rubocop:enable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
+
+      # rubocop:disable Metrics/MethodLength
+      def assert_valid_spacing!(spacing)
+        case spacing
+        in Hash
+          invalid_keys = spacing.keys - VALID_SPACING_KEYS
+
+          if invalid_keys.any?
+            raise ArgumentError,
+                  "Expected spacing keys to be one of #{VALID_SPACING_KEYS}, got #{invalid_keys}"
+          end
+
+          invalid_values = spacing.values - VALID_SPACING_VALUES
+
+          if invalid_values.any?
+            raise ArgumentError,
+                  "Expected spacing values to be one of #{VALID_SPACING_VALUES}, got #{invalid_values}"
+          end
+        in Integer
+          unless VALID_SPACING_VALUES.include?(spacing)
+            raise ArgumentError,
+                  "Expected spacing to be included in #{VALID_SPACING_VALUES}, got #{spacing}"
+          end
+        in 'auto'
+          # no-op
+        else
+          raise ArgumentError, "Expected spacing to be a 'auto', a Hash or an Integer, got #{spacing}"
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end

data/lib/bulma_x/shared/text_options.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module BulmaX
+  module Shared
+    module TextOptions
+      module ClassMethods
+        def text_options
+          option :text_modifier, values: self::MODIFIERS_PALETTE, default: nil
+          option :text_alignment, values: %i[left centered right justified], default: nil
+          option :text_transform, values: %i[lowercase uppercase capitalize italic underlined] + [nil], default: nil
+          option :text_weight, values: %i[light normal medium semibold bold], default: nil
+          option :text_family, values: %i[sans-serif monospace primary secondary code], default: nil
+          option :text_size, values: [nil, 1, 2, 3, 4, 5, 6, 7].freeze
+        end
+      end
+
+      def self.included(base) = base.extend(ClassMethods)
+
+      def text_classes
+        [
+          @text_modifier && "has-text-#{@text_modifier}",
+          @text_alignment && "has-text-#{@text_alignment}",
+          @text_transform && "is-#{@text_transform}",
+          @text_weight && "has-text-weight-#{@text_weight}",
+          @text_family && "is-family-#{@text_family}",
+          @text_size && "is-size-#{@text_size}"
+        ]
+      end
+    end
+  end
+end

data/lib/bulma_x/slot.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Slot < BaseComponent
+    option :tag, default: :div
+    option :classes, default: []
+    option :attributes, default: {}
+
+    def root_classes = super + [*@classes]
+    def root_attributes = super.merge(@attributes)
+    def root_tag = @tag
+  end
+end

data/lib/bulma_x/subtitle.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Subtitle < Title
+    def root_classes
+      ['subtitle'] + super - ['title']
+    end
+  end
+end

data/lib/bulma_x/table.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Table < BaseComponent
+    option :bordered, values: BOOLEAN, default: false
+    option :striped, values: BOOLEAN, default: false
+    option :narrow, values: BOOLEAN, default: false
+    option :hoverable, values: BOOLEAN, default: false
+    option :scrollable, values: BOOLEAN, default: false
+
+    slot :table_container, classes: ['table-container']
+
+    slot :head, component: 'Part'
+    slot :body, component: 'Part'
+    slot :footer, component: 'Part'
+
+    root_slot tag: :table
+
+    def view_template(&)
+      if @scrollable
+        slot(:table_container) { render_self }
+      else
+        render_self
+      end
+    end
+
+    def render_self
+      render_root do
+        slot(:head, type: :head) if slot?(:head)
+        slot(:body, type: :body)
+        slot(:footer, type: :foot) if slot?(:footer)
+      end
+    end
+
+    def root_classes
+      super +
+        [
+          'table',
+          @bordered && 'is-bordered',
+          @striped && 'is-striped',
+          @narrow &&  'is-narrow',
+          @hoverable && 'is-hoverable'
+        ]
+    end
+
+    class Part < BaseComponent
+      option :type, values: %i[head body foot]
+
+      slots :row, component: 'Row'
+
+      def view_template
+        super do
+          slots(:row).each { render it }
+        end
+      end
+
+      def root_tag = "t#{@type}"
+
+      class Row < BaseComponent
+        root_slot tag: :tr
+
+        slots :cell, component: 'Cell'
+
+        def view_template
+          super do
+            slots(:cell).each { render it }
+          end
+        end
+
+        class Cell < BaseComponent
+          option :head, values: BOOLEAN, default: false
+
+          def root_tag = @head ? :th : :td
+        end
+      end
+    end
+  end
+end

data/lib/bulma_x/tabs.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Tabs < BaseComponent
+    option :alignment, values: %i[centered left right], default: :center
+    option :size, values: %i[small medium large], default: :medium
+    option :boxed, values: BOOLEAN, default: false
+    option :toggle, values: BOOLEAN, default: false
+    option :toggle_rounded, values: BOOLEAN, default: false
+
+    slot :tab_list, tag: :ul
+    slots :tab, component: 'Tab'
+
+    def view_template(&)
+      super do
+        slot(:tab_list) do
+          slots(:tab).each_with_index do |tab, _idx|
+            render(tab)
+          end
+        end
+      end
+    end
+
+    def root_classes
+      super +
+        [
+          'tabs',
+          "is-#{@alignment}",
+          "is-#{@size}",
+          @boxed && 'is-boxed',
+          @toggle && 'is-toggle',
+          @toggle_rounded && 'is-toggle-rounded'
+        ]
+    end
+
+    class Tab < BaseComponent
+      option :current, values: BOOLEAN, default: false
+      root_slot tag: :li
+
+      def root_classes = super + ['tab', @current && 'is-active']
+    end
+  end
+end

data/lib/bulma_x/tag.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Tag < BaseComponent
+    option :modifier, values: MODIFIERS_DECLINED, default: nil
+    option :rounded, values: BOOLEAN, default: false
+
+    root_slot tag: :span
+
+    def view_template
+      super do
+        yield if block_given?
+      end
+    end
+
+    def root_classes
+      super +
+        [
+          'tag',
+          @modifier && "is-#{@modifier}",
+          @rounded && 'is-rounded'
+        ]
+    end
+  end
+end

data/lib/bulma_x/textarea.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Textarea < BaseInput
+    option :rows, default: 3
+    option :fixed_size, values: BOOLEAN, default: false
+    option :name
+    option :value
+    option :placeholder
+
+    root_slot tag: :textarea
+
+    def root_classes
+      super + [
+        'textarea',
+        @fixed_size && 'has-fixed-size'
+      ]
+    end
+
+    def root_attributes
+      super.merge(
+        rows: @rows,
+        name: @name,
+        value: @value,
+        placeholder: @placeholder
+      )
+    end
+  end
+end

data/lib/bulma_x/title.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class Title < BaseComponent
+    option :level, values: [1, 2, 3, 4, 5, 6], default: 1
+    option :size, values: (1..7).to_a + [nil], default: nil
+    option :spaced, values: BOOLEAN, default: false
+    option :tag, values: %i[h div p span], default: :h
+
+    def root_tag = @tag == :h ? "h#{@level}" : @tag
+
+    def root_classes
+      super +
+        [
+          'title',
+          @size && "is-#{@size}",
+          @spaced && 'is-spaced'
+        ]
+    end
+  end
+end

data/lib/bulma_x/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BulmaX
+  VERSION = '0.2.0'
+end

data/lib/bulma_x/vertical_menu.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module BulmaX
+  class VerticalMenu < BaseComponent
+    root_slot tag: :aside, classes: ['menu'] # It override root_classes
+    slots :list, component: 'List'
+
+    def view_template(&)
+      super do
+        slots(:list).each do |list|
+          render(list)
+        end
+      end
+    end
+
+    class List < BaseComponent
+      slot :label, tag: :p, classes: ['menu-label']
+      slots :item, component: 'Item'
+
+      root_slot tag: :ul, classes: ['menu-list']
+
+      def view_template(&)
+        slot(:label) # must be right before the list
+
+        super do
+          slots(:item).each do |item|
+            render(item)
+          end
+        end
+      end
+
+      class Item < Link
+        option :active, values: BOOLEAN, default: false
+
+        slots :sub_item, component: 'self'
+
+        def root_classes
+          super + [
+            @active && 'is-active'
+          ]
+        end
+
+        def view_template(&)
+          li do
+            if slot?(:sub_item)
+              render_sub_list
+            elsif block_given?
+              super do
+                render_item(&)
+              end
+            end
+          end
+        end
+
+        private
+
+        def render_sub_list
+          ul do
+            slots(:sub_item).each do |sub_item|
+              render(sub_item)
+            end
+          end
+        end
+
+        def render_item(&)
+          yield if block_given?
+        end
+      end
+    end
+  end
+end

data/lib/bulma_x.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'zeitwerk'
+
+module BulmaX
+  class Error < StandardError; end
+
+  Loader = Zeitwerk::Loader.for_gem.tap(&:setup)
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: bulma_x
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Team for the Planet
+bindir: exe
+cert_chain: []
+date: 2025-05-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: phlex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+description: |
+  BulmaX is a component based library that allows you to use Bulma CSS with
+  the power of Phlex. It provides a set of components that can be used to
+  build modern web applications with ease and a DSL to create your own
+  components.
+email:
+- dev@team-planet.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- Rakefile
+- lib/bulma_x.rb
+- lib/bulma_x/base_component.rb
+- lib/bulma_x/base_input.rb
+- lib/bulma_x/block.rb
+- lib/bulma_x/box.rb
+- lib/bulma_x/breadcrumbs.rb
+- lib/bulma_x/button.rb
+- lib/bulma_x/card.rb
+- lib/bulma_x/checkbox.rb
+- lib/bulma_x/columns.rb
+- lib/bulma_x/component_dsl.rb
+- lib/bulma_x/dropdown.rb
+- lib/bulma_x/dsl/options.rb
+- lib/bulma_x/dsl/slots.rb
+- lib/bulma_x/dsl/validations.rb
+- lib/bulma_x/field.rb
+- lib/bulma_x/figure.rb
+- lib/bulma_x/file.rb
+- lib/bulma_x/footer.rb
+- lib/bulma_x/form.rb
+- lib/bulma_x/grid.rb
+- lib/bulma_x/help.rb
+- lib/bulma_x/hero.rb
+- lib/bulma_x/icon.rb
+- lib/bulma_x/image.rb
+- lib/bulma_x/input.rb
+- lib/bulma_x/level.rb
+- lib/bulma_x/link.rb
+- lib/bulma_x/media.rb
+- lib/bulma_x/message.rb
+- lib/bulma_x/modal.rb
+- lib/bulma_x/navbar.rb
+- lib/bulma_x/notification.rb
+- lib/bulma_x/pagination.rb
+- lib/bulma_x/panel.rb
+- lib/bulma_x/paragraph.rb
+- lib/bulma_x/progress.rb
+- lib/bulma_x/radio.rb
+- lib/bulma_x/section.rb
+- lib/bulma_x/select.rb
+- lib/bulma_x/shared/aria_options.rb
+- lib/bulma_x/shared/data_options.rb
+- lib/bulma_x/shared/flex_options.rb
+- lib/bulma_x/shared/global_options.rb
+- lib/bulma_x/shared/spacing_options.rb
+- lib/bulma_x/shared/text_options.rb
+- lib/bulma_x/slot.rb
+- lib/bulma_x/subtitle.rb
+- lib/bulma_x/table.rb
+- lib/bulma_x/tabs.rb
+- lib/bulma_x/tag.rb
+- lib/bulma_x/textarea.rb
+- lib/bulma_x/title.rb
+- lib/bulma_x/version.rb
+- lib/bulma_x/vertical_menu.rb
+homepage: https://gitlab.com/tftp/open/bulma_x
+licenses: []
+metadata:
+  homepage_uri: https://gitlab.com/tftp/open/bulma_x
+  source_code_uri: https://gitlab.com/tftp/open/bulma_x.
+  changelog_uri: https://gitlab.com/tftp/open/bulma_x/Changelog.md.
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Merge the power of Phlex into Bulma CSS
+test_files: []