jfs-components 0.0.71 → 0.0.73

package/lib/module/components/LinearProgress/LinearProgress.js

@@ -0,0 +1,63 @@
+"use strict";
+
+import React from 'react';
+import { View } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES } from '../../utils/react-utils';
+import { jsx as _jsx } from "react/jsx-runtime";
+const LinearProgress = ({
+  value = 0,
+  modes = EMPTY_MODES,
+  style,
+  trackStyle,
+  indicatorStyle,
+  ...rest
+}) => {
+  // The track and the progress indicator are intentionally rendered at
+  // different emphasis levels by default: the track sits in the
+  // background as a low-emphasis surface, while the progress indicator
+  // is the high-emphasis foreground. Defaults are placed *before* the
+  // user-provided modes spread, so callers can still override
+  // `Emphasis / DataViz` (or any other mode) via the `modes` prop.
+  const trackModes = {
+    'Emphasis': 'Low',
+    ...modes
+  };
+  const progressModes = {
+    'Emphasis': 'High',
+    ...modes
+  };
+  const trackHeight = getVariableByName('linearProgress/track/height', trackModes) ?? 8;
+  const trackRadius = getVariableByName('linearProgress/track/radius', trackModes) ?? 999;
+  const trackBg = getVariableByName('linearProgress/track/background', trackModes) ?? '#ede7ff';
+  const indicatorHeight = getVariableByName('linearProgress/indicator/height', progressModes) ?? 8;
+  const indicatorRadius = getVariableByName('linearProgress/indicator/radius', progressModes) ?? 999;
+  const indicatorBg = getVariableByName('linearProgress/indicator/background', progressModes) ?? '#5d00b5';
+  const clampedValue = Math.min(Math.max(value, 0), 1);
+  const widthPercent = `${clampedValue * 100}%`;
+  return /*#__PURE__*/_jsx(View, {
+    style: [{
+      height: trackHeight,
+      backgroundColor: trackBg,
+      borderRadius: trackRadius,
+      overflow: 'hidden',
+      width: '100%'
+    }, style, trackStyle],
+    accessibilityRole: "progressbar",
+    accessibilityValue: {
+      min: 0,
+      max: 1,
+      now: clampedValue
+    },
+    ...rest,
+    children: /*#__PURE__*/_jsx(View, {
+      style: [{
+        width: widthPercent,
+        height: indicatorHeight,
+        backgroundColor: indicatorBg,
+        borderRadius: indicatorRadius
+      }, indicatorStyle]
+    })
+  });
+};
+export default LinearProgress;

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;