tramway 2.0.1.1 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bd6eb6d708a8b3f4ce6b23fa65dbef402851081a090a14b7ca2d01d14694b6d
-  data.tar.gz: 8dcab579e2dbf2a9a21178d710ec43edfd40a006d4a54755bd885eab71c7dd64
+  metadata.gz: 5565893c9153d2914e800609426fe0be62fe9c46163c80e4964cdf427c4178f4
+  data.tar.gz: 374172adbeaf55a926859c54c21ef78d2d9d56fbbe84af44544bd0a3cd1de5c3
 SHA512:
-  metadata.gz: d79da51f2ba0157b7dd94a52e59a2fd379166dc0397a72375f42b24513f6e78d2a7b93b4d36d1ca2d1f4fd328d7beea5de021a98c40e335c0f0b76e6ef85ac03
-  data.tar.gz: ae2a74273a7812c6b5c7e0bd80487fd61f22d1d6cc082d1117d328d4d279b28b5b90ba8008583463c1c702d86fa618de05c3abb3cec87fcc71cc2e5982abe18a
+  metadata.gz: 7061fae419485630e856be9422f9b495ecb6316f367c7341f019bb360782e13d4993e7324eedac1eed9f51b440a56b33cbb0bbc53f8f2955ef7d90312ae3bcdd
+  data.tar.gz: 02d84eabc379ea00eb75b2f6750dd928d5eabe088d71dfe5442598253e1afc1fa11bb2cf7a3cec789cc56f76daa3edde66c2eca559ba39d38a73faceb25bd919

data/README.md

@@ -13,6 +13,7 @@ Unite Ruby on Rails brilliance. Streamline development with Tramway.
   * [Tramway Decorators](https://github.com/Purple-Magic/tramway#tramway-decorators)
   * [Tramway Form](https://github.com/Purple-Magic/tramway#tramway-form)
   * [Tramway Navbar](https://github.com/Purple-Magic/tramway#tramway-navbar)
+  * [Tramway Flash](https://github.com/Purple-Magic/tramway#tramway-flash)
   * [Tramway Table Component](https://github.com/Purple-Magic/tramway#tramway-table-component)
   * [Tailwind-styled forms](https://github.com/Purple-Magic/tramway#tailwind-styled-forms)
     * [Stimulus-based inputs](https://github.com/Purple-Magic/tramway#stimulus-based-inputs)
@@ -708,6 +709,27 @@ tramway_navbar title: 'Purple Magic' do |nav|
 end
 ```
 
+### Tramway Flash
+
+`tramway_flash` renders the Tailwind-styled flash component that Tramway uses in its layouts. Pass the flash text and type, and
+the helper will resolve the proper Tailwind color (for example `:success` -> green, `:warning` -> orange). You can also provide
+custom HTML options directly (e.g., `class:`, `data:`) and they will be merged into the flash container.
+
+```haml
+-# Haml example
+= tramway_flash text: flash[:notice], type: :hope
+= tramway_flash text: 'Double check your data', type: :greed, class: 'mt-2', data: { turbo: 'false' }
+```
+
+```erb
+<%# ERB example %>
+<%= tramway_flash text: flash[:alert], type: :rage %>
+<%= tramway_flash text: 'Saved!', type: :will, data: { controller: 'dismissible' } %>
+```
+
+Use the `type` argument is compatible to [Lantern Color Palette](https://github.com/TrinityMonsters/tramway/blob/main/README.md#lantern-color-palette) or provide a `color:` keyword to set
+the Tailwind color family explicitly.
+
 ### Tramway Table Component
 
 Tramway provides a responsive, tailwind-styled table with light and dark themes. Use the `tramway_table`, `tramway_row`, and
@@ -795,19 +817,7 @@ Tramway ships with helpers for common UI patterns built on top of Tailwind compo
     options: { data: { controller: 'submit-once' } } %>
   ```
 
-  The `type` option maps semantic intent to Tailwind color families. The full set of supported values is:
-
-  | Type | Color |
-  | ---- | ----- |
-  | `default`, `life` | Gray |
-  | `primary`, `hope` | Blue |
-  | `secondary` | Zinc |
-  | `success`, `will` | Green |
-  | `warning`, `greed` | Orange |
-  | `danger`, `rage` | Red |
-  | `love` | Violet |
-  | `compassion` | Indigo |
-  | `fear` | Yellow |
+  The `type` option maps semantic intent to [Lantern Color Palette](https://github.com/TrinityMonsters/tramway/blob/main/README.md#lantern-color-palette).
 
   If none of the predefined semantic types fit your needs, you can supply a Tailwind color family directly using the `color`
   option—for example: `color: :gray`. When you pass a custom color ensure the corresponding utility classes exist in your
@@ -1028,6 +1038,20 @@ Tramway.configure do |config|
 end
 ```
 
+## Lantern Color Palette
+
+  | Type | Color |
+  | ---- | ----- |
+  | `default`, `life` | Gray |
+  | `primary`, `hope` | Blue |
+  | `secondary` | Zinc |
+  | `success`, `will` | Green |
+  | `warning`, `greed` | Orange |
+  | `danger`, `rage` | Red |
+  | `love` | Violet |
+  | `compassion` | Indigo |
+  | `fear` | Yellow |
+
 ## Articles
 * [Tramway on Rails](https://kalashnikovisme.medium.com/tramway-on-rails-32158c35ed68)
 * [Tramway is the way to deal with little things for Rails developers](https://medium.com/@kalashnikovisme/tramway-is-the-way-to-deal-with-little-things-for-rails-developers-4f502172a18c)
@@ -1035,6 +1059,7 @@ end
 * [Behave as ActiveRecord. Why do we want objects to be AR lookalikes?](https://kalashnikovisme.medium.com/behave-as-activerecord-why-do-we-want-objects-to-be-ar-lookalikes-d494d692e1d3)
 * [Decorating associations in Rails with Tramway](https://kalashnikovisme.medium.com/decorating-associations-in-rails-with-tramway-b46a28392f9e)
 * [Easy-to-use Tailwind-styled multi-select built with Stimulus](https://medium.com/@kalashnikovisme/easy-to-use-tailwind-styled-multi-select-built-with-stimulus-b3daa9e307aa)
+* [Lantern Color Palette]([https://github.com/TrinityMonsters/tramway/blob/main/README.md#lantern-color-palette](https://kalashnikovisme.medium.com/lantern-buttons-in-rails-ff61688fd8e3?postPublishedType=repub))
 
 ## Contributing
 

data/app/components/tailwinds/button_component.rb

@@ -31,8 +31,8 @@ module Tailwinds
 
     def default_classes
       [
-        'btn', 'btn-primary', 'font-bold', 'rounded-sm', 'flex', 'flex-row', 'whitespace-nowrap', size_classes.to_s,
-        options[:class].to_s
+        'btn', 'btn-primary', 'flex', 'flex-row', 'font-bold', 'rounded-sm', 'flex', 'flex-row', 'whitespace-nowrap',
+        'items-center', 'space-x-1', size_classes.to_s, options[:class].to_s
       ]
     end
 

data/app/components/tailwinds/flash_component.html.haml

@@ -0,0 +1,23 @@
+:css
+  @keyframes fadeout {
+    0% {
+      opacity: 1;
+    }
+
+    80% {
+      opacity: 1;
+    }
+
+    100% {
+      opacity: 0;
+    }
+  }
+
+  .flash {
+    animation: fadeout 2.7s ease-out forwards;
+  }
+
+.fixed.top-4.right-4.z-50.space-y-2{ **options }
+  .flash.opacity-100.text-white.px-4.py-2.rounded.shadow{ class: "bg-#{resolved_color}-700" }
+    .text-xl.font-bold
+      = text

data/app/components/tailwinds/flash_component.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Tailwinds
+  # Description: A Tailwinds flash message component for displaying notifications.
+  class FlashComponent < Tailwinds::BaseComponent
+    option :text
+    option :type, optional: true, default: -> {}
+    option :color, optional: true, default: -> {}
+    option :options, optional: true, default: -> { {} }
+  end
+end

data/app/views/tramway/layouts/application.html.haml

@@ -19,39 +19,13 @@
     / 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]
+      = tramway_flash text: flash[:notice].presence || flash[:alert],
+        type: flash[:notice].present? ? :will : :rage,
+        id: 'flash-container'
 
     .container.mx-auto.p-4.flex.align-center.justify-center
       = yield

data/lib/tramway/helpers/views_helper.rb

@@ -67,6 +67,10 @@ module Tramway
       def tramway_title(text: nil, &)
         component 'tailwinds/title', text:, &
       end
+
+      def tramway_flash(text:, type:, **options)
+        component 'tailwinds/flash', text:, type:, options:
+      end
     end
   end
 end

data/lib/tramway/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tramway
 version: !ruby/object:Gem::Version
-  version: 2.0.1.1
+  version: 2.0.3
 platform: ruby
 authors:
 - kalashnikovisme
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-07 00:00:00.000000000 Z
+date: 2025-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -152,6 +152,8 @@ files:
 - app/components/tailwinds/button_component.rb
 - app/components/tailwinds/containers/narrow_component.html.haml
 - app/components/tailwinds/containers/narrow_component.rb
+- app/components/tailwinds/flash_component.html.haml
+- app/components/tailwinds/flash_component.rb
 - app/components/tailwinds/form/builder.rb
 - app/components/tailwinds/form/date_field_component.html.haml
 - app/components/tailwinds/form/date_field_component.rb