tramway 0.5.5 → 0.5.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21ffe76c2224bd46292479de272ccdb59f0095075043507af3dd6098d5559933
-  data.tar.gz: 6547f3ac892439dddb165dbf7d8a06dcb90d8adb6f12b65d921cb277ebf7754a
+  metadata.gz: 7e2e7bd75d61196a4ba4302fe3c05d5dfce6928a35ea0d97022b9170ce911ca8
+  data.tar.gz: 1b89b1fb5a18ae6d28c8afb1b8a1d94da832f0855c1acf1f5ab4f9fb0f1d4bd7
 SHA512:
-  metadata.gz: 93bdfec725bc98cb5ab5a045604fe00c6669eaf8d89eedb081e0750a4b1073fda7c7f99964a3e4b8bbfb4f668024ca9341f512c5fed77d17ea05eeb31de19f37
-  data.tar.gz: 6d6d161386768b114e82e031888ce118383bfb377c6b5e1551d9f8b7300f077af50eb6cb2bff3a6d4523ab0f43bbc77b69b3af180ed4895d7b8c24558c1876a4
+  metadata.gz: 4565144363a3419833bb267231fc403ff49c1da50caa3ee4ec936d6a2245fc2ddf89ab111af33cc7a5759cd9bc51d90cc456e5108acc78b73e99ca7ea5107158
+  data.tar.gz: a83591d638a439dcd659474cfd50b73f9f292bff11fd2e18987c821df25888a9de4ae68d16fb2d7048eb36949869350339b8c3104ffaa71f92f97042d2a84ba9

data/README.md

@@ -14,6 +14,16 @@ Unite Ruby on Rails brilliance. Streamline development with Tramway.
   * [Tailwind-styled pagination](https://github.com/Purple-Magic/tramway?tab=readme-ov-file#tailwind-styled-pagination-for-kaminari)
 * [Articles](https://github.com/Purple-Magic/tramway#usage)
 
+## Compatibility
+
+Tramway is actively verified against the following Ruby and Rails versions.
+
+| Ruby \ Rails | 7.1 | 7.2 | 8.0 | 8.1 |
+| ------------- | --- | --- | --- | --- |
+| 3.2           | ✅  | ✅  | ✅  | ✅  |
+| 3.3           | ✅  | ✅  | ✅  | ✅  |
+| 3.4           | ✅  | ✅  | ✅  | ✅  |
+
 ## Installation
 Add this line to your application's Gemfile:
 
@@ -528,6 +538,38 @@ Tramway provides a responsive, tailwind-styled table with light and dark themes.
       Another
 ```
 
+`Tailwinds::TableComponent` accepts an optional `options` hash that is merged into the outer `.div-table` element. The hash is
+forwarded as HTML attributes, so you can pass things like `id`, `data` attributes, or additional classes. If you do not supply
+your own width utility (e.g. a class that starts with `w-`), the component automatically appends `w-full` to keep the table
+responsive. This allows you to extend the default styling without losing the sensible defaults provided by the component.
+
+```haml
+= component 'tailwinds/table', options: { class: 'max-w-3xl border border-gray-200', data: { controller: 'table' } } do
+  = component 'tailwinds/table/header', headers: ['Name', 'Email']
+  = component 'tailwinds/table/row' do
+    = component 'tailwinds/table/cell' do
+      = user.name
+    = component 'tailwinds/table/cell' do
+      = user.email
+```
+
+When you render a header you can either pass the `headers:` array, as in the examples above, or render custom header content in
+the block. `Tailwinds::Table::HeaderComponent` uses the length of the `headers` array to build the grid if the array is present.
+If you omit the array and provide custom content, pass the `columns:` argument so the component knows how many grid columns to
+generate.
+
+```haml
+= component 'tailwinds/table/header', columns: 4 do
+  = component 'tailwinds/table/cell' do
+    Custom header cell
+  = component 'tailwinds/table/cell' do
+    Another header cell
+  / ...
+```
+
+With this approach you control the header layout while still benefiting from the default Tailwind grid classes that the header
+component applies.
+
 ### 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

@@ -99,13 +99,7 @@ module Tailwinds
       end
 
       def default_options(attribute, options)
-        {
-          attribute:,
-          label: label_build(attribute, options),
-          for: for_id(attribute),
-          options:,
-          size: form_size
-        }
+        { attribute:, label: label_build(attribute, options), for: for_id(attribute), options:, size: form_size }
       end
 
       # :reek:UtilityFunction

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

@@ -1,8 +1,8 @@
 .mb-4
-    - if @label
-      - base_classes = 'inline-block bg-blue-500 hover:bg-blue-700 text-white font-bold rounded cursor-pointer mt-4 '
-      - base_classes += 'dark:bg-blue-600 dark:hover:bg-blue-500'
-      - classes = "#{size_class(:file_button)} #{base_classes}"
-      %label{ for: @for, class: classes }
-        = @label
+  - if @label
+    - base_classes = 'inline-block bg-blue-500 hover:bg-blue-700 text-white font-bold rounded cursor-pointer mt-4 '
+    - base_classes += 'dark:bg-blue-600 dark:hover:bg-blue-500'
+    - classes = "#{size_class(:file_button)} #{base_classes}"
+    %label{ for: @for, class: classes }
+      = @label
   = @input

data/app/components/tailwinds/form/multiselect/select_as_input.html.haml

@@ -2,11 +2,4 @@
   - base_classes = 'bg-transparent appearance-none outline-none h-full w-full text-gray-800 hidden '
   - base_classes += 'dark:text-white dark:placeholder-white'
   - classes = "#{@size_class} #{base_classes}"
-  = @input.call(
-    @attribute,
-    @options.merge(
-      placeholder: "{{placeholder}}",
-      class: classes,
-      data: { 'multiselect-target' => 'hiddenInput' }
-    )
-  )
+  = @input.call(@attribute, @options.merge(placeholder: "{{placeholder}}", class: classes, data: { 'multiselect-target' => 'hiddenInput' }))

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

@@ -12,26 +12,22 @@ module Tailwinds
         default_attributes = { role: :row }
 
         if href.present?
-          klass = "#{options[:class] || ''} #{link_row_classes}"
-
-          link_to(href, options.merge(class: klass, **default_attributes)) do
+          link_to(href, options.merge(class: "#{options[:class] || ''} #{link_row_classes}", **default_attributes)) do
             yield if block_given?
           end
         else
-          tag.div(**options.merge(default_attributes)) do
+          tag.div(**options, **default_attributes) do
             yield if block_given?
           end
         end
       end
 
-      # :reek:UtilityFunction { enabled: false }
       def desktop_row_classes(cells_count)
         [
           'div-table-row', 'grid', 'gap-4', 'bg-white', 'border-b', 'last:border-b-0', 'dark:bg-gray-800',
           'dark:border-gray-700', "grid-cols-#{cells_count}"
         ].join(' ')
       end
-      # :reek:UtilityFunction { enabled: true }
 
       def link_row_classes
         'cursor-pointer hover:bg-gray-100 dark:hover:bg-gray-700'

data/app/controllers/tramway/entities_controller.rb

@@ -11,11 +11,13 @@ module Tramway
     include Rails.application.routes.url_helpers
 
     def index
-      @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])
+      if index_scope.present?
+        model_class.public_send(index_scope)
+      else
+        model_class.order(id: :desc)
+      end.page(params[:page]) => entities
+
+      @entities = entities
 
       @namespace = entity.route&.namespace
     end
@@ -29,5 +31,9 @@ module Tramway
     def entity
       @entity ||= Tramway.config.entities.find { |e| e.name == params[:entity][:name] }
     end
+
+    def index_scope
+      entity.page(:index).scope
+    end
   end
 end

data/config/routes.rb

@@ -3,13 +3,13 @@
 Tramway::Engine.routes.draw do
   Tramway.config.entities.each do |entity|
     segments      = entity.name.split('/')
-    resource_name = segments.pop          
+    resource_name = segments.pop
 
     define_resource = proc do
       resources resource_name.pluralize.to_sym,
-                only:      [:index],
-                controller:'/tramway/entities',
-                defaults:   { entity: entity }
+                only: [:index],
+                controller: '/tramway/entities',
+                defaults: { entity: entity }
     end
 
     if segments.empty?

data/lib/tramway/base_form.rb

@@ -50,7 +50,7 @@ module Tramway
     end
 
     def method_missing(method_name, *args)
-      if method_name.to_s.end_with?('=') && args.count == 1
+      if method_name.to_s.end_with?('=') && args.one?
         object.public_send(method_name, args.first)
       else
         super

data/lib/tramway/decorators/association.rb

@@ -40,7 +40,7 @@ module Tramway
       class << self
         def decorate_has_many_association(assoc, decorator_class: nil)
           return [] if assoc.empty?
-          
+
           decorator_class ||= decorator(assoc.klass)
 
           decorator_class.decorate(assoc)

data/lib/tramway/decorators/class_helper.rb

@@ -20,26 +20,19 @@ module Tramway
       end
 
       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_or_class.class
-                end
+        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_or_class.class
+        end => klass
 
         base_class_name = Tramway::Decorators::NameBuilder.default_decorator_class_name(klass)
 
-        klass_name = namespace.present? ? "#{namespace.to_s.camelize}::#{base_class_name}" : base_class_name
-
-        if klass_name.safe_constantize
-          klass_name
-        else
-          raise NameError, "You should define #{klass_name} decorator class in app/decorators/ folder."
-        end
+        build_klass_name(base_class_name, namespace)
       end
 
-      # :reek:NilCheck { enabled: false }
       def raise_error_if_object_empty(object_or_array, decorator)
         return unless object_or_array.blank? && decorator.nil?
 
@@ -47,7 +40,16 @@ module Tramway
 
         raise ArgumentError, text
       end
-      # :reek:NilCheck { enabled: true }
+
+      def build_klass_name(base_class_name, namespace)
+        klass_name = namespace.present? ? "#{namespace.to_s.camelize}::#{base_class_name}" : base_class_name
+
+        unless klass_name.safe_constantize
+          raise NameError, "You should define #{klass_name} decorator class in app/decorators/ folder."
+        end
+
+        klass_name
+      end
     end
   end
 end

data/lib/tramway/forms/properties.rb

@@ -10,21 +10,17 @@ module Tramway
           @properties << attribute
 
           define_method(attribute) do
-            if object.respond_to?(attribute)
-              object.public_send(attribute)
-            else
-              raise NoMethodError, "#{self.class}##{attribute} is not defined"
-            end
+            raise NoMethodError, "#{self.class}##{attribute} is not defined" unless object.respond_to?(attribute)
+
+            object.public_send(attribute)
           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
+            raise NoMethodError, "#{self.class}##{set_method} is not defined" unless object.respond_to?(set_method)
+
+            object.public_send(set_method, value)
           end
         end
 

data/lib/tramway/navbar.rb

@@ -10,13 +10,13 @@ module Tramway
       @items = { left: [], right: [] }
       @filling = nil
 
-      if with_entities
-        entities = Tramway.config.entities
+      return unless with_entities
 
-        return unless entities.any?
+      entities = Tramway.config.entities
 
-        preset_left entities
-      end
+      return unless entities.any?
+
+      preset_left entities
     end
 
     def left

data/lib/tramway/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: 0.5.5.1
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-14 00:00:00.000000000 Z
+date: 2025-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config