tramway 1.1.3 → 2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dc301f6bca8cfbc81e6c68d976cfe3dfe23cce47fcbfe000731d531f09bb742
-  data.tar.gz: 2bb6aded7c7ffaa0dfcd2c6903db30af490cd57795675f1af6d96afe9613a3a5
+  metadata.gz: 0c779661b04c0ea3be53c76acdae493d703604e1dd3a2f48aad1c2121d6ea7d6
+  data.tar.gz: 41f3c46793abc8f3a6059b7be90ac1ef3eed8bebdf6e3c0bf880a8feac548f17
 SHA512:
-  metadata.gz: b984b2ef4232e4b138ec76309d750e4cb570a95aebaaf0f0c21ff8f97c019ae0c8b5a53cc9184ba831ba41b3d466861d4a94db8a5a161b3205d89c5b67a376f1
-  data.tar.gz: d7b086421ecf3b0ccb511542f916d4fd713c66652b5bc71b2be0c3ef264a503fdaaa7f6819f4ffc25f40ebb8863a5d66896f8ae7eb06b12763e5cc18b5022b7d
+  metadata.gz: e48c87f877ec8f72bb8554e4983be7f3e85c8845c117a862055db7f97a84cebc8c2e7cdbf272726f5be9f57b7ffed5505cef352482f98d5f503326f93ece247f
+  data.tar.gz: 20417c4f44f6e0dd627ff8770dd08473fba1093a517baff5aacfd803e5457baf0f9dde7c8425f4317fc35654fc064e4e28ac4d9fb57e1f0588d8ce2476968a92

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

@@ -63,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.3'
+  VERSION = '2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: '2.0'
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-05 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