@atlaskit/analytics-next 10.1.0 → 10.2.0

package/dist/esm/components/AnalyticsErrorBoundary.js

@@ -3,7 +3,7 @@ import _createClass from "@babel/runtime/helpers/createClass";
 import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _createSuper(t) { var r = _isNativeReflectConstruct(); return function () { var e, o = _getPrototypeOf(t); if (r) { var s = _getPrototypeOf(this).constructor; e = Reflect.construct(o, arguments, s); } else e = o.apply(this, arguments); return _possibleConstructorReturn(this, e); }; }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import React, { Component } from 'react';
 import { fg } from '@atlaskit/platform-feature-flags';
@@ -44,7 +44,7 @@ var AnalyticsErrorBoundary = /*#__PURE__*/function (_Component) {
         children = _this$props.children,
         ErrorComponent = _this$props.ErrorComponent;
       var hasError = this.state.hasError;
-      var isModernContext = isModernContextEnabledEnv || fg('platform.analytics-next-use-modern-context_fqgbx');
+      var isModernContext = isModernContextEnabledEnv || fg('analytics-next-use-modern-context_jira');
       if (hasError) {
         if (ErrorComponent) {
           if (isModernContext) {

package/dist/esm/components/AnalyticsListener/LegacyAnalyticsListener.js

@@ -6,7 +6,7 @@ import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _createSuper(t) { var r = _isNativeReflectConstruct(); return function () { var e, o = _getPrototypeOf(t); if (r) { var s = _getPrototypeOf(this).constructor; e = Reflect.construct(o, arguments, s); } else e = o.apply(this, arguments); return _possibleConstructorReturn(this, e); }; }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import React, { Component } from 'react';
 import PropTypes from 'prop-types';

package/dist/esm/components/AnalyticsListener/index.js

@@ -4,7 +4,7 @@ import isModernContextEnabledEnv from '../../utils/isModernContextEnabledEnv';
 import LegacyAnalyticsListener from './LegacyAnalyticsListener';
 import ModernAnalyticsListener from './ModernAnalyticsListener';
 var ExportedAnalyticsListener = function ExportedAnalyticsListener(props) {
-  var isModernContext = isModernContextEnabledEnv || fg('platform.analytics-next-use-modern-context_fqgbx');
+  var isModernContext = isModernContextEnabledEnv || fg('analytics-next-use-modern-context_jira');
   return isModernContext ? /*#__PURE__*/React.createElement(ModernAnalyticsListener, props) : /*#__PURE__*/React.createElement(LegacyAnalyticsListener, props);
 };
 export default ExportedAnalyticsListener;

package/dist/esm/components/matchEvent/index.js

@@ -0,0 +1,17 @@
+var ENDS_WITH_DOT = /\.$/;
+function matchEvent(matcher, name) {
+  if (matcher === '*' || name === undefined) {
+    return true;
+  }
+  if (typeof matcher === 'string') {
+    if (ENDS_WITH_DOT.test(matcher)) {
+      return name.substr(0, matcher.length) === matcher;
+    }
+    return name === matcher;
+  }
+  if (typeof matcher === 'function') {
+    return matcher(name);
+  }
+  return matcher.test(name);
+}
+export default matchEvent;

package/dist/esm/events/UIAnalyticsEvent.js

@@ -7,8 +7,9 @@ import _inherits from "@babel/runtime/helpers/inherits";
 import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
 import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _createSuper(t) { var r = _isNativeReflectConstruct(); return function () { var e, o = _getPrototypeOf(t); if (r) { var s = _getPrototypeOf(this).constructor; e = Reflect.construct(o, arguments, s); } else e = o.apply(this, arguments); return _possibleConstructorReturn(this, e); }; }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+/// <reference types="node" />
 import AnalyticsEvent from './AnalyticsEvent';
 export var isUIAnalyticsEvent = function isUIAnalyticsEvent(obj) {
   var _obj$constructor;

package/dist/esm/index.js

@@ -20,4 +20,9 @@ export { usePlatformLeafEventHandler } from './hooks/usePlatformLeafEventHandler
 export { usePlatformLeafSyntheticEventHandler } from './hooks/usePlatformLeafSyntheticEventHandler';
 // Helper functions
 export { default as createAndFireEvent } from './utils/createAndFireEvent';
-export { default as cleanProps } from './utils/cleanProps';
+export { default as cleanProps } from './utils/cleanProps';
+
+// Moved from deprecated @atlaskit/analytics
+export { default as AnalyticsDecorator } from './components/AnalyticsDecorator';
+export { default as AnalyticsDelegate } from './components/AnalyticsDelegate';
+export { default as withAnalytics } from './utils/withAnalytics';

package/dist/esm/utils/isModernContextEnabledEnv.js

@@ -1,2 +1,3 @@
 var _process$env;
+/// <reference types="node" />
 export default typeof process !== 'undefined' && process !== null && ((_process$env = process.env) === null || _process$env === void 0 ? void 0 : _process$env['ANALYTICS_NEXT_MODERN_CONTEXT']);

package/dist/esm/utils/withAnalytics.js

@@ -0,0 +1,137 @@
+import _extends from "@babel/runtime/helpers/extends";
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
+import _createClass from "@babel/runtime/helpers/createClass";
+import _assertThisInitialized from "@babel/runtime/helpers/assertThisInitialized";
+import _inherits from "@babel/runtime/helpers/inherits";
+import _possibleConstructorReturn from "@babel/runtime/helpers/possibleConstructorReturn";
+import _getPrototypeOf from "@babel/runtime/helpers/getPrototypeOf";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var _excluded = ["analyticsId", "analyticsData"];
+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; }
+function _createSuper(t) { var r = _isNativeReflectConstruct(); return function () { var e, o = _getPrototypeOf(t); if (r) { var s = _getPrototypeOf(this).constructor; e = Reflect.construct(o, arguments, s); } else e = o.apply(this, arguments); return _possibleConstructorReturn(this, e); }; }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+import React, { Component } from 'react';
+import PropTypes from 'prop-types';
+/**
+ * The withAnalytics HOC wraps a component and provides the `fireAnalyticsEvent`
+ * and `firePrivateAnalyticsEvent` methods to it as props. It contains the logic
+ * for how to fire events, including handling the analyticsId and analyticsData
+ * props. The `map` argument may be an object or a function that returns an object.
+ * The properties of the `map` object/result can be strings (the name of the event
+ * that will be fired) or functions (which are responsible for firing the event).
+ * You can specify a default `analyticsId` and `analyticsData` with the `defaultProps`
+ * param. Please be aware that specifying a default `analyticsId` will cause public
+ * events to always fire for your component unless it has been set to a falsy by
+ * the component consumer.
+ *
+ * @param WrappedComponent
+ * @param map
+ * @param defaultProps
+ * @param withDelegation
+ */
+var withAnalytics = function withAnalytics(WrappedComponent) {
+  var _class;
+  var map = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var defaultProps = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+  var withDelegation = arguments.length > 3 ? arguments[3] : undefined;
+  return _class = /*#__PURE__*/function (_Component) {
+    _inherits(WithAnalytics, _Component);
+    var _super = _createSuper(WithAnalytics);
+    function WithAnalytics(props) {
+      var _this;
+      _classCallCheck(this, WithAnalytics);
+      _this = _super.call(this, props);
+      _defineProperty(_assertThisInitialized(_this), "delegateAnalyticsEvent", function (analyticsId, data, isPrivate) {
+        var _ref = _this.context,
+          onAnalyticsEvent = _ref.onAnalyticsEvent;
+        if (!onAnalyticsEvent) {
+          return;
+        }
+        onAnalyticsEvent(analyticsId, data, isPrivate);
+      });
+      _defineProperty(_assertThisInitialized(_this), "fireAnalyticsEvent", function (name, data) {
+        var _this$props = _this.props,
+          analyticsData = _this$props.analyticsData,
+          analyticsId = _this$props.analyticsId;
+        var _ref2 = _this.context,
+          onAnalyticsEvent = _ref2.onAnalyticsEvent;
+        if (!analyticsId || !onAnalyticsEvent) {
+          return;
+        }
+        var eventData = _objectSpread(_objectSpread({}, analyticsData), data);
+        onAnalyticsEvent("".concat(analyticsId, ".").concat(name), eventData, false);
+      });
+      _defineProperty(_assertThisInitialized(_this), "privateAnalyticsEvent", function (name, data) {
+        var _ref3 = _this.context,
+          onAnalyticsEvent = _ref3.onAnalyticsEvent;
+        if (!onAnalyticsEvent) {
+          return;
+        }
+        onAnalyticsEvent("".concat(name), data, true);
+      });
+      _defineProperty(_assertThisInitialized(_this), "getParentAnalyticsData", function (name) {
+        var _ref4 = _this.context,
+          getParentAnalyticsData = _ref4.getParentAnalyticsData;
+        var parentData = {};
+        if (typeof getParentAnalyticsData === 'function' && _this.props.analyticsId) {
+          var analyticsId = _this.props.analyticsId;
+          parentData = getParentAnalyticsData("".concat(analyticsId, ".").concat(name), false);
+        }
+        return parentData;
+      });
+      _this.state = {
+        evaluatedMap: {}
+      };
+      return _this;
+    }
+    _createClass(WithAnalytics, [{
+      key: "componentDidMount",
+      value: function componentDidMount() {
+        this.setState({
+          evaluatedMap: typeof map === 'function' ? map(this.fireAnalyticsEvent) : map
+        });
+      }
+    }, {
+      key: "render",
+      value: function render() {
+        var _this2 = this;
+        var _this$props2 = this.props,
+          analyticsId = _this$props2.analyticsId,
+          analyticsData = _this$props2.analyticsData,
+          componentProps = _objectWithoutProperties(_this$props2, _excluded);
+        Object.keys(this.state.evaluatedMap).forEach(function (prop) {
+          var handler = _this2.state.evaluatedMap[prop];
+          var originalProp = componentProps[prop];
+          componentProps[prop] = function () {
+            if (typeof handler === 'function') {
+              handler.apply(void 0, arguments);
+            } else {
+              _this2.fireAnalyticsEvent(handler);
+            }
+            if (typeof originalProp === 'function') {
+              originalProp.apply(void 0, arguments);
+            }
+          };
+        });
+        return /*#__PURE__*/React.createElement(WrappedComponent, _extends({
+          fireAnalyticsEvent: this.fireAnalyticsEvent,
+          firePrivateAnalyticsEvent: this.privateAnalyticsEvent,
+          getParentAnalyticsData: this.getParentAnalyticsData,
+          delegateAnalyticsEvent: withDelegation ? this.delegateAnalyticsEvent : undefined,
+          analyticsId: analyticsId,
+          ref: this.props.innerRef
+        }, componentProps));
+      }
+    }]);
+    return WithAnalytics;
+  }(Component), _defineProperty(_class, "displayName", "WithAnalytics(".concat(WrappedComponent.displayName || WrappedComponent.name, ")")), _defineProperty(_class, "contextTypes", {
+    onAnalyticsEvent: PropTypes.func,
+    getParentAnalyticsData: PropTypes.func
+  }), _defineProperty(_class, "defaultProps", {
+    analyticsId: defaultProps.analyticsId,
+    analyticsData: defaultProps.analyticsData
+  }), _class;
+};
+export default withAnalytics;

package/dist/types/components/AnalyticsDecorator/index.d.ts

@@ -0,0 +1,46 @@
+import React, { Component } from 'react';
+import PropTypes from 'prop-types';
+import { type Matcher } from '../matchEvent';
+type AnalyticsData = {
+    [key: string]: any;
+};
+type AnalyticsDecoratorProps = {
+    match: Matcher;
+    matchPrivate: boolean;
+    data?: AnalyticsData;
+    getData?: (name: string, data: AnalyticsData) => AnalyticsData;
+    children: React.ReactNode;
+};
+type AnalyticsDecoratorContext = {
+    onAnalyticsEvent?: (name: string, data: AnalyticsData, isPrivate: boolean) => void;
+    getParentAnalyticsData?: (name: string, isPrivate: boolean) => AnalyticsData;
+};
+export declare const ContextTypes: {
+    onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+};
+/**
+ * The Decorator component extends analytics event data
+ * for any events fired by its descendents,
+ * then passes the event up the hierarchy
+ */
+export declare class AnalyticsDecorator extends Component<AnalyticsDecoratorProps> {
+    static defaultProps: {
+        match: string;
+        matchPrivate: boolean;
+    };
+    static contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    static childContextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    getChildContext(): AnalyticsDecoratorContext;
+    getDecoratedAnalyticsData: (name: string, srcData: AnalyticsData, isPrivate: boolean) => AnalyticsData;
+    onAnalyticsEvent: (name: string, srcData: AnalyticsData, isPrivate: boolean) => void;
+    getParentAnalyticsData: (name: string, isPrivate: boolean) => AnalyticsData;
+    render(): boolean | {} | React.ReactChild | React.ReactPortal | null | undefined;
+}
+export default AnalyticsDecorator;

package/dist/types/components/AnalyticsDelegate/index.d.ts

@@ -0,0 +1,25 @@
+import React, { Component } from 'react';
+import PropTypes from 'prop-types';
+type AnalyticsDelegateProps = {
+    delegateAnalyticsEvent?: (name: string, data: any, isPrivate: boolean) => void;
+    children: React.ReactNode;
+};
+type AnalyticsDelegateContext = {
+    onAnalyticsEvent?: (name: string, data: any, isPrivate: boolean) => void;
+};
+/**
+ * Listens to public and private events and delegates to an analytics
+ * stack in a different React root.
+ */
+declare class AnalyticsDelegate extends Component<AnalyticsDelegateProps> {
+    static contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    static childContextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    getChildContext(): AnalyticsDelegateContext;
+    onAnalyticsEvent: (name: string, data: any, isPrivate: boolean) => void;
+    render(): boolean | {} | React.ReactChild | React.ReactPortal | null | undefined;
+}
+export default AnalyticsDelegate;

package/dist/types/components/matchEvent/index.d.ts

@@ -0,0 +1,3 @@
+export type Matcher = string | RegExp | ((name: string) => boolean) | '*';
+declare function matchEvent(matcher: Matcher, name: string): boolean;
+export default matchEvent;

package/dist/types/hocs/withAnalyticsEvents.d.ts

@@ -8,5 +8,5 @@ export interface WithAnalyticsEventsProps {
     createAnalyticsEvent?: CreateUIAnalyticsEvent;
     ref?: React.Ref<any>;
 }
-declare const withAnalyticsEvents: (createEventMap?: CreateEventMap) => <Props extends WithAnalyticsEventsProps, Component>(WrappedComponent: React.ComponentType<Props> & Component) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.LibraryManagedAttributes<Component, Omit<Props, keyof WithAnalyticsEventsProps>>> & React.RefAttributes<any>>;
+declare const withAnalyticsEvents: (createEventMap?: CreateEventMap) => <Props, Component>(WrappedComponent: React.ComponentType<WithAnalyticsEventsProps & Props> & Component) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.LibraryManagedAttributes<Component, Omit<Props, keyof WithAnalyticsEventsProps>>> & React.RefAttributes<any>>;
 export default withAnalyticsEvents;

package/dist/types/index.d.ts

@@ -23,3 +23,6 @@ export { usePlatformLeafSyntheticEventHandler } from './hooks/usePlatformLeafSyn
 export type { UsePlatformLeafSyntheticEventHandlerHookArgs, UsePlatformLeafSyntheticEventHandlerHook, } from './hooks/usePlatformLeafSyntheticEventHandler';
 export { default as createAndFireEvent } from './utils/createAndFireEvent';
 export { default as cleanProps } from './utils/cleanProps';
+export { default as AnalyticsDecorator } from './components/AnalyticsDecorator';
+export { default as AnalyticsDelegate } from './components/AnalyticsDelegate';
+export { default as withAnalytics } from './utils/withAnalytics';

package/dist/types/utils/withAnalytics.d.ts

@@ -0,0 +1,80 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+type AnalyticsData = {
+    [key: string]: any;
+};
+type WithAnalyticsProps = {
+    analyticsId?: string;
+    analyticsData?: AnalyticsData;
+    fireAnalyticsEvent?: (name: string, data?: AnalyticsData) => void;
+    firePrivateAnalyticsEvent?: (name: string, data?: AnalyticsData) => void;
+    getParentAnalyticsData?: (name: string) => AnalyticsData;
+    delegateAnalyticsEvent?: (analyticsId: string, data: any, isPrivate: boolean) => void;
+    innerRef?: React.Ref<any>;
+    [key: string]: any;
+};
+type WithAnalyticsState = {
+    evaluatedMap: {
+        [key: string]: string | ((...args: any[]) => void);
+    };
+};
+/**
+ * The withAnalytics HOC wraps a component and provides the `fireAnalyticsEvent`
+ * and `firePrivateAnalyticsEvent` methods to it as props. It contains the logic
+ * for how to fire events, including handling the analyticsId and analyticsData
+ * props. The `map` argument may be an object or a function that returns an object.
+ * The properties of the `map` object/result can be strings (the name of the event
+ * that will be fired) or functions (which are responsible for firing the event).
+ * You can specify a default `analyticsId` and `analyticsData` with the `defaultProps`
+ * param. Please be aware that specifying a default `analyticsId` will cause public
+ * events to always fire for your component unless it has been set to a falsy by
+ * the component consumer.
+ *
+ * @param WrappedComponent
+ * @param map
+ * @param defaultProps
+ * @param withDelegation
+ */
+declare const withAnalytics: (WrappedComponent: React.ComponentType<any>, map?: {
+    [key: string]: string | ((...args: any[]) => void);
+} | ((fireAnalyticsEvent: (name: string, data?: AnalyticsData) => void) => {
+    [key: string]: string | ((...args: any[]) => void);
+}), defaultProps?: Partial<WithAnalyticsProps>, withDelegation?: boolean) => {
+    new (props: WithAnalyticsProps): {
+        componentDidMount(): void;
+        delegateAnalyticsEvent: (analyticsId: string, data: any, isPrivate: boolean) => void;
+        fireAnalyticsEvent: (name: string, data?: AnalyticsData) => void;
+        privateAnalyticsEvent: (name: string, data?: AnalyticsData) => void;
+        getParentAnalyticsData: (name: string) => AnalyticsData;
+        render(): JSX.Element;
+        context: any;
+        setState<K extends "evaluatedMap">(state: WithAnalyticsState | ((prevState: Readonly<WithAnalyticsState>, props: Readonly<WithAnalyticsProps>) => WithAnalyticsState | Pick<WithAnalyticsState, K> | null) | Pick<WithAnalyticsState, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<WithAnalyticsProps> & Readonly<{
+            children?: React.ReactNode;
+        }>;
+        state: Readonly<WithAnalyticsState>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<WithAnalyticsProps>, prevState: Readonly<WithAnalyticsState>): any;
+        componentDidUpdate?(prevProps: Readonly<WithAnalyticsProps>, prevState: Readonly<WithAnalyticsState>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<WithAnalyticsProps>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<WithAnalyticsProps>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): void;
+    };
+    displayName: string;
+    contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    defaultProps: Partial<WithAnalyticsProps>;
+    contextType?: React.Context<any> | undefined;
+};
+export default withAnalytics;

package/dist/types-ts4.5/components/AnalyticsDecorator/index.d.ts

@@ -0,0 +1,46 @@
+import React, { Component } from 'react';
+import PropTypes from 'prop-types';
+import { type Matcher } from '../matchEvent';
+type AnalyticsData = {
+    [key: string]: any;
+};
+type AnalyticsDecoratorProps = {
+    match: Matcher;
+    matchPrivate: boolean;
+    data?: AnalyticsData;
+    getData?: (name: string, data: AnalyticsData) => AnalyticsData;
+    children: React.ReactNode;
+};
+type AnalyticsDecoratorContext = {
+    onAnalyticsEvent?: (name: string, data: AnalyticsData, isPrivate: boolean) => void;
+    getParentAnalyticsData?: (name: string, isPrivate: boolean) => AnalyticsData;
+};
+export declare const ContextTypes: {
+    onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+};
+/**
+ * The Decorator component extends analytics event data
+ * for any events fired by its descendents,
+ * then passes the event up the hierarchy
+ */
+export declare class AnalyticsDecorator extends Component<AnalyticsDecoratorProps> {
+    static defaultProps: {
+        match: string;
+        matchPrivate: boolean;
+    };
+    static contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    static childContextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    getChildContext(): AnalyticsDecoratorContext;
+    getDecoratedAnalyticsData: (name: string, srcData: AnalyticsData, isPrivate: boolean) => AnalyticsData;
+    onAnalyticsEvent: (name: string, srcData: AnalyticsData, isPrivate: boolean) => void;
+    getParentAnalyticsData: (name: string, isPrivate: boolean) => AnalyticsData;
+    render(): boolean | {} | React.ReactChild | React.ReactPortal | null | undefined;
+}
+export default AnalyticsDecorator;

package/dist/types-ts4.5/components/AnalyticsDelegate/index.d.ts

@@ -0,0 +1,25 @@
+import React, { Component } from 'react';
+import PropTypes from 'prop-types';
+type AnalyticsDelegateProps = {
+    delegateAnalyticsEvent?: (name: string, data: any, isPrivate: boolean) => void;
+    children: React.ReactNode;
+};
+type AnalyticsDelegateContext = {
+    onAnalyticsEvent?: (name: string, data: any, isPrivate: boolean) => void;
+};
+/**
+ * Listens to public and private events and delegates to an analytics
+ * stack in a different React root.
+ */
+declare class AnalyticsDelegate extends Component<AnalyticsDelegateProps> {
+    static contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    static childContextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    getChildContext(): AnalyticsDelegateContext;
+    onAnalyticsEvent: (name: string, data: any, isPrivate: boolean) => void;
+    render(): boolean | {} | React.ReactChild | React.ReactPortal | null | undefined;
+}
+export default AnalyticsDelegate;

package/dist/types-ts4.5/components/matchEvent/index.d.ts

@@ -0,0 +1,3 @@
+export type Matcher = string | RegExp | ((name: string) => boolean) | '*';
+declare function matchEvent(matcher: Matcher, name: string): boolean;
+export default matchEvent;

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

@@ -8,5 +8,5 @@ export interface WithAnalyticsEventsProps {
     createAnalyticsEvent?: CreateUIAnalyticsEvent;
     ref?: React.Ref<any>;
 }
-declare const withAnalyticsEvents: (createEventMap?: CreateEventMap) => <Props extends WithAnalyticsEventsProps, Component>(WrappedComponent: React.ComponentType<Props> & Component) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.LibraryManagedAttributes<Component, Omit<Props, keyof WithAnalyticsEventsProps>>> & React.RefAttributes<any>>;
+declare const withAnalyticsEvents: (createEventMap?: CreateEventMap) => <Props, Component>(WrappedComponent: React.ComponentType<WithAnalyticsEventsProps & Props> & Component) => React.ForwardRefExoticComponent<React.PropsWithoutRef<JSX.LibraryManagedAttributes<Component, Omit<Props, keyof WithAnalyticsEventsProps>>> & React.RefAttributes<any>>;
 export default withAnalyticsEvents;

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

@@ -23,3 +23,6 @@ export { usePlatformLeafSyntheticEventHandler } from './hooks/usePlatformLeafSyn
 export type { UsePlatformLeafSyntheticEventHandlerHookArgs, UsePlatformLeafSyntheticEventHandlerHook, } from './hooks/usePlatformLeafSyntheticEventHandler';
 export { default as createAndFireEvent } from './utils/createAndFireEvent';
 export { default as cleanProps } from './utils/cleanProps';
+export { default as AnalyticsDecorator } from './components/AnalyticsDecorator';
+export { default as AnalyticsDelegate } from './components/AnalyticsDelegate';
+export { default as withAnalytics } from './utils/withAnalytics';

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

@@ -0,0 +1,80 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+type AnalyticsData = {
+    [key: string]: any;
+};
+type WithAnalyticsProps = {
+    analyticsId?: string;
+    analyticsData?: AnalyticsData;
+    fireAnalyticsEvent?: (name: string, data?: AnalyticsData) => void;
+    firePrivateAnalyticsEvent?: (name: string, data?: AnalyticsData) => void;
+    getParentAnalyticsData?: (name: string) => AnalyticsData;
+    delegateAnalyticsEvent?: (analyticsId: string, data: any, isPrivate: boolean) => void;
+    innerRef?: React.Ref<any>;
+    [key: string]: any;
+};
+type WithAnalyticsState = {
+    evaluatedMap: {
+        [key: string]: string | ((...args: any[]) => void);
+    };
+};
+/**
+ * The withAnalytics HOC wraps a component and provides the `fireAnalyticsEvent`
+ * and `firePrivateAnalyticsEvent` methods to it as props. It contains the logic
+ * for how to fire events, including handling the analyticsId and analyticsData
+ * props. The `map` argument may be an object or a function that returns an object.
+ * The properties of the `map` object/result can be strings (the name of the event
+ * that will be fired) or functions (which are responsible for firing the event).
+ * You can specify a default `analyticsId` and `analyticsData` with the `defaultProps`
+ * param. Please be aware that specifying a default `analyticsId` will cause public
+ * events to always fire for your component unless it has been set to a falsy by
+ * the component consumer.
+ *
+ * @param WrappedComponent
+ * @param map
+ * @param defaultProps
+ * @param withDelegation
+ */
+declare const withAnalytics: (WrappedComponent: React.ComponentType<any>, map?: {
+    [key: string]: string | ((...args: any[]) => void);
+} | ((fireAnalyticsEvent: (name: string, data?: AnalyticsData) => void) => {
+    [key: string]: string | ((...args: any[]) => void);
+}), defaultProps?: Partial<WithAnalyticsProps>, withDelegation?: boolean) => {
+    new (props: WithAnalyticsProps): {
+        componentDidMount(): void;
+        delegateAnalyticsEvent: (analyticsId: string, data: any, isPrivate: boolean) => void;
+        fireAnalyticsEvent: (name: string, data?: AnalyticsData) => void;
+        privateAnalyticsEvent: (name: string, data?: AnalyticsData) => void;
+        getParentAnalyticsData: (name: string) => AnalyticsData;
+        render(): JSX.Element;
+        context: any;
+        setState<K extends "evaluatedMap">(state: WithAnalyticsState | ((prevState: Readonly<WithAnalyticsState>, props: Readonly<WithAnalyticsProps>) => WithAnalyticsState | Pick<WithAnalyticsState, K> | null) | Pick<WithAnalyticsState, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<WithAnalyticsProps> & Readonly<{
+            children?: React.ReactNode;
+        }>;
+        state: Readonly<WithAnalyticsState>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<WithAnalyticsProps>, prevState: Readonly<WithAnalyticsState>): any;
+        componentDidUpdate?(prevProps: Readonly<WithAnalyticsProps>, prevState: Readonly<WithAnalyticsState>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<WithAnalyticsProps>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<WithAnalyticsProps>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<WithAnalyticsProps>, nextState: Readonly<WithAnalyticsState>, nextContext: any): void;
+    };
+    displayName: string;
+    contextTypes: {
+        onAnalyticsEvent: PropTypes.Requireable<(...args: any[]) => any>;
+        getParentAnalyticsData: PropTypes.Requireable<(...args: any[]) => any>;
+    };
+    defaultProps: Partial<WithAnalyticsProps>;
+    contextType?: React.Context<any> | undefined;
+};
+export default withAnalytics;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/analytics-next",
-	"version": "10.1.0",
+	"version": "10.2.0",
 	"description": "React components, HOCs and hooks to assist with tracking user activity with React components",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -24,18 +24,18 @@
 	"atlaskit:src": "src/index.ts",
 	"atlassian": {
 		"team": "UIP Frontend Observability",
-		"releaseModel": "continuous",
-		"productPushConsumption": [
-			"jira"
-		],
 		"website": {
 			"name": "Analytics next"
-		}
+		},
+		"runReact18": true
 	},
 	"./types": "./src/types.ts",
 	"af:exports": {
 		"./types": "./src/types.ts",
 		"./AnalyticsContext": "./src/components/AnalyticsContext/index.tsx",
+		"./AnalyticsDecorator": "./src/components/AnalyticsDecorator/index.ts",
+		"./AnalyticsDelegate": "./src/components/AnalyticsDelegate/index.ts",
+		"./withAnalytics": "./src/utils/withAnalytics.tsx",
 		"./AnalyticsListener": "./src/components/AnalyticsListener/index.tsx",
 		"./AnalyticsErrorBoundary": "./src/components/AnalyticsErrorBoundary.tsx",
 		"./withAnalyticsEvents": "./src/hocs/withAnalyticsEvents.tsx",
@@ -60,14 +60,11 @@
 		"react": "^16.8.0 || ^17.0.0 || ^18.0.0",
 		"react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0"
 	},
-	"runReact18": true,
 	"devDependencies": {
 		"@atlaskit/ssr": "*",
 		"@atlassian/feature-flags-test-utils": "*",
 		"@testing-library/react": "^12.1.5",
-		"enzyme": "^3.10.0",
-		"redux": "^3.7.2",
-		"storybook-addon-performance": "^0.16.0",
+		"storybook-addon-performance": "^0.17.3",
 		"typescript": "~5.4.2"
 	},
 	"techstack": {
@@ -93,7 +90,7 @@
 		}
 	},
 	"platform-feature-flags": {
-		"platform.analytics-next-use-modern-context_fqgbx": {
+		"analytics-next-use-modern-context_jira": {
 			"type": "boolean"
 		}
 	}