jfs-components 0.0.78 → 0.0.84

package/lib/module/components/ListItem/ListItem.js

@@ -3,7 +3,6 @@
 import React, { useCallback, useMemo, useRef } from 'react';
 import { View, Text, Pressable, Platform } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
-import IconCapsule from '../IconCapsule/IconCapsule';
 import NavArrow from '../NavArrow/NavArrow';
 import { usePressableWebSupport } from '../../utils/web-platform-utils';
 import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
@@ -15,9 +14,10 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const IS_IOS = Platform.OS === 'ios';
 const PRESS_DELAY = IS_IOS ? 130 : 0;
 
-// Forced modes for the endSlot — `Context: 'ListItem'` can never be
-// overridden by external modes. Frozen so identity is stable across renders.
-const END_SLOT_FORCED_MODES = Object.freeze({
+// Forced modes for the leading/trailing slots — `Context: 'ListItem'` can
+// never be overridden by external modes. Frozen so identity is stable across
+// renders. Applied to both slots so they cascade modes identically.
+const SLOT_FORCED_MODES = Object.freeze({
   Context: 'ListItem'
 });
 
@@ -32,7 +32,7 @@ const pressedOverlayStyle = {
 // ---------------------------------------------------------------------------
 
 function resolveListItemTokens(modes) {
-  // Modes used to cascade into slot children (leading / supportSlot / endSlot).
+  // Modes used to cascade into slot children (leading / supportSlot / trailing).
   // We do NOT inject an `AppearanceBrand` default here: slot content such as
   // Buttons or Badges carry their own intended appearance, so forcing one onto
   // them would be surprising.
@@ -131,9 +131,11 @@ const verticalSupportTextOverride = {
  *  - **design-token driven styling** via `getVariableByName` and `modes`
  *
  * Wherever the Figma layer name contains "Slot", this component exposes a
- * dedicated React "slot" prop:
+ * dedicated React "slot" prop. The leading and trailing edges share a
+ * symmetric `leading` / `trailing` slot API:
+ *  - Slot "leading" → `leading`
  *  - Slot "support text" → `supportSlot`
- *  - Slot "end" → `endSlot`
+ *  - Slot "trailing" → `trailing`
  *
  * @component
  * @param {Object} props
@@ -141,9 +143,9 @@ const verticalSupportTextOverride = {
  * @param {string} [props.title='Title'] - Primary title used in the horizontal layout.
  * @param {string} [props.supportText='Support Text'] - Support text used in both layouts when `supportSlot` is not provided.
  * @param {boolean} [props.showSupportText=true] - Toggles rendering of the support text in Horizontal layout.
- * @param {React.ReactNode} [props.leading] - Optional leading element. Defaults to `IconCapsule`.
+ * @param {React.ReactNode|null} [props.leading] - Optional leading slot. Omitted or `null` renders nothing.
  * @param {React.ReactNode} [props.supportSlot] - Optional custom slot used instead of the default support text block.
- * @param {React.ReactNode} [props.endSlot] - Optional custom trailing slot (Figma Slot "end").
+ * @param {React.ReactNode} [props.trailing] - Optional trailing slot (Figma Slot "trailing"). Horizontal layout only.
  * @param {boolean} [props.navArrow=true] - Whether to show NavArrow on the far right (Horizontal layout only).
  * @param {Object} [props.modes={}] - Modes object passed to `getVariableByName` for all design tokens.
  * @param {Function} [props.onPress] - When provided, the entire item becomes pressable (navigation variant).
@@ -172,6 +174,7 @@ function ListItemImpl({
   showSupportText = true,
   leading,
   supportSlot,
+  trailing,
   endSlot,
   navArrow = true,
   modes = EMPTY_MODES,
@@ -209,13 +212,9 @@ function ListItemImpl({
   // Process leading slot to pass modes to children. Memoized on
   // (leading, resolvedModes) so a parent re-render doesn't re-walk the tree.
   const leadingElement = useMemo(() => {
-    const processed = leading ? cloneChildrenWithModes(React.Children.toArray(leading), tokens.resolvedModes) : [];
-    if (processed.length === 0) {
-      return /*#__PURE__*/_jsx(IconCapsule, {
-        modes: tokens.resolvedModes,
-        accessibilityLabel: undefined
-      });
-    }
+    if (leading == null) return null;
+    const processed = cloneChildrenWithModes(React.Children.toArray(leading), tokens.resolvedModes, SLOT_FORCED_MODES);
+    if (processed.length === 0) return null;
     return processed.length === 1 ? processed[0] : processed;
   }, [leading, tokens.resolvedModes]);
   const processedSupportSlot = useMemo(() => {
@@ -223,11 +222,14 @@ function ListItemImpl({
     const processed = cloneChildrenWithModes(React.Children.toArray(supportSlot), tokens.resolvedModes);
     return processed.length === 1 ? processed[0] : processed;
   }, [supportSlot, tokens.resolvedModes]);
-  const processedEndSlot = useMemo(() => {
-    if (!endSlot) return null;
-    const processed = cloneChildrenWithModes(React.Children.toArray(endSlot), tokens.resolvedModes, END_SLOT_FORCED_MODES);
+
+  // `trailing` wins; `endSlot` is the deprecated alias kept for back-compat.
+  const trailingContent = trailing ?? endSlot;
+  const processedTrailing = useMemo(() => {
+    if (!trailingContent) return null;
+    const processed = cloneChildrenWithModes(React.Children.toArray(trailingContent), tokens.resolvedModes, SLOT_FORCED_MODES);
     return processed.length === 1 ? processed[0] : processed;
-  }, [endSlot, tokens.resolvedModes]);
+  }, [trailingContent, tokens.resolvedModes]);
   const renderSupportContent = () => {
     if (processedSupportSlot) return processedSupportSlot;
 
@@ -262,7 +264,7 @@ function ListItemImpl({
   if (layout === 'Horizontal') {
     const innerContent = /*#__PURE__*/_jsxs(View, {
       style: innerContentStyleArray,
-      children: [leadingElement, /*#__PURE__*/_jsxs(View, {
+      children: [leadingElement ?? null, /*#__PURE__*/_jsxs(View, {
         style: {
           flex: 1,
           minWidth: 1,
@@ -273,9 +275,9 @@ function ListItemImpl({
           numberOfLines: 1,
           children: title
         }), showSupportText && renderSupportContent()]
-      }), processedEndSlot ? /*#__PURE__*/_jsx(View, {
+      }), processedTrailing ? /*#__PURE__*/_jsx(View, {
         style: tokens.trailingWrapperStyle,
-        children: processedEndSlot
+        children: processedTrailing
       }) : null, navArrow && /*#__PURE__*/_jsx(NavArrow, {
         direction: "Forward",
         modes: tokens.resolvedModes
@@ -309,7 +311,7 @@ function ListItemImpl({
   // Vertical layout — icon on top, support text/slot below
   const verticalContent = /*#__PURE__*/_jsxs(View, {
     style: verticalContentStyleArray,
-    children: [leadingElement, renderSupportContent()]
+    children: [leadingElement ?? null, renderSupportContent()]
   });
   if (onPress) {
     return /*#__PURE__*/_jsx(Pressable, {

package/lib/module/components/MessageField/MessageField.js

@@ -1,7 +1,7 @@
 "use strict";
 
-import React, { useCallback, useMemo, useRef, useState } from 'react';
-import { View, Text, Pressable, TextInput as RNTextInput } from 'react-native';
+import React, { useCallback, useMemo, useState } from 'react';
+import { View, Text, TextInput as RNTextInput } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { useTokens } from '../../design-tokens/JFSThemeProvider';
 import { EMPTY_MODES } from '../../utils/react-utils';
@@ -140,15 +140,6 @@ function MessageField({
   const currentValue = isControlled ? value : uncontrolledValue;
   const [isFocused, setIsFocused] = useState(false);
   const interactive = !isDisabled && !isReadOnly;
-
-  // Ref to the native textarea so tapping anywhere in the (padded) textarea
-  // container focuses it on the FIRST tap, fixing the Android "two taps to
-  // open the keyboard" issue.
-  const inputRef = useRef(null);
-  const focusInput = useCallback(() => {
-    if (!interactive) return;
-    inputRef.current?.focus();
-  }, [interactive]);
   const {
     modes: globalModes
   } = useTokens();
@@ -283,12 +274,9 @@ function MessageField({
         style: requiredIndicatorStyle,
         children: " *"
       })]
-    }), /*#__PURE__*/_jsx(Pressable, {
+    }), /*#__PURE__*/_jsx(View, {
       style: [textareaContainerStyle, textareaStyle],
-      onPress: focusInput,
-      accessible: false,
       children: /*#__PURE__*/_jsx(RNTextInput, {
-        ref: inputRef,
         multiline: true,
         value: currentValue,
         onChangeText: handleChangeText,

package/lib/module/components/PaymentFeedback/PaymentFeedback.js

@@ -1,16 +1,16 @@
 "use strict";
 
-import React, { isValidElement, cloneElement } from 'react';
+import React from 'react';
 import { View, Text } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { useTokens } from '../../design-tokens/JFSThemeProvider';
 import IconCapsule from '../IconCapsule/IconCapsule';
-import { EMPTY_MODES } from '../../utils/react-utils';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export default function PaymentFeedback({
   title = '₹50,000',
   subtitle = 'Payment successful',
-  body = 'Your payment has been\nsuccessfully processed.',
+  body,
   details = '18 March 2025, 4:15 pm\nTransaction ID: TXN121466784',
   showDetails = true,
   iconName = 'ic_confirm',
@@ -97,17 +97,21 @@ export default function PaymentFeedback({
     fontWeight: String(detailsFontWeight),
     textAlign: 'center'
   };
-  const mediaContent = /*#__PURE__*/isValidElement(renderMedia) ? /*#__PURE__*/cloneElement(renderMedia, {
-    modes
-  }) : renderMedia;
+
+  // Cascade modes into a custom media slot (per the modes-cascade convention);
+  // any modes the consumer set on the slot child still take precedence.
+  const mediaContent = renderMedia != null ? cloneChildrenWithModes(renderMedia, modes) : null;
   const defaultMedia = /*#__PURE__*/_jsx(IconCapsule, {
-    iconName: iconName,
+    iconName: iconName
+    // `positive` is the default; consumers override the capsule color by
+    // passing `AppearanceSystem` (or any other mode) via the `modes` prop.
+    ,
     modes: {
+      AppearanceSystem: 'positive',
       ...modes,
       'Icon Capsule Size': 'L',
       Emphasis: 'High',
-      'Semantic Intent': 'System',
-      AppearanceSystem: 'positive'
+      'Semantic Intent': 'System'
     }
   });
   const detailLines = details?.split('\n') ?? [];

package/lib/module/components/PlanComparisonCard/PlanComparisonCard.js

@@ -0,0 +1,234 @@
+"use strict";
+
+import React from 'react';
+import { View, Text, Pressable, Platform } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import Icon from '../../icons/Icon';
+
+/** Figma grid: label column 1.8fr, each plan column 1fr. */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const LABEL_COLUMN_FR = 1.8;
+const PLAN_COLUMN_FR = 1;
+
+/**
+ * A single plan column header (the label column has no header of its own).
+ */
+
+/**
+ * Value rendered inside a plan cell.
+ * - `string` / `number` → rendered as value text.
+ * - `false` → renders the muted "not available" cross icon.
+ * - any React node → rendered as-is (e.g. a `Badge`, `MoneyValue`, icon…).
+ * - `null` / `undefined` / `true` → empty cell.
+ */
+
+const DEFAULT_COLUMNS = [{
+  label: 'Your plan'
+}, {
+  label: 'JioFinance+',
+  brand: true
+}];
+const DEFAULT_ROWS = [{
+  label: 'JioPoints multiplier',
+  values: ['1x', '1.25x']
+}, {
+  label: 'Cashback',
+  showInfo: true,
+  values: [false, 'Upto ₹5000']
+}, {
+  label: 'Bonus JioGold',
+  showInfo: true,
+  values: [false, '1%']
+}];
+
+/** Keeps every text layer on a single line. */
+const NO_WRAP_TEXT = {
+  flexShrink: 0,
+  ...(Platform.OS === 'web' ? {
+    whiteSpace: 'nowrap'
+  } : {})
+};
+const labelColumnStyle = {
+  flex: LABEL_COLUMN_FR,
+  minWidth: 0
+};
+const planColumnStyle = {
+  flex: PLAN_COLUMN_FR,
+  minWidth: 0,
+  alignItems: 'center'
+};
+
+/**
+ * PlanComparisonCard renders a compact comparison table that pits the user's
+ * current plan against one or more alternative plans across a set of feature
+ * rows. Implementation of Figma node `4498:2968` (`PlanComparisonCard`).
+ *
+ * Columns use a 1.8fr / 1fr flex ratio (label vs plan), matching the Figma grid.
+ *
+ * @component
+ */
+function PlanComparisonCard({
+  columns = DEFAULT_COLUMNS,
+  rows = DEFAULT_ROWS,
+  modes = EMPTY_MODES,
+  style
+}) {
+  const gap = getVariableByName('planComparisonCard/gap', modes) ?? 16;
+  const headerFg = getVariableByName('planComparisonCard/header/fg', modes) ?? '#ffffff';
+  const headerBrandFg = getVariableByName('planComparisonCard/header/brand/fg', modes) ?? '#cea15a';
+  const headerFontSize = getVariableByName('planComparisonCard/header/fontSize', modes) ?? 14;
+  const headerFontFamily = getVariableByName('planComparisonCard/header/fontFamily', modes) ?? 'JioType Var';
+  const headerLineHeight = getVariableByName('planComparisonCard/header/lineHeight', modes) ?? 18;
+  const headerFontWeight = getVariableByName('planComparisonCard/header/fontWeight', modes) ?? '500';
+  const tableBackground = getVariableByName('planComparisonCard/tableRow/background', modes) ?? '#141414';
+  const tableRadius = getVariableByName('planComparisonCard/tableRow/radius', modes) ?? 16;
+  const tableBorderSize = getVariableByName('planComparisonCard/tableRow/border/size', modes) ?? 1;
+  const tableBorderColor = getVariableByName('planComparisonCard/tableRow/border/color', modes) ?? '#1e1a14';
+  const cellPadding = getVariableByName('planComparisonCard/tableCell/padding', modes) ?? 12;
+  const cellGap = getVariableByName('planComparisonCard/tableCell/gap', modes) ?? 2;
+  const cellMinHeight = getVariableByName('planComparisonCard/tableCell/height', modes) ?? 46;
+  const cellBorderSize = getVariableByName('planComparisonCard/tableCell/border/size', modes) ?? 1;
+  const cellBorderColor = getVariableByName('planComparisonCard/tableCell/border/color', modes) ?? '#1e1a14';
+  const labelColor = getVariableByName('planComparisonCard/tableCell/label/color', modes) ?? '#ffffff';
+  const labelDisabledColor = getVariableByName('planComparisonCard/tableCell/label/disabled/color', modes) ?? '#91949c';
+  const labelFontSize = getVariableByName('planComparisonCard/tableCell/label/fontSize', modes) ?? 12;
+  const labelFontFamily = getVariableByName('planComparisonCard/tableCell/label/fontFamily', modes) ?? 'JioType Var';
+  const labelLineHeight = getVariableByName('planComparisonCard/tableCell/label/lineHeight', modes) ?? 16;
+  const labelFontWeight = getVariableByName('planComparisonCard/tableCell/label/fontWeight', modes) ?? '400';
+  const valueColor = getVariableByName('planComparisonCard/tableCell/value/color', modes) ?? '#ffffff';
+  const valueFontSize = getVariableByName('planComparisonCard/tableCell/value/fontSize', modes) ?? 12;
+  const valueFontFamily = getVariableByName('planComparisonCard/tableCell/value/fontFamily', modes) ?? 'JioType Var';
+  const valueLineHeight = getVariableByName('planComparisonCard/tableCell/value/lineHeight', modes) ?? 16;
+  const valueFontWeight = getVariableByName('planComparisonCard/tableCell/value/fontWeight', modes) ?? '500';
+  const iconColor = getVariableByName('planComparisonCard/icon/color', modes) ?? '#ffffff';
+  const iconSize = getVariableByName('planComparisonCard/icon/size', modes) ?? 16;
+  const toWeight = w => typeof w === 'number' ? `${w}` : w;
+  const headerTextStyle = {
+    ...NO_WRAP_TEXT,
+    fontFamily: headerFontFamily,
+    fontSize: headerFontSize,
+    lineHeight: headerLineHeight,
+    fontWeight: toWeight(headerFontWeight),
+    textAlign: 'center'
+  };
+  const labelTextStyle = {
+    ...NO_WRAP_TEXT,
+    color: labelColor,
+    fontFamily: labelFontFamily,
+    fontSize: labelFontSize,
+    lineHeight: labelLineHeight,
+    fontWeight: toWeight(labelFontWeight)
+  };
+  const valueTextStyle = {
+    ...NO_WRAP_TEXT,
+    color: valueColor,
+    fontFamily: valueFontFamily,
+    fontSize: valueFontSize,
+    lineHeight: valueLineHeight,
+    fontWeight: toWeight(valueFontWeight),
+    textAlign: 'center'
+  };
+  const rowStyle = {
+    flexDirection: 'row',
+    width: '100%'
+  };
+  const labelCellStyle = {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: cellGap,
+    padding: cellPadding,
+    minHeight: cellMinHeight
+  };
+  const valueCellStyle = {
+    flexDirection: 'row',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: cellPadding,
+    minHeight: cellMinHeight,
+    width: '100%'
+  };
+  const renderValue = (value, cellKey) => {
+    if (value === false) {
+      return /*#__PURE__*/_jsx(Icon, {
+        name: "ic_close",
+        size: iconSize,
+        color: labelDisabledColor
+      }, cellKey);
+    }
+    if (value === null || value === undefined || value === true) {
+      return null;
+    }
+    if (typeof value === 'string' || typeof value === 'number') {
+      return /*#__PURE__*/_jsx(Text, {
+        style: valueTextStyle,
+        children: value
+      }, cellKey);
+    }
+    return cloneChildrenWithModes(value, modes);
+  };
+  return /*#__PURE__*/_jsxs(View, {
+    style: [{
+      gap,
+      width: '100%'
+    }, style],
+    children: [/*#__PURE__*/_jsxs(View, {
+      style: rowStyle,
+      children: [/*#__PURE__*/_jsx(View, {
+        style: labelColumnStyle
+      }), columns.map((column, index) => /*#__PURE__*/_jsx(View, {
+        style: planColumnStyle,
+        children: /*#__PURE__*/_jsx(Text, {
+          style: [headerTextStyle, {
+            color: column.brand ? headerBrandFg : headerFg
+          }],
+          children: column.label
+        })
+      }, column.label ?? index))]
+    }), /*#__PURE__*/_jsx(View, {
+      style: {
+        width: '100%',
+        backgroundColor: tableBackground,
+        borderWidth: tableBorderSize,
+        borderColor: tableBorderColor,
+        borderRadius: tableRadius,
+        overflow: 'hidden'
+      },
+      children: rows.map((row, rowIndex) => {
+        const isLast = rowIndex === rows.length - 1;
+        const showInfo = row.showInfo || row.onInfoPress != null;
+        return /*#__PURE__*/_jsxs(View, {
+          style: [rowStyle, {
+            borderBottomWidth: isLast ? 0 : cellBorderSize,
+            borderBottomColor: cellBorderColor
+          }],
+          children: [/*#__PURE__*/_jsxs(View, {
+            style: [labelColumnStyle, labelCellStyle],
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: labelTextStyle,
+              children: row.label
+            }), showInfo && (row.onInfoPress ? /*#__PURE__*/_jsx(Pressable, {
+              onPress: row.onInfoPress,
+              accessibilityRole: "button",
+              accessibilityLabel: `More information about ${row.label}`,
+              hitSlop: 8,
+              children: /*#__PURE__*/_jsx(Icon, {
+                name: "ic_info",
+                size: iconSize,
+                color: iconColor
+              })
+            }) : /*#__PURE__*/_jsx(Icon, {
+              name: "ic_info",
+              size: iconSize,
+              color: iconColor
+            }))]
+          }), columns.map((column, colIndex) => /*#__PURE__*/_jsx(View, {
+            style: [planColumnStyle, valueCellStyle],
+            children: renderValue(row.values?.[colIndex], `${rowIndex}-${colIndex}`)
+          }, column.label ?? colIndex))]
+        }, row.key ?? `${row.label}-${rowIndex}`);
+      })
+    })]
+  });
+}
+export default PlanComparisonCard;

package/lib/module/components/Slot/Slot.js

@@ -0,0 +1,68 @@
+"use strict";
+
+import React, { useMemo } from 'react';
+import { View } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { useTokens } from '../../design-tokens/JFSThemeProvider';
+import { cloneChildrenWithModes, EMPTY_MODES } from '../../utils/react-utils';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Slot — a token-driven layout container for grouped slot content.
+ *
+ * Use `Slot` instead of a raw `View` when you need a vertical or horizontal
+ * stack with design-token gap spacing and automatic `modes` propagation to
+ * children. Typical usage is nesting a column of actions inside a
+ * direction-locked parent such as `ActionFooter`:
+ *
+ * @example
+ * ```tsx
+ * <ActionFooter modes={modes}>
+ *   <Slot layoutDirection="vertical" modes={modes}>
+ *     <Button label="Continue" modes={primaryModes} />
+ *     <Disclaimer disclaimer="Terms apply." modes={modes} />
+ *   </Slot>
+ * </ActionFooter>
+ * ```
+ */
+function Slot({
+  children,
+  layoutDirection = 'vertical',
+  alignCrossAxis,
+  justifyMainAxis,
+  modes: propModes = EMPTY_MODES,
+  style,
+  ...rest
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+  const modes = useMemo(() => ({
+    ...globalModes,
+    ...propModes
+  }), [globalModes, propModes]);
+  const {
+    containerStyle,
+    processedChildren
+  } = useMemo(() => {
+    const gap = getVariableByName('slot/gap', modes) ?? 8;
+    const isHorizontal = layoutDirection === 'horizontal';
+    const container = {
+      flexDirection: isHorizontal ? 'row' : 'column',
+      alignItems: alignCrossAxis ?? (isHorizontal ? 'flex-start' : 'stretch'),
+      justifyContent: justifyMainAxis ?? (isHorizontal ? 'center' : undefined),
+      alignSelf: 'stretch',
+      gap
+    };
+    const processed = children ? cloneChildrenWithModes(children, modes) : null;
+    return {
+      containerStyle: container,
+      processedChildren: processed
+    };
+  }, [children, modes, layoutDirection, alignCrossAxis, justifyMainAxis]);
+  return /*#__PURE__*/_jsx(View, {
+    style: [containerStyle, style],
+    ...rest,
+    children: processedChildren
+  });
+}
+export default /*#__PURE__*/React.memo(Slot);