jav 2.55.4

data/lib/generators/jav/filter_generator.rb

@@ -0,0 +1,25 @@
+require_relative "named_base_generator"
+
+module Generators
+  module Jav
+    class FilterGenerator < NamedBaseGenerator
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :multiple_select, type: :boolean
+      class_option :select, type: :boolean
+      class_option :text, type: :boolean
+
+      namespace "jav:filter"
+
+      def create_resource_file
+        type = "boolean"
+
+        type = "multiple_select" if options[:multiple_select]
+        type = "select" if options[:select]
+        type = "text" if options[:text]
+
+        template "filters/#{type}_filter.tt", "app/jav/filters/#{singular_name}.rb"
+      end
+    end
+  end
+end

data/lib/generators/jav/install_generator.rb

@@ -0,0 +1,30 @@
+require_relative "base_generator"
+
+module Generators
+  module Jav
+    class InstallGenerator < BaseGenerator
+      source_root File.expand_path("templates", __dir__)
+
+      namespace "jav:install"
+      desc "Creates an Jav initializer adds the route to the routes file."
+      class_option :path, type: :string, default: "jav"
+
+      def create_initializer_file
+        route "mount Jav::Engine, at: Jav.configuration.root_path"
+
+        template "initializer/jav.tt", "config/initializers/jav.rb"
+        create_resources
+      end
+
+      def create_resources
+        if defined?(User).present?
+          Rails::Generators.invoke("jav:resource", ["user", "-q"], {destination_root: Rails.root })
+        end
+
+        if defined?(Account).present?
+          Rails::Generators.invoke("jav:resource", ["account", "-q"], {destination_root: Rails.root })
+        end
+      end
+    end
+  end
+end

data/lib/generators/jav/js/install_generator.rb

@@ -0,0 +1,64 @@
+require_relative "../base_generator"
+
+module Generators
+  module Jav
+    module Js
+      class InstallGenerator < BaseGenerator
+        source_root File.expand_path("../templates", __dir__)
+
+        namespace "jav:js:install"
+        desc "Add custom JavaScript assets to your Jav project."
+
+        # possible values: importmap or esbuild
+        class_option :bundler, type: :string, default: "importmap"
+
+        def create_files
+          case options[:bundler].to_s
+          when "importmap"
+            install_for_importmap
+          when "esbuild"
+            install_for_esbuild
+          else
+            say "We don't know how to install Jav JS for this bundler \"#{options[:bundler]}\""
+          end
+        end
+
+        no_tasks do
+          def install_for_importmap
+            unless Rails.root.join("app/javascript/jav.custom.js").exist?
+              say "Add default app/javascript/jav.custom.js"
+              copy_file template_path("jav.custom.js"), "app/javascript/jav.custom.js"
+            end
+
+            say "Ejecting the _head.html.erb partial"
+            Rails::Generators.invoke("jav:eject", [":head", "--skip-jav-version"], { destination_root: Rails.root })
+
+            say "Adding the JS asset to the partial"
+            append_to_file Rails.root.join("app/views/jav/partials/_head.html.erb"), "<%= javascript_importmap_tags \"jav.custom\" %>"
+
+            # pin to importmap
+            say "Pin the new entrypoint to your importmap config"
+            append_to_file Rails.root.join("config/importmap.rb"), "\n# Jav custom JS entrypoint\npin \"jav.custom\", preload: true\n"
+          end
+
+          def install_for_esbuild
+            unless Rails.root.join("app/javascript/jav.custom.js").exist?
+              say "Add default app/javascript/jav.custom.js"
+              copy_file template_path("jav.custom.js"), "app/javascript/jav.custom.js"
+            end
+
+            say "Ejecting the _head.html.erb partial"
+            Rails::Generators.invoke("jav:eject", [":head", "--skip-jav-version"], { destination_root: Rails.root })
+
+            say "Adding the JS asset to the partial"
+            append_to_file Rails.root.join("app/views/jav/partials/_head.html.erb"), "<%= javascript_include_tag \"jav.custom\", \"data-turbo-track\": \"reload\", defer: true %>"
+          end
+
+          def template_path(filename)
+            Pathname.new(__dir__).join("..", "templates", "js", filename).to_s
+          end
+        end
+      end
+    end
+  end
+end

data/lib/generators/jav/locales_generator.rb

@@ -0,0 +1,16 @@
+require_relative "base_generator"
+
+module Generators
+  module Jav
+    class LocalesGenerator < BaseGenerator
+      source_root File.expand_path("templates", __dir__)
+
+      namespace "jav:locales"
+      desc "Add Jav locale files to your project."
+
+      def create_files
+        directory File.join(__dir__, "templates", "locales"), "config/locales"
+      end
+    end
+  end
+end

data/lib/generators/jav/named_base_generator.rb

@@ -0,0 +1,14 @@
+require "rails/generators"
+
+module Generators
+  module Jav
+    class NamedBaseGenerator < ::Rails::Generators::NamedBase
+      hide!
+
+      def initialize(name, *options)
+        super(name, *options)
+        invoke "jav:version", name, *options
+      end
+    end
+  end
+end

data/lib/generators/jav/resource_generator.rb

@@ -0,0 +1,349 @@
+require_relative "named_base_generator"
+
+module Generators
+  module Jav
+    class ResourceGenerator < NamedBaseGenerator
+      source_root File.expand_path("templates", __dir__)
+
+      namespace "jav:resource"
+
+      class_option "model-class",
+        type: :string,
+        required: false,
+        desc: "The name of the model."
+
+      def create
+        template "resource/resource.tt", "app/jav/resources/#{resource_name}.rb"
+        template "resource/controller.tt", "app/controllers/jav/#{controller_name}.rb"
+      end
+
+      def resource_class
+        "#{class_name.remove(":")}Resource"
+      end
+
+      def controller_class
+        "Jav::#{class_name.remove(":").pluralize}Controller"
+      end
+
+      def resource_name
+        "#{model_resource_name}_resource"
+      end
+
+      def controller_name
+        "#{model_resource_name.pluralize}_controller"
+      end
+
+      def current_models
+        ActiveRecord::Base.connection.tables.map do |model|
+          model.capitalize.singularize.camelize
+        end
+      end
+
+      def class_from_args
+        @class_from_args ||= options["model-class"]&.camelize || (class_name if class_name.include?("::"))
+      end
+
+      def model_class_from_args
+        if class_from_args.present? || class_name.include?("::")
+          "\n  self.model_class = ::#{class_from_args || class_name}"
+        end
+      end
+
+      private
+
+      def model_class
+        @model_class ||= class_from_args || singular_name
+      end
+
+      def model
+        @model ||= model_class.classify.safe_constantize
+      end
+
+      def model_db_columns
+        @model_db_columns ||= model.columns_hash.except(*db_columns_to_ignore)
+      end
+
+      def db_columns_to_ignore
+        %w[id encrypted_password reset_password_token reset_password_sent_at remember_created_at created_at updated_at password_digest]
+      end
+
+      def reflections
+        @reflections ||= model.reflections.reject do |name, _|
+          reflections_sufixes_to_ignore.include?(name.split("_").pop) || reflections_to_ignore.include?(name)
+        end
+      end
+
+      def reflections_sufixes_to_ignore
+        %w[blob blobs tags]
+      end
+
+      def reflections_to_ignore
+        %w[taggings]
+      end
+
+      def attachments
+        @attachments ||= reflections.select do |_, reflection|
+          reflection.options[:class_name] == "ActiveStorage::Attachment"
+        end
+      end
+
+      def rich_texts
+        @rich_texts ||= reflections.select do |_, reflection|
+          reflection.options[:class_name] == "ActionText::RichText"
+        end
+      end
+
+      def tags
+        @tags ||= reflections.select { |_, reflection| reflection.options[:as] == :taggable }
+      end
+
+      def associations
+        @associations ||= reflections.reject do |key|
+          attachments.key?(key) || tags.key?(key) || rich_texts.key?(key)
+        end
+      end
+
+      def fields
+        @fields ||= {}
+      end
+
+      def invoked_by_model_generator?
+        @options.dig("from_model_generator")
+      end
+
+      def generate_fields
+        return generate_fields_from_args if invoked_by_model_generator?
+
+        if model.blank?
+          puts "Can't generate fields from model. '#{model_class}.rb' not found!"
+          return
+        end
+
+        fields_from_model_db_columns
+        fields_from_model_enums
+        fields_from_model_attachements
+        fields_from_model_associations
+        fields_from_model_rich_texts
+        fields_from_model_tags
+
+        generated_fields_template
+      end
+
+      def generated_fields_template
+        return if fields.blank?
+
+        fields_string = "\n  # Fields generated from the model"
+
+        fields.each do |field_name, field_options|
+          # if field_options are not available (likely a missing resource for an association), skip the field
+          fields_string += "\n  # Could not generate a field for #{field_name}" and next unless field_options
+          
+          options = ""
+          field_options[:options].each { |k, v| options += ", #{k}: #{v}" } if field_options[:options].present?
+
+          fields_string += "\n  #{field_string field_name, field_options[:field], options}"
+        end
+
+        fields_string
+      end
+
+      def field_string(name, type, options)
+        "field :#{name}, as: :#{type}#{options}"
+      end
+
+      def generate_fields_from_args
+        @args.each do |arg|
+          name, type = arg.split(":")
+          type = "string" if type.blank?
+          fields[name] = field(name, type.to_sym)
+        end
+
+        generated_fields_template
+      end
+
+      def fields_from_model_rich_texts
+        rich_texts.each do |name, _|
+          fields[(name.delete_prefix("rich_text_"))] = {field: "trix"}
+        end
+      end
+
+      def fields_from_model_tags
+        tags.each do |name, _|
+          fields[(remove_last_word_from name).pluralize] = {field: "tags"}
+        end
+      end
+
+      def fields_from_model_associations
+        associations.each do |name, association|
+          fields[name] = if association.is_a? ActiveRecord::Reflection::ThroughReflection
+            field_from_through_association(association)
+          else
+            associations_mapping[association.class]
+          end
+        end
+      end
+
+      def field_from_through_association(association)
+        if association.through_reflection.is_a?(ActiveRecord::Reflection::HasManyReflection) || association.through_reflection.is_a?(ActiveRecord::Reflection::ThroughReflection)
+          {
+            field: "has_many",
+            options: {
+              through: ":#{association.options[:through]}"
+            }
+          }
+        else
+          # If the through_reflection is not a HasManyReflection, add it to the fields hash using the class of the through_reflection
+          # ex (team.rb): has_one :admin, through: :admin_membership, source: :user
+          # we use the class of the through_reflection (HasOneReflection -> has_one :admin) to generate the field
+          associations_mapping[association.through_reflection.class]
+        end
+      end
+
+      def fields_from_model_attachements
+        attachments.each do |name, attachment|
+          fields[remove_last_word_from name] = attachments_mapping[attachment.class]
+        end
+      end
+
+      # "hello_world_hehe".split('_') => ['hello', 'world', 'hehe']
+      # ['hello', 'world', 'hehe'].pop => ['hello', 'world']
+      # ['hello', 'world'].join('_') => "hello_world"
+      def remove_last_word_from(snake_case_string)
+        snake_case_string = snake_case_string.split("_")
+        snake_case_string.pop
+        snake_case_string.join("_")
+      end
+
+      def fields_from_model_enums
+        model.defined_enums.each_key do |enum|
+          fields[enum] = {
+            field: "select",
+            options: {
+              enum: "::#{model_class.classify}.#{enum.pluralize}"
+            }
+          }
+        end
+      end
+
+      def fields_from_model_db_columns
+        model_db_columns.each do |name, data|
+          fields[name] = field(name, data.type)
+        end
+      end
+
+      def field(name, type)
+        names_mapping[name.to_sym] || fields_mapping[type&.to_sym] || {field: "text"}
+      end
+
+      def associations_mapping
+        {
+          ActiveRecord::Reflection::BelongsToReflection => {
+            field: "belongs_to"
+          },
+          ActiveRecord::Reflection::HasOneReflection => {
+            field: "has_one"
+          },
+          ActiveRecord::Reflection::HasManyReflection => {
+            field: "has_many"
+          },
+          ActiveRecord::Reflection::HasAndBelongsToManyReflection => {
+            field: "has_and_belongs_to_many"
+          }
+        }
+      end
+
+      def attachments_mapping
+        {
+          ActiveRecord::Reflection::HasOneReflection => {
+            field: "file"
+          },
+          ActiveRecord::Reflection::HasManyReflection => {
+            field: "files"
+          }
+        }
+      end
+
+      def names_mapping
+        {
+          id: {
+            field: "id"
+          },
+          description: {
+            field: "textarea"
+          },
+          gravatar: {
+            field: "gravatar"
+          },
+          email: {
+            field: "text"
+          },
+          password: {
+            field: "password"
+          },
+          password_confirmation: {
+            field: "password"
+          },
+          stage: {
+            field: "select"
+          },
+          budget: {
+            field: "currency"
+          },
+          money: {
+            field: "currency"
+          },
+          country: {
+            field: "country"
+          }
+        }
+      end
+
+      def fields_mapping
+        {
+          primary_key: {
+            field: "id"
+          },
+          string: {
+            field: "text"
+          },
+          text: {
+            field: "textarea"
+          },
+          integer: {
+            field: "number"
+          },
+          float: {
+            field: "number"
+          },
+          decimal: {
+            field: "number"
+          },
+          datetime: {
+            field: "date_time"
+          },
+          timestamp: {
+            field: "date_time"
+          },
+          time: {
+            field: "date_time"
+          },
+          date: {
+            field: "date"
+          },
+          binary: {
+            field: "number"
+          },
+          boolean: {
+            field: "boolean"
+          },
+          references: {
+            field: "belongs_to"
+          },
+          json: {
+            field: "code"
+          }
+        }
+      end
+    end
+  end
+end

data/lib/generators/jav/resource_tool_generator.rb

@@ -0,0 +1,40 @@
+require 'fileutils'
+require_relative 'named_base_generator'
+
+module Generators
+  module Jav
+    class ResourceToolGenerator < NamedBaseGenerator
+      source_root File.expand_path('templates', __dir__)
+
+      argument :name, type: :string, required: true
+
+      namespace 'jav:resource_tool'
+
+      def handle
+        # Add configuration file
+        template 'resource_tools/resource_tool.tt', "app/jav/resource_tools/#{file_name}.rb"
+
+        # Add view file
+        template 'resource_tools/partial.tt', "app/views/jav/resource_tools/_#{file_name}.html.erb"
+      end
+
+      no_tasks do
+        def file_name
+          name.to_s.underscore
+        end
+
+        def controller_name
+          file_name.to_s
+        end
+
+        def human_name
+          file_name.humanize
+        end
+
+        def in_code(text)
+          "<code class='p-1 rounded-sm bg-gray-500 text-white text-sm'>#{text}</code>"
+        end
+      end
+    end
+  end
+end

data/lib/generators/jav/tailwindcss/install_generator.rb

@@ -0,0 +1,72 @@
+require_relative "../base_generator"
+
+module Generators
+  module Jav
+    module Tailwindcss
+      class InstallGenerator < BaseGenerator
+        source_root File.expand_path("../templates", __dir__)
+
+        namespace "jav:tailwindcss:install"
+        desc "Add Tailwindcss to your Jav project."
+
+        def create_files
+          unless tailwindcss_installed?
+            system "./bin/bundle add tailwindcss-rails"
+            system "./bin/rails tailwindcss:install"
+          end
+
+          unless Rails.root.join("app/assets/stylesheets/jav.tailwind.css").exist?
+            say "Add default app/assets/stylesheets/jav.tailwind.css"
+            copy_file template_path("jav.tailwind.css"), "app/assets/stylesheets/jav.tailwind.css"
+          end
+
+          if Rails.root.join("Procfile.dev").exist?
+            append_to_file "Procfile.dev", "jav_css: yarn jav:tailwindcss --watch\n"
+          else
+            say "Add default Procfile.dev"
+            copy_file template_path("Procfile.dev"), "Procfile.dev"
+
+            say "Ensure foreman is installed"
+            run "gem install foreman"
+          end
+
+          # Ensure that the _pre_head.html.erb template is available
+          unless Rails.root.join("app/views/jav/partials/_pre_head.html.erb").exist?
+            say "Ejecting the _pre_head.html.erb partial"
+            Rails::Generators.invoke("jav:eject", [":pre_head", "--skip-jav-version"], { destination_root: Rails.root })
+          end
+
+          say "Adding the CSS asset to the partial"
+          prepend_to_file Rails.root.join("app/views/jav/partials/_pre_head.html.erb"), "<%= stylesheet_link_tag \"jav.tailwind.css\", media: \"all\" %>"
+
+          tailwind_script = setup_tailwind_script
+          say "Ensure you have the following script in your package.json file.", :yellow
+          say %("scripts": { "jav:tailwindcss": "#{tailwind_script}" --minify }), :green
+        end
+
+        no_tasks do
+          def setup_tailwind_script
+            tailwind_config_path = tailwindcss_config_path
+            tailwind_script = "tailwindcss -i ./app/assets/stylesheets/jav.tailwind.css -o ./app/assets/builds/jav.tailwind.css"
+            tailwind_script += " -c #{tailwind_config_path}" if tailwind_config_path
+            tailwind_script
+          end
+
+          def template_path(filename)
+            Pathname.new(__dir__).join("..", "templates", "tailwindcss", filename).to_s
+          end
+
+          def tailwindcss_installed?
+            Rails.root.join("config/tailwind.config.js").exist? || Rails.root.join("tailwind.config.js").exist?
+          end
+
+          def tailwindcss_config_path
+            return unless Rails.root.join("config/tailwind.config.js").exist?
+
+            "./config/tailwind.config.js"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/generators/jav/templates/action.tt

@@ -0,0 +1,14 @@
+class <%= class_name.camelize %> < Jav::BaseAction
+  self.name = "<%= name.underscore.humanize %>"
+  # self.visible = -> do
+  #   true
+  # end
+
+  def handle(**args)
+    models, fields, current_user, resource = args.values_at(:models, :fields, :current_user, :resource)
+
+    models.each do |model|
+      # Do something with your models.
+    end
+  end
+end

data/lib/generators/jav/templates/cards/chartkick_card.tt

@@ -0,0 +1,16 @@
+class <%= class_name.camelize %> < Jav::Dashboards::ChartkickCard
+  self.id = "<%= name.underscore %>"
+  self.label = "<%= name.underscore.humanize %>"
+  self.chart_type = :area_chart
+
+  def query
+    data = 3.times.map do |index|
+      {
+        name: "Batch #{index}",
+        data: 17.times.map { |i| [i, Random.rand(32)] }
+      }
+    end
+
+    result data
+  end
+end

data/lib/generators/jav/templates/cards/chartkick_card_sample.tt

@@ -0,0 +1,36 @@
+class <%= class_name.camelize %> < Jav::Dashboards::ChartkickCard
+  self.id = "<%= name.underscore %>"
+  self.label = "<%= name.underscore.humanize %>"
+  self.chart_type = :area_chart
+  # self.description = "Some tiny description"
+  # self.cols = 2
+  # self.initial_range = 30
+  # self.ranges = {
+  #   "7 days": 7,
+  #   "30 days": 30,
+  #   "60 days": 60,
+  #   "365 days": 365,
+  #   Today: "TODAY",
+  #   "Month to date": "MTD",
+  #   "Quarter to date": "QTD",
+  #   "Year to date": "YTD",
+  #   All: "ALL",
+  # }
+  # self.chart_options = { library: { plugins: { legend: { display: true } } } }
+  # self.flush = true
+
+  def query
+    points = 16
+    i = Time.new.year.to_i - points
+    base_data = Array.new(points).map do
+      i += 1
+      [i.to_s, rand(0..20)]
+    end.to_h
+
+    result [
+      { name: "batch 1", data: base_data.map { |k, v| [k, rand(0..20)] }.to_h },
+      { name: "batch 2", data: base_data.map { |k, v| [k, rand(0..40)] }.to_h },
+      { name: "batch 3", data: base_data.map { |k, v| [k, rand(0..10)] }.to_h }
+    ]
+  end
+end

data/lib/generators/jav/templates/cards/metric_card.tt

@@ -0,0 +1,8 @@
+class <%= class_name.camelize %> < Jav::Dashboards::MetricCard
+  self.id = "<%= name.underscore %>"
+  self.label = "<%= name.underscore.humanize %>"
+
+  def query
+    result 101
+  end
+end