tramway 0.5.5 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21ffe76c2224bd46292479de272ccdb59f0095075043507af3dd6098d5559933
-  data.tar.gz: 6547f3ac892439dddb165dbf7d8a06dcb90d8adb6f12b65d921cb277ebf7754a
+  metadata.gz: ff761d41cd4748bf3d7e1451825da24764f69077b842e92f7be6baf0f14dff55
+  data.tar.gz: d9c3b25519ab3eb4dfe9c7d2e26d8dffb339a2743b6c5c494495bd4c5b71fc6c
 SHA512:
-  metadata.gz: 93bdfec725bc98cb5ab5a045604fe00c6669eaf8d89eedb081e0750a4b1073fda7c7f99964a3e4b8bbfb4f668024ca9341f512c5fed77d17ea05eeb31de19f37
-  data.tar.gz: 6d6d161386768b114e82e031888ce118383bfb377c6b5e1551d9f8b7300f077af50eb6cb2bff3a6d4523ab0f43bbc77b69b3af180ed4895d7b8c24558c1876a4
+  metadata.gz: bb0c9c5121dc9a8213a0011c07265b2c42a486218966725df559c31f48b1f1e0cbbb50dc7fd10ddaac13f00a14d55ae57be42e121a1c1d44b1560822425f54af
+  data.tar.gz: 4488ab5046c8fee6150ee80459df3859f0a2d8b62948cfb91af93052dce2f0788aa067dde8261c9df0708ad31c853c522adc65c91c907cc71b4418c17bfc4244

data/README.md

@@ -14,22 +14,33 @@ 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:
 
 ```ruby
 gem "tramway"
-gem "haml-rails"
-gem "kaminari"
-gem "view_component"
 ```
 
-OR
+Then install Tramway and its dependencies:
 
 ```shell
-bundle add tramway view_component kaminari view_component
+bundle install
+bin/rails g tramway:install
 ```
 
+The install generator adds the required gems (`haml-rails`, `kaminari`, `view_component`, and `dry-initializer`) to your
+application's Gemfile—if they are not present—and appends the Tailwind safelist configuration Tramway ships with.
+
 ## Getting Started
 
 **Step 1**
@@ -68,7 +79,9 @@ end
 
 **Step 4**
 
-Copy this [file](https://github.com/Purple-Magic/tramway/blob/main/config/tailwind.config.js) to config/tailwind.config.js
+If you ran `bin/rails g tramway:install`, the Tailwind safelist was already appended to `config/tailwind.config.js`.
+Otherwise, copy this [file](https://github.com/Purple-Magic/tramway/blob/main/config/tailwind.config.js) to
+`config/tailwind.config.js`.
 
 
 **Step 5**
@@ -528,6 +541,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).
@@ -539,6 +584,7 @@ Tramway provides `tramway_form_for` helper that renders Tailwind-styled forms by
 ```ruby
 = tramway_form_for @user do |f|
   = f.text_field :text
+  = f.email_field :email
   = f.password_field :password
   = f.select :role, [:admin, :user]
   = f.multiselect :permissions, [['Create User', 'create_user'], ['Update user', 'update_user']]
@@ -550,12 +596,38 @@ will render [this](https://play.tailwindcss.com/xho3LfjKkK)
 
 Available form helpers:
 * text_field
+* email_field
 * password_field
 * file_field
 * select
 * multiselect ([Stimulus-based](https://github.com/Purple-Magic/tramway#stimulus-based-inputs))
 * submit
 
+**Examples**
+
+1. Sign In Form for `devise` authentication
+
+*app/views/devise/sessions/new.html.haml*
+```haml
+  = tramway_form_for(resource, as: resource_name, url: session_path(resource_name), class: 'bg-white shadow-md rounded px-8 pt-6 pb-8 mb-4') do |f|
+    = component 'forms/errors', record: resource
+
+    = f.text_field :email, placeholder: "Your email"
+    = f.password_field :password, placeholder: "Your password"
+
+    = f.submit "Sign In"
+```
+
+2. Sign In Form for Rails authorization
+
+*app/views/sessions/new.html.haml*
+```haml
+= form_with url: login_path, scope: :session, local: true, builder: Tailwinds::Form::Builder do |form|
+    = form.email_field :email
+    = form.password_field :password
+    = form.submit "Log in"
+```
+
 #### Stimulus-based inputs
 
 `tramway_form_for` provides Tailwind-styled Stimulus-based custom inputs.

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

@@ -0,0 +1,2 @@
+%a.btn.btn-delete.bg-orange-500.hover:bg-orange-700.text-white.font-bold.py-2.px-4.rounded.ml-2{ onclick: "window.history.back(); return false;", href: '#' }
+  = t('actions.back')

data/app/components/tailwinds/back_button_component.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  # Backbutton component
+  class BackButtonComponent < BaseComponent
+  end
+end

data/app/components/tailwinds/base_component.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  # Shared base component for Tailwinds components
+  class BaseComponent < Tramway::Component::Base
+  end
+end

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

@@ -0,0 +1,12 @@
+- if text.present?
+  - if method == :get
+    = link_to text, path, class: classes, **options.except(:class)
+  - else
+    = button_to text, path, method:, class: classes, **options.except(:class)
+- else
+  - if method == :get
+    = link_to path, class: classes, **options.except(:class) do
+      = content
+  - else
+    = button_to path, method:, class: classes, **options.except(:class) do
+      = content

data/app/components/tailwinds/button_component.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  # Default Tramway button
+  #
+  class ButtonComponent < BaseComponent
+    option :text, optional: true, default: -> {}
+    option :path
+    option :color, default: -> { :blue }
+    option :type, default: -> { :default }
+    option :size, default: -> { :middle }
+    option :method, optional: true, default: -> { :get }
+    option :options, optional: true, default: -> { {} }
+
+    def size_classes
+      case size
+      when :small
+        'text-sm py-1 px-1'
+      when :middle
+        'py-2 px-4'
+      end
+    end
+
+    def classes
+      (default_classes +
+        light_mode_classes +
+        dark_mode_classes +
+        (method == :get ? %w[px-1 h-fit] : ['cursor-pointer'])).compact.join(' ')
+    end
+
+    def default_classes
+      [
+        'btn',
+        'btn-primary',
+        'font-bold',
+        'rounded-sm',
+        'flex',
+        'flex-row',
+        size_classes.to_s,
+        options[:class].to_s
+      ]
+    end
+
+    def light_mode_classes
+      [
+        "bg-#{color}-500",
+        "hover:bg-#{color}-700",
+        'text-white'
+      ]
+    end
+
+    def dark_mode_classes
+      [
+        "dark:bg-#{color}-600",
+        "dark:hover:bg-#{color}-800",
+        'dark:text-gray-300'
+      ]
+    end
+  end
+end

data/app/components/tailwinds/containers/narrow_component.html.haml

@@ -0,0 +1,3 @@
+.container.p-4.flex.align-center.justify-center.w-full.mx-auto.bg-gray-100.dark:bg-gray-900.text-gray-900.dark:text-white{ id: }
+  .flex.flex-col.justify-center.w-full.py-8.dark:text-white
+    = content

data/app/components/tailwinds/containers/narrow_component.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  module Containers
+    # Default page container in Tramway
+    class NarrowComponent < Tramway::Component::Base
+      option :id, optional: true, default: proc { SecureRandom.uuid }
+    end
+  end
+end

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

@@ -11,34 +11,33 @@ module Tailwinds
         @form_size = options[:size] || options['size'] || :middle
       end
 
-      def text_field(attribute, **options, &)
+      def common_field(component_name, input_method, attribute, **options, &)
         sanitized_options = sanitize_options(options)
 
-        render(Tailwinds::Form::TextFieldComponent.new(
-                 input: input(:text_field),
+        component_class = "Tailwinds::Form::#{component_name.to_s.camelize}Component".constantize
+
+        render(component_class.new(
+                 input: input(input_method),
                  value: get_value(attribute, sanitized_options),
                  **default_options(attribute, sanitized_options)
-               ), &)
+               ),
+               &)
       end
 
-      def number_field(attribute, **options, &)
-        sanitized_options = sanitize_options(options)
+      def text_field(attribute, **, &)
+        common_field(:text_field, :text_field, attribute, **, &)
+      end
 
-        render(Tailwinds::Form::NumberFieldComponent.new(
-                 input: input(:number_field),
-                 value: get_value(attribute, sanitized_options),
-                 **default_options(attribute, sanitized_options)
-               ), &)
+      def email_field(attribute, **, &)
+        common_field(:text_field, :email_field, attribute, **, &)
       end
 
-      def text_area(attribute, **options, &)
-        sanitized_options = sanitize_options(options)
+      def number_field(attribute, **, &)
+        common_field(:number_field, :number_field, attribute, **, &)
+      end
 
-        render(Tailwinds::Form::TextAreaComponent.new(
-                 input: input(:text_area),
-                 value: get_value(attribute, sanitized_options),
-                 **default_options(attribute, sanitized_options)
-               ), &)
+      def text_area(attribute, **, &)
+        common_field(:text_area, :text_area, attribute, **, &)
       end
 
       def password_field(attribute, **options, &)
@@ -95,17 +94,11 @@ module Tailwinds
       end
 
       def get_value(attribute, options)
-        options[:value] || object.public_send(attribute)
+        options[:value] || (object.present? ? object.public_send(attribute) : nil)
       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/config/tailwind.config.js

@@ -1,13 +1,25 @@
 module.exports = {
   safelist: [
+    // === Navbar ===
+    'ml-4',
+    
+    // === Custom table layout utilities ===
     'div-table',
     'div-table-row',
     'div-table-cell',
+    'sm:text-base',
+    'last:border-b-0',
+
+    // === Visibility and typography helpers ===
     'hidden',
+    'xl:hidden',
     'text-xl',
     'text-4xl',
     'font-bold',
-    'xl:hidden',
+    'text-right',
+
+    // === Grid templates used for configurable layouts ===
+    'grid',
     'grid-cols-1',
     'grid-cols-2',
     'grid-cols-3',
@@ -18,44 +30,112 @@ module.exports = {
     'grid-cols-8',
     'grid-cols-9',
     'grid-cols-10',
-    'text-right',
-    'w-2/3',
+
+    // === Page container and alignment helpers ===
+    'container',
+    'mx-auto',
+    'align-center',
+    'justify-center',
+
+    // === Flexbox layout utilities ===
     'flex',
-    'bg-purple-700',
+    'flex-col',
+    'flex-wrap',
+    'flex-row-reverse',
+    'flex-auto',
+    'flex-initial',
+    'justify-between',
+    'justify-end',
+    'space-x-1',
+    'items-center',
+
+    // === Responsive visibility helpers ===
+    'sm:hidden',
+    'sm:flex',
+
+    // === Sizing utilities ===
+    'w-2/3',
+    'w-full',
+    'w-fit',
+    'w-8',
+    'min-w-96',
+    'max-w-full',
+
+    // === Spacing utilities ===
+    'p-4',
     'px-6',
-    'px-3',
     'px-4',
+    'px-3',
+    'py-8',
     'py-4',
     'py-2',
     'mb-2',
-    'dark:placeholder-gray-400',
+    'mt-8',
+    'mt-2',
+
+    // === Pagination styles ===
+    'bg-white',
+    'rounded-md',
+    'hover:bg-purple-100',
+    'hover:bg-gray-100',
+    'hover:bg-gray-300',
+    'hover:text-gray-800',
+
+    // === Dark mode pagination styles ===
     'dark:text-white',
     'dark:bg-gray-800',
-    'dark:bg-gray-900',
     'dark:hover:bg-gray-700',
+    'dark:bg-gray-900',
     'dark:bg-gray-700',
     'dark:text-gray-400',
-    'dark:hover:bg-gray-700',
     'dark:hover:text-gray-400',
-    'ml-4',
-    'sm:text-base',
-    'sm:hidden',
-    'sm:flex',
-    'last:border-b-0',
-    'hover:bg-gray-100',
-    'hover:bg-gray-300',
-    'hover:text-gray-800',
-    'mt-8',
-    'justify-between',
-    'space-x-1',
-    'justify-end',
-    'mt-2',
+    'dark:placeholder-gray-400',
+
+    // === Button and badge helpers ===
+    'bg-purple-700',
+    'rounded',
+    'rounded-full',
+    'rounded-t',
+    'font-medium',
+    'font-normal',
+    'text-xs',
+
+    // === Form state helpers ===
     '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
-    'absolute', 'shadow', 'top-11', 'z-40', 'w-full', 'lef-0', 'rounded', 'max-h-select', 'overflow-y-auto', 'cursor-pointer', 'rounded-t', 'border-b', 'hover:bg-teal-100', 'items-center', 'border-transparent', 'border-l-2,', 'relative', 'hover:border-teal-100', 'leading-6', 'bg-transparent', 'appearance-none', 'outline-none', 'h-full' , 'justify-center', 'm-1', 'font-medium', 'rounded-full', 'text-teal-700', 'bg-teal-100', 'border', 'border-teal-300', 'text-xs', 'font-normal', 'leading-none', 'max-w-full', 'flex-initial', 'flex-auto', 'flex-row-reverse',, 'flex-col', 'min-w-96', 'w-fit', 'flex-wrap', 'w-8', 'border-l',
+    'mb-4',
+    'bg-red-500',
+    'hover:bg-red-700',
+
+    // === Multiselect dropdown positioning ===
+    'absolute',
+    'relative',
+    'shadow',
+    'top-11',
+    'z-40',
+    'left-0',
+    'max-h-select',
+    'overflow-y-auto',
+    'cursor-pointer',
+
+    // === Multiselect option styling ===
+    'border-b',
+    'border',
+    'border-l',
+    'border-l-2',
+    'border-transparent',
+    'border-teal-300',
+    'hover:border-teal-100',
+    'bg-teal-100',
+    'bg-transparent',
+    'text-teal-700',
+    'leading-6',
+    'leading-none',
+    'appearance-none',
+    'outline-none',
+    'h-full',
+    'm-1',
+    'hover:bg-teal-100',
   ],
 }

data/lib/generators/tramway/install/install_generator.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'fileutils'
+
+module Tramway
+  module Generators
+    # Running `rails generate tramway:install` will invoke this generator
+    #
+    class InstallGenerator < Rails::Generators::Base
+      desc 'Installs Tramway dependencies and Tailwind safelist configuration.'
+
+      def ensure_dependencies
+        missing_dependencies = gem_dependencies.reject do |dependency|
+          gemfile_contains?(dependency[:name])
+        end
+
+        return if missing_dependencies.empty?
+
+        append_to_file 'Gemfile', <<~GEMS
+
+          # Tramway dependencies
+          #{missing_dependencies.pluck(:declaration).join("\n")}
+
+        GEMS
+      end
+
+      def ensure_tailwind_safelist
+        return create_tailwind_config unless File.exist?(tailwind_config_path)
+
+        source_entries = extract_safelist_entries(File.read(gem_tailwind_config_path))
+        target_content = File.read(tailwind_config_path)
+        target_entries = extract_safelist_entries(target_content)
+
+        missing_entries = source_entries - target_entries
+        return if missing_entries.empty?
+
+        File.write(tailwind_config_path, insert_entries(target_content, missing_entries))
+      end
+
+      def ensure_tailwind_application_stylesheet
+        path = tailwind_application_stylesheet_path
+        FileUtils.mkdir_p(File.dirname(path))
+
+        return create_file(path, "#{tailwind_css_import_line}\n") unless File.exist?(path)
+
+        content = File.read(path)
+        return if content.include?(tailwind_css_import_line)
+
+        File.open(path, 'a') do |file|
+          file.write("\n") unless content.empty? || content.end_with?("\n")
+          file.write("#{tailwind_css_import_line}\n")
+        end
+      end
+
+      private
+
+      def gem_dependencies
+        @gem_dependencies ||= [
+          { name: 'haml-rails', declaration: 'gem "haml-rails"' },
+          { name: 'kaminari', declaration: 'gem "kaminari"' },
+          { name: 'view_component', declaration: 'gem "view_component"' },
+          { name: 'dry-initializer', declaration: "gem 'dry-initializer'" }
+        ]
+      end
+
+      def gemfile_path
+        @gemfile_path ||= File.join(destination_root, 'Gemfile')
+      end
+
+      def gemfile_contains?(name)
+        return false unless File.exist?(gemfile_path)
+
+        content = File.read(gemfile_path)
+        content.match?(/^\s*gem ['"]#{Regexp.escape(name)}['"]/)
+      end
+
+      def tailwind_config_path
+        @tailwind_config_path ||= File.join(destination_root, 'config/tailwind.config.js')
+      end
+
+      def gem_tailwind_config_path
+        @gem_tailwind_config_path ||= File.expand_path('../../../../config/tailwind.config.js', __dir__)
+      end
+
+      def tailwind_application_stylesheet_path
+        @tailwind_application_stylesheet_path ||= File.join(destination_root, 'app/assets/tailwind/application.css')
+      end
+
+      def tailwind_css_import_line
+        '@import "tailwindcss";'
+      end
+
+      def create_tailwind_config
+        create_file tailwind_config_path, File.read(gem_tailwind_config_path)
+      end
+
+      def extract_safelist_entries(content)
+        section = safelist_section(content)
+        return [] if section.nil?
+
+        section.scan(/'([^']+)'/).flatten.map(&:strip).reject(&:empty?).uniq
+      end
+
+      def safelist_section(content)
+        match = content.match(/safelist\s*:\s*\[(.*?)\]\s*,?/m)
+        match&.[](1)
+      end
+
+      def insert_entries(content, entries)
+        match = content.match(/safelist\s*:\s*\[(.*?)\](\s*,?)/m)
+        return content unless match
+
+        closing_index = match.begin(0) + match[0].rindex(']')
+        indentation = closing_indentation(content, closing_index)
+        formatted_entries = entries.map { |entry| "#{indentation}'#{entry}',\n" }.join
+
+        needs_leading_newline = content[closing_index - 1] != "\n"
+        insertion = String.new
+        insertion << "\n" if needs_leading_newline
+        insertion << formatted_entries
+
+        content.dup.insert(closing_index, insertion)
+      end
+
+      def closing_indentation(content, index)
+        line_start = content.rindex("\n", index - 1) || 0
+        line = content[line_start..index]
+        line[/^\s*/] || '  '
+      end
+    end
+  end
+end

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/helpers/views_helper.rb

@@ -12,6 +12,45 @@ module Tramway
           &
         )
       end
+
+      def tramway_table(**options, &)
+        component 'tailwinds/table', options:, &
+      end
+
+      def tramway_row(**options, &)
+        component 'tailwinds/table/row',
+                  cells: options.delete(:cells),
+                  href: options.delete(:href),
+                  options:,
+                  &
+      end
+
+      def tramway_cell(&)
+        component 'tailwinds/table/cell', &
+      end
+
+      def tramway_button(path:, text: nil, method: :get, **options)
+        component 'tailwinds/button',
+                  text:,
+                  path:,
+                  method:,
+                  color: options.delete(:color),
+                  type: options.delete(:type),
+                  size: options.delete(:size),
+                  options:
+      end
+
+      def tramway_back_button
+        component 'tailwinds/back_button'
+      end
+
+      def tramway_container(id: nil, &)
+        if id.present?
+          component 'tailwinds/containers/narrow', id: id, &
+        else
+          component 'tailwinds/containers/narrow', &
+        end
+      end
     end
   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.6'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.5.5
+  version: '0.6'
 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-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -143,6 +143,13 @@ files:
 - app/assets/javascripts/tramway/table_row_preview_controller.js
 - app/components/tailwind_component.html.haml
 - app/components/tailwind_component.rb
+- app/components/tailwinds/back_button_component.html.haml
+- app/components/tailwinds/back_button_component.rb
+- app/components/tailwinds/base_component.rb
+- app/components/tailwinds/button_component.html.haml
+- app/components/tailwinds/button_component.rb
+- app/components/tailwinds/containers/narrow_component.html.haml
+- app/components/tailwinds/containers/narrow_component.rb
 - app/components/tailwinds/form/builder.rb
 - app/components/tailwinds/form/file_field_component.html.haml
 - app/components/tailwinds/form/file_field_component.rb
@@ -214,6 +221,7 @@ files:
 - app/views/tramway/layouts/application.html.haml
 - config/routes.rb
 - config/tailwind.config.js
+- lib/generators/tramway/install/install_generator.rb
 - lib/kaminari/helpers/tag.rb
 - lib/rules/turbo_html_attributes_rules.rb
 - lib/tasks/tramway_tasks.rake