jav 2.55.4

data/lib/jav/fields/belongs_to_field.rb

@@ -0,0 +1,268 @@
+module Jav
+  module Fields
+    # The field can be in multiple scenarios where it needs different types of data and displays the state differently.
+    # For example the non-polymorphic, non-searchable variant is the easiest to support. You only need to populate a simple select with the ID of the associated record and the list of records.
+    # For the searchable polymorphic variant you need to provide the type of the association (Post, Project, Team), the label of the associated record ("Cool post title") and the ID of that record.
+    # Furthermore, the way Jav works, it needs to do some queries on the back-end to fetch the required information.
+    #
+    # Field scenarios:
+    # 1. Create new record
+    #   List of records
+    # 2. Create new record as association
+    #   List of records, the ID
+    # 3. Create new searchable record
+    #   Nothing really. The records will be fetched from the search API
+    # 4. Create new searchable record as association
+    #   The associated record label and ID. The records will be fetched from the search API
+    # 5. Create new polymorphic record
+    #   Type & ID
+    # 6. Create new polymorphic record as association
+    #   Type, list of records, and ID
+    # 7. Create new polymorphic searchable record
+    #   Type, Label and ID
+    # 8. Create new polymorphic searchable record as association
+    #   Type, Label and ID
+    # 9. Edit a record
+    #   List of records & ID
+    # 10. Edit a record as searchable
+    #   Label and ID
+    # 11. Edit a record as an association
+    #   List and ID
+    # 12. Edit a record as an searchable association
+    #   Label and ID
+    # 13. Edit a polymorphic record
+    #   Type, List of records & ID
+    # 14. Edit a polymorphic record as searchable
+    #   Type, Label and ID
+    # 15. Edit a polymorphic record as an association
+    #   Type, List and ID
+    # 16. Edit a polymorphic record as an searchable association
+    #   Type, Label and ID
+    # Also all of the above with a namespaced model `Course/Link`
+
+    # Variants
+    # 1. Select belongs to
+    # 2. Searchable belongs to
+    # 3. Select Polymorphic belongs to
+    # 4. Searchable Polymorphic belongs to
+
+    # Requirements
+    # - list
+    # - ID
+    # - label
+    # - Type
+    # - foreign_key
+    # - foreign_key for poly type
+    # - foreign_key for poly id
+    # - is_disabled?
+
+    class BelongsToField < BaseField
+      include Jav::Fields::Concerns::UseResource
+
+      attr_accessor :target
+
+      attr_reader :polymorphic_as, :relation_method, :types, :allow_via_detaching, :attach_scope, :polymorphic_help, :searchable # for Polymorphic associations
+
+      def initialize(id, **args, &block)
+        args[:placeholder] ||= I18n.t("jav.choose_an_option")
+
+        super
+
+        @searchable = args[:searchable] == true
+        @polymorphic_as = args[:polymorphic_as]
+        @types = args[:types]
+        @relation_method = id.to_s.parameterize.underscore
+        @allow_via_detaching = args[:allow_via_detaching] == true
+        @attach_scope = args[:attach_scope]
+        @polymorphic_help = args[:polymorphic_help]
+        @target = args[:target]
+        @use_resource = args[:use_resource] || nil
+      end
+
+      def value
+        if is_polymorphic?
+          # Get the value from the pre-filled assoociation record
+          super(polymorphic_as)
+        else
+          # Get the value from the pre-filled assoociation record
+          super(relation_method)
+        end
+      end
+
+      # The value
+      def field_value
+        value.send(database_value)
+      rescue StandardError
+        nil
+      end
+
+      # What the user sees in the text field
+      def field_label
+        value.send(target_resource.class.title)
+      rescue StandardError
+        nil
+      end
+
+      def options
+        values_for_type
+      end
+
+      def values_for_type(model = nil)
+        resource = target_resource
+        resource = App.get_resource_by_model_name model if model.present?
+
+        query = resource.class.query_scope
+
+        query = Jav::Hosts::AssociationScopeHost.new(block: attach_scope, query: query, parent: get_model).handle if attach_scope.present?
+
+        query.all.map do |mod|
+          [mod.send(resource.class.title), mod.id]
+        end
+      end
+
+      def database_value
+        target_resource.id
+      rescue StandardError
+        nil
+      end
+
+      def type_input_foreign_key
+        return unless is_polymorphic?
+
+        "#{foreign_key}_type"
+      end
+
+      def id_input_foreign_key
+        if is_polymorphic?
+          "#{foreign_key}_id"
+        else
+          foreign_key
+        end
+      end
+
+      def is_polymorphic?
+        polymorphic_as.present?
+      rescue StandardError
+        false
+      end
+
+      def foreign_key
+        return polymorphic_as if polymorphic_as.present?
+
+        if @model.present?
+          get_model_class(@model).reflections[@relation_method].foreign_key
+        elsif @resource.present? && @resource.model_class.reflections[@relation_method].present?
+          @resource.model_class.reflections[@relation_method].foreign_key
+        end
+      end
+
+      def reflection_for_key(key)
+        get_model_class(get_model).reflections[key.to_s]
+      rescue StandardError
+        nil
+      end
+
+      # Get the model reflection instance
+      def reflection
+        reflection_for_key(id)
+      rescue StandardError
+        nil
+      end
+
+      def relation_model_class
+        @resource.model_class
+      end
+
+      def label
+        value.send(target_resource.class.title)
+      end
+
+      def to_permitted_param
+        return [:"#{polymorphic_as}_type", :"#{polymorphic_as}_id"] if polymorphic_as.present?
+
+        foreign_key.to_sym
+      end
+
+      def fill_field(model, key, value, params)
+        return model unless model.methods.include? key.to_sym
+
+        if polymorphic_as.present?
+          valid_model_class = valid_polymorphic_class params["#{polymorphic_as}_type"]
+
+          model.send(:"#{polymorphic_as}_type=", valid_model_class)
+
+          # If the type is blank, reset the id too.
+          if valid_model_class.blank?
+            model.send(:"#{polymorphic_as}_id=", nil)
+          else
+            model.send(:"#{polymorphic_as}_id=", params["#{polymorphic_as}_id"])
+          end
+        else
+          model.send(:"#{key}=", value)
+        end
+
+        model
+      end
+
+      def valid_polymorphic_class(possible_class)
+        types.find do |type|
+          type.to_s == possible_class.to_s
+        end
+      end
+
+      def database_id
+        # If the field is a polymorphic value, return the polymorphic_type as key and pre-fill the _id in fill_field.
+        return "#{polymorphic_as}_type" if polymorphic_as.present?
+
+        foreign_key
+      rescue StandardError
+        id
+      end
+
+      def target_resource
+        return use_resource if use_resource.present?
+
+        if is_polymorphic?
+          return App.get_resource_by_model_name(value.class) if value.present?
+
+          return nil
+
+        end
+
+        reflection_key = polymorphic_as || id
+
+        if @model.class.reflect_on_association(reflection_key).klass.present?
+          App.get_resource_by_model_name @model.class.reflect_on_association(reflection_key).klass.to_s
+        elsif @model.class.reflect_on_association(reflection_key).options[:class_name].present?
+          App.get_resource_by_model_name @model.class.reflect_on_association(reflection_key).options[:class_name]
+        else
+          App.get_resource_by_name reflection_key.to_s
+        end
+      end
+
+      def get_model
+        return @model if @model.present?
+
+        @resource.model
+      rescue StandardError
+        nil
+      end
+
+      def name
+        return polymorphic_as.to_s.humanize if polymorphic_as.present? && view == :index
+
+        super
+      end
+
+      private
+
+      def get_model_class(model)
+        if model.instance_of?(Class)
+          model
+        else
+          model.class
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/boolean_field.rb

@@ -0,0 +1,30 @@
+module Jav
+  module Fields
+    class BooleanField < BaseField
+      attr_reader :true_value, :false_value
+
+      def initialize(id, **args, &block)
+        super
+
+        @true_value = args[:true_value].presence || true
+        @false_value = args[:false_value].presence || false
+      end
+
+      def value
+        resolve_attribute super
+      end
+
+      def resolve_attribute(value)
+        value.present? ? value.in?(truthy_values) : value
+      end
+
+      def truthy_values
+        ["true", "1", @true_value]
+      end
+
+      def falsy_values
+        ["false", "0", @false_value]
+      end
+    end
+  end
+end

data/lib/jav/fields/boolean_group_field.rb

@@ -0,0 +1,33 @@
+module Jav
+  module Fields
+    class BooleanGroupField < BaseField
+      attr_reader :options
+
+      def initialize(id, **args, &block)
+        super
+
+        @options = args[:options].presence || {}
+      end
+
+      def to_permitted_param
+        ["#{id}": []]
+      end
+
+      def fill_field(model, key, value, params)
+        new_value = {}
+
+        # Filter out the empty ("") value boolean group generates
+        value = value.compact_blank
+
+        # Cast values to booleans
+        options.each_key do |id|
+          new_value[id] = value.include? id.to_s
+        end
+
+        model[id] = new_value
+
+        model
+      end
+    end
+  end
+end

data/lib/jav/fields/code_field.rb

@@ -0,0 +1,20 @@
+module Jav
+  module Fields
+    class CodeField < BaseField
+      attr_reader :language, :theme, :height, :tab_size, :indent_with_tabs, :line_wrapping
+
+      def initialize(id, **args, &block)
+        hide_on :index
+
+        super
+
+        @language = args[:language].present? ? args[:language].to_s : "javascript"
+        @theme = args[:theme].present? ? args[:theme].to_s : "default"
+        @height = args[:height].present? ? args[:height].to_s : "auto"
+        @tab_size = args[:tab_size].presence || 2
+        @indent_with_tabs = args[:indent_with_tabs].presence || false
+        @line_wrapping = args[:line_wrapping].presence || true
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/file_authorization.rb

@@ -0,0 +1,31 @@
+module Jav
+  module Fields
+    module Concerns
+      module FileAuthorization
+        extend ActiveSupport::Concern
+
+        delegate :authorization, to: :@resource
+        delegate :authorize_action, to: :authorization
+        delegate :id, :model, to: :@field
+
+        def can_upload_file?
+          authorize_file_action(:upload)
+        end
+
+        def can_delete_file?
+          authorize_file_action(:delete)
+        end
+
+        def can_download_file?
+          authorize_file_action(:download)
+        end
+
+        private
+
+        def authorize_file_action(action)
+          authorize_action("#{action}_#{id}?", record: model, raise_exception: false)
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/has_default.rb

@@ -0,0 +1,17 @@
+module Jav
+  module Fields
+    module Concerns
+      module HasDefault
+        extend ActiveSupport::Concern
+
+        def computed_default_value
+          if default.respond_to? :call
+            Jav::Hosts::ResourceViewRecordHost.new(block: default, record: model, view: view, resource: resource).handle
+          else
+            default
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/is_disabled.rb

@@ -0,0 +1,19 @@
+module Jav
+  module Fields
+    module Concerns
+      module IsDisabled
+        extend ActiveSupport::Concern
+
+        attr_reader :disabled
+
+        def is_disabled?
+          if disabled.respond_to? :call
+            Jav::Hosts::ResourceViewRecordHost.new(block: disabled, record: model, view: view, resource: resource).handle
+          else
+            disabled
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/is_readonly.rb

@@ -0,0 +1,17 @@
+module Jav
+  module Fields
+    module Concerns
+      module IsReadonly
+        extend ActiveSupport::Concern
+
+        def is_readonly?
+          if readonly.respond_to? :call
+            Jav::Hosts::ResourceViewRecordHost.new(block: readonly, record: model, view: view, resource: resource).handle
+          else
+            readonly
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/is_required.rb

@@ -0,0 +1,29 @@
+module Jav
+  module Fields
+    module Concerns
+      module IsRequired
+        extend ActiveSupport::Concern
+
+        def is_required?
+          if required.respond_to? :call
+            Jav::Hosts::ResourceViewRecordHost.new(block: required, record: model, view: view, resource: resource).handle
+          else
+            required.nil? ? required_from_validators : required
+          end
+        end
+
+        private
+
+        def required_from_validators
+          return false if model.nil?
+
+          validators.any?(ActiveModel::Validations::PresenceValidator)
+        end
+
+        def validators
+          model.class.validators_on(id)
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/concerns/use_resource.rb

@@ -0,0 +1,13 @@
+module Jav
+  module Fields
+    module Concerns
+      module UseResource
+        extend ActiveSupport::Concern
+
+        def use_resource
+          App.get_resource @use_resource
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/country_field.rb

@@ -0,0 +1,34 @@
+module Jav
+  module Fields
+    class CountryField < BaseField
+      include Jav::Fields::FieldExtensions::HasIncludeBlank
+
+      attr_reader :countries, :display_code
+
+      def initialize(id, **args, &block)
+        args[:placeholder] ||= I18n.t("jav.choose_a_country")
+
+        super
+
+        @countries = begin
+          ISO3166::Country.translations.sort_by { |_, name| name }.to_h
+        rescue StandardError
+          { none: "You need to install the countries gem for this field to work properly" }
+        end
+        @display_code = args[:display_code].presence || false
+      end
+
+      def select_options
+        if @display_code
+          countries.map do |code, _|
+            [code, code]
+          end
+        else
+          countries.map do |code, name|
+            [name, code]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/date_field.rb

@@ -0,0 +1,40 @@
+module Jav
+  module Fields
+    class DateField < TextField
+      attr_reader :first_day_of_week, :picker_format, :disable_mobile, :format, :picker_options
+
+      def initialize(id, **args, &block)
+        super
+
+        add_string_prop args, :first_day_of_week, 1
+        add_string_prop args, :picker_format, "Y-m-d"
+        add_string_prop args, :format, "yyyy-LL-dd"
+        add_boolean_prop args, :disable_mobile
+        add_object_prop args, :picker_options
+      end
+
+      def formatted_value
+        return if value.blank?
+
+        try_iso8601
+      end
+
+      def edit_formatted_value
+        formatted_value
+      end
+
+      private
+
+      def try_iso8601
+        if value.respond_to?(:iso8601)
+          value.iso8601
+        elsif value.is_a?(String)
+          parsed = DateTime.parse(value.dup)
+          parsed.presence
+        else
+          value
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/date_time_field.rb

@@ -0,0 +1,66 @@
+module Jav
+  module Fields
+    class DateTimeField < DateField
+      attr_reader :format, :picker_format, :time_24hr, :relative
+
+      def initialize(id, **args, &block)
+        super
+
+        add_boolean_prop args, :time_24hr
+        add_string_prop args, :picker_format, "Y-m-d H:i:S"
+        add_string_prop args, :format, "yyyy-LL-dd TT"
+        add_string_prop args, :timezone
+        add_boolean_prop args, :relative, true
+      end
+
+      def formatted_value
+        return nil if value.nil?
+
+        value.utc.to_time.iso8601
+      end
+
+      def edit_formatted_value
+        return nil if value.nil?
+
+        value.utc.iso8601
+      end
+
+      def fill_field(model, key, value, params)
+        if value.in?(["", nil])
+          model[id] = value
+
+          return model
+        end
+
+        return model if value.blank?
+
+        model[id] = utc_time(value)
+
+        model
+      end
+
+      def utc_time(value)
+        time = Time.zone.parse(value)
+
+        if timezone.present? && !time.utc?
+          ActiveSupport::TimeZone.new(timezone).local_to_utc(time)
+        else
+          value
+        end
+      end
+
+      def timezone
+        timezone = if @timezone.respond_to?(:call)
+                     return Jav::Hosts::ResourceViewRecordHost.new(block: @timezone, record: resource.model, resource: resource, view: view).handle
+                   else
+                     @timezone
+                   end
+
+        # Fix for https://github.com/moment/luxon/issues/1358#issuecomment-2017477897
+        return "Etc/UTC" if timezone&.downcase == "utc" && view.in?(%i[new create edit update])
+
+        timezone
+      end
+    end
+  end
+end

data/lib/jav/fields/external_image_field.rb

@@ -0,0 +1,21 @@
+module Jav
+  module Fields
+    class ExternalImageField < BaseField
+      attr_reader :width, :height, :radius, :link_to_resource
+
+      def initialize(id, **args, &block)
+        super
+
+        @link_to_resource = args[:link_to_resource].presence || false
+
+        @width = args[:width].presence || 40
+        @height = args[:height].presence || 40
+        @radius = args[:radius].presence || 0
+      end
+
+      def to_image
+        value
+      end
+    end
+  end
+end

data/lib/jav/fields/field_extensions/has_field_name.rb

@@ -0,0 +1,19 @@
+module Jav
+  module Fields
+    module FieldExtensions
+      module HasFieldName
+        # Set the field name
+        def field_name=(name)
+          self.field_name_attribute = name
+        end
+
+        # Get the field name
+        def field_name
+          return field_name_attribute if field_name_attribute.present?
+
+          to_s.demodulize.underscore.gsub "_field", ""
+        end
+      end
+    end
+  end
+end

data/lib/jav/fields/field_extensions/has_include_blank.rb

@@ -0,0 +1,17 @@
+module Jav
+  module Fields
+    module FieldExtensions
+      module HasIncludeBlank
+        def include_blank
+          if @args[:include_blank] == true
+            placeholder || "—"
+          elsif @args[:include_blank] == false
+            false
+          else
+            @args[:include_blank]
+          end
+        end
+      end
+    end
+  end
+end