primer_view_components 0.0.83 → 0.0.86

data/lib/primer/forms/form_control.html.erb

@@ -0,0 +1,18 @@
+<%= content_tag(:div, style: "flex-grow: 1", **@form_group_arguments) do %>
+  <% if @input.label %>
+    <%= builder.label(@input.name, **@input.label_arguments) do %>
+      <%= @input.label %>
+      <% if @input.required? %>
+        <span aria-hidden="true">*</span>
+      <% end %>
+    <% end %>
+  <% end %>
+  <%= content %>
+  <% if @input.invalid? && @input.validation_messages.present? %>
+    <div class="FormControl-inlineValidation" id="<%= @input.validation_id %>">
+      <%= render(Primer::OcticonComponent.new(icon: :"alert-fill", size: :xsmall, aria: { hidden: true })) %>
+      <span><%= @input.validation_messages.first %></span>
+    </div>
+  <% end %>
+  <%= render(Caption.new(input: @input)) %>
+<% end %>

data/lib/primer/forms/form_control.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class FormControl < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_label_classes("FormControl-label")
+        @form_group_arguments = {
+          class: class_names(
+            "FormControl",
+            "FormControl--fullWidth" => @input.full_width?
+          )
+        }
+
+        @form_group_arguments[:hidden] = "hidden" if @input.hidden?
+      end
+    end
+  end
+end

data/lib/primer/forms/form_list.html.erb

@@ -0,0 +1,5 @@
+<%= render(SpacingWrapper.new) do %>
+  <% @forms.each do |form| %>
+    <%= render(form) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/form_list.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class FormList
+      extend ActsAsComponent
+
+      renders_template File.join(__dir__, "form_list.html.erb")
+
+      def initialize(*forms)
+        @forms = forms
+      end
+
+      def perform_render(&_block)
+        self.class.compile!
+        render_form_list
+      end
+    end
+  end
+end

data/lib/primer/forms/form_reference.html.erb

@@ -0,0 +1,3 @@
+<%= builder.fields_for(*@input.fields_for_args, **@input.fields_for_kwargs) do |fields| %>
+  <%= render(@input.ref_block.call(fields)) %>
+<% end %>

data/lib/primer/forms/form_reference.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class FormReference < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+      end
+    end
+  end
+end

data/lib/primer/forms/group.html.erb

@@ -0,0 +1,5 @@
+<%= content_tag_if(horizontal?, :div, class: "d-flex", style: "gap: 15px;") do %>
+  <% @inputs.each do |input| %>
+    <%= render(input) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/group.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "primer/classify"
+
+module Primer
+  module Forms
+    # :nodoc:
+    class Group < BaseComponent
+      VERTICAL = :vertical
+      HORIZONTAL = :horizontal
+      DEFAULT_LAYOUT = VERTICAL
+      LAYOUTS = [VERTICAL, HORIZONTAL].freeze
+
+      def initialize(inputs:, builder:, form:, layout: DEFAULT_LAYOUT, **system_arguments)
+        @inputs = inputs
+        @builder = builder
+        @form = form
+        @layout = layout
+        @system_arguments = system_arguments
+      end
+
+      def horizontal?
+        @layout == HORIZONTAL
+      end
+    end
+  end
+end

data/lib/primer/forms/hidden_field.html.erb

@@ -0,0 +1 @@
+<%= builder.hidden_field(@input.name, **@input.input_arguments) %>

data/lib/primer/forms/hidden_field.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class HiddenField < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_input_classes("FormField-input")
+      end
+    end
+  end
+end

data/lib/primer/forms/multi.html.erb

@@ -0,0 +1,3 @@
+<% @input.inputs.each do |child_input| %>
+  <%= render(child_input) %>
+<% end %>

data/lib/primer/forms/multi.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class Multi < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+      end
+    end
+  end
+end

data/lib/primer/forms/radio_button.html.erb

@@ -0,0 +1,14 @@
+<div class="FormControl-radio-wrap">
+  <%= builder.radio_button(@input.name, @input.value, **@input.input_arguments) %>
+  <span class="FormControl-radio-labelWrap">
+    <%= builder.label(@input.name, value: @input.value, **@input.label_arguments) do %>
+      <%= @input.label %>
+    <% end %>
+    <%= render(Caption.new(input: @input)) %>
+  </span>
+</div>
+<% if @input.nested_form_block %>
+  <%= content_tag(:div, nested_form_arguments) do %>
+    <%= render(@input.nested_form_block.call(builder)) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/radio_button.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class RadioButton < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_label_classes("FormControl-label")
+        @input.add_input_classes("FormControl-radio")
+      end
+
+      def nested_form_arguments
+        return @nested_form_arguments if defined?(@nested_form_arguments)
+
+        @nested_form_arguments = { **@input.nested_form_arguments }
+        @nested_form_arguments[:class] = class_names(
+          @nested_form_arguments[:class],
+          @nested_form_arguments.delete(:classes),
+          "ml-4"
+        )
+
+        @nested_form_arguments
+      end
+    end
+  end
+end

data/lib/primer/forms/radio_button_group.html.erb

@@ -0,0 +1,12 @@
+<fieldset>
+  <% if @input.label %>
+    <%= content_tag(:legend, **@input.label_arguments) do %>
+      <%= @input.label %>
+    <% end %>
+  <% end %>
+  <%= render(SpacingWrapper.new) do %>
+    <% @input.radio_buttons.each do |radio_button| %>
+      <%= render(radio_button.to_component) %>
+    <% end %>
+  <% end %>
+</fieldset>

data/lib/primer/forms/radio_button_group.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class RadioButtonGroup < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+      end
+    end
+  end
+end

data/lib/primer/forms/select_list.html.erb

@@ -0,0 +1,5 @@
+<%= render(FormControl.new(input: @input)) do %>
+  <%= content_tag(:div, class: @field_wrap_classes) do %>
+    <%= builder.select(@input.name, options, {}, **@input.input_arguments) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/select_list.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class SelectList < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_input_classes(
+          "FormControl-select",
+          "FormControl--medium"
+        )
+
+        @field_wrap_classes = class_names("FormControl-select-wrap")
+      end
+
+      def options
+        @options ||= @input.options.map do |option|
+          [option.label, option.value, option.system_arguments]
+        end
+      end
+    end
+  end
+end

data/lib/primer/forms/separator.html.erb

@@ -0,0 +1 @@
+<div class="border-top color-border-muted"></div>

data/lib/primer/forms/separator.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    class Separator < BaseComponent
+    end
+  end
+end

data/lib/primer/forms/spacing_wrapper.html.erb

@@ -0,0 +1,3 @@
+<div class="d-flex flex-column" style="row-gap: 15px">
+  <%= content %>
+</div>

data/lib/primer/forms/spacing_wrapper.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    class SpacingWrapper < BaseComponent
+    end
+  end
+end

data/lib/primer/forms/submit_button.html.erb

@@ -0,0 +1,4 @@
+<%= render(Primer::ButtonComponent.new(**input_arguments)) do |c| %>
+  <% @input.block.call(c) if @input.block %>
+  <%= @input.label %>
+<% end %>

data/lib/primer/forms/submit_button.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class SubmitButton < BaseComponent
+      # :nodoc:
+      module SubmitAttributeGenerator
+        extend ActionView::Helpers::FormTagHelper
+
+        class << self
+          alias submit_tag_attributes submit_tag
+
+          private
+
+          # FormTagHelper#submit_tag ultimately calls the #tag method. We return the options hash here instead
+          # of returning a string so it can be merged into the hash of options we pass to the Primer::ButtonComponent.
+          def tag(_name, options)
+            options
+          end
+        end
+      end
+
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_input_classes("FormField-input flex-self-start")
+        @input.merge_input_arguments!(
+          SubmitAttributeGenerator.submit_tag_attributes(input.label, name: input.name).deep_symbolize_keys
+        )
+
+        # rails uses a string for this, but PVC wants a symbol
+        @input.merge_input_arguments!(type: :submit)
+
+        # Never disable submit buttons. This overrides the global
+        # ActionView::Base.automatically_disable_submit_tag setting.
+        # Disabling the submit button is not accessible.
+        @input.remove_input_data(:disable_with)
+      end
+
+      def input_arguments
+        @input_arguments ||= @input.input_arguments.deep_dup.tap do |args|
+          # rails uses :class but PVC wants :classes
+          args[:classes] = args.delete(:class)
+        end
+      end
+    end
+  end
+end

data/lib/primer/forms/text_area.html.erb

@@ -0,0 +1,5 @@
+<%= render(FormControl.new(input: @input)) do %>
+  <%= content_tag(:div, class: @field_wrap_classes) do %>
+    <%= builder.text_area(@input.name, **@input.input_arguments) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/text_area.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class TextArea < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+        @input.add_input_classes("FormControl-input", "FormControl--medium")
+        @field_wrap_classes = class_names("FormControl-input-wrap")
+      end
+    end
+  end
+end

data/lib/primer/forms/text_field.html.erb

@@ -0,0 +1,19 @@
+<%= render(FormControl.new(input: @input)) do %>
+  <% if @input.leading_visual || @input.show_clear_button? %>
+    <%= content_tag(:div, class: @input.field_wrap_classes) do %>
+      <% if @input.leading_visual %>
+        <span class="FormControl-input-leadingVisualWrap">
+          <%= render(Primer::OcticonComponent.new(**@input.leading_visual)) %>
+        </span>
+      <% end %>
+      <%= builder.text_field(@input.name, **@input.input_arguments) %>
+      <% if @input.show_clear_button? %>
+        <button id="<%= @input.clear_button_id %>" class="FormControl-input-trailingAction" aria-label="Clear">
+          <%= render(Primer::OcticonComponent.new(icon: :"x-circle-fill")) %>
+        </button>
+      <% end %>
+    <% end %>
+  <% else %>
+    <%= builder.text_field(@input.name, **@input.input_arguments) %>
+  <% end %>
+<% end %>

data/lib/primer/forms/text_field.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Primer
+  module Forms
+    # :nodoc:
+    class TextField < BaseComponent
+      delegate :builder, :form, to: :@input
+
+      def initialize(input:)
+        @input = input
+      end
+    end
+  end
+end

data/lib/primer/view_components/engine.rb

@@ -8,6 +8,11 @@ module Primer
     # :nodoc:
     class Engine < ::Rails::Engine
       isolate_namespace Primer::ViewComponents
+
+      config.autoload_paths = %W[
+        #{root}/lib
+      ]
+
       config.eager_load_paths = %W[
         #{root}/app/components
         #{root}/app/lib
@@ -24,6 +29,24 @@ module Primer
         app.config.assets.precompile += %w[primer_view_components] if app.config.respond_to?(:assets)
       end
 
+      initializer "primer.forms.eager_load_actions" do
+        ActiveSupport.on_load(:after_initialize) do
+          if Rails.application.config.eager_load
+            Primer::Forms::Base.compile!
+            Primer::Forms::Base.descendants.each(&:compile!)
+            Primer::Forms::BaseComponent.descendants.each(&:compile!)
+          end
+        end
+      end
+
+      initializer "primer_view_components.zeitwerk_ignore" do
+        Rails.autoloaders.each do |autoloader|
+          autoloader.ignore(Engine.root.join("lib", "primer", "view_components", "linters.rb"))
+          autoloader.ignore(Engine.root.join("lib", "primer", "view_components", "linters", "**", "*.rb"))
+          autoloader.ignore(Engine.root.join("lib", "primer", "view_components", "statuses.rb"))
+        end
+      end
+
       config.after_initialize do |app|
         ::Primer::Classify::Utilities.validate_class_names = app.config.primer_view_components.delete(:validate_class_names)
       end

data/lib/primer/view_components/linters/argument_mappers/button.rb

@@ -20,12 +20,12 @@ module ERBLint
         ).freeze
 
         TYPE_OPTIONS = Primer::ViewComponents::Constants.get(
-          component: "Primer::BaseButton",
+          component: "Primer::Beta::BaseButton",
           constant: "TYPE_OPTIONS"
         ).freeze
 
         DEFAULT_TAG = Primer::ViewComponents::Constants.get(
-          component: "Primer::BaseButton",
+          component: "Primer::Beta::BaseButton",
           constant: "DEFAULT_TAG"
         ).freeze
 

data/lib/primer/view_components/linters/button_component_migration_counter.rb

@@ -11,7 +11,7 @@ module ERBLint
       include Autocorrectable
 
       TAGS = Primer::ViewComponents::Constants.get(
-        component: "Primer::BaseButton",
+        component: "Primer::Beta::BaseButton",
         constant: "TAG_OPTIONS"
       ).freeze
 

data/lib/primer/view_components/linters/helpers/deprecated_components_helpers.rb

@@ -7,7 +7,10 @@ module ERBLint
       module DeprecatedComponentsHelpers
         # If there is no alternative to suggest, set the value to nil
         COMPONENT_TO_USE_INSTEAD = {
+          "Primer::Alpha::AutoComplete::Item" => "Primer::Beta::AutoComplete::Item",
+          "Primer::Alpha::AutoComplete" => "Primer::Beta::AutoComplete",
           "Primer::BlankslateComponent" => "Primer::Beta::Blankslate",
+          "Primer::BorderBoxComponent" => "Primer::Beta::BorderBox",
           "Primer::DropdownMenuComponent" => nil,
           "Primer::Tooltip" => "Primer::Alpha::Tooltip",
           "Primer::FlexComponent" => nil,
@@ -29,14 +32,7 @@ module ERBLint
         end
 
         def deprecated_components
-          @deprecated_components ||= statuses_json.select { |_, value| value == "deprecated" }.keys.tap do |deprecated_components|
-            deprecated_components.each do |deprecated|
-              unless COMPONENT_TO_USE_INSTEAD.key?(deprecated)
-                raise "Please provide a component that should be used in place of #{deprecated} in COMPONENT_TO_USE_INSTEAD. "\
-                      "If there is no alternative, set the value to nil."
-              end
-            end
-          end
+          @deprecated_components ||= statuses_json.select { |_, value| value == "deprecated" }.keys
         end
       end
     end

data/lib/primer/view_components/version.rb

@@ -5,7 +5,7 @@ module Primer
     module VERSION
       MAJOR = 0
       MINOR = 0
-      PATCH = 83
+      PATCH = 86
 
       STRING = [MAJOR, MINOR, PATCH].join(".")
     end

data/lib/rubocop/cop/primer/component_name_migration.rb

@@ -15,6 +15,9 @@ module RuboCop
       # Primer::Beta::ComponentName.new()
       class ComponentNameMigration < BaseCop
         DEPRECATIONS = {
+          "Primer::BlankslateComponent" => "Primer::Beta::Blankslate",
+          "Primer::BorderBoxComponent" => "Primer::Beta::BorderBox",
+          "Primer::BaseButton" => "Primer::Beta::BaseButton",
           "Primer::TestComponent" => "Primer::Beta::Test"
         }.freeze
 

data/lib/tasks/deprecated.rake

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+namespace :deprecated do
+  task :check do
+    require_relative "./../primer/view_components/linters/helpers/deprecated_components_helpers"
+    require_relative "../primer/view_components/statuses"
+
+    puts "Checking that officially deprecated components are linted by `DeprecatedComponents` linter...."
+
+    if Primer::ViewComponents::STATUSES.select { |_, value| value == "deprecated" }.keys.sort != ERBLint::Linters::Helpers::DeprecatedComponentsHelpers::COMPONENT_TO_USE_INSTEAD.keys.sort
+      puts "\n**************************************************************************************************************************"
+      raise "Please make sure that components are officially deprecated by setting the `status :deprecated` within the component file.\n"\
+      "Run `bundle exec rake static:dump` so the deprecated status is reflected in `statuses.json`.\n"\
+      "Make sure to provide an alternative component for each deprecated component in `ERBLint::Linters::Helpers::DeprecatedComponentsHelpers::COMPONENT_TO_USE_INSTEAD`.\n"\
+      "If there is no alternative to suggest, set the value to nil."
+    end
+
+    puts "\n============================================================================="
+    puts "All good!"
+    puts "============================================================================="
+  end
+end

data/lib/tasks/docs.rake

@@ -31,7 +31,6 @@ namespace :docs do
     components = [
       Primer::Alpha::Layout,
       Primer::HellipButton,
-      Primer::Alpha::BorderBox::Header,
       Primer::Image,
       Primer::LocalTime,
       Primer::OcticonSymbolsComponent,
@@ -41,9 +40,10 @@ namespace :docs do
       Primer::Beta::AutoComplete::Item,
       Primer::Beta::Avatar,
       Primer::Beta::AvatarStack,
-      Primer::BaseButton,
+      Primer::Beta::BaseButton,
       Primer::Beta::Blankslate,
-      Primer::BorderBoxComponent,
+      Primer::Beta::BorderBox,
+      Primer::Beta::BorderBox::Header,
       Primer::BoxComponent,
       Primer::Beta::Breadcrumbs,
       Primer::ButtonComponent,
@@ -74,6 +74,7 @@ namespace :docs do
       Primer::SubheadComponent,
       Primer::TabContainerComponent,
       Primer::Beta::Text,
+      Primer::Alpha::TextField,
       Primer::TimeAgoComponent,
       Primer::TimelineItemComponent,
       Primer::Tooltip,
@@ -98,6 +99,7 @@ namespace :docs do
       Primer::Alpha::TabPanels,
       Primer::Alpha::Tooltip,
       Primer::ButtonComponent,
+      Primer::IconButton,
       Primer::LinkComponent
     ]
 
@@ -359,7 +361,7 @@ namespace :docs do
   task :preview do
     registry = generate_yard_registry
 
-    FileUtils.rm_rf("demo/test/components/previews/primer/docs/")
+    FileUtils.rm_rf("test/previews/primer/docs/")
 
     components = Primer::Component.descendants
 
@@ -373,7 +375,7 @@ namespace :docs do
 
       yard_example_tags = initialize_method.tags(:example)
 
-      path = Pathname.new("demo/test/components/previews/primer/docs/#{short_name.underscore}_preview.rb")
+      path = Pathname.new("test/previews/primer/docs/#{short_name.underscore}_preview.rb")
       path.dirname.mkdir unless path.dirname.exist?
 
       File.open(path, "w") do |f|
@@ -386,7 +388,7 @@ namespace :docs do
           method_name = name.split("|").first.downcase.parameterize.underscore
           f.puts("      def #{method_name}; end")
           f.puts unless index == yard_example_tags.size - 1
-          path = Pathname.new("demo/test/components/previews/primer/docs/#{short_name.underscore}_preview/#{method_name}.html.erb")
+          path = Pathname.new("test/previews/primer/docs/#{short_name.underscore}_preview/#{method_name}.html.erb")
           path.dirname.mkdir unless path.dirname.exist?
           File.open(path, "w") do |view_file|
             view_file.puts(code.to_s)