element_component 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85eed5018abeec014030f5b5e766bd15bb22485e1e085071350829d9dd8979c6
-  data.tar.gz: 65e106b1cb82eab8c0db53e65b09c396e5a85a16cffd8f46d548938503c6b122
+  metadata.gz: b327f66396580a4106a123f22a80cf6edb726a1d98b5b47dcea4f00d4df8649a
+  data.tar.gz: 2ba097718efa76c3418a62657eb9f2f897d67501a88f9942d8b002d7ac783acf
 SHA512:
-  metadata.gz: 40a635e98231ea288f2a865889f8a4814a2d6bd1d9fa37359320267bf506197049c615b90ee7719a8c5adbf76c984377330310904392e1b66c26f75082657377
-  data.tar.gz: 0fdfafc6cb4933a1e56704d35befb3b933c253d9d888c34fd09ad243367806dd31a4cdebeb6985b05923ccc4874953ac0c890fcc439c415b785275683a4cb7b6
+  metadata.gz: 83f7331b27128641ca774e75f5fd4e8ee4681402630f0091c31f27afe2397523e530e529ffb8481504555196a94ea530de820dbb278e03e9773eaf7a2bf55aa9
+  data.tar.gz: 988bada7149ec432984c71638e3cf4a53f309910093d10cebaf6a30ee13ff524697ebf19c7118c96625ff94575068eb5660c71902d992847943fa786b692a943

data/AGENTS.md

@@ -12,6 +12,7 @@ lib/
     version.rb                      # VERSION constant
     element.rb                      # Core Element class
     components.rb                   # Component index, requires all components
+    aliases.rb                      # Namespace aliases and shortcuts
     components/
       alert.rb                      # Alert component
       alert/
@@ -76,6 +77,7 @@ spec/
   element_component_spec.rb         # Version check
   lib/
     element_spec.rb                 # Element unit tests
+    aliases_spec.rb                 # Namespace aliases tests
     components/
       alert_spec.rb                 # Alert component tests
       badge_spec.rb                 # Badge component tests
@@ -99,18 +101,56 @@ examples/
   alert_example.rb                  # Complete Alert usage examples
 ```
 
+## Namespace Aliases
+
+All components and the Element class can be accessed in multiple ways to reduce verbosity:
+
+### 1. Direct aliases (recommended)
+```ruby
+ElementComponent::Card.new("content")
+ElementComponent::Alert.new("message", variant: :success)
+ElementComponent::E.new("div", "content")
+```
+
+### 2. Short module alias
+```ruby
+EC::Card.new("content")
+EC::E.new("span", "text")
+```
+
+### 3. Helper method for generic elements
+```ruby
+ElementComponent.tag("div", "content", class: "container")
+ElementComponent.tag("div") { |e| e.add_content("block") }
+```
+
+### 4. View shortcuts (include in views/helpers)
+```ruby
+class MyView
+  include ElementComponent::Shortcuts
+
+  def render
+    Card.new("content")
+    E.new("span", "text")
+    tag("div", "content")
+  end
+end
+```
+
+**All 48 components are available** via all four access patterns above.
+
 ## Core Classes
 
-### `ElementComponent::Element`
+### `ElementComponent::Element` (alias: `ElementComponent::E`)
 - **Attributes**: `element` (tag name), `attributes` (Hash), `contents` (Array), `html` (rendered output)
-- **Constructor**: `Element.new(tag_name, closing_tag: true, **attributes)`
+- **Constructor**: `Element.new(tag_name, content = nil, closing_tag: true, **attributes, &block)`
 - **Content methods**: `add_content`, `add_content!`, `add_content(&block)` — `content` can be a single value or an Array of values
 - **Attribute methods**: `add_attribute`, `add_attribute!`, `remove_attribute`, `remove_attribute_value`
 - **Render**: `render` (with hooks: `before_render`, `after_render`, `around_render`)
 
 ### Pre-built Components
 
-Components live under `ElementComponent::Components`. Each component folder contains the main class and its sub-components in separate files.
+Components live under `ElementComponent::Components` (alias: `EC`). Direct aliases are also available under `ElementComponent::`.
 
 | Component | Class | Tag | Key Options |
 |---|---|---|---|
@@ -132,7 +172,8 @@ Components live under `ElementComponent::Components`. Each component folder cont
 | Spinner | `Spinner` | `<div>` | `type` (border/grow), `variant` |
 | Table | `Table` | `<table>` | `striped`, `bordered`, `hover`, `small`, `variant` |
 
-**Alert constructor**: `Alert.new(variant: :primary, dismissible: false, **attributes, &block)`
+**Alert constructor**: `Alert.new(content = nil, variant: :primary, dismissible: false, **attributes, &block)`
+- `content`: optional content string or array, added before block content
 - `variant`: one of `:primary`, `:secondary`, `:success`, `:danger`, `:warning`, `:info`, `:light`, `:dark`
 - `dismissible`: adds `.alert-dismissible` class and appends a `CloseButton`
 - `&block`: block with element parameter for adding content inside the element
@@ -140,18 +181,61 @@ Components live under `ElementComponent::Components`. Each component folder cont
 **Component guidelines**:
 - Always use `add_attribute()` instead of manipulating the `attributes` hash directly
 - Each class in its own file under a component-named folder
-- Call `super("tag_name", closing_tag: ..., &block)` first, then chain `add_attribute` calls
-- `block.call(self)` lives in `Element#initialize` — passes element to block via block parameter
+- **Constructor pattern**: `def initialize(content = nil, **keyword_args, **attributes, &block)`
+- Call `super("tag_name", &block)` first, then chain `add_attribute` calls, then `add_content(content) if content`
+- Content from the `content` argument is added **before** block content
 - Pass user attributes last via `add_attribute(attributes)`
 
-### Sub-component example pattern:
+### Component constructor pattern:
 
 ```ruby
 class AlertHeading < Element
-  def initialize(**attributes, &block)
-    super("h4", &block)
+  def initialize(content = nil, **attributes)
+    super("h4")
     add_attribute(class: "alert-heading")
-    add_attribute(attributes)
+    add_attribute(attributes) unless attributes.empty?
+    add_content(content) if content
+  end
+end
+```
+
+### Components with internal content (e.g., Alert, ModalHeader):
+
+```ruby
+class Alert < Element
+  def initialize(content = nil, variant: :primary, dismissible: false, **attributes, &block)
+    super("div", &block)
+
+    add_attribute(class: "alert")
+    add_attribute(class: "alert-\#{variant}")
+    add_attribute(class: "alert-dismissible") if dismissible
+    add_attribute(role: "alert")
+
+    add_attribute(attributes) unless attributes.empty?
+    add_content(content) if content              # user content first
+    add_content(AlertCloseButton.new) if dismissible  # internal content after
+  end
+end
+```
+
+### Components with conditional tag names (e.g., Button, ListGroupItem):
+
+```ruby
+class Button < Element
+  def initialize(content = nil, variant: :primary, outline: false, size: nil, href: nil, **attributes, &block)
+    if href
+      super("a", &block)
+      add_attribute(href: href)
+    else
+      super("button", &block)
+      add_attribute(type: "button")
+    end
+
+    add_attribute(class: "btn")
+    add_attribute(class: outline ? "btn-outline-\#{variant}" : "btn-\#{variant}")
+    add_attribute(class: "btn-\#{size}") if size
+    add_attribute(attributes) unless attributes.empty?
+    add_content(content) if content
   end
 end
 ```
@@ -184,6 +268,7 @@ ruby examples/alert_example.rb  # Run Alert examples
 - Test render output as raw HTML strings
 - Test attribute hashes directly
 - Follow existing describe/context/it structure
+- Test new aliases in `spec/lib/aliases_spec.rb`
 
 ## Development Workflow
 
@@ -202,6 +287,13 @@ ruby examples/alert_example.rb  # Run Alert examples
 - Hooks (`before_render`, `after_render`, `around_render`) are optional, detected via `respond_to?`
 - Self-closing tags controlled by `closing_tag:` parameter
 - Component classes use `add_attribute()` instead of direct hash manipulation
+- `content` as first positional argument in all constructors (optional, default `nil`)
+- Content argument is added before block content when both are provided
+- All 48 components are aliased directly under `ElementComponent::` for convenience
+- `ElementComponent::E` is an alias for `ElementComponent::Element`
+- `ElementComponent::EC` is an alias for `ElementComponent::Components`
+- `ElementComponent.tag()` is a helper method for creating generic elements
+- `ElementComponent::Shortcuts` module provides instance methods for use in views/helpers
 
 ## Roadmap Features (from README)
 - Caching support

data/lib/element_component/aliases.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module ElementComponent
+  E = Element
+
+  def self.tag(name, content = nil, **attributes, &)
+    Element.new(name, content, **attributes, &)
+  end
+
+  EC = Components
+
+  Alert = Components::Alert
+  Badge = Components::Badge
+  Breadcrumb = Components::Breadcrumb
+  Button = Components::Button
+  ButtonGroup = Components::ButtonGroup
+  Card = Components::Card
+  Carousel = Components::Carousel
+  CloseButton = Components::CloseButton
+  Dropdown = Components::Dropdown
+  ListGroup = Components::ListGroup
+  Modal = Components::Modal
+  Nav = Components::Nav
+  Navbar = Components::Navbar
+  Pagination = Components::Pagination
+  Progress = Components::Progress
+  Spinner = Components::Spinner
+  Table = Components::Table
+
+  AlertHeading = Components::AlertHeading
+  AlertLink = Components::AlertLink
+  AlertCloseButton = Components::AlertCloseButton
+  BreadcrumbItem = Components::BreadcrumbItem
+  CardHeader = Components::CardHeader
+  CardBody = Components::CardBody
+  CardFooter = Components::CardFooter
+  CardTitle = Components::CardTitle
+  CardText = Components::CardText
+  CardImage = Components::CardImage
+  CarouselItem = Components::CarouselItem
+  CarouselCaption = Components::CarouselCaption
+  DropdownMenu = Components::DropdownMenu
+  DropdownItem = Components::DropdownItem
+  DropdownDivider = Components::DropdownDivider
+  DropdownHeader = Components::DropdownHeader
+  ListGroupItem = Components::ListGroupItem
+  ModalDialog = Components::ModalDialog
+  ModalContent = Components::ModalContent
+  ModalHeader = Components::ModalHeader
+  ModalTitle = Components::ModalTitle
+  ModalBody = Components::ModalBody
+  ModalFooter = Components::ModalFooter
+  NavItem = Components::NavItem
+  NavLink = Components::NavLink
+  NavbarBrand = Components::NavbarBrand
+  NavbarToggler = Components::NavbarToggler
+  NavbarCollapse = Components::NavbarCollapse
+  NavbarNav = Components::NavbarNav
+  PageItem = Components::PageItem
+  ProgressBar = Components::ProgressBar
+
+  # rubocop:disable Naming/MethodName
+  module Shortcuts
+    def Card(...) = ElementComponent::Card.new(...)
+    def Alert(...) = ElementComponent::Alert.new(...)
+    def Badge(...) = ElementComponent::Badge.new(...)
+    def Button(...) = ElementComponent::Button.new(...)
+    def ButtonGroup(...) = ElementComponent::ButtonGroup.new(...)
+    def Breadcrumb(...) = ElementComponent::Breadcrumb.new(...)
+    def Carousel(...) = ElementComponent::Carousel.new(...)
+    def CloseButton(...) = ElementComponent::CloseButton.new(...)
+    def Dropdown(...) = ElementComponent::Dropdown.new(...)
+    def ListGroup(...) = ElementComponent::ListGroup.new(...)
+    def Modal(...) = ElementComponent::Modal.new(...)
+    def Nav(...) = ElementComponent::Nav.new(...)
+    def Navbar(...) = ElementComponent::Navbar.new(...)
+    def Pagination(...) = ElementComponent::Pagination.new(...)
+    def Progress(...) = ElementComponent::Progress.new(...)
+    def Spinner(...) = ElementComponent::Spinner.new(...)
+    def Table(...) = ElementComponent::Table.new(...)
+    def AlertHeading(...) = ElementComponent::AlertHeading.new(...)
+    def AlertLink(...) = ElementComponent::AlertLink.new(...)
+    def AlertCloseButton(...) = ElementComponent::AlertCloseButton.new(...)
+    def BreadcrumbItem(...) = ElementComponent::BreadcrumbItem.new(...)
+    def CardHeader(...) = ElementComponent::CardHeader.new(...)
+    def CardBody(...) = ElementComponent::CardBody.new(...)
+    def CardFooter(...) = ElementComponent::CardFooter.new(...)
+    def CardTitle(...) = ElementComponent::CardTitle.new(...)
+    def CardText(...) = ElementComponent::CardText.new(...)
+    def CardImage(...) = ElementComponent::CardImage.new(...)
+    def CarouselItem(...) = ElementComponent::CarouselItem.new(...)
+    def CarouselCaption(...) = ElementComponent::CarouselCaption.new(...)
+    def DropdownMenu(...) = ElementComponent::DropdownMenu.new(...)
+    def DropdownItem(...) = ElementComponent::DropdownItem.new(...)
+    def DropdownDivider(...) = ElementComponent::DropdownDivider.new(...)
+    def DropdownHeader(...) = ElementComponent::DropdownHeader.new(...)
+    def ListGroupItem(...) = ElementComponent::ListGroupItem.new(...)
+    def ModalDialog(...) = ElementComponent::ModalDialog.new(...)
+    def ModalContent(...) = ElementComponent::ModalContent.new(...)
+    def ModalHeader(...) = ElementComponent::ModalHeader.new(...)
+    def ModalTitle(...) = ElementComponent::ModalTitle.new(...)
+    def ModalBody(...) = ElementComponent::ModalBody.new(...)
+    def ModalFooter(...) = ElementComponent::ModalFooter.new(...)
+    def NavItem(...) = ElementComponent::NavItem.new(...)
+    def NavLink(...) = ElementComponent::NavLink.new(...)
+    def NavbarBrand(...) = ElementComponent::NavbarBrand.new(...)
+    def NavbarToggler(...) = ElementComponent::NavbarToggler.new(...)
+    def NavbarCollapse(...) = ElementComponent::NavbarCollapse.new(...)
+    def NavbarNav(...) = ElementComponent::NavbarNav.new(...)
+    def PageItem(...) = ElementComponent::PageItem.new(...)
+    def ProgressBar(...) = ElementComponent::ProgressBar.new(...)
+    def E(...) = ElementComponent::E.new(...)
+    def tag(...) = ElementComponent.tag(...)
+  end
+  # rubocop:enable Naming/MethodName
+end

data/lib/element_component/components/alert/heading.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class AlertHeading < Element
-      def initialize(**attributes)
+      def initialize(content = nil, **attributes)
         super("h4")
 
         add_attribute(class: "alert-heading")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/alert/link.rb

@@ -3,12 +3,13 @@
 module ElementComponent
   module Components
     class AlertLink < Element
-      def initialize(href: "#", **attributes)
+      def initialize(content = nil, href: "#", **attributes)
         super("a")
 
         add_attribute(class: "alert-link")
         add_attribute(href: href)
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/alert.rb

@@ -9,7 +9,7 @@ module ElementComponent
     class Alert < Element
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
 
-      def initialize(variant: :primary, dismissible: false, **attributes, &block)
+      def initialize(content = nil, variant: :primary, dismissible: false, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "alert")
@@ -18,6 +18,7 @@ module ElementComponent
         add_attribute(role: "alert")
 
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
         add_content(AlertCloseButton.new) if dismissible
       end
     end

data/lib/element_component/components/badge.rb

@@ -5,13 +5,14 @@ module ElementComponent
     class Badge < Element
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
 
-      def initialize(variant: :primary, pill: false, **attributes, &block)
+      def initialize(content = nil, variant: :primary, pill: false, **attributes, &block)
         super("span", &block)
 
         add_attribute(class: "badge")
         add_attribute(class: "bg-#{variant}")
         add_attribute(class: "rounded-pill") if pill
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/breadcrumb/item.rb

@@ -3,7 +3,7 @@
 module ElementComponent
   module Components
     class BreadcrumbItem < Element
-      def initialize(href: nil, active: false, **attributes, &block)
+      def initialize(content = nil, href: nil, active: false, **attributes, &block)
         super("li", &block)
 
         add_attribute(class: "breadcrumb-item")
@@ -12,6 +12,7 @@ module ElementComponent
         add_attribute(attributes) unless attributes.empty?
 
         @href = href
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/breadcrumb.rb

@@ -5,11 +5,12 @@ require_relative "breadcrumb/item"
 module ElementComponent
   module Components
     class Breadcrumb < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("nav", &)
 
         add_attribute("aria-label": "breadcrumb")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
 
       def build

data/lib/element_component/components/button.rb

@@ -6,7 +6,7 @@ module ElementComponent
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark link].freeze
       VALID_SIZES = %i[sm lg].freeze
 
-      def initialize(variant: :primary, outline: false, size: nil, href: nil, **attributes, &block)
+      def initialize(content = nil, variant: :primary, outline: false, size: nil, href: nil, **attributes, &block)
         if href
           super("a", &block)
           add_attribute(href: href)
@@ -19,6 +19,7 @@ module ElementComponent
         add_attribute(class: outline ? "btn-outline-#{variant}" : "btn-#{variant}")
         add_attribute(class: "btn-#{size}") if size
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/button_group.rb

@@ -5,13 +5,14 @@ module ElementComponent
     class ButtonGroup < Element
       VALID_SIZES = %i[sm lg].freeze
 
-      def initialize(size: nil, vertical: false, **attributes, &block)
+      def initialize(content = nil, size: nil, vertical: false, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: vertical ? "btn-group-vertical" : "btn-group")
         add_attribute(class: "btn-group-#{size}") if size
         add_attribute(role: "group")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card/body.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CardBody < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "card-body")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card/footer.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CardFooter < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "card-footer")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card/header.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CardHeader < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "card-header")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card/text.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CardText < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("p", &)
 
         add_attribute(class: "card-text")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card/title.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CardTitle < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("h5", &)
 
         add_attribute(class: "card-title")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/card.rb

@@ -10,11 +10,12 @@ require_relative "card/image"
 module ElementComponent
   module Components
     class Card < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "card")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/carousel/caption.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class CarouselCaption < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "carousel-caption")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/carousel/item.rb

@@ -3,13 +3,14 @@
 module ElementComponent
   module Components
     class CarouselItem < Element
-      def initialize(active: false, interval: nil, **attributes, &block)
+      def initialize(content = nil, active: false, interval: nil, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "carousel-item")
         add_attribute(class: "active") if active
         add_attribute("data-bs-interval": interval.to_s) if interval
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/carousel.rb

@@ -6,7 +6,7 @@ require_relative "carousel/caption"
 module ElementComponent
   module Components
     class Carousel < Element
-      def initialize(id: "carousel", fade: false, indicators: true, controls: true, **attributes, &block)
+      def initialize(content = nil, id: "carousel", fade: false, indicators: true, controls: true, **attributes, &block)
         @carousel_id = id
         @show_indicators = indicators
         @show_controls = controls
@@ -17,6 +17,7 @@ module ElementComponent
         add_attribute(class: "slide")
         add_attribute(class: "carousel-fade") if fade
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/dropdown/header.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class DropdownHeader < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("li", &)
 
         inner = Element.new("h6", class: "dropdown-header", **attributes)
         @inner_header = inner
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/dropdown/item.rb

@@ -5,7 +5,7 @@ module ElementComponent
     class DropdownItem < Element
       VALID_TYPES = %i[button link].freeze
 
-      def initialize(type: :link, href: "#", active: false, disabled: false, **attributes, &block)
+      def initialize(content = nil, type: :link, href: "#", active: false, disabled: false, **attributes, &block)
         tag = type == :button ? "button" : "a"
         super("li", &block)
 
@@ -19,6 +19,7 @@ module ElementComponent
         inner.add_content(&block) if block
 
         @inner_item = inner
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/dropdown/menu.rb

@@ -3,12 +3,13 @@
 module ElementComponent
   module Components
     class DropdownMenu < Element
-      def initialize(align: nil, **attributes, &block)
+      def initialize(content = nil, align: nil, **attributes, &block)
         super("ul", &block)
 
         add_attribute(class: "dropdown-menu")
         add_attribute(class: "dropdown-menu-#{align}") if align
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/dropdown.rb

@@ -10,12 +10,13 @@ module ElementComponent
     class Dropdown < Element
       VALID_DIRECTIONS = %i[dropup dropend dropstart].freeze
 
-      def initialize(direction: nil, **attributes, &block)
+      def initialize(content = nil, direction: nil, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "dropdown")
         add_attribute(class: direction.to_s) if direction
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
 
       def toggle_button(label: "Dropdown", variant: :secondary, split: false, **btn_attributes, &block)

data/lib/element_component/components/list_group/item.rb

@@ -5,7 +5,7 @@ module ElementComponent
     class ListGroupItem < Element
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
 
-      def initialize(variant: nil, active: false, disabled: false, href: nil, **attributes, &block)
+      def initialize(content = nil, variant: nil, active: false, disabled: false, href: nil, **attributes, &block)
         tag = href ? "a" : "li"
         super(tag, &block)
 
@@ -17,6 +17,7 @@ module ElementComponent
         add_attribute(href: href) if href
         add_attribute("aria-current": "true") if active
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/list_group.rb

@@ -5,13 +5,14 @@ require_relative "list_group/item"
 module ElementComponent
   module Components
     class ListGroup < Element
-      def initialize(flush: false, numbered: false, **attributes, &block)
+      def initialize(content = nil, flush: false, numbered: false, **attributes, &block)
         super("ul", &block)
 
         add_attribute(class: "list-group")
         add_attribute(class: "list-group-flush") if flush
         add_attribute(class: "list-group-numbered") if numbered
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/modal/body.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class ModalBody < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "modal-body")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/modal/content.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class ModalContent < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "modal-content")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/modal/dialog.rb

@@ -6,7 +6,7 @@ module ElementComponent
       VALID_SIZES = %i[sm lg xl].freeze
       VALID_FULLSCREEN = %i[always sm md lg xl xxl].freeze
 
-      def initialize(scrollable: false, centered: false, size: nil, fullscreen: nil, **attributes, &block)
+      def initialize(content = nil, scrollable: false, centered: false, size: nil, fullscreen: nil, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "modal-dialog")
@@ -15,6 +15,7 @@ module ElementComponent
         add_attribute(class: "modal-#{size}") if size
         add_attribute(class: "modal-fullscreen#{"-#{fullscreen}-down" unless fullscreen == :always}") if fullscreen
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/modal/footer.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class ModalFooter < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "modal-footer")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/modal/header.rb

@@ -3,12 +3,13 @@
 module ElementComponent
   module Components
     class ModalHeader < Element
-      def initialize(close_button: true, **attributes, &block)
+      def initialize(content = nil, close_button: true, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "modal-header")
         add_attribute(attributes) unless attributes.empty?
 
+        add_content(content) if content
         add_content(CloseButton.new) if close_button
       end
     end

data/lib/element_component/components/modal/title.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class ModalTitle < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("h5", &)
 
         add_attribute(class: "modal-title")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/nav/item.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class NavItem < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("li", &)
 
         add_attribute(class: "nav-item")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/nav/link.rb

@@ -3,7 +3,7 @@
 module ElementComponent
   module Components
     class NavLink < Element
-      def initialize(href: "#", active: false, disabled: false, **attributes, &block)
+      def initialize(content = nil, href: "#", active: false, disabled: false, **attributes, &block)
         super("a", &block)
 
         add_attribute(class: "nav-link")
@@ -12,6 +12,7 @@ module ElementComponent
         add_attribute(href: href)
         add_attribute("aria-current": "page") if active
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/nav.rb

@@ -8,7 +8,7 @@ module ElementComponent
     class Nav < Element
       VALID_TYPES = %i[tabs pills underline].freeze
 
-      def initialize(type: nil, fill: false, justified: false, vertical: false, **attributes, &block)
+      def initialize(content = nil, type: nil, fill: false, justified: false, vertical: false, **attributes, &block)
         super("ul", &block)
 
         add_attribute(class: "nav")
@@ -17,6 +17,7 @@ module ElementComponent
         add_attribute(class: "nav-justified") if justified
         add_attribute(class: "flex-column") if vertical
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/navbar/brand.rb

@@ -3,12 +3,13 @@
 module ElementComponent
   module Components
     class NavbarBrand < Element
-      def initialize(href: "#", **attributes, &block)
+      def initialize(content = nil, href: "#", **attributes, &block)
         super("a", &block)
 
         add_attribute(class: "navbar-brand")
         add_attribute(href: href)
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/navbar/collapse.rb

@@ -3,13 +3,14 @@
 module ElementComponent
   module Components
     class NavbarCollapse < Element
-      def initialize(id: nil, **attributes, &block)
+      def initialize(content = nil, id: nil, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "collapse")
         add_attribute(class: "navbar-collapse")
         add_attribute(id: id) if id
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/navbar/nav.rb

@@ -3,11 +3,12 @@
 module ElementComponent
   module Components
     class NavbarNav < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("ul", &)
 
         add_attribute(class: "navbar-nav")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/navbar.rb

@@ -13,7 +13,7 @@ module ElementComponent
       VALID_FIXED = %i[top bottom].freeze
       VALID_STICKY = %i[top bottom].freeze
 
-      def initialize(expand: :lg, theme: :light, background: nil, fixed: nil, sticky: nil, container: true, **attributes,
+      def initialize(content = nil, expand: :lg, theme: :light, background: nil, fixed: nil, sticky: nil, container: true, **attributes,
                      &block)
         super("nav", &block)
 
@@ -26,6 +26,7 @@ module ElementComponent
         add_attribute(attributes) unless attributes.empty?
 
         @use_container = container
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/pagination/item.rb

@@ -3,7 +3,7 @@
 module ElementComponent
   module Components
     class PageItem < Element
-      def initialize(active: false, disabled: false, href: "#", **attributes, &block)
+      def initialize(content = nil, active: false, disabled: false, href: "#", **attributes, &block)
         super("li", &block)
 
         add_attribute(class: "page-item")
@@ -14,6 +14,7 @@ module ElementComponent
 
         @page_href = href
         @page_disabled = disabled
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/pagination.rb

@@ -7,12 +7,13 @@ module ElementComponent
     class Pagination < Element
       VALID_SIZES = %i[sm lg].freeze
 
-      def initialize(size: nil, **attributes, &block)
+      def initialize(content = nil, size: nil, **attributes, &block)
         @pagination_size = size
         super("nav", &block)
 
         add_attribute("aria-label": "Pagination")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
 
       private

data/lib/element_component/components/progress/bar.rb

@@ -5,7 +5,7 @@ module ElementComponent
     class ProgressBar < Element
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
 
-      def initialize(value: 0, variant: nil, striped: false, animated: false, **attributes, &block)
+      def initialize(content = nil, value: 0, variant: nil, striped: false, animated: false, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "progress-bar")
@@ -18,6 +18,7 @@ module ElementComponent
         add_attribute("aria-valuemax": "100")
         add_attribute(style: "width: #{value}%")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/progress.rb

@@ -5,12 +5,13 @@ require_relative "progress/bar"
 module ElementComponent
   module Components
     class Progress < Element
-      def initialize(**attributes, &)
+      def initialize(content = nil, **attributes, &)
         super("div", &)
 
         add_attribute(class: "progress")
         add_attribute(role: "progressbar")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/spinner.rb

@@ -6,13 +6,14 @@ module ElementComponent
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
       VALID_TYPES = %i[border grow].freeze
 
-      def initialize(type: :border, variant: nil, **attributes, &block)
+      def initialize(content = nil, type: :border, variant: nil, **attributes, &block)
         super("div", &block)
 
         add_attribute(class: "spinner-#{type}")
         add_attribute(class: "text-#{variant}") if variant
         add_attribute(role: "status")
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/components/table.rb

@@ -5,7 +5,7 @@ module ElementComponent
     class Table < Element
       VALID_VARIANTS = %i[primary secondary success danger warning info light dark].freeze
 
-      def initialize(striped: false, bordered: false, hover: false, small: false, variant: nil, **attributes, &block)
+      def initialize(content = nil, striped: false, bordered: false, hover: false, small: false, variant: nil, **attributes, &block)
         super("table", &block)
 
         add_attribute(class: "table")
@@ -15,6 +15,7 @@ module ElementComponent
         add_attribute(class: "table-sm") if small
         add_attribute(class: "table-#{variant}") if variant
         add_attribute(attributes) unless attributes.empty?
+        add_content(content) if content
       end
     end
   end

data/lib/element_component/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ElementComponent
-  VERSION = "0.10.0"
+  VERSION = "0.12.0"
 end

data/lib/element_component.rb

@@ -3,6 +3,7 @@
 require_relative "element_component/version"
 require_relative "element_component/element"
 require_relative "element_component/components"
+require_relative "element_component/aliases"
 
 module ElementComponent
   class Error < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: element_component
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - João Paulo Correia
@@ -40,6 +40,7 @@ files:
 - examples/spinner_example.rb
 - examples/table_example.rb
 - lib/element_component.rb
+- lib/element_component/aliases.rb
 - lib/element_component/components.rb
 - lib/element_component/components/alert.rb
 - lib/element_component/components/alert/close_button.rb