@atlaskit/smart-card 44.16.0 → 44.16.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @atlaskit/smart-card
 
+## 44.16.2
+
+### Patch Changes
+
+- Updated dependencies
+
+## 44.16.1
+
+### Patch Changes
+
+- [`6912c1730a806`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/6912c1730a806) -
+  Fix block card social proof experiment exposure to use the exposure-firing experiment helper.
+
 ## 44.16.0
 
 ### Minor Changes

package/dist/cjs/state/hooks/use-social-proof-experiment/index.js

@@ -7,7 +7,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.getSocialProofTier = exports.getSocialProofExperimentMeta = exports.getInlineSocialProofExperimentMeta = exports.default = exports.SOCIAL_PROOF_TIER_THRESHOLD = exports.SOCIAL_PROOF_3P_UNAUTH_BLOCK_EXPERIMENT_KEY = exports.INLINE_SOCIAL_PROOF_EXPERIMENT_KEY = void 0;
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _react = require("react");
-var _experiments = require("@atlaskit/tmp-editor-statsig/experiments");
+var _expValEquals = require("@atlaskit/tmp-editor-statsig/exp-val-equals");
 var _currentSiteCloudId = require("../../services/current-site-cloud-id");
 var _personalization = require("../../services/personalization");
 var _useSocialProof2 = _interopRequireDefault(require("../use-social-proof"));
@@ -73,7 +73,7 @@ var useSocialProofExperiment = function useSocialProofExperiment(extensionKey) {
     var hasSocialProofData = connectedPct !== undefined;
 
     // Only fire exposure when data has loaded (prevents exposure inflation)
-    var isTreatment = isEnabled && !isLoading && hasSocialProofData ? (0, _experiments.editorExperiment)('social_proof_3p_unauth_block_exp', true) : false;
+    var isTreatment = isEnabled && !isLoading && hasSocialProofData ? (0, _expValEquals.expValEquals)(SOCIAL_PROOF_3P_UNAUTH_BLOCK_EXPERIMENT_KEY, 'isEnabled', true) : false;
     var tier = (_getSocialProofTier = getSocialProofTier(connectedPct)) !== null && _getSocialProofTier !== void 0 ? _getSocialProofTier : 'low';
     return {
       isTreatment: isTreatment,

package/dist/cjs/utils/analytics/analytics.js

@@ -11,7 +11,7 @@ var ANALYTICS_CHANNEL = exports.ANALYTICS_CHANNEL = 'media';
 var context = exports.context = {
   componentName: 'smart-cards',
   packageName: "@atlaskit/smart-card" || '',
-  packageVersion: "44.15.0" || ''
+  packageVersion: "44.16.1" || ''
 };
 var TrackQuickActionType = exports.TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/cjs/view/InlineCard/index.js

@@ -135,7 +135,6 @@ var InlineCard = exports.InlineCard = function InlineCard(_ref2) {
         isSelected: isSelected,
         isHovered: isHovered,
         onClick: handleFrameClick
-
         // Support middle-/right-clicks for "resolved" only — the vast majority of clicks happen here.
         // Other states (e.g. "resolving") could be added later for completeness.
         ,

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

@@ -19,7 +19,7 @@ var _excluded = ["href", "children", "checkSafety", "onClick", "testId", "isLink
   _excluded2 = ["isLinkSafe", "showSafetyWarningModal"];
 var PACKAGE_DATA = {
   packageName: "@atlaskit/smart-card",
-  packageVersion: "44.15.0",
+  packageVersion: "44.16.1",
   componentName: 'linkUrl'
 };
 var LinkUrl = function LinkUrl(_ref) {

package/dist/es2019/state/hooks/use-social-proof-experiment/index.js

@@ -1,5 +1,5 @@
 import { useMemo } from 'react';
-import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { getCurrentSiteCloudIdSync } from '../../services/current-site-cloud-id';
 import { getProviderPctMapSync, SOCIAL_PROOF_TRAIT_NAME } from '../../services/personalization';
 import useSocialProof from '../use-social-proof';
@@ -64,7 +64,7 @@ const useSocialProofExperiment = (extensionKey, baseUriWithNoTrailingSlash = '')
     const hasSocialProofData = connectedPct !== undefined;
 
     // Only fire exposure when data has loaded (prevents exposure inflation)
-    const isTreatment = isEnabled && !isLoading && hasSocialProofData ? editorExperiment('social_proof_3p_unauth_block_exp', true) : false;
+    const isTreatment = isEnabled && !isLoading && hasSocialProofData ? expValEquals(SOCIAL_PROOF_3P_UNAUTH_BLOCK_EXPERIMENT_KEY, 'isEnabled', true) : false;
     const tier = (_getSocialProofTier = getSocialProofTier(connectedPct)) !== null && _getSocialProofTier !== void 0 ? _getSocialProofTier : 'low';
     return {
       isTreatment,

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.15.0" || ''
+  packageVersion: "44.16.1" || ''
 };
 export let TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/es2019/view/CardWithUrl/experiment-meta-event-attributes/index.js

@@ -1,7 +1,7 @@
-import { fg } from "@atlaskit/platform-feature-flags";
-import { useSmartLinkContext } from "../../../state";
-import { getExtensionKey } from "../../../state/helpers";
-import { getSocialProofExperimentMeta, getInlineSocialProofExperimentMeta } from "../../../state/hooks/use-social-proof-experiment";
+import { fg } from '@atlaskit/platform-feature-flags';
+import { useSmartLinkContext } from '../../../state';
+import { getExtensionKey } from '../../../state/helpers';
+import { getSocialProofExperimentMeta, getInlineSocialProofExperimentMeta } from '../../../state/hooks/use-social-proof-experiment';
 const useExperimentMetaEventAttributes = ({
   appearance,
   state

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

@@ -100,7 +100,6 @@ export const InlineCard = ({
         isSelected: isSelected,
         isHovered: isHovered,
         onClick: handleFrameClick
-
         // Support middle-/right-clicks for "resolved" only — the vast majority of clicks happen here.
         // Other states (e.g. "resolving") could be added later for completeness.
         ,

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.15.0",
+  packageVersion: "44.16.1",
   componentName: 'linkUrl'
 };
 const LinkUrl = ({

package/dist/esm/state/hooks/use-social-proof-experiment/index.js

@@ -2,7 +2,7 @@ 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 { useMemo } from 'react';
-import { editorExperiment } from '@atlaskit/tmp-editor-statsig/experiments';
+import { expValEquals } from '@atlaskit/tmp-editor-statsig/exp-val-equals';
 import { getCurrentSiteCloudIdSync } from '../../services/current-site-cloud-id';
 import { getProviderPctMapSync, SOCIAL_PROOF_TRAIT_NAME } from '../../services/personalization';
 import useSocialProof from '../use-social-proof';
@@ -66,7 +66,7 @@ var useSocialProofExperiment = function useSocialProofExperiment(extensionKey) {
     var hasSocialProofData = connectedPct !== undefined;
 
     // Only fire exposure when data has loaded (prevents exposure inflation)
-    var isTreatment = isEnabled && !isLoading && hasSocialProofData ? editorExperiment('social_proof_3p_unauth_block_exp', true) : false;
+    var isTreatment = isEnabled && !isLoading && hasSocialProofData ? expValEquals(SOCIAL_PROOF_3P_UNAUTH_BLOCK_EXPERIMENT_KEY, 'isEnabled', true) : false;
     var tier = (_getSocialProofTier = getSocialProofTier(connectedPct)) !== null && _getSocialProofTier !== void 0 ? _getSocialProofTier : 'low';
     return {
       isTreatment: isTreatment,

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.15.0" || ''
+  packageVersion: "44.16.1" || ''
 };
 export var TrackQuickActionType = /*#__PURE__*/function (TrackQuickActionType) {
   TrackQuickActionType["StatusUpdate"] = "StatusUpdate";

package/dist/esm/view/CardWithUrl/experiment-meta-event-attributes/index.js

@@ -1,10 +1,10 @@
 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 { fg } from "@atlaskit/platform-feature-flags";
-import { useSmartLinkContext } from "../../../state";
-import { getExtensionKey } from "../../../state/helpers";
-import { getSocialProofExperimentMeta, getInlineSocialProofExperimentMeta } from "../../../state/hooks/use-social-proof-experiment";
+import { fg } from '@atlaskit/platform-feature-flags';
+import { useSmartLinkContext } from '../../../state';
+import { getExtensionKey } from '../../../state/helpers';
+import { getSocialProofExperimentMeta, getInlineSocialProofExperimentMeta } from '../../../state/hooks/use-social-proof-experiment';
 var useExperimentMetaEventAttributes = function useExperimentMetaEventAttributes(_ref) {
   var appearance = _ref.appearance,
     state = _ref.state;

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

@@ -97,7 +97,6 @@ export var InlineCard = function InlineCard(_ref2) {
         isSelected: isSelected,
         isHovered: isHovered,
         onClick: handleFrameClick
-
         // Support middle-/right-clicks for "resolved" only — the vast majority of clicks happen here.
         // Other states (e.g. "resolving") could be added later for completeness.
         ,

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.15.0",
+  packageVersion: "44.16.1",
   componentName: 'linkUrl'
 };
 var LinkUrl = function LinkUrl(_ref) {

package/dist/types/types.d.ts

@@ -8,7 +8,7 @@ export {
 /** @deprecated Use @atlaskit/link-provider */
 type ProviderProps, 
 /** @deprecated Use @atlaskit/linking-common */
-type CardType } from './state';
+type CardType, } from './state';
 /** @deprecated Use @atlaskit/smart-card/card/types */
 export { type CardProps, type CardAppearance, type CardPlatform } from './view/Card/types';
 /** @deprecated Use @atlaskit/smart-card/card/types CardProps['inlinePreloaderStyle'] */

package/dist/types/view/CardWithUrl/experiment-meta-event-attributes/index.d.ts

@@ -1,5 +1,5 @@
-import type { CardAppearance, CardState } from "@atlaskit/linking-common";
-import { type BlockCardSocialProofExperimentMeta, type InlineSocialProofExperimentMeta } from "../../../state/hooks/use-social-proof-experiment";
+import type { CardAppearance, CardState } from '@atlaskit/linking-common';
+import { type BlockCardSocialProofExperimentMeta, type InlineSocialProofExperimentMeta } from '../../../state/hooks/use-social-proof-experiment';
 type ExperimentMetaEventAttributes = Partial<BlockCardSocialProofExperimentMeta & InlineSocialProofExperimentMeta>;
 type ExperimentMetaEventAttributesParams = {
     appearance: CardAppearance;

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

@@ -8,7 +8,7 @@ export {
 /** @deprecated Use @atlaskit/link-provider */
 type ProviderProps, 
 /** @deprecated Use @atlaskit/linking-common */
-type CardType } from './state';
+type CardType, } from './state';
 /** @deprecated Use @atlaskit/smart-card/card/types */
 export { type CardProps, type CardAppearance, type CardPlatform } from './view/Card/types';
 /** @deprecated Use @atlaskit/smart-card/card/types CardProps['inlinePreloaderStyle'] */

package/dist/types-ts4.5/view/CardWithUrl/experiment-meta-event-attributes/index.d.ts

@@ -1,5 +1,5 @@
-import type { CardAppearance, CardState } from "@atlaskit/linking-common";
-import { type BlockCardSocialProofExperimentMeta, type InlineSocialProofExperimentMeta } from "../../../state/hooks/use-social-proof-experiment";
+import type { CardAppearance, CardState } from '@atlaskit/linking-common';
+import { type BlockCardSocialProofExperimentMeta, type InlineSocialProofExperimentMeta } from '../../../state/hooks/use-social-proof-experiment';
 type ExperimentMetaEventAttributes = Partial<BlockCardSocialProofExperimentMeta & InlineSocialProofExperimentMeta>;
 type ExperimentMetaEventAttributesParams = {
     appearance: CardAppearance;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/smart-card",
-	"version": "44.16.0",
+	"version": "44.16.2",
 	"description": "Smart card component",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -35,7 +35,7 @@
 		"ak-postbuild": "ls -d dist/* | xargs -n 1 copyfiles -u 1 -V src/**/*.{svg,png}"
 	},
 	"dependencies": {
-		"@atlaskit/adf-utils": "^19.30.0",
+		"@atlaskit/adf-utils": "^19.31.0",
 		"@atlaskit/afm-i18n-platform-linking-platform-smart-card": "2.6.0",
 		"@atlaskit/analytics-gas-types": "^5.1.0",
 		"@atlaskit/analytics-next": "^11.2.0",
@@ -53,42 +53,42 @@
 		"@atlaskit/form": "^15.5.0",
 		"@atlaskit/frontend-utilities": "^3.3.0",
 		"@atlaskit/heading": "^5.4.0",
-		"@atlaskit/icon": "^35.0.0",
+		"@atlaskit/icon": "^35.1.0",
 		"@atlaskit/icon-file-type": "^7.0.0",
-		"@atlaskit/icon-lab": "^6.9.0",
+		"@atlaskit/icon-lab": "^6.10.0",
 		"@atlaskit/image": "^3.0.0",
 		"@atlaskit/json-ld-types": "^1.5.0",
 		"@atlaskit/link": "^3.4.0",
 		"@atlaskit/link-analytics": "^11.1.0",
 		"@atlaskit/link-client-extension": "^6.1.0",
-		"@atlaskit/link-extractors": "^2.6.0",
+		"@atlaskit/link-extractors": "^2.7.0",
 		"@atlaskit/link-test-helpers": "^10.3.0",
 		"@atlaskit/linking-common": "^9.11.0",
 		"@atlaskit/linking-types": "^14.4.0",
 		"@atlaskit/logo": "^20.1.0",
 		"@atlaskit/lozenge": "^13.8.0",
 		"@atlaskit/menu": "^8.5.0",
-		"@atlaskit/modal-dialog": "^15.1.0",
+		"@atlaskit/modal-dialog": "^15.2.0",
 		"@atlaskit/motion": "^6.2.0",
 		"@atlaskit/object": "^1.0.0",
 		"@atlaskit/outbound-auth-flow-client": "^3.4.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/platform-feature-flags-react": "^0.5.0",
-		"@atlaskit/popup": "^4.20.0",
+		"@atlaskit/popup": "^4.21.0",
 		"@atlaskit/primitives": "^19.0.0",
-		"@atlaskit/react-ufo": "^6.0.0",
+		"@atlaskit/react-ufo": "^6.1.0",
 		"@atlaskit/rovo-triggers": "^6.3.0",
 		"@atlaskit/section-message": "^8.13.0",
 		"@atlaskit/select": "^21.12.0",
 		"@atlaskit/spinner": "^19.1.0",
-		"@atlaskit/tag": "^14.13.0",
+		"@atlaskit/tag": "^14.14.0",
 		"@atlaskit/textarea": "^8.3.0",
 		"@atlaskit/textfield": "^8.3.0",
-		"@atlaskit/theme": "^24.0.0",
+		"@atlaskit/theme": "^25.0.0",
 		"@atlaskit/tile": "^1.1.0",
-		"@atlaskit/tmp-editor-statsig": "^82.4.0",
+		"@atlaskit/tmp-editor-statsig": "^83.0.0",
 		"@atlaskit/tokens": "^13.0.0",
-		"@atlaskit/tooltip": "^22.2.0",
+		"@atlaskit/tooltip": "^22.3.0",
 		"@atlaskit/ufo": "^0.5.0",
 		"@atlaskit/width-detector": "^5.1.0",
 		"@babel/runtime": "^7.0.0",
@@ -116,7 +116,7 @@
 		"@af/visual-regression": "workspace:^",
 		"@atlaskit/analytics-listeners": "^10.1.0",
 		"@atlaskit/css-reset": "^7.4.0",
-		"@atlaskit/media-test-helpers": "^41.1.0",
+		"@atlaskit/media-test-helpers": "^41.2.0",
 		"@atlaskit/ssr": "workspace:^",
 		"@atlassian/a11y-jest-testing": "^0.11.0",
 		"@atlassian/analytics-tooling": "workspace:^",

package/smart-card.docs.tsx

@@ -5,347 +5,349 @@
 
 import path from 'path';
 
-import type { ComponentStructuredContentSource } from '@atlassian/structured-docs-types';
+import type { StructuredContentSource } from '@atlassian/structured-docs-types/types';
 
 import packageJson from './package.json';
 
 const packagePath = path.resolve(__dirname);
 
-const documentation: ComponentStructuredContentSource[] = [
-	{
-		name: 'Card',
-		description:
-			'Smart Links enhance URLs into interactive previews, offering a contextualized experience within Atlassian products. They come in inline, block, and embed formats, respecting content permissions and compliance settings.',
-		status: 'general-availability',
-		import: {
+const documentation: StructuredContentSource = {
+	components: [
+		{
 			name: 'Card',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
-		},
-		usageGuidelines: [
-			'Use inline for links in body text; block when you need extra context or a card-style preview; embed when users should engage with the linked content in place.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Use descriptive link text for inline appearance; avoid generic "click here" or the raw URL when possible.',
-			'Ensure the card container is keyboard focusable and has a clear accessible name indicating it is a link or preview.',
-			'Ensure loading and error states are announced to screen readers (e.g. aria-live or status text).',
-		],
-		keywords: ['smart-card', 'card', 'smart link', 'inline', 'block', 'embed', 'link', 'preview'],
-		categories: ['linking', 'data-display'],
-		examples: [
-			{
-				name: 'Card (basic)',
-				description:
-					'Inline, block, and embed appearances shown side by side. Requires staging login to resolve links.',
-				source: path.resolve(packagePath, './examples/content/card.tsx'),
-			},
-			{
-				name: 'Card (appearance: block)',
-				description:
-					'Block appearance — card-style preview with detailed view of the linked material. In the editor this is referred to as the "Card".',
-				source: path.resolve(packagePath, './examples/content/block-card.tsx'),
-			},
-			{
-				name: 'Card (appearance: inline)',
-				description:
-					'Inline appearance — link in text like a hyperlink. Use showHoverPreview for hover preview on inline Smart Links.',
-				source: path.resolve(packagePath, './examples/content/inline-card.tsx'),
+			description:
+				'Smart Links enhance URLs into interactive previews, offering a contextualized experience within Atlassian products. They come in inline, block, and embed formats, respecting content permissions and compliance settings.',
+			status: 'general-availability',
+			import: {
+				name: 'Card',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-			{
-				name: 'Card (appearance: embed)',
-				description:
-					'Embed appearance — linked content rendered in place. Requires a resolvable embed URL; not all links support embed.',
-				source: path.resolve(packagePath, './examples/content/embed-card.tsx'),
-			},
-		],
-	},
-	{
-		name: 'HoverCard',
-		description:
-			'Hover cards can be used as a standalone component to wrap any React component and display information about a supplied URL when the user hovers over the child. Different actions are shown depending on the resource type.',
-		status: 'general-availability',
-		import: {
-			name: 'HoverCard',
-			package: '@atlaskit/smart-card/hover-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use inline for links in body text; block when you need extra context or a card-style preview; embed when users should engage with the linked content in place.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Use descriptive link text for inline appearance; avoid generic "click here" or the raw URL when possible.',
+				'Ensure the card container is keyboard focusable and has a clear accessible name indicating it is a link or preview.',
+				'Ensure loading and error states are announced to screen readers (e.g. aria-live or status text).',
+			],
+			keywords: ['smart-card', 'card', 'smart link', 'inline', 'block', 'embed', 'link', 'preview'],
+			categories: ['linking', 'data-display'],
+			examples: [
+				{
+					name: 'Card (basic)',
+					description:
+						'Inline, block, and embed appearances shown side by side. Requires staging login to resolve links.',
+					source: path.resolve(packagePath, './examples/content/card.tsx'),
+				},
+				{
+					name: 'Card (appearance: block)',
+					description:
+						'Block appearance — card-style preview with detailed view of the linked material. In the editor this is referred to as the "Card".',
+					source: path.resolve(packagePath, './examples/content/block-card.tsx'),
+				},
+				{
+					name: 'Card (appearance: inline)',
+					description:
+						'Inline appearance — link in text like a hyperlink. Use showHoverPreview for hover preview on inline Smart Links.',
+					source: path.resolve(packagePath, './examples/content/inline-card.tsx'),
+				},
+				{
+					name: 'Card (appearance: embed)',
+					description:
+						'Embed appearance — linked content rendered in place. Requires a resolvable embed URL; not all links support embed.',
+					source: path.resolve(packagePath, './examples/content/embed-card.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when you need a Smart Link preview on hover over a custom trigger (e.g. text, icon). For hover preview on inline Smart Links in body text, use Card with showHoverPreview instead.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Provide a keyboard-accessible way to open the preview (e.g. focus or explicit trigger); do not rely on hover alone.',
-			'Ensure the trigger element has an accessible name and role (e.g. link or button).',
-			'Ensure the hover card content is announced when shown (e.g. aria-describedby or live region) and can be dismissed via keyboard.',
-		],
-		keywords: ['smart-card', 'hover card', 'hover', 'preview', 'smart link'],
-		categories: ['linking', 'data-display', 'interaction'],
-		examples: [
-			{
-				name: 'Hover card',
-				description:
-					'HoverCard wrapping a trigger element; shows Smart Link preview on hover. Requires staging login to resolve.',
-				source: path.resolve(packagePath, './examples/content/hover-card.tsx'),
+		{
+			name: 'HoverCard',
+			description:
+				'Hover cards can be used as a standalone component to wrap any React component and display information about a supplied URL when the user hovers over the child. Different actions are shown depending on the resource type.',
+			status: 'general-availability',
+			import: {
+				name: 'HoverCard',
+				package: '@atlaskit/smart-card/hover-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'LinkUrl',
-		description:
-			'LinkUrl is a plain hyperlink (<a>) with a built-in safety check. Use it when you want to warn users if the link description looks like one URL but the actual destination is different.',
-		status: 'general-availability',
-		import: {
-			name: 'LinkUrl',
-			package: '@atlaskit/smart-card/link-url',
-			type: 'default',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when you need a Smart Link preview on hover over a custom trigger (e.g. text, icon). For hover preview on inline Smart Links in body text, use Card with showHoverPreview instead.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Provide a keyboard-accessible way to open the preview (e.g. focus or explicit trigger); do not rely on hover alone.',
+				'Ensure the trigger element has an accessible name and role (e.g. link or button).',
+				'Ensure the hover card content is announced when shown (e.g. aria-describedby or live region) and can be dismissed via keyboard.',
+			],
+			keywords: ['smart-card', 'hover card', 'hover', 'preview', 'smart link'],
+			categories: ['linking', 'data-display', 'interaction'],
+			examples: [
+				{
+					name: 'Hover card',
+					description:
+						'HoverCard wrapping a trigger element; shows Smart Link preview on hover. Requires staging login to resolve.',
+					source: path.resolve(packagePath, './examples/content/hover-card.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when the link text might look like one URL but point elsewhere—e.g. user-generated or external links—so users get a warning before navigating.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Use descriptive link text that indicates the destination or action; avoid exposing only the URL when possible.',
-			'Ensure the safety-check warning (when link text and destination differ) is announced to screen readers.',
-		],
-		keywords: ['smart-card', 'link', 'url', 'safety', 'hyperlink'],
-		categories: ['linking', 'interaction'],
-		examples: [
-			{
-				name: 'Link URL',
-				description:
-					'Link safety: when link text looks like a URL but destination differs (warning) vs when text matches or is plain (no warning).',
-				source: path.resolve(packagePath, './examples/content/link-url.tsx'),
+		{
+			name: 'LinkUrl',
+			description:
+				'LinkUrl is a plain hyperlink (<a>) with a built-in safety check. Use it when you want to warn users if the link description looks like one URL but the actual destination is different.',
+			status: 'general-availability',
+			import: {
+				name: 'LinkUrl',
+				package: '@atlaskit/smart-card/link-url',
+				type: 'default',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'FlexibleCard',
-		description:
-			'Flexible Smart Links (FlexibleCard / Flexible UI) is a composable system of data elements inside UI blocks for building custom Smart Link views. It does not affect inline, block, or embed appearance.',
-		status: 'general-availability',
-		import: {
-			name: 'TitleBlock',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when the link text might look like one URL but point elsewhere—e.g. user-generated or external links—so users get a warning before navigating.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Use descriptive link text that indicates the destination or action; avoid exposing only the URL when possible.',
+				'Ensure the safety-check warning (when link text and destination differ) is announced to screen readers.',
+			],
+			keywords: ['smart-card', 'link', 'url', 'safety', 'hyperlink'],
+			categories: ['linking', 'interaction'],
+			examples: [
+				{
+					name: 'Link URL',
+					description:
+						'Link safety: when link text looks like a URL but destination differs (warning) vs when text matches or is plain (no warning).',
+					source: path.resolve(packagePath, './examples/content/link-url.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when you need a custom block-style Smart Link layout. Define the layout with blocks first (title, metadata, preview, footer), then add elements inside blocks for granular content.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Use a logical structure (e.g. heading hierarchy) so the card is navigable by assistive tech.',
-			'Ensure all interactive elements inside blocks (links, buttons, actions) are focusable and have accessible names.',
-		],
-		keywords: [
-			'smart-card',
-			'flexible',
-			'flexible card',
-			'flexible ui',
-			'blocks',
-			'elements',
-			'composable',
-		],
-		categories: ['linking', 'data-display'],
-		examples: [
-			{
-				name: 'Flexible UI card',
-				description:
-					'Custom block layout with TitleBlock, PreviewBlock, MetadataBlock, SnippetBlock, and FooterBlock composed inside Card.',
-				source: path.resolve(packagePath, './examples/content/flexible-ui-card.tsx'),
+		{
+			name: 'FlexibleCard',
+			description:
+				'Flexible Smart Links (FlexibleCard / Flexible UI) is a composable system of data elements inside UI blocks for building custom Smart Link views. It does not affect inline, block, or embed appearance.',
+			status: 'general-availability',
+			import: {
+				name: 'TitleBlock',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'TitleBlock',
-		description:
-			'A block component for the Smart Link title row. Used inside FlexibleCard to show title, icon, and optional metadata and actions.',
-		status: 'general-availability',
-		import: {
-			name: 'TitleBlock',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when you need a custom block-style Smart Link layout. Define the layout with blocks first (title, metadata, preview, footer), then add elements inside blocks for granular content.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Use a logical structure (e.g. heading hierarchy) so the card is navigable by assistive tech.',
+				'Ensure all interactive elements inside blocks (links, buttons, actions) are focusable and have accessible names.',
+			],
+			keywords: [
+				'smart-card',
+				'flexible',
+				'flexible card',
+				'flexible ui',
+				'blocks',
+				'elements',
+				'composable',
+			],
+			categories: ['linking', 'data-display'],
+			examples: [
+				{
+					name: 'Flexible UI card',
+					description:
+						'Custom block layout with TitleBlock, PreviewBlock, MetadataBlock, SnippetBlock, and FooterBlock composed inside Card.',
+					source: path.resolve(packagePath, './examples/content/flexible-ui-card.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use for the main title row of a block Smart Link when you need title, icon, optional subtitle, metadata, or actions in one row.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Ensure the title is exposed as a heading or has an accessible name so it is announced as the primary label for the card.',
-			'If the title row icon conveys meaning, give it an accessible name (e.g. aria-label); otherwise mark as decorative.',
-		],
-		keywords: ['smart-card', 'title block', 'flexible', 'block'],
-		categories: ['linking', 'data-display'],
-		examples: [
-			{
-				name: 'Title block default',
-				description:
-					'TitleBlock with default props; title and icon come from the resolved link data.',
-				source: path.resolve(packagePath, './examples/content/title-block-default.tsx'),
+		{
+			name: 'TitleBlock',
+			description:
+				'A block component for the Smart Link title row. Used inside FlexibleCard to show title, icon, and optional metadata and actions.',
+			status: 'general-availability',
+			import: {
+				name: 'TitleBlock',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'MetadataBlock',
-		description:
-			'A block component that displays a row of metadata elements (e.g. created by, due date, state) in a Smart Link.',
-		status: 'general-availability',
-		import: {
-			name: 'MetadataBlock',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use for the main title row of a block Smart Link when you need title, icon, optional subtitle, metadata, or actions in one row.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Ensure the title is exposed as a heading or has an accessible name so it is announced as the primary label for the card.',
+				'If the title row icon conveys meaning, give it an accessible name (e.g. aria-label); otherwise mark as decorative.',
+			],
+			keywords: ['smart-card', 'title block', 'flexible', 'block'],
+			categories: ['linking', 'data-display'],
+			examples: [
+				{
+					name: 'Title block default',
+					description:
+						'TitleBlock with default props; title and icon come from the resolved link data.',
+					source: path.resolve(packagePath, './examples/content/title-block-default.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when you need a single row of metadata (e.g. created by, due date, state) in a block Smart Link.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Ensure metadata is available to screen readers (e.g. not conveyed only by color or icon).',
-			'Use a list or group with an accessible name if the metadata row has a specific purpose (e.g. "Contributors", "Dates").',
-		],
-		keywords: ['smart-card', 'metadata block', 'flexible', 'block', 'metadata'],
-		categories: ['linking', 'data-display'],
-		examples: [
-			{
-				name: 'Metadata block primary',
-				description:
-					'MetadataBlock with a primary row showing CollaboratorGroup and ModifiedOn elements.',
-				source: path.resolve(packagePath, './examples/content/metadata-block-primary.tsx'),
+		{
+			name: 'MetadataBlock',
+			description:
+				'A block component that displays a row of metadata elements (e.g. created by, due date, state) in a Smart Link.',
+			status: 'general-availability',
+			import: {
+				name: 'MetadataBlock',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'PreviewBlock',
-		description: 'A block component that displays a preview image or media for the Smart Link.',
-		status: 'general-availability',
-		import: {
-			name: 'PreviewBlock',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when you need a single row of metadata (e.g. created by, due date, state) in a block Smart Link.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Ensure metadata is available to screen readers (e.g. not conveyed only by color or icon).',
+				'Use a list or group with an accessible name if the metadata row has a specific purpose (e.g. "Contributors", "Dates").',
+			],
+			keywords: ['smart-card', 'metadata block', 'flexible', 'block', 'metadata'],
+			categories: ['linking', 'data-display'],
+			examples: [
+				{
+					name: 'Metadata block primary',
+					description:
+						'MetadataBlock with a primary row showing CollaboratorGroup and ModifiedOn elements.',
+					source: path.resolve(packagePath, './examples/content/metadata-block-primary.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when the linked resource has a preview image or media and you want to surface it in the block card.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'If the preview image conveys information, provide meaningful alt text; if purely decorative, use alt="" or aria-hidden.',
-			'Ensure no critical information is shown only in the preview; duplicate in text or metadata when needed.',
-		],
-		keywords: ['smart-card', 'preview block', 'flexible', 'block', 'preview', 'image'],
-		categories: ['linking', 'data-display'],
-		examples: [
-			{
-				name: 'Preview block default',
-				description: "PreviewBlock showing the resolved link's preview image when available.",
-				source: path.resolve(packagePath, './examples/content/preview-block-default.tsx'),
+		{
+			name: 'PreviewBlock',
+			description: 'A block component that displays a preview image or media for the Smart Link.',
+			status: 'general-availability',
+			import: {
+				name: 'PreviewBlock',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'FooterBlock',
-		description:
-			'A block component for the Smart Link footer, typically showing actions (e.g. copy, open, follow).',
-		status: 'general-availability',
-		import: {
-			name: 'FooterBlock',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when the linked resource has a preview image or media and you want to surface it in the block card.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'If the preview image conveys information, provide meaningful alt text; if purely decorative, use alt="" or aria-hidden.',
+				'Ensure no critical information is shown only in the preview; duplicate in text or metadata when needed.',
+			],
+			keywords: ['smart-card', 'preview block', 'flexible', 'block', 'preview', 'image'],
+			categories: ['linking', 'data-display'],
+			examples: [
+				{
+					name: 'Preview block default',
+					description: "PreviewBlock showing the resolved link's preview image when available.",
+					source: path.resolve(packagePath, './examples/content/preview-block-default.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use at the bottom of a FlexibleCard when you need actions such as copy link, open, or follow.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Give each action button or control an accessible name (e.g. "Copy link", "Open in new tab") so purpose is clear to screen readers.',
-			'Ensure actions are keyboard operable and appear in a logical tab order.',
-		],
-		keywords: ['smart-card', 'footer block', 'flexible', 'block', 'actions'],
-		categories: ['linking', 'data-display', 'interaction'],
-		examples: [
-			{
-				name: 'Footer block default',
-				description:
-					'FooterBlock with default actions (e.g. copy, open, follow) at the bottom of the card.',
-				source: path.resolve(packagePath, './examples/content/footer-block-default.tsx'),
+		{
+			name: 'FooterBlock',
+			description:
+				'A block component for the Smart Link footer, typically showing actions (e.g. copy, open, follow).',
+			status: 'general-availability',
+			import: {
+				name: 'FooterBlock',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'useSmartLinkEvents',
-		description:
-			'Hook that returns a SmartLinkEvents object for dispatching analytics events for a given URL. Currently supports insertSmartLink.',
-		status: 'general-availability',
-		import: {
-			name: 'useSmartLinkEvents',
-			package: '@atlaskit/smart-card',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use at the bottom of a FlexibleCard when you need actions such as copy link, open, or follow.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Give each action button or control an accessible name (e.g. "Copy link", "Open in new tab") so purpose is clear to screen readers.',
+				'Ensure actions are keyboard operable and appear in a logical tab order.',
+			],
+			keywords: ['smart-card', 'footer block', 'flexible', 'block', 'actions'],
+			categories: ['linking', 'data-display', 'interaction'],
+			examples: [
+				{
+					name: 'Footer block default',
+					description:
+						'FooterBlock with default actions (e.g. copy, open, follow) at the bottom of the card.',
+					source: path.resolve(packagePath, './examples/content/footer-block-default.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when you need to fire Smart Link analytics (e.g. insert events) from custom UI that is not the default Card.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'Use analytics events to understand usage; ensure event wiring does not change focus, interrupt screen readers, or alter semantics.',
-		],
-		keywords: ['smart-card', 'hooks', 'analytics', 'useSmartLinkEvents', 'events'],
-		categories: ['linking', 'analytics'],
-		examples: [
-			{
-				name: 'Analytics',
-				description:
-					'Card with AnalyticsListener capturing and displaying Smart Link analytics events (e.g. on click).',
-				source: path.resolve(packagePath, './examples/content/analytics.tsx'),
+		{
+			name: 'useSmartLinkEvents',
+			description:
+				'Hook that returns a SmartLinkEvents object for dispatching analytics events for a given URL. Currently supports insertSmartLink.',
+			status: 'general-availability',
+			import: {
+				name: 'useSmartLinkEvents',
+				package: '@atlaskit/smart-card',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-	{
-		name: 'useSmartLinkActions',
-		description:
-			'Hook that extracts and returns actions for a given URL. Relies on Smart Link context; usages must be wrapped in SmartCardProvider or equivalent.',
-		status: 'general-availability',
-		import: {
-			name: 'useSmartLinkActions',
-			package: '@atlaskit/smart-card/hooks',
-			type: 'named',
-			packagePath,
-			packageJson,
+			usageGuidelines: [
+				'Use when you need to fire Smart Link analytics (e.g. insert events) from custom UI that is not the default Card.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'Use analytics events to understand usage; ensure event wiring does not change focus, interrupt screen readers, or alter semantics.',
+			],
+			keywords: ['smart-card', 'hooks', 'analytics', 'useSmartLinkEvents', 'events'],
+			categories: ['linking', 'analytics'],
+			examples: [
+				{
+					name: 'Analytics',
+					description:
+						'Card with AnalyticsListener capturing and displaying Smart Link analytics events (e.g. on click).',
+					source: path.resolve(packagePath, './examples/content/analytics.tsx'),
+				},
+			],
 		},
-		usageGuidelines: [
-			'Use when building custom action UI (buttons, menus) that should expose Smart Link actions (e.g. Preview, Open) for a given URL.',
-		],
-		contentGuidelines: [],
-		accessibilityGuidelines: [
-			'When rendering actions from this hook (e.g. buttons or menus), provide accessible labels (e.g. from action.text) and ensure keyboard support.',
-		],
-		keywords: ['smart-card', 'hooks', 'useSmartLinkActions', 'actions'],
-		categories: ['linking', 'interaction'],
-		examples: [
-			{
+		{
+			name: 'useSmartLinkActions',
+			description:
+				'Hook that extracts and returns actions for a given URL. Relies on Smart Link context; usages must be wrapped in SmartCardProvider or equivalent.',
+			status: 'general-availability',
+			import: {
 				name: 'useSmartLinkActions',
-				description:
-					'useSmartLinkActions used to get actions for a URL and invoke one (e.g. Preview) from a custom button.',
-				source: path.resolve(packagePath, './examples/content/useSmartLinkActions.tsx'),
+				package: '@atlaskit/smart-card/hooks',
+				type: 'named',
+				packagePath,
+				packageJson,
 			},
-		],
-	},
-];
+			usageGuidelines: [
+				'Use when building custom action UI (buttons, menus) that should expose Smart Link actions (e.g. Preview, Open) for a given URL.',
+			],
+			contentGuidelines: [],
+			accessibilityGuidelines: [
+				'When rendering actions from this hook (e.g. buttons or menus), provide accessible labels (e.g. from action.text) and ensure keyboard support.',
+			],
+			keywords: ['smart-card', 'hooks', 'useSmartLinkActions', 'actions'],
+			categories: ['linking', 'interaction'],
+			examples: [
+				{
+					name: 'useSmartLinkActions',
+					description:
+						'useSmartLinkActions used to get actions for a URL and invoke one (e.g. Preview) from a custom button.',
+					source: path.resolve(packagePath, './examples/content/useSmartLinkActions.tsx'),
+				},
+			],
+		},
+	],
+};
 
 export default documentation;