@atlaskit/react-ufo 5.2.6 → 5.2.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @atlaskit/ufo-interaction-ignore
 
+## 5.2.7
+
+### Patch Changes
+
+- [`a059dfab456d9`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a059dfab456d9) -
+  Add back UFO killswitch config
+
 ## 5.2.6
 
 ### Patch Changes

package/dist/cjs/config/index.js

@@ -23,6 +23,7 @@ exports.getReactHydrationStats = getReactHydrationStats;
 exports.getTypingPerformanceTracingMethod = getTypingPerformanceTracingMethod;
 exports.getUfoNameOverrides = getUfoNameOverrides;
 exports.getVCRawDataInteractionRate = getVCRawDataInteractionRate;
+exports.isUFOEnabled = isUFOEnabled;
 exports.isVCRevisionEnabled = isVCRevisionEnabled;
 exports.setUFOConfig = setUFOConfig;
 exports.shouldUseRawDataThirdPartyBehavior = shouldUseRawDataThirdPartyBehavior;
@@ -61,6 +62,25 @@ function setUFOConfig(newConfig) {
 function getConfig() {
   return config;
 }
+
+/**
+ * Check if UFO is enabled based on the config.enabled field.
+ *
+ * This function is gated behind the platform_ufo_enable_killswitch_config feature flag.
+ * When the feature flag is disabled, UFO is always considered enabled (default behavior).
+ * When the feature flag is enabled, the config.enabled field is respected.
+ *
+ * @returns true if UFO is enabled, false if disabled
+ */
+function isUFOEnabled() {
+  var _config;
+  // Only respect the config.enabled field when the killswitch feature flag is enabled
+  if (!(0, _platformFeatureFlags.fg)('platform_ufo_enable_killswitch_config')) {
+    return true;
+  }
+  // Default to enabled if config is not set or enabled is not explicitly false
+  return ((_config = config) === null || _config === void 0 ? void 0 : _config.enabled) !== false;
+}
 var isValidConfigArray = function isValidConfigArray(array) {
   return Array.isArray(array) && array.length > 0;
 };
@@ -102,8 +122,8 @@ function getReactHydrationStats() {
     return undefined;
   }
   try {
-    var _config, _config$getReactHydra;
-    var stats = (_config = config) === null || _config === void 0 || (_config$getReactHydra = _config.getReactHydrationStats) === null || _config$getReactHydra === void 0 ? void 0 : _config$getReactHydra.call(_config);
+    var _config2, _config2$getReactHydr;
+    var stats = (_config2 = config) === null || _config2 === void 0 || (_config2$getReactHydr = _config2.getReactHydrationStats) === null || _config2$getReactHydr === void 0 ? void 0 : _config2$getReactHydr.call(_config2);
     return stats !== null && stats !== void 0 ? stats : undefined;
   } catch (e) {
     // eslint-disable-next-line no-console
@@ -116,12 +136,12 @@ function getInteractionRate(name, interactionKind) {
     if (!config) {
       return 0;
     }
-    var _config2 = config,
-      killswitch = _config2.killswitch,
-      rates = _config2.rates,
-      rules = _config2.rules,
-      kind = _config2.kind,
-      autoGeneratedRate = _config2.autoGeneratedRate;
+    var _config3 = config,
+      killswitch = _config3.killswitch,
+      rates = _config3.rates,
+      rules = _config3.rules,
+      kind = _config3.kind,
+      autoGeneratedRate = _config3.autoGeneratedRate;
     if (killswitch != null) {
       // Specifically kill certain events
       if (killswitch.includes(name)) {
@@ -179,8 +199,8 @@ function getExperimentalInteractionRate(name, interactionType) {
     if (!config) {
       return 0;
     }
-    var _config3 = config,
-      experimentalInteractionMetrics = _config3.experimentalInteractionMetrics;
+    var _config4 = config,
+      experimentalInteractionMetrics = _config4.experimentalInteractionMetrics;
     if (!(experimentalInteractionMetrics !== null && experimentalInteractionMetrics !== void 0 && experimentalInteractionMetrics.enabled)) {
       return 0;
     }
@@ -215,8 +235,8 @@ function getCapabilityRate(capability) {
     if (!config) {
       return 0;
     }
-    var _config4 = config,
-      capabilityRate = _config4.capability;
+    var _config5 = config,
+      capabilityRate = _config5.capability;
     if (capabilityRate != null) {
       var rate = capabilityRate[capability];
       if (rate != null) {
@@ -261,8 +281,8 @@ function getTypingPerformanceTracingMethod() {
     if (!config) {
       return defaultMethod;
     }
-    var _config5 = config,
-      typingMethod = _config5.typingMethod;
+    var _config6 = config,
+      typingMethod = _config6.typingMethod;
     if (typingMethod != null && validTypingMethods.find(function (m) {
       return m === typingMethod;
     })) {
@@ -281,8 +301,8 @@ function getAwaitBM3TTIList() {
     if (!config) {
       return [];
     }
-    var _config6 = config,
-      awaitBM3TTI = _config6.awaitBM3TTI;
+    var _config7 = config,
+      awaitBM3TTI = _config7.awaitBM3TTI;
     if (awaitBM3TTI != null) {
       return awaitBM3TTI;
     } else {
@@ -302,8 +322,8 @@ function getUfoNameOverrides() {
     if (!config) {
       return undefined;
     }
-    var _config7 = config,
-      ufoNameOverrides = _config7.ufoNameOverrides;
+    var _config8 = config,
+      ufoNameOverrides = _config8.ufoNameOverrides;
     if (ufoNameOverrides != null) {
       return ufoNameOverrides;
     }
@@ -317,8 +337,8 @@ function getMinorInteractions() {
     if (!config) {
       return undefined;
     }
-    var _config8 = config,
-      minorInteractions = _config8.minorInteractions;
+    var _config9 = config,
+      minorInteractions = _config9.minorInteractions;
     return minorInteractions;
   } catch (_unused9) {
     return undefined;
@@ -331,8 +351,8 @@ function getDoNotAbortActivePressInteraction() {
     if (!config) {
       return undefined;
     }
-    var _config9 = config,
-      doNotAbortActivePressInteraction = _config9.doNotAbortActivePressInteraction;
+    var _config0 = config,
+      doNotAbortActivePressInteraction = _config0.doNotAbortActivePressInteraction;
     return doNotAbortActivePressInteraction;
   } catch (_unused0) {
     return undefined;
@@ -345,8 +365,8 @@ function getDoNotAbortActivePressInteractionOnTransition() {
     if (!config) {
       return undefined;
     }
-    var _config0 = config,
-      doNotAbortActivePressInteractionOnTransition = _config0.doNotAbortActivePressInteractionOnTransition;
+    var _config1 = config,
+      doNotAbortActivePressInteractionOnTransition = _config1.doNotAbortActivePressInteractionOnTransition;
     return doNotAbortActivePressInteractionOnTransition;
   } catch (_unused1) {
     return undefined;
@@ -359,8 +379,8 @@ function getFinishInteractionOnTransition() {
     if (!config) {
       return undefined;
     }
-    var _config1 = config,
-      finishInteractionOnTransition = _config1.finishInteractionOnTransition;
+    var _config10 = config,
+      finishInteractionOnTransition = _config10.finishInteractionOnTransition;
     return finishInteractionOnTransition;
   } catch (_unused10) {
     return undefined;
@@ -372,8 +392,8 @@ function getInteractionTimeout(ufoName) {
     if (!config) {
       return CLEANUP_TIMEOUT;
     }
-    var _config10 = config,
-      interactionTimeout = _config10.interactionTimeout;
+    var _config11 = config,
+      interactionTimeout = _config11.interactionTimeout;
     if (interactionTimeout != null && interactionTimeout[ufoName] != null) {
       return interactionTimeout[ufoName];
     }

package/dist/cjs/experience-trace-id-context/context-manager.js

@@ -17,7 +17,7 @@ var _api = require("@opentelemetry/api");
  * and we need to get it because we need to call a function that's not available in the OTel API:
  * `setActive`. The OTel JS API design doesn't allow us to manually set the active context
  * despite the spec allowing for the capability. Sigh.
- * 
+ *
  * I imagine this situation might not be permanent if we can move to a system were we can rely
  * solely on the API, but for the purposes of the first change being React UFO API compatible,
  * we'll need to do this.
@@ -31,7 +31,7 @@ function getContextManager() {
   return contextManager;
 }
 
-/** 
+/**
  * The below is shamelessly borrowed from StackContextManager from @opentelemetry/sdk-trace-web
  * Using this rather than importing the entire package because this is all we need for now
  */
@@ -165,9 +165,9 @@ var UFOContextManager = exports.UFOContextManager = /*#__PURE__*/function () {
      * This function is an extension of the OTel spec, in order to facilitate the current API of React UFO trace context handling.
      * It doesn't keep track of any previously set active contexts, because it's assumed (for now) that only one trace context
      * will ever exist at a time.
-     * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the 
+     * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the
      * hierarchy of contexts (likely using the `with()` function above).
-     * @param context The context to be made the globally active one 
+     * @param context The context to be made the globally active one
      */
   }, {
     key: "setActive",

package/dist/cjs/ignore-holds/index.js

@@ -57,5 +57,4 @@ function UFOIgnoreHolds(_ref) {
   return /*#__PURE__*/_react.default.createElement(_interactionContext.default.Provider, {
     value: ignoredInteractionContext
   }, kids);
-}
-UFOIgnoreHolds.displayName = 'UFOIgnoreHolds';
+}

package/dist/cjs/interaction-metrics-init/index.js

@@ -153,10 +153,19 @@ function init(analyticsWebClientAsync, config) {
     return;
   }
 
+  // Always set config first so isUFOEnabled() can check config.enabled
+  (0, _config.setUFOConfig)(config);
+
+  // If UFO is disabled via config, skip all initialization
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  if (!(0, _config.isUFOEnabled)()) {
+    initialized = true;
+    return;
+  }
+
   // Initialize pressure observer for CPU usage monitoring
   (0, _machineUtilisation.initialisePressureObserver)();
   (0, _machineUtilisation.initialiseMemoryObserver)();
-  (0, _config.setUFOConfig)(config);
   if ((0, _platformFeatureFlags.fg)('platform_ufo_enable_otel_context_manager')) {
     // Configure global OTel context manager
     var contextManager = new _contextManager.UFOContextManager();

package/dist/cjs/load-hold/UFOLoadHold.js

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = UFOLoadHold;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _react = _interopRequireWildcard(require("react"));
+var _config = require("../config");
 var _interactionContext = _interopRequireDefault(require("../interaction-context"));
 var _interactionIdContext = _interopRequireWildcard(require("../interaction-id-context"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
@@ -85,18 +86,25 @@ function UFOLoadHold(_ref) {
     hold = _ref$hold === void 0 ? true : _ref$hold,
     _ref$experimental = _ref.experimental,
     experimental = _ref$experimental === void 0 ? false : _ref$experimental;
+  // Check if UFO is enabled (gated behind platform_ufo_enable_killswitch_config feature flag)
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  var ufoEnabled = (0, _config.isUFOEnabled)();
   var currentInteractionId = useInteractionIdValue();
 
   // react-18: useId instead
   var context = (0, _react.useContext)(_interactionContext.default);
   useLayoutEffectSAFE(function () {
+    // Skip hold registration if UFO is disabled
+    if (!ufoEnabled) {
+      return;
+    }
     if (hold && context != null) {
       if (experimental && context.holdExperimental) {
         return context.holdExperimental(name);
       }
       return context.hold(name);
     }
-  }, [hold, context, name, currentInteractionId]);
+  }, [hold, context, name, currentInteractionId, ufoEnabled]);
 
   // react-18: can return children directly
   return children != null ? /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, children) : null;

package/dist/cjs/segment/segment.js

@@ -36,6 +36,10 @@ function UFOSegment(_ref) {
     mode = _ref$mode === void 0 ? 'single' : _ref$mode,
     _ref$type = _ref.type,
     type = _ref$type === void 0 ? 'first-party' : _ref$type;
+  // If UFO is disabled, render children without any tracking overhead
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  var ufoEnabled = (0, _config.isUFOEnabled)();
   var parentContext = (0, _react.useContext)(_interactionContext.default);
   var segmentIdMap = (0, _react.useMemo)(function () {
     if (!(parentContext !== null && parentContext !== void 0 && parentContext.segmentIdMap)) {
@@ -279,6 +283,11 @@ function UFOSegment(_ref) {
       return l.name;
     }).join('/');
   }, [labelStack]);
+
+  // If UFO is disabled, just render children without tracking overhead
+  if (!ufoEnabled) {
+    return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, children);
+  }
   var ufoSegment = /*#__PURE__*/_react.default.createElement(_interactionContext.default.Provider, {
     value: interactionContext
   }, /*#__PURE__*/_react.default.createElement(_react.Profiler, {
@@ -292,5 +301,4 @@ function UFOSegment(_ref) {
     }, ufoSegment);
   }
   return ufoSegment;
-}
-UFOSegment.displayName = 'UFOSegment';
+}

package/dist/cjs/segment/third-party-segment.js

@@ -23,5 +23,4 @@ function UFOThirdPartySegment(props) {
     ignore: (0, _platformFeatureFlags.fg)('platform_ufo_exclude_3p_elements_from_ttai'),
     reason: "third-party-element"
   }, children));
-}
-UFOThirdPartySegment.displayName = 'UFOThirdPartySegment';
+}

package/dist/cjs/trace-interaction/internal/trace-ufo-interaction.js

@@ -16,6 +16,10 @@ var _routeNameContext = _interopRequireDefault(require("../../route-name-context
 
 function traceUFOInteraction(name, interactionType, startTime) {
   var _getMinorInteractions;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!(0, _config.isUFOEnabled)()) {
+    return;
+  }
   var rate = (0, _config.getInteractionRate)(name, interactionType);
   var pressInteractionsList = (0, _config.getDoNotAbortActivePressInteraction)();
   var minorInteractions = (pressInteractionsList !== null && pressInteractionsList !== void 0 ? pressInteractionsList : []).concat((_getMinorInteractions = (0, _config.getMinorInteractions)()) !== null && _getMinorInteractions !== void 0 ? _getMinorInteractions : []);

package/dist/cjs/trace-pageload/index.js

@@ -18,6 +18,10 @@ var _routeNameContext = _interopRequireDefault(require("../route-name-context"))
 var AWAITING_PAGELOAD_NAME = 'awaiting_pageload_name';
 function traceUFOPageLoad(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!(0, _config.isUFOEnabled)()) {
+    return;
+  }
   var activeInteraction = (0, _interactionMetrics.getActiveInteraction)();
   if (activeInteraction && !ufoName) {
     return;
@@ -45,6 +49,10 @@ function traceUFOPageLoad(ufoName) {
 var _default = exports.default = traceUFOPageLoad;
 function updatePageloadName(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!(0, _config.isUFOEnabled)()) {
+    return;
+  }
   var interaction = (0, _interactionMetrics.getActiveInteraction)();
   if (!interaction || interaction.type !== 'page_load' && interaction.type !== 'transition') {
     return;

package/dist/cjs/trace-transition/index.js

@@ -21,6 +21,10 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 
 function traceUFOTransition(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!(0, _config.isUFOEnabled)()) {
+    return;
+  }
   var pressInteractionsList = (0, _config.getDoNotAbortActivePressInteractionOnTransition)();
   var interaction = (0, _interactionMetrics.getActiveInteraction)();
   if (pressInteractionsList && interaction) {

package/dist/es2019/config/index.js

@@ -33,6 +33,25 @@ export function setUFOConfig(newConfig) {
 export function getConfig() {
   return config;
 }
+
+/**
+ * Check if UFO is enabled based on the config.enabled field.
+ *
+ * This function is gated behind the platform_ufo_enable_killswitch_config feature flag.
+ * When the feature flag is disabled, UFO is always considered enabled (default behavior).
+ * When the feature flag is enabled, the config.enabled field is respected.
+ *
+ * @returns true if UFO is enabled, false if disabled
+ */
+export function isUFOEnabled() {
+  var _config;
+  // Only respect the config.enabled field when the killswitch feature flag is enabled
+  if (!fg('platform_ufo_enable_killswitch_config')) {
+    return true;
+  }
+  // Default to enabled if config is not set or enabled is not explicitly false
+  return ((_config = config) === null || _config === void 0 ? void 0 : _config.enabled) !== false;
+}
 const isValidConfigArray = array => {
   return Array.isArray(array) && array.length > 0;
 };
@@ -73,8 +92,8 @@ export function getReactHydrationStats() {
     return undefined;
   }
   try {
-    var _config, _config$getReactHydra;
-    const stats = (_config = config) === null || _config === void 0 ? void 0 : (_config$getReactHydra = _config.getReactHydrationStats) === null || _config$getReactHydra === void 0 ? void 0 : _config$getReactHydra.call(_config);
+    var _config2, _config2$getReactHydr;
+    const stats = (_config2 = config) === null || _config2 === void 0 ? void 0 : (_config2$getReactHydr = _config2.getReactHydrationStats) === null || _config2$getReactHydr === void 0 ? void 0 : _config2$getReactHydr.call(_config2);
     return stats !== null && stats !== void 0 ? stats : undefined;
   } catch (e) {
     // eslint-disable-next-line no-console

package/dist/es2019/experience-trace-id-context/context-manager.js

@@ -7,7 +7,7 @@ import { ROOT_CONTEXT } from '@opentelemetry/api';
  * and we need to get it because we need to call a function that's not available in the OTel API:
  * `setActive`. The OTel JS API design doesn't allow us to manually set the active context
  * despite the spec allowing for the capability. Sigh.
- * 
+ *
  * I imagine this situation might not be permanent if we can move to a system were we can rely
  * solely on the API, but for the purposes of the first change being React UFO API compatible,
  * we'll need to do this.
@@ -21,7 +21,7 @@ export function getContextManager() {
   return contextManager;
 }
 
-/** 
+/**
  * The below is shamelessly borrowed from StackContextManager from @opentelemetry/sdk-trace-web
  * Using this rather than importing the entire package because this is all we need for now
  */
@@ -130,9 +130,9 @@ export class UFOContextManager {
    * This function is an extension of the OTel spec, in order to facilitate the current API of React UFO trace context handling.
    * It doesn't keep track of any previously set active contexts, because it's assumed (for now) that only one trace context
    * will ever exist at a time.
-   * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the 
+   * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the
    * hierarchy of contexts (likely using the `with()` function above).
-   * @param context The context to be made the globally active one 
+   * @param context The context to be made the globally active one
    */
   setActive(context) {
     if (this._enabled) {

package/dist/es2019/ignore-holds/index.js

@@ -46,5 +46,4 @@ export default function UFOIgnoreHolds({
   return /*#__PURE__*/React.createElement(InteractionContext.Provider, {
     value: ignoredInteractionContext
   }, kids);
-}
-UFOIgnoreHolds.displayName = 'UFOIgnoreHolds';
+}

package/dist/es2019/interaction-metrics-init/index.js

@@ -1,7 +1,7 @@
 import { context } from '@opentelemetry/api';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { startLighthouseObserver } from '../additional-payload';
-import { setUFOConfig } from '../config';
+import { isUFOEnabled, setUFOConfig } from '../config';
 import { experimentalVC, sinkExperimentalHandler } from '../create-experimental-interaction-metrics-payload';
 import { sinkExtraSearchPageInteractionHandler } from '../create-extra-search-page-interaction-payload';
 import { setContextManager, UFOContextManager } from '../experience-trace-id-context/context-manager';
@@ -129,10 +129,19 @@ export function init(analyticsWebClientAsync, config) {
     return;
   }
 
+  // Always set config first so isUFOEnabled() can check config.enabled
+  setUFOConfig(config);
+
+  // If UFO is disabled via config, skip all initialization
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  if (!isUFOEnabled()) {
+    initialized = true;
+    return;
+  }
+
   // Initialize pressure observer for CPU usage monitoring
   initialisePressureObserver();
   initialiseMemoryObserver();
-  setUFOConfig(config);
   if (fg('platform_ufo_enable_otel_context_manager')) {
     // Configure global OTel context manager
     const contextManager = new UFOContextManager();

package/dist/es2019/load-hold/UFOLoadHold.js

@@ -1,4 +1,5 @@
 import React, { useContext, useEffect, useLayoutEffect, useState } from 'react';
+import { isUFOEnabled } from '../config';
 import UFOInteractionContext from '../interaction-context';
 import UFOInteractionIDContext, { subscribeToInteractionIdChanges } from '../interaction-id-context';
 const useLayoutEffectSAFE = typeof window === 'undefined' ? useEffect : useLayoutEffect;
@@ -71,18 +72,25 @@ export default function UFOLoadHold({
   hold = true,
   experimental = false
 }) {
+  // Check if UFO is enabled (gated behind platform_ufo_enable_killswitch_config feature flag)
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  const ufoEnabled = isUFOEnabled();
   const currentInteractionId = useInteractionIdValue();
 
   // react-18: useId instead
   const context = useContext(UFOInteractionContext);
   useLayoutEffectSAFE(() => {
+    // Skip hold registration if UFO is disabled
+    if (!ufoEnabled) {
+      return;
+    }
     if (hold && context != null) {
       if (experimental && context.holdExperimental) {
         return context.holdExperimental(name);
       }
       return context.hold(name);
     }
-  }, [hold, context, name, currentInteractionId]);
+  }, [hold, context, name, currentInteractionId, ufoEnabled]);
 
   // react-18: can return children directly
   return children != null ? /*#__PURE__*/React.createElement(React.Fragment, null, children) : null;

package/dist/es2019/segment/segment.js

@@ -4,7 +4,7 @@ import { unstable_NormalPriority as NormalPriority, unstable_scheduleCallback as
 import { v4 as createUUID } from 'uuid';
 import { fg } from '@atlaskit/platform-feature-flags';
 import coinflip from '../coinflip';
-import { getConfig, getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions } from '../config';
+import { getConfig, getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions, isUFOEnabled } from '../config';
 import { getActiveTrace, setInteractionActiveTrace } from '../experience-trace-id-context';
 import UFOInteractionContext from '../interaction-context';
 import UFOInteractionIDContext from '../interaction-id-context';
@@ -23,6 +23,10 @@ export default function UFOSegment({
   mode = 'single',
   type = 'first-party'
 }) {
+  // If UFO is disabled, render children without any tracking overhead
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  const ufoEnabled = isUFOEnabled();
   const parentContext = useContext(UFOInteractionContext);
   const segmentIdMap = useMemo(() => {
     if (!(parentContext !== null && parentContext !== void 0 && parentContext.segmentIdMap)) {
@@ -257,6 +261,11 @@ export default function UFOSegment({
     };
   }, [interactionId, parentContext, interactionContext, labelStack]);
   const reactProfilerId = useMemo(() => labelStack.map(l => l.name).join('/'), [labelStack]);
+
+  // If UFO is disabled, just render children without tracking overhead
+  if (!ufoEnabled) {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, children);
+  }
   const ufoSegment = /*#__PURE__*/React.createElement(UFOInteractionContext.Provider, {
     value: interactionContext
   }, /*#__PURE__*/React.createElement(Profiler, {
@@ -270,5 +279,4 @@ export default function UFOSegment({
     }, ufoSegment);
   }
   return ufoSegment;
-}
-UFOSegment.displayName = 'UFOSegment';
+}

package/dist/es2019/segment/third-party-segment.js

@@ -16,5 +16,4 @@ export function UFOThirdPartySegment(props) {
     ignore: fg('platform_ufo_exclude_3p_elements_from_ttai'),
     reason: "third-party-element"
   }, children));
-}
-UFOThirdPartySegment.displayName = 'UFOThirdPartySegment';
+}

package/dist/es2019/trace-interaction/internal/trace-ufo-interaction.js

@@ -1,13 +1,17 @@
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../../coinflip';
-import { getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions } from '../../config';
+import { getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions, isUFOEnabled } from '../../config';
 import { getActiveTrace, setInteractionActiveTrace } from '../../experience-trace-id-context';
 import { DefaultInteractionID } from '../../interaction-id-context';
 import { abortAll, addNewInteraction, getActiveInteraction } from '../../interaction-metrics';
 import UFORouteName from '../../route-name-context';
 function traceUFOInteraction(name, interactionType, startTime) {
   var _getMinorInteractions;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   const rate = getInteractionRate(name, interactionType);
   const pressInteractionsList = getDoNotAbortActivePressInteraction();
   const minorInteractions = (pressInteractionsList !== null && pressInteractionsList !== void 0 ? pressInteractionsList : []).concat((_getMinorInteractions = getMinorInteractions()) !== null && _getMinorInteractions !== void 0 ? _getMinorInteractions : []);

package/dist/es2019/trace-pageload/index.js

@@ -1,13 +1,17 @@
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../coinflip';
-import { getInteractionRate } from '../config';
+import { getInteractionRate, isUFOEnabled } from '../config';
 import { getActiveTrace } from '../experience-trace-id-context';
 import { DefaultInteractionID } from '../interaction-id-context';
 import { abort, addHoldByID, addNewInteraction, getActiveInteraction, removeHoldByID, updatePageLoadInteractionName } from '../interaction-metrics';
 import UFORouteName from '../route-name-context';
 const AWAITING_PAGELOAD_NAME = 'awaiting_pageload_name';
 function traceUFOPageLoad(ufoName, routeName = ufoName) {
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   const activeInteraction = getActiveInteraction();
   if (activeInteraction && !ufoName) {
     return;
@@ -34,6 +38,10 @@ function traceUFOPageLoad(ufoName, routeName = ufoName) {
 }
 export default traceUFOPageLoad;
 export function updatePageloadName(ufoName, routeName = ufoName) {
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   const interaction = getActiveInteraction();
   if (!interaction || interaction.type !== 'page_load' && interaction.type !== 'transition') {
     return;

package/dist/es2019/trace-transition/index.js

@@ -3,13 +3,17 @@ import { useContext, useEffect } from 'react';
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../coinflip';
-import { getDoNotAbortActivePressInteractionOnTransition, getInteractionRate } from '../config';
+import { getDoNotAbortActivePressInteractionOnTransition, getInteractionRate, isUFOEnabled } from '../config';
 import { getActiveTrace } from '../experience-trace-id-context';
 import UFOInteractionIDContext, { DefaultInteractionID } from '../interaction-id-context';
 import { abortAll, addNewInteraction, addOnCancelCallback, getActiveInteraction, tryComplete } from '../interaction-metrics';
 import UFORouteName from '../route-name-context';
 import { setInteractionActiveTrace } from './utils/set-interaction-active-trace';
 function traceUFOTransition(ufoName, routeName = ufoName) {
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   const pressInteractionsList = getDoNotAbortActivePressInteractionOnTransition();
   const interaction = getActiveInteraction();
   if (pressInteractionsList && interaction) {

package/dist/esm/config/index.js

@@ -33,6 +33,25 @@ export function setUFOConfig(newConfig) {
 export function getConfig() {
   return config;
 }
+
+/**
+ * Check if UFO is enabled based on the config.enabled field.
+ *
+ * This function is gated behind the platform_ufo_enable_killswitch_config feature flag.
+ * When the feature flag is disabled, UFO is always considered enabled (default behavior).
+ * When the feature flag is enabled, the config.enabled field is respected.
+ *
+ * @returns true if UFO is enabled, false if disabled
+ */
+export function isUFOEnabled() {
+  var _config;
+  // Only respect the config.enabled field when the killswitch feature flag is enabled
+  if (!fg('platform_ufo_enable_killswitch_config')) {
+    return true;
+  }
+  // Default to enabled if config is not set or enabled is not explicitly false
+  return ((_config = config) === null || _config === void 0 ? void 0 : _config.enabled) !== false;
+}
 var isValidConfigArray = function isValidConfigArray(array) {
   return Array.isArray(array) && array.length > 0;
 };
@@ -74,8 +93,8 @@ export function getReactHydrationStats() {
     return undefined;
   }
   try {
-    var _config, _config$getReactHydra;
-    var stats = (_config = config) === null || _config === void 0 || (_config$getReactHydra = _config.getReactHydrationStats) === null || _config$getReactHydra === void 0 ? void 0 : _config$getReactHydra.call(_config);
+    var _config2, _config2$getReactHydr;
+    var stats = (_config2 = config) === null || _config2 === void 0 || (_config2$getReactHydr = _config2.getReactHydrationStats) === null || _config2$getReactHydr === void 0 ? void 0 : _config2$getReactHydr.call(_config2);
     return stats !== null && stats !== void 0 ? stats : undefined;
   } catch (e) {
     // eslint-disable-next-line no-console
@@ -88,12 +107,12 @@ export function getInteractionRate(name, interactionKind) {
     if (!config) {
       return 0;
     }
-    var _config2 = config,
-      killswitch = _config2.killswitch,
-      rates = _config2.rates,
-      rules = _config2.rules,
-      kind = _config2.kind,
-      autoGeneratedRate = _config2.autoGeneratedRate;
+    var _config3 = config,
+      killswitch = _config3.killswitch,
+      rates = _config3.rates,
+      rules = _config3.rules,
+      kind = _config3.kind,
+      autoGeneratedRate = _config3.autoGeneratedRate;
     if (killswitch != null) {
       // Specifically kill certain events
       if (killswitch.includes(name)) {
@@ -151,8 +170,8 @@ export function getExperimentalInteractionRate(name, interactionType) {
     if (!config) {
       return 0;
     }
-    var _config3 = config,
-      experimentalInteractionMetrics = _config3.experimentalInteractionMetrics;
+    var _config4 = config,
+      experimentalInteractionMetrics = _config4.experimentalInteractionMetrics;
     if (!(experimentalInteractionMetrics !== null && experimentalInteractionMetrics !== void 0 && experimentalInteractionMetrics.enabled)) {
       return 0;
     }
@@ -187,8 +206,8 @@ export function getCapabilityRate(capability) {
     if (!config) {
       return 0;
     }
-    var _config4 = config,
-      capabilityRate = _config4.capability;
+    var _config5 = config,
+      capabilityRate = _config5.capability;
     if (capabilityRate != null) {
       var rate = capabilityRate[capability];
       if (rate != null) {
@@ -233,8 +252,8 @@ export function getTypingPerformanceTracingMethod() {
     if (!config) {
       return defaultMethod;
     }
-    var _config5 = config,
-      typingMethod = _config5.typingMethod;
+    var _config6 = config,
+      typingMethod = _config6.typingMethod;
     if (typingMethod != null && validTypingMethods.find(function (m) {
       return m === typingMethod;
     })) {
@@ -253,8 +272,8 @@ export function getAwaitBM3TTIList() {
     if (!config) {
       return [];
     }
-    var _config6 = config,
-      awaitBM3TTI = _config6.awaitBM3TTI;
+    var _config7 = config,
+      awaitBM3TTI = _config7.awaitBM3TTI;
     if (awaitBM3TTI != null) {
       return awaitBM3TTI;
     } else {
@@ -274,8 +293,8 @@ export function getUfoNameOverrides() {
     if (!config) {
       return undefined;
     }
-    var _config7 = config,
-      ufoNameOverrides = _config7.ufoNameOverrides;
+    var _config8 = config,
+      ufoNameOverrides = _config8.ufoNameOverrides;
     if (ufoNameOverrides != null) {
       return ufoNameOverrides;
     }
@@ -289,8 +308,8 @@ export function getMinorInteractions() {
     if (!config) {
       return undefined;
     }
-    var _config8 = config,
-      minorInteractions = _config8.minorInteractions;
+    var _config9 = config,
+      minorInteractions = _config9.minorInteractions;
     return minorInteractions;
   } catch (_unused9) {
     return undefined;
@@ -303,8 +322,8 @@ export function getDoNotAbortActivePressInteraction() {
     if (!config) {
       return undefined;
     }
-    var _config9 = config,
-      doNotAbortActivePressInteraction = _config9.doNotAbortActivePressInteraction;
+    var _config0 = config,
+      doNotAbortActivePressInteraction = _config0.doNotAbortActivePressInteraction;
     return doNotAbortActivePressInteraction;
   } catch (_unused0) {
     return undefined;
@@ -317,8 +336,8 @@ export function getDoNotAbortActivePressInteractionOnTransition() {
     if (!config) {
       return undefined;
     }
-    var _config0 = config,
-      doNotAbortActivePressInteractionOnTransition = _config0.doNotAbortActivePressInteractionOnTransition;
+    var _config1 = config,
+      doNotAbortActivePressInteractionOnTransition = _config1.doNotAbortActivePressInteractionOnTransition;
     return doNotAbortActivePressInteractionOnTransition;
   } catch (_unused1) {
     return undefined;
@@ -331,8 +350,8 @@ export function getFinishInteractionOnTransition() {
     if (!config) {
       return undefined;
     }
-    var _config1 = config,
-      finishInteractionOnTransition = _config1.finishInteractionOnTransition;
+    var _config10 = config,
+      finishInteractionOnTransition = _config10.finishInteractionOnTransition;
     return finishInteractionOnTransition;
   } catch (_unused10) {
     return undefined;
@@ -344,8 +363,8 @@ export function getInteractionTimeout(ufoName) {
     if (!config) {
       return CLEANUP_TIMEOUT;
     }
-    var _config10 = config,
-      interactionTimeout = _config10.interactionTimeout;
+    var _config11 = config,
+      interactionTimeout = _config11.interactionTimeout;
     if (interactionTimeout != null && interactionTimeout[ufoName] != null) {
       return interactionTimeout[ufoName];
     }

package/dist/esm/experience-trace-id-context/context-manager.js

@@ -9,7 +9,7 @@ import { ROOT_CONTEXT } from '@opentelemetry/api';
  * and we need to get it because we need to call a function that's not available in the OTel API:
  * `setActive`. The OTel JS API design doesn't allow us to manually set the active context
  * despite the spec allowing for the capability. Sigh.
- * 
+ *
  * I imagine this situation might not be permanent if we can move to a system were we can rely
  * solely on the API, but for the purposes of the first change being React UFO API compatible,
  * we'll need to do this.
@@ -23,7 +23,7 @@ export function getContextManager() {
   return contextManager;
 }
 
-/** 
+/**
  * The below is shamelessly borrowed from StackContextManager from @opentelemetry/sdk-trace-web
  * Using this rather than importing the entire package because this is all we need for now
  */
@@ -157,9 +157,9 @@ export var UFOContextManager = /*#__PURE__*/function () {
      * This function is an extension of the OTel spec, in order to facilitate the current API of React UFO trace context handling.
      * It doesn't keep track of any previously set active contexts, because it's assumed (for now) that only one trace context
      * will ever exist at a time.
-     * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the 
+     * The next step in the work to improve tracing in the FE will likely remove this function as we need to track the
      * hierarchy of contexts (likely using the `with()` function above).
-     * @param context The context to be made the globally active one 
+     * @param context The context to be made the globally active one
      */
   }, {
     key: "setActive",

package/dist/esm/ignore-holds/index.js

@@ -48,5 +48,4 @@ export default function UFOIgnoreHolds(_ref) {
   return /*#__PURE__*/React.createElement(InteractionContext.Provider, {
     value: ignoredInteractionContext
   }, kids);
-}
-UFOIgnoreHolds.displayName = 'UFOIgnoreHolds';
+}

package/dist/esm/interaction-metrics-init/index.js

@@ -4,7 +4,7 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 import { context } from '@opentelemetry/api';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { startLighthouseObserver } from '../additional-payload';
-import { setUFOConfig } from '../config';
+import { isUFOEnabled, setUFOConfig } from '../config';
 import { experimentalVC, sinkExperimentalHandler } from '../create-experimental-interaction-metrics-payload';
 import { sinkExtraSearchPageInteractionHandler } from '../create-extra-search-page-interaction-payload';
 import { setContextManager, UFOContextManager } from '../experience-trace-id-context/context-manager';
@@ -144,10 +144,19 @@ export function init(analyticsWebClientAsync, config) {
     return;
   }
 
+  // Always set config first so isUFOEnabled() can check config.enabled
+  setUFOConfig(config);
+
+  // If UFO is disabled via config, skip all initialization
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  if (!isUFOEnabled()) {
+    initialized = true;
+    return;
+  }
+
   // Initialize pressure observer for CPU usage monitoring
   initialisePressureObserver();
   initialiseMemoryObserver();
-  setUFOConfig(config);
   if (fg('platform_ufo_enable_otel_context_manager')) {
     // Configure global OTel context manager
     var contextManager = new UFOContextManager();

package/dist/esm/load-hold/UFOLoadHold.js

@@ -1,5 +1,6 @@
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import React, { useContext, useEffect, useLayoutEffect, useState } from 'react';
+import { isUFOEnabled } from '../config';
 import UFOInteractionContext from '../interaction-context';
 import UFOInteractionIDContext, { subscribeToInteractionIdChanges } from '../interaction-id-context';
 var useLayoutEffectSAFE = typeof window === 'undefined' ? useEffect : useLayoutEffect;
@@ -76,18 +77,25 @@ export default function UFOLoadHold(_ref) {
     hold = _ref$hold === void 0 ? true : _ref$hold,
     _ref$experimental = _ref.experimental,
     experimental = _ref$experimental === void 0 ? false : _ref$experimental;
+  // Check if UFO is enabled (gated behind platform_ufo_enable_killswitch_config feature flag)
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  var ufoEnabled = isUFOEnabled();
   var currentInteractionId = useInteractionIdValue();
 
   // react-18: useId instead
   var context = useContext(UFOInteractionContext);
   useLayoutEffectSAFE(function () {
+    // Skip hold registration if UFO is disabled
+    if (!ufoEnabled) {
+      return;
+    }
     if (hold && context != null) {
       if (experimental && context.holdExperimental) {
         return context.holdExperimental(name);
       }
       return context.hold(name);
     }
-  }, [hold, context, name, currentInteractionId]);
+  }, [hold, context, name, currentInteractionId, ufoEnabled]);
 
   // react-18: can return children directly
   return children != null ? /*#__PURE__*/React.createElement(React.Fragment, null, children) : null;

package/dist/esm/segment/segment.js

@@ -8,7 +8,7 @@ import { unstable_NormalPriority as NormalPriority, unstable_scheduleCallback as
 import { v4 as createUUID } from 'uuid';
 import { fg } from '@atlaskit/platform-feature-flags';
 import coinflip from '../coinflip';
-import { getConfig, getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions } from '../config';
+import { getConfig, getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions, isUFOEnabled } from '../config';
 import { getActiveTrace, setInteractionActiveTrace } from '../experience-trace-id-context';
 import UFOInteractionContext from '../interaction-context';
 import UFOInteractionIDContext from '../interaction-id-context';
@@ -28,6 +28,10 @@ export default function UFOSegment(_ref) {
     mode = _ref$mode === void 0 ? 'single' : _ref$mode,
     _ref$type = _ref.type,
     type = _ref$type === void 0 ? 'first-party' : _ref$type;
+  // If UFO is disabled, render children without any tracking overhead
+  // This is gated behind platform_ufo_enable_killswitch_config feature flag
+  // Note: isUFOEnabled() returns a stable value based on config, so it's safe to call before hooks
+  var ufoEnabled = isUFOEnabled();
   var parentContext = useContext(UFOInteractionContext);
   var segmentIdMap = useMemo(function () {
     if (!(parentContext !== null && parentContext !== void 0 && parentContext.segmentIdMap)) {
@@ -271,6 +275,11 @@ export default function UFOSegment(_ref) {
       return l.name;
     }).join('/');
   }, [labelStack]);
+
+  // If UFO is disabled, just render children without tracking overhead
+  if (!ufoEnabled) {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, children);
+  }
   var ufoSegment = /*#__PURE__*/React.createElement(UFOInteractionContext.Provider, {
     value: interactionContext
   }, /*#__PURE__*/React.createElement(Profiler, {
@@ -284,5 +293,4 @@ export default function UFOSegment(_ref) {
     }, ufoSegment);
   }
   return ufoSegment;
-}
-UFOSegment.displayName = 'UFOSegment';
+}

package/dist/esm/segment/third-party-segment.js

@@ -16,5 +16,4 @@ export function UFOThirdPartySegment(props) {
     ignore: fg('platform_ufo_exclude_3p_elements_from_ttai'),
     reason: "third-party-element"
   }, children));
-}
-UFOThirdPartySegment.displayName = 'UFOThirdPartySegment';
+}

package/dist/esm/trace-interaction/internal/trace-ufo-interaction.js

@@ -1,13 +1,17 @@
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../../coinflip';
-import { getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions } from '../../config';
+import { getDoNotAbortActivePressInteraction, getInteractionRate, getMinorInteractions, isUFOEnabled } from '../../config';
 import { getActiveTrace, setInteractionActiveTrace } from '../../experience-trace-id-context';
 import { DefaultInteractionID } from '../../interaction-id-context';
 import { abortAll, addNewInteraction, getActiveInteraction } from '../../interaction-metrics';
 import UFORouteName from '../../route-name-context';
 function traceUFOInteraction(name, interactionType, startTime) {
   var _getMinorInteractions;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   var rate = getInteractionRate(name, interactionType);
   var pressInteractionsList = getDoNotAbortActivePressInteraction();
   var minorInteractions = (pressInteractionsList !== null && pressInteractionsList !== void 0 ? pressInteractionsList : []).concat((_getMinorInteractions = getMinorInteractions()) !== null && _getMinorInteractions !== void 0 ? _getMinorInteractions : []);

package/dist/esm/trace-pageload/index.js

@@ -1,7 +1,7 @@
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../coinflip';
-import { getInteractionRate } from '../config';
+import { getInteractionRate, isUFOEnabled } from '../config';
 import { getActiveTrace } from '../experience-trace-id-context';
 import { DefaultInteractionID } from '../interaction-id-context';
 import { abort, addHoldByID, addNewInteraction, getActiveInteraction, removeHoldByID, updatePageLoadInteractionName } from '../interaction-metrics';
@@ -9,6 +9,10 @@ import UFORouteName from '../route-name-context';
 var AWAITING_PAGELOAD_NAME = 'awaiting_pageload_name';
 function traceUFOPageLoad(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   var activeInteraction = getActiveInteraction();
   if (activeInteraction && !ufoName) {
     return;
@@ -36,6 +40,10 @@ function traceUFOPageLoad(ufoName) {
 export default traceUFOPageLoad;
 export function updatePageloadName(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   var interaction = getActiveInteraction();
   if (!interaction || interaction.type !== 'page_load' && interaction.type !== 'transition') {
     return;

package/dist/esm/trace-transition/index.js

@@ -3,7 +3,7 @@ import { useContext, useEffect } from 'react';
 // eslint-disable-next-line @atlaskit/platform/prefer-crypto-random-uuid -- Use crypto.randomUUID instead
 import { v4 as createUUID } from 'uuid';
 import coinflip from '../coinflip';
-import { getDoNotAbortActivePressInteractionOnTransition, getInteractionRate } from '../config';
+import { getDoNotAbortActivePressInteractionOnTransition, getInteractionRate, isUFOEnabled } from '../config';
 import { getActiveTrace } from '../experience-trace-id-context';
 import UFOInteractionIDContext, { DefaultInteractionID } from '../interaction-id-context';
 import { abortAll, addNewInteraction, addOnCancelCallback, getActiveInteraction, tryComplete } from '../interaction-metrics';
@@ -11,6 +11,10 @@ import UFORouteName from '../route-name-context';
 import { setInteractionActiveTrace } from './utils/set-interaction-active-trace';
 function traceUFOTransition(ufoName) {
   var routeName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : ufoName;
+  // Skip if UFO is disabled (gated behind platform_ufo_enable_killswitch_config)
+  if (!isUFOEnabled()) {
+    return;
+  }
   var pressInteractionsList = getDoNotAbortActivePressInteractionOnTransition();
   var interaction = getActiveInteraction();
   if (pressInteractionsList && interaction) {

package/dist/types/config/index.d.ts

@@ -190,6 +190,16 @@ export type Config = {
 };
 export declare function setUFOConfig(newConfig: Config): void;
 export declare function getConfig(): Config | undefined;
+/**
+ * Check if UFO is enabled based on the config.enabled field.
+ *
+ * This function is gated behind the platform_ufo_enable_killswitch_config feature flag.
+ * When the feature flag is disabled, UFO is always considered enabled (default behavior).
+ * When the feature flag is enabled, the config.enabled field is respected.
+ *
+ * @returns true if UFO is enabled, false if disabled
+ */
+export declare function isUFOEnabled(): boolean;
 export declare function getEnabledVCRevisions(experienceKey?: string): readonly TTVCRevision[];
 export declare function isVCRevisionEnabled(revision: TTVCRevision, experienceKey?: string): boolean;
 export declare function getMostRecentVCRevision(experienceKey?: string): TTVCRevision;

package/dist/types/ignore-holds/index.d.ts

@@ -24,8 +24,4 @@ export type UFOIgnoreHoldsProps = {
  * Has an `ignore` prop, to allow you to use it conditionally
  * Has a `reason` prop, to specify why the hold is being ignored
  */
-declare function UFOIgnoreHolds({ children, ignore, }: UFOIgnoreHoldsProps): React.JSX.Element;
-declare namespace UFOIgnoreHolds {
-    var displayName: string;
-}
-export default UFOIgnoreHolds;
+export default function UFOIgnoreHolds({ children, ignore, }: UFOIgnoreHoldsProps): React.JSX.Element;

package/dist/types/segment/segment.d.ts

@@ -7,8 +7,4 @@ export type Props = {
     type?: UFOSegmentType;
 };
 /** A portion of the page we apply measurement to */
-declare function UFOSegment({ name: segmentName, children, mode, type, }: Props): React.JSX.Element;
-declare namespace UFOSegment {
-    var displayName: string;
-}
-export default UFOSegment;
+export default function UFOSegment({ name: segmentName, children, mode, type, }: Props): React.JSX.Element;

package/dist/types/segment/third-party-segment.d.ts

@@ -1,6 +1,3 @@
 import React from 'react';
 import { type Props as SegmentProps } from './segment';
 export declare function UFOThirdPartySegment(props: Omit<SegmentProps, 'type'>): React.JSX.Element;
-export declare namespace UFOThirdPartySegment {
-    var displayName: string;
-}

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

@@ -190,6 +190,16 @@ export type Config = {
 };
 export declare function setUFOConfig(newConfig: Config): void;
 export declare function getConfig(): Config | undefined;
+/**
+ * Check if UFO is enabled based on the config.enabled field.
+ *
+ * This function is gated behind the platform_ufo_enable_killswitch_config feature flag.
+ * When the feature flag is disabled, UFO is always considered enabled (default behavior).
+ * When the feature flag is enabled, the config.enabled field is respected.
+ *
+ * @returns true if UFO is enabled, false if disabled
+ */
+export declare function isUFOEnabled(): boolean;
 export declare function getEnabledVCRevisions(experienceKey?: string): readonly TTVCRevision[];
 export declare function isVCRevisionEnabled(revision: TTVCRevision, experienceKey?: string): boolean;
 export declare function getMostRecentVCRevision(experienceKey?: string): TTVCRevision;

package/dist/types-ts4.5/ignore-holds/index.d.ts

@@ -24,8 +24,4 @@ export type UFOIgnoreHoldsProps = {
  * Has an `ignore` prop, to allow you to use it conditionally
  * Has a `reason` prop, to specify why the hold is being ignored
  */
-declare function UFOIgnoreHolds({ children, ignore, }: UFOIgnoreHoldsProps): React.JSX.Element;
-declare namespace UFOIgnoreHolds {
-    var displayName: string;
-}
-export default UFOIgnoreHolds;
+export default function UFOIgnoreHolds({ children, ignore, }: UFOIgnoreHoldsProps): React.JSX.Element;

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

@@ -7,8 +7,4 @@ export type Props = {
     type?: UFOSegmentType;
 };
 /** A portion of the page we apply measurement to */
-declare function UFOSegment({ name: segmentName, children, mode, type, }: Props): React.JSX.Element;
-declare namespace UFOSegment {
-    var displayName: string;
-}
-export default UFOSegment;
+export default function UFOSegment({ name: segmentName, children, mode, type, }: Props): React.JSX.Element;

package/dist/types-ts4.5/segment/third-party-segment.d.ts

@@ -1,6 +1,3 @@
 import React from 'react';
 import { type Props as SegmentProps } from './segment';
 export declare function UFOThirdPartySegment(props: Omit<SegmentProps, 'type'>): React.JSX.Element;
-export declare namespace UFOThirdPartySegment {
-    var displayName: string;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/react-ufo",
-	"version": "5.2.6",
+	"version": "5.2.7",
 	"description": "Parts of React UFO that are publicly available",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -208,6 +208,9 @@
 		},
 		"ufo_vc_revision_trim_enabled": {
 			"type": "boolean"
+		},
+		"platform_ufo_enable_killswitch_config": {
+			"type": "boolean"
 		}
 	}
 }