@atlaskit/primitives 2.1.0 → 3.1.0

package/dist/es2019/components/{link.js → anchor.js}

@@ -15,6 +15,9 @@ const baseFocusRingStyles = {
   outlineStyle: 'solid',
   outlineOffset: 'space.025'
 };
+const defaultStyles = xcss({
+  textDecoration: 'underline'
+});
 const focusRingStyles = xcss({
   ':focus-visible': baseFocusRingStyles,
   '@supports not selector(*:focus-visible)': {
@@ -28,7 +31,7 @@ const focusRingStyles = xcss({
 });
 const IS_EXTERNAL_LINK_REGEX = /^(?:(http|https):\/\/)/;
 const IS_NON_HTTP_BASED = /^(((mailto|tel|sms):)|(#))/;
-const Link = ({
+const Anchor = ({
   href,
   children,
   backgroundColor,
@@ -59,14 +62,14 @@ const Link = ({
     action: 'clicked',
     componentName: componentName || 'Anchor',
     packageName: "@atlaskit/primitives",
-    packageVersion: "2.1.0",
+    packageVersion: "3.1.0",
     analyticsData: analyticsContext,
     actionSubject: 'link'
   });
   const RouterLink = useRouterLink();
 
   // Combine default styles with supplied styles. XCSS does not support deep nested arrays
-  const styles = Array.isArray(xcssStyles) ? [focusRingStyles, ...xcssStyles] : [focusRingStyles, xcssStyles];
+  const styles = Array.isArray(xcssStyles) ? [defaultStyles, focusRingStyles, ...xcssStyles] : [defaultStyles, focusRingStyles, xcssStyles];
   const isExternal = typeof href === 'string' && IS_EXTERNAL_LINK_REGEX.test(href);
   const isNonHttpBased = typeof href === 'string' && IS_NON_HTTP_BASED.test(href);
 
@@ -79,7 +82,7 @@ const Link = ({
    */
   const isRouterLink = RouterLink && !isExternal && !isNonHttpBased;
   const hrefObjectUsedWithoutRouterLink = RouterLink === undefined && typeof href === 'object';
-  invariant(!hrefObjectUsedWithoutRouterLink, `@atlaskit/primitives: Link primitive cannot pass an object to 'href' unless a router link is configured in the AppProvider`);
+  invariant(!hrefObjectUsedWithoutRouterLink, `@atlaskit/primitives: Anchor primitive cannot pass an object to 'href' unless a router link is configured in the AppProvider`);
   return /*#__PURE__*/React.createElement(Box
   // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
   , _extends({}, htmlAttributes, {
@@ -98,12 +101,8 @@ const Link = ({
     paddingBlockEnd: paddingBlockEnd,
     paddingInline: paddingInline,
     paddingInlineStart: paddingInlineStart,
-    paddingInlineEnd: paddingInlineEnd
-    // TODO: This only tracks events if componentName is supplied, which makes tracking opt-in during
-    // the transition period. This will be removed once `@atlaskit/button` is bumped to use the latest
-    // version of primitives
-    ,
-    onClick: componentName ? onClick : providedOnClick
+    paddingInlineEnd: paddingInlineEnd,
+    onClick: onClick
     // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
     ,
     xcss: styles
@@ -112,17 +111,17 @@ const Link = ({
 
 // Workarounds to support generic types with forwardRef
 /**
- * __UNSAFE_LINK__
+ * __UNSAFE_ANCHOR__
  *
  * @internal Still under development. Do not use.
  *
- * Link is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
+ * Anchor is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
  *
  * This component is mostly used by other design system components, such as the [link component](/components/link/usage).
  *
- * - [Examples](https://atlassian.design/components/primitives/link/examples)
- * - [Code](https://atlassian.design/components/primitives/link/code)
- * - [Usage](https://atlassian.design/components/primitives/link/usage)
+ * - [Examples](https://atlassian.design/components/primitives/anchor/examples)
+ * - [Code](https://atlassian.design/components/primitives/anchor/code)
+ * - [Usage](https://atlassian.design/components/primitives/anchor/usage)
  */
-const UNSAFE_LINK = /*#__PURE__*/forwardRef(Link);
-export default UNSAFE_LINK;
+const UNSAFE_ANCHOR = /*#__PURE__*/forwardRef(Anchor);
+export default UNSAFE_ANCHOR;

package/dist/es2019/components/pressable.js

@@ -66,7 +66,7 @@ const UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(({
     action: 'clicked',
     componentName: componentName || 'Pressable',
     packageName: "@atlaskit/primitives",
-    packageVersion: "2.1.0",
+    packageVersion: "3.1.0",
     analyticsData: analyticsContext,
     actionSubject: 'button'
   });
@@ -80,12 +80,8 @@ const UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(({
     as: "button",
     ref: ref,
     testId: testId,
-    type: type
-    // TODO: This only tracks events if componentName is supplied, which makes tracking opt-in during
-    // the transition period. This will be removed once `@atlaskit/button` is bumped to use the latest
-    // version of primitives
-    ,
-    onClick: componentName ? onClick : providedOnClick,
+    type: type,
+    onClick: onClick,
     backgroundColor: backgroundColor,
     padding: padding,
     paddingBlock: paddingBlock,

package/dist/es2019/components/text.js

@@ -1,5 +1,5 @@
 /** @jsx jsx */
-
+import { createContext, useContext } from 'react';
 import { css, jsx } from '@emotion/react';
 import invariant from 'tiny-invariant';
 import { bodyTextStylesMap, fontWeightStylesMap, inverseColorMap, textColorStylesMap, uiTextStylesMap } from '../xcss/style-maps.partial';
@@ -42,19 +42,29 @@ const wordBreakMap = {
     wordBreak: 'break-all'
   })
 };
+const HasTextAncestorContext = /*#__PURE__*/createContext(false);
+const useHasTextAncestor = () => useContext(HasTextAncestorContext);
 
 /**
  * Custom hook designed to abstract the parsing of the color props and make it clearer in the future how color is reconciled between themes and tokens.
  */
-const useColor = colorProp => {
+const useColor = (colorProp, hasTextAncestor) => {
   const surface = useSurface();
 
   /**
-   * Where the color of the surface is inverted we override the user choice
+   * Where the color of the surface is inverted we always override the color
    * as there is no valid choice that is not covered by the override.
    */
-  const color = inverseColorMap.hasOwnProperty(surface) ? inverseColorMap[surface] : colorProp;
-  return color;
+  if (inverseColorMap.hasOwnProperty(surface)) {
+    return inverseColorMap[surface];
+  }
+  if (colorProp === 'inherit') {
+    return undefined;
+  }
+  if (!colorProp && hasTextAncestor) {
+    return undefined;
+  }
+  return colorProp || 'color.text';
 };
 
 /**
@@ -71,7 +81,7 @@ const Text = ({
   ...props
 }) => {
   const {
-    as: asElement,
+    as: Component = 'span',
     color: colorProp,
     textAlign,
     testId,
@@ -79,10 +89,6 @@ const Text = ({
     variant = 'body',
     weight
   } = props;
-
-  // body variants -> p
-  // ui variants -> span
-  const Component = asElement || (variant.includes('body') ? 'p' : 'span');
   invariant(asAllowlist.includes(Component), `@atlaskit/primitives: Text received an invalid "as" value of "${Component}"`);
 
   // Remove the ability to bypass typescript errors for maxLines
@@ -90,14 +96,20 @@ const Text = ({
   if ('maxLines' in props && variant.includes('body')) {
     maxLines = props.maxLines;
   }
-  const color = useColor(colorProp);
-  return jsx(Component, {
-    css: [resetStyles, variant && variantStyles[variant], color && textColorStylesMap[color], maxLines && truncationStyles, maxLines === 1 && wordBreakMap.breakAll, textAlign && textAlignMap[textAlign], weight && fontWeightStylesMap[weight], asElement === 'em' && emStyles, asElement === 'strong' && strongStyles],
+  const hasTextAncestor = useHasTextAncestor();
+  const color = useColor(colorProp, hasTextAncestor);
+  const component = jsx(Component, {
+    css: [resetStyles, variantStyles[variant], color && textColorStylesMap[color], maxLines && truncationStyles, maxLines === 1 && wordBreakMap.breakAll, textAlign && textAlignMap[textAlign], weight && fontWeightStylesMap[weight], Component === 'em' && emStyles, Component === 'strong' && strongStyles],
     style: {
       WebkitLineClamp: maxLines
     },
     "data-testid": testId,
     id: id
   }, children);
+  return hasTextAncestor ?
+  // no need to re-apply context if the text is already wrapped
+  component : jsx(HasTextAncestorContext.Provider, {
+    value: true
+  }, component);
 };
 export default Text;

package/dist/es2019/index.js

@@ -6,5 +6,6 @@ export { default as Flex } from './components/flex';
 export { default as Grid } from './components/grid';
 export { default as Bleed } from './components/bleed';
 export { default as Text } from './components/text';
-export { default as UNSAFE_Pressable } from './components/pressable';
+export { default as UNSAFE_PRESSABLE } from './components/pressable';
+export { default as UNSAFE_ANCHOR } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';

package/dist/esm/components/{link.js → anchor.js}

@@ -19,6 +19,9 @@ var baseFocusRingStyles = {
   outlineStyle: 'solid',
   outlineOffset: 'space.025'
 };
+var defaultStyles = xcss({
+  textDecoration: 'underline'
+});
 var focusRingStyles = xcss({
   ':focus-visible': baseFocusRingStyles,
   '@supports not selector(*:focus-visible)': {
@@ -32,7 +35,7 @@ var focusRingStyles = xcss({
 });
 var IS_EXTERNAL_LINK_REGEX = /^(?:(http|https):\/\/)/;
 var IS_NON_HTTP_BASED = /^(((mailto|tel|sms):)|(#))/;
-var Link = function Link(_ref, ref) {
+var Anchor = function Anchor(_ref, ref) {
   var href = _ref.href,
     children = _ref.children,
     backgroundColor = _ref.backgroundColor,
@@ -63,14 +66,14 @@ var Link = function Link(_ref, ref) {
     action: 'clicked',
     componentName: componentName || 'Anchor',
     packageName: "@atlaskit/primitives",
-    packageVersion: "2.1.0",
+    packageVersion: "3.1.0",
     analyticsData: analyticsContext,
     actionSubject: 'link'
   });
   var RouterLink = useRouterLink();
 
   // Combine default styles with supplied styles. XCSS does not support deep nested arrays
-  var styles = Array.isArray(xcssStyles) ? [focusRingStyles].concat(_toConsumableArray(xcssStyles)) : [focusRingStyles, xcssStyles];
+  var styles = Array.isArray(xcssStyles) ? [defaultStyles, focusRingStyles].concat(_toConsumableArray(xcssStyles)) : [defaultStyles, focusRingStyles, xcssStyles];
   var isExternal = typeof href === 'string' && IS_EXTERNAL_LINK_REGEX.test(href);
   var isNonHttpBased = typeof href === 'string' && IS_NON_HTTP_BASED.test(href);
 
@@ -83,7 +86,7 @@ var Link = function Link(_ref, ref) {
    */
   var isRouterLink = RouterLink && !isExternal && !isNonHttpBased;
   var hrefObjectUsedWithoutRouterLink = RouterLink === undefined && _typeof(href) === 'object';
-  invariant(!hrefObjectUsedWithoutRouterLink, "@atlaskit/primitives: Link primitive cannot pass an object to 'href' unless a router link is configured in the AppProvider");
+  invariant(!hrefObjectUsedWithoutRouterLink, "@atlaskit/primitives: Anchor primitive cannot pass an object to 'href' unless a router link is configured in the AppProvider");
   return /*#__PURE__*/React.createElement(Box
   // eslint-disable-next-line @repo/internal/react/no-unsafe-spread-props
   , _extends({}, htmlAttributes, {
@@ -102,12 +105,8 @@ var Link = function Link(_ref, ref) {
     paddingBlockEnd: paddingBlockEnd,
     paddingInline: paddingInline,
     paddingInlineStart: paddingInlineStart,
-    paddingInlineEnd: paddingInlineEnd
-    // TODO: This only tracks events if componentName is supplied, which makes tracking opt-in during
-    // the transition period. This will be removed once `@atlaskit/button` is bumped to use the latest
-    // version of primitives
-    ,
-    onClick: componentName ? onClick : providedOnClick
+    paddingInlineEnd: paddingInlineEnd,
+    onClick: onClick
     // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
     ,
     xcss: styles
@@ -116,17 +115,17 @@ var Link = function Link(_ref, ref) {
 
 // Workarounds to support generic types with forwardRef
 /**
- * __UNSAFE_LINK__
+ * __UNSAFE_ANCHOR__
  *
  * @internal Still under development. Do not use.
  *
- * Link is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
+ * Anchor is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
  *
  * This component is mostly used by other design system components, such as the [link component](/components/link/usage).
  *
- * - [Examples](https://atlassian.design/components/primitives/link/examples)
- * - [Code](https://atlassian.design/components/primitives/link/code)
- * - [Usage](https://atlassian.design/components/primitives/link/usage)
+ * - [Examples](https://atlassian.design/components/primitives/anchor/examples)
+ * - [Code](https://atlassian.design/components/primitives/anchor/code)
+ * - [Usage](https://atlassian.design/components/primitives/anchor/usage)
  */
-var UNSAFE_LINK = /*#__PURE__*/forwardRef(Link);
-export default UNSAFE_LINK;
+var UNSAFE_ANCHOR = /*#__PURE__*/forwardRef(Anchor);
+export default UNSAFE_ANCHOR;

package/dist/esm/components/pressable.js

@@ -70,7 +70,7 @@ var UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(function (_ref, ref) {
     action: 'clicked',
     componentName: componentName || 'Pressable',
     packageName: "@atlaskit/primitives",
-    packageVersion: "2.1.0",
+    packageVersion: "3.1.0",
     analyticsData: analyticsContext,
     actionSubject: 'button'
   });
@@ -84,12 +84,8 @@ var UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(function (_ref, ref) {
     as: "button",
     ref: ref,
     testId: testId,
-    type: type
-    // TODO: This only tracks events if componentName is supplied, which makes tracking opt-in during
-    // the transition period. This will be removed once `@atlaskit/button` is bumped to use the latest
-    // version of primitives
-    ,
-    onClick: componentName ? onClick : providedOnClick,
+    type: type,
+    onClick: onClick,
     backgroundColor: backgroundColor,
     padding: padding,
     paddingBlock: paddingBlock,

package/dist/esm/components/text.js

@@ -4,7 +4,7 @@ var _excluded = ["children"];
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 /** @jsx jsx */
-
+import { createContext, useContext } from 'react';
 import { css, jsx } from '@emotion/react';
 import invariant from 'tiny-invariant';
 import { bodyTextStylesMap, fontWeightStylesMap, inverseColorMap, textColorStylesMap, uiTextStylesMap } from '../xcss/style-maps.partial';
@@ -44,19 +44,31 @@ var wordBreakMap = {
     wordBreak: 'break-all'
   })
 };
+var HasTextAncestorContext = /*#__PURE__*/createContext(false);
+var useHasTextAncestor = function useHasTextAncestor() {
+  return useContext(HasTextAncestorContext);
+};
 
 /**
  * Custom hook designed to abstract the parsing of the color props and make it clearer in the future how color is reconciled between themes and tokens.
  */
-var useColor = function useColor(colorProp) {
+var useColor = function useColor(colorProp, hasTextAncestor) {
   var surface = useSurface();
 
   /**
-   * Where the color of the surface is inverted we override the user choice
+   * Where the color of the surface is inverted we always override the color
    * as there is no valid choice that is not covered by the override.
    */
-  var color = inverseColorMap.hasOwnProperty(surface) ? inverseColorMap[surface] : colorProp;
-  return color;
+  if (inverseColorMap.hasOwnProperty(surface)) {
+    return inverseColorMap[surface];
+  }
+  if (colorProp === 'inherit') {
+    return undefined;
+  }
+  if (!colorProp && hasTextAncestor) {
+    return undefined;
+  }
+  return colorProp || 'color.text';
 };
 
 /**
@@ -71,7 +83,8 @@ var useColor = function useColor(colorProp) {
 var Text = function Text(_ref) {
   var children = _ref.children,
     props = _objectWithoutProperties(_ref, _excluded);
-  var asElement = props.as,
+  var _props$as = props.as,
+    Component = _props$as === void 0 ? 'span' : _props$as,
     colorProp = props.color,
     textAlign = props.textAlign,
     testId = props.testId,
@@ -79,10 +92,6 @@ var Text = function Text(_ref) {
     _props$variant = props.variant,
     variant = _props$variant === void 0 ? 'body' : _props$variant,
     weight = props.weight;
-
-  // body variants -> p
-  // ui variants -> span
-  var Component = asElement || (variant.includes('body') ? 'p' : 'span');
   invariant(asAllowlist.includes(Component), "@atlaskit/primitives: Text received an invalid \"as\" value of \"".concat(Component, "\""));
 
   // Remove the ability to bypass typescript errors for maxLines
@@ -90,14 +99,20 @@ var Text = function Text(_ref) {
   if ('maxLines' in props && variant.includes('body')) {
     maxLines = props.maxLines;
   }
-  var color = useColor(colorProp);
-  return jsx(Component, {
-    css: [resetStyles, variant && variantStyles[variant], color && textColorStylesMap[color], maxLines && truncationStyles, maxLines === 1 && wordBreakMap.breakAll, textAlign && textAlignMap[textAlign], weight && fontWeightStylesMap[weight], asElement === 'em' && emStyles, asElement === 'strong' && strongStyles],
+  var hasTextAncestor = useHasTextAncestor();
+  var color = useColor(colorProp, hasTextAncestor);
+  var component = jsx(Component, {
+    css: [resetStyles, variantStyles[variant], color && textColorStylesMap[color], maxLines && truncationStyles, maxLines === 1 && wordBreakMap.breakAll, textAlign && textAlignMap[textAlign], weight && fontWeightStylesMap[weight], Component === 'em' && emStyles, Component === 'strong' && strongStyles],
     style: {
       WebkitLineClamp: maxLines
     },
     "data-testid": testId,
     id: id
   }, children);
+  return hasTextAncestor ?
+  // no need to re-apply context if the text is already wrapped
+  component : jsx(HasTextAncestorContext.Provider, {
+    value: true
+  }, component);
 };
 export default Text;

package/dist/esm/index.js

@@ -6,5 +6,6 @@ export { default as Flex } from './components/flex';
 export { default as Grid } from './components/grid';
 export { default as Bleed } from './components/bleed';
 export { default as Text } from './components/text';
-export { default as UNSAFE_Pressable } from './components/pressable';
+export { default as UNSAFE_PRESSABLE } from './components/pressable';
+export { default as UNSAFE_ANCHOR } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';

package/dist/{types-ts4.5/components/link.d.ts → types/components/anchor.d.ts}

@@ -2,7 +2,7 @@ import React, { type ReactNode, type Ref } from 'react';
 import { UIAnalyticsEvent } from '@atlaskit/analytics-next';
 import { type RouterLinkComponentProps } from '@atlaskit/app-provider';
 import { type BoxProps } from './box';
-export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<'a'>, 'href' | 'as' | 'children' | 'style' | 'onClick'> & {
+export type AnchorProps<RouterLinkConfig extends Record<string, any> = never> = RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<'a'>, 'href' | 'as' | 'children' | 'style' | 'onClick'> & {
     /**
      * `children` should be defined to ensure links have text.
      */
@@ -10,7 +10,7 @@ export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = Ro
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: (e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent?: UIAnalyticsEvent) => void;
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent: UIAnalyticsEvent) => void;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -26,21 +26,21 @@ export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = Ro
      */
     analyticsContext?: Record<string, any>;
 };
-declare const Link: <RouterLinkConfig extends Record<string, any> = never>({ href, children, backgroundColor, padding, paddingBlock, paddingBlockStart, paddingBlockEnd, paddingInline, paddingInlineStart, paddingInlineEnd, testId, xcss: xcssStyles, target, rel, onClick: providedOnClick, interactionName, componentName, analyticsContext, ...htmlAttributes }: LinkProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
+declare const Anchor: <RouterLinkConfig extends Record<string, any> = never>({ href, children, backgroundColor, padding, paddingBlock, paddingBlockStart, paddingBlockEnd, paddingInline, paddingInlineStart, paddingInlineEnd, testId, xcss: xcssStyles, target, rel, onClick: providedOnClick, interactionName, componentName, analyticsContext, ...htmlAttributes }: AnchorProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
 /**
- * __UNSAFE_LINK__
+ * __UNSAFE_ANCHOR__
  *
  * @internal Still under development. Do not use.
  *
- * Link is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
+ * Anchor is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
  *
  * This component is mostly used by other design system components, such as the [link component](/components/link/usage).
  *
- * - [Examples](https://atlassian.design/components/primitives/link/examples)
- * - [Code](https://atlassian.design/components/primitives/link/code)
- * - [Usage](https://atlassian.design/components/primitives/link/usage)
+ * - [Examples](https://atlassian.design/components/primitives/anchor/examples)
+ * - [Code](https://atlassian.design/components/primitives/anchor/code)
+ * - [Usage](https://atlassian.design/components/primitives/anchor/usage)
  */
-declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never>(props: RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<"a">, "style" | "children" | "as" | "onClick" | "href"> & {
+declare const UNSAFE_ANCHOR: <RouterLinkConfig extends Record<string, any> = never>(props: RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<"a">, "style" | "children" | "as" | "onClick" | "href"> & {
     /**
      * `children` should be defined to ensure links have text.
      */
@@ -48,7 +48,7 @@ declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: ((e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent?: UIAnalyticsEvent) => void) | undefined;
+    onClick?: ((e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent: UIAnalyticsEvent) => void) | undefined;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -65,5 +65,5 @@ declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never
     analyticsContext?: Record<string, any> | undefined;
 } & {
     ref?: React.Ref<HTMLAnchorElement> | undefined;
-}) => ReturnType<typeof Link>;
-export default UNSAFE_LINK;
+}) => ReturnType<typeof Anchor>;
+export default UNSAFE_ANCHOR;

package/dist/types/components/pressable.d.ts

@@ -11,7 +11,7 @@ export type PressableProps = Omit<BoxProps<'button'>, 'disabled' | 'as' | 'child
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: (e: React.MouseEvent<HTMLButtonElement>, analyticsEvent?: UIAnalyticsEvent) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>, analyticsEvent: UIAnalyticsEvent) => void;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -48,7 +48,7 @@ declare const UNSAFE_PRESSABLE: React.ForwardRefExoticComponent<Pick<Omit<BoxPro
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: ((e: React.MouseEvent<HTMLButtonElement>, analyticsEvent?: UIAnalyticsEvent) => void) | undefined;
+    onClick?: ((e: React.MouseEvent<HTMLButtonElement>, analyticsEvent: UIAnalyticsEvent) => void) | undefined;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).

package/dist/types/components/text.d.ts

@@ -36,10 +36,10 @@ type TextPropsBase = {
     children: ReactNode;
     /**
      * Token representing text color with a built-in fallback value.
-     * Will apply inverse text color automatically if placed within a Box with backgroundColor.
-     *
+     * Will apply inverse text color automatically if placed within a Box with bold background color.
+     * Defaults to `text.color` if not nested in other Text components.
      */
-    color?: TextColor;
+    color?: TextColor | 'inherit';
     /**
      * The [HTML `id` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id).
      */

package/dist/types/index.d.ts

@@ -15,7 +15,9 @@ export { default as Bleed } from './components/bleed';
 export type { BleedProps } from './components/bleed';
 export { default as Text } from './components/text';
 export type { TextProps } from './components/text';
-export { default as UNSAFE_Pressable } from './components/pressable';
+export { default as UNSAFE_PRESSABLE } from './components/pressable';
 export type { PressableProps as UNSAFE_PressableProps } from './components/pressable';
+export { default as UNSAFE_ANCHOR } from './components/anchor';
+export type { AnchorProps as UNSAFE_AnchorProps } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';
 export type { Breakpoint, MediaQuery } from './responsive';

package/dist/{types/components/link.d.ts → types-ts4.5/components/anchor.d.ts}

@@ -2,7 +2,7 @@ import React, { type ReactNode, type Ref } from 'react';
 import { UIAnalyticsEvent } from '@atlaskit/analytics-next';
 import { type RouterLinkComponentProps } from '@atlaskit/app-provider';
 import { type BoxProps } from './box';
-export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<'a'>, 'href' | 'as' | 'children' | 'style' | 'onClick'> & {
+export type AnchorProps<RouterLinkConfig extends Record<string, any> = never> = RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<'a'>, 'href' | 'as' | 'children' | 'style' | 'onClick'> & {
     /**
      * `children` should be defined to ensure links have text.
      */
@@ -10,7 +10,7 @@ export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = Ro
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: (e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent?: UIAnalyticsEvent) => void;
+    onClick?: (e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent: UIAnalyticsEvent) => void;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -26,21 +26,21 @@ export type LinkProps<RouterLinkConfig extends Record<string, any> = never> = Ro
      */
     analyticsContext?: Record<string, any>;
 };
-declare const Link: <RouterLinkConfig extends Record<string, any> = never>({ href, children, backgroundColor, padding, paddingBlock, paddingBlockStart, paddingBlockEnd, paddingInline, paddingInlineStart, paddingInlineEnd, testId, xcss: xcssStyles, target, rel, onClick: providedOnClick, interactionName, componentName, analyticsContext, ...htmlAttributes }: LinkProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
+declare const Anchor: <RouterLinkConfig extends Record<string, any> = never>({ href, children, backgroundColor, padding, paddingBlock, paddingBlockStart, paddingBlockEnd, paddingInline, paddingInlineStart, paddingInlineEnd, testId, xcss: xcssStyles, target, rel, onClick: providedOnClick, interactionName, componentName, analyticsContext, ...htmlAttributes }: AnchorProps<RouterLinkConfig>, ref: Ref<HTMLAnchorElement>) => JSX.Element;
 /**
- * __UNSAFE_LINK__
+ * __UNSAFE_ANCHOR__
  *
  * @internal Still under development. Do not use.
  *
- * Link is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
+ * Anchor is a primitive for building custom anchor links. It's a wrapper around the HTML `<a>` element that provides a consistent API for handling client-side routing and Atlassian Design System styling.
  *
  * This component is mostly used by other design system components, such as the [link component](/components/link/usage).
  *
- * - [Examples](https://atlassian.design/components/primitives/link/examples)
- * - [Code](https://atlassian.design/components/primitives/link/code)
- * - [Usage](https://atlassian.design/components/primitives/link/usage)
+ * - [Examples](https://atlassian.design/components/primitives/anchor/examples)
+ * - [Code](https://atlassian.design/components/primitives/anchor/code)
+ * - [Usage](https://atlassian.design/components/primitives/anchor/usage)
  */
-declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never>(props: RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<"a">, "style" | "children" | "as" | "onClick" | "href"> & {
+declare const UNSAFE_ANCHOR: <RouterLinkConfig extends Record<string, any> = never>(props: RouterLinkComponentProps<RouterLinkConfig> & Omit<BoxProps<"a">, "style" | "children" | "as" | "onClick" | "href"> & {
     /**
      * `children` should be defined to ensure links have text.
      */
@@ -48,7 +48,7 @@ declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: ((e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent?: UIAnalyticsEvent) => void) | undefined;
+    onClick?: ((e: React.MouseEvent<HTMLAnchorElement>, analyticsEvent: UIAnalyticsEvent) => void) | undefined;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -65,5 +65,5 @@ declare const UNSAFE_LINK: <RouterLinkConfig extends Record<string, any> = never
     analyticsContext?: Record<string, any> | undefined;
 } & {
     ref?: React.Ref<HTMLAnchorElement> | undefined;
-}) => ReturnType<typeof Link>;
-export default UNSAFE_LINK;
+}) => ReturnType<typeof Anchor>;
+export default UNSAFE_ANCHOR;

package/dist/types-ts4.5/components/pressable.d.ts

@@ -11,7 +11,7 @@ export type PressableProps = Omit<BoxProps<'button'>, 'disabled' | 'as' | 'child
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: (e: React.MouseEvent<HTMLButtonElement>, analyticsEvent?: UIAnalyticsEvent) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>, analyticsEvent: UIAnalyticsEvent) => void;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
@@ -48,7 +48,7 @@ declare const UNSAFE_PRESSABLE: React.ForwardRefExoticComponent<Pick<Omit<BoxPro
     /**
      * Handler to be called on click. The second argument can be used to track analytics data. See the tutorial in the analytics-next package for details.
      */
-    onClick?: ((e: React.MouseEvent<HTMLButtonElement>, analyticsEvent?: UIAnalyticsEvent) => void) | undefined;
+    onClick?: ((e: React.MouseEvent<HTMLButtonElement>, analyticsEvent: UIAnalyticsEvent) => void) | undefined;
     /**
      * An optional name used to identify the interaction type to press listeners. For example, interaction tracing. For more information,
      * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).

package/dist/types-ts4.5/components/text.d.ts

@@ -41,10 +41,10 @@ type TextPropsBase = {
     children: ReactNode;
     /**
      * Token representing text color with a built-in fallback value.
-     * Will apply inverse text color automatically if placed within a Box with backgroundColor.
-     *
+     * Will apply inverse text color automatically if placed within a Box with bold background color.
+     * Defaults to `text.color` if not nested in other Text components.
      */
-    color?: TextColor;
+    color?: TextColor | 'inherit';
     /**
      * The [HTML `id` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id).
      */

package/dist/types-ts4.5/index.d.ts

@@ -15,7 +15,9 @@ export { default as Bleed } from './components/bleed';
 export type { BleedProps } from './components/bleed';
 export { default as Text } from './components/text';
 export type { TextProps } from './components/text';
-export { default as UNSAFE_Pressable } from './components/pressable';
+export { default as UNSAFE_PRESSABLE } from './components/pressable';
 export type { PressableProps as UNSAFE_PressableProps } from './components/pressable';
+export { default as UNSAFE_ANCHOR } from './components/anchor';
+export type { AnchorProps as UNSAFE_AnchorProps } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';
 export type { Breakpoint, MediaQuery } from './responsive';