lato 3.10.12 → 3.11.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1933e05b24bc5a17c0bdfed4bc7e4138115ea82d295f602a10d8773037add06c
-  data.tar.gz: 2a5a834dc481d9ee274128d5a3f1686b00faaaabd7356a34c3b2d4c05d067855
+  metadata.gz: aac7553d07bfc74cea7e43c829e5e68a99ef5c4c1ca84c0abafbe3ed9b28d4e2
+  data.tar.gz: 946fa0334adad14cd55836470e5969a04be8d8533085811fd206cc21685bc333
 SHA512:
-  metadata.gz: 0d985c7cb9f25127c0d5b045593e0063d6fc8dcfcdca34b6fecc30fdd27851205f9e0838fd01d939b52a753060c0d6bf85909bb7b2b506d99a8bb6e68c949613
-  data.tar.gz: 62bf40a75b307205ed2927b6aebedbf320b592f5f71389eab763cafa716b9c15351b5ab490b022e28afea4d654c8d8569185facb46bdd219db8fc28979fb5cc3
+  metadata.gz: fa351b5aaeb8c3610000eef54cfc6dc1fe000ede31e9a6963b5282c2f6591239a475da8285066f7c2e2483f5c8e1f2b7fbc109157cc6c035f4155c7ac66db3a0
+  data.tar.gz: 0ec8ec42232d0ec5c0cd4411e6b5821348772cd451ea81c3698b2c852b20b96457e907a387f58634b2a711bf294140b55e55123503074f353d7bf828503eecaa

data/README.md

@@ -1,5 +1,6 @@
 # Lato
-Lato is a Rails Engine for developing web applications.
+
+Lato is a Rails Engine to deliver a full featured web panel for your Rails application.
 
 This gem includes:
 - User management with full authentication (signin, signup, recover password);
@@ -77,7 +78,7 @@ end
 ### Extra tasks
 Lato integrates by default a basic PWAs manifest and service worker. To re-generate them with all required assets follow these steps:
 
-1. Complete the configuration of lato on a custom initializer (see [configuration](https://github.com/lato-gam/lato/blob/main/lib/lato/config.rb) options for more details)
+1. Complete the configuration of lato on a custom initializer (see [configuration](https://github.com/lato-org/lato/blob/main/lib/lato/config.rb) options for more details)
 2. Add an icon.png file on **public/icon.png** with minimum size of 512x512px
 3. Run the following commands:
 
@@ -91,7 +92,7 @@ $ rails lato:generate:pwa
 Clone repository, install dependencies, run migrations and start:
 
 ```shell
-$ git clone https://github.com/Lato-GAM/lato
+$ git clone https://github.com/lato-org/lato
 $ cd lato
 $ bundle
 $ rails db:migrate

data/app/assets/javascripts/lato/application.js

@@ -55,5 +55,10 @@ document.addEventListener('turbo:before-cache', (e) => {
   document.querySelector('.navbar-toggler').classList.add('collapsed')
   document.querySelector('.navbar-collapse').classList.remove('show')
 
+  // remove all tooltips
+  document.querySelectorAll('.tooltip').forEach((el) => {
+    el.remove()
+  })
+
   e.detail?.resume()
 })

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

@@ -0,0 +1,93 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ['item']
+
+  /**
+   * Stimulus
+   */
+
+  connect() {
+    const localStorageStatus = localStorage.getItem('lato_guide')
+    this.status = localStorageStatus ? JSON.parse(localStorageStatus) : {}
+    this.items = null
+    this.showing = false
+    
+    this.storeStatus()
+    this.setupItems()
+    this.showGuide()
+  }
+
+  itemTargetConnected(e) {
+    this.setupItems()
+    this.showGuide()
+  }
+
+  itemTargetDisconnected(e) {
+    this.setupItems()
+  }
+
+  setupItems(e = null) {
+    if (e) e.preventDefault()
+
+    this.items = this.itemTargets.map(item => ({ element: item, key: item.dataset.guideKey, content: item.dataset.guideContent, index: parseInt(item.dataset.guideIndex) })).map(item => {
+      item.index = isNaN(item.index) ? 999 : item.index
+      return item
+    }).sort((a, b) => a.index - b.index)
+  }
+
+  async showGuide() {
+    if (this.showing) return
+    if (!this.status) return
+    if (!this.items) return
+
+    for (const item of this.items) {
+      if (this.status[item.key]) continue
+      await this.showGuideItem(item)
+    }
+  }
+
+  async showGuideItem(item) {
+    if (this.showing) return
+    if (!this.status) return
+    if (this.status[item.key]) return
+
+    this.showing = true
+    return new Promise((resolve) => {
+      const tooltipIsLast = this.items.filter(target => !this.status[target.key]).length === 1
+      const tooltipCloseId = `lato-guide-close-${Math.random().toString(36).substring(7)}`
+      const tooltipTitle = `
+        <div class="px-2 py-2 d-flex align-items-center justify-content-between">
+          <p class="me-2 mb-0 text-start">${item.content}</p>
+          <a id="${tooltipCloseId}" class="btn btn-light btn-sm">${tooltipIsLast ? 'Close' : 'Next'}</a>
+        </div>
+      `
+
+      const tooltip = new bootstrap.Tooltip(item.element, { title: tooltipTitle, trigger: 'manual', html: true, customClass: 'lato-guide-tooltip' })
+      item.element.addEventListener('shown.bs.tooltip', () => {
+        setTimeout(() => {
+          document.getElementById(tooltipCloseId).addEventListener('click', () => {
+            tooltip.hide()
+            this.showing = false
+            this.status[item.key] = true
+            this.storeStatus()
+            resolve()
+          })
+        }, 250)
+      })
+      tooltip.show()  
+    })
+  }
+
+  storeStatus(e = null) {
+    if (e) e.preventDefault()
+    localStorage.setItem('lato_guide', JSON.stringify(this.status))
+  }
+
+  resetStatus(e = null) {
+    if (e) e.preventDefault()
+    this.status = {}
+    this.storeStatus()
+    this.showGuide()
+  }
+}

data/app/assets/stylesheets/lato/application.scss

@@ -17,6 +17,9 @@ $gray-700: #454f58 !default;
 $gray-800: #313a42 !default;
 $gray-900: #1f262c !default;
 
+$tooltip-opacity: 1;
+$tooltip-max-width: 300px;
+
 @import url("https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.2/font/bootstrap-icons.css");
 @import "bootstrap";
 
@@ -127,4 +130,8 @@ main, aside {
   100% {
     transform: rotate(360deg);
   }
+}
+
+.lato-guide-tooltip {
+
 }

data/app/views/layouts/lato/application.html.erb

@@ -25,7 +25,7 @@
 </head>
 <body
   class="controller-<%= controller_name %> action-<%= action_name %> <%= @layout_body_classes.join(' ') %>"
-  data-controller="lato-action"
+  data-controller="lato-action lato-guide"
 >
   <header>
     <%= render 'layouts/lato/navbar' %>

data/lib/lato/config.rb

@@ -32,7 +32,7 @@ module Lato
       @application_title = 'Lato'
       @application_version = '1.0.0'
       @application_company_name = 'Lato Team'
-      @application_company_url = 'https://github.com/Lato-GAM'
+      @application_company_url = 'https://github.com/lato-org'
       @application_brand_color = '#03256c'
 
       @auth_disable_signup = false

data/lib/lato/version.rb

@@ -1,3 +1,3 @@
 module Lato
-  VERSION = "3.10.12"
+  VERSION = "3.11.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lato
 version: !ruby/object:Gem::Version
-  version: 3.10.12
+  version: 3.11.1
 platform: ruby
 authors:
 - Gregorio Galante
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-31 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -159,6 +159,7 @@ files:
 - app/assets/javascripts/lato/controllers/lato_confirm_controller.js
 - app/assets/javascripts/lato/controllers/lato_feedback_controller.js
 - app/assets/javascripts/lato/controllers/lato_form_controller.js
+- app/assets/javascripts/lato/controllers/lato_guide_controller.js
 - app/assets/javascripts/lato/controllers/lato_hello_controller.js
 - app/assets/javascripts/lato/controllers/lato_input_autocomplete2_controller.js
 - app/assets/javascripts/lato/controllers/lato_input_autocomplete_controller.js