zutils 3.0.5 → 4.0.0

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.5"
+  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

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: zutils
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 4.0.0
 platform: ruby
 authors:
 - Ricardo Viana
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-12-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -16,79 +15,82 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
-description: Utilidades gerais (views, models, helpers) para aplicações rails
+        version: '13.0'
+description: Engine Rails com partials Bootstrap 5, helpers (bootstrap_flash, eval_with_rescue)
+  e controllers Stimulus reutilizáveis (filtering, toastr, bootstrap-table, dropdown,
+  tooltip) para os apps captei, sofia e reduz.
 email:
 - zezim.ricardo@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- CODE_OF_CONDUCT.md
-- Gemfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- app/assets/javascripts/zutils.js
 - app/assets/stylesheets/zutils.scss
 - app/views/shared/_action_links.html.erb
 - app/views/shared/_btn_action_links.html.erb
 - app/views/shared/_card_list.html.erb
+- app/views/shared/_dropdown_menu.html.erb
+- app/views/shared/_empty_state.html.erb
+- app/views/shared/_empty_state_card.html.erb
 - app/views/shared/_fields.html.erb
+- app/views/shared/_file_chooser.html.erb
 - app/views/shared/_flash.html.erb
+- app/views/shared/_flash_only_toastr.html.erb
 - app/views/shared/_form.html.erb
 - app/views/shared/_index.html.erb
 - app/views/shared/_list.html.erb
 - app/views/shared/_modal.html.erb
+- app/views/shared/_pagination.html.erb
 - app/views/shared/_search_form.html.erb
 - app/views/shared/_show.html.erb
+- app/views/shared/_turbo_modal.html.erb
 - bin/console
 - bin/setup
 - lib/zutils.rb
 - lib/zutils/engine.rb
+- lib/zutils/helpers.rb
 - lib/zutils/version.rb
-- zutils.gemspec
 homepage: http://gitlab.tjpi.jus.br/
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -96,15 +98,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
-summary: Utilidades gerais para aplicações rails
+summary: Utilidades gerais (views, helpers e controllers Stimulus) para aplicações
+  Rails
 test_files: []

data/.gitignore

@@ -1,8 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/

data/CODE_OF_CONDUCT.md

@@ -1,74 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at ricardo.viana@tjpi.jus.br. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -1,6 +0,0 @@
-source "https://rubygems.org"
-
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
-
-# Specify your gem's dependencies in zutils.gemspec
-gemspec

data/Rakefile

@@ -1,2 +0,0 @@
-require "bundler/gem_tasks"
-task :default => :spec

data/app/assets/javascripts/zutils.js

@@ -1,86 +0,0 @@
-//= require selectize
-
-$(document).ready(function () {
-  var selectizeCallback = null;
-
-  $(".selectize_with_add").each(function(i, item) {
-    $(item).selectize({
-      create: function(input, callback) {
-        selectizeCallback = callback;
-
-        $("." + $(item).data('name') + "-modal").modal();
-        $("#" + $(item).data('name') + "_name").val(input);
-      }
-    });
-
-    $("." + $(item).data('name') + "-modal").on("hide.bs.modal", function(e) {
-      if (selectizeCallback != null) {
-        selectizeCallback();
-        selecitzeCallback = null;
-      }
-
-      $("." + $(item).data('name') + "-modal form").trigger("reset");
-      $("." + $(item).data('name') + "-modal form select").val(null).trigger('change');
-      $.rails.enableFormElements($("." + $(item).data('name') + "-modal form"));
-    });
-
-    $("." + $(item).data('name') + "-modal form").on("submit", function(e) {
-      e.preventDefault();
-      $("." + $(item).data('name') + "-modal form").find('.has-error').removeClass('has-error');
-      $("." + $(item).data('name') + "-modal form").find('.help-block').text("");
-      $.ajax({
-        method: "POST",
-        dataType: "json",
-        url: $(this).attr("action"),
-        data: $(this).serialize(),
-        success: function(response) {
-          selectizeCallback({value: response.id, text: response.name});
-          selectizeCallback = null;
-
-          $("." + $(item).data('name') + "-modal").modal('toggle');
-        },
-        error: function(response) {
-          $.each(response.responseJSON, function(key, value) {
-            $("." + $(item).data('name') + "-modal form").find("." + $(item).data('model') + '_' + key).addClass('has-error');
-            if (!($("." + $(item).data('name') + "-modal form" + " ." + $(item).data('model') + '_' + key).find('.help-block').length)) {
-              $("." + $(item).data('name') + "-modal form").find("." + $(item).data('model') + '_' + key).append("<p class='help-block'></p>");
-            }
-            $("." + $(item).data('name') + "-modal form").find("." + $(item).data('model') + '_' + key).find('.help-block').text(value);
-          });
-          $.rails.enableFormElements($("." + $(item).data('name') + "-modal form" + ""));
-        }
-      });
-    });
-  });
-
-  $(".selectize_with_add_without_modal").each(function(i, item) {
-    $(item).selectize({
-      create: function(input, callback) {
-        $(item).parent().removeClass('has-error');
-        $(item).parent().find('.help-block').text("");
-        selectizeCallback = callback;
-        data = {};
-        data[$(item).data('model')] = {};
-        data[$(item).data('model')][$(item).data('field')] = input;
-        $.ajax({
-          method: "POST",
-          dataType: "json",
-          url: "/" + $(item).data('pluralized'),
-          data: data,
-          success: function(response) {
-            selectizeCallback({value: response.id, text: response.name});
-          },
-          error: function(response) {
-            $(item).parent().addClass('has-error');
-            if (!( $(item).parent().find('.help-block').length)) {
-                $(item).parent().append("<p class='help-block'></p>");
-            }
-            $(item).parent().find('.help-block').text("Valor já existente: " + input);
-            selectizeCallback();
-          }
-        });
-        selectizeCallback = callback;
-      }
-    });
-  });
-});

data/zutils.gemspec

@@ -1,39 +0,0 @@
-
-lib = File.expand_path("../lib", __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "zutils/version"
-
-Gem::Specification.new do |spec|
-  spec.name          = "zutils"
-  spec.version       = Zutils::VERSION
-  spec.authors       = ["Ricardo Viana"]
-  spec.email         = ["zezim.ricardo@gmail.com"]
-
-  spec.summary       = "Utilidades gerais para aplicações rails"
-  spec.description   = "Utilidades gerais (views, models, helpers) para aplicações rails"
-  spec.homepage      = "http://gitlab.tjpi.jus.br/"
-  spec.license       = "MIT"
-
-  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
-  # to allow pushing to a single host or delete this section to allow pushing to any host.
-  # if spec.respond_to?(:metadata)
-  #   spec.metadata["allowed_push_host"] = "TODO: Set to 'http://mygemserver.com'"
-  # else
-  #   raise "RubyGems 2.0 or newer is required to protect against " \
-  #     "public gem pushes."
-  # end
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_dependency 'rails', '>= 5.0'
-
-  spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
-end