@atlaskit/primitives
Version:
Primitives are token-backed low-level building blocks.
1,351 lines (900 loc) • 81.8 kB
Markdown
# @atlaskit/primitives
## 14.7.3
### Patch Changes
- [#154215](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/154215)
[`eccacf87bc9e5`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/eccacf87bc9e5) -
Tweaks formatting behaviour of the stage1 compiled codemod
## 14.7.2
### Patch Changes
- [#152840](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/152840)
[`c6830ce5e4911`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/c6830ce5e4911) -
Fix bug in `compiled-fork-stage1` codemod in which deprecated Pressable props were not being moved
into the `xcss` prop.
## 14.7.1
### Patch Changes
- [#148964](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/148964)
[`79dddcb8a67c0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/79dddcb8a67c0) -
Add tabindex="0" to Pressable for Safari so that click events are fired
- Updated dependencies
## 14.7.0
### Minor Changes
- [#146876](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/146876)
[`1f9d7feceff9f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1f9d7feceff9f) -
Removed deprecated unsafe anchor and unsafe anchor props.
## 14.6.0
### Minor Changes
- [#148632](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/148632)
[`9dd484b8a47eb`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/9dd484b8a47eb) -
Make `<Pressable backgroundColor>` and `<Anchor backgroundColor>` a deprecated prop to ease the
migration to `@atlaskit/primitives/compiled` as including a `backgroundColor` style map for this
component is a large bytesize impact and it may lead to bad patterns as you should typically also
have `backgroundColor` changes in `&:hover` and `&:focus` states.
### Patch Changes
- Updated dependencies
## 14.5.0
### Minor Changes
- [#148288](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/148288)
[`c31c2fb751ae5`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/c31c2fb751ae5) -
Add `backgroundColor` back to `props.style` and `props.xcss` for `Box` from
`@atlaskit/primitives/compiled` to have a more iterative migration, but we still prefer the
`props.backgroundColor` value.
## 14.4.0
### Minor Changes
- [#138526](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/138526)
[`1c66b8e32f30a`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1c66b8e32f30a) -
[ux] Removed feature flag `platform-typography-improved-color-control` resulting in automatic
color inversion based on bold surfaces will only affect the default color.
## 14.3.3
### Patch Changes
- [#138465](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/138465)
[`5349bc88cca65`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/5349bc88cca65) -
Fix outlineOffset types in XCSS.
## 14.3.2
### Patch Changes
- [#138447](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/138447)
[`0f50e1e11be49`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/0f50e1e11be49) -
Bugfix to `compiled-fork-stage1` codemod's handling of Grid props.
## 14.3.1
### Patch Changes
- [#137814](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/137814)
[`d2a58e04ac617`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/d2a58e04ac617) -
Fix bug in `compiled-fork-stage1` codemod in which Grid props would be transformed despite having
`xcss` prop.
## 14.3.0
### Minor Changes
- [#135655](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/135655)
[`71f8afb32ade5`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/71f8afb32ade5) -
Anchor will no longer render as a RouterLink for urls that use the blob: protocol.
### Patch Changes
- Updated dependencies
## 14.2.3
### Patch Changes
- [#133540](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/133540)
[`606c6a34e6c24`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/606c6a34e6c24) -
Fix type of `separator` in the Compiled variant of Inline.
## 14.2.2
### Patch Changes
- [#127093](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/127093)
[`1378ea7a99ce1`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1378ea7a99ce1) -
Upgrades `jscodeshift` to handle generics properly.
- Updated dependencies
## 14.2.1
### Patch Changes
- [#129972](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/129972)
[`b2d69a39e6687`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b2d69a39e6687) -
Update `@compiled/react` dependency for improved type checking support.
- Updated dependencies
## 14.2.0
### Minor Changes
- [#128868](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/128868)
[`b24df558e8edb`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b24df558e8edb) -
Introduces codemod to support the first stage of the compiled migration. This codemod only
migrates to the compiled variant if xcss is not used
## 14.1.4
### Patch Changes
- [#124329](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/124329)
[`b0d988fe689d9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/b0d988fe689d9) -
Consolidate ADS themes by adding the icon.color.subtlest with the value equal to icon.color.subtle
to non-brand-refresh themes
- Updated dependencies
## 14.1.3
### Patch Changes
- Updated dependencies
## 14.1.2
### Patch Changes
- [#119650](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/119650)
[`51704d016e269`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/51704d016e269) -
Fix typo in documentation.
## 14.1.1
### Patch Changes
- [#119116](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/119116)
[`96ff1753a7299`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/96ff1753a7299) -
Update dependencies and remove unused internal exports.
## 14.1.0
### Minor Changes
- [#118121](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/pull-requests/118121)
[`4850fa1a503ba`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/4850fa1a503ba) -
[ux] Automatic color inversion based on bold surfaces will only affect the default color behind a
feature flag. If testing successful, this change will be made available in a later release.
### Patch Changes
- Updated dependencies
## 14.0.0
### Major Changes
- [#117363](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/117363)
[`10a0f7f6c2027`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/10a0f7f6c2027) -
This package's `peerDependencies` have been adjusted for `react` and/or `react-dom` to reflect the
status of only supporting React 18 going forward. No explicit breaking change to React support has
been made in this release, but this is to signify going forward, breaking changes for React 16 or
React 17 may come via non-major semver releases.
Please refer this community post for more details:
https://community.developer.atlassian.com/t/rfc-78-dropping-support-for-react-16-and-rendering-in-a-react-18-concurrent-root-in-jira-and-confluence/87026
### Patch Changes
- Updated dependencies
## 13.6.0
### Minor Changes
- [#116138](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/116138)
[`b50c5d5d65ae2`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b50c5d5d65ae2) -
Bump to the latest version of @compiled/react
### Patch Changes
- Updated dependencies
## 13.5.1
### Patch Changes
- [#115124](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/115124)
[`b6dd4e0fcdd67`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b6dd4e0fcdd67) -
Added support for style overrides of `overflowWrap` and `textDecorationLine` for the compiled
version of Text.
## 13.5.0
### Minor Changes
- [#112172](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/112172)
[`54699aa47995b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/54699aa47995b) -
[ux] Removed feature flag `platform-primitives-nested-text-inherit-size` resulting in Text to
inherit size when nested in other Text component.
## 13.4.1
### Patch Changes
- Updated dependencies
## 13.4.0
### Minor Changes
- [#109060](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/109060)
[`4660ec858a305`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/4660ec858a305) -
Update `React` from v16 to v18
### Patch Changes
- Updated dependencies
## 13.3.8
### Patch Changes
- [#103999](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/103999)
[`9f62ecec4d422`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/9f62ecec4d422) -
Update dependencies.
## 13.3.7
### Patch Changes
- Updated dependencies
## 13.3.6
### Patch Changes
- [#99467](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/99467)
[`118e81bbb4659`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/118e81bbb4659) -
Internal changes to typography.
## 13.3.5
### Patch Changes
- [#180173](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/180173)
[`6be28a4ed15b1`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/6be28a4ed15b1) -
Fixing label text for compiled/anchor to be 1:1 with primitive as part of compiled migration
## 13.3.4
### Patch Changes
- [#178771](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/178771)
[`77f2655aef31d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/77f2655aef31d) -
Fixing label text for compiled/anchor to be 1:1 with primitive as part of compiled migration
## 13.3.3
### Patch Changes
- [#178053](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/178053)
[`cb318c8c28c26`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/cb318c8c28c26) -
Internal changes to typography.
## 13.3.2
### Patch Changes
- [#175552](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/175552)
[`0384c8ac8996a`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0384c8ac8996a) -
Narrow down fontStyle type definition to only allow `normal` and `italic`.
## 13.3.1
### Patch Changes
- Updated dependencies
## 13.3.0
### Minor Changes
- [#165860](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/165860)
[`c2dec1ca710f3`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c2dec1ca710f3) -
Adds an experimental Focusable component under the Compiled entrypoint, which requires a specific
setup.
## 13.2.0
### Minor Changes
- [#162507](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/162507)
[`55f201f2b2d04`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/55f201f2b2d04) -
[ux] Text to inherit size when nested in other Text component behind a feature flag. If testing
successful, this change will be made available in a later release.
## 13.1.0
### Minor Changes
- [#161694](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/161694)
[`22f69cdefebd9`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/22f69cdefebd9) -
Add compiled.css sideEffect to @atlaskit/primitives to hint and fix bundlers to load these styles
## 13.0.0
### Major Changes
- [#158114](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/158114)
[`01676a379617b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/01676a379617b) -
This generates a new entrypoint for opt-in to Compiled through `@atlaskit/primitives/compiled`.
No documentation is currently available on how to use this, and this is for internal testing, use
at your own risk.
Possibly BREAKING: In theory, this could have an impact depending on your bundling setup due to
newly distributed `dist/cjs/compiled/box.compiled.css` type files—the most notable impact is in an
extreme, Webpack may error if it was not expecting `*.css` files (and then these files could be
ignored for now following future updates), _or_ are included but not used, increasing
client-facing bundle size.
### Minor Changes
- [#158114](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/158114)
[`01676a379617b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/01676a379617b) -
Remove the UNSAFE_SurfaceContext export which was temporarily used internally and not documented
for public use.
## 12.2.7
### Patch Changes
- [#155472](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/155472)
[`3d80f6ab74b68`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/3d80f6ab74b68) -
Add zIndex: 1 to XCSS layer API.
## 12.2.6
### Patch Changes
- Updated dependencies
## 12.2.5
### Patch Changes
- [#150360](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/150360)
[`284490a8c1813`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/284490a8c1813) -
Update codegen script to output into primitives-emotion-to-compiled codemod.
## 12.2.4
### Patch Changes
- Updated dependencies
## 12.2.3
### Patch Changes
- [#148281](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/148281)
[`3c4de48168ffe`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/3c4de48168ffe) -
Update the import path of `useId*` from `@atlaskit/ds-lib`
- Updated dependencies
## 12.2.2
### Patch Changes
- [#146405](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/146405)
[`a92a52978058c`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/a92a52978058c) -
Exports a temporary UNSAFE_SurfaceContext export that may be removed in a future minor version to
decouple Compiled migrations from Primitives
## 12.2.1
### Patch Changes
- Updated dependencies
## 12.2.0
### Minor Changes
- [#143323](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/143323)
[`4fdf6347eb506`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/4fdf6347eb506) -
Add new entrypoint called "use-layout-effect" to ds-lib and use it inside primitives pkg.
### Patch Changes
- Updated dependencies
## 12.1.2
### Patch Changes
- Updated dependencies
## 12.1.1
### Patch Changes
- [#137821](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/137821)
[`94620325283df`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/94620325283df) -
Remove `react-uid` and use an ID generator that is compatible with React16 and React 18; Strict
React 18 behind a flag.
## 12.1.0
### Minor Changes
- [`e0c305a0be2ce`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/e0c305a0be2ce) -
Added support for typography tokens to XCSS.
## 12.0.1
### Patch Changes
- Updated dependencies
## 12.0.0
### Major Changes
- [#128232](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/128232)
[`c97dfe9e5b27d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c97dfe9e5b27d) -
Box no longer supports usage as an anchor tag (`<a>`). Use
[the Anchor primitive](https://atlassian.design/components/primitives/anchor/examples) instead,
which is more specialized. This has benefits including:
- Built-in event tracking support
- Default text underlines
- Automatic router link configuration from `@atlaskit/app-provider`
- Built-in accessible focus styles
- Warning screen-readers when links open in new windows
**Migrating to Anchor**
- First consider if another ADS link component such as `@atlaskit/link` is better suited rather
than building a custom anchor.
- Anchor has focus ring styles built-in, so remove existing styles including
`@atlaskit/focus-ring`.
- Anchor has a default cursor (`cursor: pointer`), so existing styles can be removed.
- Anchor has a default link underline, so an existing style can be removed.
**Before migration**
```tsx
import { Box, xcss } from '@atlaskit/primitives';
import FocusRing from '@atlaskit/focus-ring';
const anchorStyles = xcss({
cursor: 'pointer',
color: 'color.link',
textDecoration: 'underline',
});
const MyApp = () => (
<FocusRing>
<Box as="a" href="/foo" xcss={anchorStyles}>
Hello
</Box>
</FocusRing>
);
```
**After migration**
```tsx
import { Anchor, xcss } from '@atlaskit/primitives';
const anchorStyles = xcss({
color: 'color.link',
});
const MyApp = () => (
<Anchor href="/foo" xcss={anchorStyles}>
Hello
</Anchor>
);
```
## 11.1.2
### Patch Changes
- Updated dependencies
## 11.1.1
### Patch Changes
- [#126649](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/126649)
[`24092d9f293a1`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/24092d9f293a1) -
Removed development warnings from JSDoc comment for Anchor primitive.
## 11.1.0
### Minor Changes
- [#123719](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/123719)
[`4de823258d64a`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/4de823258d64a) -
Added `dl` as a valid polymorphic element for both the `Inline` and `Stack` primitives.
## 11.0.2
### Patch Changes
- [#120336](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/120336)
[`62381baf0d2e1`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/62381baf0d2e1) -
Update 'opens new window' for anchor and link with a nicer AT announcement
## 11.0.1
### Patch Changes
- [#119548](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/119548)
[`c99cce707b5cb`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c99cce707b5cb) -
The separator prop in the inline component has had its type expanded to `ReactNode`.
- Updated dependencies
## 11.0.0
### Major Changes
- [#119014](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/119014)
[`80c46fcb18957`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/80c46fcb18957) -
Increased type safety for `xcss`. In general, non-token values for the following properties are no
longer allowed:
- `margin`
- `marginBlock`
- `marginBlockEnd`
- `marginBlockStart`
- `marginBottom`
- `marginInline`
- `marginInlineEnd`
- `marginInlineStart`
- `marginLeft`
- `marginRight`
- `marginTop`
- `paddingBottom`
- `paddingLeft`
- `paddingRight`
- `paddingTop`
Note: Logical properties for `padding`, e.g. `paddingInline`, already prohibit non-token values.
For example:
```typescript
const styles = xcss({
padding: '8px', // <-- Type Error
^^^^^
});
```
A few additional non-token values are still accepted:
- `margin`: `'0 auto'` | `'auto'` | `'0'`
- `marginBlock`: `'auto'` | `'0'`
- `marginBlockEnd`: `'auto'` | `'0'`
- `marginBlockStart`: `'auto'` | `'0'`
- `marginBottom`: `'auto'` | `'0'`
- `marginInline`: `'auto'` | `'0'`
- `marginInlineEnd`: `'auto'` | `'0'`
- `marginInlineStart`: `'auto'` | `'0'`
- `marginLeft`: `'auto'` | `'0'`
- `marginRight`: `'auto'` | `'0'`
- `marginTop`: `'auto'` | `'0'`
- `paddingBlock`: `'0'`
- `paddingBlockEnd`: `'0'`
- `paddingBlockStart`: `'0'`
- `paddingBottom`: `'0'`
- `paddingInline`: `'0'`
- `paddingInlineEnd`: `'0'`
- `paddingInlineStart`: `'0'`
- `paddingLeft`: `'0'`
- `paddingRight`: `'0'`
- `paddingTop`: `'0'`
as well as global CSS properties: `'inherit'` | `'initial'` | `'revert'` | `'revert-layer'` |
`'unset'`
## 10.1.0
### Minor Changes
- [`b78fad249a1e7`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b78fad249a1e7) -
Allow Negative Spaces in OutlineOffset
## 10.0.0
### Major Changes
- [#115948](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/115948)
[`1798755846b6d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/1798755846b6d) -
Released Anchor primitive to open beta.
## 9.0.0
### Major Changes
- [#114987](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/114987)
[`d4d420c947747`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/d4d420c947747) -
[ux] Pressable and Anchor primitives no longer support surface color detection to improve
performance. These primitives don't contain nested layouts so this is not needed. Although this is
a breaking change, the impact of this change is minimal as no usage of surface detection in these
primitives has been observed.
## 8.2.1
### Patch Changes
- [#113600](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/113600)
[`7ba62903cc2eb`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/7ba62903cc2eb) -
Internal changes to both Pressable and Anchor primitives. They no longer use the Box primitive.
There are no changes for consumers.
## 8.2.0
### Minor Changes
- [#114203](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/114203)
[`fb57afa892329`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/fb57afa892329) -
Added `:visited:hover` XCSS pseudo combination.
## 8.1.0
### Minor Changes
- [#113286](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/113286)
[`7c318f9ea8f09`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/7c318f9ea8f09) -
Added support for skeleton color tokens as XCSS background colors.
### Patch Changes
- Updated dependencies
## 8.0.1
### Patch Changes
- [#108692](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/108692)
[`294e1a9116fce`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/294e1a9116fce) -
Update `color.skeleton` and `color.skeleton.subtle` to be valid backgroundColor values on XCSS.
## 8.0.0
### Major Changes
- [#109778](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/109778)
[`d20b004b7c9dd`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/d20b004b7c9dd) -
Box no longer supports usage as a button. Use
[the Pressable primitive](https://atlassian.design/components/primitives/pressable/examples)
instead, which is more specialized and has built-in event tracking support.
- Pressable has focus ring styles built-in, so remove existing styles including
`@atlaskit/focus-ring`
- Pressable has a default cursor (`cursor: pointer`) built-in, so existing styles can be removed.
- Pressable has a `isDisabled` prop, rather than direct usage of the `disabled` attribute.
- Pressable is built on Box, so no visual changes are expected.
**Before migration**
```tsx
import { Box, xcss } from '@atlaskit/primitives';
import FocusRing from '@atlaskit/focus-ring';
const buttonStyles = xcss({
cursor: 'pointer',
backgroundColor: 'color.background.brand.bold',
});
const MyApp = () => (
<FocusRing>
<Box as="button" xcss={buttonStyles} disabled={isDisabled}>
Hello
</Box>
</FocusRing>
);
```
**After migration**
```tsx
import { Pressable, xcss } from '@atlaskit/primitives';
const buttonStyles = xcss({
backgroundColor: 'color.background.brand.bold',
});
const MyApp = () => (
<Pressable xcss={buttonStyles} isDisabled={isDisabled}>
Hello
</Pressable>
);
```
### Minor Changes
- [#108386](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/108386)
[`8f3fa9e80b93c`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/8f3fa9e80b93c) -
Updated xl breakpoint to be 1768px instead of 1760px (110.5rem instead of 110rem) to match updated
design guidance.
### Patch Changes
- Updated dependencies
## 7.4.1
### Patch Changes
- Updated dependencies
## 7.4.0
### Minor Changes
- [#110836](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110836)
[`a8bd419fd70b9`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/a8bd419fd70b9) -
Explicitly set jsxRuntime to classic via pragma comments in order to avoid issues where jsxRuntime
is implicitly set to automatic.
## 7.3.0
### Minor Changes
- [#111623](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/111623)
[`0392b6e4d865a`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0392b6e4d865a) -
The `Text` component now aplies `overflow-wrap: anywhere` by default to ensure text does not break
out of fixed width containers. Be aware that if a single word is wider than its container width,
the word will be broken over multiple lines.
## 7.2.0
### Minor Changes
- [#108733](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/108733)
[`c414bbde52951`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c414bbde52951) -
Extends XCSS type to support `:focus:not(:focus-visible)`
### Patch Changes
- [#108733](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/108733)
[`c414bbde52951`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c414bbde52951) -
Adds a `:focus` style reset to `Anchor` and `Pressable` to prevent `:focus` styles with lower
specificity from leaking through.
## 7.1.0
### Minor Changes
- [#110702](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110702)
[`b8c2eefeb195b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b8c2eefeb195b) - -
Anchor and Pressable primitives no longer require `children`, so labels can be supplied through
aria attributes if required
### Patch Changes
- [#110702](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110702)
[`b8c2eefeb195b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b8c2eefeb195b) - -
Fixed a bug with Anchor, where the "(opens new window)" label was not being automatically appended
to `aria-label` or `aria-labelledby`.
## 7.0.3
### Patch Changes
- [#110975](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110975)
[`c462a22b33940`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c462a22b33940) -
Removed type hinting for size values in the following properties in XCSS:
- blockSize
- height
- inlineSize
- maxBlockSize
- maxHeight
- maxInlineSize
- maxWidth
- minBlockSize
- minHeight
- minInlineSize
- minWidth
- width
These properties optionally accept size values like `width: 'size.100'`. However `size` will be
deprecated in the future. Therefore, the type hinting that displayed `size.XXX` has been removed
to discourage its usage until it is officially deprecated.
No changes in functionality have been introduced. The syntax `width: 'size.100'` remains valid for
now, so existing code will not be broken. However, consumers are encouraged to use hard-coded
values, like `width: '8px'`, instead.
## 7.0.2
### Patch Changes
- [#110867](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110867)
[`dc7e72da70ef7`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/dc7e72da70ef7) -
Migrating instances of `UNSAFE_ANCHOR` primitive imports to the new safe import `Anchor`, in
preparation of Anchor open beta and removal of the unsafe export from `@atlaskit/primitives`
## 7.0.1
### Patch Changes
- [#110191](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/110191)
[`c3dc02298f8aa`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c3dc02298f8aa) -
[ux] Change heading xsmall lineheight from 16 to 20 for minor third theme.
- Updated dependencies
## 7.0.0
### Major Changes
- [#108387](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/108387)
[`0f3b7b4c63c6d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0f3b7b4c63c6d) -
`xcss`: Restrict valid chained pseudo-selectors a limited subset:
- `:visited:active`
- `:active:visited`
- `:hover::before`
- `:hover::after`
- `:focus-visible::before`
- `:focus-visible::after`
Previously, any combination of two pseudo-selectors was allowed. This decision was made to improve
performance for TypeScript compilation and IDE type hinting.
## 6.5.0
### Minor Changes
- [#107382](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/107382)
[`219600ccac79`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/219600ccac79) -
Adding safe exports for `Anchor` primitive in preparation for open beta. The `UNSAFE_` prefixed
exports have been deprecated and will be removed in an upcoming major release.
## 6.4.0
### Minor Changes
- [#105558](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/105558)
[`9e4502966543`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/9e4502966543) -
Relax type safety on `borderWidth`, `borderRadius`, and their variant properties on `xcss`. The
tokens for those properties will be deprecated in future in favor of new border tokens.
## 6.3.0
### Minor Changes
- [#95202](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/95202)
[`b28e3d55ab88`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/b28e3d55ab88) -
Adds "Fill" to the set of exported style map types
### Patch Changes
- Updated dependencies
## 6.2.0
### Minor Changes
- [#100442](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/100442)
[`6b3630addb05`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/6b3630addb05) -
Add `xcss` to responsive components `Show` and `Hide`.
## 6.1.2
### Patch Changes
- [#98149](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/98149)
[`45101e24202a`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/45101e24202a) -
Internal change only; update generated styles.
- Updated dependencies
## 6.1.1
### Patch Changes
- [#97580](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/97580)
[`496e5da89b3b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/496e5da89b3b) -
Export unsafe surface APIs for use in heading component.
## 6.1.0
### Minor Changes
- [#96841](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/96841)
[`6cca90095b7e`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/6cca90095b7e) - -
Pressable now accepts a `role` attribute.
- The `UNSAFE_PressableProps` export has been renamed to `PressableProps`. This is unused in
products.
## 6.0.0
### Major Changes
- [#96847](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/96847)
[`914419349eeb`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/914419349eeb) - -
`Pressable` primitive is now in beta.
- Pressable unsafe exports `UNSAFE_PRESSABLE` and `UNSAFE_PressableProps` have been removed.
## 5.7.0
### Minor Changes
- [#93706](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/93706)
[`2e4fdfa436da`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/2e4fdfa436da) -
Add support for React 18 in non-strict mode.
## 5.6.1
### Patch Changes
- [#94316](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/94316)
[`35fd5ed8e1d7`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/35fd5ed8e1d7) -
Upgrading internal dependency `bind-event-listener` to `@^3.0.0`
- [#93980](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/93980)
[`0437b8b3c791`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0437b8b3c791) -
Updated imports of `UNSAFE_PRESSABLE` primitive to new `Pressable` export
## 5.6.0
### Minor Changes
- [#93535](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/93535)
[`e9177e2fdee3`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/e9177e2fdee3) -
Adds new export for Pressable as `Pressable` in preparation for open beta. The previous
`UNSAFE_PRESSABLE` export remains available while existing usages are migrated, and will be
removed in an upcoming major release.
### Patch Changes
- [#92007](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/92007)
[`85525725cb0d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/85525725cb0d) -
Migrated to the new button component
## 5.5.3
### Patch Changes
- Updated dependencies
## 5.5.2
### Patch Changes
- Updated dependencies
## 5.5.1
### Patch Changes
- [#88354](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/88354)
[`4c87d9b4f0c2`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/4c87d9b4f0c2) -
The internal composition of this component has changed. There is no expected change in behavior.
## 5.5.0
### Minor Changes
- [#86439](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/86439)
[`43cd9551f332`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/43cd9551f332) -
Removed deprecated `textAlign` prop from Text primitive component
## 5.4.0
### Minor Changes
- [#85745](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/85745)
[`0e9c8c15ef86`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0e9c8c15ef86) -
Extends XCSS selector types to allow up to two CSS psuedos to be used in combination. For example:
`:visited:hover {}`.
### Patch Changes
- Updated dependencies
## 5.3.0
### Minor Changes
- [#86400](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/86400)
[`92f574fd392d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/92f574fd392d) -
Anchor now suffixes the accessible label with visually hidden text "(opens new window)" when
`target` is set to `_blank`. This improves accessibility for screen readers.
- Anchor no longer automatically opens external links in new windows, which is a poor usability and
accessibility practice. Previously this involved applying default attributes
`rel="noopener noreferrer"` and `target="_blank"` when the link was detected to link externally.
## 5.2.0
### Minor Changes
- [#86279](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/86279)
[`0988fda99a0d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0988fda99a0d) -
Renaming text alignment prop for Text component from `textAlign` to `align`
## 5.1.2
### Patch Changes
- [#80174](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/80174)
[`2a4fd6ccba31`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/2a4fd6ccba31) -
Add forwardRef to text component
## 5.1.1
### Patch Changes
- [#83116](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/83116)
[`8d4e99057fe0`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/8d4e99057fe0) -
Upgrade Typescript from `4.9.5` to `5.4.2`
- Updated dependencies
## 5.1.0
### Minor Changes
- [#78900](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/78900)
[`6ea786dd8082`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/6ea786dd8082) -
Add UNSAFE_small fontsize token.
### Patch Changes
- Updated dependencies
## 5.0.1
### Patch Changes
- Updated dependencies
## 5.0.0
### Major Changes
- [#81744](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/81744)
[`30e3d8c81030`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/30e3d8c81030) -
Replaced `Text`'s `variant` prop with a `size` prop. The `size` prop takes three values:
`"small"`, `"medium"` (default), and `"large"`.
Migration guide:
- `variant="body.small"` -> `size="small"`
- `variant="body"` -> `size="medium"` (Note: Since medium is the default, the size prop can be
omitted here)
- `variant="body.large"` -> `size="large"`
## 4.1.1
### Patch Changes
- [#81644](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/81644)
[`8ab7a816dca7`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/8ab7a816dca7) -
Revert input border change from the previous version
## 4.1.0
### Minor Changes
- [#80528](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/80528)
[`8877e9b57d55`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/8877e9b57d55) -
Added `size` prop which will replace `variant` prop in the next major version.
## 4.0.2
### Patch Changes
- [#80805](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/80805)
[`427c2dd9e0d6`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/427c2dd9e0d6) -
Update input border color token and width to meet 3:1 color contrast
- Updated dependencies
## 4.0.1
### Patch Changes
- [#79770](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/79770)
[`542e29efe0ad`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/542e29efe0ad) -
Update imports from @atlaskit/tokens
- Updated dependencies
## 4.0.0
### Major Changes
- [#77148](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/77148)
[`473df43e816b`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/473df43e816b) -
Removed `ui` variant from Text component. The `body` variant should be used for all non-heading
typography.
### Patch Changes
- Updated dependencies
## 3.2.0
### Minor Changes
- [#77488](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/77488)
[`9e119dcbfd60`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/9e119dcbfd60) -
The `xcss` prop on select components have had its type expanded to support styles being passed
from Compiled CSS-in-JS. This is still experimental and something we'll be iterating on.
## 3.1.0
### Minor Changes
- [#76431](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/76431)
[`c6819de73d02`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c6819de73d02) -
Default text color + allow color inheritance if explicitly defined
## 3.0.0
### Major Changes
- [#58240](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58240)
[`a45d2049a22c`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/a45d2049a22c) -
The "Link" primitive has been renamed to "Anchor" to avoid confusion with the upcoming "Link"
component. Since Link is still in Alpha this should not cause any upgrade friction.
### Minor Changes
- [#58240](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58240)
[`75b2ade8b254`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/75b2ade8b254) -
Both the Pressable and Anchor primitives now support analytics tracking by default.
- [#58240](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58240)
[`39f3c929f0c4`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/39f3c929f0c4) -
Add Pressable and Anchor primitives (in Alpha) to root export as `UNSAFE_PRESSABLE` and
`UNSAFE_LINK`.
### Patch Changes
- [#58240](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58240)
[`4951390bc0ae`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/4951390bc0ae) -
[ux] Adds a default underline style to the Anchor primitive (Alpha)
## 2.1.0
### Minor Changes
- [#74930](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/74930)
[`707a8fee2aee`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/707a8fee2aee) -
Both the Pressable and Anchor primitives (in Alpha) now support analytics tracking in the same
fashion as `@atlaskit/button`. An additional prop `componentName` allows analytics to be
configured if a parent component name is desired to be tracked rather than the primitive names.
For the time being this tracking is opt-in via use of the `componentName` prop. This will be made
default behavior in an upcoming release once tracking is removed in the new Buttons, and
`@atlaskit/button` is bumped to use the latest version of `@atlaskit/primitives`
- [#75221](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/75221)
[`c15d58bff276`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c15d58bff276) -
`Text` inherits color by default if `color` prop is not provided. Removed auto-collapsing
behaviour of `Text`
## 2.0.3
### Patch Changes
- [#74836](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/74836)
[`3963062ac997`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/3963062ac997) -
Codegen to add in new font family tokens. Not exposed in any components.
- Updated dependencies
## 2.0.2
### Patch Changes
- [#72557](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/72557)
[`0c78c9c18cb7`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/0c78c9c18cb7) -
Fix font family not preferencing apple system fonts on macOS
## 2.0.1
### Patch Changes
- Updated dependencies
## 2.0.0
### Major Changes
- [#68009](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/68009)
[`1168354ed6ef`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/1168354ed6ef) -
We now ensure the specificity of our `xcss`-based overrides are consistent across all primitives
so `xcss` will always override props.
This resulted in a breaking change wtih Grid. For example,
`<Grid templateAreas="…" xcss({ gridTemplateAreas: "…" })>` will result in different styles
resolution before and after this version. This applies to `templateAreas`, `templateColumns`, and
`templateRows`). From static analysis, we found only one known usage of this and it has been
resolved.
## 1.20.0
### Minor Changes
- [#68163](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/68163)
[`67d09e3f972d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/67d09e3f972d) -
`weight` property added to `Text` to allow overriding text variant default font weight.
- [#69343](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/69343)
[`77249f536425`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/77249f536425) -
`Text` color prop defaults to `color.text` if not provided.
### Patch Changes
- Updated dependencies
## 1.19.0
### Minor Changes
- [#66702](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/66702)
[`5b6bbaf2d5fc`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/5b6bbaf2d5fc) -
Added `maxLines` prop to `Text` component, allowing truncation at a certain number of lines. This
prop replaces `shouldTruncate` prop.
### Patch Changes
- [#67698](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/67698)
[`175c07b58c52`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/175c07b58c52) -
Export tokensMap object
## 1.18.0
### Minor Changes
- [#67463](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/67463)
[`adf1c3ebf0fd`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/adf1c3ebf0fd) -
Fixed an issue with `Text` where text could render incorrectly if a typography token theme was not
present on a page.
### Patch Changes
- Updated dependencies
## 1.17.0
### Minor Changes
- [#65770](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/65770)
[`1e2db2714522`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/1e2db2714522) -
The `shouldTruncate` prop on `Text` is now only available for `body` variants and cannot be used
with `ui` variants.
## 1.16.0
### Minor Changes
- [#63526](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/63526)
[`e8835feffae9`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/e8835feffae9) -
Internal change to improve token sorting logic for typography tokens. Typography tokens are now
marked as active though they are still in development and not recommend for use without prior
approval from ADS.
### Patch Changes
- Updated dependencies
## 1.15.2
### Patch Changes
- [#61090](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/61090)
[`2e34d3535125`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/2e34d3535125) - -
Fixed issue where using negative space tokens in `xcss` wouldn't apply.
- Allow negative space tokens for position properties in `xcss` (i.e. top, bottom, left, right,
and inset-\*).
## 1.15.1
### Patch Changes
- [#57241](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/57241)
[`cae2e80ae968`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/cae2e80ae968) -
Migrate webdriver tests for @atlassian/product-search-dialog
## 1.15.0
### Minor Changes
- [#60570](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/60570)
[`d74bd13bec9c`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/d74bd13bec9c) -
Restrict usage of data-testid to primitives (`testId` should be used instead). This prop is
currently silently ignored so this is just to follow the principle of least surprise when using
primitives.
### Patch Changes
- Updated dependencies
## 1.14.0
### Minor Changes
- [#58048](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58048)
[`cc9e9495e995`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/cc9e9495e995) -
Export `media.only` and `media.below` for Compiled CSS-in-JS support.
## 1.13.1
### Patch Changes
- [#58444](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/58444)
[`c0499565188d`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c0499565188d) -
Update package.json documentation metadata.
## 1.13.0
### Minor Changes
- [#57795](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/57795)
[`d2c06815d043`](https://stash.atl