jfs-components 0.1.23 → 0.1.25

package/lib/typescript/src/components/ChipSelect/ChipSelect.d.ts

@@ -17,6 +17,11 @@ export type ChipSelectProps = {
      * @default "ic_calendar_week"
      */
     icon?: string;
+    /**
+     * Whether to show the close icon when active.
+     * @default true
+     */
+    showCloseIcon?: boolean;
     /**
      * Modes for design token resolution.
      */
@@ -38,6 +43,6 @@ export type ChipSelectProps = {
  * ChipSelect component for selecting options (e.g. Date selection).
  * Based on Figma Node 1901-4727.
  */
-declare function ChipSelect({ label, active, icon, modes, style, labelSlot, onPress, }: ChipSelectProps): import("react/jsx-runtime").JSX.Element;
+declare function ChipSelect({ label, active, icon, showCloseIcon, modes, style, labelSlot, onPress, }: ChipSelectProps): import("react/jsx-runtime").JSX.Element;
 export default ChipSelect;
 //# sourceMappingURL=ChipSelect.d.ts.map

package/lib/typescript/src/components/MetricData/MetricData.d.ts

@@ -0,0 +1,53 @@
+import React from 'react';
+import { type StyleProp, type ViewStyle, type TextStyle } from 'react-native';
+import type { Modes } from '../../design-tokens';
+export type MetricDataProps = {
+    /** Top label (small, 12px). Hidden when omitted. */
+    title?: string;
+    /**
+     * The prominent value (20px bold). Pass a string, or any node (e.g. a
+     * `MoneyValue`) to compose a richer value.
+     */
+    value?: string | React.ReactNode;
+    /** Sub-label below the value (12px, muted). Hidden when omitted. */
+    caption?: string;
+    /**
+     * Optional glyph shown to the left of the value. Pass a registry icon name
+     * (e.g. `'ic_card'`) or a custom node. Rendered at 18px, tinted to the value
+     * colour. Hidden when omitted.
+     */
+    icon?: string | React.ReactNode;
+    /** Design-token modes for theming. */
+    modes?: Modes;
+    /** Override the container styles. */
+    style?: StyleProp<ViewStyle>;
+    /** Override the title text styles. */
+    titleStyle?: StyleProp<TextStyle>;
+    /** Override the value text styles. */
+    valueStyle?: StyleProp<TextStyle>;
+    /** Override the caption text styles. */
+    captionStyle?: StyleProp<TextStyle>;
+    /**
+     * Accessibility label. Defaults to the resolved `title`, `value` and
+     * `caption` text joined together.
+     */
+    accessibilityLabel?: string;
+};
+/**
+ * MetricData — a compact, centered metric block.
+ *
+ * Stacks a small `title`, a prominent `value` (with an optional leading
+ * `icon`), and a muted `caption`. Typography, colours, gaps and padding all
+ * resolve from the `metricdata/*` design tokens. `title`, `caption` and `icon`
+ * are optional; only `value` is shown by default.
+ *
+ * @example
+ * ```tsx
+ * <MetricData title="Balance" value="₹1,20,000" caption="as of today" />
+ * <MetricData title="Cards" value="12" icon="ic_card" caption="active" />
+ * ```
+ */
+declare function MetricData({ title, value, caption, icon, modes, style, titleStyle, valueStyle, captionStyle, accessibilityLabel, }: MetricDataProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: React.MemoExoticComponent<typeof MetricData>;
+export default _default;
+//# sourceMappingURL=MetricData.d.ts.map

package/lib/typescript/src/components/Rating/Rating.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import { View, type StyleProp, type ViewStyle } from 'react-native';
+import type { Modes } from '../../design-tokens';
+export type RatingProps = {
+    /** Number of filled stars. Rounded to the nearest whole star for display. */
+    value?: number;
+    /** Total number of stars to render. */
+    max?: number;
+    /**
+     * Called with the new rating (1..max) when a star is pressed. Providing this
+     * makes the control interactive; omit it (or set `readOnly`) for a display.
+     */
+    onChange?: (value: number) => void;
+    /** Force a read-only display even when `onChange` is provided. */
+    readOnly?: boolean;
+    /** Override the star edge length. Defaults to the `ratingStar/width` token. */
+    starSize?: number;
+    /** Override the spacing between stars. Defaults to the `rating/gap` token. */
+    gap?: number;
+    /** Design token modes forwarded to token lookups. */
+    modes?: Modes;
+    /** Optional container style overrides. */
+    style?: StyleProp<ViewStyle>;
+    /** Accessibility label for the whole rating. Defaults to "X of Y stars". */
+    accessibilityLabel?: string;
+} & Omit<React.ComponentProps<typeof View>, 'style'>;
+declare function Rating({ value, max, onChange, readOnly, starSize, gap, modes: propModes, style, accessibilityLabel, ...rest }: RatingProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: React.MemoExoticComponent<typeof Rating>;
+export default _default;
+//# sourceMappingURL=Rating.d.ts.map

package/lib/typescript/src/icons/registry.d.ts

@@ -4,7 +4,7 @@
  * Auto-generated from SVG files in src/icons/
  * DO NOT EDIT MANUALLY - Run "npm run icons:generate" to regenerate
  *
- * Generated: 2026-07-01T12:55:42.353Z
+ * Generated: 2026-07-03T01:43:10.333Z
  */
 export declare const iconRegistry: Record<string, {
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jfs-components",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "React Native Jio Finance Components Library",
   "author": "sunshuaiqi@gmail.com",
   "license": "MIT",

package/src/components/CardCTA/CardCTA.tsx

@@ -281,22 +281,37 @@ function CardCTA({
         zIndex: 1,
     }
 
-    // NOTE: rightWrap must NOT shrink on native. On Android (Yoga), the default
-    // `flex: 2` shorthand expands to `{ flexGrow: 2, flexShrink: 1, flexBasis: 0 }`,
-    // which — combined with `minWidth: 0` — lets Yoga shrink this wrapper below
-    // its own padding+IconCapsule width when leftWrap's text is long. Once that
-    // happens the horizontal padding collapses, `alignItems: 'flex-end'` pins
-    // the IconCapsule against the inner edge, and the icon ends up visually
-    // touching the body text (the wrapper "appears not to exist"). Web hides
-    // this because browsers honor `min-width: auto` on flex items. Use
-    // explicit `flexGrow`/`flexShrink: 0`/`flexBasis: 'auto'` so the wrapper
-    // is sized to its content as a floor and only grows for the design's
-    // 3:2 ratio when extra space is available. leftWrap already absorbs tight
-    // space via `flexShrink: 1` + `minWidth: 0`.
+    // NOTE: rightWrap must implement the design's TRUE `2fr` column.
+    //
+    // History of this style — two Yoga pitfalls pull in opposite directions:
+    //
+    //  1. `flex: 2` (=> flexBasis: 0, flexShrink: 1): on Android, Yoga could
+    //     shrink the wrapper below its padding+IconCapsule width when the left
+    //     text was long, collapsing the padding and gluing the icon to the
+    //     text. Browsers hide this because they honor `min-width: auto`; Yoga
+    //     always treats min-width as 0 unless told otherwise.
+    //  2. The previous workaround, `flexBasis: 'auto'` + `flexGrow: 2`, fixed
+    //     #1 but broke the column ratio: Yoga then sizes the wrapper to its
+    //     content FIRST (icon + padding) and distributes only the leftover
+    //     space 3:2. The icon width gets baked in on top of the 2fr share, so
+    //     the right column ends up much wider than the design's 2fr and the
+    //     body text wraps early with dead space to its right.
+    //
+    // Fundamental fix: keep the genuine fr-unit geometry (`flexBasis: 0`,
+    // grow 3:2, no shrink) and replace Yoga's missing `min-width: auto` with
+    // an explicit computed floor — the resolved IconCapsule size plus the
+    // wrapper's own horizontal padding. The column is exactly 2fr whenever
+    // space allows and can never collapse below its content.
+    const iconCapsuleModes = { ...modes, 'IconCapsule / Size': 'M', Emphasis: 'Medium', AppearanceBrand: 'Secondary' }
+    const rightWrapMinWidth =
+        ((getVariableByName('iconCapsule/size', iconCapsuleModes) as number) || 0) +
+        ((rightPaddingH as number) || 0) * 2
+
     const rightWrapStyle: ViewStyle = {
         flexGrow: 2,
         flexShrink: 0,
-        flexBasis: 'auto',
+        flexBasis: 0,
+        minWidth: rightWrapMinWidth,
         paddingHorizontal: rightPaddingH,
         paddingVertical: rightPaddingV,
         alignItems: 'flex-end',
@@ -555,9 +570,9 @@ function CardCTA({
             </View>
             <View style={rightWrapStyle}>
                 {iconSlot ? (
-                    cloneChildrenWithModes(iconSlot, {...modes, 'IconCapsule / Size': 'M',Emphasis: 'Medium', AppearanceBrand: 'Secondary'})
+                    cloneChildrenWithModes(iconSlot, iconCapsuleModes)
                 ) : (
-                    <IconCapsule iconName={iconName} modes={{...modes, 'IconCapsule / Size': 'M',Emphasis: 'Medium', AppearanceBrand: 'Secondary'}} />
+                    <IconCapsule iconName={iconName} modes={iconCapsuleModes} />
                 )}
             </View>
         </View>

package/src/components/ChipSelect/ChipSelect.tsx

@@ -21,6 +21,11 @@ export type ChipSelectProps = {
      * @default "ic_calendar_week"
      */
     icon?: string;
+    /**
+     * Whether to show the close icon when active.
+     * @default true
+     */
+    showCloseIcon?: boolean;
     /**
      * Modes for design token resolution.
      */
@@ -47,6 +52,7 @@ function ChipSelect({
     label = 'Date',
     active = false,
     icon = 'ic_calendar_week',
+    showCloseIcon = true,
     modes = EMPTY_MODES,
     style,
     labelSlot,
@@ -123,7 +129,7 @@ function ChipSelect({
 
             {renderLabel()}
 
-            {active && (
+            {active && showCloseIcon && (
                 <Icon name="ic_close" size={iconSize} color={textColor} />
             )}
         </TouchableOpacity>

package/src/components/ListItem/ListItem.tsx

@@ -322,9 +322,16 @@ function ListItemImpl({
   const renderSupportContent = () => {
     if (processedSupportSlot) return processedSupportSlot
 
-    // Default support text:
-    //  - vertical layout: main text (line-broken on spaces)
-    //  - horizontal layout: secondary line (clamped to 2 lines)
+    // Default support text — ONE `<Text>` hard-clamped to 2 lines via
+    // `numberOfLines={2}`, the only mechanism React Native actually enforces
+    // on iOS/Android (native has no `white-space: nowrap` equivalent, so any
+    // style-based trick cannot stop a too-wide word from wrapping).
+    //
+    //  - vertical layout: line-broken on spaces so each word gets its own line
+    //    ("Split Payments" → "Split" / "Payments"). If a word is still wider
+    //    than the cell (or there are 3+ words), RN cuts it off at line 2 with
+    //    a trailing ellipsis instead of ever spilling onto a third line.
+    //  - horizontal layout: natural wrapping, same 2-line clamp.
     const displayText = layout === 'Vertical'
       ? supportText.replace(/ /g, '\n')
       : supportText
@@ -336,7 +343,7 @@ function ListItemImpl({
             ? [tokens.supportTextStyle, verticalSupportTextOverride]
             : tokens.supportTextStyle
         }
-        {...resolveTruncation(disableTruncation, layout === 'Horizontal' ? 2 : undefined)}
+        {...resolveTruncation(disableTruncation, 2, 'tail')}
       >
         {displayText}
       </Text>

package/src/components/MetricData/MetricData.tsx

@@ -0,0 +1,185 @@
+import React from 'react'
+import {
+  View,
+  Text,
+  type StyleProp,
+  type ViewStyle,
+  type TextStyle,
+} from 'react-native'
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver'
+import { EMPTY_MODES } from '../../utils/react-utils'
+import Icon from '../Icon/Icon'
+import type { Modes } from '../../design-tokens'
+
+const LINE_HEIGHT_RATIO = 1.2
+const ICON_SIZE = 18
+// Figma renders the value-row icon with no surrounding padding; the shared Icon
+// component pulls padding from `icon/padding/*` tokens, so we zero it here.
+const ICON_PADDING_RESET: ViewStyle = {
+  paddingLeft: 0,
+  paddingRight: 0,
+  paddingTop: 0,
+  paddingBottom: 0,
+}
+
+export type MetricDataProps = {
+  /** Top label (small, 12px). Hidden when omitted. */
+  title?: string
+  /**
+   * The prominent value (20px bold). Pass a string, or any node (e.g. a
+   * `MoneyValue`) to compose a richer value.
+   */
+  value?: string | React.ReactNode
+  /** Sub-label below the value (12px, muted). Hidden when omitted. */
+  caption?: string
+  /**
+   * Optional glyph shown to the left of the value. Pass a registry icon name
+   * (e.g. `'ic_card'`) or a custom node. Rendered at 18px, tinted to the value
+   * colour. Hidden when omitted.
+   */
+  icon?: string | React.ReactNode
+  /** Design-token modes for theming. */
+  modes?: Modes
+  /** Override the container styles. */
+  style?: StyleProp<ViewStyle>
+  /** Override the title text styles. */
+  titleStyle?: StyleProp<TextStyle>
+  /** Override the value text styles. */
+  valueStyle?: StyleProp<TextStyle>
+  /** Override the caption text styles. */
+  captionStyle?: StyleProp<TextStyle>
+  /**
+   * Accessibility label. Defaults to the resolved `title`, `value` and
+   * `caption` text joined together.
+   */
+  accessibilityLabel?: string
+}
+
+/**
+ * MetricData — a compact, centered metric block.
+ *
+ * Stacks a small `title`, a prominent `value` (with an optional leading
+ * `icon`), and a muted `caption`. Typography, colours, gaps and padding all
+ * resolve from the `metricdata/*` design tokens. `title`, `caption` and `icon`
+ * are optional; only `value` is shown by default.
+ *
+ * @example
+ * ```tsx
+ * <MetricData title="Balance" value="₹1,20,000" caption="as of today" />
+ * <MetricData title="Cards" value="12" icon="ic_card" caption="active" />
+ * ```
+ */
+function MetricData({
+  title,
+  value,
+  caption,
+  icon,
+  modes = EMPTY_MODES,
+  style,
+  titleStyle,
+  valueStyle,
+  captionStyle,
+  accessibilityLabel,
+}: MetricDataProps) {
+  const titleColor = (getVariableByName('metricdata/title/color', modes) as string | null) ?? '#000000'
+  const titleFontFamily = (getVariableByName('metricdata/title/fontfamily', modes) as string | null) ?? 'JioType Var'
+  const titleFontSize = (getVariableByName('metricdata/title/fontsize', modes) as number | null) ?? 12
+  const titleFontWeight = String(getVariableByName('metricdata/title/fontweight', modes) ?? 400) as TextStyle['fontWeight']
+
+  const valueColor = (getVariableByName('metricdata/value/color', modes) as string | null) ?? '#000000'
+  const valueFontFamily = (getVariableByName('metricdata/value/fontfamily', modes) as string | null) ?? 'JioType Var'
+  const valueFontSize = (getVariableByName('metricdata/value/fontsize', modes) as number | null) ?? 20
+  const valueFontWeight = String(getVariableByName('metricdata/value/fontweight', modes) ?? 700) as TextStyle['fontWeight']
+
+  const captionColor = (getVariableByName('metricdata/caption/color', modes) as string | null) ?? '#777777'
+  const captionFontFamily = (getVariableByName('metricdata/caption/fontfamily', modes) as string | null) ?? 'JioType Var'
+  const captionFontSize = (getVariableByName('metricdata/caption/fontsize', modes) as number | null) ?? 12
+  const captionFontWeight = String(getVariableByName('metricdata/caption/fontweight', modes) ?? 500) as TextStyle['fontWeight']
+
+  const gap = (getVariableByName('metricdata/gap', modes) as number | null) ?? 4
+  const valueWrapGap = (getVariableByName('metricdata/valueWrap/gap', modes) as number | null) ?? 4
+  const paddingHorizontal = (getVariableByName('metricdata/padding/horizontal', modes) as number | null) ?? 10
+  const paddingVertical = (getVariableByName('metricdata/padding/vertical', modes) as number | null) ?? 10
+
+  const containerStyle: ViewStyle = {
+    flexDirection: 'column',
+    alignItems: 'center',
+    justifyContent: 'center',
+    gap,
+    paddingHorizontal,
+    paddingVertical,
+  }
+
+  const titleTextStyle: TextStyle = {
+    color: titleColor,
+    fontFamily: titleFontFamily,
+    fontSize: titleFontSize,
+    fontWeight: titleFontWeight,
+    lineHeight: titleFontSize * LINE_HEIGHT_RATIO,
+    textAlign: 'center',
+  }
+
+  const valueTextStyle: TextStyle = {
+    color: valueColor,
+    fontFamily: valueFontFamily,
+    fontSize: valueFontSize,
+    fontWeight: valueFontWeight,
+    lineHeight: valueFontSize * LINE_HEIGHT_RATIO,
+    textAlign: 'center',
+  }
+
+  const captionTextStyle: TextStyle = {
+    color: captionColor,
+    fontFamily: captionFontFamily,
+    fontSize: captionFontSize,
+    fontWeight: captionFontWeight,
+    lineHeight: captionFontSize * LINE_HEIGHT_RATIO,
+    textAlign: 'center',
+  }
+
+  const iconNode =
+    icon == null ? null : typeof icon === 'string' ? (
+      <Icon
+        iconName={icon}
+        size={ICON_SIZE}
+        color={valueColor}
+        modes={modes}
+        style={ICON_PADDING_RESET}
+      />
+    ) : (
+      icon
+    )
+
+  const resolvedLabel =
+    accessibilityLabel ??
+    ([title, typeof value === 'string' ? value : undefined, caption]
+      .filter(Boolean)
+      .join(', ') || undefined)
+
+  return (
+    <View
+      style={[containerStyle, style]}
+      accessible
+      {...(resolvedLabel !== undefined ? { accessibilityLabel: resolvedLabel } : null)}
+    >
+      {title !== undefined && title !== '' ? (
+        <Text style={[titleTextStyle, titleStyle]}>{title}</Text>
+      ) : null}
+
+      <View style={{ flexDirection: 'row', alignItems: 'center', justifyContent: 'center', gap: valueWrapGap }}>
+        {iconNode}
+        {typeof value === 'string' ? (
+          <Text style={[valueTextStyle, valueStyle]}>{value}</Text>
+        ) : (
+          value
+        )}
+      </View>
+
+      {caption !== undefined && caption !== '' ? (
+        <Text style={[captionTextStyle, captionStyle]}>{caption}</Text>
+      ) : null}
+    </View>
+  )
+}
+
+export default React.memo(MetricData)

package/src/components/Rating/Rating.tsx

@@ -0,0 +1,174 @@
+import React, { useMemo } from 'react'
+import {
+  Pressable,
+  View,
+  type StyleProp,
+  type ViewStyle,
+} from 'react-native'
+import Svg, { Path } 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 type { Modes } from '../../design-tokens'
+
+/**
+ * Star glyph taken directly from the Figma `Rating` component. Filled and empty
+ * stars share this shape and differ only by fill color, so a single path keeps
+ * the row perfectly aligned.
+ */
+const STAR_PATH =
+  'M40.7187 15.3334C40.4728 14.6159 40.0426 13.9805 39.4688 13.4885C38.8951 12.9965 38.1985 12.689 37.4403 12.566L28.3018 11.1721L24.2038 2.35741C23.8759 1.66044 23.3432 1.06596 22.6875 0.635476C22.0318 0.225491 21.2737 0 20.4951 0C19.7165 0 18.9583 0.225491 18.3027 0.635476C17.647 1.04546 17.1142 1.63994 16.7864 2.35741L12.6884 11.1721L3.4679 12.566C2.73026 12.689 2.01311 12.9965 1.43939 13.4885C0.865675 13.9805 0.435385 14.6159 0.189505 15.3334C-0.0358854 16.0304 -0.0563753 16.7889 0.107545 17.5063C0.271465 18.2238 0.640285 18.9003 1.15254 19.4333L7.89374 26.362L6.29552 36.1811C6.17258 36.9396 6.27503 37.7186 6.56189 38.4156C6.84875 39.1125 7.34051 39.7275 7.9757 40.1785C8.65187 40.691 9.49196 40.978 10.3525 40.9985C11.0697 40.9985 11.7664 40.8345 12.4015 40.486L20.5771 35.9761L28.7526 40.486C29.3673 40.8345 30.0844 41.019 30.8016 40.9985C31.6621 40.9985 32.4817 40.732 33.1784 40.24C33.7931 39.789 34.2849 39.1945 34.5922 38.4771C34.8791 37.7801 34.9815 37.0011 34.8586 36.2426L33.2604 26.4235L40.0016 19.4948C40.4933 18.9413 40.8007 18.2443 40.9441 17.5063C41.0671 16.7684 40.9851 16.0099 40.7187 15.3334Z'
+const STAR_VIEWBOX = '0 0 41 41'
+
+// Fallbacks mirror the Figma `Rating Star / Output` + `Rating Star State` tokens.
+const DEFAULT_STAR_SIZE = 41
+const DEFAULT_GAP = 12
+const SELECTED_FALLBACK = '#5D00B5'
+const IDLE_FALLBACK = '#F6F3FF'
+
+/**
+ * `ratingStar/background` is state-driven: the same token resolves to the filled
+ * color when `Rating Star State = selected` and to the empty color when `idle`.
+ */
+const RATING_STATE_COLLECTION = 'Rating Star State'
+
+export type RatingProps = {
+  /** Number of filled stars. Rounded to the nearest whole star for display. */
+  value?: number
+  /** Total number of stars to render. */
+  max?: number
+  /**
+   * Called with the new rating (1..max) when a star is pressed. Providing this
+   * makes the control interactive; omit it (or set `readOnly`) for a display.
+   */
+  onChange?: (value: number) => void
+  /** Force a read-only display even when `onChange` is provided. */
+  readOnly?: boolean
+  /** Override the star edge length. Defaults to the `ratingStar/width` token. */
+  starSize?: number
+  /** Override the spacing between stars. Defaults to the `rating/gap` token. */
+  gap?: number
+  /** Design token modes forwarded to token lookups. */
+  modes?: Modes
+  /** Optional container style overrides. */
+  style?: StyleProp<ViewStyle>
+  /** Accessibility label for the whole rating. Defaults to "X of Y stars". */
+  accessibilityLabel?: string
+} & Omit<React.ComponentProps<typeof View>, 'style'>
+
+const toNumber = (value: unknown, fallback: number) => {
+  const n = typeof value === 'string' ? Number(value) : value
+  return typeof n === 'number' && Number.isFinite(n) ? n : fallback
+}
+
+function Star({
+  width,
+  height,
+  color,
+}: {
+  width: number
+  height: number
+  color: string
+}) {
+  return (
+    <Svg width={width} height={height} viewBox={STAR_VIEWBOX}>
+      <Path d={STAR_PATH} fill={color} />
+    </Svg>
+  )
+}
+
+function Rating({
+  value = 0,
+  max = 5,
+  onChange,
+  readOnly = false,
+  starSize,
+  gap,
+  modes: propModes = EMPTY_MODES,
+  style,
+  accessibilityLabel,
+  ...rest
+}: RatingProps) {
+  const { modes: globalModes } = useTokens()
+  const modes = useMemo(
+    () =>
+      globalModes === EMPTY_MODES && propModes === EMPTY_MODES
+        ? EMPTY_MODES
+        : { ...globalModes, ...propModes },
+    [globalModes, propModes]
+  )
+
+  const { selectedColor, idleColor, starWidth, starHeight, resolvedGap } =
+    useMemo(() => {
+      const selected = getVariableByName('ratingStar/background', {
+        ...modes,
+        [RATING_STATE_COLLECTION]: 'selected',
+      }) as string | undefined
+      const idle = getVariableByName('ratingStar/background', {
+        ...modes,
+        [RATING_STATE_COLLECTION]: 'idle',
+      }) as string | undefined
+
+      return {
+        selectedColor: selected ?? SELECTED_FALLBACK,
+        idleColor: idle ?? IDLE_FALLBACK,
+        starWidth:
+          starSize ??
+          toNumber(
+            getVariableByName('ratingStar/width', modes),
+            DEFAULT_STAR_SIZE
+          ),
+        starHeight:
+          starSize ??
+          toNumber(
+            getVariableByName('ratingStar/height', modes),
+            DEFAULT_STAR_SIZE
+          ),
+        resolvedGap:
+          gap ?? toNumber(getVariableByName('rating/gap', modes), DEFAULT_GAP),
+      }
+    }, [modes, starSize, gap])
+
+  const total = Math.max(0, Math.round(max))
+  const filledCount = Math.max(0, Math.min(total, Math.round(value)))
+  const interactive = !readOnly && typeof onChange === 'function'
+  const label = accessibilityLabel ?? `${filledCount} of ${total} stars`
+
+  return (
+    <View
+      {...rest}
+      style={[
+        { flexDirection: 'row', alignItems: 'center', gap: resolvedGap },
+        style,
+      ]}
+      accessibilityRole={interactive ? 'adjustable' : 'image'}
+      accessibilityLabel={label}
+      accessibilityValue={
+        interactive ? { min: 0, max: total, now: filledCount } : undefined
+      }
+    >
+      {Array.from({ length: total }, (_, index) => {
+        const color = index < filledCount ? selectedColor : idleColor
+        const star = <Star width={starWidth} height={starHeight} color={color} />
+
+        if (!interactive) {
+          return <React.Fragment key={index}>{star}</React.Fragment>
+        }
+
+        return (
+          <Pressable
+            key={index}
+            onPress={() => onChange?.(index + 1)}
+            accessibilityRole="button"
+            accessibilityLabel={`Rate ${index + 1} of ${total} stars`}
+            hitSlop={8}
+          >
+            {star}
+          </Pressable>
+        )
+      })}
+    </View>
+  )
+}
+
+export default React.memo(Rating)

package/src/design-tokens/figma-modes.generated.ts

@@ -355,6 +355,7 @@ export const FIGMA_COMPONENT_MODES: Record<string, readonly string[]> = {
   "MediaCard": ["Contrast Context"],
   "MerchantProfile": ["Avatar Size", "Badge Size", "Color Mode", "context 10", "Context4", "Profile Card Appearance"],
   "MessageField": ["Color Mode", "FormField States"],
+  "MetricData": ["AppearanceBrand", "Badge Size", "Color Mode", "context 10", "Context4", "Emphasis", "Profile Card Appearance"],
   "MetricLegendItem": ["Appearance / DataViz", "Color Mode", "Emphasis / DataViz"],
   "MoneyValue": ["Color Mode", "Context3"],
   "MonthlyStatusGrid": ["Appearance / DataViz", "Calendar Glyph State", "Color Mode", "Emphasis / DataViz"],
@@ -373,6 +374,7 @@ export const FIGMA_COMPONENT_MODES: Record<string, readonly string[]> = {
   "ProjectionMarker": ["Color Mode", "context 10", "Profile Card Appearance"],
   "Radio": ["Color Mode"],
   "RangeTrack": ["Appearance / DataViz", "Color Mode", "Emphasis / DataViz"],
+  "Rating": ["Color Mode", "Rating Star State"],
   "RechargeCard": ["Avatar Size", "Badge Size", "Color Mode", "Context3", "Context4"],
   "SavingsGoalSummary": ["Appearance / DataViz", "AppearanceBrand", "AppearanceSystem", "Color Mode", "Emphasis", "Emphasis / DataViz", "LinearProgress Size", "Semantic Intent"],
   "Screen": ["Color Mode", "Page type"],

package/src/icons/registry.ts

@@ -4,7 +4,7 @@
  * Auto-generated from SVG files in src/icons/
  * DO NOT EDIT MANUALLY - Run "npm run icons:generate" to regenerate
  * 
- * Generated: 2026-07-01T12:55:42.353Z
+ * Generated: 2026-07-03T01:43:10.333Z
  */
 
 // Icon name to SVG data mapping