tramway 0.5.2.1 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7bd63f1711a60db98ddc871375d48d7d3e6eaae3d67626dc038146e42395b3e6
-  data.tar.gz: ce50bc57610979a11cbc11feb52958b1a76ff85a7e530a28f872d85973f00e7a
+  metadata.gz: c3edafce1c744c1e57499e5682ee75f749dbf5bdefd1a9137d70ccaa95f1381f
+  data.tar.gz: fbb70ec105b76caad025797238eb09a7e21d5892e90be6b77c1c2858f301c666
 SHA512:
-  metadata.gz: e3faa9546ca344e73c22cfa4d751375efadcde87dc28a1767ff47954ca014258ea6d6dd065bdc58c8e6abc76d7bffd739e2116c3a306cb1733c20b44a80e39a9
-  data.tar.gz: 1f5cc72ffc449a10248be0b997392a9b17ef61bc37b0198ac9a5283963ad40e4428ddc586410b9faf9a04a5f209e96f21747ca2a8649a060ca0ea63250b453e4
+  metadata.gz: 4deef971e492a823f04475bc6e915193735844521f8ae65ba8f07da1b1b0edb40e35d944000b648e0c36f1e33d8b2e770b6b62117f52df1a81443fb034132032
+  data.tar.gz: fcbea51c9f88495f24110ccac4f473a3a76f2583621fb952ec849fc77c690ee081bcba7a4e789c04f1c77bda02c41dac2d607f7c9b5a6572cdd03172cf31ac0c

data/README.md

@@ -8,6 +8,7 @@ Unite Ruby on Rails brilliance. Streamline development with Tramway.
   * [Tramway Decorators](https://github.com/Purple-Magic/tramway#tramway-decorators)
   * [Tramway Form](https://github.com/Purple-Magic/tramway#tramway-form)
   * [Tramway Navbar](https://github.com/Purple-Magic/tramway#tramway-navbar)
+  * [Tramway Table Component](https://github.com/Purple-Magic/tramway#tramway-table-component)
   * [Tailwind-styled forms](https://github.com/Purple-Magic/tramway#tailwind-styled-forms)
     * [Stimulus-based inputs](https://github.com/Purple-Magic/tramway#stimulus-based-inputs)
   * [Tailwind-styled pagination](https://github.com/Purple-Magic/tramway?tab=readme-ov-file#tailwind-styled-pagination-for-kaminari)
@@ -26,7 +27,7 @@ gem "view_component"
 OR
 
 ```shell
-bundle add tramway view_component
+bundle add tramway view_component kaminari view_component
 ```
 
 ## Getting Started
@@ -194,6 +195,8 @@ end
 
 #### Decorate associations
 
+**Decorate single association**
+
 ```ruby
 class UserDecorator < Tramway::BaseDecorator
   association :posts
@@ -203,6 +206,14 @@ user = tramway_decorate User.first
 user.posts # => decorated collection of posts with PostDecorator
 ```
 
+**Decorate multiple associations**
+
+```ruby
+class UserDecorator < Tramway::BaseDecorator
+  associations :posts, :users
+end
+```
+
 #### Decorate nil
 
 Tramway Decorator does not decorate nil objects
@@ -225,7 +236,7 @@ Tramway provides **convenient** form objects for Rails applications. List proper
 class UserForm < Tramway::BaseForm
   properties :email, :password, :first_name, :last_name, :phone
 
-  normalizes :email, ->(value) { value.strip.downcase }
+  normalizes :email, with: ->(value) { value.strip.downcase }
 end
 ```
 
@@ -491,6 +502,20 @@ tramway_navbar title: 'Purple Magic' do |nav|
 end
 ```
 
+### Tramway Table Component
+
+Tramway provides a responsive, tailwind-styled table with light and dark themes.
+
+```haml
+= component 'tailwinds/table' do
+  = component 'tailwinds/table/header', headers: ['Column 1', 'Column 2']
+  = component 'tailwinds/table/row' do
+    = component 'tailwinds/table/cell' do
+      Something
+    = component 'tailwinds/table/cell' do
+      Another
+```
+
 ### Tailwind-styled forms
 
 Tramway uses [Tailwind](https://tailwindcss.com/) by default. All UI helpers are implemented with [ViewComponent](https://github.com/viewcomponent/view_component).

data/app/components/tailwinds/form/builder.rb

@@ -13,6 +13,14 @@ module Tailwinds
                ), &)
       end
 
+      def text_area(attribute, **options, &)
+        render(Tailwinds::Form::TextAreaComponent.new(
+                 input: input(:text_area),
+                 value: get_value(attribute, options),
+                 **default_options(attribute, options)
+               ), &)
+      end
+
       def password_field(attribute, **options, &)
         render(Tailwinds::Form::TextFieldComponent.new(
                  input: input(:password_field),

data/app/components/tailwinds/form/select_component.html.haml

@@ -2,4 +2,4 @@
   - if @label
     = component('tailwinds/form/label', for: @for) do
       = @label
-  = @input.call(@attribute, @collection, { selected: @value }, @options.merge(class: 'bg-white border border-gray-300 text-gray-700 py-2.5 px-2 rounded focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent'))
+  = @input.call(@attribute, @collection, { selected: @value }, @options.merge(class: 'bg-white border border-gray-300 text-gray-700 rounded focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent py-2 px-3 disabled:bg-gray-100 disabled:text-gray-400 disabled:cursor-not-allowed'))

data/app/components/tailwinds/form/submit_button_component.html.haml

@@ -1,4 +1,4 @@
 .flex.items-center.justify-between
-  %button.bg-red-500.hover:bg-red-700.text-white.font-bold.py-2.px-4.rounded.focus:outline-none.focus:shadow-outline.cursor-pointer{ type: :submit, name: :commit, **@options }
+  %button.bg-red-500.hover:bg-red-700.text-white.font-bold.py-2.px-4.rounded.focus:outline-none.focus:shadow-outline.cursor-pointer.dark:text-white{ type: :submit, name: :commit, **@options }
     = @text
   = @content

data/app/components/tailwinds/form/text_area_component.html.haml

@@ -0,0 +1,5 @@
+.mb-4
+  - if @label
+    = component('tailwinds/form/label', for: @for) do
+      = @label
+  = @input.call @attribute, **@options.merge(class: 'w-full bg-white px-3 py-2 border border-gray-300 rounded focus:outline-none focus:border-red-500 dark:placeholder-gray-400'), value: @value

data/app/components/tailwinds/form/text_area_component.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  module Form
+    # Tailwind-styled text field
+    class TextAreaComponent < TailwindComponent
+    end
+  end
+end

data/app/components/tailwinds/nav/item_component.rb

@@ -8,7 +8,7 @@ module Tailwinds
       def style
         @style ||= [
           'text-white', 'hover:bg-gray-300', 'hover:text-gray-800', 'px-4', 'py-2', 'rounded', 'whitespace-nowrap',
-          'dark:hover:bg-gray-700', 'dark:hover:text-gray-400'
+          'dark:hover:bg-gray-700', 'dark:hover:text-gray-400', 'dark:text-white'
         ].join(' ')
       end
     end

data/app/components/tailwinds/navbar_component.html.haml

@@ -4,7 +4,7 @@
       .flex.items-center
         - if @title[:text].present?
           = link_to @title[:link] do
-            .text-xl.text-white.font-bold
+            .text-xl.text-white.font-bold.dark:text-white
               = @title[:text]
         - if @left_items.present?
           %ul.block.flex.flex-row.items-center.space-x-4.ml-4

data/app/components/tailwinds/table/header_component.html.haml

@@ -1,4 +1,4 @@
-.div-table-row.block.grid.text-white.text-small.gap-4.bg-purple-700.dark:bg-gray-700.dark:text-gray-400{ class: "grid-cols-#{headers.count}" }
+.div-table-row.grid.text-white.text-small.gap-4.bg-purple-700.dark:bg-gray-700.dark:text-gray-400{ class: "grid-cols-#{headers.count}", aria: { label: "Table Header" }, role: "row" }
   - if headers.any?
     - headers.each do |header|
       .div-table-cell.py-4.px-6

data/app/components/tailwinds/table/row_component.html.haml

@@ -1,27 +1,15 @@
 - if cells.any?
-  -# desktop view
-  = row_tag class: desktop_row_classes(cells.count) do
+  = row_tag class: desktop_row_classes(cells.count), **options do
     - cells.each do |(_, value)|
       .div-table-cell.px-6.py-4.font-medium.text-gray-900.whitespace-nowrap.dark:text-white.text-xs.sm:text-base
         = value
 
-  -# mobile view
-  .div-table-row.xl:hidden.border-b.dark:bg-gray-800.dark:border-gray-700.mb-2{ "data-action" => "click->preview#toggle", "data-controller" => "preview", "data-items" => cells.to_json }
-    .w-full.p-4.bg-purple-100.text-gray-700.dark:bg-gray-700.dark:text-gray-400
-      = cells.values.first
-
-    .flex.overflow-x-auto.whitespace-nowrap
-      - cells.each_with_index do |(_, value), index|
-        - next if index == 0
-
-        .text-gray-900.dark:text-white.p-4.text-xs.sm:text-base.inline-block.w-auto
-          = value
 - else
-  - cells = Nokogiri::HTML.fragment(content).children.css('div')
+  - cells = Nokogiri::HTML.fragment(content).xpath('./*[@class and contains(concat(" ", normalize-space(@class), " "), " div-table-cell ")]')
 
   - if href.present?
-    = tag.a href:, class: [desktop_row_classes(cells.count), link_row_classes].join(' ') do
+    = tag.a href:, class: [desktop_row_classes(cells.count), link_row_classes].join(' '), **options do
       = content
   - else
-    = tag.div class: desktop_row_classes(cells.count) do
+    = tag.div class: desktop_row_classes(cells.count), **options do
       = content

data/app/components/tailwinds/table/row_component.rb

@@ -6,16 +6,19 @@ module Tailwinds
     class RowComponent < Tramway::Component::Base
       option :cells, optional: true, default: -> { [] }
       option :href, optional: true
+      option :options, optional: true, default: -> { {} }
 
       def row_tag(**options, &)
+        default_attributes = { role: :row }
+
         if href.present?
           klass = "#{options[:class] || ''} #{link_row_classes}"
 
-          link_to(href, options.merge(class: klass)) do
+          link_to(href, options.merge(class: klass, **default_attributes)) do
             yield if block_given?
           end
         else
-          tag.div(**options) do
+          tag.div(**options.merge(default_attributes)) do
             yield if block_given?
           end
         end

data/app/components/tailwinds/table_component.html.haml

@@ -1,4 +1,5 @@
 = helpers.component 'tailwinds/table/row/preview'
 
-.div-table.w-full.text-left.rtl:text-right.text-gray-500.dark:text-gray-400.mt-4
+- width_class = options[:class]&.include?('w-') ? '' : 'w-full'
+.div-table.text-left.rtl:text-right.text-gray-500.dark:text-gray-400.mt-4{ class: "#{options[:class]} #{width_class}", **options.except(:class) }
   = content

data/app/components/tailwinds/table_component.rb

@@ -3,5 +3,6 @@
 module Tailwinds
   # Table component for rendering a table
   class TableComponent < Tramway::Component::Base
+    option :options, optional: true, default: -> { {} }
   end
 end

data/app/controllers/tramway/entities_controller.rb

@@ -11,7 +11,12 @@ module Tramway
     include Rails.application.routes.url_helpers
 
     def index
-      @entities = model_class.page(params[:page])
+      @entities = if entity.page(:index).scope.present?
+                    model_class.public_send(entity.page(:index).scope)
+                  else
+                    model_class.order(id: :desc)
+                  end.page(params[:page])
+      @namespace = entity.route.namespace
     end
 
     private
@@ -19,5 +24,9 @@ module Tramway
     def model_class
       @model_class ||= params[:entity][:name].classify.constantize
     end
+
+    def entity
+      @entity ||= Tramway.config.entities.find { |e| e.name == params[:entity][:name] }
+    end
   end
 end

data/app/helpers/tramway/application_helper.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'tramway/helpers/component_helper'
+require 'kaminari/helpers/tag'
 
 module Tramway
   # Main helper module for Tramway entities pages

data/app/views/tramway/entities/_entity.html.haml

@@ -1,3 +1,3 @@
-- decorator = decorator_class(entity)
-- decorated_object = decorator.decorate(entity)
-= component 'tailwinds/table/row', cells: decorator.list_attributes.reduce({}) { |hash, attribute| hash.merge! attribute => decorated_object.public_send(attribute) }, href: decorated_object.show_path
+- decorator = decorator_class_name(entity, @namespace)
+- decorated_object = decorator.constantize.decorate(entity)
+= component 'tailwinds/table/row', cells: decorator.constantize.list_attributes.reduce({}) { |hash, attribute| hash.merge! attribute => decorated_object.public_send(attribute) }, href: decorated_object.show_path

data/app/views/tramway/entities/_list.html.haml

@@ -1,15 +1,17 @@
-- decorator = Tramway::Decorators::NameBuilder.default_decorator_class_name(@model_class)
+- decorator = Tramway::Decorators::ClassHelper.decorator_class_name(@model_class, @namespace)
 - list_attributes = decorator.constantize.list_attributes
 
 .mt-8.w-full
   - content_for :title, page_title
 
-  .flex.justify-between.items-center.md:mt-4.mt-2
+  .flex.justify-between.items-center
     %h1.font-bold.text-4xl.dark:text-white
       = content_for(:title)
 
     - if Tramway.config.pagination[:enabled]
-      = paginate @entities
+      = paginate @entities, custom_path_method: "#{@model_class.model_name.plural}_path"
+  .flex.justify-end.mt-2
+    = decorator.constantize.index_header_content.call(@entities) if decorator.constantize.index_header_content.present?
 
   - if list_attributes.empty?
     %p.text-center.mt-10
@@ -21,5 +23,6 @@
     - @entities.each do |item|
       = render 'tramway/entities/entity', entity: item
 
-    .flex.mt-4
-      = paginate @entities
+    - if Tramway.config.pagination[:enabled]
+      .flex.mt-4
+        = paginate @entities, custom_path_method: "#{@model_class.model_name.plural}_path"

data/config/routes.rb

@@ -2,29 +2,30 @@
 
 Tramway::Engine.routes.draw do
   Tramway.config.entities.each do |entity|
-    define_resource = lambda do |resource_name, entity| # rubocop:disable Lint/ShadowingOuterLocalVariable
+    segments      = entity.name.split('/')
+    resource_name = segments.pop          
+
+    define_resource = proc do
       resources resource_name.pluralize.to_sym,
-                only: [:index],
-                controller: '/tramway/entities',
-                defaults: { entity: }
+                only:      [:index],
+                controller:'/tramway/entities',
+                defaults:   { entity: entity }
     end
 
-    if entity.name.include?('/')
-      *namespaces, resource_name = entity.name.split('/')
-
-      define_namespace = lambda do |index|
-        namespace namespaces[index].to_sym do
-          if namespaces[index] == namespaces.last
-            define_resource.call(resource_name, entity)
+    if segments.empty?
+      define_resource.call
+    else
+      nest = lambda do |names|
+        namespace names.first.to_sym do
+          if names.size > 1
+            nest.call(names.drop(1))
           else
-            define_namespace.call(namespaces[index + 1])
+            define_resource.call
           end
         end
       end
 
-      define_namespace.call(0)
-    else
-      define_resource.call(entity.name, entity)
+      nest.call(segments)
     end
   end
 end

data/config/tailwind.config.js

@@ -23,7 +23,11 @@ module.exports = {
     'flex',
     'bg-purple-700',
     'px-6',
+    'px-3',
+    'px-4',
     'py-4',
+    'py-2',
+    'mb-2',
     'dark:placeholder-gray-400',
     'dark:text-white',
     'dark:bg-gray-800',
@@ -41,6 +45,14 @@ module.exports = {
     'hover:bg-gray-100',
     'hover:bg-gray-300',
     'hover:text-gray-800',
+    'mt-8',
+    'justify-between',
+    'space-x-1',
+    'justify-end',
+    'mt-2',
+    'disabled:bg-gray-100',
+    'disabled:text-gray-400',
+    'disabled:cursor-not-allowed',
     // pagination
     'bg-white', 'rounded-md', 'hover:bg-purple-100', 'dark:text-white', 'dark:bg-gray-800', 'dark:hover:bg-gray-700',
     // multiselect styles

data/lib/kaminari/helpers/tag.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Kaminari
+  module Helpers
+    # Monkey patch for Kaminari::Helpers::Tag to support :custom_path_method
+    # :reek:InstanceVariableAssumption { enabled: false }
+    class Tag
+      def page_url_for(page)
+        custom_path_method = @options[:custom_path_method]
+
+        if custom_path_method.present?
+          Tramway::Engine.routes.url_helpers.public_send(
+            custom_path_method,
+            @params.except(:controller, :action).merge(page: page)
+          )
+        else
+          params = params_for(page)
+          @template.url_for params.merge(only_path: true)
+        end
+      end
+    end
+  end
+end

data/lib/tramway/base_decorator.rb

@@ -4,6 +4,7 @@ require 'tramway/decorators/name_builder'
 require 'tramway/decorators/association'
 require 'tramway/decorators/collection_decorator'
 require 'tramway/helpers/decorate_helper'
+require 'tramway/helpers/component_helper'
 require 'tramway/utils/render'
 require 'tramway/duck_typing'
 
@@ -15,6 +16,7 @@ module Tramway
     include Tramway::Utils::Render
     include Tramway::DuckTyping::ActiveRecordCompatibility
     include Tramway::Helpers::DecorateHelper
+    include Tramway::Helpers::ComponentHelper
 
     attr_reader :object
 
@@ -23,6 +25,9 @@ module Tramway
     end
 
     class << self
+      include Tramway::Helpers::ComponentHelper
+      include Tramway::Utils::Render
+
       # :reek:NilCheck { enabled: false } because checking for nil is not a type-checking issue but business logic
       def decorate(object_or_array)
         return if object_or_array.nil?
@@ -47,6 +52,10 @@ module Tramway
         []
       end
 
+      def index_header_content
+        nil
+      end
+
       include Tramway::Decorators::AssociationClassMethods
     end
 

data/lib/tramway/configs/entities/page.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Configs
+    module Entities
+      # Route struct describes rules for route management
+      #
+      class Page < Dry::Struct
+        attribute :action, Types::Coercible::String
+        attribute? :scope, Types::Coercible::String
+      end
+    end
+  end
+end

data/lib/tramway/configs/entity.rb

@@ -1,19 +1,20 @@
 # frozen_string_literal: true
 
 require 'tramway/configs/entities/route'
+require 'tramway/configs/entities/page'
 
 module Tramway
   module Configs
     # Tramway is an entity-based framework
     class Entity < Dry::Struct
       attribute :name, Types::Coercible::String
-      attribute? :pages, Types::Array.of(Types::Symbol).default([].freeze)
+      attribute? :pages, Types::Array.of(Tramway::Configs::Entities::Page).default([].freeze)
       attribute? :route, Tramway::Configs::Entities::Route
 
       # Route Struct contains implemented in Tramway CRUD and helpful routes for the entity
       RouteStruct = Struct.new(:index)
 
-      # HumanNameStruct contains human names forms for the entity
+      # HumanName Struct contains human names forms for the entity
       HumanNameStruct = Struct.new(:single, :plural)
 
       def routes
@@ -31,6 +32,10 @@ module Tramway
         HumanNameStruct.new(single, plural)
       end
 
+      def page(name)
+        pages.find { |page| page.action == name.to_s }
+      end
+
       private
 
       def pluralized(model_name)
@@ -48,7 +53,7 @@ module Tramway
       def route_helper_method
         underscored_name = name.parameterize.pluralize.underscore
 
-        method_name = if pages.include?(:index) || route.blank?
+        method_name = if set_page?(:index) || route.blank?
                         "#{underscored_name}_path"
                       else
                         route.helper_method_by(underscored_name)
@@ -58,8 +63,10 @@ module Tramway
       end
 
       def route_helper_engine
-        pages.include?(:index) ? Tramway::Engine : Rails.application
+        set_page?(:index) ? Tramway::Engine : Rails.application
       end
+
+      alias set_page? page
     end
   end
 end

data/lib/tramway/decorators/association.rb

@@ -22,14 +22,14 @@ module Tramway
       end
 
       # has_and_belongs_to_many is not supported for now
-      def association(association)
+      def association(association, decorator: nil)
         define_method(association) do
           assoc = object.send(association)
 
           if assoc.is_a?(ActiveRecord::Relation)
-            AssocDecoratorHelper.decorate_has_many_association assoc
+            AssocDecoratorHelper.decorate_has_many_association assoc, decorator_class: decorator
           elsif assoc.present?
-            AssocDecoratorHelper.decorate_associated_object(assoc)
+            AssocDecoratorHelper.decorate_associated_object(assoc, decorator_class: decorator)
           end
         end
       end
@@ -38,12 +38,18 @@ module Tramway
     # Helper module for association decorators
     module AssocDecoratorHelper
       class << self
-        def decorate_has_many_association(assoc)
-          assoc.empty? ? [] : decorator(assoc.klass).decorate(assoc)
+        def decorate_has_many_association(assoc, decorator_class: nil)
+          return [] if assoc.empty?
+          
+          decorator_class ||= decorator(assoc.klass)
+
+          decorator_class.decorate(assoc)
         end
 
-        def decorate_associated_object(assoc)
-          decorator(assoc.class).decorate(assoc)
+        def decorate_associated_object(assoc, decorator_class: nil)
+          decorator_class ||= decorator(assoc.class)
+
+          decorator_class.decorate(assoc)
         end
 
         def decorator(class_name)

data/lib/tramway/decorators/class_helper.rb

@@ -6,27 +6,31 @@ module Tramway
     module ClassHelper
       module_function
 
-      def decorator_class(object_or_array, decorator = nil)
+      def decorator_class(object_or_array, decorator = nil, namespace = nil)
         raise_error_if_object_empty object_or_array, decorator
 
         return decorator if decorator.present?
 
         begin
-          class_name = decorator_class_name(object_or_array)
+          class_name = decorator_class_name(object_or_array, namespace)
           class_name.constantize
         rescue NameError
           raise NameError, "You should define #{class_name} decorator class."
         end
       end
 
-      def decorator_class_name(object_or_array)
-        klass = if Tramway::Decorators::CollectionDecorators.collection?(object_or_array)
-                  object_or_array.first.class
+      def decorator_class_name(object_or_array_or_class, namespace)
+        klass = if Tramway::Decorators::CollectionDecorators.collection?(object_or_array_or_class)
+                  object_or_array_or_class.first.class
+                elsif object_or_array_or_class.is_a?(Class)
+                  object_or_array_or_class
                 else
-                  object_or_array.class
+                  object_or_array_or_class.class
                 end
 
-        Tramway::Decorators::NameBuilder.default_decorator_class_name(klass)
+        base_class_name = Tramway::Decorators::NameBuilder.default_decorator_class_name(klass)
+
+        namespace.present? ? "#{namespace.to_s.camelize}::#{base_class_name}" : base_class_name
       end
 
       # :reek:NilCheck { enabled: false }

data/lib/tramway/forms/properties.rb

@@ -9,7 +9,23 @@ module Tramway
         def property(attribute)
           @properties << attribute
 
-          delegate attribute, to: :object
+          define_method(attribute) do
+            if object.respond_to?(attribute)
+              object.public_send(attribute)
+            else
+              raise NoMethodError, "#{self.class}##{attribute} is not defined"
+            end
+          end
+
+          set_method = "#{attribute}="
+
+          define_method(set_method) do |value|
+            if object.respond_to?(set_method)
+              object.public_send(set_method, value)
+            else
+              raise NoMethodError, "#{self.class}##{set_method} is not defined"
+            end
+          end
         end
 
         def properties(*attributes)

data/lib/tramway/helpers/decorate_helper.rb

@@ -8,12 +8,12 @@ module Tramway
     #
     module DecorateHelper
       # :reek:NilCheck { enabled: false } because checking for nil is not a type-checking issue but business logic
-      def tramway_decorate(object_or_array, decorator: nil)
+      def tramway_decorate(object_or_array, decorator: nil, namespace: nil)
         return [] if Tramway::Decorators::CollectionDecorators.collection?(object_or_array) && object_or_array.empty?
 
         return if object_or_array.nil?
 
-        Tramway::Decorators::ClassHelper.decorator_class(object_or_array, decorator).decorate object_or_array
+        Tramway::Decorators::ClassHelper.decorator_class(object_or_array, decorator, namespace).decorate object_or_array
       end
     end
   end

data/lib/tramway/helpers/navbar_helper.rb

@@ -6,8 +6,8 @@ module Tramway
   module Helpers
     # Provides navbar helpers for ActionView
     module NavbarHelper
-      def tramway_navbar(**options)
-        initialize_navbar
+      def tramway_navbar(with_entities: true, **options)
+        initialize_navbar(with_entities:)
 
         yield @navbar if block_given?
 
@@ -18,8 +18,8 @@ module Tramway
 
       private
 
-      def initialize_navbar
-        @navbar = Tramway::Navbar.new self
+      def initialize_navbar(with_entities:)
+        @navbar = Tramway::Navbar.new self, with_entities:
       end
 
       def assign_navbar_items(options)

data/lib/tramway/navbar.rb

@@ -5,16 +5,18 @@ module Tramway
   class Navbar
     attr_reader :items, :context
 
-    def initialize(context)
+    def initialize(context, with_entities:)
       @context = context
       @items = { left: [], right: [] }
       @filling = nil
 
-      entities = Tramway.config.entities
+      if with_entities
+        entities = Tramway.config.entities
 
-      return unless entities.any?
+        return unless entities.any?
 
-      preset_left entities
+        preset_left entities
+      end
     end
 
     def left

data/lib/tramway/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tramway
-  VERSION = '0.5.2.1'
+  VERSION = '0.5.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.5.2.1
+  version: 0.5.4
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-18 00:00:00.000000000 Z
+date: 2025-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -162,6 +162,8 @@ files:
 - app/components/tailwinds/form/select_component.rb
 - app/components/tailwinds/form/submit_button_component.html.haml
 - app/components/tailwinds/form/submit_button_component.rb
+- app/components/tailwinds/form/text_area_component.html.haml
+- app/components/tailwinds/form/text_area_component.rb
 - app/components/tailwinds/form/text_field_component.html.haml
 - app/components/tailwinds/form/text_field_component.rb
 - app/components/tailwinds/nav/item/button_component.html.haml
@@ -210,12 +212,14 @@ files:
 - app/views/tramway/layouts/application.html.haml
 - config/routes.rb
 - config/tailwind.config.js
+- lib/kaminari/helpers/tag.rb
 - lib/rules/turbo_html_attributes_rules.rb
 - lib/tasks/tramway_tasks.rake
 - lib/tramway.rb
 - lib/tramway/base_decorator.rb
 - lib/tramway/base_form.rb
 - lib/tramway/config.rb
+- lib/tramway/configs/entities/page.rb
 - lib/tramway/configs/entities/route.rb
 - lib/tramway/configs/entity.rb
 - lib/tramway/decorators/association.rb