primer_view_components 0.0.44 → 0.0.48

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

@@ -41,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,12 +1,12 @@
 {
   "Primer::Alpha::ButtonMarketing": "alpha",
-  "Primer::AutoComplete": "beta",
-  "Primer::AutoComplete::Input": "alpha",
-  "Primer::AutoComplete::Item": "beta",
-  "Primer::AvatarComponent": "beta",
   "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",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: primer_view_components
 version: !ruby/object:Gem::Version
-  version: 0.0.44
+  version: 0.0.48
 platform: ruby
 authors:
 - GitHub Open Source
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-06-10 00:00:00.000000000 Z
+date: 2021-07-21 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: []
@@ -351,19 +351,21 @@ files:
 - app/assets/javascripts/primer_view_components.js
 - app/assets/javascripts/primer_view_components.js.map
 - app/components/primer/alpha/button_marketing.rb
-- app/components/primer/auto_complete.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
@@ -457,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
@@ -473,6 +466,16 @@ 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
@@ -482,10 +485,16 @@ files:
 - 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/rubocop/config/default.yml
+- lib/rubocop/cop/primer.rb
+- lib/rubocop/cop/primer/no_tag_memoize.rb
+- lib/rubocop/cop/primer/system_argument_instead_of_class.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
@@ -495,7 +504,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -510,8 +519,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,156 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  # Use `AutoComplete` to provide a user with a list of selectable suggestions that appear when they type into the
-  # input field. This list is populated by server search results.
-  # @accessibility
-  #   Always set an accessible label to help the user interact with the component.
-  #
-  #   * Set the `label` slot to render a visible label. Alternatively, associate an existing visible text element
-  #   as a label by setting `aria-labelledby`.
-  #   * If you must use a non-visible label, set `:"aria-label"` on `AutoComplete` and Primer
-  #   will apply it to the correct elements. However, please note that a visible label should almost
-  #   always be used unless there is compelling reason not to. A placeholder is not a label.
-  class AutoComplete < Primer::Component
-    status :beta
-
-    # Optionally render a visible label. See <%= link_to_accessibility %>
-    #
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    renders_one :label, lambda { |**system_arguments|
-      system_arguments[:for] = @input_id
-      system_arguments[:tag] = :label
-      Primer::BaseComponent.new(**system_arguments)
-    }
-
-    # 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 { |**system_arguments|
-      aria_label = system_arguments[:"aria-label"] || system_arguments.dig(:aria, :label) || @aria_label
-      if aria_label.present?
-        system_arguments[:"aria-label"] = aria_label
-        system_arguments[:aria]&.delete(:label)
-      end
-
-      Input.new(id: @input_id, **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] = @list_id
-      system_arguments[:classes] = class_names(
-        "autocomplete-results",
-        system_arguments[:classes]
-      )
-
-      aria_label = system_arguments[:"aria-label"] || system_arguments.dig(:aria, :label) || @aria_label
-      system_arguments[:"aria-label"] = aria_label if aria_label.present?
-      system_arguments[:aria]&.delete(:label)
-
-      Primer::BaseComponent.new(**system_arguments)
-    }
-
-    # @example Default
-    #   <%= render(Primer::AutoComplete.new(src: "/auto_complete", input_id: "fruits-input-1", list_id: "fruits-popup-1", position: :relative)) do |c| %>
-    #     <% c.label(classes:"").with_content("Fruits") %>
-    #     <% c.input(type: :text) %>
-    #   <% end %>
-    #
-    # @example With `aria-label`
-    #   <%= render(Primer::AutoComplete.new("aria-label": "Fruits", src: "/auto_complete", input_id: "fruits-input-2", list_id: "fruits-popup-2", position: :relative)) do |c| %>
-    #     <% c.input(type: :text) %>
-    #   <% end %>
-    #
-    # @example With `aria-labelledby`
-    #   <%= render(Primer::HeadingComponent.new(tag: :h2, id: "search-1")) { "Search" } %>
-    #   <%= render(Primer::AutoComplete.new(src: "/auto_complete", input_id: "fruits-input-3", list_id: "fruits-popup-2", position: :relative)) do |c| %>
-    #     <% c.input("aria-labelledby": "search-1") %>
-    #   <% end %>
-    #
-    # @example With custom classes for the results
-    #   <%= render(Primer::AutoComplete.new(src: "/auto_complete", input_id: "fruits-input-4", list_id: "fruits-popup-3", position: :relative)) do |c| %>
-    #     <% c.label(classes:"").with_content("Fruits") %>
-    #     <% c.input(type: :text) %>
-    #     <% c.results(classes: "custom-class") do %>
-    #       <%= render(Primer::AutoComplete::Item.new(selected: true, value: "apple")) do |c| %>
-    #         Apple
-    #       <% end %>
-    #       <%= render(Primer::AutoComplete::Item.new(value: "orange")) do |c| %>
-    #         Orange
-    #       <% end %>
-    #     <% end %>
-    #   <% end %>
-    #
-    # @example With Icon
-    #   <%= render(Primer::AutoComplete.new(src: "/auto_complete", list_id: "fruits-popup-4", input_id: "fruits-input-4", position: :relative)) do |c| %>
-    #     <% c.label(classes:"").with_content("Fruits") %>
-    #     <% c.input(type: :text) %>
-    #     <% c.icon(icon: :search) %>
-    #   <% end %>
-    #
-    # @param src [String] The route to query.
-    # @param input_id [String] Id of the input element.
-    # @param list_id [String] Id of the list element.
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    def initialize(src:, list_id:, input_id:, **system_arguments)
-      @list_id = list_id
-      @input_id = input_id
-      @aria_label = system_arguments[:"aria-label"] || system_arguments.dig(:aria, :label)
-
-      system_arguments.delete(:"aria-label") && system_arguments[:aria]&.delete(:label)
-
-      @system_arguments = system_arguments
-      @system_arguments[:tag] = "auto-complete"
-      @system_arguments[:src] = src
-      @system_arguments[:for] = list_id
-    end
-
-    # add `results` without needing to explicitly call it in the view
-    def before_render
-      raise ArgumentError, "Missing `input` slot" if input.blank?
-      raise ArgumentError, "Accessible label is required." if label.blank? && input.missing_label?
-
-      results(classes: "") unless results
-    end
-
-    # This component is part of `Primer::AutoCompleteComponent` and should not be
-    # used as a standalone component.
-    class Input < Primer::Component
-      DEFAULT_TYPE = :text
-      TYPE_OPTIONS = [DEFAULT_TYPE, :search].freeze
-
-      # @param type [Symbol] <%= one_of(Primer::AutoComplete::Input::TYPE_OPTIONS) %>
-      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-      def initialize(type: DEFAULT_TYPE, **system_arguments)
-        @system_arguments = system_arguments
-        @system_arguments[:tag] = :input
-
-        @aria_label = system_arguments[:"aria-label"]
-        @aria_labelledby = system_arguments[:"aria-labelledby"] || system_arguments.dig(:aria, :labelledby)
-
-        @system_arguments[:type] = fetch_or_fallback(TYPE_OPTIONS, type, DEFAULT_TYPE)
-        @system_arguments[:classes] = class_names(
-          "form-control",
-          system_arguments[:classes]
-        )
-      end
-
-      def missing_label?
-        @aria_label.blank? && @aria_labelledby.blank?
-      end
-
-      def call
-        render(Primer::BaseComponent.new(**@system_arguments))
-      end
-    end
-  end
-end

data/app/components/primer/auto_complete/item.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  class AutoComplete
-    # Use `AutoCompleteItem` to list results of an auto-completed search.
-    class Item < Primer::Component
-      status :beta
-
-      # @example Default
-      #   <%= 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 %>
-      #
-      # @param value [String] Value of the item.
-      # @param selected [Boolean] Whether the item is selected.
-      # @param disabled [Boolean] Whether the item is disabled.
-      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-      def initialize(value:, selected: false, disabled: false, **system_arguments)
-        @system_arguments = system_arguments
-        @system_arguments[:tag] = :li
-        @system_arguments[:role] = :option
-        @system_arguments[:"data-autocomplete-value"] = value
-
-        @system_arguments[:"aria-selected"] = true if selected
-        @system_arguments[:"aria-disabled"] = true if disabled
-
-        @system_arguments[:classes] = class_names(
-          "autocomplete-item",
-          system_arguments[:classes],
-          "disabled" => disabled
-        )
-      end
-
-      def call
-        render(Primer::BaseComponent.new(**@system_arguments)) { content }
-      end
-    end
-  end
-end