jfs-components 0.0.72 → 0.0.74

package/lib/module/components/LottieIntroBlock/LottieIntroBlock.js

@@ -0,0 +1,144 @@
+"use strict";
+
+import React, { useMemo } from 'react';
+import { View, Text } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { useTokens } from '../../design-tokens/JFSThemeProvider';
+import Button from '../Button/Button';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const DEFAULT_MEDIA_SIZE = 117;
+/**
+ * LottieIntroBlock displays a centered onboarding/intro block composed of a
+ * media slot (typically a Lottie animation or illustration) above a title,
+ * an optional supportive paragraph, and an optional action button.
+ *
+ * All visual values are resolved from Figma design tokens via
+ * `getVariableByName`. Slots cascade the active `modes` to their children
+ * through `cloneChildrenWithModes`.
+ *
+ * @component
+ * @example
+ * ```tsx
+ * <LottieIntroBlock
+ *   title="Let's get to know how your financial health is doing"
+ *   supportText="From assets to taxes, stay on top of everything in one simple view."
+ *   buttonLabel="Get started"
+ *   onButtonPress={() => navigate('NextScreen')}
+ *   media={<MyLottiePlayer source={animationSource} />}
+ * />
+ * ```
+ */
+function LottieIntroBlock({
+  title = "Let's get to know how your financial health is doing",
+  showSupportText = true,
+  supportText = 'From assets to taxes, stay on top of everything in one simple view.',
+  showButton = true,
+  buttonLabel = 'Button',
+  onButtonPress,
+  media,
+  buttonSlot,
+  modes: propModes = EMPTY_MODES,
+  style,
+  testID
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+  const modes = useMemo(() => ({
+    ...globalModes,
+    ...propModes
+  }), [globalModes, propModes]);
+
+  // Container
+  const gap = Number(getVariableByName('lottieIntroBlock/gap', modes)) || 36;
+  const paddingHorizontal = Number(getVariableByName('lottieIntroBlock/padding/horizontal', modes)) || 0;
+  const paddingVertical = Number(getVariableByName('lottieIntroBlock/padding/vertical', modes)) || 16;
+
+  // Text wrap
+  const textWrapGap = Number(getVariableByName('lottieIntroBlock/textWrap/gap', modes)) || 16;
+
+  // Title
+  const titleColor = getVariableByName('lottieIntroBlock/title/foreground', modes) || '#0d0d0f';
+  const titleFontSize = Number(getVariableByName('lottieIntroBlock/title/fontSize', modes)) || 23;
+  const titleFontFamily = getVariableByName('lottieIntroBlock/title/fontFamily', modes) || 'System';
+  const titleLineHeight = Number(getVariableByName('lottieIntroBlock/title/lineHeight', modes)) || 23;
+  const titleFontWeight = getVariableByName('lottieIntroBlock/title/fontWeight', modes) || 900;
+
+  // Support text
+  const supportColor = getVariableByName('lottieIntroBlock/supportText/foreground', modes) || '#0d0d0f';
+  const supportFontSize = Number(getVariableByName('lottieIntroBlock/supportText/fontSize', modes)) || 14;
+  const supportFontFamily = getVariableByName('lottieIntroBlock/supportText/fontFamily', modes) || 'System';
+  const supportLineHeight = Number(getVariableByName('lottieIntroBlock/supportText/lineHeight', modes)) || 18;
+  const supportFontWeight = getVariableByName('lottieIntroBlock/supportText/fontWeight', modes) || 400;
+  const containerStyle = {
+    flexDirection: 'column',
+    alignItems: 'center',
+    paddingHorizontal,
+    paddingVertical,
+    gap
+  };
+  const textWrapStyle = {
+    flexDirection: 'column',
+    alignItems: 'center',
+    gap: textWrapGap,
+    width: '100%'
+  };
+  const titleStyle = {
+    color: titleColor,
+    fontSize: titleFontSize,
+    fontFamily: titleFontFamily,
+    lineHeight: titleLineHeight,
+    fontWeight: String(titleFontWeight),
+    textAlign: 'center'
+  };
+  const supportTextStyle = {
+    color: supportColor,
+    fontSize: supportFontSize,
+    fontFamily: supportFontFamily,
+    lineHeight: supportLineHeight,
+    fontWeight: String(supportFontWeight),
+    textAlign: 'center'
+  };
+  const mediaContent = useMemo(() => {
+    if (media === undefined || media === null) {
+      return /*#__PURE__*/_jsx(View, {
+        style: {
+          width: DEFAULT_MEDIA_SIZE,
+          height: DEFAULT_MEDIA_SIZE
+        },
+        accessibilityElementsHidden: true,
+        importantForAccessibility: "no-hide-descendants"
+      });
+    }
+    return cloneChildrenWithModes(media, modes);
+  }, [media, modes]);
+  const buttonContent = useMemo(() => {
+    if (buttonSlot !== undefined && buttonSlot !== null) {
+      return cloneChildrenWithModes(buttonSlot, modes);
+    }
+    if (!showButton) {
+      return null;
+    }
+    return /*#__PURE__*/_jsx(Button, {
+      label: buttonLabel,
+      onPress: onButtonPress,
+      modes: modes
+    });
+  }, [buttonSlot, showButton, buttonLabel, onButtonPress, modes]);
+  return /*#__PURE__*/_jsxs(View, {
+    style: [containerStyle, style],
+    testID: testID,
+    children: [mediaContent, /*#__PURE__*/_jsxs(View, {
+      style: textWrapStyle,
+      children: [/*#__PURE__*/_jsx(Text, {
+        style: titleStyle,
+        children: title
+      }), showSupportText && supportText ? /*#__PURE__*/_jsx(Text, {
+        style: supportTextStyle,
+        children: supportText
+      }) : null, buttonContent]
+    })]
+  });
+}
+export default LottieIntroBlock;

package/lib/module/components/MetricLegendItem/MetricLegendItem.js

@@ -0,0 +1,90 @@
+"use strict";
+
+import React from 'react';
+import { View, Text } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES } from '../../utils/react-utils';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * MetricLegendItem renders a horizontal row consisting of a small colored
+ * indicator dot, a label and an optional value. It is used in chart legends
+ * and similar metric callouts.
+ *
+ * @component
+ * @param {MetricLegendItemProps} props
+ */
+function MetricLegendItem({
+  label = 'Current (4 months)',
+  value,
+  indicatorColor,
+  modes = EMPTY_MODES,
+  style,
+  indicatorStyle,
+  labelStyle,
+  valueStyle
+}) {
+  const gap = getVariableByName('metricLegendItem/gap', modes) ?? 4;
+  const textWrapGap = getVariableByName('metricLegendItem/textWrap/gap', modes) ?? 4;
+  const indicatorSize = getVariableByName('metricLegendItem/indicator/size', modes) ?? 8;
+  const indicatorRadius = getVariableByName('metricLegendItem/indicator/radius', modes) ?? 999;
+  const indicatorBg = indicatorColor ?? getVariableByName('metricLegendItem/indicator/bg', modes) ?? '#f7ab21';
+  const labelColor = getVariableByName('metricLegendItem/label/color', modes) ?? '#000000';
+  const labelFontFamily = getVariableByName('metricLegendItem/label/fontFamily', modes) ?? 'JioType Var';
+  const labelFontSize = getVariableByName('metricLegendItem/label/fontSize', modes) ?? 12;
+  const labelLineHeight = getVariableByName('metricLegendItem/label/lineHeight', modes) ?? 16;
+  const labelFontWeightRaw = getVariableByName('metricLegendItem/label/fontWeight', modes) ?? 400;
+  const labelFontWeight = String(labelFontWeightRaw);
+  const valueColor = getVariableByName('metricLegendItem/value/color', modes) ?? '#000000';
+  const valueFontFamily = getVariableByName('metricLegendItem/value/fontFamily', modes) ?? 'JioType Var';
+  const valueFontSize = getVariableByName('metricLegendItem/value/fontSize', modes) ?? 12;
+  const valueLineHeight = getVariableByName('metricLegendItem/value/lineHeight', modes) ?? 16;
+  const valueFontWeightRaw = getVariableByName('metricLegendItem/value/fontWeight', modes) ?? 500;
+  const valueFontWeight = String(valueFontWeightRaw);
+  const showValue = value !== undefined && value !== null && value !== false;
+  return /*#__PURE__*/_jsxs(View, {
+    style: [{
+      flexDirection: 'row',
+      alignItems: 'center',
+      gap
+    }, style],
+    accessibilityRole: "text",
+    children: [/*#__PURE__*/_jsx(View, {
+      style: [{
+        width: indicatorSize,
+        height: indicatorSize,
+        borderRadius: indicatorRadius,
+        backgroundColor: indicatorBg
+      }, indicatorStyle]
+    }), /*#__PURE__*/_jsxs(View, {
+      style: {
+        flex: 1,
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: textWrapGap,
+        minWidth: 0
+      },
+      children: [/*#__PURE__*/_jsx(Text, {
+        style: [{
+          flex: 1,
+          color: labelColor,
+          fontFamily: labelFontFamily,
+          fontSize: labelFontSize,
+          lineHeight: labelLineHeight,
+          fontWeight: labelFontWeight
+        }, labelStyle],
+        children: label
+      }), showValue && /*#__PURE__*/_jsx(Text, {
+        style: [{
+          color: valueColor,
+          fontFamily: valueFontFamily,
+          fontSize: valueFontSize,
+          lineHeight: valueLineHeight,
+          fontWeight: valueFontWeight
+        }, valueStyle],
+        numberOfLines: 1,
+        children: value
+      })]
+    })]
+  });
+}
+export default MetricLegendItem;

package/lib/module/components/MonthlyStatusGrid/MonthlyStatusGrid.js

@@ -0,0 +1,281 @@
+"use strict";
+
+import React from 'react';
+import { View, Text } from 'react-native';
+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';
+
+/**
+ * The three semantic states a calendar glyph can be in. Maps 1:1 to the
+ * Figma `Calendar Glyph State` collection modes (`Idle`, `notSaved`,
+ * `saved`) and drives both the glyph fill/foreground tokens and the
+ * matching legend dot.
+ */
+
+/** One month entry in the grid. */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const DEFAULT_MONTH_LABELS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+const DEFAULT_LEGEND_LABELS = Object.freeze({
+  Idle: 'No data',
+  notSaved: 'Not saved',
+  saved: 'Saved'
+});
+const DEFAULT_LEGEND_STATUSES = ['Idle', 'notSaved', 'saved'];
+const DEFAULT_MONTHS = DEFAULT_MONTH_LABELS.map(label => ({
+  label,
+  status: 'Idle'
+}));
+
+/**
+ * Default tokens used as the safe fallbacks when token resolution returns
+ * `null` (e.g. modes are missing or the resolver hasn't been initialized).
+ * They mirror the Figma source values for the `Calendar Glyph State` modes.
+ */
+const FALLBACK_BG = {
+  Idle: '#e0e0e3',
+  notSaved: '#b84fbd',
+  saved: '#5d00b5'
+};
+const FALLBACK_FG = {
+  Idle: '#000000',
+  notSaved: '#ffffff',
+  saved: '#ffffff'
+};
+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;
+};
+/**
+ * Single calendar-month glyph: a small pill with a status-driven background
+ * and foreground, and a centered month label. Exposed for callers who want
+ * to compose glyphs themselves; most consumers should use
+ * {@link MonthlyStatusGrid} instead, which keeps the count, layout and
+ * legend in sync automatically.
+ */
+function CalendarGlyph({
+  label = 'Jan',
+  status = 'Idle',
+  modes: propModes = EMPTY_MODES,
+  style,
+  labelStyle,
+  accessibilityLabel
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+  const modes = React.useMemo(() => ({
+    ...globalModes,
+    ...propModes,
+    'Calendar Glyph State': status
+  }), [globalModes, propModes, status]);
+  const width = toNumber(getVariableByName('calendarGlyph/width', modes), 46);
+  const height = toNumber(getVariableByName('calendarGlyph/height', modes), 46);
+  const radius = toNumber(getVariableByName('calendarGlyph/radius', modes), 29);
+  const paddingTop = toNumber(getVariableByName('calendarGlyph/padding/top', modes), 16);
+  const paddingBottom = toNumber(getVariableByName('calendarGlyph/padding/bottom', modes), 16);
+  const paddingLeft = toNumber(getVariableByName('calendarGlyph/padding/left', modes), 13);
+  const paddingRight = toNumber(getVariableByName('calendarGlyph/padding/right', modes), 12);
+  const gap = toNumber(getVariableByName('calendarGlyph/gap', modes), 0);
+  const background = getVariableByName('calendarGlyph/background', modes) ?? FALLBACK_BG[status];
+  const foreground = getVariableByName('calendarGlyph/foreground', modes) ?? FALLBACK_FG[status];
+  const fontFamily = getVariableByName('calendarGlyph/fontFamily', modes) ?? 'JioType Var';
+  const fontSize = toNumber(getVariableByName('calendarGlyph/fontSize', modes), 12);
+  const lineHeight = toNumber(getVariableByName('calendarGlyph/lineHeight', modes), 14);
+  const fontWeight = toFontWeight(getVariableByName('calendarGlyph/fontWeight', modes), '500');
+  const defaultAccessibilityLabel = accessibilityLabel ?? `${typeof label === 'string' ? label : 'Month'}, ${DEFAULT_LEGEND_LABELS[status].toLowerCase()}`;
+  return /*#__PURE__*/_jsx(View, {
+    accessibilityLabel: defaultAccessibilityLabel,
+    style: [{
+      // Use min* so the pill is always at least the Figma size, but
+      // grows naturally when the label is wider (e.g. localized
+      // months). Avoids the ellipsis-truncation that happens when a
+      // 3-letter label barely overflows the strict inner width.
+      minWidth: width,
+      minHeight: height,
+      borderRadius: radius,
+      backgroundColor: background,
+      paddingTop,
+      paddingBottom,
+      paddingLeft,
+      paddingRight,
+      alignItems: 'center',
+      justifyContent: 'center',
+      gap
+    }, style],
+    children: /*#__PURE__*/_jsx(Text, {
+      numberOfLines: 1,
+      style: [{
+        color: foreground,
+        fontFamily,
+        fontSize,
+        lineHeight,
+        fontWeight,
+        textAlign: 'center'
+      }, labelStyle],
+      children: label
+    })
+  });
+}
+
+/**
+ * Resolve the canonical color pair for a status. Used by both the glyph and
+ * the matching legend item so they can never visually drift apart.
+ */
+function resolveStatusColors(status, modes) {
+  const statusModes = {
+    ...modes,
+    'Calendar Glyph State': status
+  };
+  const bg = getVariableByName('calendarGlyph/background', statusModes) ?? FALLBACK_BG[status];
+  const fg = getVariableByName('calendarGlyph/foreground', statusModes) ?? FALLBACK_FG[status];
+  return {
+    bg,
+    fg,
+    statusModes
+  };
+}
+
+/**
+ * `MonthlyStatusGrid` shows a year (or any contiguous range of months) as a
+ * grid of small pill-shaped calendar glyphs, each colored by its semantic
+ * status (`Idle` = "No data", `notSaved` = "Not saved", `saved` = "Saved").
+ * A legend below the grid explains the colors.
+ *
+ * Cohesiveness guarantees:
+ * - The number of glyphs is **always** `months.length`. There is no way to
+ *   render a glyph that has no underlying status.
+ * - The legend dot color for a status is resolved through the **same**
+ *   `calendarGlyph/background` token + `Calendar Glyph State` mode as the
+ *   glyph itself, so the visual mapping cannot drift.
+ *
+ * The chart is rendered with plain RN primitives (`View` + `Text`); SVG is
+ * unnecessary here because the glyph shape is a simple rounded rectangle.
+ *
+ * @component
+ */
+function MonthlyStatusGrid({
+  months = DEFAULT_MONTHS,
+  columns = 4,
+  legend,
+  legendStatuses = DEFAULT_LEGEND_STATUSES,
+  modes: propModes = EMPTY_MODES,
+  style,
+  monthsStyle,
+  rowStyle,
+  glyphStyle,
+  labelStyle,
+  legendStyle,
+  accessibilityLabel
+}) {
+  const {
+    modes: globalModes
+  } = useTokens();
+  const modes = React.useMemo(() => ({
+    ...globalModes,
+    ...propModes
+  }), [globalModes, propModes]);
+  const gridGap = toNumber(getVariableByName('monthlyStatusGrid/gap', modes), 16);
+  const rowGap = toNumber(getVariableByName('monthlyStatusGrid/months/gap', modes), 12);
+  const safeColumns = Math.max(1, Math.floor(columns));
+
+  // Group months into rows of `safeColumns`. Render-time only; cheap.
+  const rows = React.useMemo(() => {
+    const out = [];
+    for (let i = 0; i < months.length; i += safeColumns) {
+      out.push(months.slice(i, i + safeColumns));
+    }
+    return out;
+  }, [months, safeColumns]);
+  const showLegend = legend !== false;
+  const legendOverrides = legend && typeof legend === 'object' ? legend : {};
+  const defaultAccessibilityLabel = accessibilityLabel ?? `Monthly status grid: ${months.length} month${months.length === 1 ? '' : 's'}`;
+  return /*#__PURE__*/_jsxs(View, {
+    accessibilityLabel: defaultAccessibilityLabel,
+    style: [{
+      width: '100%',
+      gap: gridGap,
+      alignItems: 'stretch',
+      justifyContent: 'center'
+    }, style],
+    children: [/*#__PURE__*/_jsx(View, {
+      style: [{
+        width: '100%',
+        gap: rowGap,
+        alignItems: 'stretch'
+      }, monthsStyle],
+      children: rows.map((row, rowIndex) => /*#__PURE__*/_jsx(View, {
+        style: [{
+          flexDirection: 'row',
+          alignItems: 'center',
+          justifyContent: 'space-between',
+          width: '100%'
+        }, rowStyle],
+        children: row.map((month, colIndex) => {
+          const absoluteIndex = rowIndex * safeColumns + colIndex;
+          const fallbackLabel = DEFAULT_MONTH_LABELS[absoluteIndex % DEFAULT_MONTH_LABELS.length];
+          const label = month.label ?? fallbackLabel;
+          const glyphModes = month.modes ? {
+            ...modes,
+            ...month.modes
+          } : modes;
+          return /*#__PURE__*/_jsx(CalendarGlyph, {
+            label: label,
+            status: month.status,
+            modes: glyphModes,
+            ...(glyphStyle !== undefined ? {
+              style: glyphStyle
+            } : {}),
+            ...(labelStyle !== undefined ? {
+              labelStyle
+            } : {}),
+            ...(month.accessibilityLabel !== undefined ? {
+              accessibilityLabel: month.accessibilityLabel
+            } : {})
+          }, month.key ?? `glyph-${absoluteIndex}`);
+        })
+      }, `row-${rowIndex}`))
+    }), showLegend ? /*#__PURE__*/_jsx(View, {
+      style: [{
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        width: '100%'
+      }, legendStyle],
+      children: legendStatuses.map(status => {
+        const {
+          bg,
+          statusModes
+        } = resolveStatusColors(status, modes);
+        const label = legendOverrides[status] ?? DEFAULT_LEGEND_LABELS[status];
+        return /*#__PURE__*/_jsx(MetricLegendItem, {
+          label: label,
+          indicatorColor: bg,
+          modes: statusModes,
+          style: {
+            flex: 1,
+            minWidth: 0
+          }
+        }, `legend-${status}`);
+      })
+    }) : null]
+  });
+}
+export { CalendarGlyph };
+export default MonthlyStatusGrid;