primer_view_components 0.0.112 → 0.0.114

data/app/components/primer/alpha/toggle_switch.js

@@ -27,9 +27,12 @@ let ToggleSwitchElement = class ToggleSwitchElement extends HTMLElement {
         return this.src != null;
     }
     toggle() {
+        if (this.isDisabled()) {
+            return;
+        }
         if (this.isRemote()) {
             this.setLoadingState();
-            this.check();
+            this.submitForm();
         }
         else {
             this.performToggle();
@@ -90,12 +93,12 @@ let ToggleSwitchElement = class ToggleSwitchElement extends HTMLElement {
         this.loadingSpinner.setAttribute('hidden', 'hidden');
         this.enable();
     }
-    async check() {
+    async submitForm() {
         const body = new FormData();
         if (this.csrf) {
             body.append(this.csrfField, this.csrf);
         }
-        body.append('value', this.isOn() ? '1' : '0');
+        body.append('value', this.isOn() ? '0' : '1');
         try {
             if (!this.src)
                 throw new Error('invalid src');
@@ -131,7 +134,7 @@ __decorate([
 ], ToggleSwitchElement.prototype, "errorIcon", void 0);
 __decorate([
     debounce(300)
-], ToggleSwitchElement.prototype, "check", null);
+], ToggleSwitchElement.prototype, "submitForm", null);
 ToggleSwitchElement = __decorate([
     controller
 ], ToggleSwitchElement);

data/app/components/primer/alpha/toggle_switch.ts

@@ -32,9 +32,13 @@ class ToggleSwitchElement extends HTMLElement {
   }
 
   toggle() {
+    if (this.isDisabled()) {
+      return
+    }
+
     if (this.isRemote()) {
       this.setLoadingState()
-      this.check()
+      this.submitForm()
     } else {
       this.performToggle()
     }
@@ -110,14 +114,14 @@ class ToggleSwitchElement extends HTMLElement {
   }
 
   @debounce(300)
-  private async check() {
+  private async submitForm() {
     const body = new FormData()
 
     if (this.csrf) {
       body.append(this.csrfField, this.csrf)
     }
 
-    body.append('value', this.isOn() ? '1' : '0')
+    body.append('value', this.isOn() ? '0' : '1')
 
     try {
       if (!this.src) throw new Error('invalid src')

data/app/components/primer/beta/clipboard_copy.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Primer
+  module Beta
+    # Use `ClipboardCopy` to copy element text content or input values to the clipboard.
+    #
+    # @accessibility
+    #   Always set an accessible label to help the user interact with the component.
+    class ClipboardCopy < Primer::Component
+      status :beta
+
+      # @example Default
+      #   <%= render(Primer::Beta::ClipboardCopy.new(value: "Text to copy", "aria-label": "Copy text to the system clipboard")) %>
+      #
+      # @example With text instead of icons
+      #   <%= render(Primer::Beta::ClipboardCopy.new(value: "Text to copy")) do %>
+      #     Click to copy!
+      #   <% end %>
+      #
+      # @example Copying from an element
+      #   <%= render(Primer::Beta::ClipboardCopy.new(for: "blob-path", "aria-label": "Copy text to the system clipboard")) %>
+      #   <div id="blob-path">src/index.js</div>
+      #
+      # @param aria-label [String] String that will be read to screenreaders when the component is focused
+      # @param value [String] Text to copy into the users clipboard when they click the component.
+      # @param for [String] Element id from where to get the copied value.
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      def initialize(value: nil, **system_arguments)
+        @system_arguments = deny_tag_argument(**system_arguments)
+        @value = value
+
+        validate!
+
+        @system_arguments[:tag] = "clipboard-copy"
+        @system_arguments[:value] = value if value.present?
+      end
+
+      # :nodoc:
+      def before_render
+        validate_aria_label if content.blank?
+      end
+
+      private
+
+      def validate!
+        raise ArgumentError, "Must provide either `value` or `for`" if @value.nil? && @system_arguments[:for].nil?
+      end
+    end
+  end
+end

data/app/components/primer/beta/markdown.rb

@@ -0,0 +1,290 @@
+# frozen_string_literal: true
+
+module Primer
+  module Beta
+    # Use `Markdown` to wrap markdown content.
+    class Markdown < Primer::Component
+      status :beta
+
+      DEFAULT_TAG = :div
+      TAG_OPTIONS = [DEFAULT_TAG, :article, :td].freeze
+      # @example Default
+      #   <%= render(Primer::Beta::Markdown.new) do %>
+      #     <p>Text can be <b>bold</b>, <i>italic</i>, or <s>strikethrough</s>. <a href="https://github.com">Links </a> should be blue with no underlines (unless hovered over).</p>
+      #
+      #     <p>There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs.</p>
+      #
+      #     <p>There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs. There should be whitespace between paragraphs.</p>
+      #
+      #     <blockquote>
+      #       <p>There should be no margin above this first sentence.</p>
+      #       <p>Blockquotes should be a lighter gray with a gray border along the left side.</p>
+      #       <p>There should be no margin below this final sentence.</p>
+      #     </blockquote>
+      #
+      #     <h1>Header 1</h1>
+      #
+      #     <p>This is a normal paragraph following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.</p>
+      #
+      #     <h2>Header 2</h2>
+      #
+      #     <blockquote>This is a blockquote following a header. Bacon ipsum dolor sit amet t-bone doner shank drumstick, pork belly porchetta chuck sausage brisket ham hock rump pig. Chuck kielbasa leberkas, pork bresaola ham hock filet mignon cow shoulder short ribs biltong.</blockquote>
+      #
+      #     <h3>Header 3</h3>
+      #
+      #     <pre><code>This is a code block following a header.</code></pre>
+      #
+      #     <h4>Header 4</h4>
+      #
+      #     <ul>
+      #       <li>This is an unordered list following a header.</li>
+      #       <li>This is an unordered list following a header.</li>
+      #       <li>This is an unordered list following a header.</li>
+      #     </ul>
+      #
+      #     <h5>Header 5</h5>
+      #
+      #     <ol>
+      #       <li>This is an ordered list following a header.</li>
+      #       <li>This is an ordered list following a header.</li>
+      #       <li>This is an ordered list following a header.</li>
+      #     </ol>
+      #
+      #     <h6>Header 6</h6>
+      #
+      #     <table>
+      #       <thead>
+      #         <tr>
+      #           <th>What</th>
+      #           <th>Follows</th>
+      #         </tr>
+      #       </thead>
+      #       <tbody>
+      #         <tr>
+      #           <td>A table</td>
+      #           <td>A header</td>
+      #         </tr>
+      #         <tr>
+      #           <td>A table</td>
+      #           <td>A header</td>
+      #         </tr>
+      #         <tr>
+      #           <td>A table</td>
+      #           <td>A header</td>
+      #         </tr>
+      #       </tbody>
+      #     </table>
+      #
+      #     <hr />
+      #
+      #     <p>There's a horizontal rule above and below this.</p>
+      #
+      #     <hr />
+      #
+      #     <p>Here is an unordered list:</p>
+      #
+      #     <ul>
+      #       <li>Salt-n-Pepa</li>
+      #       <li>Bel Biv DeVoe</li>
+      #       <li>Kid 'N Play</li>
+      #     </ul>
+      #
+      #     <p>And an ordered list:</p>
+      #
+      #     <ol>
+      #       <li>Michael Jackson</li>
+      #       <li>Michael Bolton</li>
+      #       <li>Michael Bublé</li>
+      #     </ol>
+      #
+      #     <p>And an unordered task list:</p>
+      #
+      #     <ul>
+      #       <li><input type="checkbox" id="create-markdown" checked /><label for="create-markdown">Create a sample markdown document</label><br></li>
+      #       <li><input type="checkbox" id="tasks-list" checked /><label for="tasks-list">Add tasks list to it</label><br></li>
+      #       <li><input type="checkbox" id="take-vacation" checked /><label for="take-vacation">Take a vacation</label><br></li>
+      #     </ul>
+      #
+      #     <p>And a "mixed" task list:</p>
+      #
+      #     <ul>
+      #       <li><input type="checkbox"id="steal-underpants"/><label for="steal-underpants">Steal underpants</label></li>
+      #       <li>?</li>
+      #       <li><input type="checkbox"id="profit"/><label for="profit">Profit!</label></li>
+      #     </ul>
+      #
+      #     And a nested list:
+      #
+      #     <ul>
+      #       <li>Jackson 5
+      #         <ul>
+      #           <li>Michael</li>
+      #           <li>Tito</li>
+      #           <li>Jackie</li>
+      #           <li>Marlon</li>
+      #           <li>Jermaine</li>
+      #         </ul>
+      #       </li>
+      #       <li>TMNT
+      #         <ul>
+      #           <li>Leonardo</li>
+      #           <li>Michelangelo</li>
+      #           <li>Donatello</li>
+      #           <li>Raphael</li>
+      #         </ul>
+      #       </li>
+      #     </ul>
+      #
+      #     <p>Definition lists can be used with HTML syntax. Definition terms are bold and italic.</p>
+      #
+      #     <dl>
+      #         <dt>Name</dt>
+      #         <dd>Godzilla</dd>
+      #         <dt>Born</dt>
+      #         <dd>1952</dd>
+      #         <dt>Birthplace</dt>
+      #         <dd>Japan</dd>
+      #         <dt>Color</dt>
+      #         <dd>Green</dd>
+      #     </dl>
+      #
+      #     <hr />
+      #
+      #     <p>Tables should have bold headings and alternating shaded rows.</p>
+      #
+      #     <table>
+      #       <thead>
+      #         <tr>
+      #           <th>Artist</th>
+      #           <th>Album</th>
+      #           <th>Year</th>
+      #         </tr>
+      #       </thead>
+      #       <tbody>
+      #         <tr>
+      #           <td>David Bowie</td>
+      #           <td>Scary Monsters</td>
+      #           <td>1980</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Prince</td>
+      #           <td>Purple Rain</td>
+      #           <td>1982</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Beastie Boys</td>
+      #           <td>License to Ill</td>
+      #           <td>1986</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Janet Jackson</td>
+      #           <td>Rhythm Nation 1814</td>
+      #           <td>1989</td>
+      #         </tr>
+      #       </tbody>
+      #     </table>
+      #
+      #     <p>If a table is too wide, it should condense down and/or scroll horizontally.</p>
+      #
+      #     <table>
+      #       <thead>
+      #         <tr>
+      #           <th>Artist</th>
+      #           <th>Album</th>
+      #           <th>Year</th>
+      #           <th>Label</th>
+      #           <th>Songs</th>
+      #         </tr>
+      #       </thead>
+      #       <tbody>
+      #         <tr>
+      #           <td>David Bowie</td>
+      #           <td>Scary Monsters</td>
+      #           <td>1980</td>
+      #           <td>RCA Records</td>
+      #           <td>It's No Game (No. 1), Up the Hill Backwards, Scary Monsters (And Super Creeps), Ashes to Ashes, Fashion, Teenage Wildlife, Scream Like a Baby, Kingdom Come, Because You're Young, It's No Game (No. 2)</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Prince</td>
+      #           <td>Purple Rain</td>
+      #           <td>1982</td>
+      #           <td>Warner Brothers Records</td>
+      #           <td>Let's Go Crazy, Take Me With U, The Beautiful Ones, Computer Blue, Darling Nikki, When Doves Cry, I Would Die 4 U, Baby I'm a Star, Purple Rain</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Beastie Boys</td>
+      #           <td>License to Ill</td>
+      #           <td>1986</td>
+      #           <td>Def Jam</td>
+      #           <td>Rhymin &amp; Stealin, The New Style, She's Crafty, Posse in Effect, Slow Ride, Girls, Fight for Your Right, No Sleep till Brooklyn, Paul Revere, "Hold It Now, Hit It", Brass Monkey, Slow and Low, Time to Get Ill</td>
+      #         </tr>
+      #         <tr>
+      #           <td>Janet Jackson</td>
+      #           <td>Rhythm Nation 1814</td>
+      #           <td>1989</td>
+      #           <td>A&amp;M</td>
+      #           <td>Interlude: Pledge, Rhythm Nation, Interlude: T.V., State of the World, Interlude: Race, The Knowledge, Interlude: Let's Dance, Miss You Much, Interlude: Come Back, Love Will Never Do (Without You), Livin' in a World (They Didn't Make), Alright, Interlude: Hey Baby, Escapade, Interlude: No Acid, Black Cat, Lonely, Come Back to Me, Someday Is Tonight, Interlude: Livin'...In Complete Darkness</td>
+      #         </tr>
+      #       </tbody>
+      #     </table>
+      #
+      #     <hr />
+      #
+      #     <p>Code snippets like <code>var foo = "bar";</code> can be shown inline.</p>
+      #
+      #     <p>Also, <code>this should vertically align</code> <s><code>with this</code></s> <s>and this</s>.</p>
+      #
+      #     <p>Code can also be shown in a block element.</p>
+      #
+      #     <pre><code>var foo = "bar";</code></pre>
+      #
+      #     <p>Code can also use syntax highlighting.</p>
+      #
+      #     <pre><code>var foo = "bar";</code></pre>
+      #
+      #     <pre tabindex="0"><code>Long, single-line code blocks should not wrap. They should horizontally scroll if they are too long. This line should be long enough to demonstrate this.</code></pre>
+      #
+      #     <pre tabindex="0"><code>var foo = "The same thing is true for code with syntax highlighting. A single line of code should horizontally scroll if it is really long.";</code></pre>
+      #
+      #     <p>Inline code inside table cells should still be distinguishable.</p>
+      #
+      #     <table>
+      #       <thead>
+      #         <tr>
+      #           <th>Language</th>
+      #           <th>Code</th>
+      #         </tr>
+      #       </thead>
+      #       <tbody>
+      #         <tr>
+      #           <td>JavasScript</td>
+      #           <td><code>var foo = "bar";</code></td>
+      #         </tr>
+      #         <tr>
+      #           <td>Ruby</td>
+      #           <td><code>foo = "bar"</code></td>
+      #         </tr>
+      #       </tbody>
+      #     </table>
+      #
+      #     <pre><code>This is the final element on the page and there should be no margin below this.</code></pre>
+      #   <% end %>
+      #
+      # @param tag [Symbol] <%= one_of(Primer::Beta::Markdown::TAG_OPTIONS) %>
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      def initialize(tag: DEFAULT_TAG, **system_arguments)
+        @system_arguments = system_arguments
+        @system_arguments[:tag] = fetch_or_fallback(TAG_OPTIONS, tag, DEFAULT_TAG)
+
+        @system_arguments[:classes] = class_names(
+          "markdown-body",
+          system_arguments[:classes]
+        )
+      end
+
+      def call
+        render(Primer::BaseComponent.new(**@system_arguments)) { content }
+      end
+    end
+  end
+end

data/app/components/primer/beta/popover.css.map

@@ -1 +1 @@
-{"version":3,"sources":["popover.pcss"],"names":[],"mappings":"AAEA,SACE,iBAAkB,CAClB,WACF,CAEA,iBAKE,4CAA6C,CAC7C,2EAA6E,CAC7E,mDAAqD,CAHrD,gBAAiB,CADjB,iBAAkB,CAFlB,iBAAkB,CAClB,WA6BF,CArBE,+CAKE,UAAW,CADX,oBAAqB,CADrB,QAAS,CADT,iBAIF,CAEA,wBAIE,sBAAgD,CAAhD,mDAAgD,CAFhD,gBAAiB,CADjB,SAIF,CAEA,uBAIE,sBAAgD,CAAhD,mDAAgD,CAFhD,gBAAiB,CADjB,SAIF,CAKA,mEAEE,YACF,CAOA,mNAGE,yBAAgC,CADhC,QAEF,CAEA,2GAEE,4CAA6C,CAD7C,YAEF,CAEA,wGAEE,4CAA6C,CAD7C,YAEF,CAIF,2DAGE,cAAe,CADf,UAgBF,CAbE,gJAEE,SAAU,CACV,aACF,CAEA,yEACE,UACF,CAEA,uEACE,UACF,CAIF,yDAEE,SAAU,CACV,aAWF,CATE,4IAEE,SAAU,CACV,aACF,CAEA,qEACE,SACF,CAUA,oZAKE,yBAAgC,CAFhC,SAAU,CACV,aAAc,CAFd,OAIF,CAEA,6MACE,eACF,CAEA,uMACE,eACF,CAOA,wGAEE,6CAA8C,CAD9C,WAEF,CAEA,qGAEE,6CAA8C,CAD9C,WAEF,CAOA,qGAEE,8CAA+C,CAD/C,UAEF,CAEA,kGAEE,8CAA+C,CAD/C,UAEF,CAMA,wIAEE,QACF,CAMA,oJAEE,QACF,CAEA,2EACE,WACF,CAEA,yEACE,WACF,CAGF,yBACE,wBACE,eACF,CACF,CAKA,4BACE,SAIE,kBAAoB,CACpB,gBAAkB,CAJlB,cAAe,CAEf,iBAAmB,CADnB,kBAIF,CAEA,iBAGE,WAAY,CACZ,SAAU,CAEV,4CAA8C,CAJ9C,UAAW,CADX,QAAS,CAIT,oBAEF,CAGA,8BACE,wEACF,CAGA,+CAEE,YACF,CACF","file":"popover.css","sourcesContent":["/* Popover */\n\n.Popover {\n  position: absolute;\n  z-index: 100;\n}\n\n.Popover-message {\n  position: relative;\n  width: 232px;\n  margin-right: auto;\n  margin-left: auto;\n  background-color: var(--color-canvas-overlay);\n  border: var(--primer-borderWidth-thin, 1px) solid var(--color-border-default);\n  border-radius: var(--primer-borderRadius-medium, 6px);\n\n  /* Carets */\n  &::before,\n  &::after {\n    position: absolute;\n    left: 50%;\n    display: inline-block;\n    content: '';\n  }\n\n  &::before {\n    top: -16px;\n    margin-left: -9px;\n    border: 8px solid transparent;\n    border-bottom-color: var(--color-border-default);\n  }\n\n  &::after {\n    top: -14px;\n    margin-left: -8px;\n    border: 7px solid transparent;\n    border-bottom-color: var(--color-canvas-overlay);\n  }\n}\n\n/* No caret */\n.Popover-message--no-caret {\n  &::before,\n  &::after {\n    display: none;\n  }\n}\n\n/* Bottom-oriented carets */\n.Popover-message--bottom,\n.Popover-message--bottom-right,\n.Popover-message--bottom-left {\n  &::before,\n  &::after {\n    top: auto;\n    border-bottom-color: transparent;\n  }\n\n  &::before {\n    bottom: -16px;\n    border-top-color: var(--color-border-default);\n  }\n\n  &::after {\n    bottom: -14px;\n    border-top-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Top & Bottom: Right-oriented carets */\n.Popover-message--top-right,\n.Popover-message--bottom-right {\n  right: -9px;\n  margin-right: 0;\n\n  &::before,\n  &::after {\n    left: auto;\n    margin-left: 0;\n  }\n\n  &::before {\n    right: 20px;\n  }\n\n  &::after {\n    right: 21px;\n  }\n}\n\n/* Top & Bottom: Left-oriented carets */\n.Popover-message--top-left,\n.Popover-message--bottom-left {\n  left: -9px;\n  margin-left: 0;\n\n  &::before,\n  &::after {\n    left: 24px;\n    margin-left: 0;\n  }\n\n  &::after {\n    left: 25px;\n  }\n}\n\n/* Right- & Left-oriented carets */\n.Popover-message--right,\n.Popover-message--right-top,\n.Popover-message--right-bottom,\n.Popover-message--left,\n.Popover-message--left-top,\n.Popover-message--left-bottom {\n  &::before,\n  &::after {\n    top: 50%;\n    left: auto;\n    margin-left: 0;\n    border-bottom-color: transparent;\n  }\n\n  &::before {\n    margin-top: -9px;\n  }\n\n  &::after {\n    margin-top: -8px;\n  }\n}\n\n/* Right-oriented carets */\n.Popover-message--right,\n.Popover-message--right-top,\n.Popover-message--right-bottom {\n  &::before {\n    right: -16px;\n    border-left-color: var(--color-border-default);\n  }\n\n  &::after {\n    right: -14px;\n    border-left-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Left-oriented carets */\n.Popover-message--left,\n.Popover-message--left-top,\n.Popover-message--left-bottom {\n  &::before {\n    left: -16px;\n    border-right-color: var(--color-border-default);\n  }\n\n  &::after {\n    left: -14px;\n    border-right-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Right & Left: Top-oriented carets */\n.Popover-message--right-top,\n.Popover-message--left-top {\n  &::before,\n  &::after {\n    top: 24px;\n  }\n}\n\n/* Right & Left: Bottom-oriented carets */\n.Popover-message--right-bottom,\n.Popover-message--left-bottom {\n  &::before,\n  &::after {\n    top: auto;\n  }\n\n  &::before {\n    bottom: 16px;\n  }\n\n  &::after {\n    bottom: 17px;\n  }\n}\n\n@media (min-width: 544px) {\n  .Popover-message--large {\n    min-width: 320px;\n  }\n}\n\n/* Responsive Popover\n** For < md it will show full-width anchored to the bottom */\n\n@media (max-width: 767.98px) {\n  .Popover {\n    position: fixed;\n    top: auto !important;\n    right: 0 !important;\n    bottom: 0 !important;\n    left: 0 !important;\n  }\n\n  .Popover-message {\n    top: auto;\n    right: auto;\n    bottom: auto;\n    left: auto;\n    width: auto !important;\n    margin: var(--primer-stack-gap-condensed, 8px);\n  }\n\n  /* Increase tap area for touch input */\n  .Popover-message > .btn-octicon {\n    padding: var(--primer-control-medium-paddingInline-normal, 12px) !important;\n  }\n\n  /* Remove caret */\n  .Popover-message::after,\n  .Popover-message::before {\n    display: none;\n  }\n}\n"]}
+{"version":3,"sources":["popover.pcss"],"names":[],"mappings":"AAEA,SACE,iBAAkB,CAClB,WACF,CAEA,iBAKE,4CAA6C,CAC7C,2EAA6E,CAC7E,mDAAqD,CAHrD,gBAAiB,CADjB,iBAAkB,CAFlB,iBAAkB,CAClB,WA6BF,CArBE,+CAKE,UAAW,CADX,oBAAqB,CADrB,QAAS,CADT,iBAIF,CAEA,wBAIE,sBAAgD,CAAhD,mDAAgD,CAFhD,gBAAiB,CADjB,SAIF,CAEA,uBAIE,sBAAgD,CAAhD,mDAAgD,CAFhD,gBAAiB,CADjB,SAIF,CAKA,mEAEE,YACF,CAOA,mNAGE,yBAAgC,CADhC,QAEF,CAEA,2GAEE,4CAA6C,CAD7C,YAEF,CAEA,wGAEE,4CAA6C,CAD7C,YAEF,CAIF,2DAGE,cAAe,CADf,UAgBF,CAbE,gJAEE,SAAU,CACV,aACF,CAEA,yEACE,UACF,CAEA,uEACE,UACF,CAIF,yDAEE,SAAU,CACV,aAWF,CATE,4IAEE,SAAU,CACV,aACF,CAEA,qEACE,SACF,CAUA,oZAKE,yBAAgC,CAFhC,SAAU,CACV,aAAc,CAFd,OAIF,CAEA,6MACE,eACF,CAEA,uMACE,eACF,CAOA,wGAEE,6CAA8C,CAD9C,WAEF,CAEA,qGAEE,6CAA8C,CAD9C,WAEF,CAOA,qGAEE,8CAA+C,CAD/C,UAEF,CAEA,kGAEE,8CAA+C,CAD/C,UAEF,CAMA,wIAEE,QACF,CAMA,oJAEE,QACF,CAEA,2EACE,WACF,CAEA,yEACE,WACF,CAGF,yBACE,wBACE,eACF,CACF,CAKA,4BACE,SAIE,kBAAoB,CACpB,gBAAkB,CAJlB,cAAe,CAEf,iBAAmB,CADnB,kBAIF,CAEA,iBAGE,WAAY,CACZ,SAAU,CAEV,4CAA8C,CAJ9C,UAAW,CADX,QAAS,CAIT,oBAEF,CAGA,8BACE,wEACF,CAGA,+CAEE,YACF,CACF","file":"popover.css","sourcesContent":["/* Popover */\n\n.Popover {\n  position: absolute;\n  z-index: 100;\n}\n\n.Popover-message {\n  position: relative;\n  width: 232px;\n  margin-right: auto;\n  margin-left: auto;\n  background-color: var(--color-canvas-overlay);\n  border: var(--primer-borderWidth-thin, 1px) solid var(--color-border-default);\n  border-radius: var(--primer-borderRadius-medium, 6px);\n\n  /* Carets */\n  &::before,\n  &::after {\n    position: absolute;\n    left: 50%;\n    display: inline-block;\n    content: '';\n  }\n\n  &::before {\n    top: -16px;\n    margin-left: -9px;\n    border: 8px solid transparent;\n    border-bottom-color: var(--color-border-default);\n  }\n\n  &::after {\n    top: -14px;\n    margin-left: -8px;\n    border: 7px solid transparent;\n    border-bottom-color: var(--color-canvas-overlay);\n  }\n}\n\n/* No caret */\n.Popover-message--no-caret {\n  &::before,\n  &::after {\n    display: none;\n  }\n}\n\n/* Bottom-oriented carets */\n.Popover-message--bottom,\n.Popover-message--bottom-right,\n.Popover-message--bottom-left {\n  &::before,\n  &::after {\n    top: auto;\n    border-bottom-color: transparent;\n  }\n\n  &::before {\n    bottom: -16px;\n    border-top-color: var(--color-border-default);\n  }\n\n  &::after {\n    bottom: -14px;\n    border-top-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Top and Bottom: Right-oriented carets */\n.Popover-message--top-right,\n.Popover-message--bottom-right {\n  right: -9px;\n  margin-right: 0;\n\n  &::before,\n  &::after {\n    left: auto;\n    margin-left: 0;\n  }\n\n  &::before {\n    right: 20px;\n  }\n\n  &::after {\n    right: 21px;\n  }\n}\n\n/* Top and Bottom: Left-oriented carets */\n.Popover-message--top-left,\n.Popover-message--bottom-left {\n  left: -9px;\n  margin-left: 0;\n\n  &::before,\n  &::after {\n    left: 24px;\n    margin-left: 0;\n  }\n\n  &::after {\n    left: 25px;\n  }\n}\n\n/* Right- and Left-oriented carets */\n.Popover-message--right,\n.Popover-message--right-top,\n.Popover-message--right-bottom,\n.Popover-message--left,\n.Popover-message--left-top,\n.Popover-message--left-bottom {\n  &::before,\n  &::after {\n    top: 50%;\n    left: auto;\n    margin-left: 0;\n    border-bottom-color: transparent;\n  }\n\n  &::before {\n    margin-top: -9px;\n  }\n\n  &::after {\n    margin-top: -8px;\n  }\n}\n\n/* Right-oriented carets */\n.Popover-message--right,\n.Popover-message--right-top,\n.Popover-message--right-bottom {\n  &::before {\n    right: -16px;\n    border-left-color: var(--color-border-default);\n  }\n\n  &::after {\n    right: -14px;\n    border-left-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Left-oriented carets */\n.Popover-message--left,\n.Popover-message--left-top,\n.Popover-message--left-bottom {\n  &::before {\n    left: -16px;\n    border-right-color: var(--color-border-default);\n  }\n\n  &::after {\n    left: -14px;\n    border-right-color: var(--color-canvas-overlay);\n  }\n}\n\n/* Right and Left: Top-oriented carets */\n.Popover-message--right-top,\n.Popover-message--left-top {\n  &::before,\n  &::after {\n    top: 24px;\n  }\n}\n\n/* Right and Left: Bottom-oriented carets */\n.Popover-message--right-bottom,\n.Popover-message--left-bottom {\n  &::before,\n  &::after {\n    top: auto;\n  }\n\n  &::before {\n    bottom: 16px;\n  }\n\n  &::after {\n    bottom: 17px;\n  }\n}\n\n@media (min-width: 544px) {\n  .Popover-message--large {\n    min-width: 320px;\n  }\n}\n\n/* Responsive Popover\n** For < md it will show full-width anchored to the bottom */\n\n@media (max-width: 767.98px) {\n  .Popover {\n    position: fixed;\n    top: auto !important;\n    right: 0 !important;\n    bottom: 0 !important;\n    left: 0 !important;\n  }\n\n  .Popover-message {\n    top: auto;\n    right: auto;\n    bottom: auto;\n    left: auto;\n    width: auto !important;\n    margin: var(--primer-stack-gap-condensed, 8px);\n  }\n\n  /* Increase tap area for touch input */\n  .Popover-message > .btn-octicon {\n    padding: var(--primer-control-medium-paddingInline-normal, 12px) !important;\n  }\n\n  /* Remove caret */\n  .Popover-message::after,\n  .Popover-message::before {\n    display: none;\n  }\n}\n"]}

data/app/components/primer/beta/popover.pcss

@@ -67,7 +67,7 @@
   }
 }
 
-/* Top & Bottom: Right-oriented carets */
+/* Top and Bottom: Right-oriented carets */
 .Popover-message--top-right,
 .Popover-message--bottom-right {
   right: -9px;
@@ -88,7 +88,7 @@
   }
 }
 
-/* Top & Bottom: Left-oriented carets */
+/* Top and Bottom: Left-oriented carets */
 .Popover-message--top-left,
 .Popover-message--bottom-left {
   left: -9px;
@@ -105,7 +105,7 @@
   }
 }
 
-/* Right- & Left-oriented carets */
+/* Right- and Left-oriented carets */
 .Popover-message--right,
 .Popover-message--right-top,
 .Popover-message--right-bottom,
@@ -159,7 +159,7 @@
   }
 }
 
-/* Right & Left: Top-oriented carets */
+/* Right and Left: Top-oriented carets */
 .Popover-message--right-top,
 .Popover-message--left-top {
   &::before,
@@ -168,7 +168,7 @@
   }
 }
 
-/* Right & Left: Bottom-oriented carets */
+/* Right and Left: Bottom-oriented carets */
 .Popover-message--right-bottom,
 .Popover-message--left-bottom {
   &::before,

data/app/components/primer/beta/relative_time.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+module Primer
+  module Beta
+    # Formats a timestamp as a localized string or as relative text that auto-updates in the user's browser.
+    class RelativeTime < Primer::Component
+      status :beta
+
+      TENSE_DEFAULT = :auto
+      TENSE_OPTIONS = [TENSE_DEFAULT, :past, :future].freeze
+
+      FORMAT_DEFAULT = :auto
+      FORMAT_OPTIONS = [FORMAT_DEFAULT, :micro, :elapsed].freeze
+
+      SECOND_DEFAULT = nil
+      SECOND_MAPPINGS = {
+        SECOND_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit"
+      }.freeze
+      SECOND_OPTIONS = SECOND_MAPPINGS.keys
+
+      MINUTE_DEFAULT = nil
+      MINUTE_MAPPINGS = {
+        MINUTE_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit"
+      }.freeze
+      MINUTE_OPTIONS = MINUTE_MAPPINGS.keys
+
+      HOUR_DEFAULT = nil
+      HOUR_MAPPINGS = {
+        HOUR_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit"
+      }.freeze
+      HOUR_OPTIONS = HOUR_MAPPINGS.keys
+
+      WEEKDAY_DEFAULT = nil
+      WEEKDAY_OPTIONS = [WEEKDAY_DEFAULT, :long, :short, :narrow].freeze
+
+      DAY_DEFAULT = nil
+      DAY_MAPPINGS = {
+        DAY_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit"
+      }.freeze
+      DAY_OPTIONS = DAY_MAPPINGS.keys
+
+      MONTH_DEFAULT = nil
+      MONTH_MAPPINGS = {
+        DAY_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit",
+        :short => "short",
+        :long => "long",
+        :narrow => "narrow"
+      }.freeze
+      MONTH_OPTIONS = MONTH_MAPPINGS.keys
+
+      YEAR_DEFAULT = nil
+      YEAR_MAPPINGS = {
+        DAY_DEFAULT => nil,
+        :numeric => "numeric",
+        :two_digit => "2-digit"
+      }.freeze
+      YEAR_OPTIONS = YEAR_MAPPINGS.keys
+
+      TIMEZONENAME_DEFAULT = nil
+      TIMEZONE_MAPPINGS = {
+        DAY_DEFAULT => nil,
+        :long => "long",
+        :short => "short",
+        :short_offset => "shortOffset",
+        :long_offset => "longOffset",
+        :short_generic => "shortGeneric",
+        :long_generic => "longGeneric"
+      }.freeze
+      TIMEZONENAME_OPTIONS = TIMEZONE_MAPPINGS.keys
+
+      PRECISION_DEFAULT = nil
+      PRECISION_OPTIONS = [PRECISION_DEFAULT, :second, :minute, :hour, :day, :month, :year].freeze
+
+      # @example Default
+      #   <%= render(Primer::Beta::RelativeTime.new(datetime: Time.at(628232400))) %>
+      #
+      # @example Past Time
+      #   <%= render(Primer::Beta::RelativeTime.new(datetime: Time.at(628232400), tense: :past)) %>
+      #
+      # @example Elapsed Time
+      #   <%= render(Primer::Beta::RelativeTime.new(datetime: Time.at(628232400), format: :elapsed)) %>
+      #
+      # @param datetime [Time] The time to be formatted.
+      # @param tense [Symbol] Which tense to use. <%= one_of(Primer::Beta::RelativeTime::TENSE_OPTIONS) %>
+      # @param prefix [sring] What to prefix the relative ime display with.
+      # @param second [Symbol] What format seconds should take. <%= one_of(Primer::Beta::RelativeTime::SECOND_OPTIONS) %>
+      # @param minute [Symbol] What format minues should take. <%= one_of(Primer::Beta::RelativeTime::MINUTE_OPTIONS) %>
+      # @param hour [Symbol] What format hours should take. <%= one_of(Primer::Beta::RelativeTime::HOUR_OPTIONS) %>
+      # @param weekday [Symbol] What format weekdays should take. <%= one_of(Primer::Beta::RelativeTime::WEEKDAY_OPTIONS) %>
+      # @param day [Symbol] What format days should take. <%= one_of(Primer::Beta::RelativeTime::DAY_OPTIONS) %>
+      # @param month [Symbol] What format months should take. <%= one_of(Primer::Beta::RelativeTime::MONTH_OPTIONS) %>
+      # @param year [Symbol] What format years should take. <%= one_of(Primer::Beta::RelativeTime::YEAR_OPTIONS) %>
+      # @param time_zone_name [Symbol] What format the time zone should take. <%= one_of(Primer::Beta::RelativeTime::TIMEZONENAME_OPTIONS) %>
+      # @param threshold [string] The threshold at which relative time displays become absolute.
+      # @param precision [Symbol] The precision elapsed time should display. <%= one_of(Primer::Beta::RelativeTime::PRECISION_OPTIONS) %>
+      # @param format [Symbol] The format the display should take. <%= one_of(Primer::Beta::RelativeTime::FORMAT_OPTIONS) %>
+      # @param lang [string] The language to use.
+      # @param title [string] Provide a custom title to the element.
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      def initialize(
+        datetime:,
+        tense: TENSE_DEFAULT,
+        prefix: nil,
+        second: SECOND_DEFAULT,
+        minute: MINUTE_DEFAULT,
+        hour: HOUR_DEFAULT,
+        weekday: WEEKDAY_DEFAULT,
+        day: DAY_DEFAULT,
+        month: MONTH_DEFAULT,
+        year: YEAR_DEFAULT,
+        time_zone_name: TIMEZONENAME_DEFAULT,
+        threshold: nil,
+        precision: PRECISION_DEFAULT,
+        format: nil,
+        lang: nil,
+        title: nil,
+        **system_arguments
+      )
+        @system_arguments = deny_tag_argument(**system_arguments)
+        @system_arguments[:tag] = "relative-time"
+        @system_arguments[:tense] = tense if tense.present?
+        @system_arguments[:prefix] = prefix if prefix.present?
+        @system_arguments[:second] = fetch_or_fallback(SECOND_OPTIONS, second, SECOND_DEFAULT) if second.present?
+        @system_arguments[:minute] = fetch_or_fallback(MINUTE_OPTIONS, minute, MINUTE_DEFAULT) if minute.present?
+        @system_arguments[:hour] = fetch_or_fallback(HOUR_OPTIONS, hour, HOUR_DEFAULT) if hour.present?
+        @system_arguments[:weekday] = fetch_or_fallback(WEEKDAY_OPTIONS, weekday, WEEKDAY_DEFAULT) if weekday.present?
+        @system_arguments[:day] = fetch_or_fallback(DAY_OPTIONS, day, DAY_DEFAULT) if day.present?
+        @system_arguments[:month] = fetch_or_fallback(MONTH_DEFAULT, month, MONTH_DEFAULT) if month.present?
+        @system_arguments[:year] = fetch_or_fallback(YEAR_OPTIONS, year, YEAR_DEFAULT) if year.present?
+        @system_arguments[:"time-zone-name"] = fetch_or_fallback(TIMEZONENAME_OPTIONS, time_zone_name, TIMEZONENAME_DEFAULT) if time_zone_name.present?
+        @system_arguments[:threshold] = threshold if threshold.present?
+        @system_arguments[:precision] = precision if precision.present?
+        @system_arguments[:title] = title if title.present?
+        @system_arguments[:lang] = lang if lang.present?
+        @system_arguments[:format] = fetch_or_fallback(FORMAT_OPTIONS, format, FORMAT_DEFAULT) if format.present?
+        if datetime.present? && datetime.respond_to?(:iso8601)
+          @datetime = datetime
+          @system_arguments[:datetime] = datetime.iso8601
+        elsif datetime.present?
+          @datetime = Time.iso8601 datetime
+          @system_arguments[:datetime] = @datetime
+        end
+      end
+
+      def call
+        render(Primer::BaseComponent.new(**@system_arguments).with_content(@datetime.strftime("%B %-d, %Y %H:%M")))
+      end
+    end
+  end
+end

data/app/components/primer/button_component.rb

@@ -3,7 +3,7 @@
 module Primer
   # Use `Button` for actions (e.g. in forms). Use links for destinations, or moving from one page to another.
   class ButtonComponent < Primer::Component
-    status :beta
+    status :deprecated
 
     DEFAULT_SCHEME = :default
     LINK_SCHEME = :link