jfs-components 0.0.84 → 0.0.85

package/src/components/ClusterBubble/ClusterBubble.tsx

@@ -0,0 +1,359 @@
+import React, { useMemo, useState } from 'react'
+import {
+    Pressable,
+    StyleSheet,
+    Text,
+    View,
+    type LayoutChangeEvent,
+    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 } from '../../utils/react-utils'
+
+/** Where the value/label text sits relative to the circle. */
+export type ClusterBubbleLabelPlacement = 'inside' | 'outside' | 'auto'
+
+/** Which side of the circle an *outside* label is anchored to. */
+export type ClusterBubbleLabelDirection = 'top' | 'bottom' | 'left' | 'right'
+
+export type ClusterBubbleProps = {
+    /**
+     * The bold, primary content rendered in/under the bubble — e.g. `"40%"`,
+     * `"₹270K"`. Strings are auto-wrapped in a `<Text>`; pass a node for full
+     * control (e.g. a `MoneyValue`).
+     */
+    value?: React.ReactNode
+    /** The secondary caption shown beside the value — e.g. `"Recommended"`. */
+    label?: React.ReactNode
+    /** Diameter of the circle in px. Defaults to `120`. */
+    size?: number
+    /**
+     * `Appearance / DataViz` mode used to resolve the fill from the
+     * `dataViz/bg` token (e.g. `Primary`, `Secondary`, `Tertiary`).
+     * Defaults to `Primary`. The *emphasis* of the fill is taken from the
+     * `Emphasis / DataViz` mode in `modes`.
+     */
+    appearance?: string
+    /** Hard-override the circle fill color (bypasses token resolution). */
+    color?: string
+    /**
+     * Where the text sits. `inside` centers it within the circle, `outside`
+     * anchors it just beyond the circle's edge, and `auto` (default) picks
+     * `inside` when the bubble is at least `autoInsideMinSize` px, otherwise
+     * `outside`.
+     */
+    labelPlacement?: ClusterBubbleLabelPlacement
+    /**
+     * Which side an *outside* label is placed on. The label is positioned
+     * exactly `labelGap` px beyond the circle's radius in this direction.
+     * Defaults to `bottom`.
+     */
+    labelDirection?: ClusterBubbleLabelDirection
+    /** Gap in px between the circle's edge and an outside label. Defaults to `8`. */
+    labelGap?: number
+    /** Diameter (px) at/above which `auto` places the text inside. Defaults to `88`. */
+    autoInsideMinSize?: number
+    /**
+     * Text color when the label sits *inside*. Defaults to an automatic
+     * black/white choice based on the fill's luminance for legibility.
+     */
+    insideTextColor?: string
+    /** Press handler — wraps the bubble in a `Pressable` when provided. */
+    onPress?: () => void
+    /** Style override for the value text. */
+    valueStyle?: StyleProp<TextStyle>
+    /** Style override for the label text. */
+    labelStyle?: StyleProp<TextStyle>
+    /** Style override for the circle view. */
+    circleStyle?: StyleProp<ViewStyle>
+    /** Style override for the outer container. */
+    style?: StyleProp<ViewStyle>
+    /** Design token modes for theming (e.g. `{ 'Color Mode': 'Light' }`). */
+    modes?: Record<string, any>
+    /** Accessibility label. Defaults to a `value + label` composite. */
+    accessibilityLabel?: string
+}
+
+const DEFAULT_FILL = '#5d00b5'
+
+/** Parse `#rgb`, `#rrggbb`, `rgb()` / `rgba()` into 0–255 channels. */
+function parseColor(input: string): { r: number; g: number; b: number } | null {
+    if (typeof input !== 'string') return null
+    const value = input.trim()
+
+    if (value[0] === '#') {
+        let hex = value.slice(1)
+        if (hex.length === 3) {
+            hex = hex
+                .split('')
+                .map((ch) => ch + ch)
+                .join('')
+        }
+        if (hex.length >= 6) {
+            const r = parseInt(hex.slice(0, 2), 16)
+            const g = parseInt(hex.slice(2, 4), 16)
+            const b = parseInt(hex.slice(4, 6), 16)
+            if ([r, g, b].every((n) => Number.isFinite(n))) return { r, g, b }
+        }
+        return null
+    }
+
+    const match = value.match(/rgba?\(([^)]+)\)/i)
+    if (match) {
+        const parts = match[1].split(',').map((p) => parseFloat(p))
+        if (parts.length >= 3 && parts.slice(0, 3).every((n) => Number.isFinite(n))) {
+            return { r: parts[0], g: parts[1], b: parts[2] }
+        }
+    }
+    return null
+}
+
+/** Pick a legible foreground (near-black or white) for a given background. */
+function readableTextColor(background: string): string {
+    const rgb = parseColor(background)
+    if (!rgb) return '#ffffff'
+    // Perceived luminance (ITU-R BT.601).
+    const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255
+    return luminance > 0.6 ? '#0f0d0a' : '#ffffff'
+}
+
+/**
+ * `ClusterBubble` is the atomic circle that composes a `BubbleChart`. It renders
+ * a single token-colored disc with a bold `value` and a secondary `label`. The
+ * text can sit inside the circle or anchor just outside its edge on any side
+ * (`labelDirection`) at a precise `labelGap` distance — so consumers (or the
+ * chart) can steer labels toward free space. The inside text color adapts to
+ * the fill for legibility. It is fully usable standalone.
+ *
+ * @component
+ */
+function ClusterBubble({
+    value,
+    label,
+    size = 120,
+    appearance = 'Primary',
+    color,
+    labelPlacement = 'auto',
+    labelDirection = 'bottom',
+    labelGap = 8,
+    autoInsideMinSize = 88,
+    insideTextColor,
+    onPress,
+    valueStyle,
+    labelStyle,
+    circleStyle,
+    style,
+    modes: propModes = EMPTY_MODES,
+    accessibilityLabel,
+}: ClusterBubbleProps) {
+    const { modes: globalModes } = useTokens()
+    const modes = useMemo(() => ({ ...globalModes, ...propModes }), [globalModes, propModes])
+
+    // Emphasis is read from the `Emphasis / DataViz` mode (defaulting to the
+    // token's own default) rather than a dedicated prop.
+    const fill = useMemo(() => {
+        if (color) return color
+        return (
+            (getVariableByName('dataViz/bg', {
+                ...modes,
+                'Appearance / DataViz': appearance,
+            }) as string | null) ?? DEFAULT_FILL
+        )
+    }, [color, modes, appearance])
+
+    const fontFamily =
+        (getVariableByName('text/fontFamily', modes) as string | null) ?? 'JioType'
+    const outsideTextColor =
+        (getVariableByName('text/foreground', modes) as string | null) ?? '#0f0d0a'
+
+    const placement: 'inside' | 'outside' =
+        labelPlacement === 'auto'
+            ? size >= autoInsideMinSize
+                ? 'inside'
+                : 'outside'
+            : labelPlacement
+
+    // Measure the outside label so it can be anchored precisely on any side
+    // without guessing its dimensions.
+    const [labelSize, setLabelSize] = useState<{ w: number; h: number } | null>(null)
+    const handleLabelLayout = (e: LayoutChangeEvent) => {
+        const { width, height } = e.nativeEvent.layout
+        setLabelSize((prev) =>
+            prev && Math.abs(prev.w - width) < 0.5 && Math.abs(prev.h - height) < 0.5
+                ? prev
+                : { w: width, h: height }
+        )
+    }
+
+    // Default typography scales with the bubble when inside (so it fits the
+    // disc); fixed comfortable sizes when anchored outside.
+    const valueFontSize =
+        placement === 'inside' ? Math.round(Math.min(48, Math.max(13, size * 0.17))) : 24
+    const labelFontSize =
+        placement === 'inside' ? Math.round(Math.min(18, Math.max(10, size * 0.085))) : 14
+
+    const textColor =
+        placement === 'inside' ? insideTextColor ?? readableTextColor(fill) : outsideTextColor
+
+    const renderText = (
+        node: React.ReactNode,
+        baseStyle: TextStyle,
+        override: StyleProp<TextStyle>
+    ) => {
+        if (node === undefined || node === null || node === false) return null
+        if (typeof node === 'string' || typeof node === 'number') {
+            return (
+                <Text style={[baseStyle, override]} numberOfLines={2}>
+                    {node}
+                </Text>
+            )
+        }
+        return node
+    }
+
+    const valueNode = renderText(
+        value,
+        {
+            color: textColor,
+            fontFamily,
+            fontSize: valueFontSize,
+            lineHeight: Math.round(valueFontSize * 1.15),
+            fontWeight: '700',
+            textAlign: 'center',
+            letterSpacing: -0.5,
+        },
+        valueStyle
+    )
+
+    const labelNode = renderText(
+        label,
+        {
+            color: textColor,
+            fontFamily,
+            fontSize: labelFontSize,
+            lineHeight: Math.round(labelFontSize * 1.3),
+            fontWeight: '400',
+            textAlign: 'center',
+            letterSpacing: -0.2,
+        },
+        labelStyle
+    )
+
+    const hasText = !!valueNode || !!labelNode
+
+    const textBlock = hasText ? (
+        <View style={styles.textBlock}>
+            {valueNode}
+            {labelNode}
+        </View>
+    ) : null
+
+    const derivedA11y = [value, label]
+        .filter((v) => typeof v === 'string' || typeof v === 'number')
+        .join(', ')
+    const a11yLabel = accessibilityLabel ?? (derivedA11y || undefined)
+
+    const circle = (
+        <View
+            style={[
+                styles.circle,
+                { width: size, height: size, borderRadius: size / 2, backgroundColor: fill },
+                circleStyle,
+            ]}
+        >
+            {placement === 'inside' ? textBlock : null}
+        </View>
+    )
+
+    let content: React.ReactNode
+    if (placement === 'inside' || !textBlock) {
+        content = <View style={[styles.inlineContainer, style]}>{circle}</View>
+    } else {
+        // Anchor the label exactly `labelGap` beyond the radius on the chosen
+        // side. Hidden until measured to avoid a positioning flash.
+        const offset = labelOffset(labelDirection, size, labelGap, labelSize)
+        content = (
+            <View style={[{ width: size, height: size }, style]}>
+                {circle}
+                <View
+                    onLayout={handleLabelLayout}
+                    style={[
+                        styles.outsideLabel,
+                        { left: offset.left, top: offset.top, opacity: labelSize ? 1 : 0 },
+                    ]}
+                    pointerEvents="none"
+                >
+                    {textBlock}
+                </View>
+            </View>
+        )
+    }
+
+    if (onPress) {
+        return (
+            <Pressable
+                onPress={onPress}
+                accessibilityRole="button"
+                accessibilityLabel={a11yLabel}
+                style={({ pressed }) => (pressed ? styles.pressed : undefined)}
+            >
+                {content}
+            </Pressable>
+        )
+    }
+
+    return (
+        <View accessibilityRole="image" accessibilityLabel={a11yLabel}>
+            {content}
+        </View>
+    )
+}
+
+/** Compute the absolute `left/top` of the outside label box for a direction. */
+function labelOffset(
+    direction: ClusterBubbleLabelDirection,
+    size: number,
+    gap: number,
+    labelSize: { w: number; h: number } | null
+): { left: number; top: number } {
+    const center = size / 2
+    const w = labelSize?.w ?? 0
+    const h = labelSize?.h ?? 0
+    switch (direction) {
+        case 'top':
+            return { left: center - w / 2, top: -(gap + h) }
+        case 'bottom':
+            return { left: center - w / 2, top: size + gap }
+        case 'left':
+            return { left: -(gap + w), top: center - h / 2 }
+        case 'right':
+            return { left: size + gap, top: center - h / 2 }
+    }
+}
+
+const styles = StyleSheet.create({
+    inlineContainer: {
+        alignItems: 'center',
+    },
+    circle: {
+        alignItems: 'center',
+        justifyContent: 'center',
+        overflow: 'hidden',
+    },
+    textBlock: {
+        alignItems: 'center',
+        justifyContent: 'center',
+        paddingHorizontal: 8,
+    },
+    outsideLabel: {
+        position: 'absolute',
+    },
+    pressed: {
+        opacity: 0.85,
+    },
+})
+
+export default ClusterBubble

package/src/components/MetricLegendItem/MetricLegendItem.tsx

@@ -22,6 +22,12 @@ export type MetricLegendItemProps = {
      * `metricLegendItem/indicator/bg` design token.
      */
     indicatorColor?: string
+    /**
+     * Shape of the leading indicator. `'dot'` (default) renders the small
+     * circle used in categorical legends; `'line'` renders a short
+     * horizontal bar, matching the legend of a line chart.
+     */
+    indicatorShape?: 'dot' | 'line'
     /** Design token modes for theming (e.g. `{ 'Color Mode': 'Light' }`). */
     modes?: Record<string, any>
     /** Override container styles. */
@@ -46,6 +52,7 @@ function MetricLegendItem({
     label = 'Current (4 months)',
     value,
     indicatorColor,
+    indicatorShape = 'dot',
     modes = EMPTY_MODES,
     style,
     indicatorStyle,
@@ -107,12 +114,19 @@ function MetricLegendItem({
         >
             <View
                 style={[
-                    {
-                        width: indicatorSize,
-                        height: indicatorSize,
-                        borderRadius: indicatorRadius,
-                        backgroundColor: indicatorBg,
-                    },
+                    indicatorShape === 'line'
+                        ? {
+                              width: indicatorSize * 2,
+                              height: Math.max(2, Math.round(indicatorSize / 4)),
+                              borderRadius: indicatorRadius,
+                              backgroundColor: indicatorBg,
+                          }
+                        : {
+                              width: indicatorSize,
+                              height: indicatorSize,
+                              borderRadius: indicatorRadius,
+                              backgroundColor: indicatorBg,
+                          },
                     indicatorStyle,
                 ]}
             />

package/src/components/index.ts

@@ -110,6 +110,9 @@ export { default as RadioButton, type RadioButtonProps } from './RadioButton/Rad
 export { default as RechargeCard, type RechargeCardProps } from './RechargeCard/RechargeCard';
 export { default as SavingsGoalSummary, type SavingsGoalSummaryProps, type SavingsGoalSummaryItem } from './SavingsGoalSummary/SavingsGoalSummary';
 export { default as DonutChart, type DonutChartProps, type DonutChartSegmentData, type DonutChartSegmentProps, DonutChartSegment } from './DonutChart/DonutChart';
+export { default as AreaLineChart, useChart, type AreaLineChartProps, type ChartSeries, type ChartPoint, type ChartInset, type GoalPinConfig, type ChartGridProps, type ChartXAxisProps, type ChartYAxisProps, type ChartGoalPinProps } from './AreaLineChart/AreaLineChart';
+export { default as ClusterBubble, type ClusterBubbleProps, type ClusterBubbleLabelPlacement, type ClusterBubbleLabelDirection } from './ClusterBubble/ClusterBubble';
+export { default as BubbleChart, type BubbleChartProps, type BubbleDatum } from './BubbleChart/BubbleChart';
 export { default as DonutChartSummary, type DonutChartSummaryProps, type DonutChartSummaryItem } from './DonutChartSummary/DonutChartSummary';
 export { default as RangeTrack, type RangeTrackProps, type RangeTrackTab, type RangeTrackItem } from './RangeTrack/RangeTrack';
 export { default as SegmentedTrack, type SegmentedTrackProps, type SegmentedTrackSegmentData, type SegmentedTrackSegmentProps, SegmentedTrackSegment } from './SegmentedTrack/SegmentedTrack';