turbo_chat 0.1.11 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97ae091b4d44fd093c6fbff38d64027c8cb85f45c5663f05e2a66cbcb15c043d
-  data.tar.gz: 3983790dec17e23c5ce5d99dd44f154e0d3b154ca43b9d4e595bf6491ac91822
+  metadata.gz: b1c6f0dd5991186ff33af55ffef201d7ab37af996f24884e4e25fb2fe8bf6b0c
+  data.tar.gz: e0d4b6d10fff71303104ea2d0f797d62222d694d4a27aa7201699730abad6c7a
 SHA512:
-  metadata.gz: cc0717fd14c06e02daa493ed4887b962147e17b15d1d44880f9305be2cb51869066c3f29c08b8ad89b45cca4fa2e5ec13850d84fe56525a3ce5123eec8c8c936
-  data.tar.gz: 7f6d6ceecc1421e73b407d67da671e25fcb32adfdee714eaddacaa6187200e2c6a423f94e9ae955fc93546c2f2c78f3c659ebcf3a21313a8d5d25d1f49b0716b
+  metadata.gz: 4968592c0c8462d24a43db894c60229fbcb6d172d0036612934d22e4713e66e454712d2b28c6ce53b9b5e34f8560e6b5f1e7cd5f624e6cfbe696fa1ddfd3747f
+  data.tar.gz: eafbf1fdfbc738c0922ca8885c53537eac0377c25ce494dfc04a70038a25e3e63fad432960c39b6b31e25bfa2ce5782cc052e44a797a771d14c53d3a8e7cf0f3

data/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to `turbo_chat` will be documented in this file.
 
+## [0.1.14] - 2026-02-28
+
+### Added
+- Scoped configuration namespaces for clearer organization: `config.chat`, `config.chat_message`, `config.style`, `config.moderation`, `config.events`, and `config.signals`.
+- Scoped installer initializer output with inline guidance grouped by scope.
+
+### Changed
+- Updated README examples to use scoped configuration.
+- Flat configuration aliases (for example `config.max_message_length`) remain supported for backward compatibility.
+
+## [0.1.13] - 2026-02-26
+
+### Added
+- Configurable timeline insert behavior via `config.message_insert_position` (`append_end` or `append_start`).
+- Configurable composer disable toggle via `config.disable_input` to hide input and reject message posts.
+
+### Changed
+- Signal indicators now render status text for standard signal types (`typing`, `thinking`, `planning`) so shimmer styling can pass over the status text only (not participant names).
+- `config.signal_text_sheen` is now consistently cast as a boolean during signal rendering.
+
+## [0.1.12] - 2026-02-26
+
+### Added
+- Configurable signal lifetime via `config.signal_ttl_seconds` (default `60`) so applications can keep typing/status indicators active longer.
+
+### Changed
+- Signal visibility/pruning now use the configured signal TTL consistently on both server-rendered active signals and client-side signal cleanup.
+- Chat show renders signal TTL metadata for frontend pruning coordination.
+
 ## [0.1.11] - 2026-02-26
 
 ### Changed

data/README.md

@@ -77,7 +77,7 @@ end
 Resolution order:
 
 1. Host `ApplicationController#current_chat_participant` (if defined)
-2. `config.current_participant_resolver` (if configured)
+2. `config.chat.current_participant_resolver` (if configured)
 3. `current_user` (if available)
 4. Raise `NotImplementedError`
 
@@ -85,7 +85,7 @@ Optional resolver for non-`current_user` auth:
 
 ```ruby
 TurboChat.configure do |config|
-  config.current_participant_resolver = ->(controller) { controller.send(:current_member) }
+  config.chat.current_participant_resolver = ->(controller) { controller.send(:current_member) }
 end
 ```
 
@@ -110,31 +110,36 @@ Start with a minimal initializer and only expand when needed:
 
 ```ruby
 TurboChat.configure do |config|
-  config.permission_adapter = TurboChat::Permission
-
-  config.max_chat_participants = 10
-  config.max_message_length = 1000
-  config.message_history_limit = 200
-
-  config.enable_mentions = true
-  config.enable_emoji_aliases = true
-
-  config.blocked_words = []
-  config.blocked_words_action = :reject # or :scramble
-
-  config.render_message_html = false
-  config.show_timestamp = true
-  config.show_role = false
-  config.message_source_labels = TurboChat::Configuration::DEFAULT_MESSAGE_SOURCE_LABELS.dup
-  config.chat_style = "chat_style_bounded"
-  config.signal_text_sheen = true
-
-  config.emit_moderation_events = false
-  config.emit_blocked_words_events = false
-  config.emit_mention_events = false
+  config.chat.permission_adapter = TurboChat::Permission
+
+  config.chat.max_chat_participants = 10
+  config.chat_message.max_message_length = 1000
+  config.chat_message.message_history_limit = 200
+
+  config.chat_message.enable_mentions = true
+  config.chat_message.enable_emoji_aliases = true
+
+  config.chat_message.blocked_words = []
+  config.chat_message.blocked_words_action = :reject # or :scramble
+
+  config.chat_message.render_message_html = false
+  config.style.show_timestamp = true
+  config.style.show_role = false
+  config.chat_message.message_source_labels = TurboChat::Configuration::DEFAULT_MESSAGE_SOURCE_LABELS.dup
+  config.style.chat_style = "chat_style_bounded"
+  config.chat_message.message_insert_position = "append_end" # or "append_start"
+  config.chat.disable_input = false
+  config.signals.signal_ttl_seconds = 60
+  config.style.signal_text_sheen = true
+
+  config.moderation.emit_moderation_events = false
+  config.moderation.emit_blocked_words_events = false
+  config.events.emit_mention_events = false
 end
 ```
 
+Flat aliases (for example `config.max_message_length`) still work for backward compatibility.
+
 ## Message Ingest API
 
 Post messages as a specific participant, including external sources like WhatsApp:
@@ -167,7 +172,7 @@ Source labels shown in message badges are configurable:
 
 ```ruby
 TurboChat.configure do |config|
-  config.message_source_labels = {
+  config.chat_message.message_source_labels = {
     "app" => "In App",
     "whatsapp" => "WhatsApp",
     "sms_gateway" => "SMS"
@@ -179,7 +184,23 @@ Chat UI layout style is configurable:
 
 ```ruby
 TurboChat.configure do |config|
-  config.chat_style = "chat_style_unbounded" # or "chat_style_bounded"
+  config.style.chat_style = "chat_style_unbounded" # or "chat_style_bounded"
+end
+```
+
+Timeline insert position is configurable:
+
+```ruby
+TurboChat.configure do |config|
+  config.chat_message.message_insert_position = "append_end" # or "append_start"
+end
+```
+
+Composer input can be disabled globally:
+
+```ruby
+TurboChat.configure do |config|
+  config.chat.disable_input = true
 end
 ```
 
@@ -243,13 +264,13 @@ Enable only what you consume:
 
 ```ruby
 TurboChat.configure do |config|
-  config.emit_typing_events = true
-  config.emit_message_events = true
-  config.emit_mention_events = true
-  config.emit_invitation_events = true
-  config.emit_chat_lifecycle_events = true
-  config.emit_moderation_events = true
-  config.emit_blocked_words_events = true
+  config.events.emit_typing_events = true
+  config.events.emit_message_events = true
+  config.events.emit_mention_events = true
+  config.events.emit_invitation_events = true
+  config.events.emit_chat_lifecycle_events = true
+  config.moderation.emit_moderation_events = true
+  config.moderation.emit_blocked_words_events = true
 end
 ```
 

data/app/assets/javascripts/turbo_chat/realtime.js

@@ -1,6 +1,6 @@
 (function (namespace) {
   var constants = namespace.constants || {};
-  var SIGNAL_TTL_SECONDS = constants.SIGNAL_TTL_SECONDS || 12;
+  var SIGNAL_TTL_SECONDS = constants.SIGNAL_TTL_SECONDS || 60;
   var SIGNAL_START_DELAY_MS = constants.SIGNAL_START_DELAY_MS || 750;
   var SIGNAL_IDLE_GRACE_MS = constants.SIGNAL_IDLE_GRACE_MS || 2500;
   var SIGNAL_HEARTBEAT_MS = constants.SIGNAL_HEARTBEAT_MS || 4000;
@@ -72,6 +72,24 @@
     container.__chatSignalDeactivateTimeoutId = null;
   }
 
+  function signalTtlSecondsForNode(node) {
+    if (!node || typeof node.closest !== "function") {
+      return SIGNAL_TTL_SECONDS;
+    }
+
+    var container = node.closest(".chat-signals");
+    if (!container || !container.dataset) {
+      return SIGNAL_TTL_SECONDS;
+    }
+
+    var parsedTtl = parseInt(container.dataset.chatSignalTtlSeconds || "", 10);
+    if (isNaN(parsedTtl) || parsedTtl <= 0) {
+      return SIGNAL_TTL_SECONDS;
+    }
+
+    return parsedTtl;
+  }
+
   function queueSignalDeactivate(container) {
     if (!container || container.__chatSignalDeactivateTimeoutId) {
       return;
@@ -210,7 +228,7 @@
         return;
       }
 
-      if (now - at > SIGNAL_TTL_SECONDS) {
+      if (now - at > signalTtlSecondsForNode(node)) {
         collapseSignalNode(node);
       }
     });

data/app/assets/javascripts/turbo_chat/shared.js

@@ -1,6 +1,6 @@
 (function (namespace) {
   var constants = {
-    SIGNAL_TTL_SECONDS: 12,
+    SIGNAL_TTL_SECONDS: 60,
     SIGNAL_START_DELAY_MS: 750,
     SIGNAL_IDLE_GRACE_MS: 2500,
     SIGNAL_HEARTBEAT_MS: 4000,
@@ -419,6 +419,17 @@
       return;
     }
 
+    var insertPosition = String(container.dataset.chatMessageInsertPosition || "").trim().toLowerCase();
+    if (insertPosition === "append_start") {
+      var firstMessage = container.firstElementChild;
+      if (!firstMessage) {
+        return;
+      }
+
+      container.scrollTop = Math.max(0, firstMessage.offsetTop - 2);
+      return;
+    }
+
     var lastMessage = container.lastElementChild;
     if (!lastMessage) {
       return;

data/app/controllers/turbo_chat/application_controller.rb

@@ -27,7 +27,7 @@ module TurboChat
         return [send(:current_user), "#current_user"]
       end
 
-      raise NotImplementedError, "Define #current_chat_participant, configure TurboChat.configuration.current_participant_resolver, or expose #current_user"
+      raise NotImplementedError, "Define #current_chat_participant, configure TurboChat.configuration.chat.current_participant_resolver, or expose #current_user"
     end
 
     def invoke_current_participant_resolver(resolver)
@@ -58,9 +58,18 @@ module TurboChat
     end
 
     def authorize_post_message!(chat)
+      return head(:forbidden) if chat_input_disabled?
       return if permission_for(chat).can_post_message?
 
       head :forbidden
     end
+
+    def chat_input_disabled?
+      configuration = TurboChat.configuration
+      value = configuration.respond_to?(:disable_input) ? configuration.disable_input : false
+      ActiveModel::Type::Boolean.new.cast(value)
+    rescue StandardError
+      false
+    end
   end
 end

data/app/controllers/turbo_chat/chat_messages_controller.rb

@@ -82,7 +82,7 @@ module TurboChat
     def respond_to_chat_message_create_failure
       @chat_messages = @chat.visible_messages
       @chat_permission = permission_for(@chat)
-      @can_post_message = @chat_permission.can_post_message?
+      @can_post_message = @chat_permission.can_post_message? && !chat_input_disabled?
       @show_members = chat_config_boolean(:show_members, default: true)
       respond_to do |format|
         format.turbo_stream { render "turbo_chat/chats/show", status: :unprocessable_entity }

data/app/controllers/turbo_chat/chats_controller.rb

@@ -61,7 +61,7 @@ module TurboChat
       @chat_lifecycle_event = chat_lifecycle_event_payload
       @chat_permission = permission_for(@chat)
       @chat_messages = @chat.visible_messages
-      @can_post_message = @chat_permission.can_post_message?
+      @can_post_message = @chat_permission.can_post_message? && !chat_input_disabled?
       @show_members = show_members_enabled?
       @can_invite_member = permission_allows?(@chat_permission, :can_invite_member?)
       @can_manage_member_permissions = permission_allows?(@chat_permission, :can_grant_member_permissions?)

data/app/helpers/turbo_chat/application_helper/config_support.rb

@@ -8,6 +8,8 @@ module TurboChat
         emit_invitation_events: false,
         emit_chat_lifecycle_events: false,
         show_members: true,
+        show_self_signals: false,
+        disable_input: false,
         composer_add_files_display: false,
         composer_add_files_active: false,
         composer_microphone_display: false,
@@ -79,6 +81,28 @@ module TurboChat
         chat_unbounded_style? ? "chat-shell--style-unbounded" : "chat-shell--style-bounded"
       end
 
+      def chat_message_insert_position
+        raw_position = chat_config_value(:message_insert_position, default: "append_end")
+        normalized = raw_position.to_s.strip.downcase
+
+        case normalized
+        when "append_start", "start", "prepend"
+          "append_start"
+        else
+          "append_end"
+        end
+      end
+
+      def chat_message_append_start?
+        chat_message_insert_position == "append_start"
+      end
+
+      def chat_signal_ttl_seconds
+        value = chat_config_value(:signal_ttl_seconds, default: 60)
+        ttl = value.to_i
+        ttl.positive? ? ttl : 60
+      end
+
       private
 
       def chat_config_value(method_name, default: nil)

data/app/models/turbo_chat/chat.rb

@@ -33,8 +33,8 @@ module TurboChat
       where.not(id: active(window: window).select(:id))
     }
 
-    def active_signals(window: 12.seconds)
-      cutoff = Time.current - window
+    def active_signals(window: nil)
+      cutoff = Time.current - self.class.signal_window_seconds(window)
       latest_message_at = chat_messages
                           .message
                           .where("created_at >= ?", cutoff)
@@ -104,6 +104,19 @@ module TurboChat
       raise ArgumentError, "active chat window must be a positive duration"
     end
 
+    def self.signal_window_seconds(window = nil)
+      value = if window.nil?
+                configuration = TurboChat.configuration
+                configuration.respond_to?(:signal_ttl_seconds) ? configuration.signal_ttl_seconds : 60
+              else
+                window
+              end
+      seconds = value.to_i
+      return seconds if seconds.positive?
+
+      raise ArgumentError, "signal ttl must be a positive duration"
+    end
+
     private
 
     def normalize_message_limit(limit)

data/app/models/turbo_chat/chat_message/broadcasting.rb

@@ -10,13 +10,8 @@ module TurboChat
 
         stream = stream_name
 
-        if appendable_timeline_message? && respond_to?(:broadcast_append_to)
-          broadcast_append_to(
-            stream,
-            target: ActionView::RecordIdentifier.dom_id(chat, :messages),
-            partial: CHAT_MESSAGE_PARTIAL,
-            locals: { chat_message: self }
-          )
+        if appendable_timeline_message?
+          broadcast_timeline_create(stream)
         end
 
         broadcast_update_to(
@@ -60,6 +55,34 @@ module TurboChat
       def appendable_timeline_message?
         message? || system?
       end
+
+      def broadcast_timeline_create(stream)
+        options = {
+          target: ActionView::RecordIdentifier.dom_id(chat, :messages),
+          partial: CHAT_MESSAGE_PARTIAL,
+          locals: { chat_message: self }
+        }
+
+        if append_start_position?
+          return unless respond_to?(:broadcast_prepend_to)
+
+          broadcast_prepend_to(stream, **options)
+          return
+        end
+
+        return unless respond_to?(:broadcast_append_to)
+
+        broadcast_append_to(stream, **options)
+      end
+
+      def append_start_position?
+        configuration = TurboChat.configuration
+        value = configuration.respond_to?(:message_insert_position) ? configuration.message_insert_position : "append_end"
+        normalized = value.to_s.strip.downcase
+        %w[append_start start prepend].include?(normalized)
+      rescue StandardError
+        false
+      end
     end
   end
 end

data/app/views/turbo_chat/chat_messages/_signals.html.erb

@@ -1,5 +1,11 @@
-<% show_self_signals = TurboChat.configuration.show_self_signals %>
-<% signal_text_sheen_enabled = TurboChat.configuration.signal_text_sheen %>
+<% show_self_signals = if respond_to?(:chat_show_self_signals?, true)
+                         chat_show_self_signals?
+                       else
+                         configuration = TurboChat.configuration
+                         value = configuration.respond_to?(:show_self_signals) ? configuration.show_self_signals : false
+                         ActiveModel::Type::Boolean.new.cast(value)
+                       end %>
+<% signal_text_sheen_enabled = ActiveModel::Type::Boolean.new.cast(TurboChat.configuration.signal_text_sheen) %>
 <% current_participant = respond_to?(:current_chat_participant, true) ? current_chat_participant : nil %>
 <% current_participant_type = current_participant&.class&.base_class&.name %>
 <% current_participant_id = current_participant&.id %>
@@ -17,19 +23,18 @@
        data-chat-signal-at="<%= signal_message.created_at.to_i %>"
        data-chat-signal-participant-type="<%= signal_message.participant_type %>"
        data-chat-signal-participant-id="<%= signal_message.participant_id %>">
+    <% signal_text = if signal_message.signal_type_custom? && signal_message.signal_text.present?
+                       signal_message.signal_text
+                     else
+                       signal_message.signal_type.to_s
+                     end %>
     <strong><%= signal_message.participant_display_name %></strong>
-    <% if signal_message.signal_type_custom? && signal_message.signal_text.present? %>
-      <span class="chat-signal-text<%= " chat-signal-text--sheen" if signal_text_sheen_enabled %>">
-        <% if signal_text_sheen_enabled %>
-          <span class="chat-signal-text-sheen"><%= signal_message.signal_text %></span>
-        <% else %>
-          <%= signal_message.signal_text %>
-        <% end %>
-      </span>
-    <% else %>
-      <span class="chat-dots">
-        <i></i><i></i><i></i>
-      </span>
-    <% end %>
+    <span class="chat-signal-text<%= " chat-signal-text--sheen" if signal_text_sheen_enabled %>">
+      <% if signal_text_sheen_enabled %>
+        <span class="chat-signal-text-sheen"><%= signal_text %></span>
+      <% else %>
+        <%= signal_text %>
+      <% end %>
+    </span>
   </div>
 <% end %>

data/app/views/turbo_chat/chats/show.html.erb

@@ -10,6 +10,10 @@
   ("chat-shell--closed" if @chat.closed?),
   ("chat-shell--can-manage-member-permissions" if @can_manage_member_permissions)
 ].compact.join(" ") %>
+<% message_insert_position = chat_message_insert_position %>
+<% chat_messages = @chat_messages.to_a %>
+<% chat_messages.reverse! if message_insert_position == "append_start" %>
+<% can_render_composer = @can_post_message && !chat_disable_input? %>
 <section class="<%= chat_shell_classes %>"
          data-chat-id="<%= @chat.id %>"
          data-chat-style="<%= chat_style_key %>"
@@ -113,6 +117,7 @@
     <div id="<%= dom_id(@chat, :messages) %>"
          class="chat-messages"
          data-chat-id="<%= @chat.id %>"
+         data-chat-message-insert-position="<%= message_insert_position %>"
          data-chat-self-participant-type="<%= current_participant_type %>"
          data-chat-self-participant-id="<%= current_participant_id %>"
          data-chat-self-mention-tokens="<%= json_escape(self_mention_tokens.to_json) %>"
@@ -122,19 +127,20 @@
          data-chat-emit-mention-events="<%= chat_emit_mention_events? %>"
          data-chat-can-edit-own-messages="<%= @can_edit_own_messages %>"
          <%= %(style="#{mention_container_style}") if mention_container_style.present? %>>
-      <%= render @chat_messages %>
+      <%= render chat_messages %>
     </div>
 
     <div id="<%= dom_id(@chat, :signals) %>"
          class="chat-signals"
-         data-chat-show-self-signals="<%= TurboChat.configuration.show_self_signals %>"
+         data-chat-show-self-signals="<%= chat_show_self_signals? %>"
+         data-chat-signal-ttl-seconds="<%= chat_signal_ttl_seconds %>"
          data-chat-self-participant-type="<%= current_participant_type %>"
          data-chat-self-participant-id="<%= current_participant_id %>">
       <%= render "turbo_chat/chat_messages/signals", chat: @chat %>
     </div>
   </section>
 
-  <% if @can_post_message %>
+  <% if can_render_composer %>
     <%= render "turbo_chat/chat_messages/form",
                chat: @chat,
                chat_message: @chat_message,

data/lib/generators/turbo_chat/install/templates/turbo_chat.rb

@@ -1,116 +1,120 @@
 TurboChat.configure do |config|
-  # Permissions
-  config.permission_adapter = TurboChat::Permission
+  # Chat scope
+  config.chat.permission_adapter = TurboChat::Permission
   # Class that answers permission checks for participants/chats.
 
   # Authentication
-  # config.current_participant_resolver = ->(controller) { controller.send(:current_member) }
+  # config.chat.current_participant_resolver = ->(controller) { controller.send(:current_member) }
   # Fallback resolver when you do not define `current_chat_participant`.
 
-  # Limits
-  config.max_chat_participants = 10
+  # Chat limits
+  config.chat.max_chat_participants = 10
   # Maximum active members allowed in a chat.
-  config.max_message_length = 1000
+  config.chat_message.max_message_length = 1000
   # Maximum characters allowed in a message body.
-  config.message_history_limit = 200
+  config.chat_message.message_history_limit = 200
   # Number of recent messages loaded in chat history.
-  config.active_chat_window = 5.minutes
-  # Duration a typing signal stays active without refresh.
+  config.chat.active_chat_window = 5.minutes
+  # Duration used to classify chats as active.
+  config.chat.show_members = true
+  # Shows member list panel in chat UI.
+  config.chat.system_messages = true
+  # Shows system timeline messages (joins, invites, moderation).
+  # config.chat.disable_input = true
+  # Disables composer rendering and blocks message submissions.
 
-  # Mentions and emoji
-  config.enable_mentions = true
+  # Chat message behavior
+  config.chat_message.enable_mentions = true
   # Enables mention parsing/highlighting and mention UI.
-  config.mention_filter_exclude_self = true
+  config.chat_message.mention_filter_exclude_self = true
   # Hides self from mention suggestions.
-  config.mention_filter_hide_roles = true
+  config.chat_message.mention_filter_hide_roles = true
   # Hides @ROLE suggestions in mention picker.
-  config.enable_emoji_aliases = true
+  config.chat_message.enable_emoji_aliases = true
   # Expands :alias: tokens using configured emoji aliases.
-  config.emoji_aliases = TurboChat::Configuration::DEFAULT_EMOJI_ALIASES.dup
+  config.chat_message.emoji_aliases = TurboChat::Configuration::DEFAULT_EMOJI_ALIASES.dup
   # Hash of emoji alias mappings, e.g. "smile" => "😄".
 
   # Blocked words
-  config.blocked_words = []
+  config.chat_message.blocked_words = []
   # Case-insensitive word list checked before message save.
-  config.blocked_words_action = :reject
+  config.chat_message.blocked_words_action = :reject
   # `:reject` adds a validation error, `:scramble` rewrites matched words.
-  config.blocked_words_scramble_chars = TurboChat::Configuration::DEFAULT_BLOCKED_WORDS_SCRAMBLE_CHARS.dup
+  config.chat_message.blocked_words_scramble_chars = TurboChat::Configuration::DEFAULT_BLOCKED_WORDS_SCRAMBLE_CHARS.dup
   # Character pool used when scrambling blocked words.
+  config.chat_message.message_source_labels = TurboChat::Configuration::DEFAULT_MESSAGE_SOURCE_LABELS.dup
+  # Maps message source keys to labels shown on non-default source badges.
+  # config.chat_message.message_insert_position = "append_end"
+  # Timeline insert behavior: `append_end` (near composer) or `append_start` (top of list).
+  # config.chat_message.render_message_html = true
+  # Renders/sanitizes HTML in message bodies.
+  config.chat_message.message_html_tags = %w[a b br code em i li ol p pre strong ul]
+  # Allowed HTML tags when `render_message_html` is true.
+  config.chat_message.message_html_attributes = %w[href target rel class]
+  # Allowed HTML attributes when `render_message_html` is true.
+  config.chat_message.timestamp_formatter = ->(timestamp, _chat_message) { I18n.l(timestamp.in_time_zone, format: :long) }
+  # Formatter lambda for displayed timestamps.
+  config.chat_message.role_formatter = ->(role, _chat_message) { role.to_s.humanize }
+  # Formatter lambda for displayed role labels.
 
-  # Visuals
-  # config.mention_mark_hex_color = "b42318"
+  # Style scope
+  # config.style.mention_mark_hex_color = "b42318"
   # Mention highlight color (without #).
-  # config.mention_highlight_hex_color = "b42318"
+  # config.style.mention_highlight_hex_color = "b42318"
   # Legacy mention highlight color fallback.
-  # config.own_message_hex_color = "eef6ff"
+  # config.style.own_message_hex_color = "eef6ff"
   # Bubble background color for current participant messages.
-  # config.other_message_hex_color = "ffffff"
+  # config.style.other_message_hex_color = "ffffff"
   # Bubble background color for other participant messages.
-  config.role_message_hex_colors = {}
+  config.style.role_message_hex_colors = {}
   # Map role key to message bubble color.
-  config.show_timestamp = true
+  config.style.show_timestamp = true
   # Shows formatted timestamp on each message.
-  # config.show_role = true
+  # config.style.show_role = true
   # Shows participant role label near messages.
-  config.show_members = true
-  # Shows member list panel in chat UI.
-  config.system_messages = true
-  # Shows system timeline messages (joins, invites, moderation).
-  config.message_source_labels = TurboChat::Configuration::DEFAULT_MESSAGE_SOURCE_LABELS.dup
-  # Maps message source keys to labels shown on non-default source badges.
-  config.chat_style = "chat_style_bounded"
+  config.style.chat_style = "chat_style_bounded"
   # Chat layout style: `chat_style_bounded` or `chat_style_unbounded`.
-  config.composer_placeholder_text = "start chatting"
+  config.style.composer_placeholder_text = "start chatting"
   # Placeholder text for the message composer input.
+  config.style.signal_text_sheen = true
+  # Adds bracketed sheen styling to custom signal text.
+  # config.style.message_css_class_resolver = ->(_chat_message) { "chat-message" }
+  # Returns extra CSS class names for a message wrapper.
 
   # Optional composer controls (disabled by default)
-  # config.composer_add_files_display = true
+  # config.style.composer_add_files_display = true
   # Shows the add-files control in the composer.
-  # config.composer_add_files_active = true
+  # config.style.composer_add_files_active = true
   # Enables add-files control interaction.
-  # config.composer_microphone_display = true
+  # config.style.composer_microphone_display = true
   # Shows microphone control in composer.
-  # config.composer_microphone_active = true
+  # config.style.composer_microphone_active = true
   # Enables microphone control interaction.
 
-  # Optional browser events (disabled by default)
-  # config.emit_typing_events = true
+  # Events scope (disabled by default)
+  # config.events.emit_typing_events = true
   # Emits `turbo-chat:typing-started` and `turbo-chat:typing-ended`.
-  # config.emit_message_events = true
+  # config.events.emit_message_events = true
   # Emits `turbo-chat:message-sent`.
-  # config.emit_mention_events = true
+  # config.events.emit_mention_events = true
   # Emits `turbo-chat:mention`.
-  # config.emit_invitation_events = true
+  # config.events.emit_invitation_events = true
   # Emits `turbo-chat:invitation-accepted`.
-  # config.emit_chat_lifecycle_events = true
+  # config.events.emit_chat_lifecycle_events = true
   # Emits `turbo-chat:chat-*` lifecycle events.
 
-  # Optional ActiveSupport::Notifications events (disabled by default)
-  # config.emit_moderation_events = true
+  # Moderation scope (disabled by default)
+  # config.moderation.emit_moderation_events = true
   # Emits `turbo_chat.moderation.*` notifications.
-  # config.emit_blocked_words_events = true
+  # config.moderation.emit_blocked_words_events = true
   # Emits `turbo_chat.blocked_words.*` notifications.
 
-  # Signal behavior
-  config.signal_text_sheen = true
-  # Adds bracketed sheen styling to custom signal text.
+  # Signals scope
+  config.signals.signal_ttl_seconds = 60
+  # Maximum age (in seconds) for active typing/signal indicators.
   # Optional toggles (disabled by default)
-  # config.show_self_signals = true
+  # config.signals.show_self_signals = true
   # Shows your own active typing/signal indicators.
-  # config.replace_signals_on_message_submit = true
+  # config.signals.replace_signals_on_message_submit = true
   # Replaces existing signals when sending a message.
-
-  # Optional message rendering hooks
-  # config.message_css_class_resolver = ->(_chat_message) { "chat-message" }
-  # Returns extra CSS class names for a message wrapper.
-  # config.render_message_html = true
-  # Renders/sanitizes HTML in message bodies.
-  config.message_html_tags = %w[a b br code em i li ol p pre strong ul]
-  # Allowed HTML tags when `render_message_html` is true.
-  config.message_html_attributes = %w[href target rel class]
-  # Allowed HTML attributes when `render_message_html` is true.
-  config.timestamp_formatter = ->(timestamp, _chat_message) { I18n.l(timestamp.in_time_zone, format: :long) }
-  # Formatter lambda for displayed timestamps.
-  config.role_formatter = ->(role, _chat_message) { role.to_s.humanize }
-  # Formatter lambda for displayed role labels.
 end

data/lib/turbo_chat/configuration/defaults.rb

@@ -1,4 +1,18 @@
 class TurboChat::Configuration
+  def self.build_attribute_scopes(scoped_defaults)
+    scoped_defaults.each_with_object({}) do |(scope_name, defaults), mapping|
+      defaults.each_key do |attribute|
+        if mapping.key?(attribute)
+          existing_scope = mapping.fetch(attribute)
+          raise ArgumentError, "Duplicate configuration attribute `#{attribute}` across scopes: #{existing_scope}, #{scope_name}"
+        end
+
+        mapping[attribute] = scope_name
+      end
+    end.freeze
+  end
+  private_class_method :build_attribute_scopes
+
   DEFAULT_ROLE_DEFINITIONS = {
     "member" => {
       name: "Member",
@@ -51,10 +65,17 @@ class TurboChat::Configuration
     "whatsapp" => "WhatsApp"
   }.freeze
 
-  DEFAULTS = {
+  CHAT_DEFAULTS = {
     permission_adapter: -> { TurboChat::Permission },
     current_participant_resolver: nil,
     max_chat_participants: 10,
+    active_chat_window: -> { 5.minutes },
+    show_members: true,
+    system_messages: true,
+    disable_input: false
+  }.freeze
+
+  CHAT_MESSAGE_DEFAULTS = {
     max_message_length: 1000,
     message_history_limit: 200,
     enable_mentions: true,
@@ -65,6 +86,16 @@ class TurboChat::Configuration
     blocked_words: -> { [] },
     blocked_words_action: DEFAULT_BLOCKED_WORDS_ACTION,
     blocked_words_scramble_chars: -> { DEFAULT_BLOCKED_WORDS_SCRAMBLE_CHARS.dup },
+    message_insert_position: "append_end",
+    message_source_labels: -> { DEFAULT_MESSAGE_SOURCE_LABELS.dup },
+    render_message_html: false,
+    message_html_tags: -> { DEFAULT_MESSAGE_HTML_TAGS.dup },
+    message_html_attributes: -> { DEFAULT_MESSAGE_HTML_ATTRIBUTES.dup },
+    timestamp_formatter: -> { ->(timestamp, _chat_message = nil) { I18n.l(timestamp.in_time_zone, format: :long) } },
+    role_formatter: -> { ->(role, _chat_message = nil) { role.to_s.humanize } }
+  }.freeze
+
+  STYLE_DEFAULTS = {
     mention_mark_hex_color: nil,
     mention_highlight_hex_color: nil,
     own_message_hex_color: nil,
@@ -72,31 +103,50 @@ class TurboChat::Configuration
     role_message_hex_colors: -> { {} },
     show_timestamp: true,
     show_role: false,
-    show_members: true,
-    system_messages: true,
     composer_placeholder_text: "start chatting",
     composer_add_files_display: false,
     composer_add_files_active: false,
     composer_microphone_display: false,
     composer_microphone_active: false,
-    active_chat_window: -> { 5.minutes },
+    chat_style: "chat_style_bounded",
+    message_css_class_resolver: nil,
+    signal_text_sheen: true
+  }.freeze
+
+  MODERATION_DEFAULTS = {
+    emit_moderation_events: false,
+    emit_blocked_words_events: false
+  }.freeze
+
+  EVENTS_DEFAULTS = {
     emit_typing_events: false,
     emit_message_events: false,
     emit_mention_events: false,
     emit_invitation_events: false,
-    emit_chat_lifecycle_events: false,
-    emit_moderation_events: false,
-    emit_blocked_words_events: false,
-    signal_text_sheen: true,
+    emit_chat_lifecycle_events: false
+  }.freeze
+
+  SIGNALS_DEFAULTS = {
+    signal_ttl_seconds: 60,
     show_self_signals: false,
-    replace_signals_on_message_submit: false,
-    message_css_class_resolver: nil,
-    message_source_labels: -> { DEFAULT_MESSAGE_SOURCE_LABELS.dup },
-    chat_style: "chat_style_bounded",
-    render_message_html: false,
-    message_html_tags: -> { DEFAULT_MESSAGE_HTML_TAGS.dup },
-    message_html_attributes: -> { DEFAULT_MESSAGE_HTML_ATTRIBUTES.dup },
-    timestamp_formatter: -> { ->(timestamp, _chat_message = nil) { I18n.l(timestamp.in_time_zone, format: :long) } },
-    role_formatter: -> { ->(role, _chat_message = nil) { role.to_s.humanize } }
+    replace_signals_on_message_submit: false
   }.freeze
+
+  SCOPED_DEFAULTS = {
+    chat: CHAT_DEFAULTS,
+    chat_message: CHAT_MESSAGE_DEFAULTS,
+    style: STYLE_DEFAULTS,
+    moderation: MODERATION_DEFAULTS,
+    events: EVENTS_DEFAULTS,
+    signals: SIGNALS_DEFAULTS
+  }.freeze
+
+  ATTRIBUTE_SCOPES = build_attribute_scopes(SCOPED_DEFAULTS)
+
+  DEFAULTS = ATTRIBUTE_SCOPES.each_with_object({}) do |(attribute, scope_name), defaults|
+    defaults[attribute] = SCOPED_DEFAULTS.fetch(scope_name).fetch(attribute)
+  end.freeze
+
+  SCOPE_NAMES = SCOPED_DEFAULTS.keys.freeze
+  ATTRIBUTES = ATTRIBUTE_SCOPES.keys.freeze
 end

data/lib/turbo_chat/configuration/emoji_support.rb

@@ -7,19 +7,19 @@ class TurboChat::Configuration
       normalized_value = value.to_s.strip
       raise ArgumentError, "Emoji alias value cannot be blank" if normalized_value.blank?
 
-      @emoji_aliases = effective_emoji_aliases.merge(key => normalized_value)
+      self.emoji_aliases = effective_emoji_aliases.merge(key => normalized_value)
     end
 
     def remove_emoji_alias(name)
       key = normalize_emoji_alias_key(name)
       return if key.blank?
 
-      @emoji_aliases = effective_emoji_aliases.except(key)
+      self.emoji_aliases = effective_emoji_aliases.except(key)
     end
 
-    def clear_emoji_aliases! = @emoji_aliases = {}
+    def clear_emoji_aliases! = self.emoji_aliases = {}
 
-    def reset_emoji_aliases! = @emoji_aliases = DEFAULT_EMOJI_ALIASES.dup
+    def reset_emoji_aliases! = self.emoji_aliases = DEFAULT_EMOJI_ALIASES.dup
 
     def effective_emoji_aliases
       source = emoji_aliases.is_a?(Hash) ? emoji_aliases : {}

data/lib/turbo_chat/configuration.rb

@@ -8,13 +8,78 @@ class TurboChat::Configuration
   include EmojiSupport
   include BlockedWordsSupport
 
-  attr_accessor(*DEFAULTS.keys)
+  class Scope
+    class << self
+      attr_reader :scope_defaults
+
+      def configure_defaults(defaults)
+        @scope_defaults = defaults
+        attr_accessor(*defaults.keys)
+      end
+    end
+
+    def initialize
+      self.class.scope_defaults.each do |attribute, default_value|
+        instance_variable_set("@#{attribute}", TurboChat::Configuration.resolve_default_value(default_value))
+      end
+    end
+  end
+
+  class Chat < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:chat))
+  end
+
+  class ChatMessage < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:chat_message))
+  end
+
+  class Style < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:style))
+  end
+
+  class Moderation < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:moderation))
+  end
+
+  class Events < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:events))
+  end
+
+  class Signals < Scope
+    configure_defaults(SCOPED_DEFAULTS.fetch(:signals))
+  end
+
+  SCOPE_CLASSES = {
+    chat: Chat,
+    chat_message: ChatMessage,
+    style: Style,
+    moderation: Moderation,
+    events: Events,
+    signals: Signals
+  }.freeze
+
+  attr_reader(*SCOPE_NAMES)
+
+  ATTRIBUTE_SCOPES.each do |attribute, scope_name|
+    define_method(attribute) do
+      public_send(scope_name).public_send(attribute)
+    end
+
+    define_method("#{attribute}=") do |value|
+      public_send(scope_name).public_send("#{attribute}=", value)
+    end
+  end
 
   def initialize
-    DEFAULTS.each do |attribute, default_value|
-      value = default_value.respond_to?(:call) ? default_value.call : (default_value.dup rescue default_value)
-      instance_variable_set("@#{attribute}", value)
+    SCOPE_CLASSES.each do |scope_name, klass|
+      instance_variable_set("@#{scope_name}", klass.new)
     end
     @additional_roles = {}
   end
+
+  class << self
+    def resolve_default_value(default_value)
+      default_value.respond_to?(:call) ? default_value.call : (default_value.dup rescue default_value)
+    end
+  end
 end

data/lib/turbo_chat/permission.rb

@@ -26,6 +26,7 @@ class TurboChat::Permission
 
   def can_post_message?
     can_view_chat? &&
+      !chat_input_disabled? &&
       role_permission?(:post_message) &&
       !chat_closed? &&
       !actor_membership_muted? &&
@@ -65,4 +66,14 @@ class TurboChat::Permission
   def can_close_chat? = can_view_chat? && role_permission?(:close_chat)
 
   def can_reopen_chat? = can_view_chat? && role_permission?(:reopen_chat)
+
+  private
+
+  def chat_input_disabled?
+    configuration = TurboChat.configuration
+    value = configuration.respond_to?(:disable_input) ? configuration.disable_input : false
+    ActiveModel::Type::Boolean.new.cast(value)
+  rescue StandardError
+    false
+  end
 end

data/lib/turbo_chat/version.rb

@@ -1,3 +1,3 @@
 module TurboChat
-  VERSION = "0.1.11"
+  VERSION = "0.1.14"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: turbo_chat
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.1.14
 platform: ruby
 authors:
 - Alexander Haumer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-26 00:00:00.000000000 Z
+date: 2026-02-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails