primer_view_components 0.0.39 → 0.0.44

data/lib/tasks/statuses.rake

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+namespace :statuses do
+  task :dump do
+    require File.expand_path("./../../demo/config/environment.rb", __dir__)
+    require "primer/view_components"
+    # Loads all components for `.descendants` to work properly
+    Dir["./app/components/primer/**/*.rb"].sort.each { |file| require file }
+
+    Primer::ViewComponents.dump_statuses
+  end
+end

data/lib/yard/docs_helper.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module YARD
+  # Helper methods to use for yard documentation
+  module DocsHelper
+    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
+          enumerable.map do |key, value|
+            "#{pretty_value(key)} (#{pretty_value(value)})"
+          end
+        else
+          enumerable.map do |key|
+            pretty_value(key)
+          end
+        end
+
+      prefix = "One of"
+      prefix = prefix.downcase if lower
+
+      "#{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
+
+    def link_to_typography_docs
+      "[Typography](/system-arguments#typography)"
+    end
+
+    def link_to_component(component)
+      short_name = component.name.gsub(/Primer|::|Component/, "")
+      "[#{short_name}](/components/#{short_name.downcase})"
+    end
+
+    def link_to_octicons
+      "[Octicon](https://primer.style/octicons/)"
+    end
+
+    def link_to_heading_practices
+      "[Learn more about best heading practices (WAI Headings)](https://www.w3.org/WAI/tutorials/page-structure/headings/)"
+    end
+
+    def pretty_value(val)
+      case val
+      when nil
+        "`nil`"
+      when Symbol
+        "`:#{val}`"
+      else
+        "`#{val}`"
+      end
+    end
+  end
+end

data/static/statuses.json

@@ -1 +1,56 @@
-{"Primer::AutoComplete":"beta","Primer::AutoComplete::Item":"beta","Primer::AvatarComponent":"beta","Primer::AvatarStackComponent":"beta","Primer::BaseButton":"beta","Primer::BaseComponent":"beta","Primer::BlankslateComponent":"beta","Primer::BorderBoxComponent":"beta","Primer::BoxComponent":"stable","Primer::BreadcrumbComponent":"beta","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::DropdownMenuComponent":"deprecated","Primer::FlashComponent":"beta","Primer::FlexComponent":"alpha","Primer::FlexItemComponent":"deprecated","Primer::HeadingComponent":"beta","Primer::HiddenTextExpander":"alpha","Primer::IconButton":"alpha","Primer::LabelComponent":"beta","Primer::LayoutComponent":"alpha","Primer::LinkComponent":"beta","Primer::MarkdownComponent":"alpha","Primer::MenuComponent":"alpha","Primer::Navigation::TabComponent":"alpha","Primer::OcticonComponent":"beta","Primer::PopoverComponent":"beta","Primer::ProgressBarComponent":"beta","Primer::SpinnerComponent":"beta","Primer::StateComponent":"beta","Primer::SubheadComponent":"beta","Primer::TabContainerComponent":"alpha","Primer::TabNavComponent":"alpha","Primer::TextComponent":"beta","Primer::TimeAgoComponent":"beta","Primer::TimelineItemComponent":"beta","Primer::TimelineItemComponent::BadgeComponent":"alpha","Primer::TooltipComponent":"alpha","Primer::Truncate":"beta","Primer::UnderlineNavComponent":"alpha"}
+{
+  "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::Text": "beta",
+  "Primer::BlankslateComponent": "beta",
+  "Primer::BorderBoxComponent": "beta",
+  "Primer::BoxComponent": "stable",
+  "Primer::BreadcrumbComponent": "beta",
+  "Primer::BreadcrumbComponent::ItemComponent": "alpha",
+  "Primer::ButtonComponent": "beta",
+  "Primer::ButtonGroup": "beta",
+  "Primer::ClipboardCopy": "alpha",
+  "Primer::CloseButton": "beta",
+  "Primer::CounterComponent": "beta",
+  "Primer::DetailsComponent": "beta",
+  "Primer::Dropdown": "alpha",
+  "Primer::Dropdown::Menu": "alpha",
+  "Primer::Dropdown::Menu::Item": "alpha",
+  "Primer::DropdownMenuComponent": "deprecated",
+  "Primer::FlashComponent": "beta",
+  "Primer::FlexComponent": "deprecated",
+  "Primer::FlexItemComponent": "deprecated",
+  "Primer::HeadingComponent": "beta",
+  "Primer::HiddenTextExpander": "alpha",
+  "Primer::IconButton": "beta",
+  "Primer::Image": "alpha",
+  "Primer::ImageCrop": "alpha",
+  "Primer::LabelComponent": "beta",
+  "Primer::LayoutComponent": "alpha",
+  "Primer::LinkComponent": "beta",
+  "Primer::LocalTime": "alpha",
+  "Primer::Markdown": "beta",
+  "Primer::MenuComponent": "alpha",
+  "Primer::Navigation::TabComponent": "alpha",
+  "Primer::OcticonComponent": "beta",
+  "Primer::OcticonSymbolsComponent": "alpha",
+  "Primer::PopoverComponent": "beta",
+  "Primer::ProgressBarComponent": "beta",
+  "Primer::SpinnerComponent": "beta",
+  "Primer::StateComponent": "beta",
+  "Primer::SubheadComponent": "beta",
+  "Primer::TabContainerComponent": "alpha",
+  "Primer::TabNavComponent": "beta",
+  "Primer::TimeAgoComponent": "beta",
+  "Primer::TimelineItemComponent": "beta",
+  "Primer::TimelineItemComponent::BadgeComponent": "alpha",
+  "Primer::Tooltip": "beta",
+  "Primer::Truncate": "beta",
+  "Primer::UnderlineNavComponent": "alpha"
+}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: primer_view_components
 version: !ruby/object:Gem::Version
-  version: 0.0.39
+  version: 0.0.44
 platform: ruby
 authors:
 - GitHub Open Source
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-29 00:00:00.000000000 Z
+date: 2021-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -86,6 +86,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.3
+- !ruby/object:Gem::Dependency
+  name: axe-core-api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
 - !ruby/object:Gem::Dependency
   name: benchmark-ips
   requirement: !ruby/object:Gem::Requirement
@@ -120,14 +134,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: '0.11'
+        version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: erb_lint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
@@ -322,6 +350,7 @@ files:
 - README.md
 - 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
@@ -335,6 +364,7 @@ files:
 - app/components/primer/avatar_stack_component.rb
 - app/components/primer/base_button.rb
 - app/components/primer/base_component.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
@@ -346,7 +376,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
@@ -357,10 +386,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
@@ -370,16 +405,29 @@ files:
 - app/components/primer/heading_component.rb
 - app/components/primer/hidden_text_expander.rb
 - app/components/primer/icon_button.rb
+- app/components/primer/image.rb
+- app/components/primer/image_crop.d.ts
+- app/components/primer/image_crop.html.erb
+- app/components/primer/image_crop.js
+- app/components/primer/image_crop.rb
+- app/components/primer/image_crop.ts
 - app/components/primer/label_component.rb
 - app/components/primer/layout_component.html.erb
 - app/components/primer/layout_component.rb
 - app/components/primer/link_component.rb
-- app/components/primer/markdown_component.rb
+- app/components/primer/local_time.d.ts
+- app/components/primer/local_time.js
+- app/components/primer/local_time.rb
+- app/components/primer/local_time.ts
+- app/components/primer/markdown.rb
 - app/components/primer/menu_component.html.erb
 - app/components/primer/menu_component.rb
 - app/components/primer/navigation/tab_component.html.erb
 - app/components/primer/navigation/tab_component.rb
+- app/components/primer/octicon_component.html.erb
 - app/components/primer/octicon_component.rb
+- app/components/primer/octicon_symbols_component.html.erb
+- app/components/primer/octicon_symbols_component.rb
 - app/components/primer/popover_component.html.erb
 - app/components/primer/popover_component.rb
 - app/components/primer/primer.d.ts
@@ -398,14 +446,13 @@ 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
 - app/components/primer/time_ago_component.ts
 - app/components/primer/timeline_item_component.html.erb
 - app/components/primer/timeline_item_component.rb
-- app/components/primer/tooltip_component.rb
+- app/components/primer/tooltip.rb
 - app/components/primer/truncate.rb
 - app/components/primer/underline_nav_component.html.erb
 - app/components/primer/underline_nav_component.rb
@@ -417,6 +464,7 @@ files:
 - 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
@@ -427,7 +475,18 @@ files:
 - app/lib/primer/view_helper.rb
 - 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/version.rb
+- lib/tasks/coverage.rake
+- lib/tasks/docs.rake
+- lib/tasks/statuses.rake
+- lib/yard/docs_helper.rb
 - lib/yard/renders_many_handler.rb
 - lib/yard/renders_one_handler.rb
 - static/statuses.json
@@ -451,7 +510,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: ViewComponents for the Primer Design System

data/app/components/primer/button_marketing_component.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  # Use `ButtonMarketing` for actions (e.g. in forms). Use links for destinations, or moving from one page to another.
-  class ButtonMarketingComponent < Primer::Component
-    DEFAULT_SCHEME = :default
-    SCHEME_MAPPINGS = {
-      DEFAULT_SCHEME => "",
-      :primary => "btn-primary-mktg",
-      :outline => "btn-outline-mktg",
-      :transparent => "btn-transparent"
-    }.freeze
-    SCHEME_OPTIONS = SCHEME_MAPPINGS.keys
-
-    DEFAULT_VARIANT = :default
-    VARIANT_MAPPINGS = {
-      DEFAULT_VARIANT => "",
-      :large => "btn-large-mktg"
-    }.freeze
-    VARIANT_OPTIONS = VARIANT_MAPPINGS.keys
-
-    DEFAULT_TAG = :button
-    TAG_OPTIONS = [DEFAULT_TAG, :a].freeze
-
-    DEFAULT_TYPE = :button
-    TYPE_OPTIONS = [DEFAULT_TYPE, :submit].freeze
-
-    # @example Schemes
-    #   <%= render(Primer::ButtonMarketingComponent.new(mr: 2)) { "Default" } %>
-    #   <%= render(Primer::ButtonMarketingComponent.new(scheme: :primary, mr: 2)) { "Primary" } %>
-    #   <%= render(Primer::ButtonMarketingComponent.new(scheme: :outline)) { "Outline" } %>
-    #   <div class="color-bg-canvas-inverse">
-    #     <%= render(Primer::ButtonMarketingComponent.new(scheme: :transparent)) { "Transparent" } %>
-    #   </div>
-    #
-    # @example Sizes
-    #   <%= render(Primer::ButtonMarketingComponent.new(mr: 2)) { "Default" } %>
-    #   <%= render(Primer::ButtonMarketingComponent.new(variant: :large)) { "Large" } %>
-    #
-    # @param scheme [Symbol] <%= one_of(Primer::ButtonMarketingComponent::SCHEME_OPTIONS) %>
-    # @param variant [Symbol] <%= one_of(Primer::ButtonMarketingComponent::VARIANT_OPTIONS) %>
-    # @param tag [Symbol] <%= one_of(Primer::ButtonMarketingComponent::TAG_OPTIONS) %>
-    # @param type [Symbol] <%= one_of(Primer::ButtonMarketingComponent::TYPE_OPTIONS) %>
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    def initialize(
-      scheme: DEFAULT_SCHEME,
-      variant: DEFAULT_VARIANT,
-      tag: DEFAULT_TAG,
-      type: DEFAULT_TYPE,
-      **system_arguments
-    )
-      @system_arguments = system_arguments
-      @system_arguments[:block] = false
-      @system_arguments[:tag] = fetch_or_fallback(TAG_OPTIONS, tag, DEFAULT_TAG)
-      @system_arguments[:type] = fetch_or_fallback(TYPE_OPTIONS, type, DEFAULT_TYPE)
-      @system_arguments[:classes] = class_names(
-        "btn-mktg",
-        SCHEME_MAPPINGS[fetch_or_fallback(SCHEME_OPTIONS, scheme, DEFAULT_SCHEME)],
-        VARIANT_MAPPINGS[fetch_or_fallback(VARIANT_OPTIONS, variant, DEFAULT_VARIANT)],
-        system_arguments[:classes]
-      )
-    end
-
-    def call
-      render(Primer::BaseButton.new(**@system_arguments)) { content }
-    end
-  end
-end

data/app/components/primer/dropdown/menu_component.html.erb

@@ -1,12 +0,0 @@
-<%= render Primer::BaseComponent.new(**@system_arguments) do %>
-  <% if @header.present? %>
-    <div class="dropdown-header">
-      <%= @header %>
-    </div>
-  <% end %>
-  <ul>
-    <% items.each do |item| %>
-      <%= item %>
-    <% end %>
-  </ul>
-<% end %>

data/app/components/primer/dropdown/menu_component.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  module Dropdown
-    # This component is part of `Dropdown` and should not be
-    # used as a standalone component.
-    class MenuComponent < Primer::Component
-      SCHEME_DEFAULT = :default
-      SCHEME_MAPPINGS = {
-        SCHEME_DEFAULT => "",
-        :dark => "dropdown-menu-dark"
-      }.freeze
-
-      DIRECTION_DEFAULT = :se
-      DIRECTION_OPTIONS = [DIRECTION_DEFAULT, :sw, :w, :e, :ne, :s].freeze
-
-      renders_many :items, lambda { |divider: false, **system_arguments|
-        system_arguments[:tag] = :li
-        system_arguments[:role] = :none if divider
-        system_arguments[:classes] = class_names(
-          system_arguments[:classes],
-          "dropdown-item" => !divider,
-          "dropdown-divider" => divider
-        )
-
-        Primer::BaseComponent.new(**system_arguments)
-      }
-
-      def initialize(direction: DIRECTION_DEFAULT, scheme: SCHEME_DEFAULT, header: nil, **system_arguments)
-        @header = header
-        @direction = direction
-        @system_arguments = system_arguments
-
-        @system_arguments[:tag] = "details-menu"
-        @system_arguments[:role] = "menu"
-
-        @system_arguments[:classes] = class_names(
-          @system_arguments[:classes],
-          "dropdown-menu",
-          "dropdown-menu-#{fetch_or_fallback(DIRECTION_OPTIONS, direction, DIRECTION_DEFAULT)}",
-          SCHEME_MAPPINGS[fetch_or_fallback(SCHEME_MAPPINGS.keys, scheme, SCHEME_DEFAULT)]
-        )
-      end
-    end
-  end
-end