tramway 0.6.1.6 → 1.0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9354b63aaa064dc6b94161742d1b7c59cf8820b0763a0041105a0f44364aaf34
-  data.tar.gz: 9b8cc641c9f4bb05a6e62f547f0fb8a0dd3c770da988a6c117b28231cd43708e
+  metadata.gz: 4ae5cf80f64299d99f74c529026b79d86560dc9de06ef48b5e2034e0cf586781
+  data.tar.gz: 8c7a9206caca2076a929c6f1d5f54680e7efb637f615a9513be2d2d720eaaf2a
 SHA512:
-  metadata.gz: 65033a5c73fae062088d67353563f79684a90e07bbbb3a39e29825bc9f8f49b9f75c970d05c6460b19701171a4e1509ead844fec977ee9ce0a7cfa55962ff8a2
-  data.tar.gz: 0cb7242a4146d887195f756f58faaf52a2ad80979fa08917a78a3062aa567021d0b627becfee0d3ed15fe7aa1fa11c828b2d41fa12a39a01759dfb171d0f7845
+  metadata.gz: 8e74f1aa07fe82961906725383afbe2ca3b2ee307c0aecb04687f4e49db726aec9796a9bab6fd9dac9b61801a91ddf31f4d746591ac725cdf0e158beddc10c67
+  data.tar.gz: 3b0fc24f6e0f5f24540b85ec151af179b4bedd292713e8035932c11346e12d2ba685382d12a86e5deb97a5dd3e85ef5a8ff2e7c5a3aba9b6f676897a1adfc2a2

data/README.md

@@ -73,7 +73,7 @@ end
 
 ```ruby
 class UserDecorator < Tramway::BaseDecorator
-  def self.list_attributes
+  def self.index_attributes
     [:id, :email, :created_at]
   end
 end
@@ -176,6 +176,37 @@ 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.
 
+**show page**
+
+To render a show page for an entity, declare a `:show` action inside the `pages` array in
+`config/initializers/tramway.rb`. Tramway will generate the route and render a table using the attributes returned by the
+decorator's `self.show_attributes` method.
+
+```ruby
+Tramway.configure do |config|
+  config.entities = [
+    {
+      name: :campaign,
+      pages: [
+        { action: :index },
+        { action: :show }
+      ]
+    }
+  ]
+end
+```
+
+```ruby
+class CampaignDecorator < Tramway::BaseDecorator
+  def self.show_attributes
+    %i[name status starts_at]
+  end
+end
+```
+
+With this configuration in place, visiting the show page displays a two-column table where the left column contains the
+localized attribute names and the right column renders their values.
+
 **route_helper**
 
 To get routes Tramway generated just Tramway::Engine.

data/app/components/tailwind_component.rb

@@ -3,7 +3,7 @@
 require 'view_component'
 
 # Base TailwindComponent. Contains base features for all tailwind components
-class TailwindComponent < Tramway::Component::Base
+class TailwindComponent < Tramway::BaseComponent
   option :input
   option :attribute
   option :value, optional: true

data/app/components/tailwinds/base_component.rb

@@ -2,6 +2,6 @@
 
 module Tailwinds
   # Shared base component for Tailwinds components
-  class BaseComponent < Tramway::Component::Base
+  class BaseComponent < Tramway::BaseComponent
   end
 end

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

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

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

@@ -3,7 +3,7 @@
 module Tailwinds
   module Form
     # Form label for all tailwind-styled forms
-    class LabelComponent < Tramway::Component::Base
+    class LabelComponent < Tramway::BaseComponent
       option :for
     end
   end

data/app/components/tailwinds/pagination/base.rb

@@ -3,7 +3,7 @@
 module Tailwinds
   module Pagination
     # Base component for rendering a Kaminari pagination
-    class Base < Tramway::Component::Base
+    class Base < Tramway::BaseComponent
       option :current_page
       option :url
       option :remote

data/app/components/tailwinds/pagination/gap_component.rb

@@ -3,7 +3,7 @@
 module Tailwinds
   module Pagination
     # Kaminari gap component for rendering a gap in a pagination
-    class GapComponent < Tramway::Component::Base
+    class GapComponent < Tramway::BaseComponent
     end
   end
 end

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

@@ -3,7 +3,7 @@
 module Tailwinds
   module Table
     # Component for rendering a cell in a table
-    class CellComponent < Tramway::Component::Base
+    class CellComponent < Tramway::BaseComponent
     end
   end
 end

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

@@ -3,7 +3,7 @@
 module Tailwinds
   module Table
     # Component for rendering a header in a table
-    class HeaderComponent < Tramway::Component::Base
+    class HeaderComponent < Tramway::BaseComponent
       option :headers, optional: true, default: -> { [] }
       option :columns, optional: true, default: -> { 3 }
 

data/app/components/tailwinds/table/row/preview_component.rb

@@ -4,7 +4,7 @@ module Tailwinds
   module Table
     module Row
       # Row component for rendering a row in a table
-      class PreviewComponent < Tramway::Component::Base
+      class PreviewComponent < Tramway::BaseComponent
       end
     end
   end

data/app/components/tailwinds/table/row_component.html.haml

@@ -1,7 +1,7 @@
 - if cells.any?
   = row_tag class: desktop_row_classes(cells.count), **options do
     - cells.each do |(_, value)|
-      .div-table-cell.px-6.py-4.font-medium.text-gray-900.whitespace-nowrap.dark:text-white.text-xs.sm:text-base
+      .div-table-cell.px-6.py-4.font-medium.text-gray-900.dark:text-white.text-xs.sm:text-base
         = value
 
 - else

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

@@ -3,7 +3,7 @@
 module Tailwinds
   module Table
     # Component for rendering a row in a table
-    class RowComponent < Tramway::Component::Base
+    class RowComponent < Tramway::BaseComponent
       option :cells, optional: true, default: -> { [] }
       option :href, optional: true
       option :options, optional: true, default: -> { {} }

data/app/components/tailwinds/table_component.rb

@@ -2,7 +2,7 @@
 
 module Tailwinds
   # Table component for rendering a table
-  class TableComponent < Tramway::Component::Base
+  class TableComponent < Tramway::BaseComponent
     option :options, optional: true, default: -> { {} }
   end
 end

data/app/components/tramway/base_component.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'tramway/helpers/component_helper'
+require 'tramway/helpers/decorate_helper'
+require 'tramway/helpers/views_helper'
+
+module Tramway
+  # You can use this class as a base for all your components
+  class BaseComponent < ViewComponent::Base
+    extend Dry::Initializer[undefined: false]
+    include Tramway::Helpers::ComponentHelper
+    include Tramway::Helpers::DecorateHelper
+    include Tramway::Helpers::ViewsHelper
+  end
+end

data/app/components/tramway/entity_component.html.haml

@@ -0,0 +1 @@
+= tramway_row cells:, href:

data/app/components/tramway/entity_component.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Tramway
+  # Component for displaying an entity row in a list
+  #
+  class EntityComponent < Tramway::BaseComponent
+    option :item
+    option :entity
+
+    def decorated_item
+      tramway_decorate item, namespace: entity.namespace
+    end
+
+    def href
+      if entity.pages.find { _1.action == 'show' }.present?
+        Tramway::Engine.routes.url_helpers.public_send entity.routes.show, decorated_item.id
+      else
+        decorated_item.show_path
+      end
+    end
+
+    def cells
+      decorated_item.class.index_attributes.reduce({}) do |hash, attribute|
+        hash.merge! attribute => decorated_item.public_send(attribute)
+      end
+    end
+  end
+end

data/app/controllers/tramway/entities_controller.rb

@@ -19,7 +19,11 @@ module Tramway
 
       @entities = entities
 
-      @namespace = entity.route&.namespace
+      @namespace = entity.namespace
+    end
+
+    def show
+      @entity = tramway_decorate model_class.find(params[:id]), namespace: entity.namespace
     end
 
     private

data/app/helpers/tramway/application_helper.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'tramway/helpers/component_helper'
+require 'tramway/helpers/views_helper'
 require 'kaminari/helpers/tag'
 
 module Tramway
@@ -8,6 +9,7 @@ module Tramway
   module ApplicationHelper
     include Tramway::Decorators::ClassHelper
     include Tramway::Helpers::ComponentHelper
+    include Tramway::Helpers::ViewsHelper
 
     def page_title
       @model_class.model_name.human.pluralize # rubocop:disable Rails/HelperInstanceVariable

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

@@ -1,5 +1,5 @@
 - decorator = Tramway::Decorators::ClassHelper.decorator_class_name(@model_class, @namespace)
-- list_attributes = decorator.constantize.list_attributes
+- index_attributes = decorator.constantize.index_attributes
 
 .mt-8.w-full
   - content_for :title, page_title
@@ -13,15 +13,15 @@
   .flex.justify-end.mt-2
     = decorator.constantize.index_header_content.call(@entities) if decorator.constantize.index_header_content.present?
 
-  - if list_attributes.empty?
+  - if index_attributes.empty?
     %p.text-center.mt-10
-      You should fill class-level method `self.list_attributes` inside your
+      You should fill class-level method `self.index_attributes` inside your
       = decorator
   - else
-    = component 'tailwinds/table' do
-      = component 'tailwinds/table/header', headers: list_attributes.map { |attribute| @model_class.human_attribute_name(attribute) }
+    = tramway_table do
+      = tramway_header headers: index_attributes.map { |attribute| @model_class.human_attribute_name(attribute) }
       - @entities.each do |item|
-        = render 'tramway/entities/entity', entity: item
+        = component 'tramway/entity', entity: @entity, item: item
 
       - if Tramway.config.pagination[:enabled]
         .flex.mt-4

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

@@ -0,0 +1,15 @@
+= tramway_container do
+  %h1.text-2xl.font-bold.mb-4
+    = @entity.title
+
+  - if @entity.show_attributes.empty?
+    %p.text-center.mt-10
+      You should fill object-level method `show_attributes` inside your
+      = @entity.class.name
+  = tramway_table do
+    - @entity.show_attributes.each do |attribute|
+      = tramway_row do
+        = tramway_cell do
+          = @model_class.human_attribute_name(attribute)
+        = tramway_cell do
+          = @entity.public_send(attribute)

data/config/routes.rb

@@ -1,13 +1,19 @@
 # frozen_string_literal: true
 
+# rubocop:disable Metrics/BlockLength
 Tramway::Engine.routes.draw do
   Tramway.config.entities.each do |entity|
-    segments      = entity.name.split('/')
+    if entity.namespace.present?
+      entity.namespace.split('/') + entity.name.split('/')
+    else
+      entity.name.split('/')
+    end => segments
+
     resource_name = segments.pop
 
     define_resource = proc do
       resources resource_name.pluralize.to_sym,
-                only: [:index],
+                only: entity.pages.map(&:action),
                 controller: '/tramway/entities',
                 defaults: { entity: entity }
     end
@@ -29,3 +35,4 @@ Tramway::Engine.routes.draw do
     end
   end
 end
+# rubocop:enable Metrics/BlockLength

data/config/tailwind.config.js

@@ -3,6 +3,7 @@ module.exports = {
     // === Navbar ===
     'ml-4',
     'text-white',
+    'md:flex',
     
     // === Custom table layout utilities ===
     'div-table',

data/lib/tramway/base_decorator.rb

@@ -48,7 +48,7 @@ module Tramway
         end
       end
 
-      def list_attributes
+      def index_attributes
         []
       end
 
@@ -67,6 +67,10 @@ module Tramway
 
     def show_path = nil
 
+    def show_attributes
+      []
+    end
+
     # :reek:ManualDispatch { enabled: false } because there is the idea to manual dispatch
     def method_missing(method_name, *, &)
       url_helpers = Rails.application.routes.url_helpers

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

@@ -6,11 +6,10 @@ module Tramway
       # Route struct describes rules for route management
       #
       class Route < Dry::Struct
-        attribute? :namespace, Types::Coercible::String
         attribute? :route_method, Types::Coercible::String
 
         def helper_method_by(underscored_name)
-          "#{[namespace, route_method || underscored_name].compact.join('_')}_path"
+          "#{route_method || underscored_name}_path"
         end
       end
     end

data/lib/tramway/configs/entity.rb

@@ -10,24 +10,26 @@ module Tramway
       attribute :name, Types::Coercible::String
       attribute? :pages, Types::Array.of(Tramway::Configs::Entities::Page).default([].freeze)
       attribute? :route, Tramway::Configs::Entities::Route
+      attribute? :namespace, Types::Coercible::String
 
       # Route Struct contains implemented in Tramway CRUD and helpful routes for the entity
-      RouteStruct = Struct.new(:index)
+      RouteStruct = Struct.new(:index, :show)
 
       # HumanName Struct contains human names forms for the entity
       HumanNameStruct = Struct.new(:single, :plural)
 
       def routes
-        RouteStruct.new(route_helper_method)
+        RouteStruct.new(*route_helper_methods)
       end
 
       def human_name
-        single, plural = if model_class.present?
-                           model_name = model_class.model_name.human
-                           [model_name, pluralized(model_name)]
-                         else
-                           [name.capitalize, name.pluralize.capitalize]
-                         end
+        if model_class.present?
+          model_name = model_class.model_name.human
+
+          [model_name, pluralized(model_name)]
+        else
+          [name.capitalize, name.pluralize.capitalize]
+        end => single, plural
 
         HumanNameStruct.new(single, plural)
       end
@@ -50,16 +52,29 @@ module Tramway
         nil
       end
 
-      def route_helper_method
-        underscored_name = name.parameterize.pluralize.underscore
+      def route_helper_methods
+        %i[index show].map do |action|
+          page(action).present? ? send("#{action}_helper_method") : nil
+        end.compact
+      end
+
+      def build_helper_method(base_name, route: nil, namespace: nil, plural: false)
+        if plural
+          base_name.to_s.parameterize.underscore.pluralize
+        else
+          base_name.to_s.parameterize.underscore
+        end => underscored
 
-        method_name = if set_page?(:index) || route.blank?
-                        "#{underscored_name}_path"
-                      else
-                        route.helper_method_by(underscored_name)
-                      end
+        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
 
-        route_helper_engine.routes.url_helpers.public_send(method_name)
+      def index_helper_method
+        build_helper_method(name, route:, namespace:, plural: true)
       end
 
       def route_helper_engine

data/lib/tramway/decorators/class_helper.rb

@@ -15,7 +15,7 @@ module Tramway
           class_name = decorator_class_name(object_or_array, namespace)
           class_name.constantize
         rescue NameError
-          raise NameError, "You should define #{class_name} decorator class."
+          raise NameError, "You should define #{class_name_for_error(object_or_array, namespace)} decorator class."
         end
       end
 
@@ -50,6 +50,14 @@ module Tramway
 
         klass_name
       end
+
+      def class_name_for_error(object_or_array, namespace)
+        object = object_or_array.respond_to?(:first) ? object_or_array.first : object_or_array
+
+        base_class_name = "#{object.class.name}Decorator"
+
+        namespace.present? ? "#{namespace}::#{base_class_name}" : base_class_name
+      end
     end
   end
 end

data/lib/tramway/helpers/navbar_helper.rb

@@ -25,12 +25,12 @@ module Tramway
       def assign_navbar_items(options)
         navbar_items = @navbar.items
         navbar_items.each do |(key, value)|
-          key_to_merge = case key
-                         when :left, :right
-                           :"#{key}_items"
-                         else
-                           key
-                         end
+          case key
+          when :left, :right
+            :"#{key}_items"
+          else
+            key
+          end => key_to_merge
 
           options.merge! key_to_merge => value
         end

data/lib/tramway/navbar.rb

@@ -38,11 +38,11 @@ module Tramway
     def item(text_or_url, url = nil, **, &)
       raise 'You cannot provide an argument and a code block at the same time' if provided_url_and_block?(url, &)
 
-      rendered_item = if url.present?
-                        render_ignoring_block(text_or_url, url, **)
-                      else
-                        render_using_block(text_or_url, **, &)
-                      end
+      if url.present?
+        render_ignoring_block(text_or_url, url, **)
+      else
+        render_using_block(text_or_url, **, &)
+      end => rendered_item
 
       @items[@filling] << rendered_item
     end
@@ -53,7 +53,9 @@ module Tramway
       filling_side :left
 
       entities.each do |entity|
-        item entity.human_name.plural, entity.routes.index
+        next if entity.routes.index.blank?
+
+        item entity.human_name.plural, Tramway::Engine.routes.url_helpers.public_send(entity.routes.index)
       end
 
       reset_filling

data/lib/tramway/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 0.6.1.6
+  version: 1.0.0.1
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-31 00:00:00.000000000 Z
+date: 2025-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -205,7 +205,9 @@ files:
 - app/components/tailwinds/table/row_component.rb
 - app/components/tailwinds/table_component.html.haml
 - app/components/tailwinds/table_component.rb
-- app/components/tramway/component/base.rb
+- app/components/tramway/base_component.rb
+- app/components/tramway/entity_component.html.haml
+- app/components/tramway/entity_component.rb
 - app/controllers/tramway/entities_controller.rb
 - app/helpers/tramway/application_helper.rb
 - app/views/kaminari/_first_page.html.haml
@@ -215,9 +217,9 @@ files:
 - app/views/kaminari/_page.html.haml
 - app/views/kaminari/_paginator.html.haml
 - app/views/kaminari/_prev_page.html.haml
-- app/views/tramway/entities/_entity.html.haml
 - app/views/tramway/entities/_list.html.haml
 - app/views/tramway/entities/index.html.haml
+- app/views/tramway/entities/show.html.haml
 - app/views/tramway/layouts/application.html.haml
 - config/routes.rb
 - config/tailwind.config.js

data/app/components/tramway/component/base.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-require 'tramway/helpers/component_helper'
-
-module Tramway
-  module Component
-    # You can use this class as a base for all your components
-    class Base < ViewComponent::Base
-      extend Dry::Initializer[undefined: false]
-      include Tramway::Helpers::ComponentHelper
-    end
-  end
-end

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

@@ -1,3 +0,0 @@
-- decorator = decorator_class_name(entity, @namespace)
-- decorated_object = decorator.constantize.decorate(entity)
-= component 'tailwinds/table/row', cells: decorator.constantize.list_attributes.reduce({}) { |hash, attribute| hash.merge! attribute => decorated_object.public_send(attribute) }, href: decorated_object.show_path