@applicaster/zapp-react-native-ui-components 15.0.0-rc.129 → 15.0.0-rc.131

package/Components/MasterCell/DefaultComponents/mobile/MobileActionButtons/__tests__/PressableView.test.tsx

@@ -0,0 +1,191 @@
+import React from "react";
+import { render, fireEvent } from "@testing-library/react-native";
+import { useActions } from "@applicaster/zapp-react-native-utils/reactHooks/actions";
+
+import { elementMapper } from "../../../../elementMapper";
+import { defaultComponents } from "../../../index";
+
+jest.mock("@applicaster/zapp-react-native-utils/reactHooks/actions", () => ({
+  useActions: jest.fn(),
+}));
+
+jest.mock("@applicaster/zapp-react-native-utils/theme", () => ({
+  useTheme: () => ({}),
+}));
+
+jest.mock("@applicaster/zapp-react-native-utils/localizationUtils", () => ({
+  useIsRTL: jest.fn(() => false),
+}));
+
+jest.mock(
+  "@applicaster/zapp-react-native-utils/reactHooks/navigation/useNavigation",
+  () => ({
+    useNavigation: jest.fn(() => ({
+      currentRoute: "home",
+      videoModalState: {
+        visible: false,
+      },
+    })),
+  })
+);
+
+jest.mock(
+  "@applicaster/zapp-react-native-utils/reactHooks/navigation/usePathname",
+  () => ({
+    usePathname: jest.fn(() => "home"),
+  })
+);
+
+jest.mock(
+  "@applicaster/zapp-react-native-utils/appUtils/accessibilityManager/hooks",
+  () => ({
+    useAccessibilityManager: jest.fn(() => ({
+      addHeading: jest.fn(),
+    })),
+  })
+);
+
+const mockUseActions = useActions as jest.Mock;
+
+const item = {
+  id: "entry-1",
+} as ZappEntry;
+
+const buildActionContext = (entryState = {}) => ({
+  initialEntryState: jest.fn(() => ({
+    asset: {
+      inactive: "https://example.com/image-inactive.png",
+      active: "https://example.com/image-active.png",
+    },
+    label: {
+      label_1: "Play",
+    },
+    ...entryState,
+  })),
+  invokeAction: jest.fn(),
+  addListener: jest.fn(() => jest.fn()),
+  isActionAvailable: jest.fn(() => true),
+});
+
+const baseNode = {
+  type: "PressableView",
+  style: {
+    backgroundColor: "rgba(1,1,1,1)",
+    borderColor: "rgba(2,2,2,1)",
+    borderWidth: 1,
+  },
+  props: {
+    item,
+    action: {
+      identifier: "navigation_action",
+    },
+    focusedStyles: {
+      backgroundColor: "rgba(3,3,3,1)",
+      borderColor: "rgba(4,4,4,1)",
+    },
+    testID: "mobile-action-button",
+  },
+  elements: [
+    {
+      type: "Image",
+      style: {
+        width: 24,
+        height: 24,
+      },
+      props: {
+        testID: "mobile-action-button-asset",
+        source: {
+          context: "navigation_action",
+        },
+        mobileActionRole: "asset",
+      },
+    },
+    {
+      type: "View",
+      style: {
+        flexDirection: "column",
+      },
+      props: {
+        mobileActionRole: "label_container",
+      },
+      elements: [
+        {
+          type: "Text",
+          style: {
+            fontSize: 15,
+          },
+          props: {
+            testID: "mobile-action-button-label",
+            label: {
+              context: "navigation_action",
+              name: "label_1",
+            },
+            focusedStyles: {
+              color: "rgba(20,20,20,1)",
+            },
+            normalStyles: {
+              color: "rgba(10,10,10,1)",
+            },
+            mobileActionRole: "label",
+            transformText: "default",
+          },
+        },
+      ],
+    },
+  ],
+};
+
+describe("PressableView", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  const renderNode = (node = baseNode) =>
+    render(
+      <React.Fragment>
+        {elementMapper(defaultComponents)(node as never)}
+      </React.Fragment>
+    );
+
+  it("renders nested image and text children through elementMapper", () => {
+    mockUseActions.mockReturnValue(buildActionContext());
+
+    const { getByText, getByTestId } = renderNode();
+
+    expect(getByTestId("mobile-action-button")).toBeTruthy();
+    expect(getByTestId("mobile-action-button-asset")).toBeTruthy();
+    expect(getByText("Play")).toBeTruthy();
+  });
+
+  it("applies focused styles when action entry state is active", () => {
+    mockUseActions.mockReturnValue(buildActionContext({ active: true }));
+
+    const { getByTestId, getByText } = renderNode();
+
+    expect(
+      getByTestId("mobile-action-button").props.style.backgroundColor
+    ).toBe("rgba(3,3,3,1)");
+
+    expect(getByText("Play").props.style).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ color: "rgba(20,20,20,1)" }),
+      ])
+    );
+  });
+
+  it("invokes action on press", () => {
+    const actionContext = buildActionContext();
+    mockUseActions.mockReturnValue(actionContext);
+
+    const { getByTestId } = renderNode();
+
+    fireEvent.press(getByTestId("mobile-action-button"));
+
+    expect(actionContext.invokeAction).toHaveBeenCalledWith(
+      item,
+      expect.objectContaining({
+        updateState: expect.any(Function),
+      })
+    );
+  });
+});

package/Components/MasterCell/DefaultComponents/mobile/MobileActionButtons/__tests__/builders.test.ts

@@ -0,0 +1,140 @@
+import { Asset } from "../Asset";
+import { Button } from "../Button";
+import { ButtonContainerView } from "../ButtonContainerView";
+import { Spacer } from "../Spacer";
+import { TextLabel } from "../TextLabel";
+import { TextLabelsContainer } from "../TextLabelsContainer";
+
+describe("mobile action button builders", () => {
+  const configuration = {
+    mobile_buttons_container_align: "left",
+    mobile_buttons_container_margin_top: 0,
+    mobile_buttons_container_margin_right: 12,
+    mobile_buttons_container_margin_bottom: 0,
+    mobile_buttons_container_margin_left: 6,
+    mobile_buttons_container_stacking: "horizontal",
+    mobile_button_1_button_enabled: true,
+    mobile_button_1_assign_action: "navigation_action",
+    mobile_button_1_display_mode: "dynamic",
+    mobile_button_1_contents_alignment: "center",
+    mobile_button_1_background_color: "rgba(1,1,1,1)",
+    mobile_button_1_border_color: "rgba(0,0,0,0)",
+    mobile_button_1_border_size: 0,
+    mobile_button_1_corner_radius: 8,
+    mobile_button_1_padding_top: 10,
+    mobile_button_1_padding_right: 10,
+    mobile_button_1_padding_bottom: 10,
+    mobile_button_1_padding_left: 10,
+    mobile_button_1_asset_enabled: true,
+    mobile_button_1_action_asset_flavour: "flavour_1",
+    mobile_button_1_asset_alignment: "left",
+    mobile_button_1_asset_width: 24,
+    mobile_button_1_asset_height: 24,
+    mobile_button_1_asset_margin_top: 1,
+    mobile_button_1_asset_margin_right: 2,
+    mobile_button_1_asset_margin_bottom: 3,
+    mobile_button_1_asset_margin_left: 4,
+    mobile_button_1_label_enabled: true,
+    mobile_button_1_font_color: "rgba(255,255,255,1)",
+    mobile_button_1_focused_font_color: "rgba(255,0,0,1)",
+    mobile_button_1_ios_font_family: "Ubuntu-Bold",
+    mobile_button_1_android_font_family: "Ubuntu-Bold",
+    mobile_button_1_font_size: 15,
+    mobile_button_1_line_height: 24,
+    mobile_button_1_ios_letter_spacing: -0.2,
+    mobile_button_1_android_letter_spacing: -0.2,
+    mobile_button_1_text_transform: "default",
+  };
+
+  const value = (key) => configuration[key];
+
+  it("builds the container node with content style in additionalProps", () => {
+    const result = ButtonContainerView({
+      style: { position: "absolute" },
+      contentStyle: {
+        flexDirection: "row",
+      },
+      elements: [{ type: "PressableView" }],
+    });
+
+    expect(result).toEqual({
+      type: "View",
+      style: { position: "absolute" },
+      elements: [
+        {
+          type: "View",
+          style: {
+            flexDirection: "row",
+          },
+          elements: [{ type: "PressableView" }],
+        },
+      ],
+    });
+  });
+
+  it("builds the button node with asset and text label children", () => {
+    const result = Button({
+      index: 0,
+      value,
+      stylePrefix: "mobile_button_1",
+      specificPrefix: "mobile_button_1",
+      spacingStyle: { marginRight: 8 },
+    });
+
+    expect(result.type).toBe("PressableView");
+    expect(result.additionalProps.action.identifier).toBe("navigation_action");
+
+    expect(result.elements).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ type: "Image" }),
+        expect.objectContaining({ type: "View" }),
+      ])
+    );
+  });
+
+  it("builds the asset, label container, label and spacer nodes", () => {
+    expect(
+      Asset({
+        prefix: "mobile_button_1",
+        value,
+        actionIdentifier: "navigation_action",
+      })
+    ).toEqual(
+      expect.objectContaining({
+        type: "Image",
+      })
+    );
+
+    expect(
+      TextLabelsContainer({
+        prefix: "mobile_button_1",
+        value,
+        actionIdentifier: "navigation_action",
+      })
+    ).toEqual(
+      expect.objectContaining({
+        type: "View",
+        elements: [expect.objectContaining({ type: "Text" })],
+      })
+    );
+
+    expect(
+      TextLabel({
+        prefix: "mobile_button_1",
+        value,
+        actionIdentifier: "navigation_action",
+      })
+    ).toEqual(
+      expect.objectContaining({
+        type: "Text",
+      })
+    );
+
+    expect(Spacer({ enabled: true })).toEqual({
+      type: "View",
+      style: {
+        flex: 1,
+      },
+    });
+  });
+});

package/Components/MasterCell/DefaultComponents/mobile/MobileActionButtons/__tests__/index.test.ts

@@ -0,0 +1,222 @@
+import { MobileActionButtons } from "..";
+
+describe("MobileActionButtons", () => {
+  const configuration = {
+    mobile_buttons_container_buttons_enabled: true,
+    mobile_buttons_container_position: "over_image",
+    mobile_buttons_container_align: "left",
+    mobile_buttons_container_margin_top: 0,
+    mobile_buttons_container_margin_right: 0,
+    mobile_buttons_container_margin_bottom: 0,
+    mobile_buttons_container_margin_left: 0,
+    mobile_buttons_container_stacking: "horizontal",
+    mobile_buttons_container_horizontal_gutter: 8,
+    mobile_buttons_container_vertical_gutter: 8,
+    mobile_buttons_container_independent_styles: true,
+    mobile_buttons_container_over_image_position: "top_right",
+    mobile_button_1_button_enabled: true,
+    mobile_button_1_assign_action: "navigation_action",
+    mobile_button_1_display_mode: "dynamic",
+    mobile_button_1_contents_alignment: "center",
+    mobile_button_1_background_color: "rgba(1,1,1,1)",
+    mobile_button_1_border_color: "rgba(0,0,0,0)",
+    mobile_button_1_border_size: 0,
+    mobile_button_1_corner_radius: 8,
+    mobile_button_1_padding_top: 10,
+    mobile_button_1_padding_right: 10,
+    mobile_button_1_padding_bottom: 10,
+    mobile_button_1_padding_left: 10,
+    mobile_button_1_asset_width: 24,
+    mobile_button_1_asset_height: 24,
+    mobile_button_1_asset_margin_top: 0,
+    mobile_button_1_asset_margin_right: 0,
+    mobile_button_1_asset_margin_bottom: 0,
+    mobile_button_1_asset_margin_left: 0,
+    mobile_button_1_asset_enabled: true,
+    mobile_button_1_label_enabled: true,
+    mobile_button_1_font_color: "rgba(255,255,255,1)",
+    mobile_button_1_focused_font_color: "rgba(255,0,0,1)",
+  };
+
+  const value = (key) => configuration[key];
+
+  it("renders over-image buttons only for over_image placement", () => {
+    const result = MobileActionButtons({
+      value,
+      configuration,
+      placement: "over_image",
+    });
+
+    expect(result).toBeTruthy();
+    expect(result.type).toBe("View");
+    expect(result.style.position).toBe("absolute");
+    expect(result.style.top).toBe(0);
+    expect(result.style.right).toBe(0);
+    expect(result.elements).toHaveLength(1);
+    expect(result.elements[0].type).toBe("View");
+    expect(result.elements[0].style.flexDirection).toBe("row");
+    expect(result.elements[0].elements[0].type).toBe("PressableView");
+
+    expect(result.elements[0].elements[0].elements).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({ type: "Image" }),
+        expect.objectContaining({ type: "View" }),
+      ])
+    );
+  });
+
+  it("does not render label placement when position is over_image", () => {
+    const result = MobileActionButtons({
+      value,
+      configuration,
+      placement: "labels",
+    });
+
+    expect(result).toBeNull();
+  });
+
+  it("renders button 1 when only button 1 is enabled", () => {
+    const configurationWithSingleButton = {
+      ...configuration,
+      mobile_button_1_button_enabled: true,
+      mobile_button_2_button_enabled: false,
+      mobile_button_3_button_enabled: false,
+    };
+
+    const singleButtonValue = (key) => configurationWithSingleButton[key];
+
+    const result = MobileActionButtons({
+      value: singleButtonValue,
+      configuration: configurationWithSingleButton,
+      placement: "over_image",
+    });
+
+    expect(result?.elements?.[0]?.elements).toHaveLength(1);
+    expect(result?.elements?.[0]?.elements?.[0]?.type).toBe("PressableView");
+  });
+
+  it("renders button 2 when only button 2 is enabled", () => {
+    const configurationWithSingleButton = {
+      ...configuration,
+      mobile_button_1_button_enabled: false,
+      mobile_button_2_button_enabled: true,
+      mobile_button_3_button_enabled: false,
+    };
+
+    const singleButtonValue = (key) => configurationWithSingleButton[key];
+
+    const result = MobileActionButtons({
+      value: singleButtonValue,
+      configuration: configurationWithSingleButton,
+      placement: "over_image",
+    });
+
+    expect(result?.elements?.[0]?.elements).toHaveLength(1);
+    expect(result?.elements?.[0]?.elements?.[0]?.type).toBe("PressableView");
+
+    expect(
+      result?.elements?.[0]?.elements?.[0]?.additionalProps?.action?.identifier
+    ).toBe(configurationWithSingleButton.mobile_button_2_assign_action);
+  });
+
+  it("renders button 3 when only button 3 is enabled", () => {
+    const configurationWithSingleButton = {
+      ...configuration,
+      mobile_button_1_button_enabled: false,
+      mobile_button_2_button_enabled: false,
+      mobile_button_3_button_enabled: true,
+      mobile_button_3_assign_action: "local_storage_favourites_action",
+    };
+
+    const singleButtonValue = (key) => configurationWithSingleButton[key];
+
+    const result = MobileActionButtons({
+      value: singleButtonValue,
+      configuration: configurationWithSingleButton,
+      placement: "over_image",
+    });
+
+    expect(result?.elements?.[0]?.elements).toHaveLength(1);
+    expect(result?.elements?.[0]?.elements?.[0]?.type).toBe("PressableView");
+
+    expect(
+      result?.elements?.[0]?.elements?.[0]?.additionalProps?.action?.identifier
+    ).toBe(configurationWithSingleButton.mobile_button_3_assign_action);
+  });
+
+  it("renders sparse slots contiguously while preserving slot-specific actions", () => {
+    const configurationWithSparseButtons = {
+      ...configuration,
+      mobile_button_1_button_enabled: true,
+      mobile_button_1_assign_action: "action_1",
+      mobile_button_2_button_enabled: false,
+      mobile_button_3_button_enabled: true,
+      mobile_button_3_assign_action: "action_3",
+    };
+
+    const sparseValue = (key) => configurationWithSparseButtons[key];
+
+    const result = MobileActionButtons({
+      value: sparseValue,
+      configuration: configurationWithSparseButtons,
+      placement: "over_image",
+    });
+
+    expect(result?.elements?.[0]?.elements).toHaveLength(2);
+
+    expect(
+      result?.elements?.[0]?.elements?.[0]?.additionalProps?.action?.identifier
+    ).toBe("action_1");
+
+    expect(
+      result?.elements?.[0]?.elements?.[1]?.additionalProps?.action?.identifier
+    ).toBe("action_3");
+
+    expect(result?.elements?.[0]?.elements?.[0]?.additionalProps?.testID).toBe(
+      "mobile_action_button_1"
+    );
+
+    expect(result?.elements?.[0]?.elements?.[1]?.additionalProps?.testID).toBe(
+      "mobile_action_button_2"
+    );
+  });
+
+  it("maps shared semantic layout data into content styles", () => {
+    const configurationWithLayout = {
+      ...configuration,
+      mobile_buttons_container_align: "middle",
+      mobile_buttons_container_margin_top: 5,
+      mobile_buttons_container_margin_right: 6,
+      mobile_buttons_container_margin_bottom: 7,
+      mobile_buttons_container_margin_left: 8,
+      mobile_buttons_container_stacking: "vertical",
+    };
+
+    const layoutValue = (key) => configurationWithLayout[key];
+
+    const result = MobileActionButtons({
+      value: layoutValue,
+      configuration: configurationWithLayout,
+      placement: "labels",
+    });
+
+    expect(result).toBeNull();
+
+    const overImageResult = MobileActionButtons({
+      value: layoutValue,
+      configuration: configurationWithLayout,
+      placement: "over_image",
+    });
+
+    expect(overImageResult?.elements?.[0]?.style).toMatchObject({
+      flexDirection: "column",
+      alignItems: "center",
+      marginTop: 5,
+      marginRight: 6,
+      marginBottom: 7,
+      marginLeft: 8,
+    });
+
+    expect(overImageResult?.elements?.[0]?.style.alignSelf).toBeUndefined();
+  });
+});

package/Components/MasterCell/DefaultComponents/mobile/MobileActionButtons/helpers.ts

@@ -0,0 +1,105 @@
+import { Platform } from "react-native";
+
+export function isStringAsset(asset) {
+  return typeof asset === "string" || Array.isArray(asset);
+}
+
+export function getAssetValue(asset, flavour, fallbackAsset = null) {
+  if (!asset) {
+    return fallbackAsset;
+  }
+
+  if (typeof asset === "string") {
+    return asset;
+  }
+
+  if (Array.isArray(asset)) {
+    const flavourIndex = Number(String(flavour || "").replace("flavour_", ""));
+
+    if (!Number.isNaN(flavourIndex) && flavourIndex > 0) {
+      return asset[flavourIndex - 1];
+    }
+
+    return asset[0];
+  }
+
+  return asset.src || fallbackAsset;
+}
+
+export function getContentDirection(alignment = "left") {
+  switch (alignment) {
+    case "right":
+      return "row-reverse";
+    case "above":
+      return "column";
+    case "below":
+      return "column-reverse";
+    case "left":
+    default:
+      return "row";
+  }
+}
+
+export function getContentsAlignment(alignment = "center") {
+  switch (alignment) {
+    case "left":
+      return "flex-start";
+    case "right":
+      return "flex-end";
+    case "center":
+    default:
+      return "center";
+  }
+}
+
+export function resolveLabelText(label) {
+  if (typeof label === "string") {
+    return label;
+  }
+
+  return label?.label_1 || "";
+}
+
+export function resolveIsActive(actionState, fallbackSelected = false) {
+  if (actionState == null) {
+    return fallbackSelected;
+  }
+
+  return Boolean(
+    actionState?.active ??
+      actionState?.isActive ??
+      actionState?.selected ??
+      actionState?.isSelected ??
+      fallbackSelected
+  );
+}
+
+export function buildLegacySelection(item, actionContext) {
+  const defaultIsSelected = (actionContext?.state || []).includes(item);
+
+  return actionContext?.masterCell?.isSelected
+    ? actionContext?.masterCell?.isSelected(item)
+    : defaultIsSelected;
+}
+
+export function buildLabelStyle(label) {
+  if (!label?.enabled) {
+    return {};
+  }
+
+  const platformFontFamily =
+    Platform.OS === "ios"
+      ? label?.iosFontFamily || label?.normalStyle?.fontFamily
+      : label?.androidFontFamily || label?.normalStyle?.fontFamily;
+
+  const platformLetterSpacing =
+    Platform.OS === "ios"
+      ? label?.iosLetterSpacing
+      : label?.androidLetterSpacing;
+
+  return {
+    ...label?.normalStyle,
+    fontFamily: platformFontFamily,
+    letterSpacing: platformLetterSpacing,
+  };
+}