tramway 2.3.1.4 → 3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20f2a11f56484a9763bbb712c8bbf2c09558d9ad098b886849ee87429e379a19
-  data.tar.gz: b5b9a13a2e084cd82fd09c9d4451c8cb2d59a4dd08198968eb8165d34a7dcfc0
+  metadata.gz: 6dc5de667eeeb4db78705dc65c49743449c5c14ef4bb2fe45159fd8a5abd209b
+  data.tar.gz: fdb10f35b0ed3e6b20fc048044418a5b78a846bc4c4383ff6090981a884df325
 SHA512:
-  metadata.gz: c0a2569b1767b5e8c7e65b88f03124c67e845ce2db8999574255e1353135770f06dfe932d3b4d3601ad9bd3bfd0573dc4f217b7e211c502a67414a0e757b3239
-  data.tar.gz: d6d354cef03905530fc1f959a5768e2682008b14a10a9b34d03a0065c7f07ed343eb3dac7e06c2a5d3a1136f3c149e8f81a62c360ace8c8a4bf7c5615b46b184
+  metadata.gz: 562e93acbe9f809cd7b7bbbedb2b4a860be4763b9aa2eb709b6b4cce904804303db6d7c652d2b591468c4d3fc72ac44df19d7251a1829f94a9a54ef92c494eb6
+  data.tar.gz: ec1b87e02459067629e2432cd938ef80d639398a06861700b0ee0cc6f854cb83760fffc85dd4488e8bc37303249cc71580dc0d186a3ec380a5bc083296584b64

data/README.md

@@ -194,6 +194,30 @@ end
 In this example, the `Campaign` entity will display only records returned by the `active` scope on its index page, while all
 other pages continue to show every record unless another scope is specified.
 
+**search**
+
+Search is disabled by default on index pages. Enable it per-entity by setting `search: true` on the `:index` page entry:
+
+*config/initializers/tramway.rb*
+```ruby
+Tramway.configure do |config|
+  config.entities = [
+    {
+      name: :campaign,
+      pages: [
+        {
+          action: :index,
+          search: true
+        }
+      ]
+    }
+  ]
+end
+```
+
+When search is enabled, Tramway uses `Model.search(query)` if defined. If not, it falls back to `Model.tramway_search(query)` and logs a warning.
+The fallback is generic and not tailored to your data structure, so it is not intended for long-term use and may be slow or not scalable.
+
 **show page**
 
 To render a show page for an entity, declare a `:show` action inside the `pages` array in
@@ -267,13 +291,13 @@ end
 
 **fields method**
 
-Use `form_fields` in your form class to customize which form helpers get rendered and which options are passed to them.
+Use `fields` in your form class to customize which form helpers get rendered and which options are passed to them.
 Each field must map to a form helper method name. When you need to pass options, use a hash where `:type` is the helper
 method name and the remaining keys are passed as named arguments.
 
 ```ruby
 class UserForm < Tramway::BaseForm
-  properties :email, :about_me, :user_type
+  properties :email, :about_me, :user_type, :score
 
   fields email: :email,
     name: :text,
@@ -284,7 +308,15 @@ class UserForm < Tramway::BaseForm
     user_type: {
       type: :select,
       collection: ['regular', 'user']
+    },
+    score: {
+      type: :number,
+      value: -> (object) { Score.find_by(user_id: object.id).value }
     }
+
+  def score=(value)
+    Score.find_by(user_id: object.id).update(value:)
+  end
 end
 ```
 
@@ -1091,14 +1123,27 @@ within the form will use the same size value.
 <% end %>
 ```
 
+Use `horizontal: true` to render a horizontal form layout.
+
+```erb
+<%= tramway_form_for @user, horizontal: true do |f| %>
+  <%= f.text_field :text %>
+  <%= f.submit 'Create User' %>
+<% end %>
+```
+
 Available form helpers:
 * text_field
 * email_field
+* number_field
+* text_area
 * password_field
 * file_field
+* check_box
 * select
 * date_field
 * datetime_field
+* time_field
 * multiselect ([Stimulus-based](https://github.com/Purple-Magic/tramway#stimulus-based-inputs))
 * submit
 
@@ -1177,19 +1222,6 @@ Tramway uses [Tailwind](https://tailwindcss.com/) by default. It has tailwind-st
 
 #### How to use
 
-*Gemfile*
-```ruby
-gem 'tramway'
-gem 'kaminari'
-```
-
-*config/initializers/tramway.rb*
-```ruby
-Tramway.configure do |config|
-  config.pagination = { enabled: true } # enabled is false by default
-end
-```
-
 *app/views/users/index.html.erb*
 ```erb
 <%= paginate @users %> <%# it will render tailwind-styled pagination buttons by default %>

data/app/components/tailwind_component.rb

@@ -58,7 +58,7 @@ class TailwindComponent < Tramway::BaseComponent
 
   def file_button_base_classes
     theme_classes(
-      classic: 'inline-block text-blue-100 font-semibold rounded-xl cursor-pointer mt-4 bg-blue-900 ' \
+      classic: 'inline-block text-white font-semibold rounded-xl cursor-pointer mt-4 bg-blue-600 ' \
                'hover:bg-blue-800 shadow-md'
     )
   end
@@ -83,6 +83,12 @@ class TailwindComponent < Tramway::BaseComponent
     )
   end
 
+  def default_container_classes
+    return if options[:horizontal]
+
+    'mb-4'
+  end
+
   def size_class(key)
     size_classes = SIZE_CLASSES.fetch(size) { SIZE_CLASSES[:medium] }
     size_classes.fetch(key) { SIZE_CLASSES[:medium].fetch(key) }

data/app/components/tramway/chats/message_component.rb

@@ -30,7 +30,7 @@ module Tramway
 
       def array_2d?(array)
         array.is_a?(Array) && array.all? do |inner|
-          inner.is_a?(Array) && inner.none? { |e| e.is_a?(Array) }
+          inner.is_a?(Array) && inner.none?(Array)
         end
       end
 

data/app/components/tramway/comments/show_path_component.html.haml

@@ -0,0 +1,4 @@
+- unless Rails.env.production?
+  / ==== COMMENTS FROM TRAMWAY ====
+  / You should set `show_path` method in #{decorator_class} to make the row below clickable and redirect to the associated record's show page.
+  / ==== COMMENTS FROM TRAMWAY ====

data/app/components/tramway/comments/show_path_component.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Comments
+    # HTML comment that shows in case `show_path` is needed but it's empty
+    # It does not show for Rails.env.production
+    class ShowPathComponent < Tramway::BaseComponent
+      option :decorator_class
+    end
+  end
+end

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

@@ -11,9 +11,14 @@ module Tramway
       include Tramway::ColorsMethods
 
       def initialize(object_name, object, template, options)
+        @horizontal = options[:horizontal] || false
+
+        options.merge!(class: [options[:class], 'flex flex-row items-center gap-2'].compact.join(' ')) if @horizontal
+
         super
 
         @form_size = options[:size] || options['size'] || :medium
+        @form_object_class = options[:form_object_class]
       end
 
       def common_field(component_name, input_method, attribute, **options, &)
@@ -62,6 +67,10 @@ module Tramway
         common_field(:datetime_field, :datetime_field, attribute, **, &)
       end
 
+      def time_field(attribute, **, &)
+        common_field(:time_field, :time_field, attribute, **, &)
+      end
+
       def file_field(attribute, **options, &)
         sanitized_options = sanitize_options(options)
         input = super(attribute, **sanitized_options.merge(class: :hidden))
@@ -118,12 +127,22 @@ module Tramway
         unbound_method.bind(self)
       end
 
+      def form_object
+        @form_object_class&.new object
+      end
+
       def get_value(attribute, options)
-        options[:value] || object.presence&.public_send(attribute)
+        options[:value] || form_object&.public_send(attribute).presence || object.presence&.public_send(attribute)
       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: options.merge(horizontal: @horizontal),
+          size: form_size
+        }
       end
 
       def label_build(attribute, options)

data/app/components/tramway/form/checkbox_component.html.haml

@@ -1,4 +1,4 @@
-.flex.items-start.gap-2.mb-4
+.flex.items-start.gap-2{ class: default_container_classes }
   - classes = "#{size_class(:checkbox_input)} #{checkbox_base_classes}"
   = @input.call @attribute, **@options.merge(class: classes)
   - if @label

data/app/components/tramway/form/date_field_component.html.haml

@@ -1,6 +1,6 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label
-- classes = "#{size_class(:text_input)} #{text_input_base_classes}"
-= @input.call @attribute, **@options.merge(class: classes), value: @value
+  - classes = "#{size_class(:text_input)} #{text_input_base_classes}"
+  = @input.call @attribute, **@options.merge(class: classes), value: @value

data/app/components/tramway/form/datetime_field_component.html.haml

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

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

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     - classes = "#{size_class(:file_button)} #{file_button_base_classes}"
 

data/app/components/tramway/form/multiselect_component.html.haml

@@ -1,4 +1,4 @@
-.mb-4.relative
+.relative{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

data/app/components/tramway/form/number_field_component.html.haml

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

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

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

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

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

data/app/components/tramway/form/text_field_component.html.haml

@@ -1,4 +1,4 @@
-.mb-4
+%div{ class: default_container_classes }
   - if @label
     = component('tramway/form/label', for: @for) do
       = @label

data/app/components/tramway/form/time_field_component.html.haml

@@ -0,0 +1,6 @@
+%div{ class: default_container_classes }
+  - if @label
+    = component('tramway/form/label', for: @for) do
+      = @label
+  - classes = "#{size_class(:text_input)} #{text_input_base_classes}"
+  = @input.call @attribute, **@options.merge(class: classes), value: @value

data/app/components/tramway/form/time_field_component.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Form
+    # Tailwind-styled time field
+    class TimeFieldComponent < TailwindComponent
+    end
+  end
+end

data/app/controllers/tramway/entities_controller.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'tramway/warnings'
+
 module Tramway
   # Main controller for entities pages
   class EntitiesController < Tramway.config.application_controller.constantize
@@ -15,8 +17,10 @@ module Tramway
         model_class.public_send(index_scope)
       else
         model_class.order(id: :desc)
-      end.page(params[:page]) => entities
+      end => entities
 
+      entities = search(entities)
+      entities = entities.page(params[:page])
       @entities = entities
 
       @namespace = entity.namespace
@@ -84,18 +88,49 @@ module Tramway
     end
 
     def set_associations
-      @associations = @record.show_associations.map do |association|
-        next unless @record.public_send(association).any?
-
-        records = Kaminari.paginate_array(@record.public_send(association.name)).page(params[:page])
+      @associations = @record.show_associations.map do |(association, options)|
+        options ||= {}
+        association_type = @record.object.class.reflect_on_association(association).macro
 
         {
           name: association,
-          decorator: records.first.class,
-          records:,
-          model_class: records.first.object.class
+          association_type:,
+          **send("#{association_type}_associations", association, options)
         }
       end.compact
     end
+
+    # rubocop:disable Naming/PredicatePrefix
+    def has_many_associations(association, options)
+      records = Kaminari.paginate_array(@record.public_send(association.name)).page(params[:page])
+
+      {
+        decorator: records.first&.class,
+        records:,
+        model_class: records.first&.object&.class,
+        new_record_path: options[:new_record_path]
+      }
+    end
+    # rubocop:enable Naming/PredicatePrefix
+
+    def belongs_to_associations(association, _options)
+      record = @record.public_send(association.name)
+
+      { decorator: record.class, record:, model_class: record.class }
+    end
+
+    def search(entities)
+      query = params[:query]
+
+      if entity.page(:index).search && query.present?
+        return entities.search(query) if entities.respond_to?(:search)
+
+        Tramway::Warnings.search_fallback model_class
+
+        return entities.tramway_search(query)
+      end
+
+      entities
+    end
   end
 end

data/app/views/kaminari/_paginator.html.haml

@@ -1,5 +1,5 @@
 = paginator.render do
-  %nav.pagination.flex.items-center.justify-center.space-x-1
+  %nav.pagination.flex.items-center.justify-center.gap-x-1
     = first_page_tag unless current_page.first? 
     = prev_page_tag unless current_page.first?
     - each_page do |page|
@@ -9,4 +9,3 @@
         = gap_tag
     = next_page_tag unless current_page.last?
     = last_page_tag unless current_page.last?
-

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

@@ -10,8 +10,12 @@
         - @record.errors.full_messages.each do |message|
           %li= message
 
+  - prepolulated_values = params[@entity.name.to_param]&.compact || {}
+
   - @record.class.fields.each do |(attribute, field_type)|
-    = f.tramway_field field_type, attribute
+    = f.tramway_field field_type, attribute,
+      value: prepolulated_values&.dig(attribute),
+      label: @model_class.human_attribute_name(attribute)
 
   .flex.flex-row.space-x-2
     = f.submit t('tramway.actions.save')

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

@@ -10,15 +10,21 @@
     = tramway_title do
       = content_for :title
 
-    - if Tramway.config.pagination[:enabled]
-      = paginate @entities, custom_path_method:
-  = component 'tramway/actions_buttons_container' do
-    - if @entity.page(:create).present?
-      = tramway_button text: t('tramway.actions.new'),
-        path: Tramway::Engine.routes.url_helpers.public_send(@entity.routes.new),
-        type: :will
+    = component 'tramway/actions_buttons_container' do
+      - if @entity.page(:create).present?
+        = tramway_button text: t('tramway.actions.new'),
+          path: Tramway::Engine.routes.url_helpers.public_send(@entity.routes.new),
+          type: :will
 
-    = decorator.constantize.index_header_content.call(@entities) if decorator.constantize.index_header_content.present?
+      = decorator.constantize.index_header_content.call(@entities) if decorator.constantize.index_header_content.present?
+
+  .flex.flex-row.justify-end.mt-2.gap-4
+    - if @entity.page(:index).search
+      = form_with url: public_send(custom_path_method), method: :get, local: true, builder: Tramway::Form::Builder, horizontal: true do |f|
+        = f.text_field :query, label: false, value: params[:query], placeholder: t('tramway.actions.search')
+        = f.submit t('tramway.actions.search')
+
+    = paginate @entities, custom_path_method:
 
   - if index_attributes.empty?
     %p.text-center.mt-10
@@ -30,6 +36,5 @@
       - @entities.each do |item|
         = component 'tramway/entity', entity: @entity, item: item
 
-      - if Tramway.config.pagination[:enabled]
-        .flex.mt-4
-          = paginate @entities, custom_path_method:
+      .flex.mt-4
+        = paginate @entities, custom_path_method:

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

@@ -20,11 +20,20 @@
       = @record.show_header_content
 
   - if @record.show_attributes.empty?
-    %p.text-center.mt-10
+    %p.text-center.mt-10.text-white
       You should fill object-level method `show_attributes` inside your
       = @record.class.name
 
   = tramway_table class: 'mt-4' do
+    - @associations.select { _1[:association_type] == :belongs_to }.each do |association|
+      - if association[:record].show_path.blank?
+        = component 'tramway/comments/show_path', decorator_class: association[:record].class.name
+      = tramway_row href: association[:record].show_path do
+        = tramway_cell do
+          = @model_class.human_attribute_name(association[:name])
+        = tramway_cell do
+          = association[:record].title
+
     - @record.show_attributes.each do |attribute|
       = tramway_row do
         = tramway_cell do
@@ -32,26 +41,37 @@
         = tramway_cell do
           = @record.public_send(attribute)
 
-  - @associations.each do |association|
-    .flex.flex-row.justify-between.mt-8
+  - @associations.select { _1[:association_type] == :has_many }.each do |association|
+    .flex.flex-row.justify-between.mt-8.text-white
       %h3.text-2xl.font-bold
         = @model_class.human_attribute_name(association[:name])
 
-      %div
-        = paginate association[:records],
-          custom_path_method: @entity.index_helper_method,
-          custom_path_arguments: [@record.id]
+      - if association[:records].any?
+        %div
+          = paginate association[:records],
+            custom_path_method: @entity.index_helper_method,
+            custom_path_arguments: [@record.id]
 
-    = tramway_table class: 'mt-4' do 
-      = tramway_header headers: association[:decorator].table_headers(model_class: association[:model_class])
+      = tramway_button text: t('tramway.actions.new'),
+        path: association[:new_record_path],
+        type: :will
+
+    - if association[:records].any?
+      = tramway_table class: 'mt-4' do 
+        = tramway_header headers: association[:decorator].table_headers(model_class: association[:model_class])
 
-      - association[:records].each do |record|
-        = tramway_row do
-          - association[:decorator].index_attributes.each do |column|
-            = tramway_cell do
-              = record.public_send(column)
+        - association[:records].each do |record|
+          - if record.show_path.blank?
+            = component 'tramway/comments/show_path', decorator_class: association[:decorator].name
+          = tramway_row href: record.show_path do
+            - if association[:decorator].index_attributes.empty?
+              .text-white
+                You should set `index_attributes` method in #{association[:decorator].name} to display the table of associated records.
+            - association[:decorator].index_attributes.each do |column|
+              = tramway_cell do
+                = record.public_send(column)
 
-    .mt-4
-      = paginate association[:records],
-        custom_path_method: @entity.index_helper_method,
-        custom_path_arguments: [@record.id]
+      .mt-4
+        = paginate association[:records],
+          custom_path_method: @entity.index_helper_method,
+          custom_path_arguments: [@record.id]

data/config/locales/en.yml

@@ -11,6 +11,7 @@ en:
       destroy: "Destroy"
       save: "Save"
       cancel: "Cancel"
+      search: "Search"
     notices:
       created: "The record is created"
       updated: "The record is updated"

data/config/routes.rb

@@ -14,7 +14,7 @@ Tramway::Engine.routes.draw do
     resource_name = segments.pop
 
     define_resource = proc do
-      actions = entity.pages.reduce([]) do |acc, page|
+      entity.pages.reduce([]) do |acc, page|
         case page.action
         when 'index'
           acc << :index
@@ -29,7 +29,7 @@ Tramway::Engine.routes.draw do
         else
           acc
         end
-      end
+      end => actions
 
       resources resource_name.pluralize.to_sym,
                 only: actions.map(&:to_sym),

data/config/tailwind.config.js

@@ -195,6 +195,7 @@ module.exports = {
 
     // === Pagination styles ===
     'hover:bg-gray-300',
+    'gap-x-1',
 
     // === Dark mode pagination styles ===
     'bg-gray-900',
@@ -331,6 +332,7 @@ module.exports = {
     'border-red-600',
     'bg-red-100',
     'text-red-800',
+    'space-x-2',
 
     // === Multiselect dropdown positioning ===
     'absolute',

data/docs/AGENTS.md

@@ -105,6 +105,28 @@ end
 
 If admin panel requested to be implemented from scratch, do the same with `namespace: :admin`
 
+### Rule 1.1
+Search is disabled by default on index pages. Enable it with `search: true` on the `:index` page definition:
+
+```ruby
+Tramway.configure do |config|
+  config.entities = [
+    {
+      name: :participant,
+      pages: [
+        {
+          action: :index,
+          search: true
+        }
+      ]
+    }
+  ]
+end
+```
+
+If `Model.search` exists, Tramway uses it. Otherwise it falls back to `Model.tramway_search` and logs a warning.
+The fallback is generic, not tailored to the data structure, and should not be used long-term because it may be slow or not scalable.
+
 ### Rule 2
 Normalize input with `normalizes` (from Tramway) for attributes like email, phone, etc. Don't use `normalizes` in model unless it requested explicitly.
 
@@ -133,6 +155,21 @@ Use Tramway Button for buttons. Always add a color of the button via `color:` or
 ### Rule 7
 Use `tramway_form_for` instead `form_with`, `form_for`
 
+Available `tramway_form_for` helpers:
+- `text_field`
+- `email_field`
+- `number_field`
+- `text_area`
+- `password_field`
+- `file_field`
+- `check_box`
+- `select`
+- `date_field`
+- `datetime_field`
+- `time_field`
+- `multiselect`
+- `submit`
+
 ### Rule 8
 Inherit all components from Tramway::BaseComponent
 
@@ -150,21 +187,32 @@ it raises `ArgumentError`. `chat_id` must match the stream id used in `tramway_c
 ### Rule 9
 If page `create` or `update` is configured for an entity, use Tramway Form pattern for forms. Visible fields are configured via `form_fields` method.
 
-Use form_fields in your form class to customize which form helpers get rendered and which options are passed to them. Each field must map to a form helper method name. When you need to pass options, use a hash where :type is the helper method name and the remaining keys are passed as named arguments.
+Use `fields` in your form class to customize which form helpers get rendered and which options are passed to them. Each field must map to a form helper method name. When you need to pass options, use a hash where :type is the helper method name and the remaining keys are passed as named arguments.
 
 Example:
 
-*app/forms/user_form.rb*:
 ```ruby
 class UserForm < Tramway::BaseForm
-  properties :email, :about_me
+  properties :email, :about_me, :user_type, :score
 
   fields email: :email,
     name: :text,
     about_me: {
       type: :text_area,
       rows: 5
+    },
+    user_type: {
+      type: :select,
+      collection: ['regular', 'user']
+    },
+    score: {
+      type: :number,
+      value: -> (object) { Score.find_by(user_id: object.id).value }
     }
+
+  def score=(value)
+    Score.find_by(user_id: object.id).update(value:)
+  end
 end
 ```
 
@@ -537,6 +585,25 @@ class ParticipantsController < ApplicationController
 end
 ```
 
+`tramway_form_for` example
+
+```ruby
+= tramway_form_for @user do |f|
+  = f.email_field :email
+  = f.password_field :password
+  = f.select :role, [["Admin", "admin"], ["Manager", "manager"]], include_blank: "Select role"
+  = f.submit 'Save'
+```
+
+`tramway_form_for` supports `horizontal: true` for horizontal form layout.
+
+```ruby
+= tramway_form_for @user, horizontal: true do |f|
+  = f.email_field :email
+  = f.password_field :password
+  = f.submit 'Save'
+```
+
 
 ---
 

data/lib/tramway/config.rb

@@ -11,7 +11,6 @@ module Tramway
     include Singleton
 
     attr_config(
-      pagination: { enabled: false },
       entities: [],
       application_controller: 'ActionController::Base',
       theme: :classic

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

@@ -8,6 +8,7 @@ module Tramway
       class Page < Dry::Struct
         attribute :action, Types::Coercible::String
         attribute? :scope, Types::Coercible::String
+        attribute? :search, Types::Bool
       end
     end
   end

data/lib/tramway/engine.rb

@@ -13,7 +13,7 @@ module Tramway
       load_form_helper
       load_routes_helper
       load_chats_broadcast
-      configure_pagination if Tramway.config.pagination[:enabled]
+      load_searchable
     end
 
     initializer 'tramway.assets.precompile' do |app|
@@ -78,6 +78,14 @@ module Tramway
       end
     end
 
+    def load_searchable
+      ActiveSupport.on_load(:active_record) do |loaded_class|
+        require 'tramway/searchable'
+
+        loaded_class.include Tramway::Searchable
+      end
+    end
+
     def configure_pagination
       ActiveSupport.on_load(:action_controller) do
         # Detecting tramway views path

data/lib/tramway/helpers/views_helper.rb

@@ -9,10 +9,12 @@ module Tramway
       FORM_SIZES = %i[small medium large].freeze
 
       def tramway_form_for(object, *, size: :medium, **options, &)
+        form_object_class = object.is_a?(Tramway::BaseForm) ? object.class : nil
+
         form_for(
           object,
           *,
-          **options.merge(builder: Tramway::Form::Builder, size: normalize_form_size(size)),
+          **options.merge(builder: Tramway::Form::Builder, size: normalize_form_size(size), form_object_class:),
           &
         )
       end

data/lib/tramway/searchable.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Tramway
+  # Searchable module provides a class method `tramway_search` for ActiveRecord models to perform full-text search
+  # across all string and text columns using PostgreSQL's full-text search capabilities.
+  module Searchable
+    extend ActiveSupport::Concern
+
+    class_methods do
+      def tramway_search(query)
+        tokens = search_tokens(query)
+        columns_to_search = searchable_column_names
+
+        return all if tokens.empty? || columns_to_search.empty?
+
+        where(
+          Arel.sql("to_tsvector('simple', #{tsvector_expression(columns_to_search)}) @@ to_tsquery('simple', ?)"),
+          tsquery_expression(tokens)
+        )
+      end
+
+      private
+
+      def search_tokens(query)
+        query.to_s.scan(/[[:alnum:]]+/)
+      end
+
+      def searchable_column_names
+        columns.select { |column| column.type.in?(%i[string text]) }.map(&:name)
+      end
+
+      def tsvector_expression(column_names)
+        column_names.map do |column_name|
+          "coalesce(#{connection.quote_column_name(column_name)}, '')"
+        end.join(" || ' ' || ")
+      end
+
+      def tsquery_expression(tokens)
+        tokens.map { |token| "#{token}:*" }.join(' & ')
+      end
+    end
+  end
+end

data/lib/tramway/utils/field.rb

@@ -7,7 +7,7 @@ module Tramway
       def tramway_field(field_data, attribute, **options, &)
         input_type = field_type(field_data)
         input_name = field_name input_type
-        input_options = field_options(field_data).merge(options)
+        input_options = field_options(field_data).merge(options.compact)
 
         case input_type.to_sym
         when :select, :multiselect
@@ -42,7 +42,7 @@ module Tramway
 
       def field_options(field_data)
         if field_data.is_a?(Hash)
-          value = field_data[:value]&.call
+          value = field_data[:value]&.call(object)
 
           field_data.merge(value:).except(:type)
         else

data/lib/tramway/version.rb

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

data/lib/tramway/warnings.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Tramway
+  # Warnings module provides methods to log warnings for different scenarios
+  module Warnings
+    module_function
+
+    def search_fallback(model_class)
+      Rails.logger.warn(
+        "Tramway search: `#{model_class}.search` is not defined. " \
+        "Falling back to `#{model_class}.tramway_search`. " \
+        'This is a generic fallback and not tailored to your data structure, ' \
+        'so it is not intended for long-term use and may be slow or not scalable.'
+      )
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 2.3.1.4
+  version: '3.0'
 platform: ruby
 authors:
 - kalashnikovisme
@@ -161,6 +161,8 @@ files:
 - app/components/tramway/chats/messages/table_component.html.haml
 - app/components/tramway/chats/messages/table_component.rb
 - app/components/tramway/colors_methods.rb
+- app/components/tramway/comments/show_path_component.html.haml
+- app/components/tramway/comments/show_path_component.rb
 - app/components/tramway/containers/main_component.html.haml
 - app/components/tramway/containers/main_component.rb
 - app/components/tramway/containers/narrow_component.html.haml
@@ -200,6 +202,8 @@ files:
 - app/components/tramway/form/text_area_component.rb
 - app/components/tramway/form/text_field_component.html.haml
 - app/components/tramway/form/text_field_component.rb
+- app/components/tramway/form/time_field_component.html.haml
+- app/components/tramway/form/time_field_component.rb
 - app/components/tramway/native_text_component.html.haml
 - app/components/tramway/native_text_component.rb
 - app/components/tramway/nav/item/button_component.html.haml
@@ -286,10 +290,12 @@ files:
 - lib/tramway/helpers/routes_helper.rb
 - lib/tramway/helpers/views_helper.rb
 - lib/tramway/navbar.rb
+- lib/tramway/searchable.rb
 - lib/tramway/utils/field.rb
 - lib/tramway/utils/render.rb
 - lib/tramway/version.rb
 - lib/tramway/views/form_builder.rb
+- lib/tramway/warnings.rb
 - lib/types.rb
 homepage: https://github.com/purple-magic/tramway
 licenses: