tramway 2.2.7 → 2.3.1

data/app/components/{tailwinds → tramway}/form/multiselect/selected_item_template_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     module Multiselect
       # Tailwind-styled multi-select field

data/app/components/{tailwinds → tramway}/form/multiselect_component.html.haml

@@ -1,6 +1,6 @@
 .mb-4.relative
   - if @label
-    = component('tailwinds/form/label', for: @for) do
+    = component('tramway/form/label', for: @for) do
       = @label
   %div{ role: :combobox, data: multiselect_hash, id: "#{@for}_multiselect" }
     - classes = "#{size_class(:multiselect_input)} #{select_base_classes}"
@@ -8,6 +8,6 @@
       .flex.flex-row.flex-nowrap.overflow-x-auto.space-x-1{ data: { "multiselect-target" => "showSelectedArea" } }
       .flex.flex-col.justify-center
         .caret-down{ data: { "multiselect-target" => "caretDown" } }
-          = component 'tailwinds/form/multiselect/caret', size: size, direction: :down
+          = component 'tramway/form/multiselect/caret', size: size, direction: :down
         .caret-up.hidden{ data: { "multiselect-target" => "caretUp" } }
-          = component 'tailwinds/form/multiselect/caret', size: size, direction: :up
+          = component 'tramway/form/multiselect/caret', size: size, direction: :up

data/app/components/{tailwinds → tramway}/form/multiselect_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     # Tailwind-styled multi-select field
     class MultiselectComponent < TailwindComponent
@@ -73,7 +73,7 @@ module Tailwinds
 
       def select_as_input
         component(
-          'tailwinds/form/multiselect/select_as_input',
+          'tramway/form/multiselect/select_as_input',
           options:,
           attribute:,
           input:,
@@ -96,15 +96,15 @@ module Tailwinds
       end
 
       def selected_item_template
-        component('tailwinds/form/multiselect/selected_item_template', size:)
+        component('tramway/form/multiselect/selected_item_template', size:)
       end
 
       def dropdown_container
-        component('tailwinds/form/multiselect/dropdown_container', size:)
+        component('tramway/form/multiselect/dropdown_container', size:)
       end
 
       def item_container
-        component('tailwinds/form/multiselect/item_container', size:)
+        component('tramway/form/multiselect/item_container', size:)
       end
     end
   end

data/app/components/{tailwinds → tramway}/form/number_field_component.html.haml

@@ -1,6 +1,6 @@
 .mb-4
   - if @label
-    = component('tailwinds/form/label', for: @for) do
+    = component('tramway/form/label', for: @for) do
       = @label
   - classes = "#{size_class(:text_input)} #{text_input_base_classes}"
   = @input.call @attribute, **@options.merge(class: classes), value: @value

data/app/components/{tailwinds → tramway}/form/number_field_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     # Tailwind-styled numeric field
     class NumberFieldComponent < TailwindComponent

data/app/components/{tailwinds → tramway}/form/select_component.html.haml

@@ -1,6 +1,6 @@
 .mb-4
   - if @label
-    = component('tailwinds/form/label', for: @for) do
+    = component('tramway/form/label', for: @for) do
       = @label
   - classes = "#{size_class(:select_input)} #{select_base_classes}"
   = @input.call(@attribute, @collection, { selected: @value }, @options.merge(class: classes))

data/app/components/{tailwinds → tramway}/form/select_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     # Tailwind-styled select field
     class SelectComponent < TailwindComponent

data/app/components/{tailwinds → tramway}/form/text_area_component.html.haml

@@ -1,6 +1,6 @@
 .mb-4
   - if @label
-    = component('tailwinds/form/label', for: @for) do
+    = component('tramway/form/label', for: @for) do
       = @label
   - classes = "#{size_class(:text_input)} #{text_input_base_classes}"
   = @input.call @attribute, **@options.merge(class: classes), value: @value

data/app/components/{tailwinds → tramway}/form/text_area_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     # Tailwind-styled text field
     class TextAreaComponent < TailwindComponent

data/app/components/{tailwinds → tramway}/form/text_field_component.html.haml

@@ -1,6 +1,6 @@
 .mb-4
   - if @label
-    = component('tailwinds/form/label', for: @for) do
+    = component('tramway/form/label', for: @for) do
       = @label
   - classes = "#{size_class(:text_input)} #{text_input_base_classes}"
   = @input.call @attribute, **@options.merge(class: classes), value: @value

data/app/components/{tailwinds → tramway}/form/text_field_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Form
     # Tailwind-styled text field
     class TextFieldComponent < TailwindComponent

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

@@ -0,0 +1,2 @@
+%div
+  = rendered_html

data/app/components/tramway/native_text_component.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require 'erb'
+
+module Tramway
+  # Displays text with size-based utility classes.
+  class NativeTextComponent < Tramway::BaseComponent
+    URL_REGEX = %r{https?://[^\s<]+}
+    MAX_URL_LENGTH = 41
+    HEADER_REGEX = /\A(#{Regexp.escape('#')}{1,6})\s+(.+)\z/
+    LIST_ITEM_REGEX = /\A[-*]\s+(.+)\z/
+    HEADER_CLASSES = {
+      1 => 'text-4xl font-bold leading-tight mt-4 mb-2',
+      2 => 'text-3xl font-bold leading-tight mt-4 mb-2',
+      3 => 'text-2xl font-semibold leading-snug mt-3 mb-2',
+      4 => 'text-xl font-semibold leading-snug mt-3 mb-2',
+      5 => 'text-lg font-semibold leading-snug mt-2 mb-1',
+      6 => 'text-base font-semibold leading-snug mt-2 mb-1'
+    }.freeze
+
+    option :text
+    option :size, optional: true, default: -> { :middle }
+    option :klass, optional: true, default: -> { '' }
+
+    def rendered_html
+      # Safe because this is an empty static string literal, not user-controlled content.
+      return ''.html_safe if text.blank?
+
+      helpers.safe_join(rendered_blocks)
+    end
+
+    def text_class
+      { small: 'text-sm', large: 'text-lg', middle: 'text-base' }.fetch(size, 'md:text-sm lg:text-base') + " #{klass}"
+    end
+
+    private
+
+    # rubocop:disable Metrics/AbcSize
+    # rubocop:disable Metrics/MethodLength
+    def rendered_blocks
+      blocks = []
+      list_items = []
+
+      text.split("\n").each do |line|
+        stripped_line = line.strip
+
+        if stripped_line.blank?
+          flush_list_items(blocks, list_items)
+          next
+        end
+
+        header_match = stripped_line.match(HEADER_REGEX)
+        if header_match
+          flush_list_items(blocks, list_items)
+          blocks << helpers.content_tag(
+            "h#{header_match[1].length}",
+            render_inline_markdown(header_match[2]),
+            class: header_class(header_match[1].length)
+          )
+          next
+        end
+
+        list_match = stripped_line.match(LIST_ITEM_REGEX)
+        if list_match
+          list_items << helpers.content_tag(:li, render_inline_markdown(list_match[1]),
+                                            class: "#{text_class} marker:hidden")
+          next
+        end
+
+        flush_list_items(blocks, list_items)
+        blocks << helpers.content_tag(:p, render_inline_markdown(stripped_line), class: "#{text_class} my-1")
+      end
+
+      flush_list_items(blocks, list_items)
+      blocks
+    end
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/MethodLength
+
+    def flush_list_items(blocks, list_items)
+      return if list_items.empty?
+
+      blocks << helpers.content_tag(:ul, helpers.safe_join(list_items), class: "list-none pl-5 my-2 #{klass}")
+      list_items.clear
+    end
+
+    def header_class(level)
+      "#{HEADER_CLASSES.fetch(level)} #{klass}".strip
+    end
+
+    def render_inline_markdown(content)
+      escaped_content = ERB::Util.html_escape(content)
+      with_bold = escaped_content.gsub(/\*\*(.+?)\*\*/, '<strong>\\1</strong>')
+      with_italics = with_bold.gsub(/(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)/, '<em>\\1</em>')
+      with_underscored_italics = with_italics.gsub(/(?<!_)_(?!_)(.+?)(?<!_)_(?!_)/, '<em>\\1</em>')
+      # Safe because user input has already been escaped above and only controlled tags are introduced.
+      # rubocop:disable Rails/OutputSafety
+      linkified(with_underscored_italics).html_safe
+    end
+
+    # rubocop:disable Metrics/MethodLength
+    # rubocop:disable Metrics/AbcSize
+    def linkified(content)
+      fragments = []
+      current_index = 0
+
+      content.to_enum(:scan, URL_REGEX).map do
+        match = Regexp.last_match
+        matched_url = match[0]
+        url, trailing = strip_trailing_punctuation(matched_url)
+
+        # Safe because this fragment is sliced from `content`, which was already HTML-escaped.
+
+        fragments << content[current_index...match.begin(0)].html_safe # rubocop:disable Rails/OutputSafety
+        fragments << helpers.link_to(
+          shorten(url),
+          url,
+          target: '_blank',
+          rel: 'noopener noreferrer',
+          class: 'text-blue-400 hover:underline'
+        )
+        # Safe because `trailing` can only contain stripped URL punctuation (.,!?;:).
+        fragments << trailing.html_safe if trailing.present? # rubocop:disable Rails/OutputSafety
+        current_index = match.end(0)
+      end
+
+      # Safe because this tail fragment also comes from the already escaped `content` string.
+      fragments << content[current_index..].html_safe if current_index < content.length
+      # rubocop:enable Rails/OutputSafety
+
+      helpers.safe_join(fragments)
+    end
+    # rubocop:enable Metrics/AbcSize
+    # rubocop:enable Metrics/MethodLength
+
+    def strip_trailing_punctuation(url)
+      stripped_url = url.sub(/[.,!?;:]+\z/, '')
+      trailing = url.delete_prefix(stripped_url)
+      [stripped_url, trailing]
+    end
+
+    def shorten(url)
+      return url if url.length <= MAX_URL_LENGTH
+
+      "#{url[0...MAX_URL_LENGTH]}..."
+    end
+  end
+end

data/app/components/{tailwinds → tramway}/nav/item/button_component.rb

@@ -2,12 +2,12 @@
 
 require 'rules/turbo_html_attributes_rules'
 
-module Tailwinds
+module Tramway
   module Nav
     module Item
       # Render button styled with Tailwind using button_to methods
       #
-      class ButtonComponent < Tailwinds::Nav::ItemComponent
+      class ButtonComponent < Tramway::Nav::ItemComponent
         def initialize(**options)
           @href = options[:href]
           @method = options[:method]

data/app/components/{tailwinds → tramway}/nav/item/link_component.rb

@@ -2,12 +2,12 @@
 
 require 'rules/turbo_html_attributes_rules'
 
-module Tailwinds
+module Tramway
   module Nav
     module Item
       # Render button styled with Tailwind using link_to methods
       #
-      class LinkComponent < Tailwinds::Nav::ItemComponent
+      class LinkComponent < Tramway::Nav::ItemComponent
         def initialize(**options)
           @href = options[:href]
           @options = Rules::TurboHtmlAttributesRules.prepare_turbo_html_attributes(options:)

data/app/components/{tailwinds → tramway}/nav/item_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Nav
     # Base class for all Nav::ItemComponent classes
     #

data/app/components/{tailwinds → tramway}/navbar_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   # Navbar component
   class NavbarComponent < TailwindComponent
     def initialize(**options)

data/app/components/{tailwinds → tramway}/pagination/base.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Base component for rendering a Kaminari pagination
     class Base < Tramway::BaseComponent

data/app/components/{tailwinds → tramway}/pagination/first_page_component.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari first page component for rendering a first page button in a pagination
-    class FirstPageComponent < Tailwinds::Pagination::Base
+    class FirstPageComponent < Tramway::Pagination::Base
     end
   end
 end

data/app/components/{tailwinds → tramway}/pagination/gap_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari gap component for rendering a gap in a pagination
     class GapComponent < Tramway::BaseComponent

data/app/components/{tailwinds → tramway}/pagination/last_page_component.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari next page component for rendering a last page button in a pagination
-    class LastPageComponent < Tailwinds::Pagination::Base
+    class LastPageComponent < Tramway::Pagination::Base
     end
   end
 end

data/app/components/{tailwinds → tramway}/pagination/next_page_component.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari next page component for rendering a next page button in a pagination
-    class NextPageComponent < Tailwinds::Pagination::Base
+    class NextPageComponent < Tramway::Pagination::Base
     end
   end
 end

data/app/components/{tailwinds → tramway}/pagination/page_component.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari page component for rendering a page button in a pagination
-    class PageComponent < Tailwinds::Pagination::Base
+    class PageComponent < Tramway::Pagination::Base
       option :page
 
       def current_page_classes

data/app/components/{tailwinds → tramway}/pagination/prev_page_component.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Pagination
     # Kaminari prev page component for rendering a prev page button in a pagination
-    class PrevPageComponent < Tailwinds::Pagination::Base
+    class PrevPageComponent < Tramway::Pagination::Base
     end
   end
 end

data/app/components/{tailwinds → tramway}/table/cell_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Table
     # Component for rendering a cell in a table
     class CellComponent < Tramway::BaseComponent

data/app/components/{tailwinds → tramway}/table/header_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Table
     # Component for rendering a header in a table
     class HeaderComponent < Tramway::BaseComponent

data/app/components/{tailwinds → tramway}/table/row/preview_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Table
     module Row
       # Row component for rendering a row in a table

data/app/components/{tailwinds → tramway}/table/row_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   module Table
     # Component for rendering a row in a table
     class RowComponent < Tramway::BaseComponent

data/app/components/{tailwinds → tramway}/table_component.html.haml

@@ -1,4 +1,4 @@
-= helpers.component 'tailwinds/table/row/preview'
+= helpers.component 'tramway/table/row/preview'
 
 - width_class = options[:class]&.include?('w-') ? '' : 'w-full'
 

data/app/components/{tailwinds → tramway}/table_component.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-module Tailwinds
+module Tramway
   # Table component for rendering a table
   class TableComponent < Tramway::BaseComponent
     option :options, optional: true, default: -> { {} }

data/app/components/{tailwinds → tramway}/title_component.rb

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

data/app/views/kaminari/_first_page.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/first_page', current_page:, url:, remote:
+= component 'tramway/pagination/first_page', current_page:, url:, remote:

data/app/views/kaminari/_gap.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/gap'
+= component 'tramway/pagination/gap'

data/app/views/kaminari/_last_page.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/last_page', current_page:, url:, remote:
+= component 'tramway/pagination/last_page', current_page:, url:, remote:

data/app/views/kaminari/_next_page.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/next_page', current_page:, url:, remote:
+= component 'tramway/pagination/next_page', current_page:, url:, remote:

data/app/views/kaminari/_page.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/page', current_page:, url:, remote:, page:
+= component 'tramway/pagination/page', current_page:, url:, remote:, page:

data/app/views/kaminari/_prev_page.html.haml

@@ -1 +1 @@
-= component 'tailwinds/pagination/prev_page', current_page:, url:, remote:
+= component 'tramway/pagination/prev_page', current_page:, url:, remote:

data/app/views/tramway/chats/_message.html.haml

@@ -0,0 +1,4 @@
+= component 'tramway/chats/message',
+  type:,
+  text:,
+  sent_at:

data/config/locales/en.yml

@@ -15,3 +15,7 @@ en:
       created: "The record is created"
       updated: "The record is updated"
       deleted: "The record is deleted"
+    chat:
+      placeholders:
+        waiting: "Waiting for an answer..."
+        type: "Type your message..."

data/config/tailwind.config.js

@@ -27,7 +27,87 @@ module.exports = {
 
     // === Entities Index Page ===
     'md:mt-8',
-    
+
+    // === Chat components ===
+    'mt-6',
+    'mt-3',
+    'max-h-full',
+    'rounded-2xl',
+    'rounded-tl-md',
+    'rounded-tr-md',
+    'bg-white',
+    'bg-gray-50',
+    'bg-blue-600',
+    'shadow-sm',
+    'border-t',
+    'border-gray-700',
+    'bg-gray-800',
+    'bg-gray-800/60',
+    'bg-gray-900',
+    'bg-blue-500',
+    'hover:bg-blue-400',
+    'text-gray-100',
+    'text-gray-400',
+    'text-blue-400',
+    'placeholder:text-gray-400',
+    'focus:border-blue-400',
+    'focus:ring-blue-500/30',
+    'ring-gray-700',
+    'h-8',
+    'flex-1',
+    'gap-2',
+    'gap-3',
+    'items-start',
+    'items-end',
+    'max-w-lg',
+    'overflow-hidden',
+    'overflow-y-auto',
+    'my-4',
+    'p-6',
+    'pb-1',
+    'py-3',
+    'ring-1',
+    'space-y-4',
+    'text-right',
+    'text-sm',
+    'text-gray-900',
+    'text-blue-100/90',
+    'text-red-200',
+    'underline',
+    'break-all',
+    'animate-spin',
+    'placeholder:text-gray-400',
+    'focus:border-blue-500',
+    'focus:outline-none',
+    'focus:ring-2',
+    'focus:ring-blue-200',
+    'disabled:bg-gray-100',
+    'hover:bg-blue-500',
+    'bg-blue-600',
+    'bg-gray-800/60',
+    'min-h-0',
+    'min-w-0',
+    'flex-1',
+    'overflow-y-auto',
+    'overflow-hidden',
+    'shrink-0',
+    'md:p-4',
+    'md:p-6',
+    'p-2',
+    'md:gap-1',
+    'md:space-y-4',
+    'space-y-2',
+    'md:pt-2',
+    'md:rounded-xl',
+    'rounded-t-xl',
+    'md:rounded-full',
+    'rounded-bl-2xl',
+    'md:border',
+    'md:gap-1',
+    'hover:underline',
+    'marker:hidden',
+    'list-none',
+
     // === Custom table layout utilities ===
     'div-table',
     'div-table-row',

data/docs/AGENTS.md

@@ -127,6 +127,15 @@ Use `tramway_form_for` instead `form_with`, `form_for`
 ### Rule 8
 Inherit all components from Tramway::BaseComponent
 
+### Rule 8.1
+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.
+
+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
+it raises `ArgumentError`. `chat_id` must match the stream id used in `tramway_chat`.
+
 ### Rule 9
 If page `create` or `update` is configured for an entity, use Tramway Form pattern for forms. Visible fields are configured via `form_fields` method.
 
@@ -443,6 +452,18 @@ scope :for_role, -> (role) { where role: role }
 ### Rule 28
 In case, you need to make a one link in tramway_table on each row. Use `tramway_row href: your_link` instead of putting the like inside a cell.
 
+### Rule 29
+Always use tramway decorated objects in views.
+
+### Rule 30
+For Tailwind classes 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.
+
+### Rule 32
+In Tramway Decorators, use `delegate_attributes` method instead of `delegate :something, to: :object`
+
 ## Controller Patterns
 
 - Keep actions short and explicit with guard clauses.