@atlaskit/primitives 2.0.3 → 3.0.0

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

@@ -1,7 +1,10 @@
 import _extends from "@babel/runtime/helpers/extends";
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useCallback, useContext } from 'react';
 import invariant from 'tiny-invariant';
+import { usePlatformLeafEventHandler } from '@atlaskit/analytics-next';
 import { useRouterLink } from '@atlaskit/app-provider';
+import noop from '@atlaskit/ds-lib/noop';
+import InteractionContext from '@atlaskit/interaction-context';
 import { xcss } from '../xcss/xcss';
 import Box from './box';
 // TODO: Duplicated FocusRing styles due to lack of `xcss` support
@@ -12,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)': {
@@ -25,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,
@@ -40,12 +46,30 @@ const Link = ({
   xcss: xcssStyles,
   target,
   rel,
+  onClick: providedOnClick = noop,
+  interactionName,
+  componentName,
+  analyticsContext,
   ...htmlAttributes
 }, ref) => {
+  const interactionContext = useContext(InteractionContext);
+  const handleClick = useCallback((e, analyticsEvent) => {
+    interactionContext && interactionContext.tracePress(interactionName, e.timeStamp);
+    providedOnClick(e, analyticsEvent);
+  }, [providedOnClick, interactionContext, interactionName]);
+  const onClick = usePlatformLeafEventHandler({
+    fn: handleClick,
+    action: 'clicked',
+    componentName: componentName || 'Anchor',
+    packageName: "@atlaskit/primitives",
+    packageVersion: "3.0.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);
 
@@ -58,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, {
@@ -77,7 +101,8 @@ const Link = ({
     paddingBlockEnd: paddingBlockEnd,
     paddingInline: paddingInline,
     paddingInlineStart: paddingInlineStart,
-    paddingInlineEnd: paddingInlineEnd
+    paddingInlineEnd: paddingInlineEnd,
+    onClick: onClick
     // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
     ,
     xcss: styles
@@ -86,16 +111,17 @@ const Link = ({
 
 // Workarounds to support generic types with forwardRef
 /**
- * __UNSAFE_LINK__
+ * __UNSAFE_ANCHOR__
  *
  * @internal Still under development. Do not use.
  *
- * A Link is a primitive component that renders an `<a>` anchor. It utilizes
- * the configured router link component in the AppProvider if set.
+ * 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

@@ -1,5 +1,8 @@
 import _extends from "@babel/runtime/helpers/extends";
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useCallback, useContext } from 'react';
+import { usePlatformLeafEventHandler } from '@atlaskit/analytics-next';
+import noop from '@atlaskit/ds-lib/noop';
+import InteractionContext from '@atlaskit/interaction-context';
 import { xcss } from '../xcss/xcss';
 import Box from './box';
 // TODO: Duplicated FocusRing styles due to lack of `xcss` support
@@ -47,8 +50,27 @@ const UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(({
   type = 'button',
   testId,
   xcss: xcssStyles,
+  onClick: providedOnClick = noop,
+  interactionName,
+  componentName,
+  analyticsContext,
   ...htmlAttributes
 }, ref) => {
+  const interactionContext = useContext(InteractionContext);
+  const handleClick = useCallback((e, analyticsEvent) => {
+    interactionContext && interactionContext.tracePress(interactionName, e.timeStamp);
+    providedOnClick(e, analyticsEvent);
+  }, [providedOnClick, interactionContext, interactionName]);
+  const onClick = usePlatformLeafEventHandler({
+    fn: handleClick,
+    action: 'clicked',
+    componentName: componentName || 'Pressable',
+    packageName: "@atlaskit/primitives",
+    packageVersion: "3.0.0",
+    analyticsData: analyticsContext,
+    actionSubject: 'button'
+  });
+
   // Combine default styles with supplied styles. XCSS does not support deep nested arrays
   let styles = [xcss({
     cursor: isDisabled ? 'not-allowed' : 'pointer'
@@ -59,6 +81,7 @@ const UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(({
     ref: ref,
     testId: testId,
     type: type,
+    onClick: onClick,
     backgroundColor: backgroundColor,
     padding: padding,
     paddingBlock: paddingBlock,

package/dist/es2019/components/text.js

@@ -1,5 +1,5 @@
 /** @jsx jsx */
-import { createContext, Fragment, 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';
@@ -48,17 +48,14 @@ const wordBreakMap = {
  */
 const useColor = colorProp => {
   const surface = useSurface();
-  const inverseTextColor = inverseColorMap[surface];
 
   /**
    * Where the color of the surface is inverted we override the user choice
    * as there is no valid choice that is not covered by the override.
    */
-  const color = inverseTextColor !== null && inverseTextColor !== void 0 ? inverseTextColor : colorProp;
+  const color = inverseColorMap.hasOwnProperty(surface) ? inverseColorMap[surface] : colorProp;
   return color;
 };
-const HasTextAncestorContext = /*#__PURE__*/createContext(false);
-const useHasTextAncestor = () => useContext(HasTextAncestorContext);
 
 /**
  * __Text__
@@ -75,7 +72,7 @@ const Text = ({
 }) => {
   const {
     as: asElement,
-    color: colorProp = 'color.text',
+    color: colorProp,
     textAlign,
     testId,
     id,
@@ -94,16 +91,7 @@ const Text = ({
     maxLines = props.maxLines;
   }
   const color = useColor(colorProp);
-  const isWrapped = useHasTextAncestor();
-
-  /**
-   * If the text is already wrapped and applies no props we can just
-   * render the children directly as a fragment.
-   */
-  if (isWrapped && Object.keys(props).length === 0) {
-    return jsx(Fragment, null, children);
-  }
-  const component = jsx(Component, {
+  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],
     style: {
       WebkitLineClamp: maxLines
@@ -111,10 +99,5 @@ const Text = ({
     "data-testid": testId,
     id: id
   }, children);
-  return isWrapped ?
-  // 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,4 +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_ANCHOR } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';

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

@@ -2,10 +2,13 @@ import _extends from "@babel/runtime/helpers/extends";
 import _typeof from "@babel/runtime/helpers/typeof";
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["href", "children", "backgroundColor", "padding", "paddingBlock", "paddingBlockStart", "paddingBlockEnd", "paddingInline", "paddingInlineStart", "paddingInlineEnd", "testId", "xcss", "target", "rel"];
-import React, { forwardRef } from 'react';
+var _excluded = ["href", "children", "backgroundColor", "padding", "paddingBlock", "paddingBlockStart", "paddingBlockEnd", "paddingInline", "paddingInlineStart", "paddingInlineEnd", "testId", "xcss", "target", "rel", "onClick", "interactionName", "componentName", "analyticsContext"];
+import React, { forwardRef, useCallback, useContext } from 'react';
 import invariant from 'tiny-invariant';
+import { usePlatformLeafEventHandler } from '@atlaskit/analytics-next';
 import { useRouterLink } from '@atlaskit/app-provider';
+import noop from '@atlaskit/ds-lib/noop';
+import InteractionContext from '@atlaskit/interaction-context';
 import { xcss } from '../xcss/xcss';
 import Box from './box';
 // TODO: Duplicated FocusRing styles due to lack of `xcss` support
@@ -16,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)': {
@@ -29,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,
@@ -44,11 +50,30 @@ var Link = function Link(_ref, ref) {
     xcssStyles = _ref.xcss,
     target = _ref.target,
     rel = _ref.rel,
+    _ref$onClick = _ref.onClick,
+    providedOnClick = _ref$onClick === void 0 ? noop : _ref$onClick,
+    interactionName = _ref.interactionName,
+    componentName = _ref.componentName,
+    analyticsContext = _ref.analyticsContext,
     htmlAttributes = _objectWithoutProperties(_ref, _excluded);
+  var interactionContext = useContext(InteractionContext);
+  var handleClick = useCallback(function (e, analyticsEvent) {
+    interactionContext && interactionContext.tracePress(interactionName, e.timeStamp);
+    providedOnClick(e, analyticsEvent);
+  }, [providedOnClick, interactionContext, interactionName]);
+  var onClick = usePlatformLeafEventHandler({
+    fn: handleClick,
+    action: 'clicked',
+    componentName: componentName || 'Anchor',
+    packageName: "@atlaskit/primitives",
+    packageVersion: "3.0.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);
 
@@ -61,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, {
@@ -80,7 +105,8 @@ var Link = function Link(_ref, ref) {
     paddingBlockEnd: paddingBlockEnd,
     paddingInline: paddingInline,
     paddingInlineStart: paddingInlineStart,
-    paddingInlineEnd: paddingInlineEnd
+    paddingInlineEnd: paddingInlineEnd,
+    onClick: onClick
     // eslint-disable-next-line @atlaskit/design-system/consistent-css-prop-usage
     ,
     xcss: styles
@@ -89,16 +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.
  *
- * A Link is a primitive component that renders an `<a>` anchor. It utilizes
- * the configured router link component in the AppProvider if set.
+ * 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

@@ -1,8 +1,11 @@
 import _extends from "@babel/runtime/helpers/extends";
 import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
-var _excluded = ["children", "backgroundColor", "padding", "paddingBlock", "paddingBlockStart", "paddingBlockEnd", "paddingInline", "paddingInlineStart", "paddingInlineEnd", "isDisabled", "type", "testId", "xcss"];
-import React, { forwardRef } from 'react';
+var _excluded = ["children", "backgroundColor", "padding", "paddingBlock", "paddingBlockStart", "paddingBlockEnd", "paddingInline", "paddingInlineStart", "paddingInlineEnd", "isDisabled", "type", "testId", "xcss", "onClick", "interactionName", "componentName", "analyticsContext"];
+import React, { forwardRef, useCallback, useContext } from 'react';
+import { usePlatformLeafEventHandler } from '@atlaskit/analytics-next';
+import noop from '@atlaskit/ds-lib/noop';
+import InteractionContext from '@atlaskit/interaction-context';
 import { xcss } from '../xcss/xcss';
 import Box from './box';
 // TODO: Duplicated FocusRing styles due to lack of `xcss` support
@@ -51,7 +54,27 @@ var UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(function (_ref, ref) {
     type = _ref$type === void 0 ? 'button' : _ref$type,
     testId = _ref.testId,
     xcssStyles = _ref.xcss,
+    _ref$onClick = _ref.onClick,
+    providedOnClick = _ref$onClick === void 0 ? noop : _ref$onClick,
+    interactionName = _ref.interactionName,
+    componentName = _ref.componentName,
+    analyticsContext = _ref.analyticsContext,
     htmlAttributes = _objectWithoutProperties(_ref, _excluded);
+  var interactionContext = useContext(InteractionContext);
+  var handleClick = useCallback(function (e, analyticsEvent) {
+    interactionContext && interactionContext.tracePress(interactionName, e.timeStamp);
+    providedOnClick(e, analyticsEvent);
+  }, [providedOnClick, interactionContext, interactionName]);
+  var onClick = usePlatformLeafEventHandler({
+    fn: handleClick,
+    action: 'clicked',
+    componentName: componentName || 'Pressable',
+    packageName: "@atlaskit/primitives",
+    packageVersion: "3.0.0",
+    analyticsData: analyticsContext,
+    actionSubject: 'button'
+  });
+
   // Combine default styles with supplied styles. XCSS does not support deep nested arrays
   var styles = [xcss({
     cursor: isDisabled ? 'not-allowed' : 'pointer'
@@ -62,6 +85,7 @@ var UNSAFE_PRESSABLE = /*#__PURE__*/forwardRef(function (_ref, ref) {
     ref: ref,
     testId: testId,
     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, Fragment, 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';
@@ -50,19 +50,14 @@ var wordBreakMap = {
  */
 var useColor = function useColor(colorProp) {
   var surface = useSurface();
-  var inverseTextColor = inverseColorMap[surface];
 
   /**
    * Where the color of the surface is inverted we override the user choice
    * as there is no valid choice that is not covered by the override.
    */
-  var color = inverseTextColor !== null && inverseTextColor !== void 0 ? inverseTextColor : colorProp;
+  var color = inverseColorMap.hasOwnProperty(surface) ? inverseColorMap[surface] : colorProp;
   return color;
 };
-var HasTextAncestorContext = /*#__PURE__*/createContext(false);
-var useHasTextAncestor = function useHasTextAncestor() {
-  return useContext(HasTextAncestorContext);
-};
 
 /**
  * __Text__
@@ -77,8 +72,7 @@ var Text = function Text(_ref) {
   var children = _ref.children,
     props = _objectWithoutProperties(_ref, _excluded);
   var asElement = props.as,
-    _props$color = props.color,
-    colorProp = _props$color === void 0 ? 'color.text' : _props$color,
+    colorProp = props.color,
     textAlign = props.textAlign,
     testId = props.testId,
     id = props.id,
@@ -97,16 +91,7 @@ var Text = function Text(_ref) {
     maxLines = props.maxLines;
   }
   var color = useColor(colorProp);
-  var isWrapped = useHasTextAncestor();
-
-  /**
-   * If the text is already wrapped and applies no props we can just
-   * render the children directly as a fragment.
-   */
-  if (isWrapped && Object.keys(props).length === 0) {
-    return jsx(Fragment, null, children);
-  }
-  var component = jsx(Component, {
+  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],
     style: {
       WebkitLineClamp: maxLines
@@ -114,10 +99,5 @@ var Text = function Text(_ref) {
     "data-testid": testId,
     id: id
   }, children);
-  return isWrapped ?
-  // 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,4 +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_ANCHOR } from './components/anchor';
 export { media, UNSAFE_media, UNSAFE_BREAKPOINTS_CONFIG } from './responsive';

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

@@ -0,0 +1,69 @@
+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 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.
+     */
+    children: ReactNode;
+    /**
+     * 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;
+    /**
+     * 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).
+     */
+    interactionName?: string;
+    /**
+     * An optional component name used to identify this component to press listeners. This can be used if a parent component's name is preferred. For example, interaction tracing. For more information,
+     * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
+     */
+    componentName?: string;
+    /**
+     * Additional information to be included in the `context` of analytics events that come from anchor.
+     */
+    analyticsContext?: Record<string, any>;
+};
+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_ANCHOR__
+ *
+ * @internal Still under development. Do not use.
+ *
+ * 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/anchor/examples)
+ * - [Code](https://atlassian.design/components/primitives/anchor/code)
+ * - [Usage](https://atlassian.design/components/primitives/anchor/usage)
+ */
+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.
+     */
+    children: ReactNode;
+    /**
+     * 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;
+    /**
+     * 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).
+     */
+    interactionName?: string | undefined;
+    /**
+     * An optional component name used to identify this component to press listeners. This can be used if a parent component's name is preferred. For example, interaction tracing. For more information,
+     * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
+     */
+    componentName?: string | undefined;
+    /**
+     * Additional information to be included in the `context` of analytics events that come from anchor.
+     */
+    analyticsContext?: Record<string, any> | undefined;
+} & {
+    ref?: React.Ref<HTMLAnchorElement> | undefined;
+}) => ReturnType<typeof Anchor>;
+export default UNSAFE_ANCHOR;

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

@@ -1,14 +1,32 @@
-import { type ReactElement, type ReactNode } from 'react';
+import React, { type ReactNode } from 'react';
+import { UIAnalyticsEvent } from '@atlaskit/analytics-next';
 import { type BoxProps } from './box';
-export type PressableProps = Omit<BoxProps<'button'>, 'disabled' | 'as' | 'children' | 'role' | 'style'> & {
+export type PressableProps = Omit<BoxProps<'button'>, 'disabled' | 'as' | 'children' | 'role' | 'style' | 'onClick'> & {
     /**
      * `children` should be defined to ensure buttons are not empty,
      * because they should have labels.
      */
     children: ReactNode;
     isDisabled?: boolean;
+    /**
+     * 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;
+    /**
+     * 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).
+     */
+    interactionName?: string;
+    /**
+     * An optional component name used to identify this component to press listeners. This can be used if a parent component's name is preferred. For example, interaction tracing. For more information,
+     * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
+     */
+    componentName?: string;
+    /**
+     * Additional information to be included in the `context` of analytics events that come from pressable.
+     */
+    analyticsContext?: Record<string, any>;
 };
-type PressableComponent = (props: PressableProps, displayName: string) => ReactElement | null;
 /**
  * __UNSAFE_PRESSABLE__
  *
@@ -20,5 +38,30 @@ type PressableComponent = (props: PressableProps, displayName: string) => ReactE
  * - [Code](https://atlassian.design/components/primitives/pressable/code)
  * - [Usage](https://atlassian.design/components/primitives/pressable/usage)
  */
-declare const UNSAFE_PRESSABLE: PressableComponent;
+declare const UNSAFE_PRESSABLE: React.ForwardRefExoticComponent<Pick<Omit<BoxProps<"button">, "style" | "disabled" | "children" | "as" | "role" | "onClick"> & {
+    /**
+     * `children` should be defined to ensure buttons are not empty,
+     * because they should have labels.
+     */
+    children: ReactNode;
+    isDisabled?: boolean | undefined;
+    /**
+     * 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;
+    /**
+     * 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).
+     */
+    interactionName?: string | undefined;
+    /**
+     * An optional component name used to identify this component to press listeners. This can be used if a parent component's name is preferred. For example, interaction tracing. For more information,
+     * see [UFO integration into Design System components](https://go.atlassian.com/react-ufo-dst-integration).
+     */
+    componentName?: string | undefined;
+    /**
+     * Additional information to be included in the `context` of analytics events that come from pressable.
+     */
+    analyticsContext?: Record<string, any> | undefined;
+}, "padding" | "paddingBlock" | "paddingBlockStart" | "paddingBlockEnd" | "paddingInline" | "paddingInlineStart" | "paddingInlineEnd" | "backgroundColor" | "color" | "translate" | "key" | "value" | "hidden" | "children" | "form" | "slot" | "title" | "name" | "type" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "id" | "lang" | "placeholder" | "spellCheck" | "tabIndex" | "radioGroup" | "about" | "datatype" | "inlist" | "prefix" | "property" | "resource" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "autoFocus" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "testId" | "xcss" | "data-testid" | "isDisabled" | "interactionName" | "componentName" | "analyticsContext"> & React.RefAttributes<HTMLButtonElement>>;
 export default UNSAFE_PRESSABLE;

package/dist/types/index.d.ts

@@ -15,5 +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 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';