openproject-primer_view_components 0.22.2 → 0.24.0

data/previews/primer/beta/nav_list_preview.rb

@@ -129,6 +129,49 @@ module Primer
       # @label Trailing action
       # @snapshot
       def trailing_action; end
+
+      # @label Long label truncate overflow
+      #
+      # @param truncate_label [Symbol] select [none, truncate, show_tooltip]
+      # @snapshot
+      def long_label_with_tooltip(truncate_label: :show_tooltip)
+        render(Primer::Beta::NavList.new(aria: { label: "List heading" })) do |component|
+          component.with_item(
+            label: "Really really long label that may wrap, truncate, or appear as a tooltip",
+            truncate_label: truncate_label
+          ) do |item|
+            item.with_trailing_visual_icon(icon: :plus)
+          end
+        end
+      end
+
+      def long_label_wrap(truncate_label: :none)
+        render(Primer::Beta::NavList.new(aria: { label: "List heading" })) do |component|
+          component.with_item(
+            label: "Really really long label that may wrap, truncate, or appear as a tooltip",
+            truncate_label: truncate_label
+          )
+        end
+      end
+
+      def long_label_truncate_no_tooltip(truncate_label: :truncate)
+        render(Primer::Beta::NavList.new(aria: { label: "List heading" })) do |component|
+          component.with_item(
+            label: "Really really long label that may wrap, truncate, or appear as a tooltip",
+            truncate_label: truncate_label
+          )
+        end
+      end
+
+      def long_label_show_tooltip_no_truncate_label
+        render(Primer::Beta::NavList.new(aria: { label: "List heading" })) do |component|
+          component.with_item(
+            label: "Really really long label that may wrap, truncate, or appear as a tooltip",
+          ) do |item|
+            item.with_tooltip(text: "this is a tooltip")
+          end
+        end
+      end
     end
   end
 end

data/previews/primer/forms_preview/auto_complete_form.html.erb

@@ -0,0 +1,3 @@
+<%= primer_form_with(url: generic_form_submission_path) do |f| %>
+  <%= render(AutoCompleteForm.new(f)) %>
+<% end %>

data/previews/primer/forms_preview/select_form.html.erb

@@ -1,3 +1,3 @@
-<%= primer_form_with(url: "/foo") do |f| %>
+<%= primer_form_with(url: generic_form_submission_path) do |f| %>
   <%= render(SelectForm.new(f)) %>
 <% end %>

data/previews/primer/forms_preview.rb

@@ -46,5 +46,7 @@ module Primer
     def immediate_validation_form; end
 
     def example_toggle_switch_form; end
+
+    def auto_complete_form; end
   end
 end

data/previews/primer/open_project/page_header_preview/actions.html.erb

@@ -1,15 +1,18 @@
 <%= render(Primer::OpenProject::PageHeader.new) do |component| %>
-  <% component.with_title(tag: :h1) do %>
+  <% component.with_title do %>
     A title
   <% end %>
   <% component.with_description do %>
     A description with actions
   <% end %>
-  <% component.with_actions do %>
-    <%= render(Primer::Alpha::ActionMenu.new) do |component| %>
-      <% component.with_show_button { "Menu" } %>
-      <% component.with_item(label: "Item", tag: :button, value: "") %>
-      <% component.with_item(
+  <% component.with_action do %>
+    <%= render(Primer::Beta::IconButton.new(icon: 'pencil', 'aria-label': 'Edit')) %>
+  <% end %>
+  <% component.with_action do %>
+    <%= render(Primer::Alpha::ActionMenu.new) do |menu| %>
+      <% menu.with_show_button { "Menu" } %>
+      <% menu.with_item(label: "Item", tag: :button, value: "") %>
+      <% menu.with_item(
            label: "Show dialog",
            tag: :button,
            content_arguments: { "data-show-dialog-id": "my-dialog" },
@@ -19,4 +22,3 @@
     <% end %>
   <% end %>
 <% end %>
-

data/previews/primer/open_project/page_header_preview/context_bar_actions.html.erb

@@ -8,11 +8,14 @@
   <% component.with_parent_link(href: "#") do %>
     Parent link
   <% end %>
-  <% component.with_context_bar_actions do %>
-    <%= render(Primer::Alpha::ActionMenu.new) do |component| %>
-      <% component.with_show_button { "Menu" } %>
-      <% component.with_item(label: "Item", tag: :button, value: "") %>
-      <% component.with_item(
+  <% component.with_context_bar_action do %>
+    <%= render(Primer::Beta::IconButton.new(icon: 'star', 'aria-label': 'Star')) %>
+  <% end %>
+  <% component.with_context_bar_action do %>
+    <%= render(Primer::Alpha::ActionMenu.new) do |menu| %>
+      <% menu.with_show_button { "Menu" } %>
+      <% menu.with_item(label: "Item", tag: :button, value: "") %>
+      <% menu.with_item(
            label: "Show dialog",
            tag: :button,
            content_arguments: { "data-show-dialog-id": "my-dialog" },
@@ -22,4 +25,3 @@
     <% end %>
   <% end %>
 <% end %>
-

data/previews/primer/open_project/page_header_preview/playground.html.erb

@@ -1,11 +1,11 @@
 <%= render Primer::OpenProject::PageHeader.new do |header| %>
   <%= header.with_title(variant: variant) { title } %>
   <%= header.with_description { description } %>
-  <%= header.with_back_button(href: "#", size: back_button_size, 'aria-label': "Back") if with_back_button %>
+  <%= header.with_leading_action(icon: with_leading_action, href: '#', 'aria-label': "A leading action") if with_leading_action %>
   <%= header.with_breadcrumbs(breadcrumb_items) if with_breadcrumbs %>
   <%= header.with_parent_link(href: "#") { "Parent link" } if with_parent_link %>
   <% if with_actions %>
-    <% header.with_actions do %>
+    <% header.with_action do %>
       <%= render(Primer::Alpha::ActionMenu.new) do |component| %>
         <% component.with_show_button { "Menu" } %>
         <% component.with_item(label: "Item", tag: :button, value: "") %>
@@ -20,12 +20,12 @@
     <% end %>
   <% end %>
   <% if with_context_bar_actions %>
-    <% header.with_context_bar_actions do %>
+    <% header.with_context_bar_action do %>
       <%= render(Primer::Beta::IconButton.new(
         scheme: :default,
         size: :small,
         icon: "pencil",
-        "aria-label": "aria_label"
+        "aria-label": "A meaningful label"
       )) %>
     <% end %>
   <% end %>

data/previews/primer/open_project/page_header_preview.rb

@@ -18,8 +18,7 @@ module Primer
       # @param variant [Symbol] select [medium, large]
       # @param title [String] text
       # @param description [String] text
-      # @param with_back_button [Boolean]
-      # @param back_button_size [Symbol] select [small, medium, large]
+      # @param with_leading_action [Symbol] octicon
       # @param with_breadcrumbs [Boolean]
       # @param with_actions [Boolean]
       # @param with_context_bar_actions [Boolean]
@@ -28,8 +27,7 @@ module Primer
         variant: :large,
         title: "Hello",
         description: "Last updated 5 minutes ago by XYZ.",
-        with_back_button: false,
-        back_button_size: :medium,
+        with_leading_action: :"arrow-left",
         with_breadcrumbs: false,
         with_actions: false,
         with_context_bar_actions: false,
@@ -40,8 +38,7 @@ module Primer
         render_with_template(locals: { variant: variant,
                                        title: title,
                                        description: description,
-                                       with_back_button: with_back_button,
-                                       back_button_size: back_button_size,
+                                       with_leading_action: with_leading_action,
                                        with_breadcrumbs: with_breadcrumbs,
                                        with_parent_link: with_parent_link,
                                        with_actions: with_actions,
@@ -49,10 +46,10 @@ module Primer
                                        breadcrumb_items: breadcrumb_items })
       end
 
-      # @label Medium title
-      def medium_title
+      # @label Large title
+      def large_title
         render(Primer::OpenProject::PageHeader.new) do |header|
-          header.with_title(variant: :medium) { "Hello" }
+          header.with_title(variant: :large) { "Hello" }
           header.with_description { "Last updated 5 minutes ago by XYZ." }
         end
       end
@@ -62,18 +59,17 @@ module Primer
         render_with_template(locals: {})
       end
 
-      # @label With back button (on wide)
-      # **Back button** is only shown on **wider than narrow screens** by default.
+      # @label With leading action (on wide)
+      # **Leading action** is only shown on **wide screens** by default.
       # If you want to override that behaviour please use the system_argument: **display**
       # e.g. **component.with\_breadcrumbs(display: [:block, :block])**
       #
       # @param href [String] text
-      # @param size [Symbol] select [small, medium, large]
-      # @param icon [String] select ["arrow-left", "chevron-left", "triangle-left"]
-      def back_button(href: "#", size: :medium, icon: "arrow-left")
+      # @param icon [Symbol] octicon
+      def leading_action(href: "#", icon: :"arrow-left")
         render(Primer::OpenProject::PageHeader.new) do |header|
           header.with_title { "Hello" }
-          header.with_back_button(href: href, size: size, icon: icon, 'aria-label': "Back")
+          header.with_leading_action(icon: icon, href: href, 'aria-label': "Back")
         end
       end
 

data/static/arguments.json

@@ -249,9 +249,9 @@
       },
       {
         "name": "truncate_label",
-        "type": "Boolean",
-        "default": "`false`",
-        "description": "Truncate label with ellipsis."
+        "type": "Boolean | Symbol",
+        "default": "`:none`",
+        "description": "How the label should be truncated when the text does not fit inside the bounds of the list item. One of `false`, `:none`, `:show_tooltip`, `:truncate`, or `true`. Pass `false` or `:none` to wrap label text. Pass `true` or `:truncate` to truncate labels with ellipses. Pass `:show_tooltip` to show the entire label contents in a tooltip when the item is hovered."
       },
       {
         "name": "href",
@@ -2494,7 +2494,7 @@
         "name": "full_width",
         "type": "Boolean",
         "default": "N/A",
-        "description": "When set to `true`, the field will take up all the horizontal space allowed by its container."
+        "description": "When set to `true`, the field will take up all the horizontal space allowed by its container. Defaults to `true`."
       },
       {
         "name": "name",
@@ -2624,7 +2624,7 @@
         "name": "full_width",
         "type": "Boolean",
         "default": "N/A",
-        "description": "When set to `true`, the field will take up all the horizontal space allowed by its container."
+        "description": "When set to `true`, the field will take up all the horizontal space allowed by its container. Defaults to `true`."
       },
       {
         "name": "name",
@@ -2814,13 +2814,13 @@
         "name": "size",
         "type": "Symbol",
         "default": "`:medium`",
-        "description": "What size toggle switch to render. One of `:end` or `:start`."
+        "description": "What size toggle switch to render. One of `:medium` or `:small`."
       },
       {
         "name": "status_label_position",
         "type": "Symbol",
         "default": "`:start`",
-        "description": "Which side of the toggle switch to render the status label. One of `:medium` or `:small`."
+        "description": "Which side of the toggle switch to render the status label. One of `:end` or `:start`."
       },
       {
         "name": "system_arguments",
@@ -3436,6 +3436,28 @@
       }
     ]
   },
+  {
+    "component": "ButtonGroup::MenuButton",
+    "status": "alpha",
+    "a11y_reviewed": false,
+    "short_name": "ButtonGroupMenuButton",
+    "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/button_group/menu_button.rb",
+    "lookbook": "https://primer.style/view-components/lookbook/inspect/primer/beta/button_group/menu_button/default/",
+    "parameters": [
+      {
+        "name": "menu_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "The arguments accepted by [ActionMenu](/components/alpha/actionmenu)."
+      },
+      {
+        "name": "button_arguments",
+        "type": "Hash",
+        "default": "`{}`",
+        "description": "The arguments accepted by [Button](/components/beta/button) or [IconButton](/components/beta/iconbutton), depending on the value of the `icon:` argument."
+      }
+    ]
+  },
   {
     "component": "ClipboardCopy",
     "status": "beta",
@@ -3648,7 +3670,7 @@
   },
   {
     "component": "Flash",
-    "status": "beta",
+    "status": "deprecated",
     "a11y_reviewed": false,
     "short_name": "Flash",
     "source": "https://github.com/primer/view_components/tree/main/app/components/primer/beta/flash.rb",

data/static/audited_at.json

@@ -75,6 +75,7 @@
   "Primer::Beta::Breadcrumbs::Item": "",
   "Primer::Beta::Button": "",
   "Primer::Beta::ButtonGroup": "",
+  "Primer::Beta::ButtonGroup::MenuButton": "",
   "Primer::Beta::ClipboardCopy": "",
   "Primer::Beta::ClipboardCopyBaseButton": "",
   "Primer::Beta::ClipboardCopyButton": "",

data/static/classes.json

@@ -426,19 +426,16 @@
   "PageHeader-actions": [
     "Primer::OpenProject::PageHeader"
   ],
-  "PageHeader-backButton": [
-    "Primer::OpenProject::PageHeader"
-  ],
   "PageHeader-breadcrumbs": [
     "Primer::OpenProject::PageHeader"
   ],
   "PageHeader-contextBar": [
     "Primer::OpenProject::PageHeader"
   ],
-  "PageHeader-contextBarActions": [
+  "PageHeader-description": [
     "Primer::OpenProject::PageHeader"
   ],
-  "PageHeader-description": [
+  "PageHeader-leadingAction": [
     "Primer::OpenProject::PageHeader"
   ],
   "PageHeader-parentLink": [

data/static/constants.json

@@ -95,6 +95,7 @@
     "DEFAULT_DESCRIPTION_SCHEME": "block",
     "DEFAULT_SCHEME": "default",
     "DEFAULT_SIZE": "medium",
+    "DEFAULT_TRUNCATION_BEHAVIOR": "none",
     "DESCRIPTION_SCHEME_MAPPINGS": {
       "inline": "ActionListItem-descriptionWrap--inline",
       "block": "ActionListItem-descriptionWrap"
@@ -120,6 +121,20 @@
       "medium",
       "large",
       "xlarge"
+    ],
+    "TRUNCATION_BEHAVIOR_MAPPINGS": {
+      "none": null,
+      "false": null,
+      "show_tooltip": "ActionListItem-label--truncate",
+      "truncate": "ActionListItem-label--truncate",
+      "true": "ActionListItem-label--truncate"
+    },
+    "TRUNCATION_BEHAVIOR_OPTIONS": [
+      "none",
+      false,
+      "show_tooltip",
+      "truncate",
+      true
     ]
   },
   "Primer::Alpha::ActionMenu": {
@@ -848,6 +863,9 @@
     ]
   },
   "Primer::Beta::ButtonGroup": {
+    "MenuButton": "Primer::Beta::ButtonGroup::MenuButton"
+  },
+  "Primer::Beta::ButtonGroup::MenuButton": {
   },
   "Primer::Beta::ClipboardCopy": {
   },
@@ -1412,26 +1430,20 @@
       "chevron-left",
       "triangle-left"
     ],
-    "BACK_BUTTON_SIZE_OPTIONS": [
-      "small",
-      "medium",
-      "large"
-    ],
-    "DEFAULT_BACK_BUTTON_DISPLAY": [
-      "none",
-      "flex"
-    ],
     "DEFAULT_BACK_BUTTON_ICON": "arrow-left",
-    "DEFAULT_BACK_BUTTON_SIZE": "medium",
     "DEFAULT_BREADCRUMBS_DISPLAY": [
       "none",
       "flex"
     ],
     "DEFAULT_CONTEXT_BAR_ACTIONS_DISPLAY": [
-      "block",
+      "flex",
       "none"
     ],
-    "DEFAULT_HEADER_VARIANT": "large",
+    "DEFAULT_HEADER_VARIANT": "medium",
+    "DEFAULT_LEADING_ACTION_DISPLAY": [
+      "none",
+      "flex"
+    ],
     "DEFAULT_PARENT_LINK_DISPLAY": [
       "block",
       "none"
@@ -1440,7 +1452,7 @@
       "medium",
       "large"
     ],
-    "HEADING_TAG_FALLBACK": "h2",
+    "HEADING_TAG_FALLBACK": "h1",
     "HEADING_TAG_OPTIONS": [
       "h1",
       "h2",