tramway 1.1.2.2 → 2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7daf328b2fd26510b8c32822ca6e8f1df91d72569e54f2a182e165f7654ff35e
-  data.tar.gz: d0bbdc12b3846410dff72d24cc195eb089c3cd3c692fa253c29752490bf7a078
+  metadata.gz: 0c779661b04c0ea3be53c76acdae493d703604e1dd3a2f48aad1c2121d6ea7d6
+  data.tar.gz: 41f3c46793abc8f3a6059b7be90ac1ef3eed8bebdf6e3c0bf880a8feac548f17
 SHA512:
-  metadata.gz: 133c3f109631e45ae41201406fdbee2ac4a18f9996cb4cfd96b8fe2f9e15fe9a620b2283bb47fa031fd9cddb637d6f292d13379924f5b26af9387602d6ba3ff4
-  data.tar.gz: fe76dc4556c28615eab0fcc894b37f381e665c120e5e3ad113a38bb4b1b825cb80b2b2a7be25c13270b6dceca97c3f629ca7cb62000b55c64debd10d21e1a40b
+  metadata.gz: e48c87f877ec8f72bb8554e4983be7f3e85c8845c117a862055db7f97a84cebc8c2e7cdbf272726f5be9f57b7ffed5505cef352482f98d5f503326f93ece247f
+  data.tar.gz: 20417c4f44f6e0dd627ff8770dd08473fba1093a517baff5aacfd803e5457baf0f9dde7c8425f4317fc35654fc064e4e28ac4d9fb57e1f0588d8ce2476968a92

data/README.md

@@ -786,6 +786,15 @@ Tramway ships with helpers for common UI patterns built on top of Tailwind compo
 
   All additional keyword arguments are forwarded to the underlying component as HTML attributes.
 
+  You can also pass HTML attributes for the generated `<form>` separately via `form_options:` while keeping button-specific
+  attributes in `options:`:
+
+  ```erb
+  <%= tramway_button path: user_path(user), text: 'Create',
+    form_options: { data: { turbo: false } },
+    options: { data: { controller: 'submit-once' } } %>
+  ```
+
   The `type` option maps semantic intent to Tailwind color families. The full set of supported values is:
 
   | Type | Color |

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

@@ -6,7 +6,7 @@
       %button{ type: :submit, name: :commit, class: classes, **options.except(:class) }
         = text
     - else
-      = button_to text, path, method:, class: classes, **options.except(:class)
+      = button_to text, path, method:, form: form_options, class: classes, **options.except(:class)
 - else
   - if link
     = link_to path, class: classes, **options.except(:class) do
@@ -16,5 +16,5 @@
       %button{ type: :submit, name: :commit, class: classes, **options.except(:class) }
         = content
     - else
-      = button_to path, method:, class: classes, **options.except(:class) do
+      = button_to path, method:, class: classes, form: form_options, **options.except(:class) do
         = content

data/app/components/tailwinds/button_component.rb

@@ -12,6 +12,7 @@ module Tailwinds
     option :method, optional: true, default: -> { :get }
     option :link, optional: true, default: -> { false }
     option :options, optional: true, default: -> { {} }
+    option :form_options, optional: true, default: -> { {} }
 
     def size_classes
       {

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

@@ -1,10 +1,13 @@
 # frozen_string_literal: true
 
+require 'tramway/utils/field'
+
 module Tailwinds
   module Form
     # Provides Tailwind-styled forms
-    # :reek:InstanceVariableAssumption
     class Builder < Tramway::Views::FormBuilder
+      include Tramway::Utils::Field
+
       def initialize(object_name, object, template, options)
         super
 
@@ -105,8 +108,6 @@ module Tailwinds
         { attribute:, label: label_build(attribute, options), for: for_id(attribute), options:, size: form_size }
       end
 
-      # :reek:UtilityFunction
-      # :reek:NilCheck
       def label_build(attribute, options)
         label_option = options[:label]
 
@@ -125,7 +126,6 @@ module Tailwinds
       end
 
       # REMOVE IT. WE MUST UNDERSTAND WHY INCLUDE_BLANK DOES NOT WORK
-      # :reek:UtilityFunction
       def explicitly_add_blank_option(collection, options)
         if options[:include_blank]
           collection = collection.to_a if collection.is_a? Hash

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

@@ -0,0 +1,5 @@
+%h1.font-bold.text-4xl.dark:text-white
+  - if text.present?
+    = text
+  - else
+    = content

data/app/components/tailwinds/title_component.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  # Title component
+  class TitleComponent < Tramway::BaseComponent
+    option :text
+  end
+end

data/app/controllers/tramway/entities_controller.rb

@@ -31,6 +31,22 @@ module Tramway
       set_associations
     end
 
+    def new
+      @record = tramway_form model_class.new, namespace: entity.namespace
+    end
+
+    # rubocop:disable Metrics/AbcSize
+    def create
+      @record = tramway_form model_class.new, namespace: entity.namespace
+
+      if @record.submit params[model_class.model_name.param_key]
+        redirect_to public_send(entity.show_helper_method, @record.id), notice: t('tramway.notices.created')
+      else
+        render :new
+      end
+    end
+    # rubocop:enable Metrics/AbcSize
+
     private
 
     def model_class

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

@@ -0,0 +1,17 @@
+= tramway_form_for @record, local: true, url: public_send(@entity.create_helper_method), method: :post do |f|
+  - if @record.errors.any?
+    .alert.alert-danger
+      %h4= "#{pluralize(@record.errors.count, 'error')} prohibited this record from being saved:"
+      %ul
+        - @record.errors.full_messages.each do |message|
+          %li= message
+
+  - @record.class.fields.each do |(attribute, field_type)|
+    = f.tramway_field field_type, attribute
+
+  .flex.flex-row.space-x-2
+    = f.submit t('tramway.actions.save')
+    = tramway_button text: t('tramway.actions.cancel'),
+      path: public_send(@entity.index_helper_method),
+      type: :secondary,
+      link: true

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

@@ -7,12 +7,17 @@
   - content_for :title, page_title
 
   .flex.justify-between.items-center
-    %h1.font-bold.text-4xl.dark:text-white
-      = content_for(:title)
+    = tramway_title do
+      = content_for :title
 
     - if Tramway.config.pagination[:enabled]
       = paginate @entities, custom_path_method:
   .flex.justify-end.mt-2
+    - 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?
 
   - if index_attributes.empty?

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

@@ -0,0 +1,5 @@
+= tramway_container do
+  = tramway_title text: t('tramway.pages.new.title', model_name: @record.object.model_name.human)
+
+  .mt-4
+    = render 'form'

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

@@ -27,7 +27,7 @@
 
       %div
         = paginate association[:records],
-          custom_path_method: "#{@model_class.model_name.to_s.underscore}_path",
+          custom_path_method: @entity.index_helper_method,
           custom_path_arguments: [@record.id]
 
     = tramway_table class: 'mt-4' do 
@@ -42,5 +42,5 @@
 
     .mt-4
       = paginate association[:records],
-        custom_path_method: "#{@model_class.model_name.to_s.underscore}_path",
+        custom_path_method: @entity.index_helper_method,
         custom_path_arguments: [@record.id]

data/app/views/tramway/layouts/application.html.haml

@@ -19,8 +19,39 @@
     / Includes all stylesheet files in app/assets/stylesheets
     = stylesheet_link_tag "tailwind", "data-turbo-track": "reload"
 
+    :css
+      @keyframes fadeout {
+        0% {
+          opacity: 1;
+        }
+
+        80% {
+          opacity: 1;
+        }
+
+        100% {
+          opacity: 0;
+        }
+      }
+
+      .flash {
+        animation: fadeout 2.7s ease-out forwards;
+      }
+
   %body.bg-gray-100.dark:bg-gray-900.text-gray-900.dark:text-white
     = tramway_navbar title: 'Tramway'
 
+    - if flash.any?
+      #flash-container.fixed.top-4.right-4.z-50.space-y-2
+        - if flash[:notice]
+          .flash.opacity-100.bg-green-700.text-white.px-4.py-2.rounded.shadow
+            .text-xl.font-bold
+              = flash[:notice]
+
+        - if flash[:alert]
+          .flash.opacity-100.bg-yellow-700.text-black.px-4.py-2.rounded.shadow
+            .text-xl.font-bold
+              = flash[:alert]
+
     .container.mx-auto.p-4.flex.align-center.justify-center
       = yield

data/config/locales/en.yml

@@ -0,0 +1,7 @@
+en:
+  tramway:
+    pages:
+      new:
+        title: "Create %{model_name}"
+    notices:
+      created: "The record is created"

data/config/routes.rb

@@ -14,22 +14,56 @@ Tramway::Engine.routes.draw do
     resource_name = segments.pop
 
     define_resource = proc do
-      entity.pages.each do |page|
+      actions = entity.pages.reduce([]) do |acc, page|
         case page.action
         when 'index'
-          get resource_name.pluralize, to: '/tramway/entities#index', defaults: { entity: }, as: resource_name.pluralize
+          acc << :index
         when 'show'
-          get "#{resource_name.pluralize}/:id", to: '/tramway/entities#show', defaults: { entity: },
-                                                as: resource_name.singularize
+          acc << :show
+        when 'create'
+          acc + %i[create new]
+        else
+          acc
         end
       end
+
+      resources resource_name.pluralize.to_sym,
+                only: actions.map(&:to_sym),
+                controller: '/tramway/entities',
+                defaults: { entity: }
+
+      # entity.pages.each do |page|
+      #   case page.action
+      #   when 'index'
+      #     get resource_name.pluralize,
+      #       to: '/tramway/entities#index',
+      #       defaults: { entity: },
+      #       as: resource_name.pluralize
+
+      #   when 'show'
+      #     get "#{resource_name.pluralize}/:id",
+      #       to: '/tramway/entities#show',
+      #       defaults: { entity: },
+      #       as: resource_name.singularize
+
+      #   when 'create'
+      #     post resource_name.pluralize,
+      #       to: '/tramway/entities#create',
+      #       defaults: { entity: }
+
+      #     get "#{resource_name.pluralize}/new",
+      #       to: '/tramway/entities#new',
+      #       defaults: { entity: }
+      #   end
+      # end
     end
 
     if segments.empty?
       define_resource.call
     else
       nest = lambda do |names|
-        namespace names.first.to_sym do
+        namespace_name = names.first.to_sym
+        namespace namespace_name do
           if names.size > 1
             nest.call(names.drop(1))
           else

data/config/tailwind.config.js

@@ -195,5 +195,22 @@ module.exports = {
     'h-full',
     'm-1',
     'hover:bg-teal-100',
+
+    // === Flash message styles ===
+    'fixed',
+    'top-6',
+    'right-4',
+    'z-50',
+    'space-y-2',
+    'flash',
+    'opacity-100',
+    'bg-green-700',
+    'text-white',
+    'px-4',
+    'py-2',
+    'rounded',
+    'shadow',
+    'bg-yellow-700',
+    'text-black'
   ],
 }

data/lib/tramway/base_form.rb

@@ -2,6 +2,7 @@
 
 require 'tramway/forms/properties'
 require 'tramway/forms/normalizations'
+require 'tramway/forms/fields'
 require 'tramway/duck_typing'
 
 module Tramway
@@ -9,6 +10,7 @@ module Tramway
   #
   class BaseForm
     include Tramway::Forms::Properties
+    include Tramway::Forms::Fields
     include Tramway::Forms::Normalizations
     include Tramway::DuckTyping::ActiveRecordCompatibility
 
@@ -24,6 +26,7 @@ module Tramway
       def inherited(subclass)
         __initialize_properties subclass
         __initialize_normalizations subclass
+        __initialize_fields subclass
 
         super
       end

data/lib/tramway/configs/entity.rb

@@ -13,7 +13,7 @@ module Tramway
       attribute? :namespace, Types::Coercible::String
 
       # Route Struct contains implemented in Tramway CRUD and helpful routes for the entity
-      ACTIONS = %i[index show].freeze
+      ACTIONS = %i[index show new create].freeze
       RouteStruct = Struct.new(*ACTIONS)
 
       # HumanName Struct contains human names forms for the entity
@@ -39,6 +39,22 @@ module Tramway
         pages.find { |page| page.action == name.to_s }
       end
 
+      def show_helper_method
+        build_helper_method(name, route:, namespace:, plural: false)
+      end
+
+      def index_helper_method
+        build_helper_method(name, route:, namespace:, plural: true)
+      end
+
+      def new_helper_method
+        build_helper_method(name, route:, namespace:, plural: false, action: :new)
+      end
+
+      def create_helper_method
+        build_helper_method(name, route:, namespace:, plural: true)
+      end
+
       private
 
       def pluralized(model_name)
@@ -55,11 +71,18 @@ module Tramway
 
       def route_helper_methods
         ACTIONS.map do |action|
-          page(action).present? ? send("#{action}_helper_method") : nil
+          case action
+          when :index, :show
+            page(action).present?
+          when :new, :create
+            page(:create).present?
+          end => existing_condition
+
+          send("#{action}_helper_method") if existing_condition
         end
       end
 
-      def build_helper_method(base_name, route: nil, namespace: nil, plural: false)
+      def build_helper_method(base_name, route: nil, namespace: nil, plural: false, action: nil)
         if plural
           base_name.to_s.parameterize.underscore.pluralize
         else
@@ -67,15 +90,10 @@ module Tramway
         end => underscored
 
         method_name = route.present? ? route.helper_method_by(underscored) : "#{underscored}_path"
-        namespace.present? ? "#{namespace}_#{method_name}" : method_name
-      end
 
-      def show_helper_method
-        build_helper_method(name, route:, namespace:, plural: false)
-      end
+        namespaced_method_name = namespace.present? ? "#{namespace}_#{method_name}" : method_name
 
-      def index_helper_method
-        build_helper_method(name, route:, namespace:, plural: true)
+        action.present? ? "#{action}_#{namespaced_method_name}" : namespaced_method_name
       end
 
       def route_helper_engine

data/lib/tramway/forms/fields.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Forms
+    # Provides field definitions for tramway_form_for
+    module Fields
+      # Class methods for defining fields
+      module ClassMethods
+        def fields(**attributes)
+          @fields.merge! attributes
+        end
+
+        def __initialize_fields(subclass)
+          subclass.instance_variable_set(:@fields, {})
+        end
+      end
+
+      def self.included(base)
+        base.extend ClassMethods
+      end
+    end
+  end
+end

data/lib/tramway/forms/properties.rb

@@ -38,7 +38,6 @@ module Tramway
           (__ancestor_properties + @properties).uniq
         end
 
-        # :reek:ManualDispatch { enabled: false }
         def __ancestor_properties(klass = superclass)
           superklass = klass.superclass
 
@@ -47,7 +46,6 @@ module Tramway
           klass.properties + __ancestor_properties(superklass)
         end
 
-        # :reek:UtilityFunction { enabled: false }
         def __initialize_properties(subclass)
           subclass.instance_variable_set(:@properties, [])
         end

data/lib/tramway/helpers/views_helper.rb

@@ -38,18 +38,12 @@ module Tramway
         component 'tailwinds/table/cell', &
       end
 
-      def tramway_button(path: nil, text: nil, method: :get, link: false, **options, &)
-        component 'tailwinds/button',
-                  text:,
-                  path:,
-                  method:,
-                  link:,
-                  color: options.delete(:color),
-                  type: options.delete(:type),
-                  size: options.delete(:size),
-                  options:,
-                  &
+      # rubocop:disable Metrics/ParameterLists
+      def tramway_button(path: nil, text: nil, method: :get, link: false, form_options: {}, **options, &)
+        component 'tailwinds/button', text:, path:, method:, link:, form_options:, color: options.delete(:color),
+                                      type: options.delete(:type), size: options.delete(:size), options:, &
       end
+      # rubocop:enable Metrics/ParameterLists
 
       def tramway_back_button
         component 'tailwinds/back_button'
@@ -69,6 +63,10 @@ module Tramway
                   type:,
                   color:
       end
+
+      def tramway_title(text: nil, &)
+        component 'tailwinds/title', text:, &
+      end
     end
   end
 end

data/lib/tramway/utils/field.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Utils
+    # Provides dynamic field rendering
+    module Field
+      def tramway_field(field_type, attribute, **, &)
+        if field_type.is_a?(Hash)
+          name = field_name(field_type[:type])
+          value = field_type[:value].call
+
+          public_send(name, attribute, value:, **, &)
+        else
+          public_send(field_name(field_type), attribute, **, &)
+        end
+      end
+
+      private
+
+      def field_name(field_type)
+        case field_type.to_sym
+        when :text_area, :select, :multiselect
+          field_type
+        else
+          "#{field_type}_field"
+        end
+      end
+    end
+  end
+end

data/lib/tramway/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 1.1.2.2
+  version: '2.0'
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-04 00:00:00.000000000 Z
+date: 2025-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -209,6 +209,8 @@ files:
 - app/components/tailwinds/table/row_component.rb
 - app/components/tailwinds/table_component.html.haml
 - app/components/tailwinds/table_component.rb
+- app/components/tailwinds/title_component.html.haml
+- app/components/tailwinds/title_component.rb
 - app/components/tramway/base_component.rb
 - app/components/tramway/entity_component.html.haml
 - app/components/tramway/entity_component.rb
@@ -221,10 +223,13 @@ files:
 - app/views/kaminari/_page.html.haml
 - app/views/kaminari/_paginator.html.haml
 - app/views/kaminari/_prev_page.html.haml
+- app/views/tramway/entities/_form.html.haml
 - app/views/tramway/entities/_list.html.haml
 - app/views/tramway/entities/index.html.haml
+- app/views/tramway/entities/new.html.haml
 - app/views/tramway/entities/show.html.haml
 - app/views/tramway/layouts/application.html.haml
+- config/locales/en.yml
 - config/routes.rb
 - config/tailwind.config.js
 - lib/generators/tramway/install/install_generator.rb
@@ -246,6 +251,7 @@ files:
 - lib/tramway/duck_typing/active_record_compatibility.rb
 - lib/tramway/engine.rb
 - lib/tramway/forms/class_helper.rb
+- lib/tramway/forms/fields.rb
 - lib/tramway/forms/normalizations.rb
 - lib/tramway/forms/properties.rb
 - lib/tramway/helpers/component_helper.rb
@@ -255,6 +261,7 @@ files:
 - lib/tramway/helpers/routes_helper.rb
 - lib/tramway/helpers/views_helper.rb
 - lib/tramway/navbar.rb
+- lib/tramway/utils/field.rb
 - lib/tramway/utils/render.rb
 - lib/tramway/version.rb
 - lib/tramway/views/form_builder.rb