@atlaskit/smart-card 44.23.2 → 44.23.4

package/dist/esm/state/hooks-external/useSmartLinkActions.js

@@ -6,6 +6,7 @@ import { useMemo } from 'react';
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import uuid from 'uuid';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { useAnalyticsEvents } from '../../common/analytics/generated/use-analytics-events';
 import { extractInvokeDownloadAction } from '../../extractors/action/extract-invoke-download-action';
@@ -15,6 +16,7 @@ import { messages } from '../../messages';
 import { toAction } from '../../utils/actions/to-action';
 import useInvokeClientAction from '../hooks/use-invoke-client-action';
 import useResolve from '../hooks/use-resolve';
+import { useSmartLinkCrossProductUrlWrapperGated } from '../hooks/use-smart-link-cross-product-url-wrapper';
 import { useSmartCardState as useLinkState } from '../store';
 export function useSmartLinkActions(_ref) {
   var url = _ref.url,
@@ -36,6 +38,9 @@ export function useSmartLinkActions(_ref) {
     fireEvent: fireEvent
   });
   var resolve = useResolve();
+  var appendCrossProductAnalyticsParams = useSmartLinkCrossProductUrlWrapperGated({
+    details: linkState.details
+  });
   if (expValEquals('platform_hover_card_preview_panel', 'cohort', 'test') && prefetch && !linkState.details) {
     resolve(url);
   }
@@ -51,7 +56,12 @@ export function useSmartLinkActions(_ref) {
     if (downloadActionProps) {
       actions.push(toAction(downloadActionProps, invokeClientAction, messages.download, 'download-content'));
     }
-    var viewActionProps = extractInvokeViewAction(invokeParam);
+    var viewActionProps = fg('platform_smartlink_xpc_url_wrapping') ? extractInvokeViewAction(_objectSpread(_objectSpread({}, invokeParam), {}, {
+      transformUrl: function transformUrl() {
+        var destinationUrl = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : url;
+        return appendCrossProductAnalyticsParams(destinationUrl);
+      }
+    })) : extractInvokeViewAction(invokeParam);
     if (viewActionProps) {
       actions.push(toAction(viewActionProps, invokeClientAction, messages.view, 'view-content'));
     }
@@ -60,7 +70,12 @@ export function useSmartLinkActions(_ref) {
       origin: origin,
       isPreviewPanelAvailable: isPreviewPanelAvailable,
       openPreviewPanel: openPreviewPanel
-    }));
+    }, fg('platform_smartlink_xpc_url_wrapping') ? {
+      transformUrl: function transformUrl() {
+        var destinationUrl = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : url;
+        return appendCrossProductAnalyticsParams(destinationUrl);
+      }
+    } : undefined));
     if (previewActionProps) {
       actions.push(toAction(previewActionProps.invokeAction, invokeClientAction, messages.preview_improved, 'preview-content'));
     }

package/dist/esm/utils/analytics/analytics.js

@@ -4,7 +4,7 @@ export var ANALYTICS_CHANNEL = 'media';
 export var context = {
   componentName: 'smart-cards',
   packageName: "@atlaskit/smart-card" || '',
-  packageVersion: "44.23.1" || ''
+  packageVersion: "44.23.3" || ''
 };
 export var TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/esm/utils/click-helpers.js

@@ -5,4 +5,33 @@
  */
 export var isAuxClick = function isAuxClick(e) {
   return e.button === 1;
+};
+
+/**
+ * Extracts `href` and `target` from the anchor element that is the event's `currentTarget`.
+ *
+ * Smart Link click handlers are attached to multiple card renderers (InlineCard, BlockCard,
+ * EmbedCard, FlexibleCard). When the handler needs to manually open a link — for example,
+ * when native anchor navigation has been prevented — it uses this helper to read the
+ * anchor's resolved URL and intended target from the event rather than re-deriving them.
+ *
+ * Returns `{ href: undefined, target: '_self' }` when `currentTarget` is not an anchor
+ * element (e.g. a button or wrapper div), so callers can safely fall back to a default target.
+ *
+ * @param event - A React mouse or keyboard event whose `currentTarget` may be an anchor.
+ * @returns The resolved absolute `href` and `target` attribute of the anchor, or safe
+ *   defaults if `currentTarget` is not an anchor.
+ */
+export var getAnchorAttributesFromEvent = function getAnchorAttributesFromEvent(event) {
+  var currentTarget = event.currentTarget;
+  if (!(currentTarget instanceof HTMLAnchorElement)) {
+    return {
+      href: undefined,
+      target: '_self'
+    };
+  }
+  return {
+    href: currentTarget.href,
+    target: currentTarget.target || '_self'
+  };
 };

package/dist/esm/view/CardWithUrl/component.js

@@ -19,7 +19,7 @@ import { isSpecialClick, isSpecialEvent, isSpecialKey } from '../../utils';
 import { combineActionOptions } from '../../utils/actions/combine-action-options';
 import { fireLinkClickedEvent } from '../../utils/analytics/click';
 import { SmartLinkAnalyticsContext } from '../../utils/analytics/SmartLinkAnalyticsContext';
-import { isAuxClick } from '../../utils/click-helpers';
+import { getAnchorAttributesFromEvent, isAuxClick } from '../../utils/click-helpers';
 import { isFlexibleUiCard } from '../../utils/flexible';
 import * as measure from '../../utils/performance';
 import { BlockCard } from '../BlockCard';
@@ -84,7 +84,7 @@ function Component(_ref) {
   var services = getServices(state.details);
   var thirdPartyARI = getThirdPartyARI(state.details);
   var firstPartyIdentifier = getFirstPartyIdentifier();
-  var wrapUrlWithCrossProductAnalytics = useSmartLinkCrossProductUrlWrapperGated({
+  var appendCrossProductAnalyticsParams = useSmartLinkCrossProductUrlWrapperGated({
     details: state.details
   });
   var actionOptions = combineActionOptions({
@@ -118,56 +118,120 @@ function Component(_ref) {
     var isDisablePreviewPanel = disablePreviewPanel && editorExperiment('platform_editor_preview_panel_linking_exp', true, {
       exposure: true
     });
+    if (fg('platform_smartlink_xpc_url_wrapping')) {
+      var _appendCrossProductAn;
+      // FIXME: InlineCard, BlockCard and EmbedCard call event.preventDefault() internally
+      // before the event bubbles up to this handler. This forces us to snapshot
+      // event.defaultPrevented before calling onClick to detect whether the consumer
+      // specifically prevented navigation. Ideally those components should not call
+      // preventDefault so this workaround can be removed.
+      var isEventDefaultPrevented = event.defaultPrevented;
+      var canOpenPreviewPanel = !isModifierKeyPressed && ari && name && openPreviewPanel && (isPreviewPanelAvailable === null || isPreviewPanelAvailable === void 0 ? void 0 : isPreviewPanelAvailable({
+        ari: ari
+      })) && !isDisablePreviewPanel;
 
-    // If preview panel is available and the user clicked on the link,
-    // delegate the click to the preview panel handler
-    if (!isModifierKeyPressed && ari && name && openPreviewPanel && isPreviewPanelAvailable !== null && isPreviewPanelAvailable !== void 0 && isPreviewPanelAvailable({
-      ari: ari
-    }) && !isDisablePreviewPanel) {
-      var _extractSmartLinkEmbe;
-      event.preventDefault();
-      event.stopPropagation();
-      openPreviewPanel({
-        url: url,
-        ari: ari,
-        name: name,
-        iconUrl: getObjectIconUrl(state.details),
-        panelData: {
-          embedUrl: expValEquals('platform_hover_card_preview_panel', 'cohort', 'test') ? (_extractSmartLinkEmbe = extractSmartLinkEmbed(state.details)) === null || _extractSmartLinkEmbe === void 0 ? void 0 : _extractSmartLinkEmbe.src : undefined
-        }
-      });
-      fireLinkClickedEvent(createAnalyticsEvent)(event, {
-        attributes: {
-          clickOutcome: 'previewPanel'
-        }
-      });
-      return;
-    } else if (!onClick && !isFlexibleUi) {
-      var clickUrl = getClickUrl(url, state.details);
+      // Preview panel takes priority over link navigation when available.
+      if (canOpenPreviewPanel) {
+        var _extractSmartLinkEmbe;
+        event.preventDefault();
+        event.stopPropagation();
+        openPreviewPanel({
+          url: url,
+          ari: ari,
+          name: name,
+          iconUrl: getObjectIconUrl(state.details),
+          panelData: {
+            embedUrl: expValEquals('platform_hover_card_preview_panel', 'cohort', 'test') ? (_extractSmartLinkEmbe = extractSmartLinkEmbed(state.details)) === null || _extractSmartLinkEmbe === void 0 ? void 0 : _extractSmartLinkEmbe.src : undefined
+          }
+        });
+        fireLinkClickedEvent(createAnalyticsEvent)(event, {
+          attributes: {
+            clickOutcome: 'previewPanel'
+          }
+        });
+        return;
+      }
 
-      // Ctrl+left click on mac typically doesn't trigger onClick
-      // The event could have potentially had `e.preventDefault()` called on it by now
-      // event by smart card internally
-      // If it has been called then only then can `isSpecialEvent` be true.
-      var target = isSpecialEvent(event) ? '_blank' : '_self';
-      if (fg('platform_smartlink_xpc_url_wrapping')) {
-        var wrappedUrl = wrapUrlWithCrossProductAnalytics(clickUrl);
-        window.open(wrappedUrl, target);
-      } else {
-        window.open(clickUrl, target);
+      // For FlexibleCard, read target from the clicked anchor element (e.g. _blank for links
+      // rendered with explicit target). For classic cards, default to _self
+      var _getAnchorAttributesF = getAnchorAttributesFromEvent(event),
+        anchorTarget = _getAnchorAttributesF.target;
+      var target = isSpecialEvent(event) ? '_blank' : isFlexibleUi ? anchorTarget : '_self';
+
+      // FIXME: preferredUrl should be rendered in the DOM anchor href instead of derived at click time
+      var preferredUrl = getClickUrl(url, state.details);
+      var destinationUrl = (_appendCrossProductAn = appendCrossProductAnalyticsParams(preferredUrl)) !== null && _appendCrossProductAn !== void 0 ? _appendCrossProductAn : preferredUrl;
+
+      // FIXME: Consumer that handle click even themselves via callback won't have the decorated URL
+      onClick === null || onClick === void 0 || onClick(event);
+
+      // Check if the event is prevented via onClick callback
+      var consumerPreventedNavigation = event.defaultPrevented && !isEventDefaultPrevented;
+
+      // Classic cards (InlineCard, BlockCard, EmbedCard) rely on their own anchor navigation
+      // when onClick is provided, so this handler should not open the link for them.
+      // FlexibleCard's anchor is prevented from native navigation, so this handler always
+      // opens the link for FlexibleCard unless the consumer's onClick called preventDefault.
+      var shouldOpenLink = isFlexibleUi || !onClick;
+      var doOpenLink = shouldOpenLink && !consumerPreventedNavigation;
+      if (doOpenLink) {
+        event.preventDefault();
+        window.open(destinationUrl, target);
       }
-      fireLinkClickedEvent(createAnalyticsEvent)(event, {
+
+      // Only set clickOutcome when this handler actually opened the link.
+      // If a parent onClick handled navigation, fire a generic click event instead.
+      fireLinkClickedEvent(createAnalyticsEvent)(event, doOpenLink ? {
         attributes: {
           clickOutcome: target === '_blank' ? 'clickThroughNewTabOrWindow' : 'clickThrough'
         }
-      });
+      } : undefined);
     } else {
-      if (onClick) {
-        onClick(event);
+      // If preview panel is available and the user clicked on the link,
+      // delegate the click to the preview panel handler
+      if (!isModifierKeyPressed && ari && name && openPreviewPanel && isPreviewPanelAvailable !== null && isPreviewPanelAvailable !== void 0 && isPreviewPanelAvailable({
+        ari: ari
+      }) && !isDisablePreviewPanel) {
+        var _extractSmartLinkEmbe2;
+        event.preventDefault();
+        event.stopPropagation();
+        openPreviewPanel({
+          url: url,
+          ari: ari,
+          name: name,
+          iconUrl: getObjectIconUrl(state.details),
+          panelData: {
+            embedUrl: expValEquals('platform_hover_card_preview_panel', 'cohort', 'test') ? (_extractSmartLinkEmbe2 = extractSmartLinkEmbed(state.details)) === null || _extractSmartLinkEmbe2 === void 0 ? void 0 : _extractSmartLinkEmbe2.src : undefined
+          }
+        });
+        fireLinkClickedEvent(createAnalyticsEvent)(event, {
+          attributes: {
+            clickOutcome: 'previewPanel'
+          }
+        });
+        return;
+      } else if (!onClick && !isFlexibleUi) {
+        var clickUrl = getClickUrl(url, state.details);
+
+        // Ctrl+left click on mac typically doesn't trigger onClick
+        // The event could have potentially had `e.preventDefault()` called on it by now
+        // event by smart card internally
+        // If it has been called then only then can `isSpecialEvent` be true.
+        var _target = isSpecialEvent(event) ? '_blank' : '_self';
+        window.open(clickUrl, _target);
+        fireLinkClickedEvent(createAnalyticsEvent)(event, {
+          attributes: {
+            clickOutcome: _target === '_blank' ? 'clickThroughNewTabOrWindow' : 'clickThrough'
+          }
+        });
+      } else {
+        if (onClick) {
+          onClick(event);
+        }
+        fireLinkClickedEvent(createAnalyticsEvent)(event);
       }
-      fireLinkClickedEvent(createAnalyticsEvent)(event);
     }
-  }, [fireEvent, id, isFlexibleUi, appearance, definitionId, onClick, url, wrapUrlWithCrossProductAnalytics, state.details, ari, name, fire3PClickEvent, shouldFire3PClickEvent, isPreviewPanelAvailable, openPreviewPanel, createAnalyticsEvent, disablePreviewPanel]);
+  }, [fireEvent, id, isFlexibleUi, appearance, definitionId, onClick, url, appendCrossProductAnalyticsParams, state.details, ari, name, fire3PClickEvent, shouldFire3PClickEvent, isPreviewPanelAvailable, openPreviewPanel, createAnalyticsEvent, disablePreviewPanel]);
 
   // Exposure fires once per eligible mount; click-time reads use no-exposure variant.
   useEffect(function () {

package/dist/esm/view/FlexibleCard/index.js

@@ -2,7 +2,7 @@ import _extends from "@babel/runtime/helpers/extends";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 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; }
-import React, { useEffect, useMemo } from 'react';
+import React, { useCallback, useEffect, useMemo } from 'react';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
 import { fg } from '@atlaskit/platform-feature-flags';
 import UFOHoldLoad from '@atlaskit/react-ufo/load-hold';
@@ -13,6 +13,7 @@ import { FlexibleCardContext } from '../../state/flexible-ui-context';
 import { useAISummaryConfig } from '../../state/hooks/use-ai-summary-config';
 import useResolve from '../../state/hooks/use-resolve';
 import useRovoConfig from '../../state/hooks/use-rovo-config';
+import { useSmartLinkCrossProductUrlWrapperGated } from '../../state/hooks/use-smart-link-cross-product-url-wrapper';
 import Container from './components/container';
 import { getContextByStatus } from './utils';
 var PENDING_LINK_STATUSES = [SmartLinkStatus.Pending, SmartLinkStatus.Resolving];
@@ -59,6 +60,14 @@ var FlexibleCard = function FlexibleCard(_ref) {
   var cardType = cardState.status,
     details = cardState.details;
   var status = cardType;
+  var appendCrossProductAnalyticsParams = useSmartLinkCrossProductUrlWrapperGated({
+    details: details
+  });
+  var transformUrlCallback = useCallback(function () {
+    var destinationUrl = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : url;
+    return appendCrossProductAnalyticsParams(destinationUrl);
+  }, [appendCrossProductAnalyticsParams, url]);
+  var transformUrl = fg('platform_smartlink_xpc_url_wrapping') ? transformUrlCallback : undefined;
 
   // if we have placeholder state it means we can internally use it
   // as temporary resolved data until the actual data comes back as one of the final statuses
@@ -88,9 +97,10 @@ var FlexibleCard = function FlexibleCard(_ref) {
       status: placeholderCardState ? placeHolderStatus : status,
       url: url,
       isPreviewPanelAvailable: isPreviewPanelAvailable,
-      openPreviewPanel: openPreviewPanel
+      openPreviewPanel: openPreviewPanel,
+      transformUrl: transformUrl
     }));
-  }, [aiSummaryConfig, appearance, actionOptions, details, id, isPreviewPanelAvailable, onAuthorize, onClick, onAuxClick, onContextMenu, openPreviewPanel, origin, placeholderCardState, placeHolderStatus, product, renderers, resolve, rovoConfig, status, url, fireEvent]);
+  }, [aiSummaryConfig, appearance, actionOptions, details, id, isPreviewPanelAvailable, onAuthorize, onClick, onAuxClick, onContextMenu, openPreviewPanel, origin, placeholderCardState, placeHolderStatus, product, renderers, resolve, rovoConfig, status, transformUrl, url, fireEvent]);
   var flexibleCardContext = useMemo(function () {
     return {
       data: context,

package/dist/esm/view/HoverCard/components/HoverCardContent.js

@@ -14,10 +14,12 @@ import { CardDisplay, SmartLinkPosition, SmartLinkSize } from '../../../constant
 import extractRovoChatAction from '../../../extractors/flexible/actions/extract-rovo-chat-action';
 import { getDefinitionId, getExtensionKey, getServices } from '../../../state/helpers';
 import useRovoConfig from '../../../state/hooks/use-rovo-config';
+import { useSmartLinkCrossProductUrlWrapperGated } from '../../../state/hooks/use-smart-link-cross-product-url-wrapper';
 import { useSmartCardState } from '../../../state/store';
 import { isSpecialEvent } from '../../../utils';
 import { getIsAISummaryEnabled } from '../../../utils/ai-summary';
 import { fireLinkClickedEvent } from '../../../utils/analytics/click';
+import { getAnchorAttributesFromEvent } from '../../../utils/click-helpers';
 import { flexibleUiOptions } from '../styled';
 import { getMetadata } from '../utils';
 import ContentContainer from './ContentContainer';
@@ -86,6 +88,9 @@ var HoverCardContent = function HoverCardContent(_ref4) {
     product = _useSmartLinkContext.product;
   var isAISummaryEnabled = getIsAISummaryEnabled(isAdminHubAIEnabled, cardState.details);
   var services = getServices(linkState.details);
+  var appendCrossProductAnalyticsParams = useSmartLinkCrossProductUrlWrapperGated({
+    details: linkState.details
+  });
   var statusRef = useRef(linkStatus);
   var fireEventRef = useRef(fireEvent);
   var definitionIdRef = useRef(definitionId);
@@ -127,6 +132,24 @@ var HoverCardContent = function HoverCardContent(_ref4) {
     };
   }, []);
   var onClick = useCallback(function (event) {
+    if (fg('platform_smartlink_xpc_url_wrapping')) {
+      // Prevent the anchor's native navigation so we can open the destination URL
+      // with cross-product analytics query parameters appended.
+      // The href is read from the anchor element at click time rather than at render
+      // time because the URL for the anchor may be different from original URL.
+      // The component may use the URL from the resolved response which can be a redirect URL
+      // or other preferred URL based on link extractor.
+      // The cross-product params are client-only and cannot be rendered
+      // server-side. Falls back to the original `url` prop if the event target is
+      // not an anchor element.
+      event.preventDefault();
+      var _getAnchorAttributesF = getAnchorAttributesFromEvent(event),
+        _getAnchorAttributesF2 = _getAnchorAttributesF.href,
+        href = _getAnchorAttributesF2 === void 0 ? url : _getAnchorAttributesF2,
+        target = _getAnchorAttributesF.target;
+      var destinationUrl = appendCrossProductAnalyticsParams(href);
+      window.open(destinationUrl, target);
+    }
     var isModifierKeyPressed = isSpecialEvent(event);
     fireEvent('ui.smartLink.clicked.titleGoToLink', {
       id: id,
@@ -135,7 +158,7 @@ var HoverCardContent = function HoverCardContent(_ref4) {
       definitionId: definitionId !== null && definitionId !== void 0 ? definitionId : null
     });
     fireLinkClickedEvent(createAnalyticsEvent)(event);
-  }, [createAnalyticsEvent, id, fireEvent, definitionId]);
+  }, [createAnalyticsEvent, appendCrossProductAnalyticsParams, id, fireEvent, definitionId, url]);
   var data = (_cardState$details = cardState.details) === null || _cardState$details === void 0 ? void 0 : _cardState$details.data;
   var _getMetadata = getMetadata(extensionKey, data),
     subtitle = _getMetadata.subtitle;

package/dist/esm/view/LinkUrl/index.js

@@ -12,7 +12,7 @@ import LinkWarningModal from './LinkWarningModal';
 import { useLinkWarningModal } from './LinkWarningModal/hooks/use-link-warning-modal';
 var PACKAGE_DATA = {
   packageName: "@atlaskit/smart-card",
-  packageVersion: "44.23.1",
+  packageVersion: "44.23.3",
   componentName: 'linkUrl'
 };
 var LinkUrl = function LinkUrl(_ref) {

package/dist/types/extractors/action/extract-invoke-preview-action.d.ts

@@ -2,7 +2,7 @@ import { type FireEventFunction } from '../../common/analytics/types';
 import { type InvokeClientActionProps } from '../../state/hooks/use-invoke-client-action/types';
 import { type AnalyticsOrigin } from '../../utils/types';
 import { type EmbedModalProps } from '../../view/EmbedModal/types';
-import { type ExtractClientActionsParam } from './types';
+import { type ExtractClientActionsParam, type TransformUrlFn } from './types';
 export type ExtractInvokePreviewActionParam = ExtractClientActionsParam & {
     fireEvent?: FireEventFunction;
     isPreviewPanelAvailable?: (params: {
@@ -19,6 +19,7 @@ export type ExtractInvokePreviewActionParam = ExtractClientActionsParam & {
         url: string;
     }) => void;
     origin?: AnalyticsOrigin;
+    transformUrl?: TransformUrlFn;
 };
 type ExtractInvokePreviewActionReturn = {
     hasPreviewPanel?: boolean;

package/dist/types/extractors/action/extract-invoke-view-action.d.ts

@@ -1,3 +1,6 @@
 import { type InvokeClientActionProps } from '../../state/hooks/use-invoke-client-action/types';
-import { type ExtractClientActionsParam } from './types';
-export declare const extractInvokeViewAction: ({ actionOptions, appearance, id, response }: ExtractClientActionsParam, force?: boolean) => InvokeClientActionProps | undefined;
+import { type ExtractClientActionsParam, type TransformUrlFn } from './types';
+export type ExtractInvokeViewActionParam = ExtractClientActionsParam & {
+    transformUrl?: TransformUrlFn;
+};
+export declare const extractInvokeViewAction: ({ actionOptions, appearance, transformUrl, id, response }: ExtractInvokeViewActionParam, force?: boolean) => InvokeClientActionProps | undefined;

package/dist/types/extractors/action/types.d.ts

@@ -1,6 +1,7 @@
 import type { JsonLd } from '@atlaskit/json-ld-types';
 import type { InternalCardActionOptions as CardActionOptions } from '../../view/Card/types';
 import type { FlexibleCardProps } from '../../view/FlexibleCard/types';
+export type TransformUrlFn = (url?: string) => string | undefined;
 export type ExtractClientActionsParam = {
     actionOptions?: CardActionOptions;
     appearance?: FlexibleCardProps['appearance'];

package/dist/types/extractors/flexible/actions/index.d.ts

@@ -6,6 +6,7 @@ import { type AISummaryConfig } from '../../../state/hooks/use-ai-summary-config
 import type { RovoConfig } from '../../../state/hooks/use-rovo-config';
 import { type AnalyticsOrigin } from '../../../utils/types';
 import { type InternalCardActionOptions as CardActionOptions, type CardInnerAppearance } from '../../../view/Card/types';
+import { type TransformUrlFn } from '../../action/types';
 export type ExtractActionsParam = {
     actionOptions?: CardActionOptions;
     aiSummaryConfig?: AISummaryConfig;
@@ -28,6 +29,7 @@ export type ExtractActionsParam = {
     product?: ProductType;
     response: JsonLd.Response;
     rovoConfig?: RovoConfig;
+    transformUrl?: TransformUrlFn;
     url?: string;
 };
-export declare const extractFlexibleCardActions: ({ actionOptions, aiSummaryConfig, appearance, fireEvent, id, origin, product, response, rovoConfig, url, isPreviewPanelAvailable, openPreviewPanel, }: ExtractActionsParam) => FlexibleUiActions | undefined;
+export declare const extractFlexibleCardActions: ({ actionOptions, aiSummaryConfig, appearance, fireEvent, id, origin, product, response, rovoConfig, transformUrl, url, isPreviewPanelAvailable, openPreviewPanel, }: ExtractActionsParam) => FlexibleUiActions | undefined;

package/dist/types/extractors/flexible/extract-state.d.ts

@@ -3,6 +3,7 @@ import { type FireEventFunction } from '../../common/analytics/types';
 import { type ResolveFunction } from '../../state/hooks/use-resolve';
 import { type AnalyticsOrigin } from '../../utils/types';
 import { type InternalCardActionOptions as CardActionOptions, type CardInnerAppearance } from '../../view/Card/types';
+import { type TransformUrlFn } from '../action/types';
 import { type LinkLozenge } from '../common/lozenge/types';
 declare const extractState: (response?: JsonLd.Response, actionOptions?: CardActionOptions, id?: string, appearance?: CardInnerAppearance, origin?: AnalyticsOrigin, fireEvent?: FireEventFunction, resolve?: ResolveFunction, isPreviewPanelAvailable?: (params: {
     ari: string;
@@ -14,5 +15,5 @@ declare const extractState: (response?: JsonLd.Response, actionOptions?: CardAct
         embedUrl?: string;
     };
     url: string;
-}) => void) => LinkLozenge | undefined;
+}) => void, transformUrl?: TransformUrlFn) => LinkLozenge | undefined;
 export default extractState;

package/dist/types/extractors/flexible/index.d.ts

@@ -1,4 +1,4 @@
 import { type FlexibleUiDataContext } from '../../state/flexible-ui-context/types';
 import { type ExtractFlexibleUiDataContextParams } from '../../view/FlexibleCard/types';
-declare const extractFlexibleUiContext: ({ appearance, fireEvent, id, onClick, onAuxClick, onContextMenu, origin, product, resolve, rovoConfig, actionOptions, response, status, aiSummaryConfig, isPreviewPanelAvailable, openPreviewPanel, ...props }?: Partial<ExtractFlexibleUiDataContextParams>) => FlexibleUiDataContext | undefined;
+declare const extractFlexibleUiContext: ({ appearance, fireEvent, id, onClick, onAuxClick, onContextMenu, origin, product, resolve, rovoConfig, actionOptions, response, status, aiSummaryConfig, isPreviewPanelAvailable, openPreviewPanel, transformUrl, ...props }?: Partial<ExtractFlexibleUiDataContextParams>) => FlexibleUiDataContext | undefined;
 export default extractFlexibleUiContext;

package/dist/types/utils/click-helpers.d.ts

@@ -1,3 +1,4 @@
+import { type KeyboardEvent, type MouseEvent } from 'react';
 /**
  * Returns true for genuine middle-clicks (button === 1).
  * Filters out Windows right-clicks, which fire onAuxClick with button === 2
@@ -6,3 +7,22 @@
 export declare const isAuxClick: (e: {
     button: number;
 }) => boolean;
+/**
+ * Extracts `href` and `target` from the anchor element that is the event's `currentTarget`.
+ *
+ * Smart Link click handlers are attached to multiple card renderers (InlineCard, BlockCard,
+ * EmbedCard, FlexibleCard). When the handler needs to manually open a link — for example,
+ * when native anchor navigation has been prevented — it uses this helper to read the
+ * anchor's resolved URL and intended target from the event rather than re-deriving them.
+ *
+ * Returns `{ href: undefined, target: '_self' }` when `currentTarget` is not an anchor
+ * element (e.g. a button or wrapper div), so callers can safely fall back to a default target.
+ *
+ * @param event - A React mouse or keyboard event whose `currentTarget` may be an anchor.
+ * @returns The resolved absolute `href` and `target` attribute of the anchor, or safe
+ *   defaults if `currentTarget` is not an anchor.
+ */
+export declare const getAnchorAttributesFromEvent: (event: MouseEvent | KeyboardEvent) => {
+    href?: string;
+    target: string;
+};

package/dist/types/view/FlexibleCard/types.d.ts

@@ -4,6 +4,7 @@ import { type CardState, type ProductType } from '@atlaskit/linking-common';
 import { type SmartLinkResponse } from '@atlaskit/linking-types';
 import { type FireEventFunction } from '../../common/analytics/types';
 import { type SmartLinkSize, type SmartLinkStatus, type SmartLinkTheme } from '../../constants';
+import type { TransformUrlFn } from '../../extractors/action/types';
 import { type AISummaryConfig } from '../../state/hooks/use-ai-summary-config/types';
 import { type ResolveFunction } from '../../state/hooks/use-resolve';
 import type { RovoConfig } from '../../state/hooks/use-rovo-config';
@@ -197,6 +198,7 @@ export type ExtractFlexibleUiDataContextParams = Pick<FlexibleCardProps, 'appear
     response?: SmartLinkResponse;
     rovoConfig?: RovoConfig;
     status?: SmartLinkStatus;
+    transformUrl?: TransformUrlFn;
 };
 /**
  * Mark a specific props in the type as optional.

package/dist/types-ts4.5/extractors/action/extract-invoke-preview-action.d.ts

@@ -2,7 +2,7 @@ import { type FireEventFunction } from '../../common/analytics/types';
 import { type InvokeClientActionProps } from '../../state/hooks/use-invoke-client-action/types';
 import { type AnalyticsOrigin } from '../../utils/types';
 import { type EmbedModalProps } from '../../view/EmbedModal/types';
-import { type ExtractClientActionsParam } from './types';
+import { type ExtractClientActionsParam, type TransformUrlFn } from './types';
 export type ExtractInvokePreviewActionParam = ExtractClientActionsParam & {
     fireEvent?: FireEventFunction;
     isPreviewPanelAvailable?: (params: {
@@ -19,6 +19,7 @@ export type ExtractInvokePreviewActionParam = ExtractClientActionsParam & {
         url: string;
     }) => void;
     origin?: AnalyticsOrigin;
+    transformUrl?: TransformUrlFn;
 };
 type ExtractInvokePreviewActionReturn = {
     hasPreviewPanel?: boolean;

package/dist/types-ts4.5/extractors/action/extract-invoke-view-action.d.ts

@@ -1,3 +1,6 @@
 import { type InvokeClientActionProps } from '../../state/hooks/use-invoke-client-action/types';
-import { type ExtractClientActionsParam } from './types';
-export declare const extractInvokeViewAction: ({ actionOptions, appearance, id, response }: ExtractClientActionsParam, force?: boolean) => InvokeClientActionProps | undefined;
+import { type ExtractClientActionsParam, type TransformUrlFn } from './types';
+export type ExtractInvokeViewActionParam = ExtractClientActionsParam & {
+    transformUrl?: TransformUrlFn;
+};
+export declare const extractInvokeViewAction: ({ actionOptions, appearance, transformUrl, id, response }: ExtractInvokeViewActionParam, force?: boolean) => InvokeClientActionProps | undefined;

package/dist/types-ts4.5/extractors/action/types.d.ts

@@ -1,6 +1,7 @@
 import type { JsonLd } from '@atlaskit/json-ld-types';
 import type { InternalCardActionOptions as CardActionOptions } from '../../view/Card/types';
 import type { FlexibleCardProps } from '../../view/FlexibleCard/types';
+export type TransformUrlFn = (url?: string) => string | undefined;
 export type ExtractClientActionsParam = {
     actionOptions?: CardActionOptions;
     appearance?: FlexibleCardProps['appearance'];

package/dist/types-ts4.5/extractors/flexible/actions/index.d.ts

@@ -6,6 +6,7 @@ import { type AISummaryConfig } from '../../../state/hooks/use-ai-summary-config
 import type { RovoConfig } from '../../../state/hooks/use-rovo-config';
 import { type AnalyticsOrigin } from '../../../utils/types';
 import { type InternalCardActionOptions as CardActionOptions, type CardInnerAppearance } from '../../../view/Card/types';
+import { type TransformUrlFn } from '../../action/types';
 export type ExtractActionsParam = {
     actionOptions?: CardActionOptions;
     aiSummaryConfig?: AISummaryConfig;
@@ -28,6 +29,7 @@ export type ExtractActionsParam = {
     product?: ProductType;
     response: JsonLd.Response;
     rovoConfig?: RovoConfig;
+    transformUrl?: TransformUrlFn;
     url?: string;
 };
-export declare const extractFlexibleCardActions: ({ actionOptions, aiSummaryConfig, appearance, fireEvent, id, origin, product, response, rovoConfig, url, isPreviewPanelAvailable, openPreviewPanel, }: ExtractActionsParam) => FlexibleUiActions | undefined;
+export declare const extractFlexibleCardActions: ({ actionOptions, aiSummaryConfig, appearance, fireEvent, id, origin, product, response, rovoConfig, transformUrl, url, isPreviewPanelAvailable, openPreviewPanel, }: ExtractActionsParam) => FlexibleUiActions | undefined;

package/dist/types-ts4.5/extractors/flexible/extract-state.d.ts

@@ -3,6 +3,7 @@ import { type FireEventFunction } from '../../common/analytics/types';
 import { type ResolveFunction } from '../../state/hooks/use-resolve';
 import { type AnalyticsOrigin } from '../../utils/types';
 import { type InternalCardActionOptions as CardActionOptions, type CardInnerAppearance } from '../../view/Card/types';
+import { type TransformUrlFn } from '../action/types';
 import { type LinkLozenge } from '../common/lozenge/types';
 declare const extractState: (response?: JsonLd.Response, actionOptions?: CardActionOptions, id?: string, appearance?: CardInnerAppearance, origin?: AnalyticsOrigin, fireEvent?: FireEventFunction, resolve?: ResolveFunction, isPreviewPanelAvailable?: (params: {
     ari: string;
@@ -14,5 +15,5 @@ declare const extractState: (response?: JsonLd.Response, actionOptions?: CardAct
         embedUrl?: string;
     };
     url: string;
-}) => void) => LinkLozenge | undefined;
+}) => void, transformUrl?: TransformUrlFn) => LinkLozenge | undefined;
 export default extractState;

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

@@ -1,4 +1,4 @@
 import { type FlexibleUiDataContext } from '../../state/flexible-ui-context/types';
 import { type ExtractFlexibleUiDataContextParams } from '../../view/FlexibleCard/types';
-declare const extractFlexibleUiContext: ({ appearance, fireEvent, id, onClick, onAuxClick, onContextMenu, origin, product, resolve, rovoConfig, actionOptions, response, status, aiSummaryConfig, isPreviewPanelAvailable, openPreviewPanel, ...props }?: Partial<ExtractFlexibleUiDataContextParams>) => FlexibleUiDataContext | undefined;
+declare const extractFlexibleUiContext: ({ appearance, fireEvent, id, onClick, onAuxClick, onContextMenu, origin, product, resolve, rovoConfig, actionOptions, response, status, aiSummaryConfig, isPreviewPanelAvailable, openPreviewPanel, transformUrl, ...props }?: Partial<ExtractFlexibleUiDataContextParams>) => FlexibleUiDataContext | undefined;
 export default extractFlexibleUiContext;

package/dist/types-ts4.5/utils/click-helpers.d.ts

@@ -1,3 +1,4 @@
+import { type KeyboardEvent, type MouseEvent } from 'react';
 /**
  * Returns true for genuine middle-clicks (button === 1).
  * Filters out Windows right-clicks, which fire onAuxClick with button === 2
@@ -6,3 +7,22 @@
 export declare const isAuxClick: (e: {
     button: number;
 }) => boolean;
+/**
+ * Extracts `href` and `target` from the anchor element that is the event's `currentTarget`.
+ *
+ * Smart Link click handlers are attached to multiple card renderers (InlineCard, BlockCard,
+ * EmbedCard, FlexibleCard). When the handler needs to manually open a link — for example,
+ * when native anchor navigation has been prevented — it uses this helper to read the
+ * anchor's resolved URL and intended target from the event rather than re-deriving them.
+ *
+ * Returns `{ href: undefined, target: '_self' }` when `currentTarget` is not an anchor
+ * element (e.g. a button or wrapper div), so callers can safely fall back to a default target.
+ *
+ * @param event - A React mouse or keyboard event whose `currentTarget` may be an anchor.
+ * @returns The resolved absolute `href` and `target` attribute of the anchor, or safe
+ *   defaults if `currentTarget` is not an anchor.
+ */
+export declare const getAnchorAttributesFromEvent: (event: MouseEvent | KeyboardEvent) => {
+    href?: string;
+    target: string;
+};