primer_view_components 0.0.123 → 0.1.0

data/app/components/primer/alpha/overlay.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+module Primer
+  module Alpha
+    # Overlay components codify design patterns related to floating surfaces such
+    # as dialogs and menus. They are private components intended to be used by
+    # specialized components, and mostly contain presentational logic and
+    # behavior.
+    #
+    # @accessibility
+    #   - **Overlay Accessible Name**: An overlay should have an accessible name,
+    #   so screen readers are aware of the purpose of the Overlay when it opens.
+    #   Give an accessible name setting `:title`. The accessible name will be
+    #   used as the main heading inside the Overlay.
+    #   - **Overlay unique id**: A Overlay should be unique. Give a unique id
+    #   setting `:id`. If no `:id` is given, a default randomize hex id is
+    #   generated.
+    #
+    #   The combination of both `:title` and `:id` establishes an
+    #   `aria-labelledby` relationship between the title and the unique id
+    #   of the Overlay.
+    class Overlay < Primer::Component
+      DEFAULT_PADDING = :normal
+      PADDING_MAPPINGS = {
+        DEFAULT_PADDING => nil,
+        :condensed => "Overlay-body--paddingCondensed",
+        :none => "Overlay-body--paddingNone"
+      }.freeze
+
+      PADDING_OPTIONS = PADDING_MAPPINGS.keys
+
+      DEFAULT_SIZE = :auto
+      SIZE_MAPPINGS = {
+        DEFAULT_SIZE => "Overlay--size-auto",
+        :small => "Overlay--size-small",
+        :medium => "Overlay--size-medium",
+        :medium_portrait => "Overlay--size-medium-portrait",
+        :large => "Overlay--size-large",
+        :xlarge => "Overlay--size-xlarge"
+      }.freeze
+      SIZE_OPTIONS = SIZE_MAPPINGS.keys
+
+      DEFAULT_ANCHOR_ALIGN = :start
+      ANCHOR_ALIGN_OPTIONS = [DEFAULT_ANCHOR_ALIGN, :center, :end].freeze
+
+      DEFAULT_ANCHOR_OFFSET = :normal
+      ANCHOR_OFFSET_OPTIONS = [DEFAULT_ANCHOR_OFFSET, :spacious].freeze
+
+      DEFAULT_ANCHOR_SIDE = :outside_bottom
+      ANCHOR_SIDE_MAPPINGS = {
+        :inside_top => "inside-top",
+        :inside_bottom => "inside-bottom",
+        :inside_left => "inside-left",
+        :inside_right => "inside-right",
+        :inside_center => "inside-center",
+        :outside_top => "outside-top",
+        DEFAULT_ANCHOR_SIDE => "outside-bottom",
+        :outside_left => "outside-left",
+        :outside_right => "outside-right"
+      }.freeze
+      ANCHOR_SIDE_OPTIONS = ANCHOR_SIDE_MAPPINGS.keys
+
+      DEFAULT_POPOVER = :auto
+      POPOVER_OPTIONS = [DEFAULT_POPOVER, :manual].freeze
+
+      ROLE_OPTIONS = [:dialog, :menu].freeze
+
+      # Optional button to open the Overlay.
+      #
+      # @param system_arguments [Hash] The same arguments as <%= link_to_component(Primer::ButtonComponent) %>.
+      renders_one :show_button, lambda { |**system_arguments|
+        system_arguments[:classes] = class_names(
+          system_arguments[:classes]
+        )
+        system_arguments[:id] = "overlay-show-#{@system_arguments[:id]}"
+        system_arguments["popovertoggletarget"] = @system_arguments[:id]
+        system_arguments[:data] = (system_arguments[:data] || {}).merge({ "show-dialog-id": @system_arguments[:id] })
+        Primer::Beta::Button.new(**system_arguments)
+      }
+
+      # Header content.
+      #
+      # @param divider [Boolean] Show a divider between the header and body.
+      # @param visually_hide_title [Boolean] Visually hide the `title` while maintaining a label for assistive technologies.
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      renders_one :header, lambda { |divider: false, size: :medium, visually_hide_title: @visually_hide_title, **system_arguments|
+        Primer::Alpha::Overlay::Header.new(
+          id: @id,
+          title: @title,
+          subtitle: @subtitle,
+          size: size,
+          divider: divider,
+          visually_hide_title: visually_hide_title,
+          **system_arguments
+        )
+      }
+
+      # Required body content.
+      #
+      # @param padding [Symbol] The padding. <%= one_of(Primer::Alpha::Overlay::PADDING_OPTIONS) %>
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      renders_one :body, lambda { |padding: @padding, **system_arguments|
+        Primer::Alpha::Overlay::Body.new(
+          padding: padding,
+          **system_arguments
+        )
+      }
+
+      # Footer content.
+      #
+      # @param show_divider [Boolean] Show a divider between the footer and body.
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      renders_one :footer, "Footer"
+
+      # @example Overlay with Cancel and Submit buttons
+      #   @description
+      #     An ID is provided which enables wiring of the open and close buttons to the Overlay.
+      #   @code
+      #     <%= render(Primer::Alpha::Overlay.new(
+      #       title: "Overlay Example",
+      #       id: "my-Overlay",
+      #       role: :dialog,
+      #     )) do |d| %>
+      #       <% d.with_show_button { "Show Overlay" } %>
+      #       <% d.with_body do %>
+      #         <p>Some content</p>
+      #       <% end %>
+      #     <% end %>
+      # @param id [String] The id of the Overlay.
+      # @param title [String] Describes the content of the Overlay.
+      # @param subtitle [String] Provides dditional context for the Overlay, also setting the `aria-describedby` attribute.
+      # @param popover [Symbol] The popover behaviour. <%= one_of(Primer::Alpha::Overlay::POPOVER_OPTIONS) %>
+      # @param popover [Symbol] The popover behaviour. <%= one_of(Primer::Alpha::Overlay::POPOVER_OPTIONS) %>
+      # @param size [Symbol] The size of the Overlay. <%= one_of(Primer::Alpha::Overlay::SIZE_OPTIONS) %>
+      # @param padding [Symbol] The padding given to the Overlay body. <%= one_of(Primer::Alpha::Overlay::PADDING_OPTIONS) %>
+      # @param anchor [String] An ID of the element to anchor onto. Defaults to the `show_button`.
+      # @param anchor_align [Symbol] The anchor alignment of the Overlay. <%= one_of(Primer::Alpha::Overlay::ANCHOR_ALIGN_OPTIONS) %>
+      # @param anchor_side [Symbol] The side to anchor the Overlay to. <%= one_of(Primer::Alpha::Overlay::ANCHOR_SIDE_OPTIONS) %>
+      # @param anchor_offset [Symbol] The anchor offset to give the Overlay. <%= one_of(Primer::Alpha::Overlay::ANCHOR_OFFSET_OPTIONS) %>
+      # @param allow_out_of_bounds [Boolean] Allow the Overlay to overflow its container.
+      # @param visually_hide_title [Boolean] If true will hide the heading title, while still making it available to Screen Readers.
+      # @param role [String] The ARIA role. <%= one_of(Primer::Alpha::Overlay::ROLE_OPTIONS) %>
+      # @param system_arguments [Hash] <%= link_to_system_arguments_docs %>
+      def initialize(
+        title:,
+        role:,
+        subtitle: nil,
+        popover: DEFAULT_POPOVER,
+        size: DEFAULT_SIZE,
+        padding: DEFAULT_PADDING,
+        anchor: nil,
+        anchor_align: DEFAULT_ANCHOR_ALIGN,
+        anchor_offset: DEFAULT_ANCHOR_OFFSET,
+        anchor_side: DEFAULT_ANCHOR_SIDE,
+        allow_out_of_bounds: false,
+        visually_hide_title: false,
+        id: self.class.generate_id,
+        **system_arguments
+      )
+        @system_arguments = deny_tag_argument(**system_arguments)
+
+        @system_arguments[:role] = fetch_or_fallback(ROLE_OPTIONS, role)
+
+        @system_arguments[:id] = id.to_s
+        @system_arguments[:classes] = class_names(
+          "Overlay",
+          SIZE_MAPPINGS[fetch_or_fallback(SIZE_OPTIONS, size, DEFAULT_SIZE)],
+          "Overlay--motion-scaleFade",
+          system_arguments[:classes]
+        )
+        @system_arguments[:tag] = "anchored-position"
+        @system_arguments[:anchor] = anchor || "overlay-show-#{@system_arguments[:id]}"
+        @system_arguments[:align] = fetch_or_fallback(ANCHOR_ALIGN_OPTIONS, anchor_align, DEFAULT_ANCHOR_ALIGN)
+        @system_arguments[:side] = ANCHOR_SIDE_MAPPINGS[fetch_or_fallback(ANCHOR_SIDE_OPTIONS, anchor_side, DEFAULT_ANCHOR_SIDE)]
+        @system_arguments["anchor-offset"] = fetch_or_fallback(ANCHOR_OFFSET_OPTIONS, anchor_offset, DEFAULT_ANCHOR_OFFSET)
+        @system_arguments["allow-out-of-bounds"] = true if allow_out_of_bounds
+        @id = id.to_s
+        @title = title
+        @subtitle = subtitle
+        @visually_hide_title = visually_hide_title
+        @padding = padding
+
+        @system_arguments[:popover] = popover
+        @system_arguments[:aria] ||= {}
+        @system_arguments[:aria][:describedby] ||= "#{@id}-description"
+      end
+
+      def before_render
+        with_header unless header?
+        with_body unless body?
+      end
+    end
+  end
+end

data/app/components/primer/alpha/segmented_control.css.json

@@ -27,5 +27,20 @@
     ".SegmentedControl--fullWidth .SegmentedControl-item",
     ".SegmentedControl--fullWidth .Button--iconOnly",
     ".SegmentedControl--fullWidth .Button-withTooltip"
+  ],
+  "classes": [
+    "SegmentedControl",
+    "SegmentedControl-item",
+    "SegmentedControl-item--selected",
+    "Button",
+    "Button-label",
+    "Button--small",
+    "Button--iconOnly",
+    "Button--medium",
+    "Button--large",
+    "Button--invisible",
+    "Button--invisible-noVisuals",
+    "SegmentedControl--fullWidth",
+    "Button-withTooltip"
   ]
 }

data/app/components/primer/alpha/tab_nav.css.json

@@ -20,5 +20,15 @@
     ".tabnav-extra>.octicon",
     "a.tabnav-extra:hover",
     ".tabnav-btn"
+  ],
+  "classes": [
+    "tabnav",
+    "tabnav-tabs",
+    "tabnav-tab",
+    "selected",
+    "octicon",
+    "Counter",
+    "tabnav-extra",
+    "tabnav-btn"
   ]
 }

data/app/components/primer/alpha/text_field.css.json

@@ -130,5 +130,43 @@
     "input.FormControl-radio[type=radio]:checked",
     "input.FormControl-radio[type=radio]:checked:disabled",
     "input.FormControl-radio[type=radio]:focus-visible"
+  ],
+  "classes": [
+    "FormControl",
+    "FormControl--fullWidth",
+    "FormControl-label",
+    "FormControl-caption",
+    "FormControl-inlineValidation",
+    "FormControl-spacingWrapper",
+    "FormControl-horizontalGroup",
+    "FormControl-input",
+    "FormControl-select",
+    "FormControl-textarea",
+    "FormControl-small",
+    "FormControl-medium",
+    "FormControl-large",
+    "FormControl-inset",
+    "FormControl-monospace",
+    "FormControl-error",
+    "FormControl-success",
+    "FormControl-warning",
+    "FormControl-toggleSwitchInput",
+    "FormControl-input-wrap",
+    "FormControl-input-leadingVisualWrap",
+    "FormControl-input-leadingVisual",
+    "FormControl-input-trailingAction",
+    "FormControl-input-trailingAction--divider",
+    "FormControl-input-wrap--leadingVisual",
+    "FormControl-input-wrap--trailingAction",
+    "FormControl-input-wrap-trailingAction--divider",
+    "FormControl-select-wrap",
+    "FormControl-checkbox-wrap",
+    "FormControl-radio-wrap",
+    "FormControl-checkbox-labelWrap",
+    "FormControl-radio-labelWrap",
+    "FormControl-check-group-wrap",
+    "FormControl-radio-group-wrap",
+    "FormControl-checkbox",
+    "FormControl-radio"
   ]
 }

data/app/components/primer/alpha/toggle_switch.css.json

@@ -36,5 +36,21 @@
     ".ToggleSwitch-statusOff",
     ".ToggleSwitch--statusAtEnd",
     ".ToggleSwitch--statusAtEnd .ToggleSwitch-status"
+  ],
+  "classes": [
+    "ToggleSwitch",
+    "ToggleSwitch--checked",
+    "ToggleSwitch-statusOn",
+    "ToggleSwitch-statusOff",
+    "ToggleSwitch-track",
+    "ToggleSwitch-knob",
+    "ToggleSwitch-lineIcon",
+    "ToggleSwitch-circleIcon",
+    "ToggleSwitch-icons",
+    "ToggleSwitch-status",
+    "ToggleSwitch-statusIcon",
+    "ToggleSwitch--small",
+    "ToggleSwitch--disabled",
+    "ToggleSwitch--statusAtEnd"
   ]
 }

data/app/components/primer/alpha/underline_nav.css.json

@@ -24,5 +24,18 @@
     ".UnderlineNav--full .UnderlineNav-body",
     ".UnderlineNav-octicon",
     ".UnderlineNav-container"
+  ],
+  "classes": [
+    "UnderlineNav",
+    "Counter",
+    "Counter--primary",
+    "UnderlineNav-body",
+    "UnderlineNav-item",
+    "selected",
+    "UnderlineNav--right",
+    "UnderlineNav-actions",
+    "UnderlineNav--full",
+    "UnderlineNav-octicon",
+    "UnderlineNav-container"
   ]
 }

data/app/components/primer/anchored_position.d.ts

@@ -0,0 +1,27 @@
+import type { AnchorAlignment, AnchorSide, PositionSettings } from '@primer/behaviors';
+export default class AnchoredPositionElement extends HTMLElement implements PositionSettings {
+    #private;
+    get align(): AnchorAlignment;
+    set align(value: AnchorAlignment);
+    get side(): AnchorSide;
+    set side(value: AnchorSide);
+    get anchorOffset(): number;
+    set anchorOffset(value: number | 'normal' | 'spacious');
+    get anchor(): string;
+    set anchor(value: string);
+    get anchorElement(): HTMLElement | null;
+    set anchorElement(value: HTMLElement | null);
+    get alignmentOffset(): number;
+    set alignmentOffset(value: number);
+    get allowOutOfBounds(): boolean;
+    set allowOutOfBounds(value: boolean);
+    connectedCallback(): void;
+    static observedAttributes: string[];
+    attributeChangedCallback(): void;
+    update(): void;
+}
+declare global {
+    interface Window {
+        AnchoredPositionElement: typeof AnchoredPositionElement;
+    }
+}

data/app/components/primer/anchored_position.js

@@ -0,0 +1,149 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _AnchoredPositionElement_anchorElement, _AnchoredPositionElement_animationFrame;
+import { getAnchoredPosition } from '@primer/behaviors';
+const updateWhenVisible = (() => {
+    const anchors = new Set();
+    let intersectionObserver = null;
+    let resizeObserver = null;
+    function updateVisibleAnchors() {
+        for (const anchor of anchors) {
+            anchor.update();
+        }
+    }
+    return (el) => {
+        // eslint-disable-next-line github/prefer-observers
+        window.addEventListener('resize', updateVisibleAnchors);
+        intersectionObserver || (intersectionObserver = new IntersectionObserver(entries => {
+            for (const entry of entries) {
+                const target = entry.target;
+                if (entry.isIntersecting) {
+                    target.update();
+                    anchors.add(target);
+                }
+                else {
+                    anchors.delete(target);
+                }
+            }
+        }));
+        resizeObserver || (resizeObserver = new ResizeObserver(() => {
+            for (const anchor of anchors) {
+                anchor.update();
+            }
+        }));
+        resizeObserver.observe(el.ownerDocument.documentElement);
+        intersectionObserver.observe(el);
+    };
+})();
+export default class AnchoredPositionElement extends HTMLElement {
+    constructor() {
+        super(...arguments);
+        _AnchoredPositionElement_anchorElement.set(this, null);
+        _AnchoredPositionElement_animationFrame.set(this, void 0);
+    }
+    get align() {
+        const value = this.getAttribute('align');
+        if (value === 'center' || value === 'end')
+            return value;
+        return 'start';
+    }
+    set align(value) {
+        this.setAttribute('align', `${value}`);
+    }
+    get side() {
+        const value = this.getAttribute('side');
+        if (value === 'inside-top' ||
+            value === 'inside-bottom' ||
+            value === 'inside-left' ||
+            value === 'inside-right' ||
+            value === 'inside-center' ||
+            value === 'outside-top' ||
+            value === 'outside-left' ||
+            value === 'outside-right') {
+            return value;
+        }
+        return 'outside-bottom';
+    }
+    set side(value) {
+        this.setAttribute('side', `${value}`);
+    }
+    get anchorOffset() {
+        const alias = this.getAttribute('anchor-offset');
+        if (alias === 'spacious' || alias === '8')
+            return 8;
+        return 4;
+    }
+    set anchorOffset(value) {
+        this.setAttribute('anchor-offset', `${value}`);
+    }
+    get anchor() {
+        return this.getAttribute('anchor') || '';
+    }
+    set anchor(value) {
+        this.setAttribute('anchor', `${value}`);
+    }
+    get anchorElement() {
+        if (__classPrivateFieldGet(this, _AnchoredPositionElement_anchorElement, "f"))
+            return __classPrivateFieldGet(this, _AnchoredPositionElement_anchorElement, "f");
+        const idRef = this.anchor;
+        if (!idRef)
+            return null;
+        return this.ownerDocument.getElementById(idRef);
+    }
+    set anchorElement(value) {
+        __classPrivateFieldSet(this, _AnchoredPositionElement_anchorElement, value, "f");
+        if (!__classPrivateFieldGet(this, _AnchoredPositionElement_anchorElement, "f")) {
+            this.removeAttribute('anchor');
+        }
+    }
+    get alignmentOffset() {
+        return Number(this.getAttribute('alignment-offset'));
+    }
+    set alignmentOffset(value) {
+        this.setAttribute('alignment-offset', `${value}`);
+    }
+    get allowOutOfBounds() {
+        return this.hasAttribute('allow-out-of-bounds');
+    }
+    set allowOutOfBounds(value) {
+        this.toggleAttribute('allow-out-of-bounds', value);
+    }
+    connectedCallback() {
+        this.update();
+        this.addEventListener('beforetoggle', () => this.update());
+        updateWhenVisible(this);
+    }
+    attributeChangedCallback() {
+        this.update();
+    }
+    update() {
+        if (!this.isConnected)
+            return;
+        cancelAnimationFrame(__classPrivateFieldGet(this, _AnchoredPositionElement_animationFrame, "f"));
+        __classPrivateFieldSet(this, _AnchoredPositionElement_animationFrame, requestAnimationFrame(() => {
+            const anchor = this.anchorElement;
+            if (!anchor)
+                return;
+            const { left, top, anchorSide, anchorAlign } = getAnchoredPosition(this, anchor, this);
+            this.style.top = `${top}px`;
+            this.style.left = `${left}px`;
+            this.classList.remove('Overlay--anchorAlign-start', 'Overlay--anchorAlign-center', 'Overlay--anchorAlign-end', 'Overlay--anchorSide-insideTop', 'Overlay--anchorSide-insideBottom', 'Overlay--anchorSide-insideLeft', 'Overlay--anchorSide-insideRight', 'Overlay--anchorSide-insideCenter', 'Overlay--anchorSide-outsideTop', 'Overlay--anchorSide-outsideLeft', 'Overlay--anchorSide-outsideRight');
+            this.classList.add(`Overlay--anchorAlign-${anchorAlign}`, `Overlay--anchorSide-${anchorSide}`);
+        }), "f");
+    }
+}
+_AnchoredPositionElement_anchorElement = new WeakMap(), _AnchoredPositionElement_animationFrame = new WeakMap();
+AnchoredPositionElement.observedAttributes = ['align', 'side', 'anchor', 'alignment-offset', 'allow-out-of-bounds'];
+if (!customElements.get('anchored-position')) {
+    window.AnchoredPositionElement = AnchoredPositionElement;
+    customElements.define('anchored-position', AnchoredPositionElement);
+}

data/app/components/primer/anchored_position.ts

@@ -0,0 +1,167 @@
+import type {AnchorAlignment, AnchorSide, PositionSettings} from '@primer/behaviors'
+import {getAnchoredPosition} from '@primer/behaviors'
+
+const updateWhenVisible = (() => {
+  const anchors = new Set<AnchoredPositionElement>()
+  let intersectionObserver: IntersectionObserver | null = null
+  let resizeObserver: ResizeObserver | null = null
+  function updateVisibleAnchors() {
+    for (const anchor of anchors) {
+      anchor.update()
+    }
+  }
+  return (el: AnchoredPositionElement) => {
+    // eslint-disable-next-line github/prefer-observers
+    window.addEventListener('resize', updateVisibleAnchors)
+    intersectionObserver ||= new IntersectionObserver(entries => {
+      for (const entry of entries) {
+        const target = entry.target as AnchoredPositionElement
+        if (entry.isIntersecting) {
+          target.update()
+          anchors.add(target)
+        } else {
+          anchors.delete(target)
+        }
+      }
+    })
+    resizeObserver ||= new ResizeObserver(() => {
+      for (const anchor of anchors) {
+        anchor.update()
+      }
+    })
+    resizeObserver.observe(el.ownerDocument.documentElement)
+    intersectionObserver.observe(el)
+  }
+})()
+
+export default class AnchoredPositionElement extends HTMLElement implements PositionSettings {
+  get align(): AnchorAlignment {
+    const value = this.getAttribute('align')
+    if (value === 'center' || value === 'end') return value
+    return 'start'
+  }
+
+  set align(value: AnchorAlignment) {
+    this.setAttribute('align', `${value}`)
+  }
+
+  get side(): AnchorSide {
+    const value = this.getAttribute('side')
+    if (
+      value === 'inside-top' ||
+      value === 'inside-bottom' ||
+      value === 'inside-left' ||
+      value === 'inside-right' ||
+      value === 'inside-center' ||
+      value === 'outside-top' ||
+      value === 'outside-left' ||
+      value === 'outside-right'
+    ) {
+      return value
+    }
+    return 'outside-bottom'
+  }
+
+  set side(value: AnchorSide) {
+    this.setAttribute('side', `${value}`)
+  }
+
+  get anchorOffset(): number {
+    const alias = this.getAttribute('anchor-offset')
+    if (alias === 'spacious' || alias === '8') return 8
+    return 4
+  }
+
+  set anchorOffset(value: number | 'normal' | 'spacious') {
+    this.setAttribute('anchor-offset', `${value}`)
+  }
+
+  get anchor() {
+    return this.getAttribute('anchor') || ''
+  }
+
+  set anchor(value: string) {
+    this.setAttribute('anchor', `${value}`)
+  }
+
+  #anchorElement: HTMLElement | null = null
+  get anchorElement(): HTMLElement | null {
+    if (this.#anchorElement) return this.#anchorElement
+    const idRef = this.anchor
+    if (!idRef) return null
+    return this.ownerDocument.getElementById(idRef)
+  }
+
+  set anchorElement(value: HTMLElement | null) {
+    this.#anchorElement = value
+    if (!this.#anchorElement) {
+      this.removeAttribute('anchor')
+    }
+  }
+
+  get alignmentOffset(): number {
+    return Number(this.getAttribute('alignment-offset'))
+  }
+
+  set alignmentOffset(value: number) {
+    this.setAttribute('alignment-offset', `${value}`)
+  }
+
+  get allowOutOfBounds() {
+    return this.hasAttribute('allow-out-of-bounds')
+  }
+
+  set allowOutOfBounds(value: boolean) {
+    this.toggleAttribute('allow-out-of-bounds', value)
+  }
+
+  connectedCallback() {
+    this.update()
+    this.addEventListener('beforetoggle', () => this.update())
+    updateWhenVisible(this)
+  }
+
+  static observedAttributes = ['align', 'side', 'anchor', 'alignment-offset', 'allow-out-of-bounds']
+  attributeChangedCallback() {
+    this.update()
+  }
+
+  #animationFrame: ReturnType<typeof requestAnimationFrame>
+  update() {
+    if (!this.isConnected) return
+    cancelAnimationFrame(this.#animationFrame)
+
+    this.#animationFrame = requestAnimationFrame(() => {
+      const anchor = this.anchorElement
+      if (!anchor) return
+      const {left, top, anchorSide, anchorAlign} = getAnchoredPosition(this, anchor, this)
+      this.style.top = `${top}px`
+      this.style.left = `${left}px`
+      this.classList.remove(
+        'Overlay--anchorAlign-start',
+        'Overlay--anchorAlign-center',
+        'Overlay--anchorAlign-end',
+        'Overlay--anchorSide-insideTop',
+        'Overlay--anchorSide-insideBottom',
+        'Overlay--anchorSide-insideLeft',
+        'Overlay--anchorSide-insideRight',
+        'Overlay--anchorSide-insideCenter',
+        'Overlay--anchorSide-outsideTop',
+        'Overlay--anchorSide-outsideLeft',
+        'Overlay--anchorSide-outsideRight'
+      )
+      this.classList.add(`Overlay--anchorAlign-${anchorAlign}`, `Overlay--anchorSide-${anchorSide}`)
+    })
+  }
+}
+
+if (!customElements.get('anchored-position')) {
+  window.AnchoredPositionElement = AnchoredPositionElement
+  customElements.define('anchored-position', AnchoredPositionElement)
+}
+
+declare global {
+  interface Window {
+    AnchoredPositionElement: typeof AnchoredPositionElement
+  }
+}

data/app/components/primer/beta/avatar.css.json

@@ -13,5 +13,19 @@
     ".avatar-6",
     ".avatar-7",
     ".avatar-8"
+  ],
+  "classes": [
+    "avatar",
+    "avatar-link",
+    "avatar-group-item",
+    "avatar-1",
+    "avatar-2",
+    "avatar-small",
+    "avatar-3",
+    "avatar-4",
+    "avatar-5",
+    "avatar-6",
+    "avatar-7",
+    "avatar-8"
   ]
 }