openproject-primer_view_components 0.6.3

data/previews/primer/alpha/check_box_group_preview.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Primer
+  module Alpha
+    # @label CheckBoxGroup
+    class CheckBoxGroupPreview < ViewComponent::Preview
+      # @label Playground
+      #
+      # @param name text
+      # @param label text
+      # @param caption text
+      # @param disabled toggle
+      def playground(
+        name: "my-check-group",
+        label: "I would go into battle with:",
+        caption: "Qa'pla!",
+        disabled: false
+      )
+        system_arguments = {
+          name: name,
+          label: label,
+          caption: caption,
+          disabled: disabled
+        }
+
+        render(Primer::Alpha::CheckBoxGroup.new(**system_arguments)) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard")
+          component.check_box(label: "Hikaru Sulu", value: "sulu")
+          component.check_box(label: "Kathryn Janeway", value: "janeway")
+          component.check_box(label: "Benjamin Sisko", value: "sisko")
+        end
+      end
+
+      # @label Default
+      def default
+        render(Primer::Alpha::CheckBoxGroup.new(name: "my-check-group", label: "I would go into battle with:")) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard")
+          component.check_box(label: "Hikaru Sulu", value: "sulu")
+          component.check_box(label: "Kathryn Janeway", value: "janeway")
+          component.check_box(label: "Benjamin Sisko", value: "sisko")
+        end
+      end
+
+      # @!group Options
+      # @snapshot
+      #
+      # @label With caption
+      def with_caption
+        render(Primer::Alpha::CheckBoxGroup.new(caption: "With a caption", name: "my-check-group", label: "I would go into battle with:")) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard1")
+          component.check_box(label: "Hikaru Sulu", value: "sulu1")
+          component.check_box(label: "Kathryn Janeway", value: "janeway1")
+          component.check_box(label: "Benjamin Sisko", value: "sisko1")
+        end
+      end
+
+      # @label Visually hidden label
+      def visually_hide_label
+        render(Primer::Alpha::CheckBoxGroup.new(visually_hide_label: true, name: "my-check-group", label: "I would go into battle with:")) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard2")
+          component.check_box(label: "Hikaru Sulu", value: "sulu2")
+          component.check_box(label: "Kathryn Janeway", value: "janeway2")
+          component.check_box(label: "Benjamin Sisko", value: "sisko2")
+        end
+      end
+
+      # @label Full width
+      def full_width
+        render(Primer::Alpha::CheckBoxGroup.new(full_width: true, name: "my-check-group", label: "I would go into battle with:")) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard3")
+          component.check_box(label: "Hikaru Sulu", value: "sulu3")
+          component.check_box(label: "Kathryn Janeway", value: "janeway3")
+          component.check_box(label: "Benjamin Sisko", value: "sisko3")
+        end
+      end
+
+      # @label Disabled
+      def disabled
+        render(Primer::Alpha::CheckBoxGroup.new(disabled: true, name: "my-check-group", label: "I would go into battle with:")) do |component|
+          component.check_box(label: "Jean-Luc Picard", value: "picard4")
+          component.check_box(label: "Hikaru Sulu", value: "sulu4")
+          component.check_box(label: "Kathryn Janeway", value: "janeway4")
+          component.check_box(label: "Benjamin Sisko", value: "sisko4")
+        end
+      end
+      #
+      # @!endgroup
+    end
+  end
+end

data/previews/primer/alpha/check_box_preview.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Primer
+  module Alpha
+    # @label CheckBox
+    class CheckBoxPreview < ViewComponent::Preview
+      # @label Playground
+      #
+      # @param name text
+      # @param id text
+      # @param value text
+      # @param label text
+      # @param caption text
+      # @param visually_hide_label toggle
+      # @param disabled toggle
+      def playground(
+        name: "my-check-box",
+        id: nil,
+        value: "picard",
+        label: "Jean-Luc Picard",
+        caption: "Make it so",
+        visually_hide_label: false,
+        disabled: false
+      )
+        system_arguments = {
+          name: name,
+          value: value,
+          label: label,
+          caption: caption,
+          visually_hide_label: visually_hide_label,
+          disabled: disabled
+        }
+
+        render(Primer::Alpha::CheckBox.new(**system_arguments))
+      end
+
+      # @label Default
+      def default
+        render(Primer::Alpha::CheckBox.new(name: "my-check-box", label: "Jean-Luc Picard"))
+      end
+
+      # @!group Options
+      # @snapshot
+      #
+      # @label With caption
+      def with_caption
+        render(Primer::Alpha::CheckBox.new(caption: "With a caption", name: "my-check-box1", label: "Jean-Luc Picard"))
+      end
+
+      # @label Checked
+      def checked
+        render(Primer::Alpha::CheckBox.new(checked: true, name: "my-check-box1", label: "Jean-Luc Picard"))
+      end
+
+      # @label Visually hidden label
+      def visually_hide_label
+        render(Primer::Alpha::CheckBox.new(visually_hide_label: true, name: "my-check-box2", label: "Jean-Luc Picard"))
+      end
+
+      # @label Disabled
+      def disabled
+        render(Primer::Alpha::CheckBox.new(disabled: true, name: "my-check-box4", label: "Jean-Luc Picard"))
+      end
+      #
+      # @!endgroup
+    end
+  end
+end

data/previews/primer/alpha/dialog_preview/body_has_scrollbar_overflow.html.erb

@@ -0,0 +1,9 @@
+<div>
+  <p>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?</p>
+  <%= render(Primer::Alpha::Dialog.new(id: "dialog-one", title: title, subtitle: subtitle, visually_hide_title: false)) do |d| %>
+    <% d.with_show_button { button_text } %>
+    <% d.with_body do %>
+      <p>Dialog</p>
+    <% end %>
+  <% end %>
+</div>

data/previews/primer/alpha/dialog_preview/custom_header.html.erb

@@ -0,0 +1,7 @@
+<%= render(Primer::Alpha::Dialog.new(id: "my-dialog", title: title, subtitle: subtitle, visually_hide_title: false)) do |d| %>
+  <% d.with_header(show_divider: show_divider) do %>
+    <button class="btn">Custom Header Controls</button>
+  <% end %>
+  <% d.with_show_button { button_text } %>
+  <% d.with_body { "Hello World" } %>
+<% end %>

data/previews/primer/alpha/dialog_preview/nested_dialog.html.erb

@@ -0,0 +1,14 @@
+<%= render(Primer::Alpha::Dialog.new(id: "dialog-one", title: title, subtitle: subtitle, visually_hide_title: false)) do |d| %>
+  <% d.with_show_button { button_text } %>
+  <% d.with_body do %>
+    <p>Dialog One!</p>
+
+    <p>Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?</p>
+    <%= render(Primer::Alpha::Dialog.new(id: "dialog-two", title: title, subtitle: subtitle, visually_hide_title: false)) do |d| %>
+      <% d.with_show_button { button_text } %>
+      <% d.with_body do %>
+        Dialog Two!
+      <% end %>
+    <% end %>
+  <% end %>
+<% end %>

data/previews/primer/alpha/dialog_preview/test.html.erb

@@ -0,0 +1,7 @@
+<%= render(Primer::Alpha::Dialog.new(title: title, subtitle: subtitle)) do |d| %>
+  <% d.with_show_button { @button_text } %>
+  <% d.with_body { "Content" } %>
+  <% d.with_footer do %>
+    render(Primer::ButtonComponent.new(scheme: :primary)) { "Submit" }
+  <% end %>
+<% end %>

data/previews/primer/alpha/dialog_preview/with_footer.html.erb

@@ -0,0 +1,8 @@
+<%= render(Primer::Alpha::Dialog.new(id: "my-dialog", title: title, subtitle: subtitle)) do |d| %>
+  <% d.with_show_button { button_text } %>
+  <% d.with_body { "Content" } %>
+  <% d.with_footer(show_divider: show_divider) do %>
+    <%= render(Primer::ButtonComponent.new(data: { "close-dialog-id": "my-dialog" })) { "Cancel" } %>
+    <%= render(Primer::ButtonComponent.new(scheme: :primary)) { "Submit" } %>
+  <% end %>
+<% end %>

data/previews/primer/alpha/dialog_preview/with_form.html.erb

@@ -0,0 +1,12 @@
+<%= render(Primer::Alpha::Dialog.new(id: "my-dialog", title: title, subtitle: subtitle)) do |d| %>
+  <% d.with_show_button { button_text } %>
+  <form class="pt-3">
+    <%= render(Primer::Alpha::Dialog::Body.new) do %>
+      This is a custom dialog with the body and footer wrapped in a form tag.
+    <% end %>
+    <%= render(Primer::Alpha::Dialog::Footer.new(show_divider: show_divider)) do %>
+      <%= render(Primer::ButtonComponent.new(data: { "close-dialog-id": "my-dialog" })) { "Cancel" } %>
+      <%= render(Primer::ButtonComponent.new(scheme: :primary)) { "Submit" } %>
+    <% end %>
+  </form>
+<% end %>

data/previews/primer/alpha/dialog_preview/with_text_input.html.erb

@@ -0,0 +1,10 @@
+<%= render(Primer::Alpha::Dialog.new(id: "dialog-one", title: title, subtitle: subtitle, visually_hide_title: false)) do |d| %>
+  <% d.with_show_button { button_text } %>
+  <% d.with_body do %>
+    <p>Dialog One!</p>
+
+    <form>
+      <input type="text" value="Some text goes in here">
+    </form>
+  <% end %>
+<% end %>

data/previews/primer/alpha/dialog_preview.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+module Primer
+  module Alpha
+    # @label Dialog
+    class DialogPreview < ViewComponent::Preview
+      # @label Playground
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param size [Symbol] select [small, medium, medium_portrait, large, xlarge]
+      # @param position [Symbol] select [center, left, right]
+      # @param position_narrow [Symbol] select [inherit, bottom, fullscreen, left, right]
+      # @param visually_hide_title [Boolean] toggle
+      # @param disable_button [Boolean] toggle
+      # @param button_text [String] text
+      # @param body_text [String] text
+      # @param icon [Symbol] octicon
+      def playground(title: "Test Dialog", subtitle: nil, size: :medium, button_text: "Show Dialog", body_text: "Content", position: :center, position_narrow: :fullscreen, visually_hide_title: false, icon: nil, disable_button: false)
+        render(Primer::Alpha::Dialog.new(title: title, subtitle: subtitle, size: size, position: position, position_narrow: position_narrow, visually_hide_title: visually_hide_title)) do |d|
+          if icon.present? && (icon != :none)
+            d.with_show_button(icon: icon, "aria-label": icon.to_s, disabled: disable_button)
+          else
+            d.with_show_button(disabled: disable_button) { button_text }
+          end
+          d.with_body { body_text }
+        end
+      end
+
+      # @label Default options
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param size [Symbol] select [small, medium, medium_portrait, large, xlarge]
+      # @param position [Symbol] select [center, left, right]
+      # @param position_narrow [Symbol] select [inherit, bottom, fullscreen, left, right]
+      # @param visually_hide_title [Boolean] toggle
+      # @param button_text [String] text
+      # @param body_text [String] text
+      # @snapshot interactive
+      def default(title: "Test Dialog", subtitle: nil, size: :medium, button_text: "Show Dialog", body_text: "Content", position: :center, position_narrow: :fullscreen, visually_hide_title: false)
+        render(Primer::Alpha::Dialog.new(title: title, subtitle: subtitle, size: size, position: position, position_narrow: position_narrow, visually_hide_title: visually_hide_title)) do |d|
+          d.with_show_button { button_text }
+          d.with_body { body_text }
+        end
+      end
+
+      # @label Long text
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param size [Symbol] select [small, medium, medium_portrait, large, xlarge]
+      # @param position [Symbol] select [center, left, right]
+      # @param position_narrow [Symbol] select [inherit, bottom, fullscreen, left, right]
+      def long_text(title: "Test Dialog", subtitle: nil, size: :medium, button_text: "Show Dialog", position: :center, position_narrow: :fullscreen)
+        render(Primer::Alpha::Dialog.new(title: title, subtitle: subtitle, size: size, position: position, position_narrow: position_narrow)) do |d|
+          d.with_show_button { button_text }
+          d.with_body { "Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur? Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt. Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?" }
+        end
+      end
+
+      # @label With Footer
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def with_footer(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+
+      # @label With a Form
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def with_form(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+
+      # @label Custom Header
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def custom_header(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+
+      # @label Nested dialog
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def nested_dialog(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+
+      # @label Dialog with text input
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def with_text_input(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+
+      # @label Page with scrollbar and dialog
+      #
+      # @param title [String] text
+      # @param subtitle [String] text
+      # @param button_text [String] text
+      # @param show_divider [Boolean] toggle
+      def body_has_scrollbar_overflow(title: "Test Dialog", subtitle: nil, button_text: "Show Dialog", show_divider: true)
+        render_with_template(locals: {
+                               title: title,
+                               subtitle: subtitle,
+                               button_text: button_text,
+                               show_divider: show_divider
+                             })
+      end
+    end
+  end
+end

data/previews/primer/alpha/dropdown_preview.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+module Primer
+  module Alpha
+    # @label Dropdown
+    class DropdownPreview < ViewComponent::Preview
+      # @label Playground
+      #
+      # @param with_caret [Boolean] toggle
+      # @param overlay [Symbol] select [none, default, dark]
+      def playground(overlay: :default, with_caret: false)
+        render(Primer::Alpha::Dropdown.new(overlay: overlay, with_caret: with_caret)) do |component|
+          component.with_button { "Dropdown" }
+
+          component.with_menu(header: "Header") do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item(divider: true)
+            menu.with_item { "Item 3" }
+            menu.with_item { "Item 4" }
+          end
+        end
+      end
+
+      # @label Default
+      #
+      # @snapshot interactive
+      def default
+        render(Primer::Alpha::Dropdown.new) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Menu
+      #
+      # @param as [Symbol] select [list, default]
+      # @param direction [Symbol] select [se, sw, w, e, ne, s]
+      # @param scheme [Symbol] select [default, dark]
+      def menu(as: :default, direction: :se, scheme: :default)
+        render(Primer::Alpha::Dropdown::Menu.new(as: as, direction: direction, scheme: scheme, header: "Header")) do |menu|
+          menu.with_item { "Item 1" }
+          menu.with_item { "Item 2" }
+          menu.with_item(divider: true)
+          menu.with_item { "Item 3" }
+          menu.with_item { "Item 4" }
+        end
+      end
+
+      # @!group Direction
+      #
+      # @label Direction e
+      def direction_e
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :e) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Direction ne
+      def direction_ne
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :ne) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Direction s
+      def direction_s
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :s) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Direction se
+      def direction_se
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :se) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Direction sw
+      def direction_sw
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :sw) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Direction w
+      def direction_w
+        render(Primer::Alpha::Dropdown.new(display: :inline_block)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(direction: :w) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+      #
+      # @!endgroup
+
+      # @!group Options
+      #
+      # @label With caret
+      def options_with_caret
+        render(Primer::Alpha::Dropdown.new(with_caret: true)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label With header
+      def options_with_header
+        render(Primer::Alpha::Dropdown.new) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(header: "Header") do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label With dividers
+      def options_with_dividers
+        render(Primer::Alpha::Dropdown.new) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item(divider: true)
+            menu.with_item { "Item 3" }
+            menu.with_item { "Item 4" }
+            menu.with_item(divider: true)
+            menu.with_item { "Item 5" }
+          end
+        end
+      end
+
+      # @label As list
+      def options_as_list
+        render(Primer::Alpha::Dropdown.new) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu(as: :list) do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Overlay none
+      def options_overlay_none
+        render(Primer::Alpha::Dropdown.new(overlay: :none)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+
+      # @label Overlay dark
+      def options_overlay_dark
+        render(Primer::Alpha::Dropdown.new(overlay: :dark)) do |component|
+          component.with_button { "Dropdown" }
+          component.with_menu do |menu|
+            menu.with_item { "Item 1" }
+            menu.with_item { "Item 2" }
+            menu.with_item { "Item 3" }
+          end
+        end
+      end
+      #
+      # @!endgroup
+    end
+  end
+end

data/previews/primer/alpha/form_control_preview/playground.html.erb

@@ -0,0 +1,9 @@
+<%= render(Primer::Alpha::FormControl.new(**system_arguments)) do |component| %>
+  <% component.with_input do |input_arguments| %>
+    <%= render(Primer::Alpha::SegmentedControl.new("aria-label": "Best character", **input_arguments)) do |seg| %>
+      <% seg.with_item(label: "Han Solo", selected: true) %>
+      <% seg.with_item(label: "Luke Skywalker") %>
+      <% seg.with_item(label: "Leia Organa") %>
+    <% end %>
+  <% end %>
+<% end %>