primer_view_components 0.0.43 → 0.0.44

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

data/static/statuses.json

@@ -1,10 +1,13 @@
 {
+  "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",
@@ -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.44
 platform: ruby
 authors:
 - GitHub Open Source
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-03 00:00:00.000000000 Z
+date: 2021-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -350,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
@@ -363,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
@@ -374,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
@@ -385,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
@@ -439,7 +446,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
@@ -470,6 +476,9 @@ files:
 - 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

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

data/app/components/primer/dropdown_component.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  # `Dropdown` is a lightweight context menu for housing navigation and actions.
-  # They're great for instances where you don't need the full power (and code) of the select menu.
-  class DropdownComponent < Primer::Component
-    # Required trigger for the dropdown. Only accepts a content.
-    # Its classes can be customized by the `summary_classes` param in the parent component
-    renders_one :button
-
-    # Required context menu for the dropdown
-    #
-    # @param direction [Symbol] <%= one_of(Primer::Dropdown::MenuComponent::DIRECTION_OPTIONS) %>
-    # @param scheme [Symbol] Pass `:dark` for dark mode theming
-    # @param header [String] Optional string to display as the header
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    renders_one :menu, Primer::Dropdown::MenuComponent
-
-    # @example Default
-    #   <div>
-    #     <%= render(Primer::DropdownComponent.new) do |c| %>
-    #       <% c.button do %>
-    #         Dropdown
-    #       <% end %>
-    #
-    #       <%= c.menu(header: "Options") do |menu|
-    #         menu.item { "Item 1" }
-    #         menu.item { "Item 2" }
-    #         menu.item(divider: true)
-    #         menu.item { "Item 3" }
-    #         menu.item { "Item 4" }
-    #       end %>
-    #     <% end %>
-    #   </div>
-    #
-    # @example With Direction
-    #   <div>
-    #     <%= render(Primer::DropdownComponent.new) do |c| %>
-    #       <% c.button do %>
-    #         Dropdown
-    #       <% end %>
-    #
-    #       <%= c.menu(header: "Options", direction: :s) do |menu|
-    #         menu.item { "Item 1" }
-    #         menu.item { "Item 2" }
-    #         menu.item(divider: true)
-    #         menu.item { "Item 3" }
-    #         menu.item { "Item 4" }
-    #       end %>
-    #     <% end %>
-    #   </div>
-    #
-    # @param overlay [Symbol] <%= one_of(Primer::DetailsComponent::OVERLAY_MAPPINGS.keys) %>
-    # @param reset [Boolean] Whether to hide the default caret on the button
-    # @param summary_classes [String] Custom classes to add to the button
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    def initialize(overlay: :default, reset: true, summary_classes: "", **system_arguments)
-      @system_arguments = system_arguments
-      @system_arguments[:overlay] = overlay
-      @system_arguments[:reset] = reset
-      @system_arguments[:position] = :relative
-      @system_arguments[:classes] = class_names(
-        @system_arguments[:classes],
-        "dropdown"
-      )
-      @summary_classes = summary_classes
-    end
-
-    def render?
-      button.present? && menu.present?
-    end
-  end
-end

data/app/components/primer/text_component.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Primer
-  # `Text` is a wrapper component that will apply typography styles to the text inside.
-  class TextComponent < Primer::Component
-    status :beta
-
-    DEFAULT_TAG = :span
-
-    # @example Default
-    #   <%= render(Primer::TextComponent.new(tag: :p, font_weight: :bold)) { "Bold Text" } %>
-    #   <%= render(Primer::TextComponent.new(tag: :p, color: :text_danger)) { "Danger Text" } %>
-    #
-    # @param tag [Symbol]
-    # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
-    def initialize(tag: DEFAULT_TAG, **system_arguments)
-      @system_arguments = system_arguments
-      @system_arguments[:tag] = tag
-    end
-
-    def call
-      render(Primer::BaseComponent.new(**@system_arguments)) { content }
-    end
-  end
-end