@applicaster/zapp-react-native-utils 14.0.0-alpha.3126393935 → 14.0.0-alpha.3216572828

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 (68) hide show
  1. package/actionsExecutor/ActionExecutorContext.tsx +83 -60
  2. package/analyticsUtils/AnalyticsEvents/helper.ts +1 -1
  3. package/analyticsUtils/AnalyticsEvents/sendHeaderClickEvent.ts +1 -1
  4. package/analyticsUtils/AnalyticsEvents/sendMenuClickEvent.ts +2 -1
  5. package/analyticsUtils/index.tsx +3 -4
  6. package/analyticsUtils/manager.ts +1 -1
  7. package/appUtils/HooksManager/Hook.ts +4 -4
  8. package/appUtils/HooksManager/index.ts +11 -1
  9. package/appUtils/accessibilityManager/index.ts +3 -3
  10. package/appUtils/contextKeysManager/contextResolver.ts +1 -14
  11. package/appUtils/focusManager/__tests__/__snapshots__/focusManager.test.js.snap +5 -0
  12. package/appUtils/focusManager/__tests__/focusManager.test.js +1 -1
  13. package/appUtils/focusManager/index.ios.ts +10 -0
  14. package/appUtils/focusManager/index.ts +82 -11
  15. package/appUtils/focusManager/treeDataStructure/Tree/index.js +1 -1
  16. package/appUtils/focusManagerAux/utils/index.ts +106 -3
  17. package/appUtils/playerManager/OverlayObserver/OverlaysObserver.ts +0 -15
  18. package/appUtils/playerManager/useChapterMarker.tsx +0 -1
  19. package/appUtils/playerManager/usePlayerControllerSetup.tsx +16 -0
  20. package/arrayUtils/index.ts +1 -1
  21. package/componentsUtils/__tests__/isTabsScreen.test.ts +38 -0
  22. package/componentsUtils/index.ts +4 -1
  23. package/configurationUtils/__tests__/manifestKeyParser.test.ts +546 -0
  24. package/configurationUtils/manifestKeyParser.ts +57 -32
  25. package/index.d.ts +0 -9
  26. package/navigationUtils/__tests__/mapContentTypesToRivers.test.ts +130 -0
  27. package/navigationUtils/index.ts +6 -4
  28. package/package.json +2 -3
  29. package/playerUtils/index.ts +51 -0
  30. package/reactHooks/autoscrolling/__tests__/useTrackedView.test.tsx +15 -14
  31. package/reactHooks/cell-click/index.ts +1 -8
  32. package/reactHooks/debugging/__tests__/index.test.js +0 -1
  33. package/reactHooks/feed/__tests__/useBatchLoading.test.tsx +39 -88
  34. package/reactHooks/feed/__tests__/useFeedLoader.test.tsx +0 -20
  35. package/reactHooks/feed/useBatchLoading.ts +8 -6
  36. package/reactHooks/feed/useFeedLoader.tsx +14 -17
  37. package/reactHooks/feed/usePipesCacheReset.ts +2 -2
  38. package/reactHooks/flatList/useSequentialRenderItem.tsx +3 -3
  39. package/reactHooks/layout/__tests__/index.test.tsx +3 -1
  40. package/reactHooks/layout/isTablet/index.ts +12 -5
  41. package/reactHooks/layout/useDimensions/__tests__/useDimensions.test.ts +34 -36
  42. package/reactHooks/layout/useDimensions/useDimensions.ts +2 -3
  43. package/reactHooks/layout/useLayoutVersion.ts +5 -5
  44. package/reactHooks/navigation/index.ts +7 -5
  45. package/reactHooks/navigation/useRoute.ts +2 -7
  46. package/reactHooks/resolvers/__tests__/useCellResolver.test.tsx +4 -0
  47. package/reactHooks/state/index.ts +1 -1
  48. package/reactHooks/state/useHomeRiver.ts +4 -2
  49. package/reactHooks/state/useRivers.ts +7 -8
  50. package/screenPickerUtils/index.ts +7 -0
  51. package/testUtils/index.tsx +7 -8
  52. package/time/BackgroundTimer.ts +1 -1
  53. package/utils/__tests__/find.test.ts +36 -0
  54. package/utils/__tests__/pathOr.test.ts +37 -0
  55. package/utils/__tests__/startsWith.test.ts +30 -0
  56. package/utils/find.ts +3 -0
  57. package/utils/index.ts +8 -0
  58. package/utils/pathOr.ts +5 -0
  59. package/utils/startsWith.ts +9 -0
  60. package/actionsExecutor/ScreenActions.ts +0 -163
  61. package/actionsExecutor/StorageActions.ts +0 -110
  62. package/actionsExecutor/feedDecorator.ts +0 -171
  63. package/actionsExecutor/screenResolver.ts +0 -11
  64. package/reactHooks/navigation/useScreenStateStore.ts +0 -8
  65. package/storage/ScreenSingleValueProvider.ts +0 -201
  66. package/storage/ScreenStateMultiSelectProvider.ts +0 -290
  67. package/storage/StorageMultiSelectProvider.ts +0 -192
  68. package/storage/StorageSingleSelectProvider.ts +0 -108
@@ -16,6 +16,7 @@ import { QUICK_BRICK_EVENTS } from "@applicaster/zapp-react-native-bridge/QuickB
16
16
  import { showConfirmationDialog } from "../alertUtils";
17
17
  import { createCloudEvent, sendCloudEvent } from "../cloudEventsUtils";
18
18
  import { createLogger } from "../logger";
19
+ import { StorageMultiSelectProvider } from "@applicaster/zapp-react-native-bridge/ZappStorage/StorageMultiSelectProvider";
19
20
  import { ACTIVE_LAYOUT_ID_STORAGE_KEY } from "@applicaster/quick-brick-core/App/remoteContextReloader/consts";
20
21
  import { appStore } from "@applicaster/zapp-react-native-redux/AppStore";
21
22
  import { loadPipesData } from "@applicaster/zapp-react-native-redux/ZappPipes";
@@ -24,19 +25,15 @@ import {
24
25
  resolveObjectValues,
25
26
  } from "../appUtils/contextKeysManager/contextResolver";
26
27
  import { useNavigation } from "../reactHooks";
28
+ import { get } from "../utils";
27
29
 
28
30
  import {
29
31
  useContentTypes,
30
32
  usePickFromState,
31
33
  } from "@applicaster/zapp-react-native-redux/hooks";
32
- import { useSubscriberFor } from "../reactHooks/useSubscriberFor";
34
+ import { TOGGLE_FLAG_MAX_ITEMS_REACHED_EVENT } from "./consts";
35
+ import { postEvent, useSubscriberFor } from "../reactHooks/useSubscriberFor";
33
36
  import { APP_EVENTS } from "../appUtils/events";
34
- import {
35
- localStorageToggleFlag,
36
- sessionStorageToggleFlag,
37
- } from "./StorageActions";
38
-
39
- import { screenSetVariable, screenToggleFlag } from "./ScreenActions";
40
37
 
41
38
  export const { log_error, log_info, log_debug } = createLogger({
42
39
  subsystem: "ActionExecutorContext",
@@ -85,6 +82,19 @@ function findParentComponent(
85
82
  return null;
86
83
  }
87
84
 
85
+ // send all data just in case (like for message string formatting)
86
+ // Type is not exported for now
87
+ type MaxTagsReachedEvent = {
88
+ selectedItems: string[];
89
+ maxItems: number;
90
+ tag: string;
91
+ keyNamespace: string;
92
+ };
93
+
94
+ async function onMaxTagsReached(data: MaxTagsReachedEvent) {
95
+ postEvent(TOGGLE_FLAG_MAX_ITEMS_REACHED_EVENT, [data]);
96
+ }
97
+
88
98
  const prepareDefaultActions = (actionExecutor) => {
89
99
  actionExecutor.registerAction("localStorageSet", async (action) => {
90
100
  const namespaces = action.options.content;
@@ -168,15 +178,10 @@ const prepareDefaultActions = (actionExecutor) => {
168
178
 
169
179
  const entry = context?.entry || {};
170
180
  const entryResolver = new EntryResolver(entry);
171
- const screenData = context?.screenStateStore.getState().data || {};
172
- const screenResolver = new EntryResolver(screenData || {});
173
181
 
174
182
  const data =
175
183
  options?.data && options.inflateData
176
- ? await resolveObjectValues(options.data, {
177
- entry: entryResolver,
178
- screen: screenResolver,
179
- })
184
+ ? await resolveObjectValues(options.data, { entry: entryResolver })
180
185
  : options?.data || entry;
181
186
 
182
187
  const cloudEvent = await createCloudEvent({
@@ -210,63 +215,81 @@ const prepareDefaultActions = (actionExecutor) => {
210
215
  return ActionResult.Error;
211
216
  });
212
217
 
213
- actionExecutor.registerAction(
214
- "sessionStorageToggleFlag",
215
- async (
216
- action: ActionType,
217
- context?: Record<string, any>
218
- ): Promise<ActionResult> => {
219
- return await sessionStorageToggleFlag(context, action);
220
- }
221
- );
222
-
223
218
  actionExecutor.registerAction(
224
219
  "localStorageToggleFlag",
225
220
  async (
226
221
  action: ActionType,
227
222
  context?: Record<string, any>
228
223
  ): Promise<ActionResult> => {
229
- return await localStorageToggleFlag(context, action);
230
- }
231
- );
224
+ if (!context) {
225
+ log_error(
226
+ "handleAction: localStorageToggleFlag action missing context"
227
+ );
232
228
 
233
- actionExecutor.registerAction(
234
- "screenSetVariable",
235
- async (
236
- action: ActionType,
237
- context?: Record<string, any>
238
- ): Promise<ActionResult> => {
239
- const route = context?.screenRoute;
240
- const screenStateStore = context?.screenStateStore;
241
-
242
- await screenSetVariable(
243
- route,
244
- screenStateStore,
245
- { entry: context?.entry, options: action.options },
246
- action
247
- );
229
+ return ActionResult.Error;
230
+ }
248
231
 
249
- return Promise.resolve(ActionResult.Success);
250
- }
251
- );
232
+ const entry = context?.entry as ZappEntry;
252
233
 
253
- actionExecutor.registerAction(
254
- "screenToggleFlag",
255
- async (
256
- action: ActionType,
257
- context?: Record<string, any>
258
- ): Promise<ActionResult> => {
259
- const screenRoute = context?.screenRoute;
260
- const screenStateStore = context?.screenStateStore;
261
-
262
- await screenToggleFlag(
263
- screenRoute,
264
- screenStateStore,
265
- { entry: context?.entry, options: action.options },
266
- action
267
- );
234
+ if (!entry) {
235
+ log_error(
236
+ "handleAction: localStorageToggleFlag action missing entry. Entry is required to get the tag."
237
+ );
238
+
239
+ return ActionResult.Error;
240
+ }
241
+
242
+ const tag = action.options?.selector
243
+ ? get(entry, action.options.selector)
244
+ : (entry.extensions?.tag ?? entry.id);
245
+
246
+ const keyNamespace = action.options?.key;
247
+
248
+ if (keyNamespace && tag) {
249
+ const multiSelectProvider =
250
+ StorageMultiSelectProvider.getProvider(keyNamespace);
251
+
252
+ const selectedItems = await multiSelectProvider.getSelectedAsync();
253
+ const isTagInSelectedItems = selectedItems.includes(tag);
268
254
 
269
- return Promise.resolve(ActionResult.Success);
255
+ log_info(
256
+ `handleAction: localStorageToggleFlag event will ${
257
+ isTagInSelectedItems ? "remove" : "add"
258
+ } tag: ${tag} for keyNamespace: ${keyNamespace}, current selectedItems: ${selectedItems}`
259
+ );
260
+
261
+ if (selectedItems.includes(tag)) {
262
+ await multiSelectProvider.removeItem(tag);
263
+ } else {
264
+ const maxItems = action.options?.max_items;
265
+
266
+ if (maxItems && selectedItems.length >= maxItems) {
267
+ log_info(
268
+ `handleAction: localStorageToggleFlag event reached max items limit: ${maxItems}, cannot add tag: ${tag}`
269
+ );
270
+
271
+ await onMaxTagsReached({
272
+ selectedItems,
273
+ maxItems,
274
+ tag,
275
+ keyNamespace,
276
+ });
277
+
278
+ return ActionResult.Cancel;
279
+ }
280
+
281
+ await multiSelectProvider.addItem(tag);
282
+ }
283
+ } else {
284
+ log_error(
285
+ "handleAction: localStorageToggleFlag event missing keyNamespace or tag",
286
+ { keyNamespace, tag }
287
+ );
288
+
289
+ return ActionResult.Error;
290
+ }
291
+
292
+ return ActionResult.Success;
270
293
  }
271
294
  );
272
295
  };
@@ -9,7 +9,7 @@ import {
9
9
  } from "../events";
10
10
  import { isEmptyOrNil } from "../../cellUtils";
11
11
  import { get } from "lodash";
12
- import { StorageMultiSelectProvider } from "@applicaster/zapp-react-native-utils/storage/StorageMultiSelectProvider";
12
+ import { StorageMultiSelectProvider } from "@applicaster/zapp-react-native-bridge/ZappStorage/StorageMultiSelectProvider";
13
13
 
14
14
  export enum OfflineItemState {
15
15
  notExist = "NOT_EXISTS",
@@ -4,7 +4,7 @@ import { postAnalyticEvent } from "../manager";
4
4
  import { ANALYTICS_CORE_EVENTS } from "../events";
5
5
 
6
6
  type SendHeaderClickEventProps = {
7
- extraProps: ExtraProps;
7
+ extraProps: Record<string, any>;
8
8
  component?: ZappUIComponent;
9
9
  zappPipesData?: ZappPipesData;
10
10
  item?: ZappEntry;
@@ -1,10 +1,11 @@
1
+ /// <reference types="../../" />
1
2
  import { log_error, log_debug } from "../logger";
2
3
  import { replaceAnalyticsPropsNils } from "./helper";
3
4
  import { postAnalyticEvent } from "../manager";
4
5
 
5
6
  import { ANALYTICS_CORE_EVENTS } from "../events";
6
7
 
7
- declare type AnalyticsDefaultHelperProperties = {
8
+ type AnalyticsDefaultHelperProperties = {
8
9
  analyticsScreenData: AnalyticsScreenProperties;
9
10
  extraProps: any;
10
11
  props;
@@ -1,4 +1,3 @@
1
- /// <reference types="@applicaster/zapp-react-native-utils" />
2
1
  import * as R from "ramda";
3
2
  import * as React from "react";
4
3
  import { isWeb } from "@applicaster/zapp-react-native-utils/reactUtils";
@@ -31,7 +30,7 @@ import { ANALYTICS_CORE_EVENTS } from "./events";
31
30
  import { noop } from "../functionUtils";
32
31
 
33
32
  type ComponentWithChildrenProps = {
34
- children: React.ReactChildren;
33
+ children: React.ReactElement;
35
34
  };
36
35
 
37
36
  export function sendSelectCellEvent(item, component, headerTitle, itemIndex) {
@@ -120,11 +119,11 @@ export function getAnalyticsFunctions({
120
119
  export const AnalyticsContext =
121
120
  React.createContext<GetAnalyticsFunctions>(noop);
122
121
 
123
- export function AnalyticsProvider(props: ComponentWithChildrenProps) {
122
+ export function AnalyticsProvider({ children }: ComponentWithChildrenProps) {
124
123
  return (
125
124
  // @ts-ignore - this is a valid context provider
126
125
  <AnalyticsContext.Provider value={getAnalyticsFunctions}>
127
- {props?.children}
126
+ {children}
128
127
  </AnalyticsContext.Provider>
129
128
  );
130
129
  }
@@ -1,7 +1,7 @@
1
1
  /* eslint-disable @typescript-eslint/no-use-before-define */
2
2
  import * as R from "ramda";
3
3
  import { NativeModules } from "react-native";
4
- import { ANALYTICS_CORE_EVENTS } from "@applicaster/zapp-react-native-utils/analyticsUtils/events";
4
+ import { ANALYTICS_CORE_EVENTS } from "./events";
5
5
 
6
6
  import { analyticsUtilsLogger } from "./logger";
7
7
 
@@ -65,10 +65,6 @@ export class Hook implements HookInterface {
65
65
  event: (typeof HOOKS_EVENTS)[keyof typeof HOOKS_EVENTS],
66
66
  ...args
67
67
  ) {
68
- if (this.state === hookState(HOOKS_EVENTS.CANCEL)) {
69
- return;
70
- }
71
-
72
68
  this.state = hookState(event);
73
69
  this.manager.subscriber.invokeHandler(event, ...args);
74
70
  }
@@ -198,4 +194,8 @@ export class Hook implements HookInterface {
198
194
  R.eqProps("weight", nextHook, this)
199
195
  );
200
196
  }
197
+
198
+ isCancelled(): boolean {
199
+ return this.state === hookState(HOOKS_EVENTS.CANCEL);
200
+ }
201
201
  }
@@ -255,7 +255,7 @@ export function HooksManager({
255
255
  * @param {Array<Hook>} restOfHooks to run
256
256
  * @returns {function} callback function
257
257
  */
258
- function hookCallback(hookPlugin, restOfHooks, initialPayload) {
258
+ function hookCallback(hookPlugin: Hook, restOfHooks: Hook[], initialPayload) {
259
259
  /**
260
260
  * callback invoked after a hook is executed
261
261
  * @param {object} options
@@ -273,6 +273,16 @@ export function HooksManager({
273
273
  }) {
274
274
  let callback = callbackArg;
275
275
 
276
+ if (hookPlugin.isCancelled()) {
277
+ logHookEvent(
278
+ hooksManagerLogger.info,
279
+ `hookCallback: hook was cancelled: ${hookPlugin["identifier"]}`,
280
+ {}
281
+ );
282
+
283
+ return;
284
+ }
285
+
276
286
  if (error) {
277
287
  logHookEvent(
278
288
  hooksManagerLogger.error,
@@ -2,8 +2,8 @@ import { BehaviorSubject } from "rxjs";
2
2
  import { accessibilityManagerLogger as logger } from "./logger";
3
3
  import { TTSManager } from "../platform";
4
4
  import { BUTTON_ACCESSIBILITY_KEYS } from "./const";
5
- import { AccessibilityRole } from "react-native";
6
5
  import { toString } from "../../utils";
6
+ import { AccessibilityRole } from "react-native";
7
7
 
8
8
  export class AccessibilityManager {
9
9
  private static _instance: AccessibilityManager | null = null;
@@ -147,7 +147,7 @@ export class AccessibilityManager {
147
147
  accessibilityHint: `Press button to perform action on ${buttonName}`,
148
148
  "aria-label": buttonName,
149
149
  "aria-description": `Press button to perform action on ${buttonName}`,
150
- accessibilityRole: "button" as AccessibilityRole,
150
+ accessibilityRole: "button",
151
151
  "aria-role": "button",
152
152
  };
153
153
  }
@@ -166,7 +166,7 @@ export class AccessibilityManager {
166
166
  accessibilityHint: hint,
167
167
  "aria-label": label,
168
168
  "aria-description": hint,
169
- accessibilityRole: "button" as AccessibilityRole,
169
+ accessibilityRole: "button",
170
170
  "aria-role": "button",
171
171
  };
172
172
  }
@@ -1,11 +1,10 @@
1
1
  import { ContextKeysManager } from "./index";
2
2
  import * as R from "ramda";
3
3
 
4
- export interface IResolver {
4
+ interface IResolver {
5
5
  resolve: (string) => Promise<string | number | object>;
6
6
  }
7
7
 
8
- // TODO: Rename to ObjectKeyResolver or similar
9
8
  export class EntryResolver implements IResolver {
10
9
  entry: ZappEntry;
11
10
 
@@ -22,18 +21,6 @@ export class EntryResolver implements IResolver {
22
21
  }
23
22
  }
24
23
 
25
- // TODO: Move to proper place
26
-
27
- export class ScreenStateResolver implements IResolver {
28
- constructor(private screenStateStore: ScreenStateStore) {}
29
-
30
- async resolve(key: string) {
31
- const screenState = this.screenStateStore.getState().data;
32
-
33
- return screenState?.[key];
34
- }
35
- }
36
-
37
24
  export class ContextResolver implements IResolver {
38
25
  resolve = async (compositeKey: string) =>
39
26
  ContextKeysManager.instance.getKey(compositeKey);
@@ -6,6 +6,7 @@ exports[`focusManager should be defined 1`] = `
6
6
  "disableFocus": [Function],
7
7
  "enableFocus": [Function],
8
8
  "findPreferredFocusChild": [Function],
9
+ "focusTopNavigation": [Function],
9
10
  "focusableTree": Tree {
10
11
  "loadingCounter": 0,
11
12
  "root": {
@@ -24,6 +25,9 @@ exports[`focusManager should be defined 1`] = `
24
25
  "invokeHandler": [Function],
25
26
  "isCurrentFocusOnTheTopScreen": [Function],
26
27
  "isFocusDisabled": [Function],
28
+ "isFocusOn": [Function],
29
+ "isFocusOnContent": [Function],
30
+ "isFocusOnMenu": [Function],
27
31
  "isGroupItemFocused": [Function],
28
32
  "longPress": [Function],
29
33
  "moveFocus": [Function],
@@ -63,6 +67,7 @@ exports[`focusManagerIOS should be defined 1`] = `
63
67
  "getGroupRootById": [Function],
64
68
  "getPreferredFocusChild": [Function],
65
69
  "invokeHandler": [Function],
70
+ "isFocusOn": [Function],
66
71
  "isGroupItemFocused": [Function],
67
72
  "moveFocus": [Function],
68
73
  "on": [Function],
@@ -33,7 +33,7 @@ describe("focusManager", () => {
33
33
 
34
34
  expect(success).toBe(true);
35
35
  expect(mockSetFocus).toBeCalledTimes(1);
36
- expect(mockSetFocus).toBeCalledWith(null);
36
+ expect(mockSetFocus).toBeCalledWith(null, undefined);
37
37
  });
38
38
 
39
39
  describe("register", () => {});
@@ -1,6 +1,7 @@
1
1
  import { NativeModules } from "react-native";
2
2
  import * as R from "ramda";
3
3
 
4
+ import { isCurrentFocusOn } from "../focusManagerAux/utils";
4
5
  import { Tree } from "./treeDataStructure/Tree";
5
6
  import { findFocusableNode } from "./treeDataStructure/Utils";
6
7
  import { subscriber } from "../../functionUtils";
@@ -391,6 +392,14 @@ export const focusManager = (function () {
391
392
  return node;
392
393
  }
393
394
 
395
+ function isFocusOn(id): boolean {
396
+ const currentFocusNode = focusableTree.findInTree(
397
+ getCurrentFocus()?.props?.id
398
+ );
399
+
400
+ return id && isCurrentFocusOn(id, currentFocusNode);
401
+ }
402
+
394
403
  return {
395
404
  on,
396
405
  invokeHandler,
@@ -412,5 +421,6 @@ export const focusManager = (function () {
412
421
  getGroupRootById,
413
422
  isGroupItemFocused,
414
423
  getPreferredFocusChild,
424
+ isFocusOn,
415
425
  };
416
426
  })();
@@ -14,6 +14,15 @@ import { subscriber } from "../../functionUtils";
14
14
  import { coreLogger } from "../../logger";
15
15
  import { ACTION } from "./utils/enums";
16
16
 
17
+ import {
18
+ findSelectedTabId,
19
+ findSelectedMenuId,
20
+ isTabsScreenContentFocused,
21
+ isCurrentFocusOnContent,
22
+ isCurrentFocusOnMenu,
23
+ isCurrentFocusOn,
24
+ } from "../focusManagerAux/utils";
25
+
17
26
  const logger = coreLogger.addSubsystem("focusManager");
18
27
 
19
28
  const isFocusEnabled = (focusableItem): boolean => {
@@ -100,7 +109,7 @@ export const focusManager = (function () {
100
109
  * @private
101
110
  * @param {Object} direction of the navigation which led to this action
102
111
  */
103
- function focus(direction) {
112
+ function focus(direction, context?: FocusManager.FocusContext) {
104
113
  const currentFocusable = getCurrentFocus();
105
114
 
106
115
  if (
@@ -108,7 +117,7 @@ export const focusManager = (function () {
108
117
  !currentFocusable.isGroup &&
109
118
  currentFocusable.isMounted()
110
119
  ) {
111
- currentFocusable.setFocus(direction);
120
+ currentFocusable.setFocus(direction, context);
112
121
  }
113
122
  }
114
123
 
@@ -205,7 +214,7 @@ export const focusManager = (function () {
205
214
  * @param {Array<string>} ids - An array of node IDs to update.
206
215
  * @param {boolean} setFocus - A flag indicating whether to set focus (true) or blur (false) on the nodes.
207
216
  */
208
- const updateNodeFocus = (ids, action) => {
217
+ const updateNodeFocus = (ids, action, context: FocusManager.FocusContext) => {
209
218
  if (!ids || ids.length === 0) {
210
219
  return; // Nothing to do
211
220
  }
@@ -222,11 +231,13 @@ export const focusManager = (function () {
222
231
 
223
232
  // Function to apply the action (focus or blur)
224
233
  const applyAction = (node) => {
234
+ const direction = undefined;
235
+
225
236
  if (node && node.component) {
226
237
  if (action === "focus") {
227
- node.component.setFocus();
238
+ node.component.setFocus(direction, context);
228
239
  } else if (action === "blur") {
229
- node.component.setBlur();
240
+ node.component.setBlur(direction, context);
230
241
  }
231
242
  }
232
243
  };
@@ -253,7 +264,11 @@ export const focusManager = (function () {
253
264
  * @param {Object} direction of the navigation, which led to this focus change
254
265
  * to another group or not. defaults to false
255
266
  */
256
- function setFocus(id: string, direction?: FocusManager.Web.Direction) {
267
+ function setFocus(
268
+ id: string,
269
+ direction?: FocusManager.Web.Direction,
270
+ context?: FocusManager.FocusContext
271
+ ) {
257
272
  if (focusDisabled) return false;
258
273
 
259
274
  // due to optimisiation it's recommanded to set currentFocusNode before setFocus
@@ -266,21 +281,65 @@ export const focusManager = (function () {
266
281
  );
267
282
 
268
283
  // Set focus on current node parents and blur on previous node parents
269
- updateNodeFocus(currentNodeParentsIDs, ACTION.FOCUS);
270
- updateNodeFocus(previousNodeParentsIDs, ACTION.BLUR);
284
+ updateNodeFocus(currentNodeParentsIDs, ACTION.FOCUS, context);
285
+ updateNodeFocus(previousNodeParentsIDs, ACTION.BLUR, context);
271
286
 
272
287
  currentFocusNode = focusableTree.findInTree(id);
273
288
  }
274
289
 
275
290
  setLastFocusOnParentNode(currentFocusNode);
276
291
 
277
- focus(direction);
292
+ focus(direction, context);
293
+ }
294
+
295
+ function isFocusOnContent() {
296
+ return isCurrentFocusOnContent(currentFocusNode);
297
+ }
298
+
299
+ function isFocusOnMenu() {
300
+ return isCurrentFocusOnMenu(currentFocusNode);
301
+ }
302
+
303
+ // Move focus to appropriate top navigation tab with context
304
+ function focusTopNavigation(isTabsScreen: boolean, item: ZappEntry) {
305
+ const landFocusTo = (id) => {
306
+ if (id) {
307
+ // set focus on selected menu item
308
+ const direction = undefined;
309
+
310
+ const context: FocusManager.FocusContext = {
311
+ source: "back",
312
+ preserveScroll: true,
313
+ };
314
+
315
+ logger.log({ message: "landFocusTo", data: { id } });
316
+
317
+ blur(direction);
318
+ setFocus(id, direction, context);
319
+ }
320
+ };
321
+
322
+ if (isTabsScreen && isTabsScreenContentFocused(currentFocusNode)) {
323
+ const selectedTabId = findSelectedTabId(item);
324
+
325
+ // Set focus with back button context to tabs-menu
326
+ landFocusTo(selectedTabId);
327
+
328
+ return;
329
+ }
330
+
331
+ const selectedMenuItemId = findSelectedMenuId(focusableTree);
332
+ // Set focus with back button context to top-menu
333
+ landFocusTo(selectedMenuItemId);
278
334
  }
279
335
 
280
336
  /**
281
337
  * sets the initial focus when the screen loads, or when focus is lost
282
338
  */
283
- function setInitialFocus(lastAddedParentNode?: any) {
339
+ function setInitialFocus(
340
+ lastAddedParentNode?: any,
341
+ context?: FocusManager.FocusContext
342
+ ) {
284
343
  const preferredFocus = findPriorityItem(
285
344
  lastAddedParentNode?.children || focusableTree.root.children
286
345
  );
@@ -326,7 +385,7 @@ export const focusManager = (function () {
326
385
  },
327
386
  });
328
387
 
329
- focusableItem && setFocus(focusCandidate.id, null);
388
+ focusableItem && setFocus(focusCandidate.id, null, context);
330
389
 
331
390
  return { success: true };
332
391
  }
@@ -546,6 +605,14 @@ export const focusManager = (function () {
546
605
  return preferredFocus[0];
547
606
  }
548
607
 
608
+ function isFocusOn(id): boolean {
609
+ return (
610
+ id &&
611
+ isCurrentFocusOnTheTopScreen() &&
612
+ isCurrentFocusOn(id, currentFocusNode)
613
+ );
614
+ }
615
+
549
616
  /**
550
617
  * this is the list of the functions available externally
551
618
  * when importing the focus manager
@@ -576,5 +643,9 @@ export const focusManager = (function () {
576
643
  recoverFocus,
577
644
  isCurrentFocusOnTheTopScreen,
578
645
  findPreferredFocusChild,
646
+ focusTopNavigation,
647
+ isFocusOnContent,
648
+ isFocusOnMenu,
649
+ isFocusOn,
579
650
  };
580
651
  })();
@@ -142,7 +142,7 @@ export class Tree {
142
142
  this.hasGroupID(node)
143
143
  ? "Make sure that there are no id duplicates inside the " +
144
144
  existingNode.parent.id +
145
- " group."
145
+ " group. This can as well happen when the component is re-mounted"
146
146
  : ""
147
147
  }`,
148
148
  });