polaris_form 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c34d1faa7d2c20108d6762f5990df9d7b4b26fa72f92329d5ce30f1bcdba1605
+  data.tar.gz: e273464371de2caefdd25d83806570d06fdae8361d383652b6c199bfee685404
+SHA512:
+  metadata.gz: 119337c61aecf5fa01b2005c418af45c7b6f671c58dab8bc7306b7d8b5aca9c9acf52f249597743a6424483742dbe7bbec4f07db2f8c5e9afbeb4832faaeb64c
+  data.tar.gz: fe4f9532141669c263f689216a9b1fe2d76aee0ea063fcdf8e7e1fd21fcb78cb2f9cf5eeb80ec4d5f42762eec9a8327c11c1682347af692216a87ad0260cc7a9

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright Hopper Gee
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,28 @@
+# PolarisForm
+Short description and motivation.
+
+## Usage
+How to use my plugin.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "polaris_form"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install polaris_form
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+load "rails/tasks/statistics.rake"
+
+require "bundler/gem_tasks"

data/config/routes.rb

@@ -0,0 +1,2 @@
+Rails.application.routes.draw do
+end

data/lib/polaris_form/builder.rb

@@ -0,0 +1,71 @@
+module PolarisForm
+  class Builder < ActionView::Helpers::FormBuilder
+    def s_checkbox(method, options = {}, checked_value = '1', unchecked_value = '0')
+      PolarisForm::Tag::Checkbox.new(@object_name, method, @template, checked_value, unchecked_value, objectify_options(options)).render
+    end
+
+    # def s_choice_list(method, options = {}, &block)
+    #   @template.s_choice_list_tag(@object_name, method, objectify_options(options), &block)
+    # end
+
+    def s_color_field(method, options = {})
+      PolarisForm::Tag::ColorField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_color_picker(method, options = {})
+      PolarisForm::Tag::ColorPicker.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_date_field(method, options = {})
+      PolarisForm::Tag::DateField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_date_picker(method, options = {})
+      PolarisForm::Tag::DatePicker.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_drop_zone(method, options = {})
+      PolarisForm::Tag::DropZone.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_email_field(method, options = {})
+      PolarisForm::Tag::EmailField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_money_field(method, options = {})
+      PolarisForm::Tag::MoneyField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_number_field(method, options = {})
+      PolarisForm::Tag::NumberField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_password_field(method, options = {})
+      PolarisForm::Tag::PasswordField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_search_field(method, options = {})
+      PolarisForm::Tag::SearchField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_select(method, choices = nil, options = {}, html_options = {}, &block)
+      PolarisForm::Tag::Select.new(@object_name, method, @template, choices, objectify_options(options), html_options).render(&block)
+    end
+
+    def s_switch(method, options = {}, checked_value = '1', unchecked_value = '0')
+      PolarisForm::Tag::Switch.new(@object_name, method, @template, checked_value, unchecked_value, objectify_options(options)).render
+    end
+
+    def s_text_area(method, options = {})
+      PolarisForm::Tag::TextArea.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_text_field(method, options = {})
+      PolarisForm::Tag::TextField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+
+    def s_url_field(method, options = {})
+      PolarisForm::Tag::UrlField.new(@object_name, method, @template, objectify_options(options)).render
+    end
+  end
+end

data/lib/polaris_form/engine.rb

@@ -0,0 +1,4 @@
+module PolarisForm
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/polaris_form/helpers/form_helper.rb

@@ -0,0 +1,133 @@
+require "polaris_form/tag/base"
+require "polaris_form/tag/checkable"
+require "polaris_form/tag/checkbox"
+require "polaris_form/tag/choice_list"
+require "polaris_form/tag/choice"
+require "polaris_form/tag/color_field"
+require "polaris_form/tag/color_picker"
+require "polaris_form/tag/date_field"
+require "polaris_form/tag/date_picker"
+require "polaris_form/tag/drop_zone"
+require "polaris_form/tag/email_field"
+require "polaris_form/tag/money_field"
+require "polaris_form/tag/number_field"
+require "polaris_form/tag/option_group"
+require "polaris_form/tag/option"
+require "polaris_form/tag/password_field"
+require "polaris_form/tag/search_field"
+require "polaris_form/tag/select"
+require "polaris_form/tag/switch"
+require "polaris_form/tag/text_area"
+require "polaris_form/tag/text_field"
+require "polaris_form/tag/url_field"
+
+module PolarisForm
+  module Helpers
+    module FormHelper
+      def polaris_form_with(**options, &block)
+        options[:builder] ||= PolarisForm::Builder
+        form_with(**options, &block)
+      end
+
+      def polaris_form_for(record, options = {}, &block)
+        options[:builder] ||= PolarisForm::Builder
+        form_for(record, options, &block)
+      end
+
+      def s_checkbox_tag(name, value = "1", checked = false, options = {})
+        options[:include_hidden] = false
+        options[:checked] = checked
+        PolarisForm::Tag::Checkbox.new(nil, name, self, value, nil, options).render
+      end
+
+      # def s_choice_list_tag(name, options = {}, &block)
+      #   PolarisForm::Tag::ChoiceList.new(nil, name, self, options).render(&block)
+      # end
+
+      def s_choice_tag(options = {}, &block)
+        PolarisForm::Tag::Choice.new(nil, nil, self, options).render(&block)
+      end
+
+      def s_color_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::ColorField.new(nil, name, self, options).render
+      end
+
+      def s_color_picker_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::ColorPicker.new(nil, name, self, options).render
+      end
+
+      def s_date_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::DateField.new(nil, name, self, options).render
+      end
+
+      def s_date_picker_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::DatePicker.new(nil, name, self, options).render
+      end
+
+      def s_drop_zone_tag(name, options = {})
+        PolarisForm::Tag::DropZone.new(nil, name, self, options).render
+      end
+
+      def s_email_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::EmailField.new(nil, name, self, options).render
+      end
+
+      def s_money_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::MoneyField.new(nil, name, self, options).render
+      end
+
+      def s_number_field_tag(name, value = nil, options = {})
+        PolarisForm::Tag::NumberField.new(nil, name, self, options).render
+      end
+
+      def s_option_group_tag(options = {}, &block)
+        PolarisForm::Tag::OptionGroup.new(nil, nil, self, options).render(&block)
+      end
+
+      def s_option_tag(options = {}, &block)
+        PolarisForm::Tag::Option.new(nil, nil, self, options).render(&block)
+      end
+
+      def s_password_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::PasswordField.new(nil, name, self, options).render
+      end
+
+      def s_search_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::SearchField.new(nil, name, self, options).render
+      end
+
+      # def s_select_tag(name, option_tags = nil, options = {}, &block)
+      #   PolarisForm::Tag::Select.new(nil, name, self, options).render(&block)
+      # end
+
+      def s_switch_tag(name, value = "1", checked = false, options = {})
+        options[:include_hidden] = false
+        options[:checked] = checked
+        PolarisForm::Tag::Switch.new(nil, name, self, value, nil, options).render
+      end
+
+      def s_text_area_tag(name, content = nil, options = {})
+        options[:value] = content
+        PolarisForm::Tag::TextArea.new(nil, name, self, options).render
+      end
+
+      def s_text_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::TextField.new(nil, name, self, options).render
+      end
+
+      def s_url_field_tag(name, value = nil, options = {})
+        options[:value] = value
+        PolarisForm::Tag::UrlField.new(nil, name, self, options).render
+      end
+    end
+  end
+end

data/lib/polaris_form/helpers/form_options_helper.rb

@@ -0,0 +1,74 @@
+module PolarisForm
+  module Helpers
+    module FormOptionsHelper
+
+      def s_options_for_select(container, selected = nil)
+        return container if String === container
+
+        selected, disabled = extract_selected_and_disabled(selected).map do |r|
+          Array(r).map(&:to_s)
+        end
+
+        container.map do |element|
+          html_attributes = option_html_attributes(element)
+          text, value = option_text_and_value(element).map(&:to_s)
+
+          html_attributes[:selected] ||= option_value_selected?(value, selected)
+          html_attributes[:disabled] ||= disabled && option_value_selected?(value, disabled)
+          html_attributes[:value] = value
+
+          tag_builder.content_tag_string("s-option", text, html_attributes)
+        end.join("\n").html_safe
+      end
+
+      def s_grouped_options_for_select(grouped_options, selected_key = nil, options = {})
+        prompt  = options[:prompt]
+        divider = options[:divider]
+
+        body = "".html_safe
+
+        if prompt
+          body.safe_concat content_tag("s-option", prompt_text(prompt), value: "")
+        end
+
+        grouped_options.each do |container|
+          html_attributes = option_html_attributes(container)
+
+          if divider
+            label = divider
+          else
+            label, container = container
+          end
+
+          html_attributes = { label: label }.merge!(html_attributes)
+          body.safe_concat content_tag("s-option-group", options_for_select(container, selected_key), html_attributes)
+        end
+
+        body
+      end
+
+      def s_option_groups_from_collection_for_select(collection, group_method, group_label_method, option_key_method, option_value_method, selected_key = nil)
+        collection.map do |group|
+          option_tags = options_from_collection_for_select(
+            value_for_collection(group, group_method), option_key_method, option_value_method, selected_key)
+
+          content_tag("s-option-group", option_tags, label: value_for_collection(group, group_label_method))
+        end.join.html_safe
+      end
+
+      def s_options_from_collection_for_select(collection, value_method, text_method, selected = nil)
+        options = collection.map do |element|
+          [value_for_collection(element, text_method), value_for_collection(element, value_method), option_html_attributes(element)]
+        end
+        selected, disabled = extract_selected_and_disabled(selected)
+        select_deselect = {
+          selected: extract_values_from_collection(collection, value_method, selected),
+          disabled: extract_values_from_collection(collection, value_method, disabled)
+        }
+
+        s_options_for_select(options, select_deselect)
+      end
+
+    end
+  end
+end

data/lib/polaris_form/helpers.rb

@@ -0,0 +1,9 @@
+require "polaris_form/helpers/form_options_helper"
+require "polaris_form/helpers/form_helper"
+
+module PolarisForm
+  module Helpers
+    include FormHelper
+    include FormOptionsHelper
+  end
+end

data/lib/polaris_form/railtie.rb

@@ -0,0 +1,9 @@
+module PolarisForm
+  class Railtie < ::Rails::Engine
+    initializer "polaris_form.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include PolarisForm::Helpers
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/base.rb

@@ -0,0 +1,80 @@
+module PolarisForm
+  module Tag
+    class Base < ::ActionView::Helpers::Tags::Base
+
+      include Helpers::FormOptionsHelper
+
+      def initialize(object_name, method_name, template_object, options = {})
+        camelized_options = Utils.camelize_polaris_options(options)
+        super(object_name, method_name, template_object, camelized_options)
+      end
+
+      def tag(type, options, *rest, &block)
+        if object_has_errors?
+          options["error"] = error_message
+        end
+        super(type, options, *rest, &block)
+      end
+
+      def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)
+        if object_has_errors?
+          if block_given?
+            content_or_options_with_block ||= {}
+            content_or_options_with_block["error"] = error_message
+          else
+            options ||= {}
+            options["error"] = error_message
+          end
+        end
+        super(name, content_or_options_with_block, options, escape, &block)
+      end
+
+      def empty_content_tag(name, options = nil, escape = true, &block)
+        if object_has_errors?
+          options["error"] = error_message
+        end
+        tag_builder.content_tag_string(name, "", options, escape)
+      end
+
+      def error_wrapping(html_tag)
+        html_tag
+      end
+
+      def select_content_tag(option_tags, options, html_options)
+        html_options = html_options.stringify_keys
+        if html_options["label"].blank?
+          html_options["label"] = " "
+          html_options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(html_options)
+
+        if placeholder_required?(html_options)
+          raise ArgumentError, "include_blank cannot be false for a required field." if options[:include_blank] == false
+          options[:include_blank] ||= true unless options[:prompt]
+        end
+
+        value = options.fetch(:selected) { value() }
+        html_options["value"] = value
+        content_tag("s-select", add_options(option_tags, options, value), html_options)
+      end
+
+      def add_options(option_tags, options, value = nil)
+        if options[:include_blank]
+          content = (options[:include_blank] if options[:include_blank].is_a?(String))
+          label = (" " unless content)
+          option_tags = tag_builder.content_tag_string("s-option", content, value: "", label: label) + "\n" + option_tags
+        end
+
+        if value.blank? && options[:prompt]
+          tag_options = { value: "" }.tap do |prompt_opts|
+            prompt_opts[:disabled] = true if options[:disabled] == ""
+            prompt_opts[:selected] = true if options[:selected] == ""
+          end
+          option_tags = tag_builder.content_tag_string("s-option", prompt_text(options[:prompt]), tag_options) + "\n" + option_tags
+        end
+
+        option_tags
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/checkable.rb

@@ -0,0 +1,14 @@
+module PolarisForm
+  module Tag
+    module Checkable
+      def input_checked?(options)
+        if options.has_key?("checked")
+          checked = options.delete "checked"
+          checked == true || checked == "checked"
+        else
+          checked?(value)
+        end
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/checkbox.rb

@@ -0,0 +1,60 @@
+module PolarisForm
+  module Tag
+    class Checkbox < Base
+
+      include Checkable
+
+      def initialize(object_name, method_name, template_object, checked_value, unchecked_value, options)
+        @checked_value   = checked_value
+        @unchecked_value = unchecked_value
+        super(object_name, method_name, template_object, options)
+      end
+
+      def render
+        options = @options.stringify_keys
+        options["value"]    = @checked_value
+        options["checked"] = "checked" if input_checked?(options)
+
+        if options["multiple"]
+          add_default_name_and_id_for_value(@checked_value, options)
+          options.delete("multiple")
+        else
+          add_default_name_and_id(options)
+        end
+
+        include_hidden = options.delete("include_hidden") { true }
+        checkbox = empty_content_tag("s-checkbox", options)
+
+        if include_hidden
+          hidden = hidden_field_for_checkbox(options)
+          hidden + checkbox
+        else
+          checkbox
+        end
+      end
+
+      private
+
+      def checked?(value)
+        case value
+        when TrueClass, FalseClass
+          value == !!@checked_value
+        when NilClass
+          false
+        when String
+          value == @checked_value
+        else
+          if value.respond_to?(:include?)
+            value.include?(@checked_value)
+          else
+            value.to_i == @checked_value.to_i
+          end
+        end
+      end
+
+      def hidden_field_for_checkbox(options)
+        @unchecked_value ? tag("input", options.slice("name", "disabled", "form").merge!("type" => "hidden", "value" => @unchecked_value, "autocomplete" => "off")) : "".html_safe
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/choice.rb

@@ -0,0 +1,15 @@
+module PolarisForm
+  module Tag
+    class Choice < Base
+      def render(&block)
+        options = @options.stringify_keys
+        content = if block_given?
+          @template_object.capture(&block)
+        else
+          nil
+        end
+        content_tag("s-choice", content, options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/choice_list.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class ChoiceList < Base
+      def render(&block)
+        options = @options.stringify_keys
+        add_default_name_and_id(options)
+        content = if block_given?
+          @template_object.capture(&block)
+        else
+          nil
+        end
+        content_tag("s-choice-list", content, options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/color_field.rb

@@ -0,0 +1,28 @@
+module PolarisForm
+  module Tag
+    class ColorField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] ||= validate_color_string(value)
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-color-field", options)
+      end
+
+      private
+
+      def validate_color_string(string)
+        regex = /#[0-9a-fA-F]{6}/
+        if regex.match?(string)
+          string.downcase
+        else
+          "#000000"
+        end
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/color_picker.rb

@@ -0,0 +1,24 @@
+module PolarisForm
+  module Tag
+    class ColorPicker < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] ||= validate_color_string(value)
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        add_default_name_and_id(options)
+        empty_content_tag("s-color-picker", options)
+      end
+
+      private
+
+      def validate_color_string(string)
+        regex = /#[0-9a-fA-F]{6}/
+        if regex.match?(string)
+          string.downcase
+        else
+          "#000000"
+        end
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/date_field.rb

@@ -0,0 +1,23 @@
+module PolarisForm
+  module Tag
+    class DateField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] ||= format_date(value)
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-date-field", options)
+      end
+
+      private
+
+      def format_date(value)
+        value&.strftime("%Y-%m-%d")
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/date_picker.rb

@@ -0,0 +1,19 @@
+module PolarisForm
+  module Tag
+    class DatePicker < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] ||= format_date(value)
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        add_default_name_and_id(options)
+        empty_content_tag("s-date-picker", options)
+      end
+
+      private
+
+      def format_date(value)
+        value&.strftime("%Y-%m-%d")
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/drop_zone.rb

@@ -0,0 +1,15 @@
+module PolarisForm
+  module Tag
+    class DropZone < Base
+      def render
+        options = @options.stringify_keys
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-drop-zone", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/email_field.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class EmailField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-email-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/money_field.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class MoneyField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-money-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/number_field.rb

@@ -0,0 +1,19 @@
+module PolarisForm
+  module Tag
+    class NumberField < Base
+      def render
+        options = @options.stringify_keys
+        if range = options.delete("in") || options.delete("within")
+          options.update("min" => range.min, "max" => range.max)
+        end
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-number-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/option.rb

@@ -0,0 +1,15 @@
+module PolarisForm
+  module Tag
+    class Option < Base
+      def render(&block)
+        options = @options.stringify_keys
+        content = if block_given?
+          @template_object.capture(&block)
+        else
+          nil
+        end
+        content_tag("s-option", content, options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/option_group.rb

@@ -0,0 +1,15 @@
+module PolarisForm
+  module Tag
+    class OptionGroup < Base
+      def render(&block)
+        options = @options.stringify_keys
+        content = if block_given?
+          @template_object.capture(&block)
+        else
+          nil
+        end
+        content_tag("s-option-group", content, options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/password_field.rb

@@ -0,0 +1,17 @@
+module PolarisForm
+  module Tag
+    class PasswordField < Base
+      def render
+        @options = { value: nil }.merge!(@options)
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-password-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/search_field.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class SearchField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-search-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/select.rb

@@ -0,0 +1,38 @@
+module PolarisForm
+  module Tag
+    class Select < Base
+      def initialize(object_name, method_name, template_object, choices, options, html_options)
+        @choices = block_given? ? template_object.capture { yield || "" } : choices
+        @choices = @choices.to_a if @choices.is_a?(Range)
+
+        @html_options = html_options
+
+        super(object_name, method_name, template_object, options)
+      end
+
+      def render
+        option_tags_options = {
+          selected: @options.fetch(:selected) { value.nil? ? "" : value },
+          disabled: @options[:disabled]
+        }
+
+        option_tags = if grouped_choices?
+          s_grouped_options_for_select(@choices, option_tags_options)
+        else
+          s_options_for_select(@choices, option_tags_options)
+        end
+
+        select_content_tag(option_tags, @options, @html_options)
+      end
+
+      private
+      # Grouped choices look like this:
+      #
+      #   [nil, []]
+      #   { nil => [] }
+      def grouped_choices?
+        !@choices.blank? && @choices.first.respond_to?(:second) && Array === @choices.first.second
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/switch.rb

@@ -0,0 +1,65 @@
+module PolarisForm
+  module Tag
+    class Switch < Base
+
+      include Checkable
+
+      def initialize(object_name, method_name, template_object, checked_value, unchecked_value, options)
+        @checked_value   = checked_value
+        @unchecked_value = unchecked_value
+        super(object_name, method_name, template_object, options)
+      end
+
+      def render
+        options = @options.stringify_keys
+        options["value"]    = @checked_value
+        options["checked"] = "checked" if input_checked?(options)
+
+        if options["multiple"]
+          add_default_name_and_id_for_value(@checked_value, options)
+          options.delete("multiple")
+        else
+          add_default_name_and_id(options)
+        end
+
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+
+        include_hidden = options.delete("include_hidden") { true }
+        checkbox = empty_content_tag("s-switch", options)
+
+        if include_hidden
+          hidden = hidden_field_for_checkbox(options)
+          hidden + checkbox
+        else
+          checkbox
+        end
+      end
+
+      private
+
+      def checked?(value)
+        case value
+        when TrueClass, FalseClass
+          value == !!@checked_value
+        when NilClass
+          false
+        when String
+          value == @checked_value
+        else
+          if value.respond_to?(:include?)
+            value.include?(@checked_value)
+          else
+            value.to_i == @checked_value.to_i
+          end
+        end
+      end
+
+      def hidden_field_for_checkbox(options)
+        @unchecked_value ? tag("input", options.slice("name", "disabled", "form").merge!("type" => "hidden", "value" => @unchecked_value, "autocomplete" => "off")) : "".html_safe
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/text_area.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class TextArea < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-text-area", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/text_field.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class TextField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-text-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/tag/url_field.rb

@@ -0,0 +1,16 @@
+module PolarisForm
+  module Tag
+    class UrlField < Base
+      def render
+        options = @options.stringify_keys
+        options["value"] = options.fetch("value") { value_before_type_cast }
+        if options["label"].blank?
+          options["label"] = " "
+          options["labelAccessibilityVisibility"] ||= "exclusive"
+        end
+        add_default_name_and_id(options)
+        empty_content_tag("s-url-field", options)
+      end
+    end
+  end
+end

data/lib/polaris_form/utils.rb

@@ -0,0 +1,15 @@
+module PolarisForm
+  module Utils
+    module_function
+
+    def camelize_polaris_options(options)
+      options.transform_keys do |key|
+        if key.to_s.in?([ "skip_default_ids", "allow_method_names_outside_object" ])
+          key
+        else
+          key.to_s.camelize(:lower).to_sym
+        end
+      end
+    end
+  end
+end

data/lib/polaris_form/version.rb

@@ -0,0 +1,3 @@
+module PolarisForm
+  VERSION = "0.1.0"
+end

data/lib/polaris_form.rb

@@ -0,0 +1,9 @@
+require "polaris_form/version"
+require "polaris_form/utils"
+require "polaris_form/helpers"
+require "polaris_form/builder"
+require "polaris_form/railtie"
+require "polaris_form/engine"
+
+module PolarisForm
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: polaris_form
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Hopper Gee
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-01-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: polaris_form brings Shopify's Polaris design system to Rails forms by
+  providing a drop-in form builder that outputs Polaris web components under the hood.
+email:
+- hopper.gee@hey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/config/polaris_form_manifest.js
+- config/routes.rb
+- lib/polaris_form.rb
+- lib/polaris_form/builder.rb
+- lib/polaris_form/engine.rb
+- lib/polaris_form/helpers.rb
+- lib/polaris_form/helpers/form_helper.rb
+- lib/polaris_form/helpers/form_options_helper.rb
+- lib/polaris_form/railtie.rb
+- lib/polaris_form/tag/base.rb
+- lib/polaris_form/tag/checkable.rb
+- lib/polaris_form/tag/checkbox.rb
+- lib/polaris_form/tag/choice.rb
+- lib/polaris_form/tag/choice_list.rb
+- lib/polaris_form/tag/color_field.rb
+- lib/polaris_form/tag/color_picker.rb
+- lib/polaris_form/tag/date_field.rb
+- lib/polaris_form/tag/date_picker.rb
+- lib/polaris_form/tag/drop_zone.rb
+- lib/polaris_form/tag/email_field.rb
+- lib/polaris_form/tag/money_field.rb
+- lib/polaris_form/tag/number_field.rb
+- lib/polaris_form/tag/option.rb
+- lib/polaris_form/tag/option_group.rb
+- lib/polaris_form/tag/password_field.rb
+- lib/polaris_form/tag/search_field.rb
+- lib/polaris_form/tag/select.rb
+- lib/polaris_form/tag/switch.rb
+- lib/polaris_form/tag/text_area.rb
+- lib/polaris_form/tag/text_field.rb
+- lib/polaris_form/tag/url_field.rb
+- lib/polaris_form/utils.rb
+- lib/polaris_form/version.rb
+homepage: https://github.com/hoppergee/polaris_form
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/hoppergee/polaris_form
+  source_code_uri: https://github.com/hoppergee/polaris_form
+  changelog_uri: https://github.com/hoppergee/polaris_form/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: A Rails form builder that renders forms using Shopify Polaris web components
+test_files: []