primer_view_components 0.0.43 → 0.0.47

data/lib/tasks/utilities.rake

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+namespace :utilities do
+  task :build do
+    require "yaml"
+    require "json"
+    require File.expand_path("./../../demo/config/environment.rb", __dir__)
+
+    # Keys that are looked for to be included in the utilities.yml file
+    SUPPORTED_KEYS = %i[
+      anim
+      d
+      float
+      hide
+      m mt mr mb ml mx my
+      p pt pr pb pl px py
+      position
+      wb
+      v
+    ].freeze
+
+    # Replacements for some classnames that end up being a different argument key
+    REPLACEMENT_KEYS = {
+      "^anim" => "animation",
+      "^v-align" => "vertical_align",
+      "^d" => "display",
+      "^wb" => "word_break",
+      "^v" => "visibility"
+    }.freeze
+
+    BREAKPOINTS = [nil, "sm", "md", "lg", "xl"].freeze
+
+    css_data =
+      JSON.parse(
+        File.read(
+          File.join(
+            __FILE__.split("lib/tasks/utilities.rake")[0], "/node_modules/@primer/css/dist/stats/utilities.json"
+          )
+        )
+      )["selectors"]["values"]
+
+    output = {}
+
+    css_data.each do |selector|
+      selector.sub!(/^./, "")
+      # Next if selector has ancestors or sibling selectors
+      next if selector.match?(/[:><~\[\.]/)
+      next unless SUPPORTED_KEYS.any? { |key| selector.start_with?("#{key}-") }
+
+      # Dupe so we still have the selector at the end of slicing it up
+      classname = selector.dup
+      key = ""
+
+      # Look for a replacement key
+      REPLACEMENT_KEYS.each do |k, v|
+        next unless classname.match?(Regexp.new(k))
+
+        key = v
+        classname.sub!(Regexp.new(k + "-"), "")
+      end
+
+      # If we didn't find a replacement, grab the first text before hyphen
+      if classname == selector
+        key = classname.split("-").first
+        classname.sub!(/^[^-]+-/, "")
+      end
+
+      # Check if the next bit of the classname is a breakpoint
+      if classname.match?(/^(sm-|md-|lg-|xl-)/)
+        breakpoint = classname.split("-").first
+        classname.sub!(/^[^-]+-/, "")
+      end
+
+      # Change the rest from hypens to underscores
+      classname.sub!(/\-/, "_")
+
+      # convert padding/margin negative values ie n7 to -7
+      classname.sub!(/^n/, "-") if classname.match?(/^n[0-9]/)
+
+      key = key.to_sym
+
+      classname = if classname.match?(/\A[-+]?[0-9]+\z/)
+                    classname.to_i
+                  else
+                    classname.to_sym
+                  end
+
+      if output[key].nil?
+        output[key] = { classname => Array.new(5, nil) }
+      elsif output[key][classname].nil?
+        output[key][classname] = Array.new(5, nil)
+      end
+
+      output[key][classname][BREAKPOINTS.index(breakpoint)] = selector
+    end
+
+    output.transform_values! do |x|
+      x.transform_values { |y| y.reverse.drop_while(&:nil?).reverse }
+    end
+
+    File.open("lib/primer/classify/utilities.yml", "w") do |f|
+      f.puts YAML.dump(output)
+    end
+  end
+end

data/lib/yard/docs_helper.rb

@@ -3,7 +3,13 @@
 module YARD
   # Helper methods to use for yard documentation
   module DocsHelper
-    def one_of(enumerable, lower: false)
+    def one_of(enumerable, lower: false, sort: true)
+      # Sort the array if requested
+      if sort
+        compare = ->(a, b) { a.class == b.class ? a <=> b : a.class.to_s <=> b.class.to_s }
+        enumerable = enumerable.sort { |a, b| compare.call(a, b) }
+      end
+
       values =
         case enumerable
         when Hash
@@ -14,7 +20,7 @@ module YARD
           enumerable.map do |key|
             pretty_value(key)
           end
-          end
+        end
 
       prefix = "One of"
       prefix = prefix.downcase if lower
@@ -22,6 +28,10 @@ module YARD
       "#{prefix} #{values.to_sentence(last_word_connector: ', or ')}."
     end
 
+    def link_to_accessibility
+      "[Accessibility](#system-arguments)"
+    end
+
     def link_to_system_arguments_docs
       "[System arguments](/system-arguments)"
     end
@@ -31,7 +41,7 @@ module YARD
     end
 
     def link_to_component(component)
-      short_name = component.name.gsub(/Primer|::|Component/, "")
+      short_name = component.name.gsub(/Primer|::|Alpha|Beta|Component/, "")
       "[#{short_name}](/components/#{short_name.downcase})"
     end
 

data/static/statuses.json

@@ -1,10 +1,13 @@
 {
-  "Primer::AutoComplete": "beta",
-  "Primer::AutoComplete::Item": "beta",
-  "Primer::AvatarComponent": "beta",
+  "Primer::Alpha::ButtonMarketing": "alpha",
   "Primer::AvatarStackComponent": "beta",
   "Primer::BaseButton": "beta",
   "Primer::BaseComponent": "beta",
+  "Primer::Beta::AutoComplete": "beta",
+  "Primer::Beta::AutoComplete::Input": "alpha",
+  "Primer::Beta::AutoComplete::Item": "beta",
+  "Primer::Beta::Avatar": "beta",
+  "Primer::Beta::Text": "beta",
   "Primer::BlankslateComponent": "beta",
   "Primer::BorderBoxComponent": "beta",
   "Primer::BoxComponent": "stable",
@@ -12,13 +15,13 @@
   "Primer::BreadcrumbComponent::ItemComponent": "alpha",
   "Primer::ButtonComponent": "beta",
   "Primer::ButtonGroup": "beta",
-  "Primer::ButtonMarketingComponent": "alpha",
   "Primer::ClipboardCopy": "alpha",
   "Primer::CloseButton": "beta",
   "Primer::CounterComponent": "beta",
   "Primer::DetailsComponent": "beta",
-  "Primer::Dropdown::MenuComponent": "alpha",
-  "Primer::DropdownComponent": "alpha",
+  "Primer::Dropdown": "alpha",
+  "Primer::Dropdown::Menu": "alpha",
+  "Primer::Dropdown::Menu::Item": "alpha",
   "Primer::DropdownMenuComponent": "deprecated",
   "Primer::FlashComponent": "beta",
   "Primer::FlexComponent": "deprecated",
@@ -44,7 +47,6 @@
   "Primer::SubheadComponent": "beta",
   "Primer::TabContainerComponent": "alpha",
   "Primer::TabNavComponent": "beta",
-  "Primer::TextComponent": "beta",
   "Primer::TimeAgoComponent": "beta",
   "Primer::TimelineItemComponent": "beta",
   "Primer::TimelineItemComponent::BadgeComponent": "alpha",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: primer_view_components
 version: !ruby/object:Gem::Version
-  version: 0.0.43
+  version: 0.0.47
 platform: ruby
 authors:
 - GitHub Open Source
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-06-03 00:00:00.000000000 Z
+date: 2021-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -338,7 +338,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.25
-description: 
+description:
 email:
 - opensource+primer_view_components@github.com
 executables: []
@@ -350,19 +350,23 @@ files:
 - README.md
 - app/assets/javascripts/primer_view_components.js
 - app/assets/javascripts/primer_view_components.js.map
-- app/components/primer/auto_complete.rb
+- app/components/primer/alpha/button_marketing.rb
 - app/components/primer/auto_complete/auto_complete.d.ts
-- app/components/primer/auto_complete/auto_complete.html.erb
 - app/components/primer/auto_complete/auto_complete.js
-- app/components/primer/auto_complete/auto_complete.ts
 - app/components/primer/auto_complete/auto_component.d.ts
 - app/components/primer/auto_complete/auto_component.js
-- app/components/primer/auto_complete/item.rb
-- app/components/primer/avatar_component.rb
 - app/components/primer/avatar_stack_component.html.erb
 - app/components/primer/avatar_stack_component.rb
 - app/components/primer/base_button.rb
 - app/components/primer/base_component.rb
+- app/components/primer/beta/auto_complete.rb
+- app/components/primer/beta/auto_complete/auto_complete.d.ts
+- app/components/primer/beta/auto_complete/auto_complete.html.erb
+- app/components/primer/beta/auto_complete/auto_complete.js
+- app/components/primer/beta/auto_complete/auto_complete.ts
+- app/components/primer/beta/auto_complete/item.rb
+- app/components/primer/beta/avatar.rb
+- app/components/primer/beta/text.rb
 - app/components/primer/blankslate_component.html.erb
 - app/components/primer/blankslate_component.rb
 - app/components/primer/border_box_component.html.erb
@@ -374,7 +378,6 @@ files:
 - app/components/primer/button_component.rb
 - app/components/primer/button_group.html.erb
 - app/components/primer/button_group.rb
-- app/components/primer/button_marketing_component.rb
 - app/components/primer/clipboard_copy.html.erb
 - app/components/primer/clipboard_copy.rb
 - app/components/primer/clipboard_copy_component.d.ts
@@ -385,10 +388,16 @@ files:
 - app/components/primer/counter_component.rb
 - app/components/primer/details_component.html.erb
 - app/components/primer/details_component.rb
-- app/components/primer/dropdown/menu_component.html.erb
-- app/components/primer/dropdown/menu_component.rb
-- app/components/primer/dropdown_component.html.erb
-- app/components/primer/dropdown_component.rb
+- app/components/primer/dropdown.d.ts
+- app/components/primer/dropdown.html.erb
+- app/components/primer/dropdown.js
+- app/components/primer/dropdown.rb
+- app/components/primer/dropdown.ts
+- app/components/primer/dropdown/menu.d.ts
+- app/components/primer/dropdown/menu.html.erb
+- app/components/primer/dropdown/menu.js
+- app/components/primer/dropdown/menu.rb
+- app/components/primer/dropdown/menu.ts
 - app/components/primer/dropdown_menu_component.html.erb
 - app/components/primer/dropdown_menu_component.rb
 - app/components/primer/flash_component.html.erb
@@ -439,7 +448,6 @@ files:
 - app/components/primer/tab_container_component.ts
 - app/components/primer/tab_nav_component.html.erb
 - app/components/primer/tab_nav_component.rb
-- app/components/primer/text_component.rb
 - app/components/primer/time_ago_component.d.ts
 - app/components/primer/time_ago_component.js
 - app/components/primer/time_ago_component.rb
@@ -451,15 +459,6 @@ files:
 - app/components/primer/underline_nav_component.html.erb
 - app/components/primer/underline_nav_component.rb
 - app/lib/primer/class_name_helper.rb
-- app/lib/primer/classify.rb
-- app/lib/primer/classify/cache.rb
-- app/lib/primer/classify/flex.rb
-- app/lib/primer/classify/functional_background_colors.rb
-- app/lib/primer/classify/functional_border_colors.rb
-- app/lib/primer/classify/functional_colors.rb
-- app/lib/primer/classify/functional_text_colors.rb
-- app/lib/primer/classify/grid.rb
-- app/lib/primer/classify/spacing.rb
 - app/lib/primer/fetch_or_fallback_helper.rb
 - app/lib/primer/join_style_arguments_helper.rb
 - app/lib/primer/octicon/cache.rb
@@ -467,16 +466,31 @@ files:
 - app/lib/primer/tabbed_component_helper.rb
 - app/lib/primer/test_selector_helper.rb
 - app/lib/primer/view_helper.rb
+- lib/primer/classify.rb
+- lib/primer/classify/cache.rb
+- lib/primer/classify/flex.rb
+- lib/primer/classify/functional_background_colors.rb
+- lib/primer/classify/functional_border_colors.rb
+- lib/primer/classify/functional_colors.rb
+- lib/primer/classify/functional_text_colors.rb
+- lib/primer/classify/grid.rb
+- lib/primer/classify/utilities.rb
+- lib/primer/classify/utilities.yml
 - lib/primer/view_components.rb
 - lib/primer/view_components/engine.rb
 - lib/primer/view_components/linters.rb
+- lib/primer/view_components/linters/argument_mappers/button.rb
+- lib/primer/view_components/linters/argument_mappers/conversion_error.rb
+- lib/primer/view_components/linters/argument_mappers/system_arguments.rb
 - lib/primer/view_components/linters/button_component_migration_counter.rb
 - lib/primer/view_components/linters/flash_component_migration_counter.rb
 - lib/primer/view_components/linters/helpers.rb
+- lib/primer/view_components/statuses.rb
 - lib/primer/view_components/version.rb
 - lib/tasks/coverage.rake
 - lib/tasks/docs.rake
 - lib/tasks/statuses.rake
+- lib/tasks/utilities.rake
 - lib/yard/docs_helper.rb
 - lib/yard/renders_many_handler.rb
 - lib/yard/renders_one_handler.rb
@@ -486,7 +500,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -501,8 +515,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: ViewComponents for the Primer Design System
 test_files: []

data/app/components/primer/auto_complete.rb

@@ -1,100 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  # Use `AutoComplete` to populate input values from server search results.
-  # @accessibility
-  #   Always provide a label for the `Autocomplete` component.
-  class AutoComplete < Primer::Component
-    status :beta
-
-    DEFAULT_INPUT_TYPE = :text
-    INPUT_TYPE_OPTIONS = [DEFAULT_INPUT_TYPE, :search].freeze
-
-    # Required input used to search for results
-    #
-    # @param type [Symbol] <%= one_of(Primer::AutoComplete::INPUT_TYPE_OPTIONS) %>
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    renders_one :input, lambda { |type: DEFAULT_INPUT_TYPE, classes: "form-control", **system_arguments|
-      system_arguments[:tag] = :input
-      system_arguments[:type] = fetch_or_fallback(INPUT_TYPE_OPTIONS, type, DEFAULT_INPUT_TYPE)
-      system_arguments[:classes] = classes
-      Primer::BaseComponent.new(**system_arguments)
-    }
-
-    # Optional icon to be rendered before the input. Has the same arguments as <%= link_to_component(Primer::OcticonComponent) %>.
-    renders_one :icon, Primer::OcticonComponent
-
-    # Customizable results list.
-    #
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    renders_one :results, lambda { |**system_arguments|
-      system_arguments[:tag] = :ul
-      system_arguments[:id] = @id
-      system_arguments[:classes] = class_names(
-        "autocomplete-results",
-        system_arguments[:classes]
-      )
-
-      Primer::BaseComponent.new(**system_arguments)
-    }
-
-    # @example Default
-    #   <%= render(Primer::AutoComplete.new(src: "/users/search", id: "user-popup", position: :relative)) do |c| %>
-    #     <% c.input(type: :text, name: "input") %>
-    #     <% c.results do %>
-    #       <%= render(Primer::AutoComplete::Item.new(selected: true, value: "value")) do |c| %>
-    #         Selected
-    #       <% end %>
-    #       <%= render(Primer::AutoComplete::Item.new(value: "value")) do |c| %>
-    #         Not selected
-    #       <% end %>
-    #     <% end %>
-    #   <% end %>
-    #
-    # @example With custom classes for the results
-    #   <%= render(Primer::AutoComplete.new(src: "/users/search", id: "user-popup", position: :relative)) do |c| %>
-    #     <% c.input(type: :text, name: "input") %>
-    #     <% c.results(classes: "custom-class") do %>
-    #       <%= render(Primer::AutoComplete::Item.new(selected: true, value: "value")) do |c| %>
-    #         Selected
-    #       <% end %>
-    #       <%= render(Primer::AutoComplete::Item.new(value: "value")) do |c| %>
-    #         Not selected
-    #       <% end %>
-    #     <% end %>
-    #   <% end %>
-    #
-    # @example With Icon
-    #   <%= render(Primer::AutoComplete.new(src: "/users/search", id: "user-popup", position: :relative)) do |c| %>
-    #     <% c.input(type: :text, name: "input") %>
-    #     <% c.icon(icon: :search) %>
-    #     <% c.results do %>
-    #       <%= render(Primer::AutoComplete::Item.new(selected: true, value: "value")) do |c| %>
-    #         Selected
-    #       <% end %>
-    #       <%= render(Primer::AutoComplete::Item.new(value: "value")) do |c| %>
-    #         Not selected
-    #       <% end %>
-    #     <% end %>
-    #   <% end %>
-    #
-    # @param src [String] The route to query.
-    # @param id [String] Id of the list element.
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    def initialize(src:, id:, **system_arguments)
-      @id = id
-
-      @system_arguments = system_arguments
-      @system_arguments[:tag] = "auto-complete"
-      @system_arguments[:src] = src
-      @system_arguments[:for] = id
-    end
-
-    # add `results` without needing to explicitly call it in the view
-    def before_render
-      raise ArgumentError, "Missing `input` slot" if input.blank?
-
-      results(classes: "") unless results
-    end
-  end
-end