v36.x Release

[joshblack]

Note
This planning discussion is currently a work in progress. Everything listed here is subject to change

This discussion contains all the proposals for the upcoming v36.x release for @primer/react. Each topic will be summarized in the comment section below.

Proposed

• Components
  • AvatarToken
    • Update AvatarTokenProps props to only accept 'large' and 'xlarge'
  • SegmentedControl
    • Remove SegmentedControl from drafts
  • SelectPanel
    • Apply SelectPanel a11y remediations (this commit includes the changes but it is reverted from master so we need to re-apply it and close this issue as it won't be needed after applying the changes.
  • Button
    • Button API alignment #2714
  • TextInput
    • Specify possible `type` values for TextInput #2610
  • Details
    • Consider removing Details and adding styles to base styles
    • Consider updating useDetails hook to be used for disclosure patterns
  • UnderlineNav
    • Export new UnderlineNav in the main bundle and move the older one to the deprecated bundle - Major release #2728
  • Token
    • Remove extralarge from TokenSizeKeys
  • PageLayout
    • Remove position prop for PageLayout.* and default to source order
  • Remove from deprecated
• Types
  • Remove warning from FormValidationStatus
• Project
  • Go all in on ESM
    • Add a CommonJS build to the package github/combobox-nav#63
    • Test error on @primer/react/lib/drafts/hooks/useCombobox.js #2346
    • Regression: @primer/react is depends on esm only module @github/combobox-nav #2245
    • Convert to a ES Module (blocked on next-major) #2354
  • Switch to React 18
  • Update styled-components to v5
    • shouldForwardProp support #2734
  • Update file/folder structure for Primer React
• Internal
  • https://github.com/github/primer/issues/1224