@atlaskit/smart-card 44.24.2 → 44.25.0

package/dist/es2019/ssr.js

@@ -5,6 +5,7 @@ import uuid from 'uuid';
 import { AnalyticsContext } from '@atlaskit/analytics-next';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { context } from './utils/analytics/analytics';
+import { isFlexibleUiCard } from './utils/flexible';
 import CardErrorBoundary from './view/CardWithUrl/card-error-boundary';
 import { CardWithUrl, CardWithUrlContent } from './view/CardWithUrl/component';
 import { LoadingCardLink } from './view/CardWithUrl/component-lazy/LoadingCardLink';
@@ -17,9 +18,14 @@ const CardSSROld = props => {
     var _props$id;
     return (_props$id = props.id) !== null && _props$id !== void 0 ? _props$id : uuid();
   });
+  // FlexibleCards always need full ORS data regardless of appearance prop,
+  // because they render custom blocks (TitleBlock etc.) requiring a complete response.
+  // Override appearance to 'block' for FlexibleCards when FG is enabled.
+  const effectiveAppearance = isFlexibleUiCard(props.children, props.ui) && fg('platform_smartlink_inline_resolve_optimization') ? 'block' : props.appearance;
   const cardProps = {
     ...props,
-    id
+    id,
+    appearance: effectiveAppearance
   };
   const ErrorFallbackComponent = cardProps.fallbackComponent;
   const errorBoundaryFallbackComponent = () => {
@@ -28,7 +34,7 @@ const CardSSROld = props => {
     }
     return /*#__PURE__*/React.createElement(LoadingCardLink, cardProps);
   };
-  const Component = cardProps.appearance === 'inline' ? 'span' : 'div';
+  const Component = effectiveAppearance === 'inline' ? 'span' : 'div';
   return /*#__PURE__*/React.createElement(AnalyticsContext, {
     data: context
   }, /*#__PURE__*/React.createElement(ErrorBoundary, {
@@ -47,9 +53,14 @@ const CardSSRNew = props => {
     var _props$id2;
     return (_props$id2 = props.id) !== null && _props$id2 !== void 0 ? _props$id2 : uuid();
   });
+  // FlexibleCards always need full ORS data regardless of appearance prop,
+  // because they render custom blocks (TitleBlock etc.) requiring a complete response.
+  // Override appearance to 'block' for FlexibleCards when FG is enabled.
+  const effectiveAppearance = isFlexibleUiCard(props.children, props.ui) && fg('platform_smartlink_inline_resolve_optimization') ? 'block' : props.appearance;
   const propsWithId = {
     ...props,
-    id
+    id,
+    appearance: effectiveAppearance
   };
   return /*#__PURE__*/React.createElement(AnalyticsContext, {
     data: context

package/dist/es2019/state/actions/index.js

@@ -101,8 +101,40 @@ export const useSmartCardActions = (id, url) => {
       url
     }, undefined, undefined, metadataStatus));
   }, [dispatch, url]);
-  const resolve = useCallback(async (resourceUrl = url, isReloading = false, isMetadataRequest = false) => resolveUrl(resourceUrl, isReloading, isMetadataRequest, id), [id, resolveUrl, url]);
-  const register = useCallback(() => {
+
+  // Original resolve function — signature kept intact for maximum safety when FG is off.
+  const resolve = useCallback(async (resourceUrl = url, isReloading = false, isMetadataRequest = false) => resolveUrl({
+    url: resourceUrl,
+    isReloading,
+    isMetadataRequest,
+    id
+  }), [id, resolveUrl, url]);
+
+  // New resolve function accepting ResolveUrlParams (minus 'id' which is closed over).
+  // Used when FG is enabled to pass appearance to ORS.
+  const resolveNew = useCallback(async (params = {}) => {
+    const {
+      url: resourceUrl = url,
+      isReloading = false,
+      isMetadataRequest = false,
+      appearance
+    } = params;
+    return resolveUrl({
+      url: resourceUrl,
+      isReloading,
+      isMetadataRequest,
+      id,
+      appearance
+    });
+  }, [id, resolveUrl, url]);
+
+  /**
+   * Register a smart link for resolution.
+   * @param appearance - Card appearance hint for ORS to optimize response payload.
+   *                     When 'inline', ORS returns minimal data (title, status).
+   *                     When 'block' or 'embed', ORS returns full data including summary.
+   */
+  const register = useCallback(appearance => {
     const {
       details
     } = getSmartLinkState();
@@ -110,31 +142,72 @@ export const useSmartCardActions = (id, url) => {
       dispatch(cardAction(ACTION_RESOLVING, {
         url
       }));
+      // Always set metadataStatus to 'pending' during registration to prevent
+      // loadMetadata from firing a duplicate concurrent fetch if a hover card
+      // mounts while registration is in-flight. This matches pre-PR behaviour.
       setMetadataStatus('pending');
     }
-    return resolve();
-  }, [getSmartLinkState, resolve, dispatch, url, setMetadataStatus]);
-  const reload = useCallback(() => {
+    if (fg('platform_smartlink_inline_resolve_optimization')) {
+      return resolveNew({
+        url,
+        appearance
+      });
+    }
+    return resolve(url);
+  }, [getSmartLinkState, resolve, resolveNew, dispatch, url, setMetadataStatus]);
+  const reload = useCallback(appearance => {
     const {
       details
     } = getSmartLinkState();
     const definitionId = getDefinitionId(details);
-    if (definitionId) {
-      getByDefinitionId(definitionId, getState()).map(url => resolve(url, true));
+    if (fg('platform_smartlink_inline_resolve_optimization')) {
+      if (definitionId) {
+        getByDefinitionId(definitionId, getState()).map(reloadUrl => resolveNew({
+          url: reloadUrl,
+          isReloading: true,
+          appearance
+        }));
+      } else {
+        resolveNew({
+          url,
+          isReloading: true,
+          appearance
+        });
+      }
     } else {
-      resolve(url, true);
+      if (definitionId) {
+        getByDefinitionId(definitionId, getState()).map(reloadUrl => resolve(reloadUrl, true));
+      } else {
+        resolve(url, true);
+      }
     }
-  }, [getSmartLinkState, url, getState, resolve]);
+  }, [getSmartLinkState, url, getState, resolve, resolveNew]);
+
+  /**
+   * Load metadata for hover card preview.
+   * This always requests 'block' appearance to get full data including summary.
+   *
+   * Inline optimized and SSR-resolved links keep metadataStatus pending until hover
+   * requests the full block response.
+   */
   const loadMetadata = useCallback(() => {
     const {
       metadataStatus
     } = getSmartLinkState();
-    //metadataStatus will be undefined for SSR links only
-    if (metadataStatus === undefined) {
+    const needsBlockData = metadataStatus === undefined || metadataStatus === 'pending' && fg('platform_smartlink_inline_resolve_optimization');
+    if (needsBlockData) {
       setMetadataStatus('pending');
+      if (fg('platform_smartlink_inline_resolve_optimization')) {
+        // Always request 'block' appearance for hover card metadata to get full data
+        return resolveNew({
+          url,
+          isMetadataRequest: true,
+          appearance: 'block'
+        });
+      }
       return resolve(url, false, true);
     }
-  }, [getSmartLinkState, resolve, setMetadataStatus, url]);
+  }, [getSmartLinkState, resolve, resolveNew, setMetadataStatus, url]);
   const authorize = useCallback(appearance => {
     const {
       details,

package/dist/es2019/state/hooks/use-resolve/index.js

@@ -1,6 +1,7 @@
 import { useCallback } from 'react';
 import { isEntityPresent } from '@atlaskit/link-extractors';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { SmartLinkStatus } from '../../../constants';
 import { addMetadataToExperience } from '../../analytics';
 import useResponse from '../use-response';
@@ -20,7 +21,14 @@ const useResolve = () => {
     handleResolvedLinkResponse,
     handleResolvedLinkError
   } = useResponse();
-  return useCallback(async (url, isReloading = false, isMetadataRequest = false, id = '') => {
+  return useCallback(async params => {
+    const {
+      url,
+      isReloading = false,
+      isMetadataRequest = false,
+      id = '',
+      appearance
+    } = params;
     const {
       details
     } = getState()[url] || {
@@ -29,7 +37,8 @@ const useResolve = () => {
     };
     const hasData = !!(details && details.data || isEntityPresent(details));
     if (isReloading || !hasData || isMetadataRequest) {
-      return connections.client.fetchData(url, isReloading).then(response => handleResolvedLinkResponse(url, response, isReloading, isMetadataRequest)).catch(error => handleResolvedLinkError(url, error, undefined, isMetadataRequest));
+      const metadataStatus = appearance === 'inline' && !isMetadataRequest && fg('platform_smartlink_inline_resolve_optimization') ? 'pending' : undefined;
+      return connections.client.fetchData(url, isReloading, appearance).then(response => handleResolvedLinkResponse(url, response, isReloading, isMetadataRequest, metadataStatus)).catch(error => handleResolvedLinkError(url, error, undefined, isMetadataRequest));
     } else {
       addMetadataToExperience('smart-link-rendered', id, {
         cached: true

package/dist/es2019/state/hooks/use-response/index.js

@@ -2,6 +2,7 @@ import { useCallback, useMemo } from 'react';
 import { unstable_batchedUpdates } from 'react-dom';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
 import { ACTION_ERROR, ACTION_ERROR_FALLBACK, ACTION_RELOADING, ACTION_RESOLVED, ACTION_UPDATE_METADATA_STATUS, APIError, cardAction, getStatus } from '@atlaskit/linking-common';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { SmartLinkStatus } from '../../../constants';
 import { getUnauthorizedJsonLd } from '../../../utils/jsonld';
 import { ERROR_MESSAGE_FATAL, ERROR_MESSAGE_METADATA, ERROR_MESSAGE_OAUTH } from '../../actions/constants';
@@ -74,9 +75,9 @@ const useResponse = () => {
       }
     }
   }, [getState, setMetadataStatus, dispatch]);
-  const handleResolvedLinkSuccess = useCallback((resourceUrl, response, isReloading, isMetadataRequest) => {
-    //if a link resolves normally, metadata will also always be resolved
-    setMetadataStatus(resourceUrl, 'resolved');
+  const handleResolvedLinkSuccess = useCallback((resourceUrl, response, isReloading, isMetadataRequest, metadataStatus = 'resolved') => {
+    // Some optimized resolves intentionally leave metadata pending so hover can fetch it.
+    setMetadataStatus(resourceUrl, fg('platform_smartlink_inline_resolve_optimization') ? metadataStatus : 'resolved');
     // Dispatch Analytics and resolved card action - including unauthorized states.
     if (isReloading) {
       dispatch(cardAction(ACTION_RELOADING, {
@@ -88,7 +89,10 @@ const useResponse = () => {
       }, response, undefined, undefined, isMetadataRequest));
     }
   }, [setMetadataStatus, dispatch]);
-  const handleResolvedLinkResponse = useCallback((resourceUrl, response, isReloading = false, isMetadataRequest) => {
+  const handleResolvedLinkResponse = useCallback((resourceUrl, response, isReloading = false, isMetadataRequest, metadataStatus) => {
+    if (!resourceUrl) {
+      return;
+    }
     const hostname = new URL(resourceUrl).hostname;
     const nextStatus = response ? getStatus(response) : 'fatal';
 
@@ -118,7 +122,7 @@ const useResponse = () => {
      * https://react-redux.js.org/api/batch
      */
     unstable_batchedUpdates(() => {
-      handleResolvedLinkSuccess(resourceUrl, response, isReloading, isMetadataRequest);
+      handleResolvedLinkSuccess(resourceUrl, response, isReloading, isMetadataRequest, metadataStatus);
     });
   }, [handleResolvedLinkError, handleResolvedLinkSuccess, hasAuthFlowSupported]);
   return useMemo(() => ({

package/dist/es2019/state/hooks/usePrefetch.js

@@ -1,7 +1,8 @@
 import { useCallback } from 'react';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
 import { ACTION_UPDATE_METADATA_STATUS, cardAction } from '@atlaskit/linking-common';
-export function usePrefetch(url) {
+import { fg } from '@atlaskit/platform-feature-flags';
+export function usePrefetch(url, appearance) {
   const {
     store,
     prefetchStore,
@@ -40,7 +41,7 @@ export function usePrefetch(url) {
       // requests by domain (as usual) to ensure we minimize the amount of connections
       // we create between browser -> ORS when making network requests.
       try {
-        const response = await client.prefetchData(url);
+        const response = await client.prefetchData(url, appearance);
         // Once the data comes back, we put the link in the `resolved` status. This ensures
         // that when the link enters the viewport and is rendered, we immediately show it as
         // a Smart Link, rather than rendering a loading spinner -> immediate Smart Link.
@@ -50,18 +51,18 @@ export function usePrefetch(url) {
             url,
             payload: response
           });
-          // Put the metadata in resolved state, theres no need for a pending or errored state as
-          // we are following the same render flow as described by the comments above and below.
+          // Put the metadata status: 'pending' for inline appearance when FG is on, so HoverCard
+          // can upgrade to full block data. Otherwise 'resolved' preserves existing behaviour.
           dispatch(cardAction(ACTION_UPDATE_METADATA_STATUS, {
             url
-          }, undefined, undefined, 'resolved'));
+          }, undefined, undefined, appearance === 'inline' && fg('platform_smartlink_inline_resolve_optimization') ? 'pending' : 'resolved'));
         }
-      } catch (_err) {
+      } catch {
         // Do nothing, link will be retried under the hood with exponential backoff.
         // If it does not succeed even after those retries, the normal resolve flow
         // will start when the link is in view. Since we have not performed any store
         // mutations yet, the link will behave like a 'brand new' link.
       }
     }
-  }, [store, prefetchStore, connections, url, getState, client, dispatch]);
+  }, [store, prefetchStore, connections, url, getState, client, dispatch, appearance]);
 }

package/dist/es2019/state/hooks/useSmartLink.js

@@ -1,10 +1,20 @@
 import { useEffect, useState } from 'react';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { useSmartCardActions as useSmartLinkActions } from '../actions';
 import { useSmartLinkConfig } from '../config';
 import { useSmartLinkRenderers } from '../renderers';
 import { useSmartCardState as useSmartLinkState } from '../store';
-export function useSmartLink(id, url) {
+
+/**
+ * Hook for smart link state and actions.
+ * @param id - Unique identifier for the smart link
+ * @param url - The URL to resolve
+ * @param appearance - Card appearance hint for ORS to optimize response payload.
+ *                     When 'inline', ORS returns minimal data (title, status).
+ *                     When 'block' or 'embed', ORS returns full data including summary.
+ */
+export function useSmartLink(id, url, appearance) {
   const state = useSmartLinkState(url);
   const {
     store,
@@ -17,9 +27,9 @@ export function useSmartLink(id, url) {
 
   // NB: used to propagate errors from hooks to error boundaries.
   const [error, setError] = useState(null);
-  // Register the current card.
+  // Register the current card with appearance hint for optimized ORS response.
   const register = () => {
-    actions.register().catch(err => setError(err));
+    actions.register(fg('platform_smartlink_inline_resolve_optimization') ? appearance : undefined).catch(err => setError(err));
   };
   // AFP-2511 TODO: Fix automatic suppressions below
   // eslint-disable-next-line react-hooks/exhaustive-deps

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

@@ -40,7 +40,9 @@ export function useSmartLinkActions({
     details: linkState.details
   });
   if (expValEquals('platform_hover_card_preview_panel', 'cohort', 'test') && prefetch && !linkState.details) {
-    resolve(url);
+    resolve({
+      url
+    });
   }
   if (linkState.details && !(actionOptions !== null && actionOptions !== void 0 && actionOptions.hide)) {
     const actions = [];

package/dist/es2019/utils/analytics/analytics.js

@@ -2,7 +2,7 @@ export const ANALYTICS_CHANNEL = 'media';
 export const context = {
   componentName: 'smart-cards',
   packageName: "@atlaskit/smart-card" || '',
-  packageVersion: "44.24.1" || ''
+  packageVersion: "44.24.2" || ''
 };
 export let TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/es2019/view/CardWithUrl/component-lazy/LazyIntersectionObserverCard.js

@@ -24,7 +24,7 @@ function LazyIntersectionObserverCardOld(props) {
     url,
     id
   } = props;
-  const prefetch = usePrefetch(url);
+  const prefetch = usePrefetch(url, appearance);
   const Component = appearance === 'inline' ? 'span' : 'div';
   const ComponentObserver = Component;
   const onIntersection = useCallback((entries, observer) => {

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

@@ -1,4 +1,4 @@
-import React, { useCallback, useEffect, useMemo } from 'react';
+import React, { useCallback, useEffect, useMemo, useRef } from 'react';
 import { useAnalyticsEvents as useAnalyticsEventsNext } from '@atlaskit/analytics-next';
 import { extractSmartLinkEmbed } from '@atlaskit/link-extractors';
 import { fg } from '@atlaskit/platform-feature-flags';
@@ -66,6 +66,9 @@ function Component({
   let isFlexibleUi = useMemo(() => isFlexibleUiCard(children, ui), [children, ui]);
 
   // Get state, actions for this card.
+  // appearance is pre-resolved by the caller (loader.tsx for Card, ssr.tsx for CardSSR):
+  // FlexibleCards are always passed appearance='block' when FG is on, so component.tsx
+  // simply consumes whatever appearance it receives.
   const {
     state,
     actions,
@@ -74,7 +77,7 @@ function Component({
     error,
     isPreviewPanelAvailable,
     openPreviewPanel
-  } = useSmartLink(id, url);
+  } = useSmartLink(id, url, appearance);
   const ari = getObjectAri(state.details);
   const name = getObjectName(state.details);
   const definitionId = getDefinitionId(state.details);
@@ -261,10 +264,31 @@ function Component({
       });
     }
   }, [fire3PClickEvent, shouldFire3PClickEvent]);
+  const {
+    reload
+  } = actions;
   const handleAuthorize = useCallback(() => actions.authorize(appearance), [actions, appearance]);
   const handleRetry = useCallback(() => {
-    actions.reload();
-  }, [actions]);
+    reload();
+  }, [reload]);
+  const hasMounted = useRef(false);
+  const prevAppearance = useRef(appearance);
+
+  // When appearance changes from inline to non-inline on a mounted card
+  // (e.g. direct consumer changes inline → block/embed), reload with the new appearance
+  // so ORS can return the appropriate full data. We intentionally do NOT reload on
+  // block → embed or embed → block transitions since both already have full ORS data.
+  useEffect(() => {
+    if (!hasMounted.current) {
+      hasMounted.current = true;
+      prevAppearance.current = appearance;
+      return;
+    }
+    if (prevAppearance.current === 'inline' && appearance !== 'inline' && fg('platform_smartlink_inline_resolve_optimization')) {
+      reload(appearance);
+    }
+    prevAppearance.current = appearance;
+  }, [appearance, reload]);
   const handleInvoke = useCallback(opts => actions.invoke(opts, appearance), [actions, appearance]);
   const experimentMetaEventAttributes = useExperimentMetaEventAttributes({
     appearance,

package/dist/es2019/view/CardWithUrl/loader.js

@@ -3,6 +3,7 @@ import { ErrorBoundary } from 'react-error-boundary';
 import { di } from 'react-magnetic-di';
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import uuid from 'uuid';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { useAnalyticsEvents } from '../../common/analytics/generated/use-analytics-events';
 import { failUfoExperience, startUfoExperience } from '../../state/analytics';
 import { importWithRetry } from '../../utils';
@@ -103,10 +104,15 @@ export function CardWithURLRenderer(props) {
   const defaultFallBackComponent = () => null;
   const FallbackComponent = fallbackComponent !== null && fallbackComponent !== void 0 ? fallbackComponent : defaultFallBackComponent;
   const ErrorFallback = () => /*#__PURE__*/React.createElement(FallbackComponent, null);
+
+  // FlexibleCards always need full ORS data regardless of appearance prop,
+  // because they render custom blocks (TitleBlock etc.) requiring complete response.
+  // Override appearance to 'block' for all FlexibleCards when FG is enabled.
+  const effectiveAppearance = isFlexibleUi && fg('platform_smartlink_inline_resolve_optimization') ? 'block' : appearance;
   const cardWithUrlProps = {
     id,
     url,
-    appearance,
+    appearance: effectiveAppearance,
     onClick,
     isSelected,
     isHovered,

package/dist/es2019/view/EmbedCard/useEmbedResolvePostMessageListener.js

@@ -13,7 +13,10 @@ export const useEmbedResolvePostMessageListener = ({
       }
       const isFromExpectedIframe = embedIframeRef && event.source === ((_embedIframeRef$curre = embedIframeRef.current) === null || _embedIframeRef$curre === void 0 ? void 0 : _embedIframeRef$curre.contentWindow);
       if (event.data === 'force-resolve-smart-link' && isFromExpectedIframe) {
-        resolve(url, true);
+        resolve({
+          url,
+          isReloading: true
+        });
       }
     };
     window.addEventListener('message', messageCallback);

package/dist/es2019/view/FlexibleCard/components/actions/action/server-action/index.js

@@ -38,7 +38,11 @@ const ServerAction = ({
           smartLinkActionType
         });
         if (action.reload && action.reload.url) {
-          await reload(action.reload.url, true, undefined, action.reload.id);
+          await reload({
+            url: action.reload.url,
+            isReloading: true,
+            id: action.reload.id
+          });
         }
         setIsLoading(false);
         if (onClick) {

package/dist/es2019/view/FlexibleCard/components/elements/common/base-lozenge-element/lozenge-action/index.js

@@ -116,7 +116,11 @@ const LozengeAction = ({
           smartLinkActionType: TrackQuickActionType.StatusUpdate
         });
         if (url) {
-          await reload(url, true, undefined, linkId);
+          await reload({
+            url,
+            isReloading: true,
+            id: linkId
+          });
         }
       }
     } catch (err) {

package/dist/es2019/view/HoverCard/components/HoverCardComponent.js

@@ -1,5 +1,6 @@
 import _extends from "@babel/runtime/helpers/extends";
 import React, { useCallback, useEffect, useMemo, useRef } from 'react';
+import { fg } from '@atlaskit/platform-feature-flags';
 import Popup from '@atlaskit/popup';
 import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
 import { ActionName, CardDisplay } from '../../../constants';
@@ -121,7 +122,7 @@ export const HoverCardComponent = ({
   // to minimize the loading state
   const initResolve = useCallback(() => {
     // this check covers both non-SSR (status) & SSR case (metadataStatus)
-    const isLinkUnresolved = linkState.status === 'pending' || !linkState.metadataStatus;
+    const isLinkUnresolved = linkState.status === 'pending' || !linkState.metadataStatus || linkState.status === 'resolved' && linkState.metadataStatus === 'pending' && fg('platform_smartlink_inline_resolve_optimization');
     if (!resolveTimeOutId.current && isLinkUnresolved) {
       resolveTimeOutId.current = setTimeout(() => {
         if (linkState.status === 'pending') {

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

@@ -9,7 +9,7 @@ import LinkWarningModal from './LinkWarningModal';
 import { useLinkWarningModal } from './LinkWarningModal/hooks/use-link-warning-modal';
 const PACKAGE_DATA = {
   packageName: "@atlaskit/smart-card",
-  packageVersion: "44.24.1",
+  packageVersion: "44.24.2",
   componentName: 'linkUrl'
 };
 const LinkUrl = ({

package/dist/esm/extractors/flexible/extract-state.js

@@ -44,7 +44,10 @@ var extractAction = function extractAction(response, id, actionOptions, appearan
     fireEvent: fireEvent,
     id: id,
     onClose: resolve ? function () {
-      return url && resolve(url, true);
+      return url && resolve({
+        url: url,
+        isReloading: true
+      });
     } : undefined,
     origin: origin,
     response: response,

package/dist/esm/ssr.js

@@ -9,6 +9,7 @@ import uuid from 'uuid';
 import { AnalyticsContext } from '@atlaskit/analytics-next';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { context } from './utils/analytics/analytics';
+import { isFlexibleUiCard } from './utils/flexible';
 import CardErrorBoundary from './view/CardWithUrl/card-error-boundary';
 import { CardWithUrl, CardWithUrlContent } from './view/CardWithUrl/component';
 import { LoadingCardLink } from './view/CardWithUrl/component-lazy/LoadingCardLink';
@@ -23,8 +24,13 @@ var CardSSROld = function CardSSROld(props) {
     }),
     _useState2 = _slicedToArray(_useState, 1),
     id = _useState2[0];
+  // FlexibleCards always need full ORS data regardless of appearance prop,
+  // because they render custom blocks (TitleBlock etc.) requiring a complete response.
+  // Override appearance to 'block' for FlexibleCards when FG is enabled.
+  var effectiveAppearance = isFlexibleUiCard(props.children, props.ui) && fg('platform_smartlink_inline_resolve_optimization') ? 'block' : props.appearance;
   var cardProps = _objectSpread(_objectSpread({}, props), {}, {
-    id: id
+    id: id,
+    appearance: effectiveAppearance
   });
   var ErrorFallbackComponent = cardProps.fallbackComponent;
   var errorBoundaryFallbackComponent = function errorBoundaryFallbackComponent() {
@@ -33,7 +39,7 @@ var CardSSROld = function CardSSROld(props) {
     }
     return /*#__PURE__*/React.createElement(LoadingCardLink, cardProps);
   };
-  var Component = cardProps.appearance === 'inline' ? 'span' : 'div';
+  var Component = effectiveAppearance === 'inline' ? 'span' : 'div';
   return /*#__PURE__*/React.createElement(AnalyticsContext, {
     data: context
   }, /*#__PURE__*/React.createElement(ErrorBoundary, {
@@ -54,8 +60,13 @@ var CardSSRNew = function CardSSRNew(props) {
     }),
     _useState4 = _slicedToArray(_useState3, 1),
     id = _useState4[0];
+  // FlexibleCards always need full ORS data regardless of appearance prop,
+  // because they render custom blocks (TitleBlock etc.) requiring a complete response.
+  // Override appearance to 'block' for FlexibleCards when FG is enabled.
+  var effectiveAppearance = isFlexibleUiCard(props.children, props.ui) && fg('platform_smartlink_inline_resolve_optimization') ? 'block' : props.appearance;
   var propsWithId = _objectSpread(_objectSpread({}, props), {}, {
-    id: id
+    id: id,
+    appearance: effectiveAppearance
   });
   return /*#__PURE__*/React.createElement(AnalyticsContext, {
     data: context