@atlaskit/react-ufo 2.5.2 → 2.6.0

package/dist/types/interaction-context/index.d.ts

@@ -27,6 +27,7 @@ export interface UFOInteractionContextType extends InteractionContextType {
         startTime?: number;
         stopTime: number;
     }): void;
+    holdExperimental?(name: string): void | (() => void);
 }
 declare const _default: Context<UFOInteractionContextType | null>;
 export default _default;

package/dist/types/interaction-metrics/common/constants.d.ts

@@ -1,3 +1,32 @@
-import type { InteractionMetrics } from '../../common';
-declare const interactions: Map<string, InteractionMetrics>;
-export default interactions;
+import type { InteractionMetrics, SegmentInfo } from '../../common';
+import type { FeatureFlagValue } from '../../feature-flags-accessed';
+export declare const interactions: Map<string, InteractionMetrics>;
+export declare const CLEANUP_TIMEOUT: number;
+export declare const CLEANUP_TIMEOUT_AFTER_APDEX: number;
+export type SegmentObserver = {
+    onAdd: (segment: SegmentInfo) => void;
+    onRemove: (segment: SegmentInfo) => void;
+};
+export declare const interactionQueue: {
+    id: string;
+    data: InteractionMetrics;
+}[];
+export declare const segmentCache: Map<string, SegmentInfo>;
+export declare const segmentObservers: SegmentObserver[];
+export declare const moduleLoadingRequests: Record<string, {
+    start: number;
+    timeoutId: ReturnType<typeof setTimeout> | number | undefined;
+}>;
+declare global {
+    interface Window {
+        __REACT_UFO_ENABLE_PERF_TRACING?: boolean;
+        __UFO_COMPACT_PAYLOAD__?: boolean;
+        __CRITERION__?: {
+            addFeatureFlagAccessed?: (flagName: string, flagValue: FeatureFlagValue) => void;
+            addUFOHold?: (id: string, name: string, labelStack: string, startTime: number) => void;
+            removeUFOHold?: (id: string) => void;
+            getFeatureFlagOverride?: (flagName: string) => boolean | undefined;
+            getExperimentValueOverride?: <T>(experimentName: string, parameterName: string) => T;
+        };
+    }
+}

package/dist/types/interaction-metrics/common/index.d.ts

@@ -0,0 +1,16 @@
+import type { InteractionMetrics } from '../../common';
+import type { LabelStack, SegmentLabel } from '../../interaction-context';
+import { type SegmentObserver } from './constants';
+export declare function isPerformanceTracingEnabled(): boolean;
+export declare function labelStackToString(labelStack: LabelStack | null | undefined, name?: string): string;
+export declare function labelStackToIdString(labelStack: LabelStack | null | undefined): string | undefined;
+export declare function addSegmentObserver(observer: SegmentObserver): void;
+export declare function removeSegmentObserver(observer: SegmentObserver): void;
+export declare function addHoldCriterion(id: string, labelStack: LabelStack, name: string, startTime: number): void;
+export declare function removeHoldCriterion(id: string): void;
+export declare const pushToQueue: (id: string, data: InteractionMetrics) => void;
+export declare function callCleanUpCallbacks(interaction: InteractionMetrics): void;
+export declare function reactProfilerTimingMap(data: InteractionMetrics): void;
+export declare function callCancelCallbacks(interaction: InteractionMetrics): void;
+export declare function isSegmentLabel(obj: any): obj is SegmentLabel;
+export declare function getSegmentCacheKey(labelStack: LabelStack): string;

package/dist/types/interaction-metrics/index.d.ts

@@ -1,10 +1,7 @@
 import type { AbortReasonType, ApdexType, BM3Event, CustomData, CustomTiming, InteractionError, InteractionMetrics, InteractionType, LifecycleMarkType, LoadProfilerEventInfo, Mark, MarkType, PostInteractionLogOutput, ReactProfilerTiming, RequestInfo, Span, SpanType } from '../common';
 import { type TraceIdContext } from '../experience-trace-id-context';
-import { type FeatureFlagValue } from '../feature-flags-accessed';
 import type { LabelStack } from '../interaction-context';
-import PostInteractionLog from './post-interaction-log';
 export type { InteractionMetrics, LifecycleMarkType, Span, Mark, MarkType, InteractionType, AbortReasonType, ReactProfilerTiming, RequestInfo, ApdexType, CustomData, CustomTiming, InteractionError, };
-export declare const postInteractionLog: PostInteractionLog;
 export declare function getActiveInteraction(): InteractionMetrics | undefined;
 export declare function remove(interactionId: string): void;
 export declare function updatePageLoadInteractionName(ufoName: string, routeName?: string | null | undefined): void;
@@ -18,7 +15,7 @@ export declare function addSpanToAll(type: SpanType, name: string, labelStack: L
 export declare function addPreload(moduleId: string, timestamp: number): void;
 export declare function addLoad(identifier: string, start: number, end: number): void;
 export declare function extractModuleName(input: string): string;
-export declare function addHold(interactionId: string, labelStack: LabelStack, name: string): () => void;
+export declare function addHold(interactionId: string, labelStack: LabelStack, name: string, experimental: boolean): () => void;
 export declare function addHoldByID(interactionId: string, labelStack: LabelStack, name: string, id: string, ignoreOnSubmit?: boolean): () => void;
 export declare function removeHoldByID(interactionId: string, id: string): void;
 export declare function getCurrentInteractionType(interactionId: string): InteractionType | null;
@@ -52,18 +49,5 @@ export declare function addRequestInfo(interactionId: string, labelStack: LabelS
 export declare function addSegment(labelStack: LabelStack): void;
 export declare function removeSegment(labelStack: LabelStack): void;
 export declare function addRedirect(interactionId: string, fromUfoName: string, nextUfoName: string, nextRouteName: string, time: number): void;
-declare global {
-    interface Window {
-        __REACT_UFO_ENABLE_PERF_TRACING?: boolean;
-        __UFO_COMPACT_PAYLOAD__?: boolean;
-        __CRITERION__?: {
-            addFeatureFlagAccessed?: (flagName: string, flagValue: FeatureFlagValue) => void;
-            addUFOHold?: (id: string, name: string, labelStack: string, startTime: number) => void;
-            removeUFOHold?: (id: string) => void;
-            getFeatureFlagOverride?: (flagName: string) => boolean | undefined;
-            getExperimentValueOverride?: <T>(experimentName: string, parameterName: string) => T;
-        };
-    }
-}
 export declare const interactionSpans: Span[];
 export declare function addCustomSpans(name: string, start: number, end?: number, size?: number, labelStack?: LabelStack): void;

package/dist/types/load-hold/UFOLoadHold.d.ts

@@ -19,8 +19,7 @@ import { type ReactNode } from 'react';
  *   return (
  *     <>
  *       <Skeleton />
- *       <UFOLoadHold name="card">
- *     </UFOLoadHold>
+ *       <UFOLoadHold name="card" />
  *   )
  * }
  * ```

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

@@ -63,7 +63,7 @@ export interface SegmentInfo {
     labelStack: LabelStack;
 }
 export interface CustomData {
-    [key: string]: null | undefined | string | number | boolean | undefined | CustomData | Record<string, CustomData>;
+    [key: string]: null | string | number | boolean | undefined | CustomData | Record<string, CustomData>;
 }
 export type CustomTiming = Record<string, {
     startTime: number;
@@ -104,7 +104,9 @@ export interface InteractionMetrics {
         labelStack: LabelStack;
     })[];
     holdInfo: HoldInfo[];
+    holdExpInfo: HoldInfo[];
     holdActive: Map<string, HoldActive>;
+    holdExpActive: Map<string, HoldActive>;
     reactProfilerTimings: ReactProfilerTiming[];
     measureStart: number;
     rate: number;
@@ -115,11 +117,11 @@ export interface InteractionMetrics {
     abortReason?: AbortReasonType;
     abortedByInteractionName?: string;
     /**
-     * Apdex is legacy performance measurement where it is
+     * Apdex is a legacy performance measurement where it is
      * capturing TTI at arbitrary point in the code (bm3/UFOv1)
      *
      * We are intercepting its values now just so we can use it for
-     * topline metric, but should encourage teams adopt TTAI
+     * topline metric, but should encourage teams to adopt TTAI
      *
      * This field might be ignored/dropped in the future.
      */
@@ -164,7 +166,7 @@ export interface LazyLoadProfilerContext {
     addLoad(identifier: string, start: number, end: number): void;
 }
 export interface EnhancedUFOInteractionContextType extends UFOInteractionContextType, RelayMetricsRecorder, LazyLoadProfilerContext {
-    _internalHold(labelStack: LabelStack, name: string): void | (() => void);
+    _internalHold(labelStack: LabelStack, name: string, experimental?: boolean): void | (() => void);
     _internalHoldByID(labelStack: LabelStack, id: string, name: string, remove: boolean): void | (() => void);
     addHoldByID(labelStack: LabelStack, id: string, name?: string): void;
     removeHoldByID(labelStack: LabelStack, id: string, name?: string): void;

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

@@ -72,6 +72,11 @@ export type Config = {
         readonly rates?: Rates;
         readonly kind?: Record<InteractionType, number>;
     };
+    readonly experimentalInteractionMetrics?: {
+        readonly enabled?: boolean;
+        readonly rates?: Rates;
+        readonly kind?: Record<InteractionType, number>;
+    };
     readonly enableSegmentHighlighting?: boolean;
     readonly enableAdditionalPerformanceMarks?: boolean;
     readonly shouldCalculateLighthouseMetricsFromTTAI?: boolean;
@@ -85,6 +90,7 @@ export type Config = {
 export declare function setUFOConfig(newConfig: Config): void;
 export declare function getConfig(): Config | undefined;
 export declare function getInteractionRate(name: string, interactionKind: InteractionKind): number;
+export declare function getExperimentalInteractionRate(name: string, interactionType: InteractionType): number;
 export declare function getPostInteractionRate(name: string, interactionType: InteractionType): number;
 export declare function getCapabilityRate(capability: Capability): number;
 declare const validTypingMethods: readonly [

package/dist/types-ts4.5/create-experimental-interaction-metrics-payload/index.d.ts

@@ -0,0 +1,16 @@
+import type { InteractionMetrics } from '../common';
+import { VCObserver, type VCObserverOptions } from '../vc/vc-observer';
+type InteractionMetricsHandler = (interactionId: string, interaction: InteractionMetrics) => void | Promise<void>;
+export declare function installInteractionSink(handler: InteractionMetricsHandler): void;
+export declare function sinkExperimentalHandler(sinkFn: (interactionId: string, interaction: InteractionMetrics) => void | Promise<void>): void;
+export declare function onExperimentalInteractionComplete(interactionId: string, data: InteractionMetrics, endTime?: number): void;
+export declare class ExperimentalVCMetrics {
+    vcObserver: VCObserver | null;
+    initialize(options: VCObserverOptions): this;
+    start({ startTime }: {
+        startTime: number;
+    }): void;
+}
+export declare const experimentalVC: ExperimentalVCMetrics;
+export declare const getExperimentalVCMetrics: (interaction: InteractionMetrics) => any;
+export {};

package/dist/types-ts4.5/create-payload/common/utils/index.d.ts

@@ -1,4 +1,8 @@
+import type { InteractionMetrics } from '../../../common';
+import { type Config } from '../../../config';
 import type { LabelStack, SegmentLabel } from '../../../interaction-context';
+import PostInteractionLog from '../../../interaction-metrics/post-interaction-log';
+export declare const postInteractionLog: PostInteractionLog;
 export type SegmentItem = {
     n: string;
     c?: Record<string, SegmentItem>;
@@ -15,3 +19,8 @@ export declare function optimizeLabelStack(labelStack: LabelStack): string | {
     s?: string | undefined;
     n: string;
 }[];
+export declare const getPageVisibilityUpToTTAI: (interaction: InteractionMetrics) => import("../../../hidden-timing").PageVisibility;
+export declare const calculateVCMetrics: (interaction: InteractionMetrics, prefix: string, getVCResultFn: (props: any) => any) => any;
+export declare function getSSRDoneTimeValue(config: Config | undefined): number | undefined;
+export declare const getVCMetrics: (interaction: InteractionMetrics) => any;
+export declare const getTTAI: (interaction: InteractionMetrics) => number | undefined;