action_form 0.1.0

data/lib/action_form/schema_dsl.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module ActionForm
+  # Provides DSL methods for defining form schemas and converting them to EasyParams
+  module SchemaDSL
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+
+    module ClassMethods # rubocop:disable Style/Documentation
+      def params_class
+        EasyParams::Base
+      end
+
+      def params_definition(*) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        schema = Class.new(params_class)
+        elements.each do |name, element_definition|
+          if element_definition < ActionForm::SubformsCollection
+            # nested forms are passed as a hash that looks like this:
+            # { "0" => { "id" => "1" }, "1" => { "id" => "2" } }
+            # it is coercing to an array of hashes:
+            # [['0', { "id" => "1" }], ['1', { "id" => "2" }]]
+            # we need to normalize it to an array of hashes:
+            # [ { "id" => "1" }, { "
+            # id" => "2" } ]
+            schema.each(:"#{name}_attributes", element_definition.subform_definition.params_definition,
+                        normalize: ->(value) { value.flatten.select { |v| v.is_a?(Hash) } },
+                        default: element_definition.default)
+          elsif element_definition < ActionForm::Subform
+            schema.has(:"#{name}_attributes", element_definition.params_definition, default: element_definition.default)
+          elsif element_definition < ActionForm::Element
+            options = element_definition.output_options.dup
+            method_name = options.delete(:type)
+            schema.public_send(method_name, name, **options)
+          end
+        end
+        schema
+      end
+    end
+  end
+end

data/lib/action_form/subform.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module ActionForm
+  # Subform class for ActionForm that handles nested form structures.
+  # It allows building forms within forms, supporting has_one and has_many relationships.
+  # Includes schema and element DSL functionality for defining form elements.
+  class Subform < ::Phlex::HTML
+    include ActionForm::Rendering
+    include ActionForm::SchemaDSL
+    include ActionForm::ElementsDSL
+
+    class << self
+      attr_accessor :default
+    end
+
+    attr_reader :elements_instances, :tags, :name, :object
+    attr_accessor :helpers
+
+    def initialize(name:, scope: nil, model: nil, params: nil, **tags)
+      super()
+      @name = name
+      @scope = scope
+      @object = model
+      @params = params
+      @elements_instances = []
+      @tags = tags
+      build_from_object
+    end
+
+    def build_from_object
+      self.class.elements.each do |element_name, element_definition|
+        @elements_instances << element_definition.new(element_name, @params || @object, parent_name: @scope)
+        @elements_instances.last.tags.merge!(subform: @name)
+      end
+    end
+
+    def render?
+      true
+    end
+
+    def template_html_id
+      "#{name}_template"
+    end
+
+    def html_id
+      "#{name}_#{tags[:index]}"
+    end
+
+    def html_class
+      "#{name}_subform"
+    end
+
+    def view_template
+      render_elements
+    end
+  end
+end

data/lib/action_form/subforms_collection.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module ActionForm
+  # Collection of subforms that can be iterated and rendered
+  class SubformsCollection < ::Phlex::HTML
+    extend Forwardable
+    include ActionForm::Rendering
+
+    def_delegators :@subforms, :last, :first, :length, :size, :[], :<<
+
+    attr_reader :subforms, :tags, :name
+    attr_accessor :helpers
+
+    class << self
+      attr_reader :subform_definition
+      attr_accessor :default, :host_class
+
+      def subform(subform_class = nil, &block)
+        @subform_definition = subform_class || Class.new(host_class.subform_class)
+        @subform_definition.class_eval(&block) if block
+      end
+    end
+
+    def initialize(name)
+      super()
+      @name = name
+      @subforms = []
+      @tags = {}
+    end
+
+    def each(&block)
+      return to_enum(:each) unless block
+
+      @subforms.each(&block)
+    end
+
+    def render?
+      true
+    end
+
+    def template_html_id
+      "#{name}_template"
+    end
+
+    def add_subform_js
+      <<~JS
+        function easyFormAddSubform(event) {
+          event.preventDefault()
+          var template = document.querySelector("##{template_html_id}")
+          const content = template.innerHTML.replace(/NEW_RECORD/g, new Date().getTime().toString())
+          var beforeElement = event.target.closest(event.target.dataset.insertBeforeSelector)
+          if (beforeElement) {
+            beforeElement.insertAdjacentHTML("beforebegin", content)
+          } else {
+            event.target.parentElement.insertAdjacentHTML("beforebegin", content)
+          }
+        }
+      JS
+    end
+
+    def remove_subform_js
+      <<~JS
+        function easyFormRemoveSubform(event) {
+          event.preventDefault()
+          var subform = event.target.closest(".new_#{name}")
+          if (subform) { subform.remove() }
+          var subform = event.target.closest(".#{name}_subform")
+          if (subform) {
+            subform.style.display = "none"
+            var input = subform.querySelector("input[name*='_destroy']")
+            if (input) { input.value = "1" }
+          }
+        }
+      JS
+    end
+
+    def view_template # rubocop:disable Metrics/AbcSize
+      script(type: "text/javascript") { raw safe(remove_subform_js) }
+      script(type: "text/javascript") { raw safe(add_subform_js) }
+      subforms.each do |subform|
+        subform.helpers = helpers
+        if subform.tags[:template]
+          render_subform_template(subform)
+        else
+          div(id: subform.html_id, class: subform.html_class) { render_subform(subform) }
+        end
+      end
+    end
+
+    def render_subform_template(subform)
+      template(id: template_html_id) do
+        div(class: "new_#{name}") { render_subform(subform) }
+      end
+    end
+  end
+end

data/lib/action_form/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ActionForm
+  VERSION = "0.1.0"
+end

data/lib/action_form.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "phlex"
+require "easy_params"
+require "forwardable"
+require_relative "action_form/version"
+require_relative "action_form/schema_dsl"
+require_relative "action_form/elements_dsl"
+require_relative "action_form/input"
+require_relative "action_form/rendering"
+require_relative "action_form/subform"
+require_relative "action_form/subforms_collection"
+require_relative "action_form/element"
+require_relative "action_form/base"
+require_relative "action_form/rails/rendering"
+require_relative "action_form/rails/subform"
+require_relative "action_form/rails/base"
+
+module ActionForm
+  class Error < StandardError; end
+end

data/sig/action_form.rbs

@@ -0,0 +1,4 @@
+module ActionForm
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

data/sig/easy_form.rbs

@@ -0,0 +1,4 @@
+module ActionForm
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: action_form
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrii Baran
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: easy_params
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+- !ruby/object:Gem::Dependency
+  name: phlex
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+description: Action form builder for Rails
+email:
+- andriy.baran.v@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".qlty/.gitignore"
+- ".qlty/qlty.toml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/action_form.rb
+- lib/action_form/base.rb
+- lib/action_form/element.rb
+- lib/action_form/elements_dsl.rb
+- lib/action_form/input.rb
+- lib/action_form/rails/base.rb
+- lib/action_form/rails/rendering.rb
+- lib/action_form/rails/subform.rb
+- lib/action_form/rendering.rb
+- lib/action_form/schema_dsl.rb
+- lib/action_form/subform.rb
+- lib/action_form/subforms_collection.rb
+- lib/action_form/version.rb
+- sig/action_form.rbs
+- sig/easy_form.rbs
+homepage: https://github.com/andriy-baran/action_form
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/andriy-baran/action_form
+  source_code_uri: https://github.com/andriy-baran/action_form
+  changelog_uri: https://github.com/andriy-baran/action_form/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.1
+specification_version: 4
+summary: Action form builder for Rails
+test_files: []