lato 3.11.8 → 3.11.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f05b67d482485eda6335b24f463fa5fd8de9b339ad75e2f01919179d18d64300
-  data.tar.gz: 6141f29a7f830da8a61060b5d13f10b1f4dc2304bf7e191e1004c7425c4a746b
+  metadata.gz: ddd7c01a9cc4fe2d157455aef4dbd490520bfc6202e3fe6b9886bb9c50424ab6
+  data.tar.gz: 65074da85897c91205dc2f4163d7a9f1d8f8a28625f96a6114b28dd596e04b62
 SHA512:
-  metadata.gz: 9291584af35ac2a3a9af5e1b1decf622ca5b9f677901c37e6dd30c70c3008e0e1bc6cd2f0ced9028c9c901d6c2097b39ad94bd86b8165515515be244eb4b239c
-  data.tar.gz: d094a873bdb96294c3d002c8963850a0cc7b3c3c6d905e89728c12e41dc7e4ae687858c7f031c5ac73f7224fe458c52e3d6a8e3c7acf743d05bf32093c325a84
+  metadata.gz: 5e58f5ab69f0a9bd43ccecf90451ff7784925bf29261348a221ab6ebb0e33b06fc2887fb7799390ecad4b3b80c7e6095facd4c5b6503b7c0c1e366de7d806eb4
+  data.tar.gz: 3bcd8581b91971c86df3fcd7166ddef1978a899759533017ec915107ac019b79f03ee04f45d12841dabf80f4ef1864a274fd645239e2d75a845b1c2ad7c2d294

data/README.md

@@ -2,21 +2,27 @@
 
 [![Gem Version](https://badge.fury.io/rb/lato.svg)](https://badge.fury.io/rb/lato)
 
-Lato is a Rails Engine to deliver a full featured web panel for your Rails application.
+Lato is a Rails Engine to deliver a full featured web panel for your [Rails](https://rubyonrails.org/) application.
 
 This gem includes:
 - User management with full authentication (signin, signup, recover password, email validation, Google Authenticator multi-factor authentication, ETH wallet connection);
-- Web panel UI (Navbar, Sidebar, Body) with Bootstrap;
+- Web panel UI (Navbar, Sidebar, Body) with [Bootstrap](https://getbootstrap.com/) and [Bootstrap Icons](https://icons.getbootstrap.com/) integrated;
 - Some UI components ready to use integrated with Rails (data tables, forms, modals, async job executions);
 
 The gem is designed to be easily **customizable and extendable**. You can fully customize the UI and the functionalities of the panel. You can also add new functionalities and components to the panel on the main application or develop new engines to extend the panel.
 
-The gem is ready to be used with the **latest Rails 7+** features like **ESM import maps**, **Turbo** and **Stimulus**.
+The gem is ready to be used with the **latest Rails 7+** features like **[ESM import maps](https://github.com/rails/importmap-rails)**, **[Turbo](https://turbo.hotwired.dev/)** and **[Stimulus](https://stimulus.hotwired.dev)**.
 
 The front-end is designed to be responsive, mobile friendly and accessible.
 
 <img src="./preview.gif" alt="Lato preview" width="100%">
 
+## Full documentation (🇮🇹 Italian only)
+
+The full documentation is available at: 👉 👉 [THIS LINK](http://lato.gregoriogalante.com/) 👈 👈
+
+You can also use the [Lato AI Agent](http://lato.gregoriogalante.com/AI.html) directly on your browser to generate code and get helps with the gem.
+
 ## Eco-system
 The idea behind Lato is to create an eco-system of engines that can improve the functionalities of the panel. The following engines are already available:
 
@@ -28,13 +34,13 @@ Add required dependencies to your application's Gemfile:
 
 ```ruby
 # Use JavaScript with ESM import maps [https://github.com/rails/importmap-rails]
-gem "importmap-rails" # NOTE: Probably already installed in default rails 7 project
+gem "importmap-rails" # NOTE: Probably already installed in default rails 7+ project
 
 # Hotwire's SPA-like page accelerator [https://turbo.hotwired.dev]
-gem "turbo-rails" # NOTE: Probably already installed in default rails 7 project
+gem "turbo-rails" # NOTE: Probably already installed in default rails 7+ project
 
 # Hotwire's modest JavaScript framework [https://stimulus.hotwired.dev]
-gem "stimulus-rails" # NOTE: Probably already installed in default rails 7 project
+gem "stimulus-rails" # NOTE: Probably already installed in default rails 7+ project
 
 # Use Sass to process CSS
 gem "sassc-rails"
@@ -116,11 +122,23 @@ $ rails db:seed
 $ foreman start -f Procfile.dev
 ```
 
-## Publish
+### Publish
+
+This script will publish the gem to rubygems.org. Make sure you have the correct permissions and that you are logged in to your rubygems account.
 
 ```shell
 $ ruby ./bin/publish.rb
 ```
 
+### Generate documentation
+
+This script will generate the documentation for the gem by exporting the Rails rendered views to HTML files. The documentation will be generated in the **docs** folder.
+
+Make sure to have the server running on port 3000 before running the script.
+
+```shell
+$ ruby ./bin/generate_docs.rb
+```
+
 ## License
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/assets/javascripts/lato/controllers/lato_account_form_user_controller.js

@@ -0,0 +1,25 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = [
+    'emailInput',
+    'validateEmailLink'
+  ]
+
+  connect() {
+    if (this.hasEmailInputTarget) this.emailInputOriginalValue = this.emailInputTarget.value
+  }
+
+  onEmailKeyUp(e) {
+    if (!this.hasEmailInputTarget || !this.hasValidateEmailLinkTarget) return
+
+    const newEmailInputValue = this.emailInputTarget.value
+    if (this.emailInputOriginalValue !== newEmailInputValue) {
+      this.validateEmailLinkTarget.classList.add('opacity-50')
+      this.validateEmailLinkTarget.style.pointerEvents = 'none'
+    } else {
+      this.validateEmailLinkTarget.classList.remove('opacity-50')
+      this.validateEmailLinkTarget.style.pointerEvents = 'auto'
+    }
+  } 
+}

data/app/assets/javascripts/lato/controllers/lato_form_controller.js

@@ -27,6 +27,7 @@ export default class extends Controller {
    * Events
    */
 
+  // This event is used to remove the Bootstrap invalid class from the input when the user starts typing.
   onInputChange(e) {
     e.target.classList.remove('is-invalid')
   }

data/app/assets/javascripts/lato/controllers/lato_index_controller.js

@@ -9,8 +9,12 @@ export default class extends Controller {
   connect() {
   }
 
+  /**
+   * Events
+   */
+
+  // This event is used to reset the pagination when the user types in the search input to start a new search.
   onSearchKeyUp(e) {
-    // Search the input with name "page" inside this.element and force value to 1
     const pageInput = this.element.querySelector('input[name="page"]')
     if (pageInput) pageInput.value = 1
   }

data/app/views/lato/account/_form-user.html.erb

@@ -5,7 +5,7 @@ user ||= Lato::User.new
 %>
 
 <%= turbo_frame_tag 'account_form-user' do %>
-  <%= form_with model: user, url: lato.account_update_user_action_path, data: { turbo_frame: '_self', controller: 'lato-form' } do |form| %>
+  <%= form_with model: user, url: lato.account_update_user_action_path, data: { turbo_frame: '_self', controller: 'lato-form lato-account-form-user' } do |form| %>
     <%= lato_form_notices class: %w[mb-3] %>
     <%= lato_form_errors user, class: %w[mb-3] %>
 
@@ -23,7 +23,7 @@ user ||= Lato::User.new
       <div class="col col-12 col-lg-4 mb-3">
         <%= lato_form_item_label form, :email %>
         <div class="input-group mb-3">
-          <%= lato_form_item_input_email form, :email, required: true %>
+          <%= lato_form_item_input_email form, :email, required: true, data: { lato_account_form_user_target: 'emailInput', action: 'keyup->lato-account-form-user#onEmailKeyUp' } %>
           <% if user.email_verified_at %>
             <button
               class="btn btn-outline-success"
@@ -31,7 +31,7 @@ user ||= Lato::User.new
               aria-label="<%= I18n.t('lato.email_verified') %>"
             ><%= I18n.t('lato.email_verified') %></span>
           <% else %>
-            <%= link_to I18n.t('lato.verify_email'), account_request_verify_email_action_path, class: 'btn btn-warning', data: { turbo_method: :patch, turbo_frame: '_self' }, aria: { label: I18n.t('lato.verify_email') } %>
+            <%= link_to I18n.t('lato.verify_email'), account_request_verify_email_action_path, class: 'btn btn-warning', data: { turbo_method: :patch, turbo_frame: '_self', lato_account_form_user_target: 'validateEmailLink' }, aria: { label: I18n.t('lato.verify_email') } %>
           <% end %>
         </div>
       </div>

data/app/views/lato/components/_index.html.erb

@@ -7,7 +7,7 @@ collection_total = collection.respond_to?(:total_count) ? collection.total_count
 
 <%= turbo_frame_tag "lato_index_#{key}_#{model_name_underscore}", class: "lato-index #{browser.device.mobile? ? 'lato-index-mob' : 'lato-index-desk'}" do %>
 
-  <%= form_tag request.path, method: :get, data: { controller: 'lato_form lato_index', turbo_frame: '_self' } do %>
+  <%= form_tag request.path, method: :get, data: { controller: 'lato-form lato-index', turbo_frame: '_self' } do %>
     <%= hidden_field_tag :key, key %>
     <% params.each do |k, v| %>
       <%= hidden_field_tag k, v %>
@@ -17,7 +17,7 @@ collection_total = collection.respond_to?(:total_count) ? collection.total_count
       <div class="d-flex mb-3">
         <% if searchable_columns.any? %>
           <div class="input-group">
-            <input type="text" name="search" class="form-control" placeholder="<%= I18n.t('lato.search_for') %>: <%= searchable_columns.map { |c| collection.model.human_attribute_name(c) }.to_sentence %>" value="<%= params[:search] %>" data-action="keyup->lato_index#onSearchKeyUp" aria-label="<%= I18n.t('lato.search') %>">
+            <input type="text" name="search" class="form-control" placeholder="<%= I18n.t('lato.search_for') %>: <%= searchable_columns.map { |c| collection.model.human_attribute_name(c) }.to_sentence %>" value="<%= params[:search] %>" data-action="keyup->lato-index#onSearchKeyUp" aria-label="<%= I18n.t('lato.search') %>">
             <button
               class="btn btn-outline-primary"
               type="submit"
@@ -159,7 +159,7 @@ collection_total = collection.respond_to?(:total_count) ? collection.total_count
                   <div class="d-flex justify-content-end align-items-center">
                     <span class="text-muted"><%= collection_total %> <%= I18n.t('lato.total_results').downcase %></span>
                     <% if pagination_options %>
-                      <select name="per_page" class="ms-3 form-select form-select-sm w-auto" data-action="change->lato_form#submit" aria-label="<%= I18n.t('lato.per_page_description') %>">
+                      <select name="per_page" class="ms-3 form-select form-select-sm w-auto" data-action="change->lato-form#submit" aria-label="<%= I18n.t('lato.per_page_description') %>">
                         <% pagination_options.each do |option| %>
                           <option value="<%= option %>" <%= option == params[:per_page].to_i ? 'selected' : '' %>>
                             <%= option %> <%= I18n.t('lato.per_page').downcase %>

data/lib/lato/version.rb

@@ -1,3 +1,3 @@
 module Lato
-  VERSION = "3.11.8"
+  VERSION = "3.11.10"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lato
 version: !ruby/object:Gem::Version
-  version: 3.11.8
+  version: 3.11.10
 platform: ruby
 authors:
 - Gregorio Galante
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-15 00:00:00.000000000 Z
+date: 2025-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -154,6 +154,7 @@ files:
 - app/assets/javascripts/lato/application.js
 - app/assets/javascripts/lato/controllers/application.js
 - app/assets/javascripts/lato/controllers/index.js
+- app/assets/javascripts/lato/controllers/lato_account_form_user_controller.js
 - app/assets/javascripts/lato/controllers/lato_action_controller.js
 - app/assets/javascripts/lato/controllers/lato_aside_opener_controller.js
 - app/assets/javascripts/lato/controllers/lato_confirm_controller.js