jfs-components 0.0.70 → 0.0.72

package/src/components/Gauge/Gauge.tsx

@@ -0,0 +1,303 @@
+import React from 'react'
+import { StyleSheet, View, Text, type StyleProp, type TextStyle, 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, cloneChildrenWithModes } from '../../utils/react-utils'
+import SupportText, { type SupportTextProps } from '../SupportText/SupportText'
+
+type GaugeBaseProps = Omit<React.ComponentProps<typeof View>, 'children' | 'style'>
+
+export type GaugeProps = GaugeBaseProps & {
+  /** Current gauge value. Interpreted against `min` and `max`. */
+  value?: number
+  /** Lower bound used to normalize progress. */
+  min?: number
+  /** Upper bound used to normalize progress. */
+  max?: number
+  /** Optional formatted value shown in the default readout. */
+  valueLabel?: string
+  /** Heading above the arc. */
+  title?: string
+  /** Caption below the arc. */
+  caption?: string
+  /** Support text shown in the default readout. */
+  supportText?: string
+  /** Status passed to the default SupportText component. */
+  supportTextStatus?: SupportTextProps['status']
+  /** Hides the heading while keeping the rest of the layout intact. */
+  showTitle?: boolean
+  /** Hides the caption while keeping the rest of the layout intact. */
+  showCaption?: boolean
+  /** Hides default support text when no custom readout slot is provided. */
+  showSupportText?: boolean
+  /** Design token modes forwarded to token lookups and slot children. */
+  modes?: Record<string, any>
+  /** Slot rendered in the center of the gauge arc. Receives `modes` recursively. */
+  children?: React.ReactNode
+  /** Container style override. */
+  style?: StyleProp<ViewStyle>
+  /** Arc wrapper style override. */
+  arcStyle?: StyleProp<ViewStyle>
+  /** Readout container style override. */
+  readoutStyle?: StyleProp<ViewStyle>
+  /** Title text style override. */
+  titleStyle?: StyleProp<TextStyle>
+  /** Value text style override. */
+  valueStyle?: StyleProp<TextStyle>
+  /** Caption text style override. */
+  captionStyle?: StyleProp<TextStyle>
+  /** Track stroke style override. */
+  trackStyle?: StyleProp<ViewStyle>
+  /** Progress stroke style override. */
+  progressStyle?: StyleProp<ViewStyle>
+  /** Accessibility label for the whole gauge. */
+  accessibilityLabel?: string
+}
+
+const clamp = (value: number, min: number, max: number) => {
+  if (max <= min) {
+    return 0
+  }
+
+  return Math.min(1, Math.max(0, (value - min) / (max - min)))
+}
+
+const toNumber = (value: unknown, fallback: number) => {
+  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: unknown, fallback: TextStyle['fontWeight']) => {
+  if (typeof value === 'number') {
+    return String(value) as TextStyle['fontWeight']
+  }
+
+  if (typeof value === 'string') {
+    return value as TextStyle['fontWeight']
+  }
+
+  return fallback
+}
+
+const getStrokeColor = (style: StyleProp<ViewStyle>, fallback: string) => {
+  const flattened = StyleSheet.flatten(style)
+  return typeof flattened.backgroundColor === 'string'
+    ? flattened.backgroundColor
+    : fallback
+}
+
+function Gauge({
+  value = 84,
+  min = 0,
+  max = 100,
+  valueLabel,
+  title = 'Your score is based on strong data',
+  caption = 'Add more details for even better accuracy',
+  supportText = 'Support Text',
+  supportTextStatus = 'Success',
+  showTitle = true,
+  showCaption = true,
+  showSupportText = true,
+  modes: propModes = EMPTY_MODES,
+  children,
+  style,
+  arcStyle,
+  readoutStyle,
+  titleStyle,
+  valueStyle,
+  captionStyle,
+  trackStyle,
+  progressStyle,
+  accessibilityLabel,
+  ...rest
+}: GaugeProps) {
+  const { modes: globalModes } = useTokens()
+  const modes = { ...globalModes, ...propModes }
+  const supportTextModes = { ...modes, Status: supportTextStatus }
+
+  const gap = toNumber(getVariableByName('gauge/gap', modes), 30)
+  const padding = toNumber(getVariableByName('gauge/padding', modes), 16)
+  const width = toNumber(getVariableByName('gauge/width', modes), 299)
+  const arcWidth = toNumber(getVariableByName('gauge/arc/width', modes), 267)
+  const arcHeight = arcWidth * (186 / 328)
+
+  const trackSize = toNumber(getVariableByName('gauge/track/size', modes), 244)
+  const trackInnerRadius = toNumber(getVariableByName('gauge/track/radius', modes), 99)
+  const progressInnerRadius = toNumber(getVariableByName('gauge/progress/radius', modes), 99)
+  const innerRadius = Math.min(trackInnerRadius, progressInnerRadius)
+  const strokeWidth = Math.max(1, trackSize / 2 - innerRadius)
+  const radius = innerRadius + strokeWidth / 2
+  const centerX = arcWidth / 2
+  const centerY = Math.min(arcHeight - strokeWidth / 2, radius + strokeWidth / 2)
+  const startX = centerX - radius
+  const endX = centerX + radius
+  const arcPath = `M ${startX} ${centerY} A ${radius} ${radius} 0 0 1 ${endX} ${centerY}`
+  const arcLength = Math.PI * radius
+  const progress = clamp(value, min, max)
+
+  const titleColor = getVariableByName('gauge/title/color', modes) || '#0c0d10'
+  const titleFontSize = toNumber(getVariableByName('gauge/title/fontSize', modes), 23)
+  const titleLineHeight = toNumber(getVariableByName('gauge/title/lineHeight', modes), 23)
+  const titleFontFamily = getVariableByName('gauge/title/fontFamily', modes) || 'JioType Var'
+  const titleFontWeight = toFontWeight(getVariableByName('gauge/title/fontWeight', modes), '900')
+  const titleHeight = toNumber(getVariableByName('gauge/title/height', modes), 46)
+
+  const readoutGap = toNumber(getVariableByName('gauge/readout/gap', modes), 8)
+  const readoutPadding = toNumber(getVariableByName('gauge/readout/padding', modes), 8)
+  const valueColor = getVariableByName('gauge/readout/value/color', modes) || '#0c0d10'
+  const valueFontSize = toNumber(getVariableByName('gauge/readout/value/fontSize', modes), 36)
+  const valueLineHeight = toNumber(getVariableByName('gauge/readout/value/lineHeight', modes), 36)
+  const valueFontFamily = getVariableByName('gauge/readout/value/fontFamily', modes) || 'JioType Var'
+  const valueFontWeight = toFontWeight(getVariableByName('gauge/readout/value/fontWeight', modes), '800')
+
+  const captionColor = getVariableByName('gauge/caption/color', modes) || '#0c0d10'
+  const captionFontSize = toNumber(getVariableByName('gauge/caption/fontSize', modes), 14)
+  const captionLineHeight = toNumber(getVariableByName('gauge/caption/lineHeight', modes), 18)
+  const captionFontFamily = getVariableByName('gauge/caption/fontFamily', modes) || 'JioType Var'
+  const captionFontWeight = toFontWeight(getVariableByName('gauge/caption/fontWeight', modes), '500')
+
+  const trackColor = getStrokeColor(
+    trackStyle,
+    getVariableByName('gauge/track/color', modes) || '#f5f5f6'
+  )
+  const progressColor = getStrokeColor(
+    progressStyle,
+    getVariableByName('gauge/progress/color', modes) || '#25ab21'
+  )
+
+  const containerStyle: ViewStyle = {
+    alignItems: 'center',
+    gap,
+    padding,
+    width,
+  }
+
+  const computedTitleStyle: TextStyle = {
+    color: titleColor as string,
+    fontFamily: titleFontFamily as string,
+    fontSize: titleFontSize,
+    fontWeight: titleFontWeight,
+    lineHeight: titleLineHeight,
+    minHeight: titleHeight,
+    textAlign: 'center',
+    width: '100%',
+  }
+
+  const computedArcStyle: ViewStyle = {
+    height: arcHeight,
+    overflow: 'hidden',
+    position: 'relative',
+    width: '100%',
+  }
+
+  const computedReadoutStyle: ViewStyle = {
+    alignItems: 'center',
+    gap: readoutGap,
+    left: 0,
+    padding: readoutPadding,
+    position: 'absolute',
+    right: 0,
+    top: arcHeight * 0.42,
+  }
+
+  const computedValueStyle: TextStyle = {
+    color: valueColor as string,
+    fontFamily: valueFontFamily as string,
+    fontSize: valueFontSize,
+    fontWeight: valueFontWeight,
+    lineHeight: valueLineHeight,
+    textAlign: 'center',
+  }
+
+  const computedCaptionStyle: TextStyle = {
+    color: captionColor as string,
+    fontFamily: captionFontFamily as string,
+    fontSize: captionFontSize,
+    fontWeight: captionFontWeight,
+    lineHeight: captionLineHeight,
+    textAlign: 'center',
+    width: '100%',
+  }
+
+  const defaultValueLabel = valueLabel ?? String(Math.round(value))
+  const defaultAccessibilityLabel =
+    accessibilityLabel ??
+    `${title}. ${defaultValueLabel} out of ${max}. ${supportText}. ${caption}`
+
+  return (
+    <View
+      accessibilityRole="progressbar"
+      accessibilityLabel={defaultAccessibilityLabel}
+      accessibilityValue={{ min, max, now: value }}
+      style={[containerStyle, style]}
+      {...rest}
+    >
+      {showTitle ? (
+        <Text style={[computedTitleStyle, titleStyle]}>
+          {title}
+        </Text>
+      ) : null}
+
+      <View style={[computedArcStyle, arcStyle]}>
+        <Svg
+          width="100%"
+          height={arcHeight}
+          viewBox={`0 0 ${arcWidth} ${arcHeight}`}
+        >
+          <Path
+            d={arcPath}
+            stroke={trackColor}
+            strokeWidth={strokeWidth}
+            strokeLinecap="butt"
+            fill="none"
+          />
+          <Path
+            d={arcPath}
+            stroke={progressColor}
+            strokeWidth={strokeWidth}
+            strokeLinecap="butt"
+            fill="none"
+            strokeDasharray={`${arcLength} ${arcLength}`}
+            strokeDashoffset={arcLength * (1 - progress)}
+          />
+        </Svg>
+
+        <View style={[computedReadoutStyle, readoutStyle]}>
+          {children ? (
+            cloneChildrenWithModes(children, modes)
+          ) : (
+            <>
+              <Text style={[computedValueStyle, valueStyle]}>
+                {defaultValueLabel}
+              </Text>
+              {showSupportText ? (
+                <SupportText
+                  label={supportText}
+                  status={supportTextStatus}
+                  modes={supportTextModes}
+                />
+              ) : null}
+            </>
+          )}
+        </View>
+      </View>
+
+      {showCaption ? (
+        <Text style={[computedCaptionStyle, captionStyle]}>
+          {caption}
+        </Text>
+      ) : null}
+    </View>
+  )
+}
+
+export default Gauge

package/src/components/HoldingsCard/HoldingsCard.tsx

@@ -9,7 +9,7 @@ import {
     type ImageSourcePropType,
 } from 'react-native'
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver'
-import RadioButton from '../RadioButton/RadioButton'
+import Radio from '../Radio/Radio'
 import { EMPTY_MODES } from '../../utils/react-utils'
 
 export interface HoldingsCardDetailItem {
@@ -198,7 +198,7 @@ export default function HoldingsCard({
 
                 {/* Pointer events disabled — the whole card is the pressable target */}
                 <View pointerEvents="none">
-                    <RadioButton
+                    <Radio
                         selected={selected}
                         disabled={disabled}
                         modes={modes}

package/src/components/InstitutionBadge/InstitutionBadge.tsx

@@ -0,0 +1,216 @@
+import React, { useMemo } from 'react'
+import {
+  Text,
+  View,
+  type StyleProp,
+  type TextStyle,
+  type ViewStyle,
+} 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 MediaSource, { type UnifiedSource } from '../../utils/MediaSource'
+
+// Default avatar asset (shared with the Avatar component) so that
+// InstitutionBadge has a sensible visual fallback when no `source` is
+// provided in stories or playgrounds.
+const DEFAULT_AVATAR_IMAGE = require('../Avatar/31595e70c4181263f9971590224b12934b280c9b.png')
+
+type InstitutionBadgeBaseProps = Omit<
+  React.ComponentProps<typeof View>,
+  'children' | 'style'
+>
+
+export type InstitutionBadgeProps = InstitutionBadgeBaseProps & {
+  /** Visible label for the institution (e.g. bank name). */
+  label?: string
+  /**
+   * Unified avatar source. Accepts a remote URI (raster or `.svg`), an
+   * inline SVG XML string, a `require()` asset, an SVG React component,
+   * or an already-rendered React element. Smart-detects raster vs SVG so
+   * the same prop works on iOS, Android and web. See {@link UnifiedSource}.
+   * Ignored when `avatarSlot` is provided.
+   */
+  source?: UnifiedSource
+  /** Slot replacing the default Avatar (e.g. for monogram avatars). Receives `modes` recursively. */
+  avatarSlot?: React.ReactNode
+  /** Design token modes forwarded to token lookups and the Avatar slot. */
+  modes?: Record<string, any>
+  /** Container style override. */
+  style?: StyleProp<ViewStyle>
+  /** Label style override. */
+  labelStyle?: StyleProp<TextStyle>
+  /** Accessibility label. Defaults to `label`. */
+  accessibilityLabel?: string
+}
+
+interface InstitutionBadgeTokens {
+  containerStyle: ViewStyle
+  avatarStyle: ViewStyle
+  avatarSize: number
+  labelStyle: TextStyle
+}
+
+const toNumber = (value: unknown, fallback: number) => {
+  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: unknown, fallback: TextStyle['fontWeight']) => {
+  if (typeof value === 'number') {
+    return String(value) as TextStyle['fontWeight']
+  }
+
+  if (typeof value === 'string') {
+    return value as TextStyle['fontWeight']
+  }
+
+  return fallback
+}
+
+function resolveInstitutionBadgeTokens(
+  modes: Record<string, any>
+): InstitutionBadgeTokens {
+  const gap = toNumber(getVariableByName('institutionBadge/gap', modes), 8)
+
+  const foreground =
+    (getVariableByName('institutionBadge/foreground', modes) as string) ||
+    '#080d1a'
+  const fontSize = toNumber(
+    getVariableByName('institutionBadge/fontSize', modes),
+    14
+  )
+  const fontFamily =
+    (getVariableByName('institutionBadge/fontFamily', modes) as string) ||
+    'JioType Var'
+  const lineHeight = toNumber(
+    getVariableByName('institutionBadge/lineHeight', modes),
+    18
+  )
+  const fontWeight = toFontWeight(
+    getVariableByName('institutionBadge/fontWeight', modes),
+    '500'
+  )
+
+  // Avatar wrapper styled from shared `avatar/*` tokens so the badge stays
+  // visually consistent with other Avatar-bearing components.
+  const avatarSize = toNumber(getVariableByName('avatar/size', modes), 36)
+  const avatarRadiusRaw = toNumber(
+    getVariableByName('avatar/radius', modes),
+    9999
+  )
+  // 9999 is the design-token sentinel for "perfect circle".
+  const avatarRadius = avatarRadiusRaw === 9999 ? avatarSize / 2 : avatarRadiusRaw
+  const avatarBorderColor =
+    (getVariableByName('avatar/border/color', modes) as string) ||
+    'rgba(255,255,255,0)'
+  const avatarBorderSize = toNumber(
+    getVariableByName('avatar/border/size', modes),
+    1
+  )
+
+  return {
+    containerStyle: {
+      alignItems: 'center',
+      flexDirection: 'row',
+      gap,
+    },
+    avatarStyle: {
+      width: avatarSize,
+      height: avatarSize,
+      borderRadius: avatarRadius,
+      borderWidth: avatarBorderSize,
+      borderColor: avatarBorderColor,
+      overflow: 'hidden',
+    },
+    avatarSize,
+    labelStyle: {
+      color: foreground,
+      fontFamily,
+      fontSize,
+      fontWeight,
+      lineHeight,
+    },
+  }
+}
+
+// Default Avatar Size = M (36px in tokens) — matches the Figma badge. Callers
+// can override via `modes` if needed.
+const DEFAULT_AVATAR_MODE = 'M'
+
+function InstitutionBadge({
+  label = 'State Bank of India',
+  source,
+  avatarSlot,
+  modes: propModes = EMPTY_MODES,
+  style,
+  labelStyle,
+  accessibilityLabel,
+  ...rest
+}: InstitutionBadgeProps) {
+  const { modes: globalModes } = useTokens()
+  const modes = useMemo(
+    () =>
+      globalModes === EMPTY_MODES && propModes === EMPTY_MODES
+        ? EMPTY_MODES
+        : { ...globalModes, ...propModes },
+    [globalModes, propModes]
+  )
+
+  const avatarModes = useMemo(
+    () => ({ 'Avatar Size': DEFAULT_AVATAR_MODE, ...modes }),
+    [modes]
+  )
+
+  const tokens = useMemo(
+    () => resolveInstitutionBadgeTokens(avatarModes),
+    [avatarModes]
+  )
+
+  const processedAvatarSlot = useMemo(() => {
+    if (!avatarSlot) return null
+    const processed = cloneChildrenWithModes(
+      React.Children.toArray(avatarSlot),
+      avatarModes
+    )
+    return processed.length === 1 ? processed[0] : processed
+  }, [avatarSlot, avatarModes])
+
+  const resolvedSource: UnifiedSource =
+    (source as UnifiedSource | undefined) ?? (DEFAULT_AVATAR_IMAGE as UnifiedSource)
+
+  const defaultAccessibilityLabel = accessibilityLabel ?? label
+
+  return (
+    <View
+      accessibilityLabel={defaultAccessibilityLabel}
+      style={[tokens.containerStyle, style]}
+      {...rest}
+    >
+      {processedAvatarSlot || (
+        <View style={tokens.avatarStyle}>
+          <MediaSource
+            source={resolvedSource}
+            size={tokens.avatarSize}
+            resizeMode="cover"
+            accessibilityElementsHidden={true}
+            importantForAccessibility="no"
+          />
+        </View>
+      )}
+      <Text style={[tokens.labelStyle, labelStyle]} numberOfLines={1}>
+        {label}
+      </Text>
+    </View>
+  )
+}
+
+export default React.memo(InstitutionBadge)

package/src/components/ListGroup/ListGroup.tsx

@@ -55,7 +55,9 @@ function ListGroup({
 }: ListGroupProps) {
   // Resolve container tokens
   const backgroundColor = getVariableByName('listGroup/background', modes) || 'rgba(255,255,255,0)'
-  const borderColor = getVariableByName('listGroup/border/color', modes) || 'rgba(255,255,255,0)'
+  // The current exported token aliases a missing Figma variable. Keep the
+  // transparent fallback without logging the missing alias on every render.
+  const borderColor = 'rgba(255,255,255,0)'
   const borderWidth = getVariableByName('listGroup/borderWidth', modes) || 0
   const gap = getVariableByName('listGroup/gap', modes) || 12