@applicaster/zapp-react-native-utils 15.1.4 → 16.0.0-alpha.1042942411

package/manifestUtils/mobileAction/container/__tests__/mobileActionButtonsContainer.test.js

@@ -0,0 +1,102 @@
+import { mobileActionButtonsContainer } from "..";
+
+describe("mobileActionButtonsContainer", () => {
+  it("generates container fields with inferred conditionals", () => {
+    const result = mobileActionButtonsContainer({
+      label: "Mobile Buttons Container",
+      description: "container",
+      defaults: {
+        buttonsEnabled: false,
+        position: ["over_image", "text_label_1", "text_label_2"],
+        align: "left",
+        overImagePosition: "bottom_left",
+        marginTop: 0,
+        marginRight: 20,
+        marginBottom: 0,
+        marginLeft: 20,
+        stacking: "horizontal",
+        horizontalGutter: 8,
+        verticalGutter: 8,
+        independentStyles: true,
+      },
+    });
+
+    expect(result.group).toBe(true);
+    expect(result.label).toBe("Mobile Buttons Container");
+
+    const enabledField = result.fields.find(
+      (field) => field.key === "mobile_buttons_container_buttons_enabled"
+    );
+
+    expect(enabledField).toBeTruthy();
+    expect(enabledField.type).toBe("switch");
+
+    const positionField = result.fields.find(
+      (field) => field.key === "mobile_buttons_container_position"
+    );
+
+    expect(positionField.options).toEqual([
+      "over_image",
+      "text_label_1",
+      "text_label_2",
+    ]);
+
+    expect(positionField.conditional_fields).toEqual([
+      {
+        key: "styles/mobile_buttons_container_buttons_enabled",
+        condition_value: true,
+      },
+    ]);
+
+    const overImagePositionField = result.fields.find(
+      (field) => field.key === "mobile_buttons_container_over_image_position"
+    );
+
+    expect(overImagePositionField.rules).toBe("all_conditions");
+
+    expect(overImagePositionField.conditional_fields).toEqual([
+      {
+        key: "styles/mobile_buttons_container_buttons_enabled",
+        condition_value: true,
+      },
+      {
+        key: "styles/mobile_buttons_container_position",
+        condition_value: "over_image",
+      },
+    ]);
+
+    const horizontalGutterField = result.fields.find(
+      (field) => field.key === "mobile_buttons_container_horizontal_gutter"
+    );
+
+    expect(horizontalGutterField.rules).toBe("all_conditions");
+
+    expect(horizontalGutterField.conditional_fields).toEqual([
+      {
+        key: "styles/mobile_buttons_container_buttons_enabled",
+        condition_value: true,
+      },
+      {
+        key: "styles/mobile_buttons_container_stacking",
+        condition_value: "horizontal",
+      },
+    ]);
+
+    const verticalGutterField = result.fields.find(
+      (field) => field.key === "mobile_buttons_container_vertical_gutter"
+    );
+
+    expect(verticalGutterField.rules).toBe("all_conditions");
+
+    expect(verticalGutterField.conditional_fields).toEqual([
+      {
+        key: "styles/mobile_buttons_container_buttons_enabled",
+        condition_value: true,
+      },
+      {
+        key: "styles/mobile_buttons_container_stacking",
+        condition_value: "vertical",
+      },
+    ]);
+  });
+});

package/manifestUtils/mobileAction/container/index.js

@@ -0,0 +1,75 @@
+const { mobileActionButtonContainerFields } = require("../../keys");
+
+const {
+  isKeyHasSuffix,
+  toSnakeCase,
+  generateFieldsFromDefaultsWithoutPrefixedLabel,
+  getKeyWithPrefixGenerator,
+} = require("../../_internals");
+
+const { withConditional, createConditionalField } = require("../../fieldUtils");
+
+const { fieldsGroup } = require("../../utils");
+
+/**
+ * Builds the manifest group for the mobile action buttons container and wires
+ * child field visibility to the container-level toggles and layout selections.
+ *
+ * @param {object} options
+ * @param {string} options.label
+ * @param {string} options.description
+ * @param {object} options.defaults
+ * @returns {object}
+ */
+function mobileActionButtonsContainer({ label, description, defaults }) {
+  const containerKeyFromLabel = toSnakeCase(label); // "Mobile Buttons Container" -> "mobile_buttons_container"
+
+  const generatedFields = generateFieldsFromDefaultsWithoutPrefixedLabel(
+    label,
+    defaults,
+    mobileActionButtonContainerFields(defaults.position)
+  );
+
+  const keyPrefixGenerator = getKeyWithPrefixGenerator(containerKeyFromLabel);
+
+  const enabledKey = keyPrefixGenerator("buttons_enabled");
+  const positionKey = keyPrefixGenerator("position");
+  const stackingKey = keyPrefixGenerator("stacking");
+
+  const defaultConditions = [createConditionalField(enabledKey, true)];
+
+  const fields = generatedFields.map((field) => {
+    const key = field.key;
+
+    if (isKeyHasSuffix("buttons_enabled", key)) {
+      return field;
+    }
+
+    const conditions = [...defaultConditions];
+
+    // over_image_position depends on [positionKey: over_image]
+    if (isKeyHasSuffix("over_image_position", key)) {
+      conditions.push(
+        createConditionalField(positionKey, defaults.position[0])
+      );
+    }
+
+    // horizontal_gutter depends on [stackingKey: horizontal]
+    if (isKeyHasSuffix("horizontal_gutter", key)) {
+      conditions.push(createConditionalField(stackingKey, "horizontal"));
+    }
+
+    // vertical_gutter depends on [stackingKey: vertical]
+    if (isKeyHasSuffix("vertical_gutter", key)) {
+      conditions.push(createConditionalField(stackingKey, "vertical"));
+    }
+
+    return withConditional(conditions)(field);
+  });
+
+  return fieldsGroup(label, description, fields);
+}
+
+module.exports = {
+  mobileActionButtonsContainer,
+};

package/manifestUtils/mobileAction/groups/__tests__/buildMobileActionButtonGroups.test.js

@@ -0,0 +1,127 @@
+import { buildMobileActionButtonGroups } from "..";
+
+describe("buildMobileActionButtonGroups", () => {
+  it("builds the container and three button groups with shared defaults", () => {
+    const groups = buildMobileActionButtonGroups({
+      containerDefaults: {
+        position: ["over_image", "text_label_1", "text_label_2"],
+      },
+    });
+
+    expect(groups).toHaveLength(4);
+
+    expect(groups.map((group) => group.label)).toEqual([
+      "Mobile Buttons Container",
+      "Mobile Button 1",
+      "Mobile Button 2",
+      "Mobile Button 3",
+    ]);
+
+    const containerFields = groups[0].fields;
+
+    const positionField = containerFields.find(
+      (field) => field.key === "mobile_buttons_container_position"
+    );
+
+    const buttonsEnabledField = containerFields.find(
+      (field) => field.key === "mobile_buttons_container_buttons_enabled"
+    );
+
+    expect(positionField.options).toEqual([
+      "over_image",
+      "text_label_1",
+      "text_label_2",
+    ]);
+
+    expect(buttonsEnabledField.initial_value).toBe(false);
+
+    const button1Fields = groups[1].fields;
+
+    const button1EnabledField = button1Fields.find(
+      (field) => field.key === "mobile_button_1_button_enabled"
+    );
+
+    const button1AssignActionField = button1Fields.find(
+      (field) => field.key === "mobile_button_1_assign_action"
+    );
+
+    const button1BackgroundColorField = button1Fields.find(
+      (field) => field.key === "mobile_button_1_background_color"
+    );
+
+    expect(button1EnabledField.initial_value).toBe(true);
+    expect(button1AssignActionField.initial_value).toBe("navigation_action");
+
+    expect(button1BackgroundColorField.initial_value).toBe(
+      "rgba(254, 20, 72, 1)"
+    );
+
+    const button2Fields = groups[2].fields;
+
+    const button2EnabledField = button2Fields.find(
+      (field) => field.key === "mobile_button_2_button_enabled"
+    );
+
+    const button2AssignActionField = button2Fields.find(
+      (field) => field.key === "mobile_button_2_assign_action"
+    );
+
+    expect(button2EnabledField.initial_value).toBe(false);
+    expect(button2AssignActionField.initial_value).toBe("secondary_navigation");
+
+    const button3Fields = groups[3].fields;
+
+    const button3EnabledField = button3Fields.find(
+      (field) => field.key === "mobile_button_3_button_enabled"
+    );
+
+    const button3AssignActionField = button3Fields.find(
+      (field) => field.key === "mobile_button_3_assign_action"
+    );
+
+    expect(button3EnabledField.initial_value).toBe(false);
+
+    expect(button3AssignActionField.initial_value).toBe(
+      "local_storage_favourites_action"
+    );
+  });
+
+  it("merges container, shared button, and per-button overrides", () => {
+    const groups = buildMobileActionButtonGroups({
+      containerDefaults: {
+        align: "center",
+        position: ["over_image"],
+      },
+      sharedButtonDefaults: {
+        assetAlignment: "right",
+      },
+      buttonOverrides: {
+        2: {
+          buttonEnabled: true,
+          assignAction: "downloads",
+        },
+      },
+    });
+
+    const alignField = groups[0].fields.find(
+      (field) => field.key === "mobile_buttons_container_align"
+    );
+
+    const button1AssetAlignmentField = groups[1].fields.find(
+      (field) => field.key === "mobile_button_1_asset_alignment"
+    );
+
+    const button2EnabledField = groups[2].fields.find(
+      (field) => field.key === "mobile_button_2_button_enabled"
+    );
+
+    const button2AssignActionField = groups[2].fields.find(
+      (field) => field.key === "mobile_button_2_assign_action"
+    );
+
+    expect(alignField.initial_value).toBe("center");
+    expect(button1AssetAlignmentField.initial_value).toBe("right");
+    expect(button2EnabledField.initial_value).toBe(true);
+    expect(button2AssignActionField.initial_value).toBe("downloads");
+  });
+});

package/manifestUtils/mobileAction/groups/defaults.js

@@ -0,0 +1,78 @@
+const DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS = {
+  buttonsEnabled: false,
+
+  align: "left",
+  overImagePosition: "bottom_left",
+  marginTop: 0,
+  marginRight: 20,
+  marginBottom: 0,
+  marginLeft: 20,
+  stacking: "horizontal",
+  horizontalGutter: 8,
+  verticalGutter: 8,
+  independentStyles: true,
+};
+
+const DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS = {
+  displayMode: "dynamic",
+  width: 140,
+  contentsAlignment: "center",
+  backgroundColor: "rgba(62, 62, 62, 1)",
+  focusedBackgroundColor: "rgba(46, 46, 46, 1)",
+  borderColor: "rgba(0, 0, 0, 0)",
+  focusedBorderColor: "rgba(0, 0, 0, 0)",
+  borderSize: 0,
+  cornerRadius: 8,
+  paddingTop: 14,
+  paddingRight: 24,
+  paddingBottom: 14,
+  paddingLeft: 16,
+  assetEnabled: true,
+  actionAssetFlavour: "flavour_1",
+  assetAlignment: "left",
+  assetHeight: 24,
+  assetWidth: 24,
+  assetMarginTop: 0,
+  assetMarginRight: 0,
+  assetMarginBottom: 0,
+  assetMarginLeft: 0,
+  labelEnabled: true,
+  fontColor: "rgba(239, 239, 239, 1)",
+  focusedFontColor: "rgba(239, 239, 239, 1)",
+  iosFontFamily: "Ubuntu-Bold",
+  androidFontFamily: "Ubuntu-Bold",
+  fontSize: 15,
+  lineHeight: 24,
+  iosLetterSpacing: -0.2,
+  androidLetterSpacing: -0.2,
+  textTransform: "default",
+  marginTop: 0,
+  marginRight: 0,
+  marginBottom: 0,
+  marginLeft: 0,
+  horizontalGutter: 8,
+  verticalGutter: 8,
+};
+
+const DEFAULT_MOBILE_ACTION_BUTTON_PRESETS = {
+  1: {
+    buttonEnabled: true,
+    assignAction: "navigation_action",
+    backgroundColor: "rgba(254, 20, 72, 1)",
+    focusedBackgroundColor: "rgba(213, 8, 54, 1)",
+  },
+  2: {
+    buttonEnabled: false,
+    assignAction: "secondary_navigation",
+  },
+  3: {
+    buttonEnabled: false,
+    assignAction: "local_storage_favourites_action",
+  },
+};
+
+module.exports = {
+  DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_PRESETS,
+};

package/manifestUtils/mobileAction/groups/index.js

@@ -0,0 +1,80 @@
+const { mobileActionButtonsContainer } = require("../container");
+const { mobileActionButton } = require("../button");
+
+const {
+  DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_PRESETS,
+} = require("./defaults");
+
+const CONTAINER_GROUP_LABEL = "Mobile Buttons Container"; // NOTE: used as key – "Mobile Buttons Container" -> "mobile_buttons_container"
+
+const CONTAINER_GROUP_DESCRIPTION =
+  "Configuration for mobile action buttons container";
+
+const BUTTON_GROUPS = [
+  {
+    index: 1,
+    label: "Mobile Button 1",
+    description: "Primary mobile action button",
+  },
+  {
+    index: 2,
+    label: "Mobile Button 2",
+    description: "Secondary mobile action button",
+  },
+  {
+    index: 3,
+    label: "Mobile Button 3",
+    description: "Tertiary mobile action button",
+  },
+];
+
+/**
+ * Builds the shared mobile action button manifest groups while letting each
+ * plugin supply only its supported insertion positions and explicit overrides.
+ *
+ * @param {object} options
+ * @param {object} [options.containerDefaults={}]
+ * @param {object} [options.sharedButtonDefaults={}]
+ * @param {Record<number, object>} [options.buttonOverrides={}]
+ * @returns {object[]}
+ */
+function buildMobileActionButtonGroups({
+  containerDefaults = {},
+  sharedButtonDefaults = {},
+  buttonOverrides = {},
+}) {
+  const groups = [
+    mobileActionButtonsContainer({
+      label: CONTAINER_GROUP_LABEL,
+      description: CONTAINER_GROUP_DESCRIPTION,
+      defaults: {
+        ...DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS,
+        ...containerDefaults,
+      },
+    }),
+  ];
+
+  BUTTON_GROUPS.forEach(({ index, label, description }) => {
+    groups.push(
+      mobileActionButton({
+        isFirstButton: index === 1,
+        label,
+        description,
+        defaults: {
+          ...DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS,
+          ...sharedButtonDefaults,
+          ...DEFAULT_MOBILE_ACTION_BUTTON_PRESETS[index],
+          ...(buttonOverrides[index] || {}),
+        },
+      })
+    );
+  });
+
+  return groups;
+}
+
+module.exports = {
+  buildMobileActionButtonGroups,
+};

package/manifestUtils/tvAction/container/index.js

@@ -38,7 +38,7 @@ function tvActionButtonsContainer({ label, description, defaults }) {
     generateFieldsFromDefaultsWithoutPrefixedLabel(
       label,
       defaults,
-      tvActionButtonContainerFields(defaults["position"])
+      tvActionButtonContainerFields(defaults.position)
     )
   );
 

package/numberUtils/__tests__/isMinusZero.test.ts

@@ -0,0 +1,20 @@
+import { isMinusZero } from "..";
+
+describe("isMinusZero", () => {
+  it("return true for minus zero", () => {
+    expect(isMinusZero(-0)).toBe(true);
+  });
+
+  it("return false for positive zero", () => {
+    expect(isMinusZero(0)).toBe(false);
+  });
+
+  it("return false for non-zero numbers", () => {
+    const inputs = [-1, 1, 100, 0.1, -0.1, Infinity, -Infinity];
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      expect(isMinusZero(input)).toBe(false);
+    });
+  });
+});

package/numberUtils/__tests__/isZero.test.ts

@@ -0,0 +1,27 @@
+import { isZero } from "..";
+
+describe("isZero", () => {
+  it("return true for zero and minus zero", () => {
+    expect(isZero(0)).toBe(true);
+    expect(isZero(-0)).toBe(true);
+  });
+
+  it("return false for non-zero numbers", () => {
+    const inputs = [-1, 1, 100, 0.1, -0.1, Infinity, -Infinity, NaN];
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      expect(isZero(input)).toBe(false);
+    });
+  });
+
+  it("return false for non-number values", () => {
+    const inputs = ["0", "-0", null, undefined, "", {}, [], false, true];
+
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      expect(isZero(input)).toBe(false);
+    });
+  });
+});

package/numberUtils/__tests__/requireNumber.test.ts

@@ -0,0 +1,50 @@
+import { requireNumber } from "..";
+
+describe("requireNumber", () => {
+  it("return number if object key holds a number", () => {
+    const inputs = [-1, 1, 100, 0.2];
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      const output = requireNumber({ value: input }, "value");
+      expect(output).toBe(input);
+    });
+  });
+
+  it("return number if object key holds a string as number", () => {
+    const inputs = ["-1", "1", "100", "0.2"];
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      const output = requireNumber({ value: input }, "value");
+      expect(output).toBe(Number(input));
+    });
+  });
+
+  it("return null if object key holds zero", () => {
+    expect(requireNumber({ value: 0 }, "value")).toBeNull();
+    expect(requireNumber({ value: "0" }, "value")).toBeNull();
+  });
+
+  it("return null if object key is missing or not a number", () => {
+    const cases = [
+      [{}, "value"],
+      [{ value: null }, "value"],
+      [{ value: undefined }, "value"],
+      [{ value: NaN }, "value"],
+      [{ value: "" }, "value"],
+      [{ value: "vfdvf" }, "value"],
+      [{ value: {} }, "value"],
+      [{ value: [] }, "value"],
+      [null, "value"],
+      [undefined, "value"],
+    ] as const;
+
+    expect.assertions(cases.length);
+
+    cases.forEach(([obj, key]) => {
+      const output = requireNumber(obj, key);
+      expect(output).toBeNull();
+    });
+  });
+});

package/numberUtils/__tests__/toNumber.test.ts

@@ -21,9 +21,38 @@ describe("toNumber", () => {
     });
   });
 
+  it("return number if input is boxed string as number", () => {
+    const inputs = [
+      new String("-1"),
+      new String("0"),
+      new String("1"),
+      Object("100"),
+      Object("0.2"),
+    ];
+
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      const output = toNumber(input);
+      expect(output).toBe(Number(input));
+    });
+  });
+
+  it("return undefined if input is invalid boxed string", () => {
+    const inputs = [new String("vfdvf"), new String("5n"), Object("")];
+    expect.assertions(inputs.length);
+
+    inputs.forEach((input) => {
+      const output = toNumber(input);
+      expect(output).toBeUndefined();
+    });
+  });
+
   it("return undefined if input is not a number", () => {
     const inputs = [
       "vfdvf",
+      "5n",
+      "-5n",
       null,
       undefined,
       NaN,
@@ -41,4 +70,29 @@ describe("toNumber", () => {
       expect(output).toBeUndefined();
     });
   });
+
+  describe("BigInt support", () => {
+    // Conditional test based on BigInt availability
+    const isBigIntSupported = typeof BigInt !== "undefined";
+
+    if (isBigIntSupported) {
+      it("converts BigInt to number when BigInt is supported", () => {
+        expect(toNumber(BigInt(5))).toBe(5);
+        expect(toNumber(BigInt(0))).toBe(0);
+        expect(toNumber(BigInt(-10))).toBe(-10);
+        expect(toNumber(BigInt(1000))).toBe(1000);
+      });
+
+      it("handles large BigInt values that may lose precision", () => {
+        const largeBigInt = BigInt(Number.MAX_SAFE_INTEGER) + BigInt(1);
+        const result = toNumber(largeBigInt);
+        expect(result).toBe(Number(largeBigInt));
+      });
+    } else {
+      it("skips BigInt tests when BigInt is not supported", () => {
+        // Placeholder test to indicate BigInt is not available
+        expect(typeof BigInt).toBe("undefined");
+      });
+    }
+  });
 });