zutils 3.0.7 → 4.0.0

data/app/views/shared/_search_form.html.erb

@@ -1,52 +1,97 @@
-<% card_color ||= 'danger' %>
-<% search_object ||= @q%>
-<% default_field = {name: :id_eq, attrs: {label: false, required: false, placeholder: 'ID', wrapper: false}} %>
-<% received_field = defined?(main_field) ? main_field : {} %>
-<% main_field = default_field.deep_merge(received_field)  %>
+<% card_color ||= 'primary' %>
+<% search_object ||= @q %>
 <% opened ||= false %>
+
 <%= search_form_for search_object, url: url do |f| %>
-  <div class="card card-outline card-<%= card_color %>" data-controller='filtering'>
-    <div class="card-header with-border">
-      <div class="input-group">
-        <div class="input-group-prepend">
-          <button type="button" class="btn btn-<%= card_color %>" data-action="click->filtering#toggle">
-            <% if opened %>
-              <i class="fa fa-fw fa-angle-down" data-filtering-target='icon'></i>
-            <% else %>
-              <i class="fa fa-fw fa-angle-right" data-filtering-target='icon'></i>
-            <% end %>
-            <span class="d-none d-sm-inline-block">
-              Filtrar
-            </span>
+  <div
+    class="card shadow-sm border rounded-2 mb-3 bg-body"
+    data-controller="filtering"
+    data-filtering-opened-value="<%= opened %>"
+  >
+    <div class="card-header bg-transparent border-0 pt-3 pb-0 px-3">
+      <h6 class="mb-0 fw-bold text-secondary">
+        <i class="fa fa-search me-2 opacity-50"></i>
+        Pesquisar
+      </h6>
+    </div>
+
+    <div class="card-body p-3">
+      <div class="d-flex align-items-center w-100">
+        <button
+          type="button"
+          class="btn bg-secondary-subtle px-0 rounded-circle me-2 flex-shrink-0"
+          style="width: 42px; height: 42px;"
+          data-action="click->filtering#toggle"
+          title="Filtros Avançados"
+        >
+          <i
+            class="fa <%= opened ? 'fa-angle-down' : 'fa-sliders-h' %>"
+            data-filtering-target="icon"
+          ></i>
+        </button>
+
+        <div class="flex-grow-1 position-relative d-flex align-items-center">
+          <% main_field_name = defined?(main_field) ? main_field[:name] : :id_eq
+             main_attrs = {
+              label: false,
+              required: false,
+              placeholder: 'ID',
+              wrapper: false,
+              input_html: { class: 'form-control pe-5' }
+            }.deep_merge(defined?(main_field) ? (main_field[:attrs] || {}) : {}) %>
+
+          <%= f.input main_field_name, main_attrs %>
+
+          <button
+            type="submit"
+            class="
+              btn border-0 position-absolute end-0 me-2 p-2 text-secondary
+              d-flex align-items-center justify-content-center
+            "
+            style="background: transparent; z-index: 5;"
+          >
+            <i class="fa fa-search fs-5"></i>
           </button>
         </div>
-        <%= f.input (main_field&.dig(:name) || :id_eq), main_field&.dig(:attrs) %>
-        <div class="input-group-append">
-          <%= button_tag type: "submit", class: "btn btn-#{card_color}" do %>
-            <i class="fa fa-search"></i>
-            <span class="d-none d-sm-inline-block">
-              Buscar
-            </span>
-          <% end %>
-        </div>
-      </div>
-      <div class="row">
-        <div class="col-md-12 active-filters" data-filtering-target='filters'></div>
       </div>
+
+      <div
+        class="active-filters d-flex gap-1 flex-wrap pt-2 ps-5"
+        data-filtering-target="filters"
+        style="margin-top: -5px;"
+      ></div>
     </div>
-    <div class="card-body" style='<%= 'display: none;' unless opened %>' data-filtering-target='body'>
+
+    <div
+      class="card-body pt-0 collapse <%= 'show' if opened %>"
+      data-filtering-target="body"
+    >
+      <div class="d-flex align-items-center">
+        <h6 class="mb-0 fw-bold">
+          <i class="fa fa-filter me-2 opacity-50"></i>
+          Filtros Detalhados
+        </h6>
+
+        <hr class="flex-grow-1 ms-3 opacity-10 border-black">
+      </div>
+
       <div class="row">
         <% search_fields ||= [] %>
+
         <% search_fields.each do |sf| %>
-          <% default_attrs = {required: false, wrapper_html: {class: "col-md-3"}} %>
-          <% received_attrs = sf.dig(:attrs) || {} %>
-          <% attrs = default_attrs.deep_merge(received_attrs) %>
-          <%= f.input sf.dig(:name), attrs %>
+          <% field_attrs = { required: false, wrapper_html: {class: "col-md-3"} }.deep_merge(sf[:attrs] || {}) %>
+
+          <%= f.input sf[:name], field_attrs %>
+        <% end %>
+      </div>
+
+      <div class="d-flex justify-content-end align-items-center gap-2">
+        <%= link_to "Limpar", url, class: "btn btn-link btn-sm text-decoration-none text-muted" %>
+
+        <%= button_tag type: "submit", class: "btn btn-sm btn-#{card_color} px-4" do %>
+          Aplicar
         <% end %>
       </div>
-      <%= button_tag type: "submit", class: "btn btn-#{card_color}" do %>
-        <i class="fa fa-search"></i> Buscar
-      <% end %>
     </div>
   </div>
-<% end %>
+<% end %>

data/app/views/shared/_show.html.erb

@@ -5,213 +5,106 @@
 <% nested_resource ||= false %>
 <% relationships ||= {} %>
 
-<% card_color ||= 'danger' %>
-<% hide ||= %w[show delete] %>
-<% size ||= "xs" %>
+<% color ||= 'primary' %>
+<% hide ||= %w[new show] %>
+<% size ||= "sm" %>
+<% buttons_size ||= "md" %>
 
-<% new_color ||= 'primary' %>
-<% edit_color ||= 'warning' %>
-<% delete_color ||= 'danger' %>
+<% edit_color ||= 'btn-warning' %>
+<% delete_color ||= 'btn-outline-danger' %>
 
 <% if show_columns.empty? %>
   <% form_fields ||= (object.class.respond_to?('form_fields') ? object.class.form_fields : {}) %>
   <% form_ordered_fields ||= (form_fields.empty? ? object.class.column_names : form_fields.keys) %>
-  <% show_columns = form_ordered_fields - ['id', 'created_at', 'updated_at', 'deleted_at'] - excluded_columns + additional_columns %>
+  <% show_columns = form_ordered_fields - ['id','created_at','updated_at','deleted_at'] - excluded_columns + additional_columns %>
 <% end %>
 
 <% unless hide.include? "top_bar" %>
-  <div class="card card-outline card-<%= card_color %>">
-    <div class="card-header">
-      <div class="row align-items-center">
-        <div class="col-12 col-md-auto">
-          <h3 class="card-title">
-            <strong>
-              <i class="fa fa<%= object.class.icon %>"></i>
-              Visualizar <%=t object.class.model_name.human %>
-            </strong>
-          </h3>
-        </div>
-        <div class="col-12 col-md mr-auto">
-          <% if can? :manage, object %>
-            <%= render "shared/btn_action_links", size: "xs", object: object, labels: true, hide: hide, new_color: new_color, edit_color: edit_color, delete_color: delete_color %>
-          <% end %>
-        </div>
+  <div class="card border-0 border-top border-4 border-<%= color %> shadow-sm mb-0 rounded-bottom-0">
+    <div class="card-header bg-body-tertiary border-bottom-0">
+      <div class="d-flex justify-content-between align-items-center flex-wrap gap-2">
+        <h5 class="mb-0">
+          <i class="<%= object.class.icon %>"></i>
+          <%= t object.class.model_name.human %>
+        </h5>
       </div>
     </div>
   </div>
 <% end %>
+
 <% if lookup_context.find_all("#{object.class.model_name.plural}/_#{object.class.model_name.singular}").any? %>
-  <%= render object %>
+  <div class="mb-3"><%= render object %></div>
 <% else %>
-  <div class="card card-outline card-<%= card_color %>">
-    <div class="card-body p-0">
-      <table class="table table-bordered table-striped p-0">
+  <div class="card shadow-sm border-0 rounded-0 rounded-bottom mb-3">
+    <div class="card-body p-1" data-controller="bootstrap-table">
+      <table class="table table-striped table-hover align-middle mb-0">
         <thead>
           <tr>
-            <th width='15%'>Campo</th>
+            <th data-width="20" data-width-unit="%">Campo</th>
             <th>Valor</th>
           </tr>
         </thead>
-        <% show_columns.each do |column| %>
-          <% unless /_currency$/ =~ column %>
-            <tr>
-              <th>
-                <% if /_id$/ =~ column && object.respond_to?(column.split('_id')[0]) %>
-                  <%= object.class.human_attribute_name(column.split("_id")[0]) %>
-                <% elsif /_cents$/ =~ column %>
-                  <%= object.class.human_attribute_name(column.split("_cents")[0]) %>
-                <% else %>
-                  <%= object.class.human_attribute_name(column) %>
-                <% end %>
-              </th>
-              <td>
-                <% if column.to_s.include?('.') %>
-                  <% o = object %>
-                  <% column.split('.').each{|m| o = o.send(m) if o } %>
-                  <%= o %>
-                <% elsif object.send(column).class == Date or
-                  object.send(column).class == DateTime or
-                  object.send(column).class == ActiveSupport::TimeWithZone or
-                  object.send(column).class == Time %>
-                  <%=l object.send(column) %>
-                <% elsif object.send(column).respond_to? 'attached?' %>
-                  <% if object.send(column).class == ActiveStorage::Attached::One %>
-                    <% if object.send(column).attached? %>
-                      <%= link_to rails_blob_path(object.send(column)), class: "btn btn-#{card_color} btn-xs", target: '_blank' do %>
-                        <i class="fa fa-file-o"></i> Arquivo
+
+        <tbody>
+          <% show_columns.each do |column| %>
+            <% value = object.send(column) %>
+
+            <% unless /_currency$/ =~ column %>
+              <tr>
+                <th class="fw-semibold">
+                  <% if /_id$/ =~ column && object.respond_to?(column.split('_id')[0]) %>
+                    <%= object.class.human_attribute_name(column.split("_id")[0]) %>
+                  <% elsif /_cents$/ =~ column %>
+                    <%= object.class.human_attribute_name(column.split("_cents")[0]) %>
+                  <% else %>
+                    <%= object.class.human_attribute_name(column) %>
+                  <% end %>
+                </th>
+
+                <td>
+                  <% if column.to_s.include?('.') %>
+                    <% o = object %>
+                    <% column.split('.').each{|m| o = o.send(m) if o } %>
+                    <%= o %>
+                  <% elsif value.is_a?(Date) ||
+                      value.is_a?(Time) ||
+                      value.is_a?(DateTime) ||
+                      value.is_a?(ActiveSupport::TimeWithZone) %>
+                    <%= l value %>
+                  <% elsif value.respond_to? 'attached?' %>
+                    <% if value.attached? %>
+                      <%= link_to rails_blob_path(value),
+                        class: "btn btn-outline-#{color} btn-sm",
+                        target: '_blank' do %>
+                        <i class="fa fa-file"></i>
+                        <span class="d-none d-md-inline">Arquivo</span>
                       <% end %>
                     <% end %>
+                  <% elsif /_id$/ =~ column && object.respond_to?(column.split('_id')[0]) %>
+                    <%= object.send(column.split("_id")[0])&.name %>
+                  <% elsif /_cents$/ =~ column %>
+                    <%= number_to_currency object.send(column.split("_cents")[0]) %>
+                  <% else %>
+                    <%= value %>
                   <% end %>
-                <% elsif /_id$/ =~ column && object.respond_to?(column.split('_id')[0]) %>
-                  <%= object.send(column.split("_id")[0])&.name %>
-                <% elsif /_cents$/ =~ column %>
-                  <%= number_to_currency object.send(column.split("_cents")[0]) %>
-                <% else %>
-                  <%= object.send(column) %>
-                <% end %>
-              </td>
-            </tr>
+                </td>
+              </tr>
+            <% end %>
           <% end %>
-        <% end %>
+        </tbody>
       </table>
     </div>
   </div>
+<% end %>
 
-  <% if relationships.any? %>
-    <% relationships.each do |key, value| %>
-      <% if object.association(key.to_s).kind_of?(ActiveRecord::Associations::BelongsToAssociation) ||
-        object.association(key.to_s).kind_of?(ActiveRecord::Associations::HasOneAssociation) %>
-        <div class="box card-<%= card_color %>">
-          <div class="card-header with-border">
-            <h3 class="card-title">
-              <%= Kernel.const_get(key.to_s.singularize.camelize).model_name.human %>
-            </h3>
-          </div>
-          <div class="card-body p-0">
-            <table class="table table-bordered table-striped p-0">
-            <% unless hide_table_header %>
-                <thead>
-                  <tr>
-                    <th width='15%'><%= t('field') %></th>
-                    <th><%= t('value') %></th>
-                  </tr>
-                </thead>
-              <% end %>
-              <tbody>
-                <% value.each do |v| %>
-                  <tr>
-                    <td>
-                      <strong>
-                        <% if /_id$/ =~ v && Kernel.const_get(key.to_s.singularize.camelize).new.respond_to?(v.split('_id')[0]) %>
-                          <%= Kernel.const_get(key.to_s.singularize.camelize).human_attribute_name(v.split('_id')[0]) %>
-                        <% elsif /_cents$/ =~ v %>
-                          <%= Kernel.const_get(key.to_s.singularize.camelize).human_attribute_name(v.split("_cents")[0]) %>
-                        <% else %>
-                          <%= Kernel.const_get(key.to_s.singularize.camelize).human_attribute_name(v) %>
-                        <% end %>
-                      </strong>
-                    </td>
-                    <td>
-                      <% if object.send(key.to_s).send(v).class == Date or
-                        object.send(key.to_s).send(v).class == DateTime or
-                        object.send(key.to_s).send(v).class == ActiveSupport::TimeWithZone or
-                        object.send(key.to_s).send(v).class == Time %>
-                        <%=l object.send(key.to_s).send(v) %>
-                      <% elsif /_id$/ =~ v && object.send(key.to_s).respond_to?(v.split('_id')[0]) %>
-                        <%= object.send(key.to_s).send(v.split("_id")[0])&.name %>
-                      <% elsif /_cents$/ =~ v %>
-                        <%= number_to_currency object.send(key.to_s).send(v.split("_cents")[0]) %>
-                      <% else %>
-                        <%= object.send(key.to_s).send(v) %>
-                      <% end %>
-                    </td>
-                  </tr>
-                <% end %>
-              </tbody>
-            </table>
-          </div>
-        </div>
-      <% else %>
-        <div class="box card-<%= card_color %>">
-          <div class="card-header with-border">
-            <h3 class="card-title">
-              <%= Kernel.const_get(key.to_s.singularize.camelize).model_name.human.pluralize %>
-            </h3>
-          </div>
-          <div class="card-body p-0">
-            <table class="table table-bordered table-striped p-0">
-              <thead>
-                <tr>
-                  <% value.each do |v| %>
-                    <th>
-                      <% if /_id$/ =~ v && Kernel.const_get(key.to_s.singularize.camelize).new.respond_to?(v.split('_id')[0]) %>
-                        <%= Kernel.const_get(key.to_s.singularize.camelize).human_attribute_name(v.split('_id')[0]) %>
-                      <% else %>
-                        <%= Kernel.const_get(key.to_s.singularize.camelize).human_attribute_name(v) %>
-                      <% end %>
-                    </th>
-                  <% end %>
-                </tr>
-              </thead>
-              <tbody>
-                <% object.send(key.to_s).each do |r| %>
-                  <tr>
-                    <% value.each do |v| %>
-                      <td>
-                        <% if v.include?('.') %>
-                          <% o = r %>
-                          <% v.split('.').each{|m| o = o.send(m) if o } %>
-                          <%= o %>
-                        <% elsif r.send(v).class == Date or
-                          r.send(v).class == DateTime or
-                          r.send(v).class == ActiveSupport::TimeWithZone or
-                          r.send(v).class == Time %>
-                          <%=l r.send(v) %>
-                        <% elsif r.send(v).respond_to? 'attached?' %>
-                          <% if r.send(v).class == ActiveStorage::Attached::One %>
-                            <% if r.send(v).attached? %>
-                              <%= link_to rails_blob_path(r.send(v)), class: "btn btn-#{card_color} btn-xs", target: '_blank' do %>
-                                <i class="fa fa-file-o"></i> Arquivo
-                              <% end %>
-                            <% end %>
-                          <% end %>
-                        <% elsif /_id$/ =~ v && r.respond_to?(v.split('_id')[0]) %>
-                          <%= r.send(v.split("_id")[0])&.name %>
-                        <% else %>
-                          <%= r.send(v) %>
-                        <% end %>
-                      </td>
-                    <% end %>
-                  </tr>
-                <% end %>
-              </tbody>
-            </table>
-          </div>
-        </div>
-      <% end %>
-    <% end %>
+<div class="card-footer">
+  <% unless hide.include? "bottom_bar" %>
+    <%= render "shared/btn_action_links",
+            object: object,
+            labels: true,
+            hide: hide,
+            edit_color: edit_color,
+            delete_color: delete_color,
+            size: buttons_size %>
   <% end %>
-<% end %>
-<% unless hide.include? "bottom_bar" %>
-  <%= render "shared/btn_action_links", object: object, labels: true, hide: hide, new_color: new_color, edit_color: edit_color, delete_color: delete_color %>
-<% end %>
+</div>

data/app/views/shared/_turbo_modal.html.erb

@@ -0,0 +1,21 @@
+<% title ||= '' %>
+<% size ||= 'lg' %>
+<% hide_header ||= false %>
+<% modal_frame_tag ||= "turbo_modal" %>
+
+<%= turbo_frame_tag modal_frame_tag do %>
+  <% unless hide_header %>
+    <div class="modal-header">
+      <h5 class="modal-title"><%= title %></h5>
+
+      <button
+        type="button"
+        class="btn-close"
+        data-bs-dismiss="modal"
+        aria-label="Fechar"
+      ></button>
+    </div>
+  <% end %>
+
+  <div class="modal-body p-0"><%= yield %></div>
+<% end %>

data/lib/zutils/engine.rb

@@ -1,5 +1,7 @@
 module Zutils
   class Engine < Rails::Engine
-    # Make it a Rails Engine
+    config.to_prepare do
+      ActionView::Base.include(Zutils::Helpers)
+    end
   end
 end

data/lib/zutils/helpers.rb

@@ -0,0 +1,173 @@
+module Zutils
+  module Helpers
+    def eval_with_rescue(code)
+      eval(code)
+    rescue Exception => e
+      "error"
+    end
+
+    # ── Flash ────────────────────────────────────────────────────────────
+    def bootstrap_flash(options = {})
+      flash_messages = []
+
+      begin
+        object_name = controller_name.singularize
+        obj = instance_variable_get("@#{object_name}")
+
+        if obj && obj.respond_to?(:errors) && obj.errors.size > 0
+          msg = if obj.errors[:base].present?
+            obj.errors[:base]
+          else
+            I18n.t("helpers.links.#{action_name}_error",
+              model: Kernel.const_get(object_name.camelize).model_name.human, default: "erro de validação")
+          end
+          flash[:error] = msg if msg.present?
+        end
+      rescue
+        # ignore
+      end
+
+      flash.each do |type, message|
+        message = Array(message).select(&:presence)
+        next if message.empty?
+        data = case type.to_s
+        when "success", "notice"
+          { title: options[:success_title] || "Sucesso!", icon: options[:success_icon] || "fas fa-check", type: :success, kind: "success" }
+        when "error"
+          { title: options[:error_title] || "Erro!", icon: options[:error_icon] || "fas fa-ban", type: :danger, kind: "error" }
+        when "alert"
+          { title: options[:alert_title] || "Alerta!", icon: options[:alert_icon] || "fas fa-exclamation-triangle", type: :warning, kind: "warning" }
+        else
+          { title: options[:info_title] || "Aviso", icon: options[:info_icon] || "fas fa-info", type: :info, kind: "info" }
+        end
+
+        next unless data
+
+        tag_options = {
+          class: "alert alert-#{data[:type]} alert-dismissible d-flex align-items-center",
+          role: "alert",
+          data: { kind: data[:kind], text: message.first.to_s }
+        }
+
+        close_button = content_tag(:button, "", type: "button", class: "btn-close",
+          "data-bs-dismiss": "alert", "aria-label": "Fechar")
+
+        icon = content_tag(:i, "", class: "#{data[:icon]} me-2")
+        title = content_tag(:strong, data[:title])
+        text = safe_join([title, " ", sanitize(Array(message).first.to_s.gsub("|", "<br>"), tags: %w[br], attributes: [])])
+
+        content = safe_join([close_button, icon, text])
+        flash_messages << content_tag(:div, content, tag_options)
+      end
+
+      flash[:error] = nil
+      safe_join(flash_messages, "\n")
+    end
+
+    def render_turbo_stream_flash_messages(local: false)
+      partial = local ? "shared/flash" : "shared/flash"
+      turbo_stream.prepend(local ? "localflash" : "flash", partial: partial)
+    end
+
+    def render_turbo_stream_flash_messages_only_toastr
+      turbo_stream.prepend "flash", partial: "shared/flash_only_toastr"
+    end
+
+    # ── DOM helpers ──────────────────────────────────────────────────────
+    def nested_dom_id(*args)
+      args.map { |arg| arg.respond_to?(:to_key) ? dom_id(arg) : arg.to_s }.join("_")
+    end
+
+    # ── Menu ─────────────────────────────────────────────────────────────
+    def menu_activated?(menu_item)
+      check = ->(test) { eval_with_rescue(test) rescue false }
+
+      check.call(menu_item.dig(:active_test)) ||
+        menu_item.dig(:children).to_a.any? { |c| check.call(c[:active_test]) } ||
+        menu_item.dig(:children).to_a.flat_map { |c| c.dig(:children).to_a }.any? { |c| check.call(c[:active_test]) }
+    end
+
+    # ── Display helpers (BS5) ────────────────────────────────────────────
+    def display(object, field, options = {})
+      icon       = options[:icon]       || "fa fa-stream"
+      title      = options[:title]      || object.class.human_attribute_name(field)
+      value      = options[:value]      || interactive_send(object, field)
+      hide_title = options[:hide_title] || false
+
+      parts = []
+      unless hide_title
+        parts << content_tag(:strong, tag.i("", class: icon) + " #{title}")
+      end
+      parts << content_tag(:p, value.presence || "-", class: "text-body-secondary")
+      safe_join(parts, "\n")
+    end
+
+    def display_boolean(object, field, options = {})
+      bool_value = options[:value] || interactive_send(object, field)
+      label = bool_value ? (options[:true_label] || "Sim") : (options[:false_label] || "Não")
+      css   = bool_value ? "bg-success" : "bg-danger"
+
+      badge = content_tag(:span, label, class: "badge #{css}")
+      display(object, field, options.merge(value: badge))
+    end
+
+    def display_boolean_icon(object, field, options = {})
+      bool_value = options[:value] || interactive_send(object, field)
+      title     = options[:title] || object.class.human_attribute_name(field)
+      icon_true = options[:icon_true] || options[:icon] || "fa fa-thumbs-up"
+      icon_false = options[:icon_false] || options[:icon] || "fa fa-thumbs-down"
+      css = bool_value ? "bg-success" : "bg-danger"
+
+      icon = bool_value ? tag.i("", class: icon_true) : tag.i("", class: icon_false)
+      content = content_tag(:span, icon, class: "badge #{css}",
+        data: { "bs-toggle": "tooltip", "bs-title": "#{title}: #{bool_value ? "Sim" : "Não"}" })
+    end
+
+    def interactive_send(obj, field)
+      field.to_s.split(".").each { |m| obj = obj.send(m) if obj }
+
+      case obj
+      when Date, Time, DateTime, ActiveSupport::TimeWithZone
+        I18n.l(obj)
+      else
+        obj
+      end
+    end
+
+    # ── Section / Header ─────────────────────────────────────────────────
+    def section_header(title, icon: "fa-info-circle", color: "primary", border: true)
+      content_tag(:h5, class: "text-uppercase small text-#{color} fw-bold mb-4 #{"border-bottom" if border} pb-2") do
+        concat tag.i(class: "fa #{icon} me-2")
+        concat title
+      end
+    end
+
+    def smart_date_tag(date, icon: nil, label: nil, text_class: "text-body")
+      return "-" if date.blank?
+
+      day_month = l(date, format: "%d %b")
+      if date.year > Date.today.year
+        year_tag = " <small class='opacity-75' style='font-size: 0.85em;'>#{date.year}</small>".html_safe
+      else
+        year_tag = ""
+      end
+
+      parts = []
+      parts << tag.i("", class: "bi bi-#{icon} me-1 text-muted") if icon.present?
+      parts << content_tag(:span, "#{label}:", class: "small text-muted me-1") if label.present?
+      parts << "#{day_month}#{year_tag}".html_safe
+
+      content_tag(:span, safe_join(parts), class: text_class)
+    end
+
+    def format_date(value)
+      return if value.blank?
+
+      Date.iso8601(value.to_s).strftime("%d/%m/%Y")
+    rescue
+      Date.parse(value.to_s).strftime("%d/%m/%Y")
+    rescue
+      value
+    end
+  end
+end

data/lib/zutils/version.rb

@@ -1,3 +1,3 @@
 module Zutils
-  VERSION = "3.0.7"
+  VERSION = "4.0.0"
 end

data/lib/zutils.rb

@@ -1,6 +1,6 @@
 require "zutils/version"
 require "zutils/engine"
+require "zutils/helpers"
 
 module Zutils
-  # Your code goes here...
-end
+end