primer_view_components 0.5.1 → 0.7.0

data/lib/primer/view_components/linters/migrations/truncate_component.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Migrations
+      # Lint & autocorrect Truncate components
+      class TruncateComponent < RuboCop::Cop::Cop
+        INVALID_MESSAGE = <<~STR
+          `Primer::Truncate` is deprecated. Please use `Primer::Beta::Truncate` instead!
+        STR
+
+        def_node_matcher :truncate_component, <<~PATTERN
+          (send (const (const nil? :Primer) :Truncate) :new ...)
+        PATTERN
+
+        def_node_matcher :hash_with_inline_value?, <<~PATTERN
+          (hash ... (pair (sym :inline) (...)) ... )
+        PATTERN
+
+        def_node_matcher :truncate_with_tag?, <<~PATTERN
+          (hash ... (pair (sym :tag) (...)) ... )
+        PATTERN
+
+        def on_send(node)
+          return unless truncate_component(node)
+
+          add_offense(node, message: INVALID_MESSAGE)
+        end
+
+        def autocorrect(node)
+          return if hash_with_inline_value?(node.arguments.first)
+
+          lambda do |corrector|
+            if node.arguments.first.nil? == false
+              corrector.replace(node.children.first, "Primer::Beta::Truncate")
+              corrector.insert_after(node.arguments.first, ", tag: :div") unless truncate_with_tag?(node.arguments.first)
+            else
+              corrector.replace(node.loc.expression, "Primer::Beta::Truncate.new(tag: :div)")
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,7 +10,7 @@ module ERBLint
           include LinterRegistry
           include Helpers::RuleHelpers
 
-          MIGRATE_TO_NEWER_TOOLTIP = ".tooltipped has been deprecated. There are major accessibility concerns with using this tooltip so please take action. See https://github.com/primer/view_components/blob/main/docs/content/guides/accessibility/tooltipped_migration.md."
+          MIGRATE_TO_NEWER_TOOLTIP = ".tooltipped has been deprecated. There are major accessibility concerns with using this tooltip so please take action. See https://primer.style/design/guides/development/rails/migration-guides/primer-css-tooltipped."
           TOOLTIPPED_RUBY_PATTERN = /classes:.*tooltipped|class:.*tooltipped/.freeze
 
           def run(processed_source)

data/lib/primer/view_components/linters.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
 
 Dir[File.join(__dir__, "linters", "*.rb")].sort.each { |file| require file }
+Dir[File.join(__dir__, "linters", "migrations", "*.rb")].sort.each { |file| require file }

data/lib/primer/view_components/version.rb

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

data/lib/primer/yard/lookbook_pages_backend.rb

@@ -176,6 +176,7 @@ module Primer
         each_component do |component_ref|
           page_for(component_ref).generate
         end
+        generate_system_args_docs
       end
 
       def page_for(component_ref)
@@ -194,6 +195,36 @@ module Primer
       def each_component(&block)
         manifest.each(&block)
       end
+
+      def generate_system_args_docs
+        docs = registry.find(Primer::BaseComponent)
+
+        path = File.expand_path(
+          File.join(
+            *%w[.. .. .. previews pages system-arguments.md.erb]
+          ), __dir__
+        )
+
+        data = {
+          "description_md" => docs.base_docstring.to_s,
+          "args_md" => view_context.render(inline: docs.constructor.base_docstring)
+        }
+
+        frontmatter = {
+          "title" => "System arguments",
+          "id" => "system_arguments",
+          "data" => data
+        }
+
+        File.write(
+          path, <<~ERB
+            #{YAML.dump(frontmatter)}
+            ---
+            <%= @page.data[:description_md] %>
+            <%= @page.data[:args_md] %>
+          ERB
+        )
+      end
     end
   end
 end

data/lib/primer/yard.rb

@@ -5,15 +5,14 @@ require "yard"
 module Primer
   # :nodoc:
   module Yard
-    autoload :Backend,              "primer/yard/backend"
-    autoload :ComponentManifest,    "primer/yard/component_manifest"
-    autoload :ComponentRef,         "primer/yard/component_ref"
-    autoload :DocsHelper,           "primer/yard/docs_helper"
-    autoload :InfoArchDocsHelper,   "primer/yard/info_arch_docs_helper"
-    autoload :LegacyGatsbyBackend,  "primer/yard/legacy_gatsby_backend"
-    autoload :Registry,             "primer/yard/registry"
-    autoload :RendersManyHandler,   "primer/yard/renders_many_handler"
-    autoload :RendersOneHandler,    "primer/yard/renders_one_handler"
+    autoload :Backend,            "primer/yard/backend"
+    autoload :ComponentManifest,  "primer/yard/component_manifest"
+    autoload :ComponentRef,       "primer/yard/component_ref"
+    autoload :DocsHelper,         "primer/yard/docs_helper"
+    autoload :InfoArchDocsHelper, "primer/yard/info_arch_docs_helper"
+    autoload :Registry,           "primer/yard/registry"
+    autoload :RendersManyHandler, "primer/yard/renders_many_handler"
+    autoload :RendersOneHandler,  "primer/yard/renders_one_handler"
 
     ::YARD::Tags::Library.define_tag("Snapshot preview", :snapshot)
   end

data/lib/tasks/custom_utilities.yml

@@ -51,6 +51,8 @@
 :text_transform:
   :uppercase:
   - text-uppercase
+  :capitalize:
+  - text-capitalize
 :text_align:
   :right:
   - text-right

data/previews/primer/alpha/action_list_preview.rb

@@ -100,11 +100,13 @@ module Primer
         scheme: Primer::Alpha::ActionList::DEFAULT_SCHEME,
         show_dividers: false
       )
-        render(Primer::Alpha::ActionList.new(
-          role: role,
-          scheme: scheme,
-          show_dividers: show_dividers
-        )) do |component|
+        render(
+          Primer::Alpha::ActionList.new(
+            role: role,
+            scheme: scheme,
+            show_dividers: show_dividers
+          )
+        ) do |component|
           component.with_heading(title: "Action List")
           component.with_item(label: "Item one", href: "/") do |item|
             item.with_leading_visual_icon(icon: :gear)
@@ -145,9 +147,11 @@ module Primer
         list_id: "unique-id",
         subtitle: "This is a subtitle"
       )
-        render(Primer::Alpha::ActionList::Heading.new(
-          scheme: scheme, list_id: list_id, title: title, subtitle: subtitle
-        ))
+        render(
+          Primer::Alpha::ActionList::Heading.new(
+            scheme: scheme, list_id: list_id, title: title, subtitle: subtitle
+          )
+        )
       end
 
       # @label Item [playground]
@@ -162,7 +166,6 @@ module Primer
       # @param description_scheme [Symbol] select [inline, block]
       # @param active toggle
       # @param leading_visual_icon [Symbol] octicon
-      # @param leading_visual_avatar_src text
       # @param trailing_visual_icon [Symbol] octicon
       # @param trailing_visual_label text
       # @param trailing_visual_counter number
@@ -183,7 +186,6 @@ module Primer
         active: false,
         expanded: false,
         leading_visual_icon: nil,
-        leading_visual_avatar_src: nil,
         trailing_visual_icon: nil,
         trailing_visual_label: nil,
         trailing_visual_counter: nil,
@@ -206,11 +208,7 @@ module Primer
           expanded: expanded,
           id: "tooltip-test"
         ) do |item|
-          if leading_visual_icon && leading_visual_icon != :none
-            item.with_leading_visual_icon(icon: leading_visual_icon)
-          elsif leading_visual_avatar_src
-            item.with_leading_visual_avatar(src: leading_visual_avatar_src, alt: "An avatar")
-          end
+          item.with_leading_visual_icon(icon: leading_visual_icon) if leading_visual_icon && leading_visual_icon != :none
 
           if trailing_visual_icon && trailing_visual_icon != :none
             item.with_trailing_visual_icon(icon: trailing_visual_icon)
@@ -224,13 +222,87 @@ module Primer
 
           if private_leading_action_icon && private_leading_action_icon != :none
             item.with_private_leading_action_icon(icon: private_leading_action_icon)
-          elsif private_trailing_action_icon
+          elsif private_trailing_action_icon && private_trailing_action_icon != :none
             item.with_private_trailing_action_icon(icon: private_trailing_action_icon)
           end
 
           item.with_trailing_action(icon: "plus", "aria-label": "Button tooltip", size: :medium) if trailing_action && trailing_action != :none
 
-          item.description { description } if description
+          item.with_description { description } if description
+
+          item.with_tooltip(text: "Tooltip text", for_id: "tooltip-test", type: :description) if tooltip
+        end
+
+        render(list)
+      end
+
+      # @label Avatar item [playground]
+      #
+      # @param username text
+      # @param truncate_label toggle
+      # @param src text
+      # @param shape [Symbol] select [circle, square]
+      # @param size [Symbol] select [medium, large, xlarge]
+      # @param scheme [Symbol] select [default, danger]
+      # @param disabled toggle
+      # @param full_name text
+      # @param full_name_scheme [Symbol] select [inline, block]
+      # @param active toggle
+      # @param trailing_visual_icon [Symbol] octicon
+      # @param trailing_visual_label text
+      # @param trailing_visual_counter number
+      # @param trailing_visual_text text
+      # @param private_trailing_action_icon [Symbol] octicon
+      # @param trailing_action toggle
+      # @param tooltip toggle
+      def avatar_item(
+        username: "hulk_smash",
+        truncate_label: false,
+        src: "https://avatars.githubusercontent.com/u/103004183?v=4",
+        shape: Primer::Beta::Avatar::DEFAULT_SHAPE,
+        size: Primer::Alpha::ActionList::Item::DEFAULT_SIZE,
+        scheme: Primer::Alpha::ActionList::Item::DEFAULT_SCHEME,
+        disabled: false,
+        full_name: "Bruce Banner",
+        full_name_scheme: Primer::Alpha::ActionList::Item::DEFAULT_DESCRIPTION_SCHEME,
+        active: false,
+        expanded: false,
+        trailing_visual_icon: nil,
+        trailing_visual_label: nil,
+        trailing_visual_counter: nil,
+        trailing_visual_text: nil,
+        private_trailing_action_icon: nil,
+        trailing_action: false,
+        tooltip: false
+      )
+        list = Primer::Alpha::ActionList.new(aria: { label: "Action List" })
+        list.with_avatar_item(
+          username: username,
+          truncate_label: truncate_label,
+          src: src,
+          size: size,
+          scheme: scheme,
+          disabled: disabled,
+          full_name: full_name,
+          full_name_scheme: full_name_scheme,
+          active: active,
+          expanded: expanded,
+          id: "tooltip-test",
+          avatar_arguments: { shape: shape }
+        ) do |item|
+          if trailing_visual_icon && trailing_visual_icon != :none
+            item.with_trailing_visual_icon(icon: trailing_visual_icon)
+          elsif trailing_visual_label
+            item.with_trailing_visual_label { trailing_visual_label }
+          elsif trailing_visual_counter
+            item.with_trailing_visual_counter(count: trailing_visual_counter)
+          elsif trailing_visual_text
+            item.with_trailing_visual_text(trailing_visual_text)
+          end
+
+          item.with_private_trailing_action_icon(icon: private_trailing_action_icon) if private_trailing_action_icon && private_trailing_action_icon != :none
+
+          item.with_trailing_action(icon: "plus", "aria-label": "Button tooltip", size: :medium) if trailing_action && trailing_action != :none
 
           item.with_tooltip(text: "Tooltip text", for_id: "tooltip-test", type: :description) if tooltip
         end

data/previews/primer/alpha/action_menu_preview.rb

@@ -27,15 +27,18 @@ module Primer
 
       # @label Content labels
       #
-      def content_labels
-      end
+      def content_labels; end
 
       # @label Default
       #
       # @snapshot interactive
       def default
         render(Primer::Alpha::ActionMenu.new(menu_id: "menu-1")) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
+
           menu.with_item(label: "Copy link")
           menu.with_item(label: "Quote reply")
           menu.with_item(label: "Reference in new issue")
@@ -54,7 +57,10 @@ module Primer
       # @snapshot interactive
       def wide
         render(Primer::Alpha::ActionMenu.new(select_variant: :single, size: :medium)) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "A wider menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "A wider menu"
+          end
 
           menu.with_item(label: "Default", active: true, value: "default") do |item|
             item.with_trailing_visual_label(scheme: :accent, inline: true).with_content("Recommended")
@@ -93,18 +99,30 @@ module Primer
       def multiple_select
         render(Primer::Alpha::ActionMenu.new(select_variant: :multiple)) do |menu|
           menu.with_show_button { "Menu" }
-          menu.with_item(label: "langermank", description_scheme: :inline) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/18661030?v=4", alt: "Katie Langerman")
-            item.with_description.with_content("Katie Langerman")
-          end
-          menu.with_item(label: "jonrohan", description_scheme: :inline) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/54012?s=96&v=4", alt: "Jon Rohan")
-            item.with_description.with_content("Jon Rohan")
-          end
-          menu.with_item(label: "broccolinisoup", description_scheme: :inline) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/1446503?v=4", alt: "Armağan Ersöz")
-            item.with_description.with_content("Armağan Ersöz")
-          end
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/18661030?v=4",
+            username: "langermank",
+            full_name: "Katie Langerman",
+            full_name_scheme: :inline,
+            avatar_arguments: { shape: :square }
+          )
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/54012?s=96&v=4",
+            username: "jonrohan",
+            full_name: "Jon Rohan",
+            full_name_scheme: :inline,
+            avatar_arguments: { shape: :square }
+          )
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/1446503?v=4",
+            username: "broccolinisoup",
+            full_name: "Armağan Ersöz",
+            full_name_scheme: :inline,
+            avatar_arguments: { shape: :square }
+          )
         end
       end
 
@@ -136,7 +154,10 @@ module Primer
       # @snapshot interactive
       def single_select_with_internal_label
         render(Primer::Alpha::ActionMenu.new(select_variant: :single, dynamic_label: true, dynamic_label_prefix: "Menu")) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
           menu.with_item(label: "Copy link") do |item|
             item.with_trailing_visual_label(scheme: :accent, inline: true).with_content("Recommended")
           end
@@ -151,18 +172,29 @@ module Primer
       def multiple_selected_items
         render(Primer::Alpha::ActionMenu.new(select_variant: :multiple)) do |menu|
           menu.with_show_button { "Menu" }
-          menu.with_item(label: "langermank", description_scheme: :inline, active: true) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/18661030?v=4", alt: "Katie Langerman")
-            item.with_description.with_content("Katie Langerman")
-          end
-          menu.with_item(label: "jonrohan", description_scheme: :inline) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/54012?s=96&v=4", alt: "Jon Rohan")
-            item.with_description.with_content("Jon Rohan")
-          end
-          menu.with_item(label: "broccolinisoup", description_scheme: :inline, active: true) do |item|
-            item.with_leading_visual_avatar(src: "https://avatars.githubusercontent.com/u/1446503?v=4", alt: "Armağan Ersöz")
-            item.with_description.with_content("Armağan Ersöz")
-          end
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/18661030?v=4",
+            username: "langermank",
+            full_name: "Katie Langerman",
+            full_name_scheme: :inline,
+            active: true
+          )
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/54012?s=96&v=4",
+            username: "jonrohan",
+            full_name: "Jon Rohan",
+            full_name_scheme: :inline
+          )
+
+          menu.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/1446503?v=4",
+            username: "broccolinisoup",
+            full_name: "Armağan Ersöz",
+            full_name_scheme: :inline,
+            active: true
+          )
         end
       end
 
@@ -184,8 +216,7 @@ module Primer
 
       # @label With actions
       #
-      def with_actions
-      end
+      def with_actions; end
 
       # @label Single select form
       #
@@ -229,7 +260,10 @@ module Primer
       #
       def block_description
         render(Primer::Alpha::ActionMenu.new(menu_id: "menu-1")) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
           menu.with_item(label: "Item label") do |item|
             item.with_description.with_content("Block description")
           end
@@ -246,7 +280,10 @@ module Primer
       #
       def inline_description
         render(Primer::Alpha::ActionMenu.new(menu_id: "menu-1")) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
           menu.with_item(label: "Item label", description_scheme: :inline) do |item|
             item.with_description.with_content("Inline description")
           end
@@ -257,7 +294,10 @@ module Primer
       #
       def leading_visual
         render(Primer::Alpha::ActionMenu.new(menu_id: "menu-1")) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
           menu.with_item(label: "Item label", description_scheme: :inline) do |item|
             item.with_leading_visual_icon(icon: :gear)
             item.with_description.with_content("Inline description")
@@ -269,7 +309,10 @@ module Primer
       #
       def leading_visual_single_select
         render(Primer::Alpha::ActionMenu.new(menu_id: "menu-1", select_variant: :single)) do |menu|
-          menu.with_show_button { |button| button.with_trailing_action_icon(icon: :"triangle-down"); "Menu" }
+          menu.with_show_button do |button|
+            button.with_trailing_action_icon(icon: :"triangle-down")
+            "Menu"
+          end
           menu.with_item(label: "Item label", description_scheme: :inline) do |item|
             item.with_leading_visual_icon(icon: :gear)
             item.with_description.with_content("Inline description")
@@ -279,8 +322,7 @@ module Primer
 
       # @label Two menus
       #
-      def two_menus
-      end
+      def two_menus; end
     end
   end
 end

data/previews/primer/alpha/banner_preview/with_action_button.html.erb

@@ -1,4 +1,4 @@
-<%= render(Primer::Alpha::Banner.new(full: full, dismissible: dismissible, icon: icon, scheme: scheme, reappear: reappear)) do |component| %>
+<%= render(Primer::Alpha::Banner.new(full: full, dismiss_scheme: dismiss_scheme, icon: icon, scheme: scheme)) do |component| %>
   <% component.with_action_button(size: :medium) { "Take action" } %>
   <%= content %>
 <% end %>

data/previews/primer/alpha/banner_preview/with_action_content.html.erb

@@ -1,4 +1,4 @@
-<%= render(Primer::Alpha::Banner.new(full: full, dismissible: dismissible, icon: icon, scheme: scheme, reappear: reappear)) do |component| %>
+<%= render(Primer::Alpha::Banner.new(full: full, dismiss_scheme: dismiss_scheme, icon: icon, scheme: scheme)) do |component| %>
   <% component.with_action_content do %>
     <%= render(Primer::Beta::IconButton.new(icon: :pencil, mr: 1, "aria-label": "Edit")) %>
   <% end %>

data/previews/primer/alpha/banner_preview.rb

@@ -8,15 +8,14 @@ module Primer
       #
       # @param full toggle
       # @param full_when_narrow toggle
-      # @param dismissible toggle
+      # @param dismiss_scheme [Symbol] select [none, remove, hide]
       # @param icon [Symbol] octicon
       # @param scheme [Symbol] select [default, warning, danger, success]
       # @param content text
       # @param description text
-      # @param reappear [Boolean]
-      def playground(full: false, full_when_narrow: false, dismissible: false, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, reappear: true, content: "This is a banner!", description: nil)
+      def playground(full: false, full_when_narrow: false, dismiss_scheme: Primer::Alpha::Banner::DEFAULT_DISMISS_SCHEME, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, content: "This is a banner!", description: nil)
         icon = nil if icon == :none
-        render(Primer::Alpha::Banner.new(full: full, full_when_narrow: full_when_narrow, dismissible: dismissible, icon: icon == :none ? nil : icon, scheme: scheme, description: description, reappear: reappear)) { content }
+        render(Primer::Alpha::Banner.new(full: full, full_when_narrow: full_when_narrow, dismiss_scheme: dismiss_scheme, icon: icon == :none ? nil : icon, scheme: scheme, description: description)) { content }
       end
 
       # @label Default
@@ -54,8 +53,8 @@ module Primer
 
       # @label Dismissable
       # @snapshot
-      def dismissable
-        render(Primer::Alpha::Banner.new(dismissible: true, reappear: true)) { "This is a dismissable banner." }
+      def dismissible
+        render(Primer::Alpha::Banner.new(dismiss_scheme: :hide, reappear: true)) { "This is a dismissable banner." }
       end
 
       # @!group Full Width
@@ -76,29 +75,27 @@ module Primer
       # @label With action button
       #
       # @param full toggle
-      # @param dismissible toggle
+      # @param dismiss_scheme [Symbol] select [none, remove, hide]
       # @param icon [Symbol] octicon
       # @param scheme [Symbol] select [default, warning, danger, success]
       # @param content text
-      # @param reappear [Boolean]
       # @snapshot
-      def with_action_button(full: false, dismissible: false, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, reappear: true, content: "This is a banner with an action!")
+      def with_action_button(full: false, dismiss_scheme: Primer::Alpha::Banner::DEFAULT_DISMISS_SCHEME, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, content: "This is a banner with an action!")
         icon = nil if icon == :none
-        render_with_template(locals: { full: full, dismissible: dismissible, icon: icon == :none ? nil : icon, scheme: scheme, content: content, reappear: reappear })
+        render_with_template(locals: { full: full, dismiss_scheme: dismiss_scheme, icon: icon == :none ? nil : icon, scheme: scheme, content: content })
       end
 
       # @label With action content
       #
       # @param full toggle
-      # @param dismissible toggle
+      # @param dismiss_scheme [Symbol] select [none, remove, hide]
       # @param icon [Symbol] octicon
       # @param scheme [Symbol] select [default, warning, danger, success]
       # @param content text
-      # @param reappear [Boolean]
       # @snapshot
-      def with_action_content(full: false, dismissible: false, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, reappear: true, content: "Did you know? Comments can be edited.")
+      def with_action_content(full: false, dismiss_scheme: Primer::Alpha::Banner::DEFAULT_DISMISS_SCHEME, icon: :people, scheme: Primer::Alpha::Banner::DEFAULT_SCHEME, content: "Did you know? Comments can be edited.")
         icon = nil if icon == :none
-        render_with_template(locals: { full: full, dismissible: dismissible, icon: icon == :none ? nil : icon, scheme: scheme, content: content, reappear: reappear })
+        render_with_template(locals: { full: full, dismiss_scheme: dismiss_scheme, icon: icon == :none ? nil : icon, scheme: scheme, content: content })
       end
     end
   end

data/previews/primer/alpha/nav_list_preview.rb

@@ -50,6 +50,15 @@ module Primer
           list.with_group do |group|
             group.with_heading(title: "Access")
 
+            group.with_avatar_item(
+              src: "https://avatars.githubusercontent.com/u/103004183?v=4",
+              username: "hulk_smash",
+              full_name: "Bruce Banner",
+              full_name_scheme: :inline,
+              href: "/profile",
+              avatar_arguments: { shape: :square }
+            )
+
             group.with_item(label: "Collaborators and teams", href: "/collaborators", selected_by_ids: :collaborators) do |item|
               item.with_leading_visual_icon(icon: :people)
             end
@@ -82,6 +91,14 @@ module Primer
           list.with_item(label: "Change password", href: "/change_password") do |item|
             item.with_leading_visual_icon(icon: :key)
           end
+
+          list.with_avatar_item(
+            src: "https://avatars.githubusercontent.com/u/103004183?v=4",
+            username: "hulk_smash",
+            full_name: "Bruce Banner",
+            full_name_scheme: :inline,
+            href: "/profile"
+          )
         end
       end
 

data/previews/primer/alpha/tooltip_preview/with_multiple_on_a_page.html.erb

@@ -1,14 +1,14 @@
 <div>
   <%= render(Primer::Beta::Button.new(id: "button-1")) do |component| %>
-    <% component.with_tooltip(text: tooltip_text, type: type, direction: direction) %>
+    <% component.with_tooltip(text: tooltip_text, direction: direction) %>
     Button 1
   <% end %>
   <%= render(Primer::Beta::Button.new(id: "button-2")) do |component| %>
-    <% component.with_tooltip(text: tooltip_text, type: type, direction: direction) %>
+    <% component.with_tooltip(text: tooltip_text, direction: direction) %>
     Button 2
   <% end %>
   <%= render(Primer::Beta::Button.new(id: "button-3")) do |component| %>
-    <% component.with_tooltip(text: tooltip_text, type: type, direction: direction) %>
+    <% component.with_tooltip(text: tooltip_text, direction: direction) %>
     Button 3
   <% end %>
 </div>