kanso 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 396e93974cc0b18d97827d86306dc782af0e7cf5dd4455aa195147cf342b206b
-  data.tar.gz: cebb358075aa60d66845c99fd77a8c24d54fcfce6af0592f4e447a6d4f1e5bb1
+  metadata.gz: ac0633c240427e760e914ae8b29b2d8baf7ca67dbf94384e3116d014b425cacf
+  data.tar.gz: c8507a11acae941aee9513fa268b484c45361691a7f355a5bcb76a3a69669d29
 SHA512:
-  metadata.gz: 06b467cbda43277562df54f8617d0843d2f74888d46e54f204157708c851801587ec6902adae5ce3e8a302501cde02eea7161996e6a06670cf6264a20e740c1f
-  data.tar.gz: 5b166b635e005b0c63a07b558d43a1836426664e19d91362b43524d3a1095d7d62b8281ebbd8a10e62cd0c00aefdfa3cdf7b7d320a147ce61cf2b2355e7e0029
+  metadata.gz: 9ea4f5edf76ec98d6057f5afc2baed09063f45acbdd662e79f8a3613b0e004c12f156793f4501727394e6d333340809602f544d67df5b9b4264efb4110090cd4
+  data.tar.gz: 3d9798e11dc266d680dbc006fe7a09c09891abfe09fbdcc4add591bba41537607eed39f63ccd358787add74051f1811b06e330702c3095edee6a309fdd3e1c2c

data/README.md

@@ -1,10 +1,10 @@
-# Kanso (簡素)
-
-A rigorously crafted component library for modern Rails applications, built on a philosophy of radical simplicity.
+<p align="center">
+  <img src=".github/assets/kansobanner.jpg" alt="Kanso Minimalist Banner" width="100%">
+</p>
 
-Kanso (簡素) is a Japanese design principle valuing clarity and the elimination of the non-essential. This library is the embodiment of that idea, providing a set of foundational, rigorously tested components that are respectful guests in your application.
+# Kanso (簡素)
 
-This README is the single source of truth. The best API is one that needs no explanation.
+Kanso (簡素) is a Japanese design principle valuing clarity and the elimination of the non-essential. This UI component library is the embodiment of that idea: providing foundational, rigorously tested ViewComponents that act as respectful guests in your Rails application.
 
 ## Prerequisites
 
@@ -91,7 +91,7 @@ Renders a performant, inline SVG icon from the Kanso library.
 
 **Available Icons:**
 
-A complete list of all available icons can be found in the source code:➡️ **[View all available icons](https://github.com/santonero/kanso/tree/main/app/assets/images/kanso/icons)**
+A complete list of all available icons can be found in the source code: **[View all available icons](https://github.com/santonero/kanso/tree/main/app/assets/images/kanso/icons)**.
 
 ---
 
@@ -108,7 +108,8 @@ Renders a dismissible notification panel.
 **Options:**
 *   `message:` (`String`, **required**): The notification's content.
 *   `title:` (`String`, optional): An optional title.
-*   `theme:` (`Symbol`): The style. Can be `:success`, `:error`, `:warning`, or `:info`. Defaults to `:info`.
+*   `theme:` (`Symbol`): The style. Can be `:success`, `:error`, `:warning`, or `:info`. Defaults to `:info`.<br>
+*(Note: For seamless Rails integration, standard flash keys :notice and :alert are automatically mapped to :success and :error respectively).*
 
 **Implementation Patterns:**
 
@@ -126,7 +127,7 @@ A notification is most effective when rendered dynamically into a fixed containe
 
     *In a controller:*
     ```ruby
-    redirect_to @post, flash: { success: "Post was successfully updated." }
+    redirect_to @post, flash: { success: "Post was updated successfully." }
     ```
     *In your layout (inside the container):*
     ```erb
@@ -230,22 +231,17 @@ Turbo.StreamActions.redirect = function() {
 }
 ```
 
-*Next, in your controller, set the flash and respond to the `turbo_stream` format:*
+*Next, in your controller, respond to the `turbo_stream` format and set the flash:*
 ```ruby
 # app/controllers/products_controller.rb
 def create
   @product = Product.new(product_params)
   if @product.save
-    # Set the flash message that Turbo Drive will render on the next page.
-    flash[:success] = "Product was successfully created."
-
     respond_to do |format|
-      format.turbo_stream
-      format.html { redirect_to @product, flash: { success: "Product was successfully created." } }
+      format.turbo_stream { flash[:success] = "Product was created successfully." }
     end
   else
-    # On validation failure, Turbo re-renders the frame with errors automatically.
-    render :new, status: :unprocessable_entity
+    render :new, status: :unprocessable_content
   end
 end
 ```

data/app/components/kanso/notification_component.rb

@@ -47,12 +47,20 @@ module Kanso
       )
     }.freeze
 
+    RAILS_FLASH_ALIASES = {
+      notice: :success,
+      alert: :error
+    }.freeze
+
     attr_reader :title, :message, :theme_data
 
     def initialize(message:, title: nil, theme: :info)
       @title = title
       @message = message
-      @theme_data = THEMES[theme.to_sym] || THEMES[:info]
+
+      theme_sym = theme.to_sym
+      mapped_theme = RAILS_FLASH_ALIASES[theme_sym] || theme_sym
+      @theme_data = THEMES[mapped_theme] || THEMES[:info]
     end
   end
 end

data/lib/kanso/version.rb

@@ -1,3 +1,3 @@
 module Kanso
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kanso
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - santonero
@@ -186,7 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.9
+rubygems_version: 4.0.15
 specification_version: 4
 summary: An elemental UI component library for Rails, guided by the principle of simplicity.
 test_files: []