tramway 2.3.1.1 → 2.3.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f94931c225d093e9cb11e8957ae333b66a2a6feb0e36427c77bbe864ae75433
-  data.tar.gz: a16912c9f8ea5da24eabbba7dd0f0524f1ef0f057c14a6af6f56c2d930b08b37
+  metadata.gz: 5de5b05b1753cdf48960fb5a7f8a98e63e42b95db21eda01d3f28a828d97b81f
+  data.tar.gz: 8bb86b14f367b4874ca04d92bc81daab8566109ebeb86033bc6dacf3061000fb
 SHA512:
-  metadata.gz: 0174d5e8d6ed3f337bcbc01523471d651d333d30104399da24d0e9ac16dd0a7549982e3ad77b8ff15c8af26c59791e11120c4afee462215870bbf4c1a9fbdf81
-  data.tar.gz: 9e229945662dadadb01ca4075bf0a2da71b90fdca30e4b687144424d72e9929face26facbc94cee1c6e01cdda29c8c72a4ef072d0784fb46329bfc3c6ed257c2
+  metadata.gz: 45bbf5d2b75437f5b55f3df5c8a8041fb7cc1db11b8ce275277012c1aea3027587e114986cf9b0773fc0f72a0a5a26fbf8702dbd4fb4f2ae5375dfc9634d5841
+  data.tar.gz: c9a4dcd50b189a79592ac6e50df049b8eb3ff33387644d0db2fc76672815197ae33d830025a2982c9f1064a97a2bae5ae2fcce6fddf30043e114ac3d8fa3eeac

data/README.md

@@ -51,7 +51,7 @@ bundle install
 bin/rails g tramway:install
 ```
 
-The install generator adds the required gems (`haml-rails`, `kaminari`, `view_component`, and `dry-initializer`) to your
+The install generator adds the required gems (`haml-rails`, `kaminari`, `view_component`, `dry-initializer`, and `dry-monads`) to your
 application's Gemfile—if they are not present—and appends the Tailwind safelist configuration Tramway ships with.
 
 ## Getting Started
@@ -863,6 +863,9 @@ the Tailwind color family explicitly.
 that receives new messages. Each message must include an `:id` and a `:type` (either `:sent` or `:received`). Additional
 message fields like `text`, `data`, or `sent_at` are forwarded to `tramway/chats/message_component`.
 
+Use `send_messages_enabled:` to control whether users can send new messages from the rendered form. It defaults to `true`.
+When set to `false`, the text field is disabled and the waiting placeholder is shown.
+
 ```haml
 -# Haml example
 - messages = [
@@ -872,7 +875,8 @@ message fields like `text`, `data`, or `sent_at` are forwarded to `tramway/chats
 = tramway_chat chat_id: 'support-chat',
   messages: messages,
   message_form: @message_form,
-  send_message_path: chat_messages_path
+  send_message_path: chat_messages_path,
+  send_messages_enabled: @chat.open?
 ```
 
 ```erb
@@ -881,7 +885,8 @@ message fields like `text`, `data`, or `sent_at` are forwarded to `tramway/chats
 <%= tramway_chat chat_id: 'support-chat',
   messages: messages,
   message_form: @message_form,
-  send_message_path: chat_messages_path %>
+  send_message_path: chat_messages_path,
+  send_messages_enabled: @chat.open? %>
 ```
 
 

data/app/components/tramway/chats/message_component.html.haml

@@ -16,11 +16,11 @@
 
     - if pending?
       .pb-1
-        = inline_svg 'icons/spinner.svg', class: 'w-4 h-4 text-white animate-spin'
+        -# = inline_svg 'icons/spinner.svg', class: 'w-4 h-4 text-white animate-spin'
 
     - if failed?
       .pb-1
-        = inline_svg 'icons/cross.svg', class: 'w-6 h-6 text-red-200'
+        -# = inline_svg 'icons/cross.svg', class: 'w-6 h-6 text-red-200'
 
     - if data_view == :table
       = component 'tramway/chats/messages/table', data:

data/docs/AGENTS.md

@@ -131,6 +131,8 @@ Inherit all components from Tramway::BaseComponent
 When you need chat UI, use the `tramway_chat` helper. Pass `chat_id`, `messages`, `message_form`, and `send_message_path`.
 Each message must include `:id` and a `:type` of `:sent` or `:received`, and other keys (like `:text`, `:data`, `:sent_at`)
 are forwarded to `tramway/chats/message_component`. Use `message_form: nil` when you only need read-only chat rendering.
+Use `send_messages_enabled:` (defaults to `true`) to control whether the message input is enabled. Set it to `false`
+when chat should be visible but sending is temporarily unavailable.
 
 For live updates to a rendered `tramway_chat`, use `tramway_chat_append_message(chat_id:, message_type:, text:, sent_at:)`.
 This method is included in all controllers and ActiveRecord models. `message_type` must be `:sent` or `:received`, otherwise
@@ -354,7 +356,12 @@ In case you need something that looks like enumerize but it's a process state, u
 Use model scopes instead of creating private methods for object collections.
 
 ### Rule 23
-Use `tramway_title` for the main title on pages
+Use `tramway_title` for the main title on pages. `tramway_title text: 'Title'` OR
+
+```
+tramway_title do
+  More complicated title with HTML tags
+```
 
 Example
 *app/models/user.rb*
@@ -456,7 +463,7 @@ In case, you need to make a one link in tramway_table on each row. Use `tramway_
 Always use tramway decorated objects in views.
 
 ### Rule 30
-For Tailwind classes with `/`, `[`, `]` characters use `{ class: 'here is the complicated class' }` in HAML.
+For Tailwind classes with arbitrary values (with `/`, `[`, `]` characters) use `{ class: 'here is the complicated class' }` in HAML.
 
 ### Rule 31
 Always `tramway_decorate` and `tramway_form` for creating these types of objects. Don't use decorator and form classes for this.
@@ -464,6 +471,9 @@ Always `tramway_decorate` and `tramway_form` for creating these types of objects
 ### Rule 32
 In Tramway Decorators, use `delegate_attributes` method instead of `delegate :something, to: :object`
 
+### Rule 33
+In case you want to use container on the page, use `tramway_container` helper instead of creating a component for that or using a plain div with Tailwind classes.
+
 ## Controller Patterns
 
 - Keep actions short and explicit with guard clauses.

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

@@ -16,7 +16,8 @@ module Tramway
           { 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'" }
+          { name: 'dry-initializer', declaration: "gem 'dry-initializer'" },
+          { name: 'dry-monads', declaration: "gem 'dry-monads'" }
         ]
       end
 

data/lib/tramway/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 2.3.1.1
+  version: 2.3.1.3
 platform: ruby
 authors:
 - kalashnikovisme