jfs-components 0.0.71 → 0.0.73

package/lib/module/components/CircularProgressBar/CircularProgressBar.js

@@ -37,11 +37,13 @@ function CircularProgressBar({
   value = 70,
   state = 'Inactive',
   valueLabel,
+  supportText,
   modes: propModes = EMPTY_MODES,
   style,
   trackStyle,
   progressStyle,
   valueStyle,
+  supportTextStyle,
   accessibilityLabel,
   ...rest
 }) {
@@ -52,6 +54,17 @@ function CircularProgressBar({
     ...globalModes,
     ...propModes
   };
+  // The Figma `circularProgressBar/track/color` variable aliases to the same
+  // chain as `progress/color`, so user-selected Brand modes collapse the
+  // track and progress to a single hue. The Figma source of truth always
+  // renders the track as a neutral gray, so we force Neutral/Medium when
+  // resolving the track color while keeping the user modes for everything
+  // else.
+  const trackModes = {
+    ...modes,
+    'AppearanceBrand': 'Neutral',
+    'Emphasis': 'Medium'
+  };
   const isActive = state === true || state === 'Active';
   const normalizedValue = clamp(value, 0, 100);
   const size = toNumber(getVariableByName('circularProgressBar/size', modes), 60);
@@ -59,15 +72,18 @@ function CircularProgressBar({
   const radius = Math.max(0, (size - strokeWidth) / 2);
   const center = size / 2;
   const circumference = 2 * Math.PI * radius;
-  const trackColor = getStrokeColor(trackStyle, getVariableByName('circularProgressBar/track/color', modes) || '#ebebed');
+  const trackColor = getStrokeColor(trackStyle, getVariableByName('circularProgressBar/track/color', trackModes) || '#ebebed');
   const progressColor = getStrokeColor(progressStyle, getVariableByName('circularProgressBar/progress/color', modes) || '#25ab21');
   const iconColor = getVariableByName('circularProgressBar/icon/color', modes) || '#666666';
   const iconSize = toNumber(getVariableByName('circularProgressBar/icon/size', modes), 24);
   const foreground = getVariableByName('circularProgressBar/foreground', modes) || '#0d0d0f';
-  const fontSize = toNumber(getVariableByName('circularProgressBar/fontSize', modes), 18);
+  const fontSize = toNumber(getVariableByName('circularProgressBar/value/fontSize', modes), 18);
   const fontFamily = getVariableByName('circularProgressBar/fontFamily', modes) || 'JioType Var';
-  const lineHeight = toNumber(getVariableByName('circularProgressBar/lineHeight', modes), 21);
-  const fontWeight = toFontWeight(getVariableByName('circularProgressBar/fontWeight', modes), '700');
+  const lineHeight = toNumber(getVariableByName('circularProgressBar/value/lineHeight', modes), 21);
+  const fontWeight = toFontWeight(getVariableByName('circularProgressBar/value/fontWeight', modes), '700');
+  const supportFontSize = toNumber(getVariableByName('circularProgressBar/supportText/fontSize', modes), 11);
+  const supportLineHeight = toNumber(getVariableByName('circularProgressBar/supportText/lineHeight', modes), 13);
+  const supportFontWeight = toFontWeight(getVariableByName('circularProgressBar/supportText/fontWeight', modes), '500');
   const computedContainerStyle = {
     alignItems: 'center',
     height: size,
@@ -75,13 +91,34 @@ function CircularProgressBar({
     position: 'relative',
     width: size
   };
+
+  // The text stack (support text + value) is centered inside the ring using
+  // an absolutely-positioned column. Keeping the wrapper absolute (rather
+  // than the individual texts, as in earlier versions) lets multi-line stacks
+  // render correctly without sub-pixel misalignment.
+  const textStackStyle = {
+    alignItems: 'center',
+    justifyContent: 'center',
+    left: 0,
+    position: 'absolute',
+    right: 0,
+    top: 0,
+    bottom: 0
+  };
   const computedValueStyle = {
     color: foreground,
     fontFamily,
     fontSize,
     fontWeight,
     lineHeight,
-    position: 'absolute',
+    textAlign: 'center'
+  };
+  const computedSupportTextStyle = {
+    color: foreground,
+    fontFamily,
+    fontSize: supportFontSize,
+    fontWeight: supportFontWeight,
+    lineHeight: supportLineHeight,
     textAlign: 'center'
   };
   const iconStyle = {
@@ -90,7 +127,8 @@ function CircularProgressBar({
     top: (size - iconSize) / 2
   };
   const displayValue = valueLabel ?? String(Math.round(normalizedValue));
-  const defaultAccessibilityLabel = accessibilityLabel ?? (isActive ? `${displayValue} out of 100` : 'Inactive progress');
+  const hasSupportText = typeof supportText === 'string' && supportText.length > 0;
+  const defaultAccessibilityLabel = accessibilityLabel ?? (isActive ? hasSupportText ? `${supportText}, ${displayValue} out of 100` : `${displayValue} out of 100` : 'Inactive progress');
   return /*#__PURE__*/_jsxs(View, {
     accessibilityRole: "progressbar",
     accessibilityLabel: defaultAccessibilityLabel,
@@ -126,9 +164,18 @@ function CircularProgressBar({
         originX: center,
         originY: center
       }) : null]
-    }), isActive ? /*#__PURE__*/_jsx(Text, {
-      style: [computedValueStyle, valueStyle],
-      children: displayValue
+    }), isActive ? /*#__PURE__*/_jsxs(View, {
+      style: textStackStyle,
+      pointerEvents: "none",
+      children: [hasSupportText ? /*#__PURE__*/_jsx(Text, {
+        style: [computedSupportTextStyle, supportTextStyle],
+        numberOfLines: 1,
+        children: supportText
+      }) : null, /*#__PURE__*/_jsx(Text, {
+        style: [computedValueStyle, valueStyle],
+        numberOfLines: 1,
+        children: displayValue
+      })]
     }) : /*#__PURE__*/_jsx(IconMinus, {
       width: iconSize,
       height: iconSize,

package/lib/module/components/CoverageBarComparison/CoverageBarComparison.js

@@ -0,0 +1,266 @@
+"use strict";
+
+import React from 'react';
+import { View, Text } from 'react-native';
+import Svg, { Rect } from 'react-native-svg';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { useTokens } from '../../design-tokens/JFSThemeProvider';
+import { EMPTY_MODES } from '../../utils/react-utils';
+import MetricLegendItem from '../MetricLegendItem/MetricLegendItem';
+
+/**
+ * One entry in the {@link CoverageBarComparisonProps.bars} array.
+ *
+ * Each entry carries **both** the bar's data and its legend label, so the
+ * number of bars is intrinsically equal to the number of legend items.
+ * There is no separate `legends` prop — that is by design.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Default per-index `Emphasis / DataViz` modes applied when the caller does
+ * not provide its own override. Ascends Low → Medium → High so the natural
+ * "Current vs Recommended" two-bar story matches the Figma reference (left
+ * = lighter / Low, right = darker / High). Cycles for >3 bars.
+ */
+const DEFAULT_EMPHASIS_CYCLE = ['Low', 'Medium', 'High'];
+function defaultEmphasisFor(index, total) {
+  if (total <= 1) {
+    return 'High';
+  }
+  if (total === 2) {
+    return index === 0 ? 'Low' : 'High';
+  }
+  return DEFAULT_EMPHASIS_CYCLE[index % DEFAULT_EMPHASIS_CYCLE.length];
+}
+const DEFAULT_BARS = [{
+  value: 40,
+  label: '₹1L (40%)',
+  legend: 'Current coverage'
+}, {
+  value: 100,
+  label: '₹2.5L (100%)',
+  legend: 'Recommended coverage'
+}];
+const toNumber = (value, fallback) => {
+  if (typeof value === 'number') {
+    return Number.isFinite(value) ? value : fallback;
+  }
+  if (typeof value === 'string') {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+  }
+  return fallback;
+};
+const toFontWeight = (value, fallback) => {
+  if (typeof value === 'number') {
+    return String(value);
+  }
+  if (typeof value === 'string') {
+    return value;
+  }
+  return fallback;
+};
+/**
+ * Bar shape rendered with `react-native-svg`. The wrapper measures its width
+ * via `onLayout` so the SVG can use concrete dimensions (RN SVG does not
+ * resolve percentage shape attributes when the parent SVG itself has a
+ * percentage `width`).
+ */
+function BarShape({
+  height,
+  color,
+  radius
+}) {
+  const [width, setWidth] = React.useState(0);
+  const handleLayout = React.useCallback(event => {
+    const next = event.nativeEvent.layout.width;
+    setWidth(prev => prev === next ? prev : next);
+  }, []);
+  if (height <= 0) {
+    return /*#__PURE__*/_jsx(View, {
+      onLayout: handleLayout,
+      style: {
+        width: '100%',
+        height: 0
+      }
+    });
+  }
+  const safeRadius = Math.max(0, Math.min(radius, width / 2, height / 2));
+  return /*#__PURE__*/_jsx(View, {
+    onLayout: handleLayout,
+    style: {
+      width: '100%',
+      height,
+      minWidth: 1
+    },
+    children: width > 0 ? /*#__PURE__*/_jsx(Svg, {
+      width: width,
+      height: height,
+      children: /*#__PURE__*/_jsx(Rect, {
+        x: 0,
+        y: 0,
+        width: width,
+        height: height,
+        rx: safeRadius,
+        ry: safeRadius,
+        fill: color
+      })
+    }) : null
+  });
+}
+
+/**
+ * `CoverageBarComparison` renders a small vertical-bar chart that compares
+ * 2+ values side by side, with a legend row directly below where each item
+ * is intrinsically tied to one bar.
+ *
+ * Cohesiveness guarantees:
+ * - The legend row is **derived** from the same `bars` prop, so the count
+ *   and order can never desynchronise from the chart.
+ * - Each bar's color, its tokenized `Emphasis / DataViz` mode and its
+ *   legend indicator dot are the same value.
+ *
+ * Bars are drawn with `react-native-svg` (`<Rect>` with `rx`), and the
+ * fonts/spacing/colors are sourced from the Figma `valueBar/*` and
+ * `coverageBarComparison/*` tokens.
+ *
+ * @component
+ */
+function CoverageBarComparison({
+  bars = DEFAULT_BARS,
+  max,
+  height = 100,
+  legendGap = 12,
+  modes: propModes = EMPTY_MODES,
+  style,
+  chartStyle,
+  legendStyle,
+  labelStyle,
+  accessibilityLabel
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+  const modes = React.useMemo(() => ({
+    ...globalModes,
+    ...propModes
+  }), [globalModes, propModes]);
+  const wrapGap = toNumber(getVariableByName('coverageBarComparison/wrap/gap', modes), 6);
+  const valueBarGap = toNumber(getVariableByName('valueBar/gap', modes), 4);
+  const barRadius = toNumber(getVariableByName('valueBar/bar/radius', modes), 10);
+  const fontFamily = getVariableByName('valueBar/fontFamily', modes) ?? 'JioType Var';
+  const fontSize = toNumber(getVariableByName('valueBar/fontSize', modes), 12);
+  const lineHeight = toNumber(getVariableByName('valueBar/lineHeight', modes), 16);
+  const fontWeight = toFontWeight(getVariableByName('valueBar/fontWeight', modes), '700');
+  const foreground = getVariableByName('valueBar/foreground', modes) ?? '#000000';
+  const labelHeight = lineHeight;
+  const barAreaHeight = Math.max(0, height - labelHeight - valueBarGap);
+  const total = bars.length;
+  const computedMax = max ?? bars.reduce((acc, bar) => Math.max(acc, bar.value), 0);
+  const safeMax = computedMax > 0 ? computedMax : 1;
+  const resolvedBars = React.useMemo(() => bars.map((bar, index) => {
+    const barModes = {
+      ...modes,
+      'Emphasis / DataViz': defaultEmphasisFor(index, total),
+      ...(bar.modes || {})
+    };
+    const ratio = Math.max(0, Math.min(1, bar.value / safeMax));
+    const tokenColor = getVariableByName('valueBar/bar/background', barModes) ?? '#c9b7ff';
+    const bgColor = bar.color ?? tokenColor;
+    return {
+      original: bar,
+      index,
+      barModes,
+      ratio,
+      bgColor
+    };
+  }), [bars, modes, safeMax, total]);
+  const computedLabelStyle = {
+    color: foreground,
+    fontFamily,
+    fontSize,
+    lineHeight,
+    fontWeight,
+    textAlign: 'center'
+  };
+  const defaultAccessibilityLabel = accessibilityLabel ?? `Comparison of ${total} bar${total === 1 ? '' : 's'}: ` + bars.map((bar, i) => {
+    const legend = typeof bar.legend === 'string' ? bar.legend : `bar ${i + 1}`;
+    return `${legend} ${bar.value}`;
+  }).join(', ');
+  return /*#__PURE__*/_jsxs(View, {
+    accessibilityLabel: defaultAccessibilityLabel,
+    style: [{
+      width: '100%'
+    }, style],
+    children: [/*#__PURE__*/_jsx(View, {
+      accessibilityRole: "image",
+      style: [{
+        flexDirection: 'row',
+        alignItems: 'flex-end',
+        height,
+        gap: wrapGap,
+        width: '100%'
+      }, chartStyle],
+      children: resolvedBars.map(({
+        original,
+        index,
+        ratio,
+        bgColor
+      }) => {
+        const barHeightPx = Math.max(0, barAreaHeight * ratio);
+        const valueBarTotalHeight = labelHeight + valueBarGap + barHeightPx;
+        const hasLabel = original.label !== undefined && original.label !== null && original.label !== false;
+        return /*#__PURE__*/_jsxs(View, {
+          accessibilityLabel: original.accessibilityLabel,
+          style: {
+            flex: 1,
+            flexDirection: 'column',
+            alignItems: 'stretch',
+            justifyContent: 'flex-end',
+            height: valueBarTotalHeight,
+            gap: valueBarGap,
+            minWidth: 1
+          },
+          children: [hasLabel ? /*#__PURE__*/_jsx(Text, {
+            numberOfLines: 1,
+            style: [computedLabelStyle, labelStyle],
+            children: original.label
+          }) : null, /*#__PURE__*/_jsx(BarShape, {
+            height: barHeightPx,
+            color: bgColor,
+            radius: barRadius
+          })]
+        }, original.key ?? `bar-${index}`);
+      })
+    }), /*#__PURE__*/_jsx(View, {
+      style: [{
+        marginTop: legendGap,
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        width: '100%'
+      }, legendStyle],
+      children: resolvedBars.map(({
+        original,
+        index,
+        barModes,
+        bgColor
+      }) => {
+        const indicatorOverride = original.color ? bgColor : undefined;
+        return /*#__PURE__*/_jsx(MetricLegendItem, {
+          label: original.legend,
+          value: original.legendValue,
+          modes: barModes,
+          ...(indicatorOverride !== undefined ? {
+            indicatorColor: indicatorOverride
+          } : {}),
+          style: {
+            flex: 1,
+            minWidth: 0
+          }
+        }, original.key ?? `legend-${index}`);
+      })
+    })]
+  });
+}
+export default CoverageBarComparison;

package/lib/module/components/CoverageRing/CoverageRing.js

@@ -0,0 +1,136 @@
+"use strict";
+
+import React from 'react';
+import { View } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { useTokens } from '../../design-tokens/JFSThemeProvider';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import Button from '../Button/Button';
+import CircularProgressBar from '../CircularProgressBar/CircularProgressBar';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const toNumber = (value, fallback) => {
+  if (typeof value === 'number') {
+    return Number.isFinite(value) ? value : fallback;
+  }
+  if (typeof value === 'string') {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+  }
+  return fallback;
+};
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+
+// The Figma "Coverage Ring" pairs a `circularProgressBar Size: M` ring with a
+// `Button / Size: S` Secondary button. Locking these in as component defaults
+// keeps the visual identical to the Figma reference when the caller supplies
+// only their own brand/theme modes — caller modes are still merged on top so
+// any of these can be overridden per-instance.
+const COMPONENT_DEFAULT_MODES = Object.freeze({
+  'circularProgressBar Size': 'M',
+  'Button / Size': 'S'
+});
+
+// Match the Figma source: regardless of the overall AppearanceBrand/Emphasis
+// the caller picks (used to colour the ring), the Coverage Ring CTA renders
+// with the Secondary brand at Medium emphasis — which resolves to the
+// pale-lavender background (`#dbcfff`) + deep-purple foreground (`#5d00b5`)
+// shown in Figma. Mirrors the pattern used by `CardFinancialCondition.tsx`.
+const BUTTON_FORCED_BRAND = Object.freeze({
+  AppearanceBrand: 'Secondary',
+  Emphasis: 'Medium'
+});
+
+/**
+ * `CoverageRing` renders a single-purpose insight: how many items out of a
+ * total have been covered (e.g. "4 of 7 benefits availed"), paired with a
+ * call-to-action button below the ring.
+ *
+ * It composes the existing {@link CircularProgressBar} (in its `M` size so
+ * there is room for a caption + value inside the ring) and {@link Button}
+ * (in its `S`, Secondary brand variant) — both driven by the same design
+ * tokens used by the rest of the design system.
+ *
+ * The ring fill is derived from `value / total`, so the percentage, the
+ * displayed `"{value} of {total}"` label and the support caption stay in
+ * sync automatically. There is no separate `progress` prop.
+ *
+ * @component
+ */
+function CoverageRing({
+  value = 4,
+  total = 7,
+  supportText = 'Benefits availed',
+  valueLabel,
+  actionLabel = 'Learn more',
+  onActionPress,
+  actionProps,
+  action,
+  children,
+  modes: propModes = EMPTY_MODES,
+  style,
+  supportTextStyle,
+  valueStyle,
+  accessibilityLabel,
+  ...rest
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+
+  // Merge order matches the rest of the design system (see `Gauge.tsx`):
+  // 1. Component-level defaults — the lowest-priority safety net.
+  // 2. Global modes from `JFSThemeProvider` — app-wide theme.
+  // 3. Caller-supplied `propModes` — highest priority, overrides everything.
+  const modes = React.useMemo(() => ({
+    ...COMPONENT_DEFAULT_MODES,
+    ...globalModes,
+    ...propModes
+  }), [propModes, globalModes]);
+
+  // Force the Secondary brand on the button only; the ring stays on whatever
+  // brand the caller selected. Done via a forcedModes layer so callers can't
+  // accidentally bring back a Primary-coloured CTA through their own modes.
+  const buttonModes = React.useMemo(() => ({
+    ...modes,
+    ...BUTTON_FORCED_BRAND
+  }), [modes]);
+  const safeTotal = total > 0 ? total : 0;
+  const clampedValue = clamp(value, 0, safeTotal);
+  const progressPercent = safeTotal > 0 ? clampedValue / safeTotal * 100 : 0;
+  const computedValueLabel = valueLabel ?? `${clampedValue} of ${safeTotal}`;
+  const gap = toNumber(getVariableByName('coverageRing/gap', modes), 16);
+  const containerStyle = {
+    alignItems: 'center',
+    gap
+  };
+
+  // Custom action slot resolution order: explicit `action` prop wins over
+  // `children`. We pass `modes` down via cloneChildrenWithModes so any
+  // token-driven child (e.g. a custom `<Button>`) inherits the parent theme.
+  const customAction = action ?? children;
+  const hasCustomAction = customAction !== undefined && customAction !== null;
+  const defaultAccessibilityLabel = accessibilityLabel ?? `${supportText}, ${computedValueLabel}`;
+  return /*#__PURE__*/_jsxs(View, {
+    accessibilityLabel: defaultAccessibilityLabel,
+    style: [containerStyle, style],
+    ...rest,
+    children: [/*#__PURE__*/_jsx(CircularProgressBar, {
+      state: "Active",
+      value: progressPercent,
+      valueLabel: computedValueLabel,
+      supportText: supportText,
+      supportTextStyle: supportTextStyle,
+      valueStyle: valueStyle,
+      modes: modes,
+      accessibilityLabel: `${supportText}, ${computedValueLabel}`
+    }), hasCustomAction ? cloneChildrenWithModes(customAction, buttonModes) : /*#__PURE__*/_jsx(Button, {
+      label: actionLabel,
+      modes: buttonModes,
+      ...(onActionPress !== undefined ? {
+        onPress: onActionPress
+      } : {}),
+      ...actionProps
+    })]
+  });
+}
+export default CoverageRing;