@atlaskit/media-card 79.11.4 → 79.13.0

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

@@ -5,8 +5,10 @@ import { type MediaCardErrorInfo } from '../../utils/analytics';
 import { type MediaCardSsr } from './types';
 export declare const GLOBAL_MEDIA_CARD_SSR = "mediaCardSsr";
 export declare const GLOBAL_MEDIA_NAMESPACE = "__MEDIA_INTERNAL";
+export declare const GLOBAL_MEDIA_PERFORMANCE_ENTRIES = "performanceEntries";
 export type MediaGlobalScope = {
     [GLOBAL_MEDIA_CARD_SSR]?: MediaCardSsr;
+    [GLOBAL_MEDIA_PERFORMANCE_ENTRIES]?: PerformanceEntry[];
 };
 export declare function getMediaGlobalScope(globalScope?: any): MediaGlobalScope;
 export declare function getMediaCardSSR(globalScope?: any): MediaCardSsr;

package/dist/types-ts4.5/utils/mediaPerformanceObserver/durationMetrics.d.ts

@@ -36,6 +36,7 @@ export declare const createMediaDurationMetrics: (entry: ExperimentalPerformance
     decodedBodySize: number;
     totalDuration: number;
     initiatorType: string;
+    endedAt: number;
     responseEnd: number;
     browserCacheHit: boolean;
     nextHopProtocol: string;

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

@@ -1,15 +1,98 @@
 import { type CardStatus } from '../types';
 import { type FileAttributes } from '@atlaskit/media-common';
-import { type SSRStatus } from './analytics';
+import { type MediaCardErrorInfo, type SSRStatus } from './analytics';
 import { MediaCardError } from '../errors';
+import { type RequestMetadata } from '@atlaskit/media-client';
 import { type FileStateFlags } from '../types';
+/**
+ * Determines if performance events should be sampled for this instance.
+ * Approximately 5% of instances will be sampled.
+ */
+export declare const shouldPerformanceBeSampled: () => boolean;
+export type SSRPreviewInfo = {
+    /** The srcset of the SSR preview (used to match performance entries) */
+    srcset?: string;
+    /** The full URI of the SSR preview (used to match performance entries) */
+    dataUri?: string;
+    /** Whether SSR was attempted (ssr prop was provided) */
+    wasSSRAttempted: boolean;
+    /** Whether SSR was successful (server or client status is 'success') */
+    wasSSRSuccessful: boolean;
+};
 type SucceedUfoPayload = {
     fileAttributes: FileAttributes;
     ssrReliability: SSRStatus;
     fileStateFlags: FileStateFlags;
 };
-export declare const shouldPerformanceBeSampled: () => boolean;
-export declare const startUfoExperience: (id: string) => void;
-export declare const completeUfoExperience: (id: string, status: CardStatus, fileAttributes: FileAttributes, fileStateFlags: FileStateFlags, ssrReliability: SSRStatus, error?: MediaCardError) => void;
+type FailedProcessingPayload = {
+    fileAttributes: FileAttributes;
+    ssrReliability: SSRStatus;
+    failReason: 'failed-processing';
+    fileStateFlags: FileStateFlags;
+};
+type ErrorUfoPayload = {
+    fileAttributes: FileAttributes;
+    ssrReliability: SSRStatus;
+    request: RequestMetadata | undefined;
+    fileStateFlags: FileStateFlags;
+} & MediaCardErrorInfo;
+export interface UseMediaCardUfoExperienceOptions {
+    /** Unique identifier for this experience instance */
+    instanceId: string;
+    /** Whether to enable UFO tracking for this instance */
+    enabled: boolean;
+}
+export interface StartOptions {
+    /**
+     * When true, uses the UFO interaction start time instead of current time.
+     * Use this for SSR non-lazy scenarios where the image loading started at interaction start.
+     */
+    useInteractionTime?: boolean;
+}
+export interface MediaCardUfoExperience {
+    /**
+     * Start the UFO experience. Call when card becomes visible.
+     * @param options - Optional configuration for start behavior
+     */
+    start: (options?: StartOptions) => void;
+    /**
+     * Complete the UFO experience with appropriate timing strategy.
+     * @param status - The final card status
+     * @param fileAttributes - File metadata
+     * @param fileStateFlags - File state flags
+     * @param ssrReliability - SSR reliability status
+     * @param error - Optional error for error status
+     * @param ssrPreviewInfo - SSR preview information for timing lookup
+     */
+    complete: (status: CardStatus, fileAttributes: FileAttributes, fileStateFlags: FileStateFlags, ssrReliability: SSRStatus, error?: MediaCardError, ssrPreviewInfo?: SSRPreviewInfo) => void;
+    /** Abort the UFO experience. Call on unmount if not completed. */
+    abort: (properties?: Partial<SucceedUfoPayload>) => void;
+}
+/**
+ * Hook to create a UFO experience tied to a media card component lifecycle.
+ *
+ * This creates a unique UFOExperience instance per component, allowing:
+ * - Unique timing config per instance
+ * - Direct control over experience lifecycle
+ * - Proper cleanup on unmount
+ *
+ * @example
+ * ```tsx
+ * const ufoExperience = useMediaCardUfoExperience({
+ *   instanceId: internalOccurrenceKey,
+ *   enabled: shouldSendPerformanceEvent,
+ * });
+ *
+ * // On card visible
+ * ufoExperience.start();
+ *
+ * // On card complete/error
+ * ufoExperience.complete(status, fileAttributes, fileStateFlags, ssrReliability, error, ssrPreviewInfo);
+ * ```
+ */
+export declare const useMediaCardUfoExperience: ({ instanceId, enabled, }: UseMediaCardUfoExperienceOptions) => MediaCardUfoExperience;
+export declare const startUfoExperience: (id: string, startTime?: number) => void;
+export declare const completeUfoExperience: (id: string, status: CardStatus, fileAttributes: FileAttributes, fileStateFlags: FileStateFlags, ssrReliability: SSRStatus, error?: MediaCardError, ssrPreviewInfo?: SSRPreviewInfo) => void;
 export declare const abortUfoExperience: (id: string, properties?: Partial<SucceedUfoPayload>) => void;
-export {};
+export type { FailedProcessingPayload as _FailedProcessingPayload };
+export type { ErrorUfoPayload as _ErrorUfoPayload };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/media-card",
-	"version": "79.11.4",
+	"version": "79.13.0",
 	"description": "Includes all media card related components, CardView, CardViewSmall, Card...",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -32,24 +32,24 @@
 	},
 	"dependencies": {
 		"@atlaskit/analytics-next": "^11.1.0",
-		"@atlaskit/dropdown-menu": "^16.3.0",
+		"@atlaskit/dropdown-menu": "^16.4.0",
 		"@atlaskit/editor-shared-styles": "^3.10.0",
-		"@atlaskit/icon": "^29.3.0",
-		"@atlaskit/link": "^3.2.0",
+		"@atlaskit/icon": "^29.4.0",
+		"@atlaskit/link": "^3.3.0",
 		"@atlaskit/media-client": "^35.7.0",
 		"@atlaskit/media-client-react": "^4.1.0",
 		"@atlaskit/media-common": "^12.3.0",
 		"@atlaskit/media-file-preview": "^0.15.0",
 		"@atlaskit/media-svg": "^2.1.0",
 		"@atlaskit/media-ui": "^28.7.0",
-		"@atlaskit/media-viewer": "^52.5.0",
+		"@atlaskit/media-viewer": "^52.6.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",
 		"@atlaskit/primitives": "^17.0.0",
 		"@atlaskit/react-ufo": "^4.16.0",
 		"@atlaskit/spinner": "^19.0.0",
 		"@atlaskit/theme": "^21.0.0",
-		"@atlaskit/tokens": "^9.0.0",
-		"@atlaskit/tooltip": "^20.11.0",
+		"@atlaskit/tokens": "^9.1.0",
+		"@atlaskit/tooltip": "^20.12.0",
 		"@atlaskit/ufo": "^0.4.0",
 		"@atlaskit/visually-hidden": "^3.0.0",
 		"@babel/runtime": "^7.0.0",
@@ -71,14 +71,14 @@
 		"@af/integration-testing": "workspace:^",
 		"@atlaskit/analytics-listeners": "^9.2.0",
 		"@atlaskit/analytics-namespaced-context": "^7.2.0",
-		"@atlaskit/form": "^15.2.0",
+		"@atlaskit/form": "^15.3.0",
 		"@atlaskit/inline-message": "^15.5.0",
 		"@atlaskit/media-core": "^37.0.0",
 		"@atlaskit/media-picker": "^70.1.0",
 		"@atlaskit/media-state": "^1.8.0",
 		"@atlaskit/media-test-data": "^3.2.0",
 		"@atlaskit/media-test-helpers": "^39.0.0",
-		"@atlaskit/radio": "^8.3.0",
+		"@atlaskit/radio": "^8.4.0",
 		"@atlaskit/range": "^9.3.0",
 		"@atlaskit/ssr": "workspace:^",
 		"@atlaskit/toggle": "^15.2.0",