jfs-components 0.1.2 → 0.1.8

package/lib/commonjs/utils/react-utils.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.EMPTY_MODES = void 0;
 exports.cloneChildrenWithModes = cloneChildrenWithModes;
 exports.flattenChildren = flattenChildren;
+exports.mergeRefs = mergeRefs;
 var _react = _interopRequireDefault(require("react"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
@@ -79,6 +80,27 @@ function cloneChildrenWithModes(children, modes, forcedModes) {
   return _react.default.Children.toArray(result);
 }
 
+/**
+ * Combines several refs (object refs and/or callback refs) into a single
+ * callback ref. Useful when a component needs to keep its own internal ref to a
+ * node while still honouring a ref forwarded by the consumer.
+ *
+ * @example
+ * const inputRef = useRef<RNTextInput>(null)
+ * <RNTextInput ref={mergeRefs(inputRef, forwardedRef)} />
+ */
+function mergeRefs(...refs) {
+  return value => {
+    refs.forEach(ref => {
+      if (typeof ref === 'function') {
+        ref(value);
+      } else if (ref != null) {
+        ref.current = value;
+      }
+    });
+  };
+}
+
 /**
  * Flattens React children, extracting them from Fragments.
  * Useful for Group components that need to process individual items (e.g., for layout or styling)

package/lib/module/components/AmountInput/AmountInput.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import React from 'react';
+import React, { forwardRef } from 'react';
 import { View } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { useTokens } from '../../design-tokens/JFSThemeProvider';
@@ -13,12 +13,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * @component
  */
-export default function AmountInput({
+const AmountInput = /*#__PURE__*/forwardRef(function AmountInput({
   moneyValueSlot,
   noteInputSlot,
   modes: propModes = EMPTY_MODES,
   style
-}) {
+}, ref) {
   const {
     modes: globalModes
   } = useTokens();
@@ -72,7 +72,9 @@ export default function AmountInput({
     return noteInputSlot;
   };
   return /*#__PURE__*/_jsxs(View, {
+    ref: ref,
     style: containerStyle,
     children: [renderMoneyValueSlot(), renderNoteInputSlot()]
   });
-}
+});
+export default AmountInput;

package/lib/module/components/BenefitCard/BenefitCard.js

@@ -0,0 +1,225 @@
+"use strict";
+
+import React, { useMemo } from 'react';
+import { View, Text as RNText, Pressable, StyleSheet } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import Icon from '../Icon/Icon';
+import Text from '../Text/Text';
+import ListItem from '../ListItem/ListItem';
+import Divider from '../Divider/Divider';
+import Button from '../Button/Button';
+
+/**
+ * A single benefit row rendered with the shared `ListItem` primitive: a
+ * leading icon, a title and an optional right-aligned trailing value.
+ */
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * BenefitCard — Figma node 5352:1077 ("Benefit Card").
+ *
+ * A white, rounded card that summarises the rewards a user will earn. It is
+ * composed entirely from the shared design-system primitives so it stays in
+ * sync with the rest of the library:
+ *
+ *  - **Header** — a section title + a single highlighted {@link ListItem}
+ *    (leading `Icon`, title, right-aligned trailing value) followed by a
+ *    `Divider`.
+ *  - **Body** — a section title + a column of benefit {@link ListItem}s. The
+ *    list is a real slot: pass `children` to fully control it, or `items` for
+ *    the declarative path.
+ *  - **CTA** — a small {@link Button} (Figma `Button / Size = S`).
+ *
+ * The list rows resolve through the `List Item Style: Minimal` mode (12px /
+ * regular title, 4px gap, no padding) and the leading icons use the
+ * `AppearanceBrand: Secondary` brand color, exactly matching the design. All
+ * three defaults can be overridden via `modes`.
+ */
+function BenefitCard({
+  headerTitle = 'You will earn',
+  headerItem,
+  showHeader = true,
+  bodyTitle = 'Upgrade to JioFinance+ and earn more',
+  items,
+  children,
+  buttonLabel = 'Upgrade',
+  onButtonPress,
+  button,
+  showButton = true,
+  onPress,
+  width = 344,
+  modes = EMPTY_MODES,
+  style,
+  accessibilityLabel
+}) {
+  const tokens = useMemo(() => resolveTokens(modes), [modes]);
+
+  // Sub-component modes. Consumer-supplied `modes` always win via spread order.
+  const listItemModes = useMemo(() => ({
+    'List Item Style': 'Minimal',
+    ...modes
+  }), [modes]);
+  const iconModes = useMemo(() => ({
+    AppearanceBrand: 'Secondary',
+    ...modes
+  }), [modes]);
+  const trailingTextModes = useMemo(() => ({
+    'Text Sizes': 'Small',
+    Weight: 'Regular',
+    ...modes
+  }), [modes]);
+  const ctaModes = useMemo(() => ({
+    'Button / Size': 'S',
+    ...modes
+  }), [modes]);
+  const renderItem = (item, key) => {
+    const leading = item.leading ?? (item.icon != null ? /*#__PURE__*/_jsx(Icon, {
+      iconName: item.icon,
+      color: item.iconColor,
+      modes: iconModes
+    }) : null);
+    const trailing = item.trailing ?? (item.trailingText != null ? /*#__PURE__*/_jsx(Text, {
+      modes: trailingTextModes,
+      children: item.trailingText
+    }) : undefined);
+    return /*#__PURE__*/_jsx(ListItem, {
+      layout: "Horizontal",
+      navArrow: false,
+      showSupportText: false,
+      title: item.title,
+      leading: leading,
+      trailing: trailing,
+      onPress: item.onPress,
+      modes: listItemModes
+    }, key);
+  };
+  const headerNode = showHeader && (headerTitle != null || headerItem != null) ? /*#__PURE__*/_jsxs(View, {
+    style: styles.section,
+    children: [/*#__PURE__*/_jsxs(View, {
+      style: styles.cardHeader,
+      children: [headerTitle != null ? /*#__PURE__*/_jsx(RNText, {
+        style: tokens.title,
+        children: headerTitle
+      }) : null, headerItem != null ? renderItem(headerItem, 'header-item') : null]
+    }), /*#__PURE__*/_jsx(Divider, {
+      modes: modes
+    })]
+  }) : null;
+  const bodyList = children ? cloneChildrenWithModes(children, listItemModes) : (items ?? DEFAULT_ITEMS).map((item, index) => renderItem(item, index));
+  const ctaNode = button ?? /*#__PURE__*/_jsx(Button, {
+    label: buttonLabel,
+    modes: ctaModes,
+    onPress: onButtonPress
+  });
+  const containerStyle = useMemo(() => ({
+    ...tokens.container,
+    width
+  }), [tokens.container, width]);
+  const content = /*#__PURE__*/_jsxs(_Fragment, {
+    children: [headerNode, /*#__PURE__*/_jsxs(View, {
+      style: tokens.body,
+      children: [bodyTitle != null ? /*#__PURE__*/_jsx(RNText, {
+        style: tokens.title,
+        children: bodyTitle
+      }) : null, /*#__PURE__*/_jsx(View, {
+        style: tokens.listWrap,
+        children: bodyList
+      })]
+    }), showButton ? ctaNode : null]
+  });
+  if (onPress) {
+    return /*#__PURE__*/_jsx(Pressable, {
+      style: ({
+        pressed
+      }) => [containerStyle, pressed ? styles.pressed : null, style],
+      accessibilityRole: "button",
+      accessibilityLabel: accessibilityLabel ?? headerTitle ?? bodyTitle,
+      onPress: onPress,
+      children: content
+    });
+  }
+  return /*#__PURE__*/_jsx(View, {
+    style: [containerStyle, style],
+    accessibilityLabel: accessibilityLabel,
+    children: content
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Tokens / static styles
+// ---------------------------------------------------------------------------
+
+// The "card header" inner gap (title -> highlighted item) is a fixed 4px in
+// the Figma node and has no dedicated token.
+const CARD_HEADER_GAP = 4;
+function asNum(raw, fallback) {
+  const n = typeof raw === 'number' ? raw : parseFloat(raw);
+  return Number.isFinite(n) ? n : fallback;
+}
+function asStr(raw, fallback) {
+  return raw != null ? String(raw) : fallback;
+}
+function resolveTokens(modes) {
+  // NOTE: token names are passed as string literals DIRECTLY to
+  // getVariableByName so the `extract-component-tokens` script can statically
+  // collect them for the generated docs. Do not refactor these into a helper
+  // that receives the name as a variable.
+  const background = asStr(getVariableByName('benefitCard/background', modes), '#ffffff');
+  const paddingHorizontal = asNum(getVariableByName('benefitCard/padding/horizontal', modes), 12);
+  const paddingVertical = asNum(getVariableByName('benefitCard/padding/vertical', modes), 12);
+  const radius = asNum(getVariableByName('benefitCard/radius', modes), 12);
+  const gap = asNum(getVariableByName('benefitCard/gap', modes), 8);
+  const titleColor = asStr(getVariableByName('benefitCard/title/foreground', modes), '#000000');
+  const titleSize = asNum(getVariableByName('benefitCard/title/fontsize', modes), 14);
+  const titleFamily = asStr(getVariableByName('benefitCard/title/fontFamily', modes), 'JioType Var');
+  const titleWeight = asStr(getVariableByName('benefitCard/title/fontWeight', modes), '500');
+  return {
+    container: {
+      backgroundColor: background,
+      paddingHorizontal,
+      paddingVertical,
+      borderRadius: radius,
+      gap,
+      flexDirection: 'column',
+      alignItems: 'flex-start'
+    },
+    body: {
+      alignSelf: 'stretch',
+      gap
+    },
+    listWrap: {
+      alignSelf: 'stretch',
+      gap
+    },
+    title: {
+      color: titleColor,
+      fontSize: titleSize,
+      fontFamily: titleFamily,
+      fontWeight: titleWeight,
+      lineHeight: 20,
+      letterSpacing: -0.5,
+      includeFontPadding: false
+    }
+  };
+}
+const DEFAULT_ITEMS = [{
+  icon: 'ic_card',
+  title: 'Up to ₹5000 cashback'
+}, {
+  icon: 'ic_card',
+  title: '25% extra JioPoints'
+}];
+const styles = StyleSheet.create({
+  section: {
+    alignSelf: 'stretch',
+    gap: 8
+  },
+  cardHeader: {
+    alignSelf: 'stretch',
+    gap: CARD_HEADER_GAP
+  },
+  pressed: {
+    opacity: 0.92
+  }
+});
+export default BenefitCard;