add link to go to the releases list from any individual release

snowystinger · snowystinger · commit 81177fbbc758 · 2025-11-03T15:05:31.000+11:00
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-0-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-0-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'December 20, 2023';
 export const title = 'v1.0.0';
 export const description = 'In this release, we\'re promoting React Aria Components from RC to GA 🎉, optimizing our included translation files, shipping a storybook based on all our React Aria Components with a starter theme, and fixing plenty of bugs.';
+export const isSubpage = true;
 
 # v1.0.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-1-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-1-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'February 13, 2024';
 export const title = 'v1.1.0';
 export const description = 'Welcome to the first release of the new year! We have had a great response to our GA release of React Aria Components. To help get you started, we have also created a few starter kits. We have been busy working on our new Submenu feature which we are excited to release as an alpha. We have also made improvements to our overlay positioning code to better handle pinch zooming and spatial awareness.';
+export const isSubpage = true;
 
 # v1.1.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-10-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-10-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'June 5, 2025';
 export const title = 'v1.10.0';
 export const description = 'Drop everything! Drag and drop support in React Aria Tree has been released! This supports moving items within a tree or between collection components, with full keyboard and screen reader accessibility.';
+export const isSubpage = true;
 
 # v1.10.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-11-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-11-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'July 22, 2025';
 export const title = 'v1.11.0';
 export const description = 'Happy summer! This release adds support for async loading and infinite scrolling, improves form integration and drag and drop interactions, and adds support for additional DOM events and attributes.';
+export const isSubpage = true;
 
 # v1.11.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-12-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-12-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'August 25, 2025';
 export const title = 'v1.12.0';
 export const description = 'Summer might be winding down but we\'re definitely not! Back with another release, we have added support for origin-aware overlay animations in Popover and Tooltip, which enable scale transitions to appear as if they are emerging from the trigger. We have also advanced Autocomplete to RC, and added support for filtering GridList, Table, and TagGroup (virtual focus support is still to come). Section support in GridList has also been added as an alpha, laying the groundwork for similar support in Tree and Table.';
+export const isSubpage = true;
 
 # v1.12.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-13-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-13-0.mdx
@@ -19,6 +19,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'October 2, 2025';
 export const title = 'v1.13.0';
 export const description = 'Happy fall! This release brings some long-awaited features, including multi-selection in React Aria Select and enhanced animation support across our components. For example, Disclosure now provides CSS variables to easily animate expanding and collapsing. We\'ve also added a new `<SelectionIndicator>` component that can be used within components that support single selection to animate selection changes. In addition, we have significantly improved the behavior of scrolling modals on iOS 26. Lastly, `onAction` can now be used on a `ComboBoxItem`, enabling you to add a “create” option.'
+export const isSubpage = true;
 
 # v1.13.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-2-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-2-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'May 1, 2024';
 export const title = 'v1.2.0';
 export const description = 'We have a huge release! Submenu, unavailable menu items, DropZone, FileTrigger are all in GA. New color components in React Aria Components, and so much more!';
+export const isSubpage = true;
 
 # v1.2.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-3-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-3-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'July 22, 2024';
 export const title = 'v1.3.0';
 export const description = 'For this summer release, we have been busy working on improving virtualization in many of our Spectrum components including TableView, ListView, and ListBox. Our Color components are moving to RC, Toast focus management has been improved, we have been preparing for React 19 release along with many bug fixes and improvements.';
+export const isSubpage = true;
 
 # v1.3.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-4-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-4-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'September 30, 2024';
 export const title = 'v1.4.0';
 export const description = 'Happy fall! 🍁 We\'re excited to announce that our color picker components are now generally available! We\'ve also added a pending state for buttons in React Aria Components, advanced TreeView to beta, and added new Disclosure and DisclosureGroup components in alpha for building accordions and collapsible panels.';
+export const isSubpage = true;
 
 # v1.4.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-5-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-5-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'November 20, 2024';
 export const title = 'v1.5.0';
 export const description = 'We\'re excited to announce that our Disclosure components are now generally available! We\'ve also introduced the ToggleButtonGroup component, as well as Section-level selection groups in Menu. Additionally, React Aria is now Typescript Strict compliant.';
+export const isSubpage = true;
 
 # v1.5.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-6-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-6-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'January 15, 2025';
 export const title = 'v1.6.0';
 export const description = 'Happy New Year! Our first release of 2025 includes a new firstDayOfWeek prop for our calendar and date picker components, support for CSS transitions in our overlay components, a new Autocomplete component in alpha, and a new test utils package.';
+export const isSubpage = true;
 
 # v1.6.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-7-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-7-0.mdx
@@ -19,6 +19,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'March 5, 2025';
 export const title = 'v1.7.0';
 export const description = 'Buckle in because this is a big one! In this React Aria release, we are excited to announce that Tree and Virtualizer are now in GA, while Toast is now in available as an alpha. We\'ve also made improvements to Autocomplete, added support for custom Menu, Popover, and Tooltip triggers, completed a major refactor of usePress, and more!';
+export const isSubpage = true;
 
 # v1.7.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-8-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-8-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'April 11, 2025';
 export const title = 'v1.8.0';
 export const description = 'In today\'s release we are excited to announce custom calendar support in React Aria Components! We have also added enhanced support for React Suspense and performance optimizations for collections in React Aria Components, reduced the bundle sizes of our libraries as a whole, and now support onClick as an alias for onPress.';
+export const isSubpage = true;
 
 # v1.8.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/react-aria/releases/v1-9-0.mdx b/packages/dev/s2-docs/pages/react-aria/releases/v1-9-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'React Aria'];
 export const date = 'May 19, 2025';
 export const title = 'v1.9.0';
 export const description = 'This release includes a range of enhancements and fixes such as improved keyboard accessibility in TagGroup and increased stability for dynamic table updates. It also brings support for React 19\'s ref cleanup behavior, performance improvements for collection updates in React transitions and pressable elements, and TypeScript updates including backwards compatibility with older TypeScript and @types/react versions.';
+export const isSubpage = true;
 
 # v1.9.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-1-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-1-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'May 17, 2024';
 export const title = 'v0.1.0';
 export const description = 'Version 0.1.0 introduces the first version of Spectrum 2, including new Badge, ComboBox, Meter, and Picker components.';
+export const isSubpage = true;
 
 # v0.1.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-10-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-10-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'July 23, 2025';
 export const title = 'v0.10.0';
 export const description = 'Version 0.10.0 introduces a new font for Spectrum 2: Adobe Clean Spectrum VF, along with new date and time components including Calendar, DatePicker, DateRangePicker, and TimeField. This release also includes various component improvements and bug fixes.';
+export const isSubpage = true;
 
 # v0.10.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-11-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-11-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'August 26, 2025';
 export const title = 'v0.11.0';
 export const description = 'Version 0.11.0 introduces the new SelectBoxGroup component (alpha), fixes ComboBox empty state rendering, improves Picker dropdown styling, and adds support for custom tab layouts with collapse behavior.';
+export const isSubpage = true;
 
 # v0.11.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-12-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-12-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'October 3, 2025';
 export const title = 'v0.12.0';
 export const description = 'Version 0.12.0 adds pending states to ActionButton, avatar support in ComboBox and Picker, Dialog XL size, and Popover styling improvements. This release also includes RTL fixes, placeholder support across components, and various component enhancements.';
+export const isSubpage = true;
 
 # v0.12.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-2-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-2-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'Jun 15, 2024';
 export const title = 'v0.2.0';
 export const description = 'Version 0.2.0 introduces new color and range components, adds ESBuild starter, updates InlineAlert iconography, and includes CSS processing updates.';
+export const isSubpage = true;
 
 # v0.2.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-3-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-3-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'August 20, 2024';
 export const title = 'v0.3.0';
 export const description = 'Version 0.3.0 introduces NumberField, AlertDialog, and Tabs components, along with new linear and gradient illustrations. This release includes TagGroup enhancements, updated workflow icons with name changes, and comprehensive translations for all components.';
+export const isSubpage = true;
 
 # v0.3.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-4-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-4-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'October 1, 2024';
 export const title = 'v0.4.0';
 export const description = 'Version 0.4.0 introduces six new components including Accordion, Card, CardView, and TableView. This release includes ProgressBar and Badge enhancements, Button pending state support, and various component improvements.';
+export const isSubpage = true;
 
 # v0.4.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-5-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-5-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'November 22, 2024';
 export const title = 'v0.5.0';
 export const description = 'Version 0.5.0 includes major updates to Dialog and DialogTrigger APIs with four new dialog components: Dialog, FullscreenDialog, CustomDialog, and Popover. This release also improves style macro documentation and adds support for arbitrary pixel sizing.';
+export const isSubpage = true;
 
 # v0.5.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-6-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-6-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'January 16, 2025';
 export const title = 'v0.6.0';
 export const description = 'Version 0.6.0 introduces the ActionBar component and adds staticColor="auto" support to multiple components. This release includes Button gradient variants, Menu improvements, and various component fixes.';
+export const isSubpage = true;
 
 # v0.6.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-7-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-7-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'March 7, 2025';
 export const title = 'v0.7.0';
 export const description = 'Version 0.7.0 introduces the TreeView component and includes important CSS updates to fix Safari issues. This release removes all: revert-layer from the style macro and includes Badge improvements, Tabs collapse behavior, and updated codemods.';
+export const isSubpage = true;
 
 # v0.7.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-8-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-8-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'April 12, 2025';
 export const title = 'v0.8.0';
 export const description = 'Version 0.8.0 introduces NotificationBadge and Toast (alpha) components, along with updates to Disclosure design sizing. This release also includes various component improvements and new exports.';
+export const isSubpage = true;
 
 # v0.8.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-9-0.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-9-0.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'May 20, 2025';
 export const title = 'v0.9.0';
 export const description = 'Version 0.9.0 adds virtualization and async loading support to ComboBox and Picker, updates Dialog sizes, and introduces important TypeScript changes for UNSAFE_className. This release also includes significant style macro updates.';
+export const isSubpage = true;
 
 # v0.9.0
 <Time date={date} />
diff --git a/packages/dev/s2-docs/pages/s2/releases/v0-9-1.mdx b/packages/dev/s2-docs/pages/s2/releases/v0-9-1.mdx
@@ -18,6 +18,7 @@ export const tags = ['release', 'S2'];
 export const date = 'June 6, 2025';
 export const title = 'v0.9.1';
 export const description = 'Version 0.9.1 is a patch release that fixes focus visible styles in Button and TagGroup, updates ContextualHelp width, and improves Tabs selection indicator behavior.';
+export const isSubpage = true;
 
 # v0.9.1
 <Time date={date} />
diff --git a/packages/dev/s2-docs/src/GoUpOneLink.tsx b/packages/dev/s2-docs/src/GoUpOneLink.tsx
@@ -0,0 +1,69 @@
+'use client';
+
+import {baseColor, focusRing, fontRelative, style} from '@react-spectrum/s2/style' with { type: 'macro' };
+import {ButtonRenderProps, Link, Provider} from 'react-aria-components';
+import {centerBaseline} from '../../../@react-spectrum/s2/src/CenterBaseline';
+import ChevronLeftIcon from '@react-spectrum/s2/icons/ChevronLeft';
+import {IconContext} from '@react-spectrum/s2';
+import {pressScale} from '../../../@react-spectrum/s2/src/pressScale';
+import React, {useRef} from 'react';
+
+
+export const btnStyles = style<Omit<ButtonRenderProps, 'isPending'>>({
+  ...focusRing(),
+  borderRadius: 'default',
+  position: 'relative',
+  justifyContent: 'center',
+  flexShrink: 0,
+  fontWeight: 'medium',
+  userSelect: 'none',
+  transition: 'default',
+  forcedColorAdjust: 'none',
+  backgroundColor: {
+    default: 'transparent',
+    forcedColors: {
+      default: 'ButtonFace'
+    }
+  },
+  color: {
+    default: baseColor('neutral'),
+    isDisabled: 'disabled',
+    forcedColors: {
+      default: 'ButtonText',
+      isDisabled: {
+        default: 'GrayText'
+      }
+    }
+  },
+  '--iconPrimary': {
+    type: 'fill',
+    value: 'currentColor'
+  },
+  outlineColor: {
+    default: 'focus-ring',
+    forcedColors: 'Highlight'
+  },
+  borderStyle: 'none',
+  disableTapHighlight: true,
+  '--iconWidth': {
+    type: 'width',
+    value: fontRelative(20)
+  }
+});
+
+export function GoUpOneLink() {
+  let ref = useRef(null);
+  return (
+    <Link href="./index.html" className={btnStyles} style={pressScale(ref)} ref={ref}>
+      <Provider
+        values={[
+          [IconContext, {
+            render: centerBaseline({slot: 'icon', styles: style({order: 0})}),
+            styles: style({size: fontRelative(20), marginStart: '--iconMargin', flexShrink: 0})
+          }]
+        ]}>
+        <ChevronLeftIcon />
+      </Provider>
+    </Link>
+  );
+}
diff --git a/packages/dev/s2-docs/src/Layout.tsx b/packages/dev/s2-docs/src/Layout.tsx
@@ -16,6 +16,7 @@ import {CodePlatterProvider} from './CodePlatter';
 import {ExampleSwitcher} from './ExampleSwitcher';
 import {getLibraryFromPage, getLibraryFromUrl, getLibraryLabel} from './library';
 import {getTextWidth} from './textWidth';
+import {GoUpOneLink} from './GoUpOneLink';
 import {H2, H3, H4} from './Headings';
 import Header from './Header';
 import {Link} from './Link';
@@ -63,6 +64,16 @@ const components = {
   ExampleList
 };
 
+const subPageComponents = {
+  ...components,
+  h1: ({children, ...props}) => (
+    <div className={style({display: 'flex', alignItems: 'center', gap: 8})}>
+      <GoUpOneLink />
+      <h1 {...props} id="top" style={{'--width-per-em': getTextWidth(children)} as any} className={h1}>{children}</h1>
+    </div>
+  )
+};
+
 function anchorId(children) {
   return children.replace(/\s/g, '-').replace(/[^a-zA-Z0-9-_]/g, '').toLowerCase();
 }
@@ -133,6 +144,7 @@ export function Layout(props: PageProps & {children: ReactElement<any>}) {
   let ogImage = getOgImageUrl(currentPage);
   let title = getTitle(currentPage);
   let description = getDescription(currentPage);
+  let isSubpage = currentPage.exports?.isSubpage;
   return (
     <Provider elementType="html" locale="en" background="layer-1" styles={style({scrollPaddingTop: {default: 64, lg: 0}})}>
       <head>
@@ -243,7 +255,7 @@ export function Layout(props: PageProps & {children: ReactElement<any>}) {
                 <article
                   className={articleStyles({isWithToC: hasToC})}>
                   {currentPage.exports?.version && <VersionBadge version={currentPage.exports.version} />}
-                  {React.cloneElement(children, {components, pages})}
+                  {React.cloneElement(children, {components: isSubpage ? subPageComponents : components, pages})}
                 </article>
               </CodePlatterProvider>
               {hasToC && <aside
diff --git a/packages/dev/s2-docs/src/ReleasesList.tsx b/packages/dev/s2-docs/src/ReleasesList.tsx
@@ -16,7 +16,7 @@ export function ReleasesList({pages}: {pages: Page[]}) {
             <h2 className={style({font: 'heading-lg', margin: 0})}><Link href={release.url}>{release.exports?.title}</Link></h2>
             <Time date={release.exports?.date} />
           </header>
-          <p className={style({font: 'body', margin: 0})}>{renderHTMLfromMarkdown(release.exports?.description, {forceInline: false, forceBlock: true})}</p>
+          <p className={style({font: 'body', margin: 0})}>{renderHTMLfromMarkdown(release.exports?.description, {})}</p>
         </div>
       ))}
       <div>
