@atlaskit/analytics-next 9.2.3 → 9.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/CHANGELOG.md +330 -132
  2. package/afm-jira/tsconfig.json +25 -0
  3. package/dist/cjs/hocs/withAnalyticsContext.js +1 -5
  4. package/dist/cjs/hocs/withAnalyticsEvents.js +1 -5
  5. package/dist/es2019/hocs/withAnalyticsContext.js +1 -5
  6. package/dist/es2019/hocs/withAnalyticsEvents.js +1 -5
  7. package/dist/esm/hocs/withAnalyticsContext.js +1 -5
  8. package/dist/esm/hocs/withAnalyticsEvents.js +1 -5
  9. package/dist/types/components/AnalyticsContext/LegacyAnalyticsContext.d.ts +1 -1
  10. package/dist/types/components/AnalyticsContext/ModernAnalyticsContext.d.ts +1 -1
  11. package/dist/types/components/AnalyticsContext/index.d.ts +1 -1
  12. package/dist/types/components/AnalyticsContext/types.d.ts +1 -1
  13. package/dist/types/components/AnalyticsErrorBoundary.d.ts +2 -2
  14. package/dist/types/components/AnalyticsListener/LegacyAnalyticsListener.d.ts +2 -2
  15. package/dist/types/components/AnalyticsListener/ModernAnalyticsListener.d.ts +1 -1
  16. package/dist/types/components/AnalyticsListener/index.d.ts +1 -1
  17. package/dist/types/components/AnalyticsListener/types.d.ts +2 -2
  18. package/dist/types/events/UIAnalyticsEvent.d.ts +1 -1
  19. package/dist/types/hocs/withAnalyticsContext.d.ts +1 -1
  20. package/dist/types/hocs/withAnalyticsEvents.d.ts +2 -2
  21. package/dist/types/hooks/useAnalyticsContext.d.ts +1 -1
  22. package/dist/types/hooks/useAnalyticsEvents.d.ts +1 -1
  23. package/dist/types/hooks/usePatchedProps.d.ts +1 -1
  24. package/dist/types/hooks/usePlatformLeafEventHandler.d.ts +1 -1
  25. package/dist/types/hooks/usePlatformLeafSyntheticEventHandler.d.ts +1 -1
  26. package/dist/types/hooks/useTrackedRef.d.ts +1 -1
  27. package/dist/types/index.d.ts +4 -4
  28. package/dist/types/types.d.ts +2 -2
  29. package/dist/types/utils/createAndFireEvent.d.ts +2 -2
  30. package/dist/types-ts4.5/components/AnalyticsContext/LegacyAnalyticsContext.d.ts +1 -1
  31. package/dist/types-ts4.5/components/AnalyticsContext/ModernAnalyticsContext.d.ts +1 -1
  32. package/dist/types-ts4.5/components/AnalyticsContext/index.d.ts +1 -1
  33. package/dist/types-ts4.5/components/AnalyticsContext/types.d.ts +1 -1
  34. package/dist/types-ts4.5/components/AnalyticsErrorBoundary.d.ts +2 -2
  35. package/dist/types-ts4.5/components/AnalyticsListener/LegacyAnalyticsListener.d.ts +2 -2
  36. package/dist/types-ts4.5/components/AnalyticsListener/ModernAnalyticsListener.d.ts +1 -1
  37. package/dist/types-ts4.5/components/AnalyticsListener/index.d.ts +1 -1
  38. package/dist/types-ts4.5/components/AnalyticsListener/types.d.ts +2 -2
  39. package/dist/types-ts4.5/events/UIAnalyticsEvent.d.ts +1 -1
  40. package/dist/types-ts4.5/hocs/withAnalyticsContext.d.ts +1 -1
  41. package/dist/types-ts4.5/hocs/withAnalyticsEvents.d.ts +2 -2
  42. package/dist/types-ts4.5/hooks/useAnalyticsContext.d.ts +1 -1
  43. package/dist/types-ts4.5/hooks/useAnalyticsEvents.d.ts +1 -1
  44. package/dist/types-ts4.5/hooks/usePatchedProps.d.ts +1 -1
  45. package/dist/types-ts4.5/hooks/usePlatformLeafEventHandler.d.ts +1 -1
  46. package/dist/types-ts4.5/hooks/usePlatformLeafSyntheticEventHandler.d.ts +1 -1
  47. package/dist/types-ts4.5/hooks/useTrackedRef.d.ts +1 -1
  48. package/dist/types-ts4.5/index.d.ts +4 -4
  49. package/dist/types-ts4.5/types.d.ts +2 -2
  50. package/dist/types-ts4.5/utils/createAndFireEvent.d.ts +2 -2
  51. package/docs/0-intro.tsx +17 -17
  52. package/docs/20-usage-with-presentational-components.tsx +38 -39
  53. package/docs/40-listeners.tsx +5 -5
  54. package/docs/50-error-boundary.tsx +5 -5
  55. package/docs/70-advanced-usage.tsx +21 -21
  56. package/package.json +98 -100
  57. package/report.api.md +115 -125
package/report.api.md CHANGED
@@ -2,7 +2,8 @@
2
2
 
3
3
  ## API Report File for "@atlaskit/analytics-next"
4
4
 
5
- > Do not edit this file. This report is auto-generated using [API Extractor](https://api-extractor.com/).
5
+ > Do not edit this file. This report is auto-generated using
6
+ > [API Extractor](https://api-extractor.com/).
6
7
  > [Learn more about API reports](https://hello.atlassian.net/wiki/spaces/UR/pages/1825484529/Package+API+Reports)
7
8
 
8
9
  ### Table of contents
@@ -28,70 +29,68 @@ export let AnalyticsContext: AnalyticsContextFunction;
28
29
 
29
30
  // @public (undocumented)
30
31
  type AnalyticsContextFunction = (
31
- props: {
32
- children: React.ReactNode;
33
- data: Object;
34
- },
35
- context?: AnalyticsReactContextInterface,
32
+ props: {
33
+ children: React.ReactNode;
34
+ data: Object;
35
+ },
36
+ context?: AnalyticsReactContextInterface,
36
37
  ) => JSX.Element;
37
38
 
38
39
  // @public @deprecated (undocumented)
39
40
  export class AnalyticsErrorBoundary extends Component<
40
- AnalyticsErrorBoundaryProps,
41
- AnalyticsErrorBoundaryState
41
+ AnalyticsErrorBoundaryProps,
42
+ AnalyticsErrorBoundaryState
42
43
  > {
43
- constructor(props: AnalyticsErrorBoundaryProps);
44
- // (undocumented)
45
- componentDidCatch(error: Error, info?: AnalyticsErrorBoundaryErrorInfo): void;
46
- // (undocumented)
47
- render(): JSX.Element | null;
44
+ constructor(props: AnalyticsErrorBoundaryProps);
45
+ // (undocumented)
46
+ componentDidCatch(error: Error, info?: AnalyticsErrorBoundaryErrorInfo): void;
47
+ // (undocumented)
48
+ render(): JSX.Element | null;
48
49
  }
49
50
 
50
51
  // @public (undocumented)
51
52
  type AnalyticsErrorBoundaryErrorInfo = {
52
- componentStack: string;
53
+ componentStack: string;
53
54
  };
54
55
 
55
56
  // @public (undocumented)
56
57
  export interface AnalyticsErrorBoundaryProps {
57
- // (undocumented)
58
- channel: string;
59
- children: ReactNode;
60
- // (undocumented)
61
- data: {};
62
- // (undocumented)
63
- ErrorComponent?: React_2.ComponentType;
64
- // (undocumented)
65
- onError?: (error: Error, info?: AnalyticsErrorBoundaryErrorInfo) => void;
58
+ // (undocumented)
59
+ channel: string;
60
+ children: ReactNode;
61
+ // (undocumented)
62
+ data: {};
63
+ // (undocumented)
64
+ ErrorComponent?: React_2.ComponentType;
65
+ // (undocumented)
66
+ onError?: (error: Error, info?: AnalyticsErrorBoundaryErrorInfo) => void;
66
67
  }
67
68
 
68
69
  // @public (undocumented)
69
70
  type AnalyticsErrorBoundaryState = {
70
- hasError: boolean;
71
+ hasError: boolean;
71
72
  };
72
73
 
73
74
  // @public (undocumented)
74
75
  export class AnalyticsEvent {
75
- constructor(props: AnalyticsEventProps);
76
- // (undocumented)
77
- clone: () => AnalyticsEvent | null;
78
- // (undocumented)
79
- _isAnalyticsEvent: boolean;
80
- // (undocumented)
81
- payload: AnalyticsEventPayload;
82
- // (undocumented)
83
- update(updater: AnalyticsEventUpdater): this;
76
+ constructor(props: AnalyticsEventProps);
77
+ // (undocumented)
78
+ clone: () => AnalyticsEvent | null;
79
+ // (undocumented)
80
+ _isAnalyticsEvent: boolean;
81
+ // (undocumented)
82
+ payload: AnalyticsEventPayload;
83
+ // (undocumented)
84
+ update(updater: AnalyticsEventUpdater): this;
84
85
  }
85
86
 
86
87
  // @public (undocumented)
87
- type AnalyticsEventCallback = (
88
- payload: AnalyticsEventPayload,
89
- ) => AnalyticsEventPayload;
88
+ type AnalyticsEventCallback = (payload: AnalyticsEventPayload) => AnalyticsEventPayload;
90
89
 
91
90
  // @public (undocumented)
92
91
  type AnalyticsEventCreator = (
93
- create: CreateUIAnalyticsEvent,
94
- props: Record<string, any>,
92
+ create: CreateUIAnalyticsEvent,
93
+ props: Record<string, any>,
95
94
  ) => UIAnalyticsEvent | undefined;
96
95
 
97
96
  // @public (undocumented)
@@ -99,7 +98,7 @@ export type AnalyticsEventPayload = Record<string, any>;
99
98
 
100
99
  // @public (undocumented)
101
100
  export type AnalyticsEventProps = {
102
- payload: AnalyticsEventPayload;
101
+ payload: AnalyticsEventPayload;
103
102
  };
104
103
 
105
104
  // @public (undocumented)
@@ -110,12 +109,12 @@ export let AnalyticsListener: AnalyticsListenerFunction;
110
109
 
111
110
  // @public (undocumented)
112
111
  type AnalyticsListenerFunction = (
113
- props: {
114
- children?: React.ReactNode;
115
- channel?: string;
116
- onEvent: (event: UIAnalyticsEvent, channel?: string) => void;
117
- },
118
- context?: AnalyticsReactContextInterface,
112
+ props: {
113
+ children?: React.ReactNode;
114
+ channel?: string;
115
+ onEvent: (event: UIAnalyticsEvent, channel?: string) => void;
116
+ },
117
+ context?: AnalyticsReactContextInterface,
119
118
  ) => JSX.Element;
120
119
 
121
120
  export { AnalyticsReactContext };
@@ -127,7 +126,7 @@ type ChannelIdentifier = string;
127
126
 
128
127
  // @public (undocumented)
129
128
  export function cleanProps(props: Record<string, any>): {
130
- [x: string]: any;
129
+ [x: string]: any;
131
130
  };
132
131
 
133
132
  // @public (undocumented)
@@ -135,9 +134,9 @@ type Context = Record<string, any>[];
135
134
 
136
135
  // @public (undocumented)
137
136
  export const createAndFireEvent: (
138
- channel?: string,
137
+ channel?: string,
139
138
  ) => (
140
- payload: AnalyticsEventPayload,
139
+ payload: AnalyticsEventPayload,
141
140
  ) => (createAnalyticsEvent: CreateUIAnalyticsEvent) => UIAnalyticsEvent;
142
141
 
143
142
  // @public (undocumented)
@@ -147,9 +146,7 @@ type CreateEventMap = Record<string, CreateEventMapValue>;
147
146
  type CreateEventMapValue = AnalyticsEventCreator | AnalyticsEventPayload;
148
147
 
149
148
  // @public (undocumented)
150
- export type CreateUIAnalyticsEvent = (
151
- payload: AnalyticsEventPayload,
152
- ) => UIAnalyticsEvent;
149
+ export type CreateUIAnalyticsEvent = (payload: AnalyticsEventPayload) => UIAnalyticsEvent;
153
150
 
154
151
  // @public (undocumented)
155
152
  export const isAnalyticsEvent: (obj: any) => boolean;
@@ -159,37 +156,35 @@ export const isUIAnalyticsEvent: (obj: any) => boolean;
159
156
 
160
157
  // @public (undocumented)
161
158
  export class UIAnalyticsEvent extends AnalyticsEvent {
162
- constructor(props: UIAnalyticsEventProps);
163
- // (undocumented)
164
- clone: () => UIAnalyticsEvent | null;
165
- // (undocumented)
166
- context: Context;
167
- // (undocumented)
168
- fire: (channel?: string) => void;
169
- // (undocumented)
170
- handlers: UIAnalyticsEventHandler[];
171
- // (undocumented)
172
- hasFired: boolean;
173
- // (undocumented)
174
- _isUIAnalyticsEvent: boolean;
175
- // (undocumented)
176
- update(
177
- updater:
178
- | ((payload: AnalyticsEventPayload) => AnalyticsEventPayload)
179
- | Record<string, any>,
180
- ): this;
159
+ constructor(props: UIAnalyticsEventProps);
160
+ // (undocumented)
161
+ clone: () => UIAnalyticsEvent | null;
162
+ // (undocumented)
163
+ context: Context;
164
+ // (undocumented)
165
+ fire: (channel?: string) => void;
166
+ // (undocumented)
167
+ handlers: UIAnalyticsEventHandler[];
168
+ // (undocumented)
169
+ hasFired: boolean;
170
+ // (undocumented)
171
+ _isUIAnalyticsEvent: boolean;
172
+ // (undocumented)
173
+ update(
174
+ updater: ((payload: AnalyticsEventPayload) => AnalyticsEventPayload) | Record<string, any>,
175
+ ): this;
181
176
  }
182
177
 
183
178
  // @public (undocumented)
184
179
  export type UIAnalyticsEventHandler = (
185
- event: UIAnalyticsEvent,
186
- channel?: ChannelIdentifier,
180
+ event: UIAnalyticsEvent,
181
+ channel?: ChannelIdentifier,
187
182
  ) => void;
188
183
 
189
184
  // @public (undocumented)
190
185
  export type UIAnalyticsEventProps = AnalyticsEventProps & {
191
- context?: Context;
192
- handlers?: UIAnalyticsEventHandler[];
186
+ context?: Context;
187
+ handlers?: UIAnalyticsEventHandler[];
193
188
  };
194
189
 
195
190
  // @public (undocumented)
@@ -197,7 +192,7 @@ export function useAnalyticsEvents(): UseAnalyticsEventsHook;
197
192
 
198
193
  // @public (undocumented)
199
194
  export type UseAnalyticsEventsHook = {
200
- createAnalyticsEvent: CreateUIAnalyticsEvent;
195
+ createAnalyticsEvent: CreateUIAnalyticsEvent;
201
196
  };
202
197
 
203
198
  // @public (undocumented)
@@ -205,20 +200,20 @@ export const useCallbackWithAnalytics: UseCallbackWithAnalyticsHook;
205
200
 
206
201
  // @public (undocumented)
207
202
  export type UseCallbackWithAnalyticsHook = (
208
- method: (...args: any[]) => void,
209
- payload: ((...args: any[]) => void) | Record<string, any>,
210
- channel?: string,
203
+ method: (...args: any[]) => void,
204
+ payload: ((...args: any[]) => void) | Record<string, any>,
205
+ channel?: string,
211
206
  ) => (...args: any[]) => void;
212
207
 
213
208
  // @public (undocumented)
214
209
  export function usePlatformLeafEventHandler<T>({
215
- fn,
216
- action,
217
- componentName,
218
- actionSubject,
219
- packageName,
220
- packageVersion,
221
- analyticsData,
210
+ fn,
211
+ action,
212
+ componentName,
213
+ actionSubject,
214
+ packageName,
215
+ packageVersion,
216
+ analyticsData,
222
217
  }: UsePlatformLeafEventHandlerHookArgs<T>): (value: T) => void;
223
218
 
224
219
  // @public (undocumented)
@@ -226,23 +221,23 @@ export type UsePlatformLeafEventHandlerHook<T> = (value: T) => void;
226
221
 
227
222
  // @public (undocumented)
228
223
  export type UsePlatformLeafEventHandlerHookArgs<T> = {
229
- fn: (value: T, analyticsEvent: UIAnalyticsEvent) => void;
230
- action: string;
231
- componentName: string;
232
- actionSubject?: string;
233
- packageName: string;
234
- packageVersion: string;
235
- analyticsData?: Record<string, any>;
224
+ fn: (value: T, analyticsEvent: UIAnalyticsEvent) => void;
225
+ action: string;
226
+ componentName: string;
227
+ actionSubject?: string;
228
+ packageName: string;
229
+ packageVersion: string;
230
+ analyticsData?: Record<string, any>;
236
231
  };
237
232
 
238
233
  // @public (undocumented)
239
234
  export function usePlatformLeafSyntheticEventHandler({
240
- fn,
241
- action,
242
- componentName,
243
- packageName,
244
- packageVersion,
245
- analyticsData,
235
+ fn,
236
+ action,
237
+ componentName,
238
+ packageName,
239
+ packageVersion,
240
+ analyticsData,
246
241
  }: UsePlatformLeafSyntheticEventHandlerHookArgs): () => void;
247
242
 
248
243
  // @public (undocumented)
@@ -250,52 +245,47 @@ export type UsePlatformLeafSyntheticEventHandlerHook = () => void;
250
245
 
251
246
  // @public (undocumented)
252
247
  export type UsePlatformLeafSyntheticEventHandlerHookArgs = {
253
- fn: (analyticsEvent: UIAnalyticsEvent) => void;
254
- action: string;
255
- componentName: string;
256
- packageName: string;
257
- packageVersion: string;
258
- analyticsData?: Record<string, any>;
248
+ fn: (analyticsEvent: UIAnalyticsEvent) => void;
249
+ action: string;
250
+ componentName: string;
251
+ packageName: string;
252
+ packageVersion: string;
253
+ analyticsData?: Record<string, any>;
259
254
  };
260
255
 
261
256
  // @public (undocumented)
262
257
  export const withAnalyticsContext: (
263
- defaultData?: any,
258
+ defaultData?: any,
264
259
  ) => <Props, Component>(
265
- WrappedComponent: React_2.JSXElementConstructor<Props> & Component,
260
+ WrappedComponent: React_2.JSXElementConstructor<Props> & Component,
266
261
  ) => React_2.ForwardRefExoticComponent<
267
- React_2.PropsWithoutRef<
268
- JSX.LibraryManagedAttributes<Component, Props & WithContextProps>
269
- > &
270
- React_2.RefAttributes<any>
262
+ React_2.PropsWithoutRef<JSX.LibraryManagedAttributes<Component, Props & WithContextProps>> &
263
+ React_2.RefAttributes<any>
271
264
  >;
272
265
 
273
266
  // @public (undocumented)
274
267
  export const withAnalyticsEvents: (
275
- createEventMap?: CreateEventMap,
268
+ createEventMap?: CreateEventMap,
276
269
  ) => <Props extends WithAnalyticsEventsProps, Component>(
277
- WrappedComponent: React_2.JSXElementConstructor<Props> & Component,
270
+ WrappedComponent: React_2.JSXElementConstructor<Props> & Component,
278
271
  ) => React_2.ForwardRefExoticComponent<
279
- React_2.PropsWithoutRef<
280
- JSX.LibraryManagedAttributes<
281
- Component,
282
- Omit<Props, keyof WithAnalyticsEventsProps>
283
- >
284
- > &
285
- React_2.RefAttributes<any>
272
+ React_2.PropsWithoutRef<
273
+ JSX.LibraryManagedAttributes<Component, Omit<Props, keyof WithAnalyticsEventsProps>>
274
+ > &
275
+ React_2.RefAttributes<any>
286
276
  >;
287
277
 
288
278
  // @public (undocumented)
289
279
  export interface WithAnalyticsEventsProps {
290
- createAnalyticsEvent?: CreateUIAnalyticsEvent;
291
- // (undocumented)
292
- ref?: React_2.Ref<any>;
280
+ createAnalyticsEvent?: CreateUIAnalyticsEvent;
281
+ // (undocumented)
282
+ ref?: React_2.Ref<any>;
293
283
  }
294
284
 
295
285
  // @public (undocumented)
296
286
  export interface WithContextProps {
297
- // (undocumented)
298
- analyticsContext?: Record<string, any>;
287
+ // (undocumented)
288
+ analyticsContext?: Record<string, any>;
299
289
  }
300
290
 
301
291
  // (No @packageDocumentation comment for this package)
@@ -309,7 +299,7 @@ export interface WithContextProps {
309
299
 
310
300
  ```json
311
301
  {
312
- "react": "^16.8.0"
302
+ "react": "^16.8.0"
313
303
  }
314
304
  ```
315
305