braid-design-system 34.0.0-seperate-codemod-20250618035833 → 34.0.1

package/CHANGELOG.md

@@ -1,18 +1,426 @@
 # braid-design-system
 
-## 34.0.0-seperate-codemod-20250618035833
+## 34.0.1
+
+### Patch Changes
+
+- **MenuRenderer, OverflowMenu:** Prevent the document from scrolling when opening the menu with the keyboard ([#1952](https://github.com/seek-oss/braid-design-system/pull/1952))
+
+## 34.0.0
 
 ### Major Changes
 
+- **Hidden:** Remove `screen` prop ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  Remove the deprecated `screen` prop from the `Hidden` component.
+  For content designed to improve the screen reader experience, please use use the `HiddenVisually` component instead.
+  Alternatively, for content designed to be hidden unconditionally, remove the `screen` prop.
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  - <Hidden screen>
+  + <Hidden>
+  ```
+
+- **Box, atoms:** Remove deprecated `rating` variable. ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  Consumers should use the `brandAccent` or `neutral` variables instead.
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  # styles.css.ts
+  import { vars } from 'braid-design-system/css';
+
+  export const myStyle = style({
+  -  color: vars.foregroundColor.rating,
+  +  color: vars.foregroundColor.brandAccent,
+  });
+  ```
+
+- **Card:** Remove `rounded` prop ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  The `rounded` prop only affected deleted themes such as `apac` and has no effect on supported themes.
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  - <Card rounded>...</Card>
+  + <Card>...</Card>
+  ```
+
+- **Box, atoms**: Remove deprecated `outline` value `none`, and `boxShadow` value `outlineFocus`. ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  Braid leverages the `outline` property directly, managing focus rings of interactive elements as part of its scoped CSS reset.
+
+  **MIGRATION GUIDE:**
+
+  For styling the focus ring via `Box`:
+  1. Remove usage of `outline="none"` and `boxShadow="outlineFocus"`
+  2. Refer to [`focus outlines`] for guidance on leveraging Braid's focus outline styles.
+
+  ```diff
+  - <Box outline="none" className={styles.customFocusStyles} />
+  + <Box />
+  ```
+
+  For styling the focus outline of an element based on the focus of another element, see [`outlineStyle`].
+
+  [`focus outlines`]: https://seek-oss.github.io/braid-design-system/components/Box#focus-outlines
+  [`outlineStyle`]: https://seek-oss.github.io/braid-design-system/css/outlineStyle
+
+- **apac:** Remove in favour of `seekJobs` theme ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  The previously deprecated `apac` theme has been removed.
+  Consumers should migrate to the `seekJobs` theme.
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  # App.tsx
+  - import apac from 'braid-design-system/themes/apac';
+  + import seekJobs from 'braid-design-system/themes/seekJobs';
+
+  - <BraidProvider theme={apac} ...>
+  + <BraidProvider theme={seekJobs} ...>
+  ```
+
+- **IconList:** Remove deprecated component, in favour of more specific list types: `IconBulletList` and `IconNumberedList`. ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  -<IconList />
+  +<IconBulletList />
+  ```
+
+- **Toggle:** Remove `bleedY` prop ([#1947](https://github.com/seek-oss/braid-design-system/pull/1947))
+
+  Remove the deprecated `bleedY` prop from the `Toggle` component.
+  Consumers should remove use of the `bleedY` prop, and if previously setting `bleedY` to false, should update their layout accordingly.
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  - <Toggle bleedY />
+  + <Toggle />
+  ```
+
+### Patch Changes
+
+- Update `is-mobile` dependency ([#1945](https://github.com/seek-oss/braid-design-system/pull/1945))
+
+## 33.14.0
+
+### Minor Changes
+
+- **TooltipRenderer:** Add support for `left` and `right` placement, in addition to existing `top` and `bottom`. ([#1942](https://github.com/seek-oss/braid-design-system/pull/1942))
+
+  **EXAMPLE USAGE:**
+
+  ```jsx
+  <TooltipRenderer
+    placement="left"
+    ...props
+  >
+   ...
+  </TooltipRenderer>
+
+  ```
+
+### Patch Changes
+
+- Improve components type definitions in support of Playroom props ([#1941](https://github.com/seek-oss/braid-design-system/pull/1941))
+
+## 33.13.0
+
+### Minor Changes
+
+- **Autosuggest:** Add support for data attributes on individual suggestions ([#1938](https://github.com/seek-oss/braid-design-system/pull/1938))
+
+  The data attributes are applied to each rendered list item.
+
+  **EXAMPLE USAGE:**
+
+  ```jsx
+  <Autosuggest
+    suggestions={[
+      {
+        text: 'Apples',
+        data: { testid: 'suggestion-apples' },
+      },
+    ]}
+  />
+  ```
+
+### Patch Changes
+
+- **ButtonIcon, TooltipRenderer:** Close tooltips after clicking the trigger on desktop devices ([#1932](https://github.com/seek-oss/braid-design-system/pull/1932))
+
+## 33.12.4
+
+### Patch Changes
+
+- **Autosuggest, MenuRenderer, OverflowMenu, TooltipRenderer**: Ensure `TooltipRenderer` is correctly positioned on Android devices ([#1926](https://github.com/seek-oss/braid-design-system/pull/1926))
+
+  Additionally, adjust `TooltipRenderer` positioning at screen edges, removing extra edge spacing.
+  This ensures the tooltip arrow is more closely aligned with the trigger when the trigger is near the edge of the screen.
+
+## 33.12.3
+
+### Patch Changes
+
+- **TooltipRenderer:** Ensure Chinese text is not wrapped incorrectly ([#1916](https://github.com/seek-oss/braid-design-system/pull/1916))
+
+  Right aligned tooltip triggers with tooltips containing long unbroken Chinese text are no longer forcibly broken across many lines.
+  This was due to the use of `overflow-wrap: break-word;` used to break long strings of Latin characters—guarding against broken layouts.
+
+  For Chinese, Japanese and Korean (CJK) character sets, to avoid the unwanted line breaks it is recommened to apply the `word-break: keep-all;` CSS property.
+
+  See [MDN reference] for more information.
+
+  [MDN reference]: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/word-break#keep-all
+
+## 33.12.2
+
+### Patch Changes
+
+- **Autosuggest, MenuRenderer, TooltipRenderer:** Improve placement logic ([#1904](https://github.com/seek-oss/braid-design-system/pull/1904))
+
+  In `MenuRenderer`, if there is not enough space for the menu above or below the trigger, the menu will be positioned based on the `placement` prop.
+
+- **Dialog, Drawer:** Ensure page elements are not interactive during close animation ([#1906](https://github.com/seek-oss/braid-design-system/pull/1906))
+
+## 33.12.1
+
+### Patch Changes
+
+- **IconInfo:** Update illustration ([#1891](https://github.com/seek-oss/braid-design-system/pull/1891))
+
+## 33.12.0
+
+### Minor Changes
+
+- **IconSocialTiktok:** Add component ([#1889](https://github.com/seek-oss/braid-design-system/pull/1889))
+
+  **EXAMPLE USAGE:**
+
+  ```jsx
+  <IconSocialTiktok />
+  ```
+
+- **IconMicrophone:** Add component ([#1887](https://github.com/seek-oss/braid-design-system/pull/1887))
+
+  **EXAMPLE USAGE:**
+
+  ```jsx
+  <IconMicrophone />
+  ```
+
+### Patch Changes
+
+- **IconAttachment, IconLocation:** Update artworks to be more rounded and spacious, consistent with the latest design language ([#1887](https://github.com/seek-oss/braid-design-system/pull/1887))
+
+## 33.11.5
+
+### Patch Changes
+
+- **Button, ButtonIcon, ButtonLink:** Remove use of deprecated `outline` atoms value, in favour of CSS property ([#1871](https://github.com/seek-oss/braid-design-system/pull/1871))
+
+## 33.11.4
+
+### Patch Changes
+
+- **Button, ButtonIcon, ButtonLink:** Ensure active transition is correctly applied ([#1868](https://github.com/seek-oss/braid-design-system/pull/1868))
+
+## 33.11.3
+
+### Patch Changes
+
+- **Button, ButtonLink:** Ensure focus ring supports `bleed` layout ([#1866](https://github.com/seek-oss/braid-design-system/pull/1866))
+
+  Fixes the focus ring layout when combined with the `bleed` prop to ensure the outline wraps the visual boundary of the button.
+
+## 33.11.2
+
+### Patch Changes
+
+- **ButtonIcon:** Better match `Tooltip` text size with `size` prop ([#1864](https://github.com/seek-oss/braid-design-system/pull/1864))
+
+  When using a `small` `ButtonIcon`, the `Tooltip` text size is now set to `small`.
+  For other sizes, the text remains at the default `standard` size.
+
+## 33.11.1
+
+### Patch Changes
+
+- **Actions:** Ensure full width on mobile ([#1858](https://github.com/seek-oss/braid-design-system/pull/1858))
+
+  Ensure that the children of an `Action` component are always full width on mobile, including within a centred flex container.
+
+## 33.11.0
+
+### Minor Changes
+
+- **useToast**: Improve layout of toasts when multiple toasts are shown ([#1782](https://github.com/seek-oss/braid-design-system/pull/1782))
+
+  When multiple toasts are shown simultaneously, they now visually stack in a collapsed format that expands on interaction.
+  This prevents toasts from obscuring page content while providing users with an easy way to manage and navigate through the recent toast history.
+
+### Patch Changes
+
+- **RadioGroup:** Ensure provided `id` is assigned to `fieldset` ([#1845](https://github.com/seek-oss/braid-design-system/pull/1845))
+
+  Fixes a bug where the provided `id` was not being passed through to the `fieldset` element.
+
+- **seekJobs, seekBusiness:** Update drop shadow palette ([#1847](https://github.com/seek-oss/braid-design-system/pull/1847))
+
+  Refine the drop shadow palette values of `small`, `medium`, and `large`.
+  The shadow values are now softer and more linear in their scale.
+
+- **TooltipRenderer:** Optimise performance by reducing unnecessary recalculations of the trigger position ([#1833](https://github.com/seek-oss/braid-design-system/pull/1833))
+
+- **seekJobs, seekBusiness:** Increase medium font weight ([#1843](https://github.com/seek-oss/braid-design-system/pull/1843))
+
+  The introduction of Traditional Chinese support means characters in this unicode range are rendered using the default `sans-serif` font.
+  The system fonts that handle these characters only cater for **regular** and **bold** weights, resulting in the `medium` weight of 500 falling back to 400 — resulting in loss of visual hierarchy.
+
+  By increasing the weight of `medium` to 600, it will now round up to 700 (`strong`) when the rendered font cannot satisfy `medium`.
+
+  This only affects `seekJobs` and `seekBusiness` themes rendering Traditional Chinese characters, all weights across other character sets remain unchanged.
+
+## 33.10.2
+
+### Patch Changes
+
+- Expand the peer dependency range to support React 19. ([#1822](https://github.com/seek-oss/braid-design-system/pull/1822))
+
+## 33.10.1
+
+### Patch Changes
+
+- **useToast:** Clean up internal refactor ([#1837](https://github.com/seek-oss/braid-design-system/pull/1837))
+
+- **Dialog, Drawer:** Refactor layout, ensure content area is the full height ([#1834](https://github.com/seek-oss/braid-design-system/pull/1834))
+
+  This change allows you to spread content to the bottom of a `Drawer`, for example with a `vertical` direction `Spread`.
+
+- Ensure focus rings are consistent across components ([#1828](https://github.com/seek-oss/braid-design-system/pull/1828))
+
+  Aligns a few edge cases where focus rings were not consistent due to elements or aria roles not captured by the reset.
+
+- **BraidTestProvider:** Align mock with real IntersectionObserver API ([#1837](https://github.com/seek-oss/braid-design-system/pull/1837))
+
+- **Table:** Ensure `alignY` prop is applied consistently across browsers ([#1832](https://github.com/seek-oss/braid-design-system/pull/1832))
+
+  Fixes an issue where setting the `alignY` prop to `top` would not apply the `vertical-align` CSS property — instead falling through to our CSS reset which sets `vertical-align: baseline` (rendering inconsistently across browsers).
+
+## 33.10.0
+
+### Minor Changes
+
+- **Box, atoms**: Add `sticky` to `position`. ([#1806](https://github.com/seek-oss/braid-design-system/pull/1806))
+
+  **EXAMPLE USAGE:**
+
+  ```jsx
+  <Box position="sticky" top={0} ... />
+  ```
+
+- **Box, atoms**: Deprecate `outline` value `none`, and `boxShadow` value `outlineFocus`. ([#1810](https://github.com/seek-oss/braid-design-system/pull/1810))
+
+  Previously it was recommended to hide an element's `outline` in favour of using `boxShadow="outlineFocus"`.
+
+  Braid now leverages the `outline` property directly, managing focus rings of interactive elements as part of its scoped CSS reset.
+
+  **MIGRATION GUIDE:**
+
+  For styling the focus ring via `Box`:
+  1. Remove usage of `outline="none"` and `boxShadow="outlineFocus"`
+  2. Refer to [`focus outlines`] for guidance on leveraging Braid's focus outline styles.
+
+  ```diff
+  - <Box outline="none" className={styles.customFocusStyles} />
+  + <Box />
+  ```
+
+  For styling the focus outline of an element based on the focus of another element, see [`outlineStyle`].
+
+  [`focus outlines`]: https://seek-oss.github.io/braid-design-system/components/Box#focus-outlines
+  [`outlineStyle`]: https://seek-oss.github.io/braid-design-system/css/outlineStyle
+
+- **seekBusiness:** Migrate to updated visual language ([#1819](https://github.com/seek-oss/braid-design-system/pull/1819))
+
+  Migrate `seekBusiness` theme to new visual language.
+  Adopts the `seekJobs` theme for the latest design standards, rather than the legacy `apac` theme, while retaining the `seekBusiness` brand accent colour.
+
+### Patch Changes
+
+- **ButtonIcon**: Ensure the focus outline is styled consistently with other components. ([#1810](https://github.com/seek-oss/braid-design-system/pull/1810))
+
+  Fix issue which caused the Braid focus outline to show along with the native browser focus outline.
+
+- **apac:** Deprecate theme in favour of `seekJobs` theme ([#1820](https://github.com/seek-oss/braid-design-system/pull/1820))
+
+  **MIGRATION GUIDE:**
+
+  ```diff
+  # App.tsx
+  - import apac from 'braid-design-system/themes/apac';
+  + import seekJobs from 'braid-design-system/themes/seekJobs';
+
+  - <BraidProvider theme={apac} ...>
+  + <BraidProvider theme={seekJobs} ...>
+  ```
+
+- Migrate from custom focus ring visibility to native `:focus-visible` behaviour. ([#1810](https://github.com/seek-oss/braid-design-system/pull/1810))
+
+  Previously Braid would change the presentation of focus ring outlines based on the user input, i.e. mouse or keyboard,
+  to prevent showing focus rings on click.
+  With the updated Browser Support Policy, we can now leverage the native `:focus-visible` pseudo class instead.
+
+- **Dialog, Drawer**: Ensure the focus outline is correctly applied to the title. ([#1810](https://github.com/seek-oss/braid-design-system/pull/1810))
+
+  Fix issue where focus outline would not be long enough to wrap the entire title text in certain situations.
+
+## 33.9.1
+
+### Patch Changes
+
+- **ButtonIcon, TooltipRenderer:** Remove unnecessary intermediary element around the tooltip trigger. ([#1814](https://github.com/seek-oss/braid-design-system/pull/1814))
+
+- **BraidTestProvider:** Use stubs instead of mocks to fill missing APIs in jsdom ([#1809](https://github.com/seek-oss/braid-design-system/pull/1809))
+
+  This change allows the BraidTestProvider to be framework agnostic for tests and discourages testing the stubbed browser APIs directly.
+
+## 33.9.0
+
+### Minor Changes
+
 - @braid-design-system/codemod has been moved to its own package. ([#1801](https://github.com/seek-oss/braid-design-system/pull/1801))
 
-  The `braid-upgrade` command is now no longer apart of the core Braid Design System. Instead, `braid-upgrade` can be run via the `@braid-design-system/codemod` package.
+  **Note: This is technically a breaking change for local migrations, but we expect minimal impact so are releasing this as a minor version change.**
+
+  The `braid-upgrade` command is now no longer part of the `braid-design-system` package. Instead, `braid-upgrade` can be run via the `@braid-design-system/codemod` package.
 
   #### Example
 
   ```bash
-  pnpm --package=@braid-design-system/codemod dlx braid-upgrade v31.11 "**/*.{ts,tsx}
+  pnpm dlx @braid-design-system/codemod v31.11 "**/*.{ts,tsx}"
+  ```
+
+### Patch Changes
+
+- **BraidTestProvider:** Provide `ResizeObserver` & `IntersectionObserver` stubs to jsdom ([#1811](https://github.com/seek-oss/braid-design-system/pull/1811))
+
+  Fixes an issue where rendering certain Braid components within a test environment could throw errors due to missing APIs in jsdom, causing tests to fail with the following error:
+
   ```
+  ReferenceError: IntersectionObserver is not defined
+  ```
+
+## 33.8.0
 
 ### Minor Changes
 
@@ -53,6 +461,8 @@
 
   Fixes an issue where the close button inside the `Dialog` or `Drawer` was incorrectly inside an `aria-hidden` region.
 
+- **useToast**: Simplify internal logic, refining how the theme is applied to Toasts ([#1797](https://github.com/seek-oss/braid-design-system/pull/1797))
+
 - **Autosuggest**: Ensure suggestions dropdown is visible, even when `Autosuggest` is inside a container with overflow hidden. ([#1738](https://github.com/seek-oss/braid-design-system/pull/1738))
 
 ## 33.7.0
@@ -929,7 +1339,6 @@ See full changelog below 👇
 - Standardise `disabled` & `critical` state across form fields ([#1564](https://github.com/seek-oss/braid-design-system/pull/1564))
 
   Improves the consistency of form fields when combining both `disabled` and `critical` tone, which includes:
-
   - Hiding `critical` borders
   - Hiding `message` and not reserving space for it unless explicitly providing the `reserveMessageSpace` prop.
 
@@ -1561,7 +1970,6 @@ See full changelog below 👇
   Our different approach to using colour has seen links dialled back to compete less with other messaging and CTAs.
 
   This affects the following usages across the system:
-
   - `vars.foregroundColor.link`
   - `Text` (using `tone="link"`)
   - `TextLink` and (`TextLinkButton`)
@@ -2252,9 +2660,8 @@ For more detail on the specific changes in this release, please read on.
   ```jsx
   // playroom.config.js
   module.exports = {
-    frameComponent: require.resolve(
-      'braid-design-system/playroom/FrameComponent',
-    ),
+    frameComponent:
+      require.resolve('braid-design-system/playroom/FrameComponent'),
     components: require.resolve('braid-design-system/playroom/components'),
     snippets: require.resolve('braid-design-system/playroom/snippets'),
     scope: require.resolve('braid-design-system/playroom/scope'),
@@ -2373,7 +2780,6 @@ For more detail on the specific changes in this release, please read on.
 - **Tab, Tabs:** Updated visual design ([#1180](https://github.com/seek-oss/braid-design-system/pull/1180))
 
   The appearance of a `Tab` has been updated. Changes include:
-
   - Tab button use `regular` text weight
   - Hover state of inactive tab toggles `neutral` tone instead of underline
   - Active tab indicator underlines content only, without the horizontal gutter and animates between tabs
@@ -2400,9 +2806,8 @@ For more detail on the specific changes in this release, please read on.
   ```jsx
   // playroom.config.js
   module.exports = {
-    frameComponent: require.resolve(
-      'braid-design-system/playroom/FrameComponent.tsx',
-    ),
+    frameComponent:
+      require.resolve('braid-design-system/playroom/FrameComponent.tsx'),
     components: require.resolve('braid-design-system/playroom/components.ts'),
     snippets: require.resolve('braid-design-system/playroom/snippets.ts'),
     scope: require.resolve('braid-design-system/playroom/scope.ts'),
@@ -3413,7 +3818,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New foregrounds**
   The following foregrounds are now available on the `vars.foregroundColor` theme object:
-
   - `cautionLight`
   - `infoLight`
   - `linkLight`
@@ -3674,12 +4078,10 @@ For more detail on the specific changes in this release, please read on.
   **TOKEN CHANGES**
 
   **New**
-
   - **backgroundColor:** `surface`, `neutralSoft`
   - **borderColor:** `neutral`, `neutralInverted`, `neutralLight`
 
   **Removed**
-
   - **backgroundColor:** `card`, `formAccentDisabled`, `input`, `inputDisabled`, `selection`
   - **borderColor:** `formHover`, `standard`, `standardInverted`
 
@@ -3773,7 +4175,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New backgrounds**
   The following backgrounds are now available:
-
   - `neutralActive`
   - `neutralHover`
   - `neutralSoftActive`
@@ -3781,7 +4182,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New boxShadows**
   The following box shadows are now available:
-
   - `borderBrandAccentLightLarge`
   - `borderCriticalLightLarge`
   - `borderFormAccentLight`
@@ -3791,7 +4191,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New boxShadows**
   The following box shadows are now available:
-
   - `borderBrandAccentLightLarge`
   - `borderCriticalLightLarge`
   - `borderFormAccentLight`
@@ -3805,7 +4204,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New backgrounds**
   The following backgrounds are now available on the `vars.backgroundColor` theme object:
-
   - `neutralActive`
   - `neutralHover`
   - `neutralSoftActive`
@@ -3813,7 +4211,6 @@ For more detail on the specific changes in this release, please read on.
 
   **New borderColors**
   The following border colors are now available on the `vars.borderColor` theme object:
-
   - `brandAccentLight`
   - `criticalLight`
   - `formAccentLight`
@@ -3901,7 +4298,6 @@ For more detail on the specific changes in this release, please read on.
 - **Box:** Add new background and border colours ([#983](https://github.com/seek-oss/braid-design-system/pull/983))
 
   New `background` values:
-
   - `brandAccentSoft`
   - `brandAccentSoftActive`
   - `brandAccentSoftHover`
@@ -3913,7 +4309,6 @@ For more detail on the specific changes in this release, please read on.
   - `formAccentSoftHover`
 
   New `boxShadow` values:
-
   - `borderCautionLight`
   - `borderCriticalLight`
   - `borderInfoLight`
@@ -3921,7 +4316,6 @@ For more detail on the specific changes in this release, please read on.
   - `borderPromoteLight`
 
 - **atoms:** Add new `boxShadow` values: ([#983](https://github.com/seek-oss/braid-design-system/pull/983))
-
   - `borderCautionLight`
   - `borderCriticalLight`
   - `borderInfoLight`
@@ -3931,7 +4325,6 @@ For more detail on the specific changes in this release, please read on.
 - **vars:** Add new background and border colours ([#983](https://github.com/seek-oss/braid-design-system/pull/983))
 
   New `backgroundColor` values:
-
   - `brandAccentSoft`
   - `brandAccentSoftActive`
   - `brandAccentSoftHover`
@@ -3943,7 +4336,6 @@ For more detail on the specific changes in this release, please read on.
   - `formAccentSoftHover`
 
   New `borderColor` values:
-
   - `cautionLight`
   - `criticalLight`
   - `infoLight`
@@ -4021,7 +4413,6 @@ For more detail on the specific changes in this release, please read on.
 - Add `wide` breakpoint of 1200px ([#960](https://github.com/seek-oss/braid-design-system/pull/960))
 
   This adds support for `wide` to the following touchpoints:
-
   - Responsive values, e.g.
     ```ts
     { mobile: 'small', wide: 'large' }
@@ -4160,7 +4551,6 @@ For more detail on the specific changes in this release, please read on.
 - Updated minimum browser requirement to browsers that support CSS variables ([#947](https://github.com/seek-oss/braid-design-system/pull/947))
 
   For the major browsers this includes:
-
   - Chrome 49+
   - iOS 9.3+
   - Safari 9.1+
@@ -4177,7 +4567,6 @@ For more detail on the specific changes in this release, please read on.
 - Standardise breakpoints across all themes ([#947](https://github.com/seek-oss/braid-design-system/pull/947))
 
   All themes now use the following breakpoints:
-
   - Mobile: `0px`
   - Tablet: `740px`
   - Desktop: `992px`
@@ -4187,16 +4576,13 @@ For more detail on the specific changes in this release, please read on.
   This is a change for the following themes:
 
   **jobStreet, jobStreetClassic, jobsDb, occ, wireframe**
-
   - Tablet: `768px` → `740px`
 
   **catho**
-
   - Tablet: `600px` → `740px`
   - Desktop: `1024px` → `992px`
 
   **docs**
-
   - Tablet: `768px` → `740px`
   - Desktop: `1136px` → `992px`
 
@@ -4400,7 +4786,6 @@ For more detail on the specific changes in this release, please read on.
   To maintain accessibility, it is required to provide either a **aria-label** or **aria-labelledby** property, to describe the field's intent.
 
   Given there is no visual label, the following features from a standard Checkbox cannot be supported:
-
   - description
   - message
   - badge
@@ -5448,13 +5833,11 @@ For more detail on the specific changes in this release, please read on.
   The following z-index palette is now available on `Box`:
 
   **Local stacking**
-
   - `0`
   - `1`
   - `2`
 
   **Global stacking**
-
   - `"dropdownBackdrop"`
   - `"dropdown"`
   - `"sticky"`
@@ -5578,7 +5961,6 @@ For more detail on the specific changes in this release, please read on.
 - Add `List` component ([#710](https://github.com/seek-oss/braid-design-system/pull/710))
 
   `List` serves as a replacement for the `BulletList` and `Bullet` components which adds the following improvements:
-
   - Support for numbers and alpha characters as bullets
   - Support for custom start positions in number/alpha lists
   - Rich content support, e.g. list items with multiple paragraphs, nested lists, etc.
@@ -5643,7 +6025,6 @@ For more detail on the specific changes in this release, please read on.
   The `_LEGACY_SPACE_` prop was provided to support consumers migrating to [`v14`](https://github.com/seek-oss/braid-design-system/releases/tag/v14.0.0) when the white space cropping and layout components were originally introduced. This has now been removed to allow us to further improve on our approach.
 
   Migrating off this prop will require consumers to perform the following steps:
-
   - Remove the usage of `_LEGACY_SPACE_` on a component
   - Conduct a visual review of the impact (component will appear closer to neighbouring elements)
   - Use existing layout components, e.g. `Stack`, to define/control the reintroduction of the desired space.
@@ -5728,7 +6109,6 @@ For more detail on the specific changes in this release, please read on.
 - **`seekBusiness` theme:** Inherit from new `apac` theme rather than the deprecated `seekAnz` theme ([#694](https://github.com/seek-oss/braid-design-system/pull/694))
 
   Just like the migration from `seekAnz` to `apac`, the visual changes are as follows:
-
   - The body background has changed from `#eeeeee` to `#f5f6f8`.
   - All grey colours now have a hint of blue.
   - Buttons and form fields have decreased in height from `48px` to `44px`.
@@ -5759,7 +6139,6 @@ For more detail on the specific changes in this release, please read on.
   This component serves as a replacement for `ToggleContent` from [SEEK Style Guide.](https://github.com/seek-oss/seek-style-guide)
 
   **SEEK STYLE GUIDE MIGRATION GUIDE**
-
   - `ToggleContent` has been renamed to `Disclosure`.
   - The `onShowMore` prop has been renamed to `onToggle`.
   - The spacing around the button has changed to follow [Braid's layout guidelines.](https://seek-oss.github.io/braid-design-system/foundations/layout) Design review is recommeded.
@@ -5800,7 +6179,6 @@ For more detail on the specific changes in this release, please read on.
   Consumers of the `seekAnz` theme are under no immediate pressure to migrate and both themes will be provided for the forseeable future. For now, this theme is aimed at those teams that are explicitly wanting to adopt newer design standards.
 
   The visual changes to `seekAnz` are as follows:
-
   - The body background has changed from `#eeeeee` to `#f5f6f8`.
   - All grey colours now have a hint of blue.
   - Buttons and form fields have decreased in height from 48px to 44px.
@@ -5843,7 +6221,6 @@ For more detail on the specific changes in this release, please read on.
 - MonthPicker: Support custom month and year labels ([#672](https://github.com/seek-oss/braid-design-system/pull/672))
 
   To support internationalisation, you can now pass the following props to `MonthPicker`:
-
   - **monthLabel** (`string`)
   - **yearLabel** (`string`)
   - **monthNames** (`string[]`)
@@ -6025,7 +6402,6 @@ For more detail on the specific changes in this release, please read on.
 - Improve field border contrast ratio ([#638](https://github.com/seek-oss/braid-design-system/pull/638))
 
   To improve accessibility, field borders have been darkened for the following themes:
-
   - `seekAnz`
   - `seekBusiness`
   - `seekUnifiedBeta`
@@ -6234,7 +6610,6 @@ For more detail on the specific changes in this release, please read on.
   The implementation of internal spacing within fields has been adjusted to better support browser extensions for password managers.
 
   Affects the following components:
-
   - PasswordField: visibility toggle button
   - TextField: clear button
   - Autosuggest: clear button
@@ -6248,7 +6623,6 @@ For more detail on the specific changes in this release, please read on.
   Field buttons, such as clear and password visibility toggle, fire on mouse down to ensure focus is retained on the relevant field. We now ensure that the button only recognises left mouse button clicks.
 
   Affects the following components:
-
   - PasswordField: visibility toggle button
   - TextField: clear button
   - Autosuggest: clear button
@@ -6458,7 +6832,6 @@ For more detail on the specific changes in this release, please read on.
 - Drop lodash usage to decrease bundle size. ([#585](https://github.com/seek-oss/braid-design-system/pull/585))
 
   This directly affects `MonthPicker` and any components using the `data` prop:
-
   - All field components
   - OverflowMenu
   - MenuRenderer
@@ -6515,7 +6888,6 @@ For more detail on the specific changes in this release, please read on.
   In order to make your custom link component available for any type of link (not just usages of `TextLink`), this release introduces a new `Link` component which renders an unstyled `a` tag by default.
 
   **BREAKING CHANGES**
-
   - `TextLink` now requires an `href` prop. Even though this is unlikely to affect anyone (a `TextLink` without an `href` isn't terribly useful), this is still technically a breaking change.
 
     However, if you find an instance of `TextLink` that you think _shouldn't_ have an `href`, this is a sign that it's not _actually_ a link and you should use a [`TextLinkRenderer`](https://seek-oss.github.io/braid-design-system/components/TextLinkRenderer) instead. Unfortunately, because there's no way for us to know the semantics of your usage ahead of time, we're unable to provide a migration guide, so you'll need to be mindful of how this might impact accessibility.
@@ -6642,7 +7014,6 @@ For more detail on the specific changes in this release, please read on.
 - Add customisable `MenuRenderer` component ([#514](https://github.com/seek-oss/braid-design-system/pull/514))
 
   **BREAKING CHANGES**
-
   - Rename `OverflowMenuItem` to `MenuItem`.
   - Removed `type="link"` from `OverflowMenuItem` due to an accessibility issue with the approach (based on review of consumer usage, it did not seem to be used).
 
@@ -6651,7 +7022,6 @@ For more detail on the specific changes in this release, please read on.
   **`MenuRenderer`**
 
   Encapsulates all the behaviours of an accessible menu button, allowing consumers to define a custom `trigger` to open the menu. The trigger function receives two arguments:
-
   1. Props required for accessibility, including mouse/keyboard interactions
   2. Menu state object containing the `open` state.
 
@@ -6712,7 +7082,6 @@ For more detail on the specific changes in this release, please read on.
 - Only show focus rings on buttons for keyboard navigation. ([#526](https://github.com/seek-oss/braid-design-system/pull/526))
 
   This impacts the following components:
-
   - `Button`
   - `ButtonRenderer`
   - `OverflowMenu`
@@ -6759,5 +7128,4 @@ For more detail on the specific changes in this release, please read on.
 - 33139c8: Clone seekAnz theme to seekUnifiedBeta
 
   BREAKING CHANGE
-
   - `jobsDbRebrand` theme has been removed