jfs-components 0.1.0 → 0.1.8

package/CHANGELOG.md

@@ -4,6 +4,43 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.1.8] - 2026-06-12
+
+- Added `BenefitCard` — header highlight + body benefit rows with icon/title/trailing value and optional CTA.
+- Added `CcCard` — credit-card merchandising card with badge row, media, benefit list, footer CTA, and `compact` variant.
+- Added `CompareTable` — accordion-style product comparison table with selection-card columns and feature rows.
+- Added `ComparisonBar` — controlled add/remove image slots with a trailing Compare action.
+- Added `PdpCcCard` — PDP credit-card hero with media, title, metrics row, and footer CTA.
+- Added `ProductMerchandisingCard` — full-bleed media card with glass footer, avatar, badge, and CTA (`GlassFill` platform split for native blur / web `backdrop-filter`).
+- Added `ProjectionMarker` — investment projection timeline with start/end values and a center duration/rate badge.
+- Added `Slider` — token-driven range slider with SVG track, step snapping, and imperative ref API (`getValue` / `setValue` / `increment` / `decrement`).
+- Added `TextSegment` — token-driven multi-colour inline text via `segments` or compositional `Text` children.
+- `DropdownInput` — imperative ref API (`open` / `close` / `toggle` / `focus` / `blur` / `measureInWindow`).
+- Form inputs — refs forwarded through `Checkbox`, `CheckboxItem`, `Radio`, `TextInput`, `InputSearch`, `NoteInput`, `AmountInput`, and `FormField`.
+- Figma/token sync pass; refreshed `.token-metadata.json`, `figma-modes.generated.ts`, icons registry, and Coin Variables tokens.
+- Added `npm run tokens` script (`scripts/figma-token-explorer.js`); `tsconfig.build.json` now excludes `scripts/`.
+
+---
+
+## [0.1.2] - 2026-06-10
+
+- Added `Overlay` — full-screen scrim with optional dismiss-on-press and `contentPlacement` (`center` / `top` / `bottom` / `stretch`).
+- `Drawer` — optional `showOverlay` + `onOverlayPress` scrim behind the sheet.
+- `Image` — new `resizeMethod` prop for sharper high-res bitmap rendering.
+- `FullscreenModal` — defers hero media render until modal width is measured.
+- `DropdownInput` — popup animation set to `none`.
+- `LottiePlayer` — fixed native module resolution (static `require` so Metro resolves when the peer is installed).
+
+---
+
+## [0.1.1] - 2026-06-10
+
+- Design tokens — the `modes` prop is now strongly typed end to end. A generated `Modes` type gives autocomplete and validation for both collection-name keys and mode-name values across every component, while staying fully backward compatible (opt-in `StrictModes` turns typos into compile errors). `FIGMA_MODES`, `CollectionName`, and `ModeOf` are exported from the package.
+- Storybook — components now expose per-collection mode `select` controls (auto-generated) in place of the freeform `modes` object control. Collection detection is composition-aware, so wrapper components (e.g. `Balance`, `BubbleChart`, `BrandChip`) surface the modes of the children they theme.
+- `FullscreenModal` — hero media now fills the modal edge to edge: the surface width is measured and an explicit ratio-derived box is applied to the background, fixing the right-side gap / mis-sized image on native.
+
+---
+
 ## [0.1.0] - 2026-06-08
 
 - Added `TestimonialsCard` — compact avatar + title + body card for testimonial carousels.

package/lib/commonjs/components/AmountInput/AmountInput.js

@@ -3,8 +3,8 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.default = AmountInput;
-var _react = _interopRequireDefault(require("react"));
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _figmaVariablesResolver = require("../../design-tokens/figma-variables-resolver");
 var _JFSThemeProvider = require("../../design-tokens/JFSThemeProvider");
@@ -13,17 +13,18 @@ var _NoteInput = _interopRequireDefault(require("../NoteInput/NoteInput"));
 var _reactUtils = require("../../utils/react-utils");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * AmountInput component that combines MoneyValue and NoteInput from Figma design.
  *
  * @component
  */
-function AmountInput({
+const AmountInput = /*#__PURE__*/(0, _react.forwardRef)(function AmountInput({
   moneyValueSlot,
   noteInputSlot,
   modes: propModes = _reactUtils.EMPTY_MODES,
   style
-}) {
+}, ref) {
   const {
     modes: globalModes
   } = (0, _JFSThemeProvider.useTokens)();
@@ -77,7 +78,9 @@ function AmountInput({
     return noteInputSlot;
   };
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    ref: ref,
     style: containerStyle,
     children: [renderMoneyValueSlot(), renderNoteInputSlot()]
   });
-}
+});
+var _default = exports.default = AmountInput;

package/lib/commonjs/components/AreaLineChart/AreaLineChart.js

@@ -99,7 +99,7 @@ const defaultFormatX = label => String(label);
  * @component
  */
 function AreaLineChart({
-  series,
+  series = [],
   xLabels,
   yMin,
   yMax,

package/lib/commonjs/components/Balance/Balance.js

@@ -11,6 +11,13 @@ var _MoneyValue = _interopRequireDefault(require("../MoneyValue/MoneyValue"));
 var _reactUtils = require("../../utils/react-utils");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// The Balance design renders its money value at the 36 px / 900-weight scale.
+// The `moneyValue/*` tokens alias into the `Context3` collection, where the
+// `Balance & Cards` mode supplies those larger values. Applied *before* the
+// caller's `modes` so any consumer can still override individual keys.
+const DEFAULT_MONEY_VALUE_MODES = {
+  Context3: 'Balance & Cards'
+};
 /**
  * Balance component that displays a title and a monetary value.
  *
@@ -34,7 +41,7 @@ function Balance({
   // Title styles
   const titleColor = (0, _figmaVariablesResolver.getVariableByName)('balance/title/foreground', modes) ?? '#0c0d10';
   const titleFontSize = (0, _figmaVariablesResolver.getVariableByName)('balance/title/fontSize', modes) ?? 14;
-  const titleFontFamily = (0, _figmaVariablesResolver.getVariableByName)('balance/title/fontFamily', modes) ?? 'System';
+  const titleFontFamily = (0, _figmaVariablesResolver.getVariableByName)('balance/title/fontFamily', modes) ?? 'JioType Var';
   const titleLineHeight = (0, _figmaVariablesResolver.getVariableByName)('balance/title/lineHeight', modes) ?? 18;
   const titleFontWeightValue = (0, _figmaVariablesResolver.getVariableByName)('balance/title/fontWeight', modes) ?? 500;
   const titleFontWeight = typeof titleFontWeightValue === 'number' ? titleFontWeightValue.toString() : titleFontWeightValue;
@@ -51,15 +58,13 @@ function Balance({
     fontWeight: titleFontWeight
   };
 
-  // Handle slot children or default content
-  const content = _react.default.Children.map(children, child => {
-    if (/*#__PURE__*/_react.default.isValidElement(child)) {
-      return /*#__PURE__*/_react.default.cloneElement(child, {
-        modes
-      });
-    }
-    return child;
-  });
+  // The money value renders at the Balance & Cards scale. Merge the default
+  // context mode first so the caller's `modes` can still override it, and
+  // force that context onto any slotted children so custom money values match.
+  const moneyValueModes = {
+    ...DEFAULT_MONEY_VALUE_MODES,
+    ...modes
+  };
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [containerStyle, style],
     "data-node-id": "1986:6203",
@@ -67,10 +72,10 @@ function Balance({
       style: titleStyle,
       "data-node-id": "1986:2613",
       children: title
-    }), children ? content : /*#__PURE__*/(0, _jsxRuntime.jsx)(_MoneyValue.default, {
+    }), children ? (0, _reactUtils.cloneChildrenWithModes)(children, modes, DEFAULT_MONEY_VALUE_MODES) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_MoneyValue.default, {
       value: amount,
       currency: currency,
-      modes: modes
+      modes: moneyValueModes
     })]
   });
 }

package/lib/commonjs/components/BenefitCard/BenefitCard.js

@@ -0,0 +1,231 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _figmaVariablesResolver = require("../../design-tokens/figma-variables-resolver");
+var _reactUtils = require("../../utils/react-utils");
+var _Icon = _interopRequireDefault(require("../Icon/Icon"));
+var _Text = _interopRequireDefault(require("../Text/Text"));
+var _ListItem = _interopRequireDefault(require("../ListItem/ListItem"));
+var _Divider = _interopRequireDefault(require("../Divider/Divider"));
+var _Button = _interopRequireDefault(require("../Button/Button"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * A single benefit row rendered with the shared `ListItem` primitive: a
+ * leading icon, a title and an optional right-aligned trailing value.
+ */
+
+/**
+ * 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 = _reactUtils.EMPTY_MODES,
+  style,
+  accessibilityLabel
+}) {
+  const tokens = (0, _react.useMemo)(() => resolveTokens(modes), [modes]);
+
+  // Sub-component modes. Consumer-supplied `modes` always win via spread order.
+  const listItemModes = (0, _react.useMemo)(() => ({
+    'List Item Style': 'Minimal',
+    ...modes
+  }), [modes]);
+  const iconModes = (0, _react.useMemo)(() => ({
+    AppearanceBrand: 'Secondary',
+    ...modes
+  }), [modes]);
+  const trailingTextModes = (0, _react.useMemo)(() => ({
+    'Text Sizes': 'Small',
+    Weight: 'Regular',
+    ...modes
+  }), [modes]);
+  const ctaModes = (0, _react.useMemo)(() => ({
+    'Button / Size': 'S',
+    ...modes
+  }), [modes]);
+  const renderItem = (item, key) => {
+    const leading = item.leading ?? (item.icon != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.default, {
+      iconName: item.icon,
+      color: item.iconColor,
+      modes: iconModes
+    }) : null);
+    const trailing = item.trailing ?? (item.trailingText != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Text.default, {
+      modes: trailingTextModes,
+      children: item.trailingText
+    }) : undefined);
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ListItem.default, {
+      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__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: styles.section,
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: styles.cardHeader,
+      children: [headerTitle != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: tokens.title,
+        children: headerTitle
+      }) : null, headerItem != null ? renderItem(headerItem, 'header-item') : null]
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Divider.default, {
+      modes: modes
+    })]
+  }) : null;
+  const bodyList = children ? (0, _reactUtils.cloneChildrenWithModes)(children, listItemModes) : (items ?? DEFAULT_ITEMS).map((item, index) => renderItem(item, index));
+  const ctaNode = button ?? /*#__PURE__*/(0, _jsxRuntime.jsx)(_Button.default, {
+    label: buttonLabel,
+    modes: ctaModes,
+    onPress: onButtonPress
+  });
+  const containerStyle = (0, _react.useMemo)(() => ({
+    ...tokens.container,
+    width
+  }), [tokens.container, width]);
+  const content = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [headerNode, /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: tokens.body,
+      children: [bodyTitle != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: tokens.title,
+        children: bodyTitle
+      }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: tokens.listWrap,
+        children: bodyList
+      })]
+    }), showButton ? ctaNode : null]
+  });
+  if (onPress) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      style: ({
+        pressed
+      }) => [containerStyle, pressed ? styles.pressed : null, style],
+      accessibilityRole: "button",
+      accessibilityLabel: accessibilityLabel ?? headerTitle ?? bodyTitle,
+      onPress: onPress,
+      children: content
+    });
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.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((0, _figmaVariablesResolver.getVariableByName)('benefitCard/background', modes), '#ffffff');
+  const paddingHorizontal = asNum((0, _figmaVariablesResolver.getVariableByName)('benefitCard/padding/horizontal', modes), 12);
+  const paddingVertical = asNum((0, _figmaVariablesResolver.getVariableByName)('benefitCard/padding/vertical', modes), 12);
+  const radius = asNum((0, _figmaVariablesResolver.getVariableByName)('benefitCard/radius', modes), 12);
+  const gap = asNum((0, _figmaVariablesResolver.getVariableByName)('benefitCard/gap', modes), 8);
+  const titleColor = asStr((0, _figmaVariablesResolver.getVariableByName)('benefitCard/title/foreground', modes), '#000000');
+  const titleSize = asNum((0, _figmaVariablesResolver.getVariableByName)('benefitCard/title/fontsize', modes), 14);
+  const titleFamily = asStr((0, _figmaVariablesResolver.getVariableByName)('benefitCard/title/fontFamily', modes), 'JioType Var');
+  const titleWeight = asStr((0, _figmaVariablesResolver.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 = _reactNative.StyleSheet.create({
+  section: {
+    alignSelf: 'stretch',
+    gap: 8
+  },
+  cardHeader: {
+    alignSelf: 'stretch',
+    gap: CARD_HEADER_GAP
+  },
+  pressed: {
+    opacity: 0.92
+  }
+});
+var _default = exports.default = BenefitCard;

package/lib/commonjs/components/Card/Card.js

@@ -15,7 +15,8 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * Context to share 'modes' with child components like Card.Title and Card.SupportText.
  * This ensures that nested components can resolve their tokens correctly without 
  * needing explicit mode prop passing for every child.
- */const CardContext = /*#__PURE__*/(0, _react.createContext)({});
+ */
+const CardContext = /*#__PURE__*/(0, _react.createContext)({});
 /**
  * Card component implementation from Figma node 765:6186.
  * 

package/lib/commonjs/components/CardFeedback/CardFeedback.js

@@ -19,7 +19,8 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /**
  * Context to share 'modes' with child components.
- */const CardFeedbackContext = /*#__PURE__*/(0, _react.createContext)({});
+ */
+const CardFeedbackContext = /*#__PURE__*/(0, _react.createContext)({});
 /**
  * CardFeedback component from Figma node 1280:4481.
  *